duaer-spec 0.11.0 → 0.12.0

package/.duaer/active-job.json

@@ -1,5 +1 @@
-{
-  "specDir": ".duaer/specs/009-live-repo-pick",
-  "branch": "feat/live-repo-pick",
-  "startedAt": "2026-09-16T00:40:00.000Z"
-}
+{"specDir":".duaer/specs/022-live-preview-link","branch":"feat/live-preview-link","startedAt":"2026-09-16T02:00:00.000Z"}

package/.duaer/specs/011-live-agent-launch/delivery.json

@@ -0,0 +1,15 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-16T00:45:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1", "L3"],
+    "commands": [
+      "node --check bin/duaer-live.mjs",
+      "curl GET /api/agents (cursor-agent,claude,cursor,code,none)",
+      "curl POST /api/dispatch agentId=none",
+      "curl POST /api/dispatch agentId=cursor (open)",
+      "curl POST /api/dispatch/launch agentId=none"
+    ],
+    "result": "pass"
+  }
+}

package/.duaer/specs/011-live-agent-launch/spec.md

@@ -0,0 +1,33 @@
+# Feature Specification: Live desk agent detect + launch
+
+**Feature Branch**: `feat/live-agent-launch`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+派工后不只给文案：检测本机已安装的数字员工（Cursor Agent、Claude Code，以及仅打开仓库的 Cursor / VS Code），在现场开发页面列出可选，用户选中后启动并带上开工 prompt。
+
+## Out of scope
+
+- 远程/云端 Agent 编排
+- 代填各工具的 API Key / 登录
+- 默认开启 bypassPermissions / dangerously-skip-permissions（Claude）
+- 自动合入 / 自动 stamp delivery（仍由被启动的数字员工完成）
+
+## Acceptance
+
+1. `GET /api/agents` 返回本机检测到的启动器列表（至少探测 `agent`/`cursor agent`、`claude`、`cursor`、`code`）
+2. 派工面板展示可用启动器供点选；可「仅派工不启动」
+3. 派工时可带 `agentId`；或派工后再 `POST /api/dispatch/launch` 启动
+4. Cursor Agent：在 worktree 上以 prompt 启动（非交互 `-p`，记录日志）；Claude Code：`--bg` 后台开工；`cursor`/`code`：打开 worktree
+5. UI 文案不再暗示「请手动复制给数字员工」为唯一路径
+6. E2E catalog 增加场景；smoke curl 覆盖 detect + launch（launch 可用假/探测级）
+
+## Assumptions
+
+- macOS/Linux PATH 上有 CLI 即视为已安装
+- Cursor Agent 启动使用 `--trust`；为无人值守加 `--force`（用户显式点启动）
+- 上次选用的 agentId 可记在 live 配置里作默认

package/.duaer/specs/011-live-agent-launch/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [x] T001 Server: detectAgents + /api/agents + launchAgent + wire dispatch
+- [x] T002 UI: agent picker + launch after dispatch + copy update
+- [x] T003 Spec/CHANGELOG/E2E + smoke verify + delivery

package/.duaer/specs/012-live-dispatch-progress/delivery.json

@@ -0,0 +1,12 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-16T00:50:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1", "L3"],
+    "commands": [
+      "node --check bin/duaer-live.mjs",
+      "curl status progress 0/3 → 1/3 after T001 → accepted"
+    ],
+    "result": "pass"
+  }
+}

package/.duaer/specs/012-live-dispatch-progress/spec.md

@@ -0,0 +1,29 @@
+# Feature Specification: Live dispatch progress
+
+**Feature Branch**: `feat/live-dispatch-progress`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+派工后现场开发能看到数字员工做到哪一步：轮询产品仓 Brief 的 `tasks.md` 勾选状态，并展示当前步骤；可选附带启动日志尾部。
+
+## Out of scope
+
+- 实时流式推送 Agent token
+- 解析 IDE 内部会话状态
+- 强制远程 Agent 上报自定义协议（依赖 tasks.md 勾选约定）
+
+## Acceptance
+
+1. `GET /api/status` 返回 `progress`：tasks 列表（done/pending）、done/total、current 文案
+2. 派工面板展示进度清单，随轮询更新
+3. delivery accepted 时进度显示完成并停止轮询
+4. 派工写入的 tasks / agentPrompt 明确要求边做边勾选
+5. Smoke curl + E2E catalog
+
+## Assumptions
+
+- 数字员工按 Duaer 流程会更新 `tasks.md` 的 `- [x]`

