@akagilnc/pi-workflow-roles 0.1.5079 → 0.1.5122

package/dist/notary-contracts.js

@@ -14,7 +14,6 @@ const NOTARY_TICKET_FLAG = {
     type: "string"
   }
 };
-const NOTARY_FIXED_KICKOFF = "\u7B26\u5B9D\u90CE\u6848\u5377\u5DF2\u53D7\u7406\uFF1B\u6765\u6E90 run \u5B9A\u4F4D\u89C1\u4F1A\u8BDD\u6750\u6599\u3002";
 const notaryOutputSchema = reviewSubmissionSchema;
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -37,7 +36,6 @@ function validateRecordedNotaryOutput(value) {
   return value;
 }
 export {
-  NOTARY_FIXED_KICKOFF,
   NOTARY_OUTPUT_TOOL_NAME,
   NOTARY_SOURCE_RUN_FLAG,
   NOTARY_TICKET_FLAG,

package/dist/package-contracts/fixer-output.js

@@ -27,7 +27,7 @@ const refusedClassResultSchema = Type.Object({
 });
 const classResultSchema = Type.Union([completedClassResultSchema, refusedClassResultSchema]);
 const completedClassResultsSchema = Type.Array(completedClassResultSchema);
-const FIXER_STATUS_DESCRIPTION = "planned | completed | refused | unfinished | partially_completed \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\uFF1Bunfinished \u7F3A\u524D\u7F6E\u6216\u8FDD\u5BAA\u7EA6\u675F\u81F4\u672C\u5C40\u672A\u5B8C\u6210\u65F6\u53EF\u7528\uFF0C\u7F3A\u5F85\u51B3 owner \u51B3\u5B9A\u6216\u7B54\u590D\u5C5E\u7F3A\u524D\u7F6E\u3002";
+const FIXER_STATUS_DESCRIPTION = "planned | completed | refused | unfinished | partially_completed\u3002unfinished \u7F3A\u524D\u7F6E\u6216\u8FDD\u5BAA\u7EA6\u675F\u81F4\u672C\u5C40\u672A\u5B8C\u6210\u65F6\u53EF\u7528\uFF0C\u7F3A\u5F85\u51B3 owner \u51B3\u5B9A\u6216\u7B54\u590D\u5C5E\u7F3A\u524D\u7F6E\u3002";
 const fixerOutputVariants = Type.Union([
   Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }) }),
   Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), remainingScope: Type.String({ description: "\u4F9D\u6CD5\u4E0D\u80FD\u5B8C\u6210\u7684\u5DE5\u4F5C\u8303\u56F4" }), blocker: Type.Unsafe({ ...blockerSchema, description: "\u5408\u6CD5\u963B\u65AD\u5B8C\u6210\u7684 blocker" }) }),

package/dist/package-contracts/gatekeeper-output.js

