Skip to content

v2.7.0: Graph Intelligence, Topology Explorer, API Contracts, and Architecture Synthesis

Choose a tag to compare

@spelech spelech released this 25 Aug 05:01
· 91 commits to main since this release
fd7773b

What's Changed in ContextCortex v2.7.0

🌐 1. Interactive Visual Codebase & Dependency Topology Explorer (#8)

  • Added an interactive force-directed graph canvas in the Web Admin Dashboard for exploring file hierarchies, module clusters, AST symbol relationships, and API routes.
  • Real-time pan, zoom, drag physics, node/edge type filtering, and search-to-focus autocomplete.
  • Slide-over Inspector Drawer with code previews, AST signatures, line ranges, neighbor connections, and Git provider permalinks.
  • Backend REST endpoints: GET /admin/api/graph/topology and GET /admin/api/graph/node-details.

🌲 2. AST-Based Call Graph Traversal & Relationship Tracing (#7)

  • Tree-sitter extraction across 10+ languages capturing CALLS, IMPORTS, INHERITS, and IMPLEMENTS relationships into indexed SQLite ast_relationships tables.
  • FastMCP tool trace_path: Cycle-safe BFS traversal supporting inbound (callers), outbound (callees), and bidirectional (both) exploration with depth clamping and Markdown tree formatting.

🔗 3. API Route Discovery & Cross-Service Endpoint Linking (#6)

  • Framework-aware HTTP route extraction for FastAPI, Express, Flask, ASP.NET, and Spring Boot into api_routes.
  • Client call-site discovery (fetch, axios, requests, HttpClient) into api_client_calls.
  • FastMCP tools find_routes and find_api_callers for instant API contract discovery and cross-service consumer tracing.

🏛️ 4. Architecture Overview Synthesis & Architecture Decision Records (#5)

  • FastMCP tool get_architecture: Synthesizes primary language distributions, application entry points, key hotspot modules, route summaries, and active ADRs within a concise token footprint (<1,000 tokens).
  • FastMCP tool manage_adr: Full Architecture Decision Record lifecycle management (list, get, create, update, supersede) with automatic markdown file ingestion (docs/adr/*.md).

🧪 5. Testing & Verification Baseline

  • 383 Automated Tests: 277 Pytest Backend + 82 Vitest Frontend + 24 Playwright E2E tests passing.
  • 100% clean CI/CD pipeline.