duaer-spec 0.27.2 → 0.27.3

package/.duaer/active-job.json

@@ -1,5 +1,5 @@
 {
-  "feature": "281-release-0272",
-  "branch": "feat/release-0272",
-  "worktree": ".worktree/feat-release-0272"
+  "feature": "291-release-0273",
+  "branch": "chore/release-0273",
+  "worktree": ".worktree/chore-release-0273"
 }

package/.duaer/specs/281-release-0272/delivery.json

@@ -0,0 +1,8 @@
+{
+  "status": "accepted",
+  "summary": "Released 0.27.2: architecture clean-flow, project create uniqueness, FDE-08. Tag v0.27.2 published.",
+  "verification": {
+    "commands": ["gh release view v0.27.2"],
+    "result": "GitHub Release published; npm Trusted Publishing via release event"
+  }
+}

package/.duaer/specs/281-release-0272/tasks.md

@@ -1,4 +1,4 @@
 # Tasks — 281-release-0272
 
 - [x] Bump package.json to 0.27.2 and move CHANGELOG Unreleased
-- [ ] Promote develop → main, tag, GitHub Release
+- [x] Promote develop → main, tag, GitHub Release

package/.duaer/specs/282-dispatch-confirm-lock/delivery.json

@@ -0,0 +1,12 @@
+{
+  "status": "accepted",
+  "summary": "After confirm+build, 确认人数并生成派工图 stays locked (chips too) until the dispatch graph is invalidated.",
+  "verification": {
+    "commands": [
+      "node --check web/live-dev/app.js",
+      "node --test test/task-graph.test.mjs test/live-i18n-common.test.mjs test/live-i18n-ja.test.mjs",
+      "npm run test:live"
+    ],
+    "result": "all pass"
+  }
+}

package/.duaer/specs/282-dispatch-confirm-lock/spec.md

@@ -0,0 +1,26 @@
+# Feature Specification: Lock confirm-workers after dispatch graph
+
+## Goal
+
+After the operator confirms worker count and the dispatch graph builds
+successfully, **确认人数并生成派工图** stays locked so it cannot be
+re-clicked. Worker-count chips lock with it. Unlock only when the graph
+becomes stale (count/decompose/architecture invalidate).
+
+## In scope
+
+- Keep confirm button disabled + locked label when `dispatchGraphReady`
+- Lock worker-count chips while the graph is ready
+- Re-enable when the graph is marked stale or cleared
+- i18n + desk docs + E2E catalog + regression markers
+
+## Out of scope
+
+- Changing how the graph is generated
+- Locking「查看派工图」
+
+## Acceptance
+
+1. After a successful confirm+build, the confirm button is disabled and shows a locked label.
+2. Changing architecture / re-decompose / clearing ready unlocks the button again.
+3. `node --test test/task-graph.test.mjs` and live i18n key parity pass.

package/.duaer/specs/282-dispatch-confirm-lock/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 282-dispatch-confirm-lock
+
+- [x] Lock confirm button + worker chips when dispatchGraphReady
+- [x] Unlock on stale / arch invalidate; sync on project restore
+- [x] i18n + docs + tests

package/.duaer/specs/283-desk-theme-compact/delivery.json

@@ -0,0 +1,12 @@
+{
+  "status": "accepted",
+  "summary": "Compact FDE desk with calm slate light/dark themes and a persistent top-bar toggle.",
+  "verification": {
+    "commands": [
+      "node --check web/live-dev/app.js",
+      "node --test test/desk-theme.test.mjs test/live-i18n-common.test.mjs test/live-i18n-ja.test.mjs",
+      "npm run test:live"
+    ],
+    "result": "all pass"
+  }
+}

package/.duaer/specs/283-desk-theme-compact/spec.md

