codevira 2.0.0rc1__tar.gz → 2.1.1__tar.gz

{codevira-2.0.0rc1 → codevira-2.1.1}/CHANGELOG.md

@@ -11,7 +11,172 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-### Planned for v1.9
+## [2.1.1] — 2026-05-17 — Hybrid decision search
+
+### Added
+- **Hybrid search for `search_decisions`** (BM25 + ChromaDB semantic + RRF fusion).
+  Closes the UDAP-benchmark gap: queries like `"DDD architecture layer"` or
+  `"codevira backfill"` that returned 0 hits in v2.0/v2.1.0 now surface the
+  right decisions via semantic recall. Response includes a `retrieval` field
+  indicating which path contributed (hybrid / keyword / semantic).
+- **`codevira heal --decisions`** — non-destructive backfill embedding all
+  existing decisions into the semantic index. Run once after upgrading from
+  v2.0/v2.1.0 to pick up hybrid recall on pre-existing decision history.
+  Idempotent (upsert pattern).
+- **`mcp_server/tools/_decision_embeddings.py`** — new helper module:
+  embed_decision, semantic_search_decisions, rrf_merge, backfill_all_decisions.
+  P9 graceful degradation throughout — chromadb failures never block SQL
+  writes or BM25 reads.
+
+### Tests
+- `tests/test_decision_embeddings.py` — 15 new regression tests covering
+  RRF math, graceful-degradation paths, and the explicit benchmark queries.
+
+## [2.1.0] — 2026-05-17 — Reliability hardening + Pillar 3 discipline scaffold
+
+### Added — Pillar 3: AI development discipline scaffold (2026-05-16)
+
+The codevira repo now ships its own discipline scaffold — the same
+pattern that will be exposed as `codevira discipline install` in
+v2.2. This is the reference implementation, eaten as dog food.
+
+- **`.claude/skills/`** — 4 SKILL.md files: `development-discipline`,
+  `open-source-quality`, `release-readiness`, `epistemic-honesty`.
+- **`.claude/hooks/pre-release-block.sh`** — PreToolUse hard wall.
+  Refuses `twine upload`, `gh release ... --draft=false`,
+  `pipx publish`, etc. unless `.release-evidence/<version>.json`
+  shows G1–G5 pass. Bypass via `CODEVIRA_RELEASE_OVERRIDE=1`.
+- **`Makefile`** — 12 targets including `release-verify-version`,
+  `release-gauntlet`, `release-build`, `release-dry-run`,
+  `release-publish`, `release-smoke`, `release-full`.
+- **`.pre-commit-config.yaml`** — ruff lint+format, mypy, hygiene.
+- **`tests/e2e/test_first_contact.py`** + 4 fixtures (docs_only,
+  code_only_python, polyglot, monorepo). G2 gate.
+- **`.github/workflows/{ci,release-gate}.yml`** — CI hard wall.
+- **`codevira.discipline.yaml`** — central scaffold config.
+- **`scripts/check_real_ide_smoke.sh`** — G3 stub.
+- **`docs/release-process.md`** — step-by-step foolproof release.
+
+### Planned for v2.1
+
+See [ROADMAP.md](ROADMAP.md#-v21--new-user-first-contact--reliability-hardening).
+
+- **Reliability hardening (23 bugs A–O)** — silent-failure elimination
+  surfaced by the discipline-scaffold e2e fixtures.
+- **Hybrid search (BM25 + semantic + rerank)** — natural-language
+  decision search.
+- **Decision deduplication** (ADD/UPDATE/NOOP) + audit trail.
+- **Conditional hook injection** — kill the always-on token tax.
+- **Multi-language `get_signature` / `get_code`** — wire tree-sitter.
+- **`record_decisions_batch` API** — compress protocol overhead.
+- **CLI naming clarity** — `init` / `setup` / `register` / `configure`
+  canonical hierarchy.
+
+---
+
+## [2.0.0] — 2026-05-14 — First public 2.0 release
+
+The 2.0 release moves codevira from "memory layer for one developer in one IDE" to
+"active guardian for every AI coding tool you use, on every project, on your local
+machine." Five internal iterations (rc1..rc5 in dev tags) plus a same-day public
+release-candidate cycle (`2.0.0rc1`) of dogfood + audit + product-credibility
+work consolidate into 2.0.0. **Full changelog: [RELEASE_NOTES.md](RELEASE_NOTES.md).**
+
+### Added
+
+- **All 10 hero policies** — active guardian engine intercepts every AI tool
+  call (Edit, Write, prompt submit, session start) and routes through
+  registered policies (Decision Lock, Anti-Regression, Scope Contract,
+  Blast-Radius Veto, Cross-Session Consistency, Token Budget, Live Style
+  Enforcement, Decision Replay, Proactive Intent Inference, AI Promotion
+  Score).
+- **`codevira setup`** — one-prompt installer that detects every AI tool
+  on the machine (Claude Code, Cursor, Windsurf, Antigravity, OpenAI Codex,
+  GitHub Copilot, Continue.dev, Aider) and configures all of them at once.
+- **`codevira projects`** — canonical inventory with `tracked / ghost /
+  orphan / stale` classification (`--json` for scripting; `--ghosts-only`
+  pairs with `clean --ghosts`).
+- **`codevira hooks list / uninstall`** — admin commands for Claude Code
+  lifecycle hooks; surgical install + clean removal.
+- **`codevira clean --ghosts`** — surgical removal of incomplete project
+  data dirs without touching tracked projects.
+- **`codevira init --single-language`** — opt-out flag for the new
+  index-everything default.
+- **`codevira engine` subcommand** — internal hook dispatcher; surfaces in
+  `--help` so the lifecycle hooks can call it.
+- **4 new doctor checks** — `claude_mcp_visibility`, `codeindex_freshness`,
+  `semantic_search_health`, `ghost_projects` (total 14 per run).
+- **Per-project config opt-out for cross-session injection** —
+  `.codevira/config.yaml: project: { cross_session_mode: off }` disables
+  the per-prompt context block without touching env vars.
+
+### Changed
+
+- **`codevira init` default** — indexes every common source/config/docs
+  extension (~75 total: `.py`, `.ts`, `.go`, `.yaml`, `.toml`, `.md`,
+  `.html`, `.sql`, `.proto`, …) instead of narrowing to one language.
+- **`codevira agents` default** — renders nudge files for **detected** IDEs
+  only; `--ide=all` opt-in for the legacy "render for every supported IDE"
+  behavior.
+- **`codevira doctor`** — now genuinely read-only; snapshots the projects
+  dir at entry and removes any new dirs at exit.
+- **`search_codebase`** — graceful structural fallback (filename + symbol
+  substring) when the semantic index is unavailable, with the correct
+  `fix_command` instead of a misleading "reinstall codevira" hint.
+- **`get_node` / `get_impact` / `query_graph`** — three-case error
+  differentiation: "no graph DB" / "graph empty" / "file not in populated
+  graph", each with its own `fix_command`.
+- **`get_decision_confidence`** — exposes `decisions_in_db_total` and
+  `decisions_eligible_for_outcomes` plus a four-state interpretation so
+  users understand WHY their `total_decisions` may be zero. Outcome
+  tracker also classifies file-less decisions via mention-extraction.
+- **Playbooks** — project-scoped first
+  (`<data_dir>/playbooks/` or `<project>/.codevira/playbooks/`); bundled
+  Python defaults are skipped with a clear warning when project language
+  ≠ Python.
+- **`register_project`** uses `ON CONFLICT … COALESCE(excluded.git_remote,
+  projects.git_remote)` — subsequent registrations can't silently clear
+  the `git_remote` column.
+- **Auto-init self-heal** runs SYNCHRONOUSLY in the calling thread of every
+  CLI invocation — daemon thread death no longer leaves ghost data dirs.
+- **Default install** includes ChromaDB + sentence-transformers (no
+  `[search]` extra needed for semantic search).
+- **README "92% reduction" claim** qualified with honest scope, per-prompt
+  cost, and amortization curve.
+- **`register` deprecation** now names the removal version (v2.1).
+
+### Fixed
+
+- macOS Apple Silicon **fork-safety segfault on first `codevira index`**
+  (auto-applied at indexer import).
+- **Setup interactive prompt** silent-fail on unexpected input — replaced
+  with a shared `_prompts.confirm` helper that retries, flushes stdout,
+  and handles `KeyboardInterrupt` cleanly.
+- Three **`status --global` UI typos** that always rendered 0/0/0
+  regardless of actual `global.db` state.
+- Four **FK race conditions** in the watcher pipeline.
+- **Python `None` leaked into argparse choices** for `agents --ide` and
+  `budget` positional.
+- Several **silent argument clamps** in `replay --since`, `insights --since`,
+  and `insights --top` now print visible warnings.
+
+### Tests
+
+- 2395 / 2395 passing (deterministic).
+- ~1091 net new tests since v1.8.0 (mostly from the v2.0 hero policies +
+  audit-driven regression coverage).
+
+### Note on internal v1.8.1 + 2.0.0rc1
+
+A v1.8.1 production hotfix existed in dev tags but was never published to
+PyPI; its fixes are folded into 2.0.0. A `2.0.0rc1` was briefly published
+on PyPI (2026-05-14) as a same-day public release candidate; the code is
+identical to 2.0.0. Anyone who installed `codevira==2.0.0rc1` can
+`pipx install --upgrade codevira` to move to 2.0.0 final.
+
+---
+
+## [Original v1.9 plan, deferred]
 
 - **Interactive checkbox UI for `codevira configure`**. The current
   prompt asks users to type comma-separated indices ("1,3,5") into a

{codevira-2.0.0rc1 → codevira-2.1.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.2
 Name: codevira
-Version: 2.0.0rc1
-Summary: Persistent adaptive memory for AI coding agents — MCP server with context graph, semantic search, adaptive learning, roadmap tracking, and cross-tool continuity.
+Version: 2.1.1
+Summary: Stop re-explaining your project to AI agents every session. Codevira gives Claude Code, Cursor, Windsurf, and Antigravity shared persistent memory of your codebase — locally, no signup, MIT-licensed. One install configures every AI tool.
 Author-email: Sachin Shelke <sachin.worldnet@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/sachinshelke/codevira
@@ -9,7 +9,7 @@ Project-URL: Repository, https://github.com/sachinshelke/codevira
 Project-URL: Issues, https://github.com/sachinshelke/codevira/issues
 Project-URL: Changelog, https://github.com/sachinshelke/codevira/blob/main/CHANGELOG.md
 Keywords: mcp,model-context-protocol,ai-agents,llm,developer-tools,claude,cursor,windsurf,code-intelligence,semantic-search,context-graph,chromadb,agentic,coding-assistant,knowledge-graph
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -36,6 +36,14 @@ Requires-Dist: chromadb>=0.5.0
 Requires-Dist: sentence-transformers>=2.7.0
 Provides-Extra: search
 Provides-Extra: all
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: pytest-timeout>=2.1; extra == "dev"
+Requires-Dist: ruff>=0.6.0; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
+Requires-Dist: pre-commit>=3.5; extra == "dev"
 
 # Codevira
 
@@ -50,7 +58,17 @@ Provides-Extra: all
 
 **Built for solo developers** working on local projects with AI agents. Codevira gives every AI tool you use access to the same persistent project memory — so you stop re-explaining your codebase every session, stop losing carefully-made decisions, and stop burning tokens on re-discovery.
 
-**Works with:** Claude Code · Claude Desktop · Cursor · Windsurf · Google Antigravity · any MCP-compatible AI tool
+**Works with:** Claude Code · Claude Desktop · Cursor · Windsurf · Google Antigravity · OpenAI Codex · GitHub Copilot · Continue.dev · Aider · any MCP-compatible AI tool
+
+---
+
+## What you get
+
+* 🧠 **One brain across every AI tool.** A decision you log in Claude Code shows up in Cursor. Style preferences learned in one session enforce in the next. No per-tool re-onboarding.
+* 🛡️ **Active guardrails, not passive notes.** Codevira intercepts every AI tool call (`Edit`, `Write`, prompt submit, session start). Decisions you mark `do_not_revert` block silent regressions. Out-of-scope edits get warned. The AI literally *cannot* undo your protected choices without surfacing the conflict to you first.
+* ⚡ **Zero-friction setup.** `pipx install codevira && codevira setup` — auto-detects every AI tool you have and configures all of them. No JSON to hand-edit, no per-IDE script, no team server to spin up.
+* 🔒 **Local-first, MIT-licensed.** Your decisions, code graph, and learned preferences live in `~/.codevira/` on your machine. No cloud, no account, no telemetry, no SaaS.
+* 📊 **Honest measurement.** `codevira insights` shows which past decisions held up vs got reverted across your real git history. `codevira budget` reports per-session AI token spend. You can audit what the memory layer is actually costing and earning.
 
 ---
 
@@ -117,7 +135,7 @@ Codevira is a [Model Context Protocol](https://modelcontextprotocol.io) server t
 
 | Capability | What it means for you |
 |---|---|
-| **Zero-config setup** | `pipx install codevira && codevira register` — that's it. No prompts, no JSON editing. Auto-detects language, source dirs, and IDE configs |
+| **Zero-config setup** | `pipx install codevira && codevira setup` — that's it. No prompts, no JSON editing. Auto-detects every installed AI tool and configures all of them |
 | **Cross-tool continuity** | One `get_session_context()` call brings any AI agent up to speed in ~800 tokens — works identically in Claude Code, Cursor, Windsurf, Antigravity |
 | **Decision protection** | `do_not_revert` flags + searchable decision log stop AI agents from undoing past architectural choices |
 | **Context graph** | Every source file has a node: role, rules, dependencies, stability, blast radius. AI calls `get_node(path)` instead of re-reading the file |
@@ -141,89 +159,148 @@ The agent always asks for what it needs, in the size it needs.
 
 ---
 
-## Quick Start
-
-### 1. Install
+## Quick Start — three commands
 
 ```bash
-# Recommended: global install via pipx (isolated, works everywhere)
+# 1. Install
 pipx install codevira
 
-# Alternative: pip install
-pip install codevira
-```
-
-Installs the full toolkit (23 AI-facing MCP tools + 12 admin/CLI tools) out of the box. Semantic search downloads a ~90MB embedding model on first use.
-
-### 2. Set up every AI tool you have
-
-```bash
+# 2. Connect every AI tool you have (idempotent — safe to re-run)
 codevira setup
+
+# 3. (Optional) Verify the install
+codevira doctor
 ```
 
-This one-prompt v2.0 command:
-- Detects every AI tool installed on your machine (Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, GitHub Copilot, Claude Desktop, Continue, Aider, Roo Code, Cline)
-- Writes per-IDE nudge files so each tool knows codevira exists (`CLAUDE.md`, `AGENTS.md`, `.cursor/rules/codevira.mdc`, `.windsurfrules`, `GEMINI.md`, `.github/copilot-instructions.md`)
-- Installs Claude Code lifecycle hooks (SessionStart, PreToolUse, PostToolUse, UserPromptSubmit, Stop) — turns codevira from passive memory into the **AI guardian** described above
-- Injects MCP server config into each detected tool
+That's it. Open any project in your AI tool — codevira auto-initializes on
+the first MCP tool call. No per-project `codevira init` needed.
 
-Idempotent — re-run any time to re-sync. Use `--dry-run` to preview, `--ide=claude` to limit to one tool.
+**Try it.** Ask your AI agent: *"Use `get_session_context` to brief me on this project."*
+You'll get a structured project state in one tool call instead of the AI
+re-reading docs.
 
-> **Migrating from v1.x?** If you've been using `codevira register`, switch to `codevira setup` — register only injects MCP server config; setup ALSO writes the nudge files + lifecycle hooks that power the v2.0 hero capabilities.
+### What `codevira setup` actually does
 
-### 2.5 Verify the install (optional but recommended)
+The one command above replaces what used to take 5+ steps in v1.x:
 
-```bash
-codevira doctor
-```
+* **Detects every installed AI tool** — Claude Code, Claude Desktop, Cursor,
+  Windsurf, Antigravity, Codex CLI, GitHub Copilot, Continue.dev, Aider.
+* **Injects MCP server config** into each tool's config file (per-IDE schema
+  handled automatically — no JSON to hand-edit).
+* **Writes per-IDE nudge files** so each AI tool knows codevira exists:
+  `CLAUDE.md`, `AGENTS.md`, `.cursor/rules/codevira.mdc`, `.windsurfrules`,
+  `GEMINI.md`, `.github/copilot-instructions.md` — only for IDEs you actually
+  have installed.
+* **Installs Claude Code lifecycle hooks** (`SessionStart`, `PreToolUse`,
+  `PostToolUse`, `UserPromptSubmit`, `Stop`) — turns codevira from passive
+  memory into the **active guardian** that intercepts every AI tool call.
 
-Runs 9 health checks, prints `✓` / `⚠` / `✗` per check, and shows the **exact command** to fix anything that's not green. Read-only — never modifies anything.
+Use `--dry-run` to preview without writing anything. Use `--ide=claude` to
+limit to one tool. Use `-y` to skip the confirmation prompt (handy in scripts).
 
-### 3. Start using
+### Already on v1.x?
 
-Open any project in your AI tool. On the first MCP tool call, Codevira **auto-initializes**:
-- Detects language, source directories, and file extensions from project markers
-- Creates the context graph and roadmap
-- Installs a `post-commit` git hook for automatic reindexing
+`pipx install --upgrade codevira` then `codevira setup`. Three default
+behaviors changed (all opt-out-able for legacy compatibility) — see
+[MIGRATING.md](MIGRATING.md) for the full upgrade guide. No data loss; your
+existing `~/.codevira/global.db` migrates safely.
 
-No explicit `codevira init` needed — everything happens on demand.
+### What `codevira doctor` reports
 
-> **Note:** `codevira init` is still available for explicit per-project setup with custom settings.
+14 health checks in one run, each with a concrete `fix_command` for any
+WARN or FAIL. Read-only — never modifies anything. Use it whenever
+something feels off.
 
-### 4. Verify
+```text
+$ codevira doctor
+Codevira health check
+────────────────────────────────────────────────────────────
+✓  python_version         Python 3.13 (≥ 3.10 required)
+✓  codevira_data_dir      /Users/you/.codevira exists and is writable
+✓  graph_db               graph.db has all 4 expected tables
+✓  global_db              /Users/you/.codevira/global.db opens cleanly
+✓  detected_ides          5 AI tool(s) detected
+✓  claude_mcp_visibility  codevira visible to Claude Code (✓ Connected)
+✓  ghost_projects         12 project(s) tracked — none are ghost dirs
+... (and 7 more checks)
+────────────────────────────────────────────────────────────
+summary: 14 pass · 0 warn · 0 fail
+```
 
-Ask your AI agent to call `get_roadmap()` — it should return your current phase and next action.
+### Daily-use commands you'll actually run
 
-> **Note:** Restart your AI tool after running `codevira register` to pick up the new MCP config.
+| Command | What it does |
+|---|---|
+| `codevira setup` | Re-sync IDE configs (after installing a new AI tool, etc.) |
+| `codevira doctor` | Health check |
+| `codevira projects` | List every project codevira knows about on this machine |
+| `codevira projects --ghosts-only` | Find half-initialised project dirs |
+| `codevira clean --ghosts` | Remove ghost dirs (preserves real ones) |
+| `codevira insights` | Stable + reverted decisions across past sessions |
+| `codevira replay` | Decisions timeline (terminal / markdown / html output) |
+| `codevira budget` | Per-session token usage |
+| `codevira hooks list` | Show installed Claude Code lifecycle hooks |
+
+Run `codevira --help` for the full subcommand list.
 
 ### Customizing what's indexed
 
-Codevira tries to auto-detect your project's source layout, but monorepo or non-standard layouts sometimes slip through — you'll notice when `codevira index --full` reports `0 chunks indexed` and prints a hint pointing you here.
+By default codevira indexes every common source / config / docs extension
+(~75 total: `.py`, `.ts`, `.go`, `.yaml`, `.md`, `.html`, `.sql`, `.proto`,
+…). For most projects this is what you want. To narrow or widen:
 
 ```bash
-cd your-project
+# Interactive picker — shows discovered dirs + extensions with file counts
 codevira configure
+
+# Non-interactive (CI / scripts)
+codevira configure --dirs src,packages,apps --extensions .py,.ts --no-reindex
+
+# Restore legacy single-language behavior on init
+codevira init --single-language
 ```
 
-Scans your project (gitignore-aware), shows discovered directories and extensions with file counts, and lets you pick which to watch via a numbered-list prompt. It writes your choices back to `.codevira/config.yaml` and offers to rebuild the index.
+After changing watched directories, **restart your AI tool** — running
+watchers snapshot the dir set at boot.
+
+### Reducing per-prompt context overhead
+
+Codevira's Cross-Session Consistency policy injects ~1 KB of relevant prior
+decisions into each `UserPromptSubmit` event. To disable per-project:
+
+```yaml
+# .codevira/config.yaml
+project:
+  cross_session_mode: off          # disable injection entirely
+  cross_session_max_inject: 2      # OR keep it but cap at 2 entries (default 5)
+```
+
+Or system-wide via env: `export CODEVIRA_CROSS_SESSION_MODE=off`.
+
+### Uninstall
+
+See [Uninstall / Reset](#uninstall--reset) below for the full set of
+options (`--all`, `--dry-run`, `--orphans`, `--ghosts`, `--legacy`).
+Quick path:
 
-**Non-interactive** (useful in scripts or CI):
 ```bash
-codevira configure --dirs src,packages,apps --extensions .py,.ts,.tsx --no-reindex
+codevira clean              # remove ~/.codevira/, IDE configs, services
+codevira hooks uninstall    # remove Claude Code lifecycle hook scripts
+pipx uninstall codevira     # remove the binary
 ```
 
-After changing watched directories, **restart your AI tool** — running watchers snapshot the dir set at boot.
+---
 
-### Manual config (only if auto-inject didn't detect your tool)
+## Manual installation — only if `codevira setup` doesn't detect your tool
 
 Codevira supports two transports. Use the right one for your client:
 
 | Client | Transport | Config file |
 |--------|-----------|-------------|
 | Claude Desktop (app) | stdio | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Claude Code (CLI) | stdio or HTTP | `.claude/settings.json` |
-| Cursor | stdio | `.cursor/mcp.json` |
-| Windsurf | stdio | `.windsurf/mcp.json` |
+| Claude Code (CLI) | stdio | `~/.claude.json` (user scope — `mcpServers` section) |
+| Cursor | stdio | `~/.cursor/mcp.json` |
+| Windsurf | stdio | `~/.codeium/windsurf/mcp_config.json` |
 | Google Antigravity | stdio | `~/.gemini/antigravity/mcp_config.json` |
 
 **Stdio transport** — Claude Desktop, Cursor, Windsurf (`.claude/settings.json` / `.cursor/mcp.json` / `.windsurf/mcp.json`):
@@ -253,7 +330,7 @@ Codevira supports two transports. Use the right one for your client:
 
 > Tip: find the full binary path with `which codevira`
 
-**HTTP/HTTPS transport** — *Preview in v1.7, single-project only.* The HTTP server binds to one project at startup and cannot switch contexts per request. **Multi-project HTTPS is planned for v1.8.** For multi-project work today, use stdio via `codevira register` (above).
+**HTTP/HTTPS transport** — *Preview only.* The HTTP server binds to one project at startup and cannot switch contexts per request. Multi-project HTTPS is still on the roadmap (see [ROADMAP.md](ROADMAP.md)). For multi-project work today, use stdio via `codevira setup` (above) — `setup` is the v2.0 successor to the now-deprecated `codevira register`.
 
 First start the HTTP server in a terminal:
 ```bash
@@ -394,7 +471,7 @@ codevira clean --dry-run    # preview what would be removed
 ```mermaid
 flowchart LR
 
-A["pipx install codevira"] --> B["codevira register"]
+A["pipx install codevira"] --> B["codevira setup"]
 B --> C["Open project in\nClaude Code / Cursor /\nWindsurf / Antigravity"]
 C --> D["First MCP tool call\ntriggers auto-init"]
 D --> E["✓ Config written\n✓ Graph built\n✓ Roadmap created\n✓ Ready"]