@akagilnc/pi-workflow-roles 0.1.4528 → 0.1.4620

package/dist/migrate-book-topology.js

@@ -8670,11 +8670,8 @@ var init_navigator_output = __esm({
     navigatorOutputSchema = withTerminatingOutputDeclarations(
       openToolObject(
         typebox_exports.Object({
-          status: typebox_exports.Unknown({
-            description: "advice \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8"
-          }),
-          candidates: typebox_exports.Unknown({
-            description: "\u6392\u597D\u5E8F\u7684\u8DEF\u7EBF\u5EFA\u8BAE\u6570\u7EC4\uFF0C\u5143\u7D20\u542B next/phase/reason \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8"
+          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\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8"
           })
         })
       )
@@ -14532,12 +14529,12 @@ var init_option_definitions = __esm({
         canonical: "--lens",
         aliases: [],
         valueMetavar: "completeness|correctness",
-        required: true,
+        required: false,
         repeatable: false,
         form: "option",
         description: {
-          en: "Required single review lens: completeness or correctness (no default).",
-          zh: "\u5FC5\u586B\u5355 lens\uFF1Acompleteness \u6216 correctness\uFF08\u65E0\u9ED8\u8BA4\u503C\uFF09\u3002"
+          en: "Optional single-lens override: completeness or correctness; omitted runs both in parallel.",
+          zh: "\u53EF\u9009\u5355 lens \u8986\u76D6\uFF1Acompleteness \u6216 correctness\uFF1B\u7701\u7565\u65F6\u5E76\u884C\u8FD0\u884C\u4E24\u8F74\u3002"
         }
       },
       {
@@ -14743,9 +14740,9 @@ var init_option_definitions = __esm({
       },
       reviewer: {
         command: "reviewer",
-        summary: "Fixed-target single-lens review (completeness or correctness).",
+        summary: "Fixed-target parallel two-lens review, with an optional single-lens override.",
         usage: [
-          "ak-role reviewer --base <revision> --lens completeness|correctness --authority-ref <ref> [options] <instruction>"
+          "ak-role reviewer --base <revision> [--lens completeness|correctness] --authority-ref <ref> [options] <instruction>"
         ],
         examples: [
           'ak-role reviewer --base main --lens completeness --authority-ref docs/adr/0001.md "Review the branch."',
@@ -14796,7 +14793,7 @@ var init_option_definitions = __esm({
       },
       navigator: {
         command: "navigator",
-        summary: "Direct Navigator (\u6E38\u5955\u4F7F) route advice: ordered next-role candidates.",
+        summary: "Direct Navigator (\u6E38\u5955\u4F7F) free-form prose route advice.",
         usage: ["ak-role navigator [options] [instruction]"],
         examples: [
           'ak-role navigator "\u521A\u5B8C\u6210 coder apply \u6536\u655B\uFF0C\u4E0B\u4E00\u6B65\uFF1F"'

package/dist/navigator-attendance.js

@@ -8,7 +8,7 @@ import {
   NAVIGATOR_INVOCATION_ENTRY,
   mintNavigatorInvocationId
 } from "./navigator-invocation-identity.js";
-import { PACKAGED_ROLE_REGISTRY, packagedRoleMetadata } from "./packaged-role-registry.js";
+import { PACKAGED_ROLE_REGISTRY } from "./packaged-role-registry.js";
 import {
   activationBookDirectory,
   resolveActivationLedgerHome
@@ -30,9 +30,9 @@ import {
   writeNavigatorModelSetting
 } from "./navigator-session-contracts.js";
 import { sitianReport } from "./sitian-facade.js";
-import { renderPublicAkRoleCommand } from "./public-command-renderer.js";
 import { issueRoot, subjectPath } from "./work-subject-identity.js";
 import { createReceiptDeliveryPolicy, NO_RECEIPT_LIFECYCLE_ENTRY_TYPE, RECEIPT_DELIVERY_PROMPT } from "./receipt-delivery-policy.js";
+import { navigatorProseFromUnknown } from "./package-contracts/navigator-output.js";
 const NAVIGATOR_EVENT_TYPE = "ak-navigator-attendance";
 const NAVIGATOR_PREPARE_ACCEPTED_TEXT = "\u6E38\u5955\u4F7F\u51C6\u5907\u5DF2\u63A5\u53D7";
 function resolveNavigatorAuthorityMaterial(roleInput, fileAuthority) {
@@ -42,15 +42,13 @@ function resolveNavigatorAuthorityMaterial(roleInput, fileAuthority) {
 }
 const NAVIGATOR_TARGETS = PACKAGED_ROLE_REGISTRY.map(({ role, phases }) => ({ role, phases }));
 const prepareSchema = Type.Object({
-  candidates: Type.Optional(Type.Unknown({
-    description: "\u65B9\u5411\u5019\u9009\uFF1Bcandidates[].next.role \u5FC5\u586B\uFF0Cphase \u53EF\u9009\uFF0Croute/matches/reason/command \u53EF\u9009\u4E0A\u4E0B\u6587\uFF0C\u975E\u53D7\u7406\u95F8"
+  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\u975E\u53D7\u7406\u95F8"
   }))
 }, { additionalProperties: true });
-const ROUTE_ENTRY = "ak-navigator-route";
 const CONTEXT_ENTRY = "ak-navigator-context";
 const INVOCATION_ENTRY = NAVIGATOR_INVOCATION_ENTRY;
 const SETTLEMENT_ENTRY = "ak-navigator-settlement";
-const targetRoles = new Set(NAVIGATOR_TARGETS.map(({ role }) => role));
 const unavailableKeys = /* @__PURE__ */ new Set(["context", "session", "model", "thinking", "auth", "quota", "transport", "unknown"]);
 function unavailableKey(value) {
   return typeof value === "string" && unavailableKeys.has(value) ? value : void 0;
@@ -80,73 +78,8 @@ function rejectedPrepareReason(entries, start) {
   }
   return reason;
 }
-function targetIsValid(value) {
-  if (!exactRecord(value) || !targetRoles.has(String(value.role))) return false;
-  const metadata = packagedRoleMetadata(String(value.role));
-  return metadata !== void 0 && metadata.phases.includes(value.phase);
-}
-function normalizeTarget(value) {
-  if (!exactRecord(value)) return void 0;
-  const role = typeof value.role === "string" ? value.role.trim() : "";
-  if (role === "") return void 0;
-  if (value.phase === void 0 || value.phase === null) {
-    return { role, phase: null };
-  }
-  if (value.phase === "plan" || value.phase === "apply") {
-    return { role, phase: value.phase };
-  }
-  return { role, phase: null };
-}
-function normalizeMatches(value) {
-  if (!exactRecord(value)) return void 0;
-  if (typeof value.role !== "string" || value.role.trim() === "") return void 0;
-  if (value.kind !== "accepted") return void 0;
-  let phase;
-  if (value.phase === void 0 || value.phase === null) phase = null;
-  else if (value.phase === "plan" || value.phase === "apply") phase = value.phase;
-  else return void 0;
-  if (value.statuses !== void 0) {
-    if (!Array.isArray(value.statuses) || value.statuses.some((status) => typeof status !== "string" || status.trim() === "")) {
-      return void 0;
-    }
-    return {
-      role: value.role,
-      phase,
-      kind: "accepted",
-      statuses: [...value.statuses]
-    };
-  }
-  return { role: value.role, phase, kind: "accepted" };
-}
-function normalizeCandidate(value) {
-  if (!exactRecord(value)) return void 0;
-  const next = normalizeTarget(value.next);
-  const route = Array.isArray(value.route) ? value.route.map(normalizeTarget).filter((target) => target !== void 0) : void 0;
-  const matches = normalizeMatches(value.matches);
-  const id = typeof value.id === "string" && value.id.trim() !== "" ? value.id : void 0;
-  const reason = typeof value.reason === "string" && value.reason.trim() !== "" ? value.reason : void 0;
-  const command = typeof value.command === "string" ? value.command : void 0;
-  return {
-    ...id === void 0 ? {} : { id },
-    ...matches === void 0 ? {} : { matches },
-    ...route === void 0 || route.length === 0 ? {} : { route },
-    ...next === void 0 ? {} : { next },
-    ...reason === void 0 ? {} : { reason },
-    ...command === void 0 ? {} : { command }
-  };
-}
-function normalizePrepareOutput(value) {
-  if (!exactRecord(value) || !Array.isArray(value.candidates)) return [];
-  return value.candidates.map(normalizeCandidate).filter((candidate) => candidate !== void 0);
-}
-function routeEqual(a, b) {
-  return a !== void 0 && a.length === b.length && a.every((target, index) => target.role === b[index].role && target.phase === b[index].phase);
-}
-function routeText(route) {
-  return route.map((target) => target.phase === null ? target.role : `${target.role} ${target.phase}`).join(" \u2192 ");
-}
-function targetText(target) {
-  return target.phase === null ? target.role : `${target.role} ${target.phase}`;
+function normalizePrepareProse(value) {
+  return navigatorProseFromUnknown(value);
 }
 function navigatorSubjectKey(subjectRoot, subject, provenance = "role_input") {
   if (issueRoot(subjectRoot) !== void 0 || !subjectRoot.includes("/.ak/work/")) return subjectRoot;
@@ -168,7 +101,7 @@ function createNavigatorPrepareTool(onOutput) {
   return {
     name: NAVIGATOR_PREPARE_TOOL_NAME,
     label: "\u6E38\u5955\u4F7F\u51C6\u5907",
-    description: "\u63D0\u4EA4\u6E38\u5955\u4F7F\u65B9\u5411\u5EFA\u8BAE\u3002",
+    description: "\u63D0\u4EA4\u6E38\u5955\u4F7F\u6563\u6587\u5EFA\u8BAE\u3002",
     parameters: prepareSchema,
     async execute(_id, value) {
       onOutput(value);
@@ -176,34 +109,6 @@ function createNavigatorPrepareTool(onOutput) {
     }
   };
 }
-function selectNavigatorCandidate(candidates, settlement) {
-  if (settlement.kind !== "accepted") return void 0;
-  const usable = candidates.filter((candidate) => candidate.next !== void 0);
-  if (usable.length === 0) return void 0;
-  const rolePhaseMatched = usable.filter(
-    (candidate) => candidate.matches !== void 0 && candidate.matches.role === settlement.role && candidate.matches.phase === settlement.phase
-  );
-  if (rolePhaseMatched.length > 0) {
-    if (settlement.status !== void 0) {
-      const statusSpecific = rolePhaseMatched.find(
-        (candidate) => candidate.matches?.statuses !== void 0 && candidate.matches.statuses.includes(settlement.status)
-      );
-      if (statusSpecific !== void 0) {
-        return { candidate: statusSpecific, matchedToSettlement: true };
-      }
-    }
-    const rolePhaseGeneric = rolePhaseMatched.find(
-      (candidate) => candidate.matches?.statuses === void 0
-    );
-    if (rolePhaseGeneric !== void 0) {
-      return { candidate: rolePhaseGeneric, matchedToSettlement: true };
-    }
-    return void 0;
-  }
-  const unbound = usable.find((candidate) => candidate.matches === void 0);
-  if (unbound === void 0) return void 0;
-  return { candidate: unbound, matchedToSettlement: false };
-}
 function formatNavigatorReport(report) {
   const playbookFailure = report.routePlaybookReadFailure === void 0 ? [] : [`\u8DEF\u4E66\u8BFB\u53D6\u5931\u8D25\uFF1A${report.routePlaybookReadFailure}`];
   if (report.disposition === "no-advice") return playbookFailure.join("\n");
@@ -213,42 +118,24 @@ function formatNavigatorReport(report) {
   if (report.disposition === "arrival") {
     return [...playbookFailure, ...report.arrivalMessage ? [report.arrivalMessage] : []].join("\n");
   }
-  return [
-    ...playbookFailure,
-    ...report.route === void 0 ? [] : [`\u8DEF\u7EBF\uFF1A${routeText(report.route)}`],
-    ...report.next === void 0 ? [] : [`\u4E0B\u4E00\u6B65\uFF1A${targetText(report.next)}`],
-    ...report.reason === void 0 || report.reason.trim() === "" ? [] : [`\u7406\u7531\uFF1A${report.reason}`],
-    ...report.command === void 0 || report.command.trim() === "" ? [] : [`\u547D\u4EE4\uFF1A${report.command}`]
-  ].join("\n");
-}
-function settlementNavigationFromEvent(event) {
-  if (event.disposition !== "recommendation") return void 0;
-  if (event.next === void 0) return void 0;
-  return {
-    disposition: "recommendation",
-    ...event.route === void 0 ? {} : { route: event.route },
-    next: event.next,
-    ...event.reason === void 0 ? {} : { reason: event.reason },
-    ...event.command === void 0 ? {} : { command: event.command }
-  };
+  return [...playbookFailure, ...report.prose ? [report.prose] : []].join("\n");
 }
 function createNavigatorAttendance(options) {
   let preparation;
+  let preparationInFlight = false;
   let sessionReady;
   let session;
   let subjectKey = options.subjectKey;
   let subject = options.subject;
   let authority = options.authority;
   let contextError = options.contextError;
-  let candidates;
+  let preparedProse;
   const invocationPrincipal = options.invocationId ?? mintNavigatorInvocationId();
   let activeInvocationId = invocationPrincipal;
-  let previousRoute;
   let outputSink;
   let settlementTail = Promise.resolve();
   let settlementFailure;
   let preparationFailure;
-  let preparationNoReceipt = false;
   let routePlaybookReadFailure;
   let disposed = false;
   let warmedHelp;
@@ -275,12 +162,7 @@ function createNavigatorAttendance(options) {
   };
   let routePlaybookSettlement;
   let prepareBoundSettlement;
-  const prepare = async () => {
-    const boundSettlement = prepareBoundSettlement;
-    prepareBoundSettlement = void 0;
-    preparationNoReceipt = false;
-    const invocationId = invocationPrincipal;
-    activeInvocationId = invocationId;
+  const loadMaterialsAndSession = async (invocationId) => {
     if (contextError !== void 0) throw navigatorUnavailableError("context", contextError);
     if (typeof authority !== "string" || authority.trim() === "") {
       throw navigatorUnavailableError(
@@ -338,21 +220,6 @@ function createNavigatorAttendance(options) {
     const helpContext = help.map(({ role, help: text }) => `<role_help role="${role}">
 ${text}
 </role_help>`).join("\n");
-    let output;
-    let prepareBatchRejected = false;
-    outputSink = (value) => {
-      if (output === void 0) {
-        output = value;
-        return;
-      }
-      const prior2 = output.candidates;
-      const next = value.candidates;
-      const merged = [
-        ...Array.isArray(prior2) ? prior2 : prior2 === void 0 ? [] : [prior2],
-        ...Array.isArray(next) ? next : next === void 0 ? [] : [next]
-      ];
-      output = { ...value, candidates: merged };
-    };
     const tool = createNavigatorPrepareTool((value) => {
       outputSink?.(value);
     });
@@ -360,7 +227,12 @@ ${text}
       sessionReady = (async () => {
         let created;
         try {
-          created = await options.createSession({ context: options.context, subject: subjectKey, ...options.modelSettingPath === void 0 ? {} : { modelSettingPath: options.modelSettingPath }, tool });
+          created = await options.createSession({
+            context: options.context,
+            subject: subjectKey,
+            ...options.modelSettingPath === void 0 ? {} : { modelSettingPath: options.modelSettingPath },
+            tool
+          });
         } catch (error) {
           throw navigatorUnavailableError("session", error);
         }
@@ -391,12 +263,27 @@ ${text}
       session.appendEntry(INVOCATION_ENTRY, { invocationId, role: options.role, phase: options.phase, subjectKey });
     }
     if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-    const activeSession = session;
-    if (activeSession === void 0) throw new Error("Navigator session was not created");
-    const prior = activeSession.entries().filter((entry) => exactRecord(entry) && entry.type === "custom" && entry.customType === ROUTE_ENTRY && exactRecord(entry.data) && entry.data.subjectKey === subjectKey).at(-1)?.data;
-    if (exactRecord(prior) && Array.isArray(prior.route) && prior.route.every((target) => targetIsValid(target))) {
-      previousRoute = prior.route.map((target) => ({ role: target.role, phase: target.phase }));
-    }
+    if (session === void 0) throw new Error("Navigator session was not created");
+    return { soul, routePlaybook, helpContext, modelSetting, model, help, activeSession: session };
+  };
+  const prepare = async (materialsBundle) => {
+    const boundSettlement = prepareBoundSettlement;
+    prepareBoundSettlement = void 0;
+    const invocationId = invocationPrincipal;
+    activeInvocationId = invocationId;
+    let output;
+    let prepareBatchRejected = false;
+    outputSink = (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 { soul, routePlaybook, helpContext, help, activeSession } = materialsBundle ?? await loadMaterialsAndSession(invocationId);
     const publicSettlementHistory = activeSession.entries().filter((entry) => exactRecord(entry) && entry.type === "custom" && entry.customType === SETTLEMENT_ENTRY && exactRecord(entry.data)).map((entry) => entry.data);
     const projection = {
       subjectKey,
@@ -404,13 +291,12 @@ ${text}
       authority,
       currentRole: { role: options.role, phase: options.phase },
       ...boundSettlement === void 0 ? {} : { currentSettlement: boundSettlement },
-      priorRoute: exactRecord(prior) && Array.isArray(prior.route) && prior.route.every((target) => targetIsValid(target)) ? prior.route.map((target) => ({ role: target.role, phase: target.phase })) : null,
       publicSettlementHistory,
       liveRoleHelp: help
     };
     activeSession.appendEntry(CONTEXT_ENTRY, projection);
-    const request = [
-      "\u672C\u6B21\u5BFC\u822A\u6750\u6599\u5982\u4E0B\uFF1A",
+    const request = boundSettlement === void 0 ? [
+      "\u672C\u8F6E\u4E3A\u5F85\u547D\u8F6E\u3002",
       `<navigator_soul>
 ${soul}
 </navigator_soul>`,
@@ -426,12 +312,32 @@ ${authority}
       `<current_role>
 ${JSON.stringify({ role: options.role, phase: options.phase })}
 </current_role>`,
-      ...boundSettlement === void 0 ? [] : [`<current_settlement>
+      `<public_settlement_history>
+${JSON.stringify(projection.publicSettlementHistory)}
+</public_settlement_history>`,
+      `<live_role_help>
+${helpContext}
+</live_role_help>`
+    ].join("\n\n") : [
+      "\u672C\u8F6E\u4E3A\u7ED3\u7B97\u6295\u5582\u8F6E\u3002",
+      `<navigator_soul>
+${soul}
+</navigator_soul>`,
+      ...routePlaybookReadFailure === void 0 ? [`<route_playbook>
+${routePlaybook}
+</route_playbook>`] : ["\u53EF\u9009\u8DEF\u7EBF\u624B\u518C\u672A\u80FD\u8BFB\u53D6\u3002"],
+      `<work_subject>
+${subject}
+</work_subject>`,
+      `<controlling_authority>
+${authority}
+</controlling_authority>`,
+      `<current_role>
+${JSON.stringify({ role: options.role, phase: options.phase })}
+</current_role>`,
+      `<current_settlement>
 ${JSON.stringify(boundSettlement)}
-</current_settlement>`],
-      `<prior_route>
-${JSON.stringify(prior ?? null)}
-</prior_route>`,
+</current_settlement>`,
       `<public_settlement_history>
 ${JSON.stringify(projection.publicSettlementHistory)}
 </public_settlement_history>`,
@@ -472,20 +378,30 @@ ${helpContext}
           if (deliveryRequest && output === void 0) delivery.recordDeliveryRequest();
         };
         await promptAllowingRejectedPrepare(request, false);
-        while (output === void 0 && delivery.nextAction() === "request-delivery") {
-          await promptAllowingRejectedPrepare(RECEIPT_DELIVERY_PROMPT, true);
-        }
-        if (output === void 0 && delivery.nextAction() === "no-receipt" && activeSession.providerFailure?.() === void 0) {
-          const facts = delivery.facts({ runPointer: activeSession.recordPointer(), attemptPointer: invocationId });
-          activeSession.appendEntry(NO_RECEIPT_LIFECYCLE_ENTRY_TYPE, facts);
-          preparationNoReceipt = true;
-          candidates = [];
-          return candidates;
+        if (boundSettlement !== void 0) {
+          while (output === void 0 && prepareBatchRejected && delivery.nextAction() === "request-delivery") {
+            await promptAllowingRejectedPrepare(RECEIPT_DELIVERY_PROMPT, true);
+          }
+          if (output === void 0 && delivery.nextAction() === "request-delivery") {
+            while (delivery.nextAction() === "request-delivery") {
+              delivery.recordDeliveryRequest();
+            }
+          }
+          if (output === void 0 && delivery.nextAction() === "no-receipt" && activeSession.providerFailure?.() === void 0) {
+            const facts = delivery.facts({ runPointer: activeSession.recordPointer(), attemptPointer: invocationId });
+            activeSession.appendEntry(NO_RECEIPT_LIFECYCLE_ENTRY_TYPE, facts);
+            preparedProse = 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 (!exactRecord(entry) || entry.type !== "message" || !exactRecord(entry.message)) return false;
           return entry.message.role === "assistant" && typeof entry.message.errorMessage === "string" && entry.message.errorMessage.trim() !== "";
@@ -497,8 +413,12 @@ ${helpContext}
         const cause = providerFailure?.cause ?? source;
         throw navigatorUnavailableError(source, errorMessage, cause);
       }
-      candidates = normalizePrepareOutput(output);
-      return candidates;
+      if (boundSettlement === void 0) {
+        preparedProse = void 0;
+        return void 0;
+      }
+      preparedProse = normalizePrepareProse(output);
+      return preparedProse;
     } finally {
       outputSink = void 0;
     }
@@ -509,7 +429,6 @@ ${helpContext}
       if (next.subjectKey !== subjectKey && session !== void 0) {
         const previous = session;
         session = void 0;
-        previousRoute = void 0;
         closing = previous.dispose();
       }
       subjectKey = next.subjectKey;
@@ -531,13 +450,16 @@ ${helpContext}
     prepare() {
       if (disposed || preparation !== void 0) return;
       preparationFailure = void 0;
-      preparation = prepare();
+      preparationInFlight = true;
+      preparation = prepare().finally(() => {
+        preparationInFlight = false;
+      });
       void preparation.catch((error) => {
         preparationFailure = error;
       });
     },
     isPreparing() {
-      return preparation !== void 0 || sessionReady !== void 0;
+      return preparationInFlight;
     },
     knownRoutePlaybookReadFailure() {
       return routePlaybookReadFailure;
@@ -561,81 +483,70 @@ ${helpContext}
     if (disposed) return;
     const invocationId = activeInvocationId ?? invocationPrincipal;
     let report;
-    if (settlement.kind === "human_decision" || settlement.kind === "role_infrastructure_failure") {
-      if (sessionReady !== void 0) {
-        try {
-          await sessionReady;
-        } catch (error) {
-          preparationFailure ??= error;
-        }
+    if (sessionReady !== void 0) {
+      try {
+        await sessionReady;
+      } catch (error) {
+        preparationFailure ??= error;
       }
-      if (preparation !== void 0) {
-        try {
-          await preparation;
-        } catch (error) {
-          preparationFailure ??= error;
-        }
+    }
+    if (preparation !== void 0) {
+      try {
+        await preparation;
+      } catch (error) {
+        preparationFailure ??= error;
       }
-      session?.appendEntry(SETTLEMENT_ENTRY, { invocationId, subjectKey, role: settlement.role, phase: settlement.phase, kind: settlement.kind, ...settlement.kind === "human_decision" ? { status: settlement.status } : {} });
+      preparation = void 0;
+    }
+    const settlementFact = {
+      invocationId,
+      subjectKey,
+      role: settlement.role,
+      phase: settlement.phase,
+      kind: settlement.kind,
+      ..."status" in settlement && settlement.status !== void 0 ? { status: settlement.status } : {}
+    };
+    let drainedProse;
+    if (settlement.kind === "arrival") {
+      session?.appendEntry(SETTLEMENT_ENTRY, settlementFact);
       if (preparationFailure !== void 0) {
         report = unavailable(invocationId, preparationFailure);
       } else {
-        report = { disposition: "no-advice" };
+        report = {
+          disposition: "arrival",
+          ...settlement.message === void 0 ? {} : { arrivalMessage: settlement.message }
+        };
       }
-    } else if (settlement.kind === "arrival") {
-      if (sessionReady !== void 0) {
+    } else {
+      if (session !== void 0) preparationFailure = void 0;
+      let coldMaterials;
+      if (session === void 0 && preparationFailure === void 0) {
         try {
-          await sessionReady;
+          coldMaterials = await loadMaterialsAndSession(invocationId);
         } catch (error) {
-          preparationFailure ??= error;
+          preparationFailure = error;
         }
       }
-      if (preparation !== void 0) {
+      session?.appendEntry(SETTLEMENT_ENTRY, settlementFact);
+      if (preparationFailure === void 0) {
+        prepareBoundSettlement = settlement;
+        preparation = prepare(coldMaterials);
+        void preparation.catch((error) => {
+          preparationFailure = error;
+        });
         try {
-          await preparation;
+          drainedProse = await preparation;
         } catch (error) {
           preparationFailure ??= error;
         }
+        preparation = void 0;
       }
-      report = preparationFailure === void 0 ? { disposition: "arrival", ...settlement.message === void 0 ? {} : { arrivalMessage: settlement.message } } : unavailable(invocationId, preparationFailure);
-    } else if (preparation === void 0) {
-      report = unavailable(invocationId, "Navigator preparation did not start");
-    } else {
-      try {
-        if (sessionReady !== void 0) await sessionReady;
-        let prepared = await preparation;
-        session?.appendEntry(SETTLEMENT_ENTRY, { invocationId, subjectKey, role: settlement.role, phase: settlement.phase, kind: settlement.kind, ...settlement.status === void 0 ? {} : { status: settlement.status } });
-        let selected = selectNavigatorCandidate(prepared, settlement);
-        if (selected?.candidate.next !== void 0 && !selected.matchedToSettlement) {
-          if (disposed) return;
-          prepareBoundSettlement = settlement;
-          prepared = await prepare();
-          if (disposed) return;
-          selected = selectNavigatorCandidate(prepared, settlement);
-        }
-        const selectedCandidate = selected?.candidate;
-        if (selectedCandidate?.next === void 0 && preparationNoReceipt) {
-          report = { disposition: "no-advice" };
-        } else if (selectedCandidate?.next === void 0) {
-          throw new Error("Navigator prepared no machine-usable next direction");
-        } else {
-          const selectedRoute = selectedCandidate.route;
-          const routeChanged = selectedRoute !== void 0 && !routeEqual(previousRoute, selectedRoute);
-          const command = typeof selectedCandidate.command === "string" && selectedCandidate.command.trim() !== "" ? selectedCandidate.command : renderPublicAkRoleCommand(selectedCandidate.next);
-          report = {
-            disposition: "recommendation",
-            ...routeChanged ? { route: selectedRoute } : {},
-            next: selectedCandidate.next,
-            ...selectedCandidate.reason === void 0 ? {} : { reason: selectedCandidate.reason },
-            ...command === void 0 ? {} : { command }
-          };
-          if (selectedRoute !== void 0) {
-            previousRoute = selectedRoute;
-            session?.appendEntry(ROUTE_ENTRY, { invocationId, subjectKey, route: selectedRoute });
-          }
-        }
-      } catch (error) {
-        report = unavailable(invocationId, error);
+      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" };
       }
     }
     await routePlaybookSettlement;
@@ -649,10 +560,7 @@ ${helpContext}
       role: options.role,
       phase: options.phase,
       subjectKey,
-      ...report.route === void 0 ? {} : { route: report.route },
-      ...report.next === void 0 ? {} : { next: report.next },
-      ...report.reason === void 0 ? {} : { reason: report.reason },
-      ...report.command === void 0 ? {} : { command: report.command },
+      ...report.prose === void 0 ? {} : { prose: report.prose },
       ...report.unavailableReason === void 0 ? {} : { unavailableReason: report.unavailableReason },
       ...report.unavailableSource === void 0 ? {} : { unavailableSource: report.unavailableSource },
       ...report.unavailableCause === void 0 ? {} : { unavailableCause: report.unavailableCause },
@@ -668,9 +576,8 @@ ${helpContext}
     }
     preparation = void 0;
     sessionReady = void 0;
-    candidates = void 0;
+    preparedProse = void 0;
     preparationFailure = void 0;
-    preparationNoReceipt = false;
     routePlaybookSettlement = void 0;
     routePlaybookReadFailure = void 0;
   }
@@ -707,8 +614,6 @@ export {
   registerNavigatorModelCommand,
   resolveNavigatorAuthorityMaterial,
   resolveNavigatorSeatSelection,
-  selectNavigatorCandidate,
-  settlementNavigationFromEvent,
   subjectPath,
   writeNavigatorModelSetting
 };