@akagilnc/pi-workflow-roles 0.1.3623 → 0.1.3629

package/dist/public-cli/main.js

@@ -16128,7 +16128,7 @@ async function spawnEngineDetourOnce(input) {
   }
   const command = input.argv[0];
   const args = input.argv.slice(1);
-  return await new Promise((resolve12, reject) => {
+  return await new Promise((resolve13, reject) => {
     let settled = false;
     const signal = input.signal;
     const child = spawn(command, args, {
@@ -16158,7 +16158,7 @@ async function spawnEngineDetourOnce(input) {
       if (signal !== void 0) {
         signal.removeEventListener("abort", onAbort);
       }
-      resolve12(result2);
+      resolve13(result2);
     };
     const onAbort = () => {
       fail4(signal !== void 0 ? abortReasonError(signal) : new Error("aborted"));
@@ -17503,10 +17503,35 @@ var init_typed_provider_http = __esm({
 
 // src/public-cli/run-lifecycle.ts
 import { chmod, open, readdir as readdir2, readFile as readFile8, unlink as unlink2, writeFile as writeFile4 } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { isAbsolute as isAbsolute4, join as join12 } from "node:path";
+function resumeRereadInstruction(materialPath, handbook) {
+  return handbook ? `\u91CD\u65B0\u8BFB ${materialPath}\uFF0C\u518D\u7EC4\u88C5\u5916\u5305 argv` : `\u91CD\u65B0\u8BFB ${materialPath}`;
+}
+function instructResumeHandbookRead(prompt, engineMaterial) {
+  const handbookPath = engineMaterial?.materialPath;
+  return prompt.split("\n").map((line2) => {
+    if (!line2.startsWith("- ")) return line2;
+    const value = line2.slice(2);
+    if (handbookPath !== void 0 && value === handbookPath) {
+      return resumeRereadInstruction(handbookPath, true);
+    }
+    if (isAbsolute4(value)) return resumeRereadInstruction(value, false);
+    return line2;
+  }).join("\n");
+}
+function appendResumeMaterialReread(prompt, materialPath) {
+  const instruction = resumeRereadInstruction(materialPath, false);
+  const lines = prompt.split("\n");
+  if (lines.includes(instruction)) return prompt;
+  return prompt.length === 0 ? instruction : `${prompt}
+${instruction}`;
+}
 function selectResumeContinuationPrompt(message, engineMaterial) {
   const base = message !== void 0 ? message : RESUME_TRANSPORT_ENVELOPE;
-  return appendEngineSessionMaterial([base], engineMaterial).join("\n");
+  return instructResumeHandbookRead(
+    appendEngineSessionMaterial([base], engineMaterial).join("\n"),
+    engineMaterial
+  );
 }
 function buildResumeContinuationPrompt(options) {
   return selectResumeContinuationPrompt(
@@ -18587,7 +18612,7 @@ __export(notary_source_run_exports, {
   loadNotarySourceRunLocator: () => loadNotarySourceRunLocator,
   resolveNotarySourceRunLocator: () => resolveNotarySourceRunLocator
 });
-import { dirname as dirname7, isAbsolute as isAbsolute4, join as join13, resolve as resolve6, basename as basename4 } from "node:path";
+import { dirname as dirname7, isAbsolute as isAbsolute5, join as join13, resolve as resolve6, basename as basename4 } from "node:path";
 import { lstat as lstat2, realpath as realpath3 } from "node:fs/promises";
 function parseRunDirectoryName(name) {
   const match = RUN_DIR_NAME.exec(name);
@@ -18639,7 +18664,7 @@ async function resolveNotarySourceRunLocator(options) {
   if (bare !== void 0 && !raw.includes("/") && !raw.includes("\\")) {
     candidate = join13(bookRunsRoot, `${bare.runId}@${bare.role}`);
   } else {
-    candidate = isAbsolute4(raw) ? raw : resolve6(options.projectRoot, raw);
+    candidate = isAbsolute5(raw) ? raw : resolve6(options.projectRoot, raw);
   }
   const real = await requireRunDirectory(candidate, raw);
   const identity = parseRunDirectoryName(basename4(real));
@@ -19774,7 +19799,7 @@ import {
   realpath as realpath4,
   writeFile as writeFile5
 } from "node:fs/promises";
-import { basename as basename5, isAbsolute as isAbsolute5, join as join14, resolve as resolve7, sep as sep3 } from "node:path";
+import { basename as basename5, isAbsolute as isAbsolute6, join as join14, resolve as resolve7, sep as sep3 } from "node:path";
 function issueAdmissionPlacement(authority, request) {
   const principal = authority.issue(request);
   const { sessionDirectory, sessionFile } = authority.decode(principal);
@@ -20161,7 +20186,7 @@ function parseFixerArgv(args) {
   };
 }
 async function freezeRegularFileAttachment(sourcePath, destinationDir, index) {
-  const absolute = isAbsolute5(sourcePath) ? sourcePath : resolve7(sourcePath);
+  const absolute = isAbsolute6(sourcePath) ? sourcePath : resolve7(sourcePath);
   let st;
   try {
     st = await lstat3(absolute);
@@ -20491,7 +20516,7 @@ async function admitFixerInvocation(options) {
   let prerequisites = Object.freeze([]);
   let prerequisitesSource;
   if (options.prerequisitesPath !== void 0) {
-    const absolutePrereq = isAbsolute5(options.prerequisitesPath) ? options.prerequisitesPath : resolve7(options.prerequisitesPath);
+    const absolutePrereq = isAbsolute6(options.prerequisitesPath) ? options.prerequisitesPath : resolve7(options.prerequisitesPath);
     try {
       prerequisitesSource = await readFile9(absolutePrereq, "utf8");
     } catch (error) {
@@ -20916,7 +20941,7 @@ async function resolveDoctorCaseRunsPath(options) {
   if (raw === "") {
     throw new CliUsageError("doctor --runs requires a path");
   }
-  if (isAbsolute5(raw)) {
+  if (isAbsolute6(raw)) {
     throw new CliUsageError(
       "doctor --runs must be a project-relative path"
     );
@@ -22257,7 +22282,7 @@ function normalizeReviewComment(raw) {
 function createGhApiRunner(options = {}) {
   const spawnImpl = options.spawnImpl ?? spawn3;
   return async (args, runOptions = {}) => {
-    return await new Promise((resolve12, reject) => {
+    return await new Promise((resolve13, reject) => {
       const signal = runOptions.signal;
       if (signal?.aborted) {
         reject(signal.reason ?? new Error("aborted"));
@@ -22330,11 +22355,11 @@ function createGhApiRunner(options = {}) {
               const value = line2.slice(idx + 1).trim();
               headers[name] = value;
             }
-            resolve12({ status, headers, bodyText });
+            resolve13({ status, headers, bodyText });
             return;
           }
           if (code === 0) {
-            resolve12({ status: 200, headers: {}, bodyText: stdout });
+            resolve13({ status: 200, headers: {}, bodyText: stdout });
             return;
           }
           const failure = new Error(
@@ -23778,10 +23803,16 @@ var init_seat_ticket_binding = __esm({
 });
 
 // src/auditor-dossier-tool.ts
+import { dirname as dirname8, join as join19, resolve as resolve9 } from "node:path";
+function gateSubmissionCandidatePath(runDirectory) {
+  return join19(runDirectory, "artifacts", GATE_SUBMISSION_CANDIDATE_FILE);
+}
+var GATE_SUBMISSION_CANDIDATE_FILE;
 var init_auditor_dossier_tool = __esm({
   "src/auditor-dossier-tool.ts"() {
     "use strict";
     init_build();
+    GATE_SUBMISSION_CANDIDATE_FILE = "gate-submission-candidate.json";
   }
 });
 
@@ -23998,7 +24029,7 @@ var init_ledger_session_read = __esm({
 
 // src/analyst-gate-cycles-read.ts
 import { readdir as readdir3 } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { join as join20 } from "node:path";
 function isRecord15(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -24259,7 +24290,7 @@ async function readAnalystGateCyclesFromAuditorRoles(auditorRolesDirectory, opti
       throw error;
     }
     for (const name of names) {
-      const path = join19(directory, name);
+      const path = join20(directory, name);
       const sessionPath = name.endsWith(".pointer.json") ? await resolveOfficerSessionFromPointerFile(path) : path;
       if (sessionPath === void 0) continue;
       const classified = await classifyAuditorVolume(sessionPath);
@@ -24312,7 +24343,7 @@ var init_gatekeeper_role = __esm({
 
 // src/run-terminal-artifacts.ts
 import { readdir as readdir4, readFile as readFile12 } from "node:fs/promises";
-import { basename as basename7, dirname as dirname8, join as join20 } from "node:path";
+import { basename as basename7, dirname as dirname9, join as join21 } from "node:path";
 function isMissingPathError2(error) {
   return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
 }
@@ -24387,7 +24418,7 @@ async function listUniqueErrorFallbackPaths(directories) {
     }
     for (const name of names.sort((a, b) => a.localeCompare(b))) {
       if (!UNIQUE_ERROR_FALLBACK_NAME.test(name)) continue;
-      found.push(join20(dir, name));
+      found.push(join21(dir, name));
     }
   }
   return found;
@@ -24403,14 +24434,14 @@ function presentUniqueFallbackBoundToRun(body, expectedRunId) {
   return typeof body.runId === "string" && body.runId === expectedRunId;
 }
 async function readRunTerminalArtifact(runDirectory) {
-  const artifactsDir = join20(runDirectory, "artifacts");
+  const artifactsDir = join21(runDirectory, "artifacts");
   for (const file of RUN_TERMINAL_ARTIFACT_FILES) {
-    const path = join20(artifactsDir, file);
+    const path = join21(artifactsDir, file);
     const read3 = await readTerminalArtifactAtPath(path, file);
     if (read3 !== void 0) return read3;
   }
   for (const relative3 of RUN_TERMINAL_ERROR_FALLBACK_RELATIVE_PATHS) {
-    const path = join20(runDirectory, relative3);
+    const path = join21(runDirectory, relative3);
     const read3 = await readTerminalArtifactAtPath(path, "error.json");
     if (read3 !== void 0) return read3;
   }
@@ -24419,7 +24450,7 @@ async function readRunTerminalArtifact(runDirectory) {
     if (read3 !== void 0) return read3;
   }
   const expectedRunId = runIdFromRunDirectory(runDirectory);
-  for (const path of await listUniqueErrorFallbackPaths([dirname8(runDirectory)])) {
+  for (const path of await listUniqueErrorFallbackPaths([dirname9(runDirectory)])) {
     const read3 = await readTerminalArtifactAtPath(path, "error.json");
     if (read3 === void 0) continue;
     if (read3.status === "present") {
@@ -24551,15 +24582,15 @@ var init_submission_ledger = __esm({
 // src/session-opening-materials.ts
 import { existsSync as existsSync9 } from "node:fs";
 import { readFile as readFile13 } from "node:fs/promises";
-import { dirname as dirname9, join as join21 } from "node:path";
+import { dirname as dirname10, join as join22 } from "node:path";
 import { fileURLToPath as fileURLToPath2, pathToFileURL as pathToFileURL2 } from "node:url";
 function resolvePackageRootDir(moduleUrl = import.meta.url) {
-  let dir = dirname9(fileURLToPath2(moduleUrl));
+  let dir = dirname10(fileURLToPath2(moduleUrl));
   for (let i = 0; i < 8; i += 1) {
-    if (existsSync9(join21(dir, "package.json")) && existsSync9(join21(dir, "souls"))) {
+    if (existsSync9(join22(dir, "package.json")) && existsSync9(join22(dir, "souls"))) {
       return dir;
     }
-    const parent = dirname9(dir);
+    const parent = dirname10(dir);
     if (parent === dir) break;
     dir = parent;
   }
@@ -24805,12 +24836,12 @@ var init_reviewer_dispatch = __esm({
 
 // src/public-cli/reviewer-dispatch-rejection.ts
 import { readFile as readFile14, unlink as unlink3 } from "node:fs/promises";
-import { join as join22 } from "node:path";
+import { join as join23 } from "node:path";
 function isReviewerPreflightViolation(value) {
   return typeof value === "string" && REVIEWER_PREFLIGHT_VIOLATIONS.includes(value);
 }
 function reviewerDispatchRejectionPath(runDirectory) {
-  return join22(runDirectory, REVIEWER_DISPATCH_REJECTION_FILE);
+  return join23(runDirectory, REVIEWER_DISPATCH_REJECTION_FILE);
 }
 async function clearReviewerDispatchRejection(runDirectory) {
   try {
@@ -25222,7 +25253,7 @@ var init_terminal = __esm({
 // src/public-cli/settlement.ts
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { appendFile as appendFile2, readFile as readFile15, readdir as readdir5, writeFile as writeFile6 } from "node:fs/promises";
-import { dirname as dirname10, join as join23 } from "node:path";
+import { dirname as dirname11, join as join24 } from "node:path";
 function sealedLedgerHome(admitted) {
   return homeFromRunDirectory(admitted.runDirectory);
 }
@@ -25597,7 +25628,7 @@ async function readSitianRetainedAuditorProviderStop(sessionFile) {
       kind: "auditor",
       sessionParent: sessionFile,
       // Path is driven by sessionParent when under ledger home; cwd is a fallback only.
-      cwd: dirname10(sessionFile)
+      cwd: dirname11(sessionFile)
     });
     const { records: records2 } = await readSitianRecords(recordFile);
     for (let i = records2.length - 1; i >= 0; i -= 1) {
@@ -25623,7 +25654,7 @@ async function readSessionProviderStop(sessionFile) {
   }
 }
 async function readBoundEvidenceChildKnownFailure(sessionFile) {
-  const childDirectory = join23(dirname10(sessionFile), "evidence-children");
+  const childDirectory = join24(dirname11(sessionFile), "evidence-children");
   let names;
   try {
     names = await readdir5(childDirectory);
@@ -25634,7 +25665,7 @@ async function readBoundEvidenceChildKnownFailure(sessionFile) {
   for (const file of names.filter((name) => name.endsWith(".jsonl")).sort().reverse()) {
     let entries;
     try {
-      entries = await readBoundSessionEntries(join23(childDirectory, file));
+      entries = await readBoundSessionEntries(join24(childDirectory, file));
     } catch (error) {
       throw sessionReadFailure(error, "failed to read discovered evidence-child session");
     }
@@ -25688,7 +25719,7 @@ async function loadBoundAuditorVolumes(sessionFile) {
     latestParentUserIndex = i;
     break;
   }
-  const childDirectories = [join23(dirname10(sessionFile), "auditor-roles")];
+  const childDirectories = [join24(dirname11(sessionFile), "auditor-roles")];
   const valid = [];
   let sawAnyDirectory = false;
   for (const childDirectory of childDirectories) {
@@ -25703,7 +25734,7 @@ async function loadBoundAuditorVolumes(sessionFile) {
     for (const file of names.filter((name) => name.endsWith(".jsonl")).sort().reverse()) {
       let entries;
       try {
-        entries = await readBoundSessionEntries(join23(childDirectory, file));
+        entries = await readBoundSessionEntries(join24(childDirectory, file));
       } catch (error) {
         throw sessionReadFailure(error, "failed to read discovered auditor session");
       }
@@ -26481,8 +26512,8 @@ function projectTerminalGateFact(rounds) {
   };
 }
 async function extractGateFactFromSessionDirectory(sessionDirectory, options = {}) {
-  const directories = [join23(sessionDirectory, "auditor-roles")];
-  const parentSessionFile = options.parentSessionFile ?? join23(sessionDirectory, "session.jsonl");
+  const directories = [join24(sessionDirectory, "auditor-roles")];
+  const parentSessionFile = options.parentSessionFile ?? join24(sessionDirectory, "session.jsonl");
   const rounds = await readAnalystGateCyclesFromAuditorRoles(directories, {
     parentSessionFile
   });
@@ -26580,8 +26611,8 @@ async function extractNavigatorFactFromAdmittedSession(sessionFile) {
 async function publishJudgeArtifacts(admitted, roleOutcome, coordinates) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join23(artifactsDir, "report.json");
-  const evidencePath = join23(artifactsDir, "evidence.json");
+  const reportPath = join24(artifactsDir, "report.json");
+  const evidencePath = join24(artifactsDir, "evidence.json");
   await writeFile6(
     reportPath,
     `${JSON.stringify(
@@ -26625,8 +26656,8 @@ async function publishJudgeArtifacts(admitted, roleOutcome, coordinates) {
 async function publishCoderArtifacts(admitted, roleOutcome, coordinates, options = {}) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join23(artifactsDir, "report.json");
-  const evidencePath = join23(artifactsDir, "evidence.json");
+  const reportPath = join24(artifactsDir, "report.json");
+  const evidencePath = join24(artifactsDir, "evidence.json");
   await writeFile6(
     reportPath,
     `${JSON.stringify(
@@ -26785,8 +26816,8 @@ function extractFixerMethodInvocations(entries, options) {
 async function publishFixerArtifacts(admitted, roleOutcome, coordinates, options) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join23(artifactsDir, "report.json");
-  const evidencePath = join23(artifactsDir, "evidence.json");
+  const reportPath = join24(artifactsDir, "report.json");
+  const evidencePath = join24(artifactsDir, "evidence.json");
   await writeFile6(
     reportPath,
     `${JSON.stringify(
@@ -26885,8 +26916,8 @@ async function settleLawfulFixerTerminalResult(admitted, authority, options) {
 async function publishCollectorArtifacts(admitted, roleOutcome, coordinates, options = {}) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join23(artifactsDir, "report.json");
-  const evidencePath = join23(artifactsDir, "evidence.json");
+  const reportPath = join24(artifactsDir, "report.json");
+  const evidencePath = join24(artifactsDir, "evidence.json");
   await writeFile6(
     reportPath,
     `${JSON.stringify(
@@ -26993,8 +27024,8 @@ async function trySettleCollectorTerminalResult(admitted, authority) {
 async function publishDoctorArtifacts(admitted, roleOutcome, coordinates, options = {}) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join23(artifactsDir, "report.json");
-  const evidencePath = join23(artifactsDir, "evidence.json");
+  const reportPath = join24(artifactsDir, "report.json");
+  const evidencePath = join24(artifactsDir, "evidence.json");
   await writeFile6(
     reportPath,
     `${JSON.stringify(
@@ -27409,8 +27440,8 @@ function extractReviewerMethodInvocations(entries, options) {
 async function publishReviewerArtifacts(admitted, roleOutcome, coordinates, options) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join23(artifactsDir, "report.json");
-  const evidencePath = join23(artifactsDir, "evidence.json");
+  const reportPath = join24(artifactsDir, "report.json");
+  const evidencePath = join24(artifactsDir, "evidence.json");
   await writeFile6(
     reportPath,
     `${JSON.stringify(
@@ -27537,8 +27568,8 @@ function extractMergerMethodInvocations(entries, options) {
 async function publishMergerArtifacts(admitted, roleOutcome, coordinates, options) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join23(artifactsDir, "report.json");
-  const evidencePath = join23(artifactsDir, "evidence.json");
+  const reportPath = join24(artifactsDir, "report.json");
+  const evidencePath = join24(artifactsDir, "evidence.json");
   await writeFile6(
     reportPath,
     `${JSON.stringify(
@@ -27681,13 +27712,13 @@ function publicationAttemptFromError(path, error) {
 }
 function uniqueFailureFallbackDirs(runDirectory, baseDir) {
   const dirs = [];
-  for (const dir of [baseDir, runDirectory, dirname10(runDirectory)]) {
+  for (const dir of [baseDir, runDirectory, dirname11(runDirectory)]) {
     if (!dirs.includes(dir)) dirs.push(dir);
   }
   return dirs;
 }
 async function resolveFailureArtifactsBase(runDirectory) {
-  const artifactsDir = join23(runDirectory, "artifacts");
+  const artifactsDir = join24(runDirectory, "artifacts");
   try {
     await ensureRunArtifactsDir(runDirectory);
     return { baseDir: artifactsDir };
@@ -27703,7 +27734,7 @@ async function writeFailureJsonRetainingCause(preferredCandidates, uniqueFallbac
   const candidates = [
     ...preferredCandidates,
     // One unique name per fallback dir — collisions on fixed names cannot exhaust this.
-    ...uniqueFallbackDirs.map((dir) => join23(dir, `${stem}.${randomUUID3()}.json`))
+    ...uniqueFallbackDirs.map((dir) => join24(dir, `${stem}.${randomUUID3()}.json`))
   ];
   for (let i = 0; i < candidates.length; i += 1) {
     const path = candidates[i];
@@ -27748,26 +27779,26 @@ async function publishFailureArtifacts(admitted, failure, authority) {
   } catch (error) {
     priorIssues.push(publicationAttemptFromError(sessionFile, error));
   }
-  const underArtifacts = baseDir === join23(admitted.runDirectory, "artifacts");
+  const underArtifacts = baseDir === join24(admitted.runDirectory, "artifacts");
   const uniqueFallbackDirs = uniqueFailureFallbackDirs(
     admitted.runDirectory,
     baseDir
   );
   const errorCandidates = underArtifacts ? [
-    join23(baseDir, "error.json"),
-    join23(baseDir, "error.settlement.json"),
-    join23(admitted.runDirectory, "error.settlement.json")
+    join24(baseDir, "error.json"),
+    join24(baseDir, "error.settlement.json"),
+    join24(admitted.runDirectory, "error.settlement.json")
   ] : [
-    join23(baseDir, "error.settlement.json"),
-    join23(baseDir, "error.json")
+    join24(baseDir, "error.settlement.json"),
+    join24(baseDir, "error.json")
   ];
   const evidenceCandidates = underArtifacts ? [
-    join23(baseDir, "evidence.json"),
-    join23(baseDir, "evidence.settlement.json"),
-    join23(admitted.runDirectory, "evidence.settlement.json")
+    join24(baseDir, "evidence.json"),
+    join24(baseDir, "evidence.settlement.json"),
+    join24(admitted.runDirectory, "evidence.settlement.json")
   ] : [
-    join23(baseDir, "evidence.settlement.json"),
-    join23(baseDir, "evidence.json")
+    join24(baseDir, "evidence.settlement.json"),
+    join24(baseDir, "evidence.json")
   ];
   const errorPayloadBase = {
     kind: "error",
@@ -28043,7 +28074,7 @@ var init_turn_request = __esm({
 
 // src/host-transition-prior-native.ts
 import { access as access2, readdir as readdir6 } from "node:fs/promises";
-import { dirname as dirname11, join as join24 } from "node:path";
+import { dirname as dirname12, join as join25 } from "node:path";
 function isEnoent2(error) {
   return typeof error === "object" && error !== null && error.code === "ENOENT";
 }
@@ -28057,7 +28088,7 @@ async function listPiNativeRecordPaths(sessionFile) {
   }
 }
 async function listSitianRecordPaths(sessionParent) {
-  const sessionRoot = dirname11(sessionParent);
+  const sessionRoot = dirname12(sessionParent);
   let entries;
   try {
     entries = await readdir6(sessionRoot, { withFileTypes: true });
@@ -28068,7 +28099,7 @@ async function listSitianRecordPaths(sessionParent) {
   const recordPaths = [];
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const recordFile = join24(sessionRoot, entry.name, "records.jsonl");
+    const recordFile = join25(sessionRoot, entry.name, "records.jsonl");
     try {
       await access2(recordFile);
       recordPaths.push(recordFile);
@@ -28138,7 +28169,7 @@ var init_public_run_credentials = __esm({
 import { constants as fsConstants } from "node:fs";
 import { randomUUID as randomUUID4 } from "node:crypto";
 import { lstat as lstat5, mkdir as mkdir4, open as open2 } from "node:fs/promises";
-import { join as join25 } from "node:path";
+import { join as join26 } from "node:path";
 function presentTerminal(terminal, io) {
   if (terminal.roleOutcome.kind === "failure" || terminal.roleOutcome.kind === "no_receipt") {
     presentFailureTerminal(terminal, io);
@@ -28157,7 +28188,7 @@ async function finalizeExceptionRunBestEffort(runDirectory, io) {
   }
 }
 function runArtifactsDirectory(runDirectory) {
-  return join25(runDirectory, "artifacts");
+  return join26(runDirectory, "artifacts");
 }
 async function ensureRealArtifactsDirectory(runDirectory) {
   const runStat = await lstat5(runDirectory);
@@ -28240,7 +28271,7 @@ function jsonSafeReplacer() {
 }
 async function retainDispatchError(admitted, principalAuthority, sessionAppender, attempt, error) {
   const artifactsDir = await ensureRealArtifactsDirectory(admitted.runDirectory);
-  const filePath = join25(
+  const filePath = join26(
     artifactsDir,
     `dispatch-error-attempt-${attempt}-${randomUUID4()}.json`
   );
@@ -28489,10 +28520,10 @@ var init_auto_resume = __esm({
 // src/public-cli/post-admission.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
 import { readFile as readFile16, writeFile as writeFile7 } from "node:fs/promises";
-import { isAbsolute as isAbsolute6, join as join26, resolve as resolve9 } from "node:path";
+import { isAbsolute as isAbsolute7, join as join27, resolve as resolve10 } from "node:path";
 async function readInvocationHost(runDirectory) {
   try {
-    const raw = JSON.parse(await readFile16(join26(runDirectory, "invocation.json"), "utf8"));
+    const raw = JSON.parse(await readFile16(join27(runDirectory, "invocation.json"), "utf8"));
     return typeof raw.host === "string" && raw.host.trim() !== "" ? raw.host : void 0;
   } catch (error) {
     if (error.code === "ENOENT") return void 0;
@@ -28632,7 +28663,7 @@ async function dispatchPostAdmissionTurn(input) {
     }
     try {
       await writeFile7(
-        join26(admitted.runDirectory, "stderr.log"),
+        join27(admitted.runDirectory, "stderr.log"),
         result2.stderr,
         "utf8"
       );
@@ -28705,12 +28736,15 @@ function resumeTurnRequestProjectionOptions(admitted, request, env, summonsPrepa
   let prompt;
   if (request.message !== void 0) {
     if (summonsPrepared !== void 0 && summonsPrepared.attachments.length > 0) {
-      prompt = buildInstructionTransportPrompt(
-        {
-          instruction: request.message,
-          instructionEmpty: false,
-          attachments: summonsPrepared.attachments
-        },
+      prompt = instructResumeHandbookRead(
+        buildInstructionTransportPrompt(
+          {
+            instruction: request.message,
+            instructionEmpty: false,
+            attachments: summonsPrepared.attachments
+          },
+          engineMaterial
+        ),
         engineMaterial
       );
     } else {
@@ -28721,7 +28755,10 @@ function resumeTurnRequestProjectionOptions(admitted, request, env, summonsPrepa
       });
     }
   } else if (summonsPrepared !== void 0) {
-    prompt = buildInstructionTransportPrompt(summonsPrepared, engineMaterial);
+    prompt = instructResumeHandbookRead(
+      buildInstructionTransportPrompt(summonsPrepared, engineMaterial),
+      engineMaterial
+    );
   } else {
     prompt = buildResumeContinuationPrompt({
       packageRoot: env.packageRoot,
@@ -28743,8 +28780,8 @@ function resumeTurnRequestProjectionOptions(admitted, request, env, summonsPrepa
   };
 }
 function isAlreadyFrozenSummonsAttachment(runDirectory, attachmentPath) {
-  const absolute = isAbsolute6(attachmentPath) ? attachmentPath : resolve9(attachmentPath);
-  return pathContainedIn(join26(runDirectory, "attachments"), absolute);
+  const absolute = isAbsolute7(attachmentPath) ? attachmentPath : resolve10(attachmentPath);
+  return pathContainedIn(join27(runDirectory, "attachments"), absolute);
 }
 async function prepareSummonsResumeMaterials(runDirectory, summons) {
   if (summons === void 0) return void 0;
@@ -29775,7 +29812,7 @@ var init_countersign_run = __esm({
 // src/public-cli/diarist-run.ts
 import { existsSync as existsSync10 } from "node:fs";
 import { writeFile as writeFile8 } from "node:fs/promises";
-import { join as join27 } from "node:path";
+import { join as join28 } from "node:path";
 function withDiaristCatalogPath(prompt, sourcesPath) {
   if (sourcesPath === void 0 || sourcesPath.trim() === "") return prompt;
   return `${prompt}
@@ -29801,7 +29838,7 @@ function buildDiaristTurnRequest(admitted, options, sourcesPath) {
 }
 async function freezeDiaristSourceCatalog(admitted, env) {
   if (admitted.ticketNumber === void 0) return void 0;
-  const path = join27(admitted.runDirectory, DIARIST_SOURCE_CATALOG_FILE);
+  const path = join28(admitted.runDirectory, DIARIST_SOURCE_CATALOG_FILE);
   if (existsSync10(path)) {
     const identity = await readRoleRunIdentity(admitted.runDirectory);
     if (identity !== void 0 && identity.state !== "terminal") return path;
@@ -30349,6 +30386,7 @@ var init_fixer_run = __esm({
 });
 
 // src/public-cli/notary-run.ts
+import { existsSync as existsSync11 } from "node:fs";
 function buildNotaryTurnRequest(admitted, options) {
   return projectRoleTurnRequest(
     admitted,
@@ -30491,10 +30529,19 @@ async function runPublicNotaryResume(request, env, io) {
       }
       return loaded;
     },
-    buildTurnRequest: (admitted, effective) => buildNotaryTurnRequest(
-      admitted,
-      resumeTurnRequestProjectionOptions(admitted, effective, env)
-    ),
+    buildTurnRequest: (admitted, effective) => {
+      const projection = resumeTurnRequestProjectionOptions(
+        admitted,
+        effective,
+        env
+      );
+      const candidatePath = gateSubmissionCandidatePath(admitted.sourceRunPath);
+      const prompt = existsSync11(candidatePath) ? appendResumeMaterialReread(projection.continuation.prompt, candidatePath) : projection.continuation.prompt;
+      return buildNotaryTurnRequest(admitted, {
+        ...projection,
+        continuation: { kind: "resume", prompt }
+      });
+    },
     adapters: notaryAdapters(),
     ...env.engine === void 0 ? {} : { effectiveEngine: env.engine }
   });
@@ -30502,6 +30549,7 @@ async function runPublicNotaryResume(request, env, io) {
 var init_notary_run = __esm({
   "src/public-cli/notary-run.ts"() {
     "use strict";
+    init_auditor_dossier_tool();
     init_notary_source_run();
     init_engine_material();
     init_run_ticket_number();
@@ -30784,7 +30832,7 @@ var init_judge_run = __esm({
 
 // src/public-cli/merger-run.ts
 import { mkdir as mkdir5, writeFile as writeFile9 } from "node:fs/promises";
-import { join as join28, resolve as resolve10 } from "node:path";
+import { join as join29, resolve as resolve11 } from "node:path";
 function mergerMethods(packageRoot2) {
   return [
     {
@@ -30826,7 +30874,7 @@ async function loadMergerMethodMaterial(packageRoot2) {
   );
 }
 async function admitMergerShellForActivationFailure(options) {
-  const projectRoot = resolve10(options.project ?? options.cwd);
+  const projectRoot = resolve11(options.project ?? options.cwd);
   const runId = (options.createRunId ?? uuidv7)();
   const {
     principal,
@@ -30850,8 +30898,8 @@ async function admitMergerShellForActivationFailure(options) {
     expectedConflictPaths: [],
     resolutionScope: []
   };
-  const admittedRequestPath = join28(runDirectory, "admitted-request.json");
-  const mergerInputPath = join28(runDirectory, "merger-input.json");
+  const admittedRequestPath = join29(runDirectory, "admitted-request.json");
+  const mergerInputPath = join29(runDirectory, "merger-input.json");
   await writeFile9(
     admittedRequestPath,
     `${JSON.stringify(
@@ -31256,7 +31304,7 @@ var init_reviewer_run = __esm({
 
 // src/analyst-book-key.ts
 import { statSync as statSync3 } from "node:fs";
-import { isAbsolute as isAbsolute7 } from "node:path";
+import { isAbsolute as isAbsolute8 } from "node:path";
 function resolveAnalystBookKey(projectRoot) {
   const identity = physicalPathIdentity(projectRoot);
   let stats;
@@ -31278,7 +31326,7 @@ function resolveAnalystBookKey(projectRoot) {
   }
 }
 function isSyntheticAnalystBookKey(bookKey) {
-  return bookKey.startsWith("root:") && isAbsolute7(bookKey.slice("root:".length));
+  return bookKey.startsWith("root:") && isAbsolute8(bookKey.slice("root:".length));
 }
 var init_analyst_book_key = __esm({
   "src/analyst-book-key.ts"() {
@@ -31291,10 +31339,10 @@ var init_analyst_book_key = __esm({
 // src/atomic-write.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
 import { rename, rm as rm2, writeFile as writeFile10 } from "node:fs/promises";
-import { dirname as dirname12, join as join29 } from "node:path";
+import { dirname as dirname13, join as join30 } from "node:path";
 async function writeFileAtomically(destination, contents) {
-  const parent = dirname12(destination);
-  const temporary = join29(parent, `.atomic-write-${randomUUID6()}.tmp`);
+  const parent = dirname13(destination);
+  const temporary = join30(parent, `.atomic-write-${randomUUID6()}.tmp`);
   try {
     await writeFile10(temporary, contents);
     await rename(temporary, destination);
@@ -31311,16 +31359,16 @@ var init_atomic_write = __esm({
 
 // src/analyst-index.ts
 import { open as open3, readFile as readFile17, unlink as unlink4 } from "node:fs/promises";
-import { dirname as dirname13, join as join30 } from "node:path";
+import { dirname as dirname14, join as join31 } from "node:path";
 function sleep(ms) {
-  return new Promise((resolve12) => {
-    setTimeout(resolve12, ms);
+  return new Promise((resolve13) => {
+    setTimeout(resolve13, ms);
   });
 }
 async function withAnalystLibraryIndexLock(ledgerHome, fn) {
   const indexPath = analystLibraryIndexPath(ledgerHome);
-  ensureRealDirectoryTree(ledgerHome, dirname13(indexPath));
-  const lockPath = join30(dirname13(indexPath), LIBRARY_INDEX_LOCK_NAME);
+  ensureRealDirectoryTree(ledgerHome, dirname14(indexPath));
+  const lockPath = join31(dirname14(indexPath), LIBRARY_INDEX_LOCK_NAME);
   assertLedgerFileInsideHome(lockPath, ledgerHome);
   const startedAt = Date.now();
   while (true) {
@@ -31347,7 +31395,7 @@ async function withAnalystLibraryIndexLock(ledgerHome, fn) {
   }
 }
 function analystLibraryIndexPath(ledgerHome) {
-  return join30(ledgerHome, "analyst", "library-index.json");
+  return join31(ledgerHome, "analyst", "library-index.json");
 }
 function rowFromIssueMetricsPage(page) {
   return {
@@ -31456,7 +31504,7 @@ async function readAnalystLibraryIndexPage(ledgerHome) {
 }
 async function writeAnalystLibraryIndexPage(ledgerHome, page) {
   const path = analystLibraryIndexPath(ledgerHome);
-  ensureRealDirectoryTree(ledgerHome, dirname13(path));
+  ensureRealDirectoryTree(ledgerHome, dirname14(path));
   assertLedgerFileInsideHome(path, ledgerHome);
   await writeFileAtomically(path, `${JSON.stringify(page, null, 2)}
 `);
@@ -31643,7 +31691,7 @@ var init_analyst_cohort = __esm({
 
 // src/analyst-ledger.ts
 import { readdir as readdir7, readFile as readFile18 } from "node:fs/promises";
-import { join as join31 } from "node:path";
+import { join as join32 } from "node:path";
 function isMissingPathError5(error) {
   return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
 }
@@ -31656,7 +31704,7 @@ function isRecord19(value) {
 async function readExistingRunLifecycleState(runDirectory) {
   try {
     const raw = JSON.parse(
-      await readFile18(join31(runDirectory, "run-state.json"), "utf8")
+      await readFile18(join32(runDirectory, "run-state.json"), "utf8")
     );
     if (!isRecord19(raw) || typeof raw.state !== "string") return void 0;
     return raw.state;
@@ -31688,7 +31736,7 @@ async function listLedgerBookNames(booksRoot) {
 async function readInvocationScopeFields(runDirectory) {
   let raw;
   try {
-    raw = await readFile18(join31(runDirectory, "invocation.json"), "utf8");
+    raw = await readFile18(join32(runDirectory, "invocation.json"), "utf8");
   } catch (error) {
     if (isMissingPathError5(error)) return void 0;
     throw error;
@@ -31720,7 +31768,7 @@ function decideIssueScope(input) {
 }
 async function resolveSessionFile(runDirectory) {
   try {
-    const raw = await readFile18(join31(runDirectory, "invocation.json"), "utf8");
+    const raw = await readFile18(join32(runDirectory, "invocation.json"), "utf8");
     const parsed = JSON.parse(raw);
     if (isRecord19(parsed) && typeof parsed.sessionFile === "string" && parsed.sessionFile.trim() !== "") {
       return parsed.sessionFile;
@@ -31728,7 +31776,7 @@ async function resolveSessionFile(runDirectory) {
   } catch (error) {
     if (!isMissingPathError5(error)) throw error;
   }
-  return join31(runDirectory, "session", "session.jsonl");
+  return join32(runDirectory, "session", "session.jsonl");
 }
 function attributeSessionRowsForRun(input) {
   if (pathContainedIn(input.runDirectory, input.sessionFile)) {
@@ -31900,9 +31948,9 @@ async function classifyScopedRun(input) {
   }
   let gateCycles;
   try {
-    const parentSessionFile = join31(input.runDirectory, "session", "session.jsonl");
+    const parentSessionFile = join32(input.runDirectory, "session", "session.jsonl");
     gateCycles = await readAnalystGateCyclesFromAuditorRoles(
-      join31(input.runDirectory, "session", "auditor-roles"),
+      join32(input.runDirectory, "session", "auditor-roles"),
       { parentSessionFile }
     );
   } catch (error) {
@@ -31935,7 +31983,7 @@ async function classifyScopedRun(input) {
 async function scanAnalystIssueRuns(input) {
   const ledgerHome = resolveActivationLedgerHome(input.home);
   const scopeTicketNumber = input.ticketNumber;
-  const booksRoot = join31(ledgerHome, "books");
+  const booksRoot = join32(ledgerHome, "books");
   let wholeBook = false;
   let scopeRootIdentity;
   let bookNames;
@@ -31967,7 +32015,7 @@ async function scanAnalystIssueRuns(input) {
   const unreadable = [];
   const scopeConflicts = [];
   for (const book of bookNames) {
-    const runsDir = join31(booksRoot, book, "runs");
+    const runsDir = join32(booksRoot, book, "runs");
     let runNames;
     try {
       const entries = await readdir7(runsDir, { withFileTypes: true });
@@ -31979,7 +32027,7 @@ async function scanAnalystIssueRuns(input) {
     for (const runName of runNames) {
       const parsed = parseRunDirectoryName2(runName);
       if (parsed === void 0) continue;
-      const runDirectory = join31(runsDir, runName);
+      const runDirectory = join32(runsDir, runName);
       let scopeFields;
       try {
         scopeFields = await readInvocationScopeFields(runDirectory);
@@ -32833,7 +32881,7 @@ var init_analyst_metric_family = __esm({
 
 // src/analyst-page.ts
 import { createHash as createHash7 } from "node:crypto";
-import { dirname as dirname14, join as join32 } from "node:path";
+import { dirname as dirname15, join as join33 } from "node:path";
 function analystIssuePageKey(address) {
   const parts = ["book", address.bookKey];
   if (address.issueNumber !== void 0) {
@@ -32844,7 +32892,7 @@ function analystIssuePageKey(address) {
   return createHash7("sha256").update(parts.join("\0")).digest("hex").slice(0, 32);
 }
 function analystIssuePagePath(ledgerHome, address) {
-  return join32(ledgerHome, "analyst", "issues", `${analystIssuePageKey(address)}.json`);
+  return join33(ledgerHome, "analyst", "issues", `${analystIssuePageKey(address)}.json`);
 }
 function analystIssuePageAddressFromPage(page) {
   return {
@@ -32963,7 +33011,7 @@ async function buildAnalystIssueMetricsPage(input) {
 }
 async function writeAnalystIssueMetricsPage(ledgerHome, page) {
   const path = analystIssuePagePath(ledgerHome, analystIssuePageAddressFromPage(page));
-  ensureRealDirectoryTree(ledgerHome, dirname14(path));
+  ensureRealDirectoryTree(ledgerHome, dirname15(path));
   assertLedgerFileInsideHome(path, ledgerHome);
   await writeFileAtomically(path, `${JSON.stringify(page, null, 2)}
 `);
@@ -33205,7 +33253,7 @@ var init_analyst_entry = __esm({
 
 // src/public-cli/analyst-run.ts
 import { readFile as readFile20 } from "node:fs/promises";
-import { isAbsolute as isAbsolute8, resolve as resolve11 } from "node:path";
+import { isAbsolute as isAbsolute9, resolve as resolve12 } from "node:path";
 function resolveAnalystIssueBookKeyFromCwd(cwd = process.cwd()) {
   try {
     return resolveBookKeyFromGit(cwd);
@@ -33254,7 +33302,7 @@ async function buildAnalystSweepModeInputFromAttachmentPaths(attachmentPaths) {
     );
   }
   const sourcePath = attachmentPaths[0];
-  const absolute = isAbsolute8(sourcePath) ? sourcePath : resolve11(sourcePath);
+  const absolute = isAbsolute9(sourcePath) ? sourcePath : resolve12(sourcePath);
   let bytes;
   try {
     bytes = await readFile20(absolute);
@@ -33377,7 +33425,7 @@ __export(cli_exports, {
   runAkRole: () => runAkRole
 });
 import { realpath as realpath6 } from "node:fs/promises";
-import { join as join33 } from "node:path";
+import { join as join34 } from "node:path";
 function takePublicGlobalFlag(argv, index, options) {
   const tokens = argv.slice(index);
   const taken = options.takeDashed(tokens);
@@ -33509,7 +33557,7 @@ function resolveHome(env) {
   return env.home ?? packageMachineHome();
 }
 function resolveAgentDir(env, home) {
-  return env.agentDir ?? process.env.PI_CODING_AGENT_DIR ?? join33(home, ".pi", "agent");
+  return env.agentDir ?? process.env.PI_CODING_AGENT_DIR ?? join34(home, ".pi", "agent");
 }
 function parseThinking(value) {
   return value;
@@ -34466,8 +34514,8 @@ var init_cli = __esm({
 });
 
 // src/public-cli/main.ts
-import { existsSync as existsSync11 } from "node:fs";
-import { dirname as dirname15, join as join34 } from "node:path";
+import { existsSync as existsSync12 } from "node:fs";
+import { dirname as dirname16, join as join35 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // src/public-cli/host-pi-runtime.ts
@@ -34554,10 +34602,10 @@ function linkPackage(packageRoot2, name, targetDir) {
 }
 
 // src/public-cli/main.ts
-var here = dirname15(fileURLToPath3(import.meta.url));
+var here = dirname16(fileURLToPath3(import.meta.url));
 function resolvePackageRoot(binDir) {
-  const canonical = join34(binDir, "..", "..");
-  if (existsSync11(join34(canonical, "package.json"))) {
+  const canonical = join35(binDir, "..", "..");
+  if (existsSync12(join35(canonical, "package.json"))) {
     return canonical;
   }
   return binDir;