# Domain 2 — Codebase Context & Code Intelligence

**Status:** Proposed
**Epic:** domain2-code-intelligence
**Depends on:** v2.8.8-type-inject-mcp, v2.8.12-hashline-audit-hooks

## Why

BooCode has two parallel code intelligence systems — and neither is fully wired:

1. Old Go codecontext sidecar (http://codecontext:8080) — 16 tool wrappers in apps/server/src/services/tools/codecontext/ — called via codecontext_client.ts HTTP client. Limited to codesight-level analysis (routes, schema, middleware, hot files). No type recovery, no health grades, no impact analysis.

2. New boocontext MCP server (registered in data/mcp.json as node /opt/forks/boocontext/dist/standalone.js) — 7 aggregated tools (overview, map, health, symbols, callgraph, impact, types) backed by child MCP servers. Already running but only available to agents through MCP discovery as boocontext_* tools — not integrated as first-class BooCode agent tools.

The lift analysis (boocode-lift-analysis.md) rates the boocontext swap as Tier 1 / Critical: 7 tools instead of 5, session caching, call graph, health grades, impact analysis, TS type recovery. Written in TS (BooCode's stack). Fixes 0% TS type recovery.

## What Changes

### Phase 1: Go sidecar → boocontext migration (high confidence)

1. Update codecontext_client.ts to optionally route through boocontext MCP instead of the Go HTTP sidecar. Add a CODECONTEXT_MCP env toggle. When boocontext MCP is active, call the MCP tool directly instead of HTTP POST to http://codecontext:8080/v1/{toolName}.

2. Add 4 new first-class tool wrappers for boocontext-only capabilities:
   - get_code_health — wraps boocontext_health (A-F grades per file, 7 dimensions)
   - get_code_impact — wraps boocontext_impact (symbol trace + blast radius merged)
   - get_type_info — wraps boocontext_types (TypeScript type signatures, cross-file resolution)
   - get_code_map — wraps boocontext_map (compressible context map with DCP)

3. Register new tools in ALL_TOOLS in tools/registry.ts. Add to agent whitelists in data/AGENTS.md.

### Phase 2: Child MCP server hardening (high confidence)

4. Switch type-inject child path from hardcoded /opt/forks/type-inject/packages/mcp/dist/index.js to npx @nick-vi/type-inject-mcp. Set BOOCONTEXT_TYPE_INJECT_NPX=@nick-vi/type-inject-mcp env var on the boocontext MCP process.

5. Add graceful degradation on child server failure. If tree-sitter-analyzer or type-inject is unavailable, fall back to codesight-only mode instead of failing hard.

### Phase 3: Wiki mode + scanning (medium confidence)

6. Add get_wiki_article tool — wraps codesight --wiki output. Generates targeted persistent articles per project, cached on disk.

7. Add token-efficient scanning — adopt codesight's scanner pattern for get_codebase_overview. Uses DCP compression for large payloads.

### Phase 4: Teardown (future)

8. Deprecate Go sidecar — once all tool wrappers verify against boocontext MCP, mark the Go codecontext sidecar as deprecated. Remove from docker-compose.yml and codecontext/Dockerfile when no remaining consumers.

## Non-Goals
- No changes to the boocontext fork itself (consumed as-is via dist/standalone.js)
- No removal of the Go sidecar in this batch (parallel running OK)
- No changes to boocontext's child-server architecture
- No new framework detectors (boocontext already has 20+ language extractors)

## Capabilities

### New Capabilities
- get_code_health — A-F code health grades per file, project health summary, hotspot identification, refactoring candidate ranking
- get_code_impact — Symbol-level trace merged with file-level blast radius. Single call replaces two-step get_symbol_info → get_blast_radius
- get_type_info — TypeScript type recovery: type signatures, interface definitions, generic constraints, cross-file type resolution
- get_code_map — DCP-compressed context map with compress toggle
- get_wiki_article — Persistent codebase wiki article by name, cached on disk

### Modified Capabilities
- Existing 12 codecontext tools transparently upgraded to boocontext backend (same agent interface, better data)
- codecontext_client.ts — gains MCP routing layer with Go sidecar fallback

## Metrics
- Go sidecar HTTP calls → 0 (all migrated to boocontext MCP)
- New tool surface area: 16 → 20 first-class tools
- Agent-visible tools: 16 unchanged names + 4 new names
- TypeScript type recovery: 0% → full TS-visible types on file context
- Code health awareness: 0 tools → 1 tool
- Impact analysis: 2-step → 1-step