@akagilnc/pi-workflow-roles 0.1.3771 → 0.1.3789

package/dist/acp-host/production-host.js

@@ -883,10 +883,10 @@ __export(session_assistant_usage_exports, {
 });
 import { join as join2 } from "node:path";
 async function readAssistantUsageFromSessionFile(sessionFile) {
-  const { readFile: readFile21 } = await import("node:fs/promises");
+  const { readFile: readFile22 } = await import("node:fs/promises");
   let text;
   try {
-    text = await readFile21(sessionFile, "utf8");
+    text = await readFile22(sessionFile, "utf8");
   } catch (error) {
     if (error?.code === "ENOENT") return void 0;
     throw error;
@@ -6085,8 +6085,8 @@ var init_option_definitions = __esm({
         repeatable: false,
         form: "option",
         description: {
-          en: "Optional request manifest JSON path ({requests:[{id,body}]}).",
-          zh: "\u53EF\u9009 request manifest JSON \u8DEF\u5F84\uFF08{requests:[{id,body}]}\uFF09\u3002"
+          en: "Optional request manifest JSON path ({requests:[{id,body}]}). Role may also decide request bodies from handbook/field activity without this file.",
+          zh: "\u53EF\u9009 request manifest JSON \u8DEF\u5F84\uFF08{requests:[{id,body}]}\uFF09\u3002\u89D2\u8272\u4EA6\u53EF\u4F9D\u624B\u518C/\u73B0\u573A\u81EA\u884C\u5224\u5B9A\u8BF7\u6C42\u6B63\u6587\uFF0C\u4E0D\u5FC5\u4F9D\u8D56\u672C\u6587\u4EF6\u3002"
         }
       }
     ];
@@ -8518,11 +8518,11 @@ function parseAnalystCohortIssueToken(raw, flag) {
       `${flag} requires a comma-separated list of N or book:N`
     );
   }
-  const sep4 = trimmed.lastIndexOf(":");
-  if (sep4 > 0) {
-    const rhs = trimmed.slice(sep4 + 1);
+  const sep5 = trimmed.lastIndexOf(":");
+  if (sep5 > 0) {
+    const rhs = trimmed.slice(sep5 + 1);
     if (ANALYST_TICKET_NUMBER_PATTERN.test(rhs)) {
-      const bookKey = trimmed.slice(0, sep4);
+      const bookKey = trimmed.slice(0, sep5);
       if (bookKey.trim() === "") {
         throw new CliUsageError(
           `${flag} book:N requires a non-empty book key, got ${raw}`
@@ -8756,24 +8756,35 @@ var init_invocation = __esm({
 var host_descriptions_exports = {};
 __export(host_descriptions_exports, {
   DEFAULT_ROLE_TURN_HOST: () => DEFAULT_ROLE_TURN_HOST,
+  HEADLESS_HOST_DESCRIPTIONS: () => HEADLESS_HOST_DESCRIPTIONS,
   HOST_DESCRIPTIONS: () => HOST_DESCRIPTIONS,
   assertRegisteredHostName: () => assertRegisteredHostName,
+  lookupHeadlessHostDescription: () => lookupHeadlessHostDescription,
   lookupHostDescription: () => lookupHostDescription,
+  lookupHostFamily: () => lookupHostFamily,
   packagedExternalHostNames: () => packagedExternalHostNames
 });
 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";
@@ -8825,14 +8836,37 @@ 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"
+      })
+    });
   }
 });
 
 // src/public-cli/load-production-acp-host.ts
-var load_production_acp_host_exports = {};
-__export(load_production_acp_host_exports, {
-  loadProductionAcpHostFactory: () => loadProductionAcpHostFactory
-});
 import { existsSync as existsSync5 } from "node:fs";
 import { join as join14 } from "node:path";
 import { pathToFileURL } from "node:url";
@@ -8856,6 +8890,54 @@ var init_load_production_acp_host = __esm({
   }
 });
 
