botmux 3.9.0 → 3.9.2

package/dist/im/lark/issue-command-deps.js

@@ -0,0 +1,195 @@
+/**
+ * 把 [[issue-command]] 声明的依赖接到真实实现上。
+ *
+ * 单独一个文件是为了让 issue-command 保持可测：那边只认接口，真实的平台客户端、建群服务、
+ * bot 注册表都在这里装配。card-handler 与 command-handler 都从这里取。
+ */
+import { config } from '../../config.js';
+import { effectiveBotDisplayName, getBot } from '../../bot-registry.js';
+import { logger } from '../../utils/logger.js';
+import { readPlatformBinding } from '../../platform/binding.js';
+import { bindIssue, claimIssue, fetchIssues, fetchTeams, findIssueById, writeIssueStatus, } from '../../platform/issue-client.js';
+import { claimIssueIntoGroup, issueDetailUrl } from '../../services/issue-claim-flow.js';
+import { completeIssue, releaseIssue } from '../../services/issue-release.js';
+import { describeIssue } from '../../services/issue-status-view.js';
+import { createGroupWithBots } from '../../services/group-creator.js';
+import { buildIssueStatusCard } from './issue-card.js';
+import { sendMessage } from './client.js';
+/**
+ * kickoff 正文。写给 agent 看，所以要把它开工需要的一切都说全：干什么、在哪干、
+ * 做完怎么交付。
+ *
+ * 最后那句 `botmux report` 不是客套：它是**本机唯一**会把 issue 推到 in_review 的信号
+ * （见 [[issue-status-projector]] 的计划）。不写进 kickoff，agent 干完了平台也不知道。
+ */
+export function buildKickoffPrompt(args) {
+    return [
+        `请接手这个任务：**${args.title}**`,
+        '',
+        args.body?.trim() ? args.body.trim() : '_（这条任务没有填写详细描述）_',
+        '',
+        `工作目录：\`${args.workingDir}\``,
+        `平台任务 ID：\`${args.issueId}\``,
+        '',
+        '完成后执行 `botmux report` 交付，我会据此把任务状态推到「待验收」。',
+    ].join('\n');
+}
+/**
+ * daemon 在启动时把内部建会话入口注册进来。
+ *
+ * 用模块级注册而不是让 card-handler 直接 import daemon：daemon 是顶层编排，反向依赖它
+ * 会成环。注册前领取会干净地停在 activate 阶段（见 ActivateSession 的注释）。
+ */
+let registeredActivate;
+export function setIssueActivate(fn) {
+    registeredActivate = fn;
+}
+export function buildIssueCommandDeps(activate = registeredActivate) {
+    return {
+        fetchTeams: () => fetchTeams(),
+        fetchIssues: (teamId) => fetchIssues(teamId),
+        allowedUsers: (larkAppId) => {
+            try {
+                return getBot(larkAppId).resolvedAllowedUsers ?? [];
+            }
+            catch {
+                // bot 不在注册表里就当没有管理员——权限门 fail-closed，拒绝好过放行。
+                return [];
+            }
+        },
+        workingDirs: (larkAppId) => {
+            try {
+                const cfg = getBot(larkAppId).config;
+                return [
+                    ...(cfg.workingDir ? [cfg.workingDir] : []),
+                    ...(cfg.workingDirs ?? []),
+                ];
+            }
+            catch {
+                return [];
+            }
+        },
+        runClaim: async ({ issue, teamId, larkAppId, workingDir, invokerOpenId }) => {
+            const binding = readPlatformBinding();
+            if (!binding)
+                return { ok: false, stage: 'claim', reason: 'unbound' };
+            // 建群拿到的 chatId 之后要用来发 kickoff，先接住。
+            let shareLink;
+            let chatName = '';
+            // bot 不在注册表里就回落到 appId——展示名拿不到不该让领取失败。
+            let agentLabel;
+            try {
+                agentLabel = effectiveBotDisplayName(getBot(larkAppId));
+            }
+            catch {
+                agentLabel = undefined;
+            }
+            const r = await claimIssueIntoGroup({
+                dataDir: config.session.dataDir,
+                platformBaseUrl: binding.platformUrl,
+                claim: (issueId, args) => claimIssue(issueId, args),
+                bind: (issueId, args) => bindIssue(issueId, args),
+                createGroup: async (opts) => {
+                    const res = await createGroupWithBots({
+                        ...opts,
+                        // 领取人要在群里，否则建出来的群他自己进不去。用 open_id 而不是 union_id：
+                        // 这里的 invoker 来自同一个 bot 的卡片回调，本来就是 app-scoped 的。
+                        userOpenIds: [invokerOpenId],
+                    });
+                    chatName = opts.name ?? '';
+                    shareLink = res.shareLink ?? undefined;
+                    return res;
+                },
+                announce: async (chatId, card) => {
+                    await sendMessage(larkAppId, chatId, card, 'interactive');
+                },
+                onAnnounceError: (reason) => logger.warn(`[issue] 开工播报失败（不影响领取）：${reason}`),
+                activate: async (chatId, botLarkAppId, prompt) => {
+                    if (!activate)
+                        throw new Error('activate_not_wired');
+                    return activate({ chatId, larkAppId: botLarkAppId, prompt, workingDir });
+                },
+                writeStatus: (issueId, args) => writeIssueStatus(issueId, args),
+                fetchIssue: (teamId, issueId) => findIssueById(teamId, issueId),
+                onStatusError: (reason) => logger.warn(`[issue] in_progress 回写失败（领取仍成功，pump 会重投）：${reason}`),
+            }, {
+                issue,
+                teamId,
+                larkAppId,
+                creatorLarkAppId: larkAppId,
+                ownerUnionIds: [],
+                workingDir,
+                // 平台详情页直接渲染这个值，给它人能认的名字而不是 appId。
+                ...(agentLabel ? { agentLabel } : {}),
+                kickoffPrompt: buildKickoffPrompt({
+                    title: issue.title,
+                    ...(issue.body ? { body: issue.body } : {}),
+                    workingDir,
+                    issueId: issue._id,
+                }),
+            });
+            if (r.ok) {
+                logger.info(`[issue] 领取完成 issue=${issue._id} chat=${r.chatId} dir=${workingDir}`);
+                return {
+                    ok: true,
+                    chatId: r.chatId,
+                    chatName: chatName || r.chatId,
+                    ...(shareLink ? { shareLink } : {}),
+                };
+            }
+            return { ok: false, stage: r.stage, reason: r.reason };
+        },
+        runRelease: (anchorId) => settle(releaseIssue, anchorId),
+        runDone: (anchorId) => settle(completeIssue, anchorId),
+        runStatus: async (anchorId) => {
+            const r = await describeIssue({ dataDir: config.session.dataDir, fetchIssue: (teamId, issueId) => findIssueById(teamId, issueId) }, anchorId);
+            if (!r.ok)
+                return { ok: false, reason: r.reason };
+            const { binding, issue, pendingWrites, failedWrites, lastFailure, claimMine } = r.view;
+            const url = issueDetailUrl(binding.platformBaseUrl, binding.issueId);
+            return {
+                ok: true,
+                card: buildIssueStatusCard({
+                    issueId: binding.issueId,
+                    bindState: binding.bindState,
+                    pendingWrites,
+                    ...(failedWrites > 0 ? { failedWrites } : {}),
+                    ...(lastFailure ? { lastFailure } : {}),
+                    ...(binding.lastSyncedStatus ? { lastSyncedStatus: binding.lastSyncedStatus } : {}),
+                    ...(claimMine !== undefined ? { claimMine } : {}),
+                    ...(issue
+                        ? {
+                            platform: {
+                                title: issue.title,
+                                status: issue.status,
+                                ...(issue.attentionReason ? { attentionReason: issue.attentionReason } : {}),
+                                ...(issue.claim?.agent ? { claimAgent: issue.claim.agent } : {}),
+                                ...(issue.claim?.localTaskLabel ? { claimLabel: issue.claim.localTaskLabel } : {}),
+                            },
+                        }
+                        : {}),
+                    ...(url ? { issueUrl: url } : {}),
+                }),
+            };
+        },
+    };
+}
+/** 释放与验收完成只差目标态，出参形状一致，装配也就共用一份。 */
+async function settle(run, anchorId) {
+    const r = await run({
+        dataDir: config.session.dataDir,
+        writeStatus: (issueId, args) => writeIssueStatus(issueId, args),
+        fetchIssue: (teamId, issueId) => findIssueById(teamId, issueId),
+    }, anchorId);
+    if (r.ok) {
+        return { ok: true, issueId: r.issueId, alreadyReleasedOnPlatform: r.alreadyReleasedOnPlatform };
+    }
+    return {
+        ok: false,
+        reason: r.reason,
+        ...(r.reason === 'platform' ? { detail: r.detail, ...(r.permanent ? { permanent: true } : {}) } : {}),
+        // 终态是哪一种决定了给人的说法（作废 / 已释放 / 已完成）。
+        ...(r.reason === 'already_released' ? { bindState: r.binding.bindState } : {}),
+    };
+}
+//# sourceMappingURL=issue-command-deps.js.map