package/.duaer/specs/012-live-dispatch-progress/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [x] T001 Extend /api/status with tasks.md progress (+ log tail)
+- [x] T002 UI progress list + poll render
+- [x] T003 Prompt/tasks template + CHANGELOG/E2E + smoke + delivery

package/.duaer/specs/013-fix-live-agent-run/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-16T01:05:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["node --check", "preferred ignores open-only cursor"],
+    "result": "pass"
+  }
+}

package/.duaer/specs/013-fix-live-agent-run/spec.md

@@ -0,0 +1,18 @@
+# Feature Specification: Live agent actually runs
+
+**Feature Branch**: `fix/live-agent-run`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+选 Cursor Agent / Claude 派工后，真正启动可运行的数字员工会话（终端可见），而不是只打开 Cursor 窗口；默认不要记住「仅打开 IDE」。
+
+## Acceptance
+
+1. cursor-agent：打开 worktree，并在 Terminal（macOS）或等效方式启动 `agent --workspace … --trust --force`（交互，不用 `-p` 静默）
+2. claude：在终端启动交互 `claude`（或明确后台时写清日志）；不再让用户误以为「打开 Cursor」就是开工
+3. preferredAgentId 只持久化 worker；open-only 不覆盖默认
+4. UI 文案区分「开工」与「仅打开」

package/.duaer/specs/013-fix-live-agent-run/tasks.md

@@ -0,0 +1,4 @@
+# Tasks
+
+- [x] T001 Fix launchAgent + preferred persistence
+- [x] T002 UI hints + CHANGELOG + smoke + delivery

package/.duaer/specs/014-fix-live-agent-auto/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-16T01:10:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["fake agent receives -p --force --trust; mode=background"],
+    "result": "pass"
+  }
+}

package/.duaer/specs/014-fix-live-agent-auto/spec.md

@@ -0,0 +1,18 @@
+# Feature Specification: Live agent auto-run (no wait for input)
+
+**Feature Branch**: `fix/live-agent-auto`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+派工选 Cursor Agent / Claude 后立刻非交互开工，不落在终端/IDE 里等用户再输入。
+
+## Acceptance
+
+1. cursor-agent：`agent -p --force --trust --workspace` 后台 spawn，prompt 作 argv；日志写入 agent-launch.log
+2. claude：`claude --bg` 后台开工（非交互）
+3. 不再为 worker 打开交互 Terminal；不默认只打开 Cursor 空窗导致误以为要手输
+4. UI 说明「已后台自动开工」

package/.duaer/specs/014-fix-live-agent-auto/tasks.md

@@ -0,0 +1,4 @@
+# Tasks
+
+- [x] T001 Non-interactive launch for cursor-agent + claude
+- [x] T002 UI/CHANGELOG + smoke + delivery

package/.duaer/specs/015-fix-live-open-worktree/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-16T01:15:00.000Z",
+  "verification": {
+    "levels": ["L0"],
+    "commands": ["node --check bin/duaer-live.mjs"],
+    "result": "pass"
+  }
+}

package/.duaer/specs/015-fix-live-open-worktree/spec.md

@@ -0,0 +1,17 @@
+# Feature Specification: Open named worktree on auto-start
+
+**Feature Branch**: `fix/live-open-worktree`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+后台自动开工时，同时用 Cursor 打开派工得到的命名 worktree（如 `.worktree/feat-1`），方便查看与操作。
+
+## Acceptance
+
+1. cursor-agent：后台 `-p` 开工 + `cursor <worktreePath>`
+2. claude：`--bg` + 尽量打开 Cursor/VS Code 到该 worktree
+3. UI 提示已打开 worktree

package/.duaer/specs/015-fix-live-open-worktree/tasks.md

