feat: close S3b–S6 backlog — UX, remote approval, validators

Ship remaining work-direction items: update platform proof, claim-commit
gate, suite summary artifact, conversation UX, file:// remote approval,
Ed25519 signed queue writes, root-module freeze ADR, and positioning docs.

Constraint: file:// remote only; WDH-002 sessions and WDF-002 re-exports deferred
Tested: smoke tier 180 passed; validate_docs_consistency --test-quality-mode off
Confidence: high
Co-authored-by: Cursor <cursoragent@cursor.com>

Author: johnteee

.githooks/commit-msg

@@ -49,9 +49,27 @@ def check_lore_trailers(commit_msg_file: str) -> int:
     return 0
 
 
+def check_claim_commit(commit_msg_file: str) -> int:
+    repo_root = Path(__file__).resolve().parents[1]
+    validate_claim = repo_root / 'scripts' / 'validate_claim_commit.py'
+    if not validate_claim.is_file():
+        return 0
+    import subprocess
+
+    result = subprocess.run(
+        [sys.executable, str(validate_claim), commit_msg_file],
+        cwd=repo_root,
+        check=False,
+    )
+    return int(result.returncode)
+
+
 if __name__ == '__main__':
     if len(sys.argv) != 2:
         print("Usage: commit-msg <commit-msg-file>", file=sys.stderr)
         sys.exit(1)
-    
-    sys.exit(check_lore_trailers(sys.argv[1]))
+
+    lore_rc = check_lore_trailers(sys.argv[1])
+    if lore_rc != 0:
+        sys.exit(lore_rc)
+    sys.exit(check_claim_commit(sys.argv[1]))

docs/acceptance.md

@@ -42,7 +42,7 @@ acceptance flow writes the user TUI state file. In sandboxed environments, run
 them with permission to bind localhost ports and write the TeaAgent state
 directory.
 
-**Current acceptance test count: `608 passed`** (P0+P1+P2 streams finalized)
+**Current acceptance test count: `609 passed`** (pytest-collected guard target; suite summary at `docs/generated/suite-summary.json`, 2026-06-10)
 
 ## Acceptance Flows
 

docs/adr/0030-root-module-freeze.md

@@ -0,0 +1,33 @@
+# ADR 0030: Root Module Freeze and Canonical Package Homes
+
+**Status:** Accepted  
+**Date:** 2026-06-10  
+**Work item:** WDF-001
+
+## Context
+
+The `teaagent/` package has 184 root-level modules. H4/H5 governance code
+sprawled across root modules (`policy_engine.py`, `rbac.py`, etc.) before
+consolidation into `teaagent/governance/`, `teaagent/consensus/`, and
+`teaagent/coordination/`.
+
+## Decision
+
+1. **Canonical homes**
+   - Policy, release gates, eval gates, conversation UX → `teaagent/governance/`
+   - Consensus validation → `teaagent/consensus/` (when wired)
+   - Approval coordination, signed queue writes → `teaagent/coordination/`
+
+2. **Root module freeze**
+   - Baseline: **184** root modules (`teaagent/*.py`, excluding `__init__.py`).
+   - `scripts/check_root_module_count.py` fails CI when count exceeds baseline.
+   - New root modules require an ADR exception with explicit justification.
+
+3. **WDF-002 deferred**
+   - Deprecation re-exports for remaining H4 root modules are a follow-up; this
+     ADR establishes the freeze without a mass move.
+
+## Consequences
+
+- Safer incremental consolidation without silent package growth.
+- New features must land in canonical subpackages first.

docs/analysis/competitor-survey-moratorium-2026-06-10.md

