@akagilnc/pi-workflow-roles 0.1.5845 → 0.1.5853

package/src/navigator-invocation-identity.ts

@@ -23,8 +23,6 @@ import { isRecord } from "./unknown-value.ts";
 import { workSubjectKeysEqual } from "./work-subject-identity.ts";
 
 export const NAVIGATOR_INVOCATION_ENTRY = "ak-navigator-invocation" as const;
-/** Native playbook read failure recorded by the navigator process that read the file. */
-export const NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY = "ak-navigator-route-playbook-failure" as const;
 
 /** Typed durable infrastructure-failure fact on a packaged role output toolResult. */
 export const NAVIGATOR_INFRASTRUCTURE_FAILURE_KIND = "role_infrastructure_failure" as const;

package/src/navigator-lookup-host.ts

@@ -0,0 +1,45 @@
+/**
+ * 游奕使的非模型回合宿主（#1192 / ADR 0082「不适配者按类型开新管线」）。
+ * 不起宿主会话、不调模型：按结构化的目标角色查 navigator-route-table，
+ * 经提交账封一行，结算照常读账本。
+ */
+import { randomUUID } from "node:crypto";
+
+import type { RoleTurnHost } from "./host-contracts.ts";
+import { navigatorFullTable, navigatorRowsForRole } from "./navigator-route-table.ts";
+import { PACKAGED_ROLE_REGISTRY, type PackagedRole } from "./packaged-role-registry.ts";
+import { sealAcceptedSubmission } from "./submission-ledger.ts";
+
+/** 记入 invocation 的宿主名：如实表明这一腿是查表，不冒用真实宿主。 */
+export const NAVIGATOR_LOOKUP_HOST = "lookup" as const;
+
+function targetRole(forRole: string): PackagedRole {
+  const known = PACKAGED_ROLE_REGISTRY.find(({ role }) => role === forRole);
+  if (known === undefined) throw new Error(`navigator lookup: unknown role ${forRole}`);
+  return known.role;
+}
+
+export function createNavigatorLookupHost(): RoleTurnHost {
+  return {
+    async executeTurn(request) {
+      const { activation } = request;
+      if (activation.role !== "navigator") {
+        throw new Error(`navigator lookup host cannot run ${activation.role}`);
+      }
+      const accepted = activation.forRole === undefined
+        ? { byRole: navigatorFullTable() }
+        : { byStatus: navigatorRowsForRole(targetRole(activation.forRole)) };
+      sealAcceptedSubmission({
+        runDirectory: request.runDirectory,
+        cwd: request.cwd,
+        home: request.home,
+        role: "navigator",
+        accepted,
+        instruction: request.continuation.prompt,
+        toolCallId: `navigator-lookup:${randomUUID()}`,
+        ...(request.courtAttemptId === undefined ? {} : { courtAttemptId: request.courtAttemptId }),
+      });
+      return { code: 0, stderr: "", timedOut: false };
+    },
+  };
+}

package/src/navigator-lookup.ts

