docs: record rendering and builder audits

docs/execution/approved-issue-plans-ledger.md

@@ -40,29 +40,29 @@ state changes are outside scope.
 | 09 external version backup | #2705 | pending | unassigned | — | `7a98f6662` → — | none | live revalidation pending | — | — | document explicit JSON backup in user-controlled Git | no automatic sync scope |
 | 10 legacy link routing | #2836 | pending | unassigned | — | `7a98f6662` → — | none | live revalidation pending | — | — | validate owner-only notice/public 404 scope | prospective behavior only where historical data absent |
 | 11 job search policy | #3010 | pending | unassigned | — | `7a98f6662` → — | none | live revalidation pending | — | — | document JSearch removal/current tailoring workflow | — |
-| 12 preview/export failures | #3323, #3290, #3033, #3007, #2609 | pending | unassigned | — | `7a98f6662` → — | renderer ownership | live revalidation pending | — | — | reproduce first failing boundary per issue | missing historical fixtures possible |
-| 13 font/glyph/spacing | #3249, #3159, #3147, #3093, #3089, #2988 | pending | unassigned | — | `7a98f6662` → — | coordinates 14/17/18/27 | live revalidation pending | — | — | verify residuals without reverting existing fixes | fonts/fixtures/network paths |
-| 14 RTL export layout | #3275 | pending | unassigned | — | `7a98f6662` → — | renderer owner shared with 13/17/18 | live revalidation pending | — | — | separate shaping/layout from canvas display | renderer feasibility gate |
-| 15 picture fitting/style | #3168, #3088, #2794, #2782 | pending | unassigned | — | `7a98f6662` → — | coordinate 06/25 | live revalidation pending | — | — | diagnose delivery, square preview, non-square fitting separately | image fixtures/backends |
-| 16 imported table borders | #3196 | pending | unassigned | — | `7a98f6662` → — | shared rich-text owner with 19 | Q11 approves editable Tiptap tables | — | — | reproduce flattening and implement supported table editing/persistence/export | reporter fixture unavailable may limit historical equivalence |
-| 17 list/skill pagination | #2751, #3040 | pending | unassigned | — | `7a98f6662` → — | renderer owner shared with 13/14/18 | live revalidation pending | — | — | reproduce causes separately | renderer feasibility |
-| 18 preview/export geometry | #2683 | pending | unassigned | — | `7a98f6662` → — | renderer owner shared with 13/14/17 | live revalidation pending | — | — | measure identical resume data in preview/download | real render required |
-| 19 literal rich-text whitespace | #3397 | pending | unassigned | — | `7a98f6662` → — | shared rich-text owner with 16 | approved ordinary paragraph/heading preservation; four-space tabs | — | — | revalidate editor/export normalization and compatibility boundary | renderer feasibility for literal whitespace |
-| 20 section restoration | #3378, #3265, #2921 | pending | unassigned | — | `7a98f6662` → — | shared section/layout owner 21–24/32 | live revalidation pending | — | — | distinguish hidden from missing layout placement | — |
-| 21 section heading visibility | #3060 | pending | unassigned | — | `7a98f6662` → — | coordinates 20/31 | Q1–Q3 approved; current main already contains partial `showHeading` seams | — | — | compare full plan to current implementation and prove preview/PDF/DOCX/accessibility behavior | — |
-| 22 skill keyword presentation | #2785 | pending | unassigned | — | `7a98f6662` → — | shared section/layout owner | live revalidation pending | — | — | implement explicit approved mode after plan revalidation | — |
-| 23 pagination controls | #3350, #3090 | pending | unassigned | — | `7a98f6662` → — | shared section/layout owner | Q10 preserves independent authored-page controls; overflow-page UI deferred | — | — | validate guidance with Azurill scenario | renderer scenario |
-| 24 date layout | #3155, #2841 | pending | unassigned | — | `7a98f6662` → — | shared schema/section/template owner; before 32 integration | Q4–Q9 approved across all free-text-date sections/templates | — | — | inspect full plan and current schema/template seams | real layout validation required |
-| 25 experience company logos | #3379 | pending | unassigned | — | `7a98f6662` → — | image contract from 06/15 | live revalidation pending | — | — | add through existing image ownership contract | storage compatibility proof |
-| 26 secondary color | #3373 | pending | unassigned | — | `7a98f6662` → — | template owner coordinates 28/29/34 | live revalidation pending | — | — | define token, consumers, compatibility per plan | visual render review |
-| 27 offline fonts | #3377 | pending | unassigned | — | `7a98f6662` → — | font diagnostics from 13/14 | live revalidation pending | — | — | measure all font network paths before distribution choice | network/font licensing/size evidence |
-| 28 basics custom styles | #3137 | pending | unassigned | — | `7a98f6662` → — | template owner coordinates 26/29/34 | live revalidation pending | — | — | verify existing styles and isolate residuals | visual render review |
-| 29 Onyx profile header | #2812 | pending | unassigned | — | `7a98f6662` → — | template owner coordinates 26/28/34 | live revalidation pending | — | — | add optional placement without duplicate content | visual render review |
-| 30 ATS export evaluation | #2845 | pending | unassigned | — | `7a98f6662` → — | after renderer baselines | live revalidation pending | — | — | evaluate current PDF/DOCX before ATS preset decision | tooling/criteria may limit claims |
-| 31 document accessibility | #2844 | pending | unassigned | — | `7a98f6662` → — | after renderer baselines; coordinates 21 | Q3 retains accessible section labels when visible heading hidden | — | — | verify current PDF/DOCX/HTML gaps only | tagged-PDF feasibility not assumed |
-| 32 section date sorting | #2725 | pending | unassigned | — | `7a98f6662` → — | section/schema owner; coordinate 24 | approved one-time stable sort, not autosort | — | — | implement stable unknown-date behavior per full plan | — |
-| 33 Europass template | #2689 | pending | unassigned | — | `7a98f6662` → — | renderer/template baselines | approved research and concrete visual proposal only | — | — | research official reference and publish reviewable visual artifact, then mark blocked at gate | future concrete visual approval required before template code |
-| 34 Gengar skill layout | #2611 | pending | unassigned | — | `7a98f6662` → — | template owner coordinates 26/28/29 | live revalidation pending | — | — | restore Gengar-only rating placement | visual render review |
+| 12 preview/export failures | #3323, #3290, #3033, #3007, #2609 | blocked corrective work; diagnostic-ready | audit `task_1c6582ccdeae` | `codex-audit-rendering-12-19` | `7a98f6662` → no source change | renderer ownership; share observation harness with 18 | zero drift; staged-preview/error-boundary baselines remain; reports cross persistence/font/PDF/viewer/deployment boundaries | audit focused web/PDF suites, affected typechecks, boundaries, build passed | — | isolate PT Sans, browser/config, and template-selection boundaries; no shared fix | exact JSON/output/browser/config/current reproduction missing |
+| 13 font/glyph/spacing | #3249, #3159, #3147, #3093, #3089, #2988 | blocked corrective work; diagnostic-ready | audit `task_1c6582ccdeae` | `codex-audit-rendering-12-19` | `7a98f6662` → no source change | serialize font sources with 14/27 | merged metrics/cache/Unicode fixes present and passing; residuals require per-font/per-symptom fixtures | audit focused PDF/font suites, affected typechecks, boundaries, build passed | — | retain regressions; create residual unit only from exact failing font fixture | missing Ropa Sans/source strings/font hashes/before-after artifacts |
+| 14 RTL export layout | #3275 | blocked corrective work; diagnostic-ready | audit `task_1c6582ccdeae` | `codex-audit-rendering-12-19` | `7a98f6662` → no source change | serialize renderer/fonts with 13/27 | merged canvas-direction fix remains; broader shaping/bidi cause unproved | audit RTL/preview suites, affected typechecks, boundaries, build passed | — | run controlled same-bytes export matrix against approved shaping oracle | exact JSON/font/version and known-good reference absent |
+| 15 picture fitting/style | #3168, #3088, #2794, #2782 | pending implementation 15A; other causes blocked | unassigned | planned `codex/issue-2782-picture-fit` | `7a98f6662` → — | coordinate 06/25; schema/PDF owner exclusion | verified contract gap: no fit field; editor/web/PDF force cover; 15A cover/contain is ready | audit picture suites, schema/web/PDF typechecks, boundaries, build passed | — | implement explicit cover/contain with cover compatibility and cross-output geometry tests | delivery/centering issues still lack source revisions/assets/expected crop |
+| 16 imported table borders | #3196 | pending implementation | unassigned | planned `codex/issue-3196-editable-tables` | `7a98f6662` → — | rich-text owner; must precede 19/31 | editor lacks table extensions; Q11 approves editable supported tables; atomic editor/HTML/PDF unit ready | audit current table/rich-input regressions, affected typechecks, boundaries, build passed | — | implement via TDD, including persistence, undo/redo, borders, and lossless unsupported fallback | historical visual equivalence lacks reporter HTML/JSON but feature contract is approved |
+| 17 list/skill pagination | #2751, #3040 | blocked corrective work; diagnostic-ready | audit `task_1c6582ccdeae` | `codex-audit-rendering-12-19` | `7a98f6662` → no source change | renderer owner shared with 13/14/18 | merged ordered-marker/wrap/level-gap fixes present; current residual not reproduced | audit focused PDF suites, typecheck, boundaries, build passed | — | retain controls; add fix only from exact failing list/skill fixture | #2751 source absent; #3040 current fixture no longer proves residual clipping |
+| 18 preview/export geometry | #2683 | blocked corrective work; diagnostic-ready | audit `task_1c6582ccdeae` | `codex-audit-rendering-12-19` | `7a98f6662` → no source change | share output-boundary harness with 12; viewer owner exclusion | current viewport/page-size/margin baselines pass; video alone cannot locate cause | audit page/preview tests, affected typechecks, boundaries, build passed | — | compare identical preview/download bytes, MediaBoxes, ink bounds, viewport, DPR | exact JSON/PDF/browser/DPR/zoom/page settings absent |
+| 19 literal rich-text whitespace | #3397 | pending after 16 | unassigned | planned `codex/issue-3397-literal-whitespace` | `7a98f6662` → — | stack/rebase after 16; coordinate DOCX/PDF/editor with 31 | verified current marked-policy gap; approved marker contract and four-space tabs remain implementation-ready | audit whitespace/indentation suites, affected typechecks, boundaries, build passed | — | implement web/PDF/DOCX atomically after table seam stabilizes | no product blocker; serialized file ownership only |
+| 20 section restoration | #3378, #3265, #2921 | pending split implementation | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | 20A before 21/31; placement semantics before 29 | 20A hidden recovery ready; 20B defensive unplaced recovery ready after helper contract; reporter causes remain unproved | audit focused web/resume tests, affected typechecks, boundaries passed | — | implement 20A first, then separately assess 20B | #3378/#3265 need version/action/sanitized JSON; defensive fix cannot close them |
+| 21 section heading visibility | #3060 | pending after 20A | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | 20A → 21 → 31 | runtime PDF seam exists; persisted schema/menu/DOCX/accessibility contract absent; Q1–Q3 make unit ready | audit schema/web/PDF/DOCX/resume suites and typechecks/boundaries passed | — | add migration-safe flag, menu, PDF/DOCX visual behavior, retained semantic label | serialize shared section/schema files |
+| 22 skill keyword presentation | #2785 | pending implementation | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | must precede/serialize 34 | array currently comma-joined; inline/list contract ready for built-in and custom Skills | audit schema/web/PDF/DOCX suites and typechecks/boundaries passed | — | select explicit Skills-specific schema trait; implement inline compatibility and semantic list mode | exact schema owner chosen during implementation; no product gate |
+| 23 pagination controls | #3350, #3090 | pending 23A/23B; 23C blocked | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | 23B → possible 23C | 23A authored-vs-physical page guidance ready; renderer clips oversized `wrap=false` section; item policy unproved | audit focused PDF/web suites and typechecks/boundaries passed | — | publish 23A; build short/boundary/oversized matrix in 23B before item control | safe oversized-item fallback and widow/orphan UI remain unresolved |
+| 24 date layout | #3155, #2841 | design-ready only | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | 24A → 24B; mutual exclusion with 32, not dependency | free-text date/period sources and current location-first order verified; geometry contract absent | audit schema/PDF suites and typechecks/boundaries passed | — | run all-template 24A geometry characterization and select width/bounds/default | physical width, bounds, alignment, default; DOCX scope not yet confirmed |
+| 25 experience company logos | #3379 | blocked implementation; contract-design-ready | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | 25A → 25B; coordinate 06/15 | current generic uploader has eager deletion and no reference counting/ownership validation; unsafe to reuse unchanged | audit relevant package suites/typechecks/boundaries passed | — | define asset ownership, accepted types, retention/orphan/copy/undo contract and tests | storage ownership/lifetime contract requires new decision |
+| 26 secondary color | #3373 | inventory-ready; implementation blocked | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | 26A → 26B; serialize semantic docs with 28 | theme has three roles; primary consumers are not classified decorative vs semantic | audit schema/PDF suites and typechecks/boundaries passed | — | enumerate primary consumers and approve decorative truth table | consumer classification/visual contract not selected |
+| 27 offline fonts | #3377 | evidence-ready; implementation blocked | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | 27A → 27B; informs 30A; serialize 13/14 | remote catalog/PDF/web fetch paths verified; no local resolver or complete licensed manifest | audit font/PDF/web suites and typechecks/boundaries passed | — | inventory cold-network requests and build asset/license manifest | licenses, all fallback assets, size, deployment path unknown |
+| 28 basics custom styles | #3137 | partial no-change; diagnostic-ready | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | serialize semantic docs/tests with 26 | documented selectors and header/name fixtures already present; gradients intentionally unsupported; residual unspecified | audit semantic CSS fixtures and affected typechecks/boundaries passed | — | strengthen unsupported-gradient diagnostics only if current assertion is inadequate; await residual fixture | reporter has not named remaining failure; keep issue open |
+| 29 Onyx profile header | #2812 | blocked | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | placement semantics 20; accessibility order 31 | historical Onyx-only PR obsolete; no persisted generic placement owner exists | audit relevant suites/typechecks/boundaries passed | — | choose generic placement capability and produce one-page/overflow visual contract | new persisted-interface choice plus visual contract required |
+| 30 ATS export evaluation | #2845 | blocked pending measurement prerequisites | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | renderer baselines 12–19 and font assumptions → 30A → possible 30B | current DOCX mirrors authored layout; internal ATS/extraction analyzers exist; no preset/projection | audit PDF/DOCX/tooling suites and typechecks/boundaries passed | — | run synthetic measurement matrix, make no vendor claims; only then consider pure projection | renderer baselines; material benefit and adapter contract unproved |
+| 31 document accessibility | #2844 | diagnostic-ready after prerequisites | audit `task_47ed7eb02d48` | `codex-audit-builder-20-34` | `7a98f6662` → no source change | 20 → 21; rich text 16 → 19; renderer baselines → 31A | builder mirror has H1/H2 but strips rich structure; public viewer differs; cross-output audit absent | audit accessible/PDF/DOCX suites and typechecks/boundaries passed | — | audit DOM/PDF/DOCX/public viewer and manual screen reader before remediation | duplicate-announcement risk and reporter evidence; no assumed tagged-PDF fix |
+| 32 section date sorting | #2725 | pending implementation | audit `task_47ed7eb02d48` | planned `codex/issue-2725-one-shot-sort` | `7a98f6662` → — | shared-file exclusion with 20–24; behavior independent of 24 | existing `parsePeriod` reusable; pure stable one-shot sort contract approved for Experience/Education | audit resume/schema/web suites and typechecks/boundaries passed | — | implement pure helper, exact unresolved IDs, menu/undo/persistence tests | bare Present/reversed/blank remain stable unresolved by design |
+| 33 Europass template | #2689 | blocked after approved research/proposal unit | audit `task_47ed7eb02d48` | planned `codex/issue-2689-europass-research` | `7a98f6662` → — | 33A → explicit visual approval → possible 33B | no current template; historical draft obsolete/incomplete; research/proposal only approved now | audit registry/gallery/schema suites and typechecks/boundaries passed | — | research authoritative references/licensing and publish concrete one-page/overflow proposal; stop | explicit future visual approval required before any template code |
+| 34 Gengar skill layout | #2611 | pending after 22 | audit `task_47ed7eb02d48` | planned `codex/issue-2611-gengar-skill-level` | `7a98f6662` → — | 22 → 34; serialize shared Skills renderer | typed template capability + single shared renderer consumption is ready; no template-name branch | audit PDF skills/semantic suites and typechecks/boundaries passed | — | implement after keyword layout lands; assert Gengar-only delta and unchanged peers | file serialization only |
 | 35 resume import errors | #2768 | pending | unassigned | — | `7a98f6662` → — | none | live revalidation pending | — | — | reproduce before changing parser/dialog lifecycle | source fixture may be missing |
 
 ## Active orchestration
