@akagilnc/pi-workflow-roles 0.1.3783 → 0.1.3795

package/dist/pi/role-turn-host.js

@@ -95,6 +95,7 @@ function buildActivationFlagArgs(activation) {
                 ...(activation.requestManifestPath === undefined
                     ? []
                     : ["--ak-collector-request-manifest", activation.requestManifestPath]),
+                ...(activation.waitMs === undefined ? [] : ["--ak-collector-wait-ms", activation.waitMs]),
             ];
         case "doctor":
             return ["--ak-role", "doctor", "--ak-doctor-case", activation.casePath];

package/dist/public-cli/invocation.js

@@ -982,6 +982,7 @@ export function parseCollectorArgv(args) {
     let repo;
     let prNumber;
     let requestManifestPath;
+    let waitWindowMs;
     const positional = [];
     const tokens = [...args];
     const definitions = roleOptions("collector");
@@ -1014,6 +1015,17 @@ export function parseCollectorArgv(args) {
                 requestManifestPath = requireOptionPath(taken.def.canonical, taken.value);
                 continue;
             }
+            if (taken.def.id === "wait-ms") {
+                if (taken.value === undefined || !/^[1-9]\d*$/.test(taken.value.trim())) {
+                    throw new CliUsageError("--wait-ms requires a positive safe-integer millisecond value");
+                }
+                const parsed = Number(taken.value.trim());
+                if (!Number.isSafeInteger(parsed) || parsed < 1) {
+                    throw new CliUsageError("--wait-ms requires a positive safe-integer millisecond value");
+                }
+                waitWindowMs = parsed;
+                continue;
+            }
             throw new CliUsageError(`unknown collector option: ${taken.def.canonical}`);
         }
         const token = tokens.shift();
