Epic: v0.8 native Code Mower Board

[jeffhuber]

Goal

Turn the v0.7 board MVP into Code Mower's native transparency layer: a local-first control room for lane activity, reviewer evidence, spend, latency, owner escalations, and historical run state.

Scope

• Stable local board/event schema for PRs, lanes, verdicts, checks, workflow runs, spend, latency, and next actions.
• Local event store under .code-mower/board using metadata-only JSONL or SQLite.
• Live updates via polling or server-sent events.
• Rich lane and PR timeline views.
• Owner escalation queue and weekly/digest-style visibility.
• Optional agent adapters for Claude, Codex, Cursor/Grok Bot, Antigravity, Devin, and reviewers, each metadata-only and opt-in.
• CodeMower.com display parity for uploaded metadata, while keeping the server backward-compatible with existing beta uploads.
• Admin tooling: board doctor, board open, safe reset, port selection, redaction controls.

Proposed Child Issues

1. Board data contract v1 and docs/cloud-data-contract alignment for any upload shape changes.
2. Local event store with retention and redaction rules.
3. Live board updates from GitHub checks, labels, workflow runs, and local Code Mower artifacts.
4. Spend/latency and reviewer verdict timeline panels.
5. Owner queue panel for needs-owner, blocked audits, stale gates, and next action.
6. Optional metadata-only agent adapters.
7. CodeMower.com board mirror using the same metadata contract.
8. Board doctor/admin commands.
9. Public demo/rehearsal artifact for adoption announcement.

Acceptance Criteria

• Operators can answer what is active, what is blocked, what is waiting, what it cost, and what to do next from one local board.
• The board remains useful if GitHub is temporarily unavailable by showing local artifacts and clearly marking remote state unavailable.
• All adapters are opt-in, metadata-only, and non-mutating unless a command explicitly says otherwise.
• CodeMower.com consumes only documented metadata and remains backward-compatible with v0.6/v0.7 uploads.

Privacy Boundary

No source, raw diffs, transcripts, issue body text, raw stdout/stderr, auth output, browser history, or secrets. Local paths are redacted by default in shareable views.

[jeffhuber]

Progress update: v0.8 board data contract slice is complete.

• Closed v0.8: document board data contract v1 #511 via PR Document board data contract v1 #512.
• Merged commit: dd8aedd.
• Scope: documented code_mower.laneStatus.v1 and code_mower.board.v1, clarified that board/status JSON is local-only and not uploaded by default, and aligned docs/cloud-data-contract.md with the paired OSS/dashboard rule for any future mirror.
• Verification: ruff on touched tests, focused board/release-hygiene tests, and full unittest discovery all passed; 661 tests total.
• Review/gate: Claude audit PASS, Gitar PASS, Code Mower gate PASS.
• CodeMower.com metadata upload: reviewer_run uploaded, id 0f23e7e5-8fb0-4702-befb-c0894dc1d4ec.

Next: start the local board event store slice so the native board can show history/timelines without widening the upload boundary.

[jeffhuber]

Progress update: v0.8 local board event store is complete.

• Closed v0.8: add local board event store #513 via PR Add local board event store #514.
• Merged commit: 4c6532d.
• Scope: added explicit local board record/events commands, .code-mower/board/events.jsonl, boardEvent/boardEventStore/boardRecord schemas, read-only /api/events, deterministic retention, and docs.
• Fix round: Claude correctly blocked read-error data loss, concurrent record lost-update risk, and record JSON schema mismatch. The fix added locked read/modify/write, abort-on-read-error writes, bad-timestamp pruning, clean invalid-arg errors, and a distinct boardRecord schema.
• Verification: ruff on touched files, CLI temp-store smoke for board record/events/invalid retention, focused tests, and full unittest discovery passed; 667 tests total.
• Review/gate: Claude audit BLOCKED then PASS, Gitar PASS, Code Mower gate PASS.
• CodeMower.com metadata upload: reviewer_run sequence uploaded, id 9e8a35bf-3eda-4934-a269-0971e56ef1c6.

Next: start live board updates from GitHub checks, labels, workflow runs, and local Code Mower artifacts.

[jeffhuber]

Progress update for v0.8 Board:

Done: #515 / PR #516 landed.

What changed:

• Board serve now has explicit live local-history recording behind --record-events.
• Plain board serve remains read-only.
• Live recording is interval-throttled, uses the local redacted event store, and reports safe recording status in the Board payload.
• Event-store read errors now use generic safe messages without local path details.

Verification:

• Ruff focused check passed.
• Focused Board and release-hygiene tests passed.
• Full unittest discovery passed: 673 tests.
• CLI help smoke confirmed the new serve flags.
• Claude audit PASS.
• Gitar PASS.
• Code Mower gate SUCCESS.
• CodeMower.com metadata-only reviewer-run upload succeeded: e8ecf59b-9cd3-4c22-b0a3-212475d87a96.

Next: starting the spend, latency, and verdict timeline slice for the native Board.

[jeffhuber]

Progress update for v0.8 Board:

Done: #517 / PR #518 landed.

What changed:

• Board status API now embeds a local-only timelines payload.
• Reviewer verdict history is derived from local board event snapshots.
• Spend and latency groups are derived from reviewer-spend.json when present, with an optional spend path override for board serve.
• Browser Board now renders reviewer verdict and spend/latency panels.
• Timeline docs were added to the Board data contract; no cloud upload shape changed.

Verification:

• Ruff focused check passed.
• Focused Board and release-hygiene tests passed.
• Full unittest discovery passed: 676 tests.
• CLI help smoke confirmed the new spend path flag.
• Claude audit PASS.
• Gitar PASS.
• Code Mower gate SUCCESS.
• CodeMower.com metadata-only reviewer-run upload succeeded: 5d4eebf6-fdce-474d-8325-87969fb5f953.

Next: starting the owner queue panel for needs-owner, blocked audits, stale gates, and next action.