cabloy 5.1.249 → 5.1.250

package/.cabloy-version

@@ -1 +1 @@
-5.1.249
+5.1.250

package/.github/workflows/create-cabloy.yml

@@ -96,13 +96,60 @@ jobs:
           $log = Join-Path $redisDirectory 'redis.log'
           if (Test-Path $log) { Get-Content $log }
           throw 'Redis did not become ready'
+      - name: wait for published Cabloy package
+        shell: bash
+        run: |
+          node --input-type=module <<'NODE'
+          import { appendFileSync, readFileSync } from 'node:fs';
+
+          const expectedVersion = JSON.parse(readFileSync('package.json', 'utf8')).version;
+          const latestUrl = 'https://registry.npmjs.org/cabloy/latest';
+          const deadline = Date.now() + 20 * 60 * 1000;
+          let lastStatus = 'not checked';
+
+          while (Date.now() < deadline) {
+            try {
+              const response = await fetch(latestUrl, { cache: 'no-store' });
+              lastStatus = `${response.status} ${response.statusText}`;
+              if (response.ok) {
+                const metadata = await response.json();
+                if (metadata.version === expectedVersion) break;
+                lastStatus = `latest is ${metadata.version ?? 'unknown'}`;
+              }
+            } catch (error) {
+              lastStatus = error instanceof Error ? error.message : String(error);
+            }
+            console.log(`Waiting for cabloy@${expectedVersion} to become npm latest (${lastStatus})...`);
+            await new Promise(resolve => setTimeout(resolve, 10_000));
+          }
+
+          if (Date.now() >= deadline) {
+            throw new Error(`cabloy@${expectedVersion} was not npm latest within 20 minutes (last status: ${lastStatus})`);
+          }
+
+          appendFileSync(process.env.GITHUB_ENV, `CABLOY_VERSION=${expectedVersion}\n`);
+          NODE
       - name: create project
         run: npm create cabloy@latest cabloy-app
       - name: verify project initialization
         working-directory: cabloy-app
