duaer-spec 0.19.0 → 0.20.0

package/.duaer/active-job.json

@@ -1,5 +1,5 @@
 {
-  "feature": "188-release-019",
-  "spec": ".duaer/specs/188-release-019/spec.md",
-  "updatedAt": "2026-09-19T00:00:00.000Z"
+  "feature": "192-release-020",
+  "spec": ".duaer/specs/192-release-020/spec.md",
+  "updatedAt": "2026-09-19T02:50:00.000Z"
 }

package/.duaer/specs/188-release-019/delivery.json

@@ -0,0 +1,18 @@
+{
+  "status": "accepted",
+  "feature": "188-release-019",
+  "acceptedAt": "2026-09-19T00:00:00.000Z",
+  "summary": "0.19.0 shipped: develop+main pushed, tag v0.19.0, GitHub Release, npm publish success.",
+  "verification": {
+    "commands": [
+      "git push origin develop main v0.19.0",
+      "gh release create v0.19.0",
+      "gh run watch npm-publish"
+    ],
+    "results": "CI pass; Pages pass; npm publish success"
+  },
+  "preview": {
+    "url": "https://www.npmjs.com/package/duaer-spec/v/0.19.0",
+    "label": "npm 0.19.0"
+  }
+}

package/.duaer/specs/188-release-019/tasks.md

@@ -1,6 +1,6 @@
 # Tasks — 188-release-019
 
 - [x] Brief
-- [ ] Bump 0.19.0 + CHANGELOG
-- [ ] Merge to develop; promote main; push; tag; gh release
-- [ ] Watch npm publish / stamp delivery
+- [x] Bump 0.19.0 + CHANGELOG
+- [x] Merge to develop; promote main; push; tag; gh release
+- [x] Watch npm publish / stamp delivery

package/.duaer/specs/189-fde-portfolio/delivery.json

@@ -0,0 +1,10 @@
+{
+  "status": "accepted",
+  "feature": "189-fde-portfolio",
+  "acceptedAt": "2026-09-19T02:30:00.000Z",
+  "verification": {
+    "L0": "node --check app.js delivery-status.mjs live-projects.mjs",
+    "L1": "node --test test/delivery-status.test.mjs test/live-projects.test.mjs (9 pass)",
+    "L3": "npm run test:live (pass)"
+  }
+}

package/.duaer/specs/189-fde-portfolio/spec.md

@@ -0,0 +1,29 @@
+# 189 — FDE project portfolio status strip
+
+## Goal
+
+Operators see each project’s delivery status at a glance in the Projects drawer,
+open deliverables in one click, and get a clear next action in the Progress
+column — without learning Duaer phases.
+
+## In scope
+
+- Derive status: drafting / confirming / building / delivered / revising
+- Enrich `GET /api/projects` project rows with status + nextAction + hasDeliverables
+- Portfolio list: status chip + open-deliverables control
+- Progress: stage strip + next-action line; deliverables CTA stays primary
+- Docs (live-desk) + E2E + L0/L3
+
+## Out of scope
+
+- Dedicated cloud / multi-user accounts
+- Session export/import
+- Changing BYOC deploy hosts
+
+## Acceptance
+
+1. `/api/projects` includes `deliveryStatus` and `nextAction` per project when a
+   session exists (or sensible defaults when empty).
+2. Portfolio row shows a status chip; deliverables openable when `hasDeliverables`.
+3. Progress column shows stage summary + next-action copy for the active desk.
+4. `npm test` (targeted) + `npm run test:live` pass.

package/.duaer/specs/189-fde-portfolio/tasks.md

@@ -0,0 +1,8 @@
+# Tasks — 189-fde-portfolio
+
+- [x] Brief + active-job
+- [x] `delivery-status.mjs` derive status / nextAction / stages
+- [x] Enrich `/api/projects` via live-projects / duaer-live
+- [x] Portfolio UI chips + deliverables
+- [x] Progress cockpit (stages + next action)
+- [x] i18n, CSS, docs, E2E, verify, merge

package/.duaer/specs/190-live-open-no-model/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "feature": "190-live-open-no-model",
+  "acceptedAt": "2026-09-19T02:45:00.000Z",
+  "verification": {
+    "L1": "node --test test/live-open-no-model.test.mjs",
+    "L3": "npm run test:live"
+  }
+}

package/.duaer/specs/190-live-open-no-model/spec.md

@@ -0,0 +1,17 @@
+# 190 — Live starts without model gate; open desk URL
+
+## Goal
+
+`duaer live` must not require a configured model before serving. Always start
+the desk, open `http://127.0.0.1:<port>` in the browser, and guide the operator
+to Settings when the model is missing.
+
+## Acceptance
+
+1. `serve()` does not exit or block when `configReady` is false.
+2. After listen, the desk URL is opened (macOS `open` / Linux `xdg-open`).
+3. Console copy points to in-page Settings, not “must run live config first”.
+4. UI shows the desk even when not ready; Settings opens as guidance; Settings
+   can be closed and reopened via the header control.
+5. Chat/API that need a model still fail clearly until configured.
+6. L0 + targeted tests / live smoke markers pass.

package/.duaer/specs/190-live-open-no-model/tasks.md

@@ -0,0 +1,6 @@
+# Tasks — 190-live-open-no-model
+
+- [x] Brief
+- [x] Open browser URL on serve; soft console hint
+- [x] UI: show desk without model; allow closing Settings
+- [x] Tests + docs + merge

package/.duaer/specs/191-projects-root-pick/delivery.json

@@ -0,0 +1,11 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T02:45:00.000Z",
+  "verification": {
+    "L0": "node --check bin/duaer-live.mjs; node --check web/live-dev/app.js",
+    "L1": "node --test test/live-repo-path.test.mjs test/live-projects.test.mjs",
+    "L3": "npm run test:live",
+    "result": "pass"
+  },
+  "summary": "产品父目录 uses native folder pick (选择…/清除); no path typing."
+}

package/.duaer/specs/191-projects-root-pick/spec.md

@@ -0,0 +1,14 @@
+# 191 — Pick projects parent folder (no typing)
+
+## Goal
+
+Operators choose the **产品父目录** via the system folder dialog, not by
+typing a path. Selection saves immediately.
+
+## Acceptance
+
+1. Projects drawer shows parent path as read-only display (not a free-text field).
+2. A **选择…** control opens the native folder picker and saves `projectsRoot`.
+3. Cancel leaves the previous value unchanged.
+4. Optional clear control empties `projectsRoot`.
+5. L0 + smoke/unit markers + merge to develop.

package/.duaer/specs/191-projects-root-pick/tasks.md

@@ -0,0 +1,6 @@
+# Tasks — 191-projects-root-pick
+
+- [x] Brief
+- [x] API pick-root + pickFolderNative prompt
+- [x] UI: readonly path + 选择… / 清除
+- [x] i18n, tests, docs, merge

package/.duaer/specs/192-release-020/spec.md

@@ -0,0 +1,12 @@
+# 192 — Release 0.20.0
+
+## Goal
+
+Ship 0.20.0: bump version + CHANGELOG, promote develop → main, push,
+GitHub Release `v0.20.0`, trigger npm Trusted Publishing.
+
+## Acceptance
+
+1. `package.json` is `0.20.0`; CHANGELOG has `0.20.0` section (Unreleased cleared).
+2. `develop` and `main` pushed with release commits.
+3. GitHub Release `v0.20.0` published; npm publish workflow run succeeds or documented.

