TARS v3.1.0

TARS 3.1: Harden, simplify, and extend — hooks, MCP wrappers, hybrid retrieval, office productivity

Phase 8 — Docs (§8)

• CLAUDE.md: version bump to v3.1. New "Write interface: tars-vault MCP tools" section documents all mcp__tars_vault__* tools. Skill roster adds /lint. Startup checks re-ordered around the SessionStart hook + integration-registry refresh + Anthropic-skills probe. Key constraints expanded: mcp__tars_vault__* mandate, provider-agnostic resolve_capability rule, office-delegation rule, nuance-capture rule. Vault structure block updated (telemetry, search-index, embedding-cache, tools-registry, search.db). Template + script blocks reflect the Phase 7 consolidation.
• README.md: version-agnostic intro broadened with retrieval, integrations, office-delegation, nuance-capture bullets. Architecture-at-a-glance adds hooks/ and mcp/tars-vault/. Documentation map links to the new Migration / Release / Mobile guides.
• ARCHITECTURE.md: renamed to "TARS 3.1 Architecture". New "Three operations" framing paragraph. Repo-layout block adds .mcp.json, mcp/tars-vault/, hooks/, scripts/githooks/, archive/historical/, docs/, requirements.txt. Runtime-layers section gains explicit "Write interface", "Hooks", "Retrieval", "Integration (provider-agnostic)", and "Office output" sub-sections. State/schema layer documents the v3.1 additions (tools-registry.yaml, telemetry/*.jsonl, search-index-state.json, search.db). Template layer lists the consolidated briefing.md and backlog-item.md. Added "What's new in v3.1" section covering all 10 strategic bets. Retrieval section rewritten with the hybrid tier-A / tier-B priority.
• GETTING-STARTED.md: prerequisites add Python 3.10+ and tars-vault MCP server. Installation section adds the pip install -r requirements.txt step and sets the zero-office-libs expectation. Integrations section rewritten around the capability-preference map and resolve_capability. New "First semantic search — FastEmbed model download" and "Office output prerequisites" subsections. /lint added to "Your first workflows".
• New docs/MIGRATION-v3.0-to-v3.1.md: 9-step user-executed migration runbook (backup → integrations-v2 migration → wikilink fixes → search-index build → githooks install → /welcome refresh → /lint pass → cron registration → verification). Rollback, duration, known-issues sections included.
• New docs/RELEASE-v3.1.0.md: user-executed release runbook (authorship guards, pre-release verification, retroactive tag backfill, version bump, CHANGELOG finalization, commit, build, tag, merge, push). Zero-Claude-attribution enforced via the installed git hooks.
• New docs/MOBILE-USAGE.md: Claude Remote Control setup + daily use + troubleshooting + security for iOS / Android. Matches §26.14 outline — Pro/Max plan + launchd keepalive + mobile mic-first workflow.

Phase 7 — Consolidation and cleanup (§7)

• Repo cleanup (§7.1): 6 legacy rebuild docs (TARS_REBUILD_FOUNDATION.md, TARS_V2_REBUILD_PLAN.md, TARS_V3_REBUILD_PLAN.md, TARS_V3_INSTANCE_MIGRATION_PLAN.md, MIGRATION_HANDOFF.md, REBUILD_HANDOFF.md — ~197 KB) moved from the repo root into archive/historical/. They were already untracked via .git/info/exclude, so no git history was rewritten.
• Template consolidation (§7.2): templates/daily-briefing.md + templates/weekly-briefing.md → single templates/briefing.md with tars-briefing-type: daily|weekly. templates/issue.md + templates/idea.md → single templates/backlog-item.md with tars-backlog-type: issue|idea. Skills (briefing, learn, meeting) and _system/taxonomy.md updated to reference the merged templates. Net: 17 templates → 15.
• Script consolidation (§7.4): scripts/scan-flagged.py merged into scripts/health-check.py as a flagged_content sub-block (markers, unmarked sentiment, stale-flag count). _system/guardrails.yaml header, tests/smoke-tests.py required-scripts list, skills/lint/SKILL.md, and skills/welcome/SKILL.md updated to point at the consolidated script. Net: 13 scripts → 12.
• Validator hardening: tests/validate-scripts.py now treats imports wrapped in try/except ImportError|ModuleNotFoundError as optional (§26.2 "graceful degrade path"), which unblocks the 6 pre-existing YAML-fallback scripts without loosening the pinned-deps allowlist.
• Commands readme (§7.5): new commands/README.md documents the 12 command-to-skill mappings; the thin wrappers remain in place pending end-to-end verification of Claude Code skill auto-registration (narrow-path per §26.18 — retirement deferred).
• .mcp.json project defaults (§7.6): repo-root .mcp.json now declares the tars-vault MCP server entry (stdio transport, python3 -m tars_vault, PYTHONPATH=mcp/tars-vault/src), alongside the existing filesystem server.
• Doc counts synced: README.md and ARCHITECTURE.md framework-inventory summary sentences upda...