Progress docs: target-app parity, gaps, alpha gate, readiness by audience (#89)

Progress docs per craftrules standards/progress-docs.md: target-app parity, gaps, roadmap with alpha gate, readiness by audience (full / mainstream / essentials) with Opus 5.5 hours, and feature, format, hardware, UI and localization parity docs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 14:59:08 +00:00 · 2026-10-10 14:09:21 -04:00
1 parent d556ff98b5
commit f44857624e
@@ -158,8 +158,21 @@ to `main`.
 ## 7. Planning

 `plan/` (gitignored) holds the local plan: `README.md`, `architecture.md`, `execution-plan.md`,
-`STATUS.md` (start every session there) and `powerpoint/` observations. `ROADMAP.md` (committed)
-tracks status, milestones, parity and estimates; update it whenever a milestone task lands.
+`STATUS.md` (start every session there) and `powerpoint/` observations. The committed progress
+docs follow craftrules `standards/progress-docs.md`:
+
+| File | Holds |
+|---|---|
+| `ROADMAP.md` | Stage, headline numbers, dimensions, features, languages, progress log |
+| `docs/target-app-parity.md` | The parity assessment against PowerPoint: percentages, hours, calibration |
+| `docs/gaps.md` | Every known shortfall, ranked: the work list. Pick from the top |
+| `docs/roadmap.md` | Current focus, the beta plan, milestones |
+| `docs/parity-checklist.md` | Feature rows scored D/P/M; `cargo xtask parity` regenerates its summary |
+| `docs/file-format-parity.md`, `ui-parity.md`, `hardware-parity.md`, `localization-parity.md`, `animation-parity.md`, `slideshow-parity.md` | Per-dimension and per-feature detail |
+| `docs/architecture.md` | How DeckCraft is built today |
+
+When a task lands, re-score its checklist row, delete or update its `gaps.md` entry, add a line to
+the `ROADMAP.md` progress log, and update each touched doc's status line and revision history.

 ## Contributor credits (About window)

@@ -13,5 +13,5 @@ win over anything here.
 - Look at UI changes: `deckcraft --sample --control 7990` + `ui.screenshot`, or
  `deckcraft-cli render`.
 - Commit after each landed arc (`M<n>.<k>: what`) and push to `origin main`.
- Keep `ROADMAP.md` and `plan/STATUS.md` current.
+- Keep `ROADMAP.md`, the progress docs in `docs/` (AGENTS.md §7) and `plan/STATUS.md` current.
 - Don't ask the user questions; record genuinely-theirs decisions in `plan/STATUS.md`.
@@ -58,7 +58,7 @@

 ## What works today

-DeckCraft is in early development, heading for its first alpha (see the [roadmap](ROADMAP.md)).
+DeckCraft is in alpha, heading for beta (see the [roadmap](ROADMAP.md)).
 Today it can:

 - **Make decks**: slide masters and eleven layouts with placeholders that inherit position and
@@ -154,10 +154,12 @@ deckcraft-cli mcp --connect 7990        # drive the running app (deckcraft --con

 ## Roadmap

-DeckCraft covers about **79% of PowerPoint's features by breadth** (93% of the core ones) and is
-roughly **80% of the way to a first alpha**. See [ROADMAP.md](ROADMAP.md) for the alpha checklist,
-parity estimates and what's next, and [docs/parity.md](docs/parity.md) for the feature-by-feature
-scorecard.
+DeckCraft is in **alpha**. It covers **79% of PowerPoint's features by breadth** (92% of the core
+ones, measured) and is about **55% of the way to replacing PowerPoint for real work** (estimated).
+See [ROADMAP.md](ROADMAP.md) for the stage, numbers by dimension and what's next,
+[docs/target-app-parity.md](docs/target-app-parity.md) for the full assessment,
+[docs/gaps.md](docs/gaps.md) for every known shortfall and
+[docs/parity-checklist.md](docs/parity-checklist.md) for the feature-by-feature checklist.

 ## Downloads

@@ -1,107 +1,146 @@
 # DeckCraft roadmap

-DeckCraft aims at full PowerPoint parity — and to be better: faster, open (a documented zip+JSON
+**Stage: alpha** · next: beta, ~20 points and ~120–210 h away
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** minor (hours to ~95% per audience added; ready 56% → 55%; stage stays alpha; previous: major, full re-measure against PowerPoint for Mac 16.113.4; restructured to the craftrules progress-docs standard) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+DeckCraft aims at full PowerPoint parity, and to be better: faster, open (a documented zip+JSON
 format plus PPTX), scriptable by agents (CLI, JSON control channel, MCP), and available everywhere
-(macOS, Windows, Linux, BSD and the web).
+(macOS, Windows, Linux, BSD and the web). This page is the summary; the detail is in
+[docs/target-app-parity.md](docs/target-app-parity.md) and the work list in
+[docs/gaps.md](docs/gaps.md).

-## Status (2026-10-07)
+## Headline numbers

-**Working today**
- Document model: presentations, slides, masters and 11 standard layouts with placeholder inheritance
-  (slide → layout → master → theme), sections, notes, comments, custom shows, header/footer fields,
-  embedded media, unlimited undo built on shared slide snapshots.
- Themes: 8 original themes with colour and font schemes, custom colours/fonts, backgrounds,
-  slide size presets.
- Shapes: ~150 preset geometries with adjustment handles, text boxes, pictures (with crop and
-  adjustments), tables with styles, charts (column, bar, line, area, pie, doughnut, scatter and more),
-  basic SmartArt, groups, connectors, ink, action buttons, WordArt.
- Text: in-place editing with caret, selection, keyboard and mouse; every Home-tab font and paragraph
-  control; bullets and numbering; levels; autofit; columns; vertical text; fields; hyperlinks.
-  Right-to-left and Arabic text: UAX #9 bidi (levels per paragraph, L1/L2 per line, mirrored
-  brackets), contextual HarfRust shaping across style runs, `a:latin`/`a:ea`/`a:cs` slots with
-  per-cluster fallback through theme script fonts, RTL start edge and bullets, `justLow` kashida,
-  bidi caret/hit-testing/selection (`format.rtl`). Arrow keys still move logically (visual
-  movement with caret affinity lands with the keyboard sprint).
- Editing: select, marquee, move, resize, rotate, adjust; smart guides; nudge; duplicate; z-order;
-  group/ungroup; align/distribute; Format Painter; Selection pane; clipboard incl. images.
- Transitions (fade, push, wipe, split, cover, uncover, zoom, morph…) and animations (entrance,
-  emphasis, exit, motion paths, triggers, by-paragraph builds) on a shared timeline engine.
- Slide show: full screen, keyboard/mouse navigation, blank screens, go-to-slide, pen, presenter
-  window, rehearse timings, custom shows, Set Up Show; Reading View; hyperlinks and shape actions
-  are followed on click (slides, web pages, email, End Show, Last Slide Viewed).
- Views: Normal (thumbnails with sections, slide, notes), Outline, Slide Sorter, Notes Page,
-  Slide Master; zoom; grayscale.
- Review: comments, accessibility checker, spelling.
- Audio and video: MP3, AAC/M4A, ALAC, WAV, AIFF, CAF, FLAC, Ogg Vorbis and Opus audio; H.264,
-  HEVC, VP9 and AV1 video in MP4/MOV/WebM/MKV (pure-Rust decoders); poster frames, trim, fades,
-  volume, loop, rewind, play across slides, hide during show, full screen; an in-place control bar
-  in the editor and `media.play/pause/stop/seek/info/posterFrame` for agents. WMA/WMV are
-  recognised and embedded but not yet playable. Animated GIFs play in the editor and the show;
-  pause them from their corner button or `media.gifPlay`.
- PDF export: slides, notes pages and handouts (1–9 per page) with a selectable real-text layer, hyperlinks and slide bookmarks (`file.export {format: "pdf", layout}`, File › Export…).
- UI: PowerPoint-style ribbon with contextual tabs, ~240 original icons, status bar, panes, command
-  palette, light/dark.
- Automation: ~200 commands, every one reachable from `deckcraft-cli`, the app's JSON control
-  channel and the MCP server (headless or connected to the running app).
- Web: `apps/deckcraft-web` runs the same UI in the browser (trunk; WebGPU with WebGL2 fallback),
-  opening the sample deck; Open/Insert use the browser file picker, Save/Export download.
- Release CI: pushes to `release` build a draft GitHub Release (macOS universal dmg, Windows
-  x64/x86 msi + zip, Linux AppImage/deb/rpm/tar.gz + Flatpak, FreeBSD tar.gz, web zip); signing
-  secrets live in the `release` environment. Version: `cargo xtask version`.
-
-**Next (in order):** PPTX corpus hardening against real-world decks ·
-Animation Pane and presenter view polish · vector PDF artwork · Format Shape pane depth (3-D,
-picture/texture options) · edit points · native macOS menu bar · print · Notes/Handout masters ·
-equations · SVG pictures · WMA/WMV decoding.
-
-Milestone details live in `plan/execution-plan.md` (M0–M14, local planning notes).
-
-## How close to an alpha (estimate, 2026-10-07)
-
-An **alpha** here means: someone can install a signed build on macOS, Windows or Linux, make a real
-deck from scratch or from a PowerPoint file, present it with transitions, animations and media,
-save it back to `.pptx`/PDF without losing work, and hit no crashes on the common paths.
-
-**DeckCraft is about 80% of the way to that alpha — roughly 30–40 wall-clock hours of a single
-Claude Opus 5.5 agent** (about 12–18 hours with three agents in parallel).
-
-| Alpha blocker | State | Estimate |
+| | Value | Kind |
 |---|---|---|
