duaer-spec 0.22.0 → 0.23.1

package/.duaer/active-job.json

@@ -1,5 +1,4 @@
 {
-  "featureDir": ".duaer/specs/205-release-022",
-  "slug": "205-release-022",
-  "updatedAt": "2026-09-19T07:35:00.000Z"
+  "feature": "212-release-0231",
+  "specDir": ".duaer/specs/212-release-0231"
 }

package/.duaer/specs/205-release-022/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T07:37:00.000Z",
+  "verification": {
+    "levels": ["L1"],
+    "commands": ["npm test (168 pass)", "gh release v0.22.0", "npm view duaer-spec version → 0.22.0"],
+    "result": "pass"
+  },
+  "summary": "Released 0.22.0 to GitHub and npm (ja locale + atomic tasks)."
+}

package/.duaer/specs/205-release-022/tasks.md

@@ -2,5 +2,5 @@
 
 - [x] T001 Bump package.json to 0.22.0 and move CHANGELOG Unreleased
 - [x] T002 Merge release branch to develop
-- [ ] T003 Promote develop → main, push, tag, gh release, npm
-- [ ] T004 Stamp delivery accepted
+- [x] T003 Promote develop → main, push, tag, gh release, npm
+- [x] T004 Stamp delivery accepted

package/.duaer/specs/206-employee-directory/delivery.json

@@ -0,0 +1,13 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T12:45:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1", "L3"],
+    "commands": [
+      "npm test (173 pass)",
+      "npm run test:live"
+    ],
+    "result": "pass"
+  },
+  "summary": "Top employee directory with Implementer + Functional regression; task roles and verify-l3 lane assignment."
+}

package/.duaer/specs/206-employee-directory/spec.md

@@ -0,0 +1,32 @@
+# Feature Specification: Digital employee directory + role specialization
+
+**Feature Branch**: `feat/employee-directory`
+
+## Goal
+
+Add a top-bar **数字员工** directory listing specialized employees. Seed at
+least: **Implementer** and **Functional regression** (Acceptance → Playwright /
+testing.md L3). Kickoff tasks carry a `role`; multi-worker dispatch prefers
+verify-l3 tasks on a dedicated lane.
+
+## In scope
+
+- Top button + drawer (same pattern as Projects)
+- Catalog: implementer + regression (capabilities copy via i18n zh/en/ja)
+- Task pool `role: implement | verify-l3`; markdown shows role
+- When workerCount ≥ 2, assign verify-l3 tasks to the last worker lane
+- Kickoff prompts include role blurb for owned roles
+- Docs / E2E / tests
+
+## Out of scope
+
+- New CLI runtimes (still Cursor / Claude)
+- jev-ultrafast / browser-use agent
+- User-editable custom employees
+
+## Acceptance
+
+1. Top bar has 数字员工; drawer lists implementer + regression with capability text
+2. Kickoff task-pool.json tasks include `role`
+3. workerCount≥2 puts verify-l3 tasks on last worker
+4. Unit tests + E2E catalog row; live smoke markers if needed

package/.duaer/specs/206-employee-directory/tasks.md

@@ -0,0 +1,6 @@
+# Tasks
+
+- [x] T001 Employee catalog module + task role on pool
+- [x] T002 Top directory drawer UI + i18n
+- [x] T003 Assign verify-l3 to last lane; kickoff role prompts
+- [x] T004 Docs tests CHANGELOG stamp

package/.duaer/specs/207-fix-projects-root-pick/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T12:55:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["node --check bin/duaer-live.mjs", "npm test (173 pass)"],
+    "result": "pass"
+  },
+  "summary": "Parent folder picker activates Finder (frontmost) and path field click opens pick; async so HTTP stays responsive."
+}

package/.duaer/specs/207-fix-projects-root-pick/spec.md

@@ -0,0 +1,20 @@
+# Fix: projects parent folder picker unusable
+
+## Symptom
+
+Clicking 产品父目录 / 选择… does not yield a usable folder choice (dialog
+behind other windows, or readonly field ignores clicks).
+
+## Cause
+
+`pickFolderNative` uses `osascript choose folder` without activating a UI
+app, so the dialog often stays behind the browser. The path field is
+readonly with no click handler.
+
+## Acceptance
+
+1. Clicking **选择…** or the readonly parent path opens a frontmost macOS
+   folder dialog (Finder-activated).
+2. Pick is async (HTTP event loop not blocked by spawnSync).
+3. Cancel leaves previous `projectsRoot` unchanged.
+4. Unit markers + L0 check.

