duaer-spec 0.20.0 → 0.22.0

package/.duaer/specs/204-live-i18n-ja/tasks.md

@@ -0,0 +1,7 @@
+# Tasks
+
+- [x] T001 Add ja catalog + LOCALES/detectLocale/setLocale wiring
+- [x] T002 Language select option in index.html
+- [x] T003 app.js / deliverables / task-graph ja handling
+- [x] T004 Tests + E2E + docs + CHANGELOG
+- [x] T005 Stamp delivery accepted

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

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

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

@@ -0,0 +1,6 @@
+# Tasks
+
+- [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

package/.duaer/templates/tasks-template.md

@@ -15,6 +15,10 @@ TDD-style tests-before-code remain encouraged when useful.
 
 **Organization**: Tasks are grouped by user story to enable independent implementation and testing of each story.
 
+**Atomic + monitorable**: Each checkbox is one independently verifiable atom.
+Progress is only via `- [ ]` / `- [x]` — no prose-only status. Split Acceptance
+into one task per criterion; no artificial upper count.
+
 ## Format: `[ID] [P?] [Story] Description`
 
 - **[P]**: Can run in parallel (different files, no dependencies)

package/CHANGELOG.md

@@ -2,6 +2,70 @@
 
 ## Unreleased
 
+## 0.22.0 — 2026-09-19
+
+### Feat: Japanese (ja) live desk locale
+
+- Language select adds 日本語; catalog covers all en keys
+- Deliverables API accepts `lang=ja`; dates / HTML `lang` use ja-JP
+
+### Feat: atomic verifiable tasks with monitorable progress
+
+- Constitution + duaer-do / duaer-tasks: decompose to one independently
+  verifiable atom per checkbox; progress only via `- [ ]` / `- [x]`
+- Kickoff task pool and preview graph split multi-line acceptance into
+  one task per criterion so FDE can monitor and release waves
+
+## 0.21.0 — 2026-09-19
+
+### Feat: click architecture diagram for fullscreen present view
+
+- User-facing hints explain layout / worker colors and click-to-fullscreen
+- Click diagram (or「全屏查看」) opens Archify HTML with `?present=1` in a new tab
+
+### Fix: 打开看看 prefers project start URL over docs paths
+
+- Ignore non-HTML `delivery.preview.url` (e.g. `docs/**/*.md`) for primary open
+- Prefer inferred localhost service over static HTML candidates when both exist
+- Status preview / chat link stay on the runnable product URL
+
+### Fix: 打开看看 opens the focused preview URL
+
+- Result-bar open uses `lastPreviewUrl` for `/api/…` and public https; local
+  services still go through `/api/preview/ensure` without overwriting focus
+- Chat「打开看看」keeps same-origin `/api/…` hrefs (no baked host)
+
+### Fix: task path diagram without redundant Archify labels
+
+- Drop edge `depends` labels, legend cards, and subtitle on the kickoff task graph
+
+### Feat: task execution graph uses Archify (same as architecture)
+
+- Kickoff task path renders via `/api/architecture/render` + architecture mount
+- Left-to-right layered layout and visual effect match the system architecture diagram
+- Display edges are transitively reduced so Archify routing stays valid
+
+### Feat: worker chips + task dependency execution graph
+
+- Digital-employee count uses chip radiogroup (串行 / 并行 labels)
+- Kickoff shows task path by dependsOn; colors follow worker lanes
+
+### Fix: garbled chat preview links for /api/result URLs
+
+- Stop nesting bare `/api/result/…` auto-links inside `http://host/api/result/…` hrefs
+- Accepted bubble shows a single clean「打开看看」link
+
+### Fix: clickable preview URL in accepted chat bubble
+
+- Bare `http(s)://` and `/api/artifact|result/…` URLs become links in chat
+- Accepted「打开看看」message uses a real `<a href>` (relative paths get an open chip)
+
+### Fix: FDE dispatch must finish every task
+
+- Kickoff / wave / continue / revise prompts forbid `Job not accepted yet` as a final handoff
+- When all `tasks.md` boxes are checked but delivery is still open, status poll nudges stamp accept once
+- `duaer-do`: live-dispatch jobs must stamp accepted before stopping
+
 ## 0.20.0 — 2026-09-19
 
 ### Feat: pick projects parent folder via system dialog

package/bin/duaer-live.mjs

@@ -80,7 +80,7 @@ import {
   pendingWaveReleases,
   waveForWorker,
 } from "./live-orchestrate.mjs";
-import { resolvePreviewPayload, ensureLocalPreviewService, probeLocalPreviewStatus } from "./live-preview.mjs";
+import { resolvePreviewPayload, ensureLocalPreviewService, probeLocalPreviewStatus, pickOpenableResultEntry, isOpenableProductPreview } from "./live-preview.mjs";
 import { markClaudeWorkspacesTrusted } from "./live-claude-trust.mjs";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -1573,6 +1573,14 @@ function discoverRepos({ max = 40 } = {}) {
   );
 }
 
