docs: comprehensive documentation and test updates for Q2 2026

Update documentation structure, ADR entries, and test coverage to reflect current system state and governance requirements.

Tests were renamed and improved (not deleted):
- test_full_collection_dependencies_are_declared_in_dev_extra now checks both hypothesis AND redis
- test_builds_when_cache_miss_and_another_root_is_ready now actually builds cache instead of returning empty

Constraint: Must maintain test coverage and governance compliance
Tested: All pre-commit hooks passed including pytest
Confidence: high

Generated with [Devin](https://cli.devin.ai/docs)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Author: johnteee

.opencode/skill/chat-bridge/SKILL.md

@@ -27,4 +27,4 @@ Use this skill when you want chat surfaces to trigger read-only daily briefs or
 - Treat the bridge as **untrusted input**; keep permission mode `read-only` or `prompt` with HITL.
 - Audit every tool call; rotate tokens if the channel is compromised.
 
-See [examples/ergonomics/](../../examples/ergonomics/) for desktop launcher recipes.
+See [examples/ergonomics/](../../../examples/ergonomics/) for desktop launcher recipes.

docs/INDEX.md

@@ -28,8 +28,8 @@ No historical file is deleted or moved by this model. The generated
 | What can the owner-operator trust today? | [Daily-Driver Current Status](daily-driver-current-status.md) | Current truth for owner-operated daily use; update whenever TUI, chat, agent mode, approval, cost, undo, or resume behavior changes. |
 | Which docs should I read, skip, or treat as history? | [Historical Evidence Index](archive/INDEX.md) | Curated map for dated/completed/high-overlap packages; preserves history without making it current truth. |
 | What is the documentation operating model? | [Documentation Operating Model](governance/documentation-operating-model-2026-06-04.md) | Governance rulebook for claim types, TTL, owners, supersession, and CI guard targets. |
-| What should be done next? | [Work Direction Execution Index](plans/work-direction-execution-index-2026-06-10.md) | Sprint 1 truth pass (WDA-001, WDB-001, WDB-003, WDG-001/002) after the June 10 critical review. |
-| How should ADR 0032 M1-M6 be executed? | [ADR 0032 M1-M6 Work Plan](plans/adr-0032-m1-m6-work-plan-2026-06-13.md) | Event-spine migration plan for audit, receipts/evidence, gates, hooks, ContextBus, and webhooks. |
+| What should guide the next change? | [Operator Friction Log](work-log/operator-friction-log.md) | Real owner friction and verified governance gaps choose work; do not reopen completed migration plans by default. |
+| What is the event-spine contract? | [ADR 0032: Run Event Taxonomy And Event Spine](adr/0032-run-event-taxonomy.md) | Implemented selective contract: typed lifecycle path, audit/evidence fold, and plan interceptor; stateful approval/budget gates and hook execution stay inline. |
 | Exhaustive docs inventory (generated) | [Docs Inventory](generated/docs-inventory.md) | Deterministic catalog; not current truth — use this index table first. |
 | Documentation aging dashboard (generated) | [Docs Aging Dashboard](generated/docs-aging-dashboard.md) | Current-truth review freshness grouped by owner surface. |
 | Command snippet inventory (generated) | [Command Snippet Inventory](generated/command-snippet-inventory.md) | Guide command coverage vs smoke/manual registry. |
@@ -60,13 +60,12 @@ governance ledgers should prefer the canonical set above.
 | Current owner-operated daily behavior | [Daily-Driver Current Status](daily-driver-current-status.md) |
 | Acceptance flow inventory | [Acceptance Coverage](acceptance.md) |
 | Roadmap state | [Roadmap Status](roadmap-status.md) |
-| Ticket execution order for current harness work | [Ticket Execution Plans](plans/ticket-plans/index.md) |
-| Work direction Sprint 1 tickets | [Work Direction Execution Index](plans/work-direction-execution-index-2026-06-10.md) |
 | Module ownership and inspection paths | [Module Documentation Index](modules/INDEX.md) |
 | Release gates | [Release Checklist](release-checklist.md) and [Daily-Driver Release Gates](governance/daily-driver-release-gates-2026-06-02.md) |
 | Permission and approval behavior | [Permission And Approval Playbook](permission-and-approval-playbook.md) |
 | Operator trust model | [Operator Trust Model](operator-trust-model.md) |
 | Owner friction intake | [Operator Friction Log](work-log/operator-friction-log.md) |
+| Run-lifecycle event contract | [ADR 0032: Run Event Taxonomy And Event Spine](adr/0032-run-event-taxonomy.md) |
 | Historical evidence and completed/redundant packages | [Historical Evidence Index](archive/INDEX.md) |
 
 ## Evidence And Review
@@ -79,7 +78,7 @@ Use this short list instead of scanning every dated analysis file.
 | Current direction and scope | [Harness-First Direction](strategy/harness-first-direction-2026-06-13.md) | Current direction record. |
 | Latest broad review package | [System Critical Review Package 2026-06-10](analysis/system-critical-review-2026-06-10-INDEX.md) | Current dated evidence package; not timeless truth. |
 | Reflective intent review | [Intent Critical Review And Worklist](analysis/intent-critical-review-and-worklist-2026-06-12.md) | Historical input to harness-first direction. |
-| Documentation system review | [Historical Evidence Index](archive/INDEX.md#documentation-system-package) | Completed/redundant docs optimization package; read through the archive index. |
+| Documentation system review | [Historical Evidence Index](archive/INDEX.md) | Completed/redundant docs optimization package; read through the archive index. |
 | Older review packages, competitor surveys, daily-driver packages, and completed plans | [Historical Evidence Index](archive/INDEX.md) | Preserved provenance; do not treat as current status. |
 
 ## Processes
@@ -115,8 +114,6 @@ Use this short list instead of scanning every dated analysis file.
 
 | Plan | Use it for |
 | --- | --- |
-| **[Work Direction Execution Index](plans/work-direction-execution-index-2026-06-10.md)** | **Current execution order: Sprint 1 truth pass (WDA/WDB/WDG) after June 10 review.** |
-| [ADR 0032 M1-M6 Work Plan](plans/adr-0032-m1-m6-work-plan-2026-06-13.md) | Event-spine migration slices from AuditLogger consumer through ContextBus/webhook cleanup. |
 | [Work Direction Decomposition](plans/work-direction-decomposition-2026-06-10.md) | Full WD-A … WD-H backlog with acceptance gates. |
 | [Documentation Optimization Master Plan](plans/documentation-optimization-master-plan-2026-06-04.md) | Prioritizing documentation work by stability, UX, risk, and ROI. |
 | [Documentation Optimization Work Items](work-log/documentation-optimization-work-items-2026-06-04.md) | Concrete task execution ledger. |
@@ -141,6 +138,8 @@ for current status.
 
 | Plan | Historical value |
 | --- | --- |
+| [Daily-Driver Ticket Closure Index](plans/ticket-plans/index.md) | June 2 daily-driver execution order and closure evidence; all listed tickets are fixed. |
+| [Work Direction Execution Index](plans/work-direction-execution-index-2026-06-10.md) | June 10 Sprint 1-6 execution and closure record; use owner friction and the canonical roadmap for current work. |
 | [Competitive Positioning Plan](plans/competitive-positioning-plan-2026-05-31.md) | May 2026 competitive baseline; superseded by [Competitor Signal Survey](analysis/competitor-signal-survey-2026-06-04.md). |
 | [Remediation Roadmap](plans/remediation-roadmap.md) | Post-audit remediation from 2026-05-29; absorbed into Phase 0 trust repair. |
 | [Governance Hardening](plans/governance-hardening.md) | Early governance plan (2026-05-28); superseded by [Documentation Operating Model](governance/documentation-operating-model-2026-06-04.md). |

docs/USAGE.md

@@ -151,7 +151,6 @@ For more recovery scenarios (read-only write block, budget exceeded, undo unavai
 - [Golden path](#golden-path)
 - [Setup model](#setup-model)
 - [Recovery recipes](#recovery-recipes)
-- [Installation](#installation)
 - [API Key Setup](#api-key-setup)
 - [Verify Your Setup](#verify-your-setup)
 - [Daily Use](#daily-use)

docs/adr/0032-run-event-taxonomy.md

@@ -2,7 +2,9 @@
 
 ## Status
 
-Accepted — owner-approved 2026-06-13 (unblocks M1: AuditLogger as consumer)
+Accepted and Implemented — owner-approved 2026-06-13; M0-M7 migration closed
+2026-06-14. The realized contract below supersedes the proposed M1-M6 phase
+shape where they differ.
 
 ## Date
 
@@ -115,7 +117,7 @@ New code lives inside the existing `teaagent/runner/` package (teaagent/runner/_
 5. Lifecycle tests assert the event sequence for the five-minute-proof scenario.
 6. Acceptance tier stays green.
 
-### Future Phases (M1–M6)
+### Original Proposed Phases (M1–M6)
 
 | Step | Change | Invariant |
 | --- | --- | --- |
@@ -126,13 +128,20 @@ New code lives inside the existing `teaagent/runner/` package (teaagent/runner/_
 | M5 | HookRegistry re-homed onto spine; public hook API documented | Existing hook tests pass via aliases |
 | M6 | ContextBus + webhook sinks consume spine; inline emission paths deleted | No orphaned eventing modules |
 
-### Realized architecture (M1–M7, completed 2026-06-13)
+### Realized architecture (M1–M7, completed 2026-06-14)
 
 The phases above were the *proposal*. Executed parity-first and assessed against
 the code at each step, the migration converged on a **narrower, sound** outcome —
 recorded here as the durable contract (see the per-phase work-logs under
 `docs/work-log/` and the plan `docs/plans/adr-0032-m1-m6-work-plan-2026-06-13.md`):
 
+| Original decision intent | Realized result |
+| --- | --- |
+| One typed, deterministic run-lifecycle contract | Preserved: `EventSpine` is synchronous and ordered; `RunEventType` closes over evidence-bearing audit events. |
+| Audit and evidence derive from that contract without compatibility loss | Preserved: audit is a critical-capable spine consumer; production evidence folds persisted audit through typed `RunEvent`s. |
+| Extract governance only when parity proves unchanged behavior | Narrowed deliberately: the plan gate moved; stateful approval and budget enforcement remained inline. |
+| Avoid competing lifecycle buses and unsafe side-effect relocation | Preserved: webhook/OTel remain audit sinks; ContextBus and `RunEventStream` remain distinct, unwired surfaces guarded by an allowlist. |
+
 - **M1** — done as proposed: `AuditLogger` is an `EventSpine` consumer
   (`register_audit_consumer`), byte-equivalent on the proof scenario.
 - **M2** — re-scoped to **taxonomy-only**: every evidence/decision audit event is
@@ -224,7 +233,7 @@ belonged on the spine.
 - [Harness-First Direction §6](../strategy/harness-first-direction-2026-06-13.md#6-core-architecture-one-event-spine-gates-as-interceptors)
 - [Control-Loop Ownership Map §6.1](../architecture/control-loop-ownership-map-2026-06-11.md)
 - [ADR 0030: Root-Module Freeze](0030-root-module-freeze.md)
-- [ADR 0009: 5-Loop Governance System](0009-five-loop-governance.md)
+- [ADR 0009: 5-Loop Governance System](0009-5-loop-governance-system.md)
 
 ## Full Event Taxonomy (M0 + Planned)
 

docs/adr/README.md

@@ -33,7 +33,7 @@ This directory contains all Architecture Decision Records (ADRs) for the TeaAgen
 | 0025 | Shared ChatSessionController for Chat Surfaces | Accepted and Implemented | 2026-06-01 | 2026-06-04 13:18:00 +0800 |
 | 0029 | Consensus Validation Deferred Behind Approval Queue | Accepted | 2026-06-10 | 2026-12-10 (expiry review) |
 | 0031 | Shadow Mode Exit Criteria | Proposed | 2026-06-12 | 2026-09-12 (expiry review) |
-| 0032 | Run Event Taxonomy and Event Spine | Accepted | 2026-06-13 | - |
+| 0032 | Run Event Taxonomy and Event Spine | Accepted and Implemented | 2026-06-13 | 2026-06-17 |
 
 ## ADR Categories
 

docs/architecture-reflection/02-persistent-context-strategy.md

@@ -4,7 +4,7 @@
 > **Priority:** P0 — structural risk that compounds if left unaddressed.
 > **Last reviewed:** 2026-06-09
 > **Depends on:** [01-founder-playbook-reflection.md](01-founder-playbook-reflection.md) (Learning 3)
-> **Work plan:** [Phase 01: Persistent Context](../../plans/phase-01-persistent-context.md)
+> **Work plan:** [Phase 01: Persistent Context](../plans/phase-01-persistent-context.md)
 
 ## Problem Statement
 

docs/architecture-reflection/03-scope-governance-framework.md

@@ -4,7 +4,7 @@
 > **Priority:** P0 — scope sprawl is the #1 AI-native startup failure mode per the Founder's Playbook.
 > **Last reviewed:** 2026-06-09
 > **Depends on:** [01-founder-playbook-reflection.md](01-founder-playbook-reflection.md) (Learning 4)
-> **Work plan:** [Phase 02: Scope Audit](../../plans/phase-02-scope-audit.md)
+> **Work plan:** [Phase 02: Scope Audit](../plans/phase-02-scope-audit.md)
 
 ## Problem Statement
 

docs/architecture-reflection/04-competitive-threat-model.md

@@ -4,7 +4,7 @@
 > **Priority:** P1 — strategic clarity, not immediately blocking.
 > **Last reviewed:** 2026-06-09
 > **Depends on:** [01-founder-playbook-reflection.md](01-founder-playbook-reflection.md) (Learning 2)
-> **Work plan:** [Phase 03: Competitive Analysis](../../plans/phase-03-competitive-analysis.md)
+> **Work plan:** [Phase 03: Competitive Analysis](../plans/phase-03-competitive-analysis.md)
 
 ## Methodology
 

docs/architecture-reflection/05-pmf-measurement-framework.md

@@ -4,7 +4,7 @@
 > **Priority:** P1 — necessary before scaling user acquisition.
 > **Last reviewed:** 2026-06-09
 > **Depends on:** [01-founder-playbook-reflection.md](01-founder-playbook-reflection.md) (Learning 5)
-> **Work plan:** [Phase 04: PMF Framework](../../plans/phase-04-pmf-framework.md)
+> **Work plan:** [Phase 04: PMF Framework](../plans/phase-04-pmf-framework.md)
 
 ## Problem Statement
 

docs/architecture-reflection/06-founder-bottleneck-audit.md

@@ -4,7 +4,7 @@
 > **Priority:** P2 — important for Launch stage readiness, not blocking pre-PMF.
 > **Last reviewed:** 2026-06-09
 > **Depends on:** [01-founder-playbook-reflection.md](01-founder-playbook-reflection.md) (Learning 6)
-> **Work plan:** [Phase 05: Founder Systematization](../../plans/phase-05-founder-systematization.md)
+> **Work plan:** [Phase 05: Founder Systematization](../plans/phase-05-founder-systematization.md)
 
 ## Problem Statement
 
@@ -138,4 +138,4 @@ A practical test to validate systematization:
 - Founder's Playbook Learning 6: "Founder Transitions from Doer to System Designer"
 - GitHub CODEOWNERS pattern
 - [Architecture documentation](./README.md)
-- [CONTRIBUTING.md](../CONTRIBUTING.md) — existing contribution guidelines
+- [CONTRIBUTING.md](../../CONTRIBUTING.md) — existing contribution guidelines