@@ -1032,6 +1044,7 @@ export function parseCollectorArgv(args) {
         ...(project === undefined ? {} : { project }),
         ...(repo === undefined ? {} : { repo }),
         ...(requestManifestPath === undefined ? {} : { requestManifestPath }),
+        ...(waitWindowMs === undefined ? {} : { waitWindowMs }),
     };
 }
 /**
@@ -1168,6 +1181,7 @@ export async function admitCollectorInvocation(options) {
         repository: repository.canonical,
         repositoryDisplay: repository.display,
         ...(requestManifestPath === undefined ? {} : { requestManifestPath }),
+        ...(options.waitWindowMs === undefined ? {} : { waitWindowMs: options.waitWindowMs }),
         manifestDigest,
         attachments: attachments.map((a) => ({
             provenancePath: a.provenancePath,
@@ -1197,6 +1211,7 @@ export async function admitCollectorInvocation(options) {
         ...(prNumber === undefined ? {} : { prNumber }),
         repository,
         ...(requestManifestPath === undefined ? {} : { requestManifestPath }),
+        ...(options.waitWindowMs === undefined ? {} : { waitWindowMs: options.waitWindowMs }),
         manifestDigest,
     };
 }

package/dist/public-cli/main.js

@@ -16645,7 +16645,8 @@ function buildActivationFlagArgs(activation) {
         "--ak-collector-repo",
         activation.repo,
         ...activation.pr === void 0 ? [] : ["--ak-collector-pr", activation.pr],
-        ...activation.requestManifestPath === void 0 ? [] : ["--ak-collector-request-manifest", activation.requestManifestPath]
+        ...activation.requestManifestPath === void 0 ? [] : ["--ak-collector-request-manifest", activation.requestManifestPath],
+        ...activation.waitMs === void 0 ? [] : ["--ak-collector-wait-ms", activation.waitMs]
       ];
     case "doctor":
       return ["--ak-role", "doctor", "--ak-doctor-case", activation.casePath];
@@ -18491,6 +18492,7 @@ async function loadResumableRunRecord(home, runId, authority) {
   let repositoryDisplay;
   let requestManifestPath;
   let manifestDigest;
+  let waitWindowMs;
   let issueNumber;
   let caseRunsPath;
   let caseIdentity2;
@@ -18544,6 +18546,9 @@ async function loadResumableRunRecord(home, runId, authority) {
       if (typeof record4.manifestDigest === "string" && record4.manifestDigest.trim() !== "") {
         manifestDigest = record4.manifestDigest;
       }
+      if (typeof record4.waitWindowMs === "number" && Number.isSafeInteger(record4.waitWindowMs) && record4.waitWindowMs >= 1) {
+        waitWindowMs = record4.waitWindowMs;
+      }
       if (typeof record4.issueNumber === "number" && Number.isSafeInteger(record4.issueNumber) && record4.issueNumber >= 1) {
         issueNumber = record4.issueNumber;
       }
@@ -18659,6 +18664,7 @@ async function loadResumableRunRecord(home, runId, authority) {
       ...repositoryDisplay === void 0 ? {} : { repositoryDisplay },
       ...requestManifestPath === void 0 ? {} : { requestManifestPath },
       ...manifestDigest === void 0 ? {} : { manifestDigest },
+      ...waitWindowMs === void 0 ? {} : { waitWindowMs },
       ...issueNumber === void 0 ? {} : { issueNumber },
       ...caseRunsPath === void 0 ? {} : { caseRunsPath },
       ...caseIdentity2 === void 0 ? {} : { caseIdentity: caseIdentity2 },
@@ -18916,6 +18922,7 @@ async function loadResumableCollectorRun(home, runId, authority) {
     ...prNumber === void 0 ? {} : { prNumber },
     repository: parsedRepository,
     ...loaded.admittedFields.requestManifestPath === void 0 ? {} : { requestManifestPath: loaded.admittedFields.requestManifestPath },
+    ...loaded.admittedFields.waitWindowMs === void 0 ? {} : { waitWindowMs: loaded.admittedFields.waitWindowMs },
     manifestDigest
   };
   return seatLoadedResult(loaded, admitted);
@@ -19741,8 +19748,22 @@ 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"
+        }
+      },
+      {
+        id: "wait-ms",
+        owner: "collector",
+        canonical: "--wait-ms",
+        aliases: [],
+        valueMetavar: "ms",
+        required: false,
+        repeatable: false,
+        form: "option",
+        description: {
+          en: "Wait-window duration in milliseconds after the work step opens (default 600000 = 10 minutes). Does not require a code change to adjust.",
+          zh: "\u5DE5\u4F5C\u6B65\u9AA4\u5F00\u542F\u540E\u7684\u7B49\u5F85\u7A97\u65F6\u957F\uFF08\u6BEB\u79D2\uFF1B\u9ED8\u8BA4 600000\uFF1D\u5341\u5206\u949F\uFF09\u3002\u6539\u914D\u7F6E\u5373\u53EF\uFF0C\u65E0\u9700\u6539\u4EE3\u7801\u3002"
         }
       }
     ];
@@ -21024,6 +21045,7 @@ function parseCollectorArgv(args) {
   let repo;
   let prNumber;
   let requestManifestPath;
+  let waitWindowMs;
   const positional = [];
   const tokens = [...args];
   const definitions = roleOptions("collector");
@@ -21056,6 +21078,17 @@ function parseCollectorArgv(args) {
         requestManifestPath = requireOptionPath(taken.def.canonical, taken.value);
         continue;
       }
+      if (taken.def.id === "wait-ms") {
+        if (taken.value === void 0 || !/^[1-9]\d*$/.test(taken.value.trim())) {
+          throw new CliUsageError("--wait-ms requires a positive safe-integer millisecond value");
+        }
+        const parsed = Number(taken.value.trim());
+        if (!Number.isSafeInteger(parsed) || parsed < 1) {
+          throw new CliUsageError("--wait-ms requires a positive safe-integer millisecond value");
+        }
+        waitWindowMs = parsed;
+        continue;
+      }
       throw new CliUsageError(`unknown collector option: ${taken.def.canonical}`);
     }
     const token = tokens.shift();
@@ -21071,7 +21104,8 @@ function parseCollectorArgv(args) {
     attachmentPaths,
     ...project === void 0 ? {} : { project },
     ...repo === void 0 ? {} : { repo },
-    ...requestManifestPath === void 0 ? {} : { requestManifestPath }
+    ...requestManifestPath === void 0 ? {} : { requestManifestPath },
+    ...waitWindowMs === void 0 ? {} : { waitWindowMs }
   };
 }
 function resolveGitHubRemoteRepository(projectRoot) {
@@ -21196,6 +21230,7 @@ async function admitCollectorInvocation(options) {
     repository: repository.canonical,
     repositoryDisplay: repository.display,
     ...requestManifestPath === void 0 ? {} : { requestManifestPath },
+    ...options.waitWindowMs === void 0 ? {} : { waitWindowMs: options.waitWindowMs },
     manifestDigest,
     attachments: attachments.map((a) => ({
       provenancePath: a.provenancePath,
@@ -21225,6 +21260,7 @@ async function admitCollectorInvocation(options) {
     ...prNumber === void 0 ? {} : { prNumber },
     repository,
     ...requestManifestPath === void 0 ? {} : { requestManifestPath },
+    ...options.waitWindowMs === void 0 ? {} : { waitWindowMs: options.waitWindowMs },
     manifestDigest
   };
 }
@@ -23597,11 +23633,11 @@ var init_reviewer_dispatch_rejection = __esm({
 });
 
 // src/collector-evidence.ts
-var COLLECTOR_ELIGIBILITY_MS;
+var COLLECTOR_DEFAULT_WAIT_WINDOW_MS;
 var init_collector_evidence = __esm({
   "src/collector-evidence.ts"() {
     "use strict";
-    COLLECTOR_ELIGIBILITY_MS = 15 * 60 * 1e3;
+    COLLECTOR_DEFAULT_WAIT_WINDOW_MS = 10 * 60 * 1e3;
   }
 });
 
@@ -23613,84 +23649,14 @@ var init_collector_identity = __esm({
   }
 });
 
-// src/collector-tool-schemas.ts
-var collectorObserveArgsSchema, collectorRequestArgsSchema, collectorReadArgsSchema, collectorWaitArgsSchema, collectorBindTargetArgsSchema, collectorFindingItemDeclaration, collectorOutputBaseSchema, collectorOutputArgsSchema;
-var init_collector_tool_schemas = __esm({
-  "src/collector-tool-schemas.ts"() {
-    "use strict";
-    init_build();
-    init_collector_evidence();
-    init_open_tool_schema();
-    init_terminating_infrastructure();
-    collectorObserveArgsSchema = typebox_exports.Object({}, { additionalProperties: false });
-    collectorRequestArgsSchema = typebox_exports.Object({
-      requestId: typebox_exports.String({ minLength: 1, description: "\u914D\u7F6E\u8BF7\u6C42\u8EAB\u4EFD" }),
-      snapshotId: typebox_exports.String({ minLength: 1, description: "\u6700\u65B0\u7559\u5B58\u89C2\u5BDF\u5FEB\u7167" })
-    }, { additionalProperties: false });
-    collectorReadArgsSchema = typebox_exports.Object({
-      evidenceId: typebox_exports.String({ minLength: 1, description: "observe \u8FD4\u56DE\u7684\u6750\u6599\u8BC1\u636E id\uFF08evidenceId\uFF09" })
-    }, { additionalProperties: false });
-    collectorWaitArgsSchema = typebox_exports.Object({
-      durationMs: typebox_exports.Integer({ minimum: 1, maximum: COLLECTOR_ELIGIBILITY_MS, description: "\u7B49\u5F85\u6BEB\u79D2\uFF1B\u5355\u6B21\u4E0A\u9650\u4E94\u5206\u949F\u4E14\u4E0D\u8D85\u5269\u4F59\u8D44\u683C" })
-    }, { additionalProperties: false });
-    collectorBindTargetArgsSchema = typebox_exports.Object({
-      prNumber: typebox_exports.Optional(typebox_exports.Unknown({
-        description: "\u89D2\u8272\u5224\u5B9A\u7684\u672C\u4ED3 PR \u53F7\uFF08\u6B63\u6574\u6570\uFF09\u3002\u4E0E issueNumber \u4E8C\u9009\u4E00\u6216\u540C\u6307\u552F\u4E00\u76EE\u6807\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
-      })),
-      issueNumber: typebox_exports.Optional(typebox_exports.Unknown({
-        description: "\u89D2\u8272\u5224\u5B9A\u7684\u672C\u4ED3 issue \u53F7\uFF08\u6B63\u6574\u6570\uFF09\uFF1Bruntime \u7ECF\u7EBF\u4E0A\u5173\u8054\u89E3\u6790\u552F\u4E00 PR\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
-      }))
-    }, { additionalProperties: true });
-    collectorFindingItemDeclaration = (() => {
-      const item = typebox_exports.Object(
-        {
-          evidenceId: typebox_exports.Unknown({
-            description: "observe \u8FD4\u56DE\u7684\u6750\u6599\u6307\u9488\uFF08\u5FC5\u586B\u8BED\u4E49\uFF09"
-          }),
-          category: typebox_exports.Unknown({
-            description: "\u7B80\u77ED\u5F52\u7C7B\u6807\u7B7E\uFF0C\u4E0D\u662F\u6458\u8981"
-          }),
-          summary: typebox_exports.Unknown({
-            description: "\u54EA\u4E2A bot\u3001\u4EC0\u4E48\u95EE\u9898\u7684\u6458\u8981\uFF1B\u4E0D\u8A8A\u6284\u6B63\u6587"
-          })
-        },
-        {
-          additionalProperties: true,
-          description: "\u5355\u6761 finding \u6307\u9488\uFF1AevidenceId + \u53EF\u9009 category/summary\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
-        }
-      );
-      item.required = [];
-      return item;
-    })();
-    collectorOutputBaseSchema = openToolObject(
-      typebox_exports.Object({
-        // No root type:array — host must not shape-reject non-array findings (#676 C).
-        // Nested item declarations ride `items` for registration preservation (ADR 0057).
-        findings: typebox_exports.Unsafe({
-          description: "\u672C\u6B21\u6536\u96C6\u5230\u7684\u9010\u6761 findings\uFF08\u6307\u9488\u6570\u7EC4\u4E3A\u89C4\u8303\u5F62\uFF09\u3002\u96F6 finding \u7684\u6A21\u677F\u901A\u77E5\u4E0D\u5F97\u8FDB\u5165\uFF1B\u6B63\u5E38\u5B8C\u5DE5\u65E0 finding \u65F6\u7701\u7565\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002",
-          items: collectorFindingItemDeclaration
-        }),
-        unfinishedReasons: typebox_exports.Unknown({
-          description: "\u672A\u5B8C\u6210\u539F\u56E0\u5B57\u7B26\u4E32\u6570\u7EC4\uFF08\u989D\u5EA6/\u6545\u969C/\u7B49\u5F85\u5C4A\u6EE1\u7B49\u73B0\u573A\u4F9D\u636E\uFF09\uFF1B\u4E0D\u5F97\u628A\u672A\u5B8C\u6210\u8868\u8FF0\u4E3A\u65E0\u95EE\u9898\u3002\u65E0\u53EF\u62A5\u544A\u65F6\u7701\u7565\u3002\u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8\u3002"
-        })
-      })
-    );
-    collectorOutputArgsSchema = withInfrastructureFailureDeclaration(
-      collectorOutputBaseSchema
-    );
-  }
-});
-
 // src/collector-ledger.ts
 var COLLECTOR_OBSERVE_TOOL, COLLECTOR_READ_TOOL, COLLECTOR_REQUEST_TOOL, COLLECTOR_WAIT_TOOL, COLLECTOR_BIND_TARGET_TOOL;
 var init_collector_ledger = __esm({
   "src/collector-ledger.ts"() {
     "use strict";
-    init_value2();
     init_collector_evidence();
     init_collector_github();
     init_collector_identity();
-    init_collector_tool_schemas();
     init_collector_output();
     COLLECTOR_OBSERVE_TOOL = "ak_collector_observe";
     COLLECTOR_READ_TOOL = "ak_collector_read";
@@ -28019,7 +27985,8 @@ function buildCollectorTurnRequest(admitted, options) {
         repo: admitted.repository.display,
         // #676 A: omit pr when unbound — role binds via ak_collector_bind_target.
         ...admitted.prNumber === void 0 ? {} : { pr: String(admitted.prNumber) },
-        ...admitted.requestManifestPath === void 0 ? {} : { requestManifestPath: admitted.requestManifestPath }
+        ...admitted.requestManifestPath === void 0 ? {} : { requestManifestPath: admitted.requestManifestPath },
+        ...admitted.waitWindowMs === void 0 ? {} : { waitMs: String(admitted.waitWindowMs) }
       }
     },
     options
@@ -28039,6 +28006,7 @@ async function runPublicCollector(argv, env, io, parseCollectorArgv2) {
       ...parsed.project === void 0 ? {} : { project: parsed.project },
       ...parsed.repo === void 0 ? {} : { repo: parsed.repo },
       ...parsed.requestManifestPath === void 0 ? {} : { requestManifestPath: parsed.requestManifestPath },
+      ...parsed.waitWindowMs === void 0 ? {} : { waitWindowMs: parsed.waitWindowMs },
       ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId },
       ...env.model === void 0 ? {} : { model: env.model }
     });

package/dist/public-cli/option-definitions.js

@@ -483,8 +483,22 @@ const COLLECTOR_OPTIONS = [
         repeatable: false,
         form: "option",
         description: {
-            en: "Optional request manifest JSON path ({requests:[{id,body}]}).",
-            zh: "可选 request manifest JSON 路径（{requests:[{id,body}]}）。",
+            en: "Optional request manifest JSON path ({requests:[{id,body}]}). Role may also decide request bodies from handbook/field activity without this file.",
+            zh: "可选 request manifest JSON 路径（{requests:[{id,body}]}）。角色亦可依手册/现场自行判定请求正文，不必依赖本文件。",
+        },
+    },
+    {
+        id: "wait-ms",
+        owner: "collector",
+        canonical: "--wait-ms",
+        aliases: [],
+        valueMetavar: "ms",
+        required: false,
+        repeatable: false,
+        form: "option",
+        description: {
+            en: "Wait-window duration in milliseconds after the work step opens (default 600000 = 10 minutes). Does not require a code change to adjust.",
+            zh: "工作步骤开启后的等待窗时长（毫秒；默认 600000＝十分钟）。改配置即可，无需改代码。",
         },
     },
 ];

package/dist/public-cli/run-lifecycle.js

@@ -880,6 +880,7 @@ async function loadResumableRunRecord(home, runId, authority) {
     let repositoryDisplay;
     let requestManifestPath;
     let manifestDigest;
+    let waitWindowMs;
     let issueNumber;
     let caseRunsPath;
     let caseIdentity;
@@ -934,6 +935,9 @@ async function loadResumableRunRecord(home, runId, authority) {
             if (typeof record.manifestDigest === "string" && record.manifestDigest.trim() !== "") {
                 manifestDigest = record.manifestDigest;
             }
+            if (typeof record.waitWindowMs === "number" && Number.isSafeInteger(record.waitWindowMs) && record.waitWindowMs >= 1) {
+                waitWindowMs = record.waitWindowMs;
+            }
             // Doctor — admitted single-case identity (#633 resume).
             if (typeof record.issueNumber === "number" && Number.isSafeInteger(record.issueNumber) && record.issueNumber >= 1) {
                 issueNumber = record.issueNumber;
@@ -1074,6 +1078,7 @@ async function loadResumableRunRecord(home, runId, authority) {
             ...(repositoryDisplay === undefined ? {} : { repositoryDisplay }),
             ...(requestManifestPath === undefined ? {} : { requestManifestPath }),
             ...(manifestDigest === undefined ? {} : { manifestDigest }),
+            ...(waitWindowMs === undefined ? {} : { waitWindowMs }),
             ...(issueNumber === undefined ? {} : { issueNumber }),
             ...(caseRunsPath === undefined ? {} : { caseRunsPath }),
             ...(caseIdentity === undefined ? {} : { caseIdentity }),
@@ -1338,6 +1343,9 @@ export async function loadResumableCollectorRun(home, runId, authority) {
         ...(loaded.admittedFields.requestManifestPath === undefined
             ? {}
             : { requestManifestPath: loaded.admittedFields.requestManifestPath }),
+        ...(loaded.admittedFields.waitWindowMs === undefined
+            ? {}
+            : { waitWindowMs: loaded.admittedFields.waitWindowMs }),
         manifestDigest,
     };
     return seatLoadedResult(loaded, admitted);

package/dist/role-runtime.js

@@ -1223,6 +1223,9 @@ export function createRoleRuntimeExtension(dependencies) {
             ...(dependencies.createCollectorClock === undefined
                 ? {}
                 : { createClock: dependencies.createCollectorClock }),
+            ...(dependencies.loadCollectorHandbookSeed === undefined
+                ? {}
+                : { loadHandbookSeed: dependencies.loadCollectorHandbookSeed }),
         }, hostActions);
         // #676 J1: business tools + tool_call gate register only behind admission/activation.
         // before_agent_start / tool_result collector branches live on the shared envelope hooks above.

package/extensions/role-runtime.ts

@@ -40,6 +40,7 @@ import { loadGatekeeperSessionMaterials, loadMainRoleSessionMaterials } from "..
 const extensionPath = fileURLToPath(import.meta.url);
 const packageRoot = fileURLToPath(new URL("..", import.meta.url));
 const navigatorRoutePlaybookPath = fileURLToPath(new URL("../resources/navigator-route-playbook.md", import.meta.url));
+const collectorHandbookSeedPath = fileURLToPath(new URL("../resources/collector-bot-handbook.md", import.meta.url));
 // #675: nested public summons (gate/auditor) resolve root via env under jiti.
 if (process.env.AK_ROLE_PACKAGE_ROOT === undefined || process.env.AK_ROLE_PACKAGE_ROOT.trim() === "") {
   process.env.AK_ROLE_PACKAGE_ROOT = packageRoot;
@@ -122,6 +123,7 @@ export default function roleRuntime(pi: ExtensionAPI): void {
     createReviewerPinnedGitReader: () => createReviewerPinnedGitReader(),
     createReviewerIssueFetcher: () => createGhIssueSoftFetcher(),
     loadCollectorSoul: () => loadMainRoleSessionMaterials("collector"),
+    loadCollectorHandbookSeed: () => readFile(collectorHandbookSeedPath, "utf8"),
     createCollectorTransport: () => createGhCollectorGitHubTransport(),
     loadDoctorSoul: () => loadMainRoleSessionMaterials("doctor"),
     loadDoctorCase,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.3783",
+  "version": "0.1.3795",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",

package/resources/collector-bot-handbook.md

@@ -0,0 +1,33 @@
+# 通进司 bot 工作记忆（通用）
+
+薄手册：触发方式、自动/手动条件、完成与不可继续的识别线索、官方出处。
+内容是角色阅读与修正的工作记忆，不是代码状态规则；临时额度/故障不得固化为永久行为。
+参与者依本仓使用与现场活动辨认，不把下列名称当作全仓固定名单。
+
+## Codex（hosted GitHub connector）
+
+- 官方：https://learn.chatgpt.com/docs/third-party/github
+- 常见主动请求：`@codex review`
+- 新建 PR 常有自动评审；是否已在审当前提交以现场 reviews/comments 为准
+
+## CodeRabbit
+
+- 官方：https://docs.coderabbit.ai/configuration/auto-review
+- 命令：https://docs.coderabbit.ai/guides/commands
+- 常见主动请求：`@coderabbitai review`；全量：`@coderabbitai full review`
+- 默认常为增量；本仓实际自动/暂停以现场与仓库差异条为准
+
+## Sourcery
+
+- 官方：https://docs.sourcery.ai/reviews/ 与 https://docs.sourcery.ai/reviews/commands/
+- 新建/更新与主动请求依文档与本仓现场
+
+## Cursor Bugbot / 自动化
+
+- 官方：https://prod.cursor.com/help/ai-features/bugbot 与 automations 文档
+- 内置 Bugbot 与同账号自定义任务须区分；某任务额度耗尽不推断其他任务失效
+
+## 修正规则
+
+- 优先引用官方文档；现场差异记入仓库差异条并附 PR/证据指针
+- 未知或暂未响应 ≠ 通过或确定死亡

package/src/acp-host/production-host.ts

@@ -39,6 +39,9 @@ export type ProductionAcpHostOptions = Readonly<{
 const navigatorRoutePlaybookPath = fileURLToPath(
   new URL("../../resources/navigator-route-playbook.md", import.meta.url),
 );
+const collectorHandbookSeedPath = fileURLToPath(
+  new URL("../../resources/collector-bot-handbook.md", import.meta.url),
+);
 
 /** Host-neutral packaged role runtime deps for the ACP parent-process envelope. */
 export function createAcpRoleRuntimeDependencies(packageRoot: string): RoleRuntimeDependencies {
@@ -55,6 +58,7 @@ export function createAcpRoleRuntimeDependencies(packageRoot: string): RoleRunti
     createReviewerPinnedGitReader: () => createReviewerPinnedGitReader(),
     createReviewerIssueFetcher: () => createGhIssueSoftFetcher(),
     loadCollectorSoul: () => loadMainRoleSessionMaterials("collector"),
+    loadCollectorHandbookSeed: () => readFile(collectorHandbookSeedPath, "utf8"),
     createCollectorTransport: () => createGhCollectorGitHubTransport(),
     loadDoctorSoul: () => loadMainRoleSessionMaterials("doctor"),
     loadDoctorCase,

package/src/acp-host/role-envelope.ts

@@ -98,6 +98,7 @@ export function projectAcpActivationFlags(request: RoleTurnRequest): Map<string,
     // #676 D1: pr optional at admission; omit flag when role binds from materials.
     if (activation.pr !== undefined) flags.set("ak-collector-pr", activation.pr);
     if (activation.requestManifestPath !== undefined) flags.set("ak-collector-request-manifest", activation.requestManifestPath);
+    if (activation.waitMs !== undefined) flags.set("ak-collector-wait-ms", activation.waitMs);
   }
   return flags;
 }

