botmux 3.9.1 → 3.9.2

package/dist/platform/issue-client.js

@@ -0,0 +1,142 @@
+/**
+ * 平台 Issue Board 的 machine-auth 客户端（打 `/v1/machine/*`，Bearer = machineToken）。
+ *
+ * 平台侧入口见 platform 仓 `src/server/machine-issues-http.ts` / DESIGN-issue-board.md §三之二。
+ * 只有五个端点：teams / issues(list) / claim / bind / status。创建、编辑、force-detach、
+ * 归档是**人的决策**，只在平台 Web 上做，这里没有也不该有。
+ *
+ * 鉴权材料全部来自 `~/.botmux/platform.json`（[[platform/binding]]）：未绑定平台时所有调用
+ * 直接返回 `{ ok:false, reason:'unbound' }`，调用方据此把整个 issue board 功能关掉。
+ *
+ * 错误分型是这层的重点——上层 outbox pump 要据此决定「退避重试」还是「就此打住」：
+ *  - `network`  ：连不上/超时 → **必须重试**（daemon 离线期间状态照样变，回来要补上）
+ *  - `conflict` ：平台返回 409（state_rev_conflict / stale_epoch / claim_expired…）
+ *                 → 重新投影后再发，不是简单重试
+ *  - `forbidden`：401/403（token 失效、解绑、machine_mismatch）→ **停手**，重试无意义
+ *  - `server`   ：5xx → 退避重试（含平台 ByteDoc 降级的 503）
+ */
+import { getJson, postJson } from './platform-http.js';
+import { readPlatformBinding } from './binding.js';
+/**
+ * 该失败是否值得退避后重投。
+ *
+ * 只有 `network` 与**真正的 5xx** 值得：4xx 全都是「再发一次结果不变」——401/403 是凭证/
+ * 归属问题，409 要先重新投影再发（不是盲重试），400/404 是请求本身错了。把它们混进可重试
+ * 一类，pump 会对着一个永远不会成功的请求指数退避到天荒地老，日志里还只看得到"在重试"。
+ */
+export function isRetriable(f) {
+    return f.reason === 'network' || (f.reason === 'server' && f.status >= 500);
+}
+/**
+ * 这次失败是否**永远**不会成功——发件箱据此把行标 fatal，彻底停止重投。
+ *
+ * 注意它**不是** `!isRetriable`，那两个的补集差着两类，混用会把好行判死：
+ *  - `conflict`（409）：是竞争不是错误。上层先重新对账再重发，对账本身可能因为网络问题
+ *    没做成，此时判死等于把一条完全正常的回写扔了。留给下一轮。
+ *  - `unbound`：本机当前没绑平台。绑回来之后这条行照样该发，判死就再也发不出去了。
+ *
+ * 剩下的两类才是真死：`forbidden`（401/403，凭证失效 / machine_mismatch / claim 被 revoke）
+ * 与 `client`（400 参数错 / 404 issue 被删或归档）。对它们退避重投，就是每 5 分钟朝一个
+ * 永远不会变的死端点打一发，同时 `/issue status` 上那句「N 条回写没发出去」永不清零。
+ */
+export function isPermanentFailure(f) {
+    return f.reason === 'forbidden' || f.reason === 'client';
+}
+function resolveBinding(opts) {
+    if (opts.binding !== undefined)
+        return opts.binding;
+    const b = readPlatformBinding();
+    return b ? { platformUrl: b.platformUrl, machineToken: b.machineToken, machineId: b.machineId } : null;
+}
+function classify(status, json) {
+    const error = typeof json?.error === 'string' ? String(json.error) : `http_${status}`;
+    if (status === 401 || status === 403)
+        return { ok: false, reason: 'forbidden', status, error };
+    if (status === 409)
+        return { ok: false, reason: 'conflict', status, error };
+    // 其余 4xx 单列一类：既不是鉴权问题（别误导排查方向），也绝不该被重试。
+    if (status >= 400 && status < 500)
+        return { ok: false, reason: 'client', status, error };
+    return { ok: false, reason: 'server', status, error };
+}
+async function call(opts, method, path, body, pick = (j) => j) {
+    const binding = resolveBinding(opts);
+    if (!binding)
+        return { ok: false, reason: 'unbound' };
+    const http = opts.http ?? { get: getJson, post: postJson };
+    const url = `${binding.platformUrl.replace(/\/+$/, '')}${path}`;
+    const reqOpts = {
+        headers: { authorization: `Bearer ${binding.machineToken}` },
+        ...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+    };
+    let res;
+    try {
+        res = method === 'GET' ? await http.get(url, reqOpts) : await http.post(url, body ?? {}, reqOpts);
+    }
+    catch (e) {
+        return { ok: false, reason: 'network', error: String(e?.message ?? e) };
+    }
+    // 2xx 之外一律走分型；平台的成功响应恒为 200。
+    if (res.status < 200 || res.status >= 300)
+        return classify(res.status, res.json);
+    return { ok: true, value: pick(res.json) };
+}
+/** 本机 owner 所属的平台团队。注意：日常判断「本机在不在团队里」应读本地
+ *  `platform-team-sync.json`（[[platform-team-store]]），这个接口是不依赖 team-sync
+ *  是否已收敛的权威兜底。 */
+export function fetchTeams(opts = {}) {
+    return call(opts, 'GET', '/v1/machine/teams', undefined, (j) => (Array.isArray(j?.teams) ? j.teams : []));
+}
+export function fetchIssues(teamId, opts = {}) {
+    return call(opts, 'GET', `/v1/machine/issues?teamId=${encodeURIComponent(teamId)}`, undefined, (j) => (j?.sections ?? { needsAttention: [], todo: [], inProgress: [], inReview: [], done: [] }));
+}
+/**
+ * 按 id 单查一条 issue。
+ *
+ * 平台**没有**「按 id 单查」的机器接口，只能从分段列表里捞——这是唯一的实现方式，所以收口
+ * 在这里，别让每个调用方各抄一遍（回写的 409 对账、领取确认、交付都要用它）。
+ *
+ * 返回 null 有两种含义且**无法区分**：拉列表失败，或 issue 不在活跃分段里（已归档）。
+ * 调用方一律按「无法判定」处理，不要把 null 当成「平台上没有/不是我的」——那会让
+ * 409 对账做出相反的决定。
+ */
+export async function findIssueById(teamId, issueId, opts = {}) {
+    const list = await fetchIssues(teamId, opts);
+    if (!list.ok)
+        return null;
+    for (const section of Object.values(list.value)) {
+        const hit = section.find((i) => i._id === issueId);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+/**
+ * 领取。`claimId` 必须是**高熵随机**（`crypto.randomBytes(16).toString('hex')`），
+ * 绝不能由 issueId 派生——平台的幂等分支现在会连 machineId/unionId 一起校验，派生键在
+ * 多机场景下会直接撞 409 `already_claimed`（早失败，好过静默把别人的 claim 当成自己的）。
+ *
+ * `machineId` 不用传：平台以 token 为准（传了且不一致会 403 machine_mismatch）。
+ */
+export function claimIssue(issueId, args, opts = {}) {
+    return call(opts, 'POST', `/v1/machine/issues/${encodeURIComponent(issueId)}/claim`, args);
+}
+/**
+ * 绑定本地任务。`localTaskRef` = `<anchorId>::<larkAppId>`（见 [[issue-board-store]] 的
+ * `buildLocalTaskRef`）。
+ *
+ * `localTaskLabel` / `localTaskUrl` 是**纯展示**的可选项：前者给人看（群名），后者是点进去
+ * 的深链。平台只接受 https 深链，其余静默丢弃且**不会**让 bind 失败——展示字段不该有能力
+ * 弄砸一次真实绑定。
+ */
+export function bindIssue(issueId, args, opts = {}) {
+    return call(opts, 'POST', `/v1/machine/issues/${encodeURIComponent(issueId)}/bind`, args);
+}
+/**
+ * 状态回写。幂等只认 `sourceSeq`（每 binding 单调、串行发送），所以同一条 outbox 行重发
+ * 是安全的：平台见到 `sourceSeq <= lastSourceSeq` 直接回当前态、零副作用。
+ */
+export function writeIssueStatus(issueId, args, opts = {}) {
+    return call(opts, 'POST', `/v1/machine/issues/${encodeURIComponent(issueId)}/status`, args);
+}
+//# sourceMappingURL=issue-client.js.map

package/dist/platform/issue-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-client.js","sourceRoot":"","sources":["../../src/platform/issue-client.ts"],"names":[],"mappings":"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"}

package/dist/platform/platform-http.d.ts

@@ -6,6 +6,10 @@ export interface PostJsonOptions {
     /** 强制 IP 协议族：4 / 6；缺省跟随系统默认解析（含 net 层 happy-eyeballs）。 */
     family?: 4 | 6;
     timeoutMs?: number;
+    /** 附加请求头（如 `Authorization: Bearer <machineToken>`）。不能覆盖 content-* 两个。 */
+    headers?: Record<string, string>;
 }
 export declare function postJson(url: string, body: unknown, opts?: PostJsonOptions): Promise<PostJsonResult>;
+/** 同 {@link postJson} 的连接口径（含 family 钉死），只是不带请求体的 GET。 */
+export declare function getJson(url: string, opts?: PostJsonOptions): Promise<PostJsonResult>;
 //# sourceMappingURL=platform-http.d.ts.map

package/dist/platform/platform-http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-http.d.ts","sourceRoot":"","sources":["../../src/platform/platform-http.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmCxG"}
+{"version":3,"file":"platform-http.d.ts","sourceRoot":"","sources":["../../src/platform/platform-http.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqCxG;AAED,0DAA0D;AAC1D,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAkCxF"}

package/dist/platform/platform-http.js

@@ -5,7 +5,7 @@
 import { request as httpsRequest } from 'node:https';
 import { request as httpRequest } from 'node:http';
 export function postJson(url, body, opts = {}) {
-    const { family, timeoutMs = 10_000 } = opts;
+    const { family, timeoutMs = 10_000, headers } = opts;
     const u = new URL(url);
     const doRequest = u.protocol === 'https:' ? httpsRequest : httpRequest;
     const payload = Buffer.from(JSON.stringify(body), 'utf8');
@@ -17,7 +17,9 @@ export function postJson(url, body, opts = {}) {
             method: 'POST',
             family,
             timeout: timeoutMs,
-            headers: { 'content-type': 'application/json', 'content-length': payload.length },
+            // content-* 放在扩展头之后：调用方传错 content-length 会让请求体被截断/挂死，
+            // 这两个必须由本函数说了算。
+            headers: { ...headers, 'content-type': 'application/json', 'content-length': payload.length },
         }, (res) => {
             const chunks = [];
             res.on('data', (c) => chunks.push(c));
@@ -38,4 +40,38 @@ export function postJson(url, body, opts = {}) {
         req.end(payload);
     });
 }
+/** 同 {@link postJson} 的连接口径（含 family 钉死），只是不带请求体的 GET。 */
+export function getJson(url, opts = {}) {
+    const { family, timeoutMs = 10_000, headers } = opts;
+    const u = new URL(url);
+    const doRequest = u.protocol === 'https:' ? httpsRequest : httpRequest;
+    return new Promise((resolve, reject) => {
+        const req = doRequest({
+            host: u.hostname,
+            port: u.port || (u.protocol === 'https:' ? 443 : 80),
+            path: `${u.pathname}${u.search}`,
+            method: 'GET',
+            family,
+            timeout: timeoutMs,
+            headers: { ...headers, accept: 'application/json' },
+        }, (res) => {
+            const chunks = [];
+            res.on('data', (c) => chunks.push(c));
+            res.on('end', () => {
+                let json = {};
+                try {
+                    json = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+                }
+                catch {
+                    /* 非 JSON 响应按空对象处理，调用方看 status */
+                }
+                resolve({ status: res.statusCode || 0, json });
+            });
+            res.on('error', reject);
+        });
+        req.on('timeout', () => req.destroy(new Error(`连接超时（${timeoutMs}ms）`)));
+        req.on('error', reject);
+        req.end();
+    });
+}
 //# sourceMappingURL=platform-http.js.map

package/dist/platform/platform-http.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform-http.js","sourceRoot":"","sources":["../../src/platform/platform-http.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,wDAAwD;AACxD,2DAA2D;AAC3D,gDAAgD;AAChD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAanD,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAa,EAAE,OAAwB,EAAE;IAC7E,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5C,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;IACvE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,SAAS,CACnB;YACE,IAAI,EAAE,CAAC,CAAC,QAAQ;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,IAAI,EAAE,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,MAAM;YACN,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,OAAO,CAAC,MAAM,EAAE;SAClF,EACD,CAAC,GAAG,EAAE,EAAE;YACN,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,IAAI,IAAI,GAAY,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC5D,CAAC;gBAAC,MAAM,CAAC;oBACP,iCAAiC;gBACnC,CAAC;gBACD,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC,CACF,CAAC;QACF,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC;QACxE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"platform-http.js","sourceRoot":"","sources":["../../src/platform/platform-http.ts"],"names":[],"mappings":"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"}

package/dist/services/issue-board-store.d.ts

@@ -0,0 +1,214 @@
+/**
+ * localTaskRef 的**唯一**构造入口，且 `createBinding` 会自己调它——`CreateBindingInput`
+ * 里没有 localTaskRef 字段，调用方**没有**手拼的机会。
+ *
+ * 之所以做成内生而不是「约定调用方用这个函数」：拼反了顺序不会当场报错，要等平台 bind
+ * 记下的 localTaskRef 与崩溃恢复时的重确认对不上，那条 held 会话被判 claim_mismatch 作废
+ * 才暴露——离出错点太远。直接复用 botmux 自己的 `sessionKey`，与 activeSessions 键同源。
+ */
+export declare function buildLocalTaskRef(anchorId: string, larkAppId: string): string;
+/** 平台 IssueStatus 的线上取值（回写目标只用得到其中一部分，但解析要认全）。 */
+export type IssueStatus = 'open' | 'claimed' | 'in_progress' | 'in_review' | 'done' | 'cancelling' | 'needs_attention' | 'reopened';
+export type AttentionReason = 'cancel_delivery_timeout' | 'claim_activate_timeout' | 'task_blocked' | 'run_timeout';
+/**
+ * 一条 issue ↔ 本机会话的绑定。
+ *
+ * `bindState` 对应 §六 的崩溃恢复分支，外加一个人为终态：
+ *  - `pending` ：claim 成功、binding 已落盘，但还没向平台 bind（群可能还没建出来）
+ *  - `bound`   ：平台已接受 bind，本地会话可以 activate（发 kickoff @ bot）
+ *  - `void`    ：补 bind 被平台拒（issue 被回收 / 别人领走 / 代次过期），这条作废
+ *  - `released`：人主动释放（[[issue-release]]），issue 已退回平台待领取池
+ *  - `done`    ：人验收通过（`/issue done`），平台已终结这条 issue
+ *
+ * 三个终态都不再回写，但**不能合并**：`void` 是"平台不认这次领取"，对账见到它要考虑群是不是
+ * 白建了；`released` 是"领取本来是好的，人不做了"，群里有正经的工作记录，对账不该去动它；
+ * `done` 是"活干完并且验收了"。区分开也让日志能说清一个群到底是怎么结束的。
+ *
+ * 加终态时只改 `isActiveBindState` 一处——散落的 `!== 'void'` 式判断漏改一处，就会出现
+ * 「已结束的 issue 仍被当成本机持有」，而且全程不报错。
+ */
+export interface IssueBinding {
+    /**
+     * **路由锚点**——主键，也是平台契约里的「本地任务」标识。
+     *
+     * 这里必须是 anchor 而**不是** botmux 的 session id：协议要求 bind（带 localTaskRef）
+     * 发生在 activate 之前，而 botmux 的会话是 kickoff 消息把 bot @ 起来之后才由 daemon
+     * 创建的——bind 那一刻根本还没有 session id。anchor 则在 kickoff 之前就存在：
+     *  - 拉群模式 → `chatId`（chat-scope 会话的路由键，建群即得）
+     *  - 话题模式 → `rootMessageId`（先发无 @ 的 seed 拿到，再发 threaded kickoff）
+     * 见 core/types.ts 的 `sessionAnchorId` / `sessionKey`。
+     */
+    anchorId: string;
+    /** 平台契约的 localTaskRef，取值就是 botmux 自己的 `sessionKey(anchorId, larkAppId)`
+     *  = `<anchorId>::<larkAppId>`。复用它而不是另造一套：它本来就是本仓跨 bot 的规范会话
+     *  身份，且 `om_`（消息）与 `oc_`（群）两个地址空间不会碰撞。 */
+    localTaskRef: string;
+    larkAppId: string;
+    issueId: string;
+    teamId: string;
+    /** 绑到哪个平台（换绑/多平台时区分该往哪回写）。 */
+    platformBaseUrl: string;
+    /** 领取幂等键，必须是高熵随机（禁止由 issueId 派生）。全表唯一。 */
+    claimId: string;
+    /** 领取代次快照——回写栅栏，旧代次的迟到回写会被平台按 stale_epoch 丢弃。 */
+    claimEpoch: number;
+    bindState: 'pending' | 'bound' | 'void' | 'released' | 'done';
+    /** 会话所在的群。拉群模式下 === anchorId；话题模式下是承载话题的那个群。
+     *  崩溃恢复据此复用已建的群而不是再建一个。 */
+    chatId?: string;
+    /** 会话作用域：拉群 → 'chat'（一群一 issue 一会话）；话题 → 'thread'。 */
+    scope: 'chat' | 'thread';
+    /** 本 binding 的 sourceSeq 分配计数器：单调、每 binding 唯一，平台的线上幂等只认它。 */
+    nextSourceSeq: number;
+    /** 已成功回写的状态（离线期间不动——去重合并要拿它和「最新未完成目标」一起比）。 */
+    lastSyncedStatus?: IssueStatus;
+    /** 上次回写后平台返回的 issue.stateRev，下次状态 CAS 用。 */
+    platformStateRev?: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface IssueOutboxRow {
+    /** 仅本地行主键（去重发送用），不上送平台——平台幂等只认 sourceSeq。 */
+    writeId: string;
+    anchorId: string;
+    sourceSeq: number;
+    targetStatus: IssueStatus;
+    attentionReason?: AttentionReason;
+    claimId: string;
+    claimEpoch: number;
+    expectedStateRev?: number;
+    state: 'pending' | 'inflight' | 'done' | 'failed';
+    attempts: number;
+    nextRetryAt?: number;
+    lastError?: string;
+    createdAt: number;
+}
+export declare function listBindings(dataDir: string): IssueBinding[];
+export declare function getBinding(dataDir: string, anchorId: string): IssueBinding | null;
+/**
+ * 这条 binding 是否还代表「本机正持有这个 issue」。
+ *
+ * 抽成一个谓词而不是到处写 `!== 'void'`：终态从一个变成两个（`void` / `released`）时，
+ * 散落各处的判断只要漏改一处，就会出现「已释放的 issue 仍被当成已领取」——重领被拦、
+ * 回写继续发，而且全程不报错。加状态就改这一个地方。
+ */
+export declare function isActiveBindState(state: IssueBinding['bindState']): boolean;
+/** 按 claimId 反查——崩溃恢复的入口（§六：不依赖平台「按 claimId 查 issue」的接口，那个接口不存在）。 */
+export declare function findBindingByClaimId(dataDir: string, claimId: string): IssueBinding | null;
+/** 某 issue 当前在本机的活跃 binding（作废/已释放的不算）。用于「这个 issue 是不是我已经领了」。 */
+export declare function findActiveBindingByIssue(dataDir: string, issueId: string): IssueBinding | null;
+export interface IssueClaimIntent {
+    /** 主键。高熵随机，与平台 claim 用的是同一个值。 */
+    claimId: string;
+    issueId: string;
+    teamId: string;
+    claimEpoch: number;
+    platformBaseUrl: string;
+    /** 平台 claim 返回的 stateRev，后续 bind 的 CAS 基线。 */
+    platformStateRev: number;
+    /** 这个 issue 交给哪个 bot 跑（决定 localTaskRef 的 appId 段）。 */
+    larkAppId: string;
+    scope: 'chat' | 'thread';
+    /**
+     * 建群/发 seed 拿到 anchor 后回填。它出现 = 群已存在，对账时**不要再建一个**。
+     * 注意这份回填本身也可能崩在中间，所以对账不能只信它，还要按 claimId 去群里反查。
+     */
+    anchorId?: string;
+    chatId?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export declare function listClaimIntents(dataDir: string): IssueClaimIntent[];
+export declare function getClaimIntent(dataDir: string, claimId: string): IssueClaimIntent | null;
+/**
+ * 记下一次领取意图。**必须在 platform claim 返回成功后立刻调用，早于任何建群动作**。
+ *
+ * 同 claimId 重入返回既有记录（claim 本身幂等，重试不该产生第二条意图）。
+ */
+export declare function recordClaimIntent(dataDir: string, input: Omit<IssueClaimIntent, 'createdAt' | 'updatedAt'>, now?: number): IssueClaimIntent;
+/** 回填 anchorId / chatId（建群成功后）。 */
+export declare function updateClaimIntent(dataDir: string, claimId: string, patch: Partial<Omit<IssueClaimIntent, 'claimId' | 'createdAt'>>, now?: number): IssueClaimIntent | null;
+/**
+ * 领取流程走完（binding 已 bound）后清掉意图——此后 binding 自己就是完整证据。
+ *
+ * ⚠️ 清除必须**晚于** binding 落盘。反过来先清意图再写 binding，中间崩溃就同时丢掉了两份
+ * 证据，那个群彻底认不回来——这正是意图存在的意义。
+ */
+export declare function clearClaimIntent(dataDir: string, claimId: string): boolean;
+/** 对账分类：意图还在、但没有对应 binding 的，就是需要人/流程接手的悬空领取。 */
+export declare function listDanglingClaimIntents(dataDir: string): IssueClaimIntent[];
+/** 注意没有 `localTaskRef`：它由 `buildLocalTaskRef(anchorId, larkAppId)` 内生，见上。 */
+export type CreateBindingInput = Omit<IssueBinding, 'nextSourceSeq' | 'createdAt' | 'updatedAt' | 'bindState' | 'localTaskRef'> & {
+    bindState?: IssueBinding['bindState'];
+};
+/**
+ * 写入一条 pending binding。**在建群/发 seed 拿到 anchorId 之后调用**——主键就是那个
+ * anchor，之前不可能有。放在 `createGroupWithBots` 的 `onChatCreated` 同步钩子里写，
+ * 让它成为「群已存在」到「群已归属某个 issue」之间的 durable boundary（见文件头时序）。
+ *
+ * 两条不变式都在这层强制，不指望调用方自觉：
+ *  - **claimId 唯一**：同 claimId 重入直接返回既有行（本地幂等，对应 Desktop 侧的
+ *    `UNIQUE(claim_id)`）——领取重试不会产生第二条 binding、也不会重复建群。
+ *  - **一 issue 一活跃 binding**：同 issue 已有非 void 的 binding 却拿着不同 claimId 进来，
+ *    是调用方漏查（比如没先 `findActiveBindingByIssue`）。此时**抛错**而不是照写——写下去
+ *    就是同一个 issue 两个群、两个 agent 同时开工，而平台侧只认最后一次 claim，另一个群
+ *    会变成谁也不管的孤儿。抛在这里离原因最近；释放后重领是安全的（旧 binding 已置 void）。
+ */
+export declare function createBinding(dataDir: string, input: CreateBindingInput, now?: number): IssueBinding;
+/** 局部更新一条 binding（read-modify-write，保住并发写入的其它字段）。 */
+export declare function updateBinding(dataDir: string, anchorId: string, patch: Partial<Omit<IssueBinding, 'anchorId' | 'createdAt'>>, now?: number): IssueBinding | null;
+/** 删除一条 binding（会话彻底结束且 issue 已终态后清理）。返回是否删掉。 */
+export declare function removeBinding(dataDir: string, anchorId: string): boolean;
+export declare function listOutbox(dataDir: string, anchorId?: string): IssueOutboxRow[];
+/**
+ * 投影一次「本会话应达的 issue 状态」到发件箱（§七 去重合并）。
+ *
+ * 合并规则（**与最新未完成目标比，不是与 lastSyncedStatus 比**）：
+ *  - 该 binding 已有 `pending` 行 → **就地覆盖**它的 targetStatus 并重分配 sourceSeq，不新增行；
+ *  - 否则仅当 desired 与「最新目标 ∪ lastSyncedStatus」都不同才排一条新行。
+ *
+ * 为什么必须这样：离线期间 30s 一次的 tick 会反复投影，若每次都追加，恢复后会把一长串
+ * 早已过时的中间态依次发给平台——既刷无效自迁移，又让**最新**状态排在队尾迟迟到不了。
+ *
+ * 返回排出的行；无需回写时返回 null。
+ */
+export declare function enqueueDesiredStatus(dataDir: string, anchorId: string, desired: IssueStatus, opts?: {
+    attentionReason?: AttentionReason;
+    expectedStateRev?: number;
+}, now?: number): IssueOutboxRow | null;
+/**
+ * 领取该 binding 的下一条待发行（`pending → inflight` 的 CAS）。
+ *
+ * **串行**：同一 binding 已有 inflight 行时返回 null——平台侧要求同一 issue 的 sourceSeq
+ * 单调到达，并发发送会让顺序乱掉。`nextRetryAt` 未到的行也不返回（退避）。
+ */
+export declare function claimNextOutboxRow(dataDir: string, anchorId: string, now?: number): IssueOutboxRow | null;
+/**
+ * 发送成功：标 done，并把平台返回的 stateRev / 已同步状态写回 binding。
+ *
+ * `applied: false` 用于「这条行不必再发了，但平台**没有**采纳它」——目前只有一种情况：
+ * 409 对账发现 claim 已易主。此时**绝不能**写 `lastSyncedStatus`：写了本地就以为
+ * "已经是 in_review 了"，下一次交付会走幂等分支直接回成功，而平台上那条压根没变。
+ */
+export declare function settleOutboxRow(dataDir: string, writeId: string, result: {
+    platformStateRev?: number;
+    platformLastSourceSeq?: number;
+    applied?: boolean;
+}, now?: number): void;
+/** 发送失败：退回 pending + 指数退避（上限 5min）。`fatal` 用于平台明确拒绝、重试无意义的情况。 */
+export declare function failOutboxRow(dataDir: string, writeId: string, error: string, opts?: {
+    fatal?: boolean;
+}, now?: number): void;
+/**
+ * 启动对账：把本机所有 `inflight` 退回 `pending`。
+ *
+ * 进程在「标 inflight 后、记录响应前」崩溃时，那一行会永远停在 inflight 并**堵死该
+ * binding 的串行 pump**（claimNextOutboxRow 见到 inflight 就返回 null）。平台侧的
+ * sourceSeq 单调 + 终态幂等保证重复投递是安全的，所以无脑退回即可，不需要发送租约。
+ *
+ * 返回被退回的行数。
+ */
+export declare function resetInflightToPending(dataDir: string): number;
+/** 清理已完成的发件箱行（保留最近 `keep` 条便于排查）。返回清掉的行数。 */
+export declare function pruneOutbox(dataDir: string, keep?: number): number;
+//# sourceMappingURL=issue-board-store.d.ts.map

package/dist/services/issue-board-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-board-store.d.ts","sourceRoot":"","sources":["../../src/services/issue-board-store.ts"],"names":[],"mappings":"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"}