test(launcher): add e2e smoke suite and CI gates

backlog/tasks/task-82 - Add-end-to-end-smoke-suite-for-launcher-mpv-ipc-and-overlay-runtime.md

@@ -1,11 +1,11 @@
 ---
 id: TASK-82
 title: Add end-to-end smoke suite for launcher mpv ipc and overlay runtime
-status: In Progress
+status: Done
 assignee:
   - codex-task82-smoke-20260222T002523Z-3j7u
 created_date: '2026-02-18 11:43'
-updated_date: '2026-02-22 00:27'
+updated_date: '2026-02-22 00:55'
 labels:
   - testing
   - e2e
@@ -47,10 +47,10 @@ Current coverage is strong at unit/service level but thin on end-to-end behavior
 
 ## Acceptance Criteria
 <!-- AC:BEGIN -->
-- [ ] #1 E2E smoke suite exists and runs in automated workflow
-- [ ] #2 Core launcher/mpv/ipc/overlay startup scenarios are covered
-- [ ] #3 Failures produce actionable logs/artifacts
-- [ ] #4 Smoke suite documented in development/release docs
+- [x] #1 E2E smoke suite exists and runs in automated workflow
+- [x] #2 Core launcher/mpv/ipc/overlay startup scenarios are covered
+- [x] #3 Failures produce actionable logs/artifacts
+- [x] #4 Smoke suite documented in development/release docs
 <!-- AC:END -->
 
 ## Implementation Plan
@@ -94,10 +94,34 @@ Scope guardrails
 
 <!-- SECTION:NOTES:BEGIN -->
 2026-02-22: Started execution with opencode-task82-smoke-20260222T002150Z-p5bp via writing-plans -> executing-plans workflow.
+
+Implemented launcher e2e smoke suite in `launcher/smoke.e2e.test.ts` using local fake `mpv` + fake app binaries, temp config/runtime sockets, and assertions for mpv status readiness, launcher startup wiring (`--backend`, `--socket`), IPC socket forwarding, overlay env propagation (`SUBMINER_MPV_LOG`), and post-mpv overlay stop command.
+
+Added automation wiring: `package.json` scripts (`test:launcher:smoke:src`) and CI/release quality-gate steps to run smoke suite plus upload `.tmp/launcher-smoke/**` artifacts on failure in `.github/workflows/ci.yml` and `.github/workflows/release.yml`.
+
+Documented smoke workflow and artifact triage in `docs/development.md` and release/pre-release verification guidance in `docs/installation.md`.
+
+Verification evidence: `bun run test:launcher:smoke:src` PASS, `bun run test:launcher` PASS, `bun run test:fast` PASS, `bun run docs:build` PASS. `bun run build && bun run test:smoke:dist` remains blocked by pre-existing unrelated TASK-80 IPC typing errors in `src/core/services/ipc.ts` + `src/core/services/ipc.test.ts`.
+
+2026-02-22: Implemented launcher smoke suite at `launcher/smoke.e2e.test.ts` with deterministic fake mpv/app harness and preserved failure artifacts under `.tmp/launcher-smoke/<case-id>`.
+
+2026-02-22: Wired source smoke lane into automation: `package.json` (`test:launcher:smoke:src`), `.github/workflows/ci.yml` and `.github/workflows/release.yml` now run the lane and upload `.tmp/launcher-smoke/**` artifacts on failure.
+
+2026-02-22: Updated docs with smoke command + release gate reference and artifact guidance in `docs/development.md` and `docs/installation.md`.
+
+2026-02-22 verification: `bun run test:launcher:smoke:src`, `bun run test:launcher`, `bun run test:fast`, `bun run build && bun run test:smoke:dist`, `bun run docs:build`.
+
+2026-02-22 correction: `bun run build && bun run test:smoke:dist` passes in current workspace; prior note about TASK-80-related blockage is stale from earlier intermediate run.
 <!-- SECTION:NOTES:END -->
 
+## Final Summary
+
+<!-- SECTION:FINAL_SUMMARY:BEGIN -->
+Added an end-to-end launcher smoke suite that exercises launcher->mpv IPC socket lifecycle plus overlay start/stop runtime wiring using deterministic local fake mpv/app fixtures and artifact-preserving failure output. Integrated the smoke lane into CI and release quality gates with failure artifact uploads, documented local/release usage, and verified all required test/build/docs lanes pass.
+<!-- SECTION:FINAL_SUMMARY:END -->
+
 ## Definition of Done
 <!-- DOD:BEGIN -->
-- [ ] #1 Smoke suite passes on baseline branch
-- [ ] #2 Release checklist references smoke suite
+- [x] #1 Smoke suite passes on baseline branch
+- [x] #2 Release checklist references smoke suite
 <!-- DOD:END -->