package/src/collector-evidence.ts

@@ -11,7 +11,8 @@ import type {
   GitHubUser,
 } from "./collector-github.ts";
 
-export const COLLECTOR_ELIGIBILITY_MS = 15 * 60 * 1000;
+/** Default collector wait window (D4): 10 minutes from the work-step open, not from session activation. */
+export const COLLECTOR_DEFAULT_WAIT_WINDOW_MS = 10 * 60 * 1000;
 
 export type WindowRelation = "before" | "within" | "after" | "uncertain";
 export type HeadRelation = "current" | "prior";
@@ -73,6 +74,8 @@ export type CollectorSnapshot = {
   prNumber: number;
   prState: string;
   headOid: string;
+  /** PR create success time when GitHub supplies it (#678 new-PR wait start). */
+  prCreatedAt?: string;
   complete: boolean;
   evidenceIds: string[];
   pageDiagnostics: GitHubPageDiagnostics[];
@@ -177,6 +180,7 @@ export function normalizePullRequestEvidence(
     number: pr.number,
     state: pr.state,
     headOid: pr.headOid,
+    createdAt: pr.createdAt ?? null,
     updatedAt: pr.updatedAt ?? null,
     htmlUrl: pr.url,
   });
@@ -190,6 +194,7 @@ export function normalizePullRequestEvidence(
     state: pr.state,
     commitOid: pr.headOid,
     htmlUrl: pr.url,
+    // Version clock stays updatedAt. Create success for the wait window is snapshot.prCreatedAt only (#678).
     authoritativeTime: pr.updatedAt ?? null,
     firstObservedAt: observedAt,
     raw: pr.raw,

package/src/collector-github.ts

@@ -7,6 +7,8 @@ export type GitHubPullRequest = {
   number: number;
   state: string;
   headOid: string;
+  /** GitHub PR created_at — work-step start for new-PR auto-trigger rounds (#678 D4). */
+  createdAt?: string;
   updatedAt?: string;
   url: string;
   raw: unknown;
@@ -491,6 +493,7 @@ export function normalizePullRequest(raw: unknown): GitHubPullRequest {
     number,
     state,
     headOid: head["sha"],
+    ...(typeof raw["created_at"] === "string" ? { createdAt: raw["created_at"] } : {}),
     ...(typeof raw["updated_at"] === "string" ? { updatedAt: raw["updated_at"] } : {}),
     url: htmlUrl,
     raw,