-        run: >-
-          node --input-type=module -e
-          "import { existsSync } from 'node:fs'; const required = ['.cabloy-version', 'package.json', 'vona/package.json', 'zova/package.json', 'node_modules', 'vona/node_modules', 'zova/node_modules', 'zova/dist']; const missing = required.filter(file => !existsSync(file)); if (missing.length) { console.error('Project initialization is incomplete:', missing.join(', ')); process.exit(1); }"
+        shell: bash
+        run: |
+          node --input-type=module <<'NODE'
+          import { existsSync, readFileSync } from 'node:fs';
+
+          const required = ['.cabloy-version', 'package.json', 'vona/package.json', 'zova/package.json', 'node_modules', 'vona/node_modules', 'zova/node_modules', 'zova/dist'];
+          const missing = required.filter(file => !existsSync(file));
+          const packageVersion = JSON.parse(readFileSync('package.json', 'utf8')).version;
+          if (packageVersion !== process.env.CABLOY_VERSION) {
+            console.error(`Expected cabloy@${process.env.CABLOY_VERSION}, got cabloy@${packageVersion}`);
+            process.exit(1);
+          }
+          if (missing.length) {
+            console.error('Project initialization is incomplete:', missing.join(', '));
+            process.exit(1);
+          }
+          NODE
       - name: reset database
         working-directory: cabloy-app
         run: npm run db:reset

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 5.1.250
+
+### Features
+
+- Add Japanese (`ja-jp`) and Traditional Chinese (`zh-tw`) locales.
+- Introduce locale providers and locale specifications.
+- Add grouping and aggregation capabilities.
+
+### Bug Fixes
+
+- Distinguish planning closure from unfinished work breakdown structure (WBS) scope.
+- Correct target decorator DTO resolution for OpenAPI.
+- Keep Cabloy Locale delivery confined to its worktree.
+
+### Improvements
+
+- Refactor CLI CRUD functionality.
+- Enhance grouping and aggregation.
+- Clarify locale provider examples and metadata commands.
+- Update locale documentation and synchronize OpenAPI guidance.
+
 ## 5.1.249
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cabloy",
-  "version": "5.1.249",
+  "version": "5.1.250",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "A Node.js fullstack framework",
   "keywords": [

package/repo-agent-governance/managed-assets.json

@@ -186,7 +186,7 @@
     {
       "adapter": "codex",
       "category": "skill",
-      "sha256": "9ec7a5dd8b7c1a5d561a96562ee754c148e1d14db953d3629075af89e38613d3",
+      "sha256": "a7375a23f4112d16407e867334781856367d041a956cb0009244881b3f88dcff",
       "source": "skills/cabloy-spec-execution/references/status-and-evidence.md",
       "target": ".agents/skills/cabloy-spec-execution/references/status-and-evidence.md"
     },
@@ -221,7 +221,7 @@
     {
       "adapter": "codex",
       "category": "skill",
-      "sha256": "f4051409e04e5557a3d45415b8111e6a70b7bfa013b52ee75553ace29d28531c",
+      "sha256": "6cb948d8c061c1abf96045f3edf5a24319c2cc22d9f1f6c5f1811b6face0333c",
       "source": "skills/cabloy-spec-generation/references/canonical-spec-input.md",
       "target": ".agents/skills/cabloy-spec-generation/references/canonical-spec-input.md"
     },
@@ -235,14 +235,14 @@
     {
       "adapter": "codex",
       "category": "skill",
-      "sha256": "17aaee04e0db0bce9b09d72eb55181d062b0024974ed72014681be1c8490a6a1",
+      "sha256": "0a8c64f3b0c055790d9fb2b267954dbbd0c2473a2ea0e5b2c8be2348a9956459",
       "source": "skills/cabloy-spec-generation/references/repo-specs-document-set.md",
       "target": ".agents/skills/cabloy-spec-generation/references/repo-specs-document-set.md"
     },
     {
       "adapter": "codex",
       "category": "skill",
-      "sha256": "6066944449f7072dbecfde7a79ceb16ebf75777b00c28ddc996b90d8dcdf2145",
+      "sha256": "6698717c1e20519fa13c2961de7e863fe5c2ff9f2f420f3f289f96a9533a190e",
       "source": "skills/cabloy-spec-generation/references/traceability-and-status-rules.md",
       "target": ".agents/skills/cabloy-spec-generation/references/traceability-and-status-rules.md"
     },
@@ -522,7 +522,7 @@
     {
       "adapter": "claude",
       "category": "skill",
-      "sha256": "9ec7a5dd8b7c1a5d561a96562ee754c148e1d14db953d3629075af89e38613d3",
+      "sha256": "a7375a23f4112d16407e867334781856367d041a956cb0009244881b3f88dcff",
       "source": "skills/cabloy-spec-execution/references/status-and-evidence.md",
       "target": ".claude/skills/cabloy-spec-execution/references/status-and-evidence.md"
     },
@@ -557,7 +557,7 @@
     {
       "adapter": "claude",
       "category": "skill",
-      "sha256": "f4051409e04e5557a3d45415b8111e6a70b7bfa013b52ee75553ace29d28531c",
+      "sha256": "6cb948d8c061c1abf96045f3edf5a24319c2cc22d9f1f6c5f1811b6face0333c",
       "source": "skills/cabloy-spec-generation/references/canonical-spec-input.md",
       "target": ".claude/skills/cabloy-spec-generation/references/canonical-spec-input.md"
     },
@@ -571,14 +571,14 @@
     {
       "adapter": "claude",
       "category": "skill",
-      "sha256": "17aaee04e0db0bce9b09d72eb55181d062b0024974ed72014681be1c8490a6a1",
+      "sha256": "0a8c64f3b0c055790d9fb2b267954dbbd0c2473a2ea0e5b2c8be2348a9956459",
       "source": "skills/cabloy-spec-generation/references/repo-specs-document-set.md",
       "target": ".claude/skills/cabloy-spec-generation/references/repo-specs-document-set.md"
     },
     {
       "adapter": "claude",
       "category": "skill",
-      "sha256": "6066944449f7072dbecfde7a79ceb16ebf75777b00c28ddc996b90d8dcdf2145",
+      "sha256": "6698717c1e20519fa13c2961de7e863fe5c2ff9f2f420f3f289f96a9533a190e",
       "source": "skills/cabloy-spec-generation/references/traceability-and-status-rules.md",
       "target": ".claude/skills/cabloy-spec-generation/references/traceability-and-status-rules.md"
     },
@@ -872,7 +872,7 @@
     {
       "adapter": "cursor",
       "category": "skill",
-      "sha256": "9ec7a5dd8b7c1a5d561a96562ee754c148e1d14db953d3629075af89e38613d3",
+      "sha256": "a7375a23f4112d16407e867334781856367d041a956cb0009244881b3f88dcff",
       "source": "skills/cabloy-spec-execution/references/status-and-evidence.md",
       "target": ".cursor/skills/cabloy-spec-execution/references/status-and-evidence.md"
     },
@@ -907,7 +907,7 @@
     {
       "adapter": "cursor",
       "category": "skill",
-      "sha256": "f4051409e04e5557a3d45415b8111e6a70b7bfa013b52ee75553ace29d28531c",
+      "sha256": "6cb948d8c061c1abf96045f3edf5a24319c2cc22d9f1f6c5f1811b6face0333c",
       "source": "skills/cabloy-spec-generation/references/canonical-spec-input.md",
       "target": ".cursor/skills/cabloy-spec-generation/references/canonical-spec-input.md"
     },
@@ -921,14 +921,14 @@
     {
       "adapter": "cursor",
       "category": "skill",
-      "sha256": "17aaee04e0db0bce9b09d72eb55181d062b0024974ed72014681be1c8490a6a1",
+      "sha256": "0a8c64f3b0c055790d9fb2b267954dbbd0c2473a2ea0e5b2c8be2348a9956459",
       "source": "skills/cabloy-spec-generation/references/repo-specs-document-set.md",
       "target": ".cursor/skills/cabloy-spec-generation/references/repo-specs-document-set.md"
     },
     {
       "adapter": "cursor",
       "category": "skill",
-      "sha256": "6066944449f7072dbecfde7a79ceb16ebf75777b00c28ddc996b90d8dcdf2145",
+      "sha256": "6698717c1e20519fa13c2961de7e863fe5c2ff9f2f420f3f289f96a9533a190e",
       "source": "skills/cabloy-spec-generation/references/traceability-and-status-rules.md",
       "target": ".cursor/skills/cabloy-spec-generation/references/traceability-and-status-rules.md"
     },

package/repo-agent-governance/skills/cabloy-spec-execution/references/status-and-evidence.md

@@ -102,7 +102,7 @@ The normal path is:
 not-started -> in-progress -> implementation-complete -> verified
 ```
 
-A genuinely documentary/design-only task can instead follow `not-started -> in-progress -> planning-complete`, but only when its formal WBS declaration contains `Completion mode: planning-only.`, its own checks have revision-scoped documentary evidence, and a named reviewer explicitly records the planning-closure disposition. `authority-only` traceability is not this opt-in. `planning-complete` satisfies a predecessor dependency edge but never grants successor execution approval, accepts another ADR, completes source, or passes a linked prospective runtime ATP. The Gantt shows its status separately; verified totals and the burndown's active-minus-verified remainder still count only `verified`. `implementation-complete`, `waived` and `deferred` are not completed prerequisites. `blocked`, `waived`, and `deferred` are explicit states, not shortcuts to completion. Mark an implementation task `in-progress` only after approved implementation or verification actually begins. A generated file, successful scaffold, passing typecheck, code review, manual walkthrough, screenshot, or unrelated broad test pass cannot by itself produce `verified`.
+A genuinely documentary/design-only task can instead follow `not-started -> in-progress -> planning-complete`, but only when its formal WBS declaration contains `Completion mode: planning-only.`, its own checks have revision-scoped documentary evidence, and a named reviewer explicitly records the planning-closure disposition. `authority-only` traceability is not this opt-in. `planning-complete` satisfies a predecessor dependency edge but never grants successor execution approval, accepts another ADR, completes source, or passes a linked prospective runtime ATP. Charts distinguish its documentary closure from verified acceptance. Verified totals count only `verified`; the burndown subtracts verified and eligible planning-complete counts from active scope for its unfinished remainder. Deferred scope is excluded; all other active statuses remain unfinished. `implementation-complete`, `waived` and `deferred` are not completed prerequisites. `blocked`, `waived`, and `deferred` are explicit states, not shortcuts to completion. Mark an implementation task `in-progress` only after approved implementation or verification actually begins. A generated file, successful scaffold, passing typecheck, code review, manual walkthrough, screenshot, or unrelated broad test pass cannot by itself produce `verified`.
 
 A task may be `implementation-complete` when source work is complete but an ATP, browser check, paired build, release gate, redaction decision, or durable artifact remains. A phase can be verified without implying that a separately defined integration or release phase is verified.
 

package/repo-agent-governance/skills/cabloy-spec-generation/references/canonical-spec-input.md

@@ -111,7 +111,7 @@ Setup, Procedure, Expected result, Minimum proof, and Traceability must each be
 | `WBS-DEMO-10-01` | `not-started` | None; execution has not begun. | Confirm the bounded execution dossier. |
 ```
 
-Resolve columns by header names (`WBS ID` and `Status`), never fixed cell positions. Additional/reordered columns are allowed. Require one row for every formal WBS task when constructing the complete chart model. Preserve the established status vocabulary and explain blockers/waivers precisely. `planning-complete` is valid only for a task declaring `Completion mode: planning-only.` in its WBS body; it satisfies a predecessor dependency edge but does not grant successor execution approval, count as verified, or reduce the verified-based burndown remainder.
+Resolve columns by header names (`WBS ID` and `Status`), never fixed cell positions. Additional/reordered columns are allowed. Require one row for every formal WBS task when constructing the complete chart model. Preserve the established status vocabulary and explain blockers/waivers precisely. `planning-complete` is valid only for a task declaring `Completion mode: planning-only.` in its WBS body; it satisfies a predecessor dependency edge but does not grant successor execution approval or count as verified. The burndown reports verified and eligible planning-complete counts separately; remaining = active scope − verified − eligible planning-complete. Deferred scope is separate; all other active statuses remain unfinished.
 
 ## Three gates, not one success signal
 

package/repo-agent-governance/skills/cabloy-spec-generation/references/repo-specs-document-set.md

@@ -41,7 +41,7 @@ When records disagree, update authority first, then downstream mappings and deri
 
 Generate/check charts only with complete supported README/WBS/ATP/progress inputs. Regenerate after `pdp-wbs.md`, `test-plan.md`, `progress.md`, or README title/language changes. An incomplete lightweight/legacy set reports missing chart inputs rather than inventing business definitions to make the generator run.
 
-The implementation charts are generated records, not authorities. The Gantt reads formal WBS phases/tasks/dependencies and progress status, with ATP labels only when they resolve in `test-plan.md`; absent authoritative dates or estimates must be shown as relative/illustrative order. The burndown reads active/deferred scope and verified status; without immutable dated snapshots it must be a scope-count reference rather than a calendar trend or forecast. Neither chart may add scope, dependencies, evidence, or completion claims. Both SVGs use the README-derived language consistently, including visible labels, accessibility text, and metadata.
+The implementation charts are generated records, not authorities. The Gantt reads formal WBS phases/tasks/dependencies and progress status, with ATP labels only when they resolve in `test-plan.md`; absent authoritative dates or estimates must be shown as relative/illustrative order. The burndown reads active/deferred scope, verified acceptance, and eligible planning-complete closure separately; without immutable dated snapshots it must be a scope-count reference rather than a calendar trend or forecast. Neither chart may add scope, dependencies, evidence, or completion claims. Both SVGs use the README-derived language consistently, including visible labels, accessibility text, and metadata.
 
 ## README template contract
 
@@ -201,7 +201,7 @@ Initialize a new suite with statuses such as `not-started`, `deferred`, or expli
 | `waived`                  | A temporary exception with owner, reason, and expiry; expiry makes it a release blocker.                                                                             |
 | `deferred`                | Explicitly postponed scope, not completed scope.                                                                                                                     |
 
-A `planning-complete` predecessor satisfies its dependency edge, not the next task's design/approval gates; keep a blocked successor blocked. Verified/remaining burndown counts still count only `verified` as complete. Progress must remain a derived register. It may point to evidence but must not become a second requirements document. Include a decision-register entry for each material site strategy and show strategy/identifier deferral as a blocker only on affected frontend/site WBS branches; source reading, planning, or a selected strategy alone is not implementation evidence.
+A `planning-complete` predecessor satisfies its dependency edge, not the next task's design/approval gates; keep a blocked successor blocked. Verified totals count only `verified`; the burndown separately counts eligible `planning-complete` and calculates remaining = active scope − verified − eligible planning-complete. Deferred scope is separate; all other active statuses remain unfinished. Progress must remain a derived register. It may point to evidence but must not become a second requirements document. Include a decision-register entry for each material site strategy and show strategy/identifier deferral as a blocker only on affected frontend/site WBS branches; source reading, planning, or a selected strategy alone is not implementation evidence.
 
 ## ADR 0001 template contract
 

package/repo-agent-governance/skills/cabloy-spec-generation/references/traceability-and-status-rules.md

@@ -84,7 +84,7 @@ Downstream records do not silently override authority. Charts cannot authorize s
 | `waived`                  | A temporary exception explicitly approved with owner, reason, and expiry.                                                                                           |
 | `deferred`                | Explicitly postponed scope; it is not complete or verified.                                                                                                         |
 
-For a newly created plan, initialize delivery rows as `not-started`, `deferred`, or `blocked` as appropriate. Creating Markdown files never makes a task `planning-complete`, implementation `implementation-complete`, or ATP `verified`. Only a formally declared `Completion mode: planning-only.` task with documentary acceptance checks, revision-scoped evidence and an explicit named-reviewer closure disposition may reach `planning-complete`; `authority-only` traceability does not establish this eligibility. A planning-complete predecessor satisfies its WBS dependency edge, but blocked/deferred/waived successors stay gated and require their own decisions and approvals. `implementation-complete`, `waived` and `deferred` do not satisfy predecessor completion. Only `verified` contributes to verified totals and the verified-based burndown remainder.
+For a newly created plan, initialize delivery rows as `not-started`, `deferred`, or `blocked` as appropriate. Creating Markdown files never makes a task `planning-complete`, implementation `implementation-complete`, or ATP `verified`. Only a formally declared `Completion mode: planning-only.` task with documentary acceptance checks, revision-scoped evidence and an explicit named-reviewer closure disposition may reach `planning-complete`; `authority-only` traceability does not establish this eligibility. A planning-complete predecessor satisfies its WBS dependency edge, but blocked/deferred/waived successors stay gated and require their own decisions and approvals. `implementation-complete`, `waived` and `deferred` do not satisfy predecessor completion. Only `verified` contributes to verified totals. The burndown separately reports eligible `planning-complete` closure and subtracts both from active scope to calculate unfinished work; deferred scope is excluded, and all other active statuses remain unfinished.
 
 ### README and ADR decision-status consistency
 

package/repo-agent-governance/tools/spec-charts/generate-implementation-charts.mjs

@@ -49,9 +49,14 @@ const COPY = {
       'Dependency readiness is not execution approval; descriptive gates still require review.',
     ganttDescription: (count, reviewed) =>
       `${count} formal WBS tasks. Current derived status reviewed ${reviewed}.`,
-    burndownDescription: (total, verified, remaining) =>
-      `${total} active WBS items; ${verified} verified; ${remaining} remaining.`,
-    phaseSummary: (number, verified, total) => `Phase ${number}: ${verified} / ${total} verified`,
+    burndownDescription: (total, verified, planningComplete, remaining) =>
+      `${total} active WBS items; ${verified} verified; ${planningComplete} planning complete; ${remaining} remaining.`,
+    phaseSummary: (number, total, verified, planningComplete, remaining) =>
+      `Phase ${number}: ${total} active; ${verified} verified; ${planningComplete} planning complete; ${remaining} remaining`,
+    planningComplete: 'planning complete',
+    completed: 'Completed',
+    completionCounts: (verified, planningComplete) =>
+      `${verified} verified · ${planningComplete} planning complete`,
     statuses: {
       'not-started': 'Not started',
       'in-progress': 'In progress',
@@ -65,14 +70,14 @@ const COPY = {
     source: 'Sources',
     reviewed: 'Last reviewed',
     scopeReference: 'Scope-count reference',
-    notTime: 'Verified WBS items in recorded scope — not time',
+    notTime: 'Completed WBS items (verified + planning complete) — not time',
     remainingAxis: 'WBS items remaining',
     logicalBaseline: 'Logical recorded-scope baseline',
     currentSnapshot: 'Current snapshot',
     remainingShort: 'remaining',
     emptyScope: 'No active WBS items remain in scope.',
     noHistory: 'No observed intermediate status points are available.',
-    formula: 'remaining = active scope − verified',
+    formula: 'remaining = active scope − verified − planning complete',
     phaseScope: 'Scope by phase',
     active: 'Active WBS items',
     deferred: 'Deferred',
@@ -107,9 +112,14 @@ const COPY = {
     candidateCaveat: '依赖就绪不代表实施批准；描述性门槛仍需审查。',
     ganttDescription: (count, reviewed) =>
       `${count} 项正式 WBS 工作。当前派生状态的审查日期：${reviewed}。`,
-    burndownDescription: (total, verified, remaining) =>
-      `${total} 项活跃 WBS 工作；${verified} 项已核验；${remaining} 项剩余。`,
-    phaseSummary: (number, verified, total) => `阶段 ${number}：${verified} / ${total} 项已核验`,
+    burndownDescription: (total, verified, planningComplete, remaining) =>
+      `${total} 项活跃 WBS 工作；${verified} 项已核验；${planningComplete} 项规划完成；${remaining} 项剩余。`,
+    phaseSummary: (number, total, verified, planningComplete, remaining) =>
+      `阶段 ${number}：${total} 项活跃；${verified} 项已核验；${planningComplete} 项规划完成；${remaining} 项剩余`,
+    planningComplete: '规划完成',
+    completed: '已完成',
+    completionCounts: (verified, planningComplete) =>
+      `${verified} 已核验 · ${planningComplete} 规划完成`,
     statuses: {
       'not-started': '未开始',
       'in-progress': '进行中',
@@ -123,14 +133,14 @@ const COPY = {
     source: '来源',
     reviewed: '最后审查日期',
     scopeReference: '范围计数参考',
-    notTime: '已核验的记录范围 WBS 项——不是时间',
+    notTime: '已完成 WBS 项（已核验 + 规划完成）——不是时间',
     remainingAxis: '剩余 WBS 项',
     logicalBaseline: '逻辑上的记录范围基线',
     currentSnapshot: '当前快照',
     remainingShort: '剩余',
     emptyScope: '当前范围内没有活跃 WBS 项。',
     noHistory: '没有可用的中间历史状态点。',
-    formula: '剩余 = 活跃范围 − 已核验',
+    formula: '剩余 = 活跃范围 − 已核验 − 规划完成',
     phaseScope: '按阶段统计范围',
     active: '活跃 WBS 项',
     deferred: '已延期',
@@ -236,6 +246,15 @@ function languageFromReadme(readme) {
   return cjk > latin / 3 ? 'zh' : 'en';
 }
 
+function completionCounts(tasks) {
+  const verified = tasks.filter(task => task.status === 'verified').length;
+  const planningComplete = tasks.filter(
+    task => task.status === 'planning-complete' && isPlanningCompleteEligible(task),
+  ).length;
+  const completed = verified + planningComplete;
+  return { verified, planningComplete, completed, remaining: tasks.length - completed };
+}
+
 export function createChartModel({ readme, wbs, progress, testPlan }) {
   const language = languageFromReadme(readme);
   const atpIds = parseAtpIds(testPlan);
@@ -275,7 +294,7 @@ export function createChartModel({ readme, wbs, progress, testPlan }) {
   }
   const activeTasks = tasks.filter(task => !task.deferred && task.status !== 'deferred');
   const deferredTasks = tasks.filter(task => !activeTasks.includes(task));
-  const verified = activeTasks.filter(task => task.status === 'verified').length;
+  const counts = completionCounts(activeTasks);
   return {
     language,
     copy: COPY[language],
@@ -284,7 +303,7 @@ export function createChartModel({ readme, wbs, progress, testPlan }) {
     activeTasks,
     deferredTasks,
     expandedEdges,
-    verified,
+    ...counts,
     reviewed: reviewed === 'not recorded' ? COPY[language].notRecorded : reviewed,
   };
 }
@@ -441,9 +460,19 @@ export function renderGantt(model, suiteName) {
 }
 
 export function renderBurndown(model, suiteName) {
-  const { copy: t, phases, activeTasks, deferredTasks, verified, reviewed, language } = model;
+  const {
+    copy: t,
+    phases,
+    activeTasks,
+    deferredTasks,
+    verified,
+    planningComplete,
+    completed,
+    remaining,
+    reviewed,
+    language,
+  } = model;
   const total = activeTasks.length;
-  const remaining = total - verified;
   const phaseBottom = 836 + Math.max(0, phases.length - 1) * 28;
   const footerY = Math.max(976, phaseBottom + 50);
   const height = footerY + 74;
@@ -451,7 +480,7 @@ export function renderBurndown(model, suiteName) {
   const x1 = 910;
   const y0 = 410;
   const y1 = 650;
-  const completion = total ? verified / total : 0;
+  const completion = total ? completed / total : 0;
   const currentX = x0 + completion * (x1 - x0);
   const currentY = y0 + completion * (y1 - y0);
   const currentMarker =
@@ -461,10 +490,31 @@ export function renderBurndown(model, suiteName) {
   const phaseRows = phases
     .map((phase, index) => {
       const phaseTasks = phase.tasks.filter(task => !task.deferred && task.status !== 'deferred');
-      const phaseVerified = phaseTasks.filter(task => task.status === 'verified').length;
+      const counts = completionCounts(phaseTasks);
+      const summary = t.phaseSummary(
+        phase.number,
+        phaseTasks.length,
+        counts.verified,
+        counts.planningComplete,
+        counts.remaining,
+      );
+      const status = !phaseTasks.length
+        ? 'deferred'
+        : counts.remaining
+          ? 'in-progress'
+          : counts.planningComplete
+            ? 'planning-complete'
+            : 'verified';
+      const label = !phaseTasks.length
+        ? t.emptyScope
+        : counts.remaining
+          ? `${counts.completed}/${phaseTasks.length}`
+          : counts.planningComplete && counts.verified
+            ? t.completed
+            : statusLabel(status, language);
       const y = 832 + index * 28;
-      const width = phaseTasks.length ? (phaseVerified / phaseTasks.length) * 210 : 0;
-      return `<g class="row" tabindex="0" aria-label="${escapeXml(t.phaseSummary(phase.number, phaseVerified, phaseTasks.length))}"><title>${escapeXml(`${t.phaseSummary(phase.number, phaseVerified, phaseTasks.length)} · ${phase.title}`)}</title><text class="task" x="96" y="${y}">${escapeXml(`${t.phase} ${phase.number} · ${phase.title}`)}</text><text class="num" x="730" y="${y}" text-anchor="end">${phaseVerified} / ${phaseTasks.length}</text><text class="num" x="850" y="${y}" text-anchor="end">${phaseTasks.length - phaseVerified}</text><rect x="930" y="${y - 11}" width="210" height="12" rx="6" fill="var(--blue-wash)"/><rect x="930" y="${y - 11}" width="${width}" height="12" rx="6" fill="var(--aqua)"/>${statusIcon(1215, y - 5, phaseVerified === phaseTasks.length ? 'verified' : 'in-progress')}<text class="small" x="1228" y="${y}">${escapeXml(phaseVerified === phaseTasks.length ? statusLabel('verified', language) : `${phaseVerified}/${phaseTasks.length}`)}</text></g>`;
+      const width = phaseTasks.length ? (counts.completed / phaseTasks.length) * 210 : 0;
+      return `<g class="row" tabindex="0" aria-label="${escapeXml(summary)}"><title>${escapeXml(`${summary} · ${phase.title}`)}</title><text class="task" x="96" y="${y}">${escapeXml(`${t.phase} ${phase.number} · ${phase.title}`)}</text><text class="num" x="650" y="${y}" text-anchor="end">${counts.verified}</text><text class="num" x="750" y="${y}" text-anchor="end">${counts.planningComplete}</text><text class="num" x="850" y="${y}" text-anchor="end">${counts.remaining}</text><rect x="930" y="${y - 11}" width="210" height="12" rx="6" fill="var(--blue-wash)"/><rect x="930" y="${y - 11}" width="${width}" height="12" rx="6" fill="var(--aqua)"/>${statusIcon(1215, y - 5, status)}<text class="small" x="1228" y="${y}">${escapeXml(label)}</text></g>`;
     })
     .join('\n');
   let explanationY = 412;
@@ -478,19 +528,20 @@ export function renderBurndown(model, suiteName) {
     .join('');
   const body = `<rect class="canvas" width="1600" height="${height}"/><rect class="card" x="32" y="28" width="1536" height="${height - 56}" rx="14"/>
   <text class="title" x="72" y="84">${escapeXml(`${suiteName} ${t.burndownTitle}`)}</text><text class="subtitle" x="72" y="110">${escapeXml(t.burndownSubtitle)}</text><text class="small" x="1500" y="84" text-anchor="end">${escapeXml(`${t.reviewed}: ${reviewed}`)}</text>
-  <rect x="72" y="142" width="1428" height="116" rx="8" fill="var(--aqua-wash)"/><text class="heading" x="96" y="170">${escapeXml(t.current)}</text><text x="96" y="231" class="title" style="font-size:52px">${remaining}</text><text class="heading" x="155" y="215">${escapeXml(t.remaining)}</text><text class="caption" x="155" y="237">${escapeXml(`${verified} / ${total} ${t.verified}`)}</text><text class="caption" x="700" y="205">${escapeXml(t.approved)}</text><text class="heading" x="700" y="230">${total}</text><text class="caption" x="1030" y="205">${escapeXml(t.deferred)}</text><text class="heading" x="1030" y="230">${deferredTasks.length}</text>
+  <rect x="72" y="142" width="1428" height="116" rx="8" fill="var(--aqua-wash)"/><text class="heading" x="96" y="170">${escapeXml(t.current)}</text><text x="96" y="231" class="title" style="font-size:52px">${remaining}</text><text class="heading" x="155" y="215">${escapeXml(t.remaining)}</text><text class="caption" x="155" y="237">${escapeXml(t.completionCounts(verified, planningComplete))}</text><text class="caption" x="700" y="205">${escapeXml(t.approved)}</text><text class="heading" x="700" y="230">${total}</text><text class="caption" x="1030" y="205">${escapeXml(t.deferred)}</text><text class="heading" x="1030" y="230">${deferredTasks.length}</text>
   <text class="heading" x="72" y="300">${escapeXml(t.scopeReference)}</text><text class="caption" x="72" y="321">${escapeXml(t.noHistory)}</text><rect class="card" x="72" y="340" width="940" height="390" rx="9"/><text class="small" x="116" y="372">${escapeXml(t.remainingAxis)}</text><text class="small" x="550" y="704" text-anchor="middle">${escapeXml(t.notTime)}</text>
   <g class="grid"><line x1="${x0}" y1="${y0}" x2="${x1}" y2="${y0}"/><line x1="${x0}" y1="${y0 + 80}" x2="${x1}" y2="${y0 + 80}"/><line x1="${x0}" y1="${y0 + 160}" x2="${x1}" y2="${y0 + 160}"/><line x1="${x0}" y1="${y1}" x2="${x1}" y2="${y1}"/><line x1="${x0}" y1="${y0}" x2="${x0}" y2="${y1}"/><line x1="${x1}" y1="${y0}" x2="${x1}" y2="${y1}"/></g><line class="axis" x1="${x0}" y1="${y1}" x2="${x1}" y2="${y1}"/><line class="axis" x1="${x0}" y1="${y0}" x2="${x0}" y2="${y1}"/>
-  <line x1="${x0}" y1="${y0}" x2="${currentX.toFixed(1)}" y2="${currentY.toFixed(1)}" stroke="var(--blue)" stroke-width="2"/><line x1="${currentX.toFixed(1)}" y1="${currentY.toFixed(1)}" x2="${x1}" y2="${y1}" stroke="var(--blue)" stroke-width="2" stroke-dasharray="6 5"/><circle cx="${x0}" cy="${y0}" r="7" fill="var(--blue)" stroke="var(--surface)" stroke-width="2"/><text class="heading" x="${x0 + 22}" y="${y0 + 18}">${escapeXml(t.logicalBaseline)}</text><text class="caption" x="${x0 + 22}" y="${y0 + 37}">${total} ${escapeXml(t.remainingShort)}</text>${currentMarker}<text class="heading" x="${Math.max(x0 + 150, currentX - 22)}" y="${Math.max(y0 + 60, currentY - 49)}" text-anchor="end">${escapeXml(t.currentSnapshot)}</text><text class="caption" x="${Math.max(x0 + 150, currentX - 22)}" y="${Math.max(y0 + 79, currentY - 30)}" text-anchor="end">${escapeXml(`${remaining} ${t.remainingShort} · ${verified} ${t.verified}`)}</text>
+  <line x1="${x0}" y1="${y0}" x2="${currentX.toFixed(1)}" y2="${currentY.toFixed(1)}" stroke="var(--blue)" stroke-width="2"/><line x1="${currentX.toFixed(1)}" y1="${currentY.toFixed(1)}" x2="${x1}" y2="${y1}" stroke="var(--blue)" stroke-width="2" stroke-dasharray="6 5"/><circle cx="${x0}" cy="${y0}" r="7" fill="var(--blue)" stroke="var(--surface)" stroke-width="2"/><text class="heading" x="${x0 + 22}" y="${y0 + 18}">${escapeXml(t.logicalBaseline)}</text><text class="caption" x="${x0 + 22}" y="${y0 + 37}">${total} ${escapeXml(t.remainingShort)}</text>${currentMarker}<text class="heading" x="${Math.max(x0 + 150, currentX - 22)}" y="${Math.max(y0 + 60, currentY - 49)}" text-anchor="end">${escapeXml(t.currentSnapshot)}</text><text class="caption" x="${Math.max(x0 + 150, currentX - 22)}" y="${Math.max(y0 + 79, currentY - 30)}" text-anchor="end">${escapeXml(`${remaining} ${t.remainingShort} · ${t.completionCounts(verified, planningComplete)}`)}</text>
   <rect x="1040" y="340" width="460" height="390" rx="9" fill="var(--blue-wash)"/><text class="heading" x="1070" y="378">${escapeXml(t.howRead)}</text>${explanation}
-  <rect class="card" x="72" y="758" width="1428" height="${phaseBottom + 24 - 758}" rx="9"/><text class="heading" x="96" y="786">${escapeXml(t.phaseScope)}</text><text class="small" x="96" y="800">${escapeXml(`${t.active}: ${total}; ${t.verified}: ${verified}; ${t.remaining}: ${remaining}`)}</text><text class="small" x="730" y="786" text-anchor="end">${escapeXml(t.verified)}</text><text class="small" x="850" y="786" text-anchor="end">${escapeXml(t.remaining)}</text><text class="small" x="930" y="786">${escapeXml(t.completion)}</text>${phaseRows}
+  <rect class="card" x="72" y="758" width="1428" height="${phaseBottom + 24 - 758}" rx="9"/><text class="heading" x="96" y="786">${escapeXml(t.phaseScope)}</text><text class="small" x="96" y="800">${escapeXml(`${t.active}: ${total}; ${t.verified}: ${verified}; ${t.planningComplete}: ${planningComplete}; ${t.remaining}: ${remaining}`)}</text><text class="small" x="650" y="786" text-anchor="end">${escapeXml(t.verified)}</text><text class="small" x="750" y="786" text-anchor="end">${escapeXml(t.planningComplete)}</text><text class="small" x="850" y="786" text-anchor="end">${escapeXml(t.remaining)}</text><text class="small" x="930" y="786">${escapeXml(t.completion)}</text>${phaseRows}
   <line class="grid" x1="72" y1="${height - 74}" x2="1500" y2="${height - 74}"/><text class="small" x="72" y="${height - 48}">${escapeXml(`${t.source}: pdp-wbs.md · progress.md (${t.reviewed}: ${reviewed})`)}</text><text class="small" x="1500" y="${height - 48}" text-anchor="end">${escapeXml(t.caveat)}</text>`;
   return svgDocument(
     `${suiteName} ${t.burndownTitle}`,
-    `${t.burndownTitle}. ${t.burndownDescription(total, verified, remaining)} ${t.noHistory}`,
+    `${t.burndownTitle}. ${t.burndownDescription(total, verified, planningComplete, remaining)} ${t.noHistory}`,
     body,
     height,
     t.metadata,
+    planningComplete > 0,
   );
 }