@router-agent/runtime 0.0.0-stage → 0.3.32

package/dist/spec/prompt-mode.md

@@ -0,0 +1,176 @@
+# Router Agent Worker 手册
+
+你是 router-agent 派出的 Worker。你在一个独立的 Orca worktree 里工作，负责完成下面这张工单。
+你**只对 Router（编排层）负责**：所有状态通过 `ra report` 上报，不要直接给飞书发消息，不要自己联系发起人。
+
+## 工单
+
+- 工单 ID：`{{ticketId}}`
+- 标题：{{title}}
+- 授权范围：{{scope}}
+- 仓库：{{repo}}
+- 起始分支：{{branch}}
+- 工作目录：{{workdir}}
+
+{{attachments}}
+
+## 先判断怎么回
+
+| 产出 | 怎么交付 |
+| --- | --- |
+| 代码变更 | 开 PR（GitHub）或 MR（GitLab），`ra report` 带上 `--pr-number` / `--pr-url`，可附一段 `--reply` 说明；改 UI 时 PR / MR 描述必须附 Before / After 对比 |
+| 分析、结论、答疑 | 把要发的话直接写进 `--reply` |
+| 很长的结论 / 多章节 / 需要沉淀转发 | 先 `ra doc` 生成飞书文档，再把文档链接写进 `--reply` |
+
+- **非代码类工单不要为了交付去改代码、跑构建或开 PR / MR**，也不要因为「没有 PR / MR」而卡住。
+- GitHub 仓库用 `gh` 开 PR，GitLab 仓库用 `glab mr create` 开 MR；没有 `glab` 时可用 `git push -o merge_request.create`。两种都把编号与链接带进 `--pr-number` / `--pr-url`。
+- Router 只发送 `--reply` 的原文，不会替你改写、压缩或判断「该不该转文档」。形态由你决定。
+
+## 工作方式
+
+1. 先读仓库里的 README / 约定，确认怎么构建和测试（仅代码类需要）。
+2. 只在授权范围内改动代码；需要跨范围时，用 `blocked` 上报说明原因，等人确认。
+3. 代码类：改完必须自己跑测试或构建，确认通过后再开 PR / MR。
+4. 非代码类：直接产出完整结论，不要压缩成一句话。
+5. 每轮结束前必须执行一次 `ra report`。
+
+## 上报命令（唯一对外通道）
+
+```bash
+ra report \
+  --ticket {{ticketId}} \
+  --state progress|waiting|ready|blocked|failed|dropped \
+  --summary "一句话说明这一轮做了什么" \
+  [--reply @answer.md | - | "要发给用户的话"] \
+  [--pr-number 12 --pr-url "https://..."] \
+  [--ui-change [true|false]] \
+  [--human-action "blocked 时要人做的事"] \
+  [--ack in_xxx]
+```
+
+- `--summary` 只放一句话（给日志和列表用）；**用户真正看到的内容全部放 `--reply`**。
+- `--state progress` 是「中途进展」：Router 不逐条转发，会按 `progress.syncMs` 合并后同步到话题；
+  带 `--ack` 的追问回答会立即发送。需要用户立刻看到的内容请用 `ready`。
+- `--reply` 支持字面量、`@文件`、`-`（stdin）。正文长时用文件，避免 shell 转义：
+  ```bash
+  ra report --ticket {{ticketId}} --state ready --summary "完成梳理" --reply @/tmp/answer.md
+  ```
+- **不要手写 `state.json`**。`ra report` 会 POST 给本地 Router；服务不可达时会自动落盘，等 Router 轮询。
+- 命令会打印回执；退出码非 0 时按 stderr 修正后重试。
+- 同一个工单有多轮时不用自己算 turn，Router 会自增。
+
+## 回复怎么写
+
+- 直接给结论，不要只写「我做了什么」的过程。
+- Markdown 可以直接用：单行纯文本会按纯文本发送，其余由 Router 以飞书卡片渲染标题、列表、链接、代码块。
+- 卡片渲染时会做 Markdown 归一化：`#` 标题变加粗行、表格降级为列表、`<br>` 变换行；富文本尽量用加粗、列表、代码块表达。
+- 有 PR 就附 PR 链接；有飞书文档就附文档链接。
+- `--reply` 超过单条消息长度会自动分块，不会截断。
+
+### 需要长文档时
+
+```bash
+ra doc --title "trove 可优化点清单" --content @/tmp/answer.md
+# 输出：https://xxx.feishu.cn/docx/xxxxx
+```
+
+把打印出的链接写进 `--reply`，例如：
+
+```bash
+ra report --ticket {{ticketId}} --state ready \
+  --summary "18 项可优化点已整理成文档" \
+  --reply "已完成梳理，完整清单见：https://xxx.feishu.cn/docx/xxxxx"
+```
+
+## 代码交付
+
+- 分支名：`{{workBranch}}`。
+- PR / MR 标题用中文，正文写清「做了什么 / 怎么验证的 / 风险」。
+- 上报时带 `--pr-number`、`--pr-url`；不要自己合并 PR / MR，合并由人决定。
+- CI 失败时修到绿；修不动用 `blocked` 说明失败原因。
+
+## UI 改动：必须交 Before / After 对比
+
+只要改动会影响用户看到或操作的界面（页面、组件、样式、交互、布局），PR / MR 描述里必须同时给出 **Before** 和 **After** 两组视觉证据，并标明基线版本与改动版本。
+
+- 两组截图或录屏使用同一场景、同一视口（窗口尺寸）、同一主题（明 / 暗）和同一 UI 状态，保证对比有意义。
+- **只有 After 不算完整交付**；不要用设计稿、手工 mockup 或改动后的页面冒充 Before。
+- 必须是真实运行中的页面截图；不要暴露飞书私密内容、真实用户数据或任何凭据。
+- 后续改动让界面对不上时重新截一组，不要沿用过期截图。
+- 把截图放进 PR / MR 描述能直接看到的位置：按仓库约定提交到分支后用仓库内图片链接引用，或用项目已有的素材托管 / GitLab 项目上传接口；不要只写本机文件路径，也不要把私人图床链接写进公开仓库。
+- 拿不到真实基线时，在 PR / MR 描述和 `--reply` 里如实说明缺什么、为什么缺，本轮用 `blocked` 或 `progress` 上报，**不要报 `ready`** 说这个 UI 改动已完成。
+- 报 `ready` 前确认 PR 描述里的图片链接能打开、Before / After 都能看到；`--reply` 里说明对比证据放在 PR 的哪一段。
+- 上报时用 `--ui-change` 声明本次改动是否涉及 UI：`--ui-change` 或 `--ui-change true` 表示改了 UI，`--ui-change false` 表示没改。不声明时 Router 会按改动文件路径推断。
+- Router 可能开启 UI 证据门禁（`worker.evidence.ui`）：`enforce` 档下缺证据的 `--state ready` 会返回 422 并告诉你怎么补；**补不了就改用 `blocked`，不要反复重试 ready**。`warn` 档只记日志，不会拦。
+
+截图方法：
+
+1. 优先用仓库自带的启动、预览与截图脚本（看 README、`package.json`、`AGENTS.md`）。
+2. 没有现成脚本时，启动本地开发 / 预览服务，用 Playwright 截图（首次使用先 `npx playwright install chromium`）：
+   ```bash
+   npx playwright screenshot --viewport-size=1440,900 --wait-for-timeout=2000 http://localhost:3000/page before.png
+   ```
+3. **动手前先在未改动状态（起始分支）截 Before**，改完后在同一环境截 After；中途切换过分支就重启 dev server，确认截到的是对应版本的代码。
+4. 截图前确认页面已真正加载完成：白屏、加载中骨架、404 / 500 页面都不算证据。
+
+## 收到追问（Router 投递的新输入）
+
+Router 会把发起人的新消息敲进你的终端，格式是：
+
+```text
+【Router 输入 in_xxxxx】
+用户的追问内容……
+```
+
+处理追问时：
+
+1. 记下 `【Router 输入 ...】` 里的 id。
+2. 回答完（或这一轮告一段落）必须再执行一次 `ra report`，不要只在终端里作答。
+3. 回答内容放进 `--reply`，`--state` 用 `ready`（答完了）或 `progress`（还要继续做）。
+4. 用 `--ack in_xxxxx` 确认已读。
+
+> **Router 只认 `ra report`，看不到你的终端输出。** 在终端里说了但没上报，等于用户什么都没收到；
+> 不上报 `--ack`，同一条追问会被反复投递给你。
+
+## 常用示例
+
+进度：
+
+```bash
+ra report --ticket {{ticketId}} --state progress --summary "已定位到配置入口，正在改"
+```
+
+回答追问：
+
+```bash
+ra report --ticket {{ticketId}} --state ready \
+  --summary "回答了追问：先改 A 再改 B" \
+  --reply "按优先级建议先改 A（原因……），再改 B（原因……）。" \
+  --ack in_abc123
+```
+
+代码交付：
+
+```bash
+ra report --ticket {{ticketId}} --state ready \
+  --summary "登录超时改为 30 秒，PR 已开" \
+  --pr-number 42 --pr-url "https://github.com/o/r/pull/42" \
+  --reply "已把登录超时改成 30 秒，验证方式与风险见 PR。"
+```
+
+需要人确认：
+
+```bash
+ra report --ticket {{ticketId}} --state blocked \
+  --summary "缺测试账号" \
+  --human-action "请提供一个可用的测试环境账号"
+```
+
+## 硬约束
+
+- 不要直接给飞书发消息，也不要调用 lark-cli 发消息；需要沉淀文档时用 `ra doc`。
+- 不要修改本工单授权范围之外的模块。
+- 不要手写或篡改 `state.json` / `events.log` 之外的状态文件；上报只走 `ra report`。
+- 每轮结束前必须上报；不报视为本轮没有交付。
+- **只写 summary 不写 reply 视为交付不完整**：用户只会看到一句摘要，拿不到你的结论。
+- **改了 UI 却没在 PR / MR 描述里给出 Before / After 对比，不能报 `ready`**。

