AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
fix(exports): keep validation reports out of deliverables
hugohe3dc6356f4f5dd
diff --git a/docs/technical-design.md b/docs/technical-design.mdindex 563f3a00..c237c314 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -74,11 +74,13 @@ Output:# Every PPTX variant below is produced through the svg_output → native DrawingML routeexports/├── presentation_<timestamp>.pptx ← Native shapes (DrawingML) — canonical output, edit & deliver from here- ├── presentation_<timestamp>.report.json ← Postflight package/resource audit linked to the final SVG quality report- ├── svg_quality_report.json ← Blocking/introduced/inherited/source-import SVG findings├── presentation_<timestamp>_native_charts_tables.pptx ← PowerPoint-native Chart/Table replacements (opt-in via --native-charts-and-tables)└── presentation_<timestamp>_narrated.pptx ← Narrated version — embedded per-slide audio + auto-advance timings (via --recorded-narration audio)+ validation/+ ├── svg_quality_report.json ← Blocking/introduced/inherited/source-import SVG findings+ └── presentation_<timestamp>.report.json ← Postflight package/resource audit linked to the final SVG quality report+# Always written in default-flow mode (no -o)backup/<timestamp>/└── svg_output/ ← Archived Executor SVG source (rerun finalize_svg → svg_to_pptx to rebuild)@@ -167,9 +169,9 @@ design_spec.md + spec_lock.md + images/ + icons/ + templates/+ [selected complete prototype SVG]+ [mirror text-slots.v2-min]├─> Executor -> svg_output/- │ ├─> svg_quality_checker.py -> exports/svg_quality_report.json+ │ ├─> svg_quality_checker.py -> validation/svg_quality_report.json│ ├─> finalize_svg.py -> svg_final/- │ └─> svg_to_pptx.py -> exports/<name>_<ts>.pptx + <output_stem>.report.json+ │ └─> svg_to_pptx.py -> exports/<name>_<ts>.pptx + validation/<output_stem>.report.json│ backup/<ts>/svg_output/└─> --record-usage -> analysis/page-context/P<NN>.usage.json@@ -468,17 +470,17 @@ If the same warning repeatedly appears in newly generated pages, fix the prompt,> Why each artifact and module exists in the engineering conversion stage, and which workflows would break if you delete it. Read this before considering any simplification of `svg_final/` / `finalize_svg.py` / `svg_to_pptx.py`.-### Delivery artifacts and workflows+### Post-processing artifacts and workflows-The post-processing and export stages work with distinct artifacts. Each one serves a workflow that nothing else in the pipeline can replace. Every PPTX entry below is a variant of the same `svg_output/` → native DrawingML route, not a parallel image-based converter.+The post-processing and export stages keep authoring, validation, preview, delivery, and archival artifacts distinct. Each one serves a workflow that nothing else in the pipeline can replace. Every PPTX entry below is a variant of the same `svg_output/` → native DrawingML route, not a parallel image-based converter.| Artifact | Workflow it serves | Why nothing else replaces it || --- | --- | --- || `svg_output/` | source of truth, manual editing, `update_spec.py`, `svg_quality_checker.py` | only directory whose contents are authored, not derived || `svg_final/` | mandatory self-contained visual preview; IDE/browser inspection; manual insertion as an SVG picture | `.pptx` is not openable in IDEs; `svg_output/` won't render fully because of external icon / image refs. PowerPoint Convert to Shape is not supported || `exports/<name>_<ts>.pptx` (native) | primary deliverable — editable in PowerPoint with DrawingML shapes | only artifact whose shapes the user can resize / recolor / restyle natively in PowerPoint |-| `exports/svg_quality_report.json` | machine-readable final SVG gate | separates blocking failures, introduced advisories, inherited prototype findings, and source-import losses, and fingerprints the checked SVG bytes |-| `<output_stem>.report.json` | published-PPTX postflight and resource audit | records actual ZIP/package part counts; reruns ZIP and Slide-count checks; labels relationship, structured-package, transition, and animation validation as build-time enforcement; accepts quality-report linkage only when its SHA-256 fingerprint matches the export inputs; and surfaces unresolved tokens, external images, and generic-only font stacks |+| `validation/svg_quality_report.json` | machine-readable final SVG gate | separates blocking failures, introduced advisories, inherited prototype findings, and source-import losses, and fingerprints the checked SVG bytes |+| `validation/<output_stem>.report.json` | published-PPTX postflight and resource audit | records actual ZIP/package part counts; reruns ZIP and Slide-count checks; labels relationship, structured-package, transition, and animation validation as build-time enforcement; accepts quality-report linkage only when its SHA-256 fingerprint matches the export inputs; and surfaces unresolved tokens, external images, and generic-only font stacks || `exports/<name>_<ts>_native_charts_tables.pptx` (opt-in via `--native-charts-and-tables`) | when `data-pptx-replace-with` markers should replace SVG-derived, shape-based charts/tables with PowerPoint-native Chart/Table objects | data-backed objects with chart/table-specific controls; the default DrawingML shapes remain independently editable || `exports/<name>_<ts>_narrated.pptx` (via `--recorded-narration audio`) | narrated deck for auto-play and PowerPoint video export | embedded per-slide audio plus auto-advance timings; name marks it apart from silent exports || `backup/<ts>/svg_output/` (always written in default-flow mode) | re-export from frozen SVG sources without re-running the LLM, archival | the only persisted copy of the Executor's raw SVG source after the project has been edited downstream |diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.mdindex f5e0cfd0..fc446581 100644--- a/docs/zh/technical-design.md+++ b/docs/zh/technical-design.md@@ -73,11 +73,13 @@ PPT Master 不以“任意 SVG 都能转成 PPTX”为目标。`svg_output/` 使exports/├── presentation_<timestamp>.pptx ← 原生形状版(DrawingML)— 唯一 PPTX 生成路线的标准文件- ├── presentation_<timestamp>.report.json ← 关联最终 SVG 质量报告的 package / 资源审计- ├── svg_quality_report.json ← blocking / introduced / inherited / source-import 分类结果├── presentation_<timestamp>_native_charts_tables.pptx ← 同一路线的 PowerPoint 原生 Chart/Table 替换变体(加 --native-charts-and-tables 时生成)└── presentation_<timestamp>_narrated.pptx ← 同一路线的旁白变体(加 --recorded-narration audio 时生成)+ validation/+ ├── svg_quality_report.json ← blocking / introduced / inherited / source-import 分类结果+ └── presentation_<timestamp>.report.json ← 关联最终 SVG 质量报告的 package / 资源审计+# 默认流程(未指定 -o)始终写入backup/<timestamp>/└── svg_output/ ← Executor 原始 SVG 备份(重跑 finalize_svg → svg_to_pptx 即可重建 pptx)@@ -168,9 +170,9 @@ design_spec.md + spec_lock.md + images/ + icons/ + templates/+ [当前完整原型 SVG]+ [mirror text-slots.v2-min]├─> Executor -> svg_output/- │ ├─> svg_quality_checker.py -> exports/svg_quality_report.json+ │ ├─> svg_quality_checker.py -> validation/svg_quality_report.json│ ├─> finalize_svg.py -> svg_final/- │ └─> svg_to_pptx.py -> exports/<name>_<ts>.pptx + <output_stem>.report.json+ │ └─> svg_to_pptx.py -> exports/<name>_<ts>.pptx + validation/<output_stem>.report.json│ backup/<ts>/svg_output/└─> --record-usage -> analysis/page-context/P<NN>.usage.json@@ -464,17 +466,17 @@ PowerPoint 的 DrawingML 是 SVG 表达力的严格子集,因此主编译路> 工程化转换阶段中每一份产物和每一个模块为何存在,删除它会破坏哪些工作流。在考虑简化 `svg_final/` / `finalize_svg.py` / `svg_to_pptx.py` 之前,先读这一节。-### 交付产物与工作流+### 后处理产物与工作流-后处理与导出阶段涉及几类职责不同的产物。每一份都服务于一种流水线中无法替代的工作流。+后处理与导出阶段严格区分创作源、校验、预览、交付与归档产物。每一份都服务于一种流水线中无法替代的工作流。| 产物 | 服务的工作流 | 为何无可替代 || --- | --- | --- || `svg_output/` | 唯一源、手工编辑入口、`update_spec.py`、`svg_quality_checker.py` | 流水线中唯一**手写**而非派生的目录 || `svg_final/` | IDE 内即时预览(VSCode/Cursor 直接打开 `.svg`)、浏览器单页预览、手动作为 SVG 图片插入 | `.pptx` 在 IDE 里打不开;`svg_output/` 因图标 / 图片是外部引用,IDE 中渲染不完整。PowerPoint 手工“转换为形状”不在支持范围 || `exports/<name>_<ts>.pptx`(native) | 主交付物——PowerPoint 中以 DrawingML 形状形态可编辑 | 唯一一份用户可在 PowerPoint 中原生改尺寸 / 改色 / 改样式的产物 |-| `exports/svg_quality_report.json` | 机器可读的最终 SVG 门禁 | 把阻断错误、新增提示、原型继承项和来源导入损失分开,并为受检 SVG 字节生成指纹 |-| `<output_stem>.report.json` | 已发布 PPTX 的 postflight 与资源审计 | 记录实际 ZIP/package part 数量;重新检查 ZIP 与正式页数;把内部关系、结构化包、转场和动画如实标为构建期强制校验;只有 SHA-256 指纹与导出输入一致时才接受质量报告关联,同时暴露未解析变量、外部图片和纯通用字体栈 |+| `validation/svg_quality_report.json` | 机器可读的最终 SVG 门禁 | 把阻断错误、新增提示、原型继承项和来源导入损失分开,并为受检 SVG 字节生成指纹 |+| `validation/<output_stem>.report.json` | 已发布 PPTX 的 postflight 与资源审计 | 记录实际 ZIP/package part 数量;重新检查 ZIP 与正式页数;把内部关系、结构化包、转场和动画如实标为构建期强制校验;只有 SHA-256 指纹与导出输入一致时才接受质量报告关联,同时暴露未解析变量、外部图片和纯通用字体栈 || `exports/<name>_<ts>_native_charts_tables.pptx`(需 `--native-charts-and-tables` 显式开启) | 让带 `data-pptx-replace-with` 标记的 SVG 派生形状图表/表格替换为 PowerPoint 原生 Chart/Table 对象 | 带数据源和图表/表格专属控制的对象;默认 DrawingML shape 本身仍可独立编辑 || `exports/<name>_<ts>_narrated.pptx`(经 `--recorded-narration audio` 生成) | 自动放映与 PowerPoint 视频导出用的旁白版 deck | 逐页嵌入音频并写入自动推进时间;命名与无声导出区分开 || `backup/<ts>/svg_output/`(默认流程下始终生成) | 不重跑 LLM 的前提下从冻结 SVG 源重建 pptx、长期存档 | 项目下游被改动后,Executor 原始 SVG 唯一的留存副本 |diff --git a/skills/ppt-master/references/artifact-ownership.md b/skills/ppt-master/references/artifact-ownership.mdindex c2cbc66e..0d380cc4 100644--- a/skills/ppt-master/references/artifact-ownership.md+++ b/skills/ppt-master/references/artifact-ownership.md@@ -39,8 +39,9 @@ Global artifact ownership rules for PPT Master projects.| `notes/total.md` | Speaker-note source | Complete notes before splitting | Step 6 writes; Step 7.1 splits || `notes/slide_*.md` | Split notes | Per-slide notes generated from `total.md` | Derived by `total_md_split.py` || `svg_final/` | Derived visual preview | Self-contained post-processed SVGs that may be opened directly or inserted as SVG pictures | Rebuild from `svg_output/` with `finalize_svg.py`; do not use as a supported PPTX source |-| `exports/svg_quality_report.json` | Quality provenance | Final SVG gate split into blocking / introduced / inherited / source-import categories, bound to the checked SVG bytes by SHA-256 | `svg_quality_checker.py --stage final --json` writes before export; postflight links it only when the export-source fingerprint matches. |-| `exports/` | Delivery artifacts | Native DrawingML PPTX, `<output_stem>.report.json` postflight audit, and explicit native-object/narration variants | Step 7.3 writes final outputs from `svg_output/` |+| `validation/svg_quality_report.json` | Quality provenance | Final SVG gate split into blocking / introduced / inherited / source-import categories, bound to the checked SVG bytes by SHA-256 | `svg_quality_checker.py --stage final --json` writes before export; postflight links it only when the export-source fingerprint matches. |+| `validation/<output_stem>.report.json` | Published-package audit | PPTX package/resource postflight status, part counts, and quality-gate linkage | Step 7.3 writes after the PPTX passes package validation. |+| `exports/` | Delivery artifacts | Native DrawingML PPTX and explicit native-object/narration variants | Step 7.3 writes only final deliverables from `svg_output/`. || `backup/<timestamp>/svg_output/` | Frozen author-source archive | Re-export source without re-running LLM | `svg_to_pptx.py` writes a snapshot during export || `animations.json` | Optional animation config | Object-level animation sidecar | Created only by explicit animation workflow/request |@@ -80,7 +81,7 @@ Global artifact ownership rules for PPT Master projects.| `<import_workspace>/authoring-svg/authoring_summary.json` | Current authoring SVGs plus tool-only manifest roster | `python3 ${SKILL_DIR}/scripts/svg_authoring_view.py <import_workspace>/authoring-svg --refresh-summary`; in-place vector/picture extraction refreshes it automatically || `notes/slide_*.md` | `notes/total.md` | `python3 ${SKILL_DIR}/scripts/total_md_split.py <project_path>` || `svg_final/` | `svg_output/` plus project assets | `python3 ${SKILL_DIR}/scripts/finalize_svg.py <project_path>` |-| `exports/svg_quality_report.json` | `svg_output/`, locks, template provenance | `python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> --stage final --json` |-| Native PPTX + `<output_stem>.report.json` | `svg_output/` plus notes/assets and final quality report | `python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path>` |+| `validation/svg_quality_report.json` | `svg_output/`, locks, template provenance | `python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> --stage final --json` |+| Native PPTX + `validation/<output_stem>.report.json` | `svg_output/` plus notes/assets and final quality report | `python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path>` |**Default - regenerate derived views**: When a source artifact changes, regenerate the derived artifact at the owning step instead of patching the derived file directly.diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 3e2c31ac..5dea2eb4 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -113,7 +113,7 @@ Before drawing each page, look up its entry in `page_rhythm` (key format `P<NN>`- **Reference — create depth with restraint**: use rhythm, spacing, typography, accent bars, and subtle tints before shadows. Reserve lift for a few genuinely floating elements; keep peer grids, dividers, and body containers flat.- **Phased batch generation** (recommended):1. **Visual Construction Phase**: generate all SVG pages sequentially for visual consistency. Use layout judgment for chart marks during the draft. **MUST embed plot-area markers** per [`executor-chart.md`](./executor-chart.md) §2.1 on every chart page — coordinate calibration is a post-generation step (see [`verify-charts`](../workflows/stages/verify-charts.md)) that depends on these markers — and **native object metadata** per [`executor-chart.md`](./executor-chart.md) §2.2 on every eligible data-chart page. **Reach for native presets** per §3.0 as you draw each page: a block arrow, chevron, banner/ribbon, callout, standard flowchart node, or star is authored through `preset_shape_svg.py` at draw time — decided by the object's intent as you create it, never by scanning finished paths, and never committed to a bare `<path>`/`<polygon>` when a preset expresses it (a gradient fill/stroke or a pattern fill is the one paint exception — keep those ordinary SVG). **First-page gate (Mandatory)**: after completing the first page, run `python3 scripts/svg_quality_checker.py <project_path> --stage first-page` and fix every error before drawing page 2. This stage validates only the first authored page with a partial structure roster; future declared pages are not reported missing.- 2. **Quality Check Gate**: run `python3 scripts/svg_quality_checker.py <project_path> --stage final --json` on `svg_output/`. Any `error` (banned/unsupported features, invalid values, unresolved references, viewBox mismatch, etc.) MUST be fixed on the offending page before proceeding — regenerate and re-check. Every `warning` is advisory: it never sends the page back for required modification, never authorizes automatic rewriting of compatible user syntax, and needs no acknowledgement/disposition line. Recommendation warnings describe the generated-SVG default; fidelity/quality warnings may be surfaced when material, while the existing input remains releasable. Prototype-identical diagnostics are recorded as `inherited`, source conversion losses as `source-import`, changed/new advisories as `introduced`, and release failures as `blocking` in `exports/svg_quality_report.json`. If release truly depends on a condition, it belongs in `errors`. Do NOT defer error handling to after `finalize_svg.py` — finalize rewrites SVG and masks some violations.+ 2. **Quality Check Gate**: run `python3 scripts/svg_quality_checker.py <project_path> --stage final --json` on `svg_output/`. Any `error` (banned/unsupported features, invalid values, unresolved references, viewBox mismatch, etc.) MUST be fixed on the offending page before proceeding — regenerate and re-check. Every `warning` is advisory: it never sends the page back for required modification, never authorizes automatic rewriting of compatible user syntax, and needs no acknowledgement/disposition line. Recommendation warnings describe the generated-SVG default; fidelity/quality warnings may be surfaced when material, while the existing input remains releasable. Prototype-identical diagnostics are recorded as `inherited`, source conversion losses as `source-import`, changed/new advisories as `introduced`, and release failures as `blocking` in `validation/svg_quality_report.json`. If release truly depends on a condition, it belongs in `errors`. Do NOT defer error handling to after `finalize_svg.py` — finalize rewrites SVG and masks some violations.3. **Logic Construction Phase**: after SVGs pass the quality check, batch-generate speaker notes for narrative continuity.### 3.0 Native Preset Shape Selectiondiff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex 34c4bc83..b8a99c3f 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -302,10 +302,11 @@ selection, audio generation, and the narrated re-export workflow.Behavior:- Default output (default-flow mode, no `-o`):- `exports/<project_name>_<timestamp>.pptx` — native editable pptx (canonical output)- - `exports/<project_name>_<timestamp>.report.json` — package postflight, quality-gate linkage, unresolved resource audit, and published part counts+ - `validation/<project_name>_<timestamp>.report.json` — package postflight, quality-gate linkage, unresolved resource audit, and published part counts- `backup/<timestamp>/svg_output/` — copy of Executor SVG source, always written so the pptx can be rebuilt via `finalize_svg → svg_to_pptx` without re-running the LLM+- `exports/` contains only final PPTX deliverables; machine-readable quality and postflight reports belong in `validation/`.- `finalize_svg.py` always creates `svg_final/` before export. This directory is the self-contained SVG visual preview; it is not packaged as a second PPTX.-- Explicit `-o/--output` changes the native PPTX destination and skips `backup/`.+- Explicit `-o/--output` changes the native PPTX destination and skips `backup/`; its postflight report still uses the output stem under the project `validation/` directory.- Postflight reruns ZIP integrity and published Slide count. Internal relationships,structured-package validation, transitions, and animations are enforced before thebuilder publishes the PPTX and are reported as `enforced-at-build`, not as repeated@@ -337,7 +338,7 @@ Behavior:- Native output uses content-hash media filenames, so identical images are reused and different images cannot overwrite each other by sharing a basename.- `[Content_Types].xml` is generated from the actual media extensions written into the PPTX. Unknown media extensions fail unless Python's `mimetypes` can identify them.- Native export writes to a temporary file first and publishes the requested PPTX only after conversion succeeds. A failed conversion does not replace the main output file.-- After publication, native export writes `<output_stem>.report.json`. The report distinguishes authored Slides from internal Layout definitions, reruns ZIP integrity and published Slide-count checks, records slide/layout/master/notes part counts, labels relationship/structured/transition/animation validation as enforced at build time, links the final SVG quality report only when its SHA-256 source fingerprint matches the exact export inputs, and surfaces stale/unverified gates, unresolved template tokens, generic-only font stacks, and external image references.+- After publication, native export writes `validation/<output_stem>.report.json`. The report distinguishes authored Slides from internal Layout definitions, reruns ZIP integrity and published Slide-count checks, records slide/layout/master/notes part counts, labels relationship/structured/transition/animation validation as enforced at build time, links the final SVG quality report only when its SHA-256 source fingerprint matches the exact export inputs, and surfaces stale/unverified gates, unresolved template tokens, generic-only font stacks, and external image references.- Before publishing structured template output, export reopens the temporary PPTX and validates the Slide → Layout → Master graph and registrations, Layout identity, placeholder identity, reusable bounds, and prompt/level-one sizes. A mismatch aborts publication. Flat release instead validates its single referenced Master/Layout shell and exact date/footer/slide-number hook roster before packaging.- SVG clip paths are still restricted for authored SVGs, but nested crop wrappers generated by PPTX import are mapped back to native picture crop / geometry when possible.- Speaker notes are embedded automatically unless `--no-notes` is used@@ -422,8 +423,8 @@ not affect the command's zero exit status. Only errors block the quality gate.`--stage first-page` resolves only the first authored SVG and permits an incompletefuture page roster. `--stage final` checks the complete project. With `--json`,-the final stage writes `exports/svg_quality_report.json`, while the first-page-stage writes `exports/svg_quality_first_page_report.json` so it cannot overwrite+the final stage writes `validation/svg_quality_report.json`, while the first-page+stage writes `validation/svg_quality_first_page_report.json` so it cannot overwritethe release gate (or use `--json-output`). The report separatesrelease failures (`blocking`), changed/new advisories (`introduced`),prototype-identical diagnostics (`inherited`), and source-conversion lossesdiff --git a/skills/ppt-master/scripts/project_manager.py b/skills/ppt-master/scripts/project_manager.pyindex 17f49764..c1099c78 100644--- a/skills/ppt-master/scripts/project_manager.py+++ b/skills/ppt-master/scripts/project_manager.py@@ -169,6 +169,7 @@ class ProjectManager:"live_preview",SOURCE_DIRNAME,"analysis",+ "validation","exports",):(project_path / rel_path).mkdir(parents=True, exist_ok=True)@@ -190,7 +191,8 @@ class ProjectManager:"- `live_preview/`: browser preview runtime files and history (lock.json, server.log, edits.jsonl, annotations.jsonl)\n""- `sources/`: source materials and normalized markdown\n""- `analysis/`: machine-extracted intermediate analysis (PPTX intake, image_analysis.csv) — the pipeline's canonical must-read source/asset facts\n"- "- `exports/`: native DrawingML pptx (timestamped); `_native_charts_tables.pptx` name with `--native-charts-and-tables`, `_narrated.pptx` name when narration audio is embedded\n"+ "- `validation/`: SVG quality reports and PPTX postflight audit reports\n"+ "- `exports/`: final native DrawingML pptx deliverables only (timestamped); `_native_charts_tables.pptx` name with `--native-charts-and-tables`, `_narrated.pptx` name when narration audio is embedded\n""- `backup/<timestamp>/`: svg_output/ archive (always written in default-flow mode; safe to delete old timestamps)\n"),encoding="utf-8",diff --git a/skills/ppt-master/scripts/svg_quality_checker.py b/skills/ppt-master/scripts/svg_quality_checker.pyindex 072438e4..be958e14 100644--- a/skills/ppt-master/scripts/svg_quality_checker.py+++ b/skills/ppt-master/scripts/svg_quality_checker.py@@ -6489,7 +6489,7 @@ def _default_json_report_path((project_path / 'svg_output').is_dir()or (project_path / 'design_spec.md').is_file()):- return project_path / 'exports' / report_name+ return project_path / 'validation' / report_namebase = target_path if target_path.is_dir() else target_path.parentreturn base / report_namediff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.pyindex 89520803..c57880a2 100644--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py@@ -231,7 +231,7 @@ def _quality_report_context(source_fingerprint: dict[str, object],) -> dict[str, object]:"""Load the final SVG quality report when the preceding gate wrote one."""- quality_path = project_path / 'exports' / 'svg_quality_report.json'+ quality_path = project_path / 'validation' / 'svg_quality_report.json'try:quality = json.loads(quality_path.read_text(encoding='utf-8'))except FileNotFoundError:@@ -284,7 +284,7 @@ def _write_postflight_report(backup_path: Path | None,conversion_trace_path: Path | None,) -> Path:- """Write the unified package/resource audit beside a successful PPTX."""+ """Write the unified package/resource audit for a successful PPTX."""try:package = _package_part_counts(output_path)except (OSError, zipfile.BadZipFile) as exc:@@ -337,7 +337,9 @@ def _write_postflight_report(report_status = 'passed'else:report_status = 'passed-with-warnings'- report_path = output_path.with_suffix('.report.json')+ report_path = (+ project_path / 'validation' / f'{output_path.stem}.report.json'+ )report = {'schema': 'ppt-master.pptx-postflight-report.v1','status': report_status,@@ -382,6 +384,7 @@ def _write_postflight_report(else None),}+ report_path.parent.mkdir(parents=True, exist_ok=True)report_path.write_text(json.dumps(report, ensure_ascii=False, indent=2) + '\n',encoding='utf-8',diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex e6b25b96..6aa8babd 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -393,7 +393,7 @@ python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> --stage final- Every `warning` is advisory and non-blocking: do not return the page for mandatory modification, do not auto-normalize user-authored compatible syntax, and do not require an acknowledgement/disposition line. Recommendation warnings identify the generated-SVG default; fidelity/quality warnings may be reported when material, but the existing input may ship unchanged. If a condition must be corrected before release, the checker must classify it as an `error`, not a `warning`.- The same rule applies to structured-template warnings (empty/framing-only Layout, bare Master, duplicate layout keys): they may guide an optional template cleanup, but warnings alone never fail the quality gate. Flat `style`, free-design, and brand-only routes still rely on their existing hard errors for invalid structure metadata or incomplete required locks.- Run against `svg_output/` (not after `finalize_svg.py` — finalize rewrites SVG and masks violations).-- The JSON report is written to `exports/svg_quality_report.json`. `inherited` prototype diagnostics and `source-import` compatibility losses are informational provenance; only changed/new warnings remain `introduced`, and all release-blocking failures remain `blocking`.+- The JSON report is written to `validation/svg_quality_report.json`. `inherited` prototype diagnostics and `source-import` compatibility losses are informational provenance; only changed/new warnings remain `introduced`, and all release-blocking failures remain `blocking`.**Logic Construction Phase**: after the SVG quality gate passes, load [`executor-notes.md`](../references/executor-notes.md) and generate speaker notes → `<project_path>/notes/total.md`@@ -445,10 +445,10 @@ python3 ${SKILL_DIR}/scripts/finalize_svg.py <project_path>python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path>```-**Success criterion**: The command exits successfully and publishes:+**Success criterion**: The command exits successfully and produces:- `exports/<project_name>_<timestamp>.pptx`-- `exports/<project_name>_<timestamp>.report.json` with `passed` or `passed-with-warnings` package/resource postflight status+- `validation/<project_name>_<timestamp>.report.json` with `passed` or `passed-with-warnings` package/resource postflight statusDisclose material postflight warnings to the user. A failed report or missing PPTX is not success.@@ -457,5 +457,5 @@ Disclose material postflight warnings to the user. A failed report or missing PP- [x] Image readiness gate passed- [x] Notes split completed- [x] `svg_final/` preview completed-- [x] Native PPTX and postflight report published+- [x] Native PPTX published and postflight report written- [ ] **Next**: Report the exported PPTX path; run a supporting post-export stage only when its explicit trigger is presentdiff --git a/skills/ppt-master/workflows/routing.md b/skills/ppt-master/workflows/routing.mdindex 74c9fce9..116a5e18 100644--- a/skills/ppt-master/workflows/routing.md+++ b/skills/ppt-master/workflows/routing.md@@ -30,7 +30,7 @@ route selection. After selection, the route authority owns execution.| Route | Request shape | Authority | Preconditions | Mutation model | Output contract ||---|---|---|---|---|---|-| Generate PPTX | Create a new presentation; regenerate an existing deck visually; use source material or a topic; optionally apply an explicit template workspace | [`generate-pptx`](./generate-pptx.md) | Source facts exist or the topic-research stage can gather them | Author new SVG pages and export a new PPTX | New project with `design_spec.md`, `spec_lock.md`, `svg_output/`, and `exports/` |+| Generate PPTX | Create a new presentation; regenerate an existing deck visually; use source material or a topic; optionally apply an explicit template workspace | [`generate-pptx`](./generate-pptx.md) | Source facts exist or the topic-research stage can gather them | Author new SVG pages and export a new PPTX | New project with `design_spec.md`, `spec_lock.md`, `svg_output/`, `validation/`, and `exports/` || Create Template | Create a reusable brand/layout/deck template from one or more PPTX/SVG files, images/PDFs, direct or file-based text, documents/websites, brand assets, or a mixed reference bundle | [`create-template`](./create-template.md) | A reusable-template request exists; reference material is optional, and project scope additionally requires an initialized target project | Author a new portable workspace; never modify any reference file in place | Workspace with required `templates/`, optional `images/` / `icons/`, and optional review `exports/` || Fill Native PPTX | Use a raw PPTX's native slide shells and replace/fill content | [`template-fill-pptx`](./template-fill-pptx.md) | Source PPTX plus new material/topic | Clone and patch PPTX through OOXML; no SVG pipeline | New filled PPTX in project `exports/` || Enhance Native PPTX | Keep a finished PPTX's visible slides stable while adding notes, audio, timings, or transitions | [`native-enhance-pptx`](./native-enhance-pptx.md) | Finished source PPTX exists | Append/update scoped OOXML parts; no slide regeneration | New enhanced PPTX in project `exports/` |