@@ -71,8 +71,8 @@ state changes are outside scope.
 | --- | --- | --- | --- | --- |
 | Plans 01–06 | `task_855fbee0a803` / `ctx_949458744061` | `codex-audit-backend-01-06` | complete; worker released | zero drift; plans 01/04/05/06 blocked on named evidence; plan 03 no-change; plan 02 synthetic unit ready |
 | Plans 07–11, 35 | `task_9f27829ca50f` / `ctx_11f7d7cf6d17` | `codex-audit-backend-07-11-35` | diagnosing | current issue/source/PR audit and executable unit split |
-| Plans 12–19 | `task_1c6582ccdeae` / `ctx_795fced595ef` | `codex-audit-rendering-12-19` | diagnosing | current issue/source/PR audit and renderer overlap map |
-| Plans 20–34 | `task_47ed7eb02d48` / `ctx_50d8257459ab` | `codex-audit-builder-20-34` | diagnosing | current issue/source/PR audit and schema/template overlap map |
+| Plans 12–19 | `task_1c6582ccdeae` / `ctx_795fced595ef` | `codex-audit-rendering-12-19` | complete; worker release pending | 15A/16/19 implementation-ready; remaining causes split into diagnostics with named evidence gates |
+| Plans 20–34 | `task_47ed7eb02d48` / `ctx_50d8257459ab` | `codex-audit-builder-20-34` | complete; worker release pending | ready: 20A, 21, 22, 23A, 28 diagnostics, 32, 34; remaining plans split at evidence/design gates |
 | Plan 07 implementation | `task_aee702e37eae` / not dispatched | planned `codex/issue-2722-postgres-docs` | waits on plans 07–11 audit | two-file docs change, verification, commit, independent review |
 | Plan 09 implementation | `task_e450ea143bfa` / not dispatched | planned `codex/issue-2705-git-backup-docs` | waits on plans 07–11 audit | two-file docs change, synthetic local-Git validation, commit, independent review |
 | Plan 11 implementation | `task_58d76423d364` / not dispatched | planned `codex/issue-3010-jsearch-docs` | waits on plans 07–11 audit | three-file docs change, source/test validation, commit, independent review |