@@ -0,0 +1,98 @@
+/**
+ * Automatic navigator attendance lookup (#1192, builds on #1160).
+ * The parent role's start summons the navigator public activation — an ordinary
+ * `@navigator` run that looks its rows up in navigator-route-table with no model
+ * and no host session. The parent role arrives as the structured `--role` input,
+ * never inferred from prose. A failed lookup is reported with its real cause.
+ */
+import {
+  mergePreparedAdvice,
+  preparedAdviceFromUnknown,
+  type PreparedNavigatorAdvice,
+} from "./package-contracts/navigator-output.ts";
+import { runDirectoryFromHostContext, type HostContext } from "./host-contracts.ts";
+import type { PublicSummonResult } from "./public-role-summons.ts";
+
+export type NavigatorUnavailableKey = "session" | "unknown";
+
+export class NavigatorUnavailableError extends Error {
+  readonly unavailableSource: NavigatorUnavailableKey;
+  readonly originalCause: unknown;
+
+  constructor(source: NavigatorUnavailableKey, message: string, originalCause?: unknown) {
+    super(message);
+    this.name = "NavigatorUnavailableError";
+    this.unavailableSource = source;
+    this.originalCause = originalCause;
+  }
+}
+
+export function navigatorUnavailableError(source: NavigatorUnavailableKey, error: unknown): NavigatorUnavailableError {
+  if (error instanceof NavigatorUnavailableError) return error;
+  const message = error instanceof Error ? error.message : String(error);
+  return new NavigatorUnavailableError(source, message, error);
+}
+
+/** One attendance lookup: the parent role's rows, or undefined when it has none. */
+export type NavigatorLookup = (input: {
+  readonly context: HostContext;
+  readonly role: string;
+}) => Promise<PreparedNavigatorAdvice | undefined>;
+
+type NavigatorSummon = (options: {
+  readonly role: "navigator";
+  readonly argv: readonly string[];
+  readonly cwd: string;
+  readonly home?: string;
+  readonly signal?: AbortSignal;
+}) => Promise<PublicSummonResult>;
+
+/**
+ * Ledger process home for the nested summon: the admitted run directory first,
+ * else the parent session file under .ak-roles. Never ambient HOME (#852).
+ */
+async function ledgerHomeFor(context: HostContext): Promise<string | undefined> {
+  const { tryHomeFromAkRolesPath } = await import("./activation-ledger-topology.ts");
+  for (const path of [runDirectoryFromHostContext(context), context.sessionManager?.getSessionFile?.()]) {
+    if (typeof path !== "string" || path.trim() === "") continue;
+    const home = tryHomeFromAkRolesPath(path);
+    if (home !== undefined && home.length > 0) return home;
+  }
+  return undefined;
+}
+
+export function createNavigatorLookup(deps?: { readonly summonPublicRole?: NavigatorSummon }): NavigatorLookup {
+  const summon: NavigatorSummon = deps?.summonPublicRole
+    ?? (async (options) => (await import("./public-role-summons.ts")).summonPublicRole(options));
+  return async ({ context, role }) => {
+    const home = await ledgerHomeFor(context);
+    let summoned: PublicSummonResult;
+    try {
+      summoned = await summon({
+        role: "navigator",
+        argv: ["--role", role],
+        cwd: context.cwd,
+        ...(home === undefined ? {} : { home }),
+        ...(context.signal === undefined ? {} : { signal: context.signal }),
+      });
+    } catch (error) {
+      throw navigatorUnavailableError("session", error);
+    }
+    const outcome = summoned.terminal?.roleOutcome;
+    if (outcome === undefined) {
+      const detail = summoned.stderr?.trim() || `exit ${summoned.exitCode}`;
+      throw new NavigatorUnavailableError("session", `Navigator lookup produced no terminal (${detail})`);
+    }
+    if (outcome.kind === "failure") {
+      throw new NavigatorUnavailableError("session", outcome.diagnostic);
+    }
+    if (outcome.kind !== "accepted") {
+      throw new NavigatorUnavailableError("session", `Navigator lookup settled ${outcome.kind}`);
+    }
+    let prepared: PreparedNavigatorAdvice | undefined;
+    for (const payload of outcome.payloads ?? []) {
+      prepared = mergePreparedAdvice(prepared, preparedAdviceFromUnknown(payload));
+    }
+    return prepared;
+  };
+}

package/src/navigator-route-table.ts

