duaer-spec 0.22.0 → 0.23.0

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": "210-release-023",
+  "specDir": ".duaer/specs/210-release-023"
 }

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/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
+
+- [ ] T001 Bump package.json to 0.23.0 and move CHANGELOG Unreleased
+- [ ] T002 Merge release branch to develop
+- [ ] T003 Promote develop → main, push, tag, gh release, npm
+- [ ] T004 Stamp delivery accepted

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 ## Unreleased
 
+## 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/bin/duaer-live.mjs

@@ -73,6 +73,7 @@ import {
   assignTasksToWorkers,
   clipWorkerCount,
 } from "./live-modules.mjs";
+import { rolePromptZh } from "../web/live-dev/employee-catalog.mjs";
 import {
   doneIdsFromProgress,
   fingerprintWave,
@@ -1577,56 +1578,120 @@ function discoverRepos({ max = 40 } = {}) {
 const DISPATCH_MUST_FINISH_RULES = `
 禁止半途收尾：
 - 分派的每一项任务都必须做完；不得以「Job not accepted yet」或「⏳ … not accepted」作为最终回复（那会让编码停住）
-- 波次间隙可以静默停等编排器 continue；停等时不要输出任何 not accepted / 未验收话术
+- 本波勾完且还有后续波次时：输出一行「本波完成，退出等编排器」后立刻结束本次 CLI 会话/进程退出（不要挂起等待）；编排器会 FIFO 排队 --continue 放行下一波
 - 当你负责的任务与 stamp 全部完成后：必须把 delivery.json 标为 accepted（含 preview.url），最终只允许一行：✅ Job accepted — ready for your review.
 `.trim();
 
 function pickFolderNative(promptText = "选择产品仓库") {
   const prompt = String(promptText || "选择产品仓库").trim() || "选择产品仓库";
   if (process.platform === "darwin") {
-    const r = spawnSync(
-      "osascript",
-      ["-e", `POSIX path of (choose folder with prompt ${JSON.stringify(prompt)})`],
-      { encoding: "utf8", timeout: 300000 },
-    );
-    const err = String(r.stderr || "").trim();
-    const out = String(r.stdout || "").trim();
-    if (r.status !== 0) {
-      if (
-        /User canceled|cancelled|canceled|取消/i.test(err) ||
-        /User canceled|cancelled|canceled|取消/i.test(out)
-      ) {
-        const e = new Error("已取消选择");
-        e.code = "CANCELLED";
-        throw e;
-      }
-      throw new Error(err || out || "无法打开系统文件夹选择");
-    }
-    if (!out) {
-      const e = new Error("已取消选择");
-      e.code = "CANCELLED";
-      throw e;
-    }
-    return normalizeRepoPath(out);
+    // Activate Finder so the sheet is frontmost (LaunchAgent / browser often
+    // leave a bare `choose folder` dialog buried behind Cursor / Chrome).
+    const script = `
+tell application "Finder"
+  activate
+  try
+    set theFolder to choose folder with prompt ${JSON.stringify(prompt)}
+    return POSIX path of theFolder
+  on error errMsg number errNum
+    if errNum is -128 then
+      error "User canceled" number -128
+    end if
+    error errMsg number errNum
+  end try
+end tell
+`.trim();
+    return new Promise((resolve, reject) => {
+      const child = spawn("osascript", ["-e", script], {
+        env: process.env,
+      });
+      let stdout = "";
+      let stderr = "";
+      const timer = setTimeout(() => {
+        try {
+          child.kill("SIGTERM");
+        } catch {
+          /* ignore */
+        }
+        reject(new Error("选择文件夹超时"));
+      }, 300000);
+      child.stdout.on("data", (d) => {
+        stdout += d;
+      });
+      child.stderr.on("data", (d) => {
+        stderr += d;
+      });
+      child.on("error", (err) => {
+        clearTimeout(timer);
+        reject(err);
+      });
+      child.on("close", (code) => {
+        clearTimeout(timer);
+        const err = String(stderr || "").trim();
+        const out = String(stdout || "").trim();
+        if (code !== 0) {
+          if (
+            /User canceled|cancelled|canceled|取消|-128/i.test(err) ||
+            /User canceled|cancelled|canceled|取消|-128/i.test(out)
+          ) {
+            const e = new Error("已取消选择");
+            e.code = "CANCELLED";
+            reject(e);
+            return;
+          }
+          reject(new Error(err || out || "无法打开系统文件夹选择"));
+          return;
+        }
+        if (!out) {
+          const e = new Error("已取消选择");
+          e.code = "CANCELLED";
+          reject(e);
+          return;
+        }
+        resolve(normalizeRepoPath(out));
+      });
+    });
   }
   if (process.platform === "linux") {
-    const r = spawnSync(
-      "zenity",
-      ["--file-selection", "--directory", `--title=${prompt}`],
-      { encoding: "utf8", timeout: 300000 },
-    );
-    if (r.status !== 0) {
-      const e = new Error("已取消选择");
-      e.code = "CANCELLED";
-      throw e;
-    }
-    return normalizeRepoPath(String(r.stdout || "").trim());
+    return new Promise((resolve, reject) => {
+      const child = spawn(
+        "zenity",
+        ["--file-selection", "--directory", `--title=${prompt}`],
+        { env: process.env },
+      );
+      let stdout = "";
+      const timer = setTimeout(() => {
+        try {
+          child.kill("SIGTERM");
+        } catch {
+          /* ignore */
+        }
+        reject(new Error("选择文件夹超时"));
+      }, 300000);
+      child.stdout.on("data", (d) => {
+        stdout += d;
+      });
+      child.on("error", (err) => {
+        clearTimeout(timer);
+        reject(err);
+      });
+      child.on("close", (code) => {
+        clearTimeout(timer);
+        if (code !== 0) {
+          const e = new Error("已取消选择");
+          e.code = "CANCELLED";
+          reject(e);
+          return;
+        }
+        resolve(normalizeRepoPath(String(stdout || "").trim()));
+      });
+    });
   }
   const e = new Error(
     "当前系统暂不支持弹窗选文件夹，请用扫描列表或：duaer live repo add",
   );
   e.code = "UNSUPPORTED";
-  throw e;
+  return Promise.reject(e);
 }
 
 function listReposForUi() {
@@ -3624,7 +3689,7 @@ Brief: ${featureDir}
 2. 只做 Brief 范围；以 Acceptance 为准交付可让人满意的成品（可核对结果，不是过程叙事）
 3. 按 .duaer/memory/testing.md（若有）做风险验证
 4. 每完成 tasks.md 中的一步，立刻把该行改成 - [x]（Duaer-spec FDE 靠此显示细粒度进度与编排放行）
-4a. 只做当前编排波次已放行的任务；未满足 dependsOn / 未放行的任务不要开工；本波勾完后：若还有后续波次则静默停等编排器 continue（不要写 Job not accepted yet）；若已无后续波次则继续完成 stamp accepted
+4a. 只做当前编排波次已放行的任务；未满足 dependsOn / 未放行的任务不要开工；本波勾完后：若还有后续波次则输出「本波完成，退出等编排器」并立刻结束本次 CLI 会话（不要挂起；编排器用 --continue 放行）；若已无后续波次则继续完成 stamp accepted
 4b. 拆任务（强制）：必须拆到原子任务且每条可独立验证；每个勾选项只覆盖一个验收点；进度只能用 tasks.md 的 - [ ]/- [x] 监控（立刻勾选，不要攒到最后）；不要把多项验收揉进同一条；不要人为限制条数。若仍偏粗，先按 Acceptance 扩成「一条验收一勾选」（仍用 T00x），保存后再做
 5. 对照 Acceptance 全部满足后，才 stamp ${path.join(featureDir, "delivery.json")} 为 accepted——tasks.md 全部勾完还不够，必须 stamp；禁止停在 Job not accepted yet
 5b. 交付前必须更新产品仓 README（说明文档）：与本次交付一致——做什么、模块/验收要点、如何运行或打开；需求变了就改 README，不要只改代码。英文 README 不得出现中文；若项目是中文说明则用 README.zh-CN.md（或项目既有约定），可夹英文术语
@@ -3703,6 +3768,10 @@ Brief: ${featureDir}
     const waveList = wave
       .map((t) => `- ${t.id}: ${t.title || t.id}`)
       .join("\n");
+    const ownedRoles = [
+      ...new Set(workerTasks.map((t) => t.role).filter(Boolean)),
+    ];
+    const roleBlurb = rolePromptZh(ownedRoles);
     const workerPrompt =
       assigned.workerCount === 1
         ? `${agentPrompt}
@@ -3710,8 +3779,8 @@ Brief: ${featureDir}
 ——
 编排波次（只做这些已放行任务）：
 ${waveList}
-
-本波全部改成 - [x] 后：若还有后续波次则静默停等编排器（不要写 Job not accepted yet）；若已无后续任务则 stamp delivery.json accepted 并输出 ✅ Job accepted。不要开始未放行 / 未满足 dependsOn 的任务。
+${roleBlurb ? `\n${roleBlurb}\n` : ""}
+本波全部改成 - [x] 后：若还有后续波次则输出「本波完成，退出等编排器」并立刻结束本次 CLI 会话（不要挂起；不要写 Job not accepted yet）；若已无后续任务则 stamp delivery.json accepted 并输出 ✅ Job accepted。不要开始未放行 / 未满足 dependsOn 的任务。
 
 ${DISPATCH_MUST_FINISH_RULES}
 `
@@ -3722,8 +3791,8 @@ ${DISPATCH_MUST_FINISH_RULES}
 你负责的全部任务：${ownedIds.join(", ") || "(none)"}。
 当前编排波次（只做这些）：
 ${waveList}
-
-本波全部改成 - [x] 后：若你还有后续波次则静默停等；若你负责的任务已全部做完且轮到 stamp，则 stamp delivery.json accepted 并输出 ✅ Job accepted。不要写 Job not accepted yet。不要开始未放行 / 未满足 dependsOn 的任务。其他任务由同事或后续波次负责。不要改 Brief 范围外的东西。
+${roleBlurb ? `\n${roleBlurb}\n` : ""}
+本波全部改成 - [x] 后：若你还有后续波次则输出「本波完成，退出等编排器」并立刻结束本次 CLI 会话；若你负责的任务已全部做完且轮到 stamp，则 stamp delivery.json accepted 并输出 ✅ Job accepted。不要写 Job not accepted yet。不要开始未放行 / 未满足 dependsOn 的任务。其他任务由同事或后续波次负责。不要改 Brief 范围外的东西。
 
 ${DISPATCH_MUST_FINISH_RULES}
 `;
@@ -5035,7 +5104,7 @@ ${waveList}
 要求：
 1. 只做本波已放行任务；立刻把完成项改成 tasks.md 的 - [x]
 2. 不要开始未放行 / 未满足 dependsOn 的任务
-3. 本波勾完后：若还有后续波次则静默停等编排器；若已无后续 / 需 stamp，则完成 stamp delivery.json accepted 并输出 ✅ Job accepted
+3. 本波勾完后：若还有后续波次则输出「本波完成，退出等编排器」并立刻结束本次 CLI 会话；若已无后续 / 需 stamp，则完成 stamp delivery.json accepted 并输出 ✅ Job accepted
 4. 只在上述 worktree 内改动；不要推远程除非明确要求
 
 ${DISPATCH_MUST_FINISH_RULES}
@@ -5075,10 +5144,6 @@ ${DISPATCH_MUST_FINISH_RULES}
     Number(progress.total) > 0 &&
     Number(progress.done) >= Number(progress.total);
   const nudgeLane = "w1";
-  const nudgeTerm =
-    (workerCount > 1
-      ? terminalsByLane[nudgeLane]
-      : terminalsByLane.w1 || terminalsByLane.default) || {};
   const acceptFp = "__ACCEPT_NUDGE__";
   const priorNudge = Array.isArray(releasedWaves[nudgeLane])
     ? releasedWaves[nudgeLane]
@@ -5088,7 +5153,6 @@ ${DISPATCH_MUST_FINISH_RULES}
     !accepted &&
     agentId &&
     worktreePath &&
-    !(nudgeTerm.busy || Number(nudgeTerm.queueDepth || 0) > 0) &&
     !priorNudge.includes(acceptFp)
   ) {
     const brief = featureDir || dispatch.featureDir || "";
@@ -6043,7 +6107,7 @@ async function handleApi(req, res) {
   if (req.method === "POST" && url.pathname === "/api/repos/pick") {
     let chosen = null;
     try {
-      chosen = pickFolderNative();
+      chosen = await pickFolderNative();
       const probe = probeRepo(chosen, {
         bootstrap: true,
         exact: true,
@@ -6532,7 +6596,7 @@ async function handleApi(req, res) {
 
   if (req.method === "POST" && url.pathname === "/api/projects/pick-root") {
     try {
-      const chosen = pickFolderNative("选择产品父目录");
+      const chosen = await pickFolderNative("选择产品父目录");
       const abs = path.resolve(String(chosen || "").trim()).replace(/[\\/]+$/, "");
       if (!abs || !fs.existsSync(abs) || !fs.statSync(abs).isDirectory()) {
         throw new Error("请选择一个有效的文件夹");

package/bin/live-modules.mjs

@@ -3,6 +3,10 @@
  */
 
 import { splitAcceptanceLines } from "../web/live-dev/acceptance-lines.mjs";
+import {
+  EMPLOYEE_ROLES,
+  clipEmployeeRole,
+} from "../web/live-dev/employee-catalog.mjs";
 
 function clipCard(card) {
   if (!card || typeof card !== "object") {
@@ -244,6 +248,7 @@ export function buildTaskPoolFromModules(modules, { deployNeeded = false, deploy
       moduleId: partial.moduleId || null,
       title: String(partial.title || "").slice(0, 200),
       dependsOn: Array.isArray(partial.dependsOn) ? partial.dependsOn.filter(Boolean) : [],
+      role: clipEmployeeRole(partial.role),
       status: "queued",
       workerId: null,
     };
@@ -257,6 +262,7 @@ export function buildTaskPoolFromModules(modules, { deployNeeded = false, deploy
       moduleId: m.id,
       title: `Implement module «${m.title}»: ${truncate(m.card.goal, 100)}`,
       dependsOn: [],
+      role: EMPLOYEE_ROLES.IMPLEMENT,
     });
     const acceptLines = splitAcceptanceLines(m.card.acceptance);
     let prevId = impl.id;
@@ -266,6 +272,7 @@ export function buildTaskPoolFromModules(modules, { deployNeeded = false, deploy
           moduleId: m.id,
           title: `Satisfy acceptance (alone) «${m.title}»: ${truncate(line, 120)}`,
           dependsOn: [prevId],
+          role: EMPLOYEE_ROLES.IMPLEMENT,
         });
         prevId = acc.id;
       }
@@ -274,6 +281,7 @@ export function buildTaskPoolFromModules(modules, { deployNeeded = false, deploy
         moduleId: m.id,
         title: `Satisfy acceptance for «${m.title}»: ${truncate(m.card.acceptance || m.card.goal, 100)}`,
         dependsOn: [impl.id],
+        role: EMPLOYEE_ROLES.IMPLEMENT,
       });
       prevId = acc.id;
     }
@@ -281,6 +289,7 @@ export function buildTaskPoolFromModules(modules, { deployNeeded = false, deploy
       moduleId: m.id,
       title: `Verify «${m.title}» against acceptance`,
       dependsOn: [prevId],
+      role: EMPLOYEE_ROLES.VERIFY_L3,
     });
     moduleVerifyId.set(m.id, verify.id);
 
@@ -301,20 +310,23 @@ export function buildTaskPoolFromModules(modules, { deployNeeded = false, deploy
 
   const verifyAll = push({
     moduleId: null,
-    title: "Risk-based verification per testing.md",
+    title: "Risk-based verification per testing.md (L0–L3 / Playwright when applicable)",
     dependsOn: [...moduleVerifyId.values()],
+    role: EMPLOYEE_ROLES.VERIFY_L3,
   });
   const readme = push({
     moduleId: null,
     title:
       "Update product README to match delivered requirements (modules/goal/acceptance/how to run)",
     dependsOn: [verifyAll.id],
+    role: EMPLOYEE_ROLES.IMPLEMENT,
   });
   push({
     moduleId: null,
     title:
       "Start preview service; stamp delivery.json accepted with preview.url",
     dependsOn: [readme.id],
+    role: EMPLOYEE_ROLES.IMPLEMENT,
   });
   if (deployNeeded) {
     push({
@@ -323,6 +335,7 @@ export function buildTaskPoolFromModules(modules, { deployNeeded = false, deploy
         deployTaskText ||
         "Deploy with GitHub CLI (`gh`) + Actions; write public URL to preview.url",
       dependsOn: [tasks[tasks.length - 1].id],
+      role: EMPLOYEE_ROLES.IMPLEMENT,
     });
   }
 
@@ -339,7 +352,8 @@ export function taskPoolToMarkdown(pool) {
     const deps =
       t.dependsOn?.length > 0 ? ` (depends: ${t.dependsOn.join(", ")})` : "";
     const mod = t.moduleId ? ` [${t.moduleId}]` : "";
-    return `- [ ] ${t.id}${mod} ${t.title}${deps}`;
+    const role = t.role ? ` {${t.role}}` : "";
+    return `- [ ] ${t.id}${mod}${role} ${t.title}${deps}`;
   });
   return `# Tasks
 
@@ -347,6 +361,8 @@ ${lines.join("\n")}
 
 做完一步就立刻把对应项改成 \`- [x]\`，方便 Duaer-spec FDE 监控进度与编排放行。
 
+**角色：** \`{implement}\` 实现员工 · \`{verify-l3}\` 功能回归（Acceptance → testing.md L0–L3 / Playwright）
+
 **原子任务规则（强制）：**
 - 每个勾选项只做一个可独立验证的功能点；不要把多项验收揉进同一条
 - 进度必须可监控：只用 \`- [ ]\` / \`- [x]\` 勾选；禁止无 checkbox 的笼统进度叙事
@@ -358,10 +374,15 @@ ${lines.join("\n")}
 /**
  * Assign tasks to 1..N workers (same CLI family). Ready roots fan out;
  * dependent tasks inherit the worker of their first dependency when possible.
+ * When count ≥ 2, verify-l3 tasks go to the last lane (regression employee).
  */
 export function assignTasksToWorkers(pool, workerCount = 1) {
   const count = Math.max(1, Math.min(8, Number(workerCount) || 1));
-  const tasks = (pool?.tasks || []).map((t) => ({ ...t, workerId: null }));
+  const tasks = (pool?.tasks || []).map((t) => ({
+    ...t,
+    role: clipEmployeeRole(t.role),
+    workerId: null,
+  }));
   if (count === 1) {
     for (const t of tasks) t.workerId = "w1";
     return { workerCount: 1, tasks };
@@ -394,6 +415,12 @@ export function assignTasksToWorkers(pool, workerCount = 1) {
     if (!t.moduleId) t.workerId = "w1";
   }
 
+  // Regression employee owns the last lane when multiple workers.
+  const verifyLane = `w${count}`;
+  for (const t of tasks) {
+    if (t.role === EMPLOYEE_ROLES.VERIFY_L3) t.workerId = verifyLane;
+  }
+
   return { workerCount: count, tasks };
 }
 
@@ -406,6 +433,7 @@ export function clipTaskPool(raw) {
       id: String(t.id || "").slice(0, 20),
       moduleId: t.moduleId ? String(t.moduleId).slice(0, 80) : null,
       title: String(t.title || "").slice(0, 200),
+      role: clipEmployeeRole(t.role),
       dependsOn: Array.isArray(t.dependsOn)
         ? t.dependsOn.map((x) => String(x).slice(0, 20)).slice(0, 20)
         : [],