@akagilnc/pi-workflow-roles 0.1.3749 → 0.1.3771

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 }
     );
@@ -16532,8 +16565,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":
@@ -17276,13 +17308,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();
   }
 });
 
@@ -18439,7 +18814,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 +18834,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
@@ -19254,12 +19629,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 +19954,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 +20107,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,
@@ -20610,7 +20987,7 @@ function parseCollectorArgv(args) {
   }
   options.assertRequired();
   return {
-    prNumber,
+    ...prNumber === void 0 ? {} : { prNumber },
     instruction: positional.join(" "),
     attachmentPaths,
     ...project === void 0 ? {} : { project },
@@ -20621,16 +20998,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 +21032,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;
@@ -20729,13 +21091,19 @@ async function admitCollectorInvocation(options) {
   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");
     await writeFile4(requestManifestPath, manifestCanonicalJson, "utf8");
   }
-  const instruction = options.instruction ?? "";
-  const instructionEmpty = instruction.trim() === "";
   const admitted = {
     role: "collector",
     runId,
@@ -20745,7 +21113,7 @@ async function admitCollectorInvocation(options) {
     principal,
     instruction,
     instructionEmpty,
-    prNumber,
+    ...prNumber === void 0 ? {} : { prNumber },
     repository: repository.canonical,
     repositoryDisplay: repository.display,
     ...requestManifestPath === void 0 ? {} : { requestManifestPath },
@@ -20775,14 +21143,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();
@@ -21802,6 +22170,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();
@@ -21852,11 +22222,11 @@ function resolvePackagedMethodSkillRoot(packageRoot2, name) {
 function resolvePackagedMethodSkillPath(packageRoot2, name) {
   return join15(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 +22240,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 +22267,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)) {
@@ -22085,7 +22455,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 +22479,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 +22516,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 +22532,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 +22549,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,
@@ -22265,7 +22635,7 @@ 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) {
+function isRecord12(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isParentAttemptBindingRow(row) {
@@ -22296,7 +22666,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 +22705,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 +22720,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 +22731,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 +22871,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;
@@ -22576,14 +22946,14 @@ function isMissingPathError2(error) {
 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})`
@@ -23156,20 +23526,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 +23554,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 +23729,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 {
@@ -23601,8 +24007,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 +24318,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;
@@ -23930,7 +24355,7 @@ async function readBoundEvidenceChildKnownFailure(sessionFile) {
       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 +24387,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;
   };
@@ -23999,7 +24424,7 @@ async function loadBoundAuditorVolumes(sessionFile) {
         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 +24438,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 +24465,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 +24477,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 +24524,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 +24684,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 +24726,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 +24803,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 +24824,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 +24896,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 +24904,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;
@@ -24535,7 +24976,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 +25016,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",
@@ -24936,7 +25377,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 +25414,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;
       }
@@ -25163,7 +25604,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,
@@ -25465,7 +25906,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({
@@ -25725,7 +26166,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 +26258,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;
@@ -27478,7 +27938,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 +27954,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 },
@@ -29726,7 +30187,7 @@ function isMissingPathError5(error) {
 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) {
@@ -29734,7 +30195,7 @@ async function readExistingRunLifecycleState(runDirectory) {
     const raw = JSON.parse(
       await readFile18(join28(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;
@@ -29770,7 +30231,7 @@ async function readInvocationScopeFields(runDirectory) {
     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;
   }
@@ -29798,7 +30259,7 @@ async function resolveSessionFile(runDirectory) {
   try {
     const raw = await readFile18(join28(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) {
@@ -30103,7 +30564,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 +30573,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 +31212,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;
@@ -32458,7 +32919,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 };
     }