-| First real release run: signing, notarization, installers verified on each OS | Done for macOS + Windows signing: v0.1.0 published (all platforms built); installers still to be hand-checked on each OS | 2 h |
-| PPTX fidelity on a corpus of real decks (import, round-trip, opens without repair) | Verified on generated decks only | 8 h |
-| Presenter view and Animation Pane polish (timeline, reorder, preview) | Working, rough | 6 h |
-| Soak and fuzz the editor (random command sequences, big decks, undo/redo) for crashes and slowness | Unit tests and guards only | 5 h |
-| UI fidelity pass on the most-used ribbon groups and dialogs; first-run experience | Mostly there | 6 h |
-| Mascot app icon (owner), README/site screenshots, user docs | Placeholder icon | 3 h |
+| **Feature breadth** | **79%** weighted over 191 PowerPoint features (P0 92%, P1 75%, P2 36%) | measured: `cargo xtask parity` over [docs/parity-checklist.md](docs/parity-checklist.md) |
+| Menu-bar coverage | 59% of 217 app-specific PowerPoint menu items matched by name (lower bound) | measured: script over the PowerPoint menu dump and the 226 commands |
+| **Ready for real work** | **~55%** | estimated: weighted dimensions below |
+| Mainstream practitioner | ~53% | estimated: weekly-use areas × discounts for interaction (×0.92), stability (×0.92) and `.pptx` exchange (×0.88), [method](docs/target-app-parity.md#mainstream-practitioner-and-essentials-user) |
+| Essentials user | ~62% | estimated: core features × discounts for launch (×0.90), clarity (×0.95) and opening received files (×0.90), [method](docs/target-app-parity.md#mainstream-practitioner-and-essentials-user) |
+| Hours to beta | **~120–210** Opus 5.5 agent hours (~40–70 h with 3–4 agents) | estimated, [docs/roadmap.md](docs/roadmap.md) |
+| Hours to full parity | **~365–650** Opus 5.5 agent hours | estimated, [docs/target-app-parity.md](docs/target-app-parity.md) |

-Already alpha-ready: editing, text, shapes (incl. connectors, freeform, merge), themes and
-backgrounds, tables, charts, transitions, animations, slide show, audio/video playback, PDF export,
-AutoRecover, CLI/MCP automation, web build.
+### Readiness by audience

-## How far from full parity (estimate, 2026-10-07)
+| Audience | Ready | Opus 5.5 agent hours to ~95% | Work that dominates |
+|---|---:|---|---|
+| Full target (ready for real work) | ~55% | 340–600 (~60% parallelizes: ~120–210 h wall clock with 3–4 agents) | Feature depth across all 20 areas, legacy `.ppt`/`.odp` and video export, localization in 11+ languages, GPU raster and hardware decode, AI features |
+| Mainstream practitioner | ~53% | 150–250 (~50% parallelizes: ~70–120 h with 3 agents) | `.pptx` exchange (real-deck corpus, round-trip losses, EMF/SVG, embedded fonts) 45–75 h; depth in charts, animations, pictures, text, presenting, print/vector PDF 70–110 h; interaction (menu bar, Format Shape pane, font faces, dialogs) 25–40 h; stability 10–20 h |
+| Essentials user | ~62% | 50–90 (~40% parallelizes: ~30–55 h with 2–3 agents) | Opening received decks (corpus subset, EMF, SVG icons) 25–45 h; Windows launch fallback and Close prompt 6–12 h; font faces, Tab, paste, print, show navigation 12–20 h; start screen, menu bar, palette 6–10 h |

-**Breadth: ~80% weighted** (P0 core 93%, P1 74%, P2 37%) over the 187 features of the PowerPoint catalogue, scored row by
-row in [docs/parity.md](docs/parity.md) (`cargo xtask parity` recomputes it). Many features scored
-done still lack some of PowerPoint's options, dialogs or pixel fidelity, so **overall parity
-including depth is about 62%**.
+Calibration is the same as for the full number (see [docs/target-app-parity.md](docs/target-app-parity.md#calibration-how-the-hours-were-derived)): a fix is 0.5–1 h, a checklist row to PowerPoint depth 2–4 h, a subsystem 6–35 h. The sets are nested, so essentials ≤ mainstream ≤ full. The full number is an additive weighted sum over the dimension table; only mainstream and essentials use multiplicative discounts.

-**Remaining work to 100%: about 190 wall-clock hours of a single Claude Opus 5.5 agent** (±30%),
-or roughly 65–90 hours with four agents in parallel on separate crates:
+**Why alpha:** all six of PowerPoint's core workflows pass the alpha gate
+([docs/roadmap.md](docs/roadmap.md#alpha-gate-powerpoints-core-workflows)): build, open and save
+`.pptx`, present, add tables and charts, share as PDF, review. Core workflows work end to end (build a deck, open and save `.pptx`, present with
+transitions, animations, media and presenter view, export PDF), but depth, fidelity and polish
+have known gaps, and PPTX has never been tested on a corpus of real decks. Beta needs ~75% ready
+and no blocking gap in `.pptx`: the real-deck corpus, the round-trip losses (#70, #74, #77),
+EMF/SVG pictures, the data-loss and startup-crash bugs (#60, #40, #59) and the beta list in
+[docs/roadmap.md](docs/roadmap.md).

-| Work | Estimate |
-|---|---|
-| Alpha blockers above | 35 h |
-| Open P0/P1 rows (vector PDF, print, edit points, SVG, multi-monitor, draw table, SmartArt text pane, Notes/Handout masters…) | 45 h |
-| Open P2 rows (equations, video export, 3-D, remove background, thesaurus, compare, record show…) | 40 h |
-| Depth and pixel fidelity of every ribbon group, dialog and pane against PowerPoint | 50 h |
-| Performance (incremental rendering, GPU raster, streaming media decode) | 20 h |
+## By dimension

-Basis: in this session the engine, renderer, UI, show engine, PPTX, PDF, media and release
-pipeline were built in about 30 wall-clock hours with up to three agents in parallel; recent
-catalogue rows (connectors, freeform, merge shapes, AutoRecover, gradients) took 1–2 hours each.
+| Dimension | Ready | Hours to full | Doc |
+|---|---:|---|---|
+| Features (breadth 79% measured, with depth) | ~62% | 140–240 | [docs/parity-checklist.md](docs/parity-checklist.md) |
+| UI/UX fidelity | ~60% | 30–50 | [docs/ui-parity.md](docs/ui-parity.md) |
+| File formats (PPTX, PDF, legacy, export) | ~58% | 60–110 | [docs/file-format-parity.md](docs/file-format-parity.md) |
+| Hardware (GPU raster, video decode, displays, pens) | ~40% | 25–45 | [docs/hardware-parity.md](docs/hardware-parity.md) |
+| Localization | ~8% | 55–90 + native review | [docs/localization-parity.md](docs/localization-parity.md) |
+| Performance (unmeasured) | ~55% | 10–20 | [docs/hardware-parity.md](docs/hardware-parity.md#performance) |
+| Stability | ~60% | 10–20 | [docs/gaps.md](docs/gaps.md#stability) |
+| Platforms | ~80% | 5–10 | [Downloads in README](README.md#downloads) |
+| Ecosystem (templates; add-ins out of scope) | ~25% | 10–20 | [docs/gaps.md](docs/gaps.md#ecosystem) |
+| AI features | ~10% | 20–40 | [docs/gaps.md](docs/gaps.md#ai-features) |
+| Automation ✱ (CLI, control channel, MCP) | ahead | 0 | [docs/mcp.md](docs/mcp.md) |
+
+## Features
+
+| Area | Breadth (measured) | Ready (est.) | Hours | Doc |
+|---|---:|---:|---|---|
+| Application shell | 71% | ~55% | 8–14 | [ui-parity](docs/ui-parity.md) |
+| Slides and sections | 90% | ~85% | 3–5 | [checklist](docs/parity-checklist.md) |
+| Views | 90% | ~80% | 3–6 | [ui-parity](docs/ui-parity.md) |
+| Masters and themes | 85% | ~70% | 8–14 | [checklist](docs/parity-checklist.md) |
+| Shapes | 86% | ~75% | 8–14 | [ui-parity](docs/ui-parity.md) |
+| Format (fill, line, effects) | 81% | ~65% | 8–14 | [ui-parity](docs/ui-parity.md) |
+| Arrange | 100% | ~90% | 1–2 | [ui-parity](docs/ui-parity.md) |
+| Text | 80% | ~62% | 18–30 | [gaps](docs/gaps.md#features) |
+| Tables | 89% | ~75% | 3–6 | [checklist](docs/parity-checklist.md) |
+| Charts | 65% | ~45% | 12–20 | [gaps](docs/gaps.md#charts-data-grid-elements-and-the-newer-chart-types) |
+| SmartArt | 33% | ~25% | 10–16 | [gaps](docs/gaps.md#smartart-is-pre-drawn-shapes-only) |
+| Pictures | 48% | ~45% | 12–20 | [file formats](docs/file-format-parity.md) |
+| Media | 67% | ~60% | 8–14 | [file formats](docs/file-format-parity.md) |
+| Transitions | 92% | ~80% | 4–8 | [animation-parity](docs/animation-parity.md) |
+| Animations | 79% | ~65% | 10–16 | [animation-parity](docs/animation-parity.md) |
+| Slide show and presenter view | 66% | ~60% | 10–16 | [slideshow-parity](docs/slideshow-parity.md) |
+| Review | 60% | ~45% | 8–14 | [gaps](docs/gaps.md) |
+| Draw (ink) | 33% | ~30% | 5–9 | [hardware-parity](docs/hardware-parity.md) |
+| Undo and clipboard | 88% | ~75% | 3–5 | [ui-parity](docs/ui-parity.md) |
+| Files (commands; formats above) | 69% | ~50% | in file formats | [file formats](docs/file-format-parity.md) |
+
+## Languages
+
+English only today; no string catalog yet (Ukrainian is in review as PR #34). Detail:
+[docs/localization-parity.md](docs/localization-parity.md).
+
+| Language | Code | UI strings | Status | Hours to full |
+|---|---|---:|---|---|
+| English | en | 100% | full | 0 |
+| Simplified Chinese | zh-Hans | 0% | none | 6–10 |
+| Spanish | es | 0% | none | 3–5 |
+| Hindi | hi | 0% | none | 4–7 |
+| Arabic | ar | 0% (slide text: bidi and shaping done) | none | 10–16 |
+| French | fr | 0% | none | 3–5 |
+| Portuguese | pt | 0% | none | 3–5 |
+| Indonesian | id | 0% | none | 3–5 |
+| Japanese | ja | 0% | none | 4–7 |
+| German | de | 0% | none | 3–5 |
+| Korean | ko | 0% | none | 4–7 |
+| Vietnamese | vi | 0% | none | 3–5 |
+
+Plus 8–14 h once for the catalog infrastructure. Other languages shipped: none. PowerPoint for Mac
+ships 26.
+
+## Upcoming
+
+Ranked; detail and the full beta plan in [docs/roadmap.md](docs/roadmap.md).
+
+1. **No data loss, no startup crashes:** Close's save prompt (#60), Windows GPU crashes (#40, #59),
+   image paste (#53), editor soak tests. 10–20 h.
+2. **PPTX on real decks:** owned corpus, round-trip checks, fixes; #70, #74, #77; EMF/WMF and SVG.
+   36–64 h.
+3. **Localization:** catalog, system language (#15), zh-Hans, es, fr, de, ja with IME. 27–46 h.
+4. **Output:** vector PDF, printing. 10–16 h.
+5. **Depth that users hit:** font weights (#69), chart data and elements, Animation Pane timeline,
+   presenter view on the right display, native macOS menu bar, Format Shape pane. 33–56 h.

 ## Agents: CLI and MCP

 Every command is reachable from `deckcraft-cli` (`run`, `describe`, `commands`, `app` for the running
 window, `render`, `convert`), from MCP (`deckcraft-cli mcp`, optionally `--connect PORT`), and from the
 app's JSON control channel (`deckcraft --control PORT`).
+
+## Progress log
+
+| Date | What landed |
+|---|---|
+| 2026-10-10 | Progress docs restructured to the craftrules standard; full re-measure (breadth 79%, ready ~55%, mainstream ~53%, essentials ~62%, alpha). Landed: Animation Painter (#54), Morph geometry outlines (#27), animated GIF playback (#39), hyperlink colour and following links in the show (#37, #45), date fields in their own format (#36), flipped shapes keep readable text (#35), show transition fix (#46), start screen from the Home button (#49), MCP export lists PDF (#65), OmaStore manifest (#57) |
+| 2026-10-09 | v0.4.0 released. UAX #9 bidi and Arabic shaping (#4), Morph with Words and Characters (#5), tables grow to fit and PDF cell text (#14), rotating log file (#7), DX12 default on Windows (#16), H.264/HEVC overflow hardening (#2), PPTX sniffing anywhere in the zip (#19) |
+| 2026-10-08 | v0.2.0 and v0.3.0 released: Windows arm64, Flatpak aarch64, AppImage zsync updates, branded DMG |
+| 2026-10-07 | v0.1.0 released, signed and notarized; About window with contributor credits (#3); PrintCraft renamed PdfCraft |
+| 2026-10-06 | Renamed SlideCraft to DeckCraft. PPTX import/export, PDF export, media playback with pure-Rust codecs, connectors with glue, freeform tools, merge shapes, AutoRecover, gradient editor, web build, release CI, parity catalogue |
+| 2026-10-05 | M0: workspace, model, geometry, fonts, text, renderer, engine, MCP, CLI, PowerPoint-style egui UI, slide show engine |
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | minor | Readiness-by-audience table with hours to ~95% for full, mainstream and essentials |
+| 2026-10-10 | minor | Added mainstream practitioner (~53%) and essentials user (~62%); features recomputed from written area weights, ready ~56% → ~55% |
+| 2026-10-10 | minor | Stage checked against the new core-workflow gate: passes, stays alpha |
+| 2026-10-10 | major | Restructured to craftrules `standards/progress-docs.md`: stage, two numbers, dimensions, features, languages; parity estimate moved to docs/target-app-parity.md, "Working today" to its evidence section, the alpha checklist to docs/roadmap.md |
+| 2026-10-07 | major | Alpha checklist (~80% to a self-defined alpha), breadth ~80%, overall ~62%, ~190 h to full parity |
@@ -0,0 +1,79 @@
+# Transitions and animations: parity with PowerPoint
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** major (created; effect lists counted from `crates/model/src/anim.rs` against PowerPoint 16.113's galleries) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+Transitions and animations are what make a deck a presentation, and the part of PowerPoint people
+notice first when it's missing. Scores roll up into [target-app-parity.md](target-app-parity.md)
+(Transitions ~80% ready, Animations ~65%); gaps are in [gaps.md](gaps.md).
+
+## Transitions: 48 of 48
+
+`crates/model/src/anim.rs` `TRANSITIONS` lists every transition in PowerPoint's gallery, in its
+three groups, with its Effect Options. All 48 round-trip through PPTX
+(`every_transition_kind_round_trips`), including the PowerPoint 2010+ `p14`/`p15` ones.
+
+| Group | PowerPoint | DeckCraft | Fidelity |
+|---|---|---|---|
+| Subtle (Morph, Fade, Push, Wipe, Split, Reveal, Cut, Random Bars, Shape, Uncover, Cover, Flash) | 12 | 12 | 2-D, close to PowerPoint |
+| Exciting (Fall Over, Drape, Curtains, Wind, Prestige, Fracture, Crush, Peel Off, Page Curl, Airplane, Origami, Dissolve, Checkerboard, Blinds, Clock, Ripple, Honeycomb, Glitter, Vortex, Shred, Switch, Flip, Gallery, Cube, Doors, Box, Comb, Zoom, Random) | 29 | 29 | 3-D ones are fake 3-D (trapezoid quads, `crates/anim/src/transition.rs`); particle effects (Vortex, Shred, Fracture, Crush) approximate |
+| Dynamic Content (Pan, Ferris Wheel, Conveyor, Rotate, Window, Orbit, Fly Through) | 7 | 7 | Same approach |
+
+| Transition feature | PowerPoint | DeckCraft |
+|---|---|---|
+| Effect Options per transition | yes | yes |
+| Duration, advance on click / after time, Apply To All | yes | yes |
+| Transition sounds | yes | **no** (the model has the field; no picker, no playback) |
+| Preview in the editor | yes | yes |
+| Morph: objects move, resize, recolour | yes | yes |
+| Morph: Words and Characters | yes | yes (#5) |
+| Morph: geometry (circle to star) | yes | yes (#27) |
+| Morph: `!!` name forcing, pictures, 3-D models, ink | yes | names partly; no 3-D or ink |
+| Frame-by-frame comparison with PowerPoint | | **not done** |
+
+## Animations: 64 of ~190 effects
+
+| Class | PowerPoint (gallery + More Effects) | DeckCraft | Missing (examples) |
+|---|---:|---:|---|
+| Entrance | ~50 | 24 | Plus, Wedge, Basic Zoom, Center Revolve, Compress, Stretch, Boomerang, Credits, Curve Up, Drop, Flip, Float, Pinwheel, Spiral In, Whip, Ascend, Descend, Unfold |
+| Emphasis | ~25 | 17 | Brush Color, Bold Reveal, Contrasting Color, Flicker, Grow With Color, Shimmer, Blink |
+| Exit | ~50 | 14 | Mirrors of the missing entrance effects, plus Blinds, Box, Checkerboard, Circle, Diamond, Peek Out, Strips as exits |
+| Motion paths | 64 presets + custom | 6 (Lines, Arcs, Turns, Loops, Shapes-style presets, Custom Path) | Most of Basic (shapes), Lines & Curves and Special presets |
+| Media (Play, Pause, Stop) | 3 (+ Seek) | 3 | Seek, bookmarks as triggers |
+
+By how often people use them, the effects present cover nearly all real decks (Appear, Fade, Fly
+In, Wipe, Zoom, Float In, Grow/Shrink, Pulse, Spin, motion lines): weighted, ~85% of use; by count,
+~34%.
+
+| Animation feature | PowerPoint | DeckCraft |
+|---|---|---|
+| Start On Click / With Previous / After Previous, duration, delay | yes | yes |
+| Effect Options (direction, sequence by paragraph) | yes | yes |
+| Effect dialog: sound, after-animation dim/hide, animate text by word/letter, smooth start/end, bounce end, repeat, rewind | yes | partly; rewind lost on PPTX save (#77) |
+| By-paragraph text builds, sub-bullets follow parents | yes | yes |
+| Triggers (on click of a shape) | yes | yes |
+| Triggers on a media bookmark | yes | no |
+| Animation Painter | yes | yes (#54) |
+| Animation Pane: list, reorder, remove | yes | yes |
+| Animation Pane: advanced timeline (bars you drag) | yes | **no** |
+| Preview in the editor (current effect, from selected) | yes | partly |
+| Motion path editing (edit points, reverse, lock) | yes | partly (no edit points) |
+| Multiple animations on one object | yes | yes |
+| Round trip of the timing tree | yes | flattened to the pane list on read, rebuilt on write (`every_animation_effect_survives`) |
+
+## Estimates
+
+| Work | Hours |
+|---|---|
+| Animation Pane timeline, preview from selected, effect dialog depth | 5–8 |
+| The remaining ~126 effects (most are parameter variations of existing ones) | 3–6 |
+| Rewind and other effect options on round trip (#77) | 1–2 |
+| Transition sounds | 1–2 |
+| Morph across pictures, `!!` names, align once per transition (#67) | 2–4 |
+| Reference captures from PowerPoint for the 3-D transitions, then tuning | 2–4 |
+| **Total** | **~14–26** (the Transitions and Animations rows of the feature table; part of the Features dimension's 140–240 h) |
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | major | Created: 48/48 transitions, 64 of ~190 animation effects, pane and option depth, estimates |
@@ -0,0 +1,77 @@
+# DeckCraft architecture
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** major (created from the code on main at d556ff9; AGENTS.md §4 keeps the rules) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+How DeckCraft is built today. The binding rules (layering, everything is a command, thin UI, never
+break wasm, never crash) are in [AGENTS.md](../AGENTS.md) §3–§5; this document describes what
+exists. 117k lines of Rust in 23 crates, 3 apps and `xtask`; 504 `#[test]` functions
+(`cargo xtask stats` counts them per crate).
+
+## Layers
+
+`cargo xtask layers` enforces that a crate depends only on lower layers (the table in
+`xtask/src/layers.rs`, which is authoritative; AGENTS.md §4 gives the simplified picture), and that
+nothing below L6 uses egui, eframe, winit or rfd.
+
+| Layer | Crates | What they do |
+|---|---|---|
+| L0 | `geom`, `color`; standalone `bitstream`, `matroska`, `ogg`, `opus` | EMU/pt units, transforms, ~150 preset shape generators re-derived from ECMA-376, adjust handles, hit testing; RGB/HSL and DrawingML colour transforms; MKV/WebM and Ogg demuxers, the Opus decoder |
+| L1 | `model`, `fonts`; `h264`, `hevc`, `vp9`, `av1`, `isobmff` | Presentation, masters, layouts, slides, shapes, text, themes, tables, charts, transitions, animations, placeholder inheritance (`resolve`); font database (craft-fonts + system) with metric-compatible substitutes for Office fonts (Carlito for Calibri, Caladea for Cambria, Liberation for Arial/Times); video decoders and the MP4/MOV demuxer |
+| L2 | `text`, `anim`, `format`, `media` | Shaping (HarfRust), UAX #9 bidi, UAX #14 line breaking, autofit, caret hit testing; per-shape animation state over time, the show state machine, transition frame layouts, Morph matching; `.deckcraft` (zip + JSON + media) and outline text; media probing, decoding, mixer and clock |
+| L3 | `render`, `pptx` | `vello_cpu` raster of slides, masters and layouts (fills, outlines, effects, pictures, tables, charts, Morph frames); PPTX import/export from ECMA-376 |
+| L4 | `pdf` | PDF export through krilla |
+| L5 | `engine` | Sessions, documents, selection, undo history on shared slide snapshots, the command registry (226 commands in `cmd/*`), pointer tools, keys, AutoRecover, the panic guard (`guard.rs`) |
+| L6 | `ui-egui`, `mcp` | The PowerPoint-style interface (ribbon with 10 tabs + contextual tabs, canvas, thumbnails, panes, 27 dialogs, show and presenter windows, the JSON control channel); the MCP server (JSON-RPC 2.0 over stdio), headless or connected to a running app |
+| apps | `deckcraft` (desktop: eframe/wgpu, cpal audio, logging), `deckcraft-cli` (run, render, convert, mcp, app), `deckcraft-web` (trunk; WebGPU with WebGL2 fallback), `xtask` | Exempt from layering |
+
+The media codecs and containers are clean-room pure Rust, 59k lines, shared in spirit with
+FilmCraft.
+
+## Data model
+
+A `Presentation` holds a theme set, slide masters with their layouts, slides, sections, custom
+shows, comments, media and document properties. Shapes are a tree (`ShapeKind`: preset or custom
+geometry, picture, table, chart, group, connector, ink, media, SmartArt-as-group, and `Opaque` for
+anything read from PPTX that DeckCraft doesn't model: its XML is kept and written back). Text
+bodies hold paragraphs of runs with DrawingML properties; formatting resolves slide → layout →
+master → theme at render time. Transitions live on slides; animations are the flat ordered list the
+Animation Pane shows, rebuilt into PowerPoint's timing tree on save.
+
+## Commands and frontends
+
+Every user-visible action is a `CommandSpec` (id, label, ribbon/menu place, shortcut, params doc,
+`enabled`, `run`) in `crates/engine/src/cmd/*`. The UI, `deckcraft-cli run`, the JSON control
+channel (`deckcraft --control PORT`, [control-protocol.md](control-protocol.md)) and MCP
+([mcp.md](mcp.md)) all dispatch through `Session::execute`, so they behave identically.
+Programmatic calls never open dialogs. Pointer gestures go through `Session::pointer`, keys through
+`Session::key`.
+
+## Rendering and the show
+
+The renderer draws a slide to an RGBA pixmap on the CPU; the UI uploads it as an egui texture.
+Transitions are layers of textured quads over the old and new slide images (fake 3-D from
+trapezoids). The show window and the presenter view are egui viewports; animation state per shape
+comes from `anim::timeline` each frame. PDF export renders each slide at print resolution and
+overlays an invisible real-text layer with embedded font subsets.
+
+## File I/O
+
+- **PPTX** (`crates/pptx`): lenient reader (unknown parts skipped, malformed parts logged and
+  ignored, sizes and depths bounded, zip bombs capped), writer that PowerPoint opens without
+  repair. Unknown elements round-trip through `Opaque` and `raw_ext` fields.
+- **Native** (`crates/format`): zip with `mimetype`, `presentation.json` and `media/<id>`; readers
+  ignore unknown fields; `.slidecraft` files from before the rename still open.
+- Formats and their gaps: [file-format-parity.md](file-format-parity.md).
+
+## Quality gates
+
+`cargo xtask ci`: rustfmt check, clippy `-D warnings`, tests, layering, asset attribution
+(`cargo xtask assets`), wasm32 check. CI runs it on Ubuntu for every PR and push to `main`;
+macOS is built and tested by the release workflow only. Releases (pushes to `release`) build signed
+macOS, Windows, Linux, FreeBSD and web artifacts.
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | major | Created from the code on main (d556ff9) and AGENTS.md §4 |
@@ -0,0 +1,102 @@
+# File-format parity with PowerPoint
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** major (created; formats taken from PowerPoint 16.113.4's Info.plist, PPTX coverage measured from `crates/pptx`) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+Every format PowerPoint reads or writes, DeckCraft's support, fidelity and how it is tested.
+Gaps are itemized in [gaps.md](gaps.md#file-formats). Dimension score: **~58% ready**
+(estimated), **60–110 h** to parity.
+
+Weights inside this dimension: PPTX 70%, PDF export 10%, image export 5%, legacy binary formats
+5%, everything else (templates, shows, macros, ODP, video, GIF, outline) 10%.
+
+## Documents
+
+From `/Applications/Microsoft PowerPoint.app/Contents/Info.plist` `CFBundleDocumentTypes` (Editor =
+PowerPoint opens and saves; Viewer = opens only).
+
+| Format | PowerPoint | DeckCraft read | DeckCraft write | Fidelity / notes | Tested by |
+|---|---|---|---|---|---|
+| `.pptx` presentation | Editor | yes | yes | Broad (see below); never measured on real decks | `crates/pptx/tests/roundtrip.rs`, `sample.rs`, `malformed.rs`, `sniff.rs` (30 tests); opened in PowerPoint by hand 2026-10-06 |
+| `.potx` template | Editor | yes (as a presentation) | no: written with the `.pptx` content type | `file.saveTemplate` is Save As under another name | none |
+| `.ppsx` slide show | Editor | yes (as a presentation) | no: written as `.pptx` content | Doesn't start in show mode | none |
+| `.pptm` / `.potm` / `.ppsm` macro-enabled | Editor | no | no | Should open and keep `vbaProject.bin` without running it | none |
+| `.ppt` / `.pot` / `.pps` 97–2003 binary | Editor | no | no | Owner decision; import only would be enough | none |
+| `.odp` OpenDocument | Editor | no | no | | none |
+| `.thmx` Office theme | Viewer | no | no | Browse for themes is a P2 row | none |
+| `.deckcraft` native (zip + JSON) | n/a | yes (also `.slidecraft`) | yes | Lossless for the DeckCraft model, forward compatible | `crates/format` tests |
+| PDF | export | no | yes | Slides, notes pages, handouts (1–9); real-text layer with embedded subsets, links, bookmarks. Slide artwork is a raster image at print resolution, not vector | `crates/pdf` tests |
+| Outline `.rtf` / `.txt` | export (RTF), import (outline) | `.txt`/`.md` outline (`slide.fromOutline`) | `.txt` outline | No RTF | engine tests |
+| PNG / JPEG slide images | export | n/a | yes (`file.export`, `deckcraft-cli render`) | Matches the editor's renderer | render tests |
+| TIFF / BMP / GIF slide images | export | n/a | no | Easy (the `image` crate writes them) | none |
+| Animated GIF of the deck | export | n/a | no | | none |
+| MP4 / MOV video of the deck | export | n/a | no | Needs timeline render + H.264 encode | none |
+| Print | yes | n/a | no | PR #66 (browser) open | none |
+
+## Pictures and media inside decks
+
+| Kind | PowerPoint | DeckCraft | Notes |
+|---|---|---|---|
+| PNG, JPEG, GIF (animated), BMP, TIFF, WebP | yes | yes | `image` 0.25; animated GIFs play since #39 |
+| SVG | yes (with PNG fallback) | **no** | The PNG fallback shows; SVG files can't be inserted |
+| EMF / WMF | yes | **no** | Common in decks made on Windows: blank picture |
+| HEIC | yes (macOS) | no | |
+| Audio: MP3, AAC/M4A, ALAC, WAV, AIFF, CAF, FLAC, Ogg Vorbis, Opus | yes (Ogg/Opus partly) | yes | Pure-Rust decoders in `crates/media`, `crates/opus` |
+| WMA | yes (Windows) | embedded, not playable | |
+| Video: H.264, HEVC in MP4/MOV | yes | yes | Pure-Rust, software decode |
+| Video: VP9, AV1 in WebM/MKV | partly (OS codecs) | yes | Ahead of PowerPoint for Mac |
+| WMV | yes (Windows) | embedded, not playable | |
+| Online video (YouTube embeds) | yes | no | Cloud feature |
+| Embedded OLE objects | yes | kept on round trip (opaque), not insertable or editable | `ShapeKind::Opaque` |
+| 3-D models (`.glb`) | yes | no | |
+| Embedded fonts | yes | no | `p:embeddedFontLst` ignored |
+
+## PPTX coverage (PresentationML / DrawingML)
+
+What `crates/pptx` reads and writes, from ECMA-376. "Kept" means the XML is preserved untouched for
+the round trip even though DeckCraft doesn't model it.
+
+| Part / feature | Read | Write | Notes |
+|---|---|---|---|
+| OPC package, content types, relationships | yes | yes | Content types found anywhere in the zip (#19); zip bombs capped; relationship cycles bounded |
+| Presentation, slide size, sections (p14), custom shows | yes | yes | |
+| Slide masters, layouts, placeholders and inheritance | yes | yes | |
+| Themes: colour, font (Latin/EA/CS), effect schemes, background styles | yes | yes | Unknown theme parts kept |
+| Notes slides and notes master | yes | yes | No notes-master editing view |
+| Handout master | no | no | |
+| Shapes: preset geometry (~150 presets), custom geometry, groups, connectors | yes | yes | Presets re-derived in `crates/geom/src/preset.rs` |
+| Fills: solid, gradient, picture (stretch/tile/crop), pattern, group | yes | yes | |
+| Lines: dash, compound, caps, joins, arrowheads | yes | yes | |
+| Effects: shadow, glow, soft edges, reflection | yes | yes | |
+| 3-D: `scene3d`, `sp3d` | kept | kept | Not rendered |
+| Text: runs, paragraphs, bullets, numbering, levels, autofit, columns, vertical, RTL, script fonts, fields, hyperlinks | yes | yes | Round-trip tests incl. `justLow` and date fields |
+| Text warp (`prstTxWarp`) | yes | yes | Not rendered |
+| Pictures with crop, recolour, duotone, alpha, luminance | yes | yes | |
+| Tables with styles | yes | yes | |
+| Charts (`c:chartSpace`) | yes | yes | Original XML kept in `Chart.raw` |
+| Charts (`cx:` chartex: waterfall, funnel, treemap, sunburst, histogram, box) | no | no | |
+| SmartArt (`dgm`) | drawing part only, as a group | as shapes | Diagram data model lost on save |
+| Equations (OMML, `a14:m`) | no | no | PR #55 open |
+| Audio / video (`p14:media`, trim, fades, bookmarks) | yes | partly | Playback options lost on save (#74) |
+| Ink (`contentPart`) | yes | as a group of freeform lines | PowerPoint sees shapes, not ink |
+| Transitions incl. p14/p15 (Vortex, Morph…) | all 48 | all 48 | `every_transition_kind_round_trips` |
+| Animations: timing tree, build paragraphs, triggers, motion paths | yes (flattened to the Animation Pane list) | yes (rebuilt) | `every_animation_effect_survives`; rewind lost (#77) |
+| Comments: legacy | yes | yes | |
+| Comments: modern threaded (`p188`) | yes | no (written as legacy) | Replies and resolved state lost (#70) |
+| Unknown slide-level elements (`graphicFrame` OLE, extensions, `mc:AlternateContent`) | kept | kept | Rendered as a labelled placeholder with the preview picture when present |
+| Tags, custom XML, VBA | no / no / no | | |
+| Embedded fonts | no | no | |
+| Encryption (password to open) | no | no | |
+
+### What would move the PPTX number
+
+1. An owned corpus of real-world-shaped decks (corporate templates, SmartArt, chartex charts, EMF,
+   embedded fonts, every transition and animation) in a corpus repo, with import → render → export
+   → re-import checks in CI and a PowerPoint reference render for each (owner runs PowerPoint).
+2. The round-trip losses above (#70, #74, #77).
+3. EMF/WMF and SVG rendering.
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | major | Created from PowerPoint 16.113.4's `CFBundleDocumentTypes`, `crates/pptx` reader/writer and tests, and the open round-trip issues |
@@ -0,0 +1,251 @@
+# Where DeckCraft falls short of PowerPoint
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** minor (core-workflow alpha gate added; stage stays alpha; previous: major, first itemized gap list; full re-measure against PowerPoint for Mac 16.113.4 and the open GitHub issues) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+Every known shortfall, one entry each, ranked by how much it stops someone who presents with
+PowerPoint from switching. This is the work list: pick from the top. Numbers are summarized in
+[target-app-parity.md](target-app-parity.md); the feature-by-feature scores are in
+[parity-checklist.md](parity-checklist.md). Hours are Opus 5.5 agent wall-clock hours including
+tests (calibration in [target-app-parity.md](target-app-parity.md#calibration-how-the-hours-were-derived)).
+`B` marks a gap that blocks **beta**. None blocks **alpha**: all six core workflows pass the
+[alpha gate](roadmap.md#alpha-gate-powerpoints-core-workflows).
+
+When a gap closes, delete its entry, update the parity doc it points to, and add a line to the
+revision history.
+
+## Ranked: the top 15
+
+| # | Gap | Category | Beta | Hours | Doc |
+|---|---|---|:-:|---|---|
+| 1 | PPTX never tested against a corpus of real decks | File format | B | 20–35 | [file-format-parity.md](file-format-parity.md) |
+| 2 | Data loss and crashes on common paths (#60, #40, #59) | Stability | B | 6–12 | this file |
+| 3 | PPTX round trip drops comment threads, media options, rewind (#70, #74, #77) | File format | B | 3–6 | [file-format-parity.md](file-format-parity.md) |
+| 4 | EMF/WMF and SVG pictures don't render | File format | B | 8–14 | [file-format-parity.md](file-format-parity.md) |
+| 5 | No localization: English only | Localization | B (infra + 5 languages) | 55–90 | [localization-parity.md](localization-parity.md) |
+| 6 | No printing | Feature | B | 5–8 | [file-format-parity.md](file-format-parity.md) |
+| 7 | Fonts: only Regular, Bold and Italic faces (#69) | Feature | B | 3–5 | [ui-parity.md](ui-parity.md) |
+| 8 | Image paste fails on Windows and Linux (#53) | Feature | B | 2–4 | [ui-parity.md](ui-parity.md) |
+| 9 | Presenter view isn't placed on the second display | Hardware | B | 3–5 | [slideshow-parity.md](slideshow-parity.md) |
+| 10 | Animation Pane: no timeline, thin preview; 64 of ~190 effects | Feature | B (pane) | 10–16 | [animation-parity.md](animation-parity.md) |
+| 11 | Charts: data grid editing, elements, `chartex` types | Feature | B (data, elements) | 12–20 | [parity-checklist.md](parity-checklist.md) |
+| 12 | Format Shape pane thinner than PowerPoint's | UI/UX | B | 6–10 | [ui-parity.md](ui-parity.md) |
+| 13 | No native macOS menu bar | UI/UX | B | 3–5 | [ui-parity.md](ui-parity.md) |
+| 14 | PDF export rasterizes slide artwork | File format | B | 5–8 | [file-format-parity.md](file-format-parity.md) |
+| 15 | Slides rasterize on the CPU; no performance baseline | Performance / hardware | | 15–30 | [hardware-parity.md](hardware-parity.md) |
+
+## Stability
+
+### Close discards an edited presentation without asking (#60)
+- **Evidence:** issue #60; quitting prompts, `file.close` doesn't. PR #75 is open.
+- **Impact:** silent data loss on a common path. The worst kind of bug for a presentation app.
+- **Estimate:** 0.5–1 h (land and test #75). **Beta blocker.**
+
+### Startup crashes on some Windows GPUs (#40, #59)
+- **Evidence:** #59 (Intel UHD, access violation in `igvk64.dll` during Vulkan enumeration), #40
+  (WordCraft, GridCraft and DeckCraft all fail on one Windows 11 PC). The DX12 default (#16) fixed
+  AMD's `atio6axx.dll` crash only.
+- **Impact:** the app never opens for those users.
+- **Estimate:** 4–8 h (backend probing outside the process or a safe-mode fallback, a software
+  renderer path). Needs a tester with the hardware. **Beta blocker.**
+
+### No soak or long-session testing
+- **Evidence:** unit tests (504), PPTX malformed/fuzz tests and the command panic guard exist; no
+  random command sequences over big decks, no memory or undo-depth soak.
+- **Impact:** unknown crash and slowdown rate in long sessions.
+- **Estimate:** 4–8 h.
+
+## File formats
+
+Detail in [file-format-parity.md](file-format-parity.md).
+
+### PPTX has never met a corpus of real decks
+- **Evidence:** every PPTX test (`crates/pptx/tests`, 30 tests) uses decks DeckCraft generates;
+  the 2026-10-07 alpha checklist already listed this as open. No reference renders from PowerPoint
+  exist to compare against.
+- **Impact:** the main reason to switch is "open my PowerPoint decks". Fidelity on real decks
+  (corporate templates, SmartArt, `chartex` charts, embedded fonts, EMF) is unknown.
+- **Estimate:** 20–35 h: build an owned corpus in `storytold/photocraft-corpus` style (craftrules
+  `standards/test-corpora.md`), add import → render → export → re-import checks, have the owner open
+  outputs in PowerPoint, fix what breaks. **Beta blocker.**
+
+### Round trip loses comment threads, media playback options and animation rewind (#70, #74, #77)
+- **Evidence:** issues filed 2026-10-10 by an automated reviewer; the writer emits legacy comments
+  only (no `p188` modern comments with replies and resolved state, though the reader understands
+  them); media playback options and the animation rewind flag aren't written back.
+- **Impact:** a deck opened and saved silently loses review state and show behaviour.
+- **Estimate:** 3–6 h. **Beta blocker.**
+
+### EMF/WMF and SVG pictures don't render
+- **Evidence:** `crates/render/src/images.rs` decodes through `image` 0.25 (PNG, JPEG, WebP, GIF,
+  TIFF, BMP); nothing reads EMF, WMF or SVG. Decks from Windows often hold EMF (pasted charts,
+  Visio, logos); PowerPoint's Insert Icons stores SVG with a PNG fallback.
+- **Impact:** blank pictures in real decks; SVG icons show only their raster fallback, and SVG files
+  can't be inserted.
+- **Estimate:** 8–14 h (an SVG renderer through `resvg`-style crates, an EMF/WMF record player for
+  the common records). **Beta blocker** for EMF.
+
+### Template, slide-show and macro variants are saved as plain `.pptx`
+- **Evidence:** `crates/pptx/src/write/mod.rs` always writes the
+  `presentationml.presentation.main+xml` content type; `.potx`/`.ppsx` open, `.pptm`/`.potm`/`.ppsm`
+  aren't recognised.
+- **Impact:** a template saved as `.potx` isn't a template to PowerPoint; macro decks can't be
+  opened even to view.
+- **Estimate:** 2–4 h (content types; keep `vbaProject.bin` untouched without running it).
+
+### No legacy `.ppt`/`.pot`/`.pps` import
+- **Evidence:** PowerPoint for Mac still opens and saves the 97–2003 binary formats
+  (`CFBundleDocumentTypes`); DeckCraft doesn't read them.
+- **Impact:** archives of older decks don't open.
+- **Estimate:** 20–35 h (import only, from the public [MS-PPT] spec). Owner decision whether it's
+  worth it.
+
+### No OpenDocument `.odp`
+- **Evidence:** PowerPoint opens and saves `.odp`.
+- **Impact:** LibreOffice users and public-sector exchange.
+- **Estimate:** 12–20 h (read and write the common subset).
+
+### PDF export rasterizes slide artwork
+- **Evidence:** `crates/pdf` places each slide as an image under a selectable text layer, links and
+  bookmarks.
+- **Impact:** large PDFs; blurry when zoomed or printed.
+- **Estimate:** 5–8 h (vector paths, fills and text through the PDF writer). **Beta blocker.**
+
+### No printing
+- **Evidence:** checklist row "Print" is missing; PR #66 (browser print) is open.
+- **Impact:** handouts and speaker notes are printed in many workplaces.
+- **Estimate:** 5–8 h (print through the PDF path and each OS's print dialog). **Beta blocker.**
+
+### No video or animated GIF export
+- **Evidence:** checklist row missing; PowerPoint exports MP4/MOV and animated GIF.
+- **Impact:** sharing a talk as a video is a common request.
+- **Estimate:** 10–16 h (render the timeline frame by frame; an H.264 encoder is the hard part,
+  FilmCraft has one to copy).
+
+### Embedded fonts aren't read or written
+- **Evidence:** no `p:embeddedFontLst` handling in `crates/pptx`.
+- **Impact:** decks that rely on embedded fonts reflow.
+- **Estimate:** 3–5 h.
+
+## Features
+
+### Font weights beyond Regular, Bold and Italic (#69)
+- **Evidence:** #69; the font database maps a family to four faces.
+- **Impact:** Light, Medium and Semibold headings (common in modern templates) render wrong.
+- **Estimate:** 3–5 h. **Beta blocker.**
+
+### Image paste fails on Windows and Linux (#53)
+- **Evidence:** #53 (v0.3.0, Fedora AppImage and Windows).
+- **Impact:** copy-paste of screenshots is a core workflow.
+- **Estimate:** 2–4 h. **Beta blocker.**
+
+### Tab inside a text box ends text entry (#78)
+- **Evidence:** #78.
+- **Impact:** tab stops and indented lists can't be typed.
+- **Estimate:** 1–2 h.
+
+### Charts: data grid, elements and the newer chart types
+- **Evidence:** checklist rows "Edit chart data" (P0, partial), "Chart elements" (partial), "Other
+  chart types" (partial); `chartex` parts (waterfall, funnel, treemap, sunburst, histogram, box &
+  whisker) aren't read.
+- **Impact:** most business decks have charts; editing their data is routine.
+- **Estimate:** 12–20 h. Data and elements are **beta blockers** (6–10 h).
+
+### SmartArt is pre-drawn shapes only
+- **Evidence:** `crates/pptx/src/read/shapes.rs` reads SmartArt's drawing part as a group; no text
+  pane, no layout switching, the diagram data isn't regenerated.
+- **Impact:** editing a SmartArt diagram from PowerPoint breaks it.
+- **Estimate:** 10–16 h.
+
+### Animation Pane, effect count and preview
+Detail in [animation-parity.md](animation-parity.md). 10–16 h; the pane is a **beta blocker**.
+
+### Notes and Handout masters
+- **Evidence:** checklist row missing; PPTX writes a notes master but there's no view to edit it,
+  and no handout master at all.
+- **Estimate:** 4–6 h.
+
+### Edit points, text warp, 3-D
+- **Evidence:** checklist rows "Edit points" (P1 missing), "Text warp transforms", "Bevel and 3-D
+  rotation" (missing; `scene3d`/`sp3d` kept as raw XML on round trip).
+- **Estimate:** 4–6 h (edit points), 6–10 h (warp), 8–12 h (3-D render approximation).
+
+### Proofing: spelling, thesaurus, AutoCorrect
+- **Evidence:** `review.spelling` checks a small built-in list of frequent misspellings
+  (`crates/engine/src/cmd/review.rs`); no dictionaries, no thesaurus, no AutoCorrect.
+- **Estimate:** 8–14 h (Hunspell-format dictionaries under an open licence per language).
+
+### Equations
+- **Evidence:** checklist row missing; PR #55 (OMML editor, +10.5k lines) is open.
+- **Estimate:** 3–6 h to review, land and round-trip.
+
+### Smaller missing rows
+Zoom (summary/section/slide, 6–10 h), reuse slides (2–4 h), laser pointer (1–2 h), transition
+sounds (1–2 h), artistic effects (6–10 h), remove background (6–10 h; needs a model or a classical
+matte), compress pictures (2–3 h), insert screenshot (2–3 h), record audio/screen and record slide
+show (8–12 h), compare presentations (6–10 h), password protection (4–6 h, ECMA-376 agile
+encryption), ink to shape/text (6–10 h), icons and 3-D models (8–14 h, needs an open icon set).
+
+## UI/UX
+
+Detail in [ui-parity.md](ui-parity.md).
+
+- **No native macOS menu bar.** `menus::menu_tree()` exists but nothing installs it. 3–5 h. **Beta
+  blocker.**
+- **Format Shape pane thinner than PowerPoint's** (Fill/Line/Effects/Size/Text Box pages, picture
+  and texture options, 3-D). 6–10 h. **Beta blocker.**
+- **First-run and start screen** (#17, #76: missing File overlay, broken layout; recent files and
+  templates thin). 3–5 h.
+- **Window chrome** (#71 macOS controls misaligned, #26 GNOME title bar, #41 system light/dark).
+  2–4 h.
+- **Icon consistency across Craft apps** (#73, #56). 2–4 h; coordinate in craftrules.
+- **Dialogs**: 27 dialogs vs PowerPoint's ~60 (Font, Bullets and Numbering, Find/Replace dialog,
+  Replace Fonts, Action Settings, Print, Insert Object…). 8–14 h.
+- **Command palette defaults to an Export entry that fails** (#79). 0.5 h.
+
+## Hardware
+
+Detail in [hardware-parity.md](hardware-parity.md).
+
+- **Presenter view isn't placed on the second display**; the show doesn't pick the projector. 3–5 h.
+  **Beta blocker.**
+- **CPU slide rasterization** (`vello_cpu`); PowerPoint renders on the GPU. 12–20 h (vello hybrid
+  or wgpu path).
+- **Software-only video decode**; PowerPoint uses VideoToolbox/Media Foundation. 8–14 h (copy
+  FilmCraft's hardware decode).
+- **No pen pressure or tilt for ink**; no pinch-zoom or trackpad gestures. 3–6 h.
+
+## Localization
+
+Detail in [localization-parity.md](localization-parity.md).
+
+- **English only, no string catalog** (#15, #30; Ukrainian PR #34 open). PowerPoint for Mac ships
+  26 languages. Infrastructure 8–14 h, then 3–16 h per language plus native review. Beta needs the
+  infrastructure and at least Simplified Chinese, Spanish, French, German and Japanese (~30–45 h).
+- **No IME composition in text editing** (CJK input). 3–6 h.
+- **UI isn't mirrored for right-to-left languages.** 6–10 h.
+- **Browser build draws Arabic and Hebrew as missing-glyph boxes in exports** (#81). 1–2 h.
+
+## Performance
+
+- **No baseline.** Nothing measures open time, render time per slide, show frame rate or memory
+  against PowerPoint. 4–8 h for a benchmark suite in `xtask`.
+- **Morph aligns outlines every frame** (#67, PR open). 1 h.
+
+## Ecosystem
+
+- **8 original themes, no template gallery.** PowerPoint offers dozens of designs online and
+  offline. 8–14 h for a larger original set (asset policy: our own designs only).
+- **No add-ins or VBA.** Out of scope by policy; MCP/CLI automation is the alternative.
+
+## AI features
+
+- **No Designer, Copilot, Speaker Coach, live subtitles or Translate.** All are Microsoft cloud
+  services; an offline rule-based Designer is in the catalogue (P2). Local models (speech-to-text
+  for subtitles, translation) need an owner decision on licensed models. 20–40 h.
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | minor | Noted that no gap blocks alpha (core-workflow gate passes) |
+| 2026-10-10 | major | Created: every gap from the 2026-10-10 re-measure and the 16 open GitHub issues, ranked, with beta blockers marked |
@@ -0,0 +1,74 @@
+# Hardware parity with PowerPoint
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** major (created from the renderer, media and windowing code) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365); PowerPoint for Windows where noted
+
+What hardware PowerPoint uses and what DeckCraft uses, per platform. Dimension score: **~40%
+ready** (estimated), **25–45 h** to parity. Performance (unmeasured, ~55%) is tracked here too
+because it mostly follows from hardware use.
+
+## Graphics and rendering
+
+| Feature | PowerPoint | DeckCraft macOS | DeckCraft Windows | DeckCraft Linux/BSD | DeckCraft web |
+|---|---|---|---|---|---|
+| Window compositing on the GPU | Metal / DirectX | wgpu (Metal) | wgpu, DX12 only by default (#16) | wgpu (Vulkan, GL) | WebGPU, WebGL2 fallback |
+| Slide rasterization | GPU | **CPU** (`vello_cpu`) | CPU | CPU | CPU (wasm) |
+| Transitions and Morph frames | GPU | CPU-rendered slide images composited as textured quads on the GPU | same | same | same |
+| High-DPI / Retina | yes | yes | yes | yes | yes |
+| Wide gamut / HDR display | partly (P3 images) | no (sRGB) | no | no | no |
+| Startup on all GPUs | yes | yes | **no**: crashes in some Intel/AMD drivers (#40, #59) | not reported | n/a |
+| Software fallback when no GPU | yes (WARP on Windows) | no | no | no | no |
+
+## Media
+
+| Feature | PowerPoint | DeckCraft |
+|---|---|---|
+| Video decode | Hardware (AVFoundation/VideoToolbox, Media Foundation) | Software only: pure-Rust H.264, HEVC, VP9, AV1 (`crates/h264`, `hevc`, `vp9`, `av1`) |
+| 4K video in the show | smooth on hardware decode | unmeasured; likely CPU-bound |
+| Audio output | Core Audio / WASAPI | `cpal` (Core Audio, WASAPI, ALSA); browser Web Audio |
+| Microphone (record audio, narration) | yes | no |
+| Camera (Cameo, record with camera) | yes | no |
+| Screen recording | yes | no |
+
+## Displays
+
+| Feature | PowerPoint | DeckCraft |
+|---|---|---|
+| Detect the projector, show on it, presenter view on the laptop | yes | **no**: the show goes full screen on the current display; presenter view opens as a normal window (egui viewport) |
+| Swap displays, choose the monitor in Set Up Show | yes | no |
+| Mirroring-aware behaviour | yes | no |
+
+## Input devices
+
+| Feature | PowerPoint | DeckCraft |
+|---|---|---|
+| Keyboard and presentation clickers (Page Up/Down, B, Esc) | yes | yes |
+| Mouse and trackpad scroll | yes | yes |
+| Pinch to zoom, two-finger gestures | yes | no |
+| Pen pressure and tilt for ink (Apple Pencil via Sidecar, Windows Ink) | yes | no: ink strokes have constant width |
+| Touch screens (Windows) | yes | basic pointer only |
+| IME input methods for CJK text | yes | no (see [localization-parity.md](localization-parity.md)) |
+| Dictation | yes (macOS) | no |
+
+## Performance
+
+Nothing is measured against PowerPoint yet: no benchmark of open time, render time per slide,
+show frame rate or memory exists in `xtask`. Known: slides rasterize on the CPU, Morph aligns
+outlines every frame (#67, fix open), and the decoders run in software.
+
+## Estimates
+
+| Work | Hours |
+|---|---|
+| Presenter view on the right display, choose monitor, swap | 3–5 |
+| GPU slide rasterization (vello's GPU/hybrid path) | 12–20 |
+| Hardware video decode (copy FilmCraft's VideoToolbox / Media Foundation / VA-API paths) | 8–14 |
+| Windows GPU startup robustness: backend probing, software fallback (#40, #59) | 4–8 (counted under Stability) |
+| Pen pressure, pinch zoom | 3–6 |
+| Benchmark suite (`cargo xtask bench`) and a first performance pass | 6–12 (Performance dimension) |
+| **Hardware total** | **~26–45** |
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | major | Created: rendering, media, displays, input and performance against PowerPoint 16.113 |
@@ -0,0 +1,59 @@
+# Localization parity with PowerPoint
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** major (created; string count measured from source, PowerPoint's localizations read from its bundle) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+DeckCraft's interface is English only today: strings are literals in the UI and engine code, with
+no catalog and no language switch. Requests: #15 (follow the system language), #30 and PR #34
+(Ukrainian, open). Dimension score: **~8% ready** (estimated: English complete, slide-text script
+support partly there), **55–90 h** to parity plus native-speaker review.
+
+## How the numbers are measured
+
+- **UI strings:** ~1,050 user-visible string literals (measured 2026-10-10: distinct
+  capitalized literals in `crates/ui-egui/src`, `crates/engine/src/cmd` and `crates/model/src`,
+  including the 226 command labels). A catalog will refine the count; until then percentages are
+  against this figure.
+- **Script support** is about slide text (what users type and import), separately from the UI:
+  bidi and shaping live in `crates/text` (UAX #9, HarfRust, UAX #14 line breaking).
+- **PowerPoint's languages:** `Contents/Resources/*.lproj` in PowerPoint 16.113.4: ar, cs, da, de,
+  el, en, en_GB, es, es_MX, fi, fr, fr_CA, he, hu, id, it, ja, ko, nl, no, pl, pt (Brazil), pt_PT,
+  ru, sk, sv, th, tr, zh_CN, zh_TW (26 languages). PowerPoint for **Mac** has no Hindi or Vietnamese
+  UI; PowerPoint for Windows has both.
+
+## The twelve key languages
+
+| Language | Code | UI strings translated | Dialogs / tooltips / help | Script support (slide text) | Native review | Status | PowerPoint for Mac UI | Hours to full |
+|---|---|---|---|---|---|---|---|---|
+| English | en | ~1,050 / ~1,050 (100%) | yes / yes / no help | full | yes | **full** | yes | 0 |
+| Simplified Chinese (Mandarin) | zh-Hans | 0 (0%) | no | renders with system CJK fonts (asset policy excludes Noto CJK from builds); UAX #14 breaking; **no IME composition**; no true vertical layout | no | none | yes | 6–10 (incl. IME) |
+| Spanish | es | 0 (0%) | no | full (Latin) | no | none | yes (es, es-MX) | 3–5 |
+| Hindi | hi | 0 (0%) | no | Devanagari shaping through HarfRust, untested; no bundled Devanagari font | no | none | **no** (Windows only) | 4–7 |
+| Arabic | ar | 0 (0%) | no | bidi, contextual shaping, kashida justification, RTL bullets and caret (#4); **UI not mirrored**; browser export shows boxes (#81) | no | none | yes | 10–16 (incl. UI mirroring) |
+| French | fr | 0 (0%) | no | full (Latin) | no | none | yes (fr, fr-CA) | 3–5 |
+| Portuguese | pt | 0 (0%) | no | full (Latin) | no | none | yes (pt-BR, pt-PT) | 3–5 |
+| Indonesian | id | 0 (0%) | no | full (Latin) | no | none | yes | 3–5 |
+| Japanese | ja | 0 (0%) | no | renders with system or craft-fonts Japanese faces; no IME composition; vertical text is rotated, not laid out vertically | no | none | yes | 4–7 |
+| German | de | 0 (0%) | no | full (Latin) | no | none | yes | 3–5 |
+| Korean | ko | 0 (0%) | no | system Hangul fonts; no IME composition | no | none | yes | 4–7 |
+| Vietnamese | vi | 0 (0%) | no | stacked diacritics through HarfRust | no | none | **no** (Windows only) | 3–5 |
+
+Other languages shipped: **0** (Ukrainian is in review as PR #34). PowerPoint for Mac ships 16 more
+than the twelve above: Czech, Danish, Greek, Finnish, Hebrew, Hungarian, Italian, Dutch, Norwegian,
+Polish, Russian, Slovak, Swedish, Thai, Turkish and Traditional Chinese.
+
+Per-language hours assume the infrastructure exists: **8–14 h** once for a string catalog (copy a
+sibling app's approach, e.g. EffectCraft's menu and panel catalogs), a language setting that follows
+the system (#15), plural and number formatting, and an `xtask` check that every key has a
+translation. IME composition (3–6 h) is counted once, under Simplified Chinese.
+
+## Proofing languages
+
+PowerPoint checks spelling in dozens of languages and lets each run carry a proofing language.
+DeckCraft keeps `a:rPr/@lang` on round trip but its spelling check is a small English list of
+common misspellings (`crates/engine/src/cmd/review.rs`); see [gaps.md](gaps.md#proofing-spelling-thesaurus-autocorrect).
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | major | Created: twelve-language table, ~1,050 UI strings measured, PowerPoint for Mac's 26 languages from its bundle |
@@ -1,41 +1,33 @@
-# Feature parity with PowerPoint
+# PowerPoint feature checklist

-The summary is generated by `cargo xtask parity` from the table at the bottom of this file (edit a
-row, re-run). Rows come from the black-box feature catalogue of PowerPoint for Mac (menus, ribbon
-tabs, dialogs and panes observed in the running app — no Microsoft code, documentation assets or
-images were copied).
+> **Generated:** 2026-10-10 (summary by `cargo xtask parity`; rows re-scored 2026-10-10 against PowerPoint for Mac 16.113.4) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)

-Each row is scored **D** (done), **P** (partial: works but lacks options, UI or fidelity) or **M**
-(missing), weighted by priority (**P0** core = 3, **P1** = 2, **P2** = 1). Out of scope: Microsoft
-365 cloud services (co-authoring through OneDrive, Copilot, stock images, Designer's online service,
-Live Presentations), add-ins and VBA macros.
-
-<!-- SUMMARY -->
-**Weighted breadth parity: 80%** over 187 features.
+The summary between `<!-- SUMMARY -->
+**Weighted breadth parity: 79%** over 191 features.

 | Priority | Features | Done | Partial | Missing | Parity |
 |---|---|---|---|---|---|
-| P0 | 72 | 62 | 10 | 0 | 93% |
-| P1 | 65 | 37 | 22 | 6 | 74% |
-| P2 | 50 | 13 | 11 | 26 | 37% |
+| P0 | 72 | 60 | 12 | 0 | 92% |
+| P1 | 65 | 38 | 21 | 6 | 75% |
+| P2 | 54 | 13 | 13 | 28 | 36% |

 | Area | Parity |
 |---|---|
 | Application shell | 71% |
 | Files | 71% |
-| Slides | 95% |
+| Slides | 90% |
 | Views | 90% |
 | Masters & themes | 85% |
 | Shapes | 86% |
 | Format | 81% |
 | Arrange | 100% |
-| Text | 83% |
+| Text | 80% |
 | Tables | 89% |
 | Charts | 65% |
 | SmartArt | 33% |
-| Pictures | 58% |
-| Media | 68% |
-| Transitions | 83% |
+| Pictures | 48% |
+| Media | 67% |
+| Transitions | 92% |
 | Animations | 79% |
 | Slide show | 66% |
 | Review | 60% |
@@ -44,7 +36,7 @@ Live Presentations), add-ins and VBA macros.
 | Automation (✱) | 100% |
 | Platforms (✱) | 67% |

-Open P0 items: Start screen (new, templates/themes, recent), Contextual tabs (Shape Format, Picture Format, Table Design/Layout, Chart Design), Export to PDF (slides, notes pages, handouts; text layer, links, bookmarks; vector artwork pending), Format Shape pane, Edit chart data, Crop (and crop to shape, aspect ratio), Audio/video playback in the show (WMA/WMV not decodable yet), Animation pane (reorder, timing), Presenter view (notes, next slide, timer), macOS, Windows, Linux builds.
+Open P0 items: Start screen (new, templates/themes, recent), Contextual tabs (Shape Format, Picture Format, Table Design/Layout, Chart Design), Export to PDF (slides, notes pages, handouts; text layer, links, bookmarks; vector artwork pending), Format Shape pane, Font, size, bold, italic, underline, strikethrough (only Regular/Bold/Italic faces, #69), Edit chart data, Crop (and crop to shape, aspect ratio), Paste image from clipboard (fails on Windows and Linux, #53), Audio/video playback in the show (WMA/WMV not decodable yet), Animation pane (reorder, timing), Presenter view (notes, next slide, timer), macOS, Windows, Linux builds.

 ## Rows

@@ -65,7 +57,7 @@ Open P0 items: Start screen (new, templates/themes, recent), Contextual tabs (Sh
 | Files | Native file format (open/save) | P0 | D |
 | Files | Open PowerPoint .pptx | P0 | D |
 | Files | Save as PowerPoint .pptx | P0 | D |
-| Files | Open/save .potx/.ppsx/.pptm variants | P2 | M |
+| Files | Open/save .potx/.ppsx/.pptm variants (.potx/.ppsx open; saved with the .pptx content type; no .pptm) | P2 | P |
 | Files | Legacy .ppt (binary) import | P2 | M |
 | Files | Save as template | P1 | D |
 | Files | Autosave and crash recovery | P0 | D |
@@ -78,6 +70,7 @@ Open P0 items: Start screen (new, templates/themes, recent), Contextual tabs (Sh
 | Files | Password protection | P2 | M |
 | Files | Reuse slides from another file | P1 | M |
 | Files | Drag and drop files onto the window | P1 | D |
+| Files | OpenDocument .odp open/save | P2 | M |
 | Slides | New slide by layout | P0 | D |
 | Slides | Duplicate, delete, hide slides | P0 | D |
 | Slides | Reorder slides (thumbnails, sorter) | P0 | D |
@@ -86,6 +79,7 @@ Open P0 items: Start screen (new, templates/themes, recent), Contextual tabs (Sh
 | Slides | Reset slide | P1 | D |
 | Slides | Slides from outline | P2 | D |
 | Slides | Copy/paste slides between decks | P1 | P |
+| Slides | Zoom (summary, section and slide zoom) | P2 | M |
 | Views | Normal view (thumbnails, slide, notes) | P0 | D |
 | Views | Outline view | P1 | D |
 | Views | Slide Sorter | P0 | D |
@@ -145,7 +139,7 @@ Open P0 items: Start screen (new, templates/themes, recent), Contextual tabs (Sh
 | Arrange | Lock shapes | P2 | D |
 | Arrange | Alt text | P1 | D |
 | Text | In-place text editing (caret, selection, mouse, keyboard) | P0 | D |
-| Text | Font, size, bold, italic, underline, strikethrough | P0 | D |
+| Text | Font, size, bold, italic, underline, strikethrough (only Regular/Bold/Italic faces, #69) | P0 | P |
 | Text | Font colour, highlight | P0 | D |
 | Text | Superscript, subscript, caps, character spacing | P1 | D |
 | Text | Change case, grow/shrink font, clear formatting | P1 | D |
@@ -193,18 +187,20 @@ Open P0 items: Start screen (new, templates/themes, recent), Contextual tabs (Sh
 | Pictures | Picture styles and borders | P1 | P |
 | Pictures | Change / reset picture | P1 | D |
 | Pictures | Compress pictures | P2 | M |
-| Pictures | Paste image from clipboard | P0 | D |
+| Pictures | Paste image from clipboard (fails on Windows and Linux, #53) | P0 | P |
+| Pictures | Insert screenshot | P2 | M |
 | Media | Insert audio (any common format) | P0 | D |
 | Media | Insert video | P1 | D |
 | Media | Audio/video playback in the show (WMA/WMV not decodable yet) | P0 | P |
 | Media | Trim, fade in/out, volume, loop, play across slides | P2 | D |
 | Media | Record audio / screen recording | P2 | M |
 | Media | Icons, 3-D models, stock content | P2 | M |
+| Media | Embedded objects (OLE): insert; foreign objects kept on round trip | P2 | P |
 | Transitions | Transition gallery (fade, push, wipe, split, cover, uncover, zoom, morph…) | P0 | D |
 | Transitions | Effect options and duration | P0 | D |
 | Transitions | Advance on click / after time, apply to all | P0 | D |
 | Transitions | Transition sounds | P2 | M |
-| Transitions | Morph | P1 | P |
+| Transitions | Morph | P1 | D |
 | Animations | Entrance, emphasis, exit effects | P0 | D |
 | Animations | Motion paths | P1 | P |
 | Animations | Effect options, start (on click/with/after), duration, delay | P0 | D |
@@ -0,0 +1,113 @@
+# DeckCraft roadmap: milestones and what's next
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** minor (core-workflow alpha gate added; stage stays alpha; previous: major, created; milestones carried from the local execution plan, the beta plan built from gaps.md) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+Forward-looking: where DeckCraft is going and in what order. The one-page summary is
+[ROADMAP.md](../ROADMAP.md); every shortfall is in [gaps.md](gaps.md); numbers are in
+[target-app-parity.md](target-app-parity.md). Hours are Opus 5.5 agent wall-clock hours.
+
+## Alpha gate: PowerPoint's core workflows
+
+What a typical PowerPoint user does every day, checked end to end on macOS, the main platform
+(craftrules `standards/progress-docs.md`, "The core-workflow gate"). Every workflow passes, so
+DeckCraft stays **alpha**. The "partial" rows don't block the workflow, but they are its weakest
+points and lead the beta plan.
+
+| Core workflow | Works end to end? | Evidence | Hours to full pass |
+|---|---|---|---|
+| Build a deck from scratch (theme, layouts, titles and bullets, shapes, pictures from file), save, close and reopen it | yes | Commands for all of it; `.deckcraft` and `.pptx` round-trip tests (`crates/pptx/tests/roundtrip.rs`, `crates/format`); AutoRecover. Close discards edits without asking (#60, PR #75); image *paste* fails on Windows/Linux (#53), though insert-from-file works | 1–3 |
+| Open a colleague's `.pptx`, edit it, save it back as `.pptx` that PowerPoint opens | partial (not blocking) | The reader is lenient and keeps unknown objects. Files open in PowerPoint without repair (checked 2026-10-06). But only generated decks have been tested; EMF/WMF pictures render blank; comment threads, media options and rewind are lost (#70, #74, #77) | 31–55 |
+| Present: full-screen show with transitions, animations, media, presenter view with notes, next slide and timer | yes | 48/48 transitions, 64 effects, triggers, builds, media playback, presenter window. Presenter view isn't placed on the second display automatically (drag it there) | 3–5 |
+| Add business content: tables, charts with their data, simple diagrams | partial (not blocking) | Tables with styles, merge/split, all D or P. Charts insert with the common types and edit data in the Chart Data dialog (P0 partial); SmartArt is basic (pre-drawn shapes) | 12–20 |
+| Share the deck: PDF of slides, notes or handouts; images | yes | `file.export` PDF with text layer, links, bookmarks, handouts 1–9; PNG/JPEG. Artwork is raster in the PDF; no direct print (print the PDF) | 10–16 |
+| Review: comments with replies, resolve, spelling | partial (not blocking) | Comments, replies and resolve work and survive `.deckcraft`; threads are flattened on `.pptx` save (#70); spelling is a small built-in list | 4–8 |
+
+## Current focus (2026-10-10)
+
+1. **Stop losing work and crashing:** land Close's save prompt (#60, PR #75), the Windows GPU
+   startup crashes (#40, #59), image paste on Windows/Linux (#53). 6–12 h.
+2. **PPTX on real decks:** build an owned corpus, round-trip checks in CI, fix what breaks;
+   comment threads, media options and rewind on save (#70, #74, #77); EMF/WMF and SVG. 31–55 h.
+3. **Review the open PRs:** equations (#55), browser print (#66), Morph alignment (#67), macOS
+   open-with (#68), font lookup (#80), Ukrainian (#34, after the catalog exists). 4–8 h.
+
+## Plan to beta (~120–210 h; ~40–70 h wall clock with 3–4 agents)
+
+Beta means ~75% ready for real work and opening and saving PowerPoint's `.pptx` reliably
+(craftrules `standards/progress-docs.md`). Ranked:
+
+| # | Work | Hours | Moves |
+|---|---|---|---|
+| 1 | Stability: #60, #40/#59, soak and fuzz the editor | 10–20 | Stability 60 → 85% |
+| 2 | PPTX real-deck corpus and fixes | 20–35 | File formats 58 → 75% |
+| 3 | PPTX round-trip losses (#70, #74, #77), `.potx`/`.ppsx`/`.pptm` content types, embedded fonts | 8–15 | File formats → 80% |
+| 4 | EMF/WMF and SVG pictures | 8–14 | File formats, Pictures |
+| 5 | Vector PDF, printing | 10–16 | File formats, Files |
+| 6 | Localization infrastructure + zh-Hans, es, fr, de, ja (with IME) | 27–46 | Localization 8 → ~40% |
+| 7 | Font weights (#69), image paste (#53), Tab in text (#78) | 6–11 | Features |
+| 8 | Charts: data grid, elements | 6–10 | Features |
+| 9 | Animation Pane timeline, preview, effect options | 5–8 | Features |
+| 10 | Presenter view on the right display, timer controls | 3–5 | Hardware, Slide show |
+| 11 | Native macOS menu bar, Format Shape pane depth, start screen and window chrome fixes | 13–22 | UI/UX 60 → 75% |
+| 12 | Performance baseline and the obvious fixes | 4–8 | Performance |
+| **Total** | | **~120–210** | Ready ~55% → ~75% |
+
+Parallelizes well: 1 (engine/app), 2–5 (pptx, render, pdf), 6 (ui-egui catalogs), 8–11 (UI)
+touch different crates. Needs a human: the owner opening PPTX outputs in PowerPoint and making
+reference renders, a Windows tester with the affected GPUs, native speakers to review translations.
+
+## After beta: toward full parity (~245–440 h more)
+
+SmartArt editing, chartex chart types, the remaining animation effects and motion paths, Notes and
+Handout masters, edit points, text warp and 3-D, proofing dictionaries, Zoom, recording, video and
+GIF export, legacy `.ppt` import and `.odp` (owner decision), GPU rasterization and hardware video
+decode, the other 21 languages with RTL mirroring, a larger original template gallery, and local AI
+features (owner decision on models). Itemized with hours in [gaps.md](gaps.md).
+
+## Milestones
+
+From the local execution plan (`plan/execution-plan.md`, gitignored). Status as of 2026-10-10.
+
+| # | Milestone | Status | Open |
+|---|---|---|---|
+| M0 | Skeleton and vertical slice | done | |
+| M1 | Editing core | done | |
+| M2 | PPTX import/export | done for generated decks | real-deck corpus, round-trip losses |
+| M3 | Shapes complete | mostly | edit points, Format Shape pane depth, bevel/3-D |
+| M4 | Design | mostly | Notes/Handout masters, variants, Designer |
+| M5 | Pictures and media | mostly | SVG/EMF, remove background, compress, icons, WMA/WMV |
+| M6 | Transitions and animations | mostly | Animation Pane timeline, remaining effects, transition sounds |
+| M7 | Slide show | mostly | second-display placement, laser, record |
+| M8 | Tables and charts | partly | chart data grid, elements, chartex types, draw table |
+| M9 | SmartArt, equations, WordArt | partly | SmartArt text pane and layouts, equations (PR #55), text warps |
+| M10 | Views | done | grid options, New Window |
+| M11 | Output | partly | vector PDF, SVG, GIF, MP4, print |
+| M12 | Review | partly | dictionaries, AutoCorrect, find/replace dialog, compare |
+| M13 | Automation and CLI parity | done | |
+| M14 | 1.0 polish and release | partly | i18n, native menu bar, signed releases done (v0.4.0) |
+
+## History: the 2026-10-07 alpha checklist
+
+Before the craftrules stages existed, DeckCraft defined "alpha" as: install a signed build on
+macOS, Windows or Linux, make a real deck from scratch or from a PowerPoint file, present it with
+transitions, animations and media, save back to `.pptx`/PDF without losing work, and hit no crashes
+on common paths. On 2026-10-07 it was ~80% there with these blockers:
+
+| Blocker (2026-10-07) | Status 2026-10-10 |
+|---|---|
+| First real release run: signing, notarization, installers verified on each OS | Signed releases v0.1.0–v0.4.0 published; installers not hand-checked on each OS; Windows startup crashes on some GPUs (#40, #59) |
+| PPTX fidelity on a corpus of real decks | Still open; now beta item 2 |
+| Presenter view and Animation Pane polish | Still open; beta items 9 and 10 |
+| Soak and fuzz the editor | Still open; beta item 1 |
+| UI fidelity pass on the most-used ribbon groups and dialogs; first run | Partly (start-screen fixes #20, #49); beta item 11 |
+| Mascot app icon, README screenshots, user docs | App icon (with a scalable SVG, #29) and README screenshots in place; user docs open |
+
+By the standard's definitions DeckCraft is **alpha** (~55% ready); these blockers now feed the beta
+plan above.
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | minor | Added the alpha gate (six core workflows): all pass, two with partial depth; stage stays alpha |
+| 2026-10-10 | major | Created: current focus, ranked beta plan with hours, milestones M0–M14 with status, the old alpha checklist as history |
@@ -0,0 +1,76 @@
+# Slide show and presenter view: parity with PowerPoint
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** major (created; measured from `crates/ui-egui/src/show.rs` and `crates/anim/src/show.rs` against PowerPoint 16.113's Slide Show tab and menu) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+Presenting is the job PowerPoint is hired for. This doc covers the show window, presenter view,
+rehearsal and recording. Transition and animation playback are in
+[animation-parity.md](animation-parity.md); display hardware in
+[hardware-parity.md](hardware-parity.md). Area score: checklist breadth **66%** (measured), **~60%
+ready** (estimated), **10–16 h** to parity.
+
+## Running the show
+
+| Feature | PowerPoint | DeckCraft | Notes |
+|---|---|---|---|
+| Play from Start / from Current Slide (F5, Shift+F5, Cmd+Enter) | yes | yes | |
+| Next/previous by click, arrows, Space, Page Up/Down, Enter, Backspace | yes | yes | #17 reported arrows not working in v0.3.0 AppImage; recheck |
+| Go to slide (number + Enter), first/last | yes | yes | |
+| Black / white screen (B / W) | yes | yes | |
+| End screen, Esc to leave | yes | yes | |
+| Step clock: a click after a long pause plays its step (#11) | yes | yes | |
+| Hidden slides skipped | yes | yes | |
+| Hyperlinks and action settings followed (slides, web, mail, End Show, Last Viewed) | yes | yes | Only `http(s)` and `mailto` open outside the show, by design (`safe_url`) |
+| Media playback with controls, play across slides, full-screen video | yes | yes | WMA/WMV not decodable |
+| Animated GIFs play; pause from their corner button | yes | yes (#39) | |
+| See All Slides grid during the show | yes | no | |
+| Zoom into part of a slide during the show | yes | no | |
+| Pen and highlighter ink | yes | pen only (Cmd+P pen, Cmd+A arrow, E erases all ink) | No highlighter, per-stroke eraser, ink colours, or keep/discard annotations prompt |
+| Laser pointer | yes | **no** | 1–2 h |
+| Subtitles and live captions | yes (cloud speech) | no | AI dimension |
+| Custom shows | yes | yes | |
+| Set Up Show: loop until Esc, kiosk (browsed at a kiosk), show without animation/narration, pen colour, slides range | yes | yes, most options | |
+| Use rehearsed timings | yes | yes | |
+
+## Presenter view
+
+| Feature | PowerPoint | DeckCraft | Notes |
+|---|---|---|---|
+| Separate presenter window with current slide, next slide, notes | yes | yes (an egui viewport, 1100×700) | |
+| Elapsed timer | yes | yes | |
+| Pause / reset timer, clock | yes | no | |
+| Slide counter, previous/next/end buttons | yes | yes | |
+| Notes font size, scrolling | yes | scrolling only | |
+| Placed on the presenter's display automatically, show on the projector | yes | **no**: opens wherever the OS puts it | Beta blocker, 3–5 h |
+| Swap displays | yes | no | |
+| Pen, laser, black screen, zoom from presenter view | yes | keys only | |
+| See all slides from presenter view | yes | no | |
+| Rehearse with Coach (Speaker Coach) | yes (cloud) | no | AI dimension |
+
+## Rehearse and record
+
+| Feature | PowerPoint | DeckCraft |
+|---|---|---|
+| Rehearse Timings, keep timings | yes | yes |
+| Record Slide Show (narration, ink, laser, camera; Cameo) | yes | no |
+| Clear timing / narration | yes | timings only |
+| Export the recorded show to video | yes | no (see [file-format-parity.md](file-format-parity.md)) |
+
+## Reading View
+
+Reading View in a window with navigation: present (checklist row done).
+
+## Estimates
+
+| Work | Hours |
+|---|---|
+| Presenter view on the right display, swap displays, pause/reset timer, clock, notes size | 3–5 |
+| Laser pointer, highlighter, eraser, keep-annotations prompt | 2–4 |
+| See All Slides and zoom during the show | 2–3 |
+| Record slide show with narration (no camera) | 5–8 |
+| **Total** | **~12–20** (the slide-show row of the feature table carries 10–16 h; recording overlaps the Media row) |
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | major | Created: show, presenter view, rehearse and record, compared with PowerPoint 16.113's Slide Show tab and menu |
@@ -0,0 +1,282 @@
+# DeckCraft vs Microsoft PowerPoint: parity assessment
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** minor (hours to ~95% per audience added; ready recomputed from written weights, 56% → 55%; stage stays alpha; previous: major, full re-measure against PowerPoint for Mac 16.113.4; replaces the parity sections of ROADMAP.md) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+The authoritative answer to "how close is DeckCraft to PowerPoint, and how much work is left?".
+[ROADMAP.md](../ROADMAP.md) summarizes it; [gaps.md](gaps.md) itemizes every shortfall;
+[parity-checklist.md](parity-checklist.md) is the row-by-row feature checklist behind the breadth
+number.
+
+## Headline
+
+| Number | Value | Kind |
+|---|---|---|
+| **Feature breadth** (weighted checklist) | **79%** over 191 features (P0 92%, P1 75%, P2 36%) | **measured**: `cargo xtask parity` formula over [parity-checklist.md](parity-checklist.md), rows re-scored 2026-10-10 |
+| Menu-bar coverage | **59%** (128 of 217 app-specific PowerPoint menu items have a DeckCraft command or UI label of the same name) | **measured** (heuristic lower bound): script matching the 2026-10-07 PowerPoint menu dump against the 226 engine command labels and the UI's strings; excludes the app, Window and Help menus and the subtitle language lists |
+| **Ready for real work** | **~55%** | **estimated**: weighted dimension table below (was ~56% until the features row was recomputed from written area weights) |
+| **Mainstream practitioner** | **~53%** | **estimated**: [method below](#mainstream-practitioner-and-essentials-user) |
+| **Essentials user** | **~62%** | **estimated**: [method below](#mainstream-practitioner-and-essentials-user) |
+| Stage | **alpha** (beta is ~20 points and ~120–210 h away) | judgement against craftrules `standards/progress-docs.md`: ~55% is in the alpha band and all six core workflows pass the [alpha gate](roadmap.md#alpha-gate-powerpoints-core-workflows) |
+| Remaining effort to beta | **~120–210 Opus 5.5 agent hours** | estimated, itemized in [roadmap.md](roadmap.md) |
+| Remaining effort to full parity | **~365–650 Opus 5.5 agent hours** | estimated, by dimension below |
+
+The menu figure is lower than the checklist figure because PowerPoint's menu bar lists every chart
+type, SmartArt category, action button and media source as its own item, and many DeckCraft
+equivalents are one parameterized command (`insert.chart {type}`) that the label match cannot see.
+Read it as a floor, not as a second breadth number.
+
+## Readiness by audience
+
+| Audience | Ready | Opus 5.5 agent hours to ~95% | Work that dominates |
+|---|---:|---|---|
+| Full target (ready for real work) | ~55% | 340–600 (~60% parallelizes: ~120–210 h wall clock with 3–4 agents) | Feature depth across all 20 areas, legacy `.ppt`/`.odp` and video export, localization in 11+ languages, GPU raster and hardware decode, AI features |
+| Mainstream practitioner | ~53% | 150–250 (~50% parallelizes: ~70–120 h with 3 agents) | `.pptx` exchange (real-deck corpus, round-trip losses, EMF/SVG, embedded fonts) 45–75 h; depth in charts, animations, pictures, text, presenting, print/vector PDF 70–110 h; interaction (menu bar, Format Shape pane, font faces, dialogs) 25–40 h; stability 10–20 h |
+| Essentials user | ~62% | 50–90 (~40% parallelizes: ~30–55 h with 2–3 agents) | Opening received decks (corpus subset, EMF, SVG icons) 25–45 h; Windows launch fallback and Close prompt 6–12 h; font faces, Tab, paste, print, show navigation 12–20 h; start screen, menu bar, palette 6–10 h |
+
+Calibration is the same as for the full number (see [Calibration](#calibration-how-the-hours-were-derived)): a fix is 0.5–1 h, a checklist row to PowerPoint depth 2–4 h, a subsystem 6–35 h. The sets are nested, so essentials ≤ mainstream ≤ full. The full number is an additive weighted sum over the dimension table; only mainstream and essentials use multiplicative discounts.
+
+## Target and how it was measured
+
+- **Target:** Microsoft PowerPoint for Mac **16.113.4** (build 16.113.26100421), the Microsoft 365
+  build installed at `/Applications/Microsoft PowerPoint.app`. PowerPoint for Windows has a few
+  more features (Ink Replay, OLE editing, more export types, Hindi and Vietnamese UI); where it
+  matters this document says so.
+- **The installed app, black-box** (AGENTS.md §2: names and listings only):
+  - `Info.plist` `CFBundleDocumentTypes`: the formats PowerPoint opens and saves (13 roles; table in
+    [file-format-parity.md](file-format-parity.md)).
+  - `Contents/Resources/*.lproj`: 30 localizations plus Base (26 languages and 4 regional variants; table in
+    [localization-parity.md](localization-parity.md)).
+  - The menu-bar dump `plan/powerpoint/menu-tree.txt` (491 lines, observed 2026-10-07, local and
+    gitignored) and the ribbon/pane observations in `plan/powerpoint/01-observed-ui.md`.
+- **The code on `origin/main` at d556ff9:** 226 engine commands (`crates/engine/src/cmd/*`), 48
+  transitions and 64 animation effects (`crates/model/src/anim.rs`), 504 `#[test]` functions, the
+  PPTX reader/writer (`crates/pptx`, 9.0k lines), 27 dialogs and 10 ribbon tabs
+  (`crates/ui-egui`).
+- **User reports:** 24 GitHub issues opened 2026-10-08 to 10-10 (16 still open), the best evidence
+  of depth we have.
+- **Not measured:** rendering fidelity against PowerPoint (no reference renders or real-deck corpus
+  exist yet), performance against PowerPoint, and any workflow end to end with a real user's deck.
+
+## By dimension
+
+"Ready" is how close each dimension is to what a professional who presents with PowerPoint needs.
+The weights are what those users actually depend on, written down so the total can be recomputed.
+
+| Dimension | Weight | Ready | Hours to full | Doc | Evidence |
+|---|---:|---:|---|---|---|
+| Features (breadth × depth) | 30% | ~62% | 140–240 | [parity-checklist.md](parity-checklist.md), [animation-parity.md](animation-parity.md), [slideshow-parity.md](slideshow-parity.md) | Breadth 79% measured. Depth lags: 37 of 191 rows are partial, and users found depth bugs in rows scored done within two days (#53, #60, #69, #70, #74, #77, #78) |
+| File formats | 20% | ~58% | 60–110 | [file-format-parity.md](file-format-parity.md) | PPTX reads and writes every main part and keeps unknown objects; files open in PowerPoint without repair. But it has never met a corpus of real decks, EMF/WMF/SVG pictures don't decode, comments/media/rewind settings are lost on round trip, and there is no `.ppt`, `.pptm`, `.odp`, video or GIF export |
+| UI/UX fidelity | 15% | ~60% | 30–50 | [ui-parity.md](ui-parity.md) | All 10 ribbon tabs and the contextual tabs exist; Format Shape pane, Animation Pane, dialogs and menus are thinner than PowerPoint's; no native macOS menu bar; user reports #17, #71, #73, #76 |
+| Stability | 10% | ~60% | 10–20 | [gaps.md](gaps.md) | Never-crash rules, a panic guard round every command, PPTX fuzz/malformed tests. But startup crashes on some Windows GPUs (#40, #59) and Close discards edits without asking (#60) |
+| Performance | 5% | ~55% | 10–20 | [hardware-parity.md](hardware-parity.md) | Unmeasured against PowerPoint. Slides rasterize on the CPU (`vello_cpu`); Morph re-aligns outlines every frame (#67) |
+| Hardware | 5% | ~40% | 25–45 | [hardware-parity.md](hardware-parity.md) | GPU-composited window (wgpu), but CPU slide raster, software-only video decode, presenter view not placed on the second display, no pen pressure, no pinch zoom |
+| Platforms | 5% | ~80% | 5–10 | [ROADMAP.md](../ROADMAP.md) | Ahead in reach: macOS, Windows x64/x86/arm64, Linux (5 formats), FreeBSD and the web, all from one release workflow. Held back by the Windows GPU crashes and Linux/Windows clipboard gaps |
+| Localization | 5% | ~8% | 55–90 + native review | [localization-parity.md](localization-parity.md) | English only; no string catalog. PowerPoint for Mac ships 26 languages. Bidi and Arabic shaping in slide text exist |
+| Ecosystem (templates, add-ins) | 3% | ~25% | 10–20 | [gaps.md](gaps.md) | 8 original themes vs PowerPoint's large template gallery; no add-ins or VBA (out of scope by policy) |
+| AI features | 2% | ~10% | 20–40 (owner decision on models) | [gaps.md](gaps.md) | No Designer, Copilot, Speaker Coach, live subtitles or Translate (all Microsoft cloud services). Agents drive every command over MCP instead |
+| **Total** | 100% | **~55%** (Σ weight × ready = 55.3) | **~365–650** | | |
+| Automation (✱, not weighted) | | ahead | 0 | [mcp.md](mcp.md), [control-protocol.md](control-protocol.md) | Every command is scriptable from the CLI, a JSON control channel and MCP, headless or against the running app; PowerPoint for Mac has AppleScript and VBA only |
+
+About 60% of the hours parallelize across crates (formats, render, text, UI, media, localization
+catalogs). Needs a human: native-speaker review of every translation, the owner's decision on AI
+models and on legacy `.ppt` import, running PowerPoint to make reference renders and to confirm
+round-tripped files open cleanly, and hardware we don't have (Windows GPUs from #40/#59, pens,
+multi-display rigs).
+
+## Mainstream practitioner and essentials user
+
+Two narrower readings of "ready", computed the same way in every Craft app (craftrules
+`standards/progress-docs.md`). The stage still follows the full number above and the alpha gate.
+
+### Mainstream practitioner: ~53%
+
+The typical professional who builds and presents decks every week: a consultant, teacher, sales or
+product person. Left out: add-ins, Copilot/Designer and other cloud AI, co-authoring and admin
+features, pens and recording hardware, and languages other than the user's own. Depth here is the
+depth of the parts of each area this user touches (common chart types, the effects people use,
+presenting rather than recording), so it's higher than the full-area numbers; exchange with
+PowerPoint is taken out of the areas and charged once, as a discount.
+
+| Area (weekly use) | Weight | Depth | Evidence |
+|---|---:|---:|---|
+| Text: typing, fonts, paragraphs, bullets | 18 | 70 | Every Home-tab control; font weights (#69), Tab in text boxes (#78) |
+| Slides, layouts, sections, views | 10 | 82 | Checklist 90% breadth in both areas |
+| Masters, themes, backgrounds | 8 | 75 | Slide Master view, 8 themes; Notes/Handout masters rarely used |
+| Shapes, format, arrange | 14 | 75 | Presets, connectors, smart guides; Format Shape pane thinner |
+| Pictures: insert, crop, styles | 8 | 62 | Works from file; paste fails on Windows/Linux (#53); crop partial |
+| Tables | 5 | 78 | Styles, merge/split, grow-to-fit |
+| Charts: column, bar, line, pie with data | 6 | 58 | Chart Data dialog; elements partial |
+| Transitions and common animations | 8 | 76 | 48/48 transitions; effects cover ~85% of use; pane has no timeline |
+| Presenting: show, presenter view | 10 | 70 | Works; not auto-placed on the second display; no laser |
+| Audio and video on slides | 3 | 62 | Plays; slow video in the show on Linux (#91) |
+| Comments | 3 | 60 | Threads, resolve |
+| Undo and clipboard | 4 | 75 | Unlimited undo; Paste Special partial |
+| Open, save, PDF export | 3 | 65 | No print; raster PDF artwork |
+| **Weighted depth** | 100 | **71.3** | |
+
+| Discount | Factor | Evidence |
+|---|---:|---|
+| Interaction fidelity | ×0.92 | No native macOS menu bar, thinner Format Shape pane, Tab ends text entry (#78), font faces (#69), window chrome (#71) |
+| Stability on real machines | ×0.92 | Startup crashes on some Windows GPUs (#40, #59); Close discards edits (#60, fix in PR #75); video stalls in the editor on Ubuntu (#91); arrows reported dead in the show on Linux Mint (#17) |
+| File exchange with PowerPoint users | ×0.88 | Harsher than VectorCraft's ×0.92 because swapping `.pptx` is daily work for this user: never tested on real decks, EMF pictures blank, icons from PowerPoint don't come through (#56), comment threads, media options and rewind lost on save (#70, #74, #77) |
+
+71.3 × 0.92 × 0.92 × 0.88 = **53.1 → ~53%**. This is about the same as the full number, unlike
+apps where mainstream comes out well above it. The dimensions mainstream leaves out
+(localization, ecosystem, AI) weigh only 10% of DeckCraft's full number, and the biggest penalty,
+`.pptx` exchange, hits every mainstream user.
+
+### Essentials user: ~62%
+
+Someone who makes a few simple decks: open or start a deck, type, add pictures, present, export
+a PDF. Leaves out advanced options, pro workflows and exchange edge cases, plus everything the
+mainstream number leaves out.
+
+| Core feature | Weight | Depth | Evidence |
+|---|---:|---:|---|
+| Start a deck from a theme (start screen) | 8 | 70 | Works; layout problems on the start screen (#17, #76) |
+| Type titles and bullets, basic formatting | 20 | 78 | Works; #69, #78 |
+| New slide, layout, reorder, duplicate | 12 | 88 | Works |
+| Insert a picture | 10 | 65 | From file yes; paste fails on Windows/Linux (#53) |
+| Basic shapes and text boxes | 8 | 85 | Works |
+| Theme colours and background | 6 | 80 | Works |
+| Transitions | 6 | 85 | Works |
+| Simple animations | 5 | 80 | Works |
+| Present full screen and move through slides | 10 | 85 | Works; #17 on Linux Mint |
+| Undo / redo | 5 | 95 | Works |
+| Save and reopen | 6 | 85 | Works; Close doesn't ask to save (#60) |
+| Export PDF / print | 4 | 70 | PDF yes, print no |
+| **Weighted depth** | 100 | **80.1** | |
+
+| Discount | Factor | Evidence |
+|---|---:|---|
+| Launch and stability | ×0.90 | Some Windows PCs can't start the app (#40, #59), and the workaround is an environment variable; Close loses work (#60) |
+| Discoverability and UI clarity | ×0.95 | Familiar ribbon and tabs; no native menu bar, start-screen glitches, a command palette whose default entry fails (#79) |
+| Opening files people send them | ×0.90 | `.pptx` opens, but real decks are untested and EMF pictures and PowerPoint icons can come in blank (#56) |
+
+80.1 × 0.90 × 0.95 × 0.90 = **61.6 → ~62%**.
+
+### User evidence (GitHub, 2026-10-10, maintainers excluded)
+
+- **38 issues** from 22 reporters and **48 PRs** by people other than the owner (bidi/Arabic,
+  Morph, tables, logging, packaging, a Gentoo overlay; open fix PRs for #53, #64, #70, #72, #74,
+  #77). **Praise threads or "switched from PowerPoint" reports: 0**
+  so far; the only comment threads are "same here" confirmations (#17, #33).
+- **Open issues (27):** 13 on the core path (#91 video playback, #60 Close, #59 and #40 startup
+  crashes, #53 image paste, #78 Tab in text, #69 font faces, #70/#74/#77 `.pptx` round trip, #56
+  icons from PowerPoint, #17 show navigation and file menu, #76 start screen), 14 polish or niche
+  (#81 and #64 browser exports, #79 palette, #72 browser comment timestamps, #73 icon consistency,
+  #71 and #26 window chrome, #41 system theme, #32 text transparency, #18 desktop shortcut, #15 and
+  #30 languages, #58 README link, #50 DMG signature).
+- Reading: people try DeckCraft for real decks and hit the core path. Nobody has reported
+  replacing PowerPoint yet, which fits ~53–55%.
+
+## By feature area
+
+Breadth is measured from the checklist; "ready" adds depth and is estimated. Hours are to
+PowerPoint parity for that area. **Weight** is how much a PowerPoint user relies on the area
+(points out of 110); the total "ready" is the weighted mean of the rows (6,865 / 110 = 62.4%), and
+it is the Features row of the dimension table. Automation and Platforms are scored elsewhere.
+
+| Area | Weight | Breadth (measured) | Ready (est.) | Hours | Main shortfalls | Doc |
+|---|---:|---:|---:|---|---|---|
+| Application shell | 5 | 71% | ~55% | 8–14 | No native macOS menu bar, thin start screen (templates, recent), one window per presentation missing | [ui-parity.md](ui-parity.md) |
+| Files (commands) | 4 | 69% | ~50% | see file formats | Print, reuse slides, passwords, legacy and macro formats | [file-format-parity.md](file-format-parity.md) |
+| Slides and sections | 6 | 90% | ~85% | 3–5 | Zoom (summary/section/slide), copying slides between decks keeps formatting only partly | [parity-checklist.md](parity-checklist.md) |
+| Views | 4 | 90% | ~80% | 3–6 | Snap to grid and grid options, New Window | [ui-parity.md](ui-parity.md) |
+| Masters and themes | 7 | 85% | ~70% | 8–14 | Notes and Handout masters, theme variants, `.thmx`, effect schemes | [parity-checklist.md](parity-checklist.md) |
+| Shapes | 7 | 86% | ~75% | 8–14 | Edit points, text warp, WordArt depth | [ui-parity.md](ui-parity.md) |
+| Format (fill, line, effects) | 6 | 81% | ~65% | 8–14 | Format Shape pane depth, bevel and 3-D, picture/texture fill options | [ui-parity.md](ui-parity.md) |
+| Arrange | 3 | 100% | ~90% | 1–2 | Align to slide vs selected as a menu choice, More Rotation Options | [ui-parity.md](ui-parity.md) |
+| Text | 15 | 80% | ~62% | 18–30 | Font weights beyond Regular/Bold/Italic (#69), Tab in text boxes (#78), IME, true vertical CJK, dictionaries, AutoCorrect, thesaurus, equations (PR #55 open) | [localization-parity.md](localization-parity.md) |
+| Tables | 5 | 89% | ~75% | 3–6 | Draw table, borders and cell effects depth | [parity-checklist.md](parity-checklist.md) |
+| Charts | 7 | 65% | ~45% | 12–20 | Data grid editing, chart elements, the `chartex` types (waterfall, funnel, treemap, sunburst, histogram, box) | [parity-checklist.md](parity-checklist.md) |
+| SmartArt | 4 | 33% | ~25% | 10–16 | Text pane, layout switching, the diagram data model on save | [parity-checklist.md](parity-checklist.md) |
+| Pictures | 7 | 48% | ~45% | 12–20 | SVG/EMF/WMF, clipboard paste on Windows/Linux (#53), artistic effects, remove background, compress | [file-format-parity.md](file-format-parity.md) |
+| Media | 4 | 67% | ~60% | 8–14 | WMA/WMV decode, record audio/screen, icons and 3-D models, playback options lost on PPTX round trip (#74) | [file-format-parity.md](file-format-parity.md) |
+| Transitions | 4 | 92% | ~80% | 4–8 | Transition sounds, 3-D transitions approximated in 2-D | [animation-parity.md](animation-parity.md) |
+| Animations | 6 | 79% | ~65% | 10–16 | 64 of PowerPoint's ~190 effects, Animation Pane timeline, preview, rewind lost on save (#77) | [animation-parity.md](animation-parity.md) |
+| Slide show and presenter view | 8 | 66% | ~60% | 10–16 | Second-display placement, laser pointer, recording, subtitles, ink depth | [slideshow-parity.md](slideshow-parity.md) |
+| Review | 3 | 60% | ~45% | 8–14 | Modern comment threads on round trip (#70), compare, version history, real spelling dictionaries | [file-format-parity.md](file-format-parity.md) |
+| Draw (ink) | 2 | 33% | ~30% | 5–9 | Pen pressure, ink to shape/text/math, lasso | [hardware-parity.md](hardware-parity.md) |
+| Undo and clipboard | 3 | 88% | ~75% | 3–5 | Paste Special, image paste (#53) | [ui-parity.md](ui-parity.md) |
+| Automation ✱ | — | 100% | ahead | 0 | | [mcp.md](mcp.md) |
+| Platforms ✱ | — | 67% | ~80% | see platforms | | [ROADMAP.md](../ROADMAP.md) |
+| **Total (feature areas)** | 110 | **79%** | **~62%** | **~140–240** | | |
+
+## What works today (evidence)
+
+Carried from the 2026-10-07 ROADMAP status and updated with what has landed since.
+
+- **Document model:** presentations, slides, masters and 11 standard layouts with placeholder
+  inheritance (slide → layout → master → theme), sections, notes, comments, custom shows,
+  header/footer fields, embedded media, unlimited undo on shared slide snapshots.
+- **Themes:** 8 original themes with colour and font schemes, custom colours and fonts,
+  backgrounds (solid, gradient, picture, pattern), slide size presets.
+- **Shapes:** ~150 preset geometries with adjustment handles, text boxes, pictures (crop,
+  corrections, animated GIFs that play and pause), tables with styles, charts (column, bar, line,
+  area, pie, doughnut, scatter and more), basic SmartArt, groups, connectors glued to sites,
+  freeform/curve/scribble, merge shapes, ink, action buttons, WordArt; flipped shapes keep their
+  text readable.
+- **Text:** in-place editing with caret, selection, keyboard and mouse; every Home-tab font and
+  paragraph control; bullets and numbering; levels; autofit; columns; vertical text; date fields in
+  their own format; hyperlinks drawn in the theme's hyperlink colour and followed in the show.
+  UAX #9 bidi and Arabic shaping with HarfRust, script font slots with per-cluster fallback,
+  `justLow` kashida, bidi caret and selection.
+- **Editing:** select, marquee, move, resize, rotate, adjust; smart guides; nudge; duplicate;
+  z-order; group/ungroup; align/distribute; Format Painter; Selection pane; clipboard.
+- **Transitions and animations:** 48 transitions including Morph (objects, words, characters,
+  geometry outlines), 64 animation effects (entrance, emphasis, exit, motion paths, media),
+  triggers, by-paragraph builds, Animation Painter, on a shared timeline engine.
+- **Slide show:** full screen, keyboard/mouse navigation, blank screens, go-to-slide, pen,
+  presenter window, rehearse timings, custom shows, Set Up Show, Reading View; links and shape
+  actions followed on click.
+- **Views:** Normal, Outline, Slide Sorter, Notes Page, Reading View, Slide Master; zoom;
+  grayscale.
+- **Review:** comments with replies and resolve, accessibility checker, a basic spelling list.
+- **Media:** MP3, AAC/M4A, ALAC, WAV, AIFF, CAF, FLAC, Ogg Vorbis and Opus audio; H.264, HEVC,
+  VP9 and AV1 video in MP4/MOV/WebM/MKV with pure-Rust decoders; poster frames, trim, fades,
+  volume, loop, play across slides.
+- **Files:** `.deckcraft` (zip + JSON), PPTX import/export (also opens `.potx`/`.ppsx`), PDF
+  export (slides, notes, handouts 1–9 per page, text layer, links, bookmarks), PNG/JPEG, outline
+  text, AutoRecover.
+- **Automation:** 226 commands, every one reachable from `deckcraft-cli`, the JSON control channel
+  and MCP.
+- **Platforms:** signed releases for macOS (universal), Windows x64/x86/arm64, Linux
+  (AppImage/deb/rpm/tar.gz/Flatpak, x86_64 and aarch64), FreeBSD and the web (v0.4.0, 2026-10-09).
+
+## Calibration: how the hours were derived
+
+From this repo's own history (`git log`, `gh pr list`, the 2026-10-07 ROADMAP):
+
+- **The bulk build:** engine, model, renderer, text, UI, show engine, PPTX, PDF, media and the
+  release pipeline (today 117k lines of Rust, 59k of them media codecs and containers ported from FilmCraft) took about
+  **30 wall-clock hours with up to three agents**, i.e. roughly 60–90 agent hours, landing publicly
+  between 2026-10-05 22:13 and 10-06 02:28. That is ~100 agent hours for today's 79% breadth / ~55%
+  ready, with community PRs.
+- **Catalogue rows** (connectors with glue, freeform tools, merge shapes, AutoRecover, the gradient
+  editor) took **1–2 agent hours each** to reach "done" (commits 10-06 00:49–01:34, parallel agents).
+- **Recent PRs** (2026-10-08 to 10-10): Animation Painter +189 lines, animated GIF playback +393,
+  hyperlink fixes +474, Morph geometry +781, UAX #9 bidi and Arabic shaping +1,902. At the ~150–300
+  tested lines per agent hour these suggest, that is 0.5–1 h, 1–3 h and 6–12 h respectively.
+  PR open-to-merge times (often 10–30 h) measure the review queue, not the work, and were not used.
+
+Scale used: a fix 0.5–1 h; a checklist row to presence 1–2 h; a row to PowerPoint depth 2–4 h; a
+subsystem (localization infrastructure, a real-deck corpus with fixes, EMF rendering) 6–35 h. The
+tail costs more per point than the bulk did: the remaining work is depth, fidelity and verification,
+which the first 100 hours mostly skipped.
+
+**Why the full-parity estimate rose from ~190 h (2026-10-07) to ~365–650 h:** the old figure
+covered the checklist rows, ribbon depth and performance only (~135 h of it is comparable to this
+document's 140–240 h for features plus 30–50 h for UI). New in this measure: localization (55–90 h;
+there is none yet), hardware (25–45 h), legacy and missing formats including `.ppt`, `.odp`, EMF/WMF
+and video export, a real-deck PPTX corpus, AI features, and the depth bugs users found in features
+scored done (16 open issues).
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | minor | Added the readiness-by-audience table: each number gets its own hours to ~95% (full 340–600, mainstream 150–250, essentials 50–90). The full number stays an additive weighted sum; no change to the percentages |
+| 2026-10-10 | minor | Added the mainstream practitioner (~53%) and essentials user (~62%) numbers with written weights, discounts and user evidence. Features dimension recomputed from written area weights (66% judgement → 62.4% weighted mean), which moves ready for real work from ~56% to ~55%; stage unchanged |
+| 2026-10-10 | minor | Stage checked against the core-workflow gate (all six pass); stays alpha |
+| 2026-10-10 | major | Created from ROADMAP.md's "How far from full parity" and "Status" sections; full re-measure against PowerPoint for Mac 16.113.4 (Info.plist, lproj, menu dump), 226 commands, 191-row checklist (79%), weighted dimension table (~56% ready), hours recalibrated from git history |
@@ -0,0 +1,90 @@
+# UI parity with PowerPoint
+
+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** major (created; ribbon, menus, panes, dialogs and interaction compared with PowerPoint 16.113 observations in `plan/powerpoint/`) · **Target:** Microsoft PowerPoint for Mac 16.113 (Microsoft 365)
+
+How DeckCraft looks and feels next to PowerPoint: the shell, the ribbon, menus, panes, dialogs,
+direct manipulation, keyboard and precision. Observations of PowerPoint are kept locally in
+`plan/powerpoint/01-observed-ui.md` and `menu-tree.txt` (gitignored, clean-room rules in
+AGENTS.md §2). Dimension score: **~60% ready** (estimated), **30–50 h** to parity.
+
+## Shell
+
+| Element | PowerPoint for Mac | DeckCraft | Gap |
+|---|---|---|---|
+| Title bar: AutoSave, Home, Save, Undo/Redo, document title, Share, search | yes | yes, no Share (cloud) | #71 macOS window controls misaligned |
+| Native macOS menu bar (File, Edit, View, Insert, Format, Arrange, Tools, Slide Show, Window, Help) | yes | **no** (`menus::menu_tree()` is defined but not installed) | 3–5 h |
+| Menu-bar items with a DeckCraft equivalent | 217 app-specific items | 128 matched by name (59%, heuristic lower bound) | See [target-app-parity.md](target-app-parity.md) |
+| Ribbon tabs: Home, Insert, Draw, Design, Transitions, Animations, Slide Show, Record, Review, View | 10 | 10 | Record tab is a placeholder |
+| Contextual tabs: Shape Format, Picture Format, Table Design, Table Layout, Chart Design, Chart Format, Video/Audio Format and Playback | yes | most; checklist P0 row partial | Chart Format, media tabs thinner |
+| Start screen: new, themes, templates, recent, open | yes | yes, thin (#17 broken layout, #76 missing overlay) | 3–5 h |
+| Status bar: slide counter, language, notes, comments, views, zoom slider | yes | yes | |
+| Command search (Tell Me) | yes | command palette | #79 default entry fails |
+| Light / dark appearance | follows the system | light or dark; doesn't follow the system (#41) | 1–2 h |
+| One window per presentation, New Window, Arrange All | yes | tabs in one window; no New Window | 3–5 h |
+| Quick Access Toolbar customization | yes | no | P1 partial |
+
+## Panes and dialogs
+
+| Pane / dialog | PowerPoint | DeckCraft |
+|---|---|---|
+| Format Shape / Picture / Text pane (Fill & Line, Effects, Size & Properties, Picture, Text Box) | full | partial: fill, gradient editor, line, some effects, size; no 3-D, thin picture/texture options |
+| Format Background pane | yes | yes |
+| Selection Pane | yes | yes |
+| Animation Pane | list + advanced timeline | list, reorder, timing; no timeline |
+| Comments pane (threads) | yes | yes |
+| Design Ideas (Designer) | yes (cloud) | no |
+| Dialogs | ~60 (Font, Paragraph, Bullets and Numbering, Find, Replace, Replace Fonts, Hyperlink, Action Settings, Header and Footer, Slide Size, Set Up Show, Custom Shows, Print, Page Setup, Insert Object, Symbol, Equation, Chart data sheet, SmartArt chooser, Preferences…) | 27 (`crates/ui-egui/src/dialogs.rs`): Table, Slide Size, Header and Footer, Hyperlink, Set Up Show, Zoom, Comment, Alt Text, Outline, Rename (section, shape, layout), Paragraph, About, Preferences, Export, Symbol, Equation (placeholder), Spelling, Accessibility, Language, Custom Shows, Chart Data, Trim Media, SmartArt chooser, Quit, Notes Pages |
+
+## Direct manipulation
+
+| Behaviour | PowerPoint | DeckCraft |
+|---|---|---|
+| Selection handles, rotation handle, yellow adjustment handles | yes | yes |
+| Marquee, Shift/Cmd multi-select, Tab to cycle | yes | yes |
+| Smart guides (edges, centres, equal spacing) | yes | yes |
+| Snap to grid, grid options, drawing guides | yes | gridlines, guides and snap to grid (engine setting); no Grid Options dialog or menu toggle |
+| Nudge (arrows), fine nudge (Option+arrows) | yes | yes |
+| Shift-constrained move, Option-drag to duplicate | yes | yes |
+| Connector glue and rerouting | yes | yes |
+| Edit points on freeforms | yes | **no** |
+| Crop handles, crop to shape, aspect ratio | yes | partial |
+| Text caret, selection, double/triple click, drag-select | yes | yes; Tab in text boxes ends editing (#78) |
+| Exact size/position, lock aspect | yes | yes |
+| Rulers with indent markers and tab stops | yes | rulers yes; tab stops partial |
+| Context menus on shapes, slides, text, thumbnails | yes | yes, shorter |
+| Drag and drop of files and between thumbnails | yes | yes |
+| Image paste from the clipboard | yes | macOS yes; Windows and Linux no (#53) |
+| Font menu: every installed family with its faces | yes | families yes; only Regular/Bold/Italic faces (#69) |
+
+## Keyboard shortcuts
+
+Every common PowerPoint for Mac shortcut is bound (checklist row done): new slide, duplicate,
+group/ungroup, bold/italic/underline, alignment, font size, list levels, Format Painter, show from
+start/current, view switching. Not yet: Cmd+F Find opening a find bar on the slide, Option+drag
+precision without snapping, F6 pane cycling, ribbon KeyTips (Windows).
+
+## Visual fidelity
+
+Colours, spacing, ribbon card and tab geometry follow the observations in
+`plan/powerpoint/01-observed-ui.md`; icons are original (~240, drawn in code or Lucide) and must not
+imitate Microsoft's. No pixel comparison against PowerPoint screenshots has been run since
+2026-10-07. Cross-app icon consistency is open (#73, #56).
+
+## Estimates
+
+| Work | Hours |
+|---|---|
+| Native macOS menu bar from `menu_tree()`, filled out to PowerPoint's menu items | 3–5 |
+| Format Shape pane depth | 6–10 |
+| Missing dialogs (Font, Bullets and Numbering, Find/Replace, Replace Fonts, Action Settings, Print, Insert Object) | 8–14 |
+| Start screen, window chrome, system appearance, palette fixes (#17, #41, #71, #76, #79) | 4–7 |
+| Grid Options, edit points UI, crop depth | 4–7 |
+| Multiple windows | 3–5 |
+| A screenshot comparison pass on the most-used tabs | 2–4 |
+| **Total** | **~30–52** |
+
+## Revision history
+
+| Date | Change | Summary |
+|---|---|---|
+| 2026-10-10 | major | Created: shell, panes and dialogs, direct manipulation, shortcuts and visual fidelity against PowerPoint 16.113 |
@@ -22,7 +22,7 @@ commands:
  wasm            cargo check --target wasm32-unknown-unknown for the wasm-safe crates
  ci              fmt --check, clippy -D warnings, test, assets, layers, wasm (stops at first failure)
  stats [--exact] count tests and lines per crate (--exact: ask the test harness via `-- --list`)
-  parity          recompute the PowerPoint feature-parity summary in docs/parity.md
+  parity          recompute the PowerPoint feature-parity summary in docs/parity-checklist.md
  ico <out.ico> <in.png>...
                  pack square PNGs (<= 256 px) into a Windows .ico (see packaging/icons.sh)
 ";
@@ -1,4 +1,4 @@
-//! `cargo xtask parity`: recompute the feature-parity summary in docs/parity.md from its row
+//! `cargo xtask parity`: recompute the feature-parity summary in docs/parity-checklist.md from its row
 //! table (each PowerPoint feature scored D / P / M, weighted by priority).

 use std::path::Path;
@@ -69,10 +69,10 @@ pub fn summary(rows: &[(String, String, u8, f64)]) -> String {
 }

 pub fn run(root: &Path) -> Result<(), String> {
-    let path = root.join("docs/parity.md");
+    let path = root.join("docs/parity-checklist.md");
    let text = std::fs::read_to_string(&path).map_err(|e| format!("{}: {e}", path.display()))?;
    let (Some(a), Some(b)) = (text.find(START), text.find(ROWS)) else {
-        return Err("docs/parity.md needs a `<!-- SUMMARY -->` marker before `## Rows`".into());
+        return Err("docs/parity-checklist.md needs a `<!-- SUMMARY -->` marker before `## Rows`".into());
    };
    let rows = rows(&text[b..]);
    let s = summary(&rows);