update readme/docs

docs/subagents/INDEX.md

@@ -4,6 +4,7 @@ Read first. Keep concise.
 
 | agent_id     | alias          | mission                                              | status    | file                                  | last_update_utc        |
 | ------------ | -------------- | ---------------------------------------------------- | --------- | ------------------------------------- | ---------------------- |
+| `codex-generate-minecard-image-20260220T112900Z-vsxr` | `codex-generate-minecard-image` | `Generate media fallbacks (GIF) from assets/minecard.webm and wire README/docs fallback markup` | `done` | `docs/subagents/agents/codex-generate-minecard-image-20260220T112900Z-vsxr.md` | `2026-02-20T11:35:30Z` |
 | `codex-main` | `planner-exec` | `Fix frequency/N+1 regression in plugin --start flow` | `in_progress` | `docs/subagents/agents/codex-main.md` | `2026-02-19T19:36:46Z` |
 | `codex-config-validation-20260219T172015Z-iiyf` | `codex-config-validation` | `Find root cause of config validation error for ~/.config/SubMiner/config.jsonc` | `completed` | `docs/subagents/agents/codex-config-validation-20260219T172015Z-iiyf.md` | `2026-02-19T17:26:17Z` |
 | `codex-task85-20260219T233711Z-46hc` | `codex-task85` | `Resume TASK-85 maintainability refactor from latest handoff point` | `in_progress` | `docs/subagents/agents/codex-task85-20260219T233711Z-46hc.md` | `2026-02-20T02:56:34Z` |

docs/subagents/agents/codex-generate-minecard-image-20260220T112900Z-vsxr.md

@@ -0,0 +1,37 @@
+# Agent: `codex-generate-minecard-image-20260220T112900Z-vsxr`
+
+- alias: `codex-generate-minecard-image`
+- mission: `Generate media fallbacks (GIF) from assets/minecard.webm and wire README/docs fallback markup`
+- status: `done`
+- branch: `main`
+- started_at: `2026-02-20T11:29:09Z`
+- heartbeat_minutes: `5`
+
+## Current Work (newest first)
+- [2026-02-20T11:35:13Z] handoff: switched `README.md` demo embed to GitHub-mobile-safe GIF-first pattern (linked image + explicit WebM/MP4 links).
+- [2026-02-20T11:34:27Z] handoff: generated `assets/minecard.gif` (960x540 @ 12fps) and mirrored to `docs/public/assets/minecard.gif`; updated `README.md` + `docs/index.md` video sections to embed GIF fallback when video unsupported.
+- [2026-02-20T11:34:27Z] test: verified media files exist and fallback refs present via `rg`; GIF dimensions/fps validated with `ffprobe`.
+- [2026-02-20T11:33:36Z] intent: create GIF fallback from `assets/minecard.webm`; update `README.md` + `docs/index.md` video sections to include fallback content for unsupported video.
+- [2026-02-20T11:29:35Z] handoff: created `assets/minecard-image-1.png` from `assets/minecard.webm` at `00:00:10`; verified `1920x1080`.
+- [2026-02-20T11:29:35Z] test: confirmed output file exists and dimensions via `ffprobe`.
+- [2026-02-20T11:29:09Z] progress: updated subagent index/own record for this session.
+- [2026-02-20T11:29:09Z] intent: extract a new still image from `assets/minecard.webm`; keep change minimal.
+
+## Files Touched
+- `README.md`
+- `docs/index.md`
+- `docs/public/assets/minecard.gif`
+- `assets/minecard.gif`
+- `assets/minecard-image-1.png`
+- `docs/subagents/INDEX.md`
+- `docs/subagents/agents/codex-generate-minecard-image-20260220T112900Z-vsxr.md`
+
+## Assumptions
+- User wants a still frame image generated from the video source.
+- User now wants GIF fallback available where WebM playback may fail (README/docs).
+
+## Open Questions / Blockers
+- none currently
+
+## Next Step
+- Await user review; tune GIF size/quality if needed.

docs/subagents/agents/codex-preserve-linebreak-display-20260220T110436Z-r8f1.md

@@ -0,0 +1,29 @@
+# Agent: `codex-preserve-linebreak-display-20260220T110436Z-r8f1`
+
+- alias: `codex-preserve-linebreak-display`
+- mission: `Fix visible overlay display artifact when subtitleStyle.preserveLineBreaks is disabled.`
+- status: `done`
+- branch: `main`
+- started_at: `2026-02-20T11:04:36Z`
+- heartbeat_minutes: `5`
+- backlog_ticket: `TASK-91`
+
+## Current Work (newest first)
+- [2026-02-20T11:10:51Z] follow-up: switched non-preserve token rendering to source-aligned inline segments; skip unmatched overlap tokens that caused duplicate phrase rendering; added regression test for two-line + duplicate-tail token payload.
+- [2026-02-20T11:07:29Z] handoff: patched non-preserve token render path to flatten CR/LF into spaces (no `<br>` insertion); added regression test for formatter helper; build + renderer test pass.
+- [2026-02-20T11:04:36Z] intent: investigate renderer regression reported when `subtitleStyle.preserveLineBreaks=false`; add targeted regression test + minimal fix.
+- [2026-02-20T11:04:36Z] planned files: `src/renderer/subtitle-render.ts`, `src/renderer/subtitle-render.test.ts`, `docs/subagents/*`.
+- [2026-02-20T11:04:36Z] assumptions: artifact originates in token render path for non-preserve mode, likely newline handling in token surfaces.
+
+## Files Touched
+- `docs/subagents/INDEX.md`
+- `docs/subagents/collaboration.md`
+- `docs/subagents/agents/codex-preserve-linebreak-display-20260220T110436Z-r8f1.md`
+- `src/renderer/subtitle-render.ts`
+- `src/renderer/subtitle-render.test.ts`
+
+## Open Questions / Blockers
+- none.
+
+## Next Step
+- optional: capture one problematic payload from logs and extend formatter coverage if additional control chars appear.

docs/subagents/agents/codex-vitepress-subagents-ignore-20260220T101755Z-k2m9.md

@@ -0,0 +1,31 @@
+# Agent: codex-vitepress-subagents-ignore-20260220T101755Z-k2m9
+
+- alias: codex-vitepress-subagents-ignore
+- mission: Exclude docs/subagents from VitePress build
+- status: completed
+- branch: main
+- started_at: 2026-02-20T10:17:55Z
+- heartbeat_minutes: 5
+
+## Current Work (newest first)
+
+- [2026-02-20T10:18:30Z] handoff: added `srcExclude: ['subagents/**']` in `docs/.vitepress/config.ts`; verified `bun run docs:build` passes and no `subagents` routes emitted.
+- [2026-02-20T10:17:55Z] intent: answer whether VitePress can ignore `docs/subagents` and implement exclusion in config.
+
+## Files Touched
+
+- `docs/.vitepress/config.ts`
+- `docs/subagents/INDEX.md`
+- `docs/subagents/agents/codex-vitepress-subagents-ignore-20260220T101755Z-k2m9.md`
+
+## Assumptions
+
+- Excluding `docs/subagents/**` from docs routes is desired for both local dev and production docs builds.
+
+## Open Questions / Blockers
+
+- none
+
+## Next Step
+
+- none