+// src/public-cli/load-production-headless-host.ts
+import { existsSync as existsSync6 } from "node:fs";
+import { join as join15 } from "node:path";
+import { pathToFileURL as pathToFileURL2 } from "node:url";
+async function loadProductionHeadlessHostFactory(packageRoot, host) {
+  const description = lookupHeadlessHostDescription(host);
+  if (description === void 0) {
+    throw new Error(`unregistered headless host: ${host}`);
+  }
+  const built = join15(packageRoot, "dist/headless-host/production-host.js");
+  const source = join15(packageRoot, "src/headless-host/production-host.ts");
+  const target = existsSync6(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
+var load_production_external_host_exports = {};
+__export(load_production_external_host_exports, {
+  loadProductionExternalHostFactory: () => loadProductionExternalHostFactory
+});
+async function loadProductionExternalHostFactory(packageRoot, host) {
+  const family = lookupHostFamily(host);
+  if (family === "acp") {
+    return loadProductionAcpHostFactory(packageRoot, host);
+  }
+  if (family === "headless") {
+    return loadProductionHeadlessHostFactory(packageRoot, 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/public-cli/host-providers.ts
 var host_providers_exports = {};
 __export(host_providers_exports, {
@@ -8870,15 +8952,15 @@ __export(host_providers_exports, {
   renderHostProvidersTable: () => renderHostProvidersTable
 });
 import { readFileSync as readFileSync2 } from "node:fs";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 function hostProvidersPath(home) {
   if (typeof home !== "string" || home.trim() === "") {
     throw new Error("home must be explicitly provided");
   }
-  return join15(home, ".ak-roles", "host-providers.json");
+  return join16(home, ".ak-roles", "host-providers.json");
 }
 function hermesProviderModelsCachePath(home) {
-  return join15(home, ".hermes", "provider_models_cache.json");
+  return join16(home, ".hermes", "provider_models_cache.json");
 }
 function parseHostProvidersTable(value) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
@@ -9445,7 +9527,7 @@ __export(config_exports, {
   validatePublicCliConfigAxes: () => validatePublicCliConfigAxes
 });
 import { mkdir as mkdir2, readFile as readFile10, writeFile as writeFile5 } from "node:fs/promises";
-import { dirname as dirname8, join as join16 } from "node:path";
+import { dirname as dirname8, join as join17 } from "node:path";
 function isGateOfficerSeat(value) {
   return GATE_OFFICER_SEATS.includes(value);
 }
@@ -9453,7 +9535,7 @@ function publicCliConfigPath(home) {
   if (typeof home !== "string" || home.trim() === "") {
     throw new Error("home must be explicitly provided");
   }
-  return join16(home, ".ak-roles", "public-cli.json");
+  return join17(home, ".ak-roles", "public-cli.json");
 }
 async function loadPublicCliConfig(home) {
   const path = publicCliConfigPath(home);
@@ -9862,7 +9944,7 @@ function credentialProvidersFromAuthData(data) {
 }
 async function loadCredentialProviders(agentDir) {
   try {
-    const raw = await readFile10(join16(agentDir, "auth.json"), "utf8");
+    const raw = await readFile10(join17(agentDir, "auth.json"), "utf8");
     return credentialProvidersFromAuthData(JSON.parse(raw));
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -10004,7 +10086,7 @@ var init_ticket_provenance_contracts = __esm({
 // src/ticket-provenance.ts
 import { createHash as createHash5 } from "node:crypto";
 import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "node:fs";
-import { join as join17 } from "node:path";
+import { join as join18 } 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)}`);
@@ -10062,7 +10144,7 @@ function resolveTicketProvenanceVolume(ticketNumber, cwd, home) {
   return {
     recordFile: path.recordFile,
     volumeDir: path.sessionDir,
-    humanViewFile: join17(path.sessionDir, TICKET_PROVENANCE_HUMAN_VIEW)
+    humanViewFile: join18(path.sessionDir, TICKET_PROVENANCE_HUMAN_VIEW)
   };
 }
 async function readTicketProvenance(ticketNumber, cwd, home) {
@@ -10206,7 +10288,7 @@ var init_case_dossier_delivery = __esm({
 
 // src/host-transition-prior-native.ts
 import { access as access2, readdir as readdir3 } from "node:fs/promises";
-import { dirname as dirname9, join as join18 } from "node:path";
+import { dirname as dirname9, join as join19 } from "node:path";
 function isEnoent2(error) {
   return typeof error === "object" && error !== null && error.code === "ENOENT";
 }
@@ -10231,7 +10313,7 @@ async function listSitianRecordPaths(sessionParent) {
   const recordPaths = [];
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const recordFile = join18(sessionRoot, entry.name, "records.jsonl");
+    const recordFile = join19(sessionRoot, entry.name, "records.jsonl");
     try {
       await access2(recordFile);
       recordPaths.push(recordFile);
@@ -10298,7 +10380,7 @@ var init_public_run_credentials = __esm({
 });
 
 // src/run-terminal-artifacts.ts
-import { basename as basename6, dirname as dirname10, join as join19 } from "node:path";
+import { basename as basename6, dirname as dirname10, join as join20 } from "node:path";
 function runIdFromRunDirectory(runDirectory) {
   const name = basename6(runDirectory);
   const at = name.lastIndexOf("@");
@@ -10702,7 +10784,7 @@ var init_ledger_session_read = __esm({
 
 // src/analyst-gate-cycles-read.ts
 import { readdir as readdir4 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { join as join21 } from "node:path";
 function isRecord13(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -10929,10 +11011,10 @@ function pairGateRounds(volumes) {
   return rounds.sort((a, b) => a.officerStartedAt.localeCompare(b.officerStartedAt)).map((round, index) => ({ ...round, roundIndex: index + 1 }));
 }
 async function resolveOfficerSessionFromPointerFile(pointerPath) {
-  const { readFile: readFile21 } = await import("node:fs/promises");
+  const { readFile: readFile22 } = await import("node:fs/promises");
   let raw;
   try {
-    raw = JSON.parse(await readFile21(pointerPath, "utf8"));
+    raw = JSON.parse(await readFile22(pointerPath, "utf8"));
   } catch (error) {
     throw new Error(
       `direct officer run pointer unreadable in ${pointerPath}: ${error instanceof Error ? error.message : String(error)}`,
@@ -10964,7 +11046,7 @@ async function readAnalystGateCyclesFromAuditorRoles(auditorRolesDirectory, opti
       throw error;
     }
     for (const name of names) {
-      const path = join20(directory, name);
+      const path = join21(directory, name);
       const fromPointer = name.endsWith(".pointer.json");
       const sessionPath = fromPointer ? await resolveOfficerSessionFromPointerFile(path) : path;
       if (sessionPath === void 0) continue;
@@ -11006,14 +11088,14 @@ var init_analyst_gate_cycles_read = __esm({
 });
 
 // src/session-opening-materials.ts
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync7 } from "node:fs";
 import { readFile as readFile12 } from "node:fs/promises";
-import { dirname as dirname11, join as join21 } from "node:path";
-import { fileURLToPath, pathToFileURL as pathToFileURL2 } from "node:url";
+import { dirname as dirname11, join as join22 } from "node:path";
+import { fileURLToPath, pathToFileURL as pathToFileURL3 } from "node:url";
 function resolvePackageRootDir(moduleUrl = import.meta.url) {
   let dir = dirname11(fileURLToPath(moduleUrl));
   for (let i = 0; i < 8; i += 1) {
-    if (existsSync6(join21(dir, "package.json")) && existsSync6(join21(dir, "souls"))) {
+    if (existsSync7(join22(dir, "package.json")) && existsSync7(join22(dir, "souls"))) {
       return dir;
     }
     const parent = dirname11(dir);
@@ -11043,7 +11125,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])
@@ -11885,12 +11967,12 @@ var init_reviewer_dispatch = __esm({
 // src/public-cli/reviewer-dispatch-rejection.ts
 import { writeFileSync as writeFileSync4 } from "node:fs";
 import { readFile as readFile13, unlink as unlink3 } from "node:fs/promises";
-import { join as join22 } from "node:path";
+import { join as join23 } from "node:path";
 function isReviewerPreflightViolation(value) {
   return typeof value === "string" && REVIEWER_PREFLIGHT_VIOLATIONS.includes(value);
 }
 function reviewerDispatchRejectionPath(runDirectory) {
-  return join22(runDirectory, REVIEWER_DISPATCH_REJECTION_FILE);
+  return join23(runDirectory, REVIEWER_DISPATCH_REJECTION_FILE);
 }
 function recordReviewerDispatchRejectionSync(runDirectory, rejection) {
   writeFileSync4(
@@ -12422,76 +12504,7 @@ var init_collector_identity = __esm({
   }
 });
 
-// src/collector-tool-schemas.ts
-import { Type as Type13 } from "typebox";
-var collectorObserveArgsSchema, collectorRequestArgsSchema, collectorReadArgsSchema, collectorWaitArgsSchema, collectorBindTargetArgsSchema, collectorFindingItemDeclaration, collectorOutputBaseSchema, collectorOutputArgsSchema;
-var init_collector_tool_schemas = __esm({
-  "src/collector-tool-schemas.ts"() {
-    "use strict";
-    init_collector_evidence();
-    init_open_tool_schema();
-    init_terminating_infrastructure();
-    collectorObserveArgsSchema = Type13.Object({}, { additionalProperties: false });
-    collectorRequestArgsSchema = Type13.Object({
-      requestId: Type13.String({ minLength: 1, description: "\u914D\u7F6E\u8BF7\u6C42\u8EAB\u4EFD" }),
-      snapshotId: Type13.String({ minLength: 1, description: "\u6700\u65B0\u7559\u5B58\u89C2\u5BDF\u5FEB\u7167" })
-    }, { additionalProperties: false });
-    collectorReadArgsSchema = Type13.Object({
-      evidenceId: Type13.String({ minLength: 1, description: "observe \u8FD4\u56DE\u7684\u6750\u6599\u8BC1\u636E id\uFF08evidenceId\uFF09" })
-    }, { additionalProperties: false });
-    collectorWaitArgsSchema = Type13.Object({
-      durationMs: Type13.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 });
-    collectorBindTargetArgsSchema = Type13.Object({
-      prNumber: Type13.Optional(Type13.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: Type13.Optional(Type13.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 });
-    collectorFindingItemDeclaration = (() => {
-      const item = Type13.Object(
-        {
-          evidenceId: Type13.Unknown({
-            description: "observe \u8FD4\u56DE\u7684\u6750\u6599\u6307\u9488\uFF08\u5FC5\u586B\u8BED\u4E49\uFF09"
-          }),
-          category: Type13.Unknown({
-            description: "\u7B80\u77ED\u5F52\u7C7B\u6807\u7B7E\uFF0C\u4E0D\u662F\u6458\u8981"
-          }),
-          summary: Type13.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(
-      Type13.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: Type13.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: Type13.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
-    );
-  }
-});
-
 // src/collector-ledger.ts
-import Value2 from "typebox/value";
 function utf8SafePrefix(text, maxBytes) {
   if (Buffer.byteLength(text, "utf8") <= maxBytes) return text;
   const bytes = Buffer.from(text, "utf8");
@@ -12564,9 +12577,7 @@ function createCollectorLedger(config, options) {
   const prIdentity = (pr) => `${pr.state}|${pr.headOid}|${pr.updatedAt ?? ""}`;
   const requireBoundPr = () => {
     if (config.prNumber === void 0) {
-      throw new Error(
-        "Collector PR target is unbound; call ak_collector_bind_target with the role-decided issue/PR or pass --pr"
-      );
+      throw new Error("\u901A\u8FDB\u53F8 PR \u76EE\u6807\u672A\u7ED1\u5B9A");
     }
     return config.prNumber;
   };
@@ -12848,11 +12859,11 @@ function createCollectorLedger(config, options) {
         throw new Error("\u901A\u8FDB\u53F8\u5DF2\u4EA7\u51FA\u8F93\u51FA\u5019\u9009\uFF0C\u672C\u5C40\u4E0D\u518D\u53D7\u7406\u76EE\u6807\u7ED1\u5B9A");
       }
       if (!Number.isSafeInteger(prNumber) || prNumber < 1) {
-        throw new Error("Collector bind target requires a positive safe-integer PR number");
+        throw new Error("\u901A\u8FDB\u53F8\u7ED1\u5B9A\u76EE\u6807\u8981\u6C42\u6B63\u5B89\u5168\u6574\u6570 PR \u53F7");
       }
       if (config.prNumber !== void 0 && config.prNumber !== prNumber) {
         throw new Error(
-          `Collector target already bound to PR ${config.prNumber}; cannot rebind to ${prNumber}`
+          `\u901A\u8FDB\u53F8\u76EE\u6807\u5DF2\u7ED1\u5B9A PR ${config.prNumber}\uFF0C\u4E0D\u53EF\u6539\u7ED1\u4E3A ${prNumber}`
         );
       }
       config.prNumber = prNumber;
@@ -13049,9 +13060,21 @@ function createCollectorLedger(config, options) {
       if (ledger.unresolvedTransportFailure) {
         throw latchFatal("\u901A\u8FDB\u53F8\u8BF7\u6C42\u65F6\u5B58\u5728\u672A\u6062\u590D\u7684\u4F20\u8F93\u5931\u8D25");
       }
-      const request = config.manifest.requests.find((item) => item.id === input.requestId);
-      if (request === void 0) {
-        throw new Error(`\u672A\u77E5\u901A\u8FDB\u53F8 requestId "${input.requestId}"`);
+      if (typeof input.requestId !== "string") {
+        throw new Error("\u901A\u8FDB\u53F8 requestId \u987B\u4E3A\u5B57\u7B26\u4E32");
+      }
+      const requestId = input.requestId.trim();
+      if (requestId.length === 0) {
+        throw new Error("\u901A\u8FDB\u53F8 requestId \u987B\u4E3A\u975E\u7A7A\uFF08\u9996\u5C3E\u7A7A\u767D\u4E0D\u6784\u6210\u8EAB\u4EFD\uFF09");
+      }
+      const configured = config.manifest.requests.find((item) => item.id === requestId);
+      const roleBody = typeof input.body === "string" ? input.body : void 0;
+      if (configured === void 0) {
+        if (roleBody === void 0 || roleBody.trim().length === 0) {
+          throw new Error(
+            `\u672A\u77E5\u901A\u8FDB\u53F8 requestId "${requestId}" \u4E14\u672A\u63D0\u4F9B body\uFF1B\u8BF7\u63D0\u4EA4\u89D2\u8272\u5224\u5B9A\u7684\u8BF7\u6C42\u6B63\u6587\u6216\u4F7F\u7528 request-manifest`
+          );
+        }
       }
       const snapshot = snapshots.find((item) => item.snapshotId === input.snapshotId);
       if (snapshot === void 0) {
@@ -13067,10 +13090,11 @@ function createCollectorLedger(config, options) {
         finalObservationRequired = true;
         throw latchFatal("\u901A\u8FDB\u53F8\u8BF7\u6C42\u4E0D\u5728\u8D44\u683C\u622A\u6B62\u524D");
       }
+      const configuredBody = configured?.requestBody ?? roleBody;
       const { body, marker } = buildCollectorRequestBody({
-        configuredBody: request.requestBody,
+        configuredBody,
         manifestDigest: config.manifest.digest,
-        requestId: request.id,
+        requestId,
         headOid: snapshot.headOid
       });
       const existingMarker = snapshot.evidenceIds.some((id) => {
@@ -13079,7 +13103,7 @@ function createCollectorLedger(config, options) {
       });
       if (existingMarker) {
         throw new Error(
-          `\u901A\u8FDB\u53F8\u5728\u6B64 HEAD \u5DF2\u6709\u540C marker \u7684\u5DF2\u8BA4\u8BC1\u8BF7\u6C42 "${input.requestId}"`
+          `\u901A\u8FDB\u53F8\u5728\u6B64 HEAD \u5DF2\u6709\u540C marker \u7684\u5DF2\u8BA4\u8BC1\u8BF7\u6C42 "${requestId}"`
         );
       }
       const boundPr = requireBoundPr();
@@ -13087,18 +13111,18 @@ function createCollectorLedger(config, options) {
         config.repository.canonical,
         String(boundPr),
         snapshot.headOid,
-        request.id
+        requestId
       ].join("|");
       if (attemptKeys.has(attemptKey)) {
         throw new Error(
-          `\u901A\u8FDB\u53F8\u8FDB\u7A0B\u5185\u8BF7\u6C42 "${request.id}" \u5728 HEAD ${snapshot.headOid} \u7684 attempt \u5DF2\u7528`
+          `\u901A\u8FDB\u53F8\u8FDB\u7A0B\u5185\u8BF7\u6C42 "${requestId}" \u5728 HEAD ${snapshot.headOid} \u7684 attempt \u5DF2\u7528`
         );
       }
       const startedAt = clock2.wallNow().toISOString();
       const attemptId = sha256Text(`${attemptKey}:${startedAt}`).slice(0, 16);
       const attempt = {
         attemptId,
-        requestId: request.id,
+        requestId,
         observedHead: snapshot.headOid,
         snapshotId: snapshot.snapshotId,
         marker,
@@ -13140,7 +13164,7 @@ function createCollectorLedger(config, options) {
         return {
           status: "succeeded",
           attemptId,
-          requestId: request.id,
+          requestId,
           observedHead: snapshot.headOid,
           marker,
           commentEvidenceId: record4.evidenceId
@@ -13154,7 +13178,7 @@ function createCollectorLedger(config, options) {
         return {
           status: "ambiguous_loss",
           attemptId,
-          requestId: request.id,
+          requestId,
           observedHead: snapshot.headOid,
           marker,
           diagnostics: result.diagnostics
@@ -13171,14 +13195,6 @@ function createCollectorLedger(config, options) {
       if (activationTime === void 0) {
         throw latchFatal("\u901A\u8FDB\u53F8\u7B49\u5F85\u9700\u8981\u6FC0\u6D3B");
       }
-      if (!Number.isSafeInteger(input.durationMs) || input.durationMs < 1) {
-        throw new Error("\u901A\u8FDB\u53F8\u7B49\u5F85 durationMs \u987B\u4E3A\u6B63\u5B89\u5168\u6574\u6570");
-      }
-      if (input.durationMs > COLLECTOR_ELIGIBILITY_MS) {
-        throw new Error(
-          `\u901A\u8FDB\u53F8\u7B49\u5F85 durationMs \u81F3\u591A\u4E3A ${COLLECTOR_ELIGIBILITY_MS}`
-        );
-      }
       if (pastCutoff(clock2)) {
         finalObservationRequired = true;
         throw latchFatal("\u901A\u8FDB\u53F8\u7B49\u5F85\u4E0D\u5728\u8D44\u683C\u622A\u6B62\u524D");
@@ -13280,26 +13296,27 @@ function buildObserveModelView(input) {
     }))
   };
 }
-var COLLECTOR_OBSERVE_TOOL, COLLECTOR_READ_TOOL, COLLECTOR_REQUEST_TOOL, COLLECTOR_WAIT_TOOL, COLLECTOR_BIND_TARGET_TOOL, COLLECTOR_OPERATIONAL_TOOLS, COLLECTOR_OBSERVE_BODY_HEAD_BYTES, COLLECTOR_ACTIVATION_ENTRY_TYPE, COLLECTOR_SNAPSHOT_ENTRY_TYPE, COLLECTOR_REQUEST_ENTRY_TYPE, COLLECTOR_WAIT_ENTRY_TYPE;
+var COLLECTOR_OBSERVE_TOOL, COLLECTOR_READ_TOOL, COLLECTOR_REQUEST_TOOL, COLLECTOR_WAIT_TOOL, COLLECTOR_BIND_TARGET_TOOL, COLLECTOR_HANDBOOK_WRITE_TOOL, COLLECTOR_OPERATIONAL_TOOLS, COLLECTOR_OBSERVE_BODY_HEAD_BYTES, COLLECTOR_ACTIVATION_ENTRY_TYPE, COLLECTOR_SNAPSHOT_ENTRY_TYPE, COLLECTOR_REQUEST_ENTRY_TYPE, COLLECTOR_WAIT_ENTRY_TYPE;
 var init_collector_ledger = __esm({
   "src/collector-ledger.ts"() {
     "use strict";
     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";
+    COLLECTOR_HANDBOOK_WRITE_TOOL = "ak_collector_handbook_write";
     COLLECTOR_OPERATIONAL_TOOLS = [
       COLLECTOR_BIND_TARGET_TOOL,
       COLLECTOR_OBSERVE_TOOL,
       COLLECTOR_READ_TOOL,
       COLLECTOR_REQUEST_TOOL,
-      COLLECTOR_WAIT_TOOL
+      COLLECTOR_WAIT_TOOL,
+      COLLECTOR_HANDBOOK_WRITE_TOOL
     ];
     COLLECTOR_OBSERVE_BODY_HEAD_BYTES = 512;
     COLLECTOR_ACTIVATION_ENTRY_TYPE = "ak-collector-activation";
@@ -13312,7 +13329,7 @@ var init_collector_ledger = __esm({
 // src/package-resources/method-skill.ts
 import { createHash as createHash7 } from "node:crypto";
 import { readFile as readFile14, realpath as realpath7 } from "node:fs/promises";
-import { join as join23 } from "node:path";
+import { join as join24 } 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");
@@ -13329,10 +13346,10 @@ function packagedMethodSkillRelativeDirectory(name) {
   return `${METHOD_SKILL_RELATIVE_ROOT}/${name}`;
 }
 function resolvePackagedMethodSkillRoot(packageRoot, name) {
-  return join23(packageRoot, packagedMethodSkillRelativeDirectory(name));
+  return join24(packageRoot, packagedMethodSkillRelativeDirectory(name));
 }
 function resolvePackagedMethodSkillPath(packageRoot, name) {
-  return join23(resolvePackagedMethodSkillRoot(packageRoot, name), "SKILL.md");
+  return join24(resolvePackagedMethodSkillRoot(packageRoot, name), "SKILL.md");
 }
 function isRecord14(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -13426,8 +13443,8 @@ function parseProvenance(raw, expectedName) {
 }
 async function loadPackagedMethodSkillMaterial(packageRoot, name) {
   const rootDirectory = resolvePackagedMethodSkillRoot(packageRoot, name);
-  const skillPathConfigured = join23(rootDirectory, "SKILL.md");
-  const provenancePath = join23(rootDirectory, "provenance.json");
+  const skillPathConfigured = join24(rootDirectory, "SKILL.md");
+  const provenancePath = join24(rootDirectory, "provenance.json");
   let provenanceRaw;
   try {
     provenanceRaw = await readFile14(provenancePath, "utf8");
@@ -13444,7 +13461,7 @@ async function loadPackagedMethodSkillMaterial(packageRoot, name) {
   }
   const provenance = parseProvenance(provenanceJson, name);
   for (const [rel, expected] of Object.entries(provenance.files)) {
-    const absolute = join23(rootDirectory, rel);
+    const absolute = join24(rootDirectory, rel);
     let bytes;
     try {
       bytes = await readFile14(absolute);
@@ -13960,7 +13977,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 writeFile6 } from "node:fs/promises";
-import { dirname as dirname12, join as join24 } from "node:path";
+import { dirname as dirname12, join as join25 } from "node:path";
 function sealedLedgerHome(admitted) {
   return homeFromRunDirectory(admitted.runDirectory);
 }
@@ -14375,7 +14392,7 @@ async function readSessionProviderStop(sessionFile) {
   }
 }
 async function readBoundEvidenceChildKnownFailure(sessionFile) {
-  const childDirectory = join24(dirname12(sessionFile), "evidence-children");
+  const childDirectory = join25(dirname12(sessionFile), "evidence-children");
   let names;
   try {
     names = await readdir5(childDirectory);
@@ -14386,7 +14403,7 @@ async function readBoundEvidenceChildKnownFailure(sessionFile) {
   for (const file of names.filter((name) => name.endsWith(".jsonl")).sort().reverse()) {
     let entries;
     try {
-      entries = await readBoundSessionEntries(join24(childDirectory, file));
+      entries = await readBoundSessionEntries(join25(childDirectory, file));
     } catch (error) {
       throw sessionReadFailure(error, "failed to read discovered evidence-child session");
     }
@@ -14440,7 +14457,7 @@ async function loadBoundAuditorVolumes(sessionFile) {
     latestParentUserIndex = i;
     break;
   }
-  const childDirectories = [join24(dirname12(sessionFile), "auditor-roles")];
+  const childDirectories = [join25(dirname12(sessionFile), "auditor-roles")];
   const valid = [];
   let sawAnyDirectory = false;
   for (const childDirectory of childDirectories) {
@@ -14455,7 +14472,7 @@ async function loadBoundAuditorVolumes(sessionFile) {
     for (const file of names.filter((name) => name.endsWith(".jsonl")).sort().reverse()) {
       let entries;
       try {
-        entries = await readBoundSessionEntries(join24(childDirectory, file));
+        entries = await readBoundSessionEntries(join25(childDirectory, file));
       } catch (error) {
         throw sessionReadFailure(error, "failed to read discovered auditor session");
       }
@@ -14971,8 +14988,8 @@ function projectTerminalGateFact(rounds) {
   };
 }
 async function extractGateFactFromSessionDirectory(sessionDirectory, options = {}) {
-  const directories = [join24(sessionDirectory, "auditor-roles")];
-  const parentSessionFile = options.parentSessionFile ?? join24(sessionDirectory, "session.jsonl");
+  const directories = [join25(sessionDirectory, "auditor-roles")];
+  const parentSessionFile = options.parentSessionFile ?? join25(sessionDirectory, "session.jsonl");
   const rounds = await readAnalystGateCyclesFromAuditorRoles(directories, {
     parentSessionFile
   });
@@ -15070,8 +15087,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 = join24(artifactsDir, "report.json");
-  const evidencePath = join24(artifactsDir, "evidence.json");
+  const reportPath = join25(artifactsDir, "report.json");
+  const evidencePath = join25(artifactsDir, "evidence.json");
   await writeFile6(
     reportPath,
     `${JSON.stringify(
@@ -15161,8 +15178,8 @@ async function trySettleJudgeTerminalResult(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 = join24(artifactsDir, "report.json");
-  const evidencePath = join24(artifactsDir, "evidence.json");
+  const reportPath = join25(artifactsDir, "report.json");
+  const evidencePath = join25(artifactsDir, "evidence.json");
   await writeFile6(
     reportPath,
     `${JSON.stringify(
@@ -15395,7 +15412,7 @@ function uniqueFailureFallbackDirs(runDirectory, baseDir) {
   return dirs;
 }
 async function resolveFailureArtifactsBase(runDirectory) {
-  const artifactsDir = join24(runDirectory, "artifacts");
+  const artifactsDir = join25(runDirectory, "artifacts");
   try {
     await ensureRunArtifactsDir(runDirectory);
     return { baseDir: artifactsDir };
@@ -15411,7 +15428,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) => join24(dir, `${stem}.${randomUUID3()}.json`))
+    ...uniqueFallbackDirs.map((dir) => join25(dir, `${stem}.${randomUUID3()}.json`))
   ];
   for (let i = 0; i < candidates.length; i += 1) {
     const path = candidates[i];
@@ -15456,26 +15473,26 @@ async function publishFailureArtifacts(admitted, failure2, authority) {
   } catch (error) {
     priorIssues.push(publicationAttemptFromError(sessionFile, error));
   }
-  const underArtifacts = baseDir === join24(admitted.runDirectory, "artifacts");
+  const underArtifacts = baseDir === join25(admitted.runDirectory, "artifacts");
   const uniqueFallbackDirs = uniqueFailureFallbackDirs(
     admitted.runDirectory,
     baseDir
   );
   const errorCandidates = underArtifacts ? [
-    join24(baseDir, "error.json"),
-    join24(baseDir, "error.settlement.json"),
-    join24(admitted.runDirectory, "error.settlement.json")
+    join25(baseDir, "error.json"),
+    join25(baseDir, "error.settlement.json"),
+    join25(admitted.runDirectory, "error.settlement.json")
   ] : [
-    join24(baseDir, "error.settlement.json"),
-    join24(baseDir, "error.json")
+    join25(baseDir, "error.settlement.json"),
+    join25(baseDir, "error.json")
   ];
   const evidenceCandidates = underArtifacts ? [
-    join24(baseDir, "evidence.json"),
-    join24(baseDir, "evidence.settlement.json"),
-    join24(admitted.runDirectory, "evidence.settlement.json")
+    join25(baseDir, "evidence.json"),
+    join25(baseDir, "evidence.settlement.json"),
+    join25(admitted.runDirectory, "evidence.settlement.json")
   ] : [
-    join24(baseDir, "evidence.settlement.json"),
-    join24(baseDir, "evidence.json")
+    join25(baseDir, "evidence.settlement.json"),
+    join25(baseDir, "evidence.json")
   ];
   const errorPayloadBase = {
     kind: "error",
@@ -15765,7 +15782,7 @@ var init_settlement = __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 join25 } from "node:path";
+import { join as join26 } from "node:path";
 function presentTerminal(terminal, io) {
   if (terminal.roleOutcome.kind === "failure" || terminal.roleOutcome.kind === "no_receipt") {
     presentFailureTerminal(terminal, io);
@@ -15784,7 +15801,7 @@ async function finalizeExceptionRunBestEffort(runDirectory, io) {
   }
 }
 function runArtifactsDirectory(runDirectory) {
-  return join25(runDirectory, "artifacts");
+  return join26(runDirectory, "artifacts");
 }
 async function ensureRealArtifactsDirectory(runDirectory) {
   const runStat = await lstat5(runDirectory);
@@ -15867,7 +15884,7 @@ function jsonSafeReplacer() {
 }
 async function retainDispatchError(admitted, principalAuthority, sessionAppender, attempt, error) {
   const artifactsDir = await ensureRealArtifactsDirectory(admitted.runDirectory);
-  const filePath = join25(
+  const filePath = join26(
     artifactsDir,
     `dispatch-error-attempt-${attempt}-${randomUUID4()}.json`
   );
@@ -16116,7 +16133,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 writeFile7 } from "node:fs/promises";
-import { isAbsolute as isAbsolute7, join as join26, resolve as resolve11 } from "node:path";
+import { isAbsolute as isAbsolute7, join as join27, resolve as resolve11 } from "node:path";
 function appendContinuationSection(continuation, section) {
   const prompt = `${continuation.prompt}
 
@@ -16125,7 +16142,7 @@ ${section}`;
 }
 async function readInvocationHost(runDirectory) {
   try {
-    const raw = JSON.parse(await readFile16(join26(runDirectory, "invocation.json"), "utf8"));
+    const raw = JSON.parse(await readFile16(join27(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;
@@ -16279,7 +16296,7 @@ async function dispatchPostAdmissionTurn(input) {
     }
     try {
       await writeFile7(
-        join26(admitted.runDirectory, "stderr.log"),
+        join27(admitted.runDirectory, "stderr.log"),
         result.stderr,
         "utf8"
       );
@@ -16388,7 +16405,7 @@ function resumeTurnRequestProjectionOptions(admitted, request, env, summonsPrepa
 }
 function isAlreadyFrozenSummonsAttachment(runDirectory, attachmentPath) {
   const absolute = isAbsolute7(attachmentPath) ? attachmentPath : resolve11(attachmentPath);
-  return pathContainedIn(join26(runDirectory, "attachments"), absolute);
+  return pathContainedIn(join27(runDirectory, "attachments"), absolute);
 }
 async function prepareSummonsResumeMaterials(runDirectory, summons) {
   if (summons === void 0) return void 0;
@@ -17573,8 +17590,8 @@ __export(public_role_summons_exports, {
   summonGateOfficer: () => summonGateOfficer,
   summonPublicRole: () => summonPublicRole
 });
-import { existsSync as existsSync7 } from "node:fs";
-import { join as join27 } from "node:path";
+import { existsSync as existsSync8 } from "node:fs";
+import { join as join28 } from "node:path";
 function createCapturingIo() {
   const chunks = [];
   return {
@@ -17597,7 +17614,7 @@ function parentDir(path) {
 function walkPackageRoot(start) {
   let dir = start;
   for (let i = 0; i < 12; i += 1) {
-    if (existsSync7(join27(dir, "package.json")) && existsSync7(join27(dir, "souls"))) {
+    if (existsSync8(join28(dir, "package.json")) && existsSync8(join28(dir, "souls"))) {
       return dir;
     }
     const parent = parentDir(dir);
@@ -17673,9 +17690,9 @@ async function createSummonEnv(options) {
   const hostName = options.seat.host ?? "pi";
   let roleTurnHost = piHost;
   if (hostName !== "pi") {
-    const { lookupHostDescription: lookupHostDescription2 } = await Promise.resolve().then(() => (init_host_descriptions(), host_descriptions_exports));
-    const { loadProductionAcpHostFactory: loadProductionAcpHostFactory2 } = await Promise.resolve().then(() => (init_load_production_acp_host(), load_production_acp_host_exports));
-    if (lookupHostDescription2(hostName) === void 0) {
+    const { lookupHostFamily: lookupHostFamily2 } = await Promise.resolve().then(() => (init_host_descriptions(), host_descriptions_exports));
+    const { loadProductionExternalHostFactory: loadProductionExternalHostFactory2 } = await Promise.resolve().then(() => (init_load_production_external_host(), load_production_external_host_exports));
+    if (lookupHostFamily2(hostName) === void 0) {
       throw new Error(
         `public role summons host unregistered: host=${hostName} seat=${options.role}`
       );
@@ -17683,7 +17700,7 @@ async function createSummonEnv(options) {
     let hostPromise;
     roleTurnHost = {
       executeTurn: async (request) => {
-        hostPromise ??= loadProductionAcpHostFactory2(options.packageRoot, hostName).then(
+        hostPromise ??= loadProductionExternalHostFactory2(options.packageRoot, hostName).then(
           (create) => create({
             packageRoot: options.packageRoot,
             principalAuthority
@@ -17717,7 +17734,7 @@ async function createSummonEnv(options) {
 async function summonPublicRole(options) {
   const packageRoot = resolveSummonsPackageRoot(options.packageRoot);
   const home = await resolveSummonHome(options);
-  const agentDir = options.agentDir ?? process.env.PI_CODING_AGENT_DIR ?? join27(home, ".pi", "agent");
+  const agentDir = options.agentDir ?? process.env.PI_CODING_AGENT_DIR ?? join28(home, ".pi", "agent");
   const {
     loadCredentialProviders: loadCredentialProviders2,
     loadPublicCliConfig: loadPublicCliConfig2,
@@ -17725,7 +17742,8 @@ async function summonPublicRole(options) {
   } = await Promise.resolve().then(() => (init_config(), config_exports));
   const credentials = options.credentials ?? await loadCredentialProviders2(agentDir);
   const config = await loadPublicCliConfig2(home);
-  const seat = resolveEffectiveSeat2(config, options.role, credentials);
+  const invocation = options.host === void 0 ? void 0 : { host: options.host };
+  const seat = resolveEffectiveSeat2(config, options.role, credentials, invocation);
   const env = {
     ...await createSummonEnv({
       role: options.role,
@@ -17837,6 +17855,38 @@ async function summonPublicRole(options) {
     ...stderr === void 0 || stderr === "" ? {} : { stderr }
   };
 }
+async function parentInvocationHost(sourceRunDirectory) {
+  const { readFile: readFile22 } = await import("node:fs/promises");
+  const path = join28(sourceRunDirectory, "invocation.json");
+  let text;
+  try {
+    text = await readFile22(path, "utf8");
+  } catch (error) {
+    const code = error instanceof Error && "code" in error ? error.code : void 0;
+    throw new Error(
+      `parent invocation.json required for gate source run at ${path}: ${code ?? (error instanceof Error ? error.message : String(error))}`,
+      { cause: error }
+    );
+  }
+  let raw;
+  try {
+    raw = JSON.parse(text);
+  } catch (error) {
+    throw new Error(
+      `parent invocation.json unreadable at ${path}: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
+    );
+  }
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    throw new Error(`parent invocation.json has non-object shape at ${path}`);
+  }
+  const host = raw.host;
+  if (host === void 0) return void 0;
+  if (typeof host !== "string" || host.trim() === "") {
+    throw new Error(`parent invocation.json host must be a non-empty string at ${path}`);
+  }
+  return host;
+}
 async function summonGateOfficer(options) {
   let home = options.home;
   if (home === void 0) {
@@ -17850,6 +17900,7 @@ async function summonGateOfficer(options) {
       submission: options.submission
     });
   }
+  const parentHost = await parentInvocationHost(options.sourceRunDirectory);
   const common = {
     cwd: options.cwd,
     ...home === void 0 ? {} : { home },
@@ -17858,6 +17909,7 @@ async function summonGateOfficer(options) {
     ...options.signal === void 0 ? {} : { signal: options.signal },
     ...options.reask === void 0 ? {} : { reviewReask: options.reask },
     ...gateReviewInstruction === void 0 ? {} : { gateReviewInstruction },
+    ...parentHost === void 0 ? {} : { host: parentHost },
     ...options.roleTurnHost === void 0 ? {} : { roleTurnHost: options.roleTurnHost },
     ...options.createRunId === void 0 ? {} : { createRunId: options.createRunId }
   };
@@ -17909,7 +17961,7 @@ __export(compliance_transport_exports, {
   runComplianceAudit: () => runComplianceAudit,
   tryReadComplianceCandidate: () => tryReadComplianceCandidate
 });
-import { Type as Type14 } from "typebox";
+import { Type as Type13 } from "typebox";
 function readListField(value) {
   return Array.isArray(value) ? value : value === void 0 ? [] : [value];
 }
@@ -18007,9 +18059,9 @@ var init_compliance_transport = __esm({
     "use strict";
     init_auditor_dossier_tool();
     AUDITOR_DOSSIER_PROMPT = "\u672C run \u5377\u5B97\u5DF2\u5C31\u7EEA\u3002";
-    nonblank2 = Type14.String({ minLength: 1, pattern: "\\S" });
-    decisionGateSchema = Type14.Object({ question: nonblank2, options: Type14.Array(nonblank2, { minItems: 1 }) }, { additionalProperties: false });
-    complianceDecisionSchema = Type14.Object({ status: Type14.Unknown({ description: "pass | bounce | escalate \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8" }), violations: Type14.Array(nonblank2, { description: "\u89C2\u5BDF\u5230\u7684\u5408\u89C4\u8FDD\u89C4" }), conflicts: Type14.Array(nonblank2, { description: "\u672A\u51B3\u6743\u5A01\u6216\u6267\u884C\u51B2\u7A81" }), decisionGate: Type14.Union([decisionGateSchema, Type14.Null()], { description: "\u5347\u7EA7\u95EE\u9898\u4E0E\u53EF\u9009\u9009\u9879" }) }, { additionalProperties: true, required: [] });
+    nonblank2 = Type13.String({ minLength: 1, pattern: "\\S" });
+    decisionGateSchema = Type13.Object({ question: nonblank2, options: Type13.Array(nonblank2, { minItems: 1 }) }, { additionalProperties: false });
+    complianceDecisionSchema = Type13.Object({ status: Type13.Unknown({ description: "pass | bounce | escalate \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8" }), violations: Type13.Array(nonblank2, { description: "\u89C2\u5BDF\u5230\u7684\u5408\u89C4\u8FDD\u89C4" }), conflicts: Type13.Array(nonblank2, { description: "\u672A\u51B3\u6743\u5A01\u6216\u6267\u884C\u51B2\u7A81" }), decisionGate: Type13.Union([decisionGateSchema, Type13.Null()], { description: "\u5347\u7EA7\u95EE\u9898\u4E0E\u53EF\u9009\u9009\u9879" }) }, { additionalProperties: true, required: [] });
     COMPLIANCE_RESPONSE_ENTRY_TYPE = "ak_compliance_response";
     AUDITOR_PARENT_ATTEMPT_BINDING_ENTRY_TYPE = "ak_auditor_parent_attempt_binding";
     AUDITOR_COMPLIANCE_FAILURE_ENTRY_TYPE = "ak_auditor_compliance_failure";
@@ -18023,7 +18075,7 @@ var init_compliance_transport = __esm({
 });
 
 // src/dossier-resolution.ts
-import { existsSync as existsSync8, statSync as statSync2 } from "node:fs";
+import { existsSync as existsSync9, statSync as statSync2 } from "node:fs";
 import { resolve as resolve12 } from "node:path";
 function resolveAuditDossier(env = process.env) {
   const raw = env[AUDIT_RUN_DIR_ENV];
@@ -18032,7 +18084,7 @@ function resolveAuditDossier(env = process.env) {
   }
   const runDirectory = resolve12(raw);
   try {
-    if (!existsSync8(runDirectory) || !statSync2(runDirectory).isDirectory()) {
+    if (!existsSync9(runDirectory) || !statSync2(runDirectory).isDirectory()) {
       return { status: "incomplete", observation: { kind: "missing-dossier" } };
     }
   } catch {
@@ -18103,8 +18155,8 @@ var init_doctor_auditor = __esm({
 });
 
 // src/navigator-session-contracts.ts
-import { Type as Type15 } from "typebox";
-import { Value as Value3 } from "typebox/value";
+import { Type as Type14 } from "typebox";
+import { Value as Value2 } from "typebox/value";
 function navigatorUnavailableKey(value) {
   return typeof value === "string" && NAVIGATOR_UNAVAILABLE_KEYS.has(value) ? value : void 0;
 }
@@ -18255,26 +18307,26 @@ var init_navigator_session_contracts = __esm({
         this.originalCause = originalCause;
       }
     };
-    navigatorProviderFailureSchema = Type15.Object({
-      source: Type15.Union([
-        Type15.Literal("context"),
-        Type15.Literal("session"),
-        Type15.Literal("model"),
-        Type15.Literal("thinking"),
-        Type15.Literal("auth"),
-        Type15.Literal("quota"),
-        Type15.Literal("transport"),
-        Type15.Literal("unknown")
+    navigatorProviderFailureSchema = Type14.Object({
+      source: Type14.Union([
+        Type14.Literal("context"),
+        Type14.Literal("session"),
+        Type14.Literal("model"),
+        Type14.Literal("thinking"),
+        Type14.Literal("auth"),
+        Type14.Literal("quota"),
+        Type14.Literal("transport"),
+        Type14.Literal("unknown")
       ]),
-      cause: Type15.Union([
-        Type15.Literal("context"),
-        Type15.Literal("session"),
-        Type15.Literal("model"),
-        Type15.Literal("thinking"),
-        Type15.Literal("auth"),
-        Type15.Literal("quota"),
-        Type15.Literal("transport"),
-        Type15.Literal("unknown")
+      cause: Type14.Union([
+        Type14.Literal("context"),
+        Type14.Literal("session"),
+        Type14.Literal("model"),
+        Type14.Literal("thinking"),
+        Type14.Literal("auth"),
+        Type14.Literal("quota"),
+        Type14.Literal("transport"),
+        Type14.Literal("unknown")
       ])
     }, { additionalProperties: false });
   }
@@ -18282,11 +18334,11 @@ var init_navigator_session_contracts = __esm({
 
 // src/archivist-record-topology.ts
 import { createHash as createHash8 } from "node:crypto";
-import { join as join28 } from "node:path";
+import { join as join29 } from "node:path";
 function subjectKeyedRecordDirectory(input) {
   const ledgerHome = input.parentSessionFile !== void 0 && input.parentSessionFile.length > 0 ? resolveActivationLedgerHomeForPath(input.parentSessionFile) : resolveActivationLedgerHome(input.home);
   const digest = createHash8("sha256").update(input.subject).digest("hex").slice(0, 32);
-  return join28(
+  return join29(
     activationBookDirectory(ledgerHome, resolveBookKeyFromGit(input.cwd)),
     input.kind,
     digest
@@ -18310,11 +18362,11 @@ __export(archivist_record_entry_exports, {
   createRecordSessionOpen: () => createRecordSessionOpen,
   subjectKeyedRecordDirectory: () => subjectKeyedRecordDirectory
 });
-import { existsSync as existsSync9, mkdirSync as mkdirSync4, readFileSync as readFileSync3, realpathSync as realpathSync2, writeFileSync as writeFileSync5 } from "node:fs";
-import { dirname as dirname13, resolve as resolve13, join as join29 } from "node:path";
+import { existsSync as existsSync10, mkdirSync as mkdirSync4, readFileSync as readFileSync3, realpathSync as realpathSync2, writeFileSync as writeFileSync5 } from "node:fs";
+import { dirname as dirname13, resolve as resolve13, join as join30 } from "node:path";
 import { SessionManager } from "@earendil-works/pi-coding-agent";
 function readCurrentSession(sessionDir) {
-  const ledger = join29(sessionDir, CURRENT_SESSION_LEDGER);
+  const ledger = join30(sessionDir, CURRENT_SESSION_LEDGER);
   try {
     const value = JSON.parse(readFileSync3(ledger, "utf8"));
     if (typeof value !== "object" || value === null || typeof value.sessionFile !== "string" || value.sessionFile.length === 0) {
@@ -18329,7 +18381,7 @@ function readCurrentSession(sessionDir) {
   }
 }
 function writeCurrentSession(sessionDir, sessionFile) {
-  const ledger = join29(sessionDir, CURRENT_SESSION_LEDGER);
+  const ledger = join30(sessionDir, CURRENT_SESSION_LEDGER);
   try {
     writeFileSync5(ledger, `${JSON.stringify({ sessionFile })}
 `, { flag: "wx" });
@@ -18390,10 +18442,10 @@ function createRecordSessionOpen(options) {
     return { session: SessionManager.inMemory(cwd), resumed: false };
   } else {
     const parentResolved = resolve13(parentFile);
-    sessionDir = physicallyContainedIn(ledgerHome, parentResolved) ? join29(dirname13(parentResolved), options.kind) : join29(activationBookDirectory(ledgerHome, resolveBookKeyFromGit(cwd)), options.kind);
+    sessionDir = physicallyContainedIn(ledgerHome, parentResolved) ? join30(dirname13(parentResolved), options.kind) : join30(activationBookDirectory(ledgerHome, resolveBookKeyFromGit(cwd)), options.kind);
     parentSession = parentFile;
   }
-  const nestAlreadyExists = existsSync9(sessionDir);
+  const nestAlreadyExists = existsSync10(sessionDir);
   ensureRealDirectoryTree(ledgerHome, sessionDir);
   const mayResumeSameNest = options.subject !== void 0 || options.kind === WORKER_SUBMISSION_GATE_KIND;
   if (mayResumeSameNest && nestAlreadyExists) {
@@ -18411,7 +18463,7 @@ function createRecordSessionOpen(options) {
   );
   if (session.isPersisted()) {
     const file = session.getSessionFile();
-    if (file !== void 0 && !existsSync9(file)) {
+    if (file !== void 0 && !existsSync10(file)) {
       const header = session.getHeader();
       if (header !== null && header.type === "session") {
         writeFileSync5(file, `${JSON.stringify(header)}
@@ -18429,7 +18481,7 @@ function createRecordSession(options) {
   return createRecordSessionOpen(options).session;
 }
 function bookDirectOfficerRunPointer(options) {
-  const nest = join29(dirname13(options.parentSessionFile), "auditor-roles");
+  const nest = join30(dirname13(options.parentSessionFile), "auditor-roles");
   mkdirSync4(nest, { recursive: true });
   const pointer = {
     version: 1,
@@ -18439,7 +18491,7 @@ function bookDirectOfficerRunPointer(options) {
     ...options.runDirectory !== void 0 && options.runDirectory.trim() !== "" ? { runDirectory: options.runDirectory } : {}
   };
   writeFileSync5(
-    join29(nest, `${options.officer}.pointer.json`),
+    join30(nest, `${options.officer}.pointer.json`),
     `${JSON.stringify(pointer)}
 `,
     "utf8"
@@ -18626,7 +18678,7 @@ var init_navigator_public_session = __esm({
 import { createHash as createHash9 } from "node:crypto";
 import { resolve as resolve14 } from "node:path";
 import "@earendil-works/pi-coding-agent";
-import { Type as Type16 } from "typebox";
+import { Type as Type15 } from "typebox";
 function resolveNavigatorAuthorityMaterial(roleInput, fileAuthority) {
   if (roleInput !== void 0 && roleInput.trim() !== "") return roleInput;
   if (fileAuthority !== void 0 && fileAuthority.trim() !== "") return fileAuthority;
@@ -19289,8 +19341,8 @@ var init_navigator_attendance = __esm({
     NAVIGATOR_EVENT_TYPE = "ak-navigator-attendance";
     NAVIGATOR_PREPARE_ACCEPTED_TEXT = "\u6E38\u5955\u4F7F\u51C6\u5907\u5DF2\u63A5\u53D7";
     NAVIGATOR_TARGETS = PACKAGED_ROLE_REGISTRY.map(({ role, phases }) => ({ role, phases }));
-    prepareSchema = Type16.Object({
-      candidates: Type16.Optional(Type16.Unknown({
+    prepareSchema = Type15.Object({
+      candidates: Type15.Optional(Type15.Unknown({
         description: "\u65B9\u5411\u5019\u9009\uFF1Bcandidates[].next.role \u5FC5\u586B\uFF0Cphase \u53EF\u9009\uFF0Croute/matches/reason/command \u53EF\u9009\u4E0A\u4E0B\u6587\uFF0C\u975E\u53D7\u7406\u95F8"
       }))
     }, { additionalProperties: true });
@@ -19303,7 +19355,7 @@ var init_navigator_attendance = __esm({
 });
 
 // src/engine-detour-tool.ts
-import { Type as Type17 } from "typebox";
+import { Type as Type16 } from "typebox";
 function isCallerCancellation(error, signal) {
   if (signal?.aborted === true) return true;
   if (typeof error === "object" && error !== null && error.name === "AbortError") {
@@ -19378,9 +19430,9 @@ var init_engine_detour_tool = __esm({
   "src/engine-detour-tool.ts"() {
     "use strict";
     init_engine_detour();
-    engineDetourArgsSchema = Type17.Object(
+    engineDetourArgsSchema = Type16.Object(
       {
-        argv: Type17.Array(Type17.String({ minLength: 1 }), {
+        argv: Type16.Array(Type16.String({ minLength: 1 }), {
           minItems: 1,
           description: "\u9996\u9879\u4E3A PATH \u4E2D\u7684\u53EF\u6267\u884C\u6587\u4EF6\uFF0C\u5176\u4F59\u9879\u4E3A\u53C2\u6570\u3002"
         })
@@ -19707,7 +19759,7 @@ var init_oauth_keepalive = __esm({
 });
 
 // src/activation-trace.ts
-import { Type as Type18 } from "typebox";
+import { Type as Type17 } from "typebox";
 function namedActivationCause(error) {
   const evidenceId = `activation-cause-${++activationCauseEvidence}`;
   retainedActivationCauses.set(evidenceId, error);
@@ -19728,17 +19780,17 @@ var causeSchema, activationTraceRecordSchema, activationCauseEvidence, retainedA
 var init_activation_trace = __esm({
   "src/activation-trace.ts"() {
     "use strict";
-    causeSchema = Type18.Object({
-      identity: Type18.String({ minLength: 1 }),
-      name: Type18.String({ minLength: 1 }),
-      message: Type18.String(),
-      evidenceId: Type18.Optional(Type18.String({ minLength: 1 }))
+    causeSchema = Type17.Object({
+      identity: Type17.String({ minLength: 1 }),
+      name: Type17.String({ minLength: 1 }),
+      message: Type17.String(),
+      evidenceId: Type17.Optional(Type17.String({ minLength: 1 }))
     }, { additionalProperties: false });
-    activationTraceRecordSchema = Type18.Object({
-      role: Type18.String({ minLength: 1 }),
-      stageId: Type18.String({ pattern: "^[a-z][a-z0-9-]*$" }),
-      status: Type18.Literal("failed"),
-      timestamp: Type18.String({ format: "date-time" }),
+    activationTraceRecordSchema = Type17.Object({
+      role: Type17.String({ minLength: 1 }),
+      stageId: Type17.String({ pattern: "^[a-z][a-z0-9-]*$" }),
+      status: Type17.Literal("failed"),
+      timestamp: Type17.String({ format: "date-time" }),
       cause: causeSchema
     }, { additionalProperties: false });
     activationCauseEvidence = 0;
@@ -20020,10 +20072,10 @@ var init_stderr_jsonl = __esm({
 
 // src/tool-execution-observation.ts
 import { writeSync as writeSync3 } from "node:fs";
-import { Type as Type19 } from "typebox";
-import { Value as Value4 } from "typebox/value";
+import { Type as Type18 } from "typebox";
+import { Value as Value3 } from "typebox/value";
 function validateToolExecutionObservationRecord(record4) {
-  if (!Value4.Check(toolExecutionObservationRecordSchema, record4)) {
+  if (!Value3.Check(toolExecutionObservationRecordSchema, record4)) {
     throw new TypeError("Tool execution observation record does not match its contract");
   }
   return record4;
@@ -20114,29 +20166,266 @@ var init_tool_execution_observation = __esm({
     init_stderr_jsonl();
     TOOL_EXECUTION_UPDATE_THROTTLE_MS = 3e4;
     observationBase = {
-      role: Type19.String({ minLength: 1 }),
-      toolCallId: Type19.String({ minLength: 1 }),
-      toolName: Type19.String({ minLength: 1 }),
-      timestamp: Type19.String({ format: "date-time" })
+      role: Type18.String({ minLength: 1 }),
+      toolCallId: Type18.String({ minLength: 1 }),
+      toolName: Type18.String({ minLength: 1 }),
+      timestamp: Type18.String({ format: "date-time" })
     };
-    toolExecutionObservationRecordSchema = Type19.Union([
-      Type19.Object({
+    toolExecutionObservationRecordSchema = Type18.Union([
+      Type18.Object({
         ...observationBase,
-        event: Type19.Literal("tool_execution_start")
+        event: Type18.Literal("tool_execution_start")
       }, { additionalProperties: true }),
-      Type19.Object({
+      Type18.Object({
         ...observationBase,
-        event: Type19.Literal("tool_execution_update")
+        event: Type18.Literal("tool_execution_update")
       }, { additionalProperties: true }),
-      Type19.Object({
+      Type18.Object({
         ...observationBase,
-        event: Type19.Literal("tool_execution_end"),
-        isError: Type19.Boolean()
+        event: Type18.Literal("tool_execution_end"),
+        isError: Type18.Boolean()
       }, { additionalProperties: true })
     ]);
   }
 });
 
+// src/atomic-write.ts
+import { randomUUID as randomUUID6 } from "node:crypto";
+import { rename, rm as rm2, writeFile as writeFile8 } from "node:fs/promises";
+import { dirname as dirname17, join as join32 } from "node:path";
+async function writeFileAtomically(destination, contents) {
+  const parent = dirname17(destination);
+  const temporary = join32(parent, `.atomic-write-${randomUUID6()}.tmp`);
+  try {
+    await writeFile8(temporary, contents);
+    await rename(temporary, destination);
+  } catch (error) {
+    await rm2(temporary, { force: true }).catch(() => void 0);
+    throw error;
+  }
+}
+var init_atomic_write = __esm({
+  "src/atomic-write.ts"() {
+    "use strict";
+  }
+});
+
+// src/collector-tool-schemas.ts
+import { Type as Type19 } from "typebox";
+var collectorObserveArgsSchema, COLLECTOR_REQUEST_ID_PATTERN, collectorRequestArgsSchema, COLLECTOR_HANDBOOK_MAX_BYTES, collectorHandbookWriteArgsSchema, collectorReadArgsSchema, collectorWaitArgsSchema, collectorBindTargetArgsSchema, collectorFindingItemDeclaration, collectorOutputBaseSchema, collectorOutputArgsSchema;
+var init_collector_tool_schemas = __esm({
+  "src/collector-tool-schemas.ts"() {
+    "use strict";
+    init_collector_evidence();
+    init_open_tool_schema();
+    init_terminating_infrastructure();
+    collectorObserveArgsSchema = Type19.Object({}, { additionalProperties: false });
+    COLLECTOR_REQUEST_ID_PATTERN = /^\S(?:.*\S)?$/;
+    collectorRequestArgsSchema = Type19.Object({
+      requestId: Type19.String({
+        minLength: 1,
+        pattern: COLLECTOR_REQUEST_ID_PATTERN.source,
+        description: "\u8BF7\u6C42\u8EAB\u4EFD\uFF08\u914D\u7F6E id \u6216\u89D2\u8272\u5224\u5B9A\u7684\u7A33\u5B9A id\uFF1B\u9996\u5C3E\u65E0\u7A7A\u767D\uFF09"
+      }),
+      snapshotId: Type19.String({ minLength: 1, description: "\u6700\u65B0\u7559\u5B58\u89C2\u5BDF\u5FEB\u7167" }),
+      body: Type19.Optional(Type19.String({
+        minLength: 1,
+        description: "\u89D2\u8272\u5224\u5B9A\u7684\u8BF7\u6C42\u6B63\u6587\uFF1Brequest-manifest \u672A\u6536\u5F55\u8BE5 requestId \u65F6\u5FC5\u586B"
+      }))
+    }, { additionalProperties: false });
+    COLLECTOR_HANDBOOK_MAX_BYTES = 64 * 1024;
+    collectorHandbookWriteArgsSchema = Type19.Object({
+      scope: Type19.Union([
+        Type19.Literal("general"),
+        Type19.Literal("repo")
+      ], { description: "general\uFF1D\u901A\u7528\u624B\u518C\uFF1Brepo\uFF1D\u5F53\u524D\u4ED3\u5E93\u5DEE\u5F02" }),
+      body: Type19.String({
+        description: `\u624B\u518C\u5168\u6587\uFF08opaque \u5DE5\u4F5C\u8BB0\u5FC6\uFF1B\u6574\u4EFD\u66FF\u6362\uFF1BUTF-8 \u81F3\u591A ${COLLECTOR_HANDBOOK_MAX_BYTES} \u5B57\u8282\uFF09`
+      })
+    }, { additionalProperties: false });
+    collectorReadArgsSchema = Type19.Object({
+      evidenceId: Type19.String({ minLength: 1, description: "observe \u8FD4\u56DE\u7684\u6750\u6599\u8BC1\u636E id\uFF08evidenceId\uFF09" })
+    }, { additionalProperties: false });
+    collectorWaitArgsSchema = Type19.Object({
+      durationMs: Type19.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 });
+    collectorBindTargetArgsSchema = Type19.Object({
+      prNumber: Type19.Optional(Type19.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: Type19.Optional(Type19.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 });
+    collectorFindingItemDeclaration = (() => {
+      const item = Type19.Object(
+        {
+          evidenceId: Type19.Unknown({
+            description: "observe \u8FD4\u56DE\u7684\u6750\u6599\u6307\u9488\uFF08\u5FC5\u586B\u8BED\u4E49\uFF09"
+          }),
+          category: Type19.Unknown({
+            description: "\u7B80\u77ED\u5F52\u7C7B\u6807\u7B7E\uFF0C\u4E0D\u662F\u6458\u8981"
+          }),
+          summary: Type19.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(
+      Type19.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: Type19.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: Type19.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
+    );
+  }
+});
+
+// src/collector-handbook.ts
+import { readFile as readFile18 } from "node:fs/promises";
+import { join as join33, sep as sep4 } from "node:path";
+function resolveCollectorHandbookRoot(sessionPath) {
+  if (typeof sessionPath !== "string" || sessionPath.trim().length === 0) {
+    throw new Error("\u901A\u8FDB\u53F8\u624B\u518C\u8981\u6C42\u975E\u7A7A session \u8DEF\u5F84\uFF0C\u4E14\u4F4D\u4E8E books/<bookKey>/");
+  }
+  const segments = sessionPath.split(sep4);
+  let bookKey;
+  for (let i = 0; i + 3 < segments.length; i += 1) {
+    if (segments[i] === ".ak-roles" && segments[i + 1] === "books") {
+      const candidate = segments[i + 2];
+      if (candidate.length > 0) {
+        bookKey = candidate;
+        break;
+      }
+    }
+  }
+  if (bookKey === void 0) {
+    throw new Error(
+      `\u901A\u8FDB\u53F8\u624B\u518C\u8981\u6C42 session \u4F4D\u4E8E books/<bookKey>/\uFF1B\u6536\u5230 ${sessionPath}`
+    );
+  }
+  if (bookKey === "." || bookKey === "..") {
+    throw new Error(`\u901A\u8FDB\u53F8\u624B\u518C\u62D2\u7EDD\u4E0D\u5B89\u5168 bookKey ${JSON.stringify(bookKey)}`);
+  }
+  const ledgerHome = resolveActivationLedgerHomeForPath(sessionPath);
+  const root = join33(activationBookDirectory(ledgerHome, bookKey), "collector-handbook");
+  return { ledgerHome, bookKey, root };
+}
+function collectorHandbookRepoFileName(repositoryCanonical) {
+  if (!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*$/.test(repositoryCanonical)) {
+    throw new Error(
+      `\u901A\u8FDB\u53F8\u624B\u518C\u4ED3\u5E93\u6587\u4EF6\u8981\u6C42\u89C4\u8303 owner/repo\uFF0C\u6536\u5230 ${JSON.stringify(repositoryCanonical)}`
+    );
+  }
+  return `${repositoryCanonical.replaceAll("/", "__")}.md`;
+}
+function createCollectorHandbookStore(input) {
+  const generalPath = join33(input.handbookRoot, "general.md");
+  const repoDir = join33(input.handbookRoot, "repos");
+  const repoPath = join33(repoDir, collectorHandbookRepoFileName(input.repositoryCanonical));
+  const assertHandbookBudget = (body, label) => {
+    const byteLength = Buffer.byteLength(body, "utf8");
+    if (byteLength > COLLECTOR_HANDBOOK_MAX_BYTES) {
+      throw new Error(
+        `\u901A\u8FDB\u53F8\u624B\u518C${label} UTF-8 \u81F3\u591A ${COLLECTOR_HANDBOOK_MAX_BYTES} \u5B57\u8282\uFF0C\u6536\u5230 ${byteLength}`
+      );
+    }
+    return byteLength;
+  };
+  const readOptional = async (path, parentDir2) => {
+    ensureRealDirectoryTree(input.ledgerHome, parentDir2);
+    assertLedgerFileInsideHome(path, input.ledgerHome);
+    try {
+      const body = await readFile18(path, "utf8");
+      assertHandbookBudget(body, "\u6B63\u6587");
+      return body;
+    } catch (error) {
+      if (isNotFound(error)) return void 0;
+      throw error;
+    }
+  };
+  return {
+    root: input.handbookRoot,
+    repositoryCanonical: input.repositoryCanonical,
+    async read() {
+      const bookGeneral = await readOptional(generalPath, input.handbookRoot);
+      const bookRepo = await readOptional(repoPath, repoDir);
+      if (bookGeneral !== void 0) {
+        return {
+          general: bookGeneral,
+          repo: bookRepo ?? "",
+          generalSource: "book",
+          repoSource: bookRepo === void 0 ? "empty" : "book",
+          generalPath,
+          repoPath
+        };
+      }
+      const seed = input.seedGeneral;
+      if (typeof seed === "string" && seed.length > 0) {
+        assertHandbookBudget(seed, "\u6B63\u6587");
+        return {
+          general: seed,
+          repo: bookRepo ?? "",
+          generalSource: "seed",
+          repoSource: bookRepo === void 0 ? "empty" : "book",
+          generalPath,
+          repoPath
+        };
+      }
+      return {
+        general: "",
+        repo: bookRepo ?? "",
+        generalSource: "empty",
+        repoSource: bookRepo === void 0 ? "empty" : "book",
+        generalPath,
+        repoPath
+      };
+    },
+    async write(scope, body) {
+      const byteLength = assertHandbookBudget(body, "\u6B63\u6587");
+      ensureRealDirectoryTree(input.ledgerHome, input.handbookRoot);
+      const path = scope === "general" ? generalPath : repoPath;
+      if (scope === "repo") {
+        ensureRealDirectoryTree(input.ledgerHome, repoDir);
+      }
+      assertLedgerFileInsideHome(path, input.ledgerHome);
+      await writeFileAtomically(path, body);
+      return {
+        scope,
+        path,
+        byteLength
+      };
+    }
+  };
+}
+function isNotFound(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+var init_collector_handbook = __esm({
+  "src/collector-handbook.ts"() {
+    "use strict";
+    init_atomic_write();
+    init_activation_ledger_topology();
+    init_collector_tool_schemas();
+  }
+});
+
 // src/collector-receipt.ts
 function fail4(message) {
   throw new Error(message);
@@ -20236,20 +20525,34 @@ var init_collector_receipt = __esm({
 // src/collector-role.ts
 function buildMethodContext(activation) {
   const pr = activation.ledger.config.prNumber;
-  return [
+  const handbook = activation.handbookView;
+  const lines = [
     "<collector_method>",
     `host: github.com`,
     `repository: ${activation.repository.canonical}`,
-    `prNumber: ${pr === void 0 ? "unbound \u2014 call ak_collector_bind_target with the role-decided issue/PR before observe" : String(pr)}`,
+    `prNumber: ${pr === void 0 ? "\u672A\u7ED1\u5B9A" : String(pr)}`,
     `requests: ${JSON.stringify(activation.manifest.requests.map((request) => ({ id: request.id })))}`,
+    `handbookGeneralSource: ${handbook.generalSource}`,
+    `handbookRepoSource: ${handbook.repoSource}`,
     "</collector_method>"
-  ].join("\n");
+  ];
+  if (handbook.general.length > 0 || handbook.repo.length > 0) {
+    const payload = JSON.stringify({
+      general: handbook.general,
+      repo: handbook.repo,
+      generalSource: handbook.generalSource,
+      repoSource: handbook.repoSource,
+      repository: activation.repository.canonical
+    }).replaceAll("<", "\\u003c");
+    lines.push("", "<collector_handbook>", payload, "</collector_handbook>");
+  }
+  return lines.join("\n");
 }
 function parsePositiveTicket(raw, label) {
   if (raw === void 0 || raw === null) return void 0;
   if (typeof raw === "number" && Number.isSafeInteger(raw) && raw >= 1) return raw;
   if (typeof raw === "string" && /^[1-9]\d*$/.test(raw.trim())) return Number(raw.trim());
-  throw new CollectorTargetBindError(`ak_collector_bind_target ${label} must be a positive safe integer`);
+  throw new CollectorTargetBindError(`\u901A\u8FDB\u53F8\u7ED1\u5B9A ${label} \u987B\u4E3A\u6B63\u5B89\u5168\u6574\u6570`);
 }
 function createCollectorRoleRuntime(pi, dependencies, hostActions) {
   let toolsRegistered = false;
@@ -20278,13 +20581,28 @@ function createCollectorRoleRuntime(pi, dependencies, hostActions) {
         clock,
         ctx
       );
+      const sessionPath = ctx.sessionManager?.getSessionFile?.() ?? ctx.sessionManager?.getSessionDir?.();
+      if (typeof sessionPath !== "string" || sessionPath.length === 0) {
+        throw new Error("\u901A\u8FDB\u53F8\u624B\u518C\u8981\u6C42 session \u8DEF\u5F84\u4F4D\u4E8E books/<bookKey>/");
+      }
+      const placement = resolveCollectorHandbookRoot(sessionPath);
+      const seedGeneral = dependencies.loadHandbookSeed === void 0 ? void 0 : (await dependencies.loadHandbookSeed()).trim();
+      const handbook = createCollectorHandbookStore({
+        ledgerHome: placement.ledgerHome,
+        handbookRoot: placement.root,
+        repositoryCanonical: repository.canonical,
+        ...seedGeneral === void 0 || seedGeneral.length === 0 ? {} : { seedGeneral }
+      });
+      const handbookView = await handbook.read();
       return {
         soul,
         repository,
         manifest,
         ledger,
         transport,
-        clock
+        clock,
+        handbook,
+        handbookView
       };
     },
     assembleMaterials(activation, baseSystemPrompt) {
@@ -20337,7 +20655,7 @@ function createCollectorRoleRuntime(pi, dependencies, hostActions) {
             const issueNumber = parsePositiveTicket(params.issueNumber, "issueNumber");
             if (prNumber === void 0 && issueNumber === void 0) {
               throw new CollectorTargetBindError(
-                "ak_collector_bind_target requires role-decided prNumber and/or issueNumber"
+                "\u901A\u8FDB\u53F8\u7ED1\u5B9A\u987B\u7531\u89D2\u8272\u5224\u5B9A prNumber \u4E0E/\u6216 issueNumber"
               );
             }
             let bound = prNumber;
@@ -20349,18 +20667,18 @@ function createCollectorRoleRuntime(pi, dependencies, hostActions) {
               });
               if (associated.length === 0) {
                 throw new CollectorTargetBindError(
-                  `no PR associated with issue #${issueNumber} in ${activation.repository.canonical}; pass an explicit --pr or a different issueNumber`
+                  `${activation.repository.canonical} \u7684 issue #${issueNumber} \u65E0\u5173\u8054 PR\uFF1B\u8BF7\u6539\u7528\u660E\u786E --pr \u6216\u5176\u4ED6 issueNumber`
                 );
               }
               if (associated.length > 1) {
                 throw new CollectorTargetBindError(
-                  `multiple PRs associated with issue #${issueNumber}: ${associated.join(", ")}; pass an explicit prNumber or --pr`
+                  `issue #${issueNumber} \u5173\u8054\u591A\u4E2A PR\uFF1A${associated.join("\u3001")}\uFF1B\u8BF7\u6539\u7528\u660E\u786E prNumber \u6216 --pr`
                 );
               }
               const fromIssue = associated[0];
               if (prNumber !== void 0 && prNumber !== fromIssue) {
                 throw new CollectorTargetBindError(
-                  `prNumber ${prNumber} conflicts with issue #${issueNumber} association PR ${fromIssue}`
+                  `prNumber ${prNumber} \u4E0E issue #${issueNumber} \u5173\u8054 PR ${fromIssue} \u51B2\u7A81`
                 );
               }
               bound = fromIssue;
@@ -20452,8 +20770,8 @@ function createCollectorRoleRuntime(pi, dependencies, hostActions) {
       pi.registerTool({
         name: COLLECTOR_REQUEST_TOOL,
         label: "\u901A\u8FDB\u53F8\u8BF7\u6C42",
-        description: "\u6309\u914D\u7F6E\u8BF7\u6C42\u4F53\u4E0E\u5173\u8054\u6807\u8BB0\uFF0C\u5728\u6240\u5F15\u6700\u65B0\u5FEB\u7167 HEAD \u53D1\u4E00\u6B21\u8BF7\u6C42\u3002",
-        promptSnippet: "\u6309\u914D\u7F6E\u53D1\u4E00\u6B21\u8BF7\u6C42",
+        description: "\u5728\u6240\u5F15\u6700\u65B0\u5FEB\u7167 HEAD \u53D1\u4E00\u6B21\u8BF7\u6C42\u3002requestId \u53EF\u53D6\u914D\u7F6E\u6E05\u5355\uFF0C\u6216\u89D2\u8272\u4F9D\u624B\u518C/\u73B0\u573A\u5224\u5B9A\u7684\u7A33\u5B9A id\uFF1B\u540E\u8005\u987B\u540C\u65F6\u63D0\u4F9B body\u3002",
+        promptSnippet: "\u53D1\u4E00\u6B21\u8BC4\u5BA1\u8BF7\u6C42",
         parameters: requestSchema,
         async execute(toolCallId, params, signal, _onUpdate, ctx) {
           const activation = getActivation();
@@ -20461,7 +20779,11 @@ function createCollectorRoleRuntime(pi, dependencies, hostActions) {
           try {
             activation.ledger.beginOperational(COLLECTOR_REQUEST_TOOL, toolCallId);
             const details = await activation.ledger.request(
-              params,
+              {
+                requestId: params.requestId,
+                snapshotId: params.snapshotId,
+                ...typeof params.body === "string" ? { body: params.body } : {}
+              },
               activation.transport,
               activation.clock,
               signal
@@ -20480,6 +20802,44 @@ function createCollectorRoleRuntime(pi, dependencies, hostActions) {
           }
         }
       });
+      pi.registerTool({
+        name: COLLECTOR_HANDBOOK_WRITE_TOOL,
+        label: "\u901A\u8FDB\u53F8\u624B\u518C\u5199\u5165",
+        description: "\u5199\u5165\u901A\u7528\u624B\u518C\u6216\u5F53\u524D\u4ED3\u5E93\u5DEE\u5F02\u5168\u6587\uFF08\u6574\u4EFD\u66FF\u6362\uFF09\u3002",
+        promptSnippet: "\u66F4\u65B0 bot \u624B\u518C",
+        parameters: handbookWriteSchema,
+        async execute(toolCallId, params, _signal, _onUpdate, ctx) {
+          const activation = getActivation();
+          if (activation === void 0) throw new Error("\u901A\u8FDB\u53F8\u672A\u6FC0\u6D3B");
+          try {
+            activation.ledger.beginOperational(COLLECTOR_HANDBOOK_WRITE_TOOL, toolCallId);
+            const details = await activation.handbook.write(params.scope, params.body);
+            activation.handbookView = await activation.handbook.read();
+            activation.ledger.completeOperational(toolCallId);
+            return {
+              content: [{
+                type: "text",
+                text: `\u624B\u518C\u5DF2\u5199\u5165\uFF1A${details.scope}`
+              }],
+              details: {
+                scope: details.scope,
+                path: details.path,
+                byteLength: details.byteLength,
+                generalSource: activation.handbookView.generalSource,
+                repoSource: activation.handbookView.repoSource
+              }
+            };
+          } catch (error) {
+            if (isCorrectableExecuteError(error)) throw error;
+            hostActions.failInfrastructure(error, ctx, toolCallId);
+          } finally {
+            try {
+              activation.ledger.completeOperational(toolCallId);
+            } catch {
+            }
+          }
+        }
+      });
       pi.registerTool({
         name: COLLECTOR_WAIT_TOOL,
         label: "\u901A\u8FDB\u53F8\u7B49\u5F85",
@@ -20557,13 +20917,14 @@ function createCollectorRoleRuntime(pi, dependencies, hostActions) {
     }
   };
 }
-var CollectorNormalCompletionDeclarationError, CollectorTargetBindError, COLLECTOR_REQUIRED_TOOLS, COLLECTOR_TRANSPORT_FLAGS, observeSchema, readSchema, requestSchema, waitSchema, bindSchema, outputSchema;
+var CollectorNormalCompletionDeclarationError, CollectorTargetBindError, COLLECTOR_REQUIRED_TOOLS, COLLECTOR_TRANSPORT_FLAGS, observeSchema, readSchema, requestSchema, waitSchema, bindSchema, handbookWriteSchema, outputSchema;
 var init_collector_role = __esm({
   "src/collector-role.ts"() {
     "use strict";
     init_collector_config();
     init_collector_evidence();
     init_collector_github();
+    init_collector_handbook();
     init_collector_ledger();
     init_collector_receipt();
     init_collector_tool_schemas();
@@ -20589,6 +20950,7 @@ var init_collector_role = __esm({
       COLLECTOR_READ_TOOL,
       COLLECTOR_REQUEST_TOOL,
       COLLECTOR_WAIT_TOOL,
+      COLLECTOR_HANDBOOK_WRITE_TOOL,
       COLLECTOR_OUTPUT_TOOL
     ];
     COLLECTOR_TRANSPORT_FLAGS = Object.freeze([
@@ -20619,6 +20981,7 @@ var init_collector_role = __esm({
     requestSchema = collectorRequestArgsSchema;
     waitSchema = collectorWaitArgsSchema;
     bindSchema = collectorBindTargetArgsSchema;
+    handbookWriteSchema = collectorHandbookWriteArgsSchema;
     outputSchema = collectorOutputArgsSchema;
   }
 });
@@ -21600,7 +21963,7 @@ var init_reviewer_role = __esm({
 
 // src/worker-submission-gates.ts
 import { execFileSync as execFileSync4 } from "node:child_process";
-import { existsSync as existsSync10, lstatSync as lstatSync3, readdirSync as readdirSync2, readFileSync as readFileSync4, rmdirSync, rmSync } from "node:fs";
+import { existsSync as existsSync11, lstatSync as lstatSync3, readdirSync as readdirSync2, readFileSync as readFileSync4, rmdirSync, rmSync } from "node:fs";
 import { resolve as resolve18 } from "node:path";
 function git2(cwd, args) {
   return execFileSync4("git", args, {
@@ -21621,7 +21984,7 @@ function statusOf(error) {
   return typeof error === "object" && error !== null && "status" in error ? error.status : void 0;
 }
 function tryGetAll(file, key) {
-  if (!existsSync10(file)) return [];
+  if (!existsSync11(file)) return [];
   try {
     const out = gitFile(file, ["--get-all", key]);
     return out.length === 0 ? [] : out.split("\n");
@@ -21631,7 +21994,7 @@ function tryGetAll(file, key) {
   }
 }
 function ownedHook(path) {
-  if (!existsSync10(path)) return false;
+  if (!existsSync11(path)) return false;
   return readFileSync4(path, "utf8").includes(HOOK_MARKER);
 }
 function escapeGitConfigValueRegex(value) {
@@ -21658,11 +22021,11 @@ function rmOwnedDir(dir) {
   const hookPath = resolve18(dir, HOOK_FILE);
   if (!ownedHook(hookPath)) return;
   rmSync(hookPath, { force: true });
-  if (existsSync10(dir) && readdirSync2(dir).length === 0) rmdirSync(dir);
+  if (existsSync11(dir) && readdirSync2(dir).length === 0) rmdirSync(dir);
 }
 function linkedGitDirs(commonDir) {
   const root = resolve18(commonDir, "worktrees");
-  if (!existsSync10(root)) return [];
+  if (!existsSync11(root)) return [];
   return readdirSync2(root).map((name) => resolve18(root, name)).filter((dir) => lstatSync3(dir).isDirectory());
 }
 function uninstallPackageWorkerHooks(cwd) {
@@ -21729,11 +22092,11 @@ function reliableWindow(cwd, baseline, head) {
   const raw = git2(cwd, ["log", "--format=%P%x1e%s", range]);
   if (raw.length === 0) return [];
   return raw.split("\n").flatMap((line2) => {
-    const sep4 = line2.indexOf("");
-    if (sep4 < 0) return [];
+    const sep5 = line2.indexOf("");
+    if (sep5 < 0) return [];
     return [{
-      subject: line2.slice(sep4 + 1),
-      merge: line2.slice(0, sep4).trim().includes(" ")
+      subject: line2.slice(sep5 + 1),
+      merge: line2.slice(0, sep5).trim().includes(" ")
     }];
   });
 }
@@ -22351,8 +22714,8 @@ var init_activation_reconciliation = __esm({
 
 // src/role-runtime.ts
 import { readFileSync as readFileSync5, writeSync as writeSync4 } from "node:fs";
-import { join as join31 } from "node:path";
-import { Value as Value5 } from "typebox/value";
+import { join as join34 } from "node:path";
+import { Value as Value4 } from "typebox/value";
 function decodeReviewerAdmittedInputs(getFlag) {
   let reviewScopeKeys;
   const rawScopeKeys = getFlag("ak-review-scope-keys");
@@ -22479,7 +22842,7 @@ function activationStage(role, runtime) {
   }
 }
 function validateActivationTraceRecord(record4) {
-  if (!Value5.Check(activationTraceRecordSchema, record4)) {
+  if (!Value4.Check(activationTraceRecordSchema, record4)) {
     throw new TypeError("Activation trace record does not match its closed contract");
   }
   return record4;
@@ -22723,7 +23086,7 @@ function readDiaristRunCoordinates() {
   if (typeof runDirectory !== "string" || runDirectory.trim() === "") {
     throw new Error("diarist accept requires AK_ROLE_RUN_DIR");
   }
-  const admittedPath = join31(runDirectory, "admitted-request.json");
+  const admittedPath = join34(runDirectory, "admitted-request.json");
   const admitted = JSON.parse(readFileSync5(admittedPath, "utf8"));
   if (typeof admitted.projectRoot !== "string" || admitted.projectRoot.trim() === "") {
     throw new Error(`diarist admitted-request missing projectRoot (${admittedPath})`);
@@ -23341,7 +23704,8 @@ function createRoleRuntimeExtension(dependencies) {
             dossierEntries: context.sessionManager?.getEntries?.() ?? []
           });
         },
-        ...dependencies.createCollectorClock === void 0 ? {} : { createClock: dependencies.createCollectorClock }
+        ...dependencies.createCollectorClock === void 0 ? {} : { createClock: dependencies.createCollectorClock },
+        ...dependencies.loadCollectorHandbookSeed === void 0 ? {} : { loadHandbookSeed: dependencies.loadCollectorHandbookSeed }
       },
       hostActions
     );
@@ -24082,9 +24446,9 @@ __export(in_process_session_exports, {
   DEFAULT_COMPLIANCE_IDLE_MAX_RETRIES: () => DEFAULT_COMPLIANCE_IDLE_MAX_RETRIES,
   openPiInProcessSession: () => openPiInProcessSession
 });
-import { mkdtemp as mkdtemp2, rm as rm2 } from "node:fs/promises";
+import { mkdtemp as mkdtemp2, rm as rm3 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join32 } from "node:path";
+import { join as join35 } from "node:path";
 import {
   createAgentSession,
   DefaultResourceLoader,
@@ -24207,7 +24571,7 @@ async function openPiInProcessSession(options) {
   let scratchDir;
   let resolvedAgentDir = options.agentDir;
   if (resolvedAgentDir === void 0) {
-    scratchDir = await mkdtemp2(join32(options.credentialScratchParent ?? tmpdir2(), "ak-institutional-"));
+    scratchDir = await mkdtemp2(join35(options.credentialScratchParent ?? tmpdir2(), "ak-institutional-"));
     resolvedAgentDir = scratchDir;
   }
   try {
@@ -24689,7 +25053,7 @@ async function openPiInProcessSession(options) {
         }
         if (scratchDir !== void 0) {
           try {
-            await rm2(scratchDir, { recursive: true, force: true });
+            await rm3(scratchDir, { recursive: true, force: true });
           } catch (error) {
             cleanupFailures.push(error);
           }
@@ -24714,7 +25078,7 @@ async function openPiInProcessSession(options) {
   } catch (openError) {
     if (scratchDir !== void 0) {
       try {
-        await rm2(scratchDir, { recursive: true, force: true });
+        await rm3(scratchDir, { recursive: true, force: true });
       } catch (cleanupFailure) {
         throw new AggregateError(
           [openError, cleanupFailure],
@@ -24901,9 +25265,9 @@ var init_reviewer_child_executor = __esm({
 
 // src/reviewer-workspace.ts
 import { spawn as spawn4 } from "node:child_process";
-import { mkdtemp as mkdtemp3, rm as rm3 } from "node:fs/promises";
+import { mkdtemp as mkdtemp3, rm as rm4 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
-import { join as join33 } from "node:path";
+import { join as join36 } from "node:path";
 async function runCommand(command, args, options = {}) {
   return await new Promise((resolve20, reject) => {
     const child = spawn4(command, args, { ...options.cwd === void 0 ? {} : { cwd: options.cwd }, stdio: ["ignore", "pipe", "pipe"], signal: options.signal });
@@ -24952,8 +25316,8 @@ async function prepareSnapshot(accepted, signal, dependencies) {
     if (!sameReviewerPinnedTarget({ repositoryRoot: accepted.repositoryRoot, objectFormat, targetHead }, accepted)) throw new Error("Accepted Reviewer target identity no longer matches the repository");
     await git3(accepted.repositoryRoot, ["cat-file", "-e", `${targetHead}^{commit}`], signal);
     dependencies.fault?.("mirror.before-create");
-    mirrorRoot = await mkdtemp3(join33(tmpdir3(), "ak-reviewer-snapshot-"));
-    const mirrorPath = join33(mirrorRoot, "repository.git");
+    mirrorRoot = await mkdtemp3(join36(tmpdir3(), "ak-reviewer-snapshot-"));
+    const mirrorPath = join36(mirrorRoot, "repository.git");
     dependencies.fault?.("mirror.create");
     await runCommand("git", ["init", "--bare", `--object-format=${accepted.objectFormat}`, mirrorPath], signal === void 0 ? {} : { signal });
     await git3(mirrorPath, ["fetch", "--no-tags", accepted.repositoryRoot, targetHead], signal);
@@ -24970,7 +25334,7 @@ async function prepareClone(snapshot, signal, dependencies) {
   const target = { repositoryRoot: snapshot.repositoryRoot, objectFormat: snapshot.objectFormat, targetHead: snapshot.targetHead, refs: { ...snapshot.refs } };
   try {
     dependencies.fault?.("workspace.before-create");
-    workspace = await mkdtemp3(join33(tmpdir3(), "ak-reviewer-leg-"));
+    workspace = await mkdtemp3(join36(tmpdir3(), "ak-reviewer-leg-"));
     dependencies.fault?.("workspace.init");
     await git3(workspace, ["init", `--object-format=${snapshot.objectFormat}`, "--initial-branch=ak-reviewer-unborn"], signal);
     dependencies.fault?.("workspace.fetch");
@@ -25004,12 +25368,12 @@ function createReviewerWorkspaceOwner(dependencies = {}) {
       return Object.freeze({ target: frozenTarget, workspaces: Object.freeze(workspaces) });
     },
     async dispose(workspace) {
-      await rm3(workspace.path, { recursive: true, force: false });
+      await rm4(workspace.path, { recursive: true, force: false });
       return "deleted";
     },
     async shutdown() {
       if (ownedSnapshot === void 0) return;
-      cleanupPromise ??= rm3(ownedSnapshot.mirrorRoot, { recursive: true, force: false });
+      cleanupPromise ??= rm4(ownedSnapshot.mirrorRoot, { recursive: true, force: false });
       await cleanupPromise;
     }
   };
@@ -25171,7 +25535,7 @@ var init_reviewer_agent = __esm({
 });
 
 // src/acp-host/production-host.ts
-import { readFile as readFile20 } from "node:fs/promises";
+import { readFile as readFile21 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // src/canonical-skill-binding.ts
@@ -25385,9 +25749,9 @@ init_auditor_soul();
 init_session_opening_materials();
 
 // src/acp-host/description.ts
-import { join as join34 } from "node:path";
+import { join as join37 } from "node:path";
 function resolveAcpBinary(description, operatorHome) {
-  return join34(operatorHome, ...description.binaryFromHome);
+  return join37(operatorHome, ...description.binaryFromHome);
 }
 function acpStdioArgs(description, model, seat) {
   const { prefix, suffix, modelFlag, thinkingFlag } = description.argv;
@@ -25410,10 +25774,10 @@ init_gatekeeper_pass_envelope();
 init_packaged_role_registry();
 init_method_skill();
 init_role_runtime();
-import { randomUUID as randomUUID6 } from "node:crypto";
-import { mkdir as mkdir5, readFile as readFile18, writeFile as writeFile8 } from "node:fs/promises";
+import { randomUUID as randomUUID7 } from "node:crypto";
+import { mkdir as mkdir5, readFile as readFile19, writeFile as writeFile9 } from "node:fs/promises";
 import { createServer } from "node:net";
-import { basename as basename7, dirname as dirname17, join as join35 } from "node:path";
+import { basename as basename7, dirname as dirname18, join as join38 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/acp-host/role-turn-host.ts
@@ -25712,7 +26076,7 @@ function buildAcpSkillExpansion(methodSkills, prompt) {
   return Object.freeze({
     name: parsed.name,
     location: method.path,
-    content: `References are relative to ${dirname17(method.path)}.
+    content: `References are relative to ${dirname18(method.path)}.
 
 ${method.body}`,
     userMessage: parsed.userMessage
@@ -25764,12 +26128,27 @@ function createComposedAcpRoleTurnHost(config) {
       dependencies: config.roleRuntimeDependencies,
       // Same durable-principal path settlement uses for isAvailable (#617 DK-4 layout).
       sessionFile: config.sessionIdentity.resolveSessionFile(request.principal),
-      socketPath: config.socketPath?.(request) ?? `/tmp/ak-acp-mcp-${randomUUID6()}.sock`
+      socketPath: config.socketPath?.(request) ?? `/tmp/ak-acp-mcp-${randomUUID7()}.sock`
     })
   });
 }
+function terminatingToolJsonSchema(parameters) {
+  const cloned = JSON.parse(JSON.stringify(parameters));
+  return Object.freeze({
+    ...cloned,
+    $schema: "http://json-schema.org/draft-07/schema#"
+  });
+}
 async function prepareAcpRoleEnvelope(options) {
   const { request } = options;
+  if (options.socketPath === "") {
+    throw new Error("prepareAcpRoleEnvelope requires socketPath");
+  }
+  const listTerminatingToolOnMcp = options.listTerminatingToolOnMcp !== false;
+  const earlyTerminatingTool = packagedRoleOutputTool(request.activation.role);
+  if (earlyTerminatingTool === void 0) {
+    throw new Error(`role has no terminating tool: ${request.activation.role}`);
+  }
   const flags = projectAcpActivationFlags(request);
   const tools = /* @__PURE__ */ new Map();
   const handlers = /* @__PURE__ */ new Map();
@@ -25781,19 +26160,19 @@ async function prepareAcpRoleEnvelope(options) {
   let rejection;
   let infrastructureRoundFailure;
   const hostAbort = new AbortController();
-  const runId = request.runDirectory.split("/").filter(Boolean).at(-1) ?? randomUUID6();
+  const runId = request.runDirectory.split("/").filter(Boolean).at(-1) ?? randomUUID7();
   await mkdir5(request.runDirectory, { recursive: true });
   for (const method of request.methods) {
     if (method.kind !== "skill") continue;
-    const name = basename7(dirname17(method.path));
-    const raw = await readFile18(method.path, "utf8");
+    const name = basename7(dirname18(method.path));
+    const raw = await readFile19(method.path, "utf8");
     methodSkills.set(name, { path: method.path, body: stripSkillFrontmatter(raw).trim() });
   }
-  let sessionFile = options.sessionFile ?? join35(request.runDirectory, "session", "session.jsonl");
-  await mkdir5(dirname17(sessionFile), { recursive: true });
+  let sessionFile = options.sessionFile ?? join38(request.runDirectory, "session", "session.jsonl");
+  await mkdir5(dirname18(sessionFile), { recursive: true });
   if (request.continuation.kind !== "resume") {
     try {
-      await writeFile8(
+      await writeFile9(
         sessionFile,
         `${JSON.stringify({
           type: "session",
@@ -25817,7 +26196,7 @@ async function prepareAcpRoleEnvelope(options) {
       getLeafEntry: () => sessionEntries.at(-1),
       getLeafId: () => runId,
       getEntries: () => sessionEntries,
-      getSessionDir: () => dirname17(sessionFile),
+      getSessionDir: () => dirname18(sessionFile),
       getSessionFile: () => sessionFile,
       getHeader: () => ({ type: "session", id: runId }),
       setSessionFile(path) {
@@ -25918,7 +26297,7 @@ async function prepareAcpRoleEnvelope(options) {
     }
   };
   createRoleRuntimeExtension(options.dependencies)(envelope);
-  const token = randomUUID6();
+  const token = randomUUID7();
   const server = createServer((socket) => serveSocket(socket));
   function rememberProjectedRejection(details, toolCallId) {
     if (typeof details !== "object" || details === null) return;
@@ -25992,6 +26371,68 @@ async function prepareAcpRoleEnvelope(options) {
     await emit("tool_execution_end", { toolCallId, toolName, isError: projected.isError });
     return projected;
   }
+  async function invokeAkTool(name, args) {
+    const tool = tools.get(name);
+    if (tool === void 0) throw new Error(`Unknown AK tool: ${name}`);
+    const toolCallId = randomUUID7();
+    calls.push({ toolCallId, toolName: name });
+    sessionEntries.push({
+      type: "message",
+      message: {
+        role: "assistant",
+        content: [{
+          type: "toolCall",
+          id: toolCallId,
+          name,
+          arguments: args ?? {}
+        }]
+      }
+    });
+    try {
+      await emit("tool_execution_start", { toolCallId, toolName: name });
+      const blocked = (await emit("tool_call", { toolCallId, toolName: name, input: args ?? {} })).some((value) => typeof value === "object" && value !== null && "block" in value && value.block === true);
+      if (blocked) {
+        return { content: [{ type: "text", text: `AK tool blocked: ${name}` }], isError: true, blocked: true };
+      }
+    } catch (error) {
+      const declared = declareRoundInfrastructureFailure(error);
+      try {
+        const projected = await projectToolResult(toolCallId, name, {
+          content: declared.content,
+          details: declared.details,
+          isError: true
+        });
+        return { content: projected.content, isError: true };
+      } catch {
+        return { content: declared.content, isError: true };
+      }
+    }
+    try {
+      const result = await tool.execute(toolCallId, args ?? {}, void 0, void 0, context);
+      const projected = await projectToolResult(toolCallId, name, {
+        content: result.content,
+        details: result.details,
+        isError: false
+      });
+      return { content: projected.content, isError: projected.isError };
+    } catch (error) {
+      let content;
+      let details;
+      if (isCorrectableExecuteError(error)) {
+        const projected2 = projectCorrectableExecuteRejection(error);
+        content = [{ type: "text", text: projected2.diagnostic }];
+        details = projected2.details;
+      } else {
+        ({ content, details } = declareRoundInfrastructureFailure(error));
+      }
+      const projected = await projectToolResult(toolCallId, name, {
+        content,
+        details,
+        isError: true
+      });
+      return { content: projected.content, isError: projected.isError };
+    }
+  }
   function reply(socket, id, result, error) {
     const rpcError = error instanceof Error ? { code: "ak-relay-failure", name: error.name, message: error.message } : { code: "ak-relay-failure", name: "RelayFailure", message: String(error) };
     socket.write(`${JSON.stringify({ id, ...error === void 0 ? { result } : { error: rpcError } })}
@@ -26020,8 +26461,9 @@ async function prepareAcpRoleEnvelope(options) {
           }
           try {
             if (rpc.method === "tools/list") {
-              reply(socket, rpc.id, { tools: [...tools.values()].map((tool2) => {
-                return { name: tool2.name, description: tool2.description, inputSchema: tool2.parameters };
+              const listed = [...tools.values()].filter((tool) => listTerminatingToolOnMcp || tool.name !== earlyTerminatingTool);
+              reply(socket, rpc.id, { tools: listed.map((tool) => {
+                return { name: tool.name, description: tool.description, inputSchema: tool.parameters };
               }) });
               return;
             }
@@ -26029,74 +26471,15 @@ async function prepareAcpRoleEnvelope(options) {
             const params = rpc.params;
             const name = params?.name;
             if (typeof name !== "string") throw new Error("MCP tool name is missing");
-            const tool = tools.get(name);
-            if (tool === void 0) throw new Error(`Unknown AK tool: ${name}`);
-            const toolCallId = randomUUID6();
-            calls.push({ toolCallId, toolName: name });
-            {
-              const message = {
-                role: "assistant",
-                content: [{
-                  type: "toolCall",
-                  id: toolCallId,
-                  name,
-                  arguments: params?.arguments ?? {}
-                }]
-              };
-              sessionEntries.push({ type: "message", message });
+            if (!listTerminatingToolOnMcp && name === earlyTerminatingTool) {
+              throw new Error(`terminating tool ${name} is schema-channel only on this host`);
             }
-            try {
-              await emit("tool_execution_start", { toolCallId, toolName: name });
-              const blocked = (await emit("tool_call", { toolCallId, toolName: name, input: params?.arguments ?? {} })).some((value) => typeof value === "object" && value !== null && "block" in value && value.block === true);
-              if (blocked) {
-                reply(socket, rpc.id, void 0, new Error(`AK tool blocked: ${name}`));
-                return;
-              }
-            } catch (error) {
-              const declared = declareRoundInfrastructureFailure(error);
-              try {
-                const projected = await projectToolResult(toolCallId, name, {
-                  content: declared.content,
-                  details: declared.details,
-                  isError: true
-                });
-                reply(socket, rpc.id, {
-                  content: projected.content,
-                  isError: true
-                });
-              } catch {
-                reply(socket, rpc.id, {
-                  content: declared.content,
-                  isError: true
-                });
-              }
+            const outcome = await invokeAkTool(name, params?.arguments ?? {});
+            if (outcome.blocked === true) {
+              reply(socket, rpc.id, void 0, new Error(outcome.content.map((p) => p.type === "text" ? p.text : "").join("")));
               return;
             }
-            try {
-              const result = await tool.execute(toolCallId, params?.arguments ?? {}, void 0, void 0, context);
-              const projected = await projectToolResult(toolCallId, name, {
-                content: result.content,
-                details: result.details,
-                isError: false
-              });
-              reply(socket, rpc.id, { content: projected.content, ...projected.isError ? { isError: true } : {} });
-            } catch (error) {
-              let content;
-              let details;
-              if (isCorrectableExecuteError(error)) {
-                const projected2 = projectCorrectableExecuteRejection(error);
-                content = [{ type: "text", text: projected2.diagnostic }];
-                details = projected2.details;
-              } else {
-                ({ content, details } = declareRoundInfrastructureFailure(error));
-              }
-              const projected = await projectToolResult(toolCallId, name, {
-                content,
-                details,
-                isError: true
-              });
-              reply(socket, rpc.id, { content: projected.content, ...projected.isError ? { isError: true } : {} });
-            }
+            reply(socket, rpc.id, { content: outcome.content, ...outcome.isError ? { isError: true } : {} });
           } catch (error) {
             reply(socket, rpc.id, void 0, error);
           }
@@ -26104,8 +26487,8 @@ async function prepareAcpRoleEnvelope(options) {
       }
     });
   }
-  await listen(server, options.socketPath);
   const relay = fileURLToPath2(new URL("./mcp-relay.mjs", import.meta.url));
+  await listen(server, options.socketPath);
   let disposed = false;
   let priorAkRoleRunDir;
   let priorAkRoleCourtAttempt;
@@ -26148,6 +26531,11 @@ async function prepareAcpRoleEnvelope(options) {
       });
     }
   };
+  const terminatingToolName = earlyTerminatingTool;
+  async function ingestStructuredOutput(params) {
+    if (calls.some((call) => call.toolName === terminatingToolName)) return;
+    await invokeAkTool(terminatingToolName, params ?? {});
+  }
   const closeRound = async () => {
     if (calls.length > 0) {
       const roundCalls = [...calls];
@@ -26194,7 +26582,7 @@ async function prepareAcpRoleEnvelope(options) {
         message: { role: "user", content: prompt }
       });
     }
-    const methodPrompt = (await Promise.all(request.methods.map(({ path }) => readFile18(path, "utf8")))).join("\n\n");
+    const methodPrompt = (await Promise.all(request.methods.map(({ path }) => readFile19(path, "utf8")))).join("\n\n");
     const promptResults = await emit("before_agent_start", {
       prompt,
       systemPrompt: methodPrompt,
@@ -26214,6 +26602,11 @@ async function prepareAcpRoleEnvelope(options) {
     if (request.courtAttemptId === void 0) delete process.env.AK_ROLE_COURT_ATTEMPT;
     else process.env.AK_ROLE_COURT_ATTEMPT = request.courtAttemptId;
     runDirInjected = true;
+    const terminating = tools.get(terminatingToolName);
+    if (terminating === void 0) {
+      throw new Error(`terminating tool not registered after activation: ${terminatingToolName}`);
+    }
+    const jsonSchema = terminatingToolJsonSchema(terminating.parameters);
     return {
       mcpServers: [{
         name: `ak-${request.activation.role}`,
@@ -26228,7 +26621,10 @@ async function prepareAcpRoleEnvelope(options) {
       prompt,
       abortSignal: hostAbort.signal,
       closeRound,
-      dispose
+      dispose,
+      jsonSchema,
+      terminatingToolName,
+      ingestStructuredOutput
     };
   } catch (error) {
     try {
@@ -26247,12 +26643,12 @@ async function prepareAcpRoleEnvelope(options) {
 // src/acp-host/seat-profile-soul.ts
 import { constants as constants3 } from "node:fs";
 import { access as access4, copyFile, lstat as lstat6, mkdir as mkdir6, readlink, symlink, unlink as unlink4 } from "node:fs/promises";
-import { dirname as dirname18, join as join36, relative as relative3, resolve as resolve19 } from "node:path";
+import { dirname as dirname19, join as join39, relative as relative3, resolve as resolve19 } from "node:path";
 function seatProfileName(spec, role) {
   return `${spec.namePrefix}${role}`;
 }
 function packageRoleSoulPath(packageRoot, role) {
-  return join36(packageRoot, "souls", `${role}.md`);
+  return join39(packageRoot, "souls", `${role}.md`);
 }
 async function pathExists(path) {
   try {
@@ -26269,16 +26665,16 @@ async function ensureSeatProfileSoul(options) {
   if (!await pathExists(soulTarget)) {
     throw new Error(`packaged role soul missing: ${soulTarget}`);
   }
-  const profilesRoot = join36(operatorHome, ...spec.profilesRootFromHome);
-  const profileDir = join36(profilesRoot, profileName);
-  const hostRoot = dirname18(profilesRoot);
-  const soulPath = join36(profileDir, spec.soulFileName);
+  const profilesRoot = join39(operatorHome, ...spec.profilesRootFromHome);
+  const profileDir = join39(profilesRoot, profileName);
+  const hostRoot = dirname19(profilesRoot);
+  const soulPath = join39(profileDir, spec.soulFileName);
   if (!await pathExists(profileDir)) {
     await mkdir6(profileDir, { recursive: true });
     for (const name of ["auth.json", ".env", "config.yaml"]) {
-      const source = join36(hostRoot, name);
+      const source = join39(hostRoot, name);
       if (!await pathExists(source)) continue;
-      await copyFile(source, join36(profileDir, name));
+      await copyFile(source, join39(profileDir, name));
     }
   } else {
     await mkdir6(profileDir, { recursive: true });
@@ -26304,17 +26700,17 @@ async function ensureSeatProfileSoul(options) {
 }
 
 // src/acp-host/session-identity.ts
-import { mkdir as mkdir7, readFile as readFile19, rename, writeFile as writeFile9 } from "node:fs/promises";
-import { dirname as dirname19, join as join37 } from "node:path";
+import { mkdir as mkdir7, readFile as readFile20, rename as rename2, writeFile as writeFile10 } from "node:fs/promises";
+import { dirname as dirname20, join as join40 } from "node:path";
 function createAcpSessionIdentityAuthority(authority, sessionBindingFile) {
-  const bindingPath = (principal) => join37(authority.decode(principal).sessionDirectory, sessionBindingFile);
+  const bindingPath = (principal) => join40(authority.decode(principal).sessionDirectory, sessionBindingFile);
   return {
     resolveSessionFile(principal) {
       return authority.decode(principal).sessionFile;
     },
     async load(principal) {
       try {
-        const value = JSON.parse(await readFile19(bindingPath(principal), "utf8"));
+        const value = JSON.parse(await readFile20(bindingPath(principal), "utf8"));
         if (typeof value !== "object" || value === null || typeof value.sessionId !== "string") {
           throw new Error("durable ACP session binding is invalid");
         }
@@ -26326,11 +26722,11 @@ function createAcpSessionIdentityAuthority(authority, sessionBindingFile) {
     },
     async bind(principal, sessionId) {
       const target = bindingPath(principal);
-      await mkdir7(dirname19(target), { recursive: true });
+      await mkdir7(dirname20(target), { recursive: true });
       const temporary = `${target}.${process.pid}.tmp`;
-      await writeFile9(temporary, `${JSON.stringify({ sessionId })}
+      await writeFile10(temporary, `${JSON.stringify({ sessionId })}
 `, { encoding: "utf8", mode: 384 });
-      await rename(temporary, target);
+      await rename2(temporary, target);
     }
   };
 }
@@ -26339,6 +26735,9 @@ function createAcpSessionIdentityAuthority(authority, sessionBindingFile) {
 var navigatorRoutePlaybookPath = fileURLToPath3(
   new URL("../../resources/navigator-route-playbook.md", import.meta.url)
 );
+var collectorHandbookSeedPath = fileURLToPath3(
+  new URL("../../resources/collector-bot-handbook.md", import.meta.url)
+);
 function createAcpRoleRuntimeDependencies(packageRoot) {
   const doctorAuditor = createPiDoctorAuditor();
   const reviewerAgent = createPerDispatchReviewerAgent({ packageRoot });
@@ -26346,13 +26745,14 @@ function createAcpRoleRuntimeDependencies(packageRoot) {
   return {
     loadJudgeSoul: () => loadMainRoleSessionMaterials("judge"),
     loadFixerSoul: () => loadMainRoleSessionMaterials("fixer"),
-    loadFixPacket: (path) => readFile20(path, "utf8"),
+    loadFixPacket: (path) => readFile21(path, "utf8"),
     loadCoderSoul: () => loadMainRoleSessionMaterials("coder"),
-    loadCoderTask: (path) => readFile20(path, "utf8"),
+    loadCoderTask: (path) => readFile21(path, "utf8"),
     loadReviewerSoul: () => loadMainRoleSessionMaterials("reviewer"),
     createReviewerPinnedGitReader: () => createReviewerPinnedGitReader(),
     createReviewerIssueFetcher: () => createGhIssueSoftFetcher(),
     loadCollectorSoul: () => loadMainRoleSessionMaterials("collector"),
+    loadCollectorHandbookSeed: () => readFile21(collectorHandbookSeedPath, "utf8"),
     createCollectorTransport: () => createGhCollectorGitHubTransport(),
     loadDoctorSoul: () => loadMainRoleSessionMaterials("doctor"),
     loadDoctorCase,
@@ -26366,7 +26766,7 @@ function createAcpRoleRuntimeDependencies(packageRoot) {
     loadDiaristSoul: () => loadMainRoleSessionMaterials("diarist"),
     loadNotarySourceRun: loadNotarySourceRunLocator,
     loadMergerSoul: () => loadMainRoleSessionMaterials("merger"),
-    loadMergerInput: async (path) => JSON.parse(await readFile20(path, "utf8")),
+    loadMergerInput: async (path) => JSON.parse(await readFile21(path, "utf8")),
     createMergerGitState: (repositoryRoot) => createProductionMergerGitState(repositoryRoot),
     async loadCanonicalSkillBinding(name) {
       if (name === "tdd") {
@@ -26395,7 +26795,7 @@ function createAcpRoleRuntimeDependencies(packageRoot) {
       authority: options.authority,
       invocationId: options.invocationId,
       loadSoul: () => loadMainRoleSessionMaterials("navigator"),
-      loadRoutePlaybook: () => readFile20(navigatorRoutePlaybookPath, "utf8"),
+      loadRoutePlaybook: () => readFile21(navigatorRoutePlaybookPath, "utf8"),
       loadRoleHelp: async (role) => formatNavigatorRoleHelp(role),
       createSession: navigatorSessionFactory,
       ...options.contextError === void 0 ? {} : { contextError: options.contextError },