Align current truth with owner-operated harness

Narrow the front-door docs, roadmap, and ADR 0032 language to what the repo can currently prove. Keep owner friction as real evidence only, with a lighter capture path and stricter closure semantics.

Constraint: Harness-first direction descopes external adoption and broad daily-driver claims from current truth until real owner or external evidence exists.

Rejected: Simulated owner friction or adoption proof | would repeat the closed-loop evidence problem this direction pass is trying to stop.

Confidence: high

Scope-risk: narrow

Directive: Do not cite aspirational adoption, hosted/team expansion, or simulated pilots as current roadmap evidence without a new evidence source.

Tested: .venv/bin/python -m pytest tests/test_docs_consistency.py -q; .venv/bin/python scripts/validate_event_spine_wiring.py; .venv/bin/python -m pytest tests/integration/test_audit_sink_isolation.py -q; .venv/bin/python -m pytest tests/acceptance/test_hook_lifecycle_flow.py -q; .venv/bin/python -m pytest tests/test_event_spine_wiring.py tests/lifecycle/test_run_event_spine.py -q; .venv/bin/python scripts/validate_docs_consistency.py; .venv/bin/python scripts/detect_stale_plans.py; git diff --check

Not-tested: Full repository test suite.

Author: johnteee

README.md

@@ -2,7 +2,7 @@
 
 > **Last reviewed:** 2026-06-13
 > **Review trigger:** README feature claims, golden path, or provider count changes.
-> **Direction record:** [Harness-First Direction](docs/strategy/harness-first-direction-2026-06-13.md) (owner-operator persona, aspirational adoption)
+> **Direction record:** [Harness-First Direction](docs/strategy/harness-first-direction-2026-06-13.md) (owner-operator harness-first current direction)
 
 A personal, local-first governance harness for autonomous coding tasks — built by and for the owner-operator who maintains, uses, and audits his own runs. Thin orchestration layer with tool governance, state boundaries, audit logging, and destructive-tool approval.
 

docs/INDEX.md

@@ -12,7 +12,7 @@ follow dated evidence documents only when you need the reasoning trail.
 
 | Need | Start here | Status rule |
 | --- | --- | --- |
-| What can a daily user trust today? | [Daily-Driver Current Status](daily-driver-current-status.md) | Current truth; update whenever TUI, chat, agent mode, approval, cost, undo, or resume behavior changes. |
+| 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. |
 | What is the current documentation-state assessment? | [Documentation State Review](analysis/documentation-state-review-2026-06-04.md) | Current dated evidence for corpus shape, drift risks, and consolidation priorities. |
 | 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. |
@@ -45,15 +45,16 @@ governance ledgers should prefer the canonical set above.
 
 | Question | Canonical source |
 | --- | --- |
-| Current daily-driver behavior | [Daily-Driver Current Status](daily-driver-current-status.md) |
+| 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 (daily-driver) | [Ticket Execution Plans](plans/ticket-plans/index.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) |
 
 ## Evidence And Review
 
@@ -94,10 +95,10 @@ governance ledgers should prefer the canonical set above.
 | June 6 risk and trust model critique | [Risk And Trust Model Critique](analysis/risk-and-trust-model-critique-2026-06-06.md) |
 | Phase 0-to-1 outlook | [Phase 0 To Phase 1 Outlook](strategy/phase-0-to-phase-1-outlook-2026-06-04.md) |
 | Malleable governed agent harness | [Malleable Governed Agent Harness](strategy/malleable-governed-agent-harness-2026-06-03.md) |
-| Daily-driver roadmap rationale | [Daily-Driver Roadmap Rationale](strategy/daily-driver-roadmap-rationale-2026-06-04.md) |
-| Daily-driver critique and counterarguments | [Daily-Driver Critique And Counterarguments](reviews/daily-driver-critique-and-counterarguments-2026-06-04.md) |
-| Daily-driver docs package review | [Daily-Driver Docs Package Review](reviews/daily-driver-docs-package-review-2026-06-02.md) |
-| Daily-driver red-team review | [Daily-Driver Red Team Review](reviews/daily-driver-red-team-review-2026-06-02.md) |
+| Historical daily-driver roadmap rationale | [Daily-Driver Roadmap Rationale](strategy/daily-driver-roadmap-rationale-2026-06-04.md) |
+| Historical daily-driver critique and counterarguments | [Daily-Driver Critique And Counterarguments](reviews/daily-driver-critique-and-counterarguments-2026-06-04.md) |
+| Historical daily-driver docs package review | [Daily-Driver Docs Package Review](reviews/daily-driver-docs-package-review-2026-06-02.md) |
+| Historical daily-driver red-team review | [Daily-Driver Red Team Review](reviews/daily-driver-red-team-review-2026-06-02.md) |
 
 ## Processes
 