@@ -5,7 +5,7 @@ const GATEKEEPER_OUTPUT_TOOL_NAME = "ak_gatekeeper_output";
 const gatekeeperDecisionSchema = openToolObject(
   Type.Object({
     status: Type.Unknown({
-      description: "dispatch | pass \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8"
+      description: "dispatch | pass"
     }),
     officer: Type.Unknown({
       description: "status \u4E3A dispatch \u65F6\u4E3A inspector | notary"

package/dist/package-contracts/navigator-output.js

@@ -6,7 +6,7 @@ const navigatorOutputSchema = withTerminatingOutputDeclarations(
   openToolObject(
     Type.Object({
       prose: Type.Unknown({
-        description: "\u6E38\u5955\u4F7F\u6563\u6587\u5EFA\u8BAE\uFF0C\u539F\u6837\u5448\u73B0\u3002\u4E0D\u8981\u6C42 candidates/next \u7B49\u7ED3\u6784\u5316\u5B57\u6BB5\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8"
+        description: "\u6E38\u5955\u4F7F\u6563\u6587\u5EFA\u8BAE\uFF0C\u539F\u6837\u5448\u73B0\u3002\u4E0D\u8981\u6C42 candidates/next \u7B49\u7ED3\u6784\u5316\u5B57\u6BB5\u3002"
       })
     })
   )

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

@@ -4,12 +4,12 @@ const INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY = "diagnostic";
 const infrastructureFailureNested = Type.Object(
   {
     [INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY]: Type.Unknown({
-      description: "\u975E\u7A7A\u57FA\u7840\u8BBE\u65BD\u5931\u8D25\u8BCA\u65AD\u5B57\u7B26\u4E32\u3002\u65E0\u5931\u8D25\u65F6\u5FC5\u987B\u7701\u7565\u6574\u4E2A infrastructureFailure\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
+      description: "\u57FA\u7840\u8BBE\u65BD\u5931\u8D25\u8BCA\u65AD\u5B57\u7B26\u4E32\u3002"
     })
   },
   {
     additionalProperties: true,
-    description: "\u57FA\u7840\u8BBE\u65BD\u771F\u5B9E\u5931\u8D25\u58F0\u660E\uFF08\u5982\u9700\uFF09\u3002\u89C4\u8303\u5F62\uFF1A{ diagnostic: \u975E\u7A7A\u8BCA\u65AD\u5B57\u7B26\u4E32 }\uFF1B\u65E0\u5931\u8D25\u65F6\u5FC5\u987B\u7701\u7565\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
+    description: "\u4EC5\u57FA\u7840\u8BBE\u65BD\u771F\u5B9E\u5931\u8D25\u65F6\u51FA\u73B0\u3002"
   }
 );
 infrastructureFailureNested.required = [];
@@ -25,7 +25,7 @@ function withTerminatingOutputDeclarations(schema) {
     ...baseProperties ?? {},
     ...baseProperties?.ticketNumber === void 0 ? {
       ticketNumber: Type.Unknown({
-        description: "\u53EF\u9009\u672C\u7968\u53F7\uFF1A\u5C1A\u672A\u7ED1\u5B9A\u65F6\u7531\u89D2\u8272\u5728\u65E2\u6709\u56DE\u6267\u4E2D\u7533\u62A5\uFF1B\u673A\u68B0\u5C42\u53EA\u8BB0\u5F55\u5408\u6CD5\u6B63\u6574\u6570\uFF0C\u4E0D\u4ECE\u6563\u6587\u63A8\u5BFC\u3001\u4E0D\u9A8C\u771F\u3002\u7F3A\u5931\u6216\u9519\u5F62\u4E0D\u62D2\u6536\u3002"
+        description: "\u53EF\u9009\u672C\u7968\u53F7\u3002\u5C1A\u672A\u7ED1\u5B9A\u65F6\u7531\u89D2\u8272\u5728\u65E2\u6709\u56DE\u6267\u4E2D\u7533\u62A5\u3002"
       })
     } : {},
     [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: infrastructureFailureDeclarationSchema.properties[INFRASTRUCTURE_FAILURE_DECLARATION_KEY]

package/dist/packaged-role-registry.js

@@ -27,21 +27,24 @@ const NOTARY_SESSION_MATERIALS = [
   "souls/notary.md",
   "souls/audit-law.md",
   "souls/ticket-law.md",
-  "souls/gate-output-guide.md"
+  "souls/gate-output-guide.md",
+  "docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md"
 ];
 const INSPECTOR_SESSION_MATERIALS = [
   "CLAUDE.md",
   "souls/inspector.md",
   "souls/audit-law.md",
   "souls/quality-law.md",
-  "souls/gate-output-guide.md"
+  "souls/gate-output-guide.md",
+  "docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md"
 ];
 const AUDITOR_PUBLIC_SESSION_MATERIALS = [
   "CLAUDE.md",
   "souls/judge-auditor.md",
   "souls/doctor-auditor.md",
   "souls/audit-law.md",
-  "souls/quality-law.md"
+  "souls/quality-law.md",
+  "docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md"
 ];
 const PUBLIC_ROLE_RECORDS = [
   {
@@ -69,7 +72,8 @@ const PUBLIC_ROLE_RECORDS = [
       "souls/judge.md",
       "souls/audit-law.md",
       "souls/quality-law.md",
-      "souls/judge-output-guide.md"
+      "souls/judge-output-guide.md",
+      "docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md"
     ]
   },
   {
@@ -347,7 +351,7 @@ const PUBLIC_ROLE_RECORDS = [
     activationStage: "load-and-install",
     receiptStatusKey: "status",
     // #924: 公用《票面法》三席同装
-    sessionMaterials: ["CLAUDE.md", "souls/countersign.md", "souls/ticket-law.md", "resources/countersign-ticket-issue.md"]
+    sessionMaterials: ["CLAUDE.md", "souls/countersign.md", "souls/ticket-law.md", "resources/countersign-ticket-issue.md", "docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md"]
   },
   {
     role: "secretariat",

package/dist/public-cli/cli.js

@@ -13,10 +13,12 @@ import { packagedModelParent } from "../packaged-role-registry.js";
 import { seatModelOnly } from "./registry.js";
 import { CliUsageError } from "./cli-errors.js";
 import { runMachineSkillSetup } from "./machine-method-skills.js";
+import { presentLocatedResumeFailure, } from "./post-admission.js";
 import { appendPiSessionCustomEntry } from "../pi/role-turn-host.js";
 import { composeRoleTurnHostAdapters, formatHostSelectionFailure, HostSelectionError, selectRoleTurnHost, } from "./role-turn-host-resolution.js";
 import { parseAnalystArgv, parsePublicSeatArgv, } from "./invocation.js";
 import { createTypedOptionConsumer, optionsForOwner, projectCommandHelp, projectOwnerOptions, PUBLIC_NAVIGATOR_HELP_NOTE, PUBLIC_ROLE_OPTION_OWNERS, renderHumanOwnerOptionLines, } from "./option-definitions.js";
+import { TurnDispatchedFailure } from "./auto-resume.js";
 import { continueParentAfterChild, runPublicInstructionSeat, runPublicInstructionSeatResume } from "./instruction-seat-run.js";
 import { courtDiaristEscalated } from "./countersign-run.js";
 import { runPublicAnalyst } from "./analyst-run.js";
@@ -727,6 +729,7 @@ export function commandNeedsProcessCancel(argv) {
 }
 export async function runAkRole(argv, env) {
     const io = env.io ?? defaultIo();
+    let resumeFailureContext;
     try {
         // Select the installed package identity once, before any role-owned Skill,
         // runtime entry, activation argv, or invocation provenance is derived.
@@ -820,11 +823,16 @@ export async function runAkRole(argv, env) {
         // must still exist. Seat and dispatch follow the durable admitted role.
         // #471: unique parser owns {runId, message?}; five role paths only consume it.
         if (parsed.command === "resume") {
+            const resumeRequest = parseResumeRequest(parsed.args);
+            resumeFailureContext = {
+                home,
+                runId: resumeRequest.runId,
+                authority: env.principalAuthority ?? piDurablePrincipalAuthority,
+            };
             const agentDir = resolveAgentDir(env, home);
             const cwd = env.cwd ?? process.cwd();
             const config = await loadAndValidateConfig(home, env.packageRoot);
             const credentials = env.credentials ?? (await loadCredentialProviders(agentDir));
-            const resumeRequest = parseResumeRequest(parsed.args);
             const resumeRole = await peekRoleRunRole(home, resumeRequest.runId);
             // Missing durable role keeps the judge seat table. The resume entry
             // itself is one function; it reads the stored run.
@@ -844,6 +852,11 @@ export async function runAkRole(argv, env) {
                 && current.terminal?.roleOutcome.kind === "accepted"
                 && !courtDiaristEscalated(current.terminal.roleOutcome)) {
                 const parentRunId = current.admitted.correlationId;
+                resumeFailureContext = {
+                    home,
+                    runId: parentRunId,
+                    authority: env.principalAuthority ?? piDurablePrincipalAuthority,
+                };
                 const parentRole = await peekRoleRunRole(home, parentRunId);
                 if (parentRole === undefined)
                     break;
@@ -875,6 +888,16 @@ export async function runAkRole(argv, env) {
         throw new CliUsageError(`unknown command: ${parsed.command}`);
     }
     catch (error) {
+        // A dispatched turn owns its settlement; only pre-dispatch resume failures
+        // fall through to the located-run diagnostic presenter here.
+        if (resumeFailureContext !== undefined
+            && !(error instanceof TurnDispatchedFailure)
+            && await presentLocatedResumeFailure(resumeFailureContext.home, resumeFailureContext.runId, resumeFailureContext.authority, io, error)) {
+            return {
+                exitCode: error instanceof CliUsageError ? 2 : 1,
+                ...(error instanceof HostSelectionError ? { hostFailure: error.failure } : {}),
+            };
+        }
         if (error instanceof HostSelectionError) {
             io.stderr(formatCliDiagnostic(formatHostSelectionFailure(error.failure)));
             return { exitCode: 1, hostFailure: error.failure };

package/dist/public-cli/countersign-run.js

@@ -234,7 +234,7 @@ export async function runCountersignCourtDiaristStation(admitted, env, io, after
     const completedIndex = afterTicketNumber === undefined ? -1 : refreshTickets.indexOf(afterTicketNumber);
     for (const ticketNumber of refreshTickets.slice(completedIndex + 1)) {
         const outcome = await invokeCourtDiarist({
-            instruction: `整理 #${ticketNumber} 的本案依据。`,
+            instruction: admitted.instruction,
             projectRoot: admitted.projectRoot,
             failureLabel: `ticket #${ticketNumber}`,
             correlationId: admitted.runId,

package/dist/public-cli/instruction-seat-run.js

@@ -12,7 +12,7 @@ import { packagedAdmitsCountersign, packagedBindsBoardTicket, packagedRebindSour
 import { isAuditorSoulRole } from "../auditor-soul.js";
 import { CliUsageError } from "./cli-errors.js";
 import { admitPublicRole, bindAdmittedTicketNumber, bindCourtTicketNumbersOnAdmitted, buildInstructionTransportPrompt, materializeCountersignInvocation, persistAdmittedSourceRunPath, recordAdmittedCorrelation, recordChildDiaristRun, relocateAdmittedRunToTicket, withPreparedAttachments, } from "./invocation.js";
-import { presentControlledFailure, prepareSummonsResumeMaterials, roleTurnOptions, runPostAdmissionOneShot, runPostAdmissionResumable, runPostAdmissionSeatResume, resumeTurnRequestProjectionOptions, } from "./post-admission.js";
+import { presentControlledFailure, prepareSummonsResumeMaterials, roleTurnOptions, runPostAdmissionOneShot, runPostAdmissionResumable, runPostAdmissionSeatResume, showResumeErrorPointer, resumeTurnRequestProjectionOptions, } from "./post-admission.js";
 import { buildAutoResumeContinuationPrompt, loadResumablePublicRole, markRunAdmitted, parentRunPathFromGatePointerInstruction, } from "./run-lifecycle.js";
 import { tryResumeSameTicketSeatRun } from "./seat-ticket-binding.js";
 import { presentStructuralRejection, seatKnownFailureResolver, trySettlePublicSeat, } from "./settlement.js";
@@ -52,11 +52,11 @@ function isBoardTicketSeat(seat) {
 async function bindAndRelocateDiarist(admitted, authority, lease) {
     const boardTicket = await readBoardTicketNumber(admitted.runDirectory);
     if (boardTicket === undefined)
-        return;
+        return undefined;
     if (admitted.ticketNumber === undefined) {
         await bindAdmittedTicketNumber(admitted, boardTicket);
     }
-    await relocateAdmittedRunToTicket(admitted, authority, lease);
+    return await relocateAdmittedRunToTicket(admitted, authority, lease);
 }
 function seatAdapters(admitted, env) {
     const record = roleRecord(admitted.role);
@@ -80,8 +80,8 @@ function seatAdapters(admitted, env) {
                 },
                 afterDispatch: async (seat, lease) => {
                     if (!isBoardTicketSeat(seat))
-                        return;
-                    await bindAndRelocateDiarist(seat, env.principalAuthority, lease);
+                        return undefined;
+                    return await bindAndRelocateDiarist(seat, env.principalAuthority, lease);
                 },
             }
             : {}),
@@ -655,5 +655,7 @@ export async function continueParentAfterChild(parentRunId, child, env, io) {
             return { exitCode: 0, admitted, terminal: refresh.terminal };
         }
     }
-    return dispatchAdmitted(admitted, env, io);
+    const result = await dispatchAdmitted(admitted, env, { ...io, omitFailureStderrDiagnostic: true });
+    showResumeErrorPointer(io, result.exitCode, result.terminal);
+    return result;
 }

package/dist/public-cli/invocation.js

@@ -24,7 +24,7 @@ import { validateMergerInput, } from "../merger-contracts.js";
 import { sha256Hex } from "../sha256.js";
 import { rehomeUnboundTicketProvenance } from "../ticket-provenance.js";
 import { uuidv7 } from "../uuidv7.js";
-import { NOTARY_FIXED_KICKOFF, } from "../notary-contracts.js";
+import {} from "../notary-contracts.js";
 import { NotarySourceRunError, resolveNotarySourceRunLocator, } from "../notary-source-run.js";
 import { appendEngineSessionMaterial, } from "../package-resources/engine-material.js";
 import { CliUsageError } from "./cli-errors.js";
@@ -1293,13 +1293,16 @@ function admittedTransportPromptKind(admitted) {
 export function buildInstructionTransportPrompt(admitted, engineMaterial) {
     const kind = admittedTransportPromptKind(admitted);
     if (kind === "fixed-kickoff") {
-        return appendEngineSessionMaterial([NOTARY_FIXED_KICKOFF], engineMaterial).join("\n");
+        if (admitted.sourceRunPath === undefined || admitted.sourceRunPath.trim() === "") {
+            throw new Error("fixed-kickoff transport prompt is missing the source run pointer");
+        }
+        return appendEngineSessionMaterial([admitted.sourceRunPath], engineMaterial).join("\n");
     }
     if (kind === "baseline") {
         if (admitted.baseRevision === undefined) {
             throw new Error("baseline transport prompt is missing the bound revision");
         }
-        const lines = [`左拾遗案已受理。比较基线：${admitted.baseRevision}`];
+        const lines = [admitted.baseRevision];
         if (!admitted.instructionEmpty) {
             lines.push("", admitted.instruction);
         }