package/.duaer/specs/207-fix-projects-root-pick/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [x] T001 Async Finder-activated pickFolderNative
+- [x] T002 Path field click opens pick; tests/docs
+- [x] T003 Stamp accepted

package/.duaer/specs/208-arch-click-fullscreen/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T13:10:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["node --test test/arch-fullscreen.test.mjs test/live-archify.test.mjs", "npm test"],
+    "result": "pass"
+  },
+  "summary": "Architecture mount click opens present fullscreen only; embed node zoom disabled."
+}

package/.duaer/specs/208-arch-click-fullscreen/spec.md

@@ -0,0 +1,24 @@
+# Spec: Architecture click opens fullscreen only
+
+## Goal
+
+On the live desk system-architecture (and same-style) mounts, a click opens the
+fullscreen present view. Node zoom / enlarge-on-click in the embed is removed.
+
+## In scope
+
+- Host click (capture) opens `present=1` fullscreen and stops Archify node zoom
+- Disable desk embed `installDesktopReveal` zoom path
+- Update E2E catalog lines that still require embed node zoom
+
+## Out of scope
+
+- Changing fullscreen present page itself
+- Removing the explicit「全屏查看」button
+
+## Acceptance
+
+- [ ] Clicking the architecture diagram opens fullscreen present (new tab)
+- [ ] Clicking a node does not zoom / enlarge that node in the desk embed
+- [ ] Task-path / revise mounts keep the same click → fullscreen behavior
+- [ ] Tests and E2E catalog match the new behavior

package/.duaer/specs/208-arch-click-fullscreen/tasks.md

@@ -0,0 +1,6 @@
+# Tasks
+
+- [x] T001 Capture-phase click opens present; stop Archify node handlers
+- [x] T002 Disable embed node zoom in architecture-mount
+- [x] T003 Update E2E / CHANGELOG / unit tests
+- [x] T004 Verify and stamp accepted

package/.duaer/specs/209-orch-wave-deadlock/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T13:20:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["npm test (173 pass)"],
+    "result": "pass"
+  },
+  "summary": "Wave continue enqueues while lane busy; agents exit after wave instead of silent hang deadlock."
+}

package/.duaer/specs/209-orch-wave-deadlock/spec.md

@@ -0,0 +1,27 @@
+# Spec: Fix orchestration wave deadlock after silent wait
+
+## Goal
+
+After a wave finishes and `tasks.md` is checked, the orchestrator must release
+the next ready wave. Agents must not sit in a live Terminal session waiting —
+that keeps `lane_busy` and blocks continue forever.
+
+## In scope
+
+- Prompt: after a wave, exit the CLI session so the runner becomes idle /
+  can drain a queued `--continue`
+- `pendingWaveReleases`: enqueue next wave even when the lane is busy
+  (FIFO serialize); do not stall on `lane_busy`
+- Accept-nudge: same enqueue-when-busy behavior
+- Docs / tests / E2E note
+
+## Out of scope
+
+- Changing dependsOn / atomic task splitting
+- Fixing polluted startCommand content from other projects (separate)
+
+## Acceptance
+
+- [ ] Status with T001 done + next wave ready enqueues/releases while lane busy
+- [ ] Prompts no longer tell the agent to 静默停等 with the session held open
+- [ ] Unit tests updated; npm test passes

package/.duaer/specs/209-orch-wave-deadlock/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [x] T001 Enqueue next wave even when lane busy
+- [x] T002 Prompt: exit session after wave (no silent hang)
+- [x] T003 Tests, CHANGELOG, E2E; stamp accepted

package/.duaer/specs/210-release-023/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T13:20:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": ["npm test (173 pass)", "gh release v0.23.0", "npm view duaer-spec version → 0.23.0"],
+    "result": "pass"
+  },
+  "summary": "Released 0.23.0 to GitHub and npm (employee directory, picker, arch fullscreen, orch deadlock)."
+}

package/.duaer/specs/210-release-023/spec.md

@@ -0,0 +1,12 @@
+# 210 — Release 0.23.0
+
+## Goal
+
+Ship 0.23.0: bump version + CHANGELOG, promote develop → main, push,
+GitHub Release `v0.23.0`, trigger npm Trusted Publishing.
+
+## Acceptance
+
+1. `package.json` is `0.23.0`; CHANGELOG has `0.23.0` section (Unreleased cleared).
+2. `develop` and `main` both contain the release; tag `v0.23.0` pushed.
+3. GitHub Release `v0.23.0` published; npm shows `duaer-spec@0.23.0`.

package/.duaer/specs/210-release-023/tasks.md