@@ -0,0 +1,26 @@
+# Feature Specification: Compact desk theme with light/dark toggle
+
+## Goal
+
+Make the FDE desk easier to stare at for long sessions: tighter spacing,
+calmer colors (less orange glow / hatch noise), and a light/dark theme
+toggle that persists.
+
+## In scope
+
+- Compact shell / header / layout / panel spacing
+- Soft dark + light palettes via `html[data-theme]`
+- Top-bar theme toggle; persist in `localStorage`; early boot to avoid flash
+- Same theme on dispatch-center page
+- i18n + docs + smoke markers
+
+## Out of scope
+
+- Redesigning Archify diagram chrome
+- Per-project theme overrides
+
+## Acceptance
+
+1. Desk feels denser (smaller brand, tighter gaps/padding).
+2. Light and dark themes both readable; toggle switches and persists across reload.
+3. `npm run test:live` and i18n key parity pass.

package/.duaer/specs/283-desk-theme-compact/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 283-desk-theme-compact
+
+- [x] CSS: compact density + light/dark palettes
+- [x] Theme toggle + persist + dispatch-center wire
+- [x] i18n + docs + tests

package/.duaer/specs/284-dispatch-graph-regen/delivery.json

@@ -0,0 +1,12 @@
+{
+  "status": "accepted",
+  "summary": "Each architecture/improve wave forces a fresh 派工图; confirm button shows regenerate when rebuilding; stale clears old URL.",
+  "verification": {
+    "commands": [
+      "node --check web/live-dev/app.js",
+      "node --test test/task-graph.test.mjs test/live-i18n-common.test.mjs test/live-i18n-ja.test.mjs",
+      "npm run test:live"
+    ],
+    "result": "all pass"
+  }
+}

package/.duaer/specs/284-dispatch-graph-regen/spec.md

@@ -0,0 +1,33 @@
+# Feature Specification: Regenerate dispatch graph each wave
+
+## Goal
+
+Every kickoff wave (first delivery and each **改进**) must build a **new**
+派工图. Confirm/lock buttons follow the operator flow: unlock and ask to
+regenerate when the wave changes; stay locked only for the current ready graph.
+
+## Findings (current gaps)
+
+1. `showDispatchPanel` reuses an old `taskPool` after architecture confirm and
+   does not force a fresh decompose / clear graph URL.
+2. `enterReviseMode` (再改一版) does not clear graph ready/URL/pool.
+3. `markDispatchGraphStale` leaves `dispatchGraphUrl` pointing at an old file.
+4. Button copy does not distinguish first confirm vs regenerate after stale.
+
+## In scope
+
+- Reset + redecompose on architecture confirm and revise entry
+- Clear URL on stale/invalidate; sync chips/button
+- Button labels: confirm / regenerate / locked
+- Docs + tests
+
+## Out of scope
+
+- Changing Archify render pipeline internals
+
+## Acceptance
+
+1. After「再改一版」→ plan → architecture confirm, confirm-workers is unlocked
+   and builds a new graph (new URL); old ready state is not reused.
+2. Stale / re-decompose / baseline open-change unlocks and prompts regenerate.
+3. `node --test` markers and live smoke pass.

package/.duaer/specs/284-dispatch-graph-regen/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 284-dispatch-graph-regen
+
+- [x] Central resetDispatchGraphForNewWave; call from arch confirm / revise / baseline
+- [x] showDispatchPanel always fresh pool after arch confirm; clear URL on stale
+- [x] Button labels confirm / regen / locked + i18n + tests

package/.duaer/specs/285-desk-light-compact/delivery.json

@@ -0,0 +1,11 @@
+{
+  "status": "accepted",
+  "summary": "Light theme uses shared tokens for inputs/composer/bubbles; denser compact spacing.",
+  "verification": {
+    "commands": [
+      "node --test test/desk-theme.test.mjs",
+      "npm run test:live"
+    ],
+    "result": "all pass"
+  }
+}

package/.duaer/specs/285-desk-light-compact/spec.md