package/.duaer/specs/192-release-020/tasks.md

@@ -0,0 +1,6 @@
+# Tasks — 192-release-020
+
+- [x] Brief
+- [ ] Bump 0.20.0 + CHANGELOG
+- [ ] Merge to develop; promote main; push; tag; gh release
+- [ ] Watch npm publish / stamp delivery

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## Unreleased
 
+## 0.20.0 — 2026-09-19
+
+### Feat: pick projects parent folder via system dialog
+
+- 产品父目录 is read-only; **选择…** opens the native folder picker and saves
+- **清除** empties `projectsRoot`; cancel leaves the previous path
+
+### Fix: `duaer live` opens without model gate
+
+- Desk starts and opens the browser even when no model is configured
+- Settings guides model setup instead of blocking launch
+
+### Feat: FDE portfolio status and delivery cockpit
+
+- Project list shows delivery status chips and open-deliverables actions
+- Progress column shows stage summary, next action, and deliverables CTA
+
 ## 0.19.0 — 2026-09-19
 
 ### Feat: modular `[模块]` structured requirement cards

package/README.md

@@ -61,16 +61,18 @@ Isolated from product repos. Config and Briefs live under `~/.duaer/live/`.
 **Duaer-spec FDE** = Field Development Environment.
 
 ```bash
-# DeepSeek (recommended)
+# Start anytime (opens the desk even if the model is not configured yet)
+duaer live
+
+# In the page Settings, or via CLI:
 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
 ```
 
-Open the printed URL (default `http://127.0.0.1:8787`). The desk is **full-width**
+`duaer live` opens the browser to the desk URL (default `http://127.0.0.1:8787`).
+If the model is missing, use **Settings** in the page. The desk is **full-width**
 with three columns: **chat** | **modules / confirm / architecture / kickoff /
 revise** | **task progress**. Detail:
 [`docs/agent/live-desk.md`](docs/agent/live-desk.md).
@@ -81,9 +83,10 @@ mock LLM — no paid API).
 
 **Flow**
 
-1. Open or create a **project**, then chat. Messy multi-topic talk is fine: the
-   desk evolves **`modules[]`** (tabs). Chat bubbles render **Markdown**
-   (`**bold**`, code, links).  
+1. Open or create a **project**, then chat. The **Projects** drawer shows each
+   project’s **delivery status**; open **Deliverables** when the session has
+   content. Messy multi-topic talk is fine: the desk evolves **`modules[]`**
+   (tabs). Chat bubbles render **Markdown** (`**bold**`, code, links).  
 2. Per module: fill the confirm card (goal / out-of-scope / **checkable**
    acceptance / assumptions). Vague acceptance fails the gate; validate must
    pass before **Confirm**. Confirming a module **locks that card only** — it
@@ -104,11 +107,12 @@ mock LLM — no paid API).
    - To run **DeepSeek or other models** for coding, point Claude Code at that API — see [`docs/agent/worker-models.md`](docs/agent/worker-models.md). The FDE setup page guide covers the same.  
 6. Edit the start command (must begin with `Duaer`) → kickoff creates
    `.worktree/feat-*` and opens **Terminal** for each worker lane.  
