feat(repo): showcase-completion E7 — release gate (docs/runbook/API sweep + dogfood evidence + regression coverage + umbrella close-out)

[w7-mgfcode]

Sub-issue of #406 (umbrella: showcase workspace completion — the forecastlab control story). Release gate — closes only after Foundation (E1 #407) + all Parallel epics (E2 #408, E3 #409, E4 #410, E5 #411, E6 #412) close. All six are CLOSED and merged to dev, so this gate is immediately actionable.

Purpose

Close out umbrella #406 on proof, not per-epic merges alone: a documentation/runbook/API-contract sweep that reconciles the _base docs with everything E1–E6 shipped, a dogfood evidence matrix across the new control surfaces, a regression-coverage audit (incl. the load-bearing legacy-frame byte-identical contract), and the umbrella success-criteria + decomposition close-out.

Sub-tasks

• Docs / runbook / API-contract sweep — verify docs/_base/API_CONTRACTS.md, RUNBOOKS.md, and DOMAIN_MODEL.md reflect E1–E6: the lifecycle + provenance columns and JSONB story slots (E1), safe-replay/lineage/health semantics (E2), seed_overrides + user_scope (E3), run_config (E4), approval_events + rag_events + Reject path (E5), and the export bundle contract (E6). Reconcile every "Explicitly out of scope" list (import/restore stays out; job_ids / phase_summaries slots still unwritten).
• Dogfood evidence matrix — e2e dogfood of each new control surface on a fresh seeded stack, recording green / documented-expected-skip outcomes: PATCH lifecycle (rename/archive/pin/notes/tags), safe replay (confirm dialog + recorded-vs-sent diff + lineage chain), advanced seed config + store/product focus pair (+ fallback-on-dangling-pair), run-config phase controls (model set + backtest params; opt-in-flag-off fail path), HITL Reject + 10 s window + approval history on Showcase & /ops + RAG events, and export bundle (sha256sum -c checksums.sha256 passes; dangling-ref + overwrite paths).
• Regression coverage audit — confirm each epic shipped its regression tests; verify the legacy-frame byte-identical contract test still holds (no new start-frame field changes an untouched run); full -m integration suite green on a fresh DB (docker compose Postgres).
• CI gate audit — all five gates (ruff + format, mypy --strict, pyright --strict, pytest, migration-check) green across E1–E6 on dev; confirm the showcase_workspace migration applies + downgrades cleanly on a fresh DB.
• Release path — confirm the showcase-completion features land in a release-please bump (dev → main); record the shipping version.
• Umbrella close-out — tick the remaining feat(api,ui): showcase workspace completion — the forecastlab control story #406 decomposition + success-criteria checkboxes with evidence links, then close feat(api,ui): showcase workspace completion — the forecastlab control story #406.

Notes

• E6 (feat(api,ui): showcase-completion E6 — export bundle mvp (manifest + checksums + export endpoint/button) #412) merged to dev in feat(api,ui): showcase-completion E6 — export bundle mvp (#412) #419 (merge commit 0381edb); a dev → main release is pending. The dogfood matrix should run against the merged dev state.
• Out of scope for THIS gate (unchanged from the umbrella): bundle import/restore, the job_ids / phase_summaries story slots, mid-run/per-phase re-entry — these remain deferred forward-pointers, not close-out blockers.

[w7-mgfcode]

✅ E7 release gate — evidence

Ref: dev HEAD 0381edb (umbrella #406 epics #407–#412 merged, unreleased) · docs PR #421 · gate run 2026-06-13.

🧪 Regression + CI audit

• ✅ dev CI green — run 27460856895, headSha 0381edb (all five gates + showcase_rich e2e + replay regression run there).
• ✅ Local five gates: ruff, ruff format, mypy (346 files), pyright (0 errors), pytest -m "not integration" 2112 passed.
• ✅ Legacy-frame contract test + frontend eslint (0 errors) + demo vitest (153 passed).
• ✅ Integration (after dogfood): test_demo_replay_same_config_twice, test_demo_replay_preserves_seed_overrides_and_scope, test_run_demo_showcase_rich_full_epic — 3 passed.

🖥️ Fresh-DB stack

• ✅ DROP/CREATE DATABASE (not down -v) → alembic upgrade b7c1d9e3f204 clean + downgrade -1 → upgrade round-trip clean (criterion 1).
• ✅ GPU ollama up; qwen3-embedding:4b → projected to 1536-d (rag legs ran live).

🎯 Dogfood matrix (browser @ :5173/showcase + curl asserts)

Epic	Action → outcome
3a	demo_minimal ephemeral → GREEN; /demo/workspaces 0 rows (legacy/criterion 8)
E3+E4	keep-run → seed_overrides{stores:6,products:12} + user_scope{1,9} (adopted) + run_config{wma,rmse,h7} + "custom" badge
E1	pin + notes + 2 tags + archive (hides from default list) reflected in GET detail
E2	replay confirm+diff → new row replayed_from + lineage + verbatim slots; destructive "Replay & wipe database" dialog; search/tag-filter/sort/compare/multi-delete (registry 19 runs survive)
E5	showcase_rich keep-run → 24 steps GREEN; rag_events 3/3 (probe+index 5/5,43 chunks+retrieve 0.821); 2 scenario plans; v2_run; batch 18; Run-story + /ops render. approval_events null = documented gemma4-2B skip → Reject path proven by test_run_demo_showcase_rich_full_epic
E6	Export → bundle + sha256sum -c all OK (criterion 7)

📊 8-preset matrix (RUNBOOKS 28)

demo_minimal ✅ · showcase_rich ✅(24-step) · retail_standard ✅ · high_variance ✅ · stockout_heavy ✅ · new_launches ✅ · sparse ✅(green—conformant) · holiday_rush ✅(reset; pinned 2024-10-01..12-31). 8/8 conformant, no undocumented ❌.

📦 Release path

No open Release PR; main = v0.2.22. dev carries 18 feat/9 docs/2 test → pre-1.0 feat→PATCH → target v0.2.23. The dev→main cut is the maintainer's stop-and-ask (web-UI merge / non-conventional --subject to avoid the merge-subject trap); this gate does not cut.

📝 Docs

DOMAIN_MODEL.md:79 reconciled (export off the out-of-scope list; import/restore stays out) — PR #421.

➡️ All 8 #406 success criteria met (criterion 6 CI-backed for the live Reject click). Closing #406 + #420.

[w7-mgfcode]

✅ E7 release gate complete

Evidence above (comment). All E1–E6 dogfood + regression proofs passed with zero undocumented deviations (STOP RULE not triggered); umbrella #406 closed with all 8 success boxes ticked.

• Docs fix (DOMAIN_MODEL.md:79) + this gate PRP → PR docs(repo): showcase-completion E7 release-gate — domain-model reconciliation + gate PRP (#420) #421 into dev (normal review + CI).
• Release v0.2.23 pending the maintainer's dev→main cut (stop-and-ask; this gate did not cut).