@akagilnc/pi-workflow-roles 0.1.3758 → 0.1.3783

package/dist/public-cli/main.js

@@ -508,10 +508,16 @@ function validateAcceptedCollectorReceipt(value) {
     materials: records(safeGet(group, "materials")),
     findings: records(safeGet(group, "findings"))
   }));
+  const unfinishedRaw = safeGet(value, "unfinishedReasons");
+  const unfinishedReasons = strings(unfinishedRaw);
+  const submissionProjection = projectSubmissionProjection(safeGet(value, "submissionProjection"));
+  const prStateRaw = safeGet(value, "prState");
+  const prState = typeof prStateRaw === "string" ? prStateRaw : void 0;
   return {
     host: safeGet(value, "host"),
     repository: safeGet(value, "repository"),
     prNumber: safeGet(value, "prNumber"),
+    ...prState === void 0 ? {} : { prState },
     manifestDigest: safeGet(value, "manifestDigest"),
     activationTime: safeGet(value, "activationTime"),
     deadlineTime: safeGet(value, "deadlineTime"),
@@ -519,6 +525,8 @@ function validateAcceptedCollectorReceipt(value) {
     finalSnapshotId: safeGet(value, "finalSnapshotId"),
     targetHead: safeGet(value, "targetHead"),
     groups,
+    ...unfinishedReasons.length > 0 ? { unfinishedReasons } : {},
+    ...submissionProjection === void 0 ? {} : { submissionProjection },
     requestAttempts: records(safeGet(value, "requestAttempts")),
     snapshots: records(safeGet(value, "snapshots")).map((snapshot) => ({
       snapshotId: safeGet(snapshot, "snapshotId"),
@@ -538,6 +546,30 @@ function validateAcceptedCollectorReceipt(value) {
     evidenceRecords: records(safeGet(value, "evidenceRecords")).map((record4) => ({ evidenceId: safeGet(record4, "evidenceId"), kind: safeGet(record4, "kind"), versionId: safeGet(record4, "versionId"), contentDigest: safeGet(record4, "contentDigest"), firstObservedAt: safeGet(record4, "firstObservedAt"), githubId: safeGet(record4, "githubId"), authorLogin: safeGet(record4, "authorLogin"), htmlUrl: safeGet(record4, "htmlUrl"), authoritativeTime: safeGet(record4, "authoritativeTime") }))
   };
 }
+function projectSubmissionProjection(raw) {
+  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+  const p = raw;
+  const out = {};
+  if (p["findingsSource"] === "absent" || p["findingsSource"] === "array" || p["findingsSource"] === "unreadable") {
+    out.findingsSource = p["findingsSource"];
+  }
+  if (typeof p["findingsProjectedCount"] === "number") {
+    out.findingsProjectedCount = p["findingsProjectedCount"];
+  }
+  if (typeof p["findingsUnprojected"] === "boolean") {
+    out.findingsUnprojected = p["findingsUnprojected"];
+  }
+  if (p["unfinishedReasonsSource"] === "absent" || p["unfinishedReasonsSource"] === "array" || p["unfinishedReasonsSource"] === "unreadable") {
+    out.unfinishedReasonsSource = p["unfinishedReasonsSource"];
+  }
+  if (typeof p["unfinishedReasonsProjectedCount"] === "number") {
+    out.unfinishedReasonsProjectedCount = p["unfinishedReasonsProjectedCount"];
+  }
+  if (typeof p["unfinishedReasonsUnprojected"] === "boolean") {
+    out.unfinishedReasonsUnprojected = p["unfinishedReasonsUnprojected"];
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
 var COLLECTOR_OUTPUT_TOOL;
 var init_collector_output = __esm({
   "src/package-contracts/collector-output.ts"() {
@@ -8344,27 +8376,28 @@ function withInfrastructureFailureDeclaration(schema) {
   object.required = [];
   return object;
 }
-var INFRASTRUCTURE_FAILURE_DECLARATION_KEY, INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY, infrastructureFailureDeclarationSchema;
+var INFRASTRUCTURE_FAILURE_DECLARATION_KEY, INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY, infrastructureFailureNested, infrastructureFailureDeclarationSchema;
 var init_terminating_infrastructure = __esm({
   "src/package-contracts/terminating-infrastructure.ts"() {
     "use strict";
     init_build();
     INFRASTRUCTURE_FAILURE_DECLARATION_KEY = "infrastructureFailure";
     INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY = "diagnostic";
+    infrastructureFailureNested = typebox_exports.Object(
+      {
+        [INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY]: typebox_exports.Unknown({
+          description: "\u975E\u7A7A\u57FA\u7840\u8BBE\u65BD\u5931\u8D25\u8BCA\u65AD\u5B57\u7B26\u4E32\u3002\u65E0\u5931\u8D25\u65F6\u5FC5\u987B\u7701\u7565\u6574\u4E2A infrastructureFailure\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
+        })
+      },
+      {
+        additionalProperties: true,
+        description: "\u57FA\u7840\u8BBE\u65BD\u771F\u5B9E\u5931\u8D25\u58F0\u660E\uFF08\u5982\u9700\uFF09\u3002\u89C4\u8303\u5F62\uFF1A{ diagnostic: \u975E\u7A7A\u8BCA\u65AD\u5B57\u7B26\u4E32 }\uFF1B\u65E0\u5931\u8D25\u65F6\u5FC5\u987B\u7701\u7565\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
+      }
+    );
+    infrastructureFailureNested.required = [];
     infrastructureFailureDeclarationSchema = typebox_exports.Object(
       {
-        [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: typebox_exports.Object(
-          {
-            [INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY]: typebox_exports.String({
-              minLength: 1,
-              description: "\u975E\u7A7A\u57FA\u7840\u8BBE\u65BD\u5931\u8D25\u8BCA\u65AD"
-            })
-          },
-          {
-            additionalProperties: true,
-            description: "\u57FA\u7840\u8BBE\u65BD\u5931\u8D25\u58F0\u660E"
-          }
-        )
+        [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: infrastructureFailureNested
       },
       { additionalProperties: true }
     );
@@ -15420,16 +15453,24 @@ var init_institutional_resolution = __esm({
 function lookupHostDescription(host) {
   return Object.hasOwn(HOST_DESCRIPTIONS, host) ? HOST_DESCRIPTIONS[host] : void 0;
 }
+function lookupHeadlessHostDescription(host) {
+  return Object.hasOwn(HEADLESS_HOST_DESCRIPTIONS, host) ? HEADLESS_HOST_DESCRIPTIONS[host] : void 0;
+}
+function lookupHostFamily(host) {
+  if (lookupHostDescription(host) !== void 0) return "acp";
+  if (lookupHeadlessHostDescription(host) !== void 0) return "headless";
+  return void 0;
+}
 function packagedExternalHostNames() {
-  return Object.keys(HOST_DESCRIPTIONS);
+  return [...Object.keys(HOST_DESCRIPTIONS), ...Object.keys(HEADLESS_HOST_DESCRIPTIONS)];
 }
 function assertRegisteredHostName(host) {
-  if (host === DEFAULT_ROLE_TURN_HOST || lookupHostDescription(host) !== void 0) {
+  if (host === DEFAULT_ROLE_TURN_HOST || lookupHostFamily(host) !== void 0) {
     return host;
   }
   throw new Error(`unregistered host: ${host}`);
 }
-var PRIVATE_COMPAT_ENV, DEFAULT_ROLE_TURN_HOST, HOST_DESCRIPTIONS;
+var PRIVATE_COMPAT_ENV, DEFAULT_ROLE_TURN_HOST, HOST_DESCRIPTIONS, HEADLESS_HOST_DESCRIPTIONS;
 var init_host_descriptions = __esm({
   "src/host-descriptions.ts"() {
     "use strict";
@@ -15481,6 +15522,33 @@ var init_host_descriptions = __esm({
         })
       })
     });
+    HEADLESS_HOST_DESCRIPTIONS = Object.freeze({
+      "claude": Object.freeze({
+        binaryFromHome: Object.freeze([".local", "bin", "claude"]),
+        sessionBindingFile: "claude-headless-session.json",
+        fixedArgs: Object.freeze([
+          // One result envelope (not stream-json): typed receipt only; no event-stream copy.
+          "--output-format",
+          "json",
+          "--permission-mode",
+          "bypassPermissions",
+          // Empty sources: no user/project/local operator surface (envelope owns materials).
+          "--setting-sources",
+          "",
+          // With adapter-supplied --mcp-config only (AK relay); drops operator + claude.ai MCP.
+          "--strict-mcp-config"
+        ]),
+        promptFlag: "-p",
+        modelFlag: "--model",
+        effortFlag: "--effort",
+        // File path keeps large role envelopes off ARG_MAX.
+        systemPromptFlag: "--system-prompt-file",
+        jsonSchemaFlag: "--json-schema",
+        mcpConfigFlag: "--mcp-config",
+        sessionIdFlag: "--session-id",
+        resumeFlag: "--resume"
+      })
+    });
   }
 });
 
@@ -16121,6 +16189,50 @@ var init_load_production_acp_host = __esm({
   }
 });
 
+// src/public-cli/load-production-headless-host.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { join as join8 } from "node:path";
+import { pathToFileURL as pathToFileURL2 } from "node:url";
+async function loadProductionHeadlessHostFactory(packageRoot2, host) {
+  const description = lookupHeadlessHostDescription(host);
+  if (description === void 0) {
+    throw new Error(`unregistered headless host: ${host}`);
+  }
+  const built = join8(packageRoot2, "dist/headless-host/production-host.js");
+  const source = join8(packageRoot2, "src/headless-host/production-host.ts");
+  const target = existsSync4(built) ? built : source;
+  const href = pathToFileURL2(target).href;
+  const mod = await import(href);
+  const create = mod.createProductionHeadlessRoleTurnHost;
+  return (options) => create({ ...options, description });
+}
+var init_load_production_headless_host = __esm({
+  "src/public-cli/load-production-headless-host.ts"() {
+    "use strict";
+    init_host_descriptions();
+  }
+});
+
+// src/public-cli/load-production-external-host.ts
+async function loadProductionExternalHostFactory(packageRoot2, host) {
+  const family = lookupHostFamily(host);
+  if (family === "acp") {
+    return loadProductionAcpHostFactory(packageRoot2, host);
+  }
+  if (family === "headless") {
+    return loadProductionHeadlessHostFactory(packageRoot2, host);
+  }
+  throw new Error(`unregistered host: ${host}`);
+}
+var init_load_production_external_host = __esm({
+  "src/public-cli/load-production-external-host.ts"() {
+    "use strict";
+    init_host_descriptions();
+    init_load_production_acp_host();
+    init_load_production_headless_host();
+  }
+});
+
 // src/host-contracts.ts
 var ExplicitInternalActivationError;
 var init_host_contracts = __esm({
@@ -16188,12 +16300,12 @@ var init_sitian_contracts = __esm({
 import { createHash as createHash2, randomUUID } from "node:crypto";
 import {
   appendFileSync,
-  existsSync as existsSync4,
+  existsSync as existsSync5,
   readFileSync as readFileSync2,
   unlinkSync,
   writeFileSync
 } from "node:fs";
-import { basename as basename3, dirname as dirname5, join as join8, resolve as resolve3 } from "node:path";
+import { basename as basename3, dirname as dirname5, join as join9, resolve as resolve3 } from "node:path";
 function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -16208,14 +16320,14 @@ function createExclusiveFile(path, contents) {
   writeFileSync(path, contents, { encoding: "utf8", flag: "wx" });
 }
 function sealTornTail(recordFile) {
-  if (!existsSync4(recordFile)) return;
+  if (!existsSync5(recordFile)) return;
   const buffer = readFileSync2(recordFile);
   if (buffer.length > 0 && buffer[buffer.length - 1] !== 10) {
     appendFileSync(recordFile, "\n", "utf8");
   }
 }
 function findIdentityPointer(recordFile, identity, kind, level) {
-  if (!existsSync4(recordFile)) return void 0;
+  if (!existsSync5(recordFile)) return void 0;
   const text = readFileSync2(recordFile, "utf8");
   for (const line2 of text.split("\n")) {
     const trimmed = line2.trim();
@@ -16332,7 +16444,7 @@ function resolveSitianRecordPathInLedger(input, ledgerHome) {
   const category = resolveSitianVolumeCategory(input.kind);
   let sessionDir;
   if (input.sessionParent !== void 0 && input.sessionParent.length > 0 && physicallyContainedIn(ledgerHome, input.sessionParent)) {
-    sessionDir = join8(dirname5(input.sessionParent), category);
+    sessionDir = join9(dirname5(input.sessionParent), category);
   } else {
     const bookKey = safeBookKey(cwd);
     const bookDir = activationBookDirectory(ledgerHome, bookKey);
@@ -16346,12 +16458,12 @@ function resolveSitianRecordPathInLedger(input, ledgerHome) {
         subjectStr = JSON.stringify(input.subject);
       }
       const digest = createHash2("sha256").update(subjectStr).digest("hex").slice(0, 32);
-      sessionDir = join8(bookDir, category, digest);
+      sessionDir = join9(bookDir, category, digest);
     } else {
-      sessionDir = join8(bookDir, category);
+      sessionDir = join9(bookDir, category);
     }
   }
-  const recordFile = join8(sessionDir, "records.jsonl");
+  const recordFile = join9(sessionDir, "records.jsonl");
   return { sessionDir, recordFile, ledgerHome };
 }
 function resolveSitianRecordPath(input) {
@@ -16408,13 +16520,13 @@ var init_sitian_appender = __esm({
 });
 
 // src/sitian-reader.ts
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync6 } from "node:fs";
 import { readFile as readFile2 } from "node:fs/promises";
 function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 async function readSitianRecords(recordFile) {
-  if (!existsSync5(recordFile)) {
+  if (!existsSync6(recordFile)) {
     return { records: [], diagnostics: [] };
   }
   const text = await readFile2(recordFile, "utf8");
@@ -16472,12 +16584,12 @@ var init_sitian_facade = __esm({
 import { execFile, spawn } from "node:child_process";
 import { constants } from "node:fs";
 import { access, appendFile, readFile as readFile3, realpath } from "node:fs/promises";
-import { delimiter as delimiter2, isAbsolute as isAbsolute3, join as join9, resolve as resolve4 } from "node:path";
+import { delimiter as delimiter2, isAbsolute as isAbsolute3, join as join10, resolve as resolve4 } from "node:path";
 import { platform } from "node:process";
 import { promisify } from "node:util";
 import { randomUUID as randomUUID2 } from "node:crypto";
 function resolveInternalRoleEntrypoint(packageRoot2) {
-  return join9(packageRoot2, INTERNAL_ROLE_ENTRYPOINT_RELATIVE2);
+  return join10(packageRoot2, INTERNAL_ROLE_ENTRYPOINT_RELATIVE2);
 }
 function buildExplicitInternalActivationArgs(selectedRoleEntry, extraArgs = []) {
   return ["--no-extensions", "-e", selectedRoleEntry, ...extraArgs];
@@ -16532,8 +16644,7 @@ function buildActivationFlagArgs(activation) {
         "collector",
         "--ak-collector-repo",
         activation.repo,
-        "--ak-collector-pr",
-        activation.pr,
+        ...activation.pr === void 0 ? [] : ["--ak-collector-pr", activation.pr],
         ...activation.requestManifestPath === void 0 ? [] : ["--ak-collector-request-manifest", activation.requestManifestPath]
       ];
     case "doctor":
@@ -16822,7 +16933,7 @@ var init_role_turn_host = __esm({
 
 // src/run-ticket-number.ts
 import { readFile as readFile4 } from "node:fs/promises";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 function isEnoent(error) {
   return error instanceof Error && "code" in error && error.code === "ENOENT";
 }
@@ -16835,7 +16946,7 @@ function ticketFromRecord(record4) {
 }
 async function readPageTicketNumber(runDirectory, page) {
   try {
-    const raw = JSON.parse(await readFile4(join10(runDirectory, page), "utf8"));
+    const raw = JSON.parse(await readFile4(join11(runDirectory, page), "utf8"));
     if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
       return void 0;
     }
@@ -17276,13 +17387,356 @@ async function loadCollectorManifest(path) {
   const canonicalJson2 = canonicalManifest(requests);
   return { requests, canonicalJson: canonicalJson2, digest: createHash3("sha256").update(canonicalJson2).digest("hex"), sourcePath: path };
 }
-var COLLECTOR_OWNER_PATTERN, COLLECTOR_REPO_PATTERN, COLLECTOR_FIXED_KICKOFF;
+var COLLECTOR_OWNER_PATTERN, COLLECTOR_REPO_PATTERN;
 var init_collector_config = __esm({
   "src/collector-config.ts"() {
     "use strict";
     COLLECTOR_OWNER_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$/;
     COLLECTOR_REPO_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,98}[A-Za-z0-9])?$/;
-    COLLECTOR_FIXED_KICKOFF = "\u91C7\u96C6\u76EE\u6807\u5DF2\u53D7\u7406\uFF0C\u672C\u5C40\u5F00\u59CB\u3002";
+  }
+});
+
+// src/collector-github.ts
+import { spawn as spawn2 } from "node:child_process";
+function isRecord9(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseJson(text, label) {
+  try {
+    return JSON.parse(text);
+  } catch (error) {
+    throw new Error(`GitHub ${label} returned malformed JSON`, { cause: error });
+  }
+}
+function parsePullRequestNumberList(raw, label) {
+  if (!Array.isArray(raw)) {
+    throw new Error(`GitHub ${label} payload is not a list`);
+  }
+  const numbers = [];
+  for (const item of raw) {
+    if (!isRecord9(item)) {
+      throw new Error(`GitHub ${label} payload contains a non-object pull request entry`);
+    }
+    try {
+      numbers.push(parseCollectorPrNumber(item["number"]));
+    } catch (error) {
+      throw new Error(`GitHub ${label} payload contains an invalid pull request number`, {
+        cause: error
+      });
+    }
+  }
+  return numbers;
+}
+async function listPullRequestNumbersByHead(runner, input) {
+  const head = `${input.headOwner}:${input.headRef}`;
+  const path = `/repos/${input.owner}/${input.repo}/pulls?head=${encodeURIComponent(head)}&state=all&per_page=100`;
+  const response = await runner(
+    ["api", "--hostname", "github.com", "--include", "-X", "GET", path],
+    input.signal === void 0 ? {} : { signal: input.signal }
+  );
+  if (response.status < 200 || response.status >= 300) {
+    throw new Error(`GitHub ${path} failed with HTTP ${response.status}`, {
+      cause: {
+        endpoint: path,
+        status: response.status,
+        headers: response.headers,
+        body: response.bodyText
+      }
+    });
+  }
+  return parsePullRequestNumberList(parseJson(response.bodyText, path), path);
+}
+async function listPullRequestNumbersByCommit(runner, input) {
+  const path = `/repos/${input.owner}/${input.repo}/commits/${encodeURIComponent(input.commitSha)}/pulls`;
+  const response = await runner(
+    ["api", "--hostname", "github.com", "--include", "-X", "GET", path],
+    input.signal === void 0 ? {} : { signal: input.signal }
+  );
+  if (response.status < 200 || response.status >= 300) {
+    throw new Error(`GitHub ${path} failed with HTTP ${response.status}`, {
+      cause: {
+        endpoint: path,
+        status: response.status,
+        headers: response.headers,
+        body: response.bodyText
+      }
+    });
+  }
+  return parsePullRequestNumberList(parseJson(response.bodyText, path), path);
+}
+function createGhApiRunner(options = {}) {
+  const spawnImpl = options.spawnImpl ?? spawn2;
+  return async (args, runOptions = {}) => {
+    return await new Promise((resolve11, reject) => {
+      const signal = runOptions.signal;
+      if (signal?.aborted) {
+        reject(signal.reason ?? new Error("aborted"));
+        return;
+      }
+      const child = spawnImpl("gh", args, {
+        env: options.env ?? process.env,
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      let stdout = "";
+      let stderr = "";
+      let settled = false;
+      const settle = (fn) => {
+        if (settled) return;
+        settled = true;
+        if (signal !== void 0) {
+          signal.removeEventListener("abort", onAbort);
+        }
+        fn();
+      };
+      const onAbort = () => {
+        try {
+          child.kill("SIGTERM");
+        } catch (error) {
+          settle(() => reject(error));
+          return;
+        }
+        settle(() => {
+          reject(signal?.reason ?? new Error("aborted"));
+        });
+      };
+      if (signal !== void 0) {
+        signal.addEventListener("abort", onAbort, { once: true });
+      }
+      child.stdout.setEncoding("utf8").on("data", (chunk) => {
+        stdout += chunk;
+      });
+      child.stderr.setEncoding("utf8").on("data", (chunk) => {
+        stderr += chunk;
+      });
+      child.on("error", (error) => {
+        settle(() => reject(error));
+      });
+      child.stdin.on("error", (error) => {
+        settle(() => {
+          if (signal?.aborted) {
+            reject(signal.reason ?? new Error("aborted"));
+            return;
+          }
+          const err = error instanceof Error ? error : new Error(String(error));
+          reject(Object.assign(err, { ambiguousGhFailure: true }));
+        });
+      });
+      if (runOptions.stdin !== void 0) {
+        child.stdin.write(runOptions.stdin);
+      }
+      child.stdin.end();
+      child.on("close", (code, signal2) => {
+        settle(() => {
+          const match = stdout.match(/^HTTP\/[\d.]+\s+(\d+)[^\n]*\r?\n([\s\S]*?)\r?\n\r?\n([\s\S]*)$/);
+          if (match) {
+            const status = Number(match[1]);
+            const headerText = match[2] ?? "";
+            const bodyText = match[3] ?? "";
+            const headers = {};
+            for (const line2 of headerText.split(/\r?\n/)) {
+              const idx = line2.indexOf(":");
+              if (idx === -1) continue;
+              const name = line2.slice(0, idx).trim().toLowerCase();
+              const value = line2.slice(idx + 1).trim();
+              headers[name] = value;
+            }
+            resolve11({ status, headers, bodyText });
+            return;
+          }
+          if (code === 0) {
+            resolve11({ status: 200, headers: {}, bodyText: stdout });
+            return;
+          }
+          const failure = new Error(
+            `gh api failed without a parseable HTTP response (code=${String(code)}): ${stderr || stdout}`,
+            { cause: { code, signal: signal2, stderr, stdout } }
+          );
+          reject(Object.assign(failure, { ambiguousGhFailure: true, stderr, stdout, code, signal: signal2 }));
+        });
+      });
+    });
+  };
+}
+var init_collector_github = __esm({
+  "src/collector-github.ts"() {
+    "use strict";
+    init_collector_config();
+  }
+});
+
+// src/public-cli/github-remote.ts
+function ownerFromGitHubRemoteUrl(remoteUrl) {
+  const ownerRepo = ownerRepoFromGitHubRemoteUrl(remoteUrl);
+  if (ownerRepo === void 0) return void 0;
+  return ownerRepo.split("/")[0].toLowerCase();
+}
+function ownerRepoFromGitHubRemoteUrl(remoteUrl) {
+  const trimmed = remoteUrl.trim();
+  const scp = /^git@github\.com:([^/\s]+)\/([^/\s]+?)(?:\.git)?$/i.exec(trimmed);
+  if (scp) {
+    return `${scp[1]}/${stripGitSuffix(scp[2])}`;
+  }
+  const ssh = /^ssh:\/\/git@github\.com\/([^/\s]+)\/([^/\s]+?)(?:\.git)?\/?$/i.exec(
+    trimmed
+  );
+  if (ssh) {
+    return `${ssh[1]}/${stripGitSuffix(ssh[2])}`;
+  }
+  let parsed;
+  try {
+    parsed = new URL(trimmed);
+  } catch {
+    return void 0;
+  }
+  if (!/^github\.com$/i.test(parsed.hostname)) return void 0;
+  if (parsed.search !== "" || parsed.hash !== "") return void 0;
+  const parts = parsed.pathname.split("/").filter((p) => p.length > 0);
+  if (parts.length !== 2) return void 0;
+  return `${parts[0]}/${stripGitSuffix(parts[1])}`;
+}
+function stripGitSuffix(name) {
+  return name.toLowerCase().endsWith(".git") ? name.slice(0, -4) : name;
+}
+var init_github_remote = __esm({
+  "src/public-cli/github-remote.ts"() {
+    "use strict";
+  }
+});
+
+// src/collector-target.ts
+import { execFileSync as execFileSync2 } from "node:child_process";
+function ambiguousTarget(detail, cause) {
+  throw new CliUsageError(
+    `collector target is ambiguous: ${detail}; pass an explicit --pr`,
+    cause === void 0 ? void 0 : { cause }
+  );
+}
+function gitFailure(detail, cause) {
+  throw new Error(`collector git failed: ${detail}`, {
+    cause: cause instanceof Error ? cause : new Error(String(cause))
+  });
+}
+function gitText(projectRoot, args) {
+  return execFileSync2("git", [...args], {
+    cwd: projectRoot,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"]
+  }).trim();
+}
+function isGitConfigMissing(error) {
+  if (typeof error !== "object" || error === null) return false;
+  const status = error.status;
+  return status === 1;
+}
+function readCurrentBranch(projectRoot) {
+  try {
+    return gitText(projectRoot, ["rev-parse", "--abbrev-ref", "HEAD"]);
+  } catch (error) {
+    gitFailure("cannot read current git branch", error);
+  }
+}
+function readHeadSha(projectRoot) {
+  try {
+    return gitText(projectRoot, ["rev-parse", "HEAD"]);
+  } catch (error) {
+    gitFailure("cannot read current HEAD", error);
+  }
+}
+function headRefFromMerge(merge) {
+  const trimmed = merge.trim();
+  if (trimmed.length === 0) return void 0;
+  if (trimmed.startsWith("refs/heads/")) {
+    const ref = trimmed.slice("refs/heads/".length);
+    return ref.length > 0 ? ref : void 0;
+  }
+  if (trimmed.startsWith("refs/")) return void 0;
+  return trimmed;
+}
+function readUpstreamHeadBinding(projectRoot, branch) {
+  let remote;
+  try {
+    remote = gitText(projectRoot, ["config", "--get", `branch.${branch}.remote`]);
+  } catch (error) {
+    if (isGitConfigMissing(error)) remote = void 0;
+    else gitFailure(`cannot read branch.${branch}.remote`, error);
+  }
+  if (remote === void 0 || remote.length === 0) return void 0;
+  let merge;
+  try {
+    merge = gitText(projectRoot, ["config", "--get", `branch.${branch}.merge`]);
+  } catch (error) {
+    if (isGitConfigMissing(error)) merge = void 0;
+    else gitFailure(`cannot read branch.${branch}.merge`, error);
+  }
+  if (merge === void 0 || merge.length === 0) return void 0;
+  const headRef = headRefFromMerge(merge);
+  if (headRef === void 0) return void 0;
+  let remoteUrl;
+  try {
+    remoteUrl = gitText(projectRoot, ["remote", "get-url", remote]);
+  } catch (error) {
+    gitFailure(`cannot read remote URL for ${remote}`, error);
+  }
+  const headOwner = ownerFromGitHubRemoteUrl(remoteUrl);
+  if (headOwner === void 0) return void 0;
+  return { headOwner, headRef };
+}
+async function resolveCollectorTarget(input) {
+  if (input.explicitPrNumber !== void 0) {
+    return { kind: "bound", prNumber: input.explicitPrNumber };
+  }
+  const branch = readCurrentBranch(input.projectRoot);
+  const detached = branch.length === 0 || branch === "HEAD";
+  const runner = createGhApiRunner();
+  const { owner, repo } = input.repository;
+  const numbers = [];
+  if (!detached) {
+    const headSha = readHeadSha(input.projectRoot);
+    const upstream = readUpstreamHeadBinding(input.projectRoot, branch);
+    if (upstream !== void 0) {
+      numbers.push(
+        ...await listPullRequestNumbersByHead(runner, {
+          owner,
+          repo,
+          headOwner: upstream.headOwner,
+          headRef: upstream.headRef
+        })
+      );
+    }
+    numbers.push(
+      ...await listPullRequestNumbersByCommit(runner, {
+        owner,
+        repo,
+        commitSha: headSha
+      })
+    );
+  } else {
+    const headSha = readHeadSha(input.projectRoot);
+    numbers.push(
+      ...await listPullRequestNumbersByCommit(runner, {
+        owner,
+        repo,
+        commitSha: headSha
+      })
+    );
+  }
+  const unique = [...new Set(numbers)];
+  if (unique.length === 1) {
+    return { kind: "bound", prNumber: unique[0] };
+  }
+  if (unique.length > 1) {
+    ambiguousTarget(
+      `multiple PRs associated with context: ${unique.join(", ")}`
+    );
+  }
+  return { kind: "unbound" };
+}
+var init_collector_target = __esm({
+  "src/collector-target.ts"() {
+    "use strict";
+    init_collector_github();
+    init_cli_errors();
+    init_github_remote();
   }
 });
 
@@ -17388,9 +17842,9 @@ var init_uuidv7 = __esm({
 
 // src/typed-provider-http.ts
 import { readFile as readFile7, unlink, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 function typedProviderHttpPath(runDirectory) {
-  return join11(runDirectory, TYPED_HTTP_FILE);
+  return join12(runDirectory, TYPED_HTTP_FILE);
 }
 async function clearTypedProviderHttpObservation(runDirectory) {
   try {
@@ -17435,7 +17889,7 @@ var init_typed_provider_http = __esm({
 
 // src/public-cli/run-lifecycle.ts
 import { chmod, open, readdir as readdir2, readFile as readFile8, unlink as unlink2, writeFile as writeFile3 } from "node:fs/promises";
-import { isAbsolute as isAbsolute4, join as join12 } from "node:path";
+import { isAbsolute as isAbsolute4, join as join13 } from "node:path";
 function resumeRereadInstruction(materialPath, handbook) {
   return handbook ? `\u91CD\u65B0\u8BFB ${materialPath}\uFF0C\u518D\u7EC4\u88C5\u5916\u5305 argv` : `\u91CD\u65B0\u8BFB ${materialPath}`;
 }
@@ -17483,7 +17937,7 @@ function renderResumeCommand(runId) {
 async function writeRoleRunState(runDirectory, record4) {
   const payload = { ...record4, runDirectory };
   await writeFile3(
-    join12(runDirectory, RUN_STATE_FILE),
+    join13(runDirectory, RUN_STATE_FILE),
     `${JSON.stringify(payload, null, 2)}
 `,
     "utf8"
@@ -17533,7 +17987,7 @@ function parseCurrentCourtState(raw) {
 async function readRoleRunStateDisk(runDirectory) {
   let raw;
   try {
-    raw = JSON.parse(await readFile8(join12(runDirectory, RUN_STATE_FILE), "utf8"));
+    raw = JSON.parse(await readFile8(join13(runDirectory, RUN_STATE_FILE), "utf8"));
   } catch {
     return void 0;
   }
@@ -17600,7 +18054,7 @@ async function writeRoleRunStateDisk(runDirectory, disk) {
     ...disk.currentCourt === void 0 ? {} : { currentCourt: disk.currentCourt }
   };
   await writeFile3(
-    join12(runDirectory, RUN_STATE_FILE),
+    join13(runDirectory, RUN_STATE_FILE),
     `${JSON.stringify(payload, null, 2)}
 `,
     "utf8"
@@ -17844,15 +18298,15 @@ async function acquireRunWriterLease(runDirectory, onCleanupFailure) {
   };
   const reportCleanupFailure = (error) => {
     reportDiagnostic(
-      `writer lease lock cleanup failed (release is best-effort; residual lock left in place) at ${join12(runDirectory, WRITER_LOCK_FILE)}: ${describeErrorIdentity(error)}`
+      `writer lease lock cleanup failed (release is best-effort; residual lock left in place) at ${join13(runDirectory, WRITER_LOCK_FILE)}: ${describeErrorIdentity(error)}`
     );
   };
   const reportReadFailure = (error) => {
     reportDiagnostic(
-      `writer lease lock read failed (holder liveness unverifiable; lock left in place) at ${join12(runDirectory, WRITER_LOCK_FILE)}: ${describeErrorIdentity(error)}`
+      `writer lease lock read failed (holder liveness unverifiable; lock left in place) at ${join13(runDirectory, WRITER_LOCK_FILE)}: ${describeErrorIdentity(error)}`
     );
   };
-  const lockPath = join12(runDirectory, WRITER_LOCK_FILE);
+  const lockPath = join13(runDirectory, WRITER_LOCK_FILE);
   let lastAutopsy = { verdict: "absent" };
   let lastReclaimFailure;
   for (let reclaimsLeft = WRITER_LEASE_RECLAIM_ROUNDS; ; reclaimsLeft -= 1) {
@@ -17902,7 +18356,7 @@ async function acquireRunWriterLease(runDirectory, onCleanupFailure) {
 async function findRunDirectoryById(home, runId) {
   if (runId.trim() === "") return void 0;
   const ledgerHome = resolveActivationLedgerHome(home);
-  const booksRoot = join12(ledgerHome, "books");
+  const booksRoot = join13(ledgerHome, "books");
   let bookKeys;
   try {
     bookKeys = await readdir2(booksRoot);
@@ -17910,7 +18364,7 @@ async function findRunDirectoryById(home, runId) {
     return void 0;
   }
   for (const bookKey of bookKeys) {
-    const runsDir = join12(activationBookDirectory(ledgerHome, bookKey), "runs");
+    const runsDir = join13(activationBookDirectory(ledgerHome, bookKey), "runs");
     let entries;
     try {
       entries = await readdir2(runsDir);
@@ -17919,7 +18373,7 @@ async function findRunDirectoryById(home, runId) {
     }
     for (const entry of entries) {
       if (entry === `${runId}@judge` || entry.startsWith(`${runId}@`)) {
-        return join12(runsDir, entry);
+        return join13(runsDir, entry);
       }
     }
   }
@@ -17934,7 +18388,7 @@ async function readRunParentPath(runDirectory) {
   let raw;
   try {
     raw = JSON.parse(
-      await readFile8(join12(runDirectory, "admitted-request.json"), "utf8")
+      await readFile8(join13(runDirectory, "admitted-request.json"), "utf8")
     );
   } catch (error) {
     if (errorCodeOf2(error) === "ENOENT") return void 0;
@@ -17954,7 +18408,7 @@ async function readRunParentPath(runDirectory) {
 }
 async function findLatestRunIdForSeatTicket(input) {
   const ledgerHome = resolveActivationLedgerHome(input.home);
-  const runsDir = join12(
+  const runsDir = join13(
     activationBookDirectory(ledgerHome, input.bookKey),
     "runs"
   );
@@ -17971,7 +18425,7 @@ async function findLatestRunIdForSeatTicket(input) {
     if (!entry.endsWith(suffix)) continue;
     const runId = entry.slice(0, entry.length - suffix.length);
     if (runId.length === 0) continue;
-    const runDirectory = join12(runsDir, entry);
+    const runDirectory = join13(runsDir, entry);
     if (input.parentRunPath !== void 0) {
       const parentPath = await readRunParentPath(runDirectory);
       if (parentPath !== input.parentRunPath) continue;
@@ -18156,7 +18610,7 @@ async function loadResumableRunRecord(home, runId, authority) {
   let model;
   try {
     const invocationRaw = JSON.parse(
-      await readFile8(join12(run.runDirectory, "invocation.json"), "utf8")
+      await readFile8(join13(run.runDirectory, "invocation.json"), "utf8")
     );
     if (invocationRaw !== null && typeof invocationRaw === "object" && !Array.isArray(invocationRaw)) {
       const rec = invocationRaw;
@@ -18439,7 +18893,7 @@ async function loadResumableCollectorRun(home, runId, authority) {
     );
   }
   const { prNumber, repository, repositoryDisplay, manifestDigest } = loaded.admittedFields;
-  if (prNumber === void 0 || repository === void 0 || repositoryDisplay === void 0 || manifestDigest === void 0) {
+  if (repository === void 0 || repositoryDisplay === void 0 || manifestDigest === void 0) {
     throw new CliUsageError(
       `role run admitted collector repository identity is missing: ${runId}`
     );
@@ -18459,7 +18913,7 @@ async function loadResumableCollectorRun(home, runId, authority) {
   const admitted = {
     role: "collector",
     ...resumedBaseAdmitted(loaded),
-    prNumber,
+    ...prNumber === void 0 ? {} : { prNumber },
     repository: parsedRepository,
     ...loaded.admittedFields.requestManifestPath === void 0 ? {} : { requestManifestPath: loaded.admittedFields.requestManifestPath },
     manifestDigest
@@ -18564,7 +19018,7 @@ __export(notary_source_run_exports, {
   loadNotarySourceRunLocator: () => loadNotarySourceRunLocator,
   resolveNotarySourceRunLocator: () => resolveNotarySourceRunLocator
 });
-import { dirname as dirname7, isAbsolute as isAbsolute5, join as join13, resolve as resolve6, basename as basename4 } from "node:path";
+import { dirname as dirname7, isAbsolute as isAbsolute5, join as join14, resolve as resolve6, basename as basename4 } from "node:path";
 import { lstat as lstat2, realpath as realpath3 } from "node:fs/promises";
 function parseRunDirectoryName(name) {
   const match = RUN_DIR_NAME.exec(name);
@@ -18610,11 +19064,11 @@ async function resolveNotarySourceRunLocator(options) {
   }
   const ledgerHome = resolveActivationLedgerHome(options.home);
   const bookKey = resolveBookKeyFromGit(options.projectRoot);
-  const bookRunsRoot = join13(activationBookDirectory(ledgerHome, bookKey), "runs");
+  const bookRunsRoot = join14(activationBookDirectory(ledgerHome, bookKey), "runs");
   let candidate;
   const bare = parseRunDirectoryName(raw);
   if (bare !== void 0 && !raw.includes("/") && !raw.includes("\\")) {
-    candidate = join13(bookRunsRoot, `${bare.runId}@${bare.role}`);
+    candidate = join14(bookRunsRoot, `${bare.runId}@${bare.role}`);
   } else {
     candidate = isAbsolute5(raw) ? raw : resolve6(options.projectRoot, raw);
   }
@@ -19254,12 +19708,13 @@ var init_option_definitions = __esm({
         canonical: "--pr",
         aliases: [],
         valueMetavar: "number",
-        required: true,
+        // #676 D1: optional when context uniquely determines the PR; ambiguous → require explicit.
+        required: false,
         repeatable: false,
         form: "option",
         description: {
-          en: "Required positive GitHub pull request number.",
-          zh: "\u5FC5\u586B\uFF1B\u6B63\u6574\u6570 GitHub PR \u53F7\u3002"
+          en: "Positive GitHub pull request number. Optional when unique branch/HEAD association binds the PR, or when the Collector role can decide the target from task materials via bind-target; multi-candidate git context or a role that cannot decide requires an explicit value.",
+          zh: "\u6B63\u6574\u6570 GitHub PR \u53F7\u3002\u5206\u652F/HEAD \u552F\u4E00\u5173\u8054\u53EF\u7ED1\u5B9A\u65F6\u53EF\u7701\u7565\uFF1B\u4EA6\u53EF\u7531\u901A\u8FDB\u53F8\u4ECE\u4EFB\u52A1\u6750\u6599\u7ECF bind-target \u5224\u5B9A\u3002git \u591A\u5019\u9009\u6216\u89D2\u8272\u65E0\u6CD5\u5224\u5B9A\u65F6\u5FC5\u987B\u663E\u5F0F\u63D0\u4F9B\u3002"
         }
       },
       {
@@ -19578,9 +20033,10 @@ var init_option_definitions = __esm({
       collector: {
         command: "collector",
         summary: "Collect GitHub PR review evidence.",
-        usage: ["ak-role collector --pr <number> [options] [instruction]"],
+        usage: ["ak-role collector [--pr <number>] [options] [instruction]"],
         examples: [
           "ak-role collector --pr 42 --repo owner/repository",
+          'ak-role collector --repo owner/repository "Collect findings for #42"',
           "ak-role collector --pr 42 --request-manifest ./requests.json"
         ]
       },
@@ -19730,7 +20186,7 @@ var init_option_definitions = __esm({
 });
 
 // src/public-cli/invocation.ts
-import { execFileSync as execFileSync2 } from "node:child_process";
+import { execFileSync as execFileSync3 } from "node:child_process";
 import {
   lstat as lstat3,
   mkdir as mkdir2,
@@ -19738,11 +20194,11 @@ import {
   realpath as realpath4,
   writeFile as writeFile4
 } from "node:fs/promises";
-import { basename as basename5, isAbsolute as isAbsolute6, join as join14, resolve as resolve7, sep as sep3 } from "node:path";
+import { basename as basename5, isAbsolute as isAbsolute6, join as join15, resolve as resolve7, sep as sep3 } from "node:path";
 function issueAdmissionPlacement(authority, request) {
   const principal = authority.issue(request);
   const { sessionDirectory, sessionFile } = authority.decode(principal);
-  const runDirectory = join14(sessionDirectory, "..");
+  const runDirectory = join15(sessionDirectory, "..");
   const ledgerHome = resolveActivationLedgerHome(request.home);
   const bookKey = resolveBookKeyFromGit(request.cwd);
   return {
@@ -19790,14 +20246,14 @@ async function writeRoleInvocationLedger(source, role, effectiveModel) {
     ...effectiveModelLedgerFields(effectiveModel)
   };
   await writeFile4(
-    join14(source.runDirectory, "invocation.json"),
+    join15(source.runDirectory, "invocation.json"),
     `${JSON.stringify(identity, null, 2)}
 `,
     "utf8"
   );
 }
 async function recordEffectiveInvocationModel(runDirectory, model, engine, host) {
-  const ledgerPath = join14(runDirectory, "invocation.json");
+  const ledgerPath = join15(runDirectory, "invocation.json");
   const current = JSON.parse(await readFile9(ledgerPath, "utf8"));
   const next = { ...current };
   if (model !== void 0) {
@@ -19825,7 +20281,7 @@ async function recordEffectiveInvocationModel(runDirectory, model, engine, host)
   );
 }
 async function mergeInvocationIdentityPage(runDirectory, fields) {
-  const ledgerPath = join14(runDirectory, "invocation.json");
+  const ledgerPath = join15(runDirectory, "invocation.json");
   const current = JSON.parse(await readFile9(ledgerPath, "utf8"));
   await writeFile4(
     ledgerPath,
@@ -19886,7 +20342,7 @@ async function recordLaunchedPiIdentity(runDirectory, identity) {
 async function observeLaunchedRolePackageIdentity(packageRoot2, selectedRoleEntry) {
   const rolePackageRoot = packageRoot2;
   const raw = JSON.parse(
-    await readFile9(join14(rolePackageRoot, "package.json"), "utf8")
+    await readFile9(join15(rolePackageRoot, "package.json"), "utf8")
   );
   if (typeof raw.version !== "string" || raw.version.trim() === "") {
     throw new Error(
@@ -20133,7 +20589,7 @@ async function freezeRegularFileAttachment(sourcePath, destinationDir, index) {
   }
   const bytes = await readFile9(absolute);
   const name = `${String(index).padStart(2, "0")}-${basename5(absolute)}`;
-  const frozenPath = join14(destinationDir, name);
+  const frozenPath = join15(destinationDir, name);
   await writeFile4(frozenPath, bytes);
   return {
     attachment: {
@@ -20161,7 +20617,7 @@ async function freezeAttachments(attachmentPaths, attachmentsDirectory) {
 async function freezeAttachmentsIntoRun(attachmentPaths, runDirectory, summonsKey = `s-${Date.now().toString(36)}`) {
   if (attachmentPaths.length === 0) return [];
   const ledgerHome = resolveActivationLedgerHome(homeFromRunDirectory(runDirectory));
-  const attachmentsDirectory = join14(runDirectory, "attachments", summonsKey);
+  const attachmentsDirectory = join15(runDirectory, "attachments", summonsKey);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
   return freezeAttachments(attachmentPaths, attachmentsDirectory);
 }
@@ -20187,7 +20643,7 @@ async function admitStandardMaterialInvocation(role, options) {
     role,
     home: options.home
   });
-  const attachmentsDirectory = join14(runDirectory, "attachments");
+  const attachmentsDirectory = join15(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
   const attachments = await freezeAttachments(options.attachmentPaths, attachmentsDirectory);
@@ -20212,7 +20668,7 @@ async function admitStandardMaterialInvocation(role, options) {
       mediaKind: a.mediaKind
     }))
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -20290,7 +20746,7 @@ async function admitCountersignInvocation(options) {
     role: "countersign",
     home: options.home
   });
-  const attachmentsDirectory = join14(runDirectory, "attachments");
+  const attachmentsDirectory = join15(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
   const attachments = await freezeAttachments(options.attachmentPaths, attachmentsDirectory);
@@ -20314,7 +20770,7 @@ async function admitCountersignInvocation(options) {
       mediaKind: a.mediaKind
     }))
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -20338,7 +20794,7 @@ function buildCountersignTransportPrompt(admitted, engineMaterial) {
   return buildInstructionTransportPrompt(admitted, engineMaterial);
 }
 async function ensureRunArtifactsDir(runDirectory) {
-  const dir = join14(runDirectory, "artifacts");
+  const dir = join15(runDirectory, "artifacts");
   await mkdir2(dir, { recursive: true });
   return dir;
 }
@@ -20370,11 +20826,11 @@ async function admitCoderInvocation(options) {
     role: "coder",
     home: options.home
   });
-  const attachmentsDirectory = join14(runDirectory, "attachments");
+  const attachmentsDirectory = join15(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
   const attachments = await freezeAttachments(options.attachmentPaths, attachmentsDirectory);
-  const taskPath = join14(runDirectory, "task.md");
+  const taskPath = join15(runDirectory, "task.md");
   await writeFile4(taskPath, instruction, "utf8");
   const admitted = {
     role: "coder",
@@ -20395,7 +20851,7 @@ async function admitCoderInvocation(options) {
       mediaKind: a.mediaKind
     }))
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -20476,13 +20932,13 @@ async function admitFixerInvocation(options) {
     role: "fixer",
     home: options.home
   });
-  const attachmentsDirectory = join14(runDirectory, "attachments");
+  const attachmentsDirectory = join15(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
   const attachments = await freezeAttachments(options.attachmentPaths, attachmentsDirectory);
   let prerequisitesPath;
   if (prerequisitesSource !== void 0) {
-    prerequisitesPath = join14(runDirectory, "prerequisites.json");
+    prerequisitesPath = join15(runDirectory, "prerequisites.json");
     await writeFile4(
       prerequisitesPath,
       `${JSON.stringify(prerequisites, null, 2)}
@@ -20490,7 +20946,7 @@ async function admitFixerInvocation(options) {
       "utf8"
     );
   }
-  const packetPath = join14(runDirectory, "fix-packet.md");
+  const packetPath = join15(runDirectory, "fix-packet.md");
   await writeFile4(packetPath, instruction, "utf8");
   const admitted = {
     role: "fixer",
@@ -20516,7 +20972,7 @@ async function admitFixerInvocation(options) {
       mediaKind: a.mediaKind
     }))
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -20610,7 +21066,7 @@ function parseCollectorArgv(args) {
   }
   options.assertRequired();
   return {
-    prNumber,
+    ...prNumber === void 0 ? {} : { prNumber },
     instruction: positional.join(" "),
     attachmentPaths,
     ...project === void 0 ? {} : { project },
@@ -20621,16 +21077,21 @@ function parseCollectorArgv(args) {
 function resolveGitHubRemoteRepository(projectRoot) {
   let remoteUrl;
   try {
-    remoteUrl = execFileSync2("git", ["remote", "get-url", "origin"], {
+    remoteUrl = execFileSync3("git", ["remote", "get-url", "origin"], {
       cwd: projectRoot,
       encoding: "utf8",
       stdio: ["ignore", "pipe", "pipe"]
     }).trim();
   } catch (error) {
-    throw new CliUsageError(
-      "collector requires a github.com origin remote or an explicit --repo owner/repo",
-      { cause: error }
-    );
+    if (isGitRemoteMissing(error)) {
+      throw new CliUsageError(
+        "collector requires a github.com origin remote or an explicit --repo owner/repo",
+        { cause: error }
+      );
+    }
+    throw new Error("collector git failed: cannot read origin remote URL", {
+      cause: error instanceof Error ? error : new Error(String(error))
+    });
   }
   if (remoteUrl.length === 0) {
     throw new CliUsageError(
@@ -20650,43 +21111,23 @@ function resolveGitHubRemoteRepository(projectRoot) {
     throw new CliUsageError(detail, { cause: error });
   }
 }
-function ownerRepoFromGitHubRemoteUrl(remoteUrl) {
-  const trimmed = remoteUrl.trim();
-  const scp = /^git@github\.com:([^/\s]+)\/([^/\s]+?)(?:\.git)?$/i.exec(trimmed);
-  if (scp) {
-    return `${scp[1]}/${stripGitSuffix(scp[2])}`;
-  }
-  const ssh = /^ssh:\/\/git@github\.com\/([^/\s]+)\/([^/\s]+?)(?:\.git)?\/?$/i.exec(
-    trimmed
-  );
-  if (ssh) {
-    return `${ssh[1]}/${stripGitSuffix(ssh[2])}`;
-  }
-  let parsed;
-  try {
-    parsed = new URL(trimmed);
-  } catch {
-    return void 0;
-  }
-  if (!/^github\.com$/i.test(parsed.hostname)) return void 0;
-  if (parsed.search !== "" || parsed.hash !== "") return void 0;
-  const parts = parsed.pathname.split("/").filter((p) => p.length > 0);
-  if (parts.length !== 2) return void 0;
-  return `${parts[0]}/${stripGitSuffix(parts[1])}`;
-}
-function stripGitSuffix(name) {
-  return name.toLowerCase().endsWith(".git") ? name.slice(0, -4) : name;
+function isGitRemoteMissing(error) {
+  if (typeof error !== "object" || error === null) return false;
+  const status = error.status;
+  return status === 2;
 }
 async function admitCollectorInvocation(options) {
   if (options.project !== void 0) {
     requireOptionPath("--project", options.project);
   }
-  let prNumber;
-  try {
-    prNumber = parseCollectorPrNumber(options.prNumber);
-  } catch (error) {
-    const detail = error instanceof Error ? error.message : String(error);
-    throw new CliUsageError(detail, { cause: error });
+  let explicitPrNumber;
+  if (options.prNumber !== void 0) {
+    try {
+      explicitPrNumber = parseCollectorPrNumber(options.prNumber);
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      throw new CliUsageError(detail, { cause: error });
+    }
   }
   const projectRoot = resolve7(options.project ?? options.cwd);
   let repository;
@@ -20725,17 +21166,23 @@ async function admitCollectorInvocation(options) {
     role: "collector",
     home: options.home
   });
-  const attachmentsDirectory = join14(runDirectory, "attachments");
+  const attachmentsDirectory = join15(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
   const attachments = await freezeAttachments(options.attachmentPaths ?? [], attachmentsDirectory);
+  const instruction = options.instruction ?? "";
+  const instructionEmpty = instruction.trim() === "";
+  const target = await resolveCollectorTarget({
+    projectRoot,
+    repository,
+    ...explicitPrNumber === void 0 ? {} : { explicitPrNumber }
+  });
+  const prNumber = target.kind === "bound" ? target.prNumber : void 0;
   let requestManifestPath;
   if (manifestCanonicalJson !== void 0) {
-    requestManifestPath = join14(runDirectory, "request-manifest.json");
+    requestManifestPath = join15(runDirectory, "request-manifest.json");
     await writeFile4(requestManifestPath, manifestCanonicalJson, "utf8");
   }
-  const instruction = options.instruction ?? "";
-  const instructionEmpty = instruction.trim() === "";
   const admitted = {
     role: "collector",
     runId,
@@ -20745,7 +21192,7 @@ async function admitCollectorInvocation(options) {
     principal,
     instruction,
     instructionEmpty,
-    prNumber,
+    ...prNumber === void 0 ? {} : { prNumber },
     repository: repository.canonical,
     repositoryDisplay: repository.display,
     ...requestManifestPath === void 0 ? {} : { requestManifestPath },
@@ -20758,7 +21205,7 @@ async function admitCollectorInvocation(options) {
       mediaKind: a.mediaKind
     }))
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -20775,14 +21222,14 @@ async function admitCollectorInvocation(options) {
     runDirectory,
     principal,
     admittedRequestPath,
-    prNumber,
+    ...prNumber === void 0 ? {} : { prNumber },
     repository,
     ...requestManifestPath === void 0 ? {} : { requestManifestPath },
     manifestDigest
   };
 }
-function buildCollectorTransportPrompt(_admitted, engineMaterial) {
-  return appendEngineSessionMaterial([COLLECTOR_FIXED_KICKOFF], engineMaterial).join("\n");
+function buildCollectorTransportPrompt(admitted, engineMaterial) {
+  return buildInstructionTransportPrompt(admitted, engineMaterial);
 }
 function parseDoctorIssueNumber(raw) {
   const trimmed = raw.trim();
@@ -20855,7 +21302,7 @@ function parseDoctorArgv(args) {
 }
 async function resolveDoctorCaseRunsPath(options) {
   const ledgerHome = resolveActivationLedgerHome(options.home);
-  const defaultRuns = join14(
+  const defaultRuns = join15(
     activationBookDirectory(ledgerHome, options.bookKey),
     "issues",
     String(options.issueNumber),
@@ -20962,7 +21409,7 @@ async function admitDoctorInvocation(options) {
       { cause: error }
     );
   }
-  const attachmentsDirectory = join14(runDirectory, "attachments");
+  const attachmentsDirectory = join15(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
   const attachments = await freezeAttachments(options.attachmentPaths ?? [], attachmentsDirectory);
@@ -20988,7 +21435,7 @@ async function admitDoctorInvocation(options) {
       mediaKind: a.mediaKind
     }))
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -21120,7 +21567,7 @@ async function admitNotaryInvocation(options) {
     ...ticketFields,
     ...options.correlationId === void 0 ? {} : { correlationId: options.correlationId }
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -21222,7 +21669,7 @@ async function admitGleanerLeftInvocation(options) {
     attachments: [],
     ...options.correlationId === void 0 ? {} : { correlationId: options.correlationId }
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -21327,7 +21774,7 @@ async function admitReviewerInvocation(options) {
     role: "reviewer",
     home: options.home
   });
-  const attachmentsDirectory = join14(runDirectory, "attachments");
+  const attachmentsDirectory = join15(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
   const attachments = await freezeAttachments(options.attachmentPaths, attachmentsDirectory);
@@ -21352,7 +21799,7 @@ async function admitReviewerInvocation(options) {
       mediaKind: a.mediaKind
     }))
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -21479,7 +21926,7 @@ async function admitMergerInvocation(options) {
     role: "merger",
     home: options.home
   });
-  const attachmentsDirectory = join14(runDirectory, "attachments");
+  const attachmentsDirectory = join15(runDirectory, "attachments");
   ensureRealDirectoryTree(ledgerHome, sessionDirectory);
   ensureRealDirectoryTree(ledgerHome, attachmentsDirectory);
   const attachments = await freezeAttachments(options.attachmentPaths, attachmentsDirectory);
@@ -21507,7 +21954,7 @@ async function admitMergerInvocation(options) {
     // Authorized checks remain available on the assignment; default none.
     authorizedChecks: []
   });
-  const mergerInputPath = join14(runDirectory, "merger-input.json");
+  const mergerInputPath = join15(runDirectory, "merger-input.json");
   await writeFile4(
     mergerInputPath,
     `${JSON.stringify(mergerInput, null, 2)}
@@ -21539,7 +21986,7 @@ async function admitMergerInvocation(options) {
       mediaKind: a.mediaKind
     }))
   };
-  const admittedRequestPath = join14(runDirectory, "admitted-request.json");
+  const admittedRequestPath = join15(runDirectory, "admitted-request.json");
   await writeAdmittedRequestPersistence(admittedRequestPath, admitted, {
     sessionDirectory,
     sessionFile
@@ -21802,6 +22249,8 @@ var init_invocation = __esm({
     init_run_ticket_number();
     init_doctor_evidence();
     init_collector_config();
+    init_collector_target();
+    init_github_remote();
     init_fixer_packet();
     init_merger_git_state();
     init_merger_contracts();
@@ -21830,7 +22279,7 @@ var init_invocation = __esm({
 // src/package-resources/method-skill.ts
 import { createHash as createHash4 } from "node:crypto";
 import { readFile as readFile10, realpath as realpath5 } from "node:fs/promises";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 function gitBlobOid(bytes) {
   const body = typeof bytes === "string" ? Buffer.from(bytes, "utf8") : Buffer.from(bytes);
   const header = Buffer.from(`blob ${body.byteLength}\0`, "utf8");
@@ -21847,16 +22296,16 @@ function packagedMethodSkillRelativeDirectory(name) {
   return `${METHOD_SKILL_RELATIVE_ROOT}/${name}`;
 }
 function resolvePackagedMethodSkillRoot(packageRoot2, name) {
-  return join15(packageRoot2, packagedMethodSkillRelativeDirectory(name));
+  return join16(packageRoot2, packagedMethodSkillRelativeDirectory(name));
 }
 function resolvePackagedMethodSkillPath(packageRoot2, name) {
-  return join15(resolvePackagedMethodSkillRoot(packageRoot2, name), "SKILL.md");
+  return join16(resolvePackagedMethodSkillRoot(packageRoot2, name), "SKILL.md");
 }
-function isRecord9(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseProvenance(raw, expectedName) {
-  if (!isRecord9(raw)) {
+  if (!isRecord10(raw)) {
     throw new Error(`Packaged method provenance must be an object for ${expectedName}`);
   }
   if (raw.name !== expectedName) {
@@ -21870,7 +22319,7 @@ function parseProvenance(raw, expectedName) {
   if (typeof raw.packageAdaptation !== "string" || raw.packageAdaptation.trim() === "") {
     throw new Error(`Packaged method provenance packageAdaptation must be nonblank`);
   }
-  if (!isRecord9(raw.upstream)) {
+  if (!isRecord10(raw.upstream)) {
     throw new Error(`Packaged method provenance upstream must be an object`);
   }
   const upstream = raw.upstream;
@@ -21897,12 +22346,12 @@ function parseProvenance(raw, expectedName) {
       `Packaged method provenance upstream must include nonblank tag or version`
     );
   }
-  if (!isRecord9(raw.files)) {
+  if (!isRecord10(raw.files)) {
     throw new Error(`Packaged method provenance files must be an object`);
   }
   const files = {};
   for (const [rel, entry] of Object.entries(raw.files)) {
-    if (!isRecord9(entry)) {
+    if (!isRecord10(entry)) {
       throw new Error(`Packaged method provenance file entry must be an object: ${rel}`);
     }
     if (typeof entry.sha256 !== "string" || !SHA256_RE.test(entry.sha256)) {
@@ -21944,8 +22393,8 @@ function parseProvenance(raw, expectedName) {
 }
 async function loadPackagedMethodSkillMaterial(packageRoot2, name) {
   const rootDirectory = resolvePackagedMethodSkillRoot(packageRoot2, name);
-  const skillPathConfigured = join15(rootDirectory, "SKILL.md");
-  const provenancePath = join15(rootDirectory, "provenance.json");
+  const skillPathConfigured = join16(rootDirectory, "SKILL.md");
+  const provenancePath = join16(rootDirectory, "provenance.json");
   let provenanceRaw;
   try {
     provenanceRaw = await readFile10(provenancePath, "utf8");
@@ -21962,7 +22411,7 @@ async function loadPackagedMethodSkillMaterial(packageRoot2, name) {
   }
   const provenance = parseProvenance(provenanceJson, name);
   for (const [rel, expected] of Object.entries(provenance.files)) {
-    const absolute = join15(rootDirectory, rel);
+    const absolute = join16(rootDirectory, rel);
     let bytes;
     try {
       bytes = await readFile10(absolute);
@@ -22085,7 +22534,7 @@ var init_compliance_transport = __esm({
 
 // src/ledger-session-read.ts
 import { readFile as readFile11 } from "node:fs/promises";
-function isRecord10(value) {
+function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 async function readLedgerSessionJsonl(path) {
@@ -22109,7 +22558,7 @@ async function readLedgerSessionJsonl(path) {
       }
       break;
     }
-    if (!isRecord10(row)) {
+    if (!isRecord11(row)) {
       const kind = row === null ? "null" : Array.isArray(row) ? "array" : typeof row;
       throw new LedgerSessionJsonlError(
         `complete non-object JSONL record in ${path} at line ${index + 1}: expected object, got ${kind}`,
@@ -22146,7 +22595,7 @@ function extractSessionModelSequence(rows) {
     if (row.type === "model_change" && typeof row.modelId === "string") {
       push(row.modelId);
     }
-    const message = isRecord10(row.message) ? row.message : void 0;
+    const message = isRecord11(row.message) ? row.message : void 0;
     if (message?.role === "assistant" && typeof message.model === "string") {
       push(message.model);
     }
@@ -22162,11 +22611,11 @@ function extractSessionToolIntervals(rows) {
   const openById = /* @__PURE__ */ new Map();
   for (const row of rows) {
     const rowTimestamp = typeof row.timestamp === "string" ? row.timestamp : void 0;
-    const message = isRecord10(row.message) ? row.message : void 0;
+    const message = isRecord11(row.message) ? row.message : void 0;
     if (message?.role === "assistant" && Array.isArray(message.content)) {
       const callTimestamp = typeof message.timestamp === "string" && message.timestamp ? message.timestamp : rowTimestamp;
       for (const part of message.content) {
-        if (!isRecord10(part) || part.type !== "toolCall") continue;
+        if (!isRecord11(part) || part.type !== "toolCall") continue;
         if (typeof part.id !== "string" || part.id.length === 0) {
           throw new Error("toolCall frame missing string id");
         }
@@ -22179,7 +22628,7 @@ function extractSessionToolIntervals(rows) {
         if (openById.has(part.id)) {
           throw new Error(`duplicate toolCall id ${part.id}`);
         }
-        const args = isRecord10(part.arguments) ? part.arguments : void 0;
+        const args = isRecord11(part.arguments) ? part.arguments : void 0;
         const command = part.name === "bash" && args !== void 0 && typeof args.command === "string" ? bashCommandFirstLine(args.command) : void 0;
         const interval = {
           toolCallId: part.id,
@@ -22264,8 +22713,8 @@ var init_ledger_session_read = __esm({
 
 // src/analyst-gate-cycles-read.ts
 import { readdir as readdir3 } from "node:fs/promises";
-import { join as join16 } from "node:path";
-function isRecord11(value) {
+import { join as join17 } from "node:path";
+function isRecord12(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isParentAttemptBindingRow(row) {
@@ -22296,7 +22745,7 @@ function isGateTerminatingToolName(toolName) {
 function acceptedGateReceiptIds(rows) {
   const accepted = /* @__PURE__ */ new Set();
   for (const row of rows) {
-    const message = isRecord11(row.message) ? row.message : void 0;
+    const message = isRecord12(row.message) ? row.message : void 0;
     if (message?.role !== "toolResult") continue;
     if (typeof message.toolCallId !== "string" || message.toolCallId.length === 0) continue;
     if (message.isError === false) accepted.add(message.toolCallId);
@@ -22335,7 +22784,7 @@ function nearestAttemptBindingBefore(rows, beforeIndex) {
   for (let i = beforeIndex - 1; i >= 0; i -= 1) {
     const row = rows[i];
     if (!isParentAttemptBindingRow(row)) continue;
-    if (!isRecord11(row.data) || !isRecord11(row.data.parent)) continue;
+    if (!isRecord12(row.data) || !isRecord12(row.data.parent)) continue;
     const id = row.data.parent.attemptEntryId;
     const sessionFile = row.data.parent.sessionFile;
     return {
@@ -22350,10 +22799,10 @@ function extractAllAcceptedGateToolCalls(rows) {
   const out = [];
   for (let rowIndex = 0; rowIndex < rows.length; rowIndex += 1) {
     const row = rows[rowIndex];
-    const message = isRecord11(row.message) ? row.message : void 0;
+    const message = isRecord12(row.message) ? row.message : void 0;
     if (message?.role !== "assistant" || !Array.isArray(message.content)) continue;
     for (const part of message.content) {
-      if (!isRecord11(part) || part.type !== "toolCall") continue;
+      if (!isRecord12(part) || part.type !== "toolCall") continue;
       if (typeof part.id !== "string" || part.id.length === 0) continue;
       if (typeof part.name !== "string" || part.name.length === 0) continue;
       if (!isGateTerminatingToolName(part.name)) continue;
@@ -22361,7 +22810,7 @@ function extractAllAcceptedGateToolCalls(rows) {
       const binding = nearestAttemptBindingBefore(rows, rowIndex);
       out.push({
         toolName: part.name,
-        args: isRecord11(part.arguments) ? part.arguments : void 0,
+        args: isRecord12(part.arguments) ? part.arguments : void 0,
         accepted: true,
         rowIndex,
         ...binding
@@ -22501,7 +22950,7 @@ async function resolveOfficerSessionFromPointerFile(pointerPath) {
       { cause: error }
     );
   }
-  if (!isRecord11(raw) || raw.kind !== "direct-officer-run-pointer" || raw.version !== 1) {
+  if (!isRecord12(raw) || raw.kind !== "direct-officer-run-pointer" || raw.version !== 1) {
     throw new Error(`direct officer run pointer has unknown shape in ${pointerPath}`);
   }
   const sessionFile = raw.sessionFile;
@@ -22526,7 +22975,7 @@ async function readAnalystGateCyclesFromAuditorRoles(auditorRolesDirectory, opti
       throw error;
     }
     for (const name of names) {
-      const path = join16(directory, name);
+      const path = join17(directory, name);
       const fromPointer = name.endsWith(".pointer.json");
       const sessionPath = fromPointer ? await resolveOfficerSessionFromPointerFile(path) : path;
       if (sessionPath === void 0) continue;
@@ -22569,21 +23018,21 @@ var init_analyst_gate_cycles_read = __esm({
 
 // src/run-terminal-artifacts.ts
 import { readdir as readdir4, readFile as readFile12 } from "node:fs/promises";
-import { basename as basename6, dirname as dirname8, join as join17 } from "node:path";
+import { basename as basename6, dirname as dirname8, join as join18 } from "node:path";
 function isMissingPathError2(error) {
   return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
 }
 function errorText2(error) {
   return error instanceof Error ? error.message : String(error);
 }
-function isRecord12(value) {
+function isRecord13(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readUsableTerminalArtifactBody(body) {
   if (body === null) {
     return { ok: false, reason: "terminal artifact JSON value is null" };
   }
-  if (!isRecord12(body)) {
+  if (!isRecord13(body)) {
     return {
       ok: false,
       reason: `terminal artifact JSON value is not a typed object (${Array.isArray(body) ? "array" : typeof body})`
@@ -22644,7 +23093,7 @@ async function listUniqueErrorFallbackPaths(directories) {
     }
     for (const name of names.sort((a, b) => a.localeCompare(b))) {
       if (!UNIQUE_ERROR_FALLBACK_NAME.test(name)) continue;
-      found.push(join17(dir, name));
+      found.push(join18(dir, name));
     }
   }
   return found;
@@ -22660,14 +23109,14 @@ function presentUniqueFallbackBoundToRun(body, expectedRunId) {
   return typeof body.runId === "string" && body.runId === expectedRunId;
 }
 async function readRunTerminalArtifact(runDirectory) {
-  const artifactsDir = join17(runDirectory, "artifacts");
+  const artifactsDir = join18(runDirectory, "artifacts");
   for (const file of RUN_TERMINAL_ARTIFACT_FILES) {
-    const path = join17(artifactsDir, file);
+    const path = join18(artifactsDir, file);
     const read3 = await readTerminalArtifactAtPath(path, file);
     if (read3 !== void 0) return read3;
   }
   for (const relative3 of RUN_TERMINAL_ERROR_FALLBACK_RELATIVE_PATHS) {
-    const path = join17(runDirectory, relative3);
+    const path = join18(runDirectory, relative3);
     const read3 = await readTerminalArtifactAtPath(path, "error.json");
     if (read3 !== void 0) return read3;
   }
@@ -22805,14 +23254,14 @@ var init_submission_ledger = __esm({
 });
 
 // src/session-opening-materials.ts
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync7 } from "node:fs";
 import { readFile as readFile13 } from "node:fs/promises";
-import { dirname as dirname9, join as join18 } from "node:path";
-import { fileURLToPath, pathToFileURL as pathToFileURL2 } from "node:url";
+import { dirname as dirname9, join as join19 } from "node:path";
+import { fileURLToPath, pathToFileURL as pathToFileURL3 } from "node:url";
 function resolvePackageRootDir(moduleUrl = import.meta.url) {
   let dir = dirname9(fileURLToPath(moduleUrl));
   for (let i = 0; i < 8; i += 1) {
-    if (existsSync6(join18(dir, "package.json")) && existsSync6(join18(dir, "souls"))) {
+    if (existsSync7(join19(dir, "package.json")) && existsSync7(join19(dir, "souls"))) {
       return dir;
     }
     const parent = dirname9(dir);
@@ -22836,7 +23285,7 @@ var init_session_opening_materials = __esm({
   "src/session-opening-materials.ts"() {
     "use strict";
     init_packaged_role_registry();
-    packageRootUrl = pathToFileURL2(resolvePackageRootDir() + "/").href;
+    packageRootUrl = pathToFileURL3(resolvePackageRootDir() + "/").href;
     MAIN_ROLE_SESSION_MATERIALS = {
       ...Object.fromEntries(
         PUBLIC_ROLE_RECORDS.map((record4) => [record4.role, record4.sessionMaterials])
@@ -23092,12 +23541,12 @@ var init_reviewer_dispatch = __esm({
 
 // src/public-cli/reviewer-dispatch-rejection.ts
 import { readFile as readFile14, unlink as unlink3 } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { join as join20 } from "node:path";
 function isReviewerPreflightViolation(value) {
   return typeof value === "string" && REVIEWER_PREFLIGHT_VIOLATIONS.includes(value);
 }
 function reviewerDispatchRejectionPath(runDirectory) {
-  return join19(runDirectory, REVIEWER_DISPATCH_REJECTION_FILE);
+  return join20(runDirectory, REVIEWER_DISPATCH_REJECTION_FILE);
 }
 async function clearReviewerDispatchRejection(runDirectory) {
   try {
@@ -23156,20 +23605,22 @@ var init_collector_evidence = __esm({
   }
 });
 
-// src/collector-github.ts
-var init_collector_github = __esm({
-  "src/collector-github.ts"() {
+// src/collector-identity.ts
+var init_collector_identity = __esm({
+  "src/collector-identity.ts"() {
     "use strict";
+    init_submission_correctable_error();
   }
 });
 
 // src/collector-tool-schemas.ts
-var collectorObserveArgsSchema, collectorRequestArgsSchema, collectorReadArgsSchema, collectorWaitArgsSchema, collectorFindingArgsSchema, collectorOutputBaseSchema, collectorOutputArgsSchema;
+var collectorObserveArgsSchema, collectorRequestArgsSchema, collectorReadArgsSchema, collectorWaitArgsSchema, collectorBindTargetArgsSchema, collectorFindingItemDeclaration, collectorOutputBaseSchema, collectorOutputArgsSchema;
 var init_collector_tool_schemas = __esm({
   "src/collector-tool-schemas.ts"() {
     "use strict";
     init_build();
     init_collector_evidence();
+    init_open_tool_schema();
     init_terminating_infrastructure();
     collectorObserveArgsSchema = typebox_exports.Object({}, { additionalProperties: false });
     collectorRequestArgsSchema = typebox_exports.Object({
@@ -23182,36 +23633,70 @@ var init_collector_tool_schemas = __esm({
     collectorWaitArgsSchema = typebox_exports.Object({
       durationMs: typebox_exports.Integer({ minimum: 1, maximum: COLLECTOR_ELIGIBILITY_MS, description: "\u7B49\u5F85\u6BEB\u79D2\uFF1B\u5355\u6B21\u4E0A\u9650\u4E94\u5206\u949F\u4E14\u4E0D\u8D85\u5269\u4F59\u8D44\u683C" })
     }, { additionalProperties: false });
-    collectorFindingArgsSchema = typebox_exports.Object({
-      evidenceId: typebox_exports.String({ minLength: 1, description: "observe \u8FD4\u56DE\u7684\u6750\u6599\u8BC1\u636E id\uFF08evidenceId\uFF09" }),
-      category: typebox_exports.Optional(typebox_exports.String({ minLength: 1, maxLength: 200, description: "\u8BE5 finding \u7684\u7B80\u77ED\u5F52\u7C7B\u6807\u7B7E\uFF1B\u9700\u8981\u5934\u90E8\u4E4B\u5916\u7684\u6B63\u6587\u65F6\u5148\u7528 ak_collector_read \u5F00\u5377\u518D\u5224\u8BFB\uFF0C\u4E0D\u5F97\u8A8A\u5199\u8BC4\u8BBA\u6B63\u6587" }))
-    }, { additionalProperties: false });
-    collectorOutputBaseSchema = typebox_exports.Object({
-      findings: typebox_exports.Optional(typebox_exports.Array(collectorFindingArgsSchema, {
-        description: "\u672C\u6B21\u6536\u96C6\u5230\u7684\u9010\u6761 findings\uFF1B\u96F6 finding \u7684\u6A21\u677F\u901A\u77E5\u4E0D\u5F97\u8FDB\u5165\u3002\u6B63\u5E38\u5B8C\u5DE5\u65E0 finding \u65F6\u7701\u7565\u3002"
+    collectorBindTargetArgsSchema = typebox_exports.Object({
+      prNumber: typebox_exports.Optional(typebox_exports.Unknown({
+        description: "\u89D2\u8272\u5224\u5B9A\u7684\u672C\u4ED3 PR \u53F7\uFF08\u6B63\u6574\u6570\uFF09\u3002\u4E0E issueNumber \u4E8C\u9009\u4E00\u6216\u540C\u6307\u552F\u4E00\u76EE\u6807\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
+      })),
+      issueNumber: typebox_exports.Optional(typebox_exports.Unknown({
+        description: "\u89D2\u8272\u5224\u5B9A\u7684\u672C\u4ED3 issue \u53F7\uFF08\u6B63\u6574\u6570\uFF09\uFF1Bruntime \u7ECF\u7EBF\u4E0A\u5173\u8054\u89E3\u6790\u552F\u4E00 PR\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
       }))
-    }, { additionalProperties: true, description: "\u6B63\u5E38\u5B8C\u5DE5\u63D0\u4EA4\u7A7A\u5BF9\u8C61 {}\uFF1B\u4EC5\u5728\u57FA\u7840\u8BBE\u65BD\u771F\u5B9E\u5931\u8D25\u65F6\u624D\u586B\u5199 infrastructureFailure\uFF0C\u65E0\u5931\u8D25\u65F6\u5FC5\u987B\u7701\u7565\u8BE5\u5B57\u6BB5\u3002" });
+    }, { additionalProperties: true });
+    collectorFindingItemDeclaration = (() => {
+      const item = typebox_exports.Object(
+        {
+          evidenceId: typebox_exports.Unknown({
+            description: "observe \u8FD4\u56DE\u7684\u6750\u6599\u6307\u9488\uFF08\u5FC5\u586B\u8BED\u4E49\uFF09"
+          }),
+          category: typebox_exports.Unknown({
+            description: "\u7B80\u77ED\u5F52\u7C7B\u6807\u7B7E\uFF0C\u4E0D\u662F\u6458\u8981"
+          }),
+          summary: typebox_exports.Unknown({
+            description: "\u54EA\u4E2A bot\u3001\u4EC0\u4E48\u95EE\u9898\u7684\u6458\u8981\uFF1B\u4E0D\u8A8A\u6284\u6B63\u6587"
+          })
+        },
+        {
+          additionalProperties: true,
+          description: "\u5355\u6761 finding \u6307\u9488\uFF1AevidenceId + \u53EF\u9009 category/summary\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
+        }
+      );
+      item.required = [];
+      return item;
+    })();
+    collectorOutputBaseSchema = openToolObject(
+      typebox_exports.Object({
+        // No root type:array — host must not shape-reject non-array findings (#676 C).
+        // Nested item declarations ride `items` for registration preservation (ADR 0057).
+        findings: typebox_exports.Unsafe({
+          description: "\u672C\u6B21\u6536\u96C6\u5230\u7684\u9010\u6761 findings\uFF08\u6307\u9488\u6570\u7EC4\u4E3A\u89C4\u8303\u5F62\uFF09\u3002\u96F6 finding \u7684\u6A21\u677F\u901A\u77E5\u4E0D\u5F97\u8FDB\u5165\uFF1B\u6B63\u5E38\u5B8C\u5DE5\u65E0 finding \u65F6\u7701\u7565\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002",
+          items: collectorFindingItemDeclaration
+        }),
+        unfinishedReasons: typebox_exports.Unknown({
+          description: "\u672A\u5B8C\u6210\u539F\u56E0\u5B57\u7B26\u4E32\u6570\u7EC4\uFF08\u989D\u5EA6/\u6545\u969C/\u7B49\u5F85\u5C4A\u6EE1\u7B49\u73B0\u573A\u4F9D\u636E\uFF09\uFF1B\u4E0D\u5F97\u628A\u672A\u5B8C\u6210\u8868\u8FF0\u4E3A\u65E0\u95EE\u9898\u3002\u65E0\u53EF\u62A5\u544A\u65F6\u7701\u7565\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
+        })
+      })
+    );
     collectorOutputArgsSchema = withInfrastructureFailureDeclaration(
       collectorOutputBaseSchema
     );
-    collectorOutputArgsSchema.required = [];
   }
 });
 
 // src/collector-ledger.ts
-var COLLECTOR_OBSERVE_TOOL, COLLECTOR_READ_TOOL, COLLECTOR_REQUEST_TOOL, COLLECTOR_WAIT_TOOL;
+var COLLECTOR_OBSERVE_TOOL, COLLECTOR_READ_TOOL, COLLECTOR_REQUEST_TOOL, COLLECTOR_WAIT_TOOL, COLLECTOR_BIND_TARGET_TOOL;
 var init_collector_ledger = __esm({
   "src/collector-ledger.ts"() {
     "use strict";
     init_value2();
     init_collector_evidence();
     init_collector_github();
+    init_collector_identity();
     init_collector_tool_schemas();
     init_collector_output();
     COLLECTOR_OBSERVE_TOOL = "ak_collector_observe";
     COLLECTOR_READ_TOOL = "ak_collector_read";
     COLLECTOR_REQUEST_TOOL = "ak_collector_request";
     COLLECTOR_WAIT_TOOL = "ak_collector_wait";
+    COLLECTOR_BIND_TARGET_TOOL = "ak_collector_bind_target";
   }
 });
 
@@ -23323,11 +23808,11 @@ var init_navigator_invocation_identity = __esm({
 });
 
 // src/receipt-delivery-policy.ts
-function isRecord13(value) {
+function isRecord14(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseNoReceiptLifecycleFacts(input) {
-  if (!isRecord13(input) || typeof input.terminalToolCalled !== "boolean" || input.deliveryTurns !== RECEIPT_DELIVERY_TURN_LIMIT || input.sessionCompletion !== "settled-without-accepted-receipt" || input.acceptedReceipt !== false || typeof input.runPointer !== "string" || input.runPointer.trim() === "" || typeof input.attemptPointer !== "string" || input.attemptPointer.trim() === "" || !Array.isArray(input.rejectedReceipts) || !input.rejectedReceipts.every((item) => isRecord13(item) && typeof item.reason === "string")) {
+  if (!isRecord14(input) || typeof input.terminalToolCalled !== "boolean" || input.deliveryTurns !== RECEIPT_DELIVERY_TURN_LIMIT || input.sessionCompletion !== "settled-without-accepted-receipt" || input.acceptedReceipt !== false || typeof input.runPointer !== "string" || input.runPointer.trim() === "" || typeof input.attemptPointer !== "string" || input.attemptPointer.trim() === "" || !Array.isArray(input.rejectedReceipts) || !input.rejectedReceipts.every((item) => isRecord14(item) && typeof item.reason === "string")) {
     throw new TypeError("malformed no-receipt lifecycle facts");
   }
   return {
@@ -23513,7 +23998,7 @@ var init_terminal = __esm({
 // src/public-cli/settlement.ts
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { appendFile as appendFile2, readFile as readFile15, readdir as readdir5, writeFile as writeFile5 } from "node:fs/promises";
-import { dirname as dirname10, join as join20 } from "node:path";
+import { dirname as dirname10, join as join21 } from "node:path";
 function sealedLedgerHome(admitted) {
   return homeFromRunDirectory(admitted.runDirectory);
 }
@@ -23601,8 +24086,27 @@ function formatFailureStderrDiagnostic(failure) {
   const oneLine = selected.split(/\r?\n/).map((line2) => line2.trim()).find((line2) => line2.length > 0) ?? "failure";
   return formatCliDiagnostic(boundConciseDiagnostic(oneLine));
 }
+function formatErrorCauseDetail(cause) {
+  if (cause instanceof Error) return cause.message;
+  if (typeof cause === "object" && cause !== null) {
+    try {
+      return JSON.stringify(cause);
+    } catch {
+      return String(cause);
+    }
+  }
+  return String(cause);
+}
 function presentStructuralRejection(error, io) {
-  io.stderr(formatCliDiagnostic(error.message));
+  let message = error.message;
+  const cause = error.cause;
+  if (cause !== void 0) {
+    const detail = formatErrorCauseDetail(cause);
+    if (detail.trim().length > 0) {
+      message = `${message}; cause: ${detail}`;
+    }
+  }
+  io.stderr(formatCliDiagnostic(message));
 }
 function presentControlledFailure(failure, io) {
   io.stdout(`${JSON.stringify(failure, null, 2)}
@@ -23893,7 +24397,7 @@ async function readSitianRetainedAuditorProviderStop(sessionFile) {
     const { records: records2 } = await readSitianRecords(recordFile);
     for (let i = records2.length - 1; i >= 0; i -= 1) {
       const payload = records2[i]?.payload;
-      if (!isRecord14(payload) || !isRecord14(payload.response)) continue;
+      if (!isRecord15(payload) || !isRecord15(payload.response)) continue;
       if (typeof payload.type === "string") continue;
       const stop = sessionProviderStopFromAssistant(payload.response);
       if (stop !== void 0) return stop;
@@ -23914,7 +24418,7 @@ async function readSessionProviderStop(sessionFile) {
   }
 }
 async function readBoundEvidenceChildKnownFailure(sessionFile) {
-  const childDirectory = join20(dirname10(sessionFile), "evidence-children");
+  const childDirectory = join21(dirname10(sessionFile), "evidence-children");
   let names;
   try {
     names = await readdir5(childDirectory);
@@ -23925,12 +24429,12 @@ async function readBoundEvidenceChildKnownFailure(sessionFile) {
   for (const file of names.filter((name) => name.endsWith(".jsonl")).sort().reverse()) {
     let entries;
     try {
-      entries = await readBoundSessionEntries(join20(childDirectory, file));
+      entries = await readBoundSessionEntries(join21(childDirectory, file));
     } catch (error) {
       throw sessionReadFailure(error, "failed to read discovered evidence-child session");
     }
     const header = entries.find((entry) => entry.type === "session");
-    if (!isRecord14(header) || header.parentSession !== sessionFile) continue;
+    if (!isRecord15(header) || header.parentSession !== sessionFile) continue;
     const stop = extractSessionProviderStop(entries);
     if (stop === void 0) continue;
     const primary = knownFailureFromProviderStop(stop);
@@ -23962,12 +24466,12 @@ async function loadBoundAuditorVolumes(sessionFile) {
     return firstLine === RESUME_ENVELOPE;
   };
   const isResumeEnvelope = (msg) => {
-    if (!isRecord14(msg) || msg.role !== "user") return false;
+    if (!isRecord15(msg) || msg.role !== "user") return false;
     const text = typeof msg.text === "string" ? msg.text : typeof msg.content === "string" ? msg.content : void 0;
     if (isResumeEnvelopeBytes(text)) return true;
     const content = msg.content;
     if (Array.isArray(content)) {
-      return content.some((p) => isRecord14(p) && (isResumeEnvelopeBytes(p.text) || isResumeEnvelopeBytes(p.content)));
+      return content.some((p) => isRecord15(p) && (isResumeEnvelopeBytes(p.text) || isResumeEnvelopeBytes(p.content)));
     }
     return false;
   };
@@ -23979,7 +24483,7 @@ async function loadBoundAuditorVolumes(sessionFile) {
     latestParentUserIndex = i;
     break;
   }
-  const childDirectories = [join20(dirname10(sessionFile), "auditor-roles")];
+  const childDirectories = [join21(dirname10(sessionFile), "auditor-roles")];
   const valid = [];
   let sawAnyDirectory = false;
   for (const childDirectory of childDirectories) {
@@ -23994,12 +24498,12 @@ async function loadBoundAuditorVolumes(sessionFile) {
     for (const file of names.filter((name) => name.endsWith(".jsonl")).sort().reverse()) {
       let entries;
       try {
-        entries = await readBoundSessionEntries(join20(childDirectory, file));
+        entries = await readBoundSessionEntries(join21(childDirectory, file));
       } catch (error) {
         throw sessionReadFailure(error, "failed to read discovered auditor session");
       }
       const header = entries.find((entry) => entry.type === "session");
-      if (!isRecord14(header)) continue;
+      if (!isRecord15(header)) continue;
       const bindingIndexes = [];
       for (let i = 0; i < entries.length; i += 1) {
         const entry = entries[i];
@@ -24013,7 +24517,7 @@ async function loadBoundAuditorVolumes(sessionFile) {
         end: idx + 1 < bindingIndexes.length ? bindingIndexes[idx + 1] : entries.length
       })) : [{ entry: void 0, start: 0, end: entries.length }];
       for (const { entry: bindingEntry, start, end } of bindingPasses) {
-        const bindingParent = bindingEntry !== void 0 && isRecord14(bindingEntry.data) && isRecord14(bindingEntry.data.parent) ? bindingEntry.data.parent : void 0;
+        const bindingParent = bindingEntry !== void 0 && isRecord15(bindingEntry.data) && isRecord15(bindingEntry.data.parent) ? bindingEntry.data.parent : void 0;
         const attemptEntryId = typeof bindingParent?.attemptEntryId === "string" ? bindingParent.attemptEntryId : void 0;
         const attemptEntryIndex = attemptEntryId === void 0 ? -1 : parentEntries.findIndex((entry) => entry.id === attemptEntryId);
         const boundSessionFile = typeof bindingParent?.sessionFile === "string" ? bindingParent.sessionFile : typeof header.parentSession === "string" ? header.parentSession : void 0;
@@ -24040,11 +24544,11 @@ function complianceFailureFromAuditorVolumes(volumes) {
     if (stop === void 0) continue;
     for (let i = entries.length - 1; i >= 0; i -= 1) {
       const entry = entries[i];
-      if (entry?.type !== "custom" || entry.customType !== AUDITOR_COMPLIANCE_FAILURE_ENTRY_TYPE || !isRecord14(entry.data)) continue;
-      const parent = isRecord14(entry.data.parent) ? entry.data.parent : void 0;
-      const failure = isRecord14(entry.data.failure) ? entry.data.failure : void 0;
+      if (entry?.type !== "custom" || entry.customType !== AUDITOR_COMPLIANCE_FAILURE_ENTRY_TYPE || !isRecord15(entry.data)) continue;
+      const parent = isRecord15(entry.data.parent) ? entry.data.parent : void 0;
+      const failure = isRecord15(entry.data.failure) ? entry.data.failure : void 0;
       if (parent?.sessionId !== parentId || parent.sessionFile !== sessionFile || parent.attemptEntryId !== attemptEntryId || failure?.cause !== "provider" && failure?.cause !== "unrecognized") continue;
-      const identity = isRecord14(failure.identity) ? failure.identity : void 0;
+      const identity = isRecord15(failure.identity) ? failure.identity : void 0;
       return {
         cause: failure.cause === "provider" ? "provider" : "unrecognized",
         ...identity === void 0 ? {} : { identity: {
@@ -24052,7 +24556,7 @@ function complianceFailureFromAuditorVolumes(volumes) {
           ...typeof identity.code === "string" || typeof identity.code === "number" ? { code: identity.code } : {}
         } },
         ...typeof failure.diagnostic === "string" ? { diagnostic: failure.diagnostic } : {},
-        ...isRecord14(failure.details) ? { details: failure.details } : {}
+        ...isRecord15(failure.details) ? { details: failure.details } : {}
       };
     }
   }
@@ -24099,9 +24603,9 @@ function typedFailedTerminatingToolKnownFailure(entries) {
     if (classification.kind !== "infrastructure") continue;
     if (typeof message.toolCallId !== "string" || typeof message.toolName !== "string") continue;
     if (boundRoleToolCallForResult(attemptEntries, i, message, message.toolName) === void 0) continue;
-    const textPart = Array.isArray(message.content) ? message.content.find((part) => isRecord14(part) && part.type === "text" && typeof part.text === "string") : void 0;
-    const diagnostic = isRecord14(textPart) ? textPart.text : void 0;
-    const details = isRecord14(message.details) ? message.details : classification.fact;
+    const textPart = Array.isArray(message.content) ? message.content.find((part) => isRecord15(part) && part.type === "text" && typeof part.text === "string") : void 0;
+    const diagnostic = isRecord15(textPart) ? textPart.text : void 0;
+    const details = isRecord15(message.details) ? message.details : classification.fact;
     return {
       cause: "activation",
       identity: { name: message.toolName, code: message.toolCallId },
@@ -24259,7 +24763,7 @@ function controlledFailureInputFromResolution(resolution) {
     } : {}
   };
 }
-function isRecord14(value) {
+function isRecord15(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function safelyRead(object, key) {
@@ -24301,6 +24805,22 @@ function toolResultText(message) {
     return "";
   }).join("").trim();
 }
+function extractCollectorTargetBindRejection(entries) {
+  for (let i = entries.length - 1; i >= 0; i -= 1) {
+    const entry = entries[i];
+    if (entry?.type !== "message") continue;
+    const message = entry.message;
+    if (message?.role !== "toolResult") continue;
+    if (message.toolName !== COLLECTOR_BIND_TARGET_TOOL) continue;
+    if (message.isError !== true) return void 0;
+    const diagnostic = toolResultText(message);
+    if (diagnostic.length === 0) return void 0;
+    const details = message.details;
+    const code = isRecord15(details) && typeof details.code === "string" && details.code.trim() !== "" ? details.code : void 0;
+    return code === void 0 ? { diagnostic } : { diagnostic, code };
+  }
+  return void 0;
+}
 function boundErroredToolCandidate(entries, resultIndex, message, toolName) {
   if (message.toolName !== toolName || message.isError !== true) return void 0;
   const bound = boundRoleToolCallForResult(entries, resultIndex, message, toolName);
@@ -24362,7 +24882,7 @@ function assertCollectorReceiptMatchesAdmitted(receipt, admitted) {
       `Collector receipt repository "${receipt.repository}" does not match admitted repository "${admitted.repository.canonical}"`
     );
   }
-  if (receipt.prNumber !== admitted.prNumber) {
+  if (admitted.prNumber !== void 0 && receipt.prNumber !== admitted.prNumber) {
     throw collectorReceiptBindingFailure(
       `Collector receipt prNumber ${receipt.prNumber} does not match admitted prNumber ${admitted.prNumber}`
     );
@@ -24383,7 +24903,7 @@ function boundRoleToolCallForResult(entries, resultIndex, message, outputToolNam
     const candidateMessage = entries[index]?.message;
     if (candidateMessage?.role === "assistant" && Array.isArray(candidateMessage.content)) {
       for (const part of candidateMessage.content) {
-        if (!isRecord14(part) || part.type !== "toolCall" || part.id !== callId) {
+        if (!isRecord15(part) || part.type !== "toolCall" || part.id !== callId) {
           continue;
         }
         if (part.name !== outputToolName) return void 0;
@@ -24455,7 +24975,7 @@ function parseNavigatorAttendanceDetails(details) {
   const advisoryDiagnostic = typeof details.routePlaybookReadFailure === "string" ? { advisoryDiagnostic: details.routePlaybookReadFailure } : {};
   if (disposition === "recommendation") {
     const next = details.next;
-    if (!isRecord14(next) || typeof next.role !== "string") {
+    if (!isRecord15(next) || typeof next.role !== "string") {
       return {
         disposition: "unavailable",
         source: "unknown",
@@ -24463,7 +24983,7 @@ function parseNavigatorAttendanceDetails(details) {
       };
     }
     const reason = typeof details.reason === "string" ? details.reason : "";
-    const route = Array.isArray(details.route) ? details.route.filter(isRecord14).map((target) => ({
+    const route = Array.isArray(details.route) ? details.route.filter(isRecord15).map((target) => ({
       role: String(target.role),
       phase: navigatorPhaseValue(target.phase)
     })) : void 0;
@@ -24526,8 +25046,8 @@ function projectTerminalGateFact(rounds) {
   };
 }
 async function extractGateFactFromSessionDirectory(sessionDirectory, options = {}) {
-  const directories = [join20(sessionDirectory, "auditor-roles")];
-  const parentSessionFile = options.parentSessionFile ?? join20(sessionDirectory, "session.jsonl");
+  const directories = [join21(sessionDirectory, "auditor-roles")];
+  const parentSessionFile = options.parentSessionFile ?? join21(sessionDirectory, "session.jsonl");
   const rounds = await readAnalystGateCyclesFromAuditorRoles(directories, {
     parentSessionFile
   });
@@ -24535,7 +25055,7 @@ async function extractGateFactFromSessionDirectory(sessionDirectory, options = {
 }
 async function withOptionalGateProjection(base, sessionDirectory, gateContext = {}) {
   const secondaryEvidence = base.roleOutcome.kind === "failure" ? base.roleOutcome.decisiveFacts.secondaryEvidence : void 0;
-  if (isRecord14(secondaryEvidence) && secondaryEvidence.kind === "role_infrastructure_failure" && (secondaryEvidence.stage === "gatekeeper" || secondaryEvidence.stage === "inspector" || secondaryEvidence.stage === "notary")) return base;
+  if (isRecord15(secondaryEvidence) && secondaryEvidence.kind === "role_infrastructure_failure" && (secondaryEvidence.stage === "gatekeeper" || secondaryEvidence.stage === "inspector" || secondaryEvidence.stage === "notary")) return base;
   const gate = await extractGateFactFromSessionDirectory(sessionDirectory, gateContext);
   return gate === void 0 ? base : { ...base, gate };
 }
@@ -24575,7 +25095,7 @@ function extractNavigatorFact(entries) {
     const entry = entries[i];
     if (entry?.type === "custom_message" && entry.customType === "ak-navigator-attendance") {
       const details = entry.message?.details ?? entry.details;
-      if (!isRecord14(details)) {
+      if (!isRecord15(details)) {
         return {
           disposition: "unavailable",
           source: "unknown",
@@ -24625,8 +25145,8 @@ async function extractNavigatorFactFromAdmittedSession(sessionFile) {
 async function publishJudgeArtifacts(admitted, roleOutcome, coordinates) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join20(artifactsDir, "report.json");
-  const evidencePath = join20(artifactsDir, "evidence.json");
+  const reportPath = join21(artifactsDir, "report.json");
+  const evidencePath = join21(artifactsDir, "evidence.json");
   await writeFile5(
     reportPath,
     `${JSON.stringify(
@@ -24670,8 +25190,8 @@ async function publishJudgeArtifacts(admitted, roleOutcome, coordinates) {
 async function publishCoderArtifacts(admitted, roleOutcome, coordinates, options = {}) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join20(artifactsDir, "report.json");
-  const evidencePath = join20(artifactsDir, "evidence.json");
+  const reportPath = join21(artifactsDir, "report.json");
+  const evidencePath = join21(artifactsDir, "evidence.json");
   await writeFile5(
     reportPath,
     `${JSON.stringify(
@@ -24822,8 +25342,8 @@ function extractFixerMethodInvocations(entries, options) {
 async function publishFixerArtifacts(admitted, roleOutcome, coordinates, options) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join20(artifactsDir, "report.json");
-  const evidencePath = join20(artifactsDir, "evidence.json");
+  const reportPath = join21(artifactsDir, "report.json");
+  const evidencePath = join21(artifactsDir, "evidence.json");
   await writeFile5(
     reportPath,
     `${JSON.stringify(
@@ -24913,8 +25433,8 @@ async function settleLawfulFixerTerminalResult(admitted, authority, options) {
 async function publishCollectorArtifacts(admitted, roleOutcome, coordinates, options = {}) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join20(artifactsDir, "report.json");
-  const evidencePath = join20(artifactsDir, "evidence.json");
+  const reportPath = join21(artifactsDir, "report.json");
+  const evidencePath = join21(artifactsDir, "evidence.json");
   await writeFile5(
     reportPath,
     `${JSON.stringify(
@@ -24936,7 +25456,7 @@ async function publishCollectorArtifacts(admitted, roleOutcome, coordinates, opt
       {
         runId: admitted.runId,
         role: "collector",
-        prNumber: admitted.prNumber,
+        ...admitted.prNumber === void 0 ? {} : { prNumber: admitted.prNumber },
         repository: admitted.repository.canonical,
         manifestDigest: admitted.manifestDigest,
         sessionDirectory: coordinates.sessionDirectory,
@@ -24973,7 +25493,7 @@ async function settleLawfulCollectorTerminalResult(admitted, authority) {
       const residual = boundErroredToolCandidate(entries, index, message, COLLECTOR_WAIT_TOOL);
       if (residual === void 0) continue;
       const candidate = residual.candidate;
-      const duration = isRecord14(candidate) ? candidate.durationMs : void 0;
+      const duration = isRecord15(candidate) ? candidate.durationMs : void 0;
       if (Number.isSafeInteger(duration) && duration >= 1 && duration <= 9e5) {
         continue;
       }
@@ -25021,8 +25541,8 @@ async function trySettleCollectorTerminalResult(admitted, authority) {
 async function publishDoctorArtifacts(admitted, roleOutcome, coordinates, options = {}) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join20(artifactsDir, "report.json");
-  const evidencePath = join20(artifactsDir, "evidence.json");
+  const reportPath = join21(artifactsDir, "report.json");
+  const evidencePath = join21(artifactsDir, "evidence.json");
   await writeFile5(
     reportPath,
     `${JSON.stringify(
@@ -25163,7 +25683,7 @@ async function settleLawfulSeatAcceptedTerminalResult(admitted, authority, spec,
         spec.toolName
       );
       if (residual !== void 0) {
-        const details = isRecord14(residual.candidate) ? residual.candidate : { candidate: residual.candidate };
+        const details = isRecord15(residual.candidate) ? residual.candidate : { candidate: residual.candidate };
         return settleFailureTerminalResult(admitted, {
           cause: "output",
           diagnostic: residual.diagnostic,
@@ -25282,8 +25802,8 @@ function extractReviewerMethodInvocations(entries, options) {
 async function publishReviewerArtifacts(admitted, roleOutcome, coordinates, options) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join20(artifactsDir, "report.json");
-  const evidencePath = join20(artifactsDir, "evidence.json");
+  const reportPath = join21(artifactsDir, "report.json");
+  const evidencePath = join21(artifactsDir, "evidence.json");
   await writeFile5(
     reportPath,
     `${JSON.stringify(
@@ -25397,8 +25917,8 @@ function extractMergerMethodInvocations(entries, options) {
 async function publishMergerArtifacts(admitted, roleOutcome, coordinates, options) {
   await appendRunAttemptHistory({ role: admitted.role, runId: admitted.runId, sessionFile: coordinates.sessionFile }, roleOutcome);
   const artifactsDir = await ensureRunArtifactsDir(admitted.runDirectory);
-  const reportPath = join20(artifactsDir, "report.json");
-  const evidencePath = join20(artifactsDir, "evidence.json");
+  const reportPath = join21(artifactsDir, "report.json");
+  const evidencePath = join21(artifactsDir, "evidence.json");
   await writeFile5(
     reportPath,
     `${JSON.stringify(
@@ -25465,7 +25985,7 @@ async function settleLawfulMergerTerminalResult(admitted, authority, options) {
       if (message?.role !== "toolResult") continue;
       const residual = boundErroredToolCandidate(entries, index, message, MERGER_OUTPUT_TOOL_NAME);
       if (residual === void 0) continue;
-      const attemptId = isRecord14(residual.candidate) ? safelyRead(residual.candidate, "attemptId") : { readable: true, value: void 0 };
+      const attemptId = isRecord15(residual.candidate) ? safelyRead(residual.candidate, "attemptId") : { readable: true, value: void 0 };
       if (!attemptId.readable || attemptId.value !== admitted.runId) continue;
       return {
         roleOutcome: buildResidualIncompleteTerminalOutcome({
@@ -25543,7 +26063,7 @@ function uniqueFailureFallbackDirs(runDirectory, baseDir) {
   return dirs;
 }
 async function resolveFailureArtifactsBase(runDirectory) {
-  const artifactsDir = join20(runDirectory, "artifacts");
+  const artifactsDir = join21(runDirectory, "artifacts");
   try {
     await ensureRunArtifactsDir(runDirectory);
     return { baseDir: artifactsDir };
@@ -25559,7 +26079,7 @@ async function writeFailureJsonRetainingCause(preferredCandidates, uniqueFallbac
   const candidates = [
     ...preferredCandidates,
     // One unique name per fallback dir — collisions on fixed names cannot exhaust this.
-    ...uniqueFallbackDirs.map((dir) => join20(dir, `${stem}.${randomUUID3()}.json`))
+    ...uniqueFallbackDirs.map((dir) => join21(dir, `${stem}.${randomUUID3()}.json`))
   ];
   for (let i = 0; i < candidates.length; i += 1) {
     const path = candidates[i];
@@ -25604,26 +26124,26 @@ async function publishFailureArtifacts(admitted, failure, authority) {
   } catch (error) {
     priorIssues.push(publicationAttemptFromError(sessionFile, error));
   }
-  const underArtifacts = baseDir === join20(admitted.runDirectory, "artifacts");
+  const underArtifacts = baseDir === join21(admitted.runDirectory, "artifacts");
   const uniqueFallbackDirs = uniqueFailureFallbackDirs(
     admitted.runDirectory,
     baseDir
   );
   const errorCandidates = underArtifacts ? [
-    join20(baseDir, "error.json"),
-    join20(baseDir, "error.settlement.json"),
-    join20(admitted.runDirectory, "error.settlement.json")
+    join21(baseDir, "error.json"),
+    join21(baseDir, "error.settlement.json"),
+    join21(admitted.runDirectory, "error.settlement.json")
   ] : [
-    join20(baseDir, "error.settlement.json"),
-    join20(baseDir, "error.json")
+    join21(baseDir, "error.settlement.json"),
+    join21(baseDir, "error.json")
   ];
   const evidenceCandidates = underArtifacts ? [
-    join20(baseDir, "evidence.json"),
-    join20(baseDir, "evidence.settlement.json"),
-    join20(admitted.runDirectory, "evidence.settlement.json")
+    join21(baseDir, "evidence.json"),
+    join21(baseDir, "evidence.settlement.json"),
+    join21(admitted.runDirectory, "evidence.settlement.json")
   ] : [
-    join20(baseDir, "evidence.settlement.json"),
-    join20(baseDir, "evidence.json")
+    join21(baseDir, "evidence.settlement.json"),
+    join21(baseDir, "evidence.json")
   ];
   const errorPayloadBase = {
     kind: "error",
@@ -25725,7 +26245,18 @@ async function settleFailureTerminalResult(admitted, failure, authority, options
         try {
           const facts = parseNoReceiptLifecycleFacts(raw);
           if (facts.runPointer === admitted.runDirectory && facts.attemptPointer === `current:${admitted.runDirectory}`) {
-            const decisiveFacts2 = facts;
+            let decisiveFacts2 = facts;
+            if (admitted.role === "collector") {
+              const bindRejection = extractCollectorTargetBindRejection(entries.slice(attemptStart));
+              if (bindRejection !== void 0) {
+                decisiveFacts2 = {
+                  ...facts,
+                  targetBindRejected: true,
+                  targetBindDiagnostic: bindRejection.diagnostic,
+                  ...bindRejection.code === void 0 ? {} : { targetBindCode: bindRejection.code }
+                };
+              }
+            }
             return withOptionalGateProjection(
               {
                 roleOutcome: { kind: "no_receipt", role: admitted.role, status: "no-accepted-receipt", ...facts, decisiveFacts: decisiveFacts2 },
@@ -25806,6 +26337,14 @@ function presentFailureTerminal(terminal, io) {
       cause: terminal.roleOutcome.cause,
       diagnostic: terminal.roleOutcome.diagnostic
     }));
+    return;
+  }
+  const bindDiagnostic = terminal.roleOutcome.decisiveFacts.targetBindDiagnostic;
+  if (typeof bindDiagnostic === "string" && bindDiagnostic.trim() !== "") {
+    io.stderr(formatFailureStderrDiagnostic({
+      cause: "output",
+      diagnostic: bindDiagnostic
+    }));
   }
 }
 var CONCISE_DIAGNOSTIC_MAX_CHARS, COLLECTOR_INFRASTRUCTURE_TOOLS, COLLECTOR_INFRASTRUCTURE_FAILURE_SPEC, ENGINE_DETOUR_INFRASTRUCTURE_FAILURE_SPEC, ATTEMPT_HISTORY_ENTRY_TYPE;
@@ -25906,7 +26445,7 @@ var init_ticket_provenance_contracts = __esm({
 });
 
 // src/ticket-provenance.ts
-import { join as join21 } from "node:path";
+import { join as join22 } from "node:path";
 function ticketProvenanceSubject(ticketNumber) {
   if (!Number.isSafeInteger(ticketNumber) || ticketNumber < 1) {
     throw new Error(`ticket-provenance subject requires a positive ticket number, got ${String(ticketNumber)}`);
@@ -25924,7 +26463,7 @@ function resolveTicketProvenanceVolume(ticketNumber, cwd, home) {
   return {
     recordFile: path.recordFile,
     volumeDir: path.sessionDir,
-    humanViewFile: join21(path.sessionDir, TICKET_PROVENANCE_HUMAN_VIEW)
+    humanViewFile: join22(path.sessionDir, TICKET_PROVENANCE_HUMAN_VIEW)
   };
 }
 var init_ticket_provenance = __esm({
@@ -25974,7 +26513,7 @@ var init_case_dossier_delivery = __esm({
 
 // src/host-transition-prior-native.ts
 import { access as access2, readdir as readdir6 } from "node:fs/promises";
-import { dirname as dirname11, join as join22 } from "node:path";
+import { dirname as dirname11, join as join23 } from "node:path";
 function isEnoent2(error) {
   return typeof error === "object" && error !== null && error.code === "ENOENT";
 }
@@ -25999,7 +26538,7 @@ async function listSitianRecordPaths(sessionParent) {
   const recordPaths = [];
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const recordFile = join22(sessionRoot, entry.name, "records.jsonl");
+    const recordFile = join23(sessionRoot, entry.name, "records.jsonl");
     try {
       await access2(recordFile);
       recordPaths.push(recordFile);
@@ -26069,7 +26608,7 @@ var init_public_run_credentials = __esm({
 import { constants as fsConstants } from "node:fs";
 import { randomUUID as randomUUID4 } from "node:crypto";
 import { lstat as lstat5, mkdir as mkdir4, open as open2 } from "node:fs/promises";
-import { join as join23 } from "node:path";
+import { join as join24 } from "node:path";
 function presentTerminal(terminal, io) {
   if (terminal.roleOutcome.kind === "failure" || terminal.roleOutcome.kind === "no_receipt") {
     presentFailureTerminal(terminal, io);
@@ -26088,7 +26627,7 @@ async function finalizeExceptionRunBestEffort(runDirectory, io) {
   }
 }
 function runArtifactsDirectory(runDirectory) {
-  return join23(runDirectory, "artifacts");
+  return join24(runDirectory, "artifacts");
 }
 async function ensureRealArtifactsDirectory(runDirectory) {
   const runStat = await lstat5(runDirectory);
@@ -26171,7 +26710,7 @@ function jsonSafeReplacer() {
 }
 async function retainDispatchError(admitted, principalAuthority, sessionAppender, attempt, error) {
   const artifactsDir = await ensureRealArtifactsDirectory(admitted.runDirectory);
-  const filePath = join23(
+  const filePath = join24(
     artifactsDir,
     `dispatch-error-attempt-${attempt}-${randomUUID4()}.json`
   );
@@ -26420,7 +26959,7 @@ var init_auto_resume = __esm({
 // src/public-cli/post-admission.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
 import { readFile as readFile16, writeFile as writeFile6 } from "node:fs/promises";
-import { isAbsolute as isAbsolute7, join as join24, resolve as resolve8 } from "node:path";
+import { isAbsolute as isAbsolute7, join as join25, resolve as resolve8 } from "node:path";
 function appendContinuationSection(continuation, section) {
   const prompt = `${continuation.prompt}
 
@@ -26429,7 +26968,7 @@ ${section}`;
 }
 async function readInvocationHost(runDirectory) {
   try {
-    const raw = JSON.parse(await readFile16(join24(runDirectory, "invocation.json"), "utf8"));
+    const raw = JSON.parse(await readFile16(join25(runDirectory, "invocation.json"), "utf8"));
     return typeof raw.host === "string" && raw.host.trim() !== "" ? raw.host : void 0;
   } catch (error) {
     if (error.code === "ENOENT") return void 0;
@@ -26583,7 +27122,7 @@ async function dispatchPostAdmissionTurn(input) {
     }
     try {
       await writeFile6(
-        join24(admitted.runDirectory, "stderr.log"),
+        join25(admitted.runDirectory, "stderr.log"),
         result2.stderr,
         "utf8"
       );
@@ -26692,7 +27231,7 @@ function resumeTurnRequestProjectionOptions(admitted, request, env, summonsPrepa
 }
 function isAlreadyFrozenSummonsAttachment(runDirectory, attachmentPath) {
   const absolute = isAbsolute7(attachmentPath) ? attachmentPath : resolve8(attachmentPath);
-  return pathContainedIn(join24(runDirectory, "attachments"), absolute);
+  return pathContainedIn(join25(runDirectory, "attachments"), absolute);
 }
 async function prepareSummonsResumeMaterials(runDirectory, summons) {
   if (summons === void 0) return void 0;
@@ -27478,7 +28017,8 @@ function buildCollectorTurnRequest(admitted, options) {
       activation: {
         role: "collector",
         repo: admitted.repository.display,
-        pr: String(admitted.prNumber),
+        // #676 A: omit pr when unbound — role binds via ak_collector_bind_target.
+        ...admitted.prNumber === void 0 ? {} : { pr: String(admitted.prNumber) },
         ...admitted.requestManifestPath === void 0 ? {} : { requestManifestPath: admitted.requestManifestPath }
       }
     },
@@ -27493,7 +28033,7 @@ async function runPublicCollector(argv, env, io, parseCollectorArgv2) {
       home: env.home,
       principalAuthority: env.principalAuthority,
       cwd: env.cwd,
-      prNumber: parsed.prNumber,
+      ...parsed.prNumber === void 0 ? {} : { prNumber: parsed.prNumber },
       instruction: parsed.instruction,
       attachmentPaths: parsed.attachmentPaths,
       ...parsed.project === void 0 ? {} : { project: parsed.project },
@@ -28860,7 +29400,7 @@ var init_judge_run = __esm({
 
 // src/public-cli/merger-run.ts
 import { mkdir as mkdir5, writeFile as writeFile7 } from "node:fs/promises";
-import { join as join25, resolve as resolve9 } from "node:path";
+import { join as join26, resolve as resolve9 } from "node:path";
 function mergerMethods(packageRoot2) {
   return [
     {
@@ -28926,8 +29466,8 @@ async function admitMergerShellForActivationFailure(options) {
     expectedConflictPaths: [],
     resolutionScope: []
   };
-  const admittedRequestPath = join25(runDirectory, "admitted-request.json");
-  const mergerInputPath = join25(runDirectory, "merger-input.json");
+  const admittedRequestPath = join26(runDirectory, "admitted-request.json");
+  const mergerInputPath = join26(runDirectory, "merger-input.json");
   await writeFile7(
     admittedRequestPath,
     `${JSON.stringify(
@@ -29367,10 +29907,10 @@ var init_analyst_book_key = __esm({
 // src/atomic-write.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
 import { rename, rm, writeFile as writeFile8 } from "node:fs/promises";
-import { dirname as dirname12, join as join26 } from "node:path";
+import { dirname as dirname12, join as join27 } from "node:path";
 async function writeFileAtomically(destination, contents) {
   const parent = dirname12(destination);
-  const temporary = join26(parent, `.atomic-write-${randomUUID6()}.tmp`);
+  const temporary = join27(parent, `.atomic-write-${randomUUID6()}.tmp`);
   try {
     await writeFile8(temporary, contents);
     await rename(temporary, destination);
@@ -29387,7 +29927,7 @@ var init_atomic_write = __esm({
 
 // src/analyst-index.ts
 import { open as open3, readFile as readFile17, unlink as unlink4 } from "node:fs/promises";
-import { dirname as dirname13, join as join27 } from "node:path";
+import { dirname as dirname13, join as join28 } from "node:path";
 function sleep(ms) {
   return new Promise((resolve11) => {
     setTimeout(resolve11, ms);
@@ -29396,7 +29936,7 @@ function sleep(ms) {
 async function withAnalystLibraryIndexLock(ledgerHome, fn) {
   const indexPath = analystLibraryIndexPath(ledgerHome);
   ensureRealDirectoryTree(ledgerHome, dirname13(indexPath));
-  const lockPath = join27(dirname13(indexPath), LIBRARY_INDEX_LOCK_NAME);
+  const lockPath = join28(dirname13(indexPath), LIBRARY_INDEX_LOCK_NAME);
   assertLedgerFileInsideHome(lockPath, ledgerHome);
   const startedAt = Date.now();
   while (true) {
@@ -29423,7 +29963,7 @@ async function withAnalystLibraryIndexLock(ledgerHome, fn) {
   }
 }
 function analystLibraryIndexPath(ledgerHome) {
-  return join27(ledgerHome, "analyst", "library-index.json");
+  return join28(ledgerHome, "analyst", "library-index.json");
 }
 function rowFromIssueMetricsPage(page) {
   return {
@@ -29719,22 +30259,22 @@ var init_analyst_cohort = __esm({
 
 // src/analyst-ledger.ts
 import { readdir as readdir7, readFile as readFile18 } from "node:fs/promises";
-import { join as join28 } from "node:path";
+import { join as join29 } from "node:path";
 function isMissingPathError5(error) {
   return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
 }
 function errorText3(error) {
   return error instanceof Error ? error.message : String(error);
 }
-function isRecord15(value) {
+function isRecord16(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 async function readExistingRunLifecycleState(runDirectory) {
   try {
     const raw = JSON.parse(
-      await readFile18(join28(runDirectory, "run-state.json"), "utf8")
+      await readFile18(join29(runDirectory, "run-state.json"), "utf8")
     );
-    if (!isRecord15(raw) || typeof raw.state !== "string") return void 0;
+    if (!isRecord16(raw) || typeof raw.state !== "string") return void 0;
     return raw.state;
   } catch {
     return void 0;
@@ -29764,13 +30304,13 @@ async function listLedgerBookNames(booksRoot) {
 async function readInvocationScopeFields(runDirectory) {
   let raw;
   try {
-    raw = await readFile18(join28(runDirectory, "invocation.json"), "utf8");
+    raw = await readFile18(join29(runDirectory, "invocation.json"), "utf8");
   } catch (error) {
     if (isMissingPathError5(error)) return void 0;
     throw error;
   }
   const parsed = JSON.parse(raw);
-  if (!isRecord15(parsed)) return void 0;
+  if (!isRecord16(parsed)) return void 0;
   if (typeof parsed.projectRoot !== "string" || parsed.projectRoot.trim() === "") {
     return void 0;
   }
@@ -29796,15 +30336,15 @@ function decideIssueScope(input) {
 }
 async function resolveSessionFile(runDirectory) {
   try {
-    const raw = await readFile18(join28(runDirectory, "invocation.json"), "utf8");
+    const raw = await readFile18(join29(runDirectory, "invocation.json"), "utf8");
     const parsed = JSON.parse(raw);
-    if (isRecord15(parsed) && typeof parsed.sessionFile === "string" && parsed.sessionFile.trim() !== "") {
+    if (isRecord16(parsed) && typeof parsed.sessionFile === "string" && parsed.sessionFile.trim() !== "") {
       return parsed.sessionFile;
     }
   } catch (error) {
     if (!isMissingPathError5(error)) throw error;
   }
-  return join28(runDirectory, "session", "session.jsonl");
+  return join29(runDirectory, "session", "session.jsonl");
 }
 function attributeSessionRowsForRun(input) {
   if (pathContainedIn(input.runDirectory, input.sessionFile)) {
@@ -29976,9 +30516,9 @@ async function classifyScopedRun(input) {
   }
   let gateCycles;
   try {
-    const parentSessionFile = join28(input.runDirectory, "session", "session.jsonl");
+    const parentSessionFile = join29(input.runDirectory, "session", "session.jsonl");
     gateCycles = await readAnalystGateCyclesFromAuditorRoles(
-      join28(input.runDirectory, "session", "auditor-roles"),
+      join29(input.runDirectory, "session", "auditor-roles"),
       { parentSessionFile }
     );
   } catch (error) {
@@ -30011,7 +30551,7 @@ async function classifyScopedRun(input) {
 async function scanAnalystIssueRuns(input) {
   const ledgerHome = resolveActivationLedgerHome(input.home);
   const scopeTicketNumber = input.ticketNumber;
-  const booksRoot = join28(ledgerHome, "books");
+  const booksRoot = join29(ledgerHome, "books");
   let wholeBook = false;
   let scopeRootIdentity;
   let bookNames;
@@ -30043,7 +30583,7 @@ async function scanAnalystIssueRuns(input) {
   const unreadable = [];
   const scopeConflicts = [];
   for (const book of bookNames) {
-    const runsDir = join28(booksRoot, book, "runs");
+    const runsDir = join29(booksRoot, book, "runs");
     let runNames;
     try {
       const entries = await readdir7(runsDir, { withFileTypes: true });
@@ -30055,7 +30595,7 @@ async function scanAnalystIssueRuns(input) {
     for (const runName of runNames) {
       const parsed = parseRunDirectoryName2(runName);
       if (parsed === void 0) continue;
-      const runDirectory = join28(runsDir, runName);
+      const runDirectory = join29(runsDir, runName);
       let scopeFields;
       try {
         scopeFields = await readInvocationScopeFields(runDirectory);
@@ -30103,7 +30643,7 @@ var init_analyst_ledger = __esm({
 });
 
 // src/analyst-metric-families/acceptance-success-rework.ts
-function isRecord16(value) {
+function isRecord17(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function wallMsFromSpan(span) {
@@ -30112,21 +30652,21 @@ function wallMsFromSpan(span) {
 function findCollectorGroups(body) {
   if (Array.isArray(body.groups)) return body.groups;
   const receipt = body.receipt;
-  if (isRecord16(receipt) && Array.isArray(receipt.groups)) return receipt.groups;
+  if (isRecord17(receipt) && Array.isArray(receipt.groups)) return receipt.groups;
   const outcome = body.outcome;
-  if (isRecord16(outcome)) {
+  if (isRecord17(outcome)) {
     const facts = outcome.decisiveFacts;
-    if (isRecord16(facts) && Array.isArray(facts.groups)) return facts.groups;
+    if (isRecord17(facts) && Array.isArray(facts.groups)) return facts.groups;
   }
   return void 0;
 }
 function extractStatus(body) {
   const outcome = body.outcome;
-  if (isRecord16(outcome) && typeof outcome.status === "string" && outcome.status.trim() !== "") {
+  if (isRecord17(outcome) && typeof outcome.status === "string" && outcome.status.trim() !== "") {
     return outcome.status;
   }
   const receipt = body.receipt;
-  if (isRecord16(receipt) && typeof receipt.status === "string" && receipt.status.trim() !== "") {
+  if (isRecord17(receipt) && typeof receipt.status === "string" && receipt.status.trim() !== "") {
     return receipt.status;
   }
   if (typeof body.status === "string" && body.status.trim() !== "") {
@@ -30751,21 +31291,21 @@ var init_leg_wall_clock = __esm({
 });
 
 // src/analyst-metric-families/round-timeline.ts
-function isRecord17(value) {
+function isRecord18(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function wallMsFromSpan2(startedAt, endedAt) {
   return Date.parse(endedAt) - Date.parse(startedAt);
 }
 function readOutcomeStatus(body) {
-  if (!isRecord17(body.outcome)) return void 0;
+  if (!isRecord18(body.outcome)) return void 0;
   const status = body.outcome.status;
   if (typeof status !== "string" || status.trim() === "") return void 0;
   return status;
 }
 function readClassCount(body) {
-  if (!isRecord17(body.outcome)) return void 0;
-  if (!isRecord17(body.outcome.decisiveFacts)) return void 0;
+  if (!isRecord18(body.outcome)) return void 0;
+  if (!isRecord18(body.outcome.decisiveFacts)) return void 0;
   const classCount = body.outcome.decisiveFacts.classCount;
   if (typeof classCount !== "number" || !Number.isFinite(classCount)) {
     return void 0;
@@ -30909,7 +31449,7 @@ var init_analyst_metric_family = __esm({
 
 // src/analyst-page.ts
 import { createHash as createHash5 } from "node:crypto";
-import { dirname as dirname14, join as join29 } from "node:path";
+import { dirname as dirname14, join as join30 } from "node:path";
 function analystIssuePageKey(address) {
   const parts = ["book", address.bookKey];
   if (address.issueNumber !== void 0) {
@@ -30920,7 +31460,7 @@ function analystIssuePageKey(address) {
   return createHash5("sha256").update(parts.join("\0")).digest("hex").slice(0, 32);
 }
 function analystIssuePagePath(ledgerHome, address) {
-  return join29(ledgerHome, "analyst", "issues", `${analystIssuePageKey(address)}.json`);
+  return join30(ledgerHome, "analyst", "issues", `${analystIssuePageKey(address)}.json`);
 }
 function analystIssuePageAddressFromPage(page) {
   return {
@@ -31453,7 +31993,7 @@ __export(cli_exports, {
   runAkRole: () => runAkRole
 });
 import { realpath as realpath6 } from "node:fs/promises";
-import { join as join30 } from "node:path";
+import { join as join31 } from "node:path";
 function takePublicGlobalFlag(argv, index, options) {
   const tokens = argv.slice(index);
   const taken = options.takeDashed(tokens);
@@ -31505,7 +32045,7 @@ function resolveRoleTurnHost(env, options) {
           ok: true,
           host: {
             executeTurn: async (request) => {
-              hostPromise ??= loadProductionAcpHostFactory(env.packageRoot, name).then(
+              hostPromise ??= loadProductionExternalHostFactory(env.packageRoot, name).then(
                 (create) => create({
                   packageRoot: env.packageRoot,
                   principalAuthority: options.principalAuthority
@@ -31592,7 +32132,7 @@ function resolveHome(env) {
   return env.home ?? packageMachineHome();
 }
 function resolveAgentDir(env, home) {
-  return env.agentDir ?? process.env.PI_CODING_AGENT_DIR ?? join30(home, ".pi", "agent");
+  return env.agentDir ?? process.env.PI_CODING_AGENT_DIR ?? join31(home, ".pi", "agent");
 }
 function parseThinking(value) {
   return value;
@@ -32458,7 +32998,13 @@ async function runAkRole(argv, env) {
       return { exitCode: 2 };
     }
     if (error instanceof Error) {
-      const label = error.name !== "" && error.name !== "Error" ? `${error.name}: ${error.message}` : error.message;
+      let label = error.name !== "" && error.name !== "Error" ? `${error.name}: ${error.message}` : error.message;
+      if (error.cause !== void 0) {
+        const detail = formatErrorCauseDetail(error.cause);
+        if (detail.trim().length > 0) {
+          label = `${label || error.name || "unrecognized exception"}; cause: ${detail}`;
+        }
+      }
       io.stderr(formatCliDiagnostic(label || error.name || "unrecognized exception"));
       return { exitCode: 1 };
     }
@@ -32479,7 +33025,7 @@ var init_cli = __esm({
     init_registry2();
     init_cli_errors();
     init_host_descriptions();
-    init_load_production_acp_host();
+    init_load_production_external_host();
     init_role_turn_host();
     init_invocation();
     init_option_definitions();
@@ -32550,8 +33096,8 @@ var init_cli = __esm({
 });
 
 // src/public-cli/main.ts
-import { existsSync as existsSync7 } from "node:fs";
-import { dirname as dirname15, join as join31 } from "node:path";
+import { existsSync as existsSync8 } from "node:fs";
+import { dirname as dirname15, join as join32 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/public-cli/host-pi-runtime.ts
@@ -32640,13 +33186,14 @@ function linkPackage(packageRoot2, name, targetDir) {
 // src/public-cli/main.ts
 var here = dirname15(fileURLToPath2(import.meta.url));
 function resolvePackageRoot(binDir) {
-  const canonical = join31(binDir, "..", "..");
-  if (existsSync7(join31(canonical, "package.json"))) {
+  const canonical = join32(binDir, "..", "..");
+  if (existsSync8(join32(canonical, "package.json"))) {
     return canonical;
   }
   return binDir;
 }
 var packageRoot = resolvePackageRoot(here);
+process.env.AK_ROLE_PACKAGE_ROOT = packageRoot;
 ensureHostPiRuntimeResolvable(packageRoot);
 var { runAkRole: runAkRole2 } = await Promise.resolve().then(() => (init_cli(), cli_exports));
 var result = await runAkRole2(process.argv.slice(2), { packageRoot });