@@ -0,0 +1,92 @@
+/**
+ * 游奕使的唯一路线表（#1192）：(衙门角色, 结局 status) → 一句建议。
+ * 本表是路线的唯一真源；游奕使不调模型，只按行取出。建议只供调用者参考，
+ * 不执行下一站，也不读判词正文猜分支——需判词点名下一步的写「按判词处置」。
+ * 没有结局 status 的情况（如宿主故障；通进司的回执也没有 status 字段）与未列出的
+ * status（如 coder 的 planned）不设行，走无建议。
+ * 闸在同一次公开调用内自动传召的站（闸表真源：gatekeeper-role.ts 的
+ * GATE_OFFICER_BY_SUBJECT 与 judge-role.ts 的 JUDGE_GATES）不再建议；
+ * 建议写闸线之后的下一站。
+ * 每句 20 字以内。
+ */
+import type { DiaristOutput } from "./diarist-contracts.ts";
+import type { MergerOutput } from "./merger-contracts.ts";
+import type { PackagedRole } from "./packaged-role-registry.ts";
+import type { GatekeeperDirectOutput } from "./package-contracts/gatekeeper-output.ts";
+import type { ReviewerIntent } from "./package-contracts/reviewer-output.ts";
+import type { CoderOutput } from "./package-contracts/worker-output.ts";
+import type { ReviewQueueWord } from "./review-submission.ts";
+
+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 = "续修，勿送大理寺";
+
+export type NavigatorRouteRows = Readonly<Record<string, string>>;
+
+/** Rows keyed by a seat's own status words; a lawful status may have no row. */
+type Rows<Status extends string> = Readonly<Partial<Record<Status, string>>>;
+
+/**
+ * Status keys follow each seat's existing receipt type. The fixer's output type
+ * leaves status open (its words are the coder's, per the fixer contract) and the
+ * secretariat's receipt has no status type, so those two stay on their words.
+ */
+type RoleRows = {
+  readonly judge: Rows<ReviewQueueWord>;
+  readonly countersign: Rows<ReviewQueueWord>;
+  readonly notary: Rows<ReviewQueueWord>;
+  readonly inspector: Rows<ReviewQueueWord>;
+  readonly coder: Rows<CoderOutput["status"]>;
+  readonly fixer: Rows<CoderOutput["status"]>;
+  readonly diarist: Rows<DiaristOutput["status"]>;
+  readonly merger: Rows<MergerOutput["status"]>;
+  readonly secretariat: NavigatorRouteRows;
+  readonly reviewer: Rows<ReviewerIntent["status"]>;
+  readonly gatekeeper: Rows<GatekeeperDirectOutput["status"]>;
+};
+
+export type NavigatorRouteTable = Readonly<Partial<Record<PackagedRole, NavigatorRouteRows>>>;
+
+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 },
+} as const satisfies RoleRows;
+
+export const NAVIGATOR_ROUTE_TABLE: NavigatorRouteTable = ROUTE_ROWS;
+
+/** 某衙门的全部行；表中无此衙门时为空对象。 */
+export function navigatorRowsForRole(role: PackagedRole): NavigatorRouteRows {
+  return NAVIGATOR_ROUTE_TABLE[role] ?? {};
+}
+
+/** 整表：衙门 → (status → 建议)。 */
+export function navigatorFullTable(): NavigatorRouteTable {
+  return NAVIGATOR_ROUTE_TABLE;
+}

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

@@ -26,6 +26,10 @@ export const navigatorAdviceFields = {
       "按主衙门结局 status 预写的散文建议。键为 status 字面量，值为建议正文。"
       + "结算时代码只按实际 status 取对应原文，不解析建议语义。",
   }),
+  byRole: Type.Unknown({
+    description:
+      "整张路线表：键为衙门角色，值为该衙门 status → 建议。直接入口不给角色时使用。",
+  }),
 } as const;
 
 /** Open tool object for prose/byStatus (attendance prepare + public output body). */
@@ -73,13 +77,6 @@ function byStatusFromUnknown(value: unknown): Map<string, string> {
   return out;
 }
 
