duaer-spec 0.21.0 → 0.22.0

package/.claude/rules/duaer-spec.md

@@ -28,9 +28,12 @@ For new behavior, fixes, refactors that change product behavior, or architecture
 3. Do **not** wait for `/duaer-do` or any other skill invocation.
 4. Do **not** say “please run `/duaer-specify`” — you do it.
 5. Do **not** dump a methodology tutorial unless they ask how Duaer works.
-6. Merge to **`develop`** when done (hotfix: **`main`**, then back-merge
+6. **Break down to atomic, monitorable tasks:** each `tasks.md` item is one
+   independently verifiable atom with a `- [ ]` / `- [x]` checkbox; mark done
+   as you go so progress is visible. Do not leave only coarse mega-tasks.
+7. Merge to **`develop`** when done (hotfix: **`main`**, then back-merge
    **`develop`**). Promote to **`main`** only if the user asks to go online.
-7. **Handoff (mandatory):** stop processes bound to `.worktree/<id>/`, remove
+8. **Handoff (mandatory):** stop processes bound to `.worktree/<id>/`, remove
    the worktree, then restart services from the primary checkout on `develop`
    using `.duaer/handoff.json` / `duaer handoff [--run]`. Never leave the user
    on a dead worktree server.

package/.cursor/rules/duaer-spec.mdc

@@ -32,9 +32,12 @@ For new behavior, fixes, refactors that change product behavior, or architecture
 3. Do **not** wait for `/duaer-do` or any other skill invocation.
 4. Do **not** say “please run `/duaer-specify`” — you do it.
 5. Do **not** dump a methodology tutorial unless they ask how Duaer works.
-6. Merge to **`develop`** when done (hotfix: **`main`**, then back-merge
+6. **Break down to atomic, monitorable tasks:** each `tasks.md` item is one
+   independently verifiable atom with a `- [ ]` / `- [x]` checkbox; mark done
+   as you go so progress is visible. Do not leave only coarse mega-tasks.
+7. Merge to **`develop`** when done (hotfix: **`main`**, then back-merge
    **`develop`**). Promote to **`main`** only if the user asks to go online.
-7. **Handoff (mandatory):** stop processes bound to `.worktree/<id>/`, remove
+8. **Handoff (mandatory):** stop processes bound to `.worktree/<id>/`, remove
    the worktree, then restart services from the primary checkout on `develop`
    using `.duaer/handoff.json` / `duaer handoff [--run]`. Never leave the user
    on a dead worktree server.

package/.cursor/skills/duaer-do/SKILL.md

@@ -54,7 +54,13 @@ Do **not** lecture about methodology. Do **not** ask them to run commands.
    - Deep ambiguity after a full Spec still uses `duaer-clarify` (up to 5
      questions). Understand is the **lightweight front door** on every ask.
 
-3. **Break down** — If `tasks.md` missing, write a short checklist from the Spec.
+3. **Break down** — If `tasks.md` missing, write a checklist from the Spec.
+   **Atomic + monitorable (mandatory):**
+   - Split until each item is **one** independently verifiable acceptance /
+     deliverable atom (not a mega-phase).
+   - Every item is a markdown checkbox (`- [ ]` / `- [x]`) so progress can be
+     polled; check off immediately when that atom is done.
+   - Prefer one checkbox per Acceptance line; no artificial upper count.
    Skip a heavy plan unless architecture or contracts change.
 
 4. **Work** — Implement open tasks; mark `[x]` as you go. No scope beyond Spec.

package/.cursor/skills/duaer-tasks/SKILL.md

@@ -139,6 +139,14 @@ The tasks.md should be immediately executable - each task must be specific enoug
 
 **CRITICAL**: Tasks MUST be organized by user story to enable independent implementation and testing.
 
+**Atomic + monitorable (NON-NEGOTIABLE)**:
+- Every task is **one** independently verifiable atom (one acceptance point,
+  one file-scoped change, or one verification slice) — not a bundled mega-task.
+- Every task is a markdown checkbox (`- [ ]` / `- [x]`) so progress is
+  monitorable; agents mark `[x]` as each atom completes.
+- Prefer one task per Acceptance / independent-test criterion. No artificial
+  upper count; refine if still too coarse.
+
 **Verification is DEFAULT**: For each user story, generate verification tasks
 from `.duaer/memory/testing.md` (L0–L3 as the risk table requires). Do **not**
 omit tests just because the Spec did not say “TDD”. Only skip a level when the

package/.duaer/active-job.json

@@ -1,5 +1,5 @@
 {
-  "featureDir": ".duaer/specs/202-release-021",
-  "slug": "202-release-021",
-  "branch": "chore/release-021"
+  "featureDir": ".duaer/specs/205-release-022",
+  "slug": "205-release-022",
+  "updatedAt": "2026-09-19T07:35:00.000Z"
 }

package/.duaer/memory/constitution.md

@@ -41,3 +41,16 @@ cannot cover the path.
 **Job handoff (not a git lock):** the agent reports accept/open itself.
 Default policy `coach` — do not claim "done" while the active job is unfinished.
 Do not send the human to run `duaer status` for routine work.
+
+### V. Atomic verifiable tasks; progress must be monitorable (NON-NEGOTIABLE)
+
+When breaking down work (`tasks.md`, kickoff task pool, or mid-job re-split):
+
+1. **Atomic + verifiable:** each task covers **one** independently checkable
+   acceptance point or deliverable slice. Do not bundle unrelated acceptance
+   into a mega-task.
+2. **Monitorable progress:** every task is a markdown checkbox
+   (`- [ ]` / `- [x]`). Mark `[x]` as soon as that atom is done so FDE / humans
+   can see progress. Do not replace checkboxes with prose-only status.
+3. Prefer splitting Acceptance lines (and Goal slices) over inventing coarse
+   phases. There is **no** artificial upper count; refine if still too coarse.

package/.duaer/specs/202-release-021/delivery.json

@@ -0,0 +1,18 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T04:20:00.000Z",
+  "summary": "0.21.0 shipped: develop+main pushed, tag v0.21.0, GitHub Release, npm publish success.",
+  "verification": {
+    "commands": [
+      "git push origin develop main v0.21.0",
+      "gh release create v0.21.0",
+      "gh run watch 35420973848 → success",
+      "npm view duaer-spec version → 0.21.0"
+    ]
+  },
+  "preview": {
+    "url": "https://www.npmjs.com/package/duaer-spec/v/0.21.0",
+    "label": "npm 0.21.0"
+  },
+  "release": "https://github.com/fujiezee/duaer-spec/releases/tag/v0.21.0"
+}

package/.duaer/specs/202-release-021/tasks.md

@@ -1,5 +1,5 @@
 # Tasks — 202-release-021
 
 - [x] Brief
-- [ ] Bump 0.21.0 + CHANGELOG
-- [ ] Promote / push / release / npm
+- [x] Bump 0.21.0 + CHANGELOG
+- [x] Promote / push / release / npm

package/.duaer/specs/203-atomic-monitorable-tasks/delivery.json

@@ -0,0 +1,13 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T04:50:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1"],
+    "commands": [
+      "node --check bin/live-modules.mjs bin/live-progress.mjs web/live-dev/task-graph.mjs web/live-dev/acceptance-lines.mjs",
+      "npm test (165 pass; atomic pool + preview split covered)"
+    ],
+    "result": "pass"
+  },
+  "summary": "Atomic verifiable tasks with checkbox-monitorable progress: constitution, skills, kickoff pool + preview graph split acceptance lines."
+}

