@akagilnc/pi-workflow-roles 0.1.1883 → 0.1.1918

package/dist/public-cli/main.js

@@ -14873,6 +14873,69 @@ var init_sitian_role_run_coordinates = __esm({
   }
 });
 
+// src/ticket-frontmatter.ts
+function parseTicketNumberFrontmatter(bytes) {
+  let text;
+  if (typeof bytes === "string") {
+    text = bytes;
+  } else {
+    try {
+      text = exactUtf8(bytes, "ticket face");
+    } catch {
+      return void 0;
+    }
+  }
+  let cursor;
+  if (text.startsWith("---\n")) {
+    cursor = 4;
+  } else if (text.startsWith("---\r\n")) {
+    cursor = 5;
+  } else {
+    return void 0;
+  }
+  const fmLines = [];
+  let closed = false;
+  while (cursor < text.length) {
+    const nl = text.indexOf("\n", cursor);
+    const lineEnd = nl === -1 ? text.length : nl;
+    let line2 = text.slice(cursor, lineEnd);
+    if (line2.endsWith("\r")) line2 = line2.slice(0, -1);
+    if (line2 === "---") {
+      closed = true;
+      break;
+    }
+    fmLines.push(line2);
+    if (nl === -1) break;
+    cursor = nl + 1;
+  }
+  if (!closed) return void 0;
+  let found;
+  for (const line2 of fmLines) {
+    const match = /^[ \t]*ticketNumber[ \t]*:[ \t]*(\d+)[ \t]*$/.exec(line2);
+    if (match === null) continue;
+    const value = Number(match[1]);
+    if (!Number.isInteger(value) || value < 1) return void 0;
+    if (found !== void 0 && found !== value) return void 0;
+    found = value;
+  }
+  return found;
+}
+function resolveTicketNumberFromAttachmentBodies(bodies) {
+  const found = /* @__PURE__ */ new Set();
+  for (const body of bodies) {
+    const value = parseTicketNumberFrontmatter(body);
+    if (value !== void 0) found.add(value);
+  }
+  if (found.size !== 1) return void 0;
+  return found.values().next().value;
+}
+var init_ticket_frontmatter = __esm({
+  "src/ticket-frontmatter.ts"() {
+    "use strict";
+    init_exact_utf8();
+  }
+});
+
 // src/audit-escalation.ts
 function isAuditEscalationResult(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
@@ -15338,7 +15401,9 @@ async function writeRoleInvocationLedger(source, role) {
     projectRoot: source.projectRoot,
     runDirectory: source.runDirectory,
     sessionDirectory: source.sessionDirectory,
-    sessionFile: source.sessionFile
+    sessionFile: source.sessionFile,
+    ...source.correlationId === void 0 ? {} : { correlationId: source.correlationId },
+    ...source.ticketNumber === void 0 ? {} : { ticketNumber: source.ticketNumber }
   };
   await writeFile2(
     join5(source.runDirectory, "invocation.json"),
@@ -15568,13 +15633,37 @@ async function freezeRegularFileAttachment(sourcePath, destinationDir, index) {
   const frozenPath = join5(destinationDir, name);
   await writeFile2(frozenPath, bytes);
   return {
-    provenancePath: absolute,
-    frozenPath,
-    byteLength: bytes.byteLength,
-    sha256: sha256Hex(bytes),
-    mediaKind: "regular-file"
+    attachment: {
+      provenancePath: absolute,
+      frozenPath,
+      byteLength: bytes.byteLength,
+      sha256: sha256Hex(bytes),
+      mediaKind: "regular-file"
+    },
+    body: bytes
   };
 }
+async function freezeAttachmentsWithTicketNumber(attachmentPaths, attachmentsDirectory) {
+  const attachments = [];
+  const bodies = [];
+  for (let i = 0; i < attachmentPaths.length; i += 1) {
+    const frozen = await freezeRegularFileAttachment(
+      attachmentPaths[i],
+      attachmentsDirectory,
+      i
+    );
+    attachments.push(frozen.attachment);
+    bodies.push(frozen.body);
+  }
+  const ticketNumber = resolveTicketNumberFromAttachmentBodies(bodies);
+  return {
+    attachments,
+    ...ticketNumber === void 0 ? {} : { ticketNumber }
+  };
+}
+function ticketAdmissionFields(ticketNumber) {
+  return ticketNumber === void 0 ? {} : { ticketNumber };
+}
 async function admitJudgeInvocation(options) {
   if (options.project !== void 0) {
     requireOptionPath("--project", options.project);
@@ -15585,16 +15674,11 @@ async function admitJudgeInvocation(options) {
   const attachmentsDirectory = join5(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
-  const attachments = [];
-  for (let i = 0; i < options.attachmentPaths.length; i += 1) {
-    attachments.push(
-      await freezeRegularFileAttachment(
-        options.attachmentPaths[i],
-        attachmentsDirectory,
-        i
-      )
-    );
-  }
+  const { attachments, ticketNumber } = await freezeAttachmentsWithTicketNumber(
+    options.attachmentPaths,
+    attachmentsDirectory
+  );
+  const ticketFields = ticketAdmissionFields(ticketNumber);
   const instruction = options.instruction;
   const instructionEmpty = instruction.trim() === "";
   const admitted = {
@@ -15605,6 +15689,7 @@ async function admitJudgeInvocation(options) {
     runDirectory,
     sessionDirectory,
     sessionFile,
+    ...ticketFields,
     instruction,
     instructionEmpty,
     attachments: attachments.map((a) => ({
@@ -15630,7 +15715,8 @@ async function admitJudgeInvocation(options) {
     runDirectory,
     sessionDirectory,
     sessionFile,
-    admittedRequestPath
+    admittedRequestPath,
+    ...ticketFields
   };
 }
 function buildJudgeTransportPrompt(admitted) {
@@ -15668,16 +15754,11 @@ async function admitCoderInvocation(options) {
   const attachmentsDirectory = join5(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
-  const attachments = [];
-  for (let i = 0; i < options.attachmentPaths.length; i += 1) {
-    attachments.push(
-      await freezeRegularFileAttachment(
-        options.attachmentPaths[i],
-        attachmentsDirectory,
-        i
-      )
-    );
-  }
+  const { attachments, ticketNumber } = await freezeAttachmentsWithTicketNumber(
+    options.attachmentPaths,
+    attachmentsDirectory
+  );
+  const ticketFields = ticketAdmissionFields(ticketNumber);
   const taskPath = join5(runDirectory, "task.md");
   await writeFile2(taskPath, instruction, "utf8");
   const admitted = {
@@ -15689,6 +15770,7 @@ async function admitCoderInvocation(options) {
     runDirectory,
     sessionDirectory,
     sessionFile,
+    ...ticketFields,
     instruction,
     instructionEmpty: false,
     taskPath,
@@ -15717,7 +15799,8 @@ async function admitCoderInvocation(options) {
     sessionDirectory,
     sessionFile,
     admittedRequestPath,
-    taskPath
+    taskPath,
+    ...ticketFields
   };
 }
 function buildCoderTransportPrompt(admitted) {
@@ -15744,29 +15827,12 @@ async function admitFixerInvocation(options) {
   if (options.phase !== "plan" && options.phase !== "apply") {
     throw new CliUsageError("fixer phase must be plan or apply");
   }
-  const projectRoot = resolve4(options.project ?? options.cwd);
-  const runId = (options.createRunId ?? uuidv7)();
-  const { ledgerHome, bookKey, runDirectory, sessionDirectory, sessionFile } = roleRunSessionCoordinates({ cwd: projectRoot, runId, role: "fixer", home: options.home });
-  const attachmentsDirectory = join5(runDirectory, "attachments");
-  ensureRealDirectoryTree(ledgerHome, sessionDirectory);
-  ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
-  const attachments = [];
-  for (let i = 0; i < options.attachmentPaths.length; i += 1) {
-    attachments.push(
-      await freezeRegularFileAttachment(
-        options.attachmentPaths[i],
-        attachmentsDirectory,
-        i
-      )
-    );
-  }
   let prerequisites = Object.freeze([]);
-  let prerequisitesPath;
+  let prerequisitesSource;
   if (options.prerequisitesPath !== void 0) {
     const absolutePrereq = isAbsolute3(options.prerequisitesPath) ? options.prerequisitesPath : resolve4(options.prerequisitesPath);
-    let source;
     try {
-      source = await readFile4(absolutePrereq, "utf8");
+      prerequisitesSource = await readFile4(absolutePrereq, "utf8");
     } catch (error) {
       throw new CliUsageError(
         `fixer prerequisites path is unreadable: ${options.prerequisitesPath}`,
@@ -15774,13 +15840,27 @@ async function admitFixerInvocation(options) {
       );
     }
     try {
-      prerequisites = parseFixerPrerequisites(source);
+      prerequisites = parseFixerPrerequisites(prerequisitesSource);
     } catch (error) {
       if (error instanceof FixerPacketValidationError) {
         throw new CliUsageError(error.message, { cause: error });
       }
       throw error;
     }
+  }
+  const projectRoot = resolve4(options.project ?? options.cwd);
+  const runId = (options.createRunId ?? uuidv7)();
+  const { ledgerHome, bookKey, runDirectory, sessionDirectory, sessionFile } = roleRunSessionCoordinates({ cwd: projectRoot, runId, role: "fixer", home: options.home });
+  const attachmentsDirectory = join5(runDirectory, "attachments");
+  ensureRealDirectoryTree(ledgerHome, sessionDirectory);
+  ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
+  const { attachments, ticketNumber } = await freezeAttachmentsWithTicketNumber(
+    options.attachmentPaths,
+    attachmentsDirectory
+  );
+  const ticketFields = ticketAdmissionFields(ticketNumber);
+  let prerequisitesPath;
+  if (prerequisitesSource !== void 0) {
     prerequisitesPath = join5(runDirectory, "prerequisites.json");
     await writeFile2(
       prerequisitesPath,
@@ -15800,6 +15880,7 @@ async function admitFixerInvocation(options) {
     runDirectory,
     sessionDirectory,
     sessionFile,
+    ...ticketFields,
     instruction,
     instructionEmpty: false,
     packetPath,
@@ -15835,7 +15916,8 @@ async function admitFixerInvocation(options) {
     admittedRequestPath,
     packetPath,
     ...prerequisitesPath === void 0 ? {} : { prerequisitesPath },
-    prerequisites
+    prerequisites,
+    ...ticketFields
   };
 }
 function buildFixerTransportPrompt(admitted) {
@@ -16003,34 +16085,32 @@ async function admitCollectorInvocation(options) {
   } else {
     repository = resolveGitHubRemoteRepository(projectRoot);
   }
-  const runId = (options.createRunId ?? uuidv7)();
-  const { ledgerHome, bookKey, runDirectory, sessionDirectory, sessionFile } = roleRunSessionCoordinates({ cwd: projectRoot, runId, role: "collector", home: options.home });
-  const attachmentsDirectory = join5(runDirectory, "attachments");
-  ensureRealDirectoryTree(ledgerHome, sessionDirectory);
-  ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
-  const attachments = [];
-  const attachmentPaths = options.attachmentPaths ?? [];
-  for (let i = 0; i < attachmentPaths.length; i += 1) {
-    attachments.push(
-      await freezeRegularFileAttachment(
-        attachmentPaths[i],
-        attachmentsDirectory,
-        i
-      )
-    );
-  }
   let manifest = emptyCollectorManifest();
-  let requestManifestPath;
+  let manifestCanonicalJson;
   if (options.requestManifestPath !== void 0) {
     try {
       manifest = await loadCollectorManifest(options.requestManifestPath);
+      manifestCanonicalJson = manifest.canonicalJson;
     } catch (error) {
       throw new CliUsageError(error instanceof Error ? error.message : String(error), { cause: error });
     }
-    requestManifestPath = join5(runDirectory, "request-manifest.json");
-    await writeFile2(requestManifestPath, manifest.canonicalJson, "utf8");
   }
   const manifestDigest = manifest.digest;
+  const runId = (options.createRunId ?? uuidv7)();
+  const { ledgerHome, bookKey, runDirectory, sessionDirectory, sessionFile } = roleRunSessionCoordinates({ cwd: projectRoot, runId, role: "collector", home: options.home });
+  const attachmentsDirectory = join5(runDirectory, "attachments");
+  ensureRealDirectoryTree(ledgerHome, sessionDirectory);
+  ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
+  const { attachments, ticketNumber } = await freezeAttachmentsWithTicketNumber(
+    options.attachmentPaths ?? [],
+    attachmentsDirectory
+  );
+  const ticketFields = ticketAdmissionFields(ticketNumber);
+  let requestManifestPath;
+  if (manifestCanonicalJson !== void 0) {
+    requestManifestPath = join5(runDirectory, "request-manifest.json");
+    await writeFile2(requestManifestPath, manifestCanonicalJson, "utf8");
+  }
   const instruction = options.instruction ?? "";
   const instructionEmpty = instruction.trim() === "";
   const admitted = {
@@ -16041,6 +16121,7 @@ async function admitCollectorInvocation(options) {
     runDirectory,
     sessionDirectory,
     sessionFile,
+    ...ticketFields,
     instruction,
     instructionEmpty,
     prNumber,
@@ -16079,7 +16160,8 @@ async function admitCollectorInvocation(options) {
     prNumber,
     repository,
     ...requestManifestPath === void 0 ? {} : { requestManifestPath },
-    manifestDigest
+    manifestDigest,
+    ...ticketFields
   };
 }
 function buildCollectorTransportPrompt(_admitted) {
@@ -16276,17 +16358,11 @@ async function admitDoctorInvocation(options) {
   const attachmentsDirectory = join5(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
-  const attachments = [];
-  const attachmentPaths = options.attachmentPaths ?? [];
-  for (let i = 0; i < attachmentPaths.length; i += 1) {
-    attachments.push(
-      await freezeRegularFileAttachment(
-        attachmentPaths[i],
-        attachmentsDirectory,
-        i
-      )
-    );
-  }
+  const { attachments, ticketNumber } = await freezeAttachmentsWithTicketNumber(
+    options.attachmentPaths ?? [],
+    attachmentsDirectory
+  );
+  const ticketFields = ticketAdmissionFields(ticketNumber);
   const instruction = options.instruction ?? "";
   const instructionEmpty = instruction.trim() === "";
   const admitted = {
@@ -16297,6 +16373,7 @@ async function admitDoctorInvocation(options) {
     runDirectory,
     sessionDirectory,
     sessionFile,
+    ...ticketFields,
     instruction,
     instructionEmpty,
     issueNumber: options.issueNumber,
@@ -16332,7 +16409,8 @@ async function admitDoctorInvocation(options) {
     admittedRequestPath,
     issueNumber: options.issueNumber,
     caseRunsPath,
-    caseIdentity: caseIdentity2
+    caseIdentity: caseIdentity2,
+    ...ticketFields
   };
 }
 function buildDoctorTransportPrompt(admitted) {
@@ -16402,16 +16480,11 @@ async function admitReviewerInvocation(options) {
   const attachmentsDirectory = join5(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
-  const attachments = [];
-  for (let i = 0; i < options.attachmentPaths.length; i += 1) {
-    attachments.push(
-      await freezeRegularFileAttachment(
-        options.attachmentPaths[i],
-        attachmentsDirectory,
-        i
-      )
-    );
-  }
+  const { attachments, ticketNumber } = await freezeAttachmentsWithTicketNumber(
+    options.attachmentPaths,
+    attachmentsDirectory
+  );
+  const ticketFields = ticketAdmissionFields(ticketNumber);
   const instruction = options.instruction;
   const instructionEmpty = instruction.trim() === "";
   const admitted = {
@@ -16422,6 +16495,7 @@ async function admitReviewerInvocation(options) {
     runDirectory,
     sessionDirectory,
     sessionFile,
+    ...ticketFields,
     instruction,
     instructionEmpty,
     baseRevision: options.baseRevision,
@@ -16453,7 +16527,8 @@ async function admitReviewerInvocation(options) {
     sessionDirectory,
     sessionFile,
     admittedRequestPath,
-    baseRevision: options.baseRevision
+    baseRevision: options.baseRevision,
+    ...ticketFields
   };
 }
 function buildReviewerTransportPrompt(admitted) {
@@ -16555,16 +16630,11 @@ async function admitMergerInvocation(options) {
   const attachmentsDirectory = join5(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
-  const attachments = [];
-  for (let i = 0; i < options.attachmentPaths.length; i += 1) {
-    attachments.push(
-      await freezeRegularFileAttachment(
-        options.attachmentPaths[i],
-        attachmentsDirectory,
-        i
-      )
-    );
-  }
+  const { attachments, ticketNumber } = await freezeAttachmentsWithTicketNumber(
+    options.attachmentPaths,
+    attachmentsDirectory
+  );
+  const ticketFields = ticketAdmissionFields(ticketNumber);
   const targetIntent = mergerMaterialFromUtf8(
     `Investigate primary sources for target parent ${derived.targetObjectId}. Do not invent intent.`
   );
@@ -16604,6 +16674,7 @@ async function admitMergerInvocation(options) {
     runDirectory,
     sessionDirectory,
     sessionFile,
+    ...ticketFields,
     instruction,
     instructionEmpty: false,
     mergerInputPath,
@@ -16643,7 +16714,8 @@ async function admitMergerInvocation(options) {
     sessionFile,
     admittedRequestPath,
     mergerInputPath,
-    derived: admitted.derived
+    derived: admitted.derived,
+    ...ticketFields
   };
 }
 function buildMergerTransportPrompt(admitted) {
@@ -16666,6 +16738,7 @@ var init_invocation = __esm({
     init_activation_ledger_topology();
     init_activation_ledger_git();
     init_sitian_role_run_coordinates();
+    init_ticket_frontmatter();
     init_doctor_evidence();
     init_collector_config();
     init_fixer_packet();
@@ -16779,6 +16852,27 @@ var init_reviewer_dispatch = __esm({
   }
 });
 
+// src/upstream-error-testimony.ts
+function isNonSuccessHttpStatus(status) {
+  return typeof status === "number" && (status < 200 || status >= 300);
+}
+function hasUpstreamErrorTestimony(input) {
+  if (isNonSuccessHttpStatus(input.httpStatus)) return true;
+  return Array.isArray(input.diagnostics) && input.diagnostics.length > 0;
+}
+function projectConfirmedRemotePayload(input) {
+  return {
+    ...input.body === void 0 ? {} : { body: input.body },
+    ...input.code === void 0 ? {} : { code: input.code },
+    ...input.errno === void 0 ? {} : { errno: input.errno }
+  };
+}
+var init_upstream_error_testimony = __esm({
+  "src/upstream-error-testimony.ts"() {
+    "use strict";
+  }
+});
+
 // src/public-cli/explicit-internal.ts
 import { execFile as execFile3, spawn } from "node:child_process";
 import { constants, writeFileSync } from "node:fs";
@@ -16837,21 +16931,37 @@ function resolveInternalRoleEntrypoint(packageRoot2) {
 function buildExplicitInternalActivationArgs(selectedRoleEntry, extraArgs = []) {
   return ["--no-extensions", "-e", selectedRoleEntry, ...extraArgs];
 }
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+function sessionStopDetails(input) {
+  const details = {};
+  const errorMessage = nonEmptyString(input.errorMessage);
+  if (errorMessage !== void 0) details.errorMessage = errorMessage;
+  const api = nonEmptyString(input.api);
+  if (api !== void 0) details.api = api;
+  const rawStopReason = nonEmptyString(input.rawStopReason);
+  if (rawStopReason !== void 0) details.rawStopReason = rawStopReason;
+  const testimony = hasUpstreamErrorTestimony(input);
+  if (testimony) {
+    const provider = nonEmptyString(input.provider);
+    if (provider !== void 0) details.provider = provider;
+    const model = nonEmptyString(input.model);
+    if (model !== void 0) details.model = model;
+  }
+  if (typeof input.httpStatus === "number") details.httpStatus = input.httpStatus;
+  if (input.diagnostics !== void 0) details.diagnostics = input.diagnostics;
+  if (testimony) Object.assign(details, projectConfirmedRemotePayload(input));
+  return details;
+}
 function knownFailureFromProviderStop(input) {
-  if (input.stopReason !== "error") return void 0;
-  const diagnostic = typeof input.errorMessage === "string" && input.errorMessage.trim() !== "" ? input.errorMessage.trim() : "provider failure";
-  const identity = {
-    name: "ProviderStopError"
-  };
-  if (typeof input.provider === "string" && input.provider.trim() !== "") {
-    identity.code = input.provider;
-  } else if (typeof input.model === "string" && input.model.trim() !== "") {
-    identity.code = input.model;
-  }
+  if (input.stopReason !== "error" && input.stopReason !== "aborted") return void 0;
+  const diagnostic = nonEmptyString(input.errorMessage);
+  const details = sessionStopDetails(input);
   return {
-    cause: "provider",
-    identity,
-    diagnostic
+    cause: hasUpstreamErrorTestimony(input) ? "provider" : "unrecognized",
+    ...diagnostic === void 0 ? {} : { diagnostic },
+    ...Object.keys(details).length === 0 ? {} : { details }
   };
 }
 async function resolveSelectedPi(command, cwd, env) {
@@ -16915,6 +17025,8 @@ var init_explicit_internal = __esm({
     init_invocation();
     init_registry2();
     init_reviewer_dispatch();
+    init_upstream_error_testimony();
+    init_upstream_error_testimony();
     REVIEWER_DISPATCH_REJECTION_FILE = "typed-known-failure.json";
     execFileAsync3 = promisify3(execFile3);
     defaultExplicitInternalPiRunner = async (args, options) => {
@@ -17237,12 +17349,9 @@ var init_public_run_credentials = __esm({
   }
 });
 
-// src/public-cli/run-lifecycle.ts
-import { lstat as lstat2, open, readdir as readdir2, readFile as readFile7, unlink as unlink2, writeFile as writeFile3 } from "node:fs/promises";
+// src/typed-provider-http.ts
+import { readFile as readFile7, unlink as unlink2, writeFile as writeFile3 } from "node:fs/promises";
 import { join as join8 } from "node:path";
-function isV1ResumableProvider(provider) {
-  return V1_RESUMABLE_PROVIDERS.includes(provider);
-}
 function typedProviderHttpPath(runDirectory) {
   return join8(runDirectory, TYPED_HTTP_FILE);
 }
@@ -17256,22 +17365,49 @@ async function clearTypedProviderHttpObservation(runDirectory) {
     throw error;
   }
 }
-async function readTypedHttp429Observation(runDirectory) {
+async function readLatestTypedProviderHttpObservation(runDirectory) {
+  let text;
   try {
-    const raw = JSON.parse(
-      await readFile7(typedProviderHttpPath(runDirectory), "utf8")
-    );
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+    text = await readFile7(typedProviderHttpPath(runDirectory), "utf8");
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
       return void 0;
     }
-    const record4 = raw;
-    if (record4.httpStatus !== 429) return void 0;
-    if (typeof record4.provider !== "string") return void 0;
-    if (!isV1ResumableProvider(record4.provider)) return void 0;
-    return { httpStatus: 429, provider: record4.provider };
-  } catch {
-    return void 0;
+    throw error;
+  }
+  const raw = JSON.parse(text);
+  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+    throw new Error("typed provider HTTP observation must be a JSON object");
+  }
+  const record4 = raw;
+  if (typeof record4.httpStatus !== "number") {
+    throw new Error("typed provider HTTP observation missing numeric httpStatus");
+  }
+  if (typeof record4.provider !== "string" || record4.provider.trim() === "") {
+    throw new Error("typed provider HTTP observation missing non-empty provider");
+  }
+  return { httpStatus: record4.httpStatus, provider: record4.provider };
+}
+var TYPED_HTTP_FILE;
+var init_typed_provider_http = __esm({
+  "src/typed-provider-http.ts"() {
+    "use strict";
+    TYPED_HTTP_FILE = "typed-provider-http.json";
   }
+});
+
+// src/public-cli/run-lifecycle.ts
+import { lstat as lstat2, open, readdir as readdir2, readFile as readFile8, unlink as unlink3, writeFile as writeFile4 } from "node:fs/promises";
+import { join as join9 } from "node:path";
+function isV1ResumableProvider(provider) {
+  return V1_RESUMABLE_PROVIDERS.includes(provider);
+}
+async function readTypedHttp429Observation(runDirectory) {
+  const observation = await readLatestTypedProviderHttpObservation(runDirectory);
+  if (observation === void 0) return void 0;
+  if (observation.httpStatus !== 429) return void 0;
+  if (!isV1ResumableProvider(observation.provider)) return void 0;
+  return { httpStatus: 429, provider: observation.provider };
 }
 function isV1ResumableFailure(input) {
   if (input.hasLawfulTerminalResult) return false;
@@ -17282,8 +17418,8 @@ function renderResumeCommand(runId) {
 }
 async function writeRoleRunState(runDirectory, record4) {
   const payload = { ...record4, runDirectory };
-  await writeFile3(
-    join8(runDirectory, RUN_STATE_FILE),
+  await writeFile4(
+    join9(runDirectory, RUN_STATE_FILE),
     `${JSON.stringify(payload, null, 2)}
 `,
     "utf8"
@@ -17292,7 +17428,7 @@ async function writeRoleRunState(runDirectory, record4) {
 async function readRoleRunState(runDirectory) {
   let raw;
   try {
-    raw = JSON.parse(await readFile7(join8(runDirectory, RUN_STATE_FILE), "utf8"));
+    raw = JSON.parse(await readFile8(join9(runDirectory, RUN_STATE_FILE), "utf8"));
   } catch {
     return void 0;
   }
@@ -17314,7 +17450,7 @@ async function readRoleRunState(runDirectory) {
   if (typeof record4.sessionDirectory !== "string") return void 0;
   if (typeof record4.admittedRequestPath !== "string") return void 0;
   const runDir = typeof record4.runDirectory === "string" && record4.runDirectory.trim() !== "" ? record4.runDirectory : runDirectory;
-  const sessionFile = typeof record4.sessionFile === "string" && record4.sessionFile.trim() !== "" ? record4.sessionFile : join8(record4.sessionDirectory, "session.jsonl");
+  const sessionFile = typeof record4.sessionFile === "string" && record4.sessionFile.trim() !== "" ? record4.sessionFile : join9(record4.sessionDirectory, "session.jsonl");
   let resumable;
   if (record4.resumable !== void 0 && record4.resumable !== null) {
     if (typeof record4.resumable === "object" && !Array.isArray(record4.resumable)) {
@@ -17407,7 +17543,7 @@ async function isSessionPrincipalAvailable(sessionFile) {
   }
 }
 async function acquireRunWriterLease(runDirectory) {
-  const lockPath = join8(runDirectory, WRITER_LOCK_FILE);
+  const lockPath = join9(runDirectory, WRITER_LOCK_FILE);
   try {
     const handle = await open(lockPath, "wx");
     try {
@@ -17415,7 +17551,7 @@ async function acquireRunWriterLease(runDirectory) {
 `, "utf8");
     } catch (error) {
       await handle.close().catch(() => void 0);
-      await unlink2(lockPath).catch(() => void 0);
+      await unlink3(lockPath).catch(() => void 0);
       throw error;
     }
     let released = false;
@@ -17425,7 +17561,7 @@ async function acquireRunWriterLease(runDirectory) {
         if (released) return;
         released = true;
         await handle.close().catch(() => void 0);
-        await unlink2(lockPath).catch(() => void 0);
+        await unlink3(lockPath).catch(() => void 0);
       }
     };
   } catch (error) {
@@ -17438,7 +17574,7 @@ async function acquireRunWriterLease(runDirectory) {
 async function findRunDirectoryById(home, runId) {
   if (runId.trim() === "") return void 0;
   const ledgerHome = resolveActivationLedgerHome(() => home);
-  const booksRoot = join8(ledgerHome, "books");
+  const booksRoot = join9(ledgerHome, "books");
   let bookKeys;
   try {
     bookKeys = await readdir2(booksRoot);
@@ -17446,7 +17582,7 @@ async function findRunDirectoryById(home, runId) {
     return void 0;
   }
   for (const bookKey of bookKeys) {
-    const runsDir = join8(activationBookDirectory(ledgerHome, bookKey), "runs");
+    const runsDir = join9(activationBookDirectory(ledgerHome, bookKey), "runs");
     let entries;
     try {
       entries = await readdir2(runsDir);
@@ -17455,12 +17591,26 @@ async function findRunDirectoryById(home, runId) {
     }
     for (const entry of entries) {
       if (entry === `${runId}@judge` || entry.startsWith(`${runId}@`)) {
-        return join8(runsDir, entry);
+        return join9(runsDir, entry);
       }
     }
   }
   return void 0;
 }
+function parsePersistedTicketIdentity(record4) {
+  const correlationId = typeof record4.correlationId === "string" && record4.correlationId.trim() !== "" ? record4.correlationId : void 0;
+  const ticketNumber = typeof record4.ticketNumber === "number" && Number.isInteger(record4.ticketNumber) && record4.ticketNumber >= 1 ? record4.ticketNumber : void 0;
+  return {
+    ...correlationId === void 0 ? {} : { correlationId },
+    ...ticketNumber === void 0 ? {} : { ticketNumber }
+  };
+}
+function restoredTicketFields(fields) {
+  return {
+    ...fields.correlationId === void 0 ? {} : { correlationId: fields.correlationId },
+    ...fields.ticketNumber === void 0 ? {} : { ticketNumber: fields.ticketNumber }
+  };
+}
 async function loadResumableRunRecord(home, runId) {
   const runDirectory = await findRunDirectoryById(home, runId);
   if (runDirectory === void 0) {
@@ -17492,9 +17642,11 @@ async function loadResumableRunRecord(home, runId) {
   let baseRevision;
   let mergerInputPath;
   let derived;
+  let correlationId;
+  let ticketNumber;
   try {
     const raw = JSON.parse(
-      await readFile7(run.admittedRequestPath, "utf8")
+      await readFile8(run.admittedRequestPath, "utf8")
     );
     if (raw !== null && typeof raw === "object" && !Array.isArray(raw)) {
       const record4 = raw;
@@ -17540,12 +17692,36 @@ async function loadResumableRunRecord(home, runId) {
           };
         }
       }
+      const fromAdmitted = parsePersistedTicketIdentity(record4);
+      correlationId = fromAdmitted.correlationId;
+      ticketNumber = fromAdmitted.ticketNumber;
     }
   } catch {
     throw new CliUsageError(
       `role run admitted request is unreadable: ${runId}`
     );
   }
+  if (correlationId === void 0 || ticketNumber === void 0) {
+    try {
+      const invocationRaw = JSON.parse(
+        await readFile8(join9(run.runDirectory, "invocation.json"), "utf8")
+      );
+      if (invocationRaw !== null && typeof invocationRaw === "object" && !Array.isArray(invocationRaw)) {
+        const fromInvocation = parsePersistedTicketIdentity(
+          invocationRaw
+        );
+        if (correlationId === void 0) correlationId = fromInvocation.correlationId;
+        if (ticketNumber === void 0) ticketNumber = fromInvocation.ticketNumber;
+      }
+    } catch (error) {
+      if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) {
+        throw new CliUsageError(
+          `role run invocation identity is unreadable: ${runId}`,
+          { cause: error }
+        );
+      }
+    }
+  }
   return {
     run,
     observation: run.resumable,
@@ -17560,7 +17736,9 @@ async function loadResumableRunRecord(home, runId) {
       ...prerequisites === void 0 ? {} : { prerequisites },
       ...baseRevision === void 0 ? {} : { baseRevision },
       ...mergerInputPath === void 0 ? {} : { mergerInputPath },
-      ...derived === void 0 ? {} : { derived }
+      ...derived === void 0 ? {} : { derived },
+      ...correlationId === void 0 ? {} : { correlationId },
+      ...ticketNumber === void 0 ? {} : { ticketNumber }
     }
   };
 }
@@ -17582,7 +17760,8 @@ async function loadResumableJudgeRun(home, runId) {
     runDirectory: loaded.run.runDirectory,
     sessionDirectory: loaded.run.sessionDirectory,
     sessionFile: loaded.run.sessionFile,
-    admittedRequestPath: loaded.run.admittedRequestPath
+    admittedRequestPath: loaded.run.admittedRequestPath,
+    ...restoredTicketFields(loaded.admittedFields)
   };
   return {
     admitted,
@@ -17627,7 +17806,8 @@ async function loadResumableCoderRun(home, runId) {
     sessionDirectory: loaded.run.sessionDirectory,
     sessionFile: loaded.run.sessionFile,
     admittedRequestPath: loaded.run.admittedRequestPath,
-    taskPath
+    taskPath,
+    ...restoredTicketFields(loaded.admittedFields)
   };
   return {
     admitted,
@@ -17675,7 +17855,8 @@ async function loadResumableFixerRun(home, runId) {
     admittedRequestPath: loaded.run.admittedRequestPath,
     packetPath,
     ...loaded.admittedFields.prerequisitesPath === void 0 ? {} : { prerequisitesPath: loaded.admittedFields.prerequisitesPath },
-    prerequisites
+    prerequisites,
+    ...restoredTicketFields(loaded.admittedFields)
   };
   return {
     admitted,
@@ -17708,7 +17889,8 @@ async function loadResumableReviewerRun(home, runId) {
     sessionDirectory: loaded.run.sessionDirectory,
     sessionFile: loaded.run.sessionFile,
     admittedRequestPath: loaded.run.admittedRequestPath,
-    baseRevision
+    baseRevision,
+    ...restoredTicketFields(loaded.admittedFields)
   };
   return {
     admitted,
@@ -17753,7 +17935,8 @@ async function loadResumableMergerRun(home, runId) {
     sessionFile: loaded.run.sessionFile,
     admittedRequestPath: loaded.run.admittedRequestPath,
     mergerInputPath,
-    derived
+    derived,
+    ...restoredTicketFields(loaded.admittedFields)
   };
   return {
     admitted,
@@ -17767,17 +17950,18 @@ async function peekRoleRunRole(home, runId) {
   const run = await readRoleRunState(runDirectory);
   return run?.role;
 }
-var V1_RESUMABLE_PROVIDERS, RESUME_TRANSPORT_ENVELOPE, RUN_STATE_FILE, TYPED_HTTP_FILE, WRITER_LOCK_FILE, RunWriterLeaseHeldError;
+var V1_RESUMABLE_PROVIDERS, RESUME_TRANSPORT_ENVELOPE, RUN_STATE_FILE, WRITER_LOCK_FILE, RunWriterLeaseHeldError;
 var init_run_lifecycle = __esm({
   "src/public-cli/run-lifecycle.ts"() {
     "use strict";
     init_activation_ledger_topology();
     init_cli_errors();
+    init_typed_provider_http();
+    init_typed_provider_http();
     init_invocation();
     V1_RESUMABLE_PROVIDERS = ["openai-codex", "xai"];
     RESUME_TRANSPORT_ENVELOPE = "[ak-role:resume-continue]";
     RUN_STATE_FILE = "run-state.json";
-    TYPED_HTTP_FILE = "typed-provider-http.json";
     WRITER_LOCK_FILE = "writer.lock";
     RunWriterLeaseHeldError = class extends Error {
       code = "AK_RUN_WRITER_LEASE_HELD";
@@ -17911,6 +18095,7 @@ var init_evidence_child_executor = __esm({
     init_package_owned_tool_idle();
     init_stream_idle_guard();
     init_receipt_delivery_policy();
+    init_upstream_error_testimony();
   }
 });
 
@@ -18431,8 +18616,8 @@ var init_terminal = __esm({
 
 // src/public-cli/settlement.ts
 import { randomUUID } from "node:crypto";
-import { lstat as lstat3, mkdir as mkdir3, open as open2, readFile as readFile8, readdir as readdir3, writeFile as writeFile4 } from "node:fs/promises";
-import { dirname as dirname6, join as join9 } from "node:path";
+import { lstat as lstat3, mkdir as mkdir3, open as open2, readFile as readFile9, readdir as readdir3, writeFile as writeFile5 } from "node:fs/promises";
+import { dirname as dirname6, join as join10 } from "node:path";
 function isChildDiagnosticFloodLine(line2) {
   if (/^at\s+/.test(line2)) return true;
   if (line2.startsWith("event:")) return true;
@@ -18487,7 +18672,7 @@ function presentStructuralRejection(error, io) {
 }
 async function inspectJudgeSession(sessionFile) {
   try {
-    await readFile8(sessionFile, "utf8");
+    await readFile9(sessionFile, "utf8");
     return { state: "present" };
   } catch (error) {
     if (isMissingPathError2(error)) return { state: "missing" };
@@ -18542,13 +18727,15 @@ function classifyPostAdmissionFailure(input) {
   if (input.knownCause !== void 0) {
     const fallback = input.knownCause === "provider" ? "provider failure" : input.knownCause === "session" ? "session unreadable" : input.knownCause === "output" ? "role run completed without a lawful typed terminal result" : `role run failed (${input.knownCause})`;
     const diagnostic = input.knownDiagnostic !== void 0 && input.knownDiagnostic.trim() !== "" ? input.knownDiagnostic : conciseChildDiagnostic(input.stderr, fallback);
-    const { code: _knownCode, timedOut: _knownTimedOut, ...knownDetails } = input.knownDetails ?? {};
+    const { timedOut: _knownTimedOut, ...knownDetails } = input.knownDetails ?? {};
+    const remoteCode = knownDetails.code;
     return {
       cause: input.knownCause,
       diagnostic,
       details: {
         ...knownDetails,
-        code: input.code,
+        ...remoteCode === void 0 ? {} : { code: remoteCode },
+        exitCode: input.code,
         ...input.timedOut ? { timedOut: true } : {}
       },
       ...input.knownIdentity === void 0 ? {} : { identity: input.knownIdentity }
@@ -18558,7 +18745,7 @@ function classifyPostAdmissionFailure(input) {
     return {
       cause: "timeout",
       diagnostic: "role run timed out",
-      details: { timedOut: true, code: input.code }
+      details: { timedOut: true, exitCode: input.code }
     };
   }
   if (input.code !== 0) {
@@ -18566,27 +18753,27 @@ function classifyPostAdmissionFailure(input) {
     return {
       cause: "activation",
       diagnostic: conciseChildDiagnostic(input.stderr, fallback),
-      details: { code: input.code }
+      details: { exitCode: input.code }
     };
   }
   if (input.session?.state === "missing") {
     return {
       cause: "session",
       diagnostic: "role run left no readable session transcript",
-      details: { code: input.code, session: "missing" }
+      details: { exitCode: input.code, session: "missing" }
     };
   }
   if (input.session?.state === "unreadable") {
     return {
       cause: "session",
       diagnostic: input.session.diagnostic,
-      details: { code: input.code, session: "unreadable" }
+      details: { exitCode: input.code, session: "unreadable" }
     };
   }
   return {
     cause: "output",
     diagnostic: "role run completed without a lawful typed terminal result",
-    details: { code: input.code }
+    details: { exitCode: input.code }
   };
 }
 function explicitInternalKnownFailureClassificationInput(failure) {
@@ -18627,7 +18814,7 @@ function sessionReadFailure(error, fallbackMessage) {
   return failed;
 }
 async function readBoundSessionEntries(sessionFile) {
-  const text = await readFile8(sessionFile, "utf8");
+  const text = await readFile9(sessionFile, "utf8");
   const entries = [];
   for (const line2 of text.trim().split("\n").filter(Boolean)) {
     try {
@@ -18638,6 +18825,31 @@ async function readBoundSessionEntries(sessionFile) {
   }
   return entries;
 }
+function typedHttpStatusFromMessage(message) {
+  for (const candidate of [message.httpStatus, message.statusCode, message.status]) {
+    if (typeof candidate === "number" && (candidate < 200 || candidate >= 300)) return candidate;
+  }
+  return void 0;
+}
+function sessionProviderStopFromAssistant(message) {
+  if (message?.role !== "assistant") return void 0;
+  if (message.stopReason !== "error" && message.stopReason !== "aborted") return void 0;
+  const httpStatus = typedHttpStatusFromMessage(message);
+  return {
+    stopReason: message.stopReason,
+    // Preserve held errorMessage bytes — emptiness check must not rewrite.
+    ...typeof message.errorMessage === "string" && message.errorMessage.trim() !== "" ? { errorMessage: message.errorMessage } : {},
+    ...typeof message.provider === "string" && message.provider.trim() !== "" ? { provider: message.provider } : {},
+    ...typeof message.model === "string" && message.model.trim() !== "" ? { model: message.model } : {},
+    ...typeof message.api === "string" && message.api.trim() !== "" ? { api: message.api } : {},
+    ...typeof message.rawStopReason === "string" && message.rawStopReason.trim() !== "" ? { rawStopReason: message.rawStopReason } : {},
+    ...message.diagnostics === void 0 ? {} : { diagnostics: message.diagnostics },
+    ...httpStatus === void 0 ? {} : { httpStatus },
+    ...message.body === void 0 ? {} : { body: message.body },
+    ...message.code === void 0 ? {} : { code: message.code },
+    ...message.errno === void 0 ? {} : { errno: message.errno }
+  };
+}
 function extractSessionProviderStop(entries) {
   let attemptStart = 0;
   for (let i = entries.length - 1; i >= 0; i -= 1) {
@@ -18651,14 +18863,8 @@ function extractSessionProviderStop(entries) {
     const entry = entries[i];
     if (entry?.type !== "custom" || entry.customType !== COMPLIANCE_RESPONSE_ENTRY_TYPE) continue;
     const response = isRecord5(entry.data) && isRecord5(entry.data.response) ? entry.data.response : void 0;
-    if (response?.role === "assistant" && response.stopReason === "error") {
-      return {
-        stopReason: "error",
-        ...typeof response.errorMessage === "string" && response.errorMessage.trim() !== "" ? { errorMessage: response.errorMessage } : {},
-        ...typeof response.provider === "string" && response.provider.trim() !== "" ? { provider: response.provider } : {},
-        ...typeof response.model === "string" && response.model.trim() !== "" ? { model: response.model } : {}
-      };
-    }
+    const stop = sessionProviderStopFromAssistant(response);
+    if (stop !== void 0) return stop;
     break;
   }
   for (let i = entries.length - 1; i >= attemptStart; i -= 1) {
@@ -18666,13 +18872,7 @@ function extractSessionProviderStop(entries) {
     if (entry?.type !== "message") continue;
     const message = entry.message;
     if (message?.role !== "assistant") continue;
-    if (message.stopReason !== "error") return void 0;
-    return {
-      stopReason: "error",
-      ...typeof message.errorMessage === "string" && message.errorMessage.trim() !== "" ? { errorMessage: message.errorMessage } : {},
-      ...typeof message.provider === "string" && message.provider.trim() !== "" ? { provider: message.provider } : {},
-      ...typeof message.model === "string" && message.model.trim() !== "" ? { model: message.model } : {}
-    };
+    return sessionProviderStopFromAssistant(message);
   }
   return void 0;
 }
@@ -18685,7 +18885,7 @@ async function readSessionProviderStop(sessionFile) {
   }
 }
 async function readBoundEvidenceChildKnownFailure(sessionFile) {
-  const childDirectory = join9(dirname6(sessionFile), "evidence-children");
+  const childDirectory = join10(dirname6(sessionFile), "evidence-children");
   let names;
   try {
     names = await readdir3(childDirectory);
@@ -18696,7 +18896,7 @@ async function readBoundEvidenceChildKnownFailure(sessionFile) {
   for (const file of names.filter((name) => name.endsWith(".jsonl")).sort().reverse()) {
     let entries;
     try {
-      entries = await readBoundSessionEntries(join9(childDirectory, file));
+      entries = await readBoundSessionEntries(join10(childDirectory, file));
     } catch (error) {
       throw sessionReadFailure(error, "failed to read discovered evidence-child session");
     }
@@ -18708,8 +18908,7 @@ async function readBoundEvidenceChildKnownFailure(sessionFile) {
     return {
       ...primary,
       details: {
-        ...stop.provider === void 0 ? {} : { provider: stop.provider },
-        ...stop.model === void 0 ? {} : { model: stop.model },
+        ...primary.details ?? {},
         secondaryEvidence: "evidence-child"
       }
     };
@@ -18733,7 +18932,7 @@ async function readBoundAuditorKnownFailure(sessionFile) {
       break;
     }
   }
-  const childDirectory = join9(dirname6(sessionFile), "auditor-roles");
+  const childDirectory = join10(dirname6(sessionFile), "auditor-roles");
   let names;
   try {
     names = await readdir3(childDirectory);
@@ -18744,7 +18943,7 @@ async function readBoundAuditorKnownFailure(sessionFile) {
   for (const file of names.filter((name) => name.endsWith(".jsonl")).sort().reverse()) {
     let entries;
     try {
-      entries = await readBoundSessionEntries(join9(childDirectory, file));
+      entries = await readBoundSessionEntries(join10(childDirectory, file));
     } catch (error) {
       throw sessionReadFailure(error, "failed to read discovered auditor session");
     }
@@ -18762,10 +18961,10 @@ async function readBoundAuditorKnownFailure(sessionFile) {
       if (entry?.type !== "custom" || entry.customType !== AUDITOR_COMPLIANCE_FAILURE_ENTRY_TYPE || !isRecord5(entry.data)) continue;
       const parent = isRecord5(entry.data.parent) ? entry.data.parent : void 0;
       const failure = isRecord5(entry.data.failure) ? entry.data.failure : void 0;
-      if (parent?.sessionId !== parentId || parent.sessionFile !== sessionFile || parent.attemptEntryId !== attemptEntryId || failure?.cause !== "provider") continue;
+      if (parent?.sessionId !== parentId || parent.sessionFile !== sessionFile || parent.attemptEntryId !== attemptEntryId || failure?.cause !== "provider" && failure?.cause !== "unrecognized") continue;
       const identity = isRecord5(failure.identity) ? failure.identity : void 0;
       return {
-        cause: "provider",
+        cause: failure.cause === "provider" ? "provider" : "unrecognized",
         ...identity === void 0 ? {} : { identity: {
           ...typeof identity.name === "string" ? { name: identity.name } : {},
           ...typeof identity.code === "string" || typeof identity.code === "number" ? { code: identity.code } : {}
@@ -18778,8 +18977,7 @@ async function readBoundAuditorKnownFailure(sessionFile) {
     return {
       ...primary,
       details: {
-        ...stop.provider === void 0 ? {} : { provider: stop.provider },
-        ...stop.model === void 0 ? {} : { model: stop.model },
+        ...primary.details ?? {},
         secondaryEvidence: "unavailable"
       }
     };
@@ -18813,56 +19011,145 @@ function typedFailedTerminatingToolKnownFailure(entries) {
   }
   return void 0;
 }
-async function resolveAuditedRunnerKnownFailure(input) {
-  if (input.runner !== void 0) return input.runner;
+function resolutionOf(knownFailure, typedHttp = { settled: false }) {
+  return {
+    ...knownFailure === void 0 ? {} : { knownFailure },
+    ...typedHttp.observation === void 0 ? {} : { typedHttpObservation: typedHttp.observation },
+    typedHttpObservationSettled: typedHttp.settled
+  };
+}
+async function resolveAuditedRunnerFailureResolution(input) {
+  if (input.runner !== void 0) return resolutionOf(input.runner);
   if (input.runDirectory !== void 0) {
     try {
       const rejection = await readReviewerDispatchRejection(input.runDirectory);
-      if (rejection !== void 0) return rejection;
+      if (rejection !== void 0) return resolutionOf(rejection);
     } catch (error) {
       const failure = error instanceof Error ? error : new Error(String(error));
-      return {
+      return resolutionOf({
         cause: "activation",
         identity: thrownIdentity(failure),
         diagnostic: failure.message || failure.name
-      };
+      });
     }
   }
   try {
     const auditorFailure = await readBoundAuditorKnownFailure(input.sessionFile);
-    if (auditorFailure !== void 0) return auditorFailure;
+    if (auditorFailure !== void 0) return resolutionOf(auditorFailure);
   } catch (error) {
     const failure = sessionReadFailure(error, "failed to recover bound auditor failure");
-    return {
+    return resolutionOf({
       cause: "session",
       identity: thrownIdentity(failure),
       diagnostic: failure.message || failure.name
-    };
+    });
   }
   try {
     const terminatingFailure = typedFailedTerminatingToolKnownFailure(
       await readBoundSessionEntries(input.sessionFile)
     );
-    if (terminatingFailure !== void 0) return terminatingFailure;
+    if (terminatingFailure !== void 0) return resolutionOf(terminatingFailure);
   } catch (error) {
     if (!isMissingPathError2(error)) {
       const failure = sessionReadFailure(error, "failed to recover typed terminating-tool failure");
-      return { cause: "session", identity: thrownIdentity(failure), diagnostic: failure.message || failure.name };
+      return resolutionOf({
+        cause: "session",
+        identity: thrownIdentity(failure),
+        diagnostic: failure.message || failure.name
+      });
     }
   }
   try {
     const evidenceChildFailure = await readBoundEvidenceChildKnownFailure(input.sessionFile);
-    if (evidenceChildFailure !== void 0) return evidenceChildFailure;
+    if (evidenceChildFailure !== void 0) return resolutionOf(evidenceChildFailure);
   } catch (error) {
     const failure = sessionReadFailure(error, "failed to recover bound evidence-child failure");
-    return {
+    return resolutionOf({
       cause: "session",
       identity: thrownIdentity(failure),
       diagnostic: failure.message || failure.name
-    };
+    });
   }
   const parentStop = await readSessionProviderStop(input.sessionFile);
-  return parentStop === void 0 ? input.credential : knownFailureFromProviderStop(parentStop);
+  let httpObservation;
+  if (input.runDirectory !== void 0) {
+    try {
+      httpObservation = await readLatestTypedProviderHttpObservation(input.runDirectory);
+    } catch (error) {
+      const failure = error instanceof Error ? error : new Error(String(error));
+      return resolutionOf(
+        {
+          cause: "session",
+          identity: thrownIdentity(failure),
+          diagnostic: failure.message || failure.name
+        },
+        { settled: true }
+      );
+    }
+  }
+  const typedHttp = {
+    settled: input.runDirectory !== void 0,
+    ...httpObservation === void 0 ? {} : { observation: httpObservation }
+  };
+  if (parentStop === void 0) {
+    if (input.credential !== void 0) return resolutionOf(input.credential, typedHttp);
+    if (httpObservation === void 0) return resolutionOf(void 0, typedHttp);
+    return resolutionOf(
+      knownFailureFromProviderStop({
+        stopReason: "error",
+        httpStatus: httpObservation.httpStatus,
+        provider: httpObservation.provider
+      }),
+      typedHttp
+    );
+  }
+  return resolutionOf(
+    knownFailureFromProviderStop({
+      ...parentStop,
+      ...httpObservation === void 0 ? {} : {
+        httpStatus: httpObservation.httpStatus,
+        // Observation association outranks session-configured provider name alone.
+        provider: httpObservation.provider
+      }
+    }),
+    typedHttp
+  );
+}
+async function resolveAuditedRunnerKnownFailure(input) {
+  return (await resolveAuditedRunnerFailureResolution(input)).knownFailure;
+}
+async function resolveControlledFailureResumeObservation(input) {
+  if (input.typedHttpObservationSettled === true) {
+    const observation = input.typedHttpObservation;
+    if (observation !== void 0 && observation.httpStatus === 429 && isV1ResumableProvider(observation.provider)) {
+      return {
+        typedHttp429: { httpStatus: 429, provider: observation.provider }
+      };
+    }
+    return {};
+  }
+  try {
+    const typedHttp429 = await readTypedHttp429Observation(input.runDirectory);
+    return typedHttp429 === void 0 ? {} : { typedHttp429 };
+  } catch (error) {
+    const failure = error instanceof Error ? error : new Error(String(error));
+    return {
+      observationReadFailure: {
+        cause: "session",
+        identity: thrownIdentity(failure),
+        diagnostic: failure.message || failure.name
+      }
+    };
+  }
+}
+function controlledFailureInputFromResolution(resolution) {
+  return {
+    ...resolution.knownFailure === void 0 ? {} : { knownFailure: resolution.knownFailure },
+    ...resolution.typedHttpObservationSettled ? {
+      typedHttpObservationSettled: true,
+      ...resolution.typedHttpObservation === void 0 ? {} : { typedHttpObservation: resolution.typedHttpObservation }
+    } : {}
+  };
 }
 function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -19358,7 +19645,7 @@ function auditArtifactPublicationError(message, code) {
   return error;
 }
 async function ensureAuditEvidenceDirectory(runDirectory) {
-  const artifactsDir = join9(runDirectory, "artifacts");
+  const artifactsDir = join10(runDirectory, "artifacts");
   const runStat = await lstat3(runDirectory);
   if (runStat.isSymbolicLink() || !runStat.isDirectory()) {
     throw auditArtifactPublicationError(
@@ -19395,7 +19682,7 @@ async function ensureAuditEvidenceDirectory(runDirectory) {
 }
 async function publishComplianceAuditIncompleteEvidence(admitted, outcome) {
   const artifactsDir = await ensureAuditEvidenceDirectory(admitted.runDirectory);
-  const evidencePath = join9(artifactsDir, "audit-incomplete.json");
+  const evidencePath = join10(artifactsDir, "audit-incomplete.json");
   try {
     const existing = await lstat3(evidencePath);
     throw auditArtifactPublicationError(
@@ -19417,7 +19704,7 @@ async function publishComplianceAuditIncompleteEvidence(admitted, outcome) {
 }
 function auditPublicationFailureTerminal(admitted, entries, outcome, error) {
   const attempt = publicationAttemptFromError(
-    join9(admitted.runDirectory, "artifacts", "audit-incomplete.json"),
+    join10(admitted.runDirectory, "artifacts", "audit-incomplete.json"),
     error
   );
   const diagnostic = `audit-incomplete evidence publication failed: ${attempt.diagnostic}`;
@@ -19711,9 +19998,9 @@ async function extractNavigatorFactFromAdmittedSession(admitted) {
 }
 async function publishJudgeArtifacts(admitted, roleOutcome, sessionDirectory) {
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join9(artifactsDir, "report.json");
-  const evidencePath = join9(artifactsDir, "evidence.json");
-  await writeFile4(
+  const reportPath = join10(artifactsDir, "report.json");
+  const evidencePath = join10(artifactsDir, "evidence.json");
+  await writeFile5(
     reportPath,
     `${JSON.stringify(
       {
@@ -19727,7 +20014,7 @@ async function publishJudgeArtifacts(admitted, roleOutcome, sessionDirectory) {
 `,
     "utf8"
   );
-  await writeFile4(
+  await writeFile5(
     evidencePath,
     `${JSON.stringify(
       {
@@ -19755,9 +20042,9 @@ async function publishJudgeArtifacts(admitted, roleOutcome, sessionDirectory) {
 }
 async function publishCoderArtifacts(admitted, roleOutcome, sessionDirectory, options = {}) {
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join9(artifactsDir, "report.json");
-  const evidencePath = join9(artifactsDir, "evidence.json");
-  await writeFile4(
+  const reportPath = join10(artifactsDir, "report.json");
+  const evidencePath = join10(artifactsDir, "evidence.json");
+  await writeFile5(
     reportPath,
     `${JSON.stringify(
       {
@@ -19773,7 +20060,7 @@ async function publishCoderArtifacts(admitted, roleOutcome, sessionDirectory, op
 `,
     "utf8"
   );
-  await writeFile4(
+  await writeFile5(
     evidencePath,
     `${JSON.stringify(
       {
@@ -19930,9 +20217,9 @@ function extractFixerMethodInvocations(entries, options) {
 }
 async function publishFixerArtifacts(admitted, roleOutcome, sessionDirectory, options) {
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join9(artifactsDir, "report.json");
-  const evidencePath = join9(artifactsDir, "evidence.json");
-  await writeFile4(
+  const reportPath = join10(artifactsDir, "report.json");
+  const evidencePath = join10(artifactsDir, "evidence.json");
+  await writeFile5(
     reportPath,
     `${JSON.stringify(
       {
@@ -19948,7 +20235,7 @@ async function publishFixerArtifacts(admitted, roleOutcome, sessionDirectory, op
 `,
     "utf8"
   );
-  await writeFile4(
+  await writeFile5(
     evidencePath,
     `${JSON.stringify(
       {
@@ -20044,9 +20331,9 @@ async function settleLawfulFixerTerminalResult(admitted, options) {
 }
 async function publishCollectorArtifacts(admitted, roleOutcome, sessionDirectory, options = {}) {
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join9(artifactsDir, "report.json");
-  const evidencePath = join9(artifactsDir, "evidence.json");
-  await writeFile4(
+  const reportPath = join10(artifactsDir, "report.json");
+  const evidencePath = join10(artifactsDir, "evidence.json");
+  await writeFile5(
     reportPath,
     `${JSON.stringify(
       {
@@ -20061,7 +20348,7 @@ async function publishCollectorArtifacts(admitted, roleOutcome, sessionDirectory
 `,
     "utf8"
   );
-  await writeFile4(
+  await writeFile5(
     evidencePath,
     `${JSON.stringify(
       {
@@ -20166,9 +20453,9 @@ async function trySettleCollectorTerminalResult(admitted) {
 }
 async function publishDoctorArtifacts(admitted, roleOutcome, sessionDirectory, options = {}) {
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join9(artifactsDir, "report.json");
-  const evidencePath = join9(artifactsDir, "evidence.json");
-  await writeFile4(
+  const reportPath = join10(artifactsDir, "report.json");
+  const evidencePath = join10(artifactsDir, "evidence.json");
+  await writeFile5(
     reportPath,
     `${JSON.stringify(
       {
@@ -20183,7 +20470,7 @@ async function publishDoctorArtifacts(admitted, roleOutcome, sessionDirectory, o
 `,
     "utf8"
   );
-  await writeFile4(
+  await writeFile5(
     evidencePath,
     `${JSON.stringify(
       {
@@ -20335,9 +20622,9 @@ function extractReviewerMethodInvocations(entries, options) {
 }
 async function publishReviewerArtifacts(admitted, roleOutcome, sessionDirectory, options) {
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join9(artifactsDir, "report.json");
-  const evidencePath = join9(artifactsDir, "evidence.json");
-  await writeFile4(
+  const reportPath = join10(artifactsDir, "report.json");
+  const evidencePath = join10(artifactsDir, "evidence.json");
+  await writeFile5(
     reportPath,
     `${JSON.stringify(
       {
@@ -20352,7 +20639,7 @@ async function publishReviewerArtifacts(admitted, roleOutcome, sessionDirectory,
 `,
     "utf8"
   );
-  await writeFile4(
+  await writeFile5(
     evidencePath,
     `${JSON.stringify(
       {
@@ -20502,9 +20789,9 @@ function extractMergerMethodInvocations(entries, options) {
 }
 async function publishMergerArtifacts(admitted, roleOutcome, sessionDirectory, options) {
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join9(artifactsDir, "report.json");
-  const evidencePath = join9(artifactsDir, "evidence.json");
-  await writeFile4(
+  const reportPath = join10(artifactsDir, "report.json");
+  const evidencePath = join10(artifactsDir, "evidence.json");
+  await writeFile5(
     reportPath,
     `${JSON.stringify(
       {
@@ -20519,7 +20806,7 @@ async function publishMergerArtifacts(admitted, roleOutcome, sessionDirectory, o
 `,
     "utf8"
   );
-  await writeFile4(
+  await writeFile5(
     evidencePath,
     `${JSON.stringify(
       {
@@ -20674,7 +20961,7 @@ function uniqueFailureFallbackDirs(runDirectory, baseDir) {
   return dirs;
 }
 async function resolveFailureArtifactsBase(runDirectory) {
-  const artifactsDir = join9(runDirectory, "artifacts");
+  const artifactsDir = join10(runDirectory, "artifacts");
   try {
     await ensureRunArtifactsDir(runDirectory);
     return { baseDir: artifactsDir };
@@ -20690,13 +20977,13 @@ async function writeFailureJsonRetainingCause(preferredCandidates, uniqueFallbac
   const candidates = [
     ...preferredCandidates,
     // One unique name per fallback dir — collisions on fixed names cannot exhaust this.
-    ...uniqueFallbackDirs.map((dir) => join9(dir, `${stem}.${randomUUID()}.json`))
+    ...uniqueFallbackDirs.map((dir) => join10(dir, `${stem}.${randomUUID()}.json`))
   ];
   for (let i = 0; i < candidates.length; i += 1) {
     const path = candidates[i];
     const payload = issues.length === 0 ? basePayload : { ...basePayload, publicationIssues: issues };
     try {
-      await writeFile4(
+      await writeFile5(
         path,
         `${JSON.stringify(payload, null, 2)}
 `,
@@ -20725,26 +21012,26 @@ async function publishFailureArtifacts(admitted, failure) {
     admitted.runDirectory
   );
   const priorIssues = baseAttempt === void 0 ? [] : [baseAttempt];
-  const underArtifacts = baseDir === join9(admitted.runDirectory, "artifacts");
+  const underArtifacts = baseDir === join10(admitted.runDirectory, "artifacts");
   const uniqueFallbackDirs = uniqueFailureFallbackDirs(
     admitted.runDirectory,
     baseDir
   );
   const errorCandidates = underArtifacts ? [
-    join9(baseDir, "error.json"),
-    join9(baseDir, "error.settlement.json"),
-    join9(admitted.runDirectory, "error.settlement.json")
+    join10(baseDir, "error.json"),
+    join10(baseDir, "error.settlement.json"),
+    join10(admitted.runDirectory, "error.settlement.json")
   ] : [
-    join9(baseDir, "error.settlement.json"),
-    join9(baseDir, "error.json")
+    join10(baseDir, "error.settlement.json"),
+    join10(baseDir, "error.json")
   ];
   const evidenceCandidates = underArtifacts ? [
-    join9(baseDir, "evidence.json"),
-    join9(baseDir, "evidence.settlement.json"),
-    join9(admitted.runDirectory, "evidence.settlement.json")
+    join10(baseDir, "evidence.json"),
+    join10(baseDir, "evidence.settlement.json"),
+    join10(admitted.runDirectory, "evidence.settlement.json")
   ] : [
-    join9(baseDir, "evidence.settlement.json"),
-    join9(baseDir, "evidence.json")
+    join10(baseDir, "evidence.settlement.json"),
+    join10(baseDir, "evidence.json")
   ];
   const errorPayloadBase = {
     kind: "error",
@@ -20931,6 +21218,7 @@ var init_settlement = __esm({
     init_judge_auditor();
     init_reviewer_auditor();
     init_explicit_internal();
+    init_run_lifecycle();
     init_compliance_transport();
     init_collector_ledger();
     init_judge_output();
@@ -20957,8 +21245,8 @@ var init_settlement = __esm({
 });
 
 // src/public-cli/coder-run.ts
-import { writeFile as writeFile5 } from "node:fs/promises";
-import { join as join10 } from "node:path";
+import { writeFile as writeFile6 } from "node:fs/promises";
+import { join as join11 } from "node:path";
 function buildModelArgs(model) {
   if (model === void 0) return [];
   return [
@@ -21029,20 +21317,28 @@ function buildCoderResumeActivationExtraArgs(admitted, options) {
 }
 async function presentControlledFailure(admitted, failureInput, io) {
   const hasThrown = Object.hasOwn(failureInput, "thrown");
-  const session = !hasThrown && !failureInput.timedOut && failureInput.knownFailure === void 0 && failureInput.knownCause === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
+  const resumeObservation = await resolveControlledFailureResumeObservation({
+    runDirectory: admitted.runDirectory,
+    ...failureInput.typedHttpObservationSettled === true ? {
+      typedHttpObservationSettled: true,
+      ...failureInput.typedHttpObservation === void 0 ? {} : { typedHttpObservation: failureInput.typedHttpObservation }
+    } : {}
+  });
+  const knownFailure = failureInput.knownFailure ?? resumeObservation.observationReadFailure;
+  const session = !hasThrown && !failureInput.timedOut && knownFailure === void 0 && failureInput.knownCause === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
   const failure = classifyPostAdmissionFailure({
     timedOut: failureInput.timedOut,
     code: failureInput.code,
     stderr: failureInput.stderr,
     ...hasThrown ? { thrown: failureInput.thrown } : {},
-    ...explicitInternalKnownFailureClassificationInput(failureInput.knownFailure),
+    ...explicitInternalKnownFailureClassificationInput(knownFailure),
     ...failureInput.knownCause === void 0 ? {} : { knownCause: failureInput.knownCause },
     ...failureInput.knownIdentity === void 0 ? {} : { knownIdentity: failureInput.knownIdentity },
     ...failureInput.knownDiagnostic === void 0 ? {} : { knownDiagnostic: failureInput.knownDiagnostic },
     ...session === void 0 ? {} : { session }
   });
   const hasLawfulTerminalResult = await hasLawfulCoderTerminalResult(admitted);
-  const typedHttp429 = await readTypedHttp429Observation(admitted.runDirectory);
+  const typedHttp429 = resumeObservation.typedHttp429;
   const sessionPrincipalAvailable = await isSessionPrincipalAvailable(
     admitted.sessionFile
   );
@@ -21089,8 +21385,9 @@ async function dispatchAdmittedCoder(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
-    if (env.correlationId !== void 0 && env.correlationId.trim() !== "") {
-      childEnv.AK_CORRELATION_ID = env.correlationId;
+    const correlationId = admitted.correlationId ?? env.correlationId;
+    if (correlationId !== void 0 && correlationId.trim() !== "") {
+      childEnv.AK_CORRELATION_ID = correlationId;
     }
     let result2;
     try {
@@ -21117,8 +21414,8 @@ async function dispatchAdmittedCoder(input) {
       );
     }
     try {
-      await writeFile5(
-        join10(admitted.runDirectory, "stderr.log"),
+      await writeFile6(
+        join11(admitted.runDirectory, "stderr.log"),
         result2.stderr,
         "utf8"
       );
@@ -21155,10 +21452,11 @@ async function dispatchAdmittedCoder(input) {
       env.model,
       env.credentials
     );
-    const knownFailure = await resolveAuditedRunnerKnownFailure({
+    const resolution = await resolveAuditedRunnerFailureResolution({
       runner: result2.knownFailure,
       sessionFile: admitted.sessionFile,
-      credential: credentialFailure
+      credential: credentialFailure,
+      runDirectory: admitted.runDirectory
     });
     return await presentControlledFailure(
       admitted,
@@ -21166,7 +21464,7 @@ async function dispatchAdmittedCoder(input) {
         timedOut: result2.timedOut,
         code: result2.code,
         stderr: result2.stderr,
-        ...knownFailure === void 0 ? {} : { knownFailure }
+        ...controlledFailureInputFromResolution(resolution)
       },
       io
     );
@@ -21235,7 +21533,10 @@ async function runPublicCoder(argv, env, io, parseCoderArgv2) {
   });
   return await dispatchAdmittedCoder({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease,
@@ -21309,7 +21610,10 @@ async function runPublicCoderResume(argv, env, io) {
   });
   return await dispatchAdmittedCoder({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease,
@@ -21331,8 +21635,8 @@ var init_coder_run = __esm({
 });
 
 // src/public-cli/collector-run.ts
-import { writeFile as writeFile6 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { writeFile as writeFile7 } from "node:fs/promises";
+import { join as join12 } from "node:path";
 function buildModelArgs2(model) {
   if (model === void 0) return [];
   return [
@@ -21414,8 +21718,9 @@ async function dispatchAdmittedCollector(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
-    if (env.correlationId !== void 0 && env.correlationId.trim() !== "") {
-      childEnv.AK_CORRELATION_ID = env.correlationId;
+    const correlationId = admitted.correlationId ?? env.correlationId;
+    if (correlationId !== void 0 && correlationId.trim() !== "") {
+      childEnv.AK_CORRELATION_ID = correlationId;
     }
     let result2;
     try {
@@ -21442,8 +21747,8 @@ async function dispatchAdmittedCollector(input) {
       );
     }
     try {
-      await writeFile6(
-        join11(admitted.runDirectory, "stderr.log"),
+      await writeFile7(
+        join12(admitted.runDirectory, "stderr.log"),
         result2.stderr,
         "utf8"
       );
@@ -21488,7 +21793,8 @@ async function dispatchAdmittedCollector(input) {
         ...infrastructureFailure.identity === void 0 ? {} : { identity: infrastructureFailure.identity }
       }),
       sessionFile: admitted.sessionFile,
-      credential: credentialFailure
+      credential: credentialFailure,
+      runDirectory: admitted.runDirectory
     });
     return await presentControlledFailure2(
       admitted,
@@ -21543,7 +21849,10 @@ async function runPublicCollector(argv, env, io, parseCollectorArgv2) {
   });
   return await dispatchAdmittedCollector({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease
@@ -21563,8 +21872,8 @@ var init_collector_run = __esm({
 });
 
 // src/public-cli/doctor-run.ts
-import { writeFile as writeFile7 } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { writeFile as writeFile8 } from "node:fs/promises";
+import { join as join13 } from "node:path";
 function buildModelArgs3(model) {
   if (model === void 0) return [];
   return [
@@ -21668,8 +21977,8 @@ async function dispatchAdmittedDoctor(input) {
       );
     }
     try {
-      await writeFile7(
-        join12(admitted.runDirectory, "stderr.log"),
+      await writeFile8(
+        join13(admitted.runDirectory, "stderr.log"),
         result2.stderr,
         "utf8"
       );
@@ -21721,7 +22030,8 @@ async function dispatchAdmittedDoctor(input) {
     const knownFailure = await resolveAuditedRunnerKnownFailure({
       runner: result2.knownFailure,
       sessionFile: admitted.sessionFile,
-      credential: credentialFailure
+      credential: credentialFailure,
+      runDirectory: admitted.runDirectory
     });
     return await presentControlledFailure3(
       admitted,
@@ -21795,8 +22105,8 @@ var init_doctor_run = __esm({
 });
 
 // src/public-cli/fixer-run.ts
-import { writeFile as writeFile8 } from "node:fs/promises";
-import { join as join13 } from "node:path";
+import { writeFile as writeFile9 } from "node:fs/promises";
+import { join as join14 } from "node:path";
 function buildModelArgs4(model) {
   if (model === void 0) return [];
   return [
@@ -21879,17 +22189,25 @@ function buildFixerResumeActivationExtraArgs(admitted, options) {
 }
 async function presentControlledFailure4(admitted, failureInput, io) {
   const hasThrown = Object.hasOwn(failureInput, "thrown");
-  const session = !hasThrown && !failureInput.timedOut && failureInput.knownFailure === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
+  const resumeObservation = await resolveControlledFailureResumeObservation({
+    runDirectory: admitted.runDirectory,
+    ...failureInput.typedHttpObservationSettled === true ? {
+      typedHttpObservationSettled: true,
+      ...failureInput.typedHttpObservation === void 0 ? {} : { typedHttpObservation: failureInput.typedHttpObservation }
+    } : {}
+  });
+  const knownFailure = failureInput.knownFailure ?? resumeObservation.observationReadFailure;
+  const session = !hasThrown && !failureInput.timedOut && knownFailure === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
   const failure = classifyPostAdmissionFailure({
     timedOut: failureInput.timedOut,
     code: failureInput.code,
     stderr: failureInput.stderr,
     ...hasThrown ? { thrown: failureInput.thrown } : {},
-    ...explicitInternalKnownFailureClassificationInput(failureInput.knownFailure),
+    ...explicitInternalKnownFailureClassificationInput(knownFailure),
     ...session === void 0 ? {} : { session }
   });
   const hasLawfulTerminalResult = await hasLawfulFixerTerminalResult(admitted);
-  const typedHttp429 = await readTypedHttp429Observation(admitted.runDirectory);
+  const typedHttp429 = resumeObservation.typedHttp429;
   const sessionPrincipalAvailable = await isSessionPrincipalAvailable(
     admitted.sessionFile
   );
@@ -21936,8 +22254,9 @@ async function dispatchAdmittedFixer(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
-    if (env.correlationId !== void 0 && env.correlationId.trim() !== "") {
-      childEnv.AK_CORRELATION_ID = env.correlationId;
+    const correlationId = admitted.correlationId ?? env.correlationId;
+    if (correlationId !== void 0 && correlationId.trim() !== "") {
+      childEnv.AK_CORRELATION_ID = correlationId;
     }
     let result2;
     try {
@@ -21964,8 +22283,8 @@ async function dispatchAdmittedFixer(input) {
       );
     }
     try {
-      await writeFile8(
-        join13(admitted.runDirectory, "stderr.log"),
+      await writeFile9(
+        join14(admitted.runDirectory, "stderr.log"),
         result2.stderr,
         "utf8"
       );
@@ -22021,10 +22340,11 @@ async function dispatchAdmittedFixer(input) {
       env.model,
       env.credentials
     );
-    const knownFailure = await resolveAuditedRunnerKnownFailure({
+    const resolution = await resolveAuditedRunnerFailureResolution({
       runner: result2.knownFailure,
       sessionFile: admitted.sessionFile,
-      credential: credentialFailure
+      credential: credentialFailure,
+      runDirectory: admitted.runDirectory
     });
     return await presentControlledFailure4(
       admitted,
@@ -22032,7 +22352,7 @@ async function dispatchAdmittedFixer(input) {
         timedOut: result2.timedOut,
         code: result2.code,
         stderr: result2.stderr,
-        ...knownFailure === void 0 ? {} : { knownFailure }
+        ...controlledFailureInputFromResolution(resolution)
       },
       io
     );
@@ -22098,7 +22418,10 @@ async function runPublicFixer(argv, env, io, parseFixerArgv2) {
   });
   return await dispatchAdmittedFixer({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease,
@@ -22165,7 +22488,10 @@ async function runPublicFixerResume(argv, env, io) {
   });
   return await dispatchAdmittedFixer({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease,
@@ -22187,8 +22513,8 @@ var init_fixer_run = __esm({
 });
 
 // src/public-cli/judge-run.ts
-import { writeFile as writeFile9 } from "node:fs/promises";
-import { join as join14 } from "node:path";
+import { writeFile as writeFile10 } from "node:fs/promises";
+import { join as join15 } from "node:path";
 function buildModelArgs5(model) {
   if (model === void 0) return [];
   return [
@@ -22242,17 +22568,25 @@ function buildJudgeResumeActivationExtraArgs(admitted, options = {}) {
 }
 async function presentControlledFailure5(admitted, failureInput, io) {
   const hasThrown = Object.hasOwn(failureInput, "thrown");
-  const session = !hasThrown && !failureInput.timedOut && failureInput.knownFailure === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
+  const resumeObservation = await resolveControlledFailureResumeObservation({
+    runDirectory: admitted.runDirectory,
+    ...failureInput.typedHttpObservationSettled === true ? {
+      typedHttpObservationSettled: true,
+      ...failureInput.typedHttpObservation === void 0 ? {} : { typedHttpObservation: failureInput.typedHttpObservation }
+    } : {}
+  });
+  const knownFailure = failureInput.knownFailure ?? resumeObservation.observationReadFailure;
+  const session = !hasThrown && !failureInput.timedOut && knownFailure === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
   const failure = classifyPostAdmissionFailure({
     timedOut: failureInput.timedOut,
     code: failureInput.code,
     stderr: failureInput.stderr,
     ...hasThrown ? { thrown: failureInput.thrown } : {},
-    ...explicitInternalKnownFailureClassificationInput(failureInput.knownFailure),
+    ...explicitInternalKnownFailureClassificationInput(knownFailure),
     ...session === void 0 ? {} : { session }
   });
   const hasLawfulTerminalResult = await hasLawfulJudgeTerminalResult(admitted);
-  const typedHttp429 = await readTypedHttp429Observation(admitted.runDirectory);
+  const typedHttp429 = resumeObservation.typedHttp429;
   const sessionPrincipalAvailable = await isSessionPrincipalAvailable(
     admitted.sessionFile
   );
@@ -22301,8 +22635,9 @@ async function dispatchAdmittedJudge(input) {
       // and role-runtime can record typed provider HTTP observations.
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
-    if (env.correlationId !== void 0 && env.correlationId.trim() !== "") {
-      childEnv.AK_CORRELATION_ID = env.correlationId;
+    const correlationId = admitted.correlationId ?? env.correlationId;
+    if (correlationId !== void 0 && correlationId.trim() !== "") {
+      childEnv.AK_CORRELATION_ID = correlationId;
     }
     let result2;
     try {
@@ -22329,8 +22664,8 @@ async function dispatchAdmittedJudge(input) {
       );
     }
     try {
-      await writeFile9(
-        join14(admitted.runDirectory, "stderr.log"),
+      await writeFile10(
+        join15(admitted.runDirectory, "stderr.log"),
         result2.stderr,
         "utf8"
       );
@@ -22379,10 +22714,11 @@ async function dispatchAdmittedJudge(input) {
       env.model,
       env.credentials
     );
-    const knownFailure = await resolveAuditedRunnerKnownFailure({
+    const resolution = await resolveAuditedRunnerFailureResolution({
       runner: result2.knownFailure,
       sessionFile: admitted.sessionFile,
-      credential: credentialFailure
+      credential: credentialFailure,
+      runDirectory: admitted.runDirectory
     });
     return await presentControlledFailure5(
       admitted,
@@ -22390,7 +22726,7 @@ async function dispatchAdmittedJudge(input) {
         timedOut: result2.timedOut,
         code: result2.code,
         stderr: result2.stderr,
-        ...knownFailure === void 0 ? {} : { knownFailure }
+        ...controlledFailureInputFromResolution(resolution)
       },
       io
     );
@@ -22434,7 +22770,10 @@ async function runPublicJudge(argv, env, io, parseJudgeArgv2) {
   });
   return await dispatchAdmittedJudge({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease
@@ -22483,7 +22822,10 @@ async function runPublicResume(argv, env, io) {
   });
   return await dispatchAdmittedJudge({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease
@@ -22503,8 +22845,8 @@ var init_judge_run = __esm({
 });
 
 // src/public-cli/merger-run.ts
-import { mkdir as mkdir4, writeFile as writeFile10 } from "node:fs/promises";
-import { join as join15, resolve as resolve7 } from "node:path";
+import { mkdir as mkdir4, writeFile as writeFile11 } from "node:fs/promises";
+import { join as join16, resolve as resolve7 } from "node:path";
 function buildModelArgs6(model) {
   if (model === void 0) return [];
   return [
@@ -22573,20 +22915,28 @@ function buildMergerResumeActivationExtraArgs(admitted, options) {
 }
 async function presentControlledFailure6(admitted, failureInput, io) {
   const hasThrown = Object.hasOwn(failureInput, "thrown");
-  const session = !hasThrown && !failureInput.timedOut && failureInput.knownFailure === void 0 && failureInput.knownCause === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
+  const resumeObservation = await resolveControlledFailureResumeObservation({
+    runDirectory: admitted.runDirectory,
+    ...failureInput.typedHttpObservationSettled === true ? {
+      typedHttpObservationSettled: true,
+      ...failureInput.typedHttpObservation === void 0 ? {} : { typedHttpObservation: failureInput.typedHttpObservation }
+    } : {}
+  });
+  const knownFailure = failureInput.knownFailure ?? resumeObservation.observationReadFailure;
+  const session = !hasThrown && !failureInput.timedOut && knownFailure === void 0 && failureInput.knownCause === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
   const failure = classifyPostAdmissionFailure({
     timedOut: failureInput.timedOut,
     code: failureInput.code,
     stderr: failureInput.stderr,
     ...hasThrown ? { thrown: failureInput.thrown } : {},
-    ...explicitInternalKnownFailureClassificationInput(failureInput.knownFailure),
+    ...explicitInternalKnownFailureClassificationInput(knownFailure),
     ...failureInput.knownCause === void 0 ? {} : { knownCause: failureInput.knownCause },
     ...failureInput.knownIdentity === void 0 ? {} : { knownIdentity: failureInput.knownIdentity },
     ...failureInput.knownDiagnostic === void 0 ? {} : { knownDiagnostic: failureInput.knownDiagnostic },
     ...session === void 0 ? {} : { session }
   });
   const hasLawfulTerminalResult = await hasLawfulMergerTerminalResult(admitted);
-  const typedHttp429 = await readTypedHttp429Observation(admitted.runDirectory);
+  const typedHttp429 = resumeObservation.typedHttp429;
   const sessionPrincipalAvailable = await isSessionPrincipalAvailable(
     admitted.sessionFile
   );
@@ -22633,8 +22983,9 @@ async function dispatchAdmittedMerger(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
-    if (env.correlationId !== void 0 && env.correlationId.trim() !== "") {
-      childEnv.AK_CORRELATION_ID = env.correlationId;
+    const correlationId = admitted.correlationId ?? env.correlationId;
+    if (correlationId !== void 0 && correlationId.trim() !== "") {
+      childEnv.AK_CORRELATION_ID = correlationId;
     }
     let result2;
     try {
@@ -22661,8 +23012,8 @@ async function dispatchAdmittedMerger(input) {
       );
     }
     try {
-      await writeFile10(
-        join15(admitted.runDirectory, "stderr.log"),
+      await writeFile11(
+        join16(admitted.runDirectory, "stderr.log"),
         result2.stderr,
         "utf8"
       );
@@ -22704,10 +23055,11 @@ async function dispatchAdmittedMerger(input) {
       env.model,
       env.credentials
     );
-    const knownFailure = await resolveAuditedRunnerKnownFailure({
+    const resolution = await resolveAuditedRunnerFailureResolution({
       runner: result2.knownFailure,
       sessionFile: admitted.sessionFile,
-      credential: credentialFailure
+      credential: credentialFailure,
+      runDirectory: admitted.runDirectory
     });
     return await presentControlledFailure6(
       admitted,
@@ -22715,7 +23067,7 @@ async function dispatchAdmittedMerger(input) {
         timedOut: result2.timedOut,
         code: result2.code,
         stderr: result2.stderr,
-        ...knownFailure === void 0 ? {} : { knownFailure }
+        ...controlledFailureInputFromResolution(resolution)
       },
       io
     );
@@ -22742,9 +23094,9 @@ async function admitMergerShellForActivationFailure(options) {
     expectedConflictPaths: [],
     resolutionScope: []
   };
-  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
-  const mergerInputPath = join15(runDirectory, "merger-input.json");
-  await writeFile10(
+  const admittedRequestPath = join16(runDirectory, "admitted-request.json");
+  const mergerInputPath = join16(runDirectory, "merger-input.json");
+  await writeFile11(
     admittedRequestPath,
     `${JSON.stringify(
       {
@@ -22865,7 +23217,10 @@ async function runPublicMerger(argv, env, io, parseMergerArgv2) {
   });
   return await dispatchAdmittedMerger({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease,
@@ -22933,7 +23288,10 @@ async function runPublicMergerResume(argv, env, io) {
   });
   return await dispatchAdmittedMerger({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease,
@@ -22958,8 +23316,8 @@ var init_merger_run = __esm({
 });
 
 // src/public-cli/reviewer-run.ts
-import { writeFile as writeFile11 } from "node:fs/promises";
-import { join as join16 } from "node:path";
+import { writeFile as writeFile12 } from "node:fs/promises";
+import { join as join17 } from "node:path";
 function buildModelArgs7(model) {
   if (model === void 0) return [];
   return [
@@ -23028,17 +23386,25 @@ function buildReviewerResumeActivationExtraArgs(admitted, options) {
 }
 async function presentControlledFailure7(admitted, failureInput, io) {
   const hasThrown = Object.hasOwn(failureInput, "thrown");
-  const session = !hasThrown && !failureInput.timedOut && failureInput.knownFailure === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
+  const resumeObservation = await resolveControlledFailureResumeObservation({
+    runDirectory: admitted.runDirectory,
+    ...failureInput.typedHttpObservationSettled === true ? {
+      typedHttpObservationSettled: true,
+      ...failureInput.typedHttpObservation === void 0 ? {} : { typedHttpObservation: failureInput.typedHttpObservation }
+    } : {}
+  });
+  const knownFailure = failureInput.knownFailure ?? resumeObservation.observationReadFailure;
+  const session = !hasThrown && !failureInput.timedOut && knownFailure === void 0 ? await inspectJudgeSession(admitted.sessionFile) : void 0;
   const failure = classifyPostAdmissionFailure({
     timedOut: failureInput.timedOut,
     code: failureInput.code,
     stderr: failureInput.stderr,
     ...hasThrown ? { thrown: failureInput.thrown } : {},
-    ...explicitInternalKnownFailureClassificationInput(failureInput.knownFailure),
+    ...explicitInternalKnownFailureClassificationInput(knownFailure),
     ...session === void 0 ? {} : { session }
   });
   const hasLawfulTerminalResult = await hasLawfulReviewerTerminalResult(admitted);
-  const typedHttp429 = await readTypedHttp429Observation(admitted.runDirectory);
+  const typedHttp429 = resumeObservation.typedHttp429;
   const sessionPrincipalAvailable = await isSessionPrincipalAvailable(
     admitted.sessionFile
   );
@@ -23086,8 +23452,9 @@ async function dispatchAdmittedReviewer(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
-    if (env.correlationId !== void 0 && env.correlationId.trim() !== "") {
-      childEnv.AK_CORRELATION_ID = env.correlationId;
+    const correlationId = admitted.correlationId ?? env.correlationId;
+    if (correlationId !== void 0 && correlationId.trim() !== "") {
+      childEnv.AK_CORRELATION_ID = correlationId;
     }
     let result2;
     try {
@@ -23114,8 +23481,8 @@ async function dispatchAdmittedReviewer(input) {
       );
     }
     try {
-      await writeFile11(
-        join16(admitted.runDirectory, "stderr.log"),
+      await writeFile12(
+        join17(admitted.runDirectory, "stderr.log"),
         result2.stderr,
         "utf8"
       );
@@ -23171,7 +23538,7 @@ async function dispatchAdmittedReviewer(input) {
       env.model,
       env.credentials
     );
-    const knownFailure = await resolveAuditedRunnerKnownFailure({
+    const resolution = await resolveAuditedRunnerFailureResolution({
       runner: result2.knownFailure,
       sessionFile: admitted.sessionFile,
       credential: credentialFailure,
@@ -23183,7 +23550,7 @@ async function dispatchAdmittedReviewer(input) {
         timedOut: result2.timedOut,
         code: result2.code,
         stderr: result2.stderr,
-        ...knownFailure === void 0 ? {} : { knownFailure }
+        ...controlledFailureInputFromResolution(resolution)
       },
       io
     );
@@ -23248,7 +23615,10 @@ async function runPublicReviewer(argv, env, io, parseReviewerArgv2) {
   });
   return await dispatchAdmittedReviewer({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease,
@@ -23315,7 +23685,10 @@ async function runPublicReviewerResume(argv, env, io) {
   });
   return await dispatchAdmittedReviewer({
     admitted,
-    env,
+    env: {
+      ...env,
+      ...admitted.correlationId === void 0 ? {} : { correlationId: admitted.correlationId }
+    },
     io,
     extraArgs,
     lease,
@@ -23340,6 +23713,7 @@ var init_reviewer_run = __esm({
 var cli_exports = {};
 __export(cli_exports, {
   CliUsageError: () => CliUsageError,
+  PUBLIC_ROLE_ARGV: () => PUBLIC_ROLE_ARGV,
   buildExplicitInternalActivationArgs: () => buildExplicitInternalActivationArgs,
   helpDocument: () => helpDocument,
   resolveInternalRoleEntrypoint: () => resolveInternalRoleEntrypoint,
@@ -23347,7 +23721,43 @@ __export(cli_exports, {
 });
 import { realpath as realpath5 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
-import { join as join17 } from "node:path";
+import { join as join18 } from "node:path";
+function takePublicGlobalFlag(argv, index) {
+  const token = argv[index];
+  if (token === void 0) return void 0;
+  if (token === "--help" || token === "-h") {
+    return { flag: "help", consume: 1 };
+  }
+  if (token === "--model") {
+    const value = argv[index + 1];
+    if (value === void 0) {
+      return { flag: "model", consume: 1, value: void 0 };
+    }
+    return { flag: "model", consume: 2, value };
+  }
+  if (token.startsWith("--model=")) {
+    return {
+      flag: "model",
+      consume: 1,
+      value: token.slice("--model=".length)
+    };
+  }
+  if (token === "--thinking") {
+    const raw = argv[index + 1];
+    if (raw === void 0) {
+      return { flag: "thinking", consume: 1, raw: void 0 };
+    }
+    return { flag: "thinking", consume: 2, raw };
+  }
+  if (token.startsWith("--thinking=")) {
+    return {
+      flag: "thinking",
+      consume: 1,
+      raw: token.slice("--thinking=".length)
+    };
+  }
+  return void 0;
+}
 function defaultIo() {
   return {
     stdout: (text) => {
@@ -23362,7 +23772,7 @@ function resolveHome(env) {
   return env.home ?? process.env.HOME ?? homedir3();
 }
 function resolveAgentDir(env, home) {
-  return env.agentDir ?? process.env.PI_CODING_AGENT_DIR ?? join17(home, ".pi", "agent");
+  return env.agentDir ?? process.env.PI_CODING_AGENT_DIR ?? join18(home, ".pi", "agent");
 }
 function parseThinking(value) {
   if (!THINKING_LEVELS2.has(value)) {
@@ -23377,40 +23787,34 @@ function parseArgv(argv) {
   let help = false;
   const positional = [];
   while (args.length > 0) {
-    const token = args.shift();
-    if (token === "--") {
+    if (args[0] === "--") {
+      args.shift();
       positional.push(...args);
       break;
     }
-    if (token === "--help" || token === "-h") {
-      help = true;
-      continue;
-    }
-    if (token === "--model") {
-      const value = args.shift();
-      if (value === void 0) throw new CliUsageError("--model requires a value");
-      model = value;
-      continue;
-    }
-    if (token.startsWith("--model=")) {
-      model = token.slice("--model=".length);
-      continue;
-    }
-    if (token === "--thinking") {
-      const value = args.shift();
-      if (value === void 0) throw new CliUsageError("--thinking requires a value");
-      thinking = parseThinking(value);
-      continue;
-    }
-    if (token.startsWith("--thinking=")) {
-      thinking = parseThinking(token.slice("--thinking=".length));
-      continue;
-    }
-    if (token.startsWith("-") && token !== "-") {
-      positional.push(token);
+    const taken = takePublicGlobalFlag(args, 0);
+    if (taken !== void 0) {
+      if (taken.flag === "help") {
+        help = true;
+        args.splice(0, taken.consume);
+        continue;
+      }
+      if (taken.flag === "model") {
+        if (taken.value === void 0) {
+          throw new CliUsageError("--model requires a value");
+        }
+        model = taken.value;
+        args.splice(0, taken.consume);
+        continue;
+      }
+      if (taken.raw === void 0) {
+        throw new CliUsageError("--thinking requires a value");
+      }
+      thinking = parseThinking(taken.raw);
+      args.splice(0, taken.consume);
       continue;
     }
-    positional.push(token);
+    positional.push(args.shift());
   }
   const [command, ...rest] = positional;
   return {
@@ -23743,7 +24147,7 @@ async function runAkRole(argv, env) {
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
         },
         io,
-        parseJudgeArgv
+        PUBLIC_ROLE_ARGV.judge.parse
       );
       return {
         exitCode: result2.exitCode,
@@ -23777,7 +24181,7 @@ async function runAkRole(argv, env) {
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
         },
         io,
-        parseCoderArgv
+        PUBLIC_ROLE_ARGV.coder.parse
       );
       return {
         exitCode: result2.exitCode,
@@ -23811,7 +24215,7 @@ async function runAkRole(argv, env) {
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
         },
         io,
-        parseFixerArgv
+        PUBLIC_ROLE_ARGV.fixer.parse
       );
       return {
         exitCode: result2.exitCode,
@@ -23845,7 +24249,7 @@ async function runAkRole(argv, env) {
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
         },
         io,
-        parseCollectorArgv
+        PUBLIC_ROLE_ARGV.collector.parse
       );
       return {
         exitCode: result2.exitCode,
@@ -23879,7 +24283,7 @@ async function runAkRole(argv, env) {
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
         },
         io,
-        parseReviewerArgv
+        PUBLIC_ROLE_ARGV.reviewer.parse
       );
       return {
         exitCode: result2.exitCode,
@@ -23913,7 +24317,7 @@ async function runAkRole(argv, env) {
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
         },
         io,
-        parseDoctorArgv
+        PUBLIC_ROLE_ARGV.doctor.parse
       );
       return {
         exitCode: result2.exitCode,
@@ -23947,7 +24351,7 @@ async function runAkRole(argv, env) {
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
         },
         io,
-        parseMergerArgv
+        PUBLIC_ROLE_ARGV.merger.parse
       );
       return {
         exitCode: result2.exitCode,
@@ -23969,7 +24373,7 @@ async function runAkRole(argv, env) {
     return { exitCode: 1 };
   }
 }
-var THINKING_LEVELS2;
+var PUBLIC_ROLE_ARGV, THINKING_LEVELS2;
 var init_cli = __esm({
   "src/public-cli/cli.ts"() {
     "use strict";
@@ -23989,6 +24393,15 @@ var init_cli = __esm({
     init_settlement();
     init_explicit_internal();
     init_cli_errors();
+    PUBLIC_ROLE_ARGV = {
+      judge: { parse: parseJudgeArgv },
+      coder: { parse: parseCoderArgv },
+      fixer: { parse: parseFixerArgv },
+      collector: { parse: parseCollectorArgv },
+      doctor: { parse: parseDoctorArgv },
+      merger: { parse: parseMergerArgv },
+      reviewer: { parse: parseReviewerArgv }
+    };
     THINKING_LEVELS2 = /* @__PURE__ */ new Set([
       "off",
       "minimal",
@@ -24002,7 +24415,7 @@ var init_cli = __esm({
 });
 
 // src/public-cli/main.ts
-import { dirname as dirname7, join as join18 } from "node:path";
+import { dirname as dirname7, join as join19 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/public-cli/host-pi-runtime.ts
@@ -24090,7 +24503,7 @@ function linkPackage(packageRoot2, name, targetDir) {
 
 // src/public-cli/main.ts
 var here = dirname7(fileURLToPath2(import.meta.url));
-var packageRoot = join18(here, "..", "..");
+var packageRoot = join19(here, "..", "..");
 ensureHostPiRuntimeResolvable(packageRoot);
 var { runAkRole: runAkRole2 } = await Promise.resolve().then(() => (init_cli(), cli_exports));
 var result = await runAkRole2(process.argv.slice(2), { packageRoot });