+/** Rules appended to FDE kickoff / wave / continue / revise prompts. */
+const DISPATCH_MUST_FINISH_RULES = `
+禁止半途收尾：
+- 分派的每一项任务都必须做完；不得以「Job not accepted yet」或「⏳ … not accepted」作为最终回复（那会让编码停住）
+- 波次间隙可以静默停等编排器 continue；停等时不要输出任何 not accepted / 未验收话术
+- 当你负责的任务与 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") {
@@ -3616,14 +3624,16 @@ Brief: ${featureDir}
 2. 只做 Brief 范围；以 Acceptance 为准交付可让人满意的成品（可核对结果，不是过程叙事）
 3. 按 .duaer/memory/testing.md（若有）做风险验证
 4. 每完成 tasks.md 中的一步，立刻把该行改成 - [x]（Duaer-spec FDE 靠此显示细粒度进度与编排放行）
-4a. 只做当前编排波次已放行的任务；未满足 dependsOn / 未放行的任务不要开工；本波全部勾完后停止等待下一波（编排器会 continue）
-4b. 拆任务：每个勾选项只覆盖一个可独立验收的功能点；不要把多项验收揉进同一条；不要人为限制条数（不必卡在 12 条内）。若仍偏粗，先按 Acceptance 扩成「一条功能一勾选」（仍用 T00x），保存后再做；小步勾选，不要攒到最后一次勾完
-5. 对照 Acceptance 全部满足后，才 stamp ${path.join(featureDir, "delivery.json")} 为 accepted
+4a. 只做当前编排波次已放行的任务；未满足 dependsOn / 未放行的任务不要开工；本波勾完后：若还有后续波次则静默停等编排器 continue（不要写 Job not accepted yet）；若已无后续波次则继续完成 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（或项目既有约定），可夹英文术语
-6. 必须在 delivery.json 写入 preview.url（满意交付的必填证据）：页面用相对路径如 index.html；HTTP 服务用可打开地址如 http://localhost:8788——不要因「没有页面」而省略
+6. 必须在 delivery.json 写入 preview.url（满意交付的必填证据）：必须是可打开的成品入口——HTTP 服务用 http://localhost:…；静态页用 index.html 等 HTML。禁止把 docs/**/*.md 等说明文档当作 preview.url——不要因「没有页面」而省略
 6b. 若交付是 HTTP 服务：验收前必须先把服务跑起来（如 npm start），确认能打开 preview.url 后再 stamp accepted；不要只写地址却不启动
 7. 合入 develop 并 handoff 清理 worktree
 8. 文档语言：英文文档不得出现中文；中文文档可夹英文术语
+
+${DISPATCH_MUST_FINISH_RULES}
 ${deployPrompt}${architecturePrompt}`;
 
   let agentPrompt = String(startCommand || "").trim() || defaultPrompt;
@@ -3701,7 +3711,9 @@ Brief: ${featureDir}
 编排波次（只做这些已放行任务）：
 ${waveList}
 
-本波全部改成 - [x] 后停止；不要开始未放行 / 未满足 dependsOn 的任务。编排器会在依赖就绪后继续派发。
+本波全部改成 - [x] 后：若还有后续波次则静默停等编排器（不要写 Job not accepted yet）；若已无后续任务则 stamp delivery.json accepted 并输出 ✅ Job accepted。不要开始未放行 / 未满足 dependsOn 的任务。
+
+${DISPATCH_MUST_FINISH_RULES}
 `
         : `${agentPrompt}
 