package/.duaer/specs/203-atomic-monitorable-tasks/spec.md

@@ -0,0 +1,44 @@
+# Feature Specification: Atomic verifiable tasks with monitorable progress
+
+**Feature Branch**: `feat/atomic-tasks`
+
+## Goal
+
+When decomposing work (Break down / kickoff task pool / `tasks.md`), every
+task MUST be an **atomic, independently verifiable** unit, and every task's
+progress MUST be **monitorable** via a markdown checkbox that the FDE desk
+(and agents) can poll.
+
+## Why
+
+Coarse mega-tasks hide progress and block wave orchestration. Acceptance
+bundled into one line cannot be checked off piecemeal.
+
+## In scope
+
+- Constitution + duaer-do / duaer-tasks / template wording for the rule
+- Kickoff `buildTaskPoolFromModules` splits module acceptance into one
+  checkbox task per acceptance line (plus impl / verify / shared steps)
+- Preview task graph uses the same atomic split so path matches pool
+- `tasks.md` footer / dispatch prompt reinforce: checkbox = progress signal
+- Tests + E2E catalog row
+
+## Out of scope
+
+- Changing orchestration wave algorithm beyond richer ready sets
+- Dedicated cloud / npm release
+
+## Acceptance
+
+1. Constitution (or equivalent always-on rule) states: decompose to atomic
+   verifiable tasks; each task progress monitorable via `- [ ]` / `- [x]`
+2. Module with multi-line acceptance yields one task per acceptance line in
+   the task pool / `tasks.md`
+3. Preview pool for the same modules has matching atomic acceptance tasks
+4. Unit tests cover the split; E2E catalog mentions the rule
+5. Agents following duaer-do Break down must not leave only coarse mega-tasks
+
+## Assumptions
+
+- Prefer splitting on acceptance lines / `;` / `；` (existing
+  `splitAcceptanceLines`) rather than LLM rephrasing at kickoff

