@akagilnc/pi-workflow-roles 0.1.4528 → 0.1.4620

package/dist/public-cli/terminal.js

@@ -1,11 +1,3 @@
-/**
- * Terminal result: typed semantic regions for one admitted Role run (ADR 0052 / #106).
- * Presentation may rearrange labels/order; only regions and typed facts are stable.
- *
- * Free-text cells are JSON-string encoded so legitimate newlines/tabs cannot forge
- * extra rows or shift column boundaries (note / fix.summary / decision question / reason).
- */
-import { isPublicCallableRole, renderPublicAkRoleCommand, } from "./command-renderer.js";
 /** Encode one free-text Terminal cell. JSON string form cannot embed raw tab/newline. */
 export function encodeTerminalField(value) {
     return JSON.stringify(value);
@@ -34,21 +26,13 @@ export function roleResultPayloads(outcome) {
     return [];
 }
 /**
- * Build a recommendation navigator fact. Model command is kept when present;
- * registry render is fallback only. Unknown seats stay recommendations (#836 B4.1).
+ * Build an advice navigator fact (#959). Prose is presented as submitted;
+ * code does not parse route/next or judge usability.
  */
-export function recommendationNavigatorFact(input) {
-    const command = typeof input.modelCommand === "string" && input.modelCommand.trim() !== ""
-        ? input.modelCommand
-        : isPublicCallableRole(input.next.role)
-            ? renderPublicAkRoleCommand(input.next)
-            : undefined;
+export function adviceNavigatorFact(input) {
     return {
-        disposition: "recommendation",
-        next: input.next,
-        reason: input.reason,
-        ...(command === undefined ? {} : { command }),
-        ...(input.route === undefined ? {} : { route: input.route }),
+        disposition: "advice",
+        prose: input.prose,
         ...(input.advisoryDiagnostic === undefined ? {} : { advisoryDiagnostic: input.advisoryDiagnostic }),
     };
 }
@@ -82,12 +66,9 @@ export function formatTerminalResult(result) {
     if (result.navigator.advisoryDiagnostic !== undefined) {
         lines.push(`navigator-advisory\t${encodeTerminalField(result.navigator.advisoryDiagnostic)}`);
     }
-    if (result.navigator.disposition === "recommendation") {
-        lines.push(`next\t${result.navigator.next.role}\t${result.navigator.next.phase ?? "none"}`);
-        lines.push(`reason\t${encodeTerminalField(result.navigator.reason)}`);
-        if (result.navigator.command !== undefined) {
-            lines.push(`command\t${encodeTerminalField(result.navigator.command)}`);
-        }
+    if (result.navigator.disposition === "advice") {
+        // #959: present navigator prose as-is — no next/reason/command parsing.
+        lines.push(`prose\t${encodeTerminalField(result.navigator.prose)}`);
     }
     else if (result.navigator.disposition === "unavailable") {
         lines.push(`unavailable\t${result.navigator.source}\t${encodeTerminalField(result.navigator.reason)}`);
@@ -107,6 +88,15 @@ export function formatTerminalResult(result) {
             lines.push(`gate-round\t${round.roundIndex}\t${round.dispatch.kind}\t${round.dispatch.officer}\t${reason}\t${round.officer.seat}\t${encodeTerminalField(round.officer.status)}\t${encodeTerminalField(JSON.stringify(round.officer.findings))}`);
         }
     }
+    if (result.reviewerChildOutcomes !== undefined) {
+        for (const axis of ["completeness", "correctness"]) {
+            const child = result.reviewerChildOutcomes[axis];
+            lines.push(`reviewer-child\t${axis}\t${child.exitCode}`);
+            if (child.stderr !== undefined && child.stderr !== "") {
+                lines.push(`reviewer-child-diagnostic\t${axis}\t${encodeTerminalField(child.stderr)}`);
+            }
+        }
+    }
     if (result.resume !== undefined) {
         // Resumable failure: run ID is revealed only inside the complete resume command.
         lines.push(`resume\t${encodeTerminalField(result.resume.command)}`);

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

@@ -1,6 +1,6 @@
 import { pickEngineAxis } from "../package-resources/engine-material.js";
 export function projectRoleTurnRequest(admitted, roleDetails, options) {
-    const cwd = admitted.projectRoot ?? admitted.repoRoot ?? admitted.cwd;
+    const cwd = options.cwd ?? admitted.projectRoot ?? admitted.repoRoot ?? admitted.cwd;
     if (cwd === undefined)
         throw new Error("admitted invocation missing working directory");
     if (admitted.principal === undefined)

package/dist/public-role-summons.js

@@ -1,7 +1,12 @@
+import { execFile } from "node:child_process";
 import { existsSync } from "node:fs";
-import { join } from "node:path";
+import { mkdir, mkdtemp, realpath, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, relative, sep } from "node:path";
+import { promisify } from "node:util";
 import { pickEngineAxis } from "./package-resources/engine-material.js";
 const AK_ROLE_PACKAGE_ROOT_ENV = "AK_ROLE_PACKAGE_ROOT";
+const execFileAsync = promisify(execFile);
 function createCapturingIo() {
   const chunks = [];
   return {
@@ -89,13 +94,14 @@ async function createSummonEnv(options, afterHost) {
     import("./public-cli/role-turn-host-resolution.js"),
     import("./public-cli/config.js")
   ]);
-  const principalAuthority = piDurablePrincipalAuthority;
+  const principalAuthority = options.principalAuthority ?? piDurablePrincipalAuthority;
   const roleTurnHost = resolveRoleTurnHost(
     {
       packageRoot: options.packageRoot,
       ...options.roleTurnHost === void 0 ? {} : { roleTurnHost: options.roleTurnHost },
       ...options.hostAdapters === void 0 ? {} : { hostAdapters: options.hostAdapters },
-      ...options.extraPiArgs === void 0 || options.extraPiArgs.length === 0 ? {} : { extraPiArgs: options.extraPiArgs }
+      ...options.extraPiArgs === void 0 || options.extraPiArgs.length === 0 ? {} : { extraPiArgs: options.extraPiArgs },
+      ...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs }
     },
     { role: options.role, seat: options.seat, principalAuthority }
   );
@@ -108,13 +114,16 @@ async function createSummonEnv(options, afterHost) {
     };
   }
   const hostName = seatWithModel.host ?? "pi";
-  const { loadHostProvidersTable, projectHostFacingProvider } = await import("./public-cli/host-providers.js");
-  const hostFacingSelection = projectHostFacingProvider(
-    seatWithModel.selection,
-    hostName,
-    loadHostProvidersTable(options.home),
-    options.home
-  );
+  let hostFacingSelection = options.hostFacingModel;
+  if (hostFacingSelection === void 0) {
+    const { loadHostProvidersTable, projectHostFacingProvider } = await import("./public-cli/host-providers.js");
+    hostFacingSelection = projectHostFacingProvider(
+      seatWithModel.selection,
+      hostName,
+      loadHostProvidersTable(options.home),
+      options.home
+    );
+  }
   return {
     ok: true,
     env: {
@@ -128,7 +137,8 @@ async function createSummonEnv(options, afterHost) {
       credentials: options.credentials,
       ...hostFacingSelection === void 0 ? {} : { model: hostFacingSelection },
       ...projectSeatEngine(seatWithModel),
-      ...projectSeatHost(seatWithModel)
+      ...projectSeatHost(seatWithModel),
+      ...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs }
     }
   };
 }
@@ -143,7 +153,19 @@ async function summonPublicRole(options) {
   } = await import("./public-cli/config.js");
   const credentials = options.credentials ?? await loadCredentialProviders(agentDir);
   const config = await loadPublicCliConfig(home);
-  const seat = resolveEffectiveSeat(config, options.role, credentials);
+  const resolvedSeat = resolveEffectiveSeat(config, options.role, credentials);
+  const inheritedSelection = options.model === void 0 ? void 0 : {
+    provider: options.model.provider,
+    model: options.model.model,
+    ...options.model.thinking === void 0 ? {} : { thinking: options.model.thinking }
+  };
+  const seat = {
+    ...resolvedSeat,
+    ...inheritedSelection === void 0 ? {} : { selection: inheritedSelection, source: "invocation" },
+    ...options.host === void 0 ? {} : { host: options.host, hostSource: "invocation" },
+    ...options.engine === void 0 ? {} : { engine: options.engine, engineSource: "invocation" },
+    ...options.engineModel === void 0 ? {} : { engineModel: options.engineModel }
+  };
   const captured = options.io === void 0 ? createCapturingIo() : void 0;
   const io = options.io ?? captured.io;
   const summonEnvInput = {
@@ -156,7 +178,11 @@ async function summonPublicRole(options) {
     seat,
     ...options.extraPiArgs === void 0 ? {} : { extraPiArgs: options.extraPiArgs },
     ...options.roleTurnHost === void 0 ? {} : { roleTurnHost: options.roleTurnHost },
-    ...options.hostAdapters === void 0 ? {} : { hostAdapters: options.hostAdapters }
+    ...options.hostAdapters === void 0 ? {} : { hostAdapters: options.hostAdapters },
+    ...options.principalAuthority === void 0 ? {} : { principalAuthority: options.principalAuthority },
+    ...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs },
+    // Parent model is already host-facing; child must not project again.
+    ...options.model === void 0 ? {} : { hostFacingModel: options.model }
   };
   async function prepareSummonEnv(afterHost) {
     try {
@@ -168,7 +194,9 @@ async function summonPublicRole(options) {
         ok: true,
         env: {
           ...built.env,
-          stationChild: true,
+          // Nested court stations keep station-child semantics; dual-lens
+          // ordinary Reviewer axes opt out (#946 / ADR 0082).
+          ...options.stationChild === false ? {} : { stationChild: true },
           // Forward composition-root adapters so nested court stations (e.g.
           // countersign → diarist) select the same faux/production table (#924).
           ...options.hostAdapters === void 0 ? {} : { hostAdapters: options.hostAdapters },
@@ -178,7 +206,8 @@ async function summonPublicRole(options) {
           ...options.gateReviewInstruction === void 0 ? {} : { gateReviewInstruction: options.gateReviewInstruction },
           ...options.boundTicketNumber === void 0 ? {} : { boundTicketNumber: options.boundTicketNumber },
           ...options.correlationId === void 0 || options.correlationId.trim() === "" ? {} : { correlationId: options.correlationId },
-          ...options.createRunId === void 0 ? {} : { createRunId: options.createRunId }
+          ...options.createRunId === void 0 ? {} : { createRunId: options.createRunId },
+          ...options.executionCwd === void 0 ? {} : { executionCwd: options.executionCwd }
         }
       };
     } catch (error) {
@@ -240,14 +269,32 @@ async function summonPublicRole(options) {
     case "navigator":
     case "gatekeeper": {
       const seat2 = options.role;
-      const [{ runPublicInstructionSeat }, invocation] = await Promise.all([
+      const [{ runPublicInstructionSeat, runPublicInstructionSeatResume }, invocation] = await Promise.all([
         import("./public-cli/instruction-seat-run.js"),
         import("./public-cli/invocation.js")
       ]);
       const parse = seat2 === "auditor" ? invocation.parseAuditorArgv : seat2 === "navigator" ? invocation.parseNavigatorArgv : invocation.parseGatekeeperArgv;
-      const stepped = await runPrepared(parse, (env, once) => runPublicInstructionSeat(options.argv, env, io, seat2, once));
-      if ("fail" in stepped) return stepped.fail;
-      result = stepped.ok;
+      const resumeRunId = typeof options.resumeRunId === "string" && options.resumeRunId.trim() !== "" ? options.resumeRunId.trim() : void 0;
+      if (resumeRunId !== void 0) {
+        const instruction = options.argv[0] ?? "";
+        const stepped = await runPrepared(parse, (env) => runPublicInstructionSeatResume(
+          {
+            runId: resumeRunId,
+            summons: {
+              instruction,
+              instructionEmpty: instruction.trim() === ""
+            }
+          },
+          env,
+          io
+        ));
+        if ("fail" in stepped) return stepped.fail;
+        result = stepped.ok;
+      } else {
+        const stepped = await runPrepared(parse, (env, once) => runPublicInstructionSeat(options.argv, env, io, seat2, once));
+        if ("fail" in stepped) return stepped.fail;
+        result = stepped.ok;
+      }
       break;
     }
     case "judge": {
@@ -290,6 +337,16 @@ async function summonPublicRole(options) {
       result = stepped.ok;
       break;
     }
+    case "reviewer": {
+      const [{ runPublicReviewer }, { parseReviewerArgv }] = await Promise.all([
+        import("./public-cli/reviewer-run.js"),
+        import("./public-cli/invocation.js")
+      ]);
+      const stepped = await runPrepared(parseReviewerArgv, (env, once) => runPublicReviewer(options.argv, env, io, once));
+      if ("fail" in stepped) return stepped.fail;
+      result = stepped.ok;
+      break;
+    }
   }
   const stderr = captured?.stderrText();
   const runDirectory = result.admitted?.runDirectory;
@@ -301,6 +358,296 @@ async function summonPublicRole(options) {
     ...stderr === void 0 || stderr === "" ? {} : { stderr }
   };
 }
+function withReviewerLens(argv, lens) {
+  const separator = argv.indexOf("--");
+  if (separator === -1) return [...argv, "--lens", lens];
+  return [...argv.slice(0, separator), "--lens", lens, ...argv.slice(separator)];
+}
+async function resolveReviewerWorktreeRoots(projectRoot) {
+  const callerProjectRoot = await realpath(projectRoot);
+  const sourceProjectRoot = await realpath((await execFileAsync(
+    "git",
+    ["rev-parse", "--show-toplevel"],
+    { cwd: callerProjectRoot }
+  )).stdout.trim());
+  const callerRelative = relative(sourceProjectRoot, callerProjectRoot);
+  const projectRelative = callerRelative === "" || callerRelative === "." || callerRelative.startsWith(`..${sep}`) || callerRelative === ".." ? "" : callerRelative;
+  return { callerProjectRoot, sourceProjectRoot, projectRelative };
+}
+function reviewerSandboxPath(worktreeAxis, projectRelative) {
+  return projectRelative === "" ? worktreeAxis : join(worktreeAxis, projectRelative);
+}
+async function openEphemeralReviewerWorktree(options) {
+  const { sourceProjectRoot, projectRelative } = await resolveReviewerWorktreeRoots(
+    options.projectRoot
+  );
+  const { stdout: headStdout } = await execFileAsync(
+    "git",
+    ["rev-parse", "--verify", "HEAD^{commit}"],
+    { cwd: sourceProjectRoot }
+  );
+  const targetCommit = headStdout.trim();
+  const root = await mkdtemp(join(tmpdir(), "ak-reviewer-sandbox-"));
+  const worktreeRoot = join(root, "work");
+  let registered = false;
+  const rollback = async (cause) => {
+    const cleanupErrors = [];
+    if (registered) {
+      try {
+        await execFileAsync("git", ["worktree", "remove", "--force", worktreeRoot], {
+          cwd: sourceProjectRoot
+        });
+      } catch (error) {
+        cleanupErrors.push(error);
+      }
+    }
+    try {
+      await rm(root, { recursive: true, force: true });
+    } catch (error) {
+      cleanupErrors.push(error);
+    }
+    if (cleanupErrors.length > 0) {
+      options.onCleanupDiagnostic?.([
+        "reviewer worktree cleanup failed",
+        ...cleanupErrors.map((error) => error instanceof Error ? error.message : String(error))
+      ].join("\n"));
+    }
+    throw cause;
+  };
+  try {
+    await execFileAsync("git", ["worktree", "add", "--detach", worktreeRoot, targetCommit], {
+      cwd: sourceProjectRoot
+    });
+    registered = true;
+    if (projectRelative !== "") {
+      await mkdir(reviewerSandboxPath(worktreeRoot, projectRelative), { recursive: true });
+    }
+  } catch (error) {
+    await rollback(error);
+  }
+  let closed = false;
+  return {
+    executionCwd: reviewerSandboxPath(worktreeRoot, projectRelative),
+    close: async () => {
+      if (closed) return;
+      closed = true;
+      const cleanupErrors = [];
+      try {
+        await execFileAsync("git", ["worktree", "remove", worktreeRoot], {
+          cwd: sourceProjectRoot
+        });
+      } catch (error) {
+        cleanupErrors.push(error);
+      }
+      try {
+        await rm(root, { recursive: true, force: true });
+      } catch (error) {
+        cleanupErrors.push(error);
+      }
+      if (cleanupErrors.length > 0) {
+        options.onCleanupDiagnostic?.([
+          "reviewer worktree cleanup failed",
+          ...cleanupErrors.map((error) => error instanceof Error ? error.message : String(error))
+        ].join("\n"));
+      }
+    }
+  };
+}
+async function withEphemeralReviewerWorktree(options) {
+  const sandbox = await openEphemeralReviewerWorktree({
+    projectRoot: options.projectRoot,
+    ...options.onCleanupDiagnostic === void 0 ? {} : { onCleanupDiagnostic: options.onCleanupDiagnostic }
+  });
+  try {
+    return await options.run(sandbox.executionCwd);
+  } finally {
+    await sandbox.close();
+  }
+}
+async function summonParallelReviewerLenses(options) {
+  const describeFailure = (error) => {
+    if (error instanceof AggregateError) {
+      return [error.message, ...error.errors.map(describeFailure)].join("\n");
+    }
+    return error instanceof Error ? error.message : String(error);
+  };
+  const failedResult = (error) => ({
+    exitCode: 1,
+    stderr: describeFailure(error)
+  });
+  const dualFailure = (error) => {
+    const failure = failedResult(error);
+    return { completeness: failure, correctness: failure };
+  };
+  let sourceProjectRoot;
+  let projectRelative;
+  let targetCommit;
+  const statusArgs = [
+    "status",
+    "--porcelain=v1",
+    "--untracked-files=all",
+    "--",
+    ":/",
+    ":(top,exclude).claude/worktrees/**"
+  ];
+  try {
+    const roots = await resolveReviewerWorktreeRoots(options.projectRoot);
+    sourceProjectRoot = roots.sourceProjectRoot;
+    projectRelative = roots.projectRelative;
+    const { stdout: statusStdout } = await execFileAsync("git", statusArgs, {
+      cwd: sourceProjectRoot
+    });
+    if (statusStdout !== "") {
+      const diagnostic = [
+        "Reviewer target status gate failed:",
+        "git status --porcelain=v1 --untracked-files=all -- :/ ':(top,exclude).claude/worktrees/**'",
+        statusStdout
+      ].join("\n");
+      return dualFailure(new Error(diagnostic));
+    }
+    const { stdout: targetStdout } = await execFileAsync(
+      "git",
+      ["rev-parse", "--verify", "HEAD^{commit}"],
+      { cwd: sourceProjectRoot }
+    );
+    targetCommit = targetStdout.trim();
+    await execFileAsync(
+      "git",
+      ["rev-parse", "--verify", `${options.baseRevision}^{commit}`],
+      { cwd: sourceProjectRoot }
+    );
+  } catch (error) {
+    return dualFailure(error);
+  }
+  const root = await mkdtemp(join(tmpdir(), "ak-reviewer-lenses-"));
+  const completenessRoot = join(root, "completeness");
+  const correctnessRoot = join(root, "correctness");
+  const worktrees = [completenessRoot, correctnessRoot];
+  const created = /* @__PURE__ */ new Set();
+  let results;
+  const creation = await Promise.allSettled(
+    worktrees.map(async (path) => {
+      await execFileAsync("git", ["worktree", "add", "--detach", path, targetCommit], {
+        cwd: sourceProjectRoot
+      });
+      created.add(path);
+      if (projectRelative !== "") {
+        await mkdir(reviewerSandboxPath(path, projectRelative), { recursive: true });
+      }
+    })
+  );
+  const creationFailures = creation.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+  if (creationFailures.length > 0) {
+    const failure = failedResult(new AggregateError(
+      creationFailures,
+      "parallel reviewer worktree creation failed"
+    ));
+    results = { completeness: failure, correctness: failure };
+  } else {
+    const summon = (lens, worktreeAxis) => {
+      const sandbox = reviewerSandboxPath(worktreeAxis, projectRelative);
+      return summonPublicRole({
+        role: "reviewer",
+        argv: withReviewerLens(options.argv, lens),
+        cwd: options.cwd,
+        executionCwd: sandbox,
+        // Ordinary single-axis public semantics — not a nested court station.
+        stationChild: false,
+        home: options.home,
+        ...options.agentDir === void 0 ? {} : { agentDir: options.agentDir },
+        ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+        ...options.model === void 0 ? {} : { model: options.model },
+        ...options.host === void 0 ? {} : { host: options.host },
+        ...options.engine === void 0 ? {} : { engine: options.engine },
+        ...options.engineModel === void 0 ? {} : { engineModel: options.engineModel },
+        ...options.signal === void 0 ? {} : { signal: options.signal },
+        ...options.correlationId === void 0 ? {} : { correlationId: options.correlationId },
+        ...options.packageRoot === void 0 ? {} : { packageRoot: options.packageRoot },
+        ...options.roleTurnHost === void 0 ? {} : { roleTurnHost: options.roleTurnHost },
+        ...options.hostAdapters === void 0 ? {} : { hostAdapters: options.hostAdapters },
+        ...options.principalAuthority === void 0 ? {} : { principalAuthority: options.principalAuthority },
+        ...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs }
+      });
+    };
+    const settled = await Promise.allSettled([
+      summon("completeness", completenessRoot),
+      summon("correctness", correctnessRoot)
+    ]);
+    results = {
+      completeness: settled[0].status === "fulfilled" ? settled[0].value : failedResult(settled[0].reason),
+      correctness: settled[1].status === "fulfilled" ? settled[1].value : failedResult(settled[1].reason)
+    };
+  }
+  let sealDiagnostic;
+  try {
+    const { stdout: headBeforeStdout } = await execFileAsync(
+      "git",
+      ["rev-parse", "--verify", "HEAD^{commit}"],
+      { cwd: sourceProjectRoot }
+    );
+    const { stdout: sealedStatusStdout } = await execFileAsync("git", statusArgs, {
+      cwd: sourceProjectRoot
+    });
+    const { stdout: headAfterStdout } = await execFileAsync(
+      "git",
+      ["rev-parse", "--verify", "HEAD^{commit}"],
+      { cwd: sourceProjectRoot }
+    );
+    const headBefore = headBeforeStdout.trim();
+    const headAfter = headAfterStdout.trim();
+    if (headBefore !== targetCommit || headAfter !== targetCommit || sealedStatusStdout !== "") {
+      sealDiagnostic = [
+        "Reviewer target final seal failed:",
+        `HEAD before status => ${headBefore}`,
+        `HEAD after status => ${headAfter}`,
+        `expected PRE_HEAD ${targetCommit}`,
+        "git status --porcelain=v1 --untracked-files=all -- :/ ':(top,exclude).claude/worktrees/**'",
+        sealedStatusStdout
+      ].join("\n");
+    }
+  } catch (error) {
+    sealDiagnostic = `Reviewer target final seal failed:
+${describeFailure(error)}`;
+  }
+  if (sealDiagnostic !== void 0) {
+    const withSealFailure = (result) => ({
+      ...result,
+      exitCode: 1,
+      stderr: [result.stderr, sealDiagnostic].filter(
+        (text) => typeof text === "string" && text !== ""
+      ).join("\n")
+    });
+    results = {
+      completeness: withSealFailure(results.completeness),
+      correctness: withSealFailure(results.correctness)
+    };
+  }
+  const cleanup = await Promise.allSettled(
+    [...created].map((path) => execFileAsync("git", ["worktree", "remove", path], { cwd: sourceProjectRoot }))
+  );
+  const cleanupFailures = cleanup.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+  if (cleanupFailures.length === 0) {
+    const rootCleanup = await Promise.allSettled([rm(root, { recursive: true, force: true })]);
+    cleanupFailures.push(...rootCleanup.flatMap((result) => result.status === "rejected" ? [result.reason] : []));
+  }
+  if (cleanupFailures.length > 0) {
+    const diagnostic = [
+      "parallel reviewer worktree cleanup failed",
+      ...cleanupFailures.map((failure) => failure instanceof Error ? failure.message : String(failure))
+    ].join("\n");
+    const withCleanupDiagnostic = (result) => ({
+      ...result,
+      stderr: [result.stderr, diagnostic].filter(
+        (text) => typeof text === "string" && text !== ""
+      ).join("\n")
+    });
+    results = {
+      completeness: withCleanupDiagnostic(results.completeness),
+      correctness: withCleanupDiagnostic(results.correctness)
+    };
+  }
+  return results;
+}
 async function summonGateOfficer(options) {
   let home = options.home;
   if (home === void 0) {
@@ -352,7 +699,10 @@ async function summonGateOfficer(options) {
 }
 export {
   AK_ROLE_PACKAGE_ROOT_ENV,
+  openEphemeralReviewerWorktree,
   resolveSummonsPackageRoot,
   summonGateOfficer,
-  summonPublicRole
+  summonParallelReviewerLenses,
+  summonPublicRole,
+  withEphemeralReviewerWorktree
 };

package/dist/submission-ledger.js

@@ -338,6 +338,59 @@ async function restoreState(cwd, runId, scope) {
         }, 0),
     };
 }
+/** Sole HostContext-derived session parent for ledger restore/append (never process.env). */
+function sessionParentFromHostContext(context) {
+    const runDirectory = runDirectoryFromHostContext(context);
+    if (runDirectory !== undefined)
+        return join(runDirectory, "session", "session.jsonl");
+    const sessionFile = context.sessionManager.getSessionFile?.();
+    if (typeof sessionFile === "string" && sessionFile.length > 0)
+        return sessionFile;
+    const sessionDir = context.sessionManager.getSessionDir?.();
+    if (typeof sessionDir === "string" && sessionDir.length > 0) {
+        return join(sessionDir, "session.jsonl");
+    }
+    return undefined;
+}
+function homeFromHostContext(context, home) {
+    if (home !== undefined)
+        return home;
+    const sessionParent = sessionParentFromHostContext(context);
+    return sessionParent !== undefined ? tryHomeFromAkRolesPath(sessionParent) : undefined;
+}
+/**
+ * #959: seal one accepted submission without a model tool call.
+ * Same ledger row shape and priorEventId chain as the terminating-tool wrap.
+ * Used when a prose-exit seat (navigator) harvests the final assistant text.
+ */
+export async function sealAcceptedSubmission(options) {
+    const runId = runIdentity(options.context);
+    const attemptId = attemptIdentity(options.context, runId);
+    const sessionParent = sessionParentFromHostContext(options.context);
+    const home = homeFromHostContext(options.context, options.home);
+    const state = await restoreState(options.context.cwd, runId, {
+        ...(home === undefined ? {} : { home }),
+        ...(sessionParent === undefined ? {} : { sessionParent }),
+    });
+    const pointer = sitianReport({
+        level: "event",
+        kind: "sealed",
+        subject: { runId, attemptId },
+        ...(state.prior === undefined ? {} : { priorEventId: state.prior.identity }),
+        payload: {
+            type: "sealed",
+            attemptId,
+            toolCallId: options.toolCallId,
+            role: options.role,
+            accepted: options.accepted,
+        },
+        source: "role-runtime",
+        cwd: options.context.cwd,
+        ...(home !== undefined ? { home } : {}),
+        ...(sessionParent === undefined ? {} : { sessionParent }),
+    });
+    state.prior = pointer;
+}
 /**
  * Submission ledger host — record only (#836).
  * Each terminating submission is appended with the role's original payload.
@@ -346,30 +399,10 @@ async function restoreState(cwd, runId, scope) {
  */
 export function createSubmissionLedgerHost(host, outputTools, failInfrastructure = (error) => { throw error; }, projectClosure = () => undefined, options) {
     const states = new Map();
-    /** Sole HostContext-derived run coordinate for restore and append (never process.env). */
-    const sessionParentFromContext = (context) => {
-        const runDirectory = runDirectoryFromHostContext(context);
-        if (runDirectory !== undefined) {
-            return join(runDirectory, "session", "session.jsonl");
-        }
-        const sessionFile = context.sessionManager.getSessionFile?.();
-        if (typeof sessionFile === "string" && sessionFile.length > 0)
-            return sessionFile;
-        const sessionDir = context.sessionManager.getSessionDir?.();
-        if (typeof sessionDir === "string" && sessionDir.length > 0) {
-            return join(sessionDir, "session.jsonl");
-        }
-        return undefined;
-    };
-    const resolveHomeFromContext = (context) => {
-        if (options?.home !== undefined)
-            return options.home;
-        const sessionParent = sessionParentFromContext(context);
-        return sessionParent !== undefined ? tryHomeFromAkRolesPath(sessionParent) : undefined;
-    };
+    const resolveHomeFromContext = (context) => homeFromHostContext(context, options?.home);
     const stateFor = (context, runId) => states.get(runId) ?? (() => {
         const home = resolveHomeFromContext(context);
-        const sessionParent = sessionParentFromContext(context);
+        const sessionParent = sessionParentFromHostContext(context);
         const pending = restoreState(context.cwd, runId, {
             ...(home === undefined ? {} : { home }),
             ...(sessionParent === undefined ? {} : { sessionParent }),
@@ -379,7 +412,7 @@ export function createSubmissionLedgerHost(host, outputTools, failInfrastructure
     })();
     const appendFor = (state, context, runId, attemptId, event) => {
         const home = resolveHomeFromContext(context);
-        const sessionParent = sessionParentFromContext(context);
+        const sessionParent = sessionParentFromHostContext(context);
         const pointer = sitianReport({
             level: "event",
             kind: event.type,

package/package.json

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

package/resources/836-deleted-machine-instruction-inventory.md

@@ -14,5 +14,7 @@
 | `run-lifecycle.ts` A4.2 | `重新读 <path>` | 前轮已删改写。 |
 | `submission-correctable-error.ts` A4.5 | `终局交卷并非本轮唯一工具调用。` | 删。Pi/ACP `deliverSubmissionRejection` 不再注入该句。 |
 | `role-runtime.ts` 催交 | `本会话尚无已接受的 typed 回执。` | **留**（轮次/预算，Q2）。 |
+| `navigator-attendance.ts` early prepare 开场 | `父衙门进行中。请在本宿主会话熟悉下列材料并待命；结算结果送达后，再给出下一步建议。本轮不要提交最终路线建议。` | #959 迁入 `resources/navigator-route-playbook.md`「到场阶段」；代码只留中立指针句「本轮为待命轮。」 |
+| `navigator-attendance.ts` settlement feed 开场 | `父衙门结算已送达。请根据下列材料给出下一步建议。` | #959 迁入同手册；代码只留中立指针句「本轮为结算投喂轮。」 |
 
 催交句与 2.1–2.3 打回文、重问三句不在删除列。