docs(cv): track builder integrity progress

docs/work-programmes/decisions.md

@@ -349,3 +349,13 @@
 - **Consequences:** the page presents concise state-aware navigation without changing API, profile persistence or imported-data approval semantics. Browser and production verification remain before `DONE`; deeper builder/job interaction remains in CAREER-002/JOBS-001.
 - **User approval required:** No; this is the smallest cohesive implementation of the approved programme requirement.
 - **Reversible:** Yes. Revert the CAREER-001 implementation commit; no data/configuration migration exists.
+
+## DEC-036 — CV autosave uses revision ordering and explicit discard warnings
+
+- **Date:** 2026-08-09
+- **Decision:** Keep the existing debounced variant autosave API, but track the latest name/settings and a monotonic client revision. Only the newest request may update the visible save state. Offer an explicit retry and block route/unload navigation until the user chooses to discard pending or failed edits.
+- **Reason/evidence:** the editor already has versioned server saves, but a route change during the debounce and overlapping responses could lose work or falsely display `Saved`. Blank names were ignored by the backend while remaining blank in the UI. The existing API is sufficient; the defect is client coordination and feedback.
+- **Alternatives considered:** replace autosave with a manual-only form; add a queue/schema; extend timeouts; silently flush during unload; refactor variant versioning. These regress the working interaction, add unrelated infrastructure or cannot reliably complete during page teardown.
+- **Consequences:** users receive a native discard decision for in-app navigation and browser-standard warning on unload. A blank name stays unsaved until corrected. The deeper builder redesign and browser checks remain CAREER-002 work.
+- **User approval required:** No; this is a reversible data-loss safeguard within the approved programme.
+- **Reversible:** Yes. Revert `b58cc19`; server variants and version history require no migration.

docs/work-programmes/master-progress.md

@@ -3,7 +3,7 @@
 Updated: 2026-08-09
 
 - **Overall programme status:** Active. Six packages are locally verified; eighteen packages through CAREER-001 are implemented with automated/runtime evidence but blocked from applicable browser/provider/production gates; CAREER-002 is in progress.
-- **Current work package:** `CAREER-002` — CV Builder interaction redesign (`IN PROGRESS`); revalidate existing editor/list behavior before changing the already substantial implementation.
+- **Current work package:** `CAREER-002` — CV Builder interaction redesign (`IN PROGRESS`); save/navigation integrity is pushed, and custom-entry/delete/reorder interaction is the next confirmed gap.
 - **Completed work packages:** None are `DONE`; all repository security/AI packages still have applicable browser, provider and/or production gates.
 - **Locally verified work:** SEC-001, SEC-002, SEC-003, SEC-005A, CORE-001 and PROD-002 (`VERIFIED LOCALLY`).
 - **Implemented, verification incomplete:** SEC-004, SEC-005B, SEC-008, CORE-002, BG-001, OPS-001A/B/C, POL-001/002, AI-001/002/003/004, UX-001/002, QA-001 and CAREER-001 (`IMPLEMENTED — NOT VERIFIED`). CAREER-001 now exposes first-run/profile/import/review/failure/general/job-specific/recent-CV actions while preserving explicit Apply/Discard; all automated/build gates pass.
@@ -12,7 +12,7 @@ Updated: 2026-08-09
 - **Deferred work:** None. Conditional multi-replica coordination, model deletion, realtime operation delivery and unrelated production changes remain outside current packages.
 - **Next five work packages:** CAREER-002 CV Builder redesign; EMAIL-001 consolidated email experience; JOBS-001 job-search/application redesign; HOME-001 homepage/Pro promotion; UX-003 authentication/profile polish. SEC-006/007 resume after package-index permission.
 - **Status counts:** 6 `VERIFIED LOCALLY`; 18 `IMPLEMENTED — NOT VERIFIED`; 1 `IN PROGRESS`; 9 `NOT STARTED`; 5 `BLOCKED`; 0 `DONE`; 0 `DEFERRED`.
-- **Test status:** backend 601/601; frontend 49/49 suites and 178/178 tests; CAREER-001 focused 16/16; production build and patch check pass. CAREER-001 browser/production presentation was not run because browser tooling was finalized; prior UX-002 browser and sidecar 22/22 remain green.
+- **Test status:** backend 601/601; frontend 49/49 suites and 181/181 tests; CAREER-002 focused 15/15 and CAREER-001 focused 16/16; production build and patch check pass. CAREER browser/production presentation was not run because browser tooling was finalized; prior UX-002 browser and sidecar 22/22 remain green.
 - **Deployment status:** No deployment performed. No production migrations were run. AI operation worker remains disabled by default.
 - **Production status:** Unchanged and unverified. No provider/model call, model pull, external request or paid API occurred.
 - **Known regressions:** None found by automated suites. Jest still needs `--forceExit` and reports its existing open-handle notice. Direct clean EF-only SQLite migration still hits the pre-existing historical blank-chain defect before later migrations; normal startup owns reconciliation. Cross-feature monthly AI usage accounting remains a rollout gap.
@@ -45,5 +45,6 @@ Updated: 2026-08-09
 - `docs/verification/ux-002-deterministic-theme-state.md`
 - `docs/verification/qa-001-job-term-quality.md`
 - `docs/verification/career-001-career-workspace.md`
+- `docs/verification/career-002-cv-builder.md`
 - `docs/verification/prod-002-ai-evaluation.md`
 - `docs/work-programmes/master-work-plan.md`

docs/work-programmes/master-work-plan.md

@@ -633,9 +633,9 @@ Ordering differences from the suggested list:
 - **Required production verification:** existing variants/edit/export/public render smoke.
 - **Status:** `IN PROGRESS`.
 - **Blocker:** FlowCV may require manual authenticated session; implementation can proceed from local evidence if research is labeled blocked.