-7. Watch progress in the right column (`tasks.md`). **View deliverables** (above
-   progress) opens a generated HTML page of stage artifacts (requirements doc
-   timeline, confirmation, architecture, task pool, delivery). On delivery,
-   workers update the product **README** before `delivery.json` is `accepted`.
-   Then open **Results** (**View result** when a page exists, otherwise **Open
+7. Progress shows a **next-action** stage strip, then `tasks.md` polling.
+   **View deliverables** (above progress) opens a generated HTML page of stage
+   artifacts (requirements doc timeline, confirmation, architecture, task pool,
+   delivery). On delivery, workers update the product **README** before
+   `delivery.json` is `accepted`. Then open **Results** (**View result** when a
+   page exists, otherwise **Open
    project folder**).  
 8. If the result is not right: **Continue improving (left chat)** → confirm the
    revise card (same validate gate) → re-confirm architecture (keep or redesign)

package/README.zh-CN.md

@@ -56,7 +56,10 @@ npx duaer-spec update
 **Duaer-spec FDE** = Field Development Environment（现场开发）。
 
 ```bash
-# DeepSeek（推荐）
+# 启动（任意目录都行，不会写入当前项目；未配模型也会打开台面）
+duaer live
+
+# 在打开的页面「设置」里填模型，或用 CLI：
 duaer live config --provider deepseek --api-key sk-...
 
 # 在产品仓登记，派工时点选（可选）
@@ -64,12 +67,10 @@ duaer live repo add
 
 # 或任意 OpenAI 兼容接口
 duaer live config --base-url https://api.openai.com/v1 --api-key sk-... --model gpt-4o-mini
-
-# 启动（任意目录都行，不会写入当前项目）
-duaer live
 ```
 
-浏览器打开提示地址（默认 `http://127.0.0.1:8787`）。台面**全屏宽**，三列：
+启动后会自动打开浏览器（默认 `http://127.0.0.1:8787`）。未配置模型时请在页面
+**设置**里填写并保存。台面**全屏宽**，三列：
 **对话** | **模块 / 确认 / 架构 / 开工 / 改进** | **任务进度**。细则见
 [`docs/agent/live-desk.md`](docs/agent/live-desk.md)。
 
@@ -79,7 +80,7 @@ duaer live
 
 **流程**
 
-1. 打开或新建**项目**，再聊天。话题可以乱跳：台面会演进 **`modules[]`**（模块页签）。气泡支持 **Markdown**（加粗、代码、链接）。  
+1. 打开或新建**项目**，再聊天。右上角「项目」列表会显示每个项目的**交付状态**；有内容时可直接打开**交付物**。话题可以乱跳：台面会演进 **`modules[]`**（模块页签）。气泡支持 **Markdown**（加粗、代码、链接）。  
 2. **按模块**填确认卡（目标 / 不做 / **可检查验收** / 假设）。空泛验收过不了门禁；须校验通过才能点确认。确认只**锁住该模块卡**，**不会**立刻写 Brief 或开工。模块之间可随时切换。  
 3. 关心的模块都确认完 → 审 / 确认**架构**（Archify）→ **开工（kickoff）**。开工才写 Brief，建带 **`dependsOn` 的任务池**，并分派。默认 **1** 个数字员工；可选 **N** 个同 CLI 并行。共享任务给 1 号；模块任务轮询。每个 worker 独占一条 **Terminal 队列泳道**（`live-terminal` / `live-terminal/w2`…）。  
 4. 浏览 / 扫描 / 点选产品仓，或粘贴路径 / 项目名。路径不存在会自动创建；可先设**产品父目录**，再填短名在其下新建。非 git 目录会 `git init -b develop`；没有 develop/main/master 会建本地 `develop`。  
@@ -88,7 +89,7 @@ duaer live
    - Claude Code：`npm install -g @anthropic-ai/claude-code`（或 `curl -fsSL https://claude.ai/install.sh | bash`）  
    - 要用 **DeepSeek 等其它模型**写代码：把 Claude Code 接到对应 API，见 [`docs/agent/worker-models.zh-CN.md`](docs/agent/worker-models.zh-CN.md)。FDE「配置模型」页下方也有同样说明。  
 6. 编辑「启动命令」（须以 `Duaer` 开头）→ 开工建 `.worktree/feat-*`，并为每条 worker 泳道打开 **Terminal**。  
-7. 右侧进度列轮询 `tasks.md`。进度上方 **查看交付物** 会打开生成的 HTML 页（需求文档时间线、确认书、架构、任务池、交付等）。交付时数字员工先更新产品仓 **README**，再把 `delivery.json` 标为 `accepted`。然后出现 **结果**（有页面时 **查看结果**；否则 **打开项目目录**）。  
+7. 右侧进度列先提示**下一步**（阶段条），并轮询 `tasks.md`。进度上方 **查看交付物** 会打开生成的 HTML 页（需求文档时间线、确认书、架构、任务池、交付等）。交付时数字员工先更新产品仓 **README**，再把 `delivery.json` 标为 `accepted`。然后出现 **结果**（有页面时 **查看结果**；否则 **打开项目目录**）。  
 8. 成品不满意：点 **继续改进（左侧对话）** → 确认改进卡（同样须校验）→ 再确认架构（保留或重画）→ 同 worktree 续派（先清残留 Agent 再入队）。进度跟本轮 `R{n}-*`。启动失败会回滚本轮 Brief Revision；状态行按泳道显示 Terminal 忙闲/队列。  
 9. 若需要上线 / 公网：在台面选 **计划托管平台**（Cloudflare / 阿里云 / AWS / GitHub Pages），说明见 [`docs/agent/deploy-targets.md`](docs/agent/deploy-targets.md)。未指定时默认 **GitHub CLI（`gh`）+ Actions**（[`docs/agent/deploy-github.md`](docs/agent/deploy-github.md)）
 

package/bin/duaer-live.mjs

@@ -50,6 +50,7 @@ import {
 } from "./live-repo-path.mjs";
 import {
   buildProjectList,
+  enrichProjectsWithDeliveryStatus,
   normalizeProjectKey,
 } from "./live-projects.mjs";
 import {
@@ -1572,11 +1573,12 @@ function discoverRepos({ max = 40 } = {}) {
   );
 }
 
-function pickFolderNative() {
+function pickFolderNative(promptText = "选择产品仓库") {
+  const prompt = String(promptText || "选择产品仓库").trim() || "选择产品仓库";
   if (process.platform === "darwin") {
     const r = spawnSync(
       "osascript",
-      ["-e", 'POSIX path of (choose folder with prompt "选择产品仓库")'],
+      ["-e", `POSIX path of (choose folder with prompt ${JSON.stringify(prompt)})`],
       { encoding: "utf8", timeout: 300000 },
     );
     const err = String(r.stderr || "").trim();
@@ -1602,7 +1604,7 @@ function pickFolderNative() {
   if (process.platform === "linux") {
     const r = spawnSync(
       "zenity",
-      ["--file-selection", "--directory", "--title=选择产品仓库"],
+      ["--file-selection", "--directory", `--title=${prompt}`],
       { encoding: "utf8", timeout: 300000 },
     );
     if (r.status !== 0) {
@@ -2035,6 +2037,9 @@ function listProjectsPayload() {
     jobs,
     activeProjectPath: cfg.activeProjectPath,
   });
+  enrichProjectsWithDeliveryStatus(bag, (projectPath) =>
+    readProjectChat(liveRoot(), projectPath),
+  );
   return {
     ...bag,
     projectsRoot: cfg.projectsRoot || "",
@@ -6425,6 +6430,31 @@ async function handleApi(req, res) {
     return;
   }
 
+  if (req.method === "POST" && url.pathname === "/api/projects/pick-root") {
+    try {
+      const chosen = pickFolderNative("选择产品父目录");
+      const abs = path.resolve(String(chosen || "").trim()).replace(/[\\/]+$/, "");
+      if (!abs || !fs.existsSync(abs) || !fs.statSync(abs).isDirectory()) {
+        throw new Error("请选择一个有效的文件夹");
+      }
+      const next = writeConfig({ projectsRoot: abs });
+      send(res, 200, {
+        ok: true,
+        projectsRoot: abs,
+        ...publicConfig(next),
+        ...listProjectsPayload(),
+      });
+    } catch (err) {
+      const code = err && err.code;
+      send(res, 400, {
+        error: err instanceof Error ? err.message : "pick root failed",
+        cancelled: code === "CANCELLED",
+        code: code || undefined,
+      });
+    }
+    return;
+  }
+
   if (req.method === "GET" && url.pathname === "/api/projects/chat") {
     try {
       const projectPath = String(url.searchParams.get("path") || "").trim();
@@ -6659,6 +6689,25 @@ function cmdConfig(opts) {
   }
 }
 
+function openDeskInBrowser(url) {
+  const target = String(url || "").trim();
+  if (!target) return;
+  try {
+    if (process.platform === "darwin") {
+      spawn("open", [target], { detached: true, stdio: "ignore" }).unref();
+    } else if (process.platform === "win32") {
+      spawn("cmd", ["/c", "start", "", target], {
+        detached: true,
+        stdio: "ignore",
+      }).unref();
+    } else {
+      spawn("xdg-open", [target], { detached: true, stdio: "ignore" }).unref();
+    }
+  } catch {
+    /* ignore — operator can open the printed URL */
+  }
+}
+
 function serve(port) {
   if (!fs.existsSync(WEB_ROOT)) {
     console.error("Missing web/live-dev");
@@ -6678,19 +6727,19 @@ function serve(port) {
   });
 
   server.listen(port, "127.0.0.1", () => {
+    const deskUrl = `http://127.0.0.1:${port}`;
     const cfg = publicConfig();
-    console.log(`Duaer-spec FDE  http://127.0.0.1:${port}`);
+    console.log(`Duaer-spec FDE  ${deskUrl}`);
     console.log(`隔离目录  ${liveRoot()}`);
     console.log(`Brief 写入 ${jobsRoot()}  （不会写入你当前业务仓库）`);
     if (!cfg.ready) {
-      console.log(`
-模型未配置。请先：
-  duaer live config --provider deepseek --api-key <key>
-  或页面里点「DeepSeek」再填 Key。
-`);
+      console.log(
+        `模型尚未配置 — 已打开台面，请在页面「设置」里填写模型后保存。`,
+      );
     } else {
       console.log(`模型      ${cfg.model} @ ${cfg.baseUrl}`);
     }
+    openDeskInBrowser(deskUrl);
     scheduleUpdateHint();
     void refreshUpdateInfo({ force: false });
     // Background: every 10 days check/upgrade Cursor Agent / Claude Code CLIs

package/bin/live-projects.mjs

@@ -3,6 +3,7 @@
  */
 
 import { basename } from "node:path";
+import { deriveProjectDeliveryStatus } from "../web/live-dev/delivery-status.mjs";
 
 /**
  * @param {string | null | undefined} p
@@ -21,6 +22,34 @@ export function normalizeProjectKey(p) {
   }
 }
 
+/**
+ * Attach deliveryStatus / nextAction / hasDeliverables from a session reader.
+ * @param {ReturnType<typeof buildProjectList>} bag
+ * @param {(projectPath: string) => object|null|undefined} readSession
+ */
+export function enrichProjectsWithDeliveryStatus(bag, readSession) {
+  const projects = Array.isArray(bag?.projects) ? bag.projects : [];
+  for (const p of projects) {
+    let session = null;
+    try {
+      session = typeof readSession === "function" ? readSession(p.path) : null;
+    } catch {
+      session = null;
+    }
+    const latestJob = Array.isArray(p.jobs) && p.jobs.length ? p.jobs[0] : null;
+    const derived = deriveProjectDeliveryStatus(session, {
+      jobStatus: latestJob?.status || null,
+      deliveryAccepted:
+        String(latestJob?.status || "").toLowerCase() === "accepted",
+    });
+    p.deliveryStatus = derived.status;
+    p.nextAction = derived.nextAction;
+    p.hasDeliverables = derived.hasDeliverables;
+    p.stageSummary = derived.stages;
+  }
+  return bag;
+}
+
 /**
  * Build project rows from remembered repos + jobs.
  * @param {{
@@ -34,7 +63,7 @@ export function buildProjectList(input = {}) {
   const jobs = Array.isArray(input.jobs) ? input.jobs : [];
   const active = normalizeProjectKey(input.activeProjectPath);
 
-  /** @type {Map<string, { path: string, name: string, title: string, description: string, lastUsedAt: string|null, jobs: typeof jobs }>} */
+  /** @type {Map<string, object>} */
   const map = new Map();
 
   function ensure(pathRaw, meta = {}) {
@@ -52,6 +81,10 @@ export function buildProjectList(input = {}) {
         description: descHint,
         lastUsedAt: lastUsedAt || null,
         jobs: [],
+        deliveryStatus: "drafting",
+        nextAction: "chat",
+        hasDeliverables: false,
+        stageSummary: [],
       };
       map.set(key, row);
     } else {

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

@@ -131,10 +131,13 @@ the table for their app.
 | E2E-149 | 初版 · 需求卡 accordion body uses structured lists/paragraphs (`req-list` / `req-para`); goal prose does not shatter on `、` | `npm test` + `npm run test:live` |
 | E2E-150 | Requirements click-to-edit then blur without changes keeps field text (no wipe) | `npm run test:live` + manual |
 | E2E-151 | Modular `[模块]` card fields render section titles + numbered acceptance lists | `npm test` + `npm run test:live` |
+| E2E-152 | Project portfolio shows delivery status chips + open deliverables; Progress shows stage next-action | `npm test` + `npm run test:live` |
+| E2E-153 | `duaer live` starts without model config, opens desk URL, Settings guides setup | `npm test` + `npm run test:live` |
+| E2E-154 | 产品父目录 is read-only; 选择… opens native folder pick and saves; 清除 empties; no path typing | `npm test` + manual |
 | E2E-093 | Header top actions share one button chrome; GitHub control links to duaer-spec and shows live stars via `/api/github` | `npm run test:live` + manual |
 | E2E-063 | Duaer-spec FDE brand: header/title show Duaer-spec FDE; zh secondary mark is 现场开发; en mark is Field Development Environment; setup hint / desk-model guide name Duaer | `npm test` + manual |
 | E2E-078 | Claude Terminal launch includes `--permission-mode bypassPermissions` and stamps `hasTrustDialogAccepted` for the worktree | `npm test` + manual |
-| E2E-077 | Missing product path auto-created; projectsRoot saves parent; relative name creates under parent | `npm test` + manual |
+| E2E-077 | Missing product path auto-created; projectsRoot via native folder pick (no typing); relative name creates under parent | `npm test` + manual |
 | E2E-076 | Worker CLIs are Cursor Agent + Claude Code only; no deepseek-tui worker; tutorial docs/agent/worker-models(.zh-CN).md | `npm test` + manual |
 | E2E-075 | DeepSeek Terminal launch uses `deepseek -w <worktree> --yolo` (not `--workspace`); job exits 0 when CLI present | `npm test` + manual |
 | E2E-074 | Missing git: auto-install then init; worker CLIs versioned; 10-day auto-upgrade stamp under `~/.duaer/cli-tools-check.json` (opt-out `DUAER_NO_CLI_UPGRADE=1`) | `npm test` + manual |
@@ -307,3 +310,6 @@ the table for their app.
 | E2E-149 | `185-req-card-structure` | structured 初版需求卡 accordion |
 | E2E-150 | `186-req-edit-wipe` | click-edit blur must not wipe fields |
 | E2E-151 | `187-req-card-modules` | modular `[模块]` structured sections |
+| E2E-152 | `189-fde-portfolio` | portfolio status + delivery cockpit |
+| E2E-153 | `190-live-open-no-model` | live opens desk without model gate |
+| E2E-154 | `191-projects-root-pick` | projectsRoot via native folder pick |

package/docs/agent/live-desk.md

@@ -4,6 +4,10 @@ Field Development Environment for digital employees. Config and Briefs live unde
 `~/.duaer/live/`. Product work runs in isolated worktrees inside the chosen
 product repo.
 
+`duaer live` always starts the desk and opens the browser URL. A missing model
+does not block startup — the Settings drawer opens so the operator can save
+credentials, then chat.
+
 Also see root [`README.md`](../../README.md) (EN) / [`README.zh-CN.md`](../../README.zh-CN.md).
 
 ## Layout
@@ -14,7 +18,24 @@ Three columns:
 |---|---|
 | Chat | Project dialogue; Markdown bubbles; messy multi-topic talk |
 | Center | Module tabs + confirm cards → architecture → kickoff / revise |
-| Progress | **View deliverables** (opens generated HTML) · `tasks.md` polling · result bar |
+| Progress | Delivery cockpit (stages + next action) · **View deliverables** · `tasks.md` polling · result bar |
+
+## Project portfolio
+
+The **Projects** drawer lists remembered product folders. Each row shows a
+**delivery status** chip (`drafting` / `confirming` / `building` / `delivered` /
+`revising`) derived from the per-project session under
+`~/.duaer/live/project-chats/`. When the session has anything to show, a short
+**Deliverables** control opens the dossier without hunting through progress.
+
+`GET /api/projects` includes `deliveryStatus`, `nextAction`, and
+`hasDeliverables` on each project row.
+
+## Delivery cockpit (Progress)
+
+With an active project, Progress shows a stage strip (requirements →
+architecture → kickoff → delivery → revise) and one **next action** line in
+plain language. **View deliverables** stays the primary CTA above the strip.
 
 ## Stage deliverables page
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "duaer-spec",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Norms → satisfactory delivery: digital employees for Cursor, Claude, Codex, Copilot, Windsurf, Cline, Continue, Gemini, Aider",
   "type": "module",
   "bin": {

package/web/live-dev/app.js

@@ -11,6 +11,10 @@ import {
   applyDomI18n,
 } from "./i18n.js";
 import { structuredHtml, escapeHtml, reqEditModel, serializeReqEdit } from "./structured-html.mjs";
+import {
+  deriveProjectDeliveryStatus,
+  stageTone,
+} from "./delivery-status.mjs";
 import { renderChatMarkdown } from "./chat-markdown.mjs";
 import { extractArchitectureIr } from "./architecture-ir.mjs";
 import {
@@ -211,7 +215,8 @@ const el = {
   repoList: document.getElementById("repoList"),
   repoPath: document.getElementById("repoPath"),
   projectsRoot: document.getElementById("projectsRoot"),
-  saveProjectsRoot: document.getElementById("saveProjectsRoot"),
+  pickProjectsRoot: document.getElementById("pickProjectsRoot"),
+  clearProjectsRoot: document.getElementById("clearProjectsRoot"),
   projectFolder: document.getElementById("projectFolder"),
   projectTitle: document.getElementById("projectTitle"),
   projectDescription: document.getElementById("projectDescription"),
@@ -255,6 +260,9 @@ const el = {
   dispatchErr: document.getElementById("dispatchErr"),
   dispatchStatus: document.getElementById("dispatchStatus"),
   openDeliverables: document.getElementById("openDeliverables"),
+  deliveryCockpit: document.getElementById("deliveryCockpit"),
+  deliveryStages: document.getElementById("deliveryStages"),
+  deliveryNextAction: document.getElementById("deliveryNextAction"),
   progressCol: document.querySelector(".progress-col"),
   progressEmpty: document.getElementById("progressEmpty"),
   runTimeline: document.getElementById("runTimeline"),
@@ -589,6 +597,53 @@ function setActiveProject(path, name, description) {
 function syncDeliverablesEntry() {
   if (!el.openDeliverables) return;
   el.openDeliverables.hidden = !state.projectPath;
+  paintDeliveryCockpit();
+}
+
+function deskSessionSnapshot() {
+  return {
+    modules: state.modules || [],
+    architecture: state.architecture || {},
+    jobId: state.jobId || null,
+    reviseCards: state.reviseCards || [],
+    reviseLocked: Boolean(state.reviseLocked),
+    revisePlanConfirmed: Boolean(state.revisePlanConfirmed),
+    lastRevision: state.lastRevision || null,
+    originalCard: state.originalCard || null,
+  };
+}
+
+function paintDeliveryCockpit(statusHint = null) {
+  if (!el.deliveryCockpit) return;
+  if (!state.projectPath) {
+    el.deliveryCockpit.hidden = true;
+    return;
+  }
+  const hint =
+    statusHint && typeof statusHint === "object" ? statusHint : {};
+  const progress = hint.progress;
+  const derived = deriveProjectDeliveryStatus(deskSessionSnapshot(), {
+    jobStatus: hint.status || hint.jobStatus || null,
+    deliveryAccepted:
+      hint.delivery?.status === "accepted" ||
+      String(hint.status || "").toLowerCase() === "accepted",
+    progressDone: progress?.done,
+    progressTotal: progress?.total,
+  });
+  el.deliveryCockpit.hidden = false;
+  if (el.deliveryStages) {
+    el.deliveryStages.replaceChildren();
+    for (const st of stageTone(derived.stages)) {
+      const li = document.createElement("li");
+      li.className = `delivery-stage is-${st.tone}`;
+      li.dataset.stage = st.id;
+      li.textContent = t(`cockpit.stage.${st.id}`);
+      el.deliveryStages.appendChild(li);
+    }
+  }
+  if (el.deliveryNextAction) {
+    el.deliveryNextAction.textContent = t(`cockpit.next.${derived.nextAction}`);
+  }
 }
 
 function openDeliverablesPage() {
@@ -791,6 +846,7 @@ function renderModuleTabs() {
       total: String(list.length),
     });
   }
+  paintDeliveryCockpit();
 }
 
 function mergeModulesFromChatPayload(data) {
@@ -2661,10 +2717,6 @@ function syncDrawerBackdrop() {
 function setSettingsOpen(open) {
   if (!el.settingsPanel) return;
   const want = Boolean(open);
-  if (!want && !state.ready) {
-    // First-time config: keep drawer open until saved.
-    return;
-  }
   if (want && el.historyPanel && !el.historyPanel.hidden) {
     el.historyPanel.hidden = true;
     if (el.historyToggle) {
@@ -2676,7 +2728,7 @@ function setSettingsOpen(open) {
     el.cfgOpen.setAttribute("aria-expanded", want ? "true" : "false");
   }
   if (el.settingsClose) {
-    el.settingsClose.hidden = !state.ready;
+    el.settingsClose.hidden = false;
   }
   syncDrawerBackdrop();
 }
@@ -2759,10 +2811,14 @@ function showSetup(cfg) {
   fillAwsFields(cfg);
   const id = cfg?.provider || "deepseek";
   applyProvider(id, { fillEmptyOnly: Boolean(cfg?.baseUrl || cfg?.model) });
-  if (!state.ready) {
-    if (el.desk) el.desk.hidden = true;
-  }
+  // Always show the desk; open Settings so the operator can fill the model.
+  if (el.desk) el.desk.hidden = false;
+  state.ready = false;
+  syncComposerEnabled();
   setSettingsOpen(true);
+  if (el.meta) {
+    el.meta.textContent = t("setup.hintOpenSettings");
+  }
 }
 
 function showDesk(cfg) {
@@ -4035,6 +4091,7 @@ async function renderArchitectureFromIr(ir) {
       if (!state.architecture.fingerprint) state.architecture.fingerprint = fp;
     }
     syncArchitecturePanel();
+    paintDeliveryCockpit();
     schedulePersistProjectDesk();
     return true;
   }
@@ -4933,36 +4990,65 @@ el.architectureRetry?.addEventListener("click", () => {
   retryArchitectureDesign();
 });
 
-el.saveProjectsRoot?.addEventListener("click", async () => {
+el.pickProjectsRoot?.addEventListener("click", async () => {
   if (el.historyErr) el.historyErr.hidden = true;
   if (el.dispatchErr) el.dispatchErr.hidden = true;
+  if (el.pickProjectsRoot) {
+    el.pickProjectsRoot.disabled = true;
+    el.pickProjectsRoot.textContent = t("dispatch.pickProjectsRootBusy");
+  }
+  try {
+    const res = await fetch("/api/projects/pick-root", { method: "POST" });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      if (data.cancelled) return;
+      throw new Error(data.error || t("dispatch.projectsRootPickFail"));
+    }
+    if (el.projectsRoot) el.projectsRoot.value = data.projectsRoot || "";
+    state.lastCfg = { ...(state.lastCfg || {}), ...data };
+    if (Array.isArray(data.projects)) {
+      state.projects = data.projects;
+      renderProjectList();
+    }
+    if (el.historyErr) {
+      el.historyErr.hidden = false;
+      el.historyErr.textContent = t("dispatch.projectsRootSaved");
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (el.historyErr) {
+      el.historyErr.hidden = false;
+      el.historyErr.textContent = msg;
+    }
+  } finally {
+    if (el.pickProjectsRoot) {
+      el.pickProjectsRoot.disabled = false;
+      el.pickProjectsRoot.textContent = t("dispatch.pickProjectsRoot");
+    }
+  }
+});
+
+el.clearProjectsRoot?.addEventListener("click", async () => {
+  if (el.historyErr) el.historyErr.hidden = true;
   try {
     const res = await fetch("/api/config", {
       method: "POST",
       headers: { "content-type": "application/json" },
-      body: JSON.stringify({
-        projectsRoot: (el.projectsRoot?.value || "").trim(),
-      }),
+      body: JSON.stringify({ projectsRoot: "" }),
     });
     const data = await res.json();
     if (!res.ok) throw new Error(data.error || t("dispatch.projectsRootFail"));
-    if (el.projectsRoot) el.projectsRoot.value = data.projectsRoot || "";
+    if (el.projectsRoot) el.projectsRoot.value = "";
     state.lastCfg = { ...(state.lastCfg || {}), ...data };
     if (el.historyErr) {
       el.historyErr.hidden = false;
-      el.historyErr.textContent = t("dispatch.projectsRootSaved");
-    } else if (el.dispatchStatus) {
-      el.dispatchStatus.hidden = false;
-      el.dispatchStatus.textContent = t("dispatch.projectsRootSaved");
+      el.historyErr.textContent = t("dispatch.projectsRootCleared");
     }
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     if (el.historyErr) {
       el.historyErr.hidden = false;
       el.historyErr.textContent = msg;
-    } else if (el.dispatchErr) {
-      el.dispatchErr.hidden = false;
-      el.dispatchErr.textContent = msg;
     }
   }
 });
@@ -5492,6 +5578,7 @@ function fillRunProgress(block, data) {
 
 function renderProgress(data) {
   if (!el.runTimeline) return;
+  paintDeliveryCockpit(data);
   const progress = data?.progress;
   if (!progress) {
     if (!state.activeRun) el.runTimeline.hidden = el.runTimeline.childElementCount === 0;
@@ -6865,20 +6952,22 @@ function renderProjectList() {
   }
   const active = normalizePathKey(state.projectPath);
   for (const proj of state.projects) {
+    const row = document.createElement("div");
+    row.className = "project-row";
+    const pressed = normalizePathKey(proj.path) === active;
+    if (pressed) row.classList.add("is-active");
+
     const btn = document.createElement("button");
     btn.type = "button";
     btn.className = "history-item project-item";
     btn.dataset.path = proj.path;
-    const pressed = normalizePathKey(proj.path) === active;
     btn.setAttribute("aria-pressed", pressed ? "true" : "false");
     const goal = document.createElement("span");
     goal.className = "history-item-goal";
     goal.textContent = proj.title || proj.name || proj.path;
     const st = document.createElement("span");
-    st.className = "history-item-status";
-    st.textContent = t("project.jobCount", {
-      n: String((proj.jobs || []).length),
-    });
+    st.className = `history-item-status project-status is-${proj.deliveryStatus || "drafting"}`;
+    st.textContent = t(`project.status.${proj.deliveryStatus || "drafting"}`);
     const meta = document.createElement("span");
     meta.className = "history-item-meta";
     meta.textContent = proj.description
@@ -6894,7 +6983,33 @@ function renderProjectList() {
         requireMeta: false,
       });
     });
-    el.projectList.appendChild(btn);
+    row.appendChild(btn);
+
+    if (proj.hasDeliverables) {
+      const deliv = document.createElement("button");
+      deliv.type = "button";
+      deliv.className = "btn project-deliverables";
+      deliv.textContent = t("deliverables.openShort");
+      deliv.title = t("deliverables.openHint");
+      deliv.addEventListener("click", (ev) => {
+        ev.preventDefault();
+        ev.stopPropagation();
+        const open = async () => {
+          if (normalizePathKey(state.projectPath) !== normalizePathKey(proj.path)) {
+            await activateProjectPath(proj.path, {
+              title: proj.title || proj.name,
+              description: proj.description || "",
+              requireMeta: false,
+            });
+          }
+          openDeliverablesPage();
+        };
+        void open();
+      });
+      row.appendChild(deliv);
+    }
+
+    el.projectList.appendChild(row);
   }
 }
 
@@ -7224,6 +7339,8 @@ el.projectBrowse?.addEventListener("click", async () => {
 onLocaleChange(() => {
   syncDynamicI18n();
   syncReviseCardChrome();
+  paintDeliveryCockpit();
+  renderProjectList();
   if (el.previewPanel && !el.previewPanel.hidden && state.lastStatus) {
     renderPreview(state.lastStatus);
   } else {

package/web/live-dev/delivery-status.mjs

@@ -0,0 +1,135 @@
+/**
+ * Pure delivery status for FDE project portfolio + progress cockpit.
+ * Shared by live server (project list) and desk UI.
+ */
+
+/**
+ * @param {unknown} modules
+ */
+function modulesAllConfirmed(modules) {
+  const list = Array.isArray(modules) ? modules : [];
+  if (!list.length) return false;
+  return list.every((m) => m && m.status === "confirmed");
+}
+
+/**
+ * @typedef {'drafting'|'confirming'|'building'|'delivered'|'revising'} DeliveryStatus
+ * @typedef {'chat'|'confirm_module'|'confirm_arch'|'kickoff'|'wait_workers'|'view_deliverables'|'revise'} NextAction
+ */
+
+/**
+ * Derive portfolio / cockpit status from a project chat session (+ optional job).
+ * @param {object|null|undefined} session
+ * @param {{
+ *   jobStatus?: string|null,
+ *   deliveryAccepted?: boolean,
+ *   progressDone?: number,
+ *   progressTotal?: number,
+ * }} [hint]
+ */
+export function deriveProjectDeliveryStatus(session, hint = {}) {
+  const s = session && typeof session === "object" ? session : {};
+  const modules = Array.isArray(s.modules) ? s.modules : [];
+  const confirmed = modules.filter((m) => m && m.status === "confirmed");
+  const allReq = modulesAllConfirmed(modules);
+  const arch =
+    s.architecture && typeof s.architecture === "object" ? s.architecture : {};
+  const reviseCards = Array.isArray(s.reviseCards) ? s.reviseCards : [];
+  const hasJob = Boolean(s.jobId);
+  const jobStatus = String(hint.jobStatus || "").toLowerCase();
+  const deliveryAccepted =
+    Boolean(hint.deliveryAccepted) || jobStatus === "accepted";
+  const progressTotal = Number(hint.progressTotal) || 0;
+  const progressDone = Number(hint.progressDone) || 0;
+  const buildingIncomplete =
+    hasJob &&
+    !deliveryAccepted &&
+    progressTotal > 0 &&
+    progressDone < progressTotal;
+
+  /** @type {DeliveryStatus} */
+  let status = "drafting";
+  /** @type {NextAction} */
+  let nextAction = "chat";
+
+  if (deliveryAccepted && (reviseCards.length > 0 || s.reviseLocked)) {
+    status = "revising";
+    nextAction = s.revisePlanConfirmed ? "kickoff" : "revise";
+  } else if (deliveryAccepted) {
+    status = "delivered";
+    nextAction = "view_deliverables";
+  } else if (reviseCards.length > 0 || Number(s.lastRevision?.revision) > 0) {
+    status = "revising";
+    nextAction = "revise";
+  } else if (hasJob) {
+    status = "building";
+    nextAction = buildingIncomplete ? "wait_workers" : "view_deliverables";
+  } else if (allReq && arch.confirmed) {
+    status = "confirming";
+    nextAction = "kickoff";
+  } else if (allReq && !arch.confirmed) {
+    status = "confirming";
+    nextAction = "confirm_arch";
+  } else if (confirmed.length > 0 || modules.length > 0) {
+    status = "confirming";
+    nextAction = "confirm_module";
+  } else {
+    status = "drafting";
+    nextAction = "chat";
+  }
+
+  const stages = [
+    {
+      id: "requirements",
+      done: allReq,
+      partial: confirmed.length > 0 && !allReq,
+    },
+    {
+      id: "architecture",
+      done: Boolean(arch.confirmed),
+      partial: Boolean(arch.url) && !arch.confirmed,
+    },
+    {
+      id: "kickoff",
+      done: hasJob,
+      partial: false,
+    },
+    {
+      id: "delivery",
+      done: deliveryAccepted,
+      partial: hasJob && !deliveryAccepted,
+    },
+    {
+      id: "revise",
+      done: reviseCards.length > 0 && deliveryAccepted,
+      partial: reviseCards.length > 0 && !deliveryAccepted,
+    },
+  ];
+
+  const hasDeliverables =
+    confirmed.length > 0 ||
+    Boolean(arch.url) ||
+    hasJob ||
+    reviseCards.length > 0 ||
+    Boolean(s.originalCard?.goal);
+
+  return {
+    status,
+    nextAction,
+    hasDeliverables,
+    stages,
+    confirmedCount: confirmed.length,
+    moduleCount: modules.length,
+  };
+}
+
+/**
+ * Compact stage tokens for UI (done | partial | empty).
+ * @param {ReturnType<typeof deriveProjectDeliveryStatus>['stages']} stages
+ */
+export function stageTone(stages) {
+  return (Array.isArray(stages) ? stages : []).map((st) => ({
+    id: st.id,
+    tone: st.done ? "done" : st.partial ? "partial" : "empty",
+  }));
+}

package/web/live-dev/i18n.js

@@ -59,11 +59,17 @@ const zhCN = {
   "project.needName": "请填写项目名或路径",
   "project.fail": "无法打开项目",
   "project.jobCount": "{n} 条对话",
+  "project.status.drafting": "起草中",
+  "project.status.confirming": "确认中",
+  "project.status.building": "实现中",
+  "project.status.delivered": "已交付",
+  "project.status.revising": "改进中",
   "project.unassigned": "未归入项目的对话（选项目后确认会挂上）",
   "bot.needProject": "请先点右上角「项目」选择或新建产品目录，再开始对话。",
   "setup.mark": "Duaer-spec FDE · model",
   "setup.title": "配置模型",
   "setup.hint": "先接好 Duaer 台面模型，再在台面说需求。写入 ~/.duaer/live/config.json",
+  "setup.hintOpenSettings": "请在「设置」里配置模型后保存，即可开始对话",
   "setup.provider": "服务商",
   "setup.providerAria": "服务商预设",
   "setup.save": "保存并开始",
@@ -254,9 +260,15 @@ const zhCN = {
   "arch.needConfirm": "请先确认架构再派工",
   "dispatch.projectsRoot": "产品父目录",
   "dispatch.projectsRootPh": "/Users/…/Projects",
+  "dispatch.projectsRootEmpty": "尚未选择",
+  "dispatch.pickProjectsRoot": "选择…",
+  "dispatch.clearProjectsRoot": "清除",
+  "dispatch.pickProjectsRootBusy": "选择中…",
   "dispatch.saveProjectsRoot": "保存父目录",
   "dispatch.projectsRootSaved": "父目录已保存",
+  "dispatch.projectsRootCleared": "已清除父目录",
   "dispatch.projectsRootFail": "父目录保存失败",
+  "dispatch.projectsRootPickFail": "无法选择父目录",
   "dispatch.agentLabel": "用哪个 CLI 数字员工启动",
   "dispatch.agentHint": "检测本机 PATH 上的 Cursor Agent / Claude Code",
   "dispatch.redetect": "重新检测",
@@ -396,9 +408,22 @@ const zhCN = {
   "progress.title": "任务进度",
   "progress.aria": "任务进度",
   "deliverables.open": "查看交付物",
+  "deliverables.openShort": "交付物",
   "deliverables.openHint": "新标签打开结构化交付物档案（需求文档 / 确认书 / 架构…）",
+  "cockpit.stage.requirements": "需求",
+  "cockpit.stage.architecture": "架构",
+  "cockpit.stage.kickoff": "开工",
+  "cockpit.stage.delivery": "交付",
+  "cockpit.stage.revise": "改进",
+  "cockpit.next.chat": "下一步：在对话里说清要做什么",
+  "cockpit.next.confirm_module": "下一步：确认当前模块需求卡",
+  "cockpit.next.confirm_arch": "下一步：确认系统架构",
+  "cockpit.next.kickoff": "下一步：开工派工",
+  "cockpit.next.wait_workers": "下一步：等待数字员工完成任务",
+  "cockpit.next.view_deliverables": "下一步：查看交付物或再改一版",
+  "cockpit.next.revise": "下一步：写清改进方案并派一版",
   "progress.emptyTitle": "还没有进度",
-  "progress.empty": "派工后显示各轮任务与改动文件",
+  "progress.empty": "有项目后这里会提示下一步；派工后显示各轮任务",
   "run.mark": "Run",
   "run.dispatch": "派工进度",
   "run.dispatchWorkers": "派工进度 · {n} 名员工",
@@ -546,11 +571,17 @@ const en = {
   "project.needName": "Enter a project name or path",
   "project.fail": "Could not open project",
   "project.jobCount": "{n} chats",
+  "project.status.drafting": "Drafting",
+  "project.status.confirming": "Confirming",
+  "project.status.building": "Building",
+  "project.status.delivered": "Delivered",
+  "project.status.revising": "Revising",
   "project.unassigned": "Unassigned chats (confirm after picking a project to attach)",
   "bot.needProject": "Open Projects (top right) and select or create a product folder before chatting.",
   "setup.mark": "Duaer-spec FDE · model",
   "setup.title": "Configure model",
   "setup.hint": "Connect a Duaer desk model first, then state the job. Saved to ~/.duaer/live/config.json",
+  "setup.hintOpenSettings": "Open Settings, save a model, then start chatting",
   "setup.provider": "Provider",
   "setup.providerAria": "Provider presets",
   "setup.save": "Save and start",
@@ -715,9 +746,15 @@ const en = {
   "dispatch.deploy.github-pages": "GitHub Pages",
   "dispatch.projectsRoot": "Projects parent folder",
   "dispatch.projectsRootPh": "/Users/…/Projects",
+  "dispatch.projectsRootEmpty": "Not set",
+  "dispatch.pickProjectsRoot": "Choose…",
+  "dispatch.clearProjectsRoot": "Clear",
+  "dispatch.pickProjectsRootBusy": "Choosing…",
   "dispatch.saveProjectsRoot": "Save parent",
   "dispatch.projectsRootSaved": "Parent folder saved",
+  "dispatch.projectsRootCleared": "Parent folder cleared",
   "dispatch.projectsRootFail": "Could not save parent folder",
+  "dispatch.projectsRootPickFail": "Could not choose parent folder",
   "arch.title": "Architecture",
   "arch.titlePrevious": "Previous architecture",
   "arch.titleNew": "New architecture",
@@ -899,9 +936,22 @@ const en = {
   "progress.title": "Task progress",
   "progress.aria": "Task progress",
   "deliverables.open": "View deliverables",
+  "deliverables.openShort": "Deliverables",
   "deliverables.openHint": "Opens a structured deliverables dossier in a new tab",
+  "cockpit.stage.requirements": "Requirements",
+  "cockpit.stage.architecture": "Architecture",
+  "cockpit.stage.kickoff": "Kickoff",
+  "cockpit.stage.delivery": "Delivery",
+  "cockpit.stage.revise": "Revise",
+  "cockpit.next.chat": "Next: describe what to build in chat",
+  "cockpit.next.confirm_module": "Next: confirm the active module card",
+  "cockpit.next.confirm_arch": "Next: confirm architecture",
+  "cockpit.next.kickoff": "Next: kick off dispatch",
+  "cockpit.next.wait_workers": "Next: wait for digital employees",
+  "cockpit.next.view_deliverables": "Next: view deliverables or revise",
+  "cockpit.next.revise": "Next: write the revise plan and dispatch",
   "progress.emptyTitle": "No progress yet",
-  "progress.empty": "Task steps and changed files appear here after dispatch",
+  "progress.empty": "With a project selected, the next step appears here; tasks show after dispatch",
   "run.mark": "Run",
   "run.dispatch": "Dispatch progress",
   "run.dispatchWorkers": "Dispatch progress · {n} employees",

package/web/live-dev/index.html

@@ -302,7 +302,7 @@
             <h2 class="card-title" data-i18n="progress.title">任务进度</h2>
             <button
               type="button"
-              class="btn deliverables-open"
+              class="btn deliverables-open primary"
               id="openDeliverables"
               data-i18n="deliverables.open"
               data-i18n-title="deliverables.openHint"
@@ -313,6 +313,10 @@
             </button>
             <p id="dispatchStatus" class="meta progress-status" hidden></p>
           </header>
+          <div id="deliveryCockpit" class="delivery-cockpit" hidden>
+            <ol class="delivery-stages" id="deliveryStages" aria-label="Delivery stages"></ol>
+            <p class="delivery-next" id="deliveryNextAction"></p>
+          </div>
           <div id="progressEmpty" class="progress-empty">
             <p class="progress-empty-title" data-i18n="progress.emptyTitle">还没有进度</p>
             <p class="progress-empty-hint" data-i18n="progress.empty">派工后显示各轮任务与改动文件</p>
@@ -337,10 +341,18 @@
         <p class="project-section-label" data-i18n="project.createTitle">新建 / 打开项目</p>
         <label class="field">
           <span data-i18n="dispatch.projectsRoot">产品父目录</span>
-          <input id="projectsRoot" type="text" data-i18n-placeholder="dispatch.projectsRootPh" placeholder="/Users/…/Projects" autocomplete="off" />
+          <input
+            id="projectsRoot"
+            type="text"
+            readonly
+            data-i18n-placeholder="dispatch.projectsRootEmpty"
+            placeholder="尚未选择"
+            autocomplete="off"
+          />
         </label>
         <div class="repo-actions repo-root-actions">
-          <button type="button" class="btn" id="saveProjectsRoot" data-i18n="dispatch.saveProjectsRoot">保存父目录</button>
+          <button type="button" class="btn primary" id="pickProjectsRoot" data-i18n="dispatch.pickProjectsRoot">选择…</button>
+          <button type="button" class="btn" id="clearProjectsRoot" data-i18n="dispatch.clearProjectsRoot">清除</button>
         </div>
         <label class="field">
           <span data-i18n="project.folderLabel">目录名或绝对路径</span>

package/web/live-dev/styles.css

@@ -558,6 +558,64 @@ body {
   border-color: var(--lock);
 }
 
+.project-row {
+  display: flex;
+  flex-direction: column;
+  gap: 0.3rem;
+}
+
+.project-row.is-active .project-item {
+  border-color: var(--lock);
+}
+
+.project-row .project-item {
+  width: 100%;
+}
+
+.project-status {
+  display: inline-block;
+  margin-top: 0.15rem;
+  padding: 0.1rem 0.4rem;
+  border: 1px solid rgba(63, 86, 108, 0.65);
+  font-size: 0.68rem;
+  letter-spacing: 0.03em;
+  color: var(--mute);
+}
+
+.project-status.is-drafting {
+  color: #9fb0c0;
+}
+
+.project-status.is-confirming {
+  border-color: rgba(47, 158, 143, 0.55);
+  color: #9fe8dc;
+}
+
+.project-status.is-building {
+  border-color: rgba(212, 168, 75, 0.65);
+  color: #e8c87a;
+}
+
+.project-status.is-delivered {
+  border-color: rgba(47, 158, 143, 0.8);
+  background: rgba(47, 158, 143, 0.12);
+  color: #9fe8dc;
+}
+
+.project-status.is-revising {
+  border-color: rgba(127, 149, 168, 0.8);
+  color: #c5d4e0;
+}
+
+.project-deliverables {
+  align-self: flex-start;
+  font-size: 0.75rem;
+  padding: 0.25rem 0.55rem;
+  background: rgba(47, 158, 143, 0.1);
+  border-color: var(--lock);
+  color: #9fe8dc;
+}
+
 .dispatch-project-summary {
   margin: 0 0 0.85rem;
   padding: 0.55rem 0.65rem;
@@ -1225,6 +1283,58 @@ a.btn[hidden] {
   display: none !important;
 }
 
+.deliverables-open.primary {
+  font-weight: 650;
+}
+
+.delivery-cockpit {
+  flex-shrink: 0;
+  margin: 0.55rem 0 0.35rem;
+  padding: 0.5rem 0.55rem;
+  border: 1px solid rgba(63, 86, 108, 0.55);
+  background: rgba(8, 14, 20, 0.35);
+}
+
+.delivery-cockpit[hidden] {
+  display: none !important;
+}
+
+.delivery-stages {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.3rem;
+}
+
+.delivery-stage {
+  margin: 0;
+  padding: 0.15rem 0.4rem;
+  border: 1px solid rgba(63, 86, 108, 0.55);
+  font-size: 0.68rem;
+  letter-spacing: 0.02em;
+  color: var(--mute);
+}
+
+.delivery-stage.is-partial {
+  border-color: rgba(212, 168, 75, 0.65);
+  color: #e8c87a;
+}
+
+.delivery-stage.is-done {
+  border-color: rgba(47, 158, 143, 0.75);
+  background: rgba(47, 158, 143, 0.14);
+  color: #9fe8dc;
+}
+
+.delivery-next {
+  margin: 0.45rem 0 0;
+  font-size: 0.82rem;
+  line-height: 1.4;
+  color: var(--ink);
+}
+
 .progress-col .card-title {
   font-size: 1.2rem;
   letter-spacing: 0.03em;