@akagilnc/pi-workflow-roles 0.1.5663 → 0.1.5673

package/dist/navigator-attendance.js

@@ -1,7 +1,7 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
-import { Type } from "typebox";
+import {} from "typebox";
 import {
   NAVIGATOR_INVOCATION_ENTRY,
   NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY,
@@ -31,7 +31,13 @@ import {
 import { sitianReport } from "./sitian-facade.js";
 import { issueRoot, subjectPath } from "./work-subject-identity.js";
 import { createReceiptDeliveryPolicy } from "./receipt-delivery-policy.js";
-import { navigatorProseFromUnknown } from "./package-contracts/navigator-output.js";
+import {
+  byStatusToPlainObject,
+  mergePreparedAdvice,
+  navigatorAdviceBodySchema,
+  pickPreparedProse,
+  preparedAdviceFromUnknown
+} from "./package-contracts/navigator-output.js";
 import { sha256Hex } from "./sha256.js";
 import { isRecord } from "./unknown-value.js";
 const NAVIGATOR_EVENT_TYPE = "ak-navigator-attendance";
@@ -41,11 +47,7 @@ function resolveNavigatorAuthorityMaterial(roleInput, fileAuthority) {
   return void 0;
 }
 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"
-  }))
-}, { additionalProperties: true });
+const prepareSchema = navigatorAdviceBodySchema;
 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"]);
@@ -74,8 +76,8 @@ function rejectedPrepareReason(entries, start) {
   }
   return reason;
 }
