@akagilnc/pi-workflow-roles 0.1.5068 → 0.1.5096

package/src/navigator-work-base.ts

@@ -0,0 +1,123 @@
+/**
+ * Durable work subject and controlling authority for one navigator nest.
+ * Settlement user turns keep a path pointer; the navigator system prompt
+ * loads the bytes once per agent start from this file (base material).
+ */
+import { existsSync, realpathSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+
+import { writeFileAtomically } from "./atomic-write.ts";
+
+export const NAVIGATOR_WORK_CONTEXT_BASENAME = "work-context.json";
+
+export type NavigatorWorkBase = {
+  readonly subject: string;
+  readonly authority: string;
+};
+
+export function navigatorWorkContextFile(sessionDir: string): string {
+  return join(sessionDir, NAVIGATOR_WORK_CONTEXT_BASENAME);
+}
+
+/** Nest file only: books/.../navigator/<sha256-32>/work-context.json. */
+export function isNavigatorWorkContextFile(path: string): boolean {
+  const resolved = resolve(path);
+  if (basename(resolved) !== NAVIGATOR_WORK_CONTEXT_BASENAME) return false;
+  const nest = dirname(resolved);
+  if (!/^[0-9a-f]{32}$/.test(basename(nest))) return false;
+  return basename(dirname(nest)) === "navigator";
+}
+
+function canonicalNavigatorWorkContextFile(path: string): string | undefined {
+  if (!isNavigatorWorkContextFile(path)) return undefined;
+  try {
+    const real = realpathSync(path);
+    return isNavigatorWorkContextFile(real) ? real : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+export async function persistNavigatorWorkBase(
+  sessionDir: string,
+  body: NavigatorWorkBase,
+): Promise<string | undefined> {
+  if (sessionDir.trim() === "" || !existsSync(sessionDir)) return undefined;
+  if (body.authority.trim() === "") return undefined;
+  const path = navigatorWorkContextFile(sessionDir);
+  const next = `${JSON.stringify({ subject: body.subject, authority: body.authority })}\n`;
+  try {
+    const current = await readFile(path, "utf8");
+    if (current === next) return path;
+  } catch (error) {
+    if (!(error instanceof Error && "code" in error && (error as NodeJS.ErrnoException).code === "ENOENT")) {
+      throw error;
+    }
+  }
+  await writeFileAtomically(path, next);
+  return path;
+}
+
+export async function readNavigatorWorkBase(path: string): Promise<NavigatorWorkBase | undefined> {
+  const canonical = canonicalNavigatorWorkContextFile(path);
+  if (canonical === undefined) return undefined;
+  let text: string;
+  try {
+    text = await readFile(canonical, "utf8");
+  } catch (error) {
+    if (error instanceof Error && "code" in error && (error as NodeJS.ErrnoException).code === "ENOENT") {
+      return undefined;
+    }
+    throw error;
+  }
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return undefined;
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return undefined;
+  const record = parsed as Record<string, unknown>;
+  if (typeof record.subject !== "string" || typeof record.authority !== "string") return undefined;
+  if (record.authority.trim() === "") return undefined;
+  return { subject: record.subject, authority: record.authority };
+}
+
+function jsonObjectFromPrompt(prompt: string): Record<string, unknown> | undefined {
+  const head = prompt.trimStart().split("\n\n", 1)[0] ?? "";
+  if (!head.startsWith("{")) return undefined;
+  try {
+    const parsed: unknown = JSON.parse(head);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return undefined;
+    return parsed as Record<string, unknown>;
+  } catch {
+    return undefined;
+  }
+}
+
+export function workContextPathFromPrompt(prompt: string): string | undefined {
+  const record = jsonObjectFromPrompt(prompt);
+  const path = record?.workContextPath;
+  if (typeof path !== "string" || path.trim() === "") return undefined;
+  return isNavigatorWorkContextFile(path) ? path : undefined;
+}
+
+/** Settlement JSON gains the nest pointer. Non-JSON prompts stay unchanged. */
+export function attachWorkContextPointer(text: string, workContextPath: string): string {
+  const record = jsonObjectFromPrompt(text);
+  if (record === undefined) return text;
+  if (typeof record.workContextPath === "string" && record.workContextPath.trim() !== "") return text;
+  const head = text.trimStart().split("\n\n", 1)[0] ?? "";
+  const rest = text.trimStart().slice(head.length);
+  return `${JSON.stringify({ ...record, workContextPath })}${rest}`;
+}
+
+/** System-prompt base for one agent start. Absent or unreadable file yields undefined. */
+export async function loadNavigatorWorkBaseSuffix(prompt: string): Promise<string | undefined> {
+  const path = workContextPathFromPrompt(prompt);
+  if (path === undefined) return undefined;
+  const body = await readNavigatorWorkBase(path);
+  if (body === undefined) return undefined;
+  return `<work_subject>\n${body.subject}\n</work_subject>\n\n<controlling_authority>\n${body.authority}\n</controlling_authority>`;
+}

package/src/notary-contracts.ts

@@ -23,10 +23,6 @@ export const NOTARY_TICKET_FLAG = {
   },
 } as const;
 
-/** Package-owned kickoff only — callers supply zero prompt bytes (ADR 0067 / #448). */
-export const NOTARY_FIXED_KICKOFF =
-  "符宝郎案卷已受理；来源 run 定位见会话材料。";
-
 export const notaryOutputSchema = reviewSubmissionSchema;
 
 export type NotarySourceRunLocator = {

package/src/open-tool-schema.ts

@@ -12,7 +12,7 @@ function declarationIdentity(schema: TSchema): string {
   return JSON.stringify(semantic);
 }
 
-/** Collapse transport variants into one provider-compatible, zero-required open object. */
+/** Collapse transport variants into one provider-compatible open object. Non-three-state tools stay zero-required. */
 export function openToolObjectFromUnion(schema: UnionSchema): TSchema {
   const declarations = new Map<string, TSchema[]>();
   for (const variant of schema.anyOf) {
@@ -35,10 +35,15 @@ export function openToolObjectFromUnion(schema: UnionSchema): TSchema {
   return object;
 }
 
-/** Open a pre-existing object transport schema without changing declarations. */
-export function openToolObject(schema: TSchema & { properties: Record<string, TSchema> }): TSchema {
+/** Open a pre-existing object transport schema. Every field stays optional. */
+export function openToolObject(
+  schema: TSchema & { properties: Record<string, TSchema> },
+): TSchema {
   const object = Type.Object(
-    Object.fromEntries(Object.entries(schema.properties).map(([name, declaration]) => [name, Type.Optional(described(name, declaration))])),
+    Object.fromEntries(Object.entries(schema.properties).map(([name, declaration]) => [
+      name,
+      Type.Optional(described(name, declaration)),
+    ])),
     { additionalProperties: true },
   );
   (object as unknown as { required: string[] }).required = [];

package/src/package-contracts/fixer-output.ts

@@ -41,7 +41,7 @@ const completedClassResultsSchema = Type.Array(completedClassResultSchema);
 // (src/countersign-role.ts) — one shared description across every variant
 // so openToolObjectFromUnion's identical-declaration collapse drops none of it.
 const FIXER_STATUS_DESCRIPTION =
-  "planned | completed | refused | unfinished | partially_completed — 形状指引，非 schema 闸；unfinished 缺前置或违宪约束致本局未完成时可用，缺待决 owner 决定或答复属缺前置。" as const;
+  "planned | completed | refused | unfinished | partially_completed。unfinished 缺前置或违宪约束致本局未完成时可用，缺待决 owner 决定或答复属缺前置。" as const;
 const fixerOutputVariants = Type.Union([
   Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "如实结果报告" }) }),
   Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "如实结果报告" }), remainingScope: Type.String({ description: "依法不能完成的工作范围" }), blocker: Type.Unsafe({ ...blockerSchema, description: "合法阻断完成的 blocker" }) }),

package/src/package-contracts/gatekeeper-output.ts

@@ -1,6 +1,6 @@
 /**
  * Public Gatekeeper (门下省) terminating receipt contracts (#639).
- * Direct public seat shares the province decision shape: dispatch | pass.
+ * Direct public seat decision shape. status field semantics: dispatch | pass.
  * No usable result is infrastructure failure via public settlement, not a judgment status (#475).
  */
 import { Type } from "typebox";
@@ -14,7 +14,7 @@ export const GATEKEEPER_OUTPUT_TOOL_NAME = "ak_gatekeeper_output";
 export const gatekeeperDecisionSchema = openToolObject(
   Type.Object({
     status: Type.Unknown({
-      description: "dispatch | pass — 形状指引，非 schema 闸",
+      description: "dispatch | pass",
     }),
     officer: Type.Unknown({
       description: "status 为 dispatch 时为 inspector | notary",
@@ -43,7 +43,7 @@ function asStringArray(value: unknown): readonly string[] {
 }
 
 /**
- * Project one lawful explicit Gatekeeper decision (dispatch | pass).
+ * Project one explicit Gatekeeper decision.
  * No throw on shape — ADR 0055 / 第 0 条: already-submitted params are retained as-is;
  * public-terminal projects non-usable releases via typed failure cause.
  */

package/src/package-contracts/judge-output.ts

@@ -1,7 +1,7 @@
 /** Package-owned Judge output leaf — no role registration surface. */
 
 
-import { REVIEW_SUBMISSION_OUTPUT_TOOL_NAME } from "../review-submission.ts";
+import { REVIEW_QUEUE_STATUSES, REVIEW_SUBMISSION_OUTPUT_TOOL_NAME } from "../review-submission.ts";
 
 export const JUDGE_OUTPUT_TOOL_NAME: string = REVIEW_SUBMISSION_OUTPUT_TOOL_NAME;
 
@@ -39,9 +39,7 @@ export function validateAcceptedJudgeDetails(verdict: unknown): JudgeVerdict {
   if (typeof status !== "string") {
     throw new Error("Judge verdict has no execution discriminator");
   }
-  if (
-    ["converged", "continue", "escalate"].includes(status)
-  ) {
+  if (REVIEW_QUEUE_STATUSES.has(status)) {
     return verdict as JudgeVerdict;
   }
   throw new Error("Judge verdict has no execution discriminator");

package/src/package-contracts/navigator-output.ts

@@ -16,7 +16,7 @@ export const navigatorOutputSchema = withTerminatingOutputDeclarations(
   openToolObject(
     Type.Object({
       prose: Type.Unknown({
-        description: "游奕使散文建议，原样呈现。不要求 candidates/next 等结构化字段。形状指引，非 schema 闸",
+        description: "游奕使散文建议，原样呈现。不要求 candidates/next 等结构化字段。",
       }),
     }),
   ),

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

@@ -28,14 +28,12 @@ export const INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY = "diagnostic" as const;
 const infrastructureFailureNested = Type.Object(
   {
     [INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY]: Type.Unknown({
-      description:
-        "非空基础设施失败诊断字符串。无失败时必须省略整个 infrastructureFailure。形状指引，非 schema 闸。",
+      description: "基础设施失败诊断字符串。",
     }),
   },
   {
     additionalProperties: true,
-    description:
-      "基础设施真实失败声明（如需）。规范形：{ diagnostic: 非空诊断字符串 }；无失败时必须省略。形状指引，非 schema 闸。",
+    description: "仅基础设施真实失败时出现。",
   },
 );
 // Open nested required so host cannot pure-shape-reject the declaration fragment.
@@ -50,8 +48,9 @@ const infrastructureFailureDeclarationSchema = Type.Object(
 
 /**
  * Compose declarations shared by terminating output tools: infrastructure failure
- * and the optional role-asserted ticket identity. Returns an open object (additionalProperties: true,
- * required: []) with the base schema's properties plus the shared declaration.
+ * and the optional role-asserted ticket identity. Returns an open object (additionalProperties: true)
+ * with the base schema's properties plus the shared declaration. Incoming required
+ * keys that still exist are kept; every other key stays optional.
  * Static typing is preserved on the base (`as S`), so existing
  * `Static<typeof ...>` derived parameter types are unchanged.
  */
@@ -66,8 +65,7 @@ export function withTerminatingOutputDeclarations<
       baseProperties?.ticketNumber === undefined
         ? {
             ticketNumber: Type.Unknown({
-              description:
-                "可选本票号：尚未绑定时由角色在既有回执中申报；机械层只记录合法正整数，不从散文推导、不验真。缺失或错形不拒收。",
+              description: "可选本票号。尚未绑定时由角色在既有回执中申报。",
             }),
           }
         : {}
@@ -78,7 +76,11 @@ export function withTerminatingOutputDeclarations<
       ],
   };
   const object = Type.Object(properties, { additionalProperties: true });
-  (object as unknown as { required: string[] }).required = [];
+  const incoming = (schema as { required?: unknown }).required;
+  const preserved = Array.isArray(incoming)
+    ? incoming.filter((key): key is string => typeof key === "string" && Object.hasOwn(properties, key))
+    : [];
+  (object as unknown as { required: string[] }).required = preserved;
   return object as unknown as S;
 }
 
@@ -115,7 +117,7 @@ function isInfrastructureFailureDeclaration(
 }
 
 /** Non-empty trimmed diagnostic from the declaration, else undefined. */
-function infrastructureFailureDiagnostic(
+export function infrastructureFailureDiagnostic(
   parameters: unknown,
 ): string | undefined {
   if (!isInfrastructureFailureDeclaration(parameters)) return undefined;

package/src/packaged-role-registry.ts

@@ -52,6 +52,7 @@ export const NOTARY_SESSION_MATERIALS = [
   "souls/audit-law.md",
   "souls/ticket-law.md",
   "souls/gate-output-guide.md",
+  "docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md",
 ] as const;
 
 /** Shared by public inspector and gatekeeper-province inspector. */
@@ -61,6 +62,7 @@ export const INSPECTOR_SESSION_MATERIALS = [
   "souls/audit-law.md",
   "souls/quality-law.md",
   "souls/gate-output-guide.md",
+  "docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md",
 ] as const;
 
 /**
@@ -75,6 +77,7 @@ export const AUDITOR_PUBLIC_SESSION_MATERIALS = [
   "souls/doctor-auditor.md",
   "souls/audit-law.md",
   "souls/quality-law.md",
+  "docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md",
 ] as const;
 
 /**
@@ -107,6 +110,7 @@ export const PUBLIC_ROLE_RECORDS = [
       "souls/audit-law.md",
       "souls/quality-law.md",
       "souls/judge-output-guide.md",
+      "docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md",
     ],
   },
   {
@@ -384,7 +388,7 @@ export 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/src/public-cli/countersign-run.ts

@@ -369,7 +369,7 @@ export async function runCountersignCourtDiaristStation(
   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/src/public-cli/invocation.ts

@@ -87,7 +87,6 @@ import { sha256Hex } from "../sha256.ts";
 import { rehomeUnboundTicketProvenance } from "../ticket-provenance.ts";
 import { uuidv7 } from "../uuidv7.ts";
 import {
-  NOTARY_FIXED_KICKOFF,
   type NotarySourceRunLocator,
 } from "../notary-contracts.ts";
 import {
@@ -2150,6 +2149,7 @@ type InstructionTransportSource = {
   readonly baseRevision?: string;
   readonly lens?: ReviewerLens;
   readonly authorityRefs?: readonly string[];
+  readonly sourceRunPath?: string;
 };
 
 function admittedTransportPromptKind(
@@ -2172,13 +2172,16 @@ export function buildInstructionTransportPrompt(
 ): string {
   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);
     }

package/src/public-cli/settlement.ts

@@ -99,6 +99,7 @@ import {
   isAcceptedPackagedRoleTerminalResult,
   isReceiptSettlementBindingClear,
   NAVIGATOR_INVOCATION_ENTRY,
+  NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY,
   parseInvocationMarkerIdentity,
   type InvocationMarkerIdentity,
 } from "../navigator-invocation-identity.ts";
@@ -2249,8 +2250,28 @@ async function withOptionalGateProjection<
   return attachEngineDetourToolUsage(next, sessionDirectory, gateContext);
 }
 
+function routePlaybookFailureMessage(entries: readonly SessionEntry[]): string | undefined {
+  for (let i = entries.length - 1; i >= 0; i -= 1) {
+    const entry = entries[i];
+    if (entry?.type !== "custom" || entry.customType !== NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY) continue;
+    const data = entry.data;
+    if (!isRecord(data) || typeof data.message !== "string" || data.message.trim() === "") return undefined;
+    return data.message;
+  }
+  return undefined;
+}
+
 export function extractNavigatorFact(
   entries: readonly SessionEntry[],
+): TerminalNavigatorFact {
+  const fact = extractNavigatorAttendanceFact(entries);
+  if (fact.advisoryDiagnostic !== undefined) return fact;
+  const message = routePlaybookFailureMessage(entries);
+  return message === undefined ? fact : { ...fact, advisoryDiagnostic: message };
+}
+
+function extractNavigatorAttendanceFact(
+  entries: readonly SessionEntry[],
 ): TerminalNavigatorFact {
   // Affirmative attendance only. Missing / uncorrelated / unparseable is never no-advice.
   // Minimal provenance: latest durable terminal + nearest preceding marker +

package/src/receipt-delivery-policy.ts

@@ -1,6 +1,5 @@
 /** Shared accepted-receipt delivery budget for role, auditor, and Navigator sessions (#288). */
 export const RECEIPT_DELIVERY_TURN_LIMIT = 2 as const;
-export const RECEIPT_DELIVERY_PROMPT = "本会话尚无已接受的 typed 回执。";
 
 export const NO_RECEIPT_LIFECYCLE_ENTRY_TYPE = "ak-no-receipt-lifecycle" as const;
 
@@ -104,6 +103,15 @@ export function createReceiptDeliveryPolicy() {
       if (accepted) return "accepted";
       return deliveryTurns < RECEIPT_DELIVERY_TURN_LIMIT ? "request-delivery" : "no-receipt";
     },
+    /** Current typed delivery facts. No prose. */
+    deliveryState() {
+      return {
+        terminalToolCalled,
+        rejectedReceipts: rejectedReceipts.map((item) => ({ ...item })),
+        deliveryTurns,
+        acceptedReceipt: false as const,
+      };
+    },
     facts(binding: { runPointer: string; attemptPointer: string }): NoReceiptLifecycleFacts {
       return noReceiptLifecycleFacts({ terminalToolCalled, rejectedReceipts: [...rejectedReceipts], deliveryTurns, ...binding });
     },

package/src/review-submission.ts

@@ -1,18 +1,33 @@
-/** One shared terminating receipt contract for review officers (#1028). */
+/** One shared terminating receipt contract for review officers (#1028 / #1055). */
 import { Type } from "typebox";
 
-import { openToolObject } from "./open-tool-schema.ts";
 import { withTerminatingOutputDeclarations } from "./package-contracts/terminating-infrastructure.ts";
 
 export const REVIEW_SUBMISSION_OUTPUT_TOOL_NAME = "ak_submission_output" as const;
 
-/** Open receipt: the queue reads only status; all other submitted fields ride unchanged. */
+/** Single schema copy of the review queue words. Runtime membership reads this set. */
+export const REVIEW_QUEUE_WORDS = ["converged", "continue", "escalate"] as const;
+export type ReviewQueueWord = (typeof REVIEW_QUEUE_WORDS)[number];
+export const REVIEW_QUEUE_STATUSES: ReadonlySet<string> = new Set(REVIEW_QUEUE_WORDS);
+
+/**
+ * One object root. Codex structured output rejects a root anyOf, and status
+ * stays a required three-state enum with no omitted-status failure branch.
+ * External-dependency failure while the seat can still submit:
+ * docs/adr/0057-schema-narrowing-cuts-the-required-set-not-the-declared-set.md
+ */
 export const reviewSubmissionSchema = withTerminatingOutputDeclarations(
-  openToolObject(
-    Type.Object({
-      status: Type.Optional(Type.Unknown({
-        description: "converged | continue | escalate — 非三态时请重读后重交，勿改标。",
-      })),
+  Type.Object({
+      status: Type.Union(
+        [
+          Type.Literal(REVIEW_QUEUE_WORDS[0]),
+          Type.Literal(REVIEW_QUEUE_WORDS[1]),
+          Type.Literal(REVIEW_QUEUE_WORDS[2]),
+        ],
+        {
+          description: "审核席本轮裁决的判别状态。",
+        },
+      ),
       findings: Type.Optional(Type.Unknown({ description: "审核发现，原样留存" })),
       reason: Type.Optional(Type.Unknown({ description: "上呈理由" })),
       violations: Type.Optional(Type.Unknown({ description: "违规条目" })),
@@ -22,8 +37,7 @@ export const reviewSubmissionSchema = withTerminatingOutputDeclarations(
       note: Type.Optional(Type.Unknown({ description: "裁决附注" })),
       evidence: Type.Optional(Type.Unknown({ description: "留存证据" })),
       decisionGate: Type.Optional(Type.Unknown({ description: "需人权威处置的问题与选项；可说明 question、options，原样留存" })),
-    }),
-  ),
+    }, { additionalProperties: true }),
 );
 
 export type ReviewSubmission = { readonly status?: unknown; readonly [key: string]: unknown };

package/src/reviewer-role.ts

@@ -29,7 +29,7 @@ const reviewerAmendmentsSchema = Type.Object({
 }, {
   additionalProperties: true,
   description:
-    "已运行 lens 的 amendments 承载 candidates、逐条处置与 verdict 的完整报告（非仅 verdict 行）；显式单轴时另一轴可省略。hard-stop／usage error 为 refused 时，已产出报告仍照录对应 lens 字段。形状指引，非 schema 闸。",
+    "已运行 lens 的 amendments 承载 candidates、逐条处置与 verdict 的完整报告（非仅 verdict 行）；显式单轴时另一轴可省略。hard-stop／usage error 为 refused 时，已产出报告仍照录对应 lens 字段。",
 });
 // #836 r16 class 1: diagnostic is LLM/human-read narrative content — no code
 // branches on its length (src/reviewer-role.ts consumer: reviewer content is
@@ -40,7 +40,7 @@ const reviewerAmendmentsSchema = Type.Object({
 // #917 §6: both normal lens verdicts → completed; hard-stop/usage error → refused
 // (report already produced still lands in selected-lens amendments).
 const REVIEWER_STATUS_DESCRIPTION =
-  "completed | refused — 形状指引，非 schema 闸。两种正常 lens verdict（completeness / correctness）均 completed；hard-stop 与 usage error 为 refused（已产出报告仍照录进所选 lens amendments）。" as const;
+  "completed | refused。两种正常 lens verdict（completeness / correctness）均 completed；hard-stop 与 usage error 为 refused（已产出报告仍照录进所选 lens amendments）。" as const;
 const reviewerOutputVariants = Type.Union([
   Type.Object({
     status: Type.Unknown({ description: REVIEWER_STATUS_DESCRIPTION }),
@@ -90,7 +90,7 @@ export function createReviewerRoleRuntime(
 
       if (!registered) {
         registered = true;
-        pi.registerTool({ name: REVIEWER_OUTPUT_TOOL_NAME, label: "御史台输出", description: "提交御史台终局回执。本席自调 ak-cross-m-review skill。", promptSnippet: "提交御史台终局回执", parameters: reviewerOutputSchema,
+        pi.registerTool({ name: REVIEWER_OUTPUT_TOOL_NAME, label: "御史台输出", description: "提交御史台终局回执。", promptSnippet: "提交御史台终局回执", parameters: reviewerOutputSchema,
           async execute(_id: string, parameters: unknown): Promise<HostToolResult<unknown>> {
             if (!soul) throw new Error("御史台输入未装载");
             return {

package/src/role-runtime-dependencies.ts

@@ -7,7 +7,7 @@ import { loadDoctorCase } from "./doctor-evidence.ts";
 import { createNativeNavigatorSessionFactory, createNavigatorAttendance } from "./navigator-attendance.ts";
 import { loadNavigatorWorkContext } from "./navigator-work-context.ts";
 import { loadNotarySourceRunLocator } from "./notary-source-run.ts";
-import { formatNavigatorRoleHelp, type RoleRuntimeDependencies } from "./role-runtime.ts";
+import { type RoleRuntimeDependencies } from "./role-runtime.ts";
 import {
   loadAuditorReferenceMaterialsFromSubjectInput,
   loadAuditorSoulFromSubjectInput,
@@ -42,7 +42,6 @@ export function createRoleRuntimeDependencies(packageRoot: string): RoleRuntimeD
   // packageRoot is the install root (resources/ lives there). Never resolve via
   // import.meta.url — headless/acp production-host bundles live under dist/*/
   // and would otherwise look for dist/resources/ (#962).
-  const navigatorRoutePlaybookPath = join(packageRoot, "resources/navigator-route-playbook.md");
   const collectorHandbookSeedPath = join(packageRoot, "resources/collector-bot-handbook.md");
   const doctorAuditor = createPiDoctorAuditor();
   const navigatorSessionFactory = createNativeNavigatorSessionFactory();
@@ -72,9 +71,6 @@ export function createRoleRuntimeDependencies(packageRoot: string): RoleRuntimeD
       subject: options.subject,
       authority: options.authority,
       invocationId: options.invocationId,
-      loadSoul: () => loadRegisteredRoleSoul("navigator"),
-      loadRoutePlaybook: () => readFile(navigatorRoutePlaybookPath, "utf8"),
-      loadRoleHelp: async (role) => formatNavigatorRoleHelp(role),
       createSession: navigatorSessionFactory,
       ...(options.contextError === undefined ? {} : { contextError: options.contextError }),
       onEvent: options.onEvent,