package/dist/spec/reader.d.ts

@@ -0,0 +1,5 @@
+/** 覆盖文件的固定路径：`<home>/specs/worker/<file>`。 */
+export declare function workerSpecPath(home: string, file: string): string;
+/** 随包内置模板路径；编译后与 reader.js 同目录。 */
+export declare function bundledWorkerSpecPath(file: string): string;
+export declare function readWorkerSpec(home: string | undefined, file: string): string;

package/dist/spec/reader.js

@@ -0,0 +1,32 @@
+/**
+ * Worker 规范模板读取。
+ *
+ * 模板随运行时包一起发布；用户覆盖文件固定放在 `<home>/specs/worker/<file>`。
+ * 读取顺序与原来一致：覆盖文件优先，读不到就用随包内置模板。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** 覆盖文件的固定路径：`<home>/specs/worker/<file>`。 */
+export function workerSpecPath(home, file) {
+    return join(home, 'specs', 'worker', file);
+}
+/** 随包内置模板路径；编译后与 reader.js 同目录。 */
+export function bundledWorkerSpecPath(file) {
+    return fileURLToPath(new URL(`./${file}`, import.meta.url));
+}
+export function readWorkerSpec(home, file) {
+    if (home) {
+        const path = workerSpecPath(home, file);
+        if (existsSync(path)) {
+            try {
+                return readFileSync(path, 'utf8');
+            }
+            catch {
+                // 覆盖文件被并发删除 / 权限异常时不要阻塞派工，回落到内置模板。
+            }
+        }
+    }
+    return readFileSync(bundledWorkerSpecPath(file), 'utf8');
+}
+//# sourceMappingURL=reader.js.map

