design-playbook 0.21.2 → 0.22.0

package/README.md

@@ -56,6 +56,9 @@ After install, skills and commands are **namespaced** by the plugin name:
 | `/design-playbook:ux-spec` | Spec-only command |
 | `/design-playbook:ui-review` | Review command |
 | `/design-playbook:run-review` | Cross-run review command |
+| `/design-playbook:run-status` | Run phase, blocker, and resume/continuation narration |
+| `/design-playbook:run-handoff` | Static delivery package for one reviewed run |
+| `/design-playbook:doctor` | Install health diagnosis |
 
 Bare `/design-io` is **not** the installed name — always use the `design-playbook:` prefix.
 
@@ -73,7 +76,7 @@ pi has no plugin namespace — skills are `/skill:<name>`, commands are bare `/<
 | --- | --- |
 | `/skill:design-playbook` | Orchestrator skill (model-invoked) |
 | `/skill:ux-spec` … `/skill:ui-evaluator` | Same eight skills as above |
-| `/design-io` · `/ux-spec` · `/ui-review` · `/run-review` | Pipeline / spec-only / review / cross-run commands |
+| `/design-io` · `/ux-spec` · `/ui-review` · `/run-review` · `/run-status` · `/run-handoff` · `/doctor` | Pipeline / spec-only / review / cross-run / status / handoff / health commands |
 
 pi ships no built-in MCP, so `preview*` and `observe*` skip by default (ADR-0009 absent→skip; the pipeline still runs spec → picker → fill → craft → accept). To enable both gates, install an MCP adapter and register the bundled servers in your project `.mcp.json`:
 
@@ -128,7 +131,7 @@ See the root [README](../../README.md#install-on-other-agents) for the tier tabl
 .mcp.json              ← bundled MCP servers, launched via ${CLAUDE_PLUGIN_ROOT} (ADR-0009)
 mcp/{preview,evidence}/← MCP adapter runtimes (preview_prototype / execute_capture_plan)
 skills/<name>/SKILL.md ← model-invoked skills
-commands/<name>.md     ← slash commands (design-io, ux-spec, ui-review, run-review)
+commands/<name>.md     ← slash commands (design-io, ux-spec, ui-review, run-review, run-status, run-handoff, doctor)
 codex/AGENTS.md        ← Codex bridge notes
 examples/              ← self-authored onboarding samples
 LICENSE · NOTICE       ← authored-only scope
@@ -154,7 +157,15 @@ python <pkg>/scripts/run_status.py .scratch/<run> --json   # machine-readable
 python <pkg>/scripts/run_status.py --list                  # newest runs under .scratch/
 ```
 
-The status command reuses the packaged validator’s G5 confirm rules. It is part of the installed package — not monorepo-only tooling.
+The status command reuses the packaged validator’s G5 confirm rules. It is part of the installed package — not monorepo-only tooling. For an eligible run it also reports an explicit `open-console` continuation command for the local Run Console (it never starts a server itself), with the blocking reason and a safe fallback when the run or Console prerequisites are ineligible. The Console’s current claim is **local, experimental, and trial-gated** — `run-status --json` reports the same capability receipt (`publicClaim: experimental`) — and no authorized external trial or public release is claimed until the separately authorized read-only trial gate passes (ADR-0043).
+
+### Static handoff
+
+```text
+python <pkg>/scripts/run_handoff.py <run> [--fill <declared-path>] [--round N] [--json]
+```
+
+Builds the existing static delivery package for one explicit run from its declared `fill:` path. Multiple declarations need an explicit `--fill`; a missing declaration fails with repair guidance instead of guessing. `verdict` / `authority` / `confirmationSource` are reported verbatim — a `Pending` handoff stays `Pending` and never becomes acceptance.
 
 ### Doctor
 
@@ -163,7 +174,7 @@ python <pkg>/scripts/doctor.py
 python <pkg>/scripts/doctor.py --json
 ```
 
-One packaged diagnosis for interpreter, package surface, optional Playwright, and run-root configuration. Distinguishes `ok` / `degraded` / `broken` with repair actions.
+One packaged diagnosis for interpreter, package surface, optional Playwright, and run-root configuration. Distinguishes `ok` / `degraded` / `broken` with repair actions. Those three states describe **install and runtime health** of what is present locally — they are not a public capability-maturity verdict; maturity vocabulary (`stable` / `experimental` / `blocked-by-gate` / `not-shipped`) stays with the `run-status` capability receipt, and doctor reads existing facts rather than adding a new health or capability-state authority.
 
 **Bundled MCP (v0.3+):** Preview (`mcp/preview/`) and Evidence (`mcp/evidence/`) runtimes ship inside this package and are registered by `.mcp.json` (`${CLAUDE_PLUGIN_ROOT}`). Sibling monorepo dirs remain compatibility launchers/docs. The orchestrator still **probes** MCP `tools/list` and skips `preview*` / `observe*` when tools are absent. Evidence provider writes artifacts only — never the manifest. **`DESIGN_PLAYBOOK_RUN_ROOT`:** default `"."` in `.mcp.json` is the **MCP process cwd**, not the chat workspace — for a host-app dogfood, set an **absolute** path to `.scratch/<run>/` (see [`mcp/evidence/README.md`](mcp/evidence/README.md)). Capture responses include `written_path` (absolute) so mis-rooted writes are visible without a filesystem search.
 

package/codex/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- generated-by design-playbook v0.21.2 -->
+<!-- generated-by design-playbook v0.22.0 -->
 # design-playbook for Codex
 
 ## Install (path of record)
@@ -58,25 +58,23 @@ args = ["<abs>/packages/design-playbook/mcp/evidence/server.py"]
 Verify: `codex mcp list` should list both. `preview*` needs a system Edge/Chrome (the
 adapter spawns it via `--app=`); `observe*` needs Playwright + Chromium.
 
-> **`preview*` silently skips when `preview_prototype` is absent.** If preview does not
-> appear, the orchestrator probed `tools/list`, found no `preview_prototype`, and skipped
-> G5 - this is designed skip behaviour, not a crash. Confirm the tool is registered
+> **`preview*` skips when `preview_prototype` is absent; G5 is not triggered.**
+> Follow the orchestrator's skip narration to report the reason and enable path.
+> This is designed skip behaviour, not a crash. Confirm the tool is registered
 > (`codex mcp list`) before treating it as a preview failure. Codex end-to-end preview
 > smoke is not yet validated (v0.4.4 deferred the codex E2E smoke; only evidence/G6 was
 > server-level smoked).
 
 ## Load order
 
-1. `skills/design-playbook/SKILL.md`
-2. Standard order: `design-baseline?` → `ux-spec` → `ui-picker` → `fill` → `craft-guard` → `ui-evaluator`.
+Read `skills/design-playbook/SKILL.md` first. Its **Run profile** and **Steps**
+sections are the sole authority for stage order, conditional entry, and completion
+criteria. Consume the `run_profile.py route` result as directed there; this bridge
+does not define a second route or a host-specific sequence.
 
-Native desktop order: `ux-spec` → `native-craft` → `ui-picker` → `fill` → `craft-guard` → `ui-evaluator`.
-
-Conditional entry `design-baseline?` (ADR-0012) runs before `reference-intake?` when the router returns `requires_baseline`. Existing-product Fill requires a valid existing baseline, an accepted generated baseline, or an explicit user waiver.
-
-Conditional entry `reference-intake?` (screenshot/URL/design/product analogy, ADR-0011) runs **before** `ux-spec?` when the router returns `requires_reference_contract` — fixed orchestrator order, not reorderable. Run `native-craft` only for an explicit native-desktop/native-feel target. Web and mobile Web skip `native-craft`; if the platform is unclear, ask before choosing the order. The orchestrator owns the decision gate, render-surface seam handoff, and fail-closed behavior.
-
-Mirror the orchestrator's skip narration (SKILL.md Steps preamble): when a step is skipped, output one line — step name + reason + how to enable, with the gate label when one applies, e.g. `-> preview*: adapter absent, skipped (G5 not triggered; enable via packages/design-playbook/mcp/preview/ or host MCP)`.
+For optional adapters, follow the orchestrator's **Steps** preamble and
+`skills/design-playbook/references/load-map.md` pointers. Use its one-line skip
+narration when a stage does not run, including the reason and enable path.
 
 Audit preferences (ADR-0033) apply identically on Codex. Follow `skills/design-playbook/SKILL.md` § *Audit preferences* as sole authority; this bridge adds no host-specific preference rules.
 

package/commands/doctor.md

@@ -14,3 +14,5 @@ python <plugin>/scripts/doctor.py --repo-root <target-repo>
 ```
 
 Reports `ok` / `degraded` / `broken`. Failed checks include a concrete repair. Optional adapters (Playwright, run-root env) degrade rather than hard-fail the install. Audit-preference state shows effective stage values, sources, asked status, and corrupt layers for target repository.
+
+`ok` / `degraded` / `broken` describe install and runtime health of the local surface only — they are not a public capability-maturity verdict. Maturity vocabulary (`stable` / `experimental` / `blocked-by-gate` / `not-shipped`) stays with the `run-status` capability receipt; doctor reads existing facts and adds no new health or capability-state authority.

package/commands/run-handoff.md

@@ -0,0 +1,27 @@
+---
+description: Build a static run handoff from an explicit run and its declared Fill
+---
+
+# run-handoff
+
+Build the existing static delivery package for one explicit Design I/O run. Not a pipeline obligation and not acceptance.
+
+## Usage
+
+```text
+python <plugin>/scripts/run_handoff.py <run> [--fill <declared-path>] [--round N] [--summary <text>] [--lang zh-CN|en] [--json]
+```
+
+- `<run>` is required. Do not discover a run from `.scratch/`.
+- Read `fill:` declarations from that run's `plan.md` (unfenced column-0 lines). One declared Fill is used automatically; multiple require `--fill` with one of those declared paths; none or a missing/ineligible declaration fails with repair guidance.
+- Do not scan the project for HTML, and do not use preview or reference assets as the reviewed Fill.
+- The existing Evidence builder writes `evidence/static-handoff/` (delivery page, Fill copy, archive, disclosure, snapshots). Report `verdict`, `authority`, and `confirmationSource` verbatim, including `Pending`, `blocked`, `not-applicable`, and `unsubstantiated`.
+- Do not write acceptance or convert a non-Pass state into Pass.
+- Page language: explicit `--lang`, then `DPB_PREVIEW_LANG`, then `LANG`, otherwise Chinese. Unknown environment locales use the same Chinese default as Preview. Language affects UI labels only; machine fields, original diagnostics, and user-authored content remain verbatim.
+
+## Done when
+
+The user asked for a handoff; `index.html` exists under the selected run tree; and `verdict` / `authority` / `confirmationSource` were reported verbatim.
+
+Scope:
+$ARGUMENTS

package/commands/run-status.md

@@ -13,9 +13,11 @@ python <plugin>/scripts/run_status.py [.scratch/<run>] [--json] [--list] [--scra
 ```
 
 - Omit the run path to pick the newest directory under `--scratch` (default `.scratch/`).
-- `--json` emits machine-readable stages + `next` action.
+- `--json` emits machine-readable stages + `next` action, plus the continuation block: selected run, current phase, blocker, run integrity, and the Console capability receipt (`implementation` / `validation` / `availability` / `publicClaim`).
 - `--list` only lists discovered runs.
 
+For an eligible run the continuation names an explicit `open-console` command for the local, experimental, trial-gated Run Console — no authorized external trial or public release is claimed until the separately authorized read-only trial gate passes (ADR-0043). `run-status` never starts a server, daemon, or background process itself; an ineligible run reports the blocking reason and a safe fallback instead.
+
 ## Done when
 
-The command names completed stage markers, any active blocker (preview floor, baseline gate, recirculate verdict), and the single next valid resume action. It reuses `validate_run` judgments for G5 confirm validity rather than inventing a second state machine.
+The command names completed stage markers, any active blocker (preview floor, baseline gate, recirculate verdict), and the single next valid resume action. It reuses `validate_run` judgments for G5 confirm validity rather than inventing a second state machine. Stale, partial, hash-mismatched, malformed, or inconsistent runs stay visible as those states and are never replaced by an older successful snapshot.

package/lib/index.js

@@ -8,11 +8,11 @@
  *    `skills/` directory. The plugin locates the directory via `__dirname`,
  *    so no `!!js` expression and no cwd-dependent resolution is involved.
  *
- * 2. Six slash commands (ctx.commands) — `design-io`, `doctor`,
- *    `run-review`, `run-status`, `ui-review`, `ux-spec` — that load the
- *    matching `commands/<name>.md` prompt, substitute `$ARGUMENTS` with the
- *    raw trailing input, and inject it as a user-role follow-up turn via
- *    `agent.followup()`.
+ * 2. Slash commands (ctx.commands) — `design-io`, `doctor`,
+ *    `run-handoff`, `run-review`, `run-status`, `ui-review`, `ux-spec` —
+ *    that load the matching `commands/<name>.md` prompt, substitute
+ *    `$ARGUMENTS` with the raw trailing input, and inject it as a
+ *    user-role follow-up turn via `agent.followup()`.
  *
  * The Cordis `!!js` evaluation scope provides no `require` (only Node globals
  * plus ctx-provided values like dshHomePath/loader), so pointing a
@@ -81,7 +81,7 @@ exports.parseSkillFile = parseSkillFile
 exports.createUserMessageFromPrompt = createUserMessageFromPrompt
 
 /**
- * The six slash commands this plugin registers. Each maps to a
+ * Slash commands this plugin registers. Each maps to a
  * `commands/<name>.md` prompt file; the file's frontmatter `description`
  * becomes the command's discovery metadata, and the body (with `$ARGUMENTS`
  * substituted) is injected as a user follow-up turn.
@@ -89,6 +89,7 @@ exports.createUserMessageFromPrompt = createUserMessageFromPrompt
 const COMMAND_NAMES = [
   'design-io',
   'doctor',
+  'run-handoff',
   'run-review',
   'run-status',
   'ui-review',

package/mcp/evidence/handoff.py

@@ -10,6 +10,12 @@ ADR-0034 fixed three boundaries the first Stage 9 implementation crossed:
   ``confirm-round-*.json`` that ``transaction.py`` persists (ADR-0013), never
   re-derived. The ADR-0008 floor lives inside that record; re-deriving it here
   would be a second confirmation authority, which CONTEXT.md forbids.
+- **Verdict authority** - ``point-back.md`` owns the verdict (continuation
+  pack decision 4): a delivery Pass additionally requires the point-back's
+  own canonical Pass verdict, read through the single verdict-syntax parser
+  (ADR-0025) shared with G3 and run status. A confirmed round with resolved
+  gates can never convert a Recirculate/blocked - or missing/ambiguous -
+  owner verdict into Pass (decision 25).
 - **Capture target** - the five-viewport matrix and the layout probe run
   against the deliverable itself, not against any review chrome.
 
@@ -33,6 +39,8 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Any, Callable
 
+from design_playbook.mcp.ui_locale import resolve_ui_locale
+from design_playbook.mcp.evidence.handoff_i18n import STRINGS
 from design_playbook.mcp.evidence.disclosure import (
     VIEWPORT_ORDER,
     ViewportMetrics,
@@ -118,6 +126,25 @@ def _confirmation_from_record(
     return True, ""
 
 
+def _point_back_verdict(run_root: Path) -> str | None:
+    """The canonical point-back verdict, or ``None`` when there is not
+    exactly one.
+
+    point-back.md is the finding/verdict authority (continuation pack
+    decision 4). Reading goes through the single verdict-syntax parser
+    (ADR-0025) that G3 and run status already share - never a second
+    parser here. ``None`` (missing, malformed, ambiguous, or repeated
+    verdict text) is never a Pass.
+    """
+    from design_playbook.scripts.verdict_syntax import parse_verdict
+
+    try:
+        text = (run_root / "point-back.md").read_text(encoding="utf-8")
+    except (OSError, UnicodeError):
+        return None
+    return parse_verdict(text).canonical
+
+
 def _run_gate_validation(run_root: Path) -> dict[str, Any]:
     """Run the canonical validator over one run directory."""
     spec = run_root / "spec.md"
@@ -587,7 +614,7 @@ def _decision_records_from_run(
 
 
 def _render_index_html(
-    payload: dict[str, Any], matrix: Any, snap_dir: Path
+    payload: dict[str, Any], matrix: Any, snap_dir: Path, locale: str
 ) -> str:
     """Render the delivery page with the payload inlined.
 
@@ -605,13 +632,22 @@ def _render_index_html(
             .replace('"', """)
         )
 
+    strings = STRINGS[locale]
+
+    def _display(value: Any) -> str:
+        if value is None:
+            return "—"
+        if isinstance(value, bool):
+            return strings["yes" if value else "no"]
+        return strings.get(str(value), str(value))
+
     statuses = payload.get("gateStatuses")
     rows = ""
     if isinstance(statuses, list):
         for index, state in enumerate(statuses[:8], start=1):
             rows += (
                 f'<tr><td>G{index}</td><td class="st st-{_esc(state)}">'
-                f"{_esc(state)}</td></tr>"
+                f"{_esc(_display(state))}</td></tr>"
             )
     viewports = payload.get("viewports")
     vp_rows = ""
@@ -626,9 +662,9 @@ def _render_index_html(
                 f"<td>{_esc(vp.get('name'))}</td>"
                 f"<td>{_esc(metrics.get('sw'))}</td>"
                 f"<td>{_esc(metrics.get('innerH'))}</td>"
-                f"<td>{_esc(metrics.get('hOverflow'))}</td>"
-                f"<td>{_esc(disclosure.get('inFold'))}</td>"
-                f"<td>{_esc(metrics.get('measurementStatus'))}</td>"
+                f"<td>{_esc(_display(metrics.get('hOverflow')))}</td>"
+                f"<td>{_esc(_display(disclosure.get('inFold')))}</td>"
+                f"<td>{_esc(_display(metrics.get('measurementStatus')))}</td>"
                 "</tr>"
             )
     decisions = payload.get("decisions")
@@ -639,7 +675,7 @@ def _render_index_html(
                 decision_items += (
                     f"<li><code>{_esc(item.get('id'))}</code> "
                     f"{_esc(item.get('title'))} "
-                    f"<small>({_esc(item.get('authority'))})</small></li>"
+                    f"<small>({_esc(_display(item.get('authority')))})</small></li>"
                 )
     payload_json = json.dumps(payload, ensure_ascii=False, indent=2)
     # A literal "</script>" inside the payload would close the block early;
@@ -652,27 +688,44 @@ def _render_index_html(
             matrix.get(vp), vp, snap_dir
         ):
             snap_figures += (
-                f'<figure><img src="snapshots/viewport-{vp}.png" alt="{vp} snapshot" '
+                f'<figure><img src="snapshots/viewport-{vp}.png" '
+                f'alt="{_esc(strings["snapshot"].format(viewport=vp))}" '
                 f'loading="lazy"/><figcaption>viewport-{vp}.png</figcaption></figure>'
             )
 
-    return (
-        _page_template()
-        .replace("%VERDICT%", _esc(payload.get("verdict")))
-        .replace("%VERDICT_LOWERCASE%", _esc(str(payload.get("verdict")).lower()))
-        .replace("%RUN_ID%", _esc(payload.get("runId")))
-        .replace("%AUTHORITY%", _esc(payload.get("authority")))
-        .replace("%PROFILE%", _esc(payload.get("profile")))
-        .replace("%TIMESTAMP%", _esc(payload.get("timestamp")))
-        .replace("%GATES_PASSED%", _esc(payload.get("gatesPassed")))
-        .replace("%CAPTURE_STATUS%", _esc(payload.get("captureStatus")))
-        .replace("%CONFIRMATION_NOTE%", _esc(payload.get("confirmationNote") or "—"))
-        .replace("%GATE_ROWS%", rows)
-        .replace("%VIEWPORT_ROWS%", vp_rows)
-        .replace("%DECISION_ITEMS%", decision_items)
-        .replace("%SNAPSHOT_FIGURES%", snap_figures)
-        .replace("%PAYLOAD_JSON%", payload_json)
-    )
+    note_key = "confirmed_note" if payload.get("authority") == "confirmed-user" else "pending_note"
+    note = _esc(strings[note_key])
+    if payload.get("confirmationNote"):
+        # Runtime diagnostics remain verbatim, distinct from localized UI copy.
+        note += (
+            f'<details><summary>{_esc(strings["diagnostic"])}</summary>'
+            f'<pre>{_esc(payload["confirmationNote"])}</pre></details>'
+        )
+    values = {key.upper(): _esc(text) for key, text in strings.items()}
+    values.update({
+        "LANG": locale,
+        "VERDICT_LABEL": strings["verdict"],
+        "AUTHORITY_LABEL": strings["authority"],
+        "PROFILE_LABEL": strings["profile"],
+        "GATES_PASSED_LABEL": strings["gates_passed"],
+        "VERDICT": _esc(_display(payload.get("verdict"))),
+        "VERDICT_LOWERCASE": _esc(str(payload.get("verdict")).lower()),
+        "RUN_ID": _esc(payload.get("runId")),
+        "AUTHORITY": _esc(_display(payload.get("authority"))),
+        "PROFILE": _esc(_display(payload.get("profile"))),
+        "TIMESTAMP": _esc(payload.get("timestamp")),
+        "GATES_PASSED": _esc(payload.get("gatesPassed")),
+        "CAPTURE_STATUS": _esc(_display(payload.get("captureStatus"))),
+        "CONFIRMATION_NOTE": note,
+        "GATE_ROWS": rows,
+        "VIEWPORT_ROWS": vp_rows,
+        "DECISION_ITEMS": decision_items,
+        "SNAPSHOT_FIGURES": snap_figures,
+        "PAYLOAD_JSON": payload_json,
+        "PAYLOAD_TEXT": _esc(json.dumps(payload, ensure_ascii=False, indent=2)),
+    })
+    # One pass: user-authored text resembling a template marker stays literal.
+    return re.sub(r"%([A-Z_]+)%", lambda match: values[match[1]], _page_template())
 
 
 def build_static_handoff(
@@ -684,6 +737,7 @@ def build_static_handoff(
     capture_runner: Callable[..., Any] | None = None,
     gate_runner: Callable[..., Any] | None = None,
     out_dir: Path | None = None,
+    locale: str | None = None,
 ) -> StaticHandoffResult:
     """Build the Stage 9 static handoff from durable run artifacts.
 
@@ -695,6 +749,7 @@ def build_static_handoff(
     the ZIP package, a same-directory ``deliverable.html`` copy (the page's
     relative link target, spec A5), and a self-contained index page.
     """
+    locale = resolve_ui_locale(locale)
     run_root = Path(run_root)
     deliverable = Path(deliverable)
     out_dir = Path(out_dir) if out_dir is not None else run_root / "evidence" / "static-handoff"
@@ -772,7 +827,19 @@ def build_static_handoff(
     confirmed, confirmation_reason = _confirmation_from_record(run_root, round_n)
 
     capture_complete = capture_status == "captured"
-    if confirmed and capture_complete and gate.get("available") and gates_resolved:
+    # The point-back owner verdict gates a delivery Pass (decision 25): a
+    # confirmed round with resolved gates still cannot convert a
+    # Recirculate/blocked owner verdict - or a missing/ambiguous one - into
+    # Pass. Pending/Recirculate behaviour and gatesPassed semantics are
+    # unchanged.
+    owner_pass = _point_back_verdict(run_root) == "pass"
+    if (
+        confirmed
+        and owner_pass
+        and capture_complete
+        and gate.get("available")
+        and gates_resolved
+    ):
         verdict = "Pass"
     elif confirmed:
         verdict = "Recirculate"
@@ -842,7 +909,7 @@ def build_static_handoff(
 
     index_html = out_dir / "index.html"
     index_html.write_text(
-        _render_index_html(payload, matrix, snap_dir), encoding="utf-8"
+        _render_index_html(payload, matrix, snap_dir, locale), encoding="utf-8"
     )
 
     return StaticHandoffResult(

package/mcp/evidence/handoff_i18n.py

@@ -0,0 +1,103 @@
+"""Static delivery UI copy; protocol fields and author text are never translated."""
+from __future__ import annotations
+
+from design_playbook.mcp.ui_locale import EN, ZH
+
+STRINGS: dict[str, dict[str, str]] = {
+    ZH: {
+        "title": "静态交付",
+        "credential": "交付凭据",
+        "run": "运行",
+        "generated": "生成时间",
+        "verdict": "验收结论",
+        "authority": "决策来源",
+        "profile": "运行档位",
+        "gates_passed": "已通过的门禁",
+        "capture": "证据采集",
+        "gate_matrix": "门禁矩阵",
+        "gate": "门禁",
+        "status": "状态",
+        "viewports": "视口披露",
+        "viewport": "视口",
+        "width": "页面宽度（px）",
+        "height": "视口高度（px）",
+        "overflow": "横向溢出",
+        "in_fold": "首屏内可见",
+        "measurement": "测量状态",
+        "decisions": "决策记录",
+        "artifacts": "交付文件",
+        "artifacts_note": "此页是交付摘要。下列文件均保存在同一目录，可离线打开。",
+        "download": "下载 ZIP（凭据、截图与代码）",
+        "disclosure_link": "查看披露 JSON",
+        "deliverable_link": "打开交付页面",
+        "payload": "完整披露数据（机器可读，字段保留原文）",
+        "snapshot": "{viewport} 视口截图",
+        "confirmed_note": "用户确认已记录；最终结论同时取决于验收结果与证据。",
+        "pending_note": "尚无本轮有效的用户确认，不能据此认定交付通过。",
+        "diagnostic": "确认详情（原始诊断）",
+        "Pass": "通过",
+        "Recirculate": "需返工",
+        "Pending": "待确认",
+        "pass": "通过",
+        "fail": "未通过",
+        "pending": "待检查",
+        "not-applicable": "不适用",
+        "captured": "已采集",
+        "blocked": "受阻",
+        "measured": "已测量",
+        "unmeasured": "未测量",
+        "confirmed-user": "用户已确认",
+        "pending-user": "等待用户确认",
+        "unknown": "未知",
+        "yes": "是",
+        "no": "否",
+    },
+    EN: {
+        "title": "Static Handoff",
+        "credential": "Delivery credential",
+        "run": "run",
+        "generated": "generated",
+        "verdict": "Verdict",
+        "authority": "Decision authority",
+        "profile": "Run profile",
+        "gates_passed": "Gates passed",
+        "capture": "Capture",
+        "gate_matrix": "Gate matrix",
+        "gate": "Gate",
+        "status": "Status",
+        "viewports": "Viewport disclosure",
+        "viewport": "Viewport",
+        "width": "Page width (px)",
+        "height": "Viewport height (px)",
+        "overflow": "Horizontal overflow",
+        "in_fold": "Visible above fold",
+        "measurement": "Measurement",
+        "decisions": "Decisions",
+        "artifacts": "Artifacts",
+        "artifacts_note": "This is the delivery summary. The files below are in the same directory and work offline.",
+        "download": "Download ZIP (credential + snapshots + code)",
+        "disclosure_link": "View disclosure JSON",
+        "deliverable_link": "Open deliverable",
+        "payload": "Full disclosure payload (machine-readable, original fields)",
+        "snapshot": "{viewport} viewport snapshot",
+        "confirmed_note": "User confirmation is recorded; the final verdict also depends on acceptance results and evidence.",
+        "pending_note": "No valid user confirmation exists for this round. This does not establish a delivery Pass.",
+        "diagnostic": "Confirmation details (raw diagnostic)",
+        "Pass": "Pass",
+        "Recirculate": "Recirculate",
+        "Pending": "Pending",
+        "pass": "Pass",
+        "fail": "Fail",
+        "pending": "Pending",
+        "not-applicable": "Not applicable",
+        "captured": "Captured",
+        "blocked": "Blocked",
+        "measured": "Measured",
+        "unmeasured": "Unmeasured",
+        "confirmed-user": "Confirmed by user",
+        "pending-user": "Awaiting user confirmation",
+        "unknown": "Unknown",
+        "yes": "Yes",
+        "no": "No",
+    },
+}

package/mcp/evidence/static_handoff_page.html

@@ -1,9 +1,9 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="%LANG%">
 <head>
 <meta charset="utf-8"/>
 <meta name="viewport" content="width=device-width, initial-scale=1"/>
-<title>Static Handoff - Design Playbook</title>
+<title>%TITLE% - Design Playbook</title>
 <style>
   :root{
     --primary:#2563EB; --bg:#F8FAFC; --surface:#FFFFFF; --border:#E2E8F0;
@@ -62,52 +62,55 @@
 <body>
 <div class="wrap">
   <header>
-    <h1>Static Handoff</h1>
-    <div class="sub">Delivery credential &middot; run <code>%RUN_ID%</code> &middot; generated %TIMESTAMP%</div>
+    <h1>%TITLE%</h1>
+    <div class="sub">%CREDENTIAL% &middot; %RUN% <code>%RUN_ID%</code> &middot; %GENERATED% %TIMESTAMP%</div>
   </header>
 
   <div class="grid">
-    <div class="card"><div class="k">Verdict</div>
+    <div class="card"><div class="k">%VERDICT_LABEL%</div>
       <div class="v %VERDICT_LOWERCASE%">%VERDICT%</div></div>
-    <div class="card"><div class="k">Decision authority</div>
+    <div class="card"><div class="k">%AUTHORITY_LABEL%</div>
       <div class="v">%AUTHORITY%</div></div>
-    <div class="card"><div class="k">Run profile</div>
+    <div class="card"><div class="k">%PROFILE_LABEL%</div>
       <div class="v">%PROFILE%</div></div>
-    <div class="card"><div class="k">Gates passed</div>
+    <div class="card"><div class="k">%GATES_PASSED_LABEL%</div>
       <div class="v">%GATES_PASSED% / 8</div></div>
-    <div class="card"><div class="k">Capture</div>
+    <div class="card"><div class="k">%CAPTURE%</div>
       <div class="v">%CAPTURE_STATUS%</div></div>
   </div>
   <div class="note">%CONFIRMATION_NOTE%</div>
 
-  <h2>Gate matrix</h2>
+  <h2>%GATE_MATRIX%</h2>
   <table>
-    <thead><tr><th>Gate</th><th>Status</th></tr></thead>
+    <thead><tr><th>%GATE%</th><th>%STATUS%</th></tr></thead>
     <tbody>%GATE_ROWS%</tbody>
   </table>
 
-  <h2>Viewport disclosure</h2>
+  <h2>%VIEWPORTS%</h2>
+  <div style="overflow-x:auto">
   <table>
-    <thead><tr><th>Viewport</th><th>sw</th><th>innerH</th><th>hOverflow</th>
-      <th>inFold</th><th>Measurement</th></tr></thead>
+    <thead><tr><th>%VIEWPORT%</th><th>%WIDTH%</th><th>%HEIGHT%</th><th>%OVERFLOW%</th>
+      <th>%IN_FOLD%</th><th>%MEASUREMENT%</th></tr></thead>
     <tbody>%VIEWPORT_ROWS%</tbody>
   </table>
+  </div>
 
-  <h2>Decisions</h2>
+  <h2>%DECISIONS%</h2>
   <ul class="decisions">%DECISION_ITEMS%</ul>
 
-  <h2>Artifacts</h2>
-  <p>This page is the delivery surface. Everything below sits next to it on disk.</p>
+  <h2>%ARTIFACTS%</h2>
+  <p>%ARTIFACTS_NOTE%</p>
   <div class="dl">
-    <a href="static-handoff.zip">Download ZIP (credential + snapshots + code)</a>
-    <a class="secondary" href="disclosure-review.json">disclosure-review.json</a>
-    <a class="secondary" href="deliverable.html">deliverable.html</a>
+    <a href="static-handoff.zip">%DOWNLOAD%</a>
+    <a class="secondary" href="disclosure-review.json">%DISCLOSURE_LINK%</a>
+    <a class="secondary" href="deliverable.html">%DELIVERABLE_LINK%</a>
   </div>
   <div class="snaps">%SNAPSHOT_FIGURES%</div>
 
   <details>
-    <summary>Full disclosure payload (machine-readable)</summary>
-    <pre><script type="application/json">%PAYLOAD_JSON%</script></pre>
+    <summary>%PAYLOAD%</summary>
+    <pre>%PAYLOAD_TEXT%</pre>
+    <script type="application/json">%PAYLOAD_JSON%</script>
   </details>
 </div>
 </body>