@@ -3711,7 +3723,9 @@ ${waveList}
 当前编排波次（只做这些）：
 ${waveList}
 
-本波全部改成 - [x] 后停止；不要开始未放行 / 未满足 dependsOn 的任务。其他任务由同事或后续波次负责。不要改 Brief 范围外的东西。
+本波全部改成 - [x] 后：若你还有后续波次则静默停等；若你负责的任务已全部做完且轮到 stamp，则 stamp delivery.json accepted 并输出 ✅ Job accepted。不要写 Job not accepted yet。不要开始未放行 / 未满足 dependsOn 的任务。其他任务由同事或后续波次负责。不要改 Brief 范围外的东西。
+
+${DISPATCH_MUST_FINISH_RULES}
 `;
     const wLog =
       assigned.workerCount === 1
@@ -4229,11 +4243,13 @@ ${restated.keep}
 0. 本轮 Revision 已在 Duaer-spec FDE 自动验收通过。直接改；不要进入 Confirming intent；不要让用户从多个风格/方向选项里再选一次；不要反复确认需求
 1. 只做本轮 Revision ${revN} 范围，不要重做无关功能
 2. 立刻把 tasks.md 里 R${revN}-* 勾成 - [x]（Duaer-spec FDE 靠此显示细粒度进度）
-2b. 拆任务：每个 R${revN}-* 只覆盖一个可独立验收的改动；不要把多项验收揉进同一条；不要人为限制条数。若仍偏粗，先按本轮 acceptance 扩成「一条改动一勾选」（仍用 R${revN}-*），保存后再做；小步勾选
-3. 对照本轮 Revision acceptance 全部满足后，才 stamp delivery.json 为 accepted，并必须更新 preview.url（页面路径或 http://localhost:… 服务地址，必填）；若是服务须先启动并可打开
+2b. 拆任务（强制）：必须拆到原子任务且每条可独立验证；每个 R${revN}-* 只覆盖一个改动；进度用 - [ ]/- [x] 立刻勾选监控；不要把多项验收揉进同一条；不要人为限制条数。若仍偏粗，先按本轮 acceptance 扩成「一条改动一勾选」（仍用 R${revN}-*），保存后再做
+3. 对照本轮 Revision acceptance 全部满足后，才 stamp delivery.json 为 accepted，并必须更新 preview.url 为可打开的成品入口（http://localhost:… 或 HTML 页面，必填；禁止用 docs/**/*.md 当预览）；若是服务须先启动并可打开。禁止以 Job not accepted yet 收尾
 3b. 交付前必须更新产品仓 README（说明文档）以反映本轮改动后的行为/用法；需求变了就改 README，不要只改代码。英文 README 不得出现中文；中文说明用 README.zh-CN.md（或项目既有约定）
 4. 按 testing.md 做风险验证（若有）
 5. 不要推远程除非用户明确要求部署/发布
+
+${DISPATCH_MUST_FINISH_RULES}
 `;
 
   let agentPrompt = String(startCommand || "").trim() || defaultPrompt;
@@ -5019,8 +5035,10 @@ ${waveList}
 要求：
 1. 只做本波已放行任务；立刻把完成项改成 tasks.md 的 - [x]
 2. 不要开始未放行 / 未满足 dependsOn 的任务
-3. 本波全部勾完后停止；编排器会继续派发
+3. 本波勾完后：若还有后续波次则静默停等编排器；若已无后续 / 需 stamp，则完成 stamp delivery.json accepted 并输出 ✅ Job accepted
 4. 只在上述 worktree 内改动；不要推远程除非明确要求
