@akagilnc/pi-workflow-roles 0.1.5775 → 0.1.5797

package/dist/public-cli/main.js

@@ -1045,6 +1045,12 @@ function appendSitianRecordBlock(input, block) {
 function resolveSitianVolumeCategory(kind) {
   return kind;
 }
+function runDirectoryOwningSessionParent(sessionParentDir) {
+  if (basename3(sessionParentDir) !== "session") return void 0;
+  const runDirectory = dirname3(sessionParentDir);
+  if (parseRunLeaf(basename3(runDirectory)) === void 0) return void 0;
+  return runDirectory;
+}
 function sitianVolumeDirectory(sessionDirectory, category) {
   return join2(sessionDirectory, category);
 }
@@ -1076,8 +1082,8 @@ function resolveSitianRecordPathInLedger(input, ledgerHome) {
       throw new Error("Sitian record ownership requires a parent session inside the ledger home");
     }
     const sessionParentDir = dirname3(input.sessionParent);
-    const runDirectory = dirname3(sessionParentDir);
-    if (basename3(sessionParentDir) === "session" && parseRunLeaf(basename3(runDirectory)) !== void 0) {
+    const runDirectory = runDirectoryOwningSessionParent(sessionParentDir);
+    if (runDirectory !== void 0) {
       sessionDir = runDirectory;
       recordFile = join2(runDirectory, RUN_HISTORY_KINDS.has(input.kind) ? RUN_HISTORY_FILE : RUN_STATE_KINDS.has(input.kind) ? RUN_STATE_FILE : RUN_LOG_FILE);
     } else {
@@ -1310,7 +1316,9 @@ function render(runDirectory, history, state, log, unreadable) {
       original = payload.landingPath;
     }
   }
-  if (typeof original === "string") original = join3(runDirectory, "session", basename4(original));
+  if (typeof original === "string") {
+    original = join3(sessionDirectoryOf(runDirectory), basename4(original));
+  }
   whole.host = { sessions, ...original === void 0 ? {} : { original } };
   whole.submission = latest === void 0 ? {} : { latest };
   if (Object.keys(unreadable).length > 0) whole.unreadable = unreadable;
@@ -1548,6 +1556,16 @@ function parseRunLeaf(name) {
   if (at <= 0 || at === name.length - 1) return void 0;
   return { runId: name.slice(0, at), role: name.slice(at + 1) };
 }
+function subjectDirectoryOfRun(runDirectory) {
+  const runsParent = dirname4(runDirectory);
+  if (basename5(runsParent) !== "runs") return void 0;
+  const subjectDirectory = dirname4(runsParent);
+  const subjectName = basename5(subjectDirectory);
+  if (subjectName === "unbound" || /^[1-9]\d*$/.test(subjectName)) {
+    return subjectDirectory;
+  }
+  return void 0;
+}
 function sessionDirectoryOf(runDirectory) {
   return join5(runDirectory, "session");
 }
@@ -1640,6 +1658,7 @@ function ensureRoleRunDirectory(ledgerHome, directory) {
   return ensureRealDirectoryTree(ledgerHome, directory);
 }
 function ensureRoleRunPlacement(ledgerHome, placement) {
+  ensureRoleRunDirectory(ledgerHome, placement.runDirectory);
   ensureRoleRunDirectory(ledgerHome, placement.sessionDirectory);
 }
 var ROLE_RUN_SESSION_FILENAME;
@@ -12583,7 +12602,8 @@ var init_role_activation_flags = __esm({
 
 // src/user-dialogue-stdin.ts
 function encodeUserDialogueStdin(body) {
-  return JSON.stringify({ kind: USER_DIALOGUE_STDIN_KIND, body });
+  const envelope = { kind: USER_DIALOGUE_STDIN_KIND, body };
+  return JSON.stringify(envelope);
 }
 var USER_DIALOGUE_STDIN_KIND;
 var init_user_dialogue_stdin = __esm({
@@ -12913,17 +12933,6 @@ var init_submission_correctable_error = __esm({
   }
 });
 
-// src/sha256.ts
-import { createHash } from "node:crypto";
-function sha256Hex(bytes) {
-  return createHash("sha256").update(bytes).digest("hex");
-}
-var init_sha256 = __esm({
-  "src/sha256.ts"() {
-    "use strict";
-  }
-});
-
 // src/package-contracts/terminating-tools.ts
 function isTerminatingToolName(name) {
   return TERMINATING_TOOL_NAMES.includes(name);
@@ -12984,9 +12993,149 @@ var init_terminating_tools = __esm({
   }
 });
 
+// src/ticket-progress.ts
+import {
+  appendFileSync as appendFileSync2,
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync3,
+  readFileSync as readFileSync3,
+  readdirSync as readdirSync2,
+  rmSync as rmSync3,
+  writeFileSync as writeFileSync2
+} from "node:fs";
+import { basename as basename7, dirname as dirname7, join as join11, relative as relative2, sep as sep3 } from "node:path";
+function parseProgressText(text, pathForDiagnostic) {
+  if (text.trim() === "") return [];
+  const { records, diagnostics } = parseSitianRecordText(text);
+  for (const diagnostic of diagnostics) {
+    process.stderr.write(
+      `[ticket-progress] ${pathForDiagnostic} has malformed row(s); keeps reachable rows and retains the diagnostic: line ${diagnostic.line}: ${diagnostic.error}
+`
+    );
+  }
+  const lines = [];
+  for (const record of records) {
+    const parsed = record;
+    if (!isRecord(parsed)) continue;
+    if (typeof parsed.seat !== "string" || typeof parsed.round !== "string") continue;
+    lines.push(parsed);
+  }
+  return lines;
+}
+function readProgressFile(path) {
+  if (!existsSync2(path)) return [];
+  return parseProgressText(readFileSync3(path, "utf8"), path);
+}
+function readTicketProgressLines(subjectDirectory) {
+  if (basename7(subjectDirectory) === "unbound") {
+    const runsDir = join11(subjectDirectory, "runs");
+    if (!existsSync2(runsDir)) return [];
+    const out = [];
+    for (const name of readdirSync2(runsDir).sort()) {
+      out.push(...readProgressFile(join11(runsDir, name, LEG_PROGRESS_FILENAME)));
+    }
+    return out;
+  }
+  return readProgressFile(join11(subjectDirectory, CURRENT_FILENAME));
+}
+function roundBaseNumber(round) {
+  if (round.trim() === "") return 0;
+  const base = round.includes(".") ? round.slice(0, round.indexOf(".")) : round;
+  const n = Number(base);
+  return Number.isSafeInteger(n) && n > 0 ? n : 0;
+}
+function roundLens(round) {
+  return round.includes(".") ? round.slice(round.indexOf(".") + 1) : void 0;
+}
+function nextRoundFromLines(lines, seat, lens) {
+  const want = lens === void 0 || lens.trim() === "" ? void 0 : lens;
+  let max = 0;
+  for (const line2 of lines) {
+    if (line2.seat !== seat) continue;
+    if (roundLens(line2.round) !== want) continue;
+    max = Math.max(max, roundBaseNumber(line2.round));
+  }
+  const base = max + 1;
+  return want === void 0 ? String(base) : `${base}.${want}`;
+}
+function lensFromRunDirectory(runDirectory, role) {
+  if (role !== "reviewer") return void 0;
+  const lens = readPageSync(runDirectory, "admitted")?.lens;
+  return lens === "completeness" || lens === "correctness" ? lens : void 0;
+}
+function relocateTicketProgressForLeg(input) {
+  if (isUnboundRunDirectory(input.runDirectory)) return;
+  const subjectDirectory = subjectDirectoryOfRun(input.runDirectory);
+  if (subjectDirectory === void 0) return;
+  const stagedPath = join11(input.runDirectory, LEG_PROGRESS_FILENAME);
+  const mine = readProgressFile(stagedPath);
+  if (mine.length === 0) {
+    if (existsSync2(stagedPath)) {
+      rmSync3(stagedPath, { force: true });
+    }
+    return;
+  }
+  const ticketLines = [...readTicketProgressLines(subjectDirectory)];
+  const publishedReceipts = new Set(
+    ticketLines.map((line2) => line2.receipt).filter((receipt) => typeof receipt === "string" && receipt !== "")
+  );
+  const pending = mine.filter((line2) => !publishedReceipts.has(line2.receipt));
+  if (pending.length === 0) {
+    rmSync3(stagedPath, { force: true });
+    return;
+  }
+  const movedLines = [];
+  for (const line2 of pending) {
+    const lens = lensFromRunDirectory(input.runDirectory, line2.seat);
+    const round = nextRoundFromLines(ticketLines, line2.seat, lens);
+    const moved = {
+      ...line2,
+      round
+    };
+    movedLines.push(moved);
+    ticketLines.push(moved);
+  }
+  const newCurrent = join11(subjectDirectory, CURRENT_FILENAME);
+  mkdirSync3(dirname7(newCurrent), { recursive: true });
+  appendFileSync2(
+    newCurrent,
+    `${movedLines.map((line2) => JSON.stringify(line2)).join("\n")}
+`,
+    "utf8"
+  );
+  rmSync3(stagedPath, { force: true });
+}
+var CURRENT_FILENAME, LEG_PROGRESS_FILENAME;
+var init_ticket_progress = __esm({
+  "src/ticket-progress.ts"() {
+    "use strict";
+    init_host_session_record();
+    init_host_contracts();
+    init_terminating_tools();
+    init_packaged_role_registry();
+    init_role_run_placement();
+    init_run_dossier();
+    init_sitian_reader();
+    init_unknown_value();
+    CURRENT_FILENAME = "current.jsonl";
+    LEG_PROGRESS_FILENAME = "progress.jsonl";
+  }
+});
+
+// src/sha256.ts
+import { createHash } from "node:crypto";
+function sha256Hex(bytes) {
+  return createHash("sha256").update(bytes).digest("hex");
+}
+var init_sha256 = __esm({
+  "src/sha256.ts"() {
+    "use strict";
+  }
+});
+
 // src/doctor-evidence.ts
 import { readdir as readdir2, readFile as readFile5, realpath, stat } from "node:fs/promises";
-import { dirname as dirname7, relative as relative2, resolve as resolve4, sep as sep3 } from "node:path";
+import { dirname as dirname8, relative as relative3, resolve as resolve4, sep as sep4 } from "node:path";
 async function discoverCaseFiles(root) {
   const found = [];
   async function walk(dir, depth) {
@@ -13015,11 +13164,11 @@ async function stableRunsIdentity(root) {
   while (true) {
     try {
       const git2 = await stat(resolve4(cursor, ".git"));
-      if (git2.isDirectory() || git2.isFile()) return relative2(cursor, root).split(sep3).join("/");
+      if (git2.isDirectory() || git2.isFile()) return relative3(cursor, root).split(sep4).join("/");
     } catch (error) {
       if (!isMissingPathError(error)) throw error;
     }
-    const parent = dirname7(cursor);
+    const parent = dirname8(cursor);
     if (parent === cursor) return root;
     cursor = parent;
   }
@@ -13092,12 +13241,12 @@ async function loadDoctorCase(runsPath, projectRoot) {
   if (projectRoot !== void 0 && !physicallyContainedIn(projectRoot, root)) {
     throw new Error("doctor --runs escapes the project root");
   }
-  const match = root.split(sep3).join("/").match(/\/\.ak-roles\/books\/[^/]+\/(?:issues\/)?([1-9]\d*)\/runs$/);
+  const match = root.split(sep4).join("/").match(/\/\.ak-roles\/books\/[^/]+\/(?:issues\/)?([1-9]\d*)\/runs$/);
   if (!match) throw new Error("Doctor case must be an .ak-roles/books/<book>/<n>/runs directory");
   const evidence = [], sessions = [], statuses = [], commits = [];
   const turns = { count: 0, sources: [] }, calls = { count: 0, sources: [] }, tokens = { count: 0, sources: [] };
   for (const path of await discoverCaseFiles(root)) {
-    const id = relative2(root, path).split(sep3).join("/");
+    const id = relative3(root, path).split(sep4).join("/");
     const bytes = await readFile5(path);
     const content = bytes.toString("utf8");
     const kind = id.split("/").length === 2 && id.endsWith("/log.jsonl") ? "log" : "session";
@@ -13282,7 +13431,7 @@ var init_session_dialogue = __esm({
 
 // src/ticket-provenance.ts
 import { readFile as readFile7 } from "node:fs/promises";
-import { join as join11, resolve as resolve6 } from "node:path";
+import { join as join12, resolve as resolve6 } from "node:path";
 function ticketProvenanceSubject(ticketNumber) {
   if (!isSafePositiveTicketNumber(ticketNumber)) {
     throw new Error(
@@ -13305,7 +13454,7 @@ async function rehomeUnboundTicketProvenance(runDirectory, ticketNumber, cwd, ho
   const ticketInput = ticketProvenanceRecordInput(ticketNumber, cwd, home);
   let history;
   try {
-    history = await readFile7(join11(runDirectory, RUN_HISTORY_FILE), "utf8");
+    history = await readFile7(join12(runDirectory, RUN_HISTORY_FILE), "utf8");
   } catch (error) {
     if (errnoCode(error) === "ENOENT") return;
     throw error;
@@ -13361,7 +13510,7 @@ var init_uuidv7 = __esm({
 });
 
 // src/notary-source-run.ts
-import { dirname as dirname8, isAbsolute as isAbsolute4, join as join12, resolve as resolve7, basename as basename7 } from "node:path";
+import { dirname as dirname9, isAbsolute as isAbsolute4, join as join13, resolve as resolve7, basename as basename8 } from "node:path";
 import { lstat as lstat2, realpath as realpath2 } from "node:fs/promises";
 async function readRetainedIdentity(runDirectory) {
   try {
@@ -13397,10 +13546,10 @@ async function requireRunDirectory(candidate, display) {
       `notary --source-run must be a run directory: ${display}`
     );
   }
-  const identity = parseRunLeaf(basename7(real));
+  const identity = parseRunLeaf(basename8(real));
   if (identity === void 0) {
     throw new NotarySourceRunError(
-      `notary --source-run must be named <runId>@<role>: ${basename7(real)}`
+      `notary --source-run must be named <runId>@<role>: ${basename8(real)}`
     );
   }
   return real;
@@ -13413,26 +13562,26 @@ async function resolveNotarySourceRunLocator(options) {
   const ledgerHome = resolveActivationLedgerHome(options.home);
   const bookKey = resolveBookKeyFromGit(options.projectRoot);
   const bookDirectory = activationBookDirectory(ledgerHome, bookKey);
-  const bookRunsRoot = join12(bookDirectory, "runs");
+  const bookRunsRoot = join13(bookDirectory, "runs");
   let candidate;
   const bare = parseRunLeaf(raw);
   if (bare !== void 0 && !raw.includes("/") && !raw.includes("\\")) {
-    candidate = await findRunDirectoryById(options.home, bare.runId, bookKey, bare.role) ?? join12(bookRunsRoot, formatRunLeaf(bare.runId, bare.role));
+    candidate = await findRunDirectoryById(options.home, bare.runId, bookKey, bare.role) ?? join13(bookRunsRoot, formatRunLeaf(bare.runId, bare.role));
   } else {
     candidate = isAbsolute4(raw) ? raw : resolve7(options.projectRoot, raw);
-    const identity2 = parseRunLeaf(basename7(candidate));
-    const subjectDirectory = dirname8(dirname8(candidate));
-    const isLegacyUnboundLocator = identity2 !== void 0 && basename7(dirname8(candidate)) === "runs" && basename7(subjectDirectory) === "unbound" && resolve7(dirname8(subjectDirectory)) === resolve7(bookDirectory);
+    const identity2 = parseRunLeaf(basename8(candidate));
+    const subjectDirectory = dirname9(dirname9(candidate));
+    const isLegacyUnboundLocator = identity2 !== void 0 && basename8(dirname9(candidate)) === "runs" && basename8(subjectDirectory) === "unbound" && resolve7(dirname9(subjectDirectory)) === resolve7(bookDirectory);
     if (isLegacyUnboundLocator) {
       candidate = await resolveLiveRunDirectoryPath(candidate, options.home ?? ledgerHome, bookKey) ?? candidate;
     }
   }
   const real = await requireRunDirectory(candidate, raw);
-  const identity = parseRunLeaf(basename7(real));
+  const identity = parseRunLeaf(basename8(real));
   const bookIdentity = physicalPathIdentity(bookDirectory);
-  const parentIdentity = physicalPathIdentity(dirname8(real));
-  const subjectBookIdentity = physicalPathIdentity(dirname8(dirname8(dirname8(real))));
-  if (parentIdentity !== physicalPathIdentity(bookRunsRoot) && !(basename7(dirname8(real)) === "runs" && subjectBookIdentity === bookIdentity)) {
+  const parentIdentity = physicalPathIdentity(dirname9(real));
+  const subjectBookIdentity = physicalPathIdentity(dirname9(dirname9(dirname9(real))));
+  if (parentIdentity !== physicalPathIdentity(bookRunsRoot) && !(basename8(dirname9(real)) === "runs" && subjectBookIdentity === bookIdentity)) {
     throw new NotarySourceRunError(
       "notary --source-run must resolve to a retained run under the project machine-ledger book"
     );
@@ -14535,14 +14684,14 @@ var init_option_definitions = __esm({
 
 // src/public-cli/invocation.ts
 import { execFileSync as execFileSync2 } from "node:child_process";
-import { existsSync as existsSync2 } from "node:fs";
+import { existsSync as existsSync3 } from "node:fs";
 import {
   readFile as readFile8,
   realpath as realpath3,
   rename,
   writeFile as writeFile2
 } from "node:fs/promises";
-import { dirname as dirname9, isAbsolute as isAbsolute5, join as join13, resolve as resolve8 } from "node:path";
+import { dirname as dirname10, isAbsolute as isAbsolute5, join as join14, resolve as resolve8 } from "node:path";
 function admittedSourceRunPath(admitted) {
   if (!isRecord(admitted)) return void 0;
   const path = admitted.sourceRunPath;
@@ -14701,35 +14850,36 @@ async function recordAdmittedCorrelation(admitted, correlationId) {
   mutable.correlationId = correlationId;
   mutable.correlationIds = correlationIds;
 }
-async function relocateAdmittedRunToTicket(admitted, authority, heldLease) {
-  if (admitted.ticketNumber === void 0 || !isUnboundRunDirectory(admitted.runDirectory)) return void 0;
-  const oldRunDirectory = admitted.runDirectory;
-  const ledgerHome = resolveActivationLedgerHome(homeFromRunDirectory(oldRunDirectory));
-  const target = roleRunPlacement(ledgerHome, {
-    bookKey: admitted.bookKey,
-    subject: { ticketNumber: admitted.ticketNumber },
-    runId: admitted.runId,
-    role: admitted.role
-  });
-  ensureRoleRunDirectory(ledgerHome, dirname9(target.runDirectory));
-  const principal = authority.seal(target);
-  if (admitted.role !== "diarist") {
-    const childRunIds = readPageSync(oldRunDirectory, "admitted")?.childDiaristRunIds;
-    for (const childRunId of Array.isArray(childRunIds) ? childRunIds : []) {
-      if (typeof childRunId !== "string") continue;
-      const childDirectory = join13(dirname9(oldRunDirectory), formatRunLeaf(childRunId, "diarist"));
-      if (!existsSync2(childDirectory)) continue;
-      const childTarget = roleRunPlacement(ledgerHome, {
-        bookKey: admitted.bookKey,
-        subject: { ticketNumber: admitted.ticketNumber },
-        runId: childRunId,
-        role: "diarist"
+async function relocateRegisteredChildDiarists(input) {
+  const childRunIds = readPageSync(input.parentRunDirectory, "admitted")?.childDiaristRunIds;
+  for (const childRunId of Array.isArray(childRunIds) ? childRunIds : []) {
+    if (typeof childRunId !== "string") continue;
+    const childTarget = roleRunPlacement(input.ledgerHome, {
+      bookKey: input.bookKey,
+      subject: { ticketNumber: input.ticketNumber },
+      runId: childRunId,
+      role: "diarist"
+    });
+    const unboundChildDirectory = roleRunPlacement(input.ledgerHome, {
+      bookKey: input.bookKey,
+      subject: { unbound: true },
+      runId: childRunId,
+      role: "diarist"
+    }).runDirectory;
+    if (existsSync3(unboundChildDirectory)) {
+      input.authority.seal(childTarget);
+      await bindTicketNumberOnRunDirectory(unboundChildDirectory, input.ticketNumber);
+      await rehomeUnboundTicketProvenance(
+        unboundChildDirectory,
+        input.ticketNumber,
+        input.projectRoot,
+        homeFromRunDirectory(input.parentRunDirectory)
+      );
+      ensureRoleRunDirectory(input.ledgerHome, dirname10(childTarget.runDirectory));
+      await rename(unboundChildDirectory, childTarget.runDirectory);
+      relocateTicketProgressForLeg({
+        runDirectory: childTarget.runDirectory
       });
-      authority.seal(childTarget);
-      await bindTicketNumberOnRunDirectory(childDirectory, admitted.ticketNumber);
-      await rehomeUnboundTicketProvenance(childDirectory, admitted.ticketNumber, admitted.projectRoot, homeFromRunDirectory(oldRunDirectory));
-      ensureRoleRunDirectory(ledgerHome, dirname9(childTarget.runDirectory));
-      await rename(childDirectory, childTarget.runDirectory);
       try {
         renderCurrentSync(childTarget.runDirectory);
       } catch (error) {
@@ -14738,18 +14888,71 @@ async function relocateAdmittedRunToTicket(admitted, authority, heldLease) {
 `
         );
       }
+      continue;
+    }
+    if (existsSync3(childTarget.runDirectory)) {
+      relocateTicketProgressForLeg({
+        runDirectory: childTarget.runDirectory
+      });
     }
   }
+}
+async function relocateAdmittedRunToTicket(admitted, authority, heldLease) {
+  if (admitted.ticketNumber === void 0) return void 0;
+  const ledgerHome = resolveActivationLedgerHome(homeFromRunDirectory(admitted.runDirectory));
+  if (!isUnboundRunDirectory(admitted.runDirectory)) {
+    relocateTicketProgressForLeg({
+      runDirectory: admitted.runDirectory
+    });
+    if (admitted.role !== "diarist") {
+      await relocateRegisteredChildDiarists({
+        parentRunDirectory: admitted.runDirectory,
+        bookKey: admitted.bookKey,
+        ticketNumber: admitted.ticketNumber,
+        projectRoot: admitted.projectRoot,
+        ledgerHome,
+        authority
+      });
+    }
+    return void 0;
+  }
+  const oldRunDirectory = admitted.runDirectory;
+  const target = roleRunPlacement(ledgerHome, {
+    bookKey: admitted.bookKey,
+    subject: { ticketNumber: admitted.ticketNumber },
+    runId: admitted.runId,
+    role: admitted.role
+  });
+  ensureRoleRunDirectory(ledgerHome, dirname10(target.runDirectory));
+  authority.seal(target);
+  if (admitted.role !== "diarist") {
+    await relocateRegisteredChildDiarists({
+      parentRunDirectory: oldRunDirectory,
+      bookKey: admitted.bookKey,
+      ticketNumber: admitted.ticketNumber,
+      projectRoot: admitted.projectRoot,
+      ledgerHome,
+      authority
+    });
+  }
   if (admitted.role === "diarist") {
     await rehomeUnboundTicketProvenance(oldRunDirectory, admitted.ticketNumber, admitted.projectRoot, homeFromRunDirectory(oldRunDirectory));
   }
   await rename(oldRunDirectory, target.runDirectory);
   heldLease?.relocate(target.runDirectory);
+  const actualSessionDirectory = sessionDirectoryOf(target.runDirectory);
+  const principal = authority.seal({
+    sessionDirectory: actualSessionDirectory,
+    sessionFile: sessionFileIn(actualSessionDirectory)
+  });
   rewriteAdmittedRoleRunPage(
     admitted,
     [{ oldRunDirectory, newRunDirectory: target.runDirectory }]
   );
   admitted.principal = principal;
+  relocateTicketProgressForLeg({
+    runDirectory: target.runDirectory
+  });
   renderCurrentSync(target.runDirectory);
   return { oldRunDirectory, newRunDirectory: target.runDirectory };
 }
@@ -14785,7 +14988,7 @@ async function recordLaunchedPiIdentity(runDirectory, identity) {
 async function observeLaunchedRolePackageIdentity(packageRoot2, selectedRoleEntry) {
   const rolePackageRoot = packageRoot2;
   const raw = JSON.parse(
-    await readFile8(join13(rolePackageRoot, "package.json"), "utf8")
+    await readFile8(join14(rolePackageRoot, "package.json"), "utf8")
   );
   if (typeof raw.version !== "string" || raw.version.trim() === "") {
     throw new Error(
@@ -15343,7 +15546,7 @@ async function admitPublicRole(role, parsed, env, override) {
             resolutionScope: [...derived.resolutionScope],
             authorizedChecks: []
           });
-          const mergerInputPath = join13(placed.runDirectory, "merger-input.json");
+          const mergerInputPath = join14(placed.runDirectory, "merger-input.json");
           await writeFile2(
             mergerInputPath,
             `${JSON.stringify(mergerInput, null, 2)}
@@ -15611,7 +15814,7 @@ function parseDoctorIssueNumber(raw) {
 }
 async function resolveDoctorCaseRunsPath(options) {
   const ledgerHome = resolveActivationLedgerHome(options.home);
-  const defaultRuns = join13(
+  const defaultRuns = join14(
     activationBookDirectory(ledgerHome, options.bookKey),
     String(options.issueNumber),
     "runs"
@@ -15684,11 +15887,11 @@ function parseAnalystCohortIssueToken(raw, flag) {
       `${flag} requires a comma-separated list of N or book:N`
     );
   }
-  const sep5 = trimmed.lastIndexOf(":");
-  if (sep5 > 0) {
-    const rhs = trimmed.slice(sep5 + 1);
+  const sep6 = trimmed.lastIndexOf(":");
+  if (sep6 > 0) {
+    const rhs = trimmed.slice(sep6 + 1);
     if (parseTicketNumber(rhs) !== void 0) {
-      const bookKey = trimmed.slice(0, sep5);
+      const bookKey = trimmed.slice(0, sep6);
       if (bookKey.trim() === "") {
         throw new CliUsageError(
           `${flag} book:N requires a non-empty book key, got ${raw}`
@@ -15885,6 +16088,7 @@ var init_invocation = __esm({
     init_activation_ledger_topology();
     init_activation_ledger_git();
     init_role_run_placement();
+    init_ticket_progress();
     init_packaged_role_registry();
     init_run_ticket_number();
     init_role_run_relocation();
@@ -16096,6 +16300,7 @@ var init_submission_ledger = __esm({
     init_report_ticket_tool();
     init_review_submission();
     init_run_ticket_number();
+    init_ticket_progress();
     init_unknown_value();
   }
 });
@@ -16266,7 +16471,7 @@ var init_engine_detour_usage = __esm({
 });
 
 // src/dossier-resolution.ts
-import { existsSync as existsSync3, statSync as statSync5 } from "node:fs";
+import { existsSync as existsSync4, statSync as statSync5 } from "node:fs";
 import { resolve as resolve9 } from "node:path";
 function isHostContext(value) {
   return "sessionManager" in value;
@@ -16286,7 +16491,7 @@ function resolveAuditDossier(source) {
   }
   const runDirectory = resolve9(raw);
   try {
-    if (!existsSync3(runDirectory) || !statSync5(runDirectory).isDirectory()) {
+    if (!existsSync4(runDirectory) || !statSync5(runDirectory).isDirectory()) {
       return { status: "incomplete", observation: { kind: "missing-dossier" } };
     }
   } catch {
@@ -17488,12 +17693,12 @@ var init_settlement = __esm({
 });
 
 // src/external-host-turn-loop.ts
-import { existsSync as existsSync4 } from "node:fs";
-import { basename as basename8 } from "node:path";
+import { existsSync as existsSync5 } from "node:fs";
+import { basename as basename9 } from "node:path";
 async function syncTurnRequestLivePlacement(request, authority) {
   const live = await resolveLiveRunDirectoryPath(request.runDirectory, request.home);
   if (live === void 0) {
-    const parsed = parseRunLeaf(basename8(request.runDirectory));
+    const parsed = parseRunLeaf(basename9(request.runDirectory));
     throw new Error(
       `admitted run ${parsed?.runId ?? "(unparseable)"} missing after host turn; not found under ${request.home}`
     );
@@ -17505,7 +17710,7 @@ async function syncTurnRequestLivePlacement(request, authority) {
 }
 async function retainPackageFaultBesideLivePlacement(request, input) {
   let runDirectory = request.runDirectory;
-  if (!existsSync4(runDirectory)) {
+  if (!existsSync5(runDirectory)) {
     try {
       const found = await resolveLiveRunDirectoryPath(request.runDirectory, request.home);
       if (found === void 0) {
@@ -17553,9 +17758,9 @@ var init_external_host_turn_loop = __esm({
 });
 
 // src/session-identity.ts
-import { dirname as dirname10, join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 function createSessionIdentityAuthority(authority, hostName) {
-  const runDirectoryOf = (principal) => dirname10(authority.decode(principal).sessionDirectory);
+  const runDirectoryOf = (principal) => runDirectoryFromSessionDirectory(authority.decode(principal).sessionDirectory);
   return {
     principalAuthority: authority,
     resolveSessionFile(principal) {
@@ -17563,7 +17768,7 @@ function createSessionIdentityAuthority(authority, hostName) {
     },
     async load(principal) {
       const runDirectory = runDirectoryOf(principal);
-      const { records, diagnostics } = await readSitianRecords(join14(runDirectory, RUN_STATE_FILE));
+      const { records, diagnostics } = await readSitianRecords(join15(runDirectory, RUN_STATE_FILE));
       if (diagnostics.length > 0) {
         throw new Error(
           `${RUN_STATE_FILE} has ${diagnostics.length} malformed row(s); refusing stale session binding: ${runDirectory}`
@@ -17610,6 +17815,7 @@ var init_session_identity = __esm({
   "src/session-identity.ts"() {
     "use strict";
     init_host_descriptions();
+    init_role_run_placement();
     init_run_dossier();
     init_sitian_facade();
     init_unknown_value();
@@ -17632,14 +17838,14 @@ __export(role_turn_host_exports, {
 });
 import { execFile as execFile2, spawn } from "node:child_process";
 import { constants as constants2 } from "node:fs";
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync6 } from "node:fs";
 import { access as access2, appendFile, realpath as realpath4 } from "node:fs/promises";
-import { delimiter, dirname as dirname11, isAbsolute as isAbsolute6, join as join15, resolve as resolve10 } from "node:path";
+import { delimiter, dirname as dirname11, isAbsolute as isAbsolute6, join as join16, resolve as resolve10 } from "node:path";
 import { platform } from "node:process";
 import { promisify as promisify2 } from "node:util";
 import { randomUUID as randomUUID4 } from "node:crypto";
 function resolveInternalRoleEntrypoint(packageRoot2) {
-  return join15(packageRoot2, INTERNAL_ROLE_ENTRYPOINT_RELATIVE2);
+  return join16(packageRoot2, INTERNAL_ROLE_ENTRYPOINT_RELATIVE2);
 }
 function buildExplicitInternalActivationArgs(selectedRoleEntry, extraArgs = []) {
   return ["--no-extensions", "-e", selectedRoleEntry, ...extraArgs];
@@ -17829,7 +18035,7 @@ function createDefaultPiSpawnRunner(options) {
                   homeFromRunDirectory(spawnDir)
                 );
               } catch (resolveError) {
-                runDirectory = existsSync5(spawnDir) ? spawnDir : void 0;
+                runDirectory = existsSync6(spawnDir) ? spawnDir : void 0;
                 const resolveDiagnostic = `live run path resolve failed beside Pi transport fault: ${describeErrorIdentity(resolveError)}`;
                 if (runDirectory !== void 0) {
                   await retainPackageFault({
@@ -17882,7 +18088,8 @@ function createPiRoleTurnHost(config) {
         config.extraPiArgs ?? []
       );
       const args = buildExplicitInternalActivationArgs(roleEntry, extraArgs);
-      const stdin = encodeUserDialogueStdin(piUserDialogueBody(turnRequest));
+      const transportBody = piUserDialogueBody(turnRequest);
+      const stdin = encodeUserDialogueStdin(transportBody);
       const env = {
         ...process.env,
         HOME: request.home,
@@ -17898,6 +18105,7 @@ function createPiRoleTurnHost(config) {
       else env.AK_ROLE_INVOCATION_SCOPE = request.invocationScopeId;
       if (request.host === void 0 || request.host.trim() === "") delete env.AK_ROLE_HOST;
       else env.AK_ROLE_HOST = request.host.trim();
+      delete env.AK_ROLE_SUMMONS_INSTRUCTION;
       if (request.deliveryRequestLimit === void 0) delete env[RECEIPT_DELIVERY_LIMIT_ENV];
       else env[RECEIPT_DELIVERY_LIMIT_ENV] = String(request.deliveryRequestLimit);
       applyEngineChildEnv(env, request.engine);
@@ -18030,17 +18238,17 @@ var init_role_turn_host = __esm({
 });
 
 // src/public-cli/load-production-acp-host.ts
-import { existsSync as existsSync6 } from "node:fs";
-import { join as join16 } from "node:path";
+import { existsSync as existsSync7 } from "node:fs";
+import { join as join17 } from "node:path";
 import { pathToFileURL } from "node:url";
 async function loadProductionAcpHostFactory(packageRoot2, host) {
   const description = lookupHostDescription(host);
   if (description === void 0) {
     throw new Error(`unregistered host: ${host}`);
   }
-  const built = join16(packageRoot2, "dist/acp-host/production-host.js");
-  const source = join16(packageRoot2, "src/acp-host/production-host.ts");
-  const target = existsSync6(built) ? built : source;
+  const built = join17(packageRoot2, "dist/acp-host/production-host.js");
+  const source = join17(packageRoot2, "src/acp-host/production-host.ts");
+  const target = existsSync7(built) ? built : source;
   const href = pathToFileURL(target).href;
   const mod = await import(href);
   const create = mod.createProductionAcpRoleTurnHost;
@@ -18054,17 +18262,17 @@ var init_load_production_acp_host = __esm({
 });
 
 // src/public-cli/load-production-headless-host.ts
-import { existsSync as existsSync7 } from "node:fs";
-import { join as join17 } from "node:path";
+import { existsSync as existsSync8 } from "node:fs";
+import { join as join18 } from "node:path";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 async function loadProductionHeadlessHostFactory(packageRoot2, host) {
   const description = lookupHeadlessHostDescription(host);
   if (description === void 0) {
     throw new Error(`unregistered headless host: ${host}`);
   }
-  const built = join17(packageRoot2, "dist/headless-host/production-host.js");
-  const source = join17(packageRoot2, "src/headless-host/production-host.ts");
-  const target = existsSync7(built) ? built : source;
+  const built = join18(packageRoot2, "dist/headless-host/production-host.js");
+  const source = join18(packageRoot2, "src/headless-host/production-host.ts");
+  const target = existsSync8(built) ? built : source;
   const href = pathToFileURL2(target).href;
   const mod = await import(href);
   const create = mod.createProductionHeadlessRoleTurnHost;
@@ -18231,14 +18439,14 @@ var init_role_seat_runtime = __esm({
 });
 
 // src/session-opening-materials.ts
-import { existsSync as existsSync8 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import { readFile as readFile9 } from "node:fs/promises";
-import { dirname as dirname12, join as join18 } from "node:path";
+import { dirname as dirname12, join as join19 } from "node:path";
 import { fileURLToPath, pathToFileURL as pathToFileURL3 } from "node:url";
 function resolvePackageRootDir(moduleUrl = import.meta.url) {
   let dir = dirname12(fileURLToPath(moduleUrl));
   for (let i = 0; i < 8; i += 1) {
-    if (existsSync8(join18(dir, "package.json")) && existsSync8(join18(dir, "souls"))) {
+    if (existsSync9(join19(dir, "package.json")) && existsSync9(join19(dir, "souls"))) {
       return dir;
     }
     const parent = dirname12(dir);
@@ -18537,7 +18745,7 @@ __export(auditor_soul_exports, {
   readAuditorResumeBinding: () => readAuditorResumeBinding,
   resolveAuditorSubject: () => resolveAuditorSubject
 });
-import { basename as basename9 } from "node:path";
+import { basename as basename10 } from "node:path";
 function auditorSoulRelativePath(role) {
   return `souls/${role}-auditor.md`;
 }
@@ -18573,7 +18781,7 @@ function loadAuditorReferenceMaterialsFromSubjectInput(raw) {
   return loadAuditorReferenceMaterials(resolveAuditorSubject(raw));
 }
 function subjectFromSourceDirectory(sourceRunDirectory) {
-  const role = parseRunLeaf(basename9(sourceRunDirectory))?.role;
+  const role = parseRunLeaf(basename10(sourceRunDirectory))?.role;
   return isAuditorSoulRole(role) ? role : void 0;
 }
 async function readAuditorResumeBinding(admitted) {
@@ -18942,7 +19150,8 @@ function projectRoleTurnRequest(admitted, roleDetails, options) {
     ...options.invocationScopeId === void 0 || options.invocationScopeId.length === 0 ? {} : { invocationScopeId: options.invocationScopeId },
     ...options.stationChild === void 0 ? {} : { stationChild: options.stationChild },
     ...options.navigatorByStatusPrepare === void 0 ? {} : { navigatorByStatusPrepare: options.navigatorByStatusPrepare },
-    ...options.deliveryRequestLimit === void 0 ? {} : { deliveryRequestLimit: options.deliveryRequestLimit }
+    ...options.deliveryRequestLimit === void 0 ? {} : { deliveryRequestLimit: options.deliveryRequestLimit },
+    ...options.host === void 0 || options.host.trim() === "" ? {} : { host: options.host.trim() }
   };
 }
 function packagedSettleSkill(admitted) {
@@ -19336,7 +19545,7 @@ async function resolveReviewSeatDialogueBody(input) {
   if (sourceRunPath === void 0) return void 0;
   return await loadLedgerPeerBody(sourceRunPath, input.projectRoot, input.home);
 }
-async function resolveInitialPrompt(admitted, env) {
+async function resolveInitialTurnPrompt(admitted, env) {
   const record = roleRecord(admitted.role);
   if ("reaskPrompt" in record && record.reaskPrompt === true) {
     const sourceRunPath = admittedSourceRunPath(admitted);
@@ -19433,7 +19642,7 @@ async function dispatchAdmitted(admitted, env, io) {
     if (activeEnv.correlationId !== void 0 && activeEnv.correlationId.trim() !== "") {
       await recordAdmittedCorrelation(admitted, activeEnv.correlationId);
     }
-    const initialPromptText = await resolveInitialPrompt(admitted, activeEnv);
+    const initialPrompt = await resolveInitialTurnPrompt(admitted, activeEnv);
     const auto = "inCallAutoResume" in record && record.inCallAutoResume === true;
     if (auto) {
       return await runPostAdmissionResumable({
@@ -19444,14 +19653,14 @@ async function dispatchAdmitted(admitted, env, io) {
           admitted,
           roleTurnOptions(activeEnv, admitted, {
             kind: "initial",
-            prompt: initialPromptText
+            prompt: initialPrompt
           })
         ),
         buildResumeRequest: () => buildInstructionSeatTurnRequest(
           admitted,
           roleTurnOptions(activeEnv, admitted, {
             kind: "resume",
-            prompt: initialPromptText
+            prompt: initialPrompt
           })
         ),
         adapters,
@@ -19466,7 +19675,7 @@ async function dispatchAdmitted(admitted, env, io) {
         admitted,
         roleTurnOptions(activeEnv, admitted, {
           kind: "initial",
-          prompt: initialPromptText
+          prompt: initialPrompt
         })
       ),
       adapters,
@@ -19642,7 +19851,7 @@ async function runCountersignBody(parsed, env, io) {
       }
       const turnProjection = roleTurnOptions(env, admitted, {
         kind: "initial",
-        prompt: await resolveInitialPrompt(admitted, env)
+        prompt: await resolveInitialTurnPrompt(admitted, env)
       });
       const turnRequest = buildInstructionSeatTurnRequest(admitted, turnProjection);
       const result = await runPostAdmissionOneShot({
@@ -20498,9 +20707,9 @@ __export(public_role_summons_exports, {
   summonPublicRole: () => summonPublicRole
 });
 import { execFile as execFile3 } from "node:child_process";
-import { existsSync as existsSync9 } from "node:fs";
+import { existsSync as existsSync10 } from "node:fs";
 import { realpath as realpath5 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { join as join21 } from "node:path";
 import { promisify as promisify3 } from "node:util";
 function createCapturingIo() {
   const chunks = [];
@@ -20524,7 +20733,7 @@ function parentDir(path) {
 function walkPackageRoot(start) {
   let dir = start;
   for (let i = 0; i < 12; i += 1) {
-    if (existsSync9(join20(dir, "package.json")) && existsSync9(join20(dir, "souls"))) {
+    if (existsSync10(join21(dir, "package.json")) && existsSync10(join21(dir, "souls"))) {
       return dir;
     }
     const parent = parentDir(dir);
@@ -21066,7 +21275,7 @@ var init_compliance_transport = __esm({
 });
 
 // src/role-run-relocation.ts
-import { dirname as dirname14, join as join21 } from "node:path";
+import { dirname as dirname14, join as join22 } from "node:path";
 async function retainedRunPathsMatch(recordedPath, currentPath, currentRunDirectory) {
   if (recordedPath === currentPath) return true;
   if (typeof recordedPath !== "string") return false;
@@ -21132,9 +21341,9 @@ __export(run_lifecycle_exports, {
   resolveLiveRunDirectoryPath: () => resolveLiveRunDirectoryPath,
   writeRoleRunState: () => writeRoleRunState
 });
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 import { chmod, lstat as lstat3, open, readdir as readdir3, readFile as readFile10, unlink } from "node:fs/promises";
-import { basename as basename10, join as join22 } from "node:path";
+import { basename as basename11, join as join23 } from "node:path";
 async function writeRoleRunState(runDirectory, record) {
   const payload = { ...record, runDirectory };
   writeSectionSync(runDirectory, "runState", { ...payload });
@@ -21216,13 +21425,14 @@ async function readRoleRunStateDisk(runDirectory) {
   if (typeof record.sessionDirectory !== "string") throw new TypeError("Invalid state.jsonl run-state");
   const storedRunDirectory = typeof record.runDirectory === "string" && record.runDirectory.trim() !== "" ? record.runDirectory : runDirectory;
   const runDir = runDirectory;
+  const principalCoords = {
+    sessionDirectory: record.sessionDirectory,
+    ...typeof record.sessionFile === "string" ? { sessionFile: record.sessionFile } : {}
+  };
+  rewritePrincipalSessionPaths(principalCoords, storedRunDirectory, runDirectory);
   const principalWire = {
-    sessionDirectory: rewriteRunDirectoryPathValue(
-      record.sessionDirectory,
-      storedRunDirectory,
-      runDirectory
-    ),
-    ...typeof record.sessionFile === "string" ? { sessionFile: rewriteRunDirectoryPathValue(record.sessionFile, storedRunDirectory, runDirectory) } : {}
+    sessionDirectory: principalCoords.sessionDirectory,
+    ...typeof principalCoords.sessionFile === "string" ? { sessionFile: principalCoords.sessionFile } : {}
   };
   const phase = record.phase === "plan" || record.phase === "apply" ? record.phase : void 0;
   const currentCourt = parseCurrentCourtState(record.currentCourt);
@@ -21428,7 +21638,7 @@ async function createWriterLease(lockPath, runDirectory, reportCleanupFailure) {
     },
     relocate(nextRunDirectory) {
       currentRunDirectory = nextRunDirectory;
-      currentLockPath = join22(nextRunDirectory, WRITER_LOCK_FILE);
+      currentLockPath = join23(nextRunDirectory, WRITER_LOCK_FILE);
     },
     async release() {
       if (released) return;
@@ -21467,10 +21677,10 @@ async function acquireRunWriterLease(runDirectory, onCleanupFailure) {
   };
   const reportReadFailure = (error) => {
     reportDiagnostic(
-      `writer lease lock read failed (holder liveness unverifiable; lock left in place) at ${join22(runDirectory, WRITER_LOCK_FILE)}: ${describeErrorIdentity(error)}`
+      `writer lease lock read failed (holder liveness unverifiable; lock left in place) at ${join23(runDirectory, WRITER_LOCK_FILE)}: ${describeErrorIdentity(error)}`
     );
   };
-  const lockPath = join22(runDirectory, WRITER_LOCK_FILE);
+  const lockPath = join23(runDirectory, WRITER_LOCK_FILE);
   let lastAutopsy = { verdict: "absent" };
   let lastReclaimFailure;
   for (let reclaimsLeft = WRITER_LEASE_RECLAIM_ROUNDS; ; reclaimsLeft -= 1) {
@@ -21526,7 +21736,7 @@ async function acquireRunWriterLease(runDirectory, onCleanupFailure) {
 }
 async function findRunDirectoryById(home, runId, onlyBookKey, onlyRole, knownRunDirectory) {
   if (typeof knownRunDirectory === "string" && knownRunDirectory.trim() !== "") {
-    const parsed = parseRunLeaf(basename10(knownRunDirectory));
+    const parsed = parseRunLeaf(basename11(knownRunDirectory));
     if (parsed === void 0 || parsed.runId !== runId) {
       throw new CliUsageError(
         `run directory does not match run id ${runId}: ${knownRunDirectory}`
@@ -21536,7 +21746,7 @@ async function findRunDirectoryById(home, runId, onlyBookKey, onlyRole, knownRun
   }
   if (runId.trim() === "") return void 0;
   const ledgerHome = resolveActivationLedgerHome(home);
-  const booksRoot = join22(ledgerHome, "books");
+  const booksRoot = join23(ledgerHome, "books");
   let bookKeys;
   try {
     bookKeys = await readdir3(booksRoot);
@@ -21551,8 +21761,8 @@ async function findRunDirectoryById(home, runId, onlyBookKey, onlyRole, knownRun
   );
 }
 async function resolveLiveRunDirectoryPath(recordedPath, home, onlyBookKey) {
-  if (existsSync10(recordedPath)) return recordedPath;
-  const parsed = parseRunLeaf(basename10(recordedPath));
+  if (existsSync11(recordedPath)) return recordedPath;
+  const parsed = parseRunLeaf(basename11(recordedPath));
   const bookKey = onlyBookKey ?? tryBookKeyFromAkRolesPath(recordedPath);
   if (parsed === void 0 || bookKey === void 0) return void 0;
   return findRunDirectoryById(home, parsed.runId, bookKey, parsed.role);
@@ -21586,7 +21796,7 @@ async function findLatestRunForSeatTicket(input) {
   let runDirectories;
   try {
     runDirectories = await listBookRunDirectories(
-      input.ticketNumber === void 0 ? bookDir : join22(bookDir, String(input.ticketNumber))
+      input.ticketNumber === void 0 ? bookDir : join23(bookDir, String(input.ticketNumber))
     );
   } catch (error) {
     if (errorCodeOf(error) === "ENOENT") return void 0;
@@ -21594,7 +21804,7 @@ async function findLatestRunForSeatTicket(input) {
   }
   let best;
   for (const runDirectory of runDirectories) {
-    const parsed = parseRunLeaf(basename10(runDirectory));
+    const parsed = parseRunLeaf(basename11(runDirectory));
     if (parsed === void 0 || parsed.role !== input.role) continue;
     const runId = parsed.runId;
     const parentPath = await readRunParentPath(runDirectory);
@@ -29325,10 +29535,10 @@ var init_analyst_book_key = __esm({
 // src/atomic-write.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
 import { rename as rename2, rm, writeFile as writeFile4 } from "node:fs/promises";
-import { dirname as dirname15, join as join23 } from "node:path";
+import { dirname as dirname15, join as join24 } from "node:path";
 async function writeFileAtomically(destination, contents, options) {
   const parent = dirname15(destination);
-  const temporary = join23(parent, `.atomic-write-${randomUUID6()}.tmp`);
+  const temporary = join24(parent, `.atomic-write-${randomUUID6()}.tmp`);
   try {
     await writeFile4(temporary, contents, options);
     await rename2(temporary, destination);
@@ -29345,12 +29555,12 @@ var init_atomic_write = __esm({
 
 // src/analyst-index.ts
 import { open as open2, readFile as readFile11, unlink as unlink2 } from "node:fs/promises";
-import { dirname as dirname16, join as join24 } from "node:path";
+import { dirname as dirname16, join as join25 } from "node:path";
 import { setTimeout as sleep } from "node:timers/promises";
 async function withAnalystLibraryIndexLock(ledgerHome, fn) {
   const indexPath = analystLibraryIndexPath(ledgerHome);
   ensureRealDirectoryTree(ledgerHome, dirname16(indexPath));
-  const lockPath = join24(dirname16(indexPath), LIBRARY_INDEX_LOCK_NAME);
+  const lockPath = join25(dirname16(indexPath), LIBRARY_INDEX_LOCK_NAME);
   assertLedgerFileInsideHome(lockPath, ledgerHome);
   const startedAt = Date.now();
   while (true) {
@@ -29377,7 +29587,7 @@ async function withAnalystLibraryIndexLock(ledgerHome, fn) {
   }
 }
 function analystLibraryIndexPath(ledgerHome) {
-  return join24(ledgerHome, "analyst", "library-index.json");
+  return join25(ledgerHome, "analyst", "library-index.json");
 }
 function rowFromIssueMetricsPage(page) {
   return {
@@ -29671,7 +29881,7 @@ var init_analyst_cohort = __esm({
 });
 
 // src/archivist-record-pointer.ts
-import { basename as basename11, join as join25 } from "node:path";
+import { basename as basename12, join as join26 } from "node:path";
 async function resolveOfficerPointer(raw, parentRunDirectory) {
   const where = `${parentRunDirectory} officers`;
   if (!isRecord(raw) || raw.kind !== DIRECT_OFFICER_RUN_POINTER_KIND || raw.version !== 1) {
@@ -29684,7 +29894,7 @@ async function resolveOfficerPointer(raw, parentRunDirectory) {
   let runDirectory = typeof raw.runDirectory === "string" && raw.runDirectory.trim() !== "" ? raw.runDirectory : void 0;
   let sessionFile = raw.sessionFile;
   const recordedRunDirectory = runDirectory ?? runDirectoryOfSessionFile(sessionFile);
-  const leaf = parseRunLeaf(basename11(recordedRunDirectory));
+  const leaf = parseRunLeaf(basename12(recordedRunDirectory));
   const parentIdentity = await readRoleRunIdentity(parentRunDirectory);
   if (leaf !== void 0 && parentIdentity !== void 0) {
     const currentRunDirectory = await resolveLiveRunDirectoryPath(
@@ -29704,7 +29914,7 @@ async function resolveOfficerPointer(raw, parentRunDirectory) {
   };
 }
 async function readBookedOfficerPointers(parentRunDirectory) {
-  const { records, diagnostics } = await readSitianRecords(join25(parentRunDirectory, RUN_HISTORY_FILE));
+  const { records, diagnostics } = await readSitianRecords(join26(parentRunDirectory, RUN_HISTORY_FILE));
   if (diagnostics.length > 0) {
     throw new Error(
       `${RUN_HISTORY_FILE} has ${diagnostics.length} malformed row(s); officer pointers unreadable: ${parentRunDirectory}`
@@ -29987,7 +30197,7 @@ var init_analyst_gate_cycles_read = __esm({
 
 // src/analyst-ledger.ts
 import { readdir as readdir4 } from "node:fs/promises";
-import { basename as basename12, join as join26 } from "node:path";
+import { basename as basename13, join as join27 } from "node:path";
 async function readExistingRunLifecycleState(runDirectory) {
   return (await readRoleRunIdentity(runDirectory))?.state;
 }
@@ -30007,7 +30217,7 @@ function ghostLeaseCheckFromAutopsy(autopsy) {
   }
 }
 async function classifyGhostCandidate(input) {
-  const autopsy = await autopsyWriterLock(join26(input.runDirectory, "writer.lock"));
+  const autopsy = await autopsyWriterLock(join27(input.runDirectory, "writer.lock"));
   const leaseCheck = ghostLeaseCheckFromAutopsy(autopsy);
   if (leaseCheck === void 0) return { kind: "live" };
   return {
@@ -30297,7 +30507,7 @@ async function classifyScopedRun(input) {
 async function scanAnalystIssueRuns(input) {
   const ledgerHome = resolveActivationLedgerHome(input.home);
   const scopeTicketNumber = input.ticketNumber;
-  const booksRoot = join26(ledgerHome, "books");
+  const booksRoot = join27(ledgerHome, "books");
   let wholeBook = false;
   let scopeRootIdentity;
   let bookNames;
@@ -30330,7 +30540,7 @@ async function scanAnalystIssueRuns(input) {
   const ghostLegs = [];
   const scopeConflicts = [];
   for (const book of bookNames) {
-    const bookDir = join26(booksRoot, book);
+    const bookDir = join27(booksRoot, book);
     let runDirectories;
     try {
       runDirectories = await listBookRunDirectories(bookDir);
@@ -30339,7 +30549,7 @@ async function scanAnalystIssueRuns(input) {
       throw error;
     }
     for (const runDirectory of runDirectories) {
-      const runName = basename12(runDirectory);
+      const runName = basename13(runDirectory);
       const parsed = parseRunLeaf(runName);
       if (parsed === void 0) continue;
       let scopeFields;
@@ -31076,7 +31286,7 @@ var init_analyst_metric_family = __esm({
 });
 
 // src/analyst-page.ts
-import { dirname as dirname17, join as join27 } from "node:path";
+import { dirname as dirname17, join as join28 } from "node:path";
 function analystIssuePageKey(address) {
   const parts = ["book", address.bookKey];
   if (address.issueNumber !== void 0) {
@@ -31087,7 +31297,7 @@ function analystIssuePageKey(address) {
   return sha256Hex(parts.join("\0")).slice(0, 32);
 }
 function analystIssuePagePath(ledgerHome, address) {
-  return join27(ledgerHome, "analyst", "issues", `${analystIssuePageKey(address)}.json`);
+  return join28(ledgerHome, "analyst", "issues", `${analystIssuePageKey(address)}.json`);
 }
 function analystIssuePageAddressFromPage(page) {
   return {
@@ -32634,13 +32844,13 @@ var init_cli = __esm({
 });
 
 // src/public-cli/main.ts
-import { existsSync as existsSync11 } from "node:fs";
-import { dirname as dirname18, join as join28 } from "node:path";
+import { existsSync as existsSync12 } from "node:fs";
+import { dirname as dirname18, join as join29 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var here = dirname18(fileURLToPath2(import.meta.url));
 function resolvePackageRoot(binDir) {
-  const canonical = join28(binDir, "..", "..");
-  if (existsSync11(join28(canonical, "package.json"))) {
+  const canonical = join29(binDir, "..", "..");
+  if (existsSync12(join29(canonical, "package.json"))) {
     return canonical;
   }
   return binDir;