@akagilnc/pi-workflow-roles 0.1.5068 → 0.1.5096

package/dist/inspector-contracts.js

@@ -1,4 +1,4 @@
-import { REVIEW_SUBMISSION_OUTPUT_TOOL_NAME } from "./review-submission.js";
+import { REVIEW_QUEUE_STATUSES, REVIEW_SUBMISSION_OUTPUT_TOOL_NAME } from "./review-submission.js";
 const INSPECTOR_OUTPUT_TOOL_NAME = REVIEW_SUBMISSION_OUTPUT_TOOL_NAME;
 const INSPECTOR_SOURCE_RUN_FLAG = {
   name: "ak-inspector-source-run",
@@ -17,7 +17,10 @@ function validateRecordedInspectorOutput(value) {
   } catch {
     throw new Error("Inspector output has no execution discriminator");
   }
-  if (status === "converged" || status === "continue" || status === "escalate") {
+  if (typeof status !== "string") {
+    throw new Error("Inspector output has no execution discriminator");
+  }
+  if (REVIEW_QUEUE_STATUSES.has(status)) {
     return value;
   }
   throw new Error("Inspector output has no execution discriminator");

package/dist/merger-contracts.js

@@ -13,7 +13,7 @@ const mergerInputSchema = Type.Object({
   resolutionScope: Type.Array(Type.String(), { description: "\u6750\u6599\uFF1A\u89E3\u6790\u8303\u56F4\u63D0\u793A\uFF1B\u53EF\u7A7A" }),
   authorizedChecks: Type.Array(checkSchema)
 }, { additionalProperties: false });
-const MERGER_STATUS_DESCRIPTION = "completed | escalate \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8";
+const MERGER_STATUS_DESCRIPTION = "completed | escalate";
 const mergerOutputVariants = Type.Union([
   Type.Object({ status: Type.Unknown({ description: MERGER_STATUS_DESCRIPTION }), attemptId: Type.String({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), mergeCommitId: Type.String({ description: "\u5B8C\u6210\u5408\u5E76 commit object ID" }) }, { additionalProperties: false }),
   Type.Object({ status: Type.Unknown({ description: MERGER_STATUS_DESCRIPTION }), attemptId: Type.String({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }), diagnosis: Type.String({ description: "\u5408\u5E76\u65E0\u6CD5\u6216\u4E0D\u5E94\u7531\u672C\u5E2D\u5B8C\u6210\u7684\u539F\u56E0\uFF08\u542B\u65E0\u8FDB\u884C\u4E2D\u5408\u5E76\u3001\u65E0\u6D3B\u53EF\u5E72\u3001\u9700\u65B0\u7684\u4EA7\u54C1/\u6743\u529B\u51B3\u5B9A\uFF09" }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }) }, { additionalProperties: false })

package/dist/migrate-book-topology.js

@@ -8176,7 +8176,10 @@ function openToolObjectFromUnion(schema) {
 }
 function openToolObject(schema) {
   const object = typebox_exports.Object(
-    Object.fromEntries(Object.entries(schema.properties).map(([name, declaration]) => [name, typebox_exports.Optional(described(name, declaration))])),
+    Object.fromEntries(Object.entries(schema.properties).map(([name, declaration]) => [
+      name,
+      typebox_exports.Optional(described(name, declaration))
+    ])),
     { additionalProperties: true }
   );
   object.required = [];
@@ -8196,13 +8199,15 @@ function withTerminatingOutputDeclarations(schema) {
     ...baseProperties ?? {},
     ...baseProperties?.ticketNumber === void 0 ? {
       ticketNumber: typebox_exports.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]
   };
   const object = typebox_exports.Object(properties, { additionalProperties: true });
-  object.required = [];
+  const incoming = schema.required;
+  const preserved = Array.isArray(incoming) ? incoming.filter((key) => typeof key === "string" && Object.hasOwn(properties, key)) : [];
+  object.required = preserved;
   return object;
 }
 var INFRASTRUCTURE_FAILURE_DECLARATION_KEY, INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY, infrastructureFailureNested, infrastructureFailureDeclarationSchema;
@@ -8215,12 +8220,12 @@ var init_terminating_infrastructure = __esm({
     infrastructureFailureNested = typebox_exports.Object(
       {
         [INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY]: typebox_exports.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 = [];
@@ -8245,7 +8250,7 @@ var init_gatekeeper_output = __esm({
     gatekeeperDecisionSchema = openToolObject(
       typebox_exports.Object({
         status: typebox_exports.Unknown({
-          description: "dispatch | pass \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8"
+          description: "dispatch | pass"
         }),
         officer: typebox_exports.Unknown({
           description: "status \u4E3A dispatch \u65F6\u4E3A inspector | notary"
@@ -8274,7 +8279,7 @@ var init_navigator_output = __esm({
       openToolObject(
         typebox_exports.Object({
           prose: typebox_exports.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"
           })
         })
       )
@@ -8283,31 +8288,37 @@ var init_navigator_output = __esm({
 });
 
 // src/review-submission.ts
-var REVIEW_SUBMISSION_OUTPUT_TOOL_NAME, reviewSubmissionSchema;
+var REVIEW_SUBMISSION_OUTPUT_TOOL_NAME, REVIEW_QUEUE_WORDS, REVIEW_QUEUE_STATUSES, reviewSubmissionSchema;
 var init_review_submission = __esm({
   "src/review-submission.ts"() {
     "use strict";
     init_build();
-    init_open_tool_schema();
     init_terminating_infrastructure();
     REVIEW_SUBMISSION_OUTPUT_TOOL_NAME = "ak_submission_output";
+    REVIEW_QUEUE_WORDS = ["converged", "continue", "escalate"];
+    REVIEW_QUEUE_STATUSES = new Set(REVIEW_QUEUE_WORDS);
     reviewSubmissionSchema = withTerminatingOutputDeclarations(
-      openToolObject(
-        typebox_exports.Object({
-          status: typebox_exports.Optional(typebox_exports.Unknown({
-            description: "converged | continue | escalate \u2014 \u975E\u4E09\u6001\u65F6\u8BF7\u91CD\u8BFB\u540E\u91CD\u4EA4\uFF0C\u52FF\u6539\u6807\u3002"
-          })),
-          findings: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u5BA1\u6838\u53D1\u73B0\uFF0C\u539F\u6837\u7559\u5B58" })),
-          reason: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u4E0A\u5448\u7406\u7531" })),
-          violations: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u8FDD\u89C4\u6761\u76EE" })),
-          conflicts: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u5F85\u51B3\u51B2\u7A81" })),
-          fix: typebox_exports.Optional(typebox_exports.Unknown({ description: "continue \u65F6\u7684\u8865\u6551\u8BF4\u660E\uFF1B\u53EF\u5199 summary \u6458\u8981\uFF0C\u5176\u4F59\u5185\u5BB9\u539F\u6837\u7559\u5B58" })),
-          classes: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u5DF2\u88C1\u51B3 finding \u7C7B\uFF1B\u53EF\u8BF4\u660E name\u3001owner\u3001boundary\u3001disposition\uFF0C\u539F\u6837\u7559\u5B58" })),
-          note: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u88C1\u51B3\u9644\u6CE8" })),
-          evidence: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u7559\u5B58\u8BC1\u636E" })),
-          decisionGate: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u9700\u4EBA\u6743\u5A01\u5904\u7F6E\u7684\u95EE\u9898\u4E0E\u9009\u9879\uFF1B\u53EF\u8BF4\u660E question\u3001options\uFF0C\u539F\u6837\u7559\u5B58" }))
-        })
-      )
+      typebox_exports.Object({
+        status: typebox_exports.Union(
+          [
+            typebox_exports.Literal(REVIEW_QUEUE_WORDS[0]),
+            typebox_exports.Literal(REVIEW_QUEUE_WORDS[1]),
+            typebox_exports.Literal(REVIEW_QUEUE_WORDS[2])
+          ],
+          {
+            description: "\u5BA1\u6838\u5E2D\u672C\u8F6E\u88C1\u51B3\u7684\u5224\u522B\u72B6\u6001\u3002"
+          }
+        ),
+        findings: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u5BA1\u6838\u53D1\u73B0\uFF0C\u539F\u6837\u7559\u5B58" })),
+        reason: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u4E0A\u5448\u7406\u7531" })),
+        violations: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u8FDD\u89C4\u6761\u76EE" })),
+        conflicts: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u5F85\u51B3\u51B2\u7A81" })),
+        fix: typebox_exports.Optional(typebox_exports.Unknown({ description: "continue \u65F6\u7684\u8865\u6551\u8BF4\u660E\uFF1B\u53EF\u5199 summary \u6458\u8981\uFF0C\u5176\u4F59\u5185\u5BB9\u539F\u6837\u7559\u5B58" })),
+        classes: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u5DF2\u88C1\u51B3 finding \u7C7B\uFF1B\u53EF\u8BF4\u660E name\u3001owner\u3001boundary\u3001disposition\uFF0C\u539F\u6837\u7559\u5B58" })),
+        note: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u88C1\u51B3\u9644\u6CE8" })),
+        evidence: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u7559\u5B58\u8BC1\u636E" })),
+        decisionGate: typebox_exports.Optional(typebox_exports.Unknown({ description: "\u9700\u4EBA\u6743\u5A01\u5904\u7F6E\u7684\u95EE\u9898\u4E0E\u9009\u9879\uFF1B\u53EF\u8BF4\u660E question\u3001options\uFF0C\u539F\u6837\u7559\u5B58" }))
+      }, { additionalProperties: true })
     );
   }
 });
@@ -8365,7 +8376,7 @@ var init_fixer_output = __esm({
     });
     classResultSchema = typebox_exports.Union([completedClassResultSchema, refusedClassResultSchema]);
     completedClassResultsSchema = typebox_exports.Array(completedClassResultSchema);
-    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";
+    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";
     fixerOutputVariants = typebox_exports.Union([
       typebox_exports.Object({ status: typebox_exports.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }) }),
       typebox_exports.Object({ status: typebox_exports.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), remainingScope: typebox_exports.String({ description: "\u4F9D\u6CD5\u4E0D\u80FD\u5B8C\u6210\u7684\u5DE5\u4F5C\u8303\u56F4" }), blocker: typebox_exports.Unsafe({ ...blockerSchema, description: "\u5408\u6CD5\u963B\u65AD\u5B8C\u6210\u7684 blocker" }) }),
@@ -13825,7 +13836,7 @@ var init_doctor_contracts = __esm({
       typebox_exports.Object({ targetKey: nonblank, targetKind: typebox_exports.Optional(typebox_exports.Union(assetKinds.map((kind) => typebox_exports.Literal(kind)))), assetEvidence: typebox_exports.Optional(typebox_exports.Object({ targetKey: nonblank, targetKind: typebox_exports.Optional(typebox_exports.Union(assetKinds.map((kind) => typebox_exports.Literal(kind)))), evidenceId: nonblank }, { additionalProperties: true })), ...findingBody }, { additionalProperties: true })
     ]);
     caseIdentity = typebox_exports.Object({ issueNumber: typebox_exports.Optional(typebox_exports.Integer()), runsPath: nonblank }, { additionalProperties: true });
-    DOCTOR_STATUS_DESCRIPTION = "completed | refused \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\uFF1Bcompleted \u5141\u8BB8\u7A7A findings\uFF1Brefused \u4EC5\u5F53\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u6848\u8BC1\u8BCD";
+    DOCTOR_STATUS_DESCRIPTION = "completed | refused\u3002completed \u5141\u8BB8\u7A7A findings\uFF1Brefused \u4EC5\u5F53\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u6848\u8BC1\u8BCD";
     doctorSubmissionVariants = typebox_exports.Union([
       typebox_exports.Object({
         status: typebox_exports.Unknown({ description: DOCTOR_STATUS_DESCRIPTION }),
@@ -13874,7 +13885,7 @@ var init_merger_contracts = __esm({
       resolutionScope: typebox_exports.Array(typebox_exports.String(), { description: "\u6750\u6599\uFF1A\u89E3\u6790\u8303\u56F4\u63D0\u793A\uFF1B\u53EF\u7A7A" }),
       authorizedChecks: typebox_exports.Array(checkSchema)
     }, { additionalProperties: false });
-    MERGER_STATUS_DESCRIPTION = "completed | escalate \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8";
+    MERGER_STATUS_DESCRIPTION = "completed | escalate";
     mergerOutputVariants = typebox_exports.Union([
       typebox_exports.Object({ status: typebox_exports.Unknown({ description: MERGER_STATUS_DESCRIPTION }), attemptId: typebox_exports.String({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), mergeCommitId: typebox_exports.String({ description: "\u5B8C\u6210\u5408\u5E76 commit object ID" }) }, { additionalProperties: false }),
       typebox_exports.Object({ status: typebox_exports.Unknown({ description: MERGER_STATUS_DESCRIPTION }), attemptId: typebox_exports.String({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }), diagnosis: typebox_exports.String({ description: "\u5408\u5E76\u65E0\u6CD5\u6216\u4E0D\u5E94\u7531\u672C\u5E2D\u5B8C\u6210\u7684\u539F\u56E0\uFF08\u542B\u65E0\u8FDB\u884C\u4E2D\u5408\u5E76\u3001\u65E0\u6D3B\u53EF\u5E72\u3001\u9700\u65B0\u7684\u4EA7\u54C1/\u6743\u529B\u51B3\u5B9A\uFF09" }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }) }, { additionalProperties: false })
@@ -13985,21 +13996,24 @@ var init_packaged_role_registry = __esm({
       "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"
     ];
     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"
     ];
     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"
     ];
     PUBLIC_ROLE_RECORDS = [
       {
@@ -14027,7 +14041,8 @@ var init_packaged_role_registry = __esm({
           "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"
         ]
       },
       {
@@ -14305,7 +14320,7 @@ var init_packaged_role_registry = __esm({
         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",
@@ -14515,6 +14530,7 @@ var init_compliance_transport = __esm({
     "use strict";
     init_auditor_dossier_tool();
     init_gatekeeper_role();
+    init_submission_errors();
     init_terminal();
     init_readable_gate_item();
     AUDITOR_PARENT_ATTEMPT_BINDING_ENTRY_TYPE = "ak_auditor_parent_attempt_binding";

package/dist/navigator-attendance.js

@@ -6,6 +6,7 @@ import {} from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import {
   NAVIGATOR_INVOCATION_ENTRY,
+  NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY,
   mintNavigatorInvocationId
 } from "./navigator-invocation-identity.js";
 import { PACKAGED_ROLE_REGISTRY } from "./packaged-role-registry.js";
@@ -31,10 +32,10 @@ import {
 } from "./navigator-session-contracts.js";
 import { sitianReport } from "./sitian-facade.js";
 import { issueRoot, subjectPath } from "./work-subject-identity.js";
-import { createReceiptDeliveryPolicy, NO_RECEIPT_LIFECYCLE_ENTRY_TYPE, RECEIPT_DELIVERY_PROMPT } from "./receipt-delivery-policy.js";
+import { createReceiptDeliveryPolicy, NO_RECEIPT_LIFECYCLE_ENTRY_TYPE } from "./receipt-delivery-policy.js";
 import { navigatorProseFromUnknown } from "./package-contracts/navigator-output.js";
+import { persistNavigatorWorkBase } from "./navigator-work-base.js";
 const NAVIGATOR_EVENT_TYPE = "ak-navigator-attendance";
-const NAVIGATOR_PREPARE_ACCEPTED_TEXT = "\u6E38\u5955\u4F7F\u51C6\u5907\u5DF2\u63A5\u53D7";
 function resolveNavigatorAuthorityMaterial(roleInput, fileAuthority) {
   if (roleInput !== void 0 && roleInput.trim() !== "") return roleInput;
   if (fileAuthority !== void 0 && fileAuthority.trim() !== "") return fileAuthority;
@@ -43,10 +44,9 @@ function resolveNavigatorAuthorityMaterial(roleInput, fileAuthority) {
 const NAVIGATOR_TARGETS = PACKAGED_ROLE_REGISTRY.map(({ role, phases }) => ({ role, phases }));
 const prepareSchema = Type.Object({
   prose: Type.Optional(Type.Unknown({
-    description: "\u6E38\u5955\u4F7F\u6563\u6587\u5EFA\u8BAE\uFF0C\u539F\u6837\u5448\u73B0\u3002\u4E0D\u8981\u6C42 candidates/next \u7ED3\u6784\u3002\u975E\u53D7\u7406\u95F8"
+    description: "\u6E38\u5955\u4F7F\u6563\u6587\u5EFA\u8BAE\uFF0C\u539F\u6837\u5448\u73B0\u3002\u4E0D\u8981\u6C42 candidates/next \u7ED3\u6784\u3002"
   }))
 }, { additionalProperties: true });
-const CONTEXT_ENTRY = "ak-navigator-context";
 const INVOCATION_ENTRY = NAVIGATOR_INVOCATION_ENTRY;
 const SETTLEMENT_ENTRY = "ak-navigator-settlement";
 const unavailableKeys = /* @__PURE__ */ new Set(["context", "session", "model", "thinking", "auth", "quota", "transport", "unknown"]);
@@ -105,12 +105,12 @@ function createNavigatorPrepareTool(onOutput) {
     parameters: prepareSchema,
     async execute(_id, value) {
       onOutput(value);
-      return { content: [{ type: "text", text: NAVIGATOR_PREPARE_ACCEPTED_TEXT }], details: value, terminate: true };
+      return { content: [], details: value, terminate: true };
     }
   };
 }
 function formatNavigatorReport(report) {
-  const playbookFailure = report.routePlaybookReadFailure === void 0 ? [] : [`\u8DEF\u4E66\u8BFB\u53D6\u5931\u8D25\uFF1A${report.routePlaybookReadFailure}`];
+  const playbookFailure = report.routePlaybookReadFailure === void 0 ? [] : [report.routePlaybookReadFailure];
   if (report.disposition === "no-advice") return playbookFailure.join("\n");
   if (report.disposition === "unavailable") {
     return [...playbookFailure, ...report.unavailableReason ? [report.unavailableReason] : []].join("\n");
@@ -136,28 +136,15 @@ function createNavigatorAttendance(options) {
   let settlementTail = Promise.resolve();
   let settlementFailure;
   let preparationFailure;
-  let routePlaybookReadFailure;
+  let observedRoutePlaybookFailure;
   let disposed = false;
   let closing;
   const nestCancel = new AbortController();
-  let warmedHelp;
   const sessionHostContext = () => {
     const parentSignal = options.context.signal;
     const signal = parentSignal === void 0 ? nestCancel.signal : AbortSignal.any([nestCancel.signal, parentSignal]);
     return { ...options.context, signal };
   };
-  const loadLiveHelp = async () => {
-    try {
-      return await Promise.all(
-        NAVIGATOR_TARGETS.map(async ({ role }) => ({
-          role,
-          help: await options.loadRoleHelp(role)
-        }))
-      );
-    } catch (error) {
-      throw navigatorUnavailableError("transport", error);
-    }
-  };
   const unavailable = (invocationId, reason) => {
     const failure = reason instanceof NavigatorUnavailableError ? reason : navigatorUnavailableError("unknown", reason);
     return {
@@ -167,7 +154,6 @@ function createNavigatorAttendance(options) {
       unavailableCause: failure.unavailableCause
     };
   };
-  let routePlaybookSettlement;
   let prepareBoundSettlement;
   const loadMaterialsAndSession = async (invocationId) => {
     if (contextError !== void 0) throw navigatorUnavailableError("context", contextError);
@@ -177,30 +163,6 @@ function createNavigatorAttendance(options) {
         new Error("controlling authority content was not supplied as typed work context")
       );
     }
-    let soul;
-    let modelSetting;
-    let help;
-    let routePlaybook = "";
-    routePlaybookReadFailure = void 0;
-    const soulPromise = (async () => {
-      try {
-        const text = (await options.loadSoul()).trim();
-        if (!text) throw new Error("Navigator soul is empty");
-        return text;
-      } catch (error) {
-        throw navigatorUnavailableError("context", error);
-      }
-    })();
-    const routePlaybookPromise = (async () => {
-      if (options.loadRoutePlaybook === void 0) return "";
-      try {
-        return await options.loadRoutePlaybook();
-      } catch (error) {
-        routePlaybookReadFailure = error instanceof Error ? error.message : String(error);
-        return "";
-      }
-    })();
-    routePlaybookSettlement = routePlaybookPromise.then(() => void 0);
     const modelPromise = (async () => {
       try {
         const resolved = await resolveNavigatorSeatSelection(options.context);
@@ -210,23 +172,13 @@ function createNavigatorAttendance(options) {
         throw navigatorUnavailableError("model", error);
       }
     })();
-    const helpPromise = warmedHelp ?? loadLiveHelp();
-    warmedHelp = void 0;
-    [soul, routePlaybook, modelSetting, help] = await Promise.all([
-      soulPromise,
-      routePlaybookPromise,
-      modelPromise,
-      helpPromise
-    ]);
+    const modelSetting = await modelPromise;
     let model;
     try {
       model = parseNavigatorModelSetting(modelSetting);
     } catch (error) {
       throw navigatorUnavailableError("model", error);
     }
-    const helpContext = help.map(({ role, help: text }) => `<role_help role="${role}">
-${text}
-</role_help>`).join("\n");
     const tool = createNavigatorPrepareTool((value) => {
       outputSink?.(value);
     });
@@ -271,9 +223,9 @@ ${text}
     }
     if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
     if (session === void 0) throw new Error("Navigator session was not created");
-    return { soul, routePlaybook, helpContext, modelSetting, model, help, activeSession: session };
+    return session;
   };
-  const prepare = async (materialsBundle) => {
+  const prepare = async (existingSession) => {
     const boundSettlement = prepareBoundSettlement;
     prepareBoundSettlement = void 0;
     const invocationId = invocationPrincipal;
@@ -290,73 +242,19 @@ ${text}
       const merged = [prior, next].filter((part) => part.trim() !== "").join("\n\n");
       output = { prose: merged };
     };
-    const { soul, routePlaybook, helpContext, help, activeSession } = materialsBundle ?? await loadMaterialsAndSession(invocationId);
-    const publicSettlementHistory = activeSession.entries().filter((entry) => exactRecord(entry) && entry.type === "custom" && entry.customType === SETTLEMENT_ENTRY && exactRecord(entry.data)).map((entry) => entry.data);
-    const projection = {
-      subjectKey,
-      subject,
-      authority,
-      currentRole: { role: options.role, phase: options.phase },
-      ...boundSettlement === void 0 ? {} : { currentSettlement: boundSettlement },
-      publicSettlementHistory,
-      liveRoleHelp: help
-    };
-    activeSession.appendEntry(CONTEXT_ENTRY, projection);
-    const request = boundSettlement === void 0 ? [
-      "\u672C\u8F6E\u4E3A\u5F85\u547D\u8F6E\u3002",
-      `<navigator_soul>
-${soul}
-</navigator_soul>`,
-      ...routePlaybookReadFailure === void 0 ? [`<route_playbook>
-${routePlaybook}
-</route_playbook>`] : ["\u53EF\u9009\u8DEF\u7EBF\u624B\u518C\u672A\u80FD\u8BFB\u53D6\u3002"],
-      `<work_subject>
-${subject}
-</work_subject>`,
-      `<controlling_authority>
-${authority}
-</controlling_authority>`,
-      `<current_role>
-${JSON.stringify({ role: options.role, phase: options.phase })}
-</current_role>`,
-      `<public_settlement_history>
-${JSON.stringify(projection.publicSettlementHistory)}
-</public_settlement_history>`,
-      `<live_role_help>
-${helpContext}
-</live_role_help>`
-    ].join("\n\n") : [
-      "\u672C\u8F6E\u4E3A\u7ED3\u7B97\u6295\u5582\u8F6E\u3002",
-      `<navigator_soul>
-${soul}
-</navigator_soul>`,
-      ...routePlaybookReadFailure === void 0 ? [`<route_playbook>
-${routePlaybook}
-</route_playbook>`] : ["\u53EF\u9009\u8DEF\u7EBF\u624B\u518C\u672A\u80FD\u8BFB\u53D6\u3002"],
-      `<work_subject>
-${subject}
-</work_subject>`,
-      `<controlling_authority>
-${authority}
-</controlling_authority>`,
-      `<current_role>
-${JSON.stringify({ role: options.role, phase: options.phase })}
-</current_role>`,
-      `<current_settlement>
-${JSON.stringify(boundSettlement)}
-</current_settlement>`,
-      `<public_settlement_history>
-${JSON.stringify(projection.publicSettlementHistory)}
-</public_settlement_history>`,
-      `<live_role_help>
-${helpContext}
-</live_role_help>`
-    ].join("\n\n");
+    const activeSession = existingSession ?? await loadMaterialsAndSession(invocationId);
+    if (boundSettlement === void 0) return void 0;
+    const request = JSON.stringify({
+      ...boundSettlement,
+      invocationId,
+      subjectKey
+    });
     try {
       try {
         if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
         const delivery = createReceiptDeliveryPolicy();
         const promptAllowingRejectedPrepare = async (text, deliveryRequest) => {
+          await persistNavigatorWorkBase(activeSession.recordPointer(), { subject, authority });
           const entryStart = activeSession.entries().length;
           prepareBatchRejected = false;
           let promptFailure;
@@ -387,7 +285,7 @@ ${helpContext}
         await promptAllowingRejectedPrepare(request, false);
         if (boundSettlement !== void 0) {
           while (output === void 0 && prepareBatchRejected && delivery.nextAction() === "request-delivery") {
-            await promptAllowingRejectedPrepare(RECEIPT_DELIVERY_PROMPT, true);
+            await promptAllowingRejectedPrepare(JSON.stringify(delivery.deliveryState()), true);
           }
           if (output === void 0 && delivery.nextAction() === "request-delivery") {
             while (delivery.nextAction() === "request-delivery") {
@@ -427,6 +325,8 @@ ${helpContext}
       preparedProse = normalizePrepareProse(output);
       return preparedProse;
     } finally {
+      const playbookFailure = activeSession.routePlaybookReadFailure?.();
+      observedRoutePlaybookFailure = typeof playbookFailure === "string" && playbookFailure.trim() !== "" ? playbookFailure : void 0;
       outputSink = void 0;
     }
   };
@@ -444,16 +344,6 @@ ${helpContext}
       contextError = next.contextError;
       return closing2;
     },
-    /**
-     * Start live-help subprocesses during activation without beginning full
-     * preparation. Next prepare() consumes the warm result; a later prepare
-     * reloads so live help edits remain visible.
-     */
-    warmHelp() {
-      if (disposed || warmedHelp !== void 0 || preparation !== void 0) return;
-      warmedHelp = loadLiveHelp();
-      void warmedHelp.catch(() => void 0);
-    },
     prepare() {
       if (disposed || preparation !== void 0) return;
       preparationFailure = void 0;
@@ -468,9 +358,6 @@ ${helpContext}
     isPreparing() {
       return preparationInFlight;
     },
-    knownRoutePlaybookReadFailure() {
-      return routePlaybookReadFailure;
-    },
     settle(settlement) {
       const next = settlementTail.then(() => settleOnce(settlement));
       settlementTail = next.catch((error) => {
@@ -497,6 +384,7 @@ ${helpContext}
   };
   async function settleOnce(settlement) {
     if (disposed) return;
+    observedRoutePlaybookFailure = void 0;
     const invocationId = activeInvocationId ?? invocationPrincipal;
     let report;
     if (sessionReady !== void 0) {
@@ -535,10 +423,10 @@ ${helpContext}
       }
     } else {
       if (session !== void 0) preparationFailure = void 0;
-      let coldMaterials;
+      let coldSession;
       if (session === void 0 && preparationFailure === void 0) {
         try {
-          coldMaterials = await loadMaterialsAndSession(invocationId);
+          coldSession = await loadMaterialsAndSession(invocationId);
         } catch (error) {
           preparationFailure = error;
         }
@@ -546,7 +434,7 @@ ${helpContext}
       session?.appendEntry(SETTLEMENT_ENTRY, settlementFact);
       if (preparationFailure === void 0) {
         prepareBoundSettlement = settlement;
-        preparation = prepare(coldMaterials);
+        preparation = prepare(coldSession);
         void preparation.catch((error) => {
           preparationFailure = error;
         });
@@ -565,9 +453,8 @@ ${helpContext}
         report = { disposition: "no-advice" };
       }
     }
-    await routePlaybookSettlement;
-    if (routePlaybookReadFailure !== void 0) {
-      report = { ...report, routePlaybookReadFailure };
+    if (observedRoutePlaybookFailure !== void 0) {
+      report = { ...report, routePlaybookReadFailure: observedRoutePlaybookFailure };
     }
     const event = {
       version: 1,
@@ -594,8 +481,6 @@ ${helpContext}
     sessionReady = void 0;
     preparedProse = void 0;
     preparationFailure = void 0;
-    routePlaybookSettlement = void 0;
-    routePlaybookReadFailure = void 0;
   }
 }
 function registerNavigatorModelCommand(pi, path = navigatorModelSettingPath()) {
@@ -608,8 +493,8 @@ function registerNavigatorModelCommand(pi, path = navigatorModelSettingPath()) {
 }
 export {
   NAVIGATOR_EVENT_TYPE,
-  NAVIGATOR_PREPARE_ACCEPTED_TEXT,
   NAVIGATOR_PREPARE_TOOL_NAME,
+  NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY,
   NAVIGATOR_TARGETS,
   NavigatorUnavailableError,
   createNativeNavigatorSessionFactory,

package/dist/navigator-invocation-identity.js

@@ -2,6 +2,7 @@ import { LEGACY_REVIEW_OUTPUT_ROLES, PACKAGED_ROLE_REGISTRY } from "./packaged-r
 import { isUuidV7, uuidv7 } from "./uuidv7.js";
 import { workSubjectKeysEqual } from "./work-subject-identity.js";
 const NAVIGATOR_INVOCATION_ENTRY = "ak-navigator-invocation";
+const NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY = "ak-navigator-route-playbook-failure";
 const NAVIGATOR_INFRASTRUCTURE_FAILURE_KIND = "role_infrastructure_failure";
 const NAVIGATOR_INFRASTRUCTURE_FAILURE_KEYS = [
   "kind",
@@ -221,6 +222,7 @@ export {
   NAVIGATOR_INFRASTRUCTURE_FAILURE_EVIDENCE_KEYS,
   NAVIGATOR_INFRASTRUCTURE_FAILURE_KIND,
   NAVIGATOR_INVOCATION_ENTRY,
+  NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY,
   bindCurrentDurableTerminalToMarker,
   buildNavigatorInfrastructureFailureFact,
   classifyPackagedRoleTerminalResult,

package/dist/navigator-public-session.js

@@ -1,3 +1,4 @@
+import { existsSync } from "node:fs";
 import { basename } from "node:path";
 import { sitianReport } from "./sitian-facade.js";
 import {
@@ -10,6 +11,10 @@ import {
 import { runDirectoryFromHostContext } from "./host-contracts.js";
 import { CliUsageError } from "./public-cli/cli-errors.js";
 import { isNavigatorSeat } from "./packaged-role-registry.js";
+import {
+  attachWorkContextPointer,
+  navigatorWorkContextFile
+} from "./navigator-work-base.js";
 async function resolveNavigatorLedgerHome(context) {
   const { tryHomeFromAkRolesPath } = await import("./activation-ledger-topology.js");
   const runDirectory = runDirectoryFromHostContext(context);
@@ -73,6 +78,7 @@ function createNativeNavigatorSessionFactory(deps) {
     });
     let providerFailure;
     let noReceipt;
+    let routePlaybookReadFailure;
     let disposed = false;
     let hostRunId = readNavigatorHostRunPointer(sessionManager.getEntries());
     const summon = deps?.summonPublicRole ?? (async (options) => {
@@ -86,13 +92,16 @@ function createNativeNavigatorSessionFactory(deps) {
         }
         providerFailure = void 0;
         noReceipt = void 0;
+        routePlaybookReadFailure = void 0;
         try {
           const summonHome = await resolveNavigatorLedgerHome(context);
           if (disposed) return;
           const resumeRunId = hostRunId;
+          const workContextPath = navigatorWorkContextFile(sessionManager.getSessionDir());
+          const argvText = existsSync(workContextPath) ? attachWorkContextPointer(text, workContextPath) : text;
           const baseSummon = {
             role: "navigator",
-            argv: [text],
+            argv: [argvText],
             cwd: context.cwd,
             ...summonHome === void 0 ? {} : { home: summonHome },
             ...context.signal === void 0 ? {} : { signal: context.signal }
@@ -113,6 +122,8 @@ function createNativeNavigatorSessionFactory(deps) {
             }
           }
           if (disposed) return;
+          const playbookFailure = summoned.terminal?.navigator?.advisoryDiagnostic;
+          routePlaybookReadFailure = typeof playbookFailure === "string" && playbookFailure.trim() !== "" ? playbookFailure : void 0;
           const outcome = summoned.terminal?.roleOutcome;
           if (outcome === void 0) {
             const detail = summoned.stderr?.trim() || `exit ${summoned.exitCode}`;
@@ -171,6 +182,7 @@ function createNativeNavigatorSessionFactory(deps) {
       },
       providerFailure: () => providerFailure,
       noReceipt: () => noReceipt,
+      routePlaybookReadFailure: () => routePlaybookReadFailure,
       appendEntry: (customType, data) => {
         sessionManager.appendCustomEntry(customType, data);
         try {