duaer-spec 0.14.0 → 0.15.0

package/.duaer/active-job.json

@@ -1,6 +1,6 @@
 {
-  "featureDir": ".duaer/specs/053-release-014",
-  "branch": "feat/release-014",
-  "worktree": ".worktree/feat-release-014",
+  "featureDir": ".duaer/specs/055-release-015",
+  "branch": "feat/release-015",
+  "worktree": ".worktree/feat-release-015",
   "status": "active"
 }

package/.duaer/memory/testing.md

@@ -1,21 +1,22 @@
 # Testing expectations (project contract)
 
 Agents **must** read this file before marking work verified or accepting a job.
-Replace command examples with the adopting project's real scripts. Keep the
-level model and risk rules unless an ADR documents a change.
+This file is the **duaer-spec** repo contract. Adopters replace command examples
+with their product scripts; keep the level model and risk rules unless an ADR
+documents a change.
 
 ## Levels
 
-| Level | What | Typical commands (replace) | Default owner |
+| Level | What | Typical commands (this repo) | Default owner |
 |---|---|---|---|
-| **L0** | Lint / typecheck / static | `npm run lint`, `tsc --noEmit` | After every implementation pass |
-| **L1** | Unit tests for changed modules | `npm test` (or package subset) | Default for code changes |
+| **L0** | Lint / typecheck / static | `node --check bin/duaer-live.mjs` `node --check web/live-dev/app.js` | After every implementation pass |
+| **L1** | Unit tests for changed modules | `npm test` when unit files exist under `test/` | Default for code changes |
 | **L2** | Integration / product acceptance at changed boundaries | project acceptance or integration suite | When boundaries or core paths change |
-| **L3** | Automated E2E / browser for user-visible paths | `npm run test:e2e` or equivalent **subset** | When UI / protocol UX changes |
+| **L3** | Automated E2E / protocol smoke for user-visible paths | **`npm run test:live`** (live desk shell + `/api/validate` gate; mock LLM, no paid API) | When live desk UI / protocol UX changes |
 | **L4** | Manual account / device path when automation cannot cover auth or real data | documented steps in the Brief | When UI/auth and no automated substitute |
 
 IDE Browser / MCP exploration is **optional discovery**. It does **not** replace
-L3 automation when the project has an E2E suite.
+L3 when `npm run test:live` covers the touched path.
 
 ## Risk table (what to run)
 
@@ -24,12 +25,25 @@ L3 automation when the project has an E2E suite.
 | Docs / comments only | None (note in Brief) |
 | Internal code, same behavior | L0 + L1 for affected packages |
 | API / data / core path | L0 + L1 + L2 (or documented equivalent) |
-| User-visible or protocol-visible UI/UX | L0 + L1 + **L3 subset for touched flows** + update E2E catalog |
+| User-visible or protocol-visible UI/UX (live desk) | L0 + **`npm run test:live` (L3)** + update E2E catalog |
 | Auth / payments / irreversible ops | Above + L4 if L3 cannot cover |
 
 Prefer **targeted subsets** over full monorepo suites. Do not skip a required
 level without an explicit waiver in the feature docs (`tasks.md` or Spec).
 
+## Live desk L3 (`npm run test:live`)
+
+Covers without a paid LLM:
+
+1. Desk shell HTML/CSS/JS markers (three columns, structured confirm fields,
+   `validationAllowsSend`)
+2. Local validate failures (empty / too-short card)
+3. `/api/validate` pass and `/api/validate/fix` via an in-process mock
+   OpenAI-compatible server
+
+Does **not** cover: real model quality, Terminal CLI launch, or full revise
+dispatch. Those stay manual E2E catalog rows or future suites.
+
 ## Opt-in (still need an explicit ask or Spec note)
 
 Mark these in the project table when they are expensive:

package/.duaer/specs/054-live-l3-smoke/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "summary": "Added npm run test:live L3 smoke for desk shell + validate gate; documented in manuals and testing.md; CI on develop/main.",
+  "verification": {
+    "levels": ["L0", "L3"],
+    "commands": ["npm run test:live", "node --check bin/duaer-live.mjs"],
+    "notes": "Mock LLM; no paid API. E2E-054."
+  }
+}

package/.duaer/specs/054-live-l3-smoke/spec.md

@@ -0,0 +1,41 @@
+# Feature Specification: Live desk L3 smoke suite
+
+**Feature Branch**: `feat/live-l3-smoke`
+
+**Created**: 2026-09-17
+
+**Status**: Active
+
+## Goal
+
+Add an automated L3 smoke suite for the live desk (confirm validate gate +
+desk shell markers) that agents run before accept on live UI changes, and
+document it in the manuals / testing contract.
+
+## In scope
+
+- `npm run test:live` — start isolated live + mock LLM; cover validate fail/pass,
+  validate/fix path, static desk markers (three columns, structured fields,
+  validationAllowsSend)
+- Wire into `.duaer/memory/testing.md` as the L3 command for this repo
+- Update README EN/ZH + CHANGELOG + E2E catalog
+- Optional lightweight CI job on push/PR
+
+## Out of scope
+
+- Full Playwright browser interaction / paid live LLM
+- Revise Terminal dispatch end-to-end
+- npm version bump / publish (docs only unless user asks)
+
+## Acceptance
+
+1. `npm run test:live` passes without network LLM
+2. Covers: empty/short card fail, good card pass via mock, fix endpoint,
+   HTML/JS/CSS desk markers for layout + gate
+3. README (EN/ZH) and testing.md document the command
+4. E2E catalog notes automated subset
+
+## Assumptions
+
+- Worktree: `.worktree/feat-live-l3-smoke`
+- Brief: `.duaer/specs/054-live-l3-smoke/`

