@akagilnc/pi-workflow-roles 0.1.2521 → 0.1.2653-next.71811ca

package/dist/package-contracts/terminating-infrastructure.js

@@ -1,90 +0,0 @@
-/**
- * Package-owned shared infrastructure-failure declaration for every primary
- * packaged-role output tool (#541).
- *
- * One module owns what the judge mandates be shared (not reimplemented per
- * seat): the typed `infrastructureFailure.diagnostic` declaration composed into
- * each output tool's schema, and the single early host `failInfrastructure`
- * call each output `execute` makes before any role business validation / gate /
- * audit / ledger / Git work. The accepted status sets are intentionally NOT
- * extended: an infra declaration fails BEFORE accepted validation, never
- * becomes an accepted receipt. The diagnostic is carried verbatim on the thrown
- * Error so settlement keeps the original cause (kind=failure, exit 1).
- */
-import { Type } from "typebox";
-export const INFRASTRUCTURE_FAILURE_DECLARATION_KEY = "infrastructureFailure";
-export const INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY = "diagnostic";
-/** Shared typed declaration fragment: `infrastructureFailure.diagnostic` = non-empty string. */
-const infrastructureFailureDeclarationSchema = Type.Object({
-    [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: Type.Object({
-        [INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY]: Type.String({
-            minLength: 1,
-            description: "非空基础设施失败诊断",
-        }),
-    }, {
-        additionalProperties: true,
-        description: "基础设施失败声明",
-    }),
-}, { additionalProperties: true });
-/**
- * Compose the shared infrastructure-failure declaration into an open output
- * tool-object schema. Returns an open object (additionalProperties: true,
- * required: []) with the base schema's properties plus the shared declaration.
- * Static typing is preserved on the base (`as S`), so existing
- * `Static<typeof ...>` derived parameter types are unchanged.
- */
-export function withInfrastructureFailureDeclaration(schema) {
-    const baseProperties = schema
-        .properties;
-    const properties = {
-        ...(baseProperties ?? {}),
-        [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: infrastructureFailureDeclarationSchema.properties[INFRASTRUCTURE_FAILURE_DECLARATION_KEY],
-    };
-    const object = Type.Object(properties, { additionalProperties: true });
-    object.required = [];
-    return object;
-}
-/** Safe recognition of the typed declaration; non-shapes / hostile input fail closed. */
-function isInfrastructureFailureDeclaration(parameters) {
-    if (parameters === null ||
-        typeof parameters !== "object" ||
-        Array.isArray(parameters)) {
-        return false;
-    }
-    const record = parameters;
-    if (!Object.hasOwn(record, INFRASTRUCTURE_FAILURE_DECLARATION_KEY))
-        return false;
-    const declaration = record[INFRASTRUCTURE_FAILURE_DECLARATION_KEY];
-    if (declaration === null ||
-        typeof declaration !== "object" ||
-        Array.isArray(declaration)) {
-        return false;
-    }
-    const diagnostic = declaration[INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY];
-    return typeof diagnostic === "string" && diagnostic.trim().length > 0;
-}
-/** Non-empty trimmed diagnostic from the declaration, else undefined. */
-function infrastructureFailureDiagnostic(parameters) {
-    if (!isInfrastructureFailureDeclaration(parameters))
-        return undefined;
-    const declaration = parameters[INFRASTRUCTURE_FAILURE_DECLARATION_KEY];
-    const diagnostic = declaration[INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY];
-    return typeof diagnostic === "string" ? diagnostic.trim() : undefined;
-}
-/** diagnostic → Error, name stamped so the host error identity is observable. */
-function infrastructureFailureError(diagnostic) {
-    const error = new Error(diagnostic);
-    error.name = "InfrastructureFailure";
-    return error;
-}
-/**
- * The one early call for every terminating output `execute`: if the parameters
- * carry the infra declaration, hand the diagnostic error to the shared host
- * `failInfrastructure` seam (which aborts the run). No-op otherwise.
- */
-export function failOnInfrastructureFailureDeclaration(parameters, hostActions, ctx, toolCallId) {
-    const diagnostic = infrastructureFailureDiagnostic(parameters);
-    if (diagnostic === undefined)
-        return;
-    hostActions.failInfrastructure(infrastructureFailureError(diagnostic), ctx, toolCallId);
-}

package/resources/engines/sonnet.md

@@ -1,27 +0,0 @@
-# sonnet engine method material
-
-This file is packaged technical material for the optional `sonnet` labor engine
-(Claude Code CLI on the host, pinned to the Sonnet model).
-
-Before invoking the engine, read `../engine-dispatch.md`, resolving that path
-relative to this note. This note only covers this engine's CLI technical
-parameters.
-
-## Invocation
-
-Same host CLI as the `opus` engine: the machine entrypoint is `claude`, and all
-CLI mechanics (print mode, `--output-format=stream-json` requiring `--verbose`,
-fd layout, result-row extraction) are documented in `../opus.md` — read that
-note for them; they are not duplicated here.
-
-The only difference is the model pin:
-
-```bash
-claude -p --model sonnet --verbose --output-format=stream-json "YOUR_LABOR_PROMPT"
-```
-
-`--model sonnet` is verified accepted on this host (Claude Code 2.1.233); the
-stream-json init event reports `claude-sonnet-5` (host-verified 2026-08-28).
-
-Prefer `claude --help` on the host over any remembered flag set. Do not wrap
-this engine behind `ak-role` flags.

package/resources/engines/zcode.md

@@ -1,63 +0,0 @@
-# zcode engine method material
-
-This file is packaged technical material for the optional `zcode` labor engine
-(Z.AI ZCode agent runtime on the host, GLM Coding Plan models).
-
-Before invoking the engine, read `../engine-dispatch.md`, resolving that path
-relative to this note. This note only covers this engine's CLI technical
-parameters.
-
-## Invocation (host-verified 2026-08-29)
-
-The machine entrypoint is `zcode` (npm `zcode-app-cli`, wraps the official
-ZCode runtime; host has 3.10.1-17 / runtime 0.16.5). Non-interactive labor:
-
-```bash
-zcode --prompt 'YOUR_LABOR_PROMPT' --cwd /path/to/worktree
-```
-
-`--prompt` defaults to permission mode `yolo` (no TTY permission stalls).
-Useful extras measured from `zcode --help`: `--attach <path>` (repeatable),
-`--mode build|edit|plan|yolo`, `--resume <sess_...>`, `--json` where
-supported. Prefer `zcode --help` on the host over any remembered flag set.
-
-## Realm and model traps (host-verified 2026-08-29, all three hit in sequence)
-
-- Missing `~/.zcode/cli/config.json` → hard error `Model config is missing`.
-  The desktop app's login is NOT shared with the CLI.
-- `zcode login` signs into the **overseas Z.AI realm only**. An account on the
-  mainland BigModel realm then fails with
-  `[1113][Insufficient balance or no resource package]`.
-- The scaffolded config defaults `model.main` to `zai/glm-5.2`, which is not
-  in the coding plan — same 1113 failure even with a valid plan.
-
-Working mainland configuration (per official docs
-`docs.bigmodel.cn/cn/coding-plan/quick-start`): in
-`~/.zcode/cli/config.json`, provider kind `anthropic` with
-`baseURL: https://open.bigmodel.cn/api/anthropic`, `options.apiKey` = the
-coding-plan key (host keychain: service `glm-key`, account `akagilnc`), and
-`model.main: zai/glm-5.3`, `model.lite: zai/glm-5.3-flash`. With that config
-the smoke prompt returns normally.
-
-## Quota facts (owner-provided, 2026-08-28)
-
-Plan quotas are daily and per-model (GLM-5.3 3M/day, Flash 5M/day on the
-current plan; a weekend event granted a larger temporary pool). Whether cached
-tokens count toward quota is unverified.
-
-## Lane status: PARKED (host-verified 2026-08-29)
-
-The "working" configuration above drew from a new-user gift resource package
-(2M general-model tokens), not from any plan. Once that package expired,
-glm-5.3-flash returns `1113` (insufficient balance) with the same key on BOTH
-the anthropic endpoint and the coding endpoint
-(`open.bigmodel.cn/api/coding/paas/v4`, HTTP 429 + code 1113, probed with a
-minimal request). The ZCode Start/Weekend plan quotas are bound to the desktop
-app's OAuth connection ("Start Plan" connection mode); the CLI's
-`/login bigmodel-coding-plan` OAuth variant hard-fails with
-`BigModel OAuth appSecret is required.` (the client secret ships only inside
-the desktop app; no env override exists — only `BIGMODEL_*_API_BASE_URL`).
-The plan page issues exactly one API key and it is the key tested above.
-
-Net: this engine lane has no funded model until a key with actual balance or
-an in-plan API path exists. Do not dispatch `--engine zcode` until then.

package/src/archivist-role-run-coordinates.ts

@@ -1,45 +0,0 @@
-import { join } from "node:path";
-
-import { resolveBookKeyFromGit } from "./activation-ledger-git.ts";
-import {
-  activationBookDirectory,
-  resolveActivationLedgerHome,
-} from "./activation-ledger-topology.ts";
-
-export type RoleRunSessionCoordinates = {
-  readonly ledgerHome: string;
-  readonly bookKey: string;
-  readonly runDirectory: string;
-  readonly sessionDirectory: string;
-  readonly sessionFile: string;
-};
-
-/**
- * Sole source of public top-level Role run session coordinates.
- * Callers supply identity only; no destination can be injected.
- */
-export function roleRunSessionCoordinates(options: {
-  readonly cwd: string;
-  readonly runId: string;
-  readonly role: string;
-  /** Machine-home identity; not a record destination. */
-  readonly home?: string;
-}): RoleRunSessionCoordinates {
-  const ledgerHome = resolveActivationLedgerHome(
-    options.home === undefined ? undefined : () => options.home!,
-  );
-  const bookKey = resolveBookKeyFromGit(options.cwd);
-  const runDirectory = join(
-    activationBookDirectory(ledgerHome, bookKey),
-    "runs",
-    `${options.runId}@${options.role}`,
-  );
-  const sessionDirectory = join(runDirectory, "session");
-  return {
-    ledgerHome,
-    bookKey,
-    runDirectory,
-    sessionDirectory,
-    sessionFile: join(sessionDirectory, "session.jsonl"),
-  };
-}

package/src/package-contracts/terminating-infrastructure.ts

@@ -1,132 +0,0 @@
-/**
- * Package-owned shared infrastructure-failure declaration for every primary
- * packaged-role output tool (#541).
- *
- * One module owns what the judge mandates be shared (not reimplemented per
- * seat): the typed `infrastructureFailure.diagnostic` declaration composed into
- * each output tool's schema, and the single early host `failInfrastructure`
- * call each output `execute` makes before any role business validation / gate /
- * audit / ledger / Git work. The accepted status sets are intentionally NOT
- * extended: an infra declaration fails BEFORE accepted validation, never
- * becomes an accepted receipt. The diagnostic is carried verbatim on the thrown
- * Error so settlement keeps the original cause (kind=failure, exit 1).
- */
-import { Type, type TSchema } from "typebox";
-
-export const INFRASTRUCTURE_FAILURE_DECLARATION_KEY =
-  "infrastructureFailure" as const;
-export const INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY = "diagnostic" as const;
-
-/** Shared typed declaration fragment: `infrastructureFailure.diagnostic` = non-empty string. */
-const infrastructureFailureDeclarationSchema = Type.Object(
-  {
-    [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: Type.Object(
-      {
-        [INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY]: Type.String({
-          minLength: 1,
-          description: "非空基础设施失败诊断",
-        }),
-      },
-      {
-        additionalProperties: true,
-        description: "基础设施失败声明",
-      },
-    ),
-  },
-  { additionalProperties: true },
-);
-
-/**
- * Compose the shared infrastructure-failure declaration into an open output
- * tool-object schema. Returns an open object (additionalProperties: true,
- * required: []) with the base schema's properties plus the shared declaration.
- * Static typing is preserved on the base (`as S`), so existing
- * `Static<typeof ...>` derived parameter types are unchanged.
- */
-export function withInfrastructureFailureDeclaration<
-  S extends TSchema & { properties?: Record<string, TSchema> },
->(schema: S): S {
-  const baseProperties = (schema as { properties?: Record<string, TSchema> })
-    .properties;
-  const properties: Record<string, TSchema> = {
-    ...(baseProperties ?? {}),
-    [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]:
-      infrastructureFailureDeclarationSchema.properties[
-        INFRASTRUCTURE_FAILURE_DECLARATION_KEY
-      ],
-  };
-  const object = Type.Object(properties, { additionalProperties: true });
-  (object as unknown as { required: string[] }).required = [];
-  return object as unknown as S;
-}
-
-/** Structural host seam subset shared by every terminating execute path. */
-type TerminatingInfrastructureHostActions<C> = {
-  failInfrastructure(error: unknown, ctx: C, toolCallId?: string): never;
-};
-
-/** Safe recognition of the typed declaration; non-shapes / hostile input fail closed. */
-function isInfrastructureFailureDeclaration(
-  parameters: unknown,
-): boolean {
-  if (
-    parameters === null ||
-    typeof parameters !== "object" ||
-    Array.isArray(parameters)
-  ) {
-    return false;
-  }
-  const record = parameters as Record<string, unknown>;
-  if (!Object.hasOwn(record, INFRASTRUCTURE_FAILURE_DECLARATION_KEY)) return false;
-  const declaration = record[INFRASTRUCTURE_FAILURE_DECLARATION_KEY];
-  if (
-    declaration === null ||
-    typeof declaration !== "object" ||
-    Array.isArray(declaration)
-  ) {
-    return false;
-  }
-  const diagnostic = (declaration as Record<string, unknown>)[
-    INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY
-  ];
-  return typeof diagnostic === "string" && diagnostic.trim().length > 0;
-}
-
-/** Non-empty trimmed diagnostic from the declaration, else undefined. */
-function infrastructureFailureDiagnostic(
-  parameters: unknown,
-): string | undefined {
-  if (!isInfrastructureFailureDeclaration(parameters)) return undefined;
-  const declaration = (parameters as Record<string, unknown>)[
-    INFRASTRUCTURE_FAILURE_DECLARATION_KEY
-  ] as Record<string, unknown>;
-  const diagnostic = declaration[INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY];
-  return typeof diagnostic === "string" ? diagnostic.trim() : undefined;
-}
-
-/** diagnostic → Error, name stamped so the host error identity is observable. */
-function infrastructureFailureError(diagnostic: string): Error {
-  const error = new Error(diagnostic);
-  error.name = "InfrastructureFailure";
-  return error;
-}
-
-/**
- * The one early call for every terminating output `execute`: if the parameters
- * carry the infra declaration, hand the diagnostic error to the shared host
- * `failInfrastructure` seam (which aborts the run). No-op otherwise.
- */
-export function failOnInfrastructureFailureDeclaration<C>(
-  parameters: unknown,
-  hostActions: TerminatingInfrastructureHostActions<C>,
-  ctx: C,
-  toolCallId: string,
-): void {
-  const diagnostic = infrastructureFailureDiagnostic(parameters);
-  if (diagnostic === undefined) return;
-  hostActions.failInfrastructure(
-    infrastructureFailureError(diagnostic),
-    ctx,
-    toolCallId,
-  );
-}