package/.duaer/specs/203-atomic-monitorable-tasks/tasks.md

@@ -0,0 +1,8 @@
+# Tasks
+
+- [x] T001 Add constitution + duaer-do / duaer-tasks / template rule
+- [x] T002 Split acceptance into atomic tasks in live-modules pool
+- [x] T003 Mirror atomic split in task-graph preview pool
+- [x] T004 Strengthen tasks.md footer + dispatch prompt wording
+- [x] T005 Unit tests + E2E catalog
+- [x] T006 Stamp delivery accepted

package/.duaer/specs/204-live-i18n-ja/delivery.json

@@ -0,0 +1,14 @@
+{
+  "status": "accepted",
+  "acceptedAt": "2026-09-19T07:40:00.000Z",
+  "verification": {
+    "levels": ["L0", "L1", "L3"],
+    "commands": [
+      "node --check web/live-dev/i18n.js web/live-dev/i18n-ja.js web/live-dev/app.js bin/live-deliverables.mjs",
+      "npm test (168 pass incl. live-i18n-ja)",
+      "npm run test:live"
+    ],
+    "result": "pass"
+  },
+  "summary": "Added Japanese (ja) live desk locale with full catalog parity, language select, and deliverables lang=ja."
+}

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

@@ -0,0 +1,34 @@
+# Feature Specification: Live desk Japanese locale (ja)
+
+**Feature Branch**: `feat/live-i18n-ja`
+
+## Goal
+
+Add **Japanese (`ja`)** as a third FDE live-desk language beside zh-CN and en.
+Users can switch to 日本語; reload keeps the choice; desk copy updates.
+
+## In scope
+
+- `LOCALES` includes `ja`; full catalog for all i18n keys
+- Language `<select>` option; `detectLocale` for `ja*` navigator
+- Deliverables `lang=ja` + date/`html lang` handling
+- app.js list join / toLocaleString for ja
+- task-graph Archify locale passthrough
+- E2E catalog + unit/smoke markers; CHANGELOG
+
+## Out of scope
+
+- Translating README / intro site / worker-models.md into Japanese
+- Other locales beyond `ja`
+
+## Acceptance
+
+1. Language select shows 日本語 (`ja`); switching updates visible desk copy
+2. Reload keeps `ja` via localStorage
+3. Every key present in `en` exists in `ja` (no missing-key gaps in catalog parity test)
+4. Deliverables HTML accepts `lang=ja`
+5. `npm test` / required live smoke still pass
+
+## Assumptions
+
+- Default remains zh-CN when unset; `ja` browser language can auto-detect to ja

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,20 @@
 
 ## 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

package/bin/duaer-live.mjs

@@ -3625,7 +3625,7 @@ Brief: ${featureDir}
 3. 按 .duaer/memory/testing.md（若有）做风险验证
 4. 每完成 tasks.md 中的一步，立刻把该行改成 - [x]（Duaer-spec FDE 靠此显示细粒度进度与编排放行）
 4a. 只做当前编排波次已放行的任务；未满足 dependsOn / 未放行的任务不要开工；本波勾完后：若还有后续波次则静默停等编排器 continue（不要写 Job not accepted yet）；若已无后续波次则继续完成 stamp accepted
-4b. 拆任务：每个勾选项只覆盖一个可独立验收的功能点；不要把多项验收揉进同一条；不要人为限制条数（不必卡在 12 条内）。若仍偏粗，先按 Acceptance 扩成「一条功能一勾选」（仍用 T00x），保存后再做；小步勾选，不要攒到最后一次勾完
+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（满意交付的必填证据）：必须是可打开的成品入口——HTTP 服务用 http://localhost:…；静态页用 index.html 等 HTML。禁止把 docs/**/*.md 等说明文档当作 preview.url——不要因「没有页面」而省略
@@ -4243,7 +4243,7 @@ ${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}-*），保存后再做；小步勾选
+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 做风险验证（若有）
@@ -6578,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" />