package/.duaer/specs/054-live-l3-smoke/tasks.md

@@ -0,0 +1,10 @@
+# Tasks: Live desk L3 smoke suite
+
+**Brief**: `.duaer/specs/054-live-l3-smoke/`
+
+## Checklist
+
+- [x] Add `test/live-smoke.test.mjs` + mock LLM helper
+- [x] `package.json` script `test:live`; update testing.md
+- [x] README EN/ZH + CHANGELOG + E2E-054; CI workflow
+- [x] Run `npm run test:live`; accept; merge develop

package/.duaer/specs/055-release-015/delivery.json

@@ -0,0 +1,8 @@
+{
+  "status": "accepted",
+  "summary": "Release 0.15.0 with live L3 smoke suite.",
+  "verification": {
+    "levels": ["L3"],
+    "commands": ["npm run test:live"]
+  }
+}

package/.duaer/specs/055-release-015/spec.md

@@ -0,0 +1,16 @@
+# Feature Specification: Release 0.15.0
+
+**Feature Branch**: `feat/release-015`
+
+**Created**: 2026-09-17
+
+**Status**: Active
+
+## Goal
+
+Ship **0.15.0** (live L3 smoke) to main + npm.
+
+## Acceptance
+
+1. package.json 0.15.0; CHANGELOG section dated
+2. main tagged v0.15.0; GitHub Release; npm latest 0.15.0

package/.duaer/specs/055-release-015/tasks.md

@@ -0,0 +1,4 @@
+# Tasks: Release 0.15.0
+
+- [x] Bump 0.15.0 + CHANGELOG
+- [ ] Promote main; push; tag; gh release

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.15.0 — 2026-09-17
+
+### Live desk L3 smoke
+
+- `npm run test:live` — automated desk shell + `/api/validate` / `/api/validate/fix` with mock LLM
+- Documented in `.duaer/memory/testing.md`, README EN/ZH; CI runs on push/PR to develop/main
+
 ## 0.14.0 — 2026-09-17
 
 ### Live desk layout

package/README.md

@@ -64,6 +64,10 @@ Open the printed URL (default `http://127.0.0.1:8787`). The desk is **full-width
 with three columns: **chat** | **requirements / confirm / dispatch / revise** |
 **task progress**.
 
+**Verify (maintainers / agents):** after live desk UI or validate-gate changes,
+run `npm run test:live` (L3 smoke: desk shell markers + `/api/validate` with a
+mock LLM — no paid API).
+
 **Flow**
 
 1. Dialogue → fill the confirm card (structured goal / out-of-scope / acceptance /

package/README.zh-CN.md

@@ -64,6 +64,10 @@ duaer live
 浏览器打开提示地址（默认 `http://127.0.0.1:8787`）。台面**全屏宽**，三列：
 **对话** | **需求 / 确认 / 派工 / 改进** | **任务进度**。
 
+**验收（维护者 / 数字员工）：** 改现场台 UI 或确认校验门禁后，跑
+`npm run test:live`（L3 冒烟：台面结构标记 + `/api/validate`，内置 mock 模型，
+不产生付费 API 调用）。
+
 **流程**
 
 1. 多轮对话 → 确认卡（目标 / 不做 / 验收 / 假设，结构化展示）。须**校验通过**后才能点确认；失败可自动修订  

package/docs/agent/e2e-test-plan.md

@@ -66,6 +66,7 @@ the table for their app.
 | E2E-051 | Validate-before-send: Confirm and revise-dispatch stay blocked until `/api/validate` passes for current card fields; fail shows issues + auto-fix; agent launch prompt forbids Confirming-intent / multi-choice re-confirm | manual |
 | E2E-052 | Confirm column wider than chat; requirements (and revise) fields fully expanded without inner scroll; structured paragraphs/lists display with click-to-edit | manual |
 | E2E-053 | Full-screen desk (no 1440 shell cap); chat column ~50px wider than prior confirm-wide min; confirm still wider than chat | manual |
+| E2E-054 | Live L3 smoke: `npm run test:live` covers desk shell markers + validate fail/pass + validate/fix via mock LLM (no paid API) | `npm run test:live` |
 | E2E-041 | Busy Terminal runner: revise/re-dispatch queues (`pending.cmd`), waits (no interrupt); API `queued`/`busy`/`reused`; UI does not claim agent already started | manual |
 | E2E-007 | Request worktrees use `.worktree/<id>`; `.worktree/` gitignored | manual |
 | E2E-008 | Docs require main+develop+feat+fix and typed go-live flows | manual |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "duaer-spec",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Digital employees for Cursor, Claude, Codex, Copilot, Windsurf, Cline, Continue, Gemini, Aider",
   "type": "module",
   "bin": {
@@ -63,6 +63,8 @@
   "license": "MIT",
   "scripts": {
     "duaer": "node ./bin/duaer.mjs",
-    "live": "node ./bin/duaer-live.mjs"
+    "live": "node ./bin/duaer-live.mjs",
+    "test": "node --test test/**/*.test.mjs",
+    "test:live": "node --test test/live-smoke.test.mjs"
   }
 }