@akagilnc/pi-workflow-roles 0.1.5842 → 0.1.5853

package/dist/navigator-route-table.js

@@ -0,0 +1,42 @@
+export const NAVIGATOR_ADVICE_MAX_CHARS = 20;
+const DISPOSE_BY_VERDICT = "按判词处置";
+const ESCALATE_TO_OWNER = "呈陛下裁决";
+const DISPATCH_WORKER = "派将作监开工";
+const SETTLED_TO_JUDGE = "可送大理寺审计";
+const RESUME_SAME_WORKER = "续修，勿送大理寺";
+const ROUTE_ROWS = {
+    secretariat: { converged: DISPATCH_WORKER, escalate: ESCALATE_TO_OWNER },
+    countersign: { converged: DISPATCH_WORKER, continue: DISPOSE_BY_VERDICT, escalate: ESCALATE_TO_OWNER },
+    notary: { converged: "按流程进下一站", continue: DISPOSE_BY_VERDICT, escalate: ESCALATE_TO_OWNER },
+    inspector: { converged: "按流程进下一站", continue: DISPOSE_BY_VERDICT, escalate: ESCALATE_TO_OWNER },
+    coder: {
+        completed: "派御史台",
+        partially_completed: SETTLED_TO_JUDGE,
+        refused: SETTLED_TO_JUDGE,
+        unfinished: RESUME_SAME_WORKER,
+    },
+    fixer: {
+        completed: "直回大理寺复审",
+        partially_completed: SETTLED_TO_JUDGE,
+        refused: SETTLED_TO_JUDGE,
+        unfinished: RESUME_SAME_WORKER,
+    },
+    reviewer: { completed: "派大理寺裁决", refused: "呈调用者处置" },
+    judge: {
+        converged: "调用者合并、关票",
+        continue: DISPOSE_BY_VERDICT,
+        escalate: ESCALATE_TO_OWNER,
+    },
+    gatekeeper: { dispatch: "召所点名的官员", pass: "放行，进下一站" },
+    merger: { completed: "调用者收尾、关票", escalate: ESCALATE_TO_OWNER },
+    diarist: { completed: "继续后续衙门", escalate: ESCALATE_TO_OWNER },
+};
+export const NAVIGATOR_ROUTE_TABLE = ROUTE_ROWS;
+/** 某衙门的全部行；表中无此衙门时为空对象。 */
+export function navigatorRowsForRole(role) {
+    return NAVIGATOR_ROUTE_TABLE[role] ?? {};
+}
+/** 整表：衙门 → (status → 建议)。 */
+export function navigatorFullTable() {
+    return NAVIGATOR_ROUTE_TABLE;
+}

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

@@ -9,6 +9,9 @@ const navigatorAdviceFields = {
   }),
   byStatus: Type.Unknown({
     description: "\u6309\u4E3B\u8859\u95E8\u7ED3\u5C40 status \u9884\u5199\u7684\u6563\u6587\u5EFA\u8BAE\u3002\u952E\u4E3A status \u5B57\u9762\u91CF\uFF0C\u503C\u4E3A\u5EFA\u8BAE\u6B63\u6587\u3002\u7ED3\u7B97\u65F6\u4EE3\u7801\u53EA\u6309\u5B9E\u9645 status \u53D6\u5BF9\u5E94\u539F\u6587\uFF0C\u4E0D\u89E3\u6790\u5EFA\u8BAE\u8BED\u4E49\u3002"
+  }),
+  byRole: Type.Unknown({
+    description: "\u6574\u5F20\u8DEF\u7EBF\u8868\uFF1A\u952E\u4E3A\u8859\u95E8\u89D2\u8272\uFF0C\u503C\u4E3A\u8BE5\u8859\u95E8 status \u2192 \u5EFA\u8BAE\u3002\u76F4\u63A5\u5165\u53E3\u4E0D\u7ED9\u89D2\u8272\u65F6\u4F7F\u7528\u3002"
   })
 };
 const navigatorAdviceBodySchema = openToolObject(Type.Object(navigatorAdviceFields));
@@ -41,9 +44,6 @@ function byStatusFromUnknown(value) {
   }
   return out;
 }
-function byStatusToPlainObject(byStatus) {
-  return Object.fromEntries(byStatus);
-}
 function projectLawfulNavigatorOutput(value) {
   if (value === void 0 || value === null) return void 0;
   if (typeof value === "string") return { prose: value };
@@ -66,12 +66,6 @@ function validateRecordedNavigatorOutput(value) {
   }
   return projected;
 }