@@ -0,0 +1,13 @@
+# Feature Specification: Light theme contrast + denser compact
+
+## Goal
+
+Fix unreadable black/dark hardcodes in light theme and tighten desk density
+another step.
+
+## Acceptance
+
+1. Light theme inputs, composer, chat bubbles, and primary/confirm buttons
+   use theme tokens and stay readable.
+2. Shell spacing is tighter than the previous compact pass.
+3. `node --test test/desk-theme.test.mjs` and `npm run test:live` pass.

package/.duaer/specs/285-desk-light-compact/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 285-desk-light-compact
+
+- [x] Replace dark hardcodes with theme tokens; improve light contrast
+- [x] Tighten compact spacing tokens
+- [x] Docs + tests + delivery

package/.duaer/specs/286-modules-bug-theme/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-23T09:45:00.000Z",
+  "verification": {
+    "L0": "node --check web/live-dev/app.js bin/live-modules.mjs web/live-dev/task-graph.mjs",
+    "L1": "npm test (pass)",
+    "L3": "npm run test:live (pass)"
+  },
+  "summary": "Bug path appends defect tab without wiping modules; light theme inset tokens; bug pool prefers id=bug."
+}

package/.duaer/specs/286-modules-bug-theme/spec.md

@@ -0,0 +1,26 @@
+# Feature Specification: Keep modules clickable during bug + theme leftovers
+
+## Goal
+
+After「改缺陷」, prior requirement module tabs must stay visible and clickable
+(view). Fix remaining light-theme dark overlays that still look wrong.
+
+## Cause
+
+`enterDeskKind("bug")` / `beginBugFixFromCta` replaced `state.modules` with a
+single bug card, and `renderModuleTabs` hid tabs when `deskKind === "bug"`.
+
+## In scope
+
+- Preserve feature modules; append/select a `bug` module instead of wiping
+- Show module tabs in bug mode; feature tabs viewable (readonly when confirmed)
+- Theme: replace leftover `rgba(8,14,20,…)` wells with tokens
+- Docs + tests
+
+## Acceptance
+
+1. After starting a defect from a multi-module feature project, prior module
+   tabs remain and switching shows that module's card (readonly if confirmed).
+2. Bug module is editable; confirming the defect does not delete feature modules.
+3. Light theme no longer uses fixed near-black overlay fills on wells.
+4. Targeted tests pass.

package/.duaer/specs/286-modules-bug-theme/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 286-modules-bug-theme
+
+- [x] Preserve modules on bug entry; show tabs; chat merge keeps features
+- [x] Theme overlay leftovers → tokens
+- [x] Tests + docs + delivery

package/.duaer/specs/287-progress-modules-ux/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-23T09:55:00.000Z",
+  "verification": {
+    "L0": "node --check web/live-dev/app.js bin/duaer-live.mjs bin/live-modules.mjs",
+    "L1": "npm test (pass)",
+    "L3": "npm run test:live (pass)"
+  },
+  "summary": "Bug confirm merges modules so prior tabs survive; progress run-blocks use inset tokens; denser desk spacing."
+}

package/.duaer/specs/287-progress-modules-ux/spec.md

@@ -0,0 +1,31 @@
+# Feature Specification: Progress theme + bug modules survive confirm
+
+## Goal
+
+Light theme「派工进度」must not look dark. Desk denser / smoother. After
+entering defect path (and after confirming the defect), prior requirement
+module tabs must stay visible.
+
+## Cause
+
+`/api/confirm` (bug) returned a one-item `modules` list (`bug` only). Client
+`applyConfirmSuccess` replaced `state.modules`, wiping feature tabs. Progress
+`.run-block` still used fixed dark `rgba(26,40,54,…)` fills.
+
+## In scope
+
+- Server + client: bug confirm merges into existing modules (keep features)
+- Progress column theme tokens + denser spacing / smoother scroll feel
+- Docs + tests (E2E catalog)
+
+## Out of scope
+
+- Changing bug task pool shape or hotfix branch rules
+
+## Acceptance
+
+1. Enter「改缺陷」with ≥1 prior module → tabs show prior + bug; after confirm
+   defect, prior tabs remain.
+2. Light theme progress run blocks / meters use theme inset tokens (no near-black
+   hardcodes).
+3. Progress column padding/gaps tighter than pre-fix; targeted tests pass.