@@ -107,8 +108,8 @@ governance ledgers should prefer the canonical set above.
 | Competitor gap watch | [OpenCode Gap Watch](processes/opencode-gap-watch.md) |
 | Community presence and dev-rel | [Community Presence](processes/community-presence.md) |
 | Post-fix re-audit | [Postfix Reaudit Process](processes/postfix-reaudit-process.md) |
-| Daily-driver verification | [Daily-Driver Verification](processes/daily-driver-verification.md) |
-| Daily-driver manual QA smoke | [Daily-Driver Manual QA Smoke](processes/daily-driver-manual-qa-smoke.md) |
+| Owner-operated daily verification | [Daily-Driver Verification](processes/daily-driver-verification.md) |
+| Owner-operated manual QA smoke | [Daily-Driver Manual QA Smoke](processes/daily-driver-manual-qa-smoke.md) |
 | Quarterly competitor refresh | [Quarterly Competitor Refresh Process](processes/quarterly-competitor-refresh.md) · [Release Checklist](release-checklist.md) |
 | Trust and audit whitepaper | [Trust and Audit Whitepaper](governance/trust-and-audit-whitepaper.md) |
 | When not to use TeaAgent | [When Not to Use TeaAgent](guides/when-not-to-use-teaagent.md) |
@@ -137,7 +138,7 @@ governance ledgers should prefer the canonical set above.
 | [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. |
-| [Daily-Driver Complete Work Plan](plans/daily-driver-complete-work-plan-risk-roi-2026-06-04.md) | Daily-driver risk, feasibility, ROI, and sequence. |
+| [Daily-Driver Complete Work Plan](plans/daily-driver-complete-work-plan-risk-roi-2026-06-04.md) | Historical daily-driver risk, feasibility, ROI, and sequence; use harness-first direction for current persona claims. |
 | [Roadmap Work Items](work-log/roadmap-work-items-2026-06-04.md) | Product roadmap work items and acceptance criteria. |
 | [Phase 0 Priority Work Items](work-log/phase-0-priority-work-items-2026-06-04.md) | Trust-repair tasks derived from project-state review. |
 | [Phase 0 Governance Closure Report](work-log/phase-0-governance-closure-report-2026-06-04.md) | Closure evidence for coverage omit, dependency audit, and ADR-state governance. |

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

@@ -56,15 +56,17 @@ register_interceptor(fn, *, name: str) -> None
   # Interceptors run in registration order before consumers
   # Exceptions propagate (veto semantics)
 
-register_consumer(fn, *, name: str) -> None
-  # Callable[[RunEvent], None]; never veto
+register_consumer(fn, *, name: str, critical: bool = False) -> None
+  # Callable[[RunEvent], None]; isolated by default
   # Consumers run after interceptors
-  # Exceptions are caught, logged, and isolated (never affect run)
+  # Exceptions are caught, logged, and isolated unless critical=True
+  # Critical consumers propagate to preserve required durability boundaries
 
-emit(event: RunEvent) -> None
+emit(type_: RunEventType, run_id: str, payload: Mapping[str, Any]) -> None
   # Fire an event: run interceptors in order, then consumers
   # If any interceptor raises, propagate immediately (no further subscribers run)
-  # If any consumer raises, log and continue
+  # If any non-critical consumer raises, log and continue
+  # If any critical consumer raises, propagate
   # Return normally on success or after isolated consumer failure
 ```
 
@@ -80,13 +82,15 @@ emit(event: RunEvent) -> None
 **Consumers:**
 - Represent audit, receipt building, evidence, ContextBus, webhook sinks
 - Run after all interceptors complete
-- Each wrapped in try/except (exception logged via logging module, never propagates)
-- Never affect the run (crash-safe)
+- Each wrapped in try/except by default (exception logged via logging module)
+- Non-critical consumers never affect the run (crash-safe)
+- Critical consumers may propagate when their side effect is part of the
+  required safety boundary, such as compliance-mode audit durability
 - Used for side effects and derived state
 
 ### 4. HookRegistry Alignment
 
-Existing Claude-Code hook names (SessionStart, PreToolUse, PostToolUse, etc.) are preserved as **aliases** to RunEventType members where semantically equivalent (e.g., PRE_TOOL_USE ← PreToolUse). The public hook API (teaagent/hooks.py) will be re-homed onto the spine in a later migration step (M5).
+Existing Claude-Code hook names (SessionStart, PreToolUse, PostToolUse, etc.) remain the public `teaagent/hooks.py` API. The spine taxonomy includes semantically equivalent typed hook-observability events (for example, `PRE_TOOL_USE`) so later integration can bridge the public hook API without changing hook names.
 
 ### 5. Compliance with ADR 0030
 
@@ -210,7 +214,7 @@ belonged on the spine.
 
 ```
 RUN_STARTED              # Run begins; payload: run_id, task, model, etc.
-SESSION_START            # Session begins (alias: SessionStart)
+SESSION_START            # Session begins; equivalent public hook: SessionStart
 PLAN_RESOLVED            # Plan loaded/validated
 ITERATION_STARTED        # Iteration loop begins
 DECISION_RECEIVED        # Model returns a decision (tool call or final answer)
@@ -228,15 +232,15 @@ RUN_FAILED               # Run ends in failure
 RUN_PENDING_APPROVAL     # Run paused for approval
 RUN_CANCELLED            # Run cancelled by user
 RECEIPT_EMITTED          # Receipt finalized
-SESSION_END              # Session ends (alias: SessionEnd)
+SESSION_END              # Session ends; equivalent public hook: SessionEnd
 SKILL_LOAD               # Skill loaded
 MODEL_ROUTE              # Model routed (provider selection)
 GIT_SANDBOX_STARTED      # Sandbox workspace initialized
 GIT_SANDBOX_RESOLVED     # Sandbox resolved/cleaned
 UNDO_PERFORMED           # Undo action executed
-PRE_TOOL_USE             # Hook: before tool execution (alias: PreToolUse)
-POST_TOOL_USE            # Hook: after tool execution (alias: PostToolUse)
-PRE_COMPACT              # Hook: before context compaction (alias: PreCompact)
+PRE_TOOL_USE             # Hook observability: before tool execution; public hook: PreToolUse
+POST_TOOL_USE            # Hook observability: after tool execution; public hook: PostToolUse
+PRE_COMPACT              # Hook observability: before context compaction; public hook: PreCompact
 ```
 
 The M0 spike covers RUN_STARTED, ITERATION_STARTED, TOOL_CALL_REQUESTED, TOOL_CALL_COMPLETED, TOOL_CALL_FAILED, RUN_COMPLETED, RUN_FAILED. Extended events are added in later phases as gates migrate.

docs/generated/docs-aging-dashboard.md

@@ -4,7 +4,7 @@
 
 **Stale threshold:** 90 days since `Last reviewed`
 **Current-truth docs scanned:** 17
-**Needs attention (working tier only):** 3
+**Needs attention (working tier only):** 2
 **Archive-tier docs (exempt from staleness):** 1
 
 Regenerate: `python3 scripts/report_docs_aging.py`
@@ -21,13 +21,7 @@ Regenerate: `python3 scripts/report_docs_aging.py`
 
 | Document | Status | Last reviewed | File mtime | Notes |
 | --- | --- | --- | --- | --- |
-| `docs/INDEX.md` | stale_by_mtime | 2026-06-06 | 2026-06-12 | Missing owner banner; File modified after last reviewed date |
-
-### roadmap
-
-| Document | Status | Last reviewed | File mtime | Notes |
-| --- | --- | --- | --- | --- |
-| `docs/roadmap-status.md` | stale_by_mtime | 2026-06-10 | 2026-06-12 | File modified after last reviewed date |
+| `docs/INDEX.md` | stale_by_mtime | 2026-06-06 | 2026-06-13 | Missing owner banner; File modified after last reviewed date |
 
 ## Archive Tier (Dated, Immutable Records — Exempt from Staleness Checks)
 

docs/generated/docs-inventory.md

@@ -42,7 +42,7 @@ Do not edit this file manually — regenerate instead.
 | `adr/0029-consensus-validation-deferred.md` | working | 1587 | `8a2da40abc07` |
 | `adr/0030-root-module-freeze.md` | working | 1297 | `bee25422e85f` |
 | `adr/0031-shadow-mode-exit-criteria.md` | working | 3598 | `46a9a0d5eaac` |
-| `adr/0032-run-event-taxonomy.md` | working | 13534 | `dcae5044f4c4` |
+| `adr/0032-run-event-taxonomy.md` | working | 14011 | `50c291b14941` |
 | `adr/README.md` | working | 7109 | `713a782f5411` |
 | `agent-contribution-contract.md` | constitution | 5204 | `9c2dad1195d2` |
 | `agent-mode-operator-guide.md` | working | 2778 | `25b258ab7bfe` |
@@ -233,7 +233,7 @@ Do not edit this file manually — regenerate instead.
 | `error-reference.md` | working | 4897 | `4d8a143b3322` |
 | `gateway-oauth-tenants.md` | working | 1818 | `0ff9c7df4652` |
 | `generated/command-snippet-inventory.md` | working | 8128 | `5256119bb8fe` |
-| `generated/docs-aging-dashboard.md` | working | 3359 | `f4fcc1ed6dc3` |
+| `generated/docs-aging-dashboard.md` | working | 3141 | `03454afd0476` |
 | `generated/release-docs-evidence.md` | working | 3621 | `3eacf81cef02` |
 | `governance-compliance.md` | constitution | 1648 | `031cfe1796cd` |
 | `governance/code-review-checklist.md` | working | 4379 | `f580da208c75` |
@@ -289,7 +289,7 @@ Do not edit this file manually — regenerate instead.
 | `http-surface-auth.md` | working | 5135 | `e5299e595353` |
 | `implementation/daily-driver-fix-log.md` | working | 978 | `474648b41793` |
 | `implementation/fix-log-2026-06-02.md` | archive | 8520 | `21239812e63e` |
-| `INDEX.md` | working | 19436 | `7c8bcd6a3e39` |
+| `INDEX.md` | working | 19697 | `89be0c9b9399` |
 | `maturity-matrix.md` | working | 6953 | `b5616937c67a` |
 | `migration-top-level-api.md` | working | 1505 | `2ba32dedee5a` |
 | `model-capability-matrix.md` | working | 4640 | `a5f83e814136` |
@@ -518,7 +518,7 @@ Do not edit this file manually — regenerate instead.
 | `reviews/project-state-critical-questioning-2026-06-04.md` | archive | 7340 | `78b9b54c3a9c` |
 | `reviews/security-risk-assessment-2026-06-02.md` | archive | 24112 | `4c9e2e00d001` |
 | `reviews/seven-control-loops-critical-questioning-2026-06-05.md` | archive | 7531 | `ae1e34b8369d` |
-| `roadmap-status.md` | constitution | 20384 | `45df7fe47c52` |
+| `roadmap-status.md` | constitution | 20910 | `17a4c5db9445` |
 | `run-evidence-and-audit-guide.md` | working | 1980 | `97b527c850b1` |
 | `security-whitepaper.md` | working | 9691 | `d65a19a755cb` |
 | `security/approval-abuse-cases-2026-06-02.md` | archive | 1281 | `4c43296d1c66` |
@@ -592,7 +592,7 @@ Do not edit this file manually — regenerate instead.
 | `work-log/m4-approval-sliceB-blocked-2026-06-13.md` | archive | 7347 | `3981ed82bc08` |
 | `work-log/m4-budget-stays-inline-2026-06-13.md` | archive | 5727 | `0e7a6ee74954` |
 | `work-log/m5-hooks-observability-only-2026-06-13.md` | archive | 5000 | `8a87eaee4d15` |
-| `work-log/operator-friction-log.md` | working | 2560 | `fe79899db10f` |
+| `work-log/operator-friction-log.md` | working | 3910 | `6dd6635ed859` |
 | `work-log/p0-p1-governance-implementation-ledger-2026-06-11.md` | archive | 5212 | `0b72cd69de32` |
 | `work-log/parallel-phase-0-implementation-report-2026-06-04.md` | archive | 13181 | `098186167459` |
 | `work-log/phase-0-governance-closure-report-2026-06-04.md` | archive | 4309 | `2af44267aaf4` |