-function normalizePrepareProse(value) {
-  return navigatorProseFromUnknown(value);
+function normalizePreparedAdvice(value) {
+  return preparedAdviceFromUnknown(value);
 }
 function navigatorSubjectKey(subjectRoot, subject, provenance = "role_input") {
   if (issueRoot(subjectRoot) !== void 0 || !subjectRoot.includes("/.ak/work/")) return subjectRoot;
@@ -125,7 +127,7 @@ function createNavigatorAttendance(options) {
   let subject = options.subject;
   let authority = options.authority;
   let contextError = options.contextError;
-  let preparedProse;
+  let preparedAdvice;
   const invocationPrincipal = options.invocationId ?? mintNavigatorInvocationId();
   let activeInvocationId = invocationPrincipal;
   let outputSink;
@@ -150,7 +152,6 @@ function createNavigatorAttendance(options) {
       unavailableCause: failure.unavailableCause
     };
   };
-  let prepareBoundSettlement;
   const loadMaterialsAndSession = async (invocationId) => {
     if (contextError !== void 0) throw navigatorUnavailableError("context", contextError);
     if (typeof authority !== "string" || authority.trim() === "") {
@@ -221,29 +222,32 @@ function createNavigatorAttendance(options) {
     if (session === void 0) throw new Error("Navigator session was not created");
     return session;
   };
-  const prepare = async (existingSession) => {
-    const boundSettlement = prepareBoundSettlement;
-    prepareBoundSettlement = void 0;
+  const prepare = async () => {
     const invocationId = invocationPrincipal;
     activeInvocationId = invocationId;
     let output;
     let prepareBatchRejected = false;
     outputSink = (value) => {
+      const next = normalizePreparedAdvice(value);
       if (output === void 0) {
         output = value;
         return;
       }
-      const prior = normalizePrepareProse(output) ?? "";
-      const next = normalizePrepareProse(value) ?? "";
-      const merged = [prior, next].filter((part) => part.trim() !== "").join("\n\n");
-      output = { prose: merged };
+      const merged = mergePreparedAdvice(normalizePreparedAdvice(output), next);
+      output = {
+        ...merged?.prose === void 0 ? {} : { prose: merged.prose },
+        ...merged === void 0 || merged.byStatus.size === 0 ? {} : { byStatus: byStatusToPlainObject(merged.byStatus) }
+      };
     };
-    const activeSession = existingSession ?? await loadMaterialsAndSession(invocationId);
-    if (boundSettlement === void 0) return void 0;
+    const activeSession = await loadMaterialsAndSession(invocationId);
     const request = JSON.stringify({
-      ...boundSettlement,
+      kind: "prepare",
+      role: options.role,
+      phase: options.phase,
       invocationId,
-      subjectKey
+      subjectKey,
+      subject,
+      authority
     });
     try {
       try {
@@ -277,27 +281,21 @@ function createNavigatorAttendance(options) {
           }
         };
         await promptAllowingRejectedPrepare(request);
-        if (boundSettlement !== void 0) {
-          while (output === void 0 && prepareBatchRejected && delivery.nextAction() === "request-delivery") {
-            delivery.recordDeliveryRequest();
-            await promptAllowingRejectedPrepare(JSON.stringify(delivery.deliveryState()));
-          }
-          if (output === void 0 && delivery.nextAction() === "request-delivery") {
-            delivery.closeBudget();
-          }
-          if (output === void 0 && delivery.nextAction() === "no-receipt" && activeSession.providerFailure?.() === void 0) {
-            preparedProse = void 0;
-            return void 0;
-          }
+        while (output === void 0 && prepareBatchRejected && delivery.nextAction() === "request-delivery") {
+          delivery.recordDeliveryRequest();
+          await promptAllowingRejectedPrepare(JSON.stringify(delivery.deliveryState()));
+        }
+        if (output === void 0 && delivery.nextAction() === "request-delivery") {
+          delivery.closeBudget();
+        }
+        if (output === void 0 && delivery.nextAction() === "no-receipt" && activeSession.providerFailure?.() === void 0) {
+          preparedAdvice = void 0;
+          return void 0;
         }
       } catch (error) {
         throw error instanceof NavigatorUnavailableError ? error : navigatorUnavailableError("transport", error);
       }
       if (output === void 0) {
-        if (boundSettlement === void 0) {
-          preparedProse = void 0;
-          return void 0;
-        }
         const nativeFailure = [...activeSession.entries()].reverse().find((entry) => {
           if (!isRecord(entry) || entry.type !== "message" || !isRecord(entry.message)) return false;
           return entry.message.role === "assistant" && typeof entry.message.errorMessage === "string" && entry.message.errorMessage.trim() !== "";
@@ -309,12 +307,8 @@ function createNavigatorAttendance(options) {
         const cause = providerFailure?.cause ?? source;
         throw navigatorUnavailableError(source, errorMessage, cause);
       }
-      if (boundSettlement === void 0) {
-        preparedProse = void 0;
-        return void 0;
-      }
-      preparedProse = normalizePrepareProse(output);
-      return preparedProse;
+      preparedAdvice = normalizePreparedAdvice(output);
+      return preparedAdvice;
     } finally {
       const playbookFailure = activeSession.routePlaybookReadFailure?.();
       observedRoutePlaybookFailure = typeof playbookFailure === "string" && playbookFailure.trim() !== "" ? playbookFailure : void 0;
@@ -338,6 +332,7 @@ function createNavigatorAttendance(options) {
     prepare() {
       if (disposed || preparation !== void 0) return;
       preparationFailure = void 0;
+      preparedAdvice = void 0;
       preparationInFlight = true;
       preparation = prepare().finally(() => {
         preparationInFlight = false;
@@ -375,24 +370,8 @@ function createNavigatorAttendance(options) {
   };
   async function settleOnce(settlement) {
     if (disposed) return;
-    observedRoutePlaybookFailure = void 0;
     const invocationId = activeInvocationId ?? invocationPrincipal;
     let report;
-    if (sessionReady !== void 0) {
-      try {
-        await sessionReady;
-      } catch (error) {
-        preparationFailure ??= error;
-      }
-    }
-    if (preparation !== void 0) {
-      try {
-        await preparation;
-      } catch (error) {
-        preparationFailure ??= error;
-      }
-      preparation = void 0;
-    }
     const settlementFact = {
       invocationId,
       subjectKey,
@@ -401,8 +380,14 @@ function createNavigatorAttendance(options) {
       kind: settlement.kind,
       ..."status" in settlement && settlement.status !== void 0 ? { status: settlement.status } : {}
     };
-    let drainedProse;
     if (settlement.kind === "arrival") {
+      if (sessionReady !== void 0) {
+        try {
+          await sessionReady;
+        } catch (error) {
+          preparationFailure ??= error;
+        }
+      }
       session?.appendEntry(SETTLEMENT_ENTRY, settlementFact);
       if (preparationFailure !== void 0) {
         report = unavailable(invocationId, preparationFailure);
@@ -413,35 +398,32 @@ function createNavigatorAttendance(options) {
         };
       }
     } else {
-      if (session !== void 0) preparationFailure = void 0;
-      let coldSession;
-      if (session === void 0 && preparationFailure === void 0) {
+      if (sessionReady !== void 0) {
         try {
-          coldSession = await loadMaterialsAndSession(invocationId);
+          await sessionReady;
         } catch (error) {
-          preparationFailure = error;
+          preparationFailure ??= error;
         }
       }
-      session?.appendEntry(SETTLEMENT_ENTRY, settlementFact);
-      if (preparationFailure === void 0) {
-        prepareBoundSettlement = settlement;
-        preparation = prepare(coldSession);
-        void preparation.catch((error) => {
-          preparationFailure = error;
-        });
+      if (preparation !== void 0) {
         try {
-          drainedProse = await preparation;
+          await preparation;
         } catch (error) {
           preparationFailure ??= error;
         }
         preparation = void 0;
       }
+      session?.appendEntry(SETTLEMENT_ENTRY, settlementFact);
       if (preparationFailure !== void 0) {
         report = unavailable(invocationId, preparationFailure);
-      } else if (typeof drainedProse === "string" && drainedProse.trim() !== "") {
-        report = { disposition: "advice", prose: drainedProse };
       } else {
-        report = { disposition: "no-advice" };
+        const status = "status" in settlement ? settlement.status : void 0;
+        const picked = pickPreparedProse(preparedAdvice, status);
+        if (typeof picked === "string" && picked.trim() !== "") {
+          report = { disposition: "advice", prose: picked };
+        } else {
+          report = { disposition: "no-advice" };
+        }
       }
     }
     if (observedRoutePlaybookFailure !== void 0) {
@@ -470,8 +452,9 @@ function createNavigatorAttendance(options) {
     }
     preparation = void 0;
     sessionReady = void 0;
-    preparedProse = void 0;
+    preparedAdvice = void 0;
     preparationFailure = void 0;
+    observedRoutePlaybookFailure = void 0;
   }
 }
 function registerNavigatorModelCommand(pi, path = navigatorModelSettingPath()) {

package/dist/navigator-public-session.js

@@ -43,7 +43,6 @@ async function navigatorHostRunResumable(home, runId) {
 }
 function createNativeNavigatorSessionFactory(deps) {
   return async ({ context, tool }) => {
-    let thinkingLevel;
     const entries = [];
     let providerFailure;
     let noReceipt;
@@ -71,6 +70,9 @@ function createNativeNavigatorSessionFactory(deps) {
             role: "navigator",
             argv: [text],
             cwd: context.cwd,
+            // Attendance prepare always asks for structured byStatus (#1160).
+            // Direct `ak-role navigator` never sets this flag.
+            navigatorByStatusPrepare: true,
             ...summonHome === void 0 ? {} : { home: summonHome },
             ...context.signal === void 0 ? {} : { signal: context.signal }
           };
@@ -129,17 +131,23 @@ function createNativeNavigatorSessionFactory(deps) {
           if (outcome.kind !== "accepted") {
             return;
           }
-          const { navigatorProseFromUnknown } = await import("./package-contracts/navigator-output.js");
-          const proseParts = [];
+          const {
+            byStatusToPlainObject,
+            mergePreparedAdvice,
+            preparedAdviceFromUnknown
+          } = await import("./package-contracts/navigator-output.js");
+          let prepared = void 0;
           for (const payload of outcome.payloads ?? []) {
-            const prose = navigatorProseFromUnknown(payload);
-            if (prose !== void 0) proseParts.push(prose);
+            prepared = mergePreparedAdvice(prepared, preparedAdviceFromUnknown(payload));
           }
-          if (proseParts.length === 0) return;
+          if (prepared === void 0) return;
           if (disposed) return;
           await tool.execute(
             "navigator-public-prepare",
-            { prose: proseParts.join("\n\n") },
+            {
+              ...prepared.prose === void 0 ? {} : { prose: prepared.prose },
+              ...prepared.byStatus.size === 0 ? {} : { byStatus: byStatusToPlainObject(prepared.byStatus) }
+            },
             void 0,
             void 0,
             context
@@ -168,16 +176,13 @@ function createNativeNavigatorSessionFactory(deps) {
         });
       },
       entries: () => entries,
-      setModel: async (next, nextThinking) => {
-        let nextParsed;
+      setModel: async (next) => {
         try {
-          nextParsed = parseNavigatorModelSetting(next);
+          parseNavigatorModelSetting(next);
         } catch (error) {
           throw navigatorUnavailableError("model", error);
         }
-        thinkingLevel = nextThinking ?? nextParsed.thinkingLevel;
       },
-      getThinkingLevel: () => thinkingLevel,
       dispose: async () => {
         disposed = true;
       }

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

@@ -3,30 +3,59 @@ import { isRecord } from "../unknown-value.js";
 import { openToolObject } from "../open-tool-schema.js";
 import { withTerminatingOutputDeclarations } from "./terminating-infrastructure.js";
 const NAVIGATOR_OUTPUT_TOOL_NAME = "ak_navigator_output";
-const navigatorOutputSchema = withTerminatingOutputDeclarations(
-  openToolObject(
-    Type.Object({
-      prose: Type.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"
-      })
-    })
-  )
-);
+const navigatorAdviceFields = {
+  prose: Type.Unknown({
+    description: "\u5355\u6761\u6563\u6587\u5EFA\u8BAE\u3002\u65E0\u72B6\u6001\u5206\u53C9\u65F6\u4F7F\u7528\uFF1B\u539F\u6837\u5448\u73B0\u3002"
+  }),
+  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"
+  })
+};
+const navigatorAdviceBodySchema = openToolObject(Type.Object(navigatorAdviceFields));
+const navigatorOutputSchema = withTerminatingOutputDeclarations(navigatorAdviceBodySchema);
+function nonEmptyProse(value) {
+  if (typeof value === "string") {
+    return value.trim() === "" ? void 0 : value;
+  }
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value === "object") {
+    const text2 = JSON.stringify(value);
+    if (text2 === void 0 || text2.trim() === "" || text2 === "{}" || text2 === "[]") return void 0;
+    return text2;
+  }
+  const text = String(value);
+  return text.trim() === "" ? void 0 : text;
+}
+function setStatusProse(target, key, prose) {
+  const prior = target.get(key);
+  target.set(key, prior === void 0 ? prose : `${prior}
+
+${prose}`);
+}
+function byStatusFromUnknown(value) {
+  const out = /* @__PURE__ */ new Map();
+  if (!isRecord(value)) return out;
+  for (const [key, raw] of Object.entries(value)) {
+    const prose = nonEmptyProse(raw);
+    if (prose !== void 0) out.set(key, prose);
+  }
+  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 };
   if (isRecord(value)) {
     if (typeof value.prose === "string") return { prose: value.prose };
     if (value.prose !== void 0 && value.prose !== null) {
-      return { prose: typeof value.prose === "string" ? value.prose : String(value.prose) };
+      const serialized = nonEmptyProse(value.prose);
+      if (serialized !== void 0) return { prose: serialized };
     }
     const keys = Object.keys(value);
     if (keys.length === 0) return { prose: "" };
-    try {
-      return { prose: JSON.stringify(value) };
-    } catch {
-      return { prose: String(value) };
-    }
+    return { prose: JSON.stringify(value) };
   }
   return { prose: String(value) };
 }
@@ -43,10 +72,67 @@ function navigatorProseFromUnknown(value) {
   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") {
+    const prose2 = nonEmptyProse(value);
+    return prose2 === void 0 ? void 0 : { byStatus: /* @__PURE__ */ new Map(), prose: prose2 };
+  }
+  if (!isRecord(value)) {
+    const prose2 = nonEmptyProse(value);
+    return prose2 === void 0 ? void 0 : { byStatus: /* @__PURE__ */ new Map(), prose: prose2 };
+  }
+  const byStatus = byStatusFromUnknown(value.byStatus);
+  const hasProseField = Object.prototype.hasOwnProperty.call(value, "prose");
+  const hasByStatusField = Object.prototype.hasOwnProperty.call(value, "byStatus");
+  const prose = nonEmptyProse(value.prose);
+  if (byStatus.size === 0 && prose === void 0) {
+    if (hasProseField || hasByStatusField) return void 0;
+    const keys = Object.keys(value);
+    if (keys.length === 0) return void 0;
+    const text = JSON.stringify(value);
+    return text.trim() === "" || text === "{}" ? void 0 : { byStatus: /* @__PURE__ */ new Map(), prose: text };
+  }
+  return {
+    byStatus,
+    ...prose === void 0 ? {} : { prose }
+  };
+}
+function mergePreparedAdvice(prior, next) {
+  if (prior === void 0) return next;
+  if (next === void 0) return prior;
+  const byStatus = new Map(prior.byStatus);
+  for (const [key, prose2] of next.byStatus) {
+    setStatusProse(byStatus, key, prose2);
+  }
+  const proseParts = [prior.prose, next.prose].filter((part) => typeof part === "string" && part.trim() !== "");
+  const prose = proseParts.length === 0 ? void 0 : proseParts.join("\n\n");
+  if (byStatus.size === 0 && prose === void 0) return void 0;
+  return {
+    byStatus,
+    ...prose === void 0 ? {} : { prose }
+  };
+}
+function pickPreparedProse(prepared, status) {
+  if (prepared === void 0) return void 0;
+  if (prepared.byStatus.size > 0) {
+    if (status === void 0) return void 0;
+    const hit = prepared.byStatus.get(status);
+    return typeof hit === "string" && hit.trim() !== "" ? hit : void 0;
+  }
+  const prose = prepared.prose;
+  return typeof prose === "string" && prose.trim() !== "" ? prose : void 0;
+}
 export {
   NAVIGATOR_OUTPUT_TOOL_NAME,
+  byStatusToPlainObject,
+  mergePreparedAdvice,
+  navigatorAdviceBodySchema,
+  navigatorAdviceFields,
   navigatorOutputSchema,
   navigatorProseFromUnknown,
+  pickPreparedProse,
+  preparedAdviceFromUnknown,
   projectLawfulNavigatorOutput,
   validateRecordedNavigatorOutput
 };

package/dist/pi/role-turn-host.js

@@ -103,8 +103,10 @@ export function buildPiTurnExtraArgs(request, authority, extraPiArgs = []) {
         // Envelope assembly = projectActivationFlags; pi only renders argv pairs.
         ...activationFlagsToPiArgv(projectActivationFlags(request)),
         ...piEngineModelArgs(request),
+        // #1182: text single-shot keeps pi's native assistant error/aborted
+        // exit (stderr + exit 1). json mode never takes that failure branch.
         "--mode",
-        "json",
+        "text",
         ...buildSeatModelCliArgs(request.model),
     ];
 }

package/dist/public-cli/main.js

@@ -9037,7 +9037,7 @@ var init_gatekeeper_output = __esm({
 });
 
 // src/package-contracts/navigator-output.ts
-var NAVIGATOR_OUTPUT_TOOL_NAME, navigatorOutputSchema;
+var NAVIGATOR_OUTPUT_TOOL_NAME, navigatorAdviceFields, navigatorAdviceBodySchema, navigatorOutputSchema;
 var init_navigator_output = __esm({
   "src/package-contracts/navigator-output.ts"() {
     "use strict";
@@ -9046,15 +9046,16 @@ var init_navigator_output = __esm({
     init_open_tool_schema();
     init_terminating_infrastructure();
     NAVIGATOR_OUTPUT_TOOL_NAME = "ak_navigator_output";
-    navigatorOutputSchema = withTerminatingOutputDeclarations(
-      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"
-          })
-        })
-      )
-    );
+    navigatorAdviceFields = {
+      prose: typebox_exports.Unknown({
+        description: "\u5355\u6761\u6563\u6587\u5EFA\u8BAE\u3002\u65E0\u72B6\u6001\u5206\u53C9\u65F6\u4F7F\u7528\uFF1B\u539F\u6837\u5448\u73B0\u3002"
+      }),
+      byStatus: typebox_exports.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"
+      })
+    };
+    navigatorAdviceBodySchema = openToolObject(typebox_exports.Object(navigatorAdviceFields));
+    navigatorOutputSchema = withTerminatingOutputDeclarations(navigatorAdviceBodySchema);
   }
 });
 
@@ -17571,8 +17572,10 @@ function buildPiTurnExtraArgs(request, authority, extraPiArgs = []) {
     // Envelope assembly = projectActivationFlags; pi only renders argv pairs.
     ...activationFlagsToPiArgv(projectActivationFlags(request)),
     ...piEngineModelArgs(request),
+    // #1182: text single-shot keeps pi's native assistant error/aborted
+    // exit (stderr + exit 1). json mode never takes that failure branch.
     "--mode",
-    "json",
+    "text",
     ...buildSeatModelCliArgs2(request.model)
   ];
 }
@@ -18939,6 +18942,7 @@ function projectRoleTurnRequest(admitted, roleDetails, options) {
     ...options.courtAttemptId === void 0 || options.courtAttemptId.length === 0 ? {} : { courtAttemptId: options.courtAttemptId },
     ...options.invocationScopeId === void 0 || options.invocationScopeId.length === 0 ? {} : { invocationScopeId: options.invocationScopeId },
     ...options.stationChild === void 0 ? {} : { stationChild: options.stationChild },
+    ...options.navigatorByStatusPrepare === void 0 ? {} : { navigatorByStatusPrepare: options.navigatorByStatusPrepare },
     ...options.deliveryRequestLimit === void 0 ? {} : { deliveryRequestLimit: options.deliveryRequestLimit }
   };
 }
@@ -20576,6 +20580,7 @@ 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 },
@@ -22768,6 +22773,9 @@ async function dispatchPostAdmissionTurn(input) {
     if (env.stationChild !== void 0) {
       turnRequest = { ...turnRequest, stationChild: env.stationChild };
     }
+    if (env.navigatorByStatusPrepare === true) {
+      turnRequest = { ...turnRequest, navigatorByStatusPrepare: true };
+    }
     if (typeof env.host === "string" && env.host.trim() !== "") {
       turnRequest = { ...turnRequest, host: env.host.trim() };
     }
@@ -23026,6 +23034,7 @@ function resumeTurnRequestProjectionOptions(admitted, request, env, summonsPrepa
       prompt
     },
     ...env.stationChild === void 0 ? {} : { stationChild: env.stationChild },
+    ...env.navigatorByStatusPrepare === true ? { navigatorByStatusPrepare: true } : {},
     // #1132: one configured ceiling, already resolved by the caller (#422).
     deliveryRequestLimit: deliveryLimitFromConfig(env.autoResumeLimit)
   };
@@ -23038,6 +23047,7 @@ function roleTurnOptions(env, admitted, continuation) {
     ...correlationId === void 0 || correlationId.trim() === "" ? {} : { correlationId },
     continuation,
     ...env.stationChild === void 0 ? {} : { 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/post-admission.js

@@ -812,6 +812,9 @@ 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() !== "") {
@@ -1115,6 +1118,9 @@ 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),
     };
@@ -1130,6 +1136,9 @@ 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/turn-request.js

@@ -45,6 +45,9 @@ 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,6 +187,7 @@ 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.5663",
+  "version": "0.1.5673",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",

package/resources/navigator-route-playbook.md

@@ -1,9 +1,9 @@
-## 到场阶段（#959 / ADR 0073 / #1021）
+## 到场阶段（#1160 / ADR 0073）
 
 阶段行为说明住本手册。代码不写阶段句，也不把本手册再拼进用户消息。
 
-- **待命**：父衙门进行中时，代码只记到场，不调用模型。这一轮没有输出。
-- **结算**：父衙门结算送达后，用户消息只有该次 typed 三态及指针。Soul 与本手册已在系统提示里。根据这份结算和本手册给出下一步建议。
+- **备答**：父衙门一开始即并行准备。自行判断当前进度——有票时读票卷宗里实际发生的角色运行，必要时看票面；不把过去建议或建议送达当作已经走过的站。按主衙门可能的结局 status 预写建议，经 `byStatus` 提交（键为 status 字面量，值为建议正文）。无状态分叉时可用单条 `prose`。
+- **取用**：父衙门交卷后，代码只按实际 status 取对应原文，不再起模型轮次。没有对应建议则如实无建议。主衙门结束后最多再等十秒；到时停止等待，不扣押主结果。
 
 ## 宿主轴（与角色命令面）
 

package/src/headless-host/description.ts

@@ -433,7 +433,8 @@ export function codexTurnArgs(options: {
   /**
    * Absolute path for the native `--output-schema` flag.
    * File holds the Codex-strict transport projection of the open declaration (#1148).
-   * Optional for prose-exit seats (#959 navigator) so agent_message stays free text.
+   * Optional: omit for direct navigator prose exit (#959); attendance byStatus
+   * prepare mounts it via RoleTurnRequest.navigatorByStatusPrepare (#1160).
    */
   readonly outputSchemaPath?: string;
   readonly mcpServers: readonly Readonly<Record<string, unknown>>[];