@@ -0,0 +1,6 @@
+# Tasks
+
+- [x] T001 Bump package.json to 0.23.0 and move CHANGELOG Unreleased
+- [x] T002 Merge release branch to develop
+- [x] T003 Promote develop → main, push, tag, gh release, npm
+- [x] T004 Stamp delivery accepted

package/.duaer/specs/211-plain-features/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T13:30:00.000Z",
+  "verification": {
+    "levels": ["L0"],
+    "commands": ["rg -n '我们有什么|What you get' README.zh-CN.md README.md"],
+    "result": "pass"
+  },
+  "summary": "READMEs list product capabilities in plain language (editor employee + live desk)."
+}

package/.duaer/specs/211-plain-features/spec.md

@@ -0,0 +1,12 @@
+# Spec: Plain-language feature overview in READMEs
+
+## Goal
+
+Add a human-readable “what you get” feature list to `README.zh-CN.md` and
+`README.md` so readers see capabilities without jargon-first flow dumps.
+
+## Acceptance
+
+- [ ] Chinese README has a 人话「我们有什么」section covering desk + employee core
+- [ ] English README has a matching plain-language “What you get” section
+- [ ] No CJK in English README; Chinese README may keep English product terms

package/.duaer/specs/211-plain-features/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [x] T001 Add 人话 feature section to README.zh-CN.md
+- [x] T002 Add matching plain section to README.md
+- [x] T003 CHANGELOG + stamp accepted

package/.duaer/specs/212-release-0231/spec.md

@@ -0,0 +1,12 @@
+# 212 — Release 0.23.1
+
+## Goal
+
+Ship 0.23.1: plain-language README feature overview. Bump, CHANGELOG,
+promote develop → main, push, GitHub Release, npm Trusted Publishing.
+
+## Acceptance
+
+1. `package.json` is `0.23.1`; CHANGELOG has `0.23.1` (Unreleased cleared).
+2. Tag `v0.23.1` on main; GitHub Release published.
+3. npm shows `duaer-spec@0.23.1`.

package/.duaer/specs/212-release-0231/tasks.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [ ] T001 Bump to 0.23.1 and move CHANGELOG
+- [ ] T002 Merge to develop; promote main; push; tag; gh release; npm
+- [ ] T003 Stamp accepted

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 ## Unreleased
 
+## 0.23.1 — 2026-09-19
+
+### Docs: plain-language feature overview in READMEs
+
+- Chinese「我们有什么」and English「What you get」list desk + employee capabilities
+  without jargon-first flow dumps
+
+## 0.23.0 — 2026-09-19
+
+### Fix: orchestration wave release no longer deadlocks on silent wait
+
+- Next ready wave is FIFO-enqueued even when the Terminal lane is busy
+- After a wave, agents exit the CLI session (no hang waiting for continue)
+
+### Fix: architecture embed click opens fullscreen only
+
+- Desk diagram click (capture) opens present fullscreen and does not zoom nodes
+- Embed `reveal` zoom path disabled; focus-chip hidden on the mount
+
+### Fix: projects parent folder picker frontmost + clickable path
+
+- macOS folder dialog activates Finder so it is not buried behind the browser
+- Pick is async (no spawnSync on the HTTP thread)
+- Clicking the readonly parent path also opens the picker
+
+### Feat: digital employee directory + role specialization
+
+- Top bar **数字员工** drawer lists Implementer and Functional regression
+- Kickoff tasks carry `role: implement | verify-l3`; multi-worker puts
+  verify-l3 on the last lane; prompts include role blurbs
+
 ## 0.22.0 — 2026-09-19
 
 ### Feat: Japanese (ja) live desk locale

package/README.md

@@ -45,6 +45,40 @@ Install writes host adapters for each (see [`ADOPT.md`](ADOPT.md)).
 
 Chinese guide: [`README.zh-CN.md`](README.zh-CN.md)
 