package/.duaer/specs/287-progress-modules-ux/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 287-progress-modules-ux
+
+- [x] Bug confirm merge keeps feature modules (API + client)
+- [x] Progress column theme + denser compact
+- [x] Tests + docs + delivery + merge handoff

package/.duaer/specs/288-settings-close-compact/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-23T10:05:00.000Z",
+  "verification": {
+    "L0": "node --check web/live-dev/app.js",
+    "L1": "npm test (pass)",
+    "L3": "npm run test:live (pass)"
+  },
+  "summary": "Settings closes without ready gate; gear reopen keeps ready; denser drawers/shell."
+}

package/.duaer/specs/288-settings-close-compact/spec.md

@@ -0,0 +1,17 @@
+# Feature Specification: Settings always closable + denser desk
+
+## Goal
+
+Settings drawer must close via 关闭 / backdrop / gear toggle / Escape even when
+the model is not configured. Make drawers and shell denser.
+
+## Cause
+
+Close handlers gated on `state.ready`; gear toggle only closes when ready.
+Escape did not dismiss drawers.
+
+## Acceptance
+
+1. Settings closes without `state.ready` (button, backdrop, gear, Escape).
+2. Drawers and shell spacing tighter than pre-fix.
+3. Targeted tests pass.

package/.duaer/specs/288-settings-close-compact/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 288-settings-close-compact
+
+- [x] Remove ready gate on settings close; Escape closes drawers
+- [x] Densify drawers + shell tokens
+- [x] Tests + docs + delivery + merge

package/.duaer/specs/289-settings-close-click/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-23T10:35:00.000Z",
+  "verification": {
+    "L0": "node --check web/live-dev/app.js",
+    "L1": "npm test (pass)",
+    "L3": "npm run test:live (pass)"
+  },
+  "summary": "Cache-bust app.js/styles.css; harden Settings close with closeSettingsDrawer + capture listener."
+}

package/.duaer/specs/289-settings-close-click/spec.md

@@ -0,0 +1,16 @@
+# Feature Specification: Settings close click must work
+
+## Goal
+
+The Settings「关闭」button must dismiss the drawer on click.
+
+## Cause
+
+Close was gated on `state.ready` in older builds; `app.js?v=perf-budget-1`
+cache kept serving that gate after the logic fix.
+
+## Acceptance
+
+1. Clicking「关闭」hides `#settingsPanel` (with or without model ready).
+2. Cache-bust query on `app.js` / `styles.css` so operators get the fix.
+3. Tests assert no ready-gate and bumped asset version.

package/.duaer/specs/289-settings-close-click/tasks.md

@@ -0,0 +1,4 @@
+# Tasks — 289-settings-close-click
+
+- [x] Bump asset cache + harden close (delegation)
+- [x] Tests + docs + merge handoff

package/.duaer/specs/290-remove-quicknav/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-23T10:40:00.000Z",
+  "verification": {
+    "L0": "node --check web/live-dev/app.js",
+    "L1": "npm test (pass)",
+    "L3": "npm run test:live (pass)"
+  },
+  "summary": "Removed chat column 导航 quick-nav control (HTML/CSS/JS)."
+}

package/.duaer/specs/290-remove-quicknav/spec.md

@@ -0,0 +1,11 @@
+# Feature Specification: Remove chat 导航 button
+
+## Goal
+
+Remove the chat-column「导航」quick-nav control.
+
+## Acceptance
+
+1. Desk HTML has no `#chatQuickNav` / `.chat-quicknav`.
+2. App does not wire quick-nav.
+3. Docs / E2E / smoke updated; cache bust applied.