-function navigatorProseFromUnknown(value) {
-  const projected = projectLawfulNavigatorOutput(value);
-  if (projected === void 0) return void 0;
-  const trimmed = projected.prose.trim();
-  return trimmed === "" ? void 0 : projected.prose;
-}
 function preparedAdviceFromUnknown(value) {
   if (value === void 0 || value === null) return void 0;
   if (typeof value === "string") {
@@ -125,12 +119,10 @@ function pickPreparedProse(prepared, status) {
 }
 export {
   NAVIGATOR_OUTPUT_TOOL_NAME,
-  byStatusToPlainObject,
   mergePreparedAdvice,
   navigatorAdviceBodySchema,
   navigatorAdviceFields,
   navigatorOutputSchema,
-  navigatorProseFromUnknown,
   pickPreparedProse,
   preparedAdviceFromUnknown,
   projectLawfulNavigatorOutput,

package/dist/packaged-role-registry.js

@@ -61,8 +61,6 @@ const PUBLIC_ROLE_RECORDS = [
     settlement: "sealed",
     /** Factory board: court until another station has started, then marshal. */
     boardPlacement: "judge-history",
-    /** Navigator subject is the public admitted instruction when the run is bound. */
-    navigatorSubject: "public-instruction",
     activationStage: "load-and-install",
     receiptStatusKey: "status",
     sessionMaterials: [
@@ -91,8 +89,6 @@ const PUBLIC_ROLE_RECORDS = [
       reportPhase: true
     },
     boardPlacement: "marshal",
-    /** #1168: dispatch is first message; navigator reads admitted instruction. */
-    navigatorSubject: "public-instruction",
     activationFlags: [
       { field: "phase", flag: "ak-fixer-phase", binds: "phase" }
     ],
@@ -121,8 +117,6 @@ const PUBLIC_ROLE_RECORDS = [
     artifactFace: {
       reportPhase: true
     },
-    /** #1168: dispatch is first message; navigator reads admitted instruction. */
-    navigatorSubject: "public-instruction",
     activationFlags: [
       { field: "phase", flag: "ak-coder-phase", binds: "phase" }
     ],
@@ -216,8 +210,6 @@ const PUBLIC_ROLE_RECORDS = [
     artifactFace: {
       doctorReportFacts: true
     },
-    /** Navigator subject is the doctor case, not the case-path file bytes. */
-    navigatorSubject: "case",
     activationFlags: [
       { field: "casePath", from: "caseRunsPath", flag: "ak-doctor-case", binds: "input" }
     ],
@@ -272,8 +264,6 @@ const PUBLIC_ROLE_RECORDS = [
     gateStageLabel: "\u7B26\u5B9D\u90CE",
     /** Gate summon binds --source-run and keeps dialogue off the argv. */
     gateSummon: "source-run",
-    /** Navigator subject is the source-run locator, not the path file bytes. */
-    navigatorSubject: "source-run",
     activationFlags: [
       { field: "sourceRun", from: "sourceRunPath", flag: "ak-notary-source-run", binds: "input" },
       { field: "ticketNumber", flag: "ak-notary-ticket-number" }
@@ -411,12 +401,14 @@ const PUBLIC_ROLE_RECORDS = [
     role: "navigator",
     inCallAutoResume: false,
     presentSettled: "always",
-    summonResume: true,
+    summonResume: false,
     admission: "instruction",
     sameParent: "none",
     phases: [null],
     outputTool: NAVIGATOR_OUTPUT_TOOL_NAME,
     settlement: "accepted",
+    /** #1192: structured target seat for the lookup run; no host flag (no host runs it). */
+    activationFlags: [{ field: "forRole" }],
     activationStage: "load-and-install",
     sessionMaterials: ["CLAUDE.md", "souls/navigator.md"]
   },
@@ -506,9 +498,6 @@ function packagedRoleActivationFlags(role) {
   if (record === void 0 || !("activationFlags" in record)) return [];
   return record.activationFlags;
 }
-function packagedRoleInputFlag(role) {
-  return packagedRoleActivationFlags(role).find((spec) => spec.binds === "input")?.flag;
-}
 function packagedRolePhaseFlag(role) {
   return packagedRoleActivationFlags(role).find((spec) => spec.binds === "phase")?.flag;
 }
@@ -564,11 +553,6 @@ function packagedAuditToolName(role) {
   if (record === void 0 || !("auditTool" in record)) return void 0;
   return record.auditTool;
 }
-function packagedPublicInstructionSubject(role) {
-  return typeof role === "string" && PUBLIC_ROLE_RECORDS.some(
-    (record) => "navigatorSubject" in record && record.navigatorSubject === "public-instruction" && record.role === role
-  );
-}
 function packagedResumeSourcePath(role) {
   const record = packagedRoleMetadata(role);
   return record !== void 0 && "resumeSourcePath" in record && record.resumeSourcePath === true;
@@ -577,11 +561,6 @@ function packagedProjectsTargetBindRejection(role) {
   const record = packagedRoleMetadata(role);
   return record !== void 0 && "projectTargetBindRejection" in record && record.projectTargetBindRejection === true;
 }
-function packagedNavigatorSubject(role) {
-  const record = packagedRoleMetadata(role);
-  if (record !== void 0 && "navigatorSubject" in record) return record.navigatorSubject;
-  return "file";
-}
 function packagedBoardPlacement(role) {
   const record = packagedRoleMetadata(role);
   if (record === void 0 || !("boardPlacement" in record)) return void 0;
@@ -631,15 +610,12 @@ export {
   packagedGateSummon,
   packagedMethodSkillNames,
   packagedModelParent,
-  packagedNavigatorSubject,
   packagedProjectsTargetBindRejection,
   packagedProvinceConfig,
-  packagedPublicInstructionSubject,
   packagedRebindSourceOnResume,
   packagedResumeSourcePath,
   packagedRoleAcceptedOutputTool,
   packagedRoleActivationFlags,
-  packagedRoleInputFlag,
   packagedRoleMetadata,
   packagedRoleOutputTool,
   packagedRolePhaseFlag,

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

@@ -23,7 +23,7 @@ import { summonPublicRole } from "../public-role-summons.js";
 import { latestQueuePayload, latestQueueStatus, } from "../submission-gate.js";
 import { isSafePositiveTicketNumber, readBoardTicketNumber, } from "../run-ticket-number.js";
 import { NotarySourceRunError, resolveNotarySourceRunLocator } from "../notary-source-run.js";
-import { packagedAdmitsCountersign, packagedBindsBoardTicket, packagedRebindSourceOnResume, packagedRoleMetadata, } from "../packaged-role-registry.js";
+import { packagedAdmitsCountersign, isNavigatorSeat, packagedBindsBoardTicket, packagedRebindSourceOnResume, packagedRoleMetadata, } from "../packaged-role-registry.js";
 import { readAuditorResumeBinding } from "../auditor-soul.js";
 import { CliUsageError } from "./cli-errors.js";
 import { admitPublicRole, admittedSourceRunPath, bindAdmittedTicketNumber, appendCallerFileFlagPaths, buildInstructionTransportPrompt, materializeCountersignInvocation, persistAdmittedAuditedSubmissionToolCallId, persistAdmittedSourceRunPath, readAdmittedAuditedSubmissionToolCallId, recordAdmittedCorrelation, recordChildDiaristRun, relocateAdmittedRunToTicket, } from "./invocation.js";
@@ -267,6 +267,9 @@ async function reaskUnreadablePostSubmissionStatus(admitted, terminal, env, io,
 async function reaskMissingTicketOnce(admitted, terminal, env, io) {
     if ((env.ticketReasksSpent ?? 0) >= 1)
         return { kind: "none" };
+    // #1192: a table lookup has no one to ask, and a second turn would re-seal.
+    if (isNavigatorSeat(admitted.role))
+        return { kind: "none" };
     if (admitted.ticketNumber !== undefined)
         return { kind: "none" };
     if (!isUnboundRunDirectory(admitted.runDirectory))

package/dist/public-cli/invocation.js

@@ -10,7 +10,7 @@ import { activationBookDirectory, ensureRealDirectoryTree, homeFromRunDirectory,
 import { resolveBookKeyFromGit } from "../activation-ledger-git.js";
 import { ensureRoleRunDirectory, ensureRoleRunPlacement, isUnboundRunDirectory, listBookRunDirectories, roleRunPlacement, sessionDirectoryOf, sessionFileIn, } from "../role-run-placement.js";
 import { relocateTicketProgressForLeg } from "../ticket-progress.js";
-import { packagedAdmittedSubject, packagedArgvResult, packagedBareToken, packagedBaseIsRevision, packagedEmitsAuthorityRefs, packagedPublicInstructionSubject, packagedRoleMetadata, packagedStoresSourceRunRaw, packagedSubjectChoices, } from "../packaged-role-registry.js";
+import { packagedAdmittedSubject, packagedArgvResult, packagedBareToken, packagedBaseIsRevision, packagedEmitsAuthorityRefs, packagedRoleMetadata, packagedStoresSourceRunRaw, packagedSubjectChoices, } from "../packaged-role-registry.js";
 import { isSafePositiveTicketNumber, parseTicketNumber, readBoardTicketNumber, requireSafePositiveTicketNumber, } from "../run-ticket-number.js";
 import { rewriteAdmittedRoleRunPage, } from "../role-run-relocation.js";
 import { readPageSync, renderCurrentSync, updateSectionSync, writeSectionSync } from "../run-dossier.js";
@@ -26,6 +26,7 @@ import {} from "../notary-contracts.js";
 import { NotarySourceRunError, resolveNotarySourceRunLocator, } from "../notary-source-run.js";
 import { CliUsageError } from "./cli-errors.js";
 import { REJECTED_PUBLIC_SPELLINGS, createTypedOptionConsumer, evaluateAnalystModeOptionContract, optionsForOwner, resolveAnalystMode, } from "./option-definitions.js";
+import { PUBLIC_CALLABLE_ROLES } from "./registry.js";
 import { errorText, isRecord } from "../unknown-value.js";
 /** Nonblank admitted source path, preserving its original bytes. */
 export function admittedSourceRunPath(admitted) {
@@ -490,6 +491,15 @@ function assignPublicSeatOption(owner, taken, fields) {
             fields.subject = subject;
             return;
         }
+        case "role": {
+            const raw = typeof value === "string" ? value.trim() : "";
+            const known = PUBLIC_CALLABLE_ROLES.find((role) => role === raw);
+            if (known === undefined) {
+                throw new CliUsageError(`${owner} --role must be one of ${PUBLIC_CALLABLE_ROLES.join("|")}, got ${value ?? "(missing)"}`);
+            }
+            fields.forRole = known;
+            return;
+        }
         case "source-run": {
             const text = typeof value === "string" ? value : "";
             if (text.trim() === "") {
@@ -623,6 +633,7 @@ export function parsePublicSeatArgv(owner, args) {
         ...(fields.lens === undefined ? {} : { lens: fields.lens }),
         ...(packagedEmitsAuthorityRefs(owner) ? { authorityRefs: fields.authorityRefs } : {}),
         ...(fields.subject === undefined ? {} : { subject: fields.subject }),
+        ...(fields.forRole === undefined ? {} : { forRole: fields.forRole }),
     };
 }
 /** Reject missing/blank path values so empty overrides cannot silently degrade. */
@@ -780,6 +791,7 @@ export async function admitPublicRole(role, parsed, env, override) {
                 instruction,
                 attachmentPaths,
                 ...project,
+                ...(parsed.forRole === undefined ? {} : { admittedFields: { forRole: parsed.forRole } }),
             });
         case "court-materials":
             return admitStandardMaterialInvocation("countersign", {
@@ -1249,31 +1261,6 @@ export async function materializeCountersignInvocation(admitted, options) {
     });
     await writeRoleInvocationLedger({ ...admitted, sessionDirectory: placement.sessionDirectory, sessionFile: placement.sessionFile }, admitted.role, options.model);
 }
-/**
- * Load the admitted section written at admission (Navigator work-context seam).
- * Missing / wrong-shape → undefined. Control-plane read faults propagate (#1187 F2).
- */
-export async function loadAdmittedJudgeRequest(runDirectory) {
-    const record = readPageSync(runDirectory, "admitted");
-    if (record === undefined)
-        return undefined;
-    if (!packagedPublicInstructionSubject(record.role))
-        return undefined;
-    if (typeof record.instruction !== "string")
-        return undefined;
-    if (typeof record.instructionEmpty !== "boolean")
-        return undefined;
-    if (!Array.isArray(record.attachments))
-        return undefined;
-    const attachments = record.attachments
-        .map((item) => normalizeAdmittedAttachment(item))
-        .filter((item) => item !== undefined);
-    return {
-        instruction: record.instruction,
-        instructionEmpty: record.instructionEmpty,
-        attachments,
-    };
-}
 function parsePositivePrOption(raw) {
     if (raw === undefined || raw.trim() === "")
         throw new CliUsageError("--pr requires a positive pull request number");