+## What you get (plain language)
+
+After install, these are the capabilities you actually use:
+
+### In your editor: a digital employee that delivers
+
+- **You talk; it runs the process.** No slash commands, no “you must run Spec phases.”
+- **Clarify before coding.** It turns your ask into: what to build, what not to build, how we know it’s done.
+- **Done means accepted.** It only claims finished when acceptance checks out — not when code merely exists.
+- **Works in many hosts.** Cursor, Claude Code, Codex, Copilot, Windsurf, Cline, Continue, Gemini, Aider.
+
+### In the browser: Duaer-spec FDE (live desk)
+
+A local web desk (`duaer live`) for “chat → confirm → dispatch → watch → open result”:
+
+- **Projects.** Create and switch projects; each keeps its own chat and progress.
+- **Chat until the ask is clear.** Left chat; center confirm cards (goal / out of scope / checkable acceptance). Vague acceptance cannot be confirmed.
+- **Split big work into modules.** Confirm module by module; nothing starts until you kick off after the ones you care about are confirmed.
+- **Architecture diagram.** After requirements, review the system diagram; click it for fullscreen; kickoff waits until architecture is confirmed.
+- **Dispatch digital employees to code.** Pick a product folder and Cursor Agent or Claude Code; work happens in an isolated worktree, not directly on your long-lived branches.
+- **Visible task progress.** Work is a checklist; each finished item is checked off and the desk refreshes; dependent tasks release in waves so agents don’t pile on blocked work.
+- **Employee roles.** Top-bar **digital employee** directory: Implementer builds features; Functional regression verifies against acceptance and testing rules. Optional parallel workers on the same CLI.
+- **zh-CN / en / ja UI.** Desk copy follows the language you pick.
+- **Deliverables and results.** Open a deliverables page (requirements, architecture, tasks, delivery); when done, open the page or the project folder.
+- **Revise when it’s not right.** Continue in left chat → re-confirm → relaunch on the same job without starting from scratch.
+- **Hosting when you need it.** Cloudflare / Alibaba Cloud / AWS / GitHub Pages; default is GitHub Actions when unset.
+
+### Repo habits (for humans and employees)
+
+- **Clear branches:** `main` for production, `develop` for day-to-day, short `feat`/`fix` branches merge back to `develop`.
+- **Isolated changes:** each request uses its own worktree; after merge, clean up and hand local services back to the primary checkout.
+
+The sections below are **how to run it**; this section is **what it can do**.
+
 ## What the employee does (by itself)
 
 1. Turns your ask into a Brief with **checkable acceptance**  

package/README.zh-CN.md

@@ -12,6 +12,40 @@
 
 `init` / `update` 会写入各宿主适配文件（详见 [`ADOPT.md`](ADOPT.md)）。
 
+## 我们有什么（人话）
+
+装好之后，你主要用到的是这些能力：
+
+### 在编辑器里：数字员工帮你干活
+
+- **你说人话，它自己跑流程。** 不用记 slash 命令、不用自己点「写 Spec / 拆任务」。
+- **先谈清楚再动手。** 它会把你的想法整理成：要做什么、不做什么、怎样算做完。
+- **做完才算完。** 对照验收通过才会说「交付好了」；半成品不会假装完成。
+- **多宿主可用。** Cursor、Claude Code、Codex、Copilot、Windsurf、Cline、Continue、Gemini、Aider 都行。
+
+### 在浏览器里：Duaer-spec FDE（现场台面）
+
+本机开一个网页台面（`duaer live`），专门管「从聊需求到派工、看进度、看结果」：
+
+- **项目管理。** 建项目、切换项目；每个项目自己的对话和进度，互不搅在一起。
+- **聊着把需求聊清楚。** 左边聊天；中间把目标、边界、验收写成确认卡；空话验收过不了，得能检查才给确认。
+- **大需求可拆成多个模块。** 一块一块确认，确认完一块不会立刻开工，全部谈妥再一起派。
+- **系统架构图。** 确认需求后一起看架构；点图可全屏查看；架构确认后才能派工。
+- **一键派数字员工写代码。** 选产品目录、选 Cursor Agent 或 Claude Code，点开工；它在隔离目录里改代码，不直接乱动你的主分支。
+- **任务进度看得见。** 任务拆成一条条可勾选项；做完勾一项，台面实时刷新；有依赖的任务会排队放行，不会一窝蜂乱做。
+- **数字员工分工。** 顶部有「数字员工」目录：实现员工负责写功能，功能回归负责按验收和测试规则验；可开多个并行（同一套 CLI）。
+- **中 / 英 / 日界面。** 台面文案可切换语种。
+- **看交付物和结果。** 可打开交付物页（需求、架构、任务、交付记录）；做完了可打开页面或项目文件夹。
+- **不满意就继续改。** 左侧继续聊改进 → 再确认 → 同一次任务上续派，不用从头建仓。
+- **要上线时可选托管。** Cloudflare / 阿里云 / AWS / GitHub Pages；没选时默认走 GitHub Actions。
+
+### 仓库规矩（给协作和数字员工用）
+
+- **分支分清楚：** `main` 上线、`develop` 日常、功能/修 bug 用短分支，做完合回 `develop`。
+- **隔离改动：** 每次任务在独立 worktree 里做，做完合并、清理，本地服务交回主目录。
+
+下面「安装 / 更新 / FDE 流程」是怎么用；上面这一节是**能干什么**。
+
 ## 安装
 
 ```bash