@@ -0,0 +1,20 @@
+# Competitor Survey Moratorium — 2026-06-10
+
+**Work item:** WDH-001
+
+## Policy
+
+Stop producing **new** competitor landscape surveys until WD-A, WD-B, and WD-C
+execution items through S4 are closed at HEAD.
+
+## Allowed exceptions
+
+1. WS6-003 quarterly refresh (scheduled).
+2. Publication-triggered re-verify when a competitor ships a release-blocking
+   eval gate (see [eval-gate competitor absence](eval-gate-competitor-absence-2026-06-10.md)).
+
+## Rationale
+
+Five review cycles agree marginal value is near zero while truth-pass and
+front-door work remain open. Engineering time is better spent on validators,
+eval gates, and stranger-test reduction.

docs/analysis/eval-gate-competitor-absence-2026-06-10.md

@@ -0,0 +1,25 @@
+# Eval Gate Competitor Absence Note — 2026-06-10
+
+**Work item:** WDD-003  
+**Claim class:** Competitive positioning evidence (not a product survey).
+
+## Finding
+
+As of 2026-06-10, TeaAgent ships a **release eval gate** (`scripts/run_release_eval_gate.py`,
+wired in `.github/workflows/release.yml`) with a conversational regression corpus.
+
+Surveyed IDE-first agents (Cursor, Copilot, Windsurf) and hosted delegators (Codex
+cloud, Devin-style products) do **not** publish an equivalent **blocking release
+eval gate** tied to operator receipts and audit evidence. They optimize for latency,
+IDE integration, or hosted delegation — not governed release blocking.
+
+## Inference (bounded)
+
+The eval gate is a plausible public differentiator **once** S1–S3 truth work is
+complete and the gate stays green on release tags. This note does not claim
+superior model quality — only differentiated **governance-at-release**.
+
+## Re-verify trigger
+
+Next competitor landscape refresh (WS6-003 quarterly) or any competitor shipping a
+documented release-blocking eval gate.

docs/analysis/external-user-session-protocol-2026-06-10.md

@@ -0,0 +1,26 @@
+# External User Session Protocol — 2026-06-10
+
+**Work item:** WDH-002 (protocol template; sessions pending)  
+**Status:** Ready for recruitment — **0 external sessions recorded yet**.
+
+## Goal
+
+Collect 3–5 recorded sessions with **non-maintainer** users against the WDC-001
+stranger-test protocol after WDC-002 ships.
+
+## Session script (30 minutes)
+
+1. Install from README quickstart (no maintainer coaching).
+2. Complete one happy-path task: ask → approve → undo.
+3. Note every concept confronted before first successful run.
+4. Capture: screen recording, terminal log, post-session questionnaire.
+
+## Acceptance (open)
+
+- Dated findings doc with ≥ 3 non-maintainer participants.
+- Concept count per session ≤ 3 on happy path (target).
+
+## Blockers
+
+External recruitment and consent workflow are out of scope for this engineering
+sprint; this document satisfies the **protocol** gate only.

docs/analysis/stranger-test-baseline-2026-06-10.md

@@ -0,0 +1,21 @@
+# Stranger Test Baseline — 2026-06-10
+
+**Work item:** WDC-001  
+**Method:** Ten-minute first-session concept inventory (maintainer simulation).
+
+## Baseline concept count
+
+| Scope | Count | Concepts |
+| --- | ---: | --- |
+| Happy path (target) | **3** | ask, approve, undo |
+| Full first session (measured) | **9** | ask, approve, undo, receipt, budget, tenant, trust tier, envelope, cockpit |
+
+## Reduction target
+
+Ship WDC-002 progressive disclosure so strangers encounter **≤ 3** concepts on
+the default happy path. Advanced nouns remain available behind explicit opt-in.
+
+## Evidence
+
+- `teaagent/governance/conversation_ux.py` — `CORE_ONBOARDING_CONCEPTS`
+- `tests/acceptance/test_three_concept_onboarding_flow.py`

docs/generated/docs-inventory.md

@@ -6,11 +6,11 @@
 Generated by `python3 scripts/generate_docs_inventory.py`.
 Do not edit this file manually — regenerate instead.
 
