boocode/openspec/changes/domain2-code-intelligence/tasks.md

Tasks — Domain 2: Codebase Context & Code Intelligence

Phase 1: Migration (5 tasks)

1. Route codecontext_client through boocontext MCP

Update apps/server/src/services/codecontext_client.ts to support dual routing:

• Check CODECONTEXT_MCP env var — when set, route tool calls through the boocontext MCP client instead of HTTP to the Go sidecar
• Map old tool names to boocontext equivalents:
  • get_codebase_overview → boocontext_overview
  • get_file_analysis → boocontext_map
  • get_symbol_info + get_symbol_details + search_symbols → boocontext_symbols
  • get_semantic_neighborhoods → boocontext_map
  • get_hot_files → boocontext_overview
  • get_framework_analysis → boocontext_overview
  • get_blast_radius → boocontext_impact
  • get_routes → boocontext_overview
  • get_middleware → boocontext_overview
  • get_dependencies → boocontext_callgraph
  • watch_changes → keep as-is (no boocontext equivalent)
• Fall back to Go sidecar HTTP when boocontext unavailable
• Preserve .codecontextignore handling, path validation, and truncation logic Verification: tsc --noEmit passes. Existing codecontext tests pass with both routing modes.

2. Add get_code_health tool

Create apps/server/src/services/tools/codecontext/get_code_health.ts

• Wrap boocontext_health MCP tool
• Schema: project path, optional file path for single-file health
• Output: A-F grade per dimension (cohesion, coupling, complexity, documentation, duplication, unit size, test coverage) + project health summary + hotspots list + refactoring candidates
• Register in tools/registry.ts ALL_TOOLS
• Add to Architect, Refactorer, and Code Reviewer agent tool whitelists in data/AGENTS.md Verification: tsc --noEmit passes. Tool appears as get_code_health in /api/tools response.

3. Add get_code_impact tool

Create apps/server/src/services/tools/codecontext/get_code_impact.ts

• Wrap boocontext_impact MCP tool
• Schema: project path, symbol name, optional file path, depth (default 1)
• Merges tree-sitter-analyzer symbol trace with codesight blast radius — single call
• Register in ALL_TOOLS
• Add to Architect and Planner agent whitelists Verification: tsc --noEmit passes. curl /api/tools shows get_code_impact.

4. Add get_type_info tool

Create apps/server/src/services/tools/codecontext/get_type_info.ts

• Wrap boocontext_types MCP tool (backed by @nick-vi/type-inject-mcp)
• Schema: project path, symbol name (regex), optional file path, kind filter (interface/type/class/function)
• Output: type signatures, interface definitions, generic constraints, JSDoc, import paths
• Register in ALL_TOOLS
• Add to Code Reviewer, Debugger, Architect agent whitelists Verification: tsc --noEmit passes. Tool returns correct TypeScript types for known symbols.

5. Add get_code_map tool

Create apps/server/src/services/tools/codecontext/get_code_map.ts

• Wrap boocontext_map MCP tool
• Schema: project path, compress (boolean, default true)
• DCP-compressed context map with filenames, sizes, import relationships
• Register in ALL_TOOLS
• Add to Recon agent whitelist Verification: tsc --noEmit passes. Map output is valid JSON with compress toggle working.

Phase 2: Hardening (2 tasks)

6. Fix type-inject child path

Update boocontext MCP environment:

• Set BOOCONTEXT_TYPE_INJECT_NPX=@nick-vi/type-inject-mcp in docker-compose.yml or the boocontext MCP process env
• Verify the hardcoded path /opt/forks/type-inject/packages/mcp/dist/index.js is no longer used Verification: boocontext_types tool works without /opt/forks/type-inject existing.

7. Add graceful degradation

Update boocontext child-server.ts or the tool wrappers:

• On child MCP server failure (tree-sitter-analyzer or type-inject), retry once then fall back to codesight-only result
• Return partial result with a warning message instead of hard error
• Log the child failure for observability Verification: Unplug tree-sitter-analyzer → boocontext tools still return codesight-level results with a warning.

Phase 3: Wiki + Scanning (2 tasks)

8. Add get_wiki_article tool

Create apps/server/src/services/tools/codecontext/get_wiki_article.ts

• Wraps codesight --wiki output via boocontext MCP
• Schema: project path, article name (string)
• Cache generated wiki articles to .codesight/ directory
• First request generates the wiki; subsequent requests read cache
• Register in ALL_TOOLS Verification: First call generates wiki; second call reads cache. Article content matches project structure.

9. Enable DCP compression on get_codebase_overview

Update get_codebase_overview.ts to pass compress: true for large projects

• Adds configurable compress toggle (default: auto — compress when >50 files)
• Matches boocontext_map's DCP pattern Verification: Large projects return compressed output under truncation limit.

Phase 4: Teardown (future, 1 task)

10. Deprecate Go sidecar

After all tools verified on boocontext MCP:

• Mark codecontext Go sidecar as deprecated in docker-compose.yml comment
• Add deprecation notice to codecontext/README.md
• Remove from docker-compose.yml services block in a future batch
• Remove codecontext/Dockerfile
• Remove codecontext_client.ts Go HTTP path (keep MCP-only path)