Skip to content

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(checker): keep canonical compact authoring advisory in template mode

hugohe30f88d872ff31
diff --git a/skills/ppt-master/references/shared-standards-core.md b/skills/ppt-master/references/shared-standards-core.md
index 69884829..2c4bee85 100644
--- a/skills/ppt-master/references/shared-standards-core.md
+++ b/skills/ppt-master/references/shared-standards-core.md
@@ -151,8 +151,8 @@ The source stays valid, browser-visible, semantic, locally editable SVG;
meaning and deterministic export outrank bytes. Never use classes/stylesheets,
aliases/private keys, encoded payloads, precision loss, or unrelated
indirection. `--canonical-authoring` reports drift from the compact form as an advisory
-warning on authored pages and as an error only for template workspaces;
-`compact_svg_styles.py --inplace` applies the same normalization on request.
+warning; `compact_svg_styles.py --inplace` applies the same normalization on
+request to authored project pages, never to structured template rosters.
> **`marker-start` / `marker-end` is conditional** — see §1.1.
>
diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.md
index ee2f76f6..f4842d61 100644
--- a/skills/ppt-master/scripts/docs/svg-pipeline.md
+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md
@@ -399,11 +399,13 @@ PPTX import projections and mirror materialization call the same tree-level
implementation before publishing their authoring SVG. Standard workflows do
not rewrite completed SVG: they pass `--canonical-authoring` to
`svg_quality_checker.py`, which reports any remaining deterministic change as an
-advisory warning on authored project pages (run
-`compact_svg_styles.py <svg_output> --inplace` and rerun the final gate to
-normalize, or keep the explicit form) and as a blocking error under
-`--template-mode`, where the compact tree is the hash-locked mirror source.
-SVG-to-PPTX accepts valid explicit declarations either way; canonical compact
+advisory warning (run `compact_svg_styles.py <svg_output> --inplace` on
+authored project pages and rerun the final gate to normalize, or keep the
+explicit form). Structured template rosters keep their explicit form: per-slide
+compaction would make shared Master/Layout atoms diverge and shift native
+fallback hashes, so the normalizer is not applied to them; mirror
+materialization compacts its own tree before publication. SVG-to-PPTX accepts
+valid explicit declarations either way; canonical compact
authoring is a generated-source contract, not a compatibility restriction on
external SVG input.
diff --git a/skills/ppt-master/scripts/svg_quality/checker.py b/skills/ppt-master/scripts/svg_quality/checker.py
index 2c679e60..8733c5e1 100644
--- a/skills/ppt-master/scripts/svg_quality/checker.py
+++ b/skills/ppt-master/scripts/svg_quality/checker.py
@@ -1404,13 +1404,15 @@ class SVGQualityChecker:
root: ET.Element,
result: Dict,
) -> None:
- """Report SVG that was not compact when authored.
-
- Template workspaces (``--template-mode``) fail because their compact
- form is the hash-locked source for mirror materialization. Authored
- project pages only receive an advisory warning: the exporter accepts
- explicit declarations, and ``compact_svg_styles.py --inplace`` applies
- the same deterministic normalization on request.
+ """Report SVG that was not compact when authored (advisory).
+
+ The exporter accepts explicit declarations, so drift from the compact
+ form never blocks. ``compact_svg_styles.py --inplace`` applies the
+ deterministic normalization on request for authored project pages; it
+ is not applied to structured template rosters, where per-slide
+ compaction would make shared Master/Layout atoms diverge and shift
+ native fallback hashes. Mirror materialization compacts its own tree
+ before publication.
"""
if not self.canonical_authoring:
return
@@ -1425,8 +1427,9 @@ class SVGQualityChecker:
if not errors:
return
if self.template_mode:
- result['errors'].extend(
- f"Noncanonical compact authoring: {error}"
+ result['warnings'].extend(
+ f"Noncanonical compact authoring: {error} "
+ "(advisory; structured rosters keep their explicit form)"
for error in errors
)
return