v1.0.0 — Full English Support + Humanize-Side Presenter Shell

v1.0.0 — Full English Support + Humanize-Side Presenter Shell

Date: 2026-06-20 · Branch: feat/v0.9-next → tag v1.0.0

What changed

English renderers reach full

frontend-slides and beautiful-html-templates are now support_level: full in registry/renderer_registry.json. The remaining gap from v0.9 was 0 renderer-specific failure-mode rules. Five static rules are now added for both English renderers:

Rule	What it catches
english-horizontal-overflow	overflow-x:auto/scroll/visible or viewport widths above 100vw
english-low-contrast	Explicit hex color pairs with contrast ratio below 3.0:1
english-hyphenation-noise	hyphens:auto, word-break:break-all, overflow-wrap:anywhere
english-font-contract-missing	No web font or @font-face source — deck falls back to generic system font
english-image-alt-missing	<img> elements without an alt attribute

Full mode means: brief exit works + checkup verified on real rendered output + image generation wired in + renderer-specific failure modes recorded. Screenshot review is retained for occlusion, clipping, and visual alignment failures that static HTML cannot detect.

Humanize-side presenter shell

write_presenter_shell() now produces outputs/presenter/presenter-shell.html from slide_plan.json + speaker_intent.md without requiring the downstream deck to exist. Features: current/next slide labels, speaker notes panel, slide counter, keyboard navigation (← →), S toggle, and timer. When the downstream deck is ready, downstream native consoles (guizang, Neo-Grid) can take over the full stage view; the shell stays as a functional baseline.

--presenter-adapter no longer returns missing-deck when no deck is supplied — it falls back to standalone shell mode.

Version bumps

• scripts/humanize_ppt_v2.py VERSION → 1.0.0
• SKILL.md frontmatter version → 1.0.0
• SPEC.md header → Version: 1.0

Tests

109 passing (up from 103 at v0.9.0 baseline). New coverage:

• test_write_presenter_adapter_creates_presenter_shell_with_notes
• test_write_presenter_adapter_renders_standalone_shell_without_deck
• test_module_entrypoint_can_render_presenter_shell_without_deck
• test_qa_loop_runs_english_specific_failure_modes
• test_english_specific_modes_are_registered_for_both_english_renderers
• test_english_showcase_deck_passes_presentation_checkup

Showcase added

docs/showcase/codex-starter-frontend-en/ — an English-path true-rendered deck (Codex Starter Guide · Frontend Slides Vol.01), dark editorial style, Fraunces serif + Spline Sans Mono.

What did not change

• All v0.6.4 invariants hold: brief-only output, no post-processing of downstream HTML, 3-round checkup cap.
• Screenshot review is still required for the failure classes static scan can't reach (occlusion, clipping, weight downgrade, visual misalignment).
• Downstream template ownership is unchanged: guizang / frontend-slides / beautiful-html-templates own native rendering. Humanize owns the talk structure, per-page media decisions, checkup, and now the presenter baseline.

Upgrade from v0.9.0

No breaking changes. If you were treating the English path as second-tier, it no longer is — all three production renderers are full.