@akagilnc/pi-workflow-roles 0.1.5478 → 0.1.5504

package/dist/analyst-gate-cycles-read.js

@@ -1,10 +1,8 @@
 /**
  * Sole nested-volume reader for gate-cycle facts under session/auditor-roles/.
  *
- * Consumers: Analyst sole ledger scan (classifyScopedRun) and Terminal gate
- * projection (#478). Metric families must not open a second disk scan — they
- * consume retained facts. Terminal settlement reuses this same pairing seam
- * (no second auditor-roles scanner).
+ * Consumer: Analyst sole ledger scan (classifyScopedRun). Metric families must
+ * not open a second disk scan — they consume retained facts.
  *
  * Naming: records may carry pre-#440 menxia/jishizhong/fubaolang tool faces or
  * the current gatekeeper/inspector/notary English face. Projection always uses
@@ -29,7 +27,10 @@ import { readdir } from "node:fs/promises";
 import { join } from "node:path";
 import { AUDITOR_PARENT_ATTEMPT_BINDING_ENTRY_TYPE, } from "./compliance-transport.js";
 import { extractSessionTimestampSpan, intervalRowsAroundAnchor, readLedgerSessionJsonl, } from "./ledger-session-read.js";
-import { isRecord, errorText, isEnoent } from "./unknown-value.js";
+import { isRecord, isEnoent } from "./unknown-value.js";
+import { retainedRunPathsMatch } from "./role-run-relocation.js";
+import { runDirectoryOfSessionFile } from "./role-run-placement.js";
+import { resolveOfficerSessionFromPointerFile } from "./archivist-record-pointer.js";
 const DISPATCH_TOOLS = new Set(["ak_menxia_output", "ak_gatekeeper_output"]);
 /** Officer terminating tool → current English officer identity. */
 const OFFICER_TOOL_TO_FACE = {
@@ -309,27 +310,6 @@ function pairGateRounds(volumes) {
         .sort((a, b) => a.officerStartedAt.localeCompare(b.officerStartedAt))
         .map((round, index) => ({ ...round, roundIndex: index + 1 }));
 }
-/** Resolve a direct-officer-run-pointer file to the officer session 正本 path. */
-async function resolveOfficerSessionFromPointerFile(pointerPath) {
-    const { readFile } = await import("node:fs/promises");
-    let raw;
-    try {
-        raw = JSON.parse(await readFile(pointerPath, "utf8"));
-    }
-    catch (error) {
-        throw new Error(`direct officer run pointer unreadable in ${pointerPath}: ${errorText(error)}`, { cause: error });
-    }
-    if (!isRecord(raw) || raw.kind !== "direct-officer-run-pointer" || raw.version !== 1) {
-        throw new Error(`direct officer run pointer has unknown shape in ${pointerPath}`);
-    }
-    const sessionFile = raw.sessionFile;
-    if (typeof sessionFile !== "string" || sessionFile.trim() === "") {
-        throw new Error(`direct officer run pointer missing sessionFile in ${pointerPath}`);
-    }
-    const officer = raw.officer === "inspector" || raw.officer === "notary"
-        ? raw.officer : undefined;
-    return { sessionFile, ...(officer === undefined ? {} : { officer }) };
-}
 /**
  * Read and pair gate-cycle rounds from one or more auditor-roles directories.
  * Accepts historical nested JSONL volumes and #675 direct-officer-run-pointer
@@ -346,7 +326,7 @@ export async function readAnalystGateCyclesFromAuditorRoles(auditorRolesDirector
     const volumes = [];
     // Same officer session pointed at N times (historical multi-mint pointers, or
     // one parent booking many leaves) must classify once — else each accepted
-    // seal is counted ×N in terminal gate-round (#753 acceptance A).
+    // seal is counted ×N in gate-cycle statistics (#753 acceptance A).
     const classifiedOfficerSessions = new Set();
     for (const directory of directories) {
         let names;
@@ -375,11 +355,13 @@ export async function readAnalystGateCyclesFromAuditorRoles(auditorRolesDirector
                     continue;
                 classifiedOfficerSessions.add(sessionPath);
             }
-            const classified = await classifyAuditorVolume(sessionPath, pointer?.officer);
+            const officer = pointer?.officer === "inspector" || pointer?.officer === "notary"
+                ? pointer.officer : undefined;
+            const classified = await classifyAuditorVolume(sessionPath, officer);
             for (const volume of classified) {
                 if (options.parentSessionFile !== undefined &&
                     volume.parentSessionFile !== undefined &&
-                    volume.parentSessionFile !== options.parentSessionFile) {
+                    !await retainedRunPathsMatch(volume.parentSessionFile, options.parentSessionFile, runDirectoryOfSessionFile(options.parentSessionFile))) {
                     continue;
                 }
                 volumes.push(volume);

package/dist/analyst-ledger.js

@@ -16,9 +16,11 @@ import { readdir, readFile } from "node:fs/promises";
 import { basename, join } from "node:path";
 import { isSyntheticAnalystBookKey, resolveAnalystBookKey } from "./analyst-book-key.js";
 import { pathContainedIn, physicalPathIdentity, resolveActivationLedgerHome, } from "./activation-ledger-topology.js";
-import { listBookRunDirectories } from "./role-run-placement.js";
+import { listBookRunDirectories, parseRunLeaf, sessionFileOf, } from "./role-run-placement.js";
+import { sitianRunVolumeDirectory } from "./sitian-appender.js";
 import { autopsyWriterLock, readRoleRunIdentity } from "./public-cli/run-lifecycle.js";
 import { readRunTicketNumber } from "./run-ticket-number.js";
+import { rewriteRunDirectoryPathValue } from "./role-run-relocation.js";
 import { extractSessionModelSequence, extractSessionTimestampSpan, extractSessionToolIntervals, LedgerSessionJsonlError, readLedgerSessionJsonl, } from "./ledger-session-read.js";
 import { readRunTerminalArtifact, } from "./run-terminal-artifacts.js";
 import { readAnalystGateCyclesFromAuditorRoles, } from "./analyst-gate-cycles-read.js";
@@ -65,12 +67,6 @@ async function classifyGhostCandidate(input) {
         },
     };
 }
-function parseRunDirectoryName(name) {
-    const at = name.lastIndexOf("@");
-    if (at <= 0 || at === name.length - 1)
-        return undefined;
-    return { runId: name.slice(0, at), role: name.slice(at + 1) };
-}
 async function listLedgerBookNames(booksRoot) {
     try {
         const entries = await readdir(booksRoot, { withFileTypes: true });
@@ -136,14 +132,16 @@ async function resolveSessionFile(runDirectory) {
         if (isRecord(parsed)
             && typeof parsed.sessionFile === "string"
             && parsed.sessionFile.trim() !== "") {
-            return parsed.sessionFile;
+            return typeof parsed.runDirectory === "string"
+                ? rewriteRunDirectoryPathValue(parsed.sessionFile, parsed.runDirectory, runDirectory)
+                : parsed.sessionFile;
         }
     }
     catch (error) {
         if (!isMissingPathError(error))
             throw error;
     }
-    return join(runDirectory, "session", "session.jsonl");
+    return sessionFileOf(runDirectory);
 }
 /**
  * Attribute session rows to one run.
@@ -394,8 +392,8 @@ async function classifyScopedRun(input) {
     // nested JSONL is page-local unreadable — never silently under-count rounds.
     let gateCycles;
     try {
-        const parentSessionFile = join(input.runDirectory, "session", "session.jsonl");
-        gateCycles = await readAnalystGateCyclesFromAuditorRoles(join(input.runDirectory, "session", "auditor-roles"), { parentSessionFile });
+        const parentSessionFile = sessionFileOf(input.runDirectory);
+        gateCycles = await readAnalystGateCyclesFromAuditorRoles(sitianRunVolumeDirectory(input.runDirectory, "auditor-roles"), { parentSessionFile });
     }
     catch (error) {
         return {
@@ -497,7 +495,7 @@ export async function scanAnalystIssueRuns(input) {
         }
         for (const runDirectory of runDirectories) {
             const runName = basename(runDirectory);
-            const parsed = parseRunDirectoryName(runName);
+            const parsed = parseRunLeaf(runName);
             if (parsed === undefined)
                 continue;
             let scopeFields;

package/dist/archivist-record-entry.js

@@ -25,6 +25,7 @@ import {
   resolveNavigatorWorkSubjectPlacement
 } from "./archivist-record-topology.js";
 import { piRecordSessionHost } from "./pi/record-session-host.js";
+import { sitianVolumeDirectory } from "./sitian-appender.js";
 import {
   DIRECT_OFFICER_RUN_POINTER_KIND,
   bookDirectOfficerRunPointer
@@ -35,7 +36,7 @@ import {
 } from "./archivist-record-topology.js";
 const CURRENT_SESSION_LEDGER = "current-session.json";
 function readCurrentSession(sessionDir) {
-  const ledger = join(sessionDir, CURRENT_SESSION_LEDGER);
+  const ledger = currentSessionLedgerPath(sessionDir);
   try {
     const value = JSON.parse(readFileSync(ledger, "utf8"));
     if (typeof value !== "object" || value === null || typeof value.sessionFile !== "string" || value.sessionFile.length === 0) {
@@ -50,7 +51,7 @@ function readCurrentSession(sessionDir) {
   }
 }
 function writeCurrentSession(sessionDir, sessionFile) {
-  const ledger = join(sessionDir, CURRENT_SESSION_LEDGER);
+  const ledger = currentSessionLedgerPath(sessionDir);
   try {
     writeFileSync(ledger, `${JSON.stringify({ sessionFile })}
 `, { flag: "wx" });
@@ -268,7 +269,7 @@ function createRecordSessionOpen(options, host = piRecordSessionHost) {
     if (!physicallyContainedIn(ledgerHome, parentResolved)) {
       throw new Error("Durable record ownership requires a parent session inside the ledger home");
     }
-    sessionDir = join(dirname(parentResolved), options.kind);
+    sessionDir = sitianVolumeDirectory(dirname(parentResolved), options.kind);
     parentSession = parentFile;
     mayResumeSameNest = options.kind === WORKER_SUBMISSION_GATE_KIND;
   }

package/dist/archivist-record-pointer.js

@@ -1,9 +1,17 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { isRecord } from "./unknown-value.js";
+import { basename, dirname, join } from "node:path";
+import { isRecord, errorText } from "./unknown-value.js";
+import { homeFromRunDirectory } from "./activation-ledger-topology.js";
+import { findRunDirectoryById, readRoleRunIdentity } from "./public-cli/run-lifecycle.js";
+import { rewriteRunDirectoryPathValue } from "./role-run-relocation.js";
+import { parseRunLeaf, runDirectoryOfSessionFile, runDirectoryFromSessionDirectory } from "./role-run-placement.js";
+import { sitianVolumeDirectory } from "./sitian-appender.js";
 /** Typed parent-side pointer to an independent officer run 正本 (ADR 0079 / #675). */
 export const DIRECT_OFFICER_RUN_POINTER_KIND = "direct-officer-run-pointer";
+function directOfficerRunPointerFile(parentSessionFile, officer) {
+    return join(sitianVolumeDirectory(dirname(parentSessionFile), "auditor-roles"), `${officer}.pointer.json`);
+}
 /**
  * Book a typed pointer under parent session/auditor-roles (same nest owner as
  * createRecordSession). Never fabricates user/assistant/toolResult rows (#675).
@@ -11,11 +19,11 @@ export const DIRECT_OFFICER_RUN_POINTER_KIND = "direct-officer-run-pointer";
  *
  * Stable leaf per officer under one parent (#753 gate-round accounting):
  * same-parent re-summons upsert the same pointer instead of minting N files that
- * each re-scan the full officer session and multiply terminal gate-round counts.
+ * each re-scan the full officer session and multiply gate-cycle counts.
  */
 export function bookDirectOfficerRunPointer(options) {
-    const nest = join(dirname(options.parentSessionFile), "auditor-roles");
-    mkdirSync(nest, { recursive: true });
+    const pointerFile = directOfficerRunPointerFile(options.parentSessionFile, options.officer);
+    mkdirSync(dirname(pointerFile), { recursive: true });
     const submissionToolCallId = options.submissionToolCallId?.trim() ?? "";
     const pointer = {
         version: 1,
@@ -27,38 +35,57 @@ export function bookDirectOfficerRunPointer(options) {
             : {}),
         ...(submissionToolCallId === "" ? {} : { submissionToolCallId }),
     };
-    writeFileSync(join(nest, `${options.officer}.pointer.json`), `${JSON.stringify(pointer)}\n`, "utf8");
+    writeFileSync(pointerFile, `${JSON.stringify(pointer)}\n`, "utf8");
     return pointer;
 }
-/**
- * Read the one officer pointer. Missing or unreadable is not a pass:
- * the caller re-runs the gate.
- */
-export async function readDirectOfficerRunPointer(parentSessionFile, officer) {
+/** Shared strict pointer IO; internal audit wraps unreadability as a re-summons. */
+export async function resolveOfficerSessionFromPointerFile(pointerPath) {
+    let raw;
     try {
-        const raw = JSON.parse(await readFile(join(dirname(parentSessionFile), "auditor-roles", `${officer}.pointer.json`), "utf8"));
-        if (!isRecord(raw) || raw.kind !== DIRECT_OFFICER_RUN_POINTER_KIND || raw.version !== 1) {
-            return undefined;
+        raw = JSON.parse(await readFile(pointerPath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`direct officer run pointer unreadable in ${pointerPath}: ${errorText(error)}`, { cause: error });
+    }
+    if (!isRecord(raw) || raw.kind !== DIRECT_OFFICER_RUN_POINTER_KIND || raw.version !== 1) {
+        throw new Error(`direct officer run pointer has unknown shape in ${pointerPath}`);
+    }
+    if (typeof raw.sessionFile !== "string" || raw.sessionFile.trim() === "") {
+        throw new Error(`direct officer run pointer missing sessionFile in ${pointerPath}`);
+    }
+    const officer = raw.officer === "inspector" || raw.officer === "notary"
+        || raw.officer === "auditor" || raw.officer === "countersign" ? raw.officer : undefined;
+    let runDirectory = typeof raw.runDirectory === "string" && raw.runDirectory.trim() !== ""
+        ? raw.runDirectory : undefined;
+    let sessionFile = raw.sessionFile;
+    const recordedRunDirectory = runDirectory ?? runDirectoryOfSessionFile(sessionFile);
+    const leaf = parseRunLeaf(basename(recordedRunDirectory));
+    const parentRunDirectory = runDirectoryFromSessionDirectory(dirname(dirname(pointerPath)));
+    const parentIdentity = await readRoleRunIdentity(parentRunDirectory);
+    if (leaf !== undefined && parentIdentity !== undefined) {
+        const currentRunDirectory = await findRunDirectoryById(homeFromRunDirectory(parentRunDirectory), leaf.runId, parentIdentity.bookKey, leaf.role);
+        if (currentRunDirectory !== undefined) {
+            sessionFile = rewriteRunDirectoryPathValue(sessionFile, recordedRunDirectory, currentRunDirectory);
+            if (runDirectory !== undefined)
+                runDirectory = currentRunDirectory;
         }
-        if (raw.officer !== officer)
-            return undefined;
-        if (typeof raw.sessionFile !== "string" || raw.sessionFile.trim() === "")
+    }
+    const submissionToolCallId = typeof raw.submissionToolCallId === "string"
+        && raw.submissionToolCallId.trim() !== "" ? raw.submissionToolCallId : undefined;
+    return {
+        sessionFile,
+        ...(officer === undefined ? {} : { officer }),
+        ...(runDirectory === undefined ? {} : { runDirectory }),
+        ...(submissionToolCallId === undefined ? {} : { submissionToolCallId }),
+    };
+}
+/** Missing or unreadable is not a pass: the internal audit caller re-runs the gate. */
+export async function readDirectOfficerRunPointer(parentSessionFile, officer) {
+    try {
+        const pointer = await resolveOfficerSessionFromPointerFile(directOfficerRunPointerFile(parentSessionFile, officer));
+        if (pointer.officer !== officer)
             return undefined;
-        const runDirectory = typeof raw.runDirectory === "string" && raw.runDirectory.trim() !== ""
-            ? raw.runDirectory
-            : undefined;
-        const submissionToolCallId = typeof raw.submissionToolCallId === "string"
-            && raw.submissionToolCallId.trim() !== ""
-            ? raw.submissionToolCallId
-            : undefined;
-        return {
-            version: 1,
-            kind: DIRECT_OFFICER_RUN_POINTER_KIND,
-            officer,
-            sessionFile: raw.sessionFile,
-            ...(runDirectory === undefined ? {} : { runDirectory }),
-            ...(submissionToolCallId === undefined ? {} : { submissionToolCallId }),
-        };
+        return { ...pointer, officer, version: 1, kind: DIRECT_OFFICER_RUN_POINTER_KIND };
     }
     catch {
         return undefined;

package/dist/atomic-write.js

@@ -1,11 +1,11 @@
 import { randomUUID } from "node:crypto";
 import { rename, rm, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
-async function writeFileAtomically(destination, contents) {
+async function writeFileAtomically(destination, contents, options) {
   const parent = dirname(destination);
   const temporary = join(parent, `.atomic-write-${randomUUID()}.tmp`);
   try {
-    await writeFile(temporary, contents);
+    await writeFile(temporary, contents, options);
     await rename(temporary, destination);
   } catch (error) {
     await rm(temporary, { force: true }).catch(() => void 0);

package/dist/auditor-dossier-tool.js

@@ -1,11 +1,15 @@
-import { dirname, join, resolve } from "node:path";
-import { roleRunArtifactsDirectory } from "./role-run-placement.js";
+import { join, resolve } from "node:path";
+import {
+  roleRunArtifactsDirectory,
+  runDirectoryOfSessionFile,
+  sessionFileOf
+} from "./role-run-placement.js";
 import { Type } from "typebox";
 const AUDITOR_DOSSIER_TOOL_NAME = "ak_get_run_dossier";
 function auditorRunDirectory(context) {
   const sessionFile = context.sessionManager?.getSessionFile?.();
   if (sessionFile === void 0) return void 0;
-  return resolve(dirname(dirname(sessionFile)));
+  return resolve(runDirectoryOfSessionFile(sessionFile));
 }
 function createAuditorDossierTool(runDirectory) {
   return {
@@ -24,7 +28,7 @@ function createAuditorDossierTool(runDirectory) {
       const details = {
         runDirectory,
         admittedRequest: join(runDirectory, "admitted-request.json"),
-        parentSessionCandidate: join(runDirectory, "session", "session.jsonl"),
+        parentSessionCandidate: sessionFileOf(runDirectory),
         attachments: join(runDirectory, "attachments"),
         artifacts: roleRunArtifactsDirectory(runDirectory)
       };

package/dist/auditor-soul.js

@@ -1,5 +1,6 @@
 import { readFile } from "node:fs/promises";
 import { basename, join } from "node:path";
+import { parseRunLeaf } from "./role-run-placement.js";
 import { isRecord } from "./unknown-value.js";
 import { joinPackageMaterials, readPackageMaterial, } from "./session-opening-materials.js";
 /**
@@ -84,7 +85,7 @@ export function loadAuditorReferenceMaterialsFromSubjectInput(raw) {
     return loadAuditorReferenceMaterials(resolveAuditorSubject(raw));
 }
 function subjectFromSourceDirectory(sourceRunDirectory) {
-    const role = basename(sourceRunDirectory).split("@")[1];
+    const role = parseRunLeaf(basename(sourceRunDirectory))?.role;
     return isAuditorSoulRole(role) ? role : undefined;
 }
 /**

package/dist/collector-config.js

@@ -1,6 +1,7 @@
 import { readFile } from "node:fs/promises";
 import { sha256Hex } from "./sha256.js";
 import { isRecord } from "./unknown-value.js";
+import { isTicketNumberString, parseTicketNumber } from "./run-ticket-number.js";
 export const COLLECTOR_OWNER_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$/;
 export const COLLECTOR_REPO_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,98}[A-Za-z0-9])?$/;
 function fail(message, cause) {
@@ -30,13 +31,13 @@ export function parseCollectorRepository(raw) {
     return { display: raw, canonical: `${owner}/${repo}`, owner, repo };
 }
 export function parseCollectorPrNumber(raw) {
-    if (typeof raw === "string" && !/^[1-9][0-9]*$/.test(raw))
-        fail("Collector pull request number must be a positive safe integer string");
     if (typeof raw !== "string" && typeof raw !== "number")
         fail("Collector pull request number is required");
-    const value = Number(raw);
-    if (!Number.isSafeInteger(value) || value < 1)
-        fail("Collector pull request number must be a positive safe integer");
+    const value = parseTicketNumber(raw);
+    if (value === undefined)
+        fail(typeof raw === "string" && !isTicketNumberString(raw)
+            ? "Collector pull request number must be a positive safe integer string"
+            : "Collector pull request number must be a positive safe integer");
     return value;
 }
 function canonicalManifest(requests) {

package/dist/doctor-evidence.js

@@ -1,6 +1,7 @@
 import { readdir, readFile, realpath, stat } from "node:fs/promises";
 import { dirname, relative, resolve, sep } from "node:path";
 import { sha256Hex } from "./sha256.js";
+import { physicallyContainedIn } from "./activation-ledger-topology.js";
 import { AcceptedDetailsContractError, acceptedFacts, isTerminatingToolName, validateAcceptedDetails } from "./package-contracts/terminating-tools.js";
 import { isRecord, isMissingPathError } from "./unknown-value.js";
 async function discoverCaseFiles(root) { const found = []; async function walk(dir, depth) { for (const item of await readdir(dir, { withFileTypes: true })) {
@@ -106,8 +107,11 @@ function deriveSession(content, id) {
     return { session, turns, calls, tokens, statuses, commits };
 }
 /** Read Pi's retained session directory as the sole raw material for one case. */
-export async function loadDoctorCase(runsPath) {
+export async function loadDoctorCase(runsPath, projectRoot) {
     const root = await realpath(runsPath);
+    if (projectRoot !== undefined && !physicallyContainedIn(projectRoot, root)) {
+        throw new Error("doctor --runs escapes the project root");
+    }
     // Canonical <book>/<ticket>/runs; legacy issues/<n>/runs remains read-only compatible.
     const match = root.split(sep).join("/").match(/\/\.ak-roles\/books\/[^/]+\/(?:issues\/)?([1-9]\d*)\/runs$/);
     if (!match)

package/dist/engine-detour-usage.js

@@ -17,8 +17,10 @@
  */
 import { randomUUID } from "node:crypto";
 import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { join } from "node:path";
+export { runDirectoryFromSessionDirectory, sessionFileIn as sessionFileFromSessionDirectory, } from "./role-run-placement.js";
 import { ENGINE_DETOUR_TOOL_NAME } from "./engine-detour.js";
+import { sitianRunVolumeDirectory, sitianVolumeRecordsFile } from "./sitian-appender.js";
 import { readSitianRecords, resolveSitianRecordPath, sitianReport, } from "./sitian-facade.js";
 import { isRecord } from "./unknown-value.js";
 /** Sitian event kind for one detour-tool call (volume under session/). */
@@ -30,7 +32,7 @@ export const ENGINE_DETOUR_TOOL_USAGE_FACT_KEY = "engineDetourToolUsage";
  * Openable once the run directory is known from the terminal's run id.
  * Contains no runId bytes itself (#108 + #537).
  */
-export const ENGINE_DETOUR_CALL_RECORD_FILE_RELATIVE = `session/${ENGINE_DETOUR_CALL_KIND}/records.jsonl`;
+export const ENGINE_DETOUR_CALL_RECORD_FILE_RELATIVE = sitianVolumeRecordsFile(sitianRunVolumeDirectory("", ENGINE_DETOUR_CALL_KIND));
 /** stdout UTF-8 byte length (ticket-frozen metric; empty stdout is real 0). */
 export function engineDetourStdoutByteLength(stdout) {
     return Buffer.byteLength(stdout, "utf8");
@@ -212,14 +214,6 @@ export function withEngineDetourToolUsageFact(outcome, usage) {
         },
     };
 }
-/** runDirectory owning a session directory (.../runs/<id>@role/session). */
-export function runDirectoryFromSessionDirectory(sessionDirectory) {
-    return dirname(sessionDirectory);
-}
-/** session.jsonl under a session directory. */
-export function sessionFileFromSessionDirectory(sessionDirectory) {
-    return join(sessionDirectory, "session.jsonl");
-}
 /**
  * Mint one public-invocation scope id.
  * Call once at the public-entry boundary — never inside the auto-resume loop.