-- **Evidence:** CAREER-001 is automated/build verified; existing builder is more complete than the programme's premise. Complete gap analysis and safe FlowCV access check are next.
-- **Commit:** none.
-- **Remaining work:** avoid rewriting already-working features.
+- **Evidence:** `docs/verification/career-002-cv-builder.md`; V-120–V-122. Existing builder already covers most section/reorder/hide/preview/version/PDF behavior. Save integrity is verified at 15/15 focused, 49/49 suites and 181/181 full plus build.
+- **Commit:** `b58cc19` (`fix(cv): protect unsaved builder edits`) — first increment only.
+- **Remaining work:** custom entry add/edit/reorder/delete confirmation; deeper interaction/persistence/preview error tests; narrow-screen decision; browser/FlowCV/production gates. Avoid rewriting already-working features.
 
 ### MAIL-001 — Consolidated job-email hub and explicit sending
 

docs/work-programmes/session-handoff.md

@@ -2,17 +2,17 @@
 
 Updated: 2026-08-09
 
-- **Exact current task:** CAREER-002 — re-read the CV Builder redesign requirements and inventory existing list/editor/content/reorder/hide/save/preview/export/version/responsive/accessibility behavior before editing.
-- **Last completed step:** CAREER-001 implementation was committed as `268b3a0`. The action-oriented workspace passes 16/16 focused tests, the full frontend passes 49 suites/178 tests, and the production build passes. Evidence/tracking are ready for their own commit and push.
-- **Files currently modified:** CAREER-001 verification, evidence and master tracking documents only. Application code/tests are committed. No application data, dependency, schema or configuration changed.
-- **Commands already run:** bounded Career/Profile/Builder/application-assets trace; focused Jest twice after refinement; full frontend Jest; production frontend build; diff/stat/check. See V-117–V-119.
-- **Test results:** CAREER-001 focused 16/16; frontend full 49/49 suites and 178/178 tests; production build/TypeScript and patch check pass. Browser and production checks remain.
-- **Services currently running:** none. The earlier Next development server was stopped and browser tabs finalized. Pre-existing Docker services were not changed.
-- **Temporary files or processes:** none. No private CV, provider, model, paid service or external request was used.
+- **Exact current task:** CAREER-002 — replace the custom-section line textarea/removal shortcut with explicit add/edit/reorder/delete-confirmation behavior, then expand persistence/collapse/hide/preview-error tests without changing master-profile ownership.
+- **Last completed step:** CAREER-002 save integrity was committed and pushed as `b58cc19`. Blank names validate locally, latest-data retry is explicit, stale save responses cannot overwrite newer state, and data-router/before-unload navigation warns on unsaved/saving/failed state.
+- **Files currently modified:** CAREER-002 verification/log/master tracking documents only. Application code/tests are committed and pushed.
+- **Commands already run:** Phase 8, list/editor/client/backend/architecture/test capability trace; focused Builder tests; full frontend Jest; production build; diff review/check; commit/push. See V-120–V-122.
+- **Test results:** CAREER-002 focused 3 suites/15 tests; frontend full 49/49 suites and 181/181 tests; production build/TypeScript and patch check pass.
+- **Services currently running:** none. Browser tabs were finalized earlier. Pre-existing Docker services were not changed.
+- **Temporary files or processes:** none. No external FlowCV/provider/model/private CV/paid service was accessed.
 - **Production changes currently active:** none. No deployment, migration, provider call or production payload occurred.
-- **Rollback status:** CAREER-001 has no schema/config/dependency migration. Revert `268b3a0`. Earlier rollback records remain current; production is unchanged.
-- **Uncommitted changes:** CAREER-001 evidence/tracking documents only, pending their reviewed commit and push.
-- **Known failures:** CAREER-001 browser widths/themes/keyboard/Norwegian and production synthetic smoke; QA-001 browser/production; real-provider authentication; MariaDB/SMTP/production unavailable; SEC-006 needs explicit internet/package-index permission; parser isolation remains SEC-007; historical clean EF-only SQLite chain needs startup reconciliation; Jest has an existing open-handle issue only when forced exit is used.
-- **Exact next action:** commit/push CAREER-001 evidence, then read `work.md:388-452`, `CvBuilderPage.tsx`, `CvBuilderEditor.tsx`, related tests and backend variant/render/export endpoints; write a gap matrix before the smallest CAREER-002 change.
-- **Work that can continue independently:** CAREER-002 and later repository UX packages. SEC-006/007 await package-index permission; PROD-001/003/004 await production access.
+- **Rollback status:** revert `b58cc19` for the save-integrity increment; no schema/config/dependency/data migration. CAREER-001 rollback is `268b3a0`. Production is unchanged.
+- **Uncommitted changes:** CAREER-002 evidence/tracking documents only; commit/push before the next application increment.
+- **Known failures:** authenticated FlowCV research unavailable; CAREER-001/002 browser widths/themes/keyboard/Norwegian and production smoke; custom-entry/delete interaction and deeper Builder tests remain; real providers, MariaDB/SMTP/production unavailable; SEC-006 needs internet/package-index permission; parser isolation remains SEC-007.
+- **Exact next action:** commit/push CAREER-002 progress evidence, then design explicit custom section items using the existing `string[]` model: add, edit, arrow reorder, confirmation before destructive deletion, empty/title validation, and autosave persistence tests.
+- **Work that can continue independently:** remaining CAREER-002 repository work and later UX packages. SEC-006/007 await package-index permission; PROD-001/003/004 await production access.
 - **Decisions still required from the user:** none for synthetic repository work. Internet/package upgrades, authenticated FlowCV/private CV access, external/paid providers and production actions retain explicit approval/safety gates; SEC-009 retention/legal policy remains unresolved.