package/dist/spec/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/spec/reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,8CAA8C;AAC9C,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY;IACvD,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;AAC5C,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAwB,EAAE,IAAY;IACnE,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACvC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;AAC1D,CAAC"}

package/dist/status.d.ts

@@ -0,0 +1,8 @@
+import type { AgentStatus } from './port.js';
+/** 状态分类：所有调用点只消费这个结果，避免各自解释 provider 字段。 */
+export type AgentVerdict = 'keep' | 'lost' | 'transfer' | 'unknown';
+export declare function classifyAgentStatus(status: AgentStatus | null): AgentVerdict;
+/** 是否属于「进程还活着」的 keep 状态（blocked 也算活着）。 */
+export declare function isAliveStatus(status: AgentStatus | null): boolean;
+/** 取多个时间戳里最新的一个；ISO 字符串可直接按字典序比较。 */
+export declare function latestActivityAt(...candidates: (string | undefined)[]): string | undefined;

package/dist/status.js

@@ -0,0 +1,22 @@
+export function classifyAgentStatus(status) {
+    if (!status)
+        return 'unknown';
+    if (status.phase === 'lost')
+        return 'lost';
+    if (status.phase === 'exited')
+        return status.acceptingInput ? 'keep' : 'transfer';
+    if (status.phase === 'blocked')
+        return 'keep';
+    if (status.phase === 'unknown')
+        return 'unknown';
+    return 'keep'; // starting / running
+}
+/** 是否属于「进程还活着」的 keep 状态（blocked 也算活着）。 */
+export function isAliveStatus(status) {
+    return Boolean(status && status.alive && (status.phase === 'running' || status.phase === 'blocked' || status.phase === 'starting'));
+}
+/** 取多个时间戳里最新的一个；ISO 字符串可直接按字典序比较。 */
+export function latestActivityAt(...candidates) {
+    return candidates.filter((value) => Boolean(value)).sort().at(-1);
+}
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../packages/runtime/src/status.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IAC1C,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAA;IACjF,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IAC7C,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAChD,OAAO,MAAM,CAAA,CAAC,qBAAqB;AACrC,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,OAAO,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAA;AACrI,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,gBAAgB,CAAC,GAAG,UAAkC;IACpE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AACpF,CAAC"}

