fix(plugin): allow cold-start overlay launch without running process

docs/subagents/INDEX.md

@@ -95,4 +95,6 @@ Read first. Keep concise.
 | `codex-docs-video-thumb-cache-20260223T033929Z-k8p2` | `codex-docs-video-thumb-cache` | `Fix docs landing page demo video thumbnail staleness after direct asset replacement.` | `handoff` | `docs/subagents/agents/codex-docs-video-thumb-cache-20260223T033929Z-k8p2.md` | `2026-02-23T03:44:04Z` |
 | `codex-development-docs-review-20260223T034520Z-2ebb` | `codex-development-docs-review` | `Review codebase and refresh docs/development.md to match current project state.` | `done` | `docs/subagents/agents/codex-development-docs-review-20260223T034520Z-2ebb.md` | `2026-02-23T03:49:16Z` |
 | `opencode-bun-migration-20260223T043000Z-k9m2` | `opencode-bun-migration` | `Execute TASK-115 Bun-only migration plan: parity map, dist/utility script migration, CI/docs cutover.` | `handoff` | `docs/subagents/agents/opencode-bun-migration-20260223T043000Z-k9m2.md` | `2026-02-23T04:36:00Z` |
-| `opencode-initial-release-plan-20260223T044059Z-p7k2` | `opencode-initial-release-plan` | `Analyze main history and draft copy/paste initial-release history-cleanup plan.` | `planning` | `docs/subagents/agents/opencode-initial-release-plan-20260223T044059Z-p7k2.md` | `2026-02-23T04:40:59Z` |
+| `opencode-initial-release-plan-20260223T044059Z-p7k2` | `opencode-initial-release-plan` | `Analyze main history and draft copy/paste initial-release history-cleanup plan.` | `handoff` | `docs/subagents/agents/opencode-initial-release-plan-20260223T044059Z-p7k2.md` | `2026-02-23T04:47:30Z` |
+| `codex-plugin-start-overlay-gate-20260223T044347Z-k3n8` | `codex-plugin-start-overlay-gate` | `Fix mpv plugin regression where start is refused if SubMiner process is not already running (TASK-117).` | `handoff` | `docs/subagents/agents/codex-plugin-start-overlay-gate-20260223T044347Z-k3n8.md` | `2026-02-23T04:47:40Z` |
+| `codex-commit-changes-20260223T050731Z-rer4` | `codex-commit-changes` | `Commit current working tree changes with a conventional commit message derived from content.` | `in_progress` | `docs/subagents/agents/codex-commit-changes-20260223T050731Z-rer4.md` | `2026-02-23T05:07:31Z` |

docs/subagents/agents/codex-commit-changes-20260223T050731Z-rer4.md

@@ -0,0 +1,26 @@
+# Agent: `codex-commit-changes-20260223T050731Z-rer4`
+
+- alias: `codex-commit-changes`
+- mission: `Commit current working tree changes requested by user with a content-derived conventional commit message.`
+- status: `in_progress`
+- branch: `main`
+- started_at: `2026-02-23T05:07:31Z`
+- heartbeat_minutes: `5`
+
+## Current Work (newest first)
+- [2026-02-23T05:07:31Z] intent: inspect diff scope, preserve existing user/agent edits, stage all current changes, and commit once with conventional format.
+
+## Files Touched
+- `docs/subagents/INDEX.md`
+- `docs/subagents/collaboration.md`
+- `docs/subagents/agents/codex-commit-changes-20260223T050731Z-rer4.md`
+
+## Assumptions
+- User request "commit changes" means commit all current working-tree changes.
+- No additional code edits are required beyond required coordination bookkeeping.
+
+## Open Questions / Blockers
+- None.
+
+## Next Step
+- Stage all changes and create one conventional commit message based on the diff.

docs/subagents/agents/codex-plugin-start-overlay-gate-20260223T044347Z-k3n8.md

@@ -0,0 +1,30 @@
+# Agent: `codex-plugin-start-overlay-gate-20260223T044347Z-k3n8`
+
+- alias: `codex-plugin-start-overlay-gate`
+- mission: `Fix mpv plugin regression where start is refused if SubMiner process is not already running (TASK-117).`
+- status: `handoff`
+- branch: `main`
+- started_at: `2026-02-23T04:49:00Z`
+- heartbeat_minutes: `5`
+
+## Current Work (newest first)
+- [2026-02-23T04:47:40Z] completed: patched cold-start gate in `plugin/subminer.lua`, added Lua regression harness, validated red->green + syntax + focused launcher mpv tests.
+- [2026-02-23T04:49:00Z] intent: reproduce root cause from user logs; add red test first; patch plugin start gate with minimal behavior change.
+
+## Files Touched
+- `plugin/subminer.lua`
+- `scripts/test-plugin-start-gate.lua`
+- `backlog/tasks/task-117 - Fix-mpv-plugin-overlay-start-gate-when-SubMiner-is-not-running.md`
+- `docs/subagents/INDEX.md`
+- `docs/subagents/collaboration.md`
+- `docs/subagents/agents/codex-plugin-start-overlay-gate-20260223T044347Z-k3n8.md`
+
+## Assumptions
+- Regression introduced by `is_subminer_ipc_ready()` check at start of `start_overlay()`.
+- Cold-start should not require pre-existing process; socket checks remain valid once process exists.
+
+## Open Questions / Blockers
+- None.
+
+## Next Step
+- User runtime verification: launch with `SUBMINER_APPIMAGE_PATH=... ./dist/launcher/subminer --log-level debug ...` and trigger `y-s`.