@@ -0,0 +1,4 @@
+# Tasks
+
+- [x] T001 Open worktree on worker launch + UI + CHANGELOG
+- [x] T002 Smoke + delivery

package/.duaer/specs/016-live-cursor-cli/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-16T01:25:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["fake cursor -n + agent --workspace -p --force --sandbox disabled"],
+    "result": "pass"
+  }
+}

package/.duaer/specs/016-live-cursor-cli/spec.md

@@ -0,0 +1,18 @@
+# Feature Specification: Cursor CLI dispatch support
+
+**Feature Branch**: `feat/live-cursor-cli`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+派工启动对齐 Cursor 官方 CLI：用 `cursor -n` 打开命名 worktree，用 `agent` / `cursor agent` 非交互开工（`--workspace --trust -p --force`，不用 `-w`），并暴露 CLI 检测信息。
+
+## Acceptance
+
+1. Open: `cursor -n <worktree>`；尽量 `-g` 到 Brief `tasks.md`
+2. Run: prefer `agent` else `cursor agent`; args include `--workspace --trust -p --force --sandbox disabled`; never pass `-w`
+3. `/api/agents` includes cursor/agent binary paths (+ optional version)
+4. UI hint reflects Cursor CLI behavior

package/.duaer/specs/016-live-cursor-cli/tasks.md

@@ -0,0 +1,4 @@
+# Tasks
+
+- [x] T001 Cursor CLI open + agent argv helpers
+- [x] T002 detectAgents enrichment + UI/CHANGELOG + smoke

package/.duaer/specs/017-live-cli-install-prompt/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-16T01:35:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["node --check", "missing cursor-agent exposes install curl"],
+    "result": "pass"
+  }
+}

package/.duaer/specs/017-live-cli-install-prompt/spec.md

@@ -0,0 +1,18 @@
+# Feature Specification: CLI install hints + Agent start command box
+
+**Feature Branch**: `feat/live-cli-install-prompt`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+未安装 Cursor CLI 时提示安装命令；派工区提供「启动命令」输入框，默认以 `Agent` 开头，派工时把该内容交给 Cursor Agent。
+
+## Acceptance
+
+1. missing Cursor / Cursor Agent 带 `installCommand: curl https://cursor.com/install -fsS | bash`，UI 展示可复制
+2. 派工面板有启动命令输入框；选 Cursor Agent 时默认以 `Agent` 开头
+3. `POST /api/dispatch` 接受 `startCommand`，用作 agent prompt（并补全 worktree/Brief 路径）
+4. 未安装却选 Cursor Agent 时阻止启动并提示安装

package/.duaer/specs/017-live-cli-install-prompt/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [x] T001 Server: installCommand on missing + startCommand in dispatch
+- [x] T002 UI: install hint + start command box + wire
+- [x] T003 CHANGELOG + delivery

package/.duaer/specs/018-fix-live-cursor-terminal/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-16T01:40:00.000Z",
+  "verification": {
+    "levels": ["L0"],
+    "commands": ["node --check bin/duaer-live.mjs"],
+    "result": "pass"
+  }
+}

package/.duaer/specs/018-fix-live-cursor-terminal/spec.md

@@ -0,0 +1,17 @@
+# Feature Specification: Cursor Agent launches Terminal + CLI
+
+**Feature Branch**: `fix/live-cursor-terminal`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+Cursor Agent 派工打开 Terminal，在终端里执行 `agent` / `cursor agent` CLI（带启动命令），不再 `cursor -n` 开 IDE，也不后台静默 `-p`。
+
+## Acceptance
+
+1. cursor-agent → launchInTerminal with cursor CLI; mode=terminal
+2. Hint/UI 文案反映 Terminal + CLI
+3. 不调用 openCursorWorktree for cursor-agent

package/.duaer/specs/018-fix-live-cursor-terminal/tasks.md

@@ -0,0 +1,4 @@
+# Tasks
+
+- [x] T001 Terminal + Cursor CLI launch
+- [x] T002 UI/CHANGELOG + delivery

package/.duaer/specs/019-fix-live-terminal-open/delivery.json