package/.duaer/specs/290-remove-quicknav/tasks.md

@@ -0,0 +1,4 @@
+# Tasks — 290-remove-quicknav
+
+- [x] Remove HTML / CSS / JS for chat quick-nav
+- [x] Tests + docs + delivery + merge

package/.duaer/specs/291-release-0273/spec.md

@@ -0,0 +1,12 @@
+# Feature Specification: Release 0.27.3
+
+## Goal
+
+Ship 0.27.3: desk theme/compact UX, bug-path module tabs, Settings close,
+progress theme, remove chat 导航. Promote develop → main, GitHub Release,
+npm Trusted Publishing.
+
+## Acceptance
+
+1. `package.json` is `0.27.3`; CHANGELOG has `0.27.3` and an empty Unreleased section.
+2. Tag `v0.27.3` is on `main`; GitHub Release is published; npm has 0.27.3.

package/.duaer/specs/291-release-0273/tasks.md

@@ -0,0 +1,4 @@
+# Tasks — 291-release-0273
+
+- [x] Bump package.json to 0.27.3 and move CHANGELOG Unreleased
+- [ ] Promote develop → main, tag, GitHub Release, npm

package/CHANGELOG.md

@@ -2,6 +2,62 @@
 
 ## Unreleased
 
+## 0.27.3 — 2026-09-23
+
+### Fix: remove chat「导航」control
+
+- Drop the floating quick-nav button and menu from the chat column
+
+### Fix: Settings「关闭」click + cache bust
+
+- Bump `app.js` / `styles.css` query so browsers drop the old ready-gated close
+- Harden close via `closeSettingsDrawer` + capture-phase panel listener
+- Larger close hit target; drop sticky-head clip that could swallow clicks
+
+### Fix: Settings always closable + denser drawers
+
+- Close Settings without model ready (关闭 / backdrop / gear / Escape)
+- Re-opening Settings from the gear no longer clears `ready`
+- Tighter shell, buttons, and settings drawer spacing
+
+### Fix: progress theme + bug confirm keeps requirement tabs
+
+- Confirming a defect merges into existing modules (API no longer returns
+  bug-only list that wiped prior tabs)
+- Client hardens applyConfirmSuccess; restores a Main tab from originalCard
+  when an older wipe left only `bug`
+- Progress run blocks / meters use inset tokens; denser progress + shell spacing
+
+### Fix: keep requirement modules clickable during bug path
+
+-「改缺陷」appends a `bug` tab instead of wiping prior modules; tabs stay
+  visible; confirmed feature cards are readonly when selected
+- Bug task pool prefers the `bug` module when feature modules are also confirmed
+- Light theme wells/borders use `--inset*` / `--line` (no fixed near-black fills)
+
+### Fix: light theme contrast and denser compact spacing
+
+- Replace leftover dark hardcodes (inputs, composer, bubbles, wells) with
+  theme tokens so light mode text/controls stay readable
+- Primary/confirm buttons use on-accent / lock tokens; tighten shell density
+
+### Fix: regenerate dispatch graph on every improve wave
+
+- Architecture confirm always starts a fresh task pool and unlocked confirm
+- 「再改一版」clears the prior 派工图; button shows「重新确认并生成派工图」
+- Stale / re-decompose clears the old graph URL so view cannot open a leftover
+
+### Feat: compact desk theme with light/dark toggle
+
+- Tighter shell, header, columns, and field spacing
+- Calmer slate palettes (soft blue accent; no orange glow / hatch)
+- Top-bar light/dark toggle persists across reload (desk + dispatch center)
+
+### Fix: lock confirm-workers after dispatch graph builds
+
+- After「确认人数并生成派工图」succeeds, the button stays locked (and worker
+  chips disable) until the graph is invalidated
+
 ## 0.27.2 — 2026-09-23
 
 ### Fix: bottom-via edge labels stay under the floor

package/bin/duaer-live.mjs