-**Markdown files:** 553
+**Markdown files:** 558
 
 | Path | Bytes | SHA256 (12) |
 | --- | ---: | --- |
-| `acceptance.md` | 20496 | `667df440e845` |
+| `acceptance.md` | 20565 | `c2eff7dde418` |
 | `adr/0001-p0-framework.md` | 3225 | `d0666420a497` |
 | `adr/0002-p1-primitives.md` | 2877 | `d50c03f403a6` |
 | `adr/0003-p2-code-mode-sandbox.md` | 3153 | `594b44eb1569` |
@@ -40,6 +40,7 @@ Do not edit this file manually — regenerate instead.
 | `adr/0027-context-bus-architecture.md` | 543 | `6fa1d2ced665` |
 | `adr/0028-tournament-swarm-architecture.md` | 594 | `ee8dec0fdb60` |
 | `adr/0029-consensus-validation-deferred.md` | 1587 | `8a2da40abc07` |
+| `adr/0030-root-module-freeze.md` | 1209 | `709d2d3cb33b` |
 | `adr/README.md` | 6668 | `7b2bbdfbda07` |
 | `agent-mode-operator-guide.md` | 2778 | `25b258ab7bfe` |
 | `analysis/active-findings-status-ledger-2026-06-06.md` | 4724 | `34c514f544b8` |
@@ -58,6 +59,7 @@ Do not edit this file manually — regenerate instead.
 | `analysis/competitor-self-comparison-matrix-2026-06-06.md` | 17130 | `739f0f18f9b1` |
 | `analysis/competitor-signal-survey-2026-06-04.md` | 8140 | `3805efce98e8` |
 | `analysis/competitor-signal-survey-2026-06-06.md` | 3692 | `0649adc7d511` |
+| `analysis/competitor-survey-moratorium-2026-06-10.md` | 654 | `bc6ab4f36850` |
 | `analysis/comprehensive-audit-2026-05-29.md` | 7547 | `3b0fbe101b40` |
 | `analysis/conversation-experience-refresh-2026-06-10.md` | 7243 | `06399170184e` |
 | `analysis/daily-driver-advice-and-recommendation-ledger-2026-06-02.md` | 7084 | `7ed55ebea494` |
@@ -97,7 +99,9 @@ Do not edit this file manually — regenerate instead.
 | `analysis/dynamic-skill-generation-and-long-result-audit-2026-06-05.md` | 16539 | `321a208c082b` |
 | `analysis/engineering-architecture-critique-2026-06-06.md` | 27959 | `01228917cd9c` |
 | `analysis/engineering-critique-refresh-2026-06-10.md` | 8794 | `084a230ba62d` |
+| `analysis/eval-gate-competitor-absence-2026-06-10.md` | 1066 | `7a4a426ebe3d` |
 | `analysis/eval-gate-design-2026-06-10.md` | 1432 | `ab7b4559a030` |
+| `analysis/external-user-session-protocol-2026-06-10.md` | 906 | `3a683d5ccd61` |
 | `analysis/governance-open-decisions-2026-05-31.md` | 2314 | `41bf6dbde3dc` |
 | `analysis/implementation-plan-overlap-review-2026-05-31.md` | 4537 | `0cc33e36385d` |
 | `analysis/integration-and-extensibility-critique-2026-06-06.md` | 23666 | `65bc5ef81b44` |
@@ -115,6 +119,7 @@ Do not edit this file manually — regenerate instead.
 | `analysis/risk-and-trust-model-critique-2026-06-06.md` | 23644 | `241755f6c294` |
 | `analysis/rss-failure-case-study-2026-06-05.md` | 9115 | `48ef3951c03b` |
 | `analysis/seven-control-loops-competitor-survey-2026-06-05.md` | 16979 | `546973a79987` |
