cesnimda
8.9 KiB
CV-UX implementation checkpoint — 25 October 2026
Workspace, section, candidate-template, letter-document and contextual AI implementation is ready for final integration qualification. This is not final CV-UX acceptance. Commands and remaining lanes are in VERIFICATION.md.
The existing editor retains its save queue, content/settings ownership, preview and undo. Document context/history provenance are explicit; movement announces position and retains boundary focus; previews have page selection. Template candidates use real renderer samples, make no writes until Apply, reject late responses and use reversible visual-only application.
CV export flushes local saves and checks the requested saved revision before rendering; changed local revisions discard late downloads. Existing callers without the optional CV revision remain compatible.
All letter writers stage text/design/history with the parent transaction and shared RD21 Version. Generic/draft null/clear rules remain distinct. Previously unrecorded current text is recovered before replacement; restore creates a new version. The additive nullable migration retains old text-only records. Account/backup exports include history/design; submitted packages capture rendered letter bytes/settings without rewriting historical records.
Letter editing provides adjacent/responsive physical preview, explicit Save, reviewed contact/design snapshot copying and saved-revision export. Copy creates no live synchronization. Rendering reuses CV normalization, inline formatting, pagination and bounded PDF admission. The redundant narrower text preview is hidden when physical preview is available; legacy responses retain their fallback.
Four contextual AI controls reuse existing self-hosted owners. CV proposals retain capability/source/revision validation. Letter suggestions edit the local draft explicitly; missing career evidence prevents inference and interaction creation. Cancelled or changed-source/language responses are discarded. Letter prompt guardrails do not establish actual-model semantic qualification; see AI.md.
Executed intermediate evidence
Artifacts reside under .artifacts/cv-ux-01/.
| Check | Result | Qualification |
|---|---|---|
| Full backend Debug successor | 1169 passed, 0 failed/skipped | backend-successor.trx; post-test wrapper quoting error retained separately |
| Full backend Release | 1169 passed, 0 failed/skipped | final-01/backend/backend.trx; subsequent browser attempt superseded by frontend review correction |
| Earlier full frontend | 972 passed / 107 suites | frontend-full.json; predates latest review changes |
| AI/letter frontend successor | 73 passed / 3 suites | ai-ui-successor.json; controlled responses, not real inference |
| Preview review correction | 54 passed / 2 suites | preview-review.json; physical-preview precedence |
| Actual disposable MariaDB design | 56 passed, 0 skipped | letter-design-mariadb; pinned12.2.2, down/up preservation and positive cleanup; fresh final provider run pending |
| Windows letter native PDF | 4 documents / 14 pages, zero differences | letter-windows-01; unchanged oracle, real API/export; predates final UI review correction |
| Build/type/lint | PASS | Release API0warnings/errors; TypeScript/lint; static build repeated after correction |
| Independent source review | One P2 corrected | Duplicate preview had narrower formatting dialect; no proven new data-loss/security defect |
Focused results overlap full suites and are never added to their totals. The first final browser attempt is incomplete/superseded and retained. Final regression must bind source/runtime hashes after the review correction.
Remaining: fresh ordinary/contract/RD21 browsers, responsive/localisation automation, provider regression, original Windows/Linux CV oracles and Linux letter fidelity. Actual self-hosted model semantics and human accessibility/device/language/print remain unqualified. Hosted isolation/MariaDB restrictions and production/Phase10 NO-GO remain. CV-IMPORT-01 is not started.
Reviewed successor checkpoint
- Prompt language conflict corrected;65/65 focused backend cases pass after observed12-failure RED run.18 action/language cases added.
- Current frontend full suite972/972 across107 suites; all241 current frontend source/test files match the recorded pre-run hashes (
frontend-source-identity.json). No focused totals are added. - Fresh actual MariaDB provider gate56/56, source before/after equal and generated service cleanup confirmed (
provider-final-01). Earlier SDK-selection/build-lock attempts are retained and superseded. - Letter responsive browser case passes seven widths320–1440, EN/Bokmål, light/dark, keyboard pane/focus/draft preservation, root/main overflow and primary control hit testing (
letter-responsive-03). The two predecessors expose fixture errors, not product passes: iframe init storage reset and wrong assumed900px breakpoint. The tested application theme breakpoint is1024px. - Offline Linux adapter guard/lifecycle checks10/10. Current application publish is overlaid in a new app directory on the exact verified cached native runtime. The first build's unnecessary audit override was removed; its image is explicitly superseded. No advisories are suppressed in the successor helper. Native OS rebuilding and actual Linux rendering are distinct gates.
- Handoff requirements prepared in CV_IMPORT_HANDOFF.md; import implementation remains unstarted.
Independent-review corrections
The first independent full review found three P2 acceptance gaps: location was copied by default, all letters declared English HTML language, and letter AI invalidation watched cached source metadata. All three are corrected. Contact copy now has reviewed default/optional field selection; language is an additive normalized settings property retained by history/frozen snapshots; AI suggestions bind actual input source and revalidate after inference and before local Apply. Legacy unbound suggestions require regeneration. No new schema/provider was introduced by these corrections.
Fresh full Release backend1227/1227 (40 added cases, zero removed from the preceding1187 report) and frontend981/981 across107 suites passed. Source-bound frontend process before/after hashes match. Two letter browser cases passed after corrections; the unchanged native oracle passed all four letter fixtures/14pages with zero differences. Actual MariaDB source-bound transaction cases and final aggregate Windows/Linux runs remain pending. Re-review of the corrections found no remaining material defect; review did not substitute for execution.
Actual MariaDB source-boundary successor59/59 passed (provider-final-03), including three real relational transaction/held-source cases with a stub inference service. Source hashes match and owned cleanup is confirmed. The intermediate provider-final-02 preparation failed before starting a service or executing tests and remains preserved. Real API authorization checks also passed (missing owned interaction404; free account403). The seven-scenario responsive browser case additionally passed five targeted WCAG A/AA scans with zero violations; incomplete/manual qualifications remain open and final native reports retain their scan details. Its preceding exact-name locator timeout is a fixture failure retained separately: MUI exposes the select's label together with its selected value.
Last-good preview scroll regression
The aggregate final-04 run exposed a real regression in both original preview-presentation recovery cases: a held refresh changed scrollTop by7px against the unchanged1px tolerance. The new page selector unmounted while previewReady was false, shortening the toolbar and expanding the retained preview viewport. The narrow correction keeps the selector mounted when last-good multi-page HTML exists and disables it until ready. Both original EN/light and NB/dark scenarios now pass, including held/error/retry, retained iframe identity/content and scroll checks (preview-scroll-successor-01.json); focused editor50/50 and a fresh static build pass. Independent review found no material issue. No oracle tolerance or original assertion changed. Full frontend successor and fresh aggregate/PDF runs remain pending; failed/interrupted final-04 is retained.
Candidate sample keyboard scrolling
final-05 exposed scrollable-region-focusable in the new candidate dialog's overflowing read-only content. A labelled region with tabIndex0 makes the existing DialogContent keyboard reachable while preserving Cancel autofocus, focus trapping and Apply gating. The original four EN/Bokmål/light/dark document-settings cases now pass with all axe rules unchanged (template-focus-browser-01.json); these also exercise settings, canonical source, history and eight actual PDF states. Candidate unit6/6 and static build pass; independent narrow review found no material risk. Full frontend successor and final-06 aggregate qualification remain pending; the failed predecessor is retained.