package/dist/workspaces/git-worktree.d.ts

@@ -0,0 +1,44 @@
+import type { CommandRunner } from '@router-agent/infra/process.js';
+import { type WorkspaceInfo, type WorkspaceProvider, type WorkspaceRequest, type Workspace } from '../port.js';
+export interface GitWorktreeProviderOptions {
+    git: CommandRunner;
+    /** 允许创建工作区的根目录；用于防止路径越界。为空表示不限制。 */
+    worktreesRoot?: string;
+}
+/**
+ * 纯 git worktree 实现：只负责隔离目录与分支，不负责启动 Agent。
+ * 所有位置参数前加 `--`，分支名先过 check-ref-format，避免选项注入。
+ */
+export declare class GitWorktreeProvider implements WorkspaceProvider {
+    readonly id = "git-worktree";
+    private git;
+    private worktreesRoot?;
+    constructor(opts: GitWorktreeProviderOptions);
+    create(req: WorkspaceRequest): Promise<Workspace>;
+    inspect(ref: string): Promise<WorkspaceInfo | null>;
+    /**
+     * 删除检出。
+     *
+     * `git worktree remove` 必须在 git 仓库上下文里跑，否则会报
+     * `fatal: not a git repository`（进程 cwd 通常不是仓库）。
+     * 所以优先用源仓库当 cwd；拿不到仓库时退回检出目录自己。
+     */
+    remove(ref: string, opts?: {
+        force?: boolean;
+        repo?: string;
+    }): Promise<void>;
+    private removeFailed;
+    /** 删除本次新建的分支；只用于 launch 失败回滚。 */
+    deleteBranch(branch: string, repoPath: string): Promise<void>;
+    version(): Promise<string | null>;
+    /** 从 worktree 的 origin 解析 GitHub owner/repo；解析失败返回 null。 */
+    remoteRepo(workdir: string): Promise<string | null>;
+    private branchExists;
+    private assertBranch;
+    private repoPathOf;
+    /** 宽松版：拿不到本地仓库绝对路径时返回 null（不抛错，交给调用方兜底）。 */
+    private repoPathOrNull;
+    private assertWorkdir;
+}
+/** 解析 GitHub remote：支持 git@github.com:o/r.git 与 https://github.com/o/r.git。 */
+export declare function parseGitHubRepo(remote: string): string | null;

package/dist/workspaces/git-worktree.js