package/dist/im/lark/issue-command-deps.js.map

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

package/dist/im/lark/issue-command.d.ts

@@ -0,0 +1,137 @@
+import { type RepoChoice } from './issue-card.js';
+import type { CardActionData } from './card-handler.js';
+import type { PlatformIssue, PlatformIssueSections } from '../../platform/issue-client.js';
+export interface IssueCommandDeps {
+    fetchTeams: () => Promise<{
+        ok: boolean;
+        value?: Array<{
+            teamId: string;
+            teamName: string;
+        }>;
+        reason?: string;
+    }>;
+    fetchIssues: (teamId: string) => Promise<{
+        ok: boolean;
+        value?: PlatformIssueSections;
+        reason?: string;
+    }>;
+    /** 跑 [[issue-claim-flow]]。返回值直接喂给结果卡。 */
+    runClaim: (args: {
+        issue: PlatformIssue;
+        teamId: string;
+        larkAppId: string;
+        workingDir: string;
+        invokerOpenId: string;
+    }) => Promise<{
+        ok: true;
+        chatId: string;
+        chatName: string;
+        shareLink?: string;
+    } | {
+        ok: false;
+        stage: string;
+        reason: string;
+    }>;
+    /** 该 bot 的管理员 open_id 名单（`resolvedAllowedUsers`）。 */
+    allowedUsers: (larkAppId: string) => string[];
+    /** 该 bot 配置的工作目录（未展开 `~`）。 */
+    workingDirs: (larkAppId: string) => string[];
+    /** 跑 [[issue-release]] 的 `releaseIssue`。按锚点释放，锚点由调用方从当前会话推出来。 */
+    runRelease: (anchorId: string) => Promise<TerminalResult>;
+    /** 跑 [[issue-release]] 的 `completeIssue`（验收完成）。与释放同形，只是目标态不同。 */
+    runDone: (anchorId: string) => Promise<TerminalResult>;
+    /** 跑 [[issue-status-view]]。只读，用来渲染 `/issue status` 卡片。 */
+    runStatus: (anchorId: string) => Promise<{
+        ok: true;
+        card: string;
+    } | {
+        ok: false;
+        reason: 'no_binding';
+    }>;
+}
+/**
+ * 释放 / 验收完成的共同返回形状。
+ *
+ * `bindState` 只在 `already_released` 时有意义：三个终态（void / released / done）要说的话
+ * 完全不同——"作废了"、"早就释放过了"、"已经验收完成了"——糊成一句人会以为自己记错了。
+ */
+export type TerminalResult = {
+    ok: true;
+    issueId: string;
+    alreadyReleasedOnPlatform: boolean;
+} | {
+    ok: false;
+    reason: 'no_binding' | 'already_released' | 'platform';
+    detail?: string;
+    bindState?: string;
+    /** 平台明确拒绝且重试无意义（凭证失效 / issue 被删或归档）。措辞必须换掉"稍后再试"。 */
+    permanent?: boolean;
+};
+/** 命令入口的返回：card 是卡片 JSON 字符串，直接喂 `sessionReply(..., 'interactive')`。 */
+export type IssueCardResult = {
+    card: string;
+} | {
+    toast: {
+        type: 'error' | 'info';
+        content: string;
+    };
+};
+/**
+ * 卡片回调的返回。**结构与命令入口不同**：Lark 的 callback 响应要求
+ * `card: { type: 'raw', data: <对象> }`，直接回一个 JSON 字符串会被判非法，
+ * 客户端报 `code 200672`（实测踩过：卡片能发出来，但一点按钮就报错）。
+ */
+export type IssueCardCallbackResult = {
+    card: {
+        type: 'raw';
+        data: Record<string, unknown>;
+    };
+} | {
+    toast: {
+        type: 'error' | 'info';
+        content: string;
+    };
+};
+/**
+ * 扫出该 bot 可选的仓库。
+ *
+ * 不能直接用 `workingDirs`：它常常配的是一个工作区父目录（`~/claude-code-workspace`），
+ * 直接当候选，选中的会是工作区根目录。扫一层才拿得到真正的仓库和 worktree。
+ */
+export declare function reposFor(larkAppId: string, deps: IssueCommandDeps): RepoChoice[];
+/** `/issue`（裸）→ 看板卡片。 */
+export declare function handleIssueCommand(larkAppId: string, senderOpenId: string | undefined, deps: IssueCommandDeps): Promise<IssueCardResult>;
+type Toast = {
+    toast: {
+        type: 'error' | 'info';
+        content: string;
+    };
+};
+/**
+ * `/issue release` → 释放当前会话领取的那个 issue，退回平台「待领取」。
+ *
+ * 在**领取时建出来的那个群里**发。返回文本而不是卡片：这是个一次性动作，结果就一句话，
+ * 发张卡反而重。
+ */
+export declare function handleIssueRelease(larkAppId: string, senderOpenId: string | undefined, anchorCandidates: Array<string | undefined>, deps: IssueCommandDeps): Promise<Toast>;
+/**
+ * `/issue done` → 验收通过，把任务推到平台的终态。
+ *
+ * 这一步是**人的决策**，不是 agent 能自己走的：agent 交付只到「待验收」（[[issue-report]]），
+ * 之后由人看过产出再决定完成还是打回。所以入口是群里的管理员命令，而不是 `botmux` 的某个
+ * 子命令——放在 CLI 里 agent 就能自己盖章验收，那这个状态就没有意义了。
+ *
+ * 平台侧 `done` 会清掉 claim（`clearsClaim`），这条领取就此终结、不能再释放。
+ */
+export declare function handleIssueDone(larkAppId: string, senderOpenId: string | undefined, anchorCandidates: Array<string | undefined>, deps: IssueCommandDeps): Promise<Toast>;
+/**
+ * `/issue status` → 摊开本机与平台两边的现状。
+ *
+ * 只读，所以**不设终态门**：这个命令的用处恰恰是在「这个群是不是已经结束了」存疑的时候
+ * 回答它，把终态 binding 当成"没有绑定"是把唯一的答案藏起来。
+ */
+export declare function handleIssueStatus(larkAppId: string, senderOpenId: string | undefined, anchorCandidates: Array<string | undefined>, deps: IssueCommandDeps): Promise<IssueCardResult>;
+/** 卡片回调。所有 `issue_*` action 都走这里。 */
+export declare function handleIssueCardAction(data: CardActionData, larkAppId: string, deps: IssueCommandDeps): Promise<IssueCardCallbackResult>;
+export {};
+//# sourceMappingURL=issue-command.d.ts.map

package/dist/im/lark/issue-command.d.ts.map

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