@@ -0,0 +1 @@
+{"status":"accepted","acceptedAt":"2026-09-16T01:45:00.000Z","verification":{"levels":["L0"],"commands":["node --check","open .command"],"result":"pass"}}

package/.duaer/specs/019-fix-live-terminal-open/spec.md

@@ -0,0 +1,17 @@
+# Feature Specification: Reliable Terminal open for Cursor Agent
+
+**Feature Branch**: `fix/live-terminal-open`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+Cursor Agent 派工时真正弹出 Terminal：用 `.command` + `open`（并修正 osascript 引号）。
+
+## Acceptance
+
+1. macOS uses `open *.command` to launch Terminal with Cursor CLI
+2. Failed open falls back to correctly quoted osascript; both fail → error with command
+3. Launch log records open result

package/.duaer/specs/019-fix-live-terminal-open/tasks.md

@@ -0,0 +1,4 @@
+# Tasks
+
+- [x] T001 Fix launchInTerminal via open .command
+- [x] T002 CHANGELOG + delivery

package/.duaer/specs/020-fix-live-dispatch-hang/delivery.json

@@ -0,0 +1 @@
+{"status":"accepted","acceptedAt":"2026-09-16T01:50:00.000Z","verification":{"levels":["L0"],"commands":["node --check"],"result":"pass"}}

package/.duaer/specs/020-fix-live-dispatch-hang/spec.md

@@ -0,0 +1,16 @@
+# Feature Specification: Unstick dispatch UI
+
+**Feature Branch**: `fix/live-dispatch-hang`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+派工不再因同步打开 Terminal / osascript 卡住；接口快速返回，UI 有超时。
+
+## Acceptance
+
+1. launchInTerminal non-blocking
+2. fetch abort 60s; finally clears 派工中

package/.duaer/specs/020-fix-live-dispatch-hang/tasks.md

@@ -0,0 +1,3 @@
+# Tasks
+
+- [x] T001 Async terminal + UI timeout

package/.duaer/specs/021-fix-live-cli-only/delivery.json

@@ -0,0 +1 @@
+{"status":"accepted","acceptedAt":"2026-09-16T01:55:00.000Z","verification":{"levels":["L0"],"commands":["node --check"],"result":"pass"}}

package/.duaer/specs/021-fix-live-cli-only/spec.md

@@ -0,0 +1,17 @@
+# Feature Specification: CLI-only digital employees
+
+**Feature Branch**: `fix/live-cli-only`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+派工「用哪个数字员工」只保留 CLI：Cursor Agent、Claude Code；二者均在 Terminal 执行。
+
+## Acceptance
+
+1. `/api/agents` only lists cursor-agent / claude (plus missing install hints)
+2. No Cursor-open-only / VS Code / 仅派工 options
+3. Claude launches via Terminal like Cursor Agent

package/.duaer/specs/021-fix-live-cli-only/tasks.md

@@ -0,0 +1,4 @@
+# Tasks
+
+- [x] T001 CLI-only catalog + Claude Terminal
+- [x] T002 UI + delivery

package/.duaer/specs/022-live-preview-link/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-16T02:05:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["node --check", "status preview + /api/artifact serves index.html"],
+    "result": "pass"
+  }
+}

package/.duaer/specs/022-live-preview-link/spec.md

@@ -0,0 +1,19 @@
+# Feature Specification: Live delivery preview link
+
+**Feature Branch**: `feat/live-preview-link`
+
+**Created**: 2026-09-16
+
+**Status**: Active
+
+## Goal
+
+delivery accepted 后现场开发展示可点击的成品链接（`delivery.preview` 或 worktree 内常见静态页），用户可直接打开查看。
+
+## Acceptance
+
+1. Agents stamp `preview.url` (http(s) or worktree-relative path) in delivery.json when there is a viewable artifact
+2. `/api/status` returns `preview: { url, label, source }`
+3. Live serves worktree files at `/api/artifact?jobId=&path=` (path confined to worktree)
+4. UI shows 「查看成品」 link/button on accept; bubble mentions the link
+5. Dispatch prompt/tasks require preview for UI deliverables

