@akagilnc/pi-workflow-roles 0.1.5845 → 0.1.5853

package/dist/public-cli/option-definitions.js

@@ -497,6 +497,24 @@ const DOCTOR_OPTIONS = [
         },
     },
 ];
+/** 游奕使: structured target seat for the lookup; instruction prose is never parsed (#1192). */
+const NAVIGATOR_OPTIONS = [
+    ...projectAndAttach("navigator"),
+    {
+        id: "role",
+        owner: "navigator",
+        canonical: "--role",
+        aliases: [],
+        valueMetavar: "role",
+        required: false,
+        repeatable: false,
+        form: "option",
+        description: {
+            en: "Optional seat whose status → advice rows to show; omitted shows the whole table. The instruction text is not read.",
+            zh: "可选衙门角色：只显示该衙门的 status → 建议；缺省显示整张表。instruction 正文不读。",
+        },
+    },
+];
 const NOTARY_OPTIONS = [
     bindOwner("notary", SHARED_PROJECT_SEMANTICS),
     {
@@ -696,6 +714,7 @@ const SEAT_OPTION_ROWS = {
     notary: NOTARY_OPTIONS,
     auditor: AUDITOR_OPTIONS,
     inspector: INSPECTOR_OPTIONS,
+    navigator: NAVIGATOR_OPTIONS,
 };
 function seatOptionRows(role) {
     return SEAT_OPTION_ROWS[role] ?? projectAndAttach(role);
@@ -892,7 +911,7 @@ export function allRejectedSpellingTokens() {
  * attendance is orthogonal to callability — the direct command face lives on
  * the role list like every other role).
  */
-export const PUBLIC_NAVIGATOR_HELP_NOTE = "Navigator also attends automatically on top-level public entry legs; that sidecar is unchanged by direct `ak-role navigator` calls.";
+export const PUBLIC_NAVIGATOR_HELP_NOTE = "Navigator also attends automatically on top-level public entry legs; the sidecar and direct `ak-role navigator` calls read the same status → advice table, with no model call.";
 const TOP_LEVEL_HELP = {
     command: "top",
     summary: "public role CLI",
@@ -1006,10 +1025,11 @@ const ROLE_COMMAND_HELP = {
     },
     navigator: {
         command: "navigator",
-        summary: "Direct Navigator (游奕使) free-form prose route advice.",
-        usage: ["ak-role navigator [options] [instruction]"],
+        summary: "Direct Navigator (游奕使) status → next-station advice table lookup; no model call.",
+        usage: ["ak-role navigator [--role <role>] [options] [instruction]"],
         examples: [
-            'ak-role navigator "刚完成 coder apply 收敛，下一步？"',
+            "ak-role navigator",
+            "ak-role navigator --role coder",
         ],
     },
     auditor: {

package/dist/public-cli/post-admission.js

@@ -806,9 +806,6 @@ export async function dispatchPostAdmissionTurn(input) {
         if (env.stationChild !== undefined) {
             turnRequest = { ...turnRequest, stationChild: env.stationChild };
         }
-        if (env.navigatorByStatusPrepare === true) {
-            turnRequest = { ...turnRequest, navigatorByStatusPrepare: true };
-        }
         // Selected host axis rides the shared Host envelope for in-turn tools
         // (detour usage ledger) — never a pre-spawn current.json reread.
         if (typeof env.host === "string" && env.host.trim() !== "") {
@@ -1113,9 +1110,6 @@ export function resumeTurnRequestProjectionOptions(admitted, request, env, summo
             prompt,
         },
         ...(env.stationChild === undefined ? {} : { stationChild: env.stationChild }),
-        ...(env.navigatorByStatusPrepare === true
-            ? { navigatorByStatusPrepare: true }
-            : {}),
         // #1132: one configured ceiling, already resolved by the caller (#422).
         deliveryRequestLimit: deliveryLimitFromConfig(env.autoResumeLimit),
     };
@@ -1131,9 +1125,6 @@ export function roleTurnOptions(env, admitted, continuation) {
             : { correlationId }),
         continuation,
         ...(env.stationChild === undefined ? {} : { stationChild: env.stationChild }),
-        ...(env.navigatorByStatusPrepare === true
-            ? { navigatorByStatusPrepare: true }
-            : {}),
         // #1132: one configured ceiling, already resolved by the caller (#422).
         deliveryRequestLimit: deliveryLimitFromConfig(env.autoResumeLimit),
     };

package/dist/public-cli/role-seat-runtime.js

@@ -4,10 +4,24 @@
  * then host-facing provider projection. Callers own how a missing model is shown.
  */
 import { pickEngineAxis } from "../package-resources/engine-material.js";
+import { createNavigatorLookupHost, NAVIGATOR_LOOKUP_HOST } from "../navigator-lookup-host.js";
+import { isNavigatorSeat } from "../packaged-role-registry.js";
 import { resolvedSeatWithModel, } from "./config.js";
 import { loadHostProvidersTable, projectHostFacingProvider, } from "./host-providers.js";
 import { composeRoleTurnHostAdapters, selectRoleTurnHost, } from "./role-turn-host-resolution.js";
 export function openRoleSeatRuntime(input) {
+    // #1192: the navigator is a table lookup, not a model seat. Its seat axes
+    // (model / host / engine) are accepted and never consulted, so a mismatched
+    // or absent pair cannot stop it and no host session is started.
+    if (isNavigatorSeat(input.role)) {
+        input.afterHost?.();
+        return {
+            ok: true,
+            roleTurnHost: createNavigatorLookupHost(),
+            hostAdapters: [],
+            host: NAVIGATOR_LOOKUP_HOST,
+        };
+    }
     const hostAdapters = composeRoleTurnHostAdapters(input.resolution, input.principalAuthority);
     const roleTurnHost = selectRoleTurnHost(hostAdapters, {
         role: input.role,

package/dist/public-cli/settlement.js

@@ -18,8 +18,8 @@ import { describeErrorIdentity } from "./run-lifecycle.js";
 import { readEngineDetourToolUsage, readInvocationEngineMounted, runDirectoryFromSessionDirectory, sessionFileFromSessionDirectory, withEngineDetourToolUsageFact, } from "../engine-detour-usage.js";
 import { DOCTOR_CANDIDATE_ENTRY_TYPE } from "../dossier-resolution.js";
 import { homeFromRunDirectory, } from "./invocation.js";
-import { findLatestDurablePackagedRoleTerminal, NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY, } from "../navigator-invocation-identity.js";
-import { packagedRoleAcceptedOutputTool, packagedRoleMetadata, } from "../packaged-role-registry.js";
+import { findLatestDurablePackagedRoleTerminal } from "../navigator-invocation-identity.js";
+import { isNavigatorSeat, packagedRoleAcceptedOutputTool, packagedRoleMetadata, } from "../packaged-role-registry.js";
 import { NO_RECEIPT_LIFECYCLE_ENTRY_TYPE, noReceiptLifecycleFacts, parseNoReceiptLifecycleFacts, priorReceiptContinuation, receiptAttemptPointer, } from "../receipt-delivery-policy.js";
 import { readStateRowsSync, runCurrentPath } from "../run-dossier.js";
 import { reportRunRecord } from "../sitian-facade.js";
@@ -292,7 +292,9 @@ async function settleNoReceiptTerminal(admitted, authority, scope, facts) {
     }
     return attachEngineDetourToolUsage({
         roleOutcome,
-        navigator: await extractNavigatorFactFromAdmittedSession(coordinates.sessionFile, admitted.runDirectory, scope),
+        navigator: isNavigatorSeat(admitted.role)
+            ? NAVIGATOR_SEAT_OWN_FACT
+            : await extractNavigatorFactFromAdmittedSession(coordinates.sessionFile, admitted.runDirectory, scope),
         artifacts: [],
         runId: admitted.runId,
     }, coordinates.sessionDirectory, detourUsageContext(admitted, scope));
@@ -660,9 +662,6 @@ export async function appendRunAttemptHistory(source, outcome) {
 }
 function parseNavigatorAttendanceDetails(details) {
     const disposition = details.disposition;
-    const advisoryDiagnostic = typeof details.routePlaybookReadFailure === "string"
-        ? { advisoryDiagnostic: details.routePlaybookReadFailure }
-        : {};
     // #959: advice prose is presented as-is. Legacy "recommendation" with next/reason/
     // command is projected into prose so historical sessions still render — never wash
     // a real recommendation into no-advice when any advice body is recoverable.
@@ -697,20 +696,13 @@ function parseNavigatorAttendanceDetails(details) {
         }
         if (prose === undefined || prose.trim() === "") {
             // Attended but empty body is affirmative no-advice, not unavailable (#959).
-            return {
-                disposition: "no-advice",
-                ...advisoryDiagnostic,
-            };
+            return { disposition: "no-advice" };
         }
-        return adviceNavigatorFact({
-            prose,
-            ...advisoryDiagnostic,
-        });
+        return adviceNavigatorFact({ prose });
     }
     if (disposition === "unavailable") {
         return {
             disposition: "unavailable",
-            ...advisoryDiagnostic,
             source: typeof details.unavailableSource === "string"
                 ? details.unavailableSource
                 : "unknown",
@@ -721,10 +713,7 @@ function parseNavigatorAttendanceDetails(details) {
     }
     // arrival and legacy silence both mean affirmative lawful no next-role advice.
     if (disposition === "no-advice" || disposition === "arrival" || disposition === "silence") {
-        return {
-            disposition: "no-advice",
-            ...advisoryDiagnostic,
-        };
+        return { disposition: "no-advice" };
     }
     return {
         disposition: "unavailable",
@@ -793,26 +782,7 @@ function detourUsageContext(admitted, scope) {
         ...(scope?.notePackageFault === undefined ? {} : { notePackageFault: scope.notePackageFault }),
     };
 }
-function routePlaybookFailureMessage(entries) {
-    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) {
-    const fact = extractNavigatorAttendanceFact(entries);
-    if (fact.advisoryDiagnostic !== undefined)
-        return fact;
-    const message = routePlaybookFailureMessage(entries);
-    return message === undefined ? fact : { ...fact, advisoryDiagnostic: message };
-}
-function extractNavigatorAttendanceFact(entries) {
     // Affirmative attendance only. Missing / unparseable is never no-advice.
     // The shared lifecycle places the settled event on this submission's closure;
     // an unrelated attendance message cannot supply another call's result.
@@ -845,6 +815,8 @@ function extractNavigatorAttendanceFact(entries) {
  * Never infers no-advice from omission; session read failures stay typed unavailable
  * so the controlled-failure Terminal itself still settles.
  */
+/** The navigator run is the advice itself; it has no attendance of its own (#1192). */
+const NAVIGATOR_SEAT_OWN_FACT = { disposition: "no-advice" };
 async function extractNavigatorFactFromAdmittedSession(sessionFile, runDirectory, scope) {
     try {
         const entries = await readBoundSessionEntries(sessionFile);
@@ -991,7 +963,7 @@ async function finishLawfulSeat(admitted, coordinates, entries, roleOutcome, sco
         : await publishDeclaredSeatTerminal(admitted, roleOutcome, coordinates, entries, scope);
     const terminal = await attachEngineDetourToolUsage({
         roleOutcome,
-        navigator: extractNavigatorFact(entries),
+        navigator: isNavigatorSeat(admitted.role) ? NAVIGATOR_SEAT_OWN_FACT : extractNavigatorFact(entries),
         artifacts,
         runId: admitted.runId,
         ...(submissionToolCallId === undefined || submissionToolCallId.length === 0
@@ -1145,7 +1117,9 @@ export async function settleFailureTerminalResult(admitted, failure, authority,
     const coordinates = coordinatesFromAdmitted(authority, admitted);
     const { sessionDirectory, sessionFile } = coordinates;
     // Exact-session attendance only — never infer no-advice from caller omission.
-    const navigator = await extractNavigatorFactFromAdmittedSession(sessionFile, admitted.runDirectory, options);
+    const navigator = isNavigatorSeat(admitted.role)
+        ? NAVIGATOR_SEAT_OWN_FACT
+        : await extractNavigatorFactFromAdmittedSession(sessionFile, admitted.runDirectory, options);
     let artifacts = [];
     if (options.previewOnly !== true) {
         try {

package/dist/public-cli/terminal.js

@@ -26,11 +26,7 @@ export function currentReplyRows(terminal) {
  * code does not parse route/next or judge usability.
  */
 export function adviceNavigatorFact(input) {
-    return {
-        disposition: "advice",
-        prose: input.prose,
-        ...(input.advisoryDiagnostic === undefined ? {} : { advisoryDiagnostic: input.advisoryDiagnostic }),
-    };
+    return { disposition: "advice", prose: input.prose };
 }
 /**
  * Present one Terminal result for humans. Labels, row order, wording, and layout
@@ -72,9 +68,6 @@ export function formatTerminalResult(result) {
         }
     }
     lines.push(`navigator\t${result.navigator.disposition}`);
-    if (result.navigator.advisoryDiagnostic !== undefined) {
-        lines.push(`navigator-advisory\t${encodeTerminalField(result.navigator.advisoryDiagnostic)}`);
-    }
     if (result.navigator.disposition === "advice") {
         // #959: present navigator prose as-is — no next/reason/command parsing.
         lines.push(`prose\t${encodeTerminalField(result.navigator.prose)}`);

package/dist/public-cli/turn-request.js

@@ -45,9 +45,6 @@ export function projectRoleTurnRequest(admitted, roleDetails, options) {
             ? {}
             : { invocationScopeId: options.invocationScopeId }),
         ...(options.stationChild === undefined ? {} : { stationChild: options.stationChild }),
-        ...(options.navigatorByStatusPrepare === undefined
-            ? {}
-            : { navigatorByStatusPrepare: options.navigatorByStatusPrepare }),
         ...(options.deliveryRequestLimit === undefined
             ? {}
             : { deliveryRequestLimit: options.deliveryRequestLimit }),

package/dist/public-role-summons.js

@@ -187,7 +187,6 @@ async function summonPublicRole(options) {
           // Nested court stations keep station-child semantics; dual-lens
           // ordinary Reviewer axes opt out (#946 / ADR 0082).
           ...options.stationChild === false ? {} : { stationChild: true },
-          ...options.navigatorByStatusPrepare === true ? { navigatorByStatusPrepare: true } : {},
           // Forward composition-root adapters so nested stations (e.g.
           // secretariat → diarist) select the same faux/production table (#924).
           ...options.hostAdapters === void 0 ? {} : { hostAdapters: options.hostAdapters },

package/dist/receipt-delivery-policy.js

@@ -87,29 +87,6 @@ function createReceiptDeliveryPolicy(limit) {
       deliveryTurns += 1;
       spend();
     },
-    /**
-     * Stop asking. The issued count stays whatever was actually sent (#1132 —
-     * do not fill the remainder up to the ceiling).
-     */
-    closeBudget() {
-      closed = true;
-    },
-    /**
-     * A nested session settled without an accepted receipt. Close so this layer
-     * does not open another prompt on that session. The issued count stays the
-     * larger of the two seams: a nested zero must not wipe prompts this layer
-     * already sent, and adding the two counts would bill one send twice.
-     */
-    recordNestedNoReceipt(facts) {
-      if (typeof facts.terminalToolCalled === "boolean") {
-        terminalToolCalled = terminalToolCalled || facts.terminalToolCalled;
-      }
-      if (facts.rejectedReceipts !== void 0) {
-        rejectedReceipts.push(...facts.rejectedReceipts);
-      }
-      if (facts.deliveryTurns !== void 0) deliveryTurns = Math.max(deliveryTurns, facts.deliveryTurns);
-      closed = true;
-    },
     nextAction() {
       if (accepted) return "accepted";
       if (closed) return "no-receipt";

package/dist/role-runtime-dependencies.js

@@ -1,8 +1,8 @@
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { loadDoctorCase } from "./doctor-evidence.js";
-import { createNativeNavigatorSessionFactory, createNavigatorAttendance } from "./navigator-attendance.js";
-import { loadNavigatorWorkContext } from "./navigator-work-context.js";
+import { createNavigatorAttendance } from "./navigator-attendance.js";
+import { createNavigatorLookup } from "./navigator-lookup.js";
 import { loadNotarySourceRunLocator } from "./notary-source-run.js";
 import {} from "./role-runtime.js";
 import { loadAuditorReferenceMaterialsFromSubjectInput, loadAuditorSoulFromSubjectInput, } from "./auditor-soul.js";
@@ -29,7 +29,7 @@ export function createRoleRuntimeDependencies(packageRoot) {
     // 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 navigatorSessionFactory = createNativeNavigatorSessionFactory();
+    const navigatorLookup = createNavigatorLookup();
     return {
         packageRoot,
         loadRoleReferenceMaterials: loadPackagedRoleReferenceMaterials,
@@ -37,20 +37,13 @@ export function createRoleRuntimeDependencies(packageRoot) {
         loadDoctorCase,
         loadNotarySourceRun: loadNotarySourceRunLocator,
         loadMergerInput: async (path) => JSON.parse(await readFile(path, "utf8")),
-        loadNavigatorWorkContext: (options) => loadNavigatorWorkContext({
-            context: options.context,
-            role: options.role,
-            ...(options.getFlag === undefined ? {} : { getFlag: options.getFlag }),
-        }),
         createNavigatorAttendance: (options) => createNavigatorAttendance({
             context: options.context,
             role: options.role,
             phase: options.phase,
             subjectKey: options.subjectKey,
             invocationId: options.invocationId,
-            createSession: navigatorSessionFactory,
-            ...(options.deliveryRequestLimit === undefined ? {} : { deliveryRequestLimit: options.deliveryRequestLimit }),
-            ...(options.contextError === undefined ? {} : { contextError: options.contextError }),
+            lookup: navigatorLookup,
             onEvent: options.onEvent,
         }),
     };