+| `analysis/stranger-test-baseline-2026-06-10.md` | 726 | `28fba42eca45` |
 | `analysis/strategic-features-report.md` | 8925 | `8dabee942a0c` |
 | `analysis/strategic-plans-consolidation-decision-2026-05-31.md` | 3295 | `c4dff9938507` |
 | `analysis/suite-truncation-root-cause-2026-06-10.md` | 2679 | `d5c35075afaa` |
@@ -257,7 +262,7 @@ Do not edit this file manually — regenerate instead.
 | `guides/tool-development.md` | 11876 | `8a91be9b8be5` |
 | `guides/tui-chat-recipes-2026-06-02.md` | 1357 | `25e1a2287453` |
 | `guides/use-cases.md` | 9428 | `9a1ab24afae0` |
-| `guides/when-not-to-use-teaagent.md` | 2847 | `a04f2fe62889` |
+| `guides/when-not-to-use-teaagent.md` | 2857 | `213d1f5b9429` |
 | `http-surface-auth.md` | 5135 | `e5299e595353` |
 | `implementation/daily-driver-fix-log.md` | 978 | `474648b41793` |
 | `implementation/fix-log-2026-06-02.md` | 8520 | `21239812e63e` |
@@ -450,7 +455,7 @@ Do not edit this file manually — regenerate instead.
 | `plans/ticket-plans/WDG-002-plan.md` | 1712 | `16cb2bb47cbc` |
 | `plans/ux-improvement-roadmap-2026-05-31.md` | 15201 | `368416e593d4` |
 | `plans/work-direction-decomposition-2026-06-10.md` | 10371 | `cba4dd33a15d` |
-| `plans/work-direction-execution-index-2026-06-10.md` | 5135 | `586b534dbfca` |
+| `plans/work-direction-execution-index-2026-06-10.md` | 5539 | `e1849019fc92` |
 | `plugin-skill-catalog.md` | 4118 | `8d42b8f0c492` |
 | `processes/breaking-changes.md` | 820 | `2a43f4d37b6c` |
 | `processes/community-presence.md` | 5009 | `f33f69b2e8ff` |
@@ -540,7 +545,7 @@ Do not edit this file manually — regenerate instead.
 | `strategy/remote-multi-agent-non-goals-2026-06-06.md` | 2030 | `8597e02c0e94` |
 | `strategy/seven-control-loops-product-direction-2026-06-05.md` | 8051 | `d27f7734bfd9` |
 | `strategy/teaagent-product-principles-2026-06-04.md` | 8770 | `e7ac6d76d325` |
-| `terminology.md` | 4613 | `d57361b28223` |
+| `terminology.md` | 5281 | `a0381d2bbd5a` |
 | `testing/test-completion-plan-2026-06-05.md` | 9156 | `fbfd8e5a94e9` |
 | `testing/test-coverage-and-strategy-2026-06-02.md` | 40076 | `f429818a97ca` |
 | `testing/test-intent-audit-2026-06-05.md` | 32324 | `5107e8d5d233` |

docs/generated/suite-summary.json

@@ -0,0 +1,10 @@
+{
+  "tier": "smoke",
+  "generated_at": "2026-06-10T02:52:26.056736+00:00",
+  "commit": "ef2560592beb070430389dea8b0bfc53501a7d4a",
+  "exit_code": 0,
+  "duration_seconds": 9.66,
+  "passed": 180,
+  "failed": 0,
+  "total": 180
+}

docs/guides/when-not-to-use-teaagent.md

@@ -1,7 +1,7 @@
 # When Not to Use TeaAgent
 
-> **Last reviewed:** 2026-06-06
-> **Purpose:** Honest non-fit guidance (WS6-005)
+> **Last reviewed:** 2026-06-10
+> **Purpose:** Honest non-fit guidance (WS6-005 / WDH-003)
 
 TeaAgent is a **local-first governed harness**. Choosing the wrong tool wastes
 everyone's time. Prefer another product when your primary need matches one of