+
+${DISPATCH_MUST_FINISH_RULES}
 `;
     const wLog =
       workerCount === 1
@@ -5051,6 +5069,66 @@ ${waveList}
     }
   }
 
+  // All tasks checked but delivery still open → nudge idle lane once to stamp accept.
+  const allTasksDone =
+    progress &&
+    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]
+    : [];
+  if (
+    allTasksDone &&
+    !accepted &&
+    agentId &&
+    worktreePath &&
+    !(nudgeTerm.busy || Number(nudgeTerm.queueDepth || 0) > 0) &&
+    !priorNudge.includes(acceptFp)
+  ) {
+    const brief = featureDir || dispatch.featureDir || "";
+    const prompt = `Duaer
+
+编排器催办：tasks.md 已全部勾选，但 delivery.json 尚未 accepted。工作目录: ${worktreePath}
+Brief: ${brief}
+
+立刻完成验收收尾（不要再改无关功能）：
+1. 更新产品 README（若尚未反映本次交付）
+2. 启动可打开的服务（若是 HTTP），确认能打开
+3. stamp delivery.json 为 accepted，必须写入 preview.url
+4. 最终只输出：✅ Job accepted — ready for your review.
+5. 禁止输出 Job not accepted yet / ⏳ not accepted
+
+${DISPATCH_MUST_FINISH_RULES}
+`;
+    const wLog =
+      workerCount === 1
+        ? path.join(brief, "agent-launch.log")
+        : path.join(brief, `agent-launch-${nudgeLane}.log`);
+    try {
+      launchAgent({
+        agentId,
+        worktreePath,
+        agentPrompt: prompt,
+        logPath: wLog,
+        featureDir: brief,
+        continueSession: true,
+        queueLane: workerCount > 1 ? nudgeLane : null,
+      });
+      releasedWaves[nudgeLane] = [...priorNudge, acceptFp];
+      changed = true;
+    } catch (err) {
+      errors.push(
+        `accept-nudge: ${err?.message || String(err || "launch failed")}`,
+      );
+    }
+  }
+
   const summary = orchestrationSummary({
     pool,
     doneSet,
@@ -5323,17 +5401,39 @@ function dispatchStatus(jobId) {
     revision: resultRevision,
     accepted,
   });
-  // Prefer latest snapshot URL when we recorded one for this revision.
+  // Prefer openable product URL (service / HTML). Never promote docs (.md) snapshots.
   let previewOut = showPreview ? preview : null;
   if (previewOut && accepted && results.length) {
     const latest = results[results.length - 1];
-    if (latest?.url && Number(latest.revision) === resultRevision) {
+    const latestOpenable =
+      latest?.url &&
+      Number(latest.revision) === resultRevision &&
+      (/^https?:\/\//i.test(String(latest.url)) ||
+        isOpenableProductPreview(latest.path || "") ||
+        /\.html?(?:$|[?#])/i.test(String(latest.url)));
+    if (latestOpenable) {
       previewOut = {
         ...previewOut,
         url: latest.url,
         label: latest.label || previewOut.label,
         kind: latest.kind || previewOut.kind,
+        path: latest.path || previewOut.path || null,
       };
+    } else {
+      const openable = pickOpenableResultEntry(results);
+      const previewAlreadyOpenable =
+        /^https?:\/\//i.test(String(previewOut.url || "")) ||
+        isOpenableProductPreview(previewOut.path || "") ||
+        /\.html?(?:$|[?#])/i.test(String(previewOut.url || ""));
+      if (!previewAlreadyOpenable && openable?.url) {
+        previewOut = {
+          ...previewOut,
+          url: openable.url,
+          label: openable.label || previewOut.label,
+          kind: openable.kind || previewOut.kind,
+          path: openable.path || null,
+        };
+      }
     }
   }
   // After worktree cleanup with no previewable snapshot, hide dead current link.
@@ -6478,10 +6578,13 @@ async function handleApi(req, res) {
         send(res, 400, { error: "path required", code: "EMPTY_PATH" });
         return;
       }
+      const langRaw = String(url.searchParams.get("lang") || "").toLowerCase();
       const lang =
-        String(url.searchParams.get("lang") || "").toLowerCase() === "en"
+        langRaw === "en" || langRaw.startsWith("en")
           ? "en"
-          : "zh";
+          : langRaw === "ja" || langRaw.startsWith("ja")
+            ? "ja"
+            : "zh";
       const asJson = String(url.searchParams.get("format") || "") === "json";
       const session = readProjectChat(liveRoot(), projectPath);
       let job = null;

package/bin/live-deliverables.mjs

@@ -15,12 +15,25 @@ function esc(s) {
     .replace(/"/g, """);
 }
 
+function normalizeDeliverablesLang(lang) {
+  const l = String(lang || "").toLowerCase();
+  if (l === "en" || l.startsWith("en")) return "en";
+  if (l === "ja" || l.startsWith("ja")) return "ja";
+  return "zh";
+}
+
+function pickLang(lang, map) {
+  const l = normalizeDeliverablesLang(lang);
+  return map[l] ?? map.zh;
+}
+
 function fmtAt(iso, lang) {
-  if (!iso) return lang === "en" ? "—" : "—";
+  if (!iso) return "—";
   try {
     const d = new Date(iso);
     if (Number.isNaN(d.getTime())) return String(iso).slice(0, 19);
-    return d.toLocaleString(lang === "en" ? "en-US" : "zh-CN", {
+    const tag = pickLang(lang, { en: "en-US", ja: "ja-JP", zh: "zh-CN" });
+    return d.toLocaleString(tag, {
       year: "numeric",
       month: "2-digit",
       day: "2-digit",
@@ -279,7 +292,7 @@ function renderTaskPoolHtml(body, L) {
  * @param {{ job?: object|null, lang?: string, projectTitle?: string }} [opts]
  */
 export function buildDeliverablesModel(session, opts = {}) {
-  const lang = opts.lang === "en" ? "en" : "zh";
+  const lang = normalizeDeliverablesLang(opts.lang);
   const s = session && typeof session === "object" ? session : {};
   const modules = Array.isArray(s.modules) ? s.modules : [];
   const confirmed = modules.filter((m) => m.status === "confirmed");
@@ -294,7 +307,7 @@ export function buildDeliverablesModel(session, opts = {}) {
   if (allReq || confirmed.length) {
     reqVersions.push({
       id: "v0",
-      label: lang === "en" ? "Initial" : "初版",
+      label: pickLang(lang, { en: "Initial", ja: "初版", zh: "初版" }),
       at: s.updatedAt || null,
       modules: (allReq ? modules : confirmed).map((m) => ({
         id: m.id,
@@ -309,8 +322,11 @@ export function buildDeliverablesModel(session, opts = {}) {
     if (rev < 1) continue;
     reqVersions.push({
       id: `r${rev}`,
-      label:
-        lang === "en" ? `Revision ${rev}` : `第 ${rev} 次改进`,
+      label: pickLang(lang, {
+        en: `Revision ${rev}`,
+        ja: `改訂 ${rev}`,
+        zh: `第 ${rev} 次改进`,
+      }),
       at: entry.at || s.updatedAt || null,
       revise: {
         goal: entry.goal || "",
@@ -324,19 +340,27 @@ export function buildDeliverablesModel(session, opts = {}) {
   const stages = [
     {
       id: "requirements",
-      title: lang === "en" ? "Requirements" : "需求",
+      title: pickLang(lang, { en: "Requirements", ja: "要件", zh: "需求" }),
       status: allReq ? "done" : confirmed.length ? "partial" : "empty",
       artifacts: [
         {
           id: "req-doc",
-          title: lang === "en" ? "Requirements document" : "需求文档",
+          title: pickLang(lang, {
+            en: "Requirements document",
+            ja: "要件ドキュメント",
+            zh: "需求文档",
+          }),
           kind: "timeline",
           ready: reqVersions.length > 0,
           versions: reqVersions,
         },
         {
           id: "req-confirm",
-          title: lang === "en" ? "Requirements confirmation" : "需求确认书",
+          title: pickLang(lang, {
+            en: "Requirements confirmation",
+            ja: "要件確認書",
+            zh: "需求确认书",
+          }),
           kind: "confirmations",
           ready: confirmed.length > 0,
           confirmations: confirmed.map((m) => ({
@@ -350,12 +374,16 @@ export function buildDeliverablesModel(session, opts = {}) {
     },
     {
       id: "architecture",
-      title: lang === "en" ? "Architecture" : "架构",
+      title: pickLang(lang, { en: "Architecture", ja: "アーキテクチャ", zh: "架构" }),
       status: arch.confirmed ? "done" : arch.url ? "partial" : "empty",
       artifacts: [
         {
           id: "arch-diagram",
-          title: lang === "en" ? "Architecture diagram" : "架构图",
+          title: pickLang(lang, {
+            en: "Architecture diagram",
+            ja: "アーキテクチャ図",
+            zh: "架构图",
+          }),
           kind: "architecture",
           ready: Boolean(arch.url),
           url: arch.url || null,
@@ -364,34 +392,48 @@ export function buildDeliverablesModel(session, opts = {}) {
         },
         {
           id: "arch-confirm",
-          title: lang === "en" ? "Architecture confirmation" : "架构确认",
+          title: pickLang(lang, {
+            en: "Architecture confirmation",
+            ja: "アーキテクチャ確認",
+            zh: "架构确认",
+          }),
           kind: "note",
           ready: Boolean(arch.confirmed),
           body: arch.confirmed
-            ? lang === "en"
-              ? "Architecture confirmed on the desk."
-              : "已在台面确认架构。"
+            ? pickLang(lang, {
+                en: "Architecture confirmed on the desk.",
+                ja: "デスクでアーキテクチャを確認済みです。",
+                zh: "已在台面确认架构。",
+              })
             : "",
         },
       ],
     },
     {
       id: "kickoff",
-      title: lang === "en" ? "Kickoff & implementation" : "开工与实现",
+      title: pickLang(lang, {
+        en: "Kickoff & implementation",
+        ja: "キックオフと実装",
+        zh: "开工与实现",
+      }),
       status: s.jobId || s.taskPool ? "done" : "empty",
       artifacts: [
         {
           id: "brief",
-          title: lang === "en" ? "Brief / job" : "Brief / 工单",
+          title: pickLang(lang, {
+            en: "Brief / job",
+            ja: "Brief / ジョブ",
+            zh: "Brief / 工单",
+          }),
           kind: "note",
           ready: Boolean(s.jobId),
           body: s.jobId
-            ? `${lang === "en" ? "Job" : "工单"}: ${s.jobId}`
+            ? `${pickLang(lang, { en: "Job", ja: "ジョブ", zh: "工单" })}: ${s.jobId}`
             : "",
         },
         {
           id: "task-pool",
-          title: lang === "en" ? "Task pool" : "任务池",
+          title: pickLang(lang, { en: "Task pool", ja: "タスクプール", zh: "任务池" }),
           kind: "taskpool",
           ready: Boolean(s.taskPool),
           body: s.taskPool
@@ -399,16 +441,18 @@ export function buildDeliverablesModel(session, opts = {}) {
             : "",
           meta:
             Number(s.workerCount) > 1
-              ? lang === "en"
-                ? `Workers: ${s.workerCount}`
-                : `数字员工：${s.workerCount}`
+              ? pickLang(lang, {
+                  en: `Workers: ${s.workerCount}`,
+                  ja: `デジタル従業員：${s.workerCount}`,
+                  zh: `数字员工：${s.workerCount}`,
+                })
               : "",
         },
       ],
     },
     {
       id: "delivery",
-      title: lang === "en" ? "Delivery" : "交付",
+      title: pickLang(lang, { en: "Delivery", ja: "デリバリー", zh: "交付" }),
       status:
         delivery?.status === "accepted" || job?.jobStatus === "accepted"
           ? "done"
@@ -418,22 +462,26 @@ export function buildDeliverablesModel(session, opts = {}) {
       artifacts: [
         {
           id: "delivery-stamp",
-          title: lang === "en" ? "Delivery stamp" : "交付戳",
+          title: pickLang(lang, {
+            en: "Delivery stamp",
+            ja: "デリバリースタンプ",
+            zh: "交付戳",
+          }),
           kind: "note",
           ready: Boolean(delivery || job?.jobStatus),
           body: delivery
-            ? `${lang === "en" ? "Status" : "状态"}: ${delivery.status || "—"}${
+            ? `${pickLang(lang, { en: "Status", ja: "状態", zh: "状态" })}: ${delivery.status || "—"}${
                 delivery.acceptedAt
-                  ? `\n${lang === "en" ? "Accepted" : "验收"}: ${delivery.acceptedAt}`
+                  ? `\n${pickLang(lang, { en: "Accepted", ja: "受入", zh: "验收" })}: ${delivery.acceptedAt}`
                   : ""
               }`
             : job?.jobStatus
-              ? `${lang === "en" ? "Job status" : "工单状态"}: ${job.jobStatus}`
+              ? `${pickLang(lang, { en: "Job status", ja: "ジョブ状態", zh: "工单状态" })}: ${job.jobStatus}`
               : "",
         },
         {
           id: "preview",
-          title: lang === "en" ? "Preview" : "预览",
+          title: pickLang(lang, { en: "Preview", ja: "プレビュー", zh: "预览" }),
           kind: "link",
           ready: Boolean(preview?.url),
           url: preview?.url || null,
@@ -445,14 +493,15 @@ export function buildDeliverablesModel(session, opts = {}) {
   if (reviseCards.length || s.reviseLocked || s.lastRevision) {
     stages.push({
       id: "revise",
-      title: lang === "en" ? "Revisions" : "改进",
+      title: pickLang(lang, { en: "Revisions", ja: "改訂", zh: "改进" }),
       status: reviseCards.length ? "done" : "partial",
       artifacts: reviseCards.map((entry) => ({
         id: `revise-${entry.revision}`,
-        title:
-          lang === "en"
-            ? `Revision ${entry.revision} plan`
-            : `第 ${entry.revision} 版改进方案`,
+        title: pickLang(lang, {
+          en: `Revision ${entry.revision} plan`,
+          ja: `改訂 ${entry.revision} プラン`,
+          zh: `第 ${entry.revision} 版改进方案`,
+        }),
         kind: "card",
         ready: true,
         card: {
@@ -474,7 +523,7 @@ export function buildDeliverablesModel(session, opts = {}) {
     projectTitle:
       String(opts.projectTitle || "").trim() ||
       path.basename(String(s.projectPath || "")) ||
-      (lang === "en" ? "Project" : "项目"),
+      pickLang(lang, { en: "Project", ja: "プロジェクト", zh: "项目" }),
     updatedAt: s.updatedAt || null,
     stages,
   };
@@ -512,6 +561,37 @@ function labelsFor(lang) {
       jump: "View in requirements",
     };
   }
+  if (lang === "ja") {
+    return {
+      brand: "プロジェクト成果物",
+      pageTitle: "成果物ドシエ",
+      subtitle: "各段階で何ができたかを整理した記録",
+      generated: "生成日時",
+      project: "プロジェクト",
+      emptyStage: "まだ成果物はありません",
+      emptyCard: "（空）",
+      goal: "目的",
+      out: "対象外",
+      accept: "受入基準",
+      assume: "前提",
+      statusDone: "完了",
+      statusPartial: "進行中",
+      statusEmpty: "未着手",
+      timeline: "バージョンタイムライン",
+      toc: "目次",
+      artifacts: "成果物",
+      openArch: "図を開く",
+      openLink: "開く",
+      confirmed: "確認済み",
+      draft: "下書き",
+      module: "モジュール",
+      depends: "依存",
+      taskId: "ID",
+      taskTitle: "タスク",
+      confirmRegistry: "確認レジストリ",
+      jump: "要件本文を見る",
+    };
+  }
   return {
     brand: "项目交付物",
     pageTitle: "交付物档案",
@@ -631,7 +711,7 @@ function renderArtifact(art, L, lang) {
  * @param {ReturnType<typeof buildDeliverablesModel>} model
  */
 export function renderDeliverablesHtml(model) {
-  const lang = model.lang === "en" ? "en" : "zh";
+  const lang = normalizeDeliverablesLang(model.lang);
   const L = labelsFor(lang);
   const stages = model.stages || [];
   const tocHtml = `<nav class="toc" aria-label="${esc(L.toc)}">
@@ -673,7 +753,7 @@ export function renderDeliverablesHtml(model) {
     .join("\n");
 
   return `<!DOCTYPE html>
-<html lang="${lang === "en" ? "en" : "zh-CN"}">
+<html lang="${pickLang(lang, { en: "en", ja: "ja", zh: "zh-CN" })}">
 <head>
 <meta charset="utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />