@topmindspace/tms-skills 0.1.3 → 0.1.4

package/top-ppt-html/package.json

@@ -1,8 +1,8 @@
 {
   "name": "top-ppt-html",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "private": true,
-  "description": "TopPPT HTML：报告 / 演示 / 信息架构图技能。单文件 HTML + 版式保真的可编辑 PPTX；布局骨架 P1–P12；模型单写；strict 0/0 交付。",
+  "description": "TopPPT HTML：优雅大气的正式场合演讲/汇报甲板。单文件 HTML + 版式保真可编辑 PPTX；布局骨架 P1–P12；模型单写；strict 0/0 交付。",
   "license": "MIT",
   "repository": {
     "type": "git",

package/top-ppt-html/references/default-surface.md

@@ -53,7 +53,7 @@
 ```
 scaffold_report → 只填 REPORT_MODEL → render_from_model --inplace
 → validate_report --strict   # presentation 自动 --layout-qa
-→ quality_gate --deliver →（可选）pptx
+→ quality_gate --deliver →（用户要 PPTX 时）B 通道 build_pptx → validate_pptx
 ```
 
 ## 长文与密度（Mode A）

package/top-ppt-html/references/modes.md

@@ -74,7 +74,7 @@
 
 ## 模式 A · 演示汇报 `presentation`（assets/templates/presentation.html）
 
-台上讲给人听，3 秒抓住主张。工艺清单 → `presentation-craft.md`；默认面 → `default-surface.md`。
+正式场合演讲甲板：优雅、大气、一屏一主张；3 秒抓住结论。工艺 → `presentation-craft.md`；默认面 → `default-surface.md`。**非**咨询密排 dump（那是 Mode B）。
 
 要点回顾：
 

package/top-ppt-html/references/playbook.md

@@ -1,8 +1,8 @@
 # 作战手册 · Playbook（唯一常读入口 · L1）
 
 > **每次生成都读这一份，通常就够了。**
-> 本文件是**决策层**：定模式、选页型、选版式组合、选图表、定配色、跑校验。
-> **代码、几何、穷举表不在本文件**——需要时按 `SKILL.md` 的 L2 路由读深度文件，**读完即停，不预读**。
+> 决策层：定模式、选页型、选版式组合、选图表、定配色、跑校验——服务**优雅、大气、正式场合**的演讲/汇报甲板（Mode A 默认气质；B/C 按契约，勿把咨询 dump 当 A 默认）。
+> **代码、几何、穷举表不在本文件**——按 `SKILL.md` L2 路由命中再读，**读完即停**；整读大 L2 = **FAIL**。
 
 ---
 
@@ -46,7 +46,7 @@
 Gate 0 参考图 → 六项问询（1 轮）→ 最小大纲（outline-design「轻量最小集」）→ 1 张规划卡 → scaffold_report.py
   → **只填 REPORT_MODEL** → render_from_model.py --inplace → validate_report.py --strict → 交付
 ```
-（Fast Mode 跳过 Gate 0/六项，仍须最小大纲；其余同链；**禁止**手改 HTML 正文与模型双写。）
+（Fast Mode 跳过 Gate 0/六项，仍须最小大纲；默认 **HTML-only**，PPTX 显式 opt-in 走 B 通道；**禁止**手改 HTML 正文与模型双写。）
 
 **完整路径**（任一命中）——研究 ≥20 页 / 演示 ≥12 页 / 材料量大且杂 / 含未敲定关键判断 / 用户要看框架。
 ```
@@ -188,10 +188,11 @@ python scripts/validate_pptx.py 2026-09-15-主题.pptx --strict --model=….mode
 ```
 
 **交付前必过**：`validate_report.py --strict` 0/0（**Mode A / presentation 隐含 `--layout-qa`**；research/architecture 不强制）；含 PPTX 时 `validate_pptx.py --strict --model=` 0/0。
-**推荐一键门禁**：`python scripts/quality_gate.py 报告.html [--pptx x.pptx --model x.model.json]`（presentation 同口径附带 layout-qa；交付加 `--deliver` 出七要素，不要手拼）。
-**A/B 全文对等**：`cross_verify.py` 默认 SKIP，仅 `python scripts/cross_verify.py --full-ab` 或 `regression.py --full-ab` 时启用。
+**PPTX 通道**：默认交付只跑 **B 通道**（`build_pptx.js`）；**A 通道**（`pptx-export.js` / `gen_channel_a.js`）仅预览与 `cross_verify` / 回归——**勿把 A 产物当交付**。
+**推荐一键门禁**：`python scripts/quality_gate.py 报告.html [--pptx x.pptx --model x.model.json]`（HTML/PPTX/evals **并行**；presentation 附 layout-qa；`--deliver` 出七要素，勿手拼）。
+**A/B 全文对等**：`cross_verify.py` 默认 SKIP，仅 `--full-ab` / `regression.py --full-ab` 启用。
 **PPTX 冒烟**：`bash scripts/smoke_pptx.sh`（extract_model → build_pptx → validate_pptx --strict）。
-**失败自修复**：按输出逐条修 → 重跑，直到 0/0；修复顺序见 `failure-modes.md`。
+**失败自修复**：按输出逐条修 → 重跑至 0/0；顺序见 `failure-modes.md`。
 
 ---
 
@@ -200,7 +201,7 @@ python scripts/validate_pptx.py 2026-09-15-主题.pptx --strict --model=….mode
 > 常读仍为入口两份；演示路径可加 **L1.5 工艺双件**：`default-surface.md` + `presentation-craft.md`。
 > 默认生成面：`default-surface.md`（12 页型 + 8 图 + V1–V4）。Mode A 工艺：`presentation-craft.md`。插画：`illustration-layout.md`。
 >
-> **禁止整读（强制走 `extract_snippet.py`）**：`layouts-combo.md` · `components-atoms.md` · `charts-basic.md` · `charts-extended.md` · `content-rules.md` 全文 · `pptx-export.md` · 模式模板 HTML（`assets/templates/*.html`，走 `scaffold_report.py`）。
+> **整读下列文件 = FAIL / 不合格**（强制 `extract_snippet.py`）：`layouts-combo.md` · `components-atoms.md` · `charts-basic.md` · `charts-extended.md` · `content-rules.md` 全文 · `pptx-export.md` · 模式模板 HTML（走 `scaffold_report.py`）。
 > 取码：`python scripts/extract_snippet.py --list` · `--task <名>` · `--chart <类型>` · `--page-type <页型>` · `--file components.md --section 46`（逻辑名自动路由）
 
 | 任务 | 只读 |
@@ -218,5 +219,5 @@ python scripts/validate_pptx.py 2026-09-15-主题.pptx --strict --model=….mode
 | 图标 / 语义速查 | `icons.md` · `--task icons` |
 | 起骨架用节奏包 | `scaffold_report.py --list-types` → `--preset consulting` 等 |
 
-**纪律**：L0+L1 是默认全部所需（Mode A/Fast 可加 L1.5）；上表命中才开 L2；**读完即执行，不预读下一份**；大文件**禁止整读**，一律 `extract_snippet.py`。页型语义槽位见 `layout-constants.json` → `layoutSlots`（双通道同源 IR）。
+**纪律**：L0+L1 默认全部所需（Mode A/Fast 可加 L1.5）；命中才开 L2；**读完即执行，不预读**；大文件整读 = **FAIL**，一律 `extract_snippet.py`。页型槽位见 `layout-constants.json` → `layoutSlots`（双通道同源 IR）。
 **维护者**：改常量/schema/引擎后必跑 `sync_runtime.py` → `audit_styles.py` → `audit_docs.py` → `audit_skill.py` → `build_examples.py` → `regression.py`。

package/top-ppt-html/references/pptx-export.md

@@ -21,7 +21,7 @@
 ```
 
 - **页面预览**：收到/打开报告的人点 header「预览 PPTX」（快捷键 P）即可查看页序列，无需任何环境。预览模态与精导通道使用**同一序列化语义**（`slidesOf → slideXml`）——**版式与文本所见即所得**；带数据的原生图表在交付 PPTX 中为真 chart part（双击可编辑数据），预览侧为形状近似，**图表形态以精导产物为准**。**页面不直接导出文件**：浏览器端跑不了 strict 质检硬门禁，达不到交付质量；预览模态常显**可复制 AI 提示词**，用户想获得 PPTX 时复制给 AI，由智能体走精导通道生成（`?` 帮助弹窗 / 快捷键 H 有同样说明）。
-- **智能体精导**：正式 PPTX 的唯一交付路径——从报告抽模型 → 生成 → **过 strict 质检** → 交付。生成时用户选了「HTML+PPTX」交付格式的，交付时一并生成；交付后用户随时可通过页面提示词回来补生成。
+- **智能体精导（B 通道 · 唯一交付）**：`extract_model.py` → `build_pptx.js` → `validate_pptx.py --strict` 0/0。用户选「HTML+PPTX」或事后要 PPT 时才跑；**不要**用 A 通道（`pptx-export.js` / `gen_channel_a.js`）产物交付——A 仅页面预览与回归双裁判。
 - **双单源**：页面几何/三模式独立比例尺（`typeScale` 基准 + `modeTypeScale` 模式取值）/页型几何/9 风格 token 全在 `scripts/layout-constants.json`；**页型 DSL schema（字段/必填/适用模式）在 `scripts/model-schema.json`**。通道 B 直接 `require`；页面运行时由 `sync_runtime.py` 注入（同时注入三模板的引擎/UI/运行时内联副本）。**改常量只改 JSON，改 schema 只改 schema JSON，然后跑 `python scripts/sync_runtime.py`**。
 
 ### 会场与字号（venue · P1-4）

package/top-ppt-html/references/presentation-craft.md

@@ -2,7 +2,7 @@
 
 > **何时读**：Mode A / 正式演示 / 路演 / 演讲 / Fast 演示路径。与 `default-surface.md` 同级常读。  
 > **何时不读**：Mode B 密排、Mode C 架构深读（能力保留，不反向污染 A）。  
-> **定位**：大气、演讲友好；一屏一主张；图标/图表克制配文——非 gadget deck、非咨询 dump。
+> **定位**：优雅 · 美观 · 大气；正式场合演讲友好；版式/排版/色彩/内容组织优先；图标/图表克制配文——非 gadget deck、非咨询 dump。
 
 ## 铁律速查（Hard rules）
 
@@ -32,7 +32,8 @@
 
 ```
 validate_report.py --strict   # presentation 自动隐含 --layout-qa
-quality_gate.py … --deliver   # 同口径
+quality_gate.py … --deliver   # HTML/PPTX/evals 并行；同口径
+# PPTX 交付仅 B 通道 build_pptx.js（A 通道不交付）
 ```
 
 检查：V 契约 · 简单全幅 · 骨架连用 · 截断/溢出未拆页 · 半空卡 · 对齐节奏 · 主张标题 WARN · 核图多样性 · WCAG。

package/top-ppt-html/scripts/audit_skill.py

@@ -210,6 +210,17 @@ def main() -> int:
         'SKILL.md 未声明交互轮次上限', '已声明（≤3 轮）')
     chk('⑤ 必读文件预算', bool(re.search(r'必读.{0,6}上限|必读文件数|只读当前需要的|不预读', sk)),
         'SKILL.md 未声明必读文件预算/不预读纪律', '已声明（不预读纪律）')
+    # ⑤b 反过读硬门禁文案（整读大 L2 = FAIL）+ B 通道交付口径
+    ok_snip = bool(re.search(r'extract_snippet', sk)) and bool(
+        re.search(r'整读.{0,40}(?:FAIL|不合格)|(?:FAIL|不合格).{0,40}整读', sk))
+    chk('⑤ extract_snippet 整读=FAIL', ok_snip,
+        'SKILL.md 须同时声明 extract_snippet 与「整读…FAIL/不合格」',
+        '已声明 FAIL 口径')
+    ok_b = bool(re.search(r'B\s*通道|build_pptx', sk)) and bool(
+        re.search(r'A\s*通道|pptx-export|cross_verify', sk))
+    chk('⑤ B 通道交付 / A 预览', ok_b,
+        'SKILL.md 须区分 B 通道交付与 A 通道预览/cross_verify',
+        '已区分')
 
     # ⑥ 引用完整性
     missing: list[str] = []

package/top-ppt-html/scripts/build_pptx.js

@@ -174,6 +174,17 @@ function modeFloorPt() {
   const f = FS_POLICY.floorPt[m];
   return f != null ? f : 10;
 }
+function snapFont(pt, ladder, floor) {
+  /* Snap arbitrary pt to nearest ladder step (≥ floor). fitFont + callers (fz-1) must use this. */
+  const lad = (ladder || FONT_LADDER).filter(v => v >= (floor == null ? 0 : floor));
+  if (!lad.length) return floor == null ? pt : Math.max(floor, pt);
+  let best = lad[0], bd = Math.abs(lad[0] - pt);
+  for (let i = 1; i < lad.length; i++) {
+    const d = Math.abs(lad[i] - pt);
+    if (d < bd) { bd = d; best = lad[i]; }
+  }
+  return best;
+}
 function fitFont(items, widthIn, availIn, opts) {
   opts = opts || {};
   const floor = opts.floor != null ? opts.floor : modeFloorPt();
@@ -536,7 +547,7 @@ function imageLayoutShapes(s, layout, img, items, points, isPh, fit, y0, y1) {
     const ptsI = points || [];
     const rowHI = fitRowH(ih - 0.1, ptsI.length, IM.noteRowH || 0.62, 0.3);
     const fzI = fitFont(ptsI.map(p => (p[0] || '') + (p[1] || '')), rwI - 0.3, ih, { max: 14, gapFactor: 0.6 });
-    const fz = sz(fzI), fzSm = sz(fzI - 1);
+    const fz = sz(fzI), fzSm = sz(snapFont(fzI - 1));
     ptsI.forEach((pt, i) => {
       const lyI = iy + i * rowHI;
       s.addShape('rect', { x: rxI, y: lyI + rowHI / 2 - 0.06, w: 0.12, h: 0.12,
@@ -1490,8 +1501,11 @@ function infoStreamgraph(s, sec, y0, y1) {
     totals.push(t);
   }
   const maxTot = Math.max.apply(null, totals.concat([1]));
-  const plotH = P.y1 - P.y0;
-  const cyMid = (P.y0 + P.y1) / 2;
+  /* Reserve legend INSIDE the plot box — 6 series must not crush the annotation band. */
+  const legH = Math.min(1.2, Math.max(0.28, series.length * 0.22 + 0.08));
+  const plotBottom = P.y1 - legH;
+  const plotH = Math.max(0.6, plotBottom - P.y0);
+  const cyMid = P.y0 + plotH / 2;
   const xAt = (i) => MX + (nPts > 1 ? i / (nPts - 1) : 0.5) * CW;
   const yAt = (i) => cyMid - (totals[i] / maxTot) * plotH / 2;
   const palette = [STYLE.accent, STYLE.faint, STYLE.body, STYLE.line, STYLE.soft, STYLE.surface];
@@ -1512,14 +1526,14 @@ function infoStreamgraph(s, sec, y0, y1) {
     }
     ribbonRects(s, pts, palette[si % palette.length]);
     const lx = MX;
-    s.addShape('rect', { x: lx, y: P.y1 + 0.06 + si * 0.26, w: 0.12, h: 0.12,
+    s.addShape('rect', { x: lx, y: plotBottom + 0.04 + si * 0.2, w: 0.12, h: 0.12,
       fill: { color: palette[si % palette.length] }, line: { type: 'none' } });
-    s.addText(String(se.name || ('系列' + (si + 1))), { x: lx + 0.16, y: P.y1 + si * 0.26, w: 1.5, h: 0.26,
+    s.addText(String(se.name || ('系列' + (si + 1))), { x: lx + 0.16, y: plotBottom + 0.02 + si * 0.2, w: 1.5, h: 0.2,
       fontFace: STYLE.font, fontSize: sz(10), color: STYLE.body, valign: 'middle' });
     base = upper;
   });
   labels.forEach((lb, i) => {
-    s.addText(String(lb), { x: xAt(i) - 0.4, y: P.y1 - 0.02, w: 0.8, h: 0.24, align: 'center',
+    s.addText(String(lb), { x: xAt(i) - 0.4, y: plotBottom - 0.22, w: 0.8, h: 0.2, align: 'center',
       fontFace: STYLE.font, fontSize: sz(9.5), color: STYLE.faint });
   });
 }
@@ -1745,8 +1759,8 @@ CONTENT.sections.forEach((sec) => {
     const iy = ireg.y;
     const capH = img.caption ? 0.32 : 0;
     const ih = Math.max(1.2, ireg.h);
-    imageLayoutShapes(s, layout, img, items, sec.points || [], isPh, fit, iy, iy + ih);
-    if (img.caption) s.addText(img.caption, { x: MX, y: iy + ih + 0.04, w: CW, h: capH,
+    const capYImg = imageLayoutShapes(s, layout, img, items, sec.points || [], isPh, fit, iy, iy + ih);
+    if (img.caption) s.addText(img.caption, { x: MX, y: capYImg + 0.04, w: CW, h: capH,
       fontFace: STYLE.font, fontSize: sz(10.5), color: STYLE.faint });
   } else if (type === 'donut') {
     const dcn = sec.chart || {};
@@ -2133,7 +2147,7 @@ CONTENT.sections.forEach((sec) => {
       const ly0 = bodyY, availP = bodyBottom - ly0;
       const rowH = fitRowH(availP, pts.length, SP.rowH, 0.3);
       const fzB = fitFont(pts.map(p => (p[0] || '') + (p[1] || '')), w - 0.4, availP, { max: 14, gapFactor: 0.6 });
-      const fz = sz(fzB), fzSm = sz(fzB - 1);
+      const fz = sz(fzB), fzSm = sz(snapFont(fzB - 1));
       pts.forEach((pt, i) => {
         const ly = ly0 + i * rowH;
         s.addShape('rect', { x, y: ly + rowH / 2 - 0.06, w: 0.12, h: 0.12, fill: { color: STYLE.accent }, line: { type: 'none' } });
@@ -2277,7 +2291,7 @@ CONTENT.sections.forEach((sec) => {
     const rowH = fitRowH(avail, pts.length, P.rowH, 0.3);
     const fzB = fitFont(pts.map(p => (p[0] || '') + (p[1] || '')), textW - 0.32, avail,
       { max: 15, gapFactor: 0.55 });
-    const fz = sz(fzB), fzSm = sz(fzB - 1);
+    const fz = sz(fzB), fzSm = sz(snapFont(fzB - 1));
     pts.forEach((p, i) => {
       const y = bodyY + i * rowH;
       s.addShape('rect', { x: MX, y: y + rowH / 2 - P.markSize / 2, w: P.markSize, h: P.markSize,

package/top-ppt-html/scripts/quality_gate.py

@@ -16,7 +16,7 @@
     ② 无 LLM 的 rubric 启发式（content/layout/chart/infographic/tone 五维）
     ③ --deliver：按 SKILL.md「交付说明」七要素（路径/字节数/模式/风格/篇幅/格式/校验+引用）
        生成结构化交付说明——七要素缺一即 gate FAIL，杜绝手拼遗漏
-    交付时一键跑完，避免「只过了结构、内容质量靠自觉」。
+    交付时一键跑完；互不依赖的子进程门禁（HTML / PPTX / evals）并行执行以缩短墙钟。
 """
 from __future__ import annotations
 
@@ -26,6 +26,7 @@ import re
 import subprocess
 import sys
 import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
 from pathlib import Path
 
 try:
@@ -242,33 +243,43 @@ def main() -> int:
     print(f'交付质量门禁 · {html.name}')
     print('-' * 60)
 
-    # ① HTML strict（Mode A / presentation 自动附带 --layout-qa）
+    # ①–③ 互不依赖子进程并行（HTML strict / PPTX strict / evals）
     head_snip = html.read_text(encoding='utf-8')[:2500]
     mode_m = re.search(r'data-mode="([^"]+)"', head_snip)
     mode = mode_m.group(1) if mode_m else 'presentation'
+    jobs: list[tuple[str, list[str], str | None]] = []
+    # (name, cmd, fixed_note) — fixed_note 非空则覆盖尾部摘要
     vcmd = [sys.executable, str(ROOT / 'scripts' / 'validate_report.py'), str(html), '--strict']
     if mode == 'presentation':
         vcmd.append('--layout-qa')
-    rc, out, el = run(vcmd)
-    gate_name = 'validate_report --strict' + (' --layout-qa' if mode == 'presentation' else '')
-    tail = [ln for ln in out.splitlines() if ln.startswith('PASS ') or ln.startswith('结论')]
-    gate(gate_name, rc == 0, tail[-1] if tail else f'exit {rc}', el)
-
-    # ② PPTX strict（可选）
+    gate_html = 'validate_report --strict' + (' --layout-qa' if mode == 'presentation' else '')
+    jobs.append((gate_html, vcmd, None))
     if args.pptx:
-        cmd = [sys.executable, str(ROOT / 'scripts' / 'validate_pptx.py'), args.pptx, '--strict']
+        pcmd = [sys.executable, str(ROOT / 'scripts' / 'validate_pptx.py'), args.pptx, '--strict']
         if args.model:
-            cmd += ['--model=' + args.model]
-        rc, out, el = run(cmd)
-        tail = [ln for ln in out.splitlines() if ln.startswith('PASS ') or ln.startswith('结论')]
-        gate('validate_pptx --strict', rc == 0, tail[-1] if tail else f'exit {rc}', el)
-
-    # ③ evals 确定性
-    cmd = [sys.executable, str(ROOT / 'evals' / 'run_evals.py'), '--score', str(html)]
+            pcmd += ['--model=' + args.model]
+        jobs.append(('validate_pptx --strict', pcmd, None))
+    ecmd = [sys.executable, str(ROOT / 'evals' / 'run_evals.py'), '--score', str(html)]
     if args.trace:
-        cmd += ['--trace', args.trace]
-    rc, out, el = run(cmd)
-    gate('evals --score', rc == 0, '确定性 + 效率检查', el)
+        ecmd += ['--trace', args.trace]
+    jobs.append(('evals --score', ecmd, '确定性 + 效率检查'))
+
+    results: dict[str, tuple[int, str, float, str | None]] = {}
+    with ThreadPoolExecutor(max_workers=max(1, len(jobs))) as pool:
+        futs = {pool.submit(run, cmd): (name, note) for name, cmd, note in jobs}
+        for fut in as_completed(futs):
+            name, note = futs[fut]
+            rc, out, el = fut.result()
+            results[name] = (rc, out, el, note)
+
+    # 按 jobs 声明顺序输出（稳定可读；墙钟已并行）
+    for name, _cmd, _note in jobs:
+        rc, out, el, note = results[name]
+        if note is not None:
+            gate(name, rc == 0, note, el)
+        else:
+            tail = [ln for ln in out.splitlines() if ln.startswith('PASS ') or ln.startswith('结论')]
+            gate(name, rc == 0, tail[-1] if tail else f'exit {rc}', el)
 
     # ④ rubric 启发式
     rubric = heuristic_rubric(html)

package/top-ppt-html/scripts/test_feedback_gates.py

@@ -0,0 +1,180 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Regression gates for usage-feedback defects (validator + static engine checks)."""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+from xml.etree import ElementTree as ET
+
+ROOT = Path(__file__).resolve().parent
+sys.path.insert(0, str(ROOT))
+import validate_pptx as V  # noqa: E402
+
+EMU = 914400
+NS = V.NS
+fails: list[str] = []
+
+
+def ok(name: str, cond: bool, detail: str = "") -> None:
+    status = "PASS" if cond else "FAIL"
+    print(f"  [{status}] {name}" + (f" — {detail}" if detail and not cond else ""))
+    if not cond:
+        fails.append(name)
+
+
+def test_shape_bounds_reads_p_xfrm() -> None:
+    xml = (
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        f'<p:graphicFrame xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+        "<p:xfrm>"
+        f'<a:off x="{int(0.6 * EMU)}" y="{int(2.5 * EMU)}"/>'
+        f'<a:ext cx="{int(8.5 * EMU)}" cy="{int(3.5 * EMU)}"/>'
+        "</p:xfrm>"
+        "</p:graphicFrame>"
+    )
+    el = ET.fromstring(xml)
+    box = V.shape_bounds(el)
+    ok("1 shape_bounds reads p:xfrm", box is not None and box[2] > 0, f"got {box}")
+
+
+def test_shape_bounds_still_reads_a_xfrm() -> None:
+    xml = (
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        f'<p:sp xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+        "<p:spPr><a:xfrm>"
+        f'<a:off x="{EMU}" y="{EMU}"/>'
+        f'<a:ext cx="{2 * EMU}" cy="{EMU}"/>'
+        "</a:xfrm></p:spPr></p:sp>"
+    )
+    el = ET.fromstring(xml)
+    box = V.shape_bounds(el)
+    ok("1b shape_bounds reads a:xfrm", box is not None and box[0] == EMU)
+
+
+def _text_shape(paras, x=0.6, y=2.5, w=4.0, h=0.6):
+    parts = []
+    for text, pt in paras:
+        parts.append(
+            f'<a:p><a:r><a:rPr sz="{int(pt * 100)}"/><a:t>{text}</a:t></a:r></a:p>'
+        )
+    xml = (
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        f'<p:sp xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+        "<p:spPr><a:xfrm>"
+        f'<a:off x="{int(x * EMU)}" y="{int(y * EMU)}"/>'
+        f'<a:ext cx="{int(w * EMU)}" cy="{int(h * EMU)}"/>'
+        "</a:xfrm></p:spPr>"
+        f'<p:txBody>{"".join(parts)}</p:txBody></p:sp>'
+    )
+    return ET.fromstring(xml)
+
+
+def test_text_overflow_vertical() -> None:
+    paras = [(f"这是第{i}段足够长的中文内容用来累计行高", 12.0) for i in range(8)]
+    shape = _text_shape(paras, h=0.55)
+    issues = V.text_overflow_vertical_check(shape, 1)
+    codes = [i["code"] for i in issues]
+    ok(
+        "2 TEXT_OVERFLOW_VERTICAL fires on multi-segment cumulative",
+        "TEXT_OVERFLOW_VERTICAL" in codes,
+        f"codes={codes}",
+    )
+
+
+def test_annotation_band_overlap() -> None:
+    xml = (
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        f'<p:sp xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+        "<p:spPr><a:xfrm>"
+        f'<a:off x="{int(0.6 * EMU)}" y="{int(5.5 * EMU)}"/>'
+        f'<a:ext cx="{int(4 * EMU)}" cy="{int(1.4 * EMU)}"/>'
+        "</a:xfrm></p:spPr></p:sp>"
+    )
+    el = ET.fromstring(xml)
+    issues = V.annotation_band_overlap_check([el], 1, int(7.5 * EMU))
+    codes = [i["code"] for i in issues]
+    ok(
+        "3 ANNOTATION_BAND_OVERLAP fires when content crushes band",
+        "ANNOTATION_BAND_OVERLAP" in codes,
+        f"codes={codes}",
+    )
+
+
+def test_font_size_not_snapped() -> None:
+    xml = (
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        f'<p:sld xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+        "<p:cSld><p:spTree><p:sp><p:txBody>"
+        '<a:p><a:r><a:rPr sz="1130"/><a:t>OffLadderSampleTextHere</a:t></a:r></a:p>'
+        "</p:txBody></p:sp></p:spTree></p:cSld></p:sld>"
+    )
+    root = ET.fromstring(xml)
+    issues = V.font_size_snap_check(root, 1)
+    codes = [i["code"] for i in issues]
+    ok(
+        "4 FONT_SIZE_NOT_SNAPPED fires on off-ladder size",
+        "FONT_SIZE_NOT_SNAPPED" in codes,
+        f"codes={codes}",
+    )
+
+
+def test_engine_static() -> None:
+    export = (ROOT.parent / "assets" / "pptx-export.js").read_text(encoding="utf-8")
+    build = (ROOT.parent / "scripts" / "build_pptx.js").read_text(encoding="utf-8")
+
+    m = re.search(r"function vbarShapes\([\s\S]*?\n\}", export)
+    body = m.group(0) if m else ""
+    ok("B vbarShapes handles ec.series", "ec.series" in body and "series.forEach" in body)
+
+    ok(
+        "C A-channel streamgraph reserves legend inside plot",
+        "Reserve legend INSIDE" in export and "plotBottom" in export,
+    )
+    ok(
+        "C B-channel infoStreamgraph reserves legend inside plot",
+        "Reserve legend INSIDE" in build and "plotBottom" in build,
+    )
+
+    ok(
+        "D A-channel caption uses capYImg from imageLayoutShapes",
+        "capYImg" in export
+        and re.search(r"capYImg\s*=\s*imageLayoutShapes", export) is not None,
+    )
+    ok(
+        "D B-channel caption uses capYImg from imageLayoutShapes",
+        "capYImg" in build
+        and re.search(r"capYImg\s*=\s*imageLayoutShapes", build) is not None,
+    )
+
+    cards = re.search(
+        r"else if \(type === 'cards'\) \{[\s\S]*?else if \(type === 'split'\)",
+        export,
+    )
+    cards_body = cards.group(0) if cards else ""
+    ok(
+        "A A-channel cards uses sz: N object props (not bare sz())",
+        "sz: 12" in cards_body
+        and not re.search(r"(?<![\w.])sz\s*\(\s*12\s*\)", cards_body),
+    )
+    ok(
+        "A modeSize applied in txSp serialization",
+        "function modeSize" in export and "modeSize(" in export,
+    )
+
+
+def main() -> int:
+    print("feedback-gates regression")
+    test_shape_bounds_reads_p_xfrm()
+    test_shape_bounds_still_reads_a_xfrm()
+    test_text_overflow_vertical()
+    test_annotation_band_overlap()
+    test_font_size_not_snapped()
+    test_engine_static()
+    print(f"\n{len(fails)} failed" if fails else "\nAll feedback gates PASS")
+    return 1 if fails else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())