@@ -113,6 +113,7 @@ import {
   clipActiveModuleId,
   modulesAllConfirmed,
   confirmModuleInList,
+  mergeBugModuleIntoList,
   aggregateModulesCard,
   buildTaskPoolFromModules,
   buildBugTaskPool,
@@ -6720,15 +6721,7 @@ async function handleApi(req, res) {
             "main";
       let modules =
         deskKind === "bug"
-          ? [
-              {
-                id: "bug",
-                title: "缺陷",
-                status: "draft",
-                card: acceptedCard,
-                dependsOn: [],
-              },
-            ]
+          ? mergeBugModuleIntoList(incomingModules, acceptedCard)
           : clipModules(incomingModules, acceptedCard);
       if (!modules.length) {
         modules = [
@@ -6742,7 +6735,10 @@ async function handleApi(req, res) {
         ];
       }
       modules = confirmModuleInList(modules, moduleId, acceptedCard);
-      const allConfirmed = modulesAllConfirmed(modules);
+      const allConfirmed =
+        deskKind === "bug"
+          ? modules.some((m) => m.id === "bug" && m.status === "confirmed")
+          : modulesAllConfirmed(modules);
       // Per-module confirm never writes Brief / launches agents — kickoff owns that.
       send(res, 200, {
         ok: true,
@@ -6842,15 +6838,7 @@ async function handleApi(req, res) {
             "main";
       let modules =
         deskKind === "bug"
-          ? [
-              {
-                id: "bug",
-                title: "缺陷",
-                status: "draft",
-                card: acceptedCard,
-                dependsOn: [],
-              },
-            ]
+          ? mergeBugModuleIntoList(incomingModules, acceptedCard)
           : clipModules(incomingModules, acceptedCard);
       if (!modules.length) {
         modules = [
@@ -6864,7 +6852,10 @@ async function handleApi(req, res) {
         ];
       }
       modules = confirmModuleInList(modules, moduleId, acceptedCard);
-      const allConfirmed = modulesAllConfirmed(modules);
+      const allConfirmed =
+        deskKind === "bug"
+          ? modules.some((m) => m.id === "bug" && m.status === "confirmed")
+          : modulesAllConfirmed(modules);
       send(res, 200, {
         ok: true,
         passed: true,

package/bin/live-modules.mjs

@@ -246,6 +246,25 @@ export function confirmModuleInList(modules, moduleId, card) {
   );
 }
 
+/**
+ * Keep prior requirement modules when confirming a defect.
+ * Replaces only the `bug` slot (or appends it) instead of wiping the list.
+ */
+export function mergeBugModuleIntoList(existing, bugCard, { title = "缺陷" } = {}) {
+  const kept = clipModules(existing).filter((m) => m.id !== "bug");
+  const card = clipCard(bugCard);
+  return [
+    ...kept,
+    {
+      id: "bug",
+      title: String(title || "缺陷").slice(0, 80),
+      status: "draft",
+      card,
+      dependsOn: [],
+    },
+  ];
+}
+
 /** Aggregate confirmed modules into one Brief-shaped card. */
 export function aggregateModulesCard(modules) {
   const list = clipModules(modules).filter((m) => m.status === "confirmed");
@@ -276,11 +295,12 @@ export function aggregateModulesCard(modules) {
  */
 export function buildBugTaskPool(modules, { deployNeeded = false, deployTaskText = null } = {}) {
   const list = clipModules(modules).filter((m) => m.status === "confirmed");
+  const pick = list.find((m) => m.id === "bug") || list[0];
   const card =
-    list[0]?.card ||
+    pick?.card ||
     ({ goal: "", outOfScope: "", acceptance: "", assumptions: "" });
-  const modId = list[0]?.id || "bug";
-  const title = String(list[0]?.title || "Bug").slice(0, 80);
+  const modId = pick?.id || "bug";
+  const title = String(pick?.title || "Bug").slice(0, 80);
   const tasks = [];
   let n = 1;
   const push = (partial) => {