@@ -0,0 +1,183 @@
+import { existsSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+import { WorkerRuntimeError } from '../port.js';
+/**
+ * 纯 git worktree 实现：只负责隔离目录与分支，不负责启动 Agent。
+ * 所有位置参数前加 `--`，分支名先过 check-ref-format，避免选项注入。
+ */
+export class GitWorktreeProvider {
+    id = 'git-worktree';
+    git;
+    worktreesRoot;
+    constructor(opts) {
+        this.git = opts.git;
+        this.worktreesRoot = opts.worktreesRoot ? resolve(opts.worktreesRoot) : undefined;
+    }
+    async create(req) {
+        const repoPath = this.repoPathOf(req.repo);
+        const base = req.baseBranch.trim();
+        const requestedBranch = req.workBranch.trim();
+        if (!base)
+            throw new WorkerRuntimeError('workspace:missing-branch', '起始分支为空，拒绝创建 worktree');
+        if (!requestedBranch)
+            throw new WorkerRuntimeError('workspace:missing-branch', '工作分支为空，拒绝创建 worktree');
+        await this.assertBranch(base, repoPath);
+        const requestedWorkdir = this.assertWorkdir(req.workdir);
+        // 同名分支/目录已存在时加数字后缀，避免失联后重新派工永远撞冲突。
+        let branch = requestedBranch;
+        let workdir = requestedWorkdir;
+        let free = false;
+        for (let i = 1; i <= 20; i += 1) {
+            const exists = await this.branchExists(repoPath, branch);
+            if (!exists && !existsSync(workdir)) {
+                free = true;
+                break;
+            }
+            branch = `${requestedBranch}-${i + 1}`;
+            workdir = `${requestedWorkdir}-${i + 1}`;
+        }
+        if (!free) {
+            throw new WorkerRuntimeError('workspace:create-failed', `分支/目录已被占用，无法创建工作区: ${requestedBranch}`, {
+                detail: { workdir: requestedWorkdir, branch: requestedBranch },
+            });
+        }
+        await this.assertBranch(branch, repoPath);
+        const res = await this.git.run(['worktree', 'add', '-b', branch, '--', workdir, base], { cwd: repoPath });
+        if (res.code !== 0) {
+            throw new WorkerRuntimeError('workspace:create-failed', `git worktree add 失败: ${res.stderr || res.stdout}`, {
+                cause: res.stderr || res.stdout,
+                detail: { workdir, branch, repo: repoPath },
+            });
+        }
+        const actual = await this.git.run(['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: workdir });
+        return {
+            workspaceRef: workdir,
+            workdir,
+            branch: actual.code === 0 ? actual.stdout.trim() : branch,
+        };
+    }
+    async inspect(ref) {
+        const workdir = this.assertWorkdir(ref);
+        const branchRes = await this.git.run(['-C', workdir, 'rev-parse', '--abbrev-ref', 'HEAD']);
+        if (branchRes.code !== 0)
+            return null;
+        const statusRes = await this.git.run(['-C', workdir, 'status', '--porcelain']);
+        return {
+            workdir,
+            branch: branchRes.stdout.trim(),
+            ...(statusRes.code === 0 ? { dirty: statusRes.stdout.trim().length > 0 } : {}),
+        };
+    }
+    /**
+     * 删除检出。
+     *
+     * `git worktree remove` 必须在 git 仓库上下文里跑，否则会报
+     * `fatal: not a git repository`（进程 cwd 通常不是仓库）。
+     * 所以优先用源仓库当 cwd；拿不到仓库时退回检出目录自己。
+     */
+    async remove(ref, opts = {}) {
+        const workdir = this.assertWorkdir(ref);
+        // 源仓库当 git 上下文；拿不到就用检出目录自己（worktree 本身也是 git 仓库）。
+        const repo = this.repoPathOrNull(opts.repo);
+        const cwd = repo ?? workdir;
+        // 依次尝试：源仓库 → 检出目录 → （允许时）强制删除。
+        const candidates = [
+            { argv: ['worktree', 'remove', '--', workdir], cwd },
+        ];
+        if (cwd !== workdir) {
+            candidates.push({ argv: ['worktree', 'remove', '--', workdir], cwd: workdir });
+        }
+        if (opts.force) {
+            candidates.push({ argv: ['worktree', 'remove', '--force', '--', workdir], cwd });
+        }
+        let last = null;
+        for (const candidate of candidates) {
+            const res = await this.git.run(candidate.argv, { cwd: candidate.cwd });
+            if (res.code === 0)
+                return;
+            last = res;
+        }
+        throw this.removeFailed(workdir, repo, last ?? { code: 1, stdout: '', stderr: '' });
+    }
+    removeFailed(workdir, repo, res) {
+        return new WorkerRuntimeError('workspace:remove-failed', `git worktree remove 失败: ${res.stderr || res.stdout}`, {
+            cause: res.stderr || res.stdout,
+            detail: { workdir, ...(repo ? { repo } : {}) },
+        });
+    }
+    /** 删除本次新建的分支；只用于 launch 失败回滚。 */
+    async deleteBranch(branch, repoPath) {
+        const path = this.repoPathOf(repoPath);
+        await this.assertBranch(branch, path);
+        const res = await this.git.run(['branch', '-D', '--', branch], { cwd: path });
+        if (res.code !== 0) {
+            throw new WorkerRuntimeError('workspace:remove-failed', `git branch -D 失败: ${res.stderr || res.stdout}`, {
+                cause: res.stderr || res.stdout,
+                detail: { branch, repo: path },
+            });
+        }
+    }
+    async version() {
+        const res = await this.git.run(['--version']);
+        return res.code === 0 ? res.stdout.trim() : null;
+    }
+    /** 从 worktree 的 origin 解析 GitHub owner/repo；解析失败返回 null。 */
+    async remoteRepo(workdir) {
+        const path = this.assertWorkdir(workdir);
+        const res = await this.git.run(['remote', 'get-url', 'origin'], { cwd: path });
+        if (res.code !== 0)
+            return null;
+        return parseGitHubRepo(res.stdout.trim());
+    }
+    async branchExists(repoPath, branch) {
+        const res = await this.git.run(['show-ref', '--verify', '--quiet', `refs/heads/${branch}`], { cwd: repoPath });
+        return res.code === 0;
+    }
+    async assertBranch(branch, repoPath) {
+        if (branch.startsWith('-')) {
+            throw new WorkerRuntimeError('workspace:missing-branch', `非法分支名: ${branch}`);
+        }
+        const res = await this.git.run(['check-ref-format', '--branch', branch], { cwd: repoPath });
+        if (res.code !== 0) {
+            throw new WorkerRuntimeError('workspace:missing-branch', `非法分支名: ${branch}`);
+        }
+    }
+    repoPathOf(repo) {
+        const path = repo.trim().replace(/^(id|name|path):/, '');
+        if (!path || !isAbsolute(path)) {
+            throw new WorkerRuntimeError('workspace:missing-repo', `git worktree 需要本地仓库绝对路径（path:/abs），收到: ${repo}`);
+        }
+        return resolve(path);
+    }
+    /** 宽松版：拿不到本地仓库绝对路径时返回 null（不抛错，交给调用方兜底）。 */
+    repoPathOrNull(repo) {
+        if (!repo)
+            return null;
+        const path = repo.trim().replace(/^(id|name|path):/, '');
+        if (!path || !isAbsolute(path))
+            return null;
+        return resolve(path);
+    }
+    assertWorkdir(input) {
+        if (!input)
+            throw new WorkerRuntimeError('workspace:create-failed', 'workdir 为空');
+        if (input.includes('..'))
+            throw new WorkerRuntimeError('workspace:create-failed', `workdir 不允许包含 ..: ${input}`);
+        const workdir = isAbsolute(input) ? resolve(input) : resolve(input);
+        if (this.worktreesRoot && !workdir.startsWith(`${this.worktreesRoot}/`) && workdir !== this.worktreesRoot) {
+            throw new WorkerRuntimeError('workspace:create-failed', `workdir 越界: ${workdir}`);
+        }
+        return workdir;
+    }
+}
+/** 解析 GitHub remote：支持 git@github.com:o/r.git 与 https://github.com/o/r.git。 */
+export function parseGitHubRepo(remote) {
+    const ssh = remote.match(/^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/);
+    if (ssh)
+        return `${ssh[1]}/${ssh[2]}`;
+    const https = remote.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/);
+    if (https)
+        return `${https[1]}/${https[2]}`;
+    return null;
+}
+//# sourceMappingURL=git-worktree.js.map

package/dist/workspaces/git-worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/workspaces/git-worktree.ts"],"names":[],"mappings":"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"}

package/dist/workspaces/overview.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 面板「批量清理工作区」的中立视图与端口。
+ *
+ * 这里只放纯类型与纯函数，不能依赖任何 Node 内置模块 —— Web 面板会把它打进前端包。
+ * 服务层负责扫磁盘、按运行时分组；HTTP 层只透传这些结构。
+ */
+import type { Stage } from '@router-agent/core/model.js';
+/** 一个仍在磁盘上的工单工作区。 */
+export interface WorkspaceEntryView {
+    assignmentId: string;
+    ticketId: string;
+    title: string;
+    stage: Stage;
+    runtimeId: string;
+    workdir: string;
+    startedAt: string;
+    /** 工单关闭时间（ISO）；未关闭为空串。定时任务用它算保留期。 */
+    closedAt: string;
+    /** 仅「工单已关闭 + 目录仍存在 + 当前运行时可回收」时为 true。 */
+    cleanable: boolean;
+    /** 不可清理的原因；cleanable=true 时为空。 */
+    reason?: string;
+}
+/** 按运行时聚合的工作区清单。 */
+export interface WorkspaceRuntimeGroupView {
+    runtimeId: string;
+    /** 面板展示用短名，例如 orca / claude-code / Claude Code (ACP)。 */
+    label: string;
+    isDefault: boolean;
+    /** 当前服务是否注册了该运行时且支持回收。 */
+    supported: boolean;
+    entries: WorkspaceEntryView[];
+    cleanableCount: number;
+}
+export interface WorkspaceOverviewView {
+    runtimes: WorkspaceRuntimeGroupView[];
+    /** 全部可清理的工作区数量。 */
+    cleanableCount: number;
+}
+export interface WorkspaceRemovalView {
+    ticketId: string;
+    workdir: string;
+}
+export interface WorkspaceSkipView extends WorkspaceRemovalView {
+    reason: string;
+}
+export interface WorkspaceCleanupResultView {
+    removed: WorkspaceRemovalView[];
+    skipped: WorkspaceSkipView[];
+}
+/** 面板勾选后提交的清理请求：优先按工单；只传 runtimeId 时清理该运行时下全部可清理项。 */
+export interface WorkspaceCleanupRequest {
+    ticketIds?: string[];
+    runtimeId?: string;
+}
+/** HTTP API 依赖的面板端口；由 RouterService 实现。 */
+export interface WorkspaceAdminPort {
+    list(): Promise<WorkspaceOverviewView>;
+    /**
+     * 按工单逐个清理：每个工单由它自己的运行时决定怎么回收
+     * （Orca 关 worktree、Claude Code 删 agent view、ACP 直接删 worktree）。
+     */
+    cleanup(request: WorkspaceCleanupRequest): Promise<WorkspaceCleanupResultView>;
+}
+/** 运行时短名：目录里的长 label（`orca · Orca worktree + 终端`）只取第一段。 */
+export declare function workspaceRuntimeLabel(runtimeId: string): string;

package/dist/workspaces/overview.js

@@ -0,0 +1,12 @@
+import { ACP_AGENTS } from '../runtimes/acp-agents.js';
+import { WORKER_RUNTIMES, normalizeRuntimeId } from '../runtimes/catalog.js';
+/** 运行时短名：目录里的长 label（`orca · Orca worktree + 终端`）只取第一段。 */
+export function workspaceRuntimeLabel(runtimeId) {
+    const id = normalizeRuntimeId(runtimeId);
+    const builtin = WORKER_RUNTIMES.find(runtime => runtime.id === id);
+    if (builtin)
+        return builtin.label.split(' · ')[0]?.trim() || id;
+    const agent = ACP_AGENTS.find(item => item.runtimeId === id);
+    return agent?.label ?? id;
+}
+//# sourceMappingURL=overview.js.map

package/dist/workspaces/overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/workspaces/overview.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAmE5E,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAClE,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC,CAAA;IAC5D,OAAO,KAAK,EAAE,KAAK,IAAI,EAAE,CAAA;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@router-agent/runtime",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.32",
+  "type": "module",
+  "description": "Worker 运行时 SDK：端口、注册表、插件协议与共享工具",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blankPen/router-agent.git",
+    "directory": "packages/runtime"
+  },
+  "homepage": "https://github.com/blankPen/router-agent#readme",
+  "bugs": {
+    "url": "https://github.com/blankPen/router-agent/issues"
+  },
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*.js": "./dist/*.js",
+    "./*": "./dist/*"
+  },
+  "files": [
+    "dist"
+  ],
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@router-agent/core": "0.3.32",
+    "@router-agent/infra": "0.3.32",
+    "zod": "4.4.3"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.