# Live Report Synchronization

audience: AI coding agents first.

status: ACTIVE
worker: bounded worker in `/home/user/Projects/overdeck/.worktrees/live-report-integrate`
task IDs: #90, #125, #146
source request: Keep `/home/user/.local/share/overdeck/reports/2026-08-08-session-report.html` synchronized after every transition; owner needs one honest live view. Current request: implement the smallest robust automatic regeneration hooks for land, deploy, dispatch verdict, and incident transitions; run focused tests plus collector typecheck; commit locally without push or deploy.

## Outcome

Report is generated from authoritative events/plan receipts, not manually drifting prose, and reflects every installed transition, blocker, and active worker.

## Preserved progress

- Report exists and was manually refreshed during recovery.
- It records many prior incidents and candidate refs.
- Current report predates plan-registry, latest offload proof, stopped k3s worker, and registry reconciliation.
- Manual editing is transitional; deterministic generator now lives in `collector/src/live-report/` and `collector/scripts/generate-live-report.ts`.

## Acceptance criteria

- Every ACTIVE plan/worker and current blocker appears.
- Installed/runtime claims match receipts.
- Regeneration is deterministic from durable sources.
- Refresh occurs automatically on land/deploy/dispatch verdict/incident.

## Execution steps

1. Refresh current report from plan index and receipts.
2. Locate existing report generator/event schema.
3. Make index/receipts authoritative inputs.
4. Trigger regeneration on real transitions.
5. Browser-prove output.

## Current receipt

- Generator implemented: `od-live-report` / `bun run collector/scripts/generate-live-report.ts`.
- Authoritative inputs: `docs/plans/INDEX.md`, per-plan `## Current receipt`, optional `~/.local/state/agent-sessions`.
- Regenerated on harness seat `2026-08-10T05:58:00Z` at `/seat-home/.local/share/overdeck/reports/2026-08-08-session-report.html` (owner path `/home/user/.local/share/overdeck/reports/...` not writable on this seat).
- Surfaces 5 ACTIVE workers, 1 BLOCKED plan, and Flow-First index/file status mismatch.
- `bun test collector/src/live-report/` → 3/3 pass.
- Automatic refresh hooks added after successful land, deploy, remote dispatch verdict, and incident resolution. Refresh failure is reported but never rewrites the completed transition verdict.
- Verification: hook test 1/1, incident CLI 10/10, remote dispatch 16/16, live-report 3/3, collector typecheck clean.
- Work is intentionally local-only: no install, push, deploy, or browser proof per current request.

## Next executable action

Install and invoke the landed `od-live-report` entrypoint, then browser-prove the owner report in the delivery lane that is allowed to deploy.