-/** Plain object for tool.execute / host payloads; Object.fromEntries keeps opaque keys. */
-export function byStatusToPlainObject(
-  byStatus: ReadonlyMap<string, string>,
-): Record<string, string> {
-  return Object.fromEntries(byStatus);
-}
-
 /**
  * Project one Navigator advice receipt as prose (display / single-advice path).
  * Accepts { prose }, a bare string, or any object — objects stringify as the
@@ -114,14 +111,6 @@ export function validateRecordedNavigatorOutput(value: unknown): NavigatorAdvice
   return projected;
 }
 
-/** Extract display prose from any navigator payload / attendance body. */
-export function navigatorProseFromUnknown(value: unknown): string | undefined {
-  const projected = projectLawfulNavigatorOutput(value);
-  if (projected === undefined) return undefined;
-  const trimmed = projected.prose.trim();
-  return trimmed === "" ? undefined : projected.prose;
-}
-
 /**
  * Extract parallel-prepare advice. Empty / missing → undefined.
  * Never a rejection — shape is not an admission gate.

package/src/packaged-role-registry.ts

@@ -85,8 +85,6 @@ export 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: [
@@ -115,8 +113,6 @@ export 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" },
     ],
@@ -145,8 +141,6 @@ export 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" },
     ],
@@ -242,8 +236,6 @@ export 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" },
     ],
@@ -299,8 +291,6 @@ export const PUBLIC_ROLE_RECORDS = [
     gateStageLabel: "符宝郎",
     /** 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" },
@@ -438,12 +428,14 @@ export 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"],
   },
@@ -584,10 +576,6 @@ export function packagedRoleActivationFlags(role: string): readonly PackagedActi
   return record.activationFlags;
 }
 
-export function packagedRoleInputFlag(role: string): string | undefined {
-  return packagedRoleActivationFlags(role).find((spec) => spec.binds === "input")?.flag;
-}
-
 export function packagedRolePhaseFlag(role: string): string | undefined {
   return packagedRoleActivationFlags(role).find((spec) => spec.binds === "phase")?.flag;
 }
@@ -669,15 +657,6 @@ export function packagedAuditToolName(role: string): string | undefined {
   return record.auditTool;
 }
 
-/** Admitted-request role whose navigator subject is the public instruction. */
-export function packagedPublicInstructionSubject(role: unknown): boolean {
-  return typeof role === "string" && PUBLIC_ROLE_RECORDS.some((record) =>
-    "navigatorSubject" in record
-    && record.navigatorSubject === "public-instruction"
-    && record.role === role
-  );
-}
-
 /** Resume restores an optional source-run path. */
 export function packagedResumeSourcePath(role: string): boolean {
   const record = packagedRoleMetadata(role);
@@ -692,14 +671,6 @@ export function packagedProjectsTargetBindRejection(role: string): boolean {
     && record.projectTargetBindRejection === true;
 }
 
-export function packagedNavigatorSubject(
-  role: string,
-): "file" | "case" | "source-run" | "public-instruction" {
-  const record = packagedRoleMetadata(role);
-  if (record !== undefined && "navigatorSubject" in record) return record.navigatorSubject;
-  return "file";
-}
-
 export type PackagedBoardPlacement = "judge-history" | "coder" | "marshal" | "collector";
 
 /** Factory-board column for a packaged seat. Absent seats use the board's other bucket. */

package/src/public-cli/instruction-seat-run.ts

@@ -35,6 +35,7 @@ import { NotarySourceRunError, resolveNotarySourceRunLocator } from "../notary-s
 import type { PackagedRole } from "../packaged-role-registry.ts";
 import {
   packagedAdmitsCountersign,
+  isNavigatorSeat,
   packagedBindsBoardTicket,
   packagedRebindSourceOnResume,
   packagedRoleMetadata,
@@ -431,6 +432,8 @@ async function reaskMissingTicketOnce(
   io: CliIo,
 ): Promise<SoftTicketReaskOutcome> {
   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)) return { kind: "none" };
   if (terminal?.roleOutcome.kind !== "accepted" && terminal?.roleOutcome.kind !== "audit_escalation") {

package/src/public-cli/invocation.ts

@@ -42,7 +42,6 @@ import {
   packagedBareToken,
   packagedBaseIsRevision,
   packagedEmitsAuthorityRefs,
-  packagedPublicInstructionSubject,
   packagedRoleMetadata,
   packagedStoresSourceRunRaw,
   packagedSubjectChoices,
@@ -96,7 +95,7 @@ import {
   type TakenTypedOption,
   type TypedOptionConsumer,
 } from "./option-definitions.ts";
-import type { PublicThinkingLevel } from "./registry.ts";
+import { PUBLIC_CALLABLE_ROLES, type PublicThinkingLevel } from "./registry.ts";
 
 import { errorText, isRecord } from "../unknown-value.ts";
 
@@ -188,6 +187,8 @@ export type AdmittedGatekeeperInvocation = AdmittedRoleInvocationBase & {
 
 export type AdmittedNavigatorInvocation = AdmittedRoleInvocationBase & {
   readonly role: "navigator";
+  /** Structured target seat for the lookup (#1192); absent = whole table. */
+  readonly forRole?: PackagedRole;
 };
 
 export type AdmittedAuditorInvocation = AdmittedRoleInvocationBase & {
@@ -901,6 +902,7 @@ function appendBareInstruction(
 export type PublicSeatArgvOwner = Exclude<OptionOwner, "global" | "analyst">;
 
 type SeatArgvFields = {
+  forRole?: PackagedRole;
   attachmentPaths: string[];
   project?: string;
   positional: string[];
@@ -953,6 +955,17 @@ function assignPublicSeatOption(
       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() === "") {
@@ -1107,6 +1120,7 @@ export function parsePublicSeatArgv(
     ...(fields.lens === undefined ? {} : { lens: fields.lens }),
     ...(packagedEmitsAuthorityRefs(owner) ? { authorityRefs: fields.authorityRefs } : {}),
     ...(fields.subject === undefined ? {} : { subject: fields.subject }),
+    ...(fields.forRole === undefined ? {} : { forRole: fields.forRole }),
   };
 }
 
@@ -1347,6 +1361,7 @@ export type PublicSeatParse = {
   readonly lens?: "completeness" | "correctness";
   readonly authorityRefs?: readonly string[];
   readonly subject?: "judge" | "doctor";
+  readonly forRole?: PackagedRole;
 };
 
 /**
@@ -1402,6 +1417,7 @@ export async function admitPublicRole(
           instruction,
           attachmentPaths,
           ...project,
+          ...(parsed.forRole === undefined ? {} : { admittedFields: { forRole: parsed.forRole } }),
         },
       );
     case "court-materials":
@@ -2050,34 +2066,6 @@ export async function materializeCountersignInvocation(
   );
 }
 
-/**
- * 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: string,
-): Promise<{
-  instruction: string;
-  instructionEmpty: boolean;
-  attachments: readonly AdmittedAttachment[];
-} | undefined> {
-  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 is AdmittedAttachment => item !== undefined);
-  return {
-    instruction: record.instruction,
-    instructionEmpty: record.instructionEmpty,
-    attachments,
-  };
-
-}
-
 export type AdmitFixerInvocationOptions = {
   home: string;
   principalAuthority: DurablePrincipalAuthority;

package/src/public-cli/option-definitions.ts

@@ -594,6 +594,25 @@ const DOCTOR_OPTIONS = [
   },
 ] as const satisfies readonly PublicOptionDefinition[];
 
+/** 游奕使: 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 正文不读。",
+    },
+  },
+] as const satisfies readonly PublicOptionDefinition[];
+
 const NOTARY_OPTIONS = [
   bindOwner("notary", SHARED_PROJECT_SEMANTICS),
   {
@@ -799,6 +818,7 @@ const SEAT_OPTION_ROWS: Partial<
   notary: NOTARY_OPTIONS,
   auditor: AUDITOR_OPTIONS,
   inspector: INSPECTOR_OPTIONS,
+  navigator: NAVIGATOR_OPTIONS,
 };
 
 function seatOptionRows(role: PublicCallableRole): readonly PublicOptionDefinition[] {
@@ -1103,7 +1123,7 @@ export type PublicCommandHelpFacts = {
  * 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." as const;
+  "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." as const;
 
 const TOP_LEVEL_HELP = {
   command: "top",
@@ -1220,10 +1240,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/src/public-cli/post-admission.ts

@@ -485,8 +485,6 @@ export type PostAdmissionEnv = {
   boundTicketNumber?: number;
   /** Station child role run (#840): omit automatic navigator attendance. */
   stationChild?: boolean;
-  /** #1160 attendance auto byStatus prepare (nested navigator only). */
-  navigatorByStatusPrepare?: boolean;
 };
 
 /**
@@ -1374,9 +1372,6 @@ export async function dispatchPostAdmissionTurn<
     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() !== "") {
@@ -1734,9 +1729,6 @@ export function resumeTurnRequestProjectionOptions(
       prompt,
     },
     ...(env.stationChild === undefined ? {} : { stationChild: env.stationChild }),
-    ...(env.navigatorByStatusPrepare === true
-      ? { navigatorByStatusPrepare: true as const }
-      : {}),
     // #1132: one configured ceiling, already resolved by the caller (#422).
     deliveryRequestLimit: deliveryLimitFromConfig(env.autoResumeLimit),
   };
@@ -1757,9 +1749,6 @@ export function roleTurnOptions(
       : { correlationId }),
     continuation,
     ...(env.stationChild === undefined ? {} : { stationChild: env.stationChild }),
-    ...(env.navigatorByStatusPrepare === true
-      ? { navigatorByStatusPrepare: true as const }
-      : {}),
     // #1132: one configured ceiling, already resolved by the caller (#422).
     deliveryRequestLimit: deliveryLimitFromConfig(env.autoResumeLimit),
   };

package/src/public-cli/role-seat-runtime.ts

@@ -4,6 +4,8 @@
  * then host-facing provider projection. Callers own how a missing model is shown.
  */
 import { pickEngineAxis } from "../package-resources/engine-material.ts";
+import { createNavigatorLookupHost, NAVIGATOR_LOOKUP_HOST } from "../navigator-lookup-host.ts";
+import { isNavigatorSeat } from "../packaged-role-registry.ts";
 import type { DurablePrincipalAuthority, RoleTurnHost } from "../host-contracts.ts";
 import {
   resolvedSeatWithModel,
@@ -44,6 +46,18 @@ export function openRoleSeatRuntime(input: {
   /** Already host-facing. A second projection would rename the provider again. */
   readonly hostFacingModel?: SeatModelConfig;
 }): OpenedRoleSeatRuntime {
+  // #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,