package/.duaer/specs/022-live-preview-link/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [x] T001 resolvePreview + artifact API + status field
+- [x] T002 Prompt/tasks + UI preview panel
+- [x] T003 CHANGELOG/E2E + smoke + delivery

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Changelog
 
-## Unreleased
+## 0.12.0 — 2026-09-16
+
+### Live desk → product dispatch (closed loop)
+
+- Confirm + auto-accept, then pick a product repo (browse / scan / recent) and create `.worktree/feat-*` with Brief under that worktree’s `.duaer/specs/`
+- Non-git folders: auto `git init -b develop`; repos without develop/main/master: auto-create local `develop`
+- Launchers are **CLI only**: Cursor Agent and Claude Code — open Terminal and run `agent` / `cursor agent` or `claude` with the start command (prefix `Agent`)
+- Missing Cursor CLI shows install: `curl https://cursor.com/install -fsS | bash`
+- Progress: poll product Brief `tasks.md` checkboxes; optional agent-launch.log tail
+- On `delivery.json` accepted: show **查看成品** from `preview.url` (or auto-detect `index.html`); serve worktree files at `/api/artifact/<jobId>/…`
+- Dispatch does not block the UI on Terminal open (async); 60s client timeout
+
+### Docs
+
+- README / README.zh-CN: live desk flow updated for CLI launch, progress, and preview link
 
 ## 0.11.0 — 2026-09-16
 

package/README.md

@@ -40,16 +40,26 @@ everyday human UI.
 Isolated from product repos. Config and Briefs live under `~/.duaer/live/`.
 
 ```bash
-# DeepSeek（推荐）
+# DeepSeek (recommended)
 duaer live config --provider deepseek --api-key sk-...
 
-# 在产品仓登记，派工时点选（可选）
+# Remember a product repo for dispatch (optional; run inside that repo)
 duaer live repo add
 
 duaer live
 ```
 
-Dialogue → confirm + auto-accept → **dispatch** (browse / scan / remembered repos) into a product worktree → hand the prompt to the digital employee.
+Open the printed URL (default `http://127.0.0.1:8787`).
+
+**Flow**
+
+1. Dialogue → fill confirm card → auto-accept  
+2. Pick a product repo (browse / scan / recent). Non-git folders get `git init -b develop`; missing develop/main/master creates local `develop`  
+3. Choose a **CLI** digital employee: **Cursor Agent** or **Claude Code** (install Cursor CLI if needed: `curl https://cursor.com/install -fsS | bash`)  
+4. Edit the start command (must begin with `Agent`) → dispatch creates `.worktree/feat-*` and opens **Terminal** to run the CLI  
+5. Watch `tasks.md` progress on the desk; when `delivery.json` is `accepted`, open **查看成品** (`preview.url` or auto-detected `index.html`)
+
+Worktree id ≠ Brief folder name — use `.worktree/feat-<name>/`, Brief under `.duaer/specs/<nnn-slug>/` inside that worktree.
 
 ## Branches (mandatory)
 

package/README.zh-CN.md

@@ -51,7 +51,15 @@ duaer live config --base-url https://api.openai.com/v1 --api-key sk-... --model
 duaer live
 ```
 
-浏览器打开提示地址。多轮对话 → 确认卡 → 自动验收 → **浏览/扫描/点选产品仓派工** → 把开工说明给数字员工。
+浏览器打开提示地址（默认 `http://127.0.0.1:8787`）。
+
+**流程**
+
+1. 多轮对话 → 确认卡 → 自动验收  
+2. 浏览 / 扫描 / 点选产品仓派工（非 git 目录会自动 `git init -b develop`；没有 develop/main/master 会自动建本地 `develop`）  
+3. 只选 **CLI 数字员工**：**Cursor Agent** 或 **Claude Code**（未装 Cursor 时页面会提示：`curl https://cursor.com/install -fsS | bash`）  
+4. 编辑「启动命令」（须以 `Agent` 开头）→ 派工建 `.worktree/feat-*`，并打开 **Terminal** 跑对应 CLI  
+5. 页面轮询 `tasks.md` 进度；`delivery.json` 为 `accepted` 后出现 **查看成品**（`preview.url`，或自动发现 `index.html`）
 
 ### 目录不要同名套娃