docs/subagents/agents/opencode-initial-release-plan-20260223T044059Z-p7k2.md

@@ -0,0 +1,35 @@
+# Agent: `opencode-initial-release-plan-20260223T044059Z-p7k2`
+
+- alias: `opencode-initial-release-plan`
+- mission: `Analyze main history and draft copy/paste initial-release history-cleanup plan.`
+- status: `handoff`
+- branch: `main`
+- started_at: `2026-02-23T04:40:59Z`
+- heartbeat_minutes: `5`
+
+## Current Work (newest first)
+
+- [2026-02-23T04:47:30Z] handoff: added `initial-release.md` with orphan-branch + curated-commit cutover commands, backup refs, validation checks, force-with-lease push, and team resync instructions.
+- [2026-02-23T04:44:30Z] progress: analyzed `main` history (325 commits; high refactor/noise skew) and confirmed release-shaped repo layout for snapshot regrouping.
+- [2026-02-23T04:40:59Z] intent: inspect commit history and current repository state, then write `initial-release.md` with exact cutover commands.
+
+## Files Touched
+
+- `docs/subagents/agents/opencode-initial-release-plan-20260223T044059Z-p7k2.md`
+- `docs/subagents/INDEX.md`
+- `docs/subagents/collaboration.md`
+- `initial-release.md`
+- `backlog/tasks/task-116 - Analyze-git-history-and-draft-initial-release-cleanup-plan.md`
+
+## Assumptions
+
+- history rewrite is allowed because repo is private and pre-release.
+- recommendation should prefer low-risk deterministic workflow over complex interactive rebase.
+
+## Open Questions / Blockers
+
+- none.
+
+## Next Step
+
+- share recommendation + path to `initial-release.md`; execute cutover during freeze window.

docs/subagents/collaboration.md

@@ -148,6 +148,8 @@ Shared notes. Append-only.
 
 ## 2026-02-23
 
+- [2026-02-23T04:49:00Z] [codex-plugin-start-overlay-gate-20260223T044347Z-k3n8|codex-plugin-start-overlay-gate] overlap note: touching `plugin/subminer.lua` start gate path for cold-start regression (`Refusing to start overlay: SubMiner process not running`); adding TASK-117 + focused regression harness.
+- [2026-02-23T04:47:40Z] [codex-plugin-start-overlay-gate-20260223T044347Z-k3n8|codex-plugin-start-overlay-gate] completed TASK-117: `start_overlay()` now allows cold-start when process absent; added `scripts/test-plugin-start-gate.lua` red/green regression harness; verified with `luac -p plugin/subminer.lua` and `bun test launcher/mpv.test.ts`.
 - [2026-02-23T01:10:27Z] [opencode-task109-discord-presence-20260223T011027Z-j9r4|opencode-task109-discord-presence] starting TASK-109 closure pass via Backlog MCP + writing-plans/executing-plans; scope validate existing Discord config/runtime/docs changes, close remaining DoD evidence, and finalize task status if gates pass.
 - [2026-02-23T01:15:39Z] [opencode-task109-discord-presence-20260223T011027Z-j9r4|opencode-task109-discord-presence] user feedback from real Discord session: status resumed to Playing with noticeable delay; tuned default `discordPresence.updateIntervalMs` from 15000 to 3000 in defaults/docs/examples and updated focused config expectations; reran focused config + discord presence tests green.
 - [2026-02-23T01:27:55Z] [codex-task88-yomitan-flow-20260223T012755Z-x4m2|codex-task88-yomitan-flow] starting TASK-88 via Backlog MCP + writing-plans/executing-plans; expected overlap in tokenizer modules (`src/core/services/tokenizer*`, Yomitan flow wiring/tests); will keep scope to MeCab fallback removal and token flow simplification.
@@ -169,3 +171,5 @@ Shared notes. Append-only.
 - [2026-02-23T04:30:00Z] [opencode-bun-migration-20260223T043000Z-k9m2|opencode-bun-migration] starting TASK-115 Bun-only migration execution; initial scope `package.json`, CI/release workflows, and setup docs to remove Node requirements after parity checks.
 - [2026-02-23T04:36:00Z] [opencode-bun-migration-20260223T043000Z-k9m2|opencode-bun-migration] completed TASK-115 Bun-only migration pass: dist/utility commands moved off direct Node invocation, CI/release Node setup removed, Bun parity matrix + docs updates landed, full Bun validation gate suite passed, and TASK-115 + child tasks finalized Done in Backlog.
 - [2026-02-23T04:40:59Z] [opencode-initial-release-plan-20260223T044059Z-p7k2|opencode-initial-release-plan] starting user-requested release-history cleanup planning pass; scope git-history analysis + current-state review + `initial-release.md` command playbook.
+- [2026-02-23T04:47:30Z] [opencode-initial-release-plan-20260223T044059Z-p7k2|opencode-initial-release-plan] completed planning pass: analyzed commit history/current state and added `initial-release.md` with recommended orphan-history + 7-commit split plan, validation, cutover, and teammate resync commands.
+- [2026-02-23T05:07:31Z] [codex-commit-changes-20260223T050731Z-rer4|codex-commit-changes] starting user-requested commit pass for current working tree; scope is stage all existing tracked/untracked changes and create conventional commit without additional behavior edits.