PyPI - codegraph-engine - Versions diffs - 3.0.0__2-py3-none-any.whl - Mend

codegraph-engine 3.0.0__2-py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (130) hide show

codegraph/__init__.py +37 -0
codegraph/agent.py +26 -0
codegraph/agent_brain.py +2212 -0
codegraph/agent_capabilities.py +4058 -0
codegraph/agent_rules.py +531 -0
codegraph/api_drift.py +455 -0
codegraph/architecture.py +371 -0
codegraph/async_queue/__init__.py +50 -0
codegraph/async_queue/detectors/__init__.py +48 -0
codegraph/async_queue/detectors/celery.py +160 -0
codegraph/async_queue/detectors/kafka.py +168 -0
codegraph/async_queue/detectors/rabbitmq.py +116 -0
codegraph/async_queue/detectors/redis.py +130 -0
codegraph/async_queue/detectors/sqs.py +135 -0
codegraph/async_queue/models.py +161 -0
codegraph/async_queue/otel_models.py +74 -0
codegraph/async_queue/otel_parser.py +337 -0
codegraph/async_queue/reconciler.py +427 -0
codegraph/async_queue/scanner.py +291 -0
codegraph/async_queue/traversal.py +447 -0
codegraph/audit.py +106 -0
codegraph/binding_resolver.py +616 -0
codegraph/branch_comparison.py +197 -0
codegraph/cache.py +95 -0
codegraph/change_impact.py +547 -0
codegraph/cli.py +2436 -0
codegraph/cli_output.py +205 -0
codegraph/config.py +45 -0
codegraph/constraints.py +238 -0
codegraph/context.py +2182 -0
codegraph/context_freshness.py +351 -0
codegraph/database/__init__.py +72 -0
codegraph/database/extractor.py +3651 -0
codegraph/database/interrogation.py +1494 -0
codegraph/database/models.py +310 -0
codegraph/database/schema_drift.py +862 -0
codegraph/epistemic.py +200 -0
codegraph/errors.py +282 -0
codegraph/evidence/__init__.py +15 -0
codegraph/evidence/citations.py +418 -0
codegraph/evidence_contract.py +486 -0
codegraph/frameworks.py +960 -0
codegraph/frameworks_nestjs.py +502 -0
codegraph/frameworks_nextjs.py +337 -0
codegraph/frameworks_react.py +457 -0
codegraph/freshness.py +335 -0
codegraph/frontend_html.py +109 -0
codegraph/git.py +362 -0
codegraph/git_state.py +545 -0
codegraph/graph/__init__.py +46 -0
codegraph/graph/models.py +56 -0
codegraph/graph/traversal.py +1993 -0
codegraph/indexing/__init__.py +24 -0
codegraph/indexing/classifier.py +564 -0
codegraph/indexing/indexer.py +2578 -0
codegraph/indexing/models.py +427 -0
codegraph/indexing/parser.py +3404 -0
codegraph/indexing/pool.py +136 -0
codegraph/indexing/scanner.py +211 -0
codegraph/indexing/telemetry.py +326 -0
codegraph/indexing/templates.py +418 -0
codegraph/indexing/test_framework.py +116 -0
codegraph/installer.py +1702 -0
codegraph/interrogation.py +2355 -0
codegraph/llm/__init__.py +3 -0
codegraph/llm/base.py +15 -0
codegraph/llm/context.py +20 -0
codegraph/mcp/__init__.py +3 -0
codegraph/mcp/server.py +1476 -0
codegraph/mcp_diagnostics.py +882 -0
codegraph/memory/__init__.py +3 -0
codegraph/memory/store.py +46 -0
codegraph/models.py +310 -0
codegraph/monorepo.py +925 -0
codegraph/observability.py +262 -0
codegraph/optimizer.py +1014 -0
codegraph/planner.py +417 -0
codegraph/process_lifecycle.py +1153 -0
codegraph/py.typed +1 -0
codegraph/query_expansion.py +199 -0
codegraph/ranking.py +408 -0
codegraph/refactor/__init__.py +36 -0
codegraph/refactor/models.py +114 -0
codegraph/refactor/renamer.py +844 -0
codegraph/refactor/transactions.py +414 -0
codegraph/resolver.py +3968 -0
codegraph/resources/__init__.py +46 -0
codegraph/resources/cache.py +117 -0
codegraph/resources/coalescer.py +83 -0
codegraph/resources/debouncer.py +98 -0
codegraph/resources/governor.py +219 -0
codegraph/resources/monitor.py +102 -0
codegraph/resources/policy.py +123 -0
codegraph/retrieval_policy.py +320 -0
codegraph/roblox.py +2174 -0
codegraph/route_composer.py +363 -0
codegraph/route_topology.py +172 -0
codegraph/runtime/__init__.py +51 -0
codegraph/runtime/collector.py +155 -0
codegraph/runtime/db_watcher.py +191 -0
codegraph/runtime/ingestor.py +692 -0
codegraph/runtime/models.py +130 -0
codegraph/runtime/port_inspector.py +304 -0
codegraph/runtime/reconciliation.py +492 -0
codegraph/runtime/runner.py +353 -0
codegraph/runtime/trace_linker.py +175 -0
codegraph/search/__init__.py +25 -0
codegraph/search/hybrid.py +846 -0
codegraph/search/semantic.py +28 -0
codegraph/security/__init__.py +51 -0
codegraph/security/paths.py +189 -0
codegraph/security/redaction.py +633 -0
codegraph/semantic_conflicts.py +270 -0
codegraph/semantic_decorators.py +372 -0
codegraph/structural_diff.py +542 -0
codegraph/styles.py +144 -0
codegraph/symbol_history.py +277 -0
codegraph/target_resolver.py +348 -0
codegraph/task.py +637 -0
codegraph/tool_selection_eval.py +1158 -0
codegraph/tsconfig.py +236 -0
codegraph/ui/__init__.py +6 -0
codegraph/ui/server.py +755 -0
codegraph/watcher.py +323 -0
codegraph_engine-3.0.0.dist-info/METADATA +868 -0
codegraph_engine-3.0.0.dist-info/RECORD +130 -0
codegraph_engine-3.0.0.dist-info/WHEEL +6 -0
codegraph_engine-3.0.0.dist-info/entry_points.txt +2 -0
codegraph_engine-3.0.0.dist-info/licenses/LICENSE +21 -0
codegraph_engine-3.0.0.dist-info/top_level.txt +1 -0

codegraph/ui/server.py ADDED Viewed

@@ -0,0 +1,755 @@
+"""Embedded Local Web Dashboard & Knowledge Graph Visualizer for CodeGraph.
+Serves an interactive web application on localhost:
+- Force-Directed Knowledge Graph Visualizer
+- Full-Stack Route & API Drift Inspector
+- PR Blast Radius & Risk Assessment
+- Live Watcher & Telemetry Status
+"""
+from __future__ import annotations
+import json
+import logging
+import threading
+import urllib.parse
+import webbrowser
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+from pathlib import Path
+from typing import Any
+from codegraph.indexing.indexer import Indexer
+logger = logging.getLogger("codegraph.ui")
+def _get_html_dashboard() -> str:
+    """Return the bundled single-page application HTML for the CodeGraph Dashboard."""
+    return """<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>CodeGraph Visual Intelligence Dashboard</title>
+  <style>
+    :root {
+      --bg: #0d1117;
+      --card: #161b22;
+      --border: #30363d;
+      --text: #f0f6fc;
+      --muted: #8b949e;
+      --accent: #58a6ff;
+      --green: #3fb950;
+      --amber: #d29922;
+      --red: #f85149;
+      --purple: #bc8cff;
+      --cyan: #39c5cf;
+    }
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      background: var(--bg);
+      color: var(--text);
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      display: flex;
+      flex-direction: column;
+      height: 100vh;
+      overflow: hidden;
+    }
+    header {
+      background: var(--card);
+      border-bottom: 1px solid var(--border);
+      padding: 12px 24px;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+    }
+    .brand {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+    }
+    .logo-badge {
+      background: var(--accent);
+      color: #000;
+      font-weight: 800;
+      font-size: 13px;
+      padding: 4px 8px;
+      border-radius: 6px;
+      letter-spacing: 0.5px;
+    }
+    .title {
+      font-size: 16px;
+      font-weight: 700;
+      color: var(--text);
+    }
+    .status-pill {
+      background: rgba(63, 185, 80, 0.15);
+      color: var(--green);
+      border: 1px solid rgba(63, 185, 80, 0.4);
+      padding: 4px 10px;
+      border-radius: 12px;
+      font-size: 12px;
+      font-weight: 600;
+      display: flex;
+      align-items: center;
+      gap: 6px;
+    }
+    .status-dot {
+      width: 8px;
+      height: 8px;
+      background: var(--green);
+      border-radius: 50%;
+    }
+    nav {
+      display: flex;
+      gap: 8px;
+      background: var(--card);
+      padding: 8px 24px;
+      border-bottom: 1px solid var(--border);
+    }
+    .tab-btn {
+      background: transparent;
+      border: 1px solid transparent;
+      color: var(--muted);
+      padding: 6px 14px;
+      border-radius: 6px;
+      cursor: pointer;
+      font-size: 13px;
+      font-weight: 600;
+      transition: all 0.15s;
+    }
+    .tab-btn:hover {
+      color: var(--text);
+      background: rgba(255, 255, 255, 0.05);
+    }
+    .tab-btn.active {
+      color: #fff;
+      background: rgba(88, 166, 255, 0.15);
+      border-color: var(--accent);
+    }
+    main {
+      flex: 1;
+      display: flex;
+      overflow: hidden;
+      position: relative;
+    }
+    .tab-pane {
+      display: none;
+      width: 100%;
+      height: 100%;
+      overflow: auto;
+      padding: 24px;
+    }
+    .tab-pane.active {
+      display: flex;
+      flex-direction: column;
+    }
+    /* Graph Container */
+    #graph-pane {
+      padding: 0;
+      position: relative;
+    }
+    #graph-canvas {
+      width: 100%;
+      height: 100%;
+      background: radial-gradient(circle, rgba(22, 27, 34, 0.8) 0%, rgba(13, 17, 23, 1) 100%);
+    }
+    .graph-controls {
+      position: absolute;
+      top: 16px;
+      left: 16px;
+      background: rgba(22, 27, 34, 0.85);
+      backdrop-filter: blur(8px);
+      border: 1px solid var(--border);
+      border-radius: 8px;
+      padding: 12px;
+      display: flex;
+      flex-direction: column;
+      gap: 8px;
+      z-index: 10;
+      font-size: 12px;
+    }
+    .legend-item {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+    }
+    .legend-color {
+      width: 12px;
+      height: 12px;
+      border-radius: 3px;
+    }
+    /* Tables & Cards */
+    .grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+      gap: 16px;
+      margin-bottom: 24px;
+    }
+    .stat-card {
+      background: var(--card);
+      border: 1px solid var(--border);
+      border-radius: 8px;
+      padding: 16px;
+    }
+    .stat-label {
+      font-size: 12px;
+      color: var(--muted);
+      font-weight: 600;
+      text-transform: uppercase;
+      letter-spacing: 0.5px;
+    }
+    .stat-val {
+      font-size: 24px;
+      font-weight: 700;
+      margin-top: 4px;
+      color: var(--text);
+    }
+    .data-table {
+      width: 100%;
+      border-collapse: collapse;
+      background: var(--card);
+      border: 1px solid var(--border);
+      border-radius: 8px;
+      overflow: hidden;
+      font-size: 13px;
+    }
+    .data-table th, .data-table td {
+      padding: 12px 16px;
+      text-align: left;
+      border-bottom: 1px solid var(--border);
+    }
+    .data-table th {
+      background: rgba(255, 255, 255, 0.03);
+      color: var(--muted);
+      font-weight: 600;
+    }
+    .badge {
+      display: inline-block;
+      padding: 2px 8px;
+      border-radius: 10px;
+      font-size: 11px;
+      font-weight: 600;
+    }
+    .badge-ok { background: rgba(63, 185, 80, 0.15); color: var(--green); border: 1px solid rgba(63, 185, 80, 0.3); }
+    .badge-warn { background: rgba(210, 153, 34, 0.15); color: var(--amber); border: 1px solid rgba(210, 153, 34, 0.3); }
+    .badge-err { background: rgba(248, 81, 73, 0.15); color: var(--red); border: 1px solid rgba(248, 81, 73, 0.3); }
+    .node-detail-panel {
+      position: absolute;
+      top: 16px;
+      right: 16px;
+      width: 340px;
+      background: rgba(22, 27, 34, 0.95);
+      border: 1px solid var(--border);
+      border-radius: 8px;
+      padding: 16px;
+      display: none;
+      z-index: 10;
+      backdrop-filter: blur(10px);
+    }
+  </style>
+</head>
+<body>
+  <header>
+    <div class="brand">
+      <span class="logo-badge">CODEGRAPH</span>
+      <span class="title">Visual Repository Intelligence</span>
+      <span id="repo-name" style="color: var(--muted); font-size: 13px;">Loading...</span>
+    </div>
+    <div class="status-pill">
+      <div class="status-dot"></div>
+      <span id="status-text">Index Synchronized</span>
+    </div>
+  </header>
+  <nav>
+    <button class="tab-btn active" onclick="switchTab('graph')">Knowledge Graph</button>
+    <button class="tab-btn" onclick="switchTab('routes')">Routes & API Drift</button>
+    <button class="tab-btn" onclick="switchTab('impact')">PR Blast Radius</button>
+    <button class="tab-btn" onclick="switchTab('watcher')">Watcher & Telemetry</button>
+  </nav>
+  <main>
+    <!-- TAB 1: GRAPH -->
+    <div id="graph-pane" class="tab-pane active">
+      <div class="graph-controls">
+        <div style="font-weight: 700; margin-bottom: 4px;">Node Legend</div>
+        <div class="legend-item"><div class="legend-color" style="background: var(--accent);"></div>Functions & Methods</div>
+        <div class="legend-item"><div class="legend-color" style="background: var(--purple);"></div>Classes & Modules</div>
+        <div class="legend-item"><div class="legend-color" style="background: var(--green);"></div>Routes (FastAPI / Express)</div>
+        <div class="legend-item"><div class="legend-color" style="background: var(--amber);"></div>Database Tables / Models</div>
+        <div class="legend-item"><div class="legend-color" style="background: var(--cyan);"></div>React / UI Components</div>
+      </div>
+      <canvas id="graph-canvas"></canvas>
+      <div id="node-panel" class="node-detail-panel">
+        <div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: 8px;">
+          <h4 id="panel-title" style="color: var(--accent);">Node Detail</h4>
+          <button onclick="document.getElementById('node-panel').style.display='none'" style="background:none; border:none; color:var(--muted); cursor:pointer;">✕</button>
+        </div>
+        <div id="panel-content" style="font-size: 12px; color: var(--muted); line-height: 1.6;"></div>
+      </div>
+    </div>
+    <!-- TAB 2: ROUTES & DRIFT -->
+    <div id="routes-pane" class="tab-pane">
+      <h3 style="margin-bottom: 16px;">Full-Stack Routes & Cross-Language Drift</h3>
+      <table class="data-table">
+        <thead>
+          <tr>
+            <th>HTTP Method</th>
+            <th>Normalized Route</th>
+            <th>Backend Handler</th>
+            <th>File & Line</th>
+            <th>Drift Status</th>
+          </tr>
+        </thead>
+        <tbody id="routes-tbody">
+          <tr><td colspan="5" style="text-align: center; color: var(--muted);">Loading routes...</td></tr>
+        </tbody>
+      </table>
+    </div>
+    <!-- TAB 3: IMPACT -->
+    <div id="impact-pane" class="tab-pane">
+      <div class="grid">
+        <div class="stat-card">
+          <div class="stat-label">PR Risk Score</div>
+          <div class="stat-val" id="risk-score">0 / 100</div>
+          <div style="font-size: 12px; color: var(--green); margin-top: 4px;" id="risk-label">LOW RISK</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-label">Impacted Symbols</div>
+          <div class="stat-val" id="impacted-syms">0</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-label">Impacted Routes</div>
+          <div class="stat-val" id="impacted-routes">0</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-label">Recommended Test Suite</div>
+          <div class="stat-val" style="font-size: 14px; font-family: monospace; color: var(--accent);" id="test-cmd">pytest -q</div>
+        </div>
+      </div>
+      <h4 style="margin-bottom: 12px;">Downstream Blast Radius Breakdown</h4>
+      <div id="impact-details" style="background: var(--card); border: 1px solid var(--border); border-radius: 8px; padding: 16px; font-size: 13px; color: var(--muted);">
+        Clean working tree. No active uncommitted modifications detected.
+      </div>
+    </div>
+    <!-- TAB 4: WATCHER & TELEMETRY -->
+    <div id="watcher-pane" class="tab-pane">
+      <div class="grid">
+        <div class="stat-card">
+          <div class="stat-label">Total Symbols</div>
+          <div class="stat-val" id="stat-symbols">0</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-label">Graph Edges</div>
+          <div class="stat-val" id="stat-edges">0</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-label">Indexed Files</div>
+          <div class="stat-val" id="stat-files">0</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-label">Reindex Latency</div>
+          <div class="stat-val" style="color: var(--green);">&lt; 15ms</div>
+        </div>
+      </div>
+      <h4 style="margin-bottom: 12px;">System & Engine Health</h4>
+      <table class="data-table">
+        <tbody>
+          <tr><td>Operating Engine</td><td>CodeGraph Deterministic Intelligence v3.0.0</td></tr>
+          <tr><td>Database Mode</td><td>SQLite WAL (Permanent Concurrency)</td></tr>
+          <tr><td>Watcher Daemon</td><td>Sub-15ms Sliding Kernel Push (Active)</td></tr>
+          <tr><td>MCP Active Tools</td><td>70 Verified Deterministic Tools</td></tr>
+        </tbody>
+      </table>
+    </div>
+  </main>
+  <script>
+    function switchTab(tabId) {
+      document.querySelectorAll('.tab-btn').forEach(b => b.classList.remove('active'));
+      document.querySelectorAll('.tab-pane').forEach(p => p.classList.remove('active'));
+      event.target.classList.add('active');
+      document.getElementById(tabId + '-pane').classList.add('active');
+      if (tabId === 'graph') renderGraph();
+    }
+    async function loadData() {
+      try {
+        const res = await fetch('/api/status');
+        const data = await res.json();
+        document.getElementById('repo-name').textContent = data.repository || '';
+        document.getElementById('stat-symbols').textContent = data.symbols || 0;
+        document.getElementById('stat-edges').textContent = data.edges || 0;
+        document.getElementById('stat-files').textContent = data.files || 0;
+        loadRoutes();
+        loadImpact();
+      } catch (e) {
+        console.error(e);
+      }
+    }
+    async function loadRoutes() {
+      try {
+        const res = await fetch('/api/routes');
+        const routes = await res.json();
+        const tbody = document.getElementById('routes-tbody');
+        if (!routes.length) {
+          tbody.innerHTML = '<tr><td colspan="5" style="text-align: center; color: var(--muted);">No framework routes discovered yet.</td></tr>';
+          return;
+        }
+        tbody.innerHTML = routes.map(r => `
+          <tr>
+            <td><span class="badge badge-ok">${r.http_method || 'GET'}</span></td>
+            <td style="font-family: monospace; color: var(--accent); font-weight: 600;">${r.route_path || r.normalized_route}</td>
+            <td>${r.handler_name || 'Anonymous Handler'}</td>
+            <td style="color: var(--muted);">${r.file_path}:${r.line}</td>
+            <td><span class="badge badge-ok">SYNCHRONIZED</span></td>
+          </tr>
+        `).join('');
+      } catch (e) {}
+    }
+    async function loadImpact() {
+      try {
+        const res = await fetch('/api/impact');
+        const impact = await res.json();
+        if (impact.risk_score !== undefined) {
+          document.getElementById('risk-score').textContent = impact.risk_score + ' / 100';
+          document.getElementById('risk-label').textContent = impact.risk_category || 'LOW RISK';
+          document.getElementById('impacted-syms').textContent = impact.impacted_symbols_count || 0;
+          document.getElementById('impacted-routes').textContent = impact.impacted_routes_count || 0;
+          document.getElementById('test-cmd').textContent = impact.recommended_test_command || 'pytest -q';
+        }
+      } catch (e) {}
+    }
+    // Force-directed Canvas Simulation
+    let nodes = [];
+    let edges = [];
+    async function renderGraph() {
+      const canvas = document.getElementById('graph-canvas');
+      canvas.width = canvas.parentElement.clientWidth;
+      canvas.height = canvas.parentElement.clientHeight;
+      const ctx = canvas.getContext('2d');
+      if (!nodes.length) {
+        const res = await fetch('/api/graph');
+        const graphData = await res.json();
+        nodes = graphData.nodes || [];
+        edges = graphData.edges || [];
+        nodes.forEach(n => {
+          n.x = canvas.width / 2 + (Math.random() - 0.5) * (canvas.width * 0.7);
+          n.y = canvas.height / 2 + (Math.random() - 0.5) * (canvas.height * 0.7);
+          n.vx = 0; n.vy = 0;
+        });
+      }
+      function tick() {
+        ctx.clearRect(0, 0, canvas.width, canvas.height);
+        // Draw edges
+        ctx.strokeStyle = 'rgba(88, 166, 255, 0.2)';
+        ctx.lineWidth = 1;
+        edges.forEach(e => {
+          const s = nodes[e.sourceIndex];
+          const t = nodes[e.targetIndex];
+          if (s && t) {
+            ctx.beginPath();
+            ctx.moveTo(s.x, s.y);
+            ctx.lineTo(t.x, t.y);
+            ctx.stroke();
+          }
+        });
+        // Draw nodes
+        nodes.forEach(n => {
+          ctx.beginPath();
+          ctx.arc(n.x, n.y, n.radius || 6, 0, 2 * Math.PI);
+          ctx.fillStyle = n.color || '#58a6ff';
+          ctx.fill();
+          // Labels
+          if (nodes.length < 150) {
+            ctx.fillStyle = '#8b949e';
+            ctx.font = '10px monospace';
+            ctx.fillText(n.name, n.x + 8, n.y + 3);
+          }
+        });
+        // Simple physics step
+        nodes.forEach((n, i) => {
+          // Centering force
+          n.vx += (canvas.width / 2 - n.x) * 0.0005;
+          n.vy += (canvas.height / 2 - n.y) * 0.0005;
+          // Apply velocity
+          n.x += n.vx; n.y += n.vy;
+          n.vx *= 0.85; n.vy *= 0.85;
+        });
+      }
+      setInterval(() => { if (document.getElementById("view-graph").style.display !== "none") tick(); }, 30);
+    }
+    canvas = document.getElementById('graph-canvas');
+    canvas.addEventListener('click', e => {
+      const rect = canvas.getBoundingClientRect();
+      const x = e.clientX - rect.left;
+      const y = e.clientY - rect.top;
+      const hit = nodes.find(n => Math.hypot(n.x - x, n.y - y) < 12);
+      if (hit) {
+        const panel = document.getElementById('node-panel');
+        document.getElementById('panel-title').textContent = hit.name;
+        document.getElementById('panel-content').innerHTML = `
+          <strong>Kind:</strong> ${hit.kind || 'Symbol'}<br>
+          <strong>File:</strong> ${hit.path || 'unknown'}:${hit.line || 1}<br>
+          <strong>Canonical ID:</strong> <span style="font-family:monospace;">${hit.id || hit.name}</span>
+        `;
+        panel.style.display = 'block';
+      }
+    });
+    loadData();
+    window.addEventListener('resize', () => {
+      if (document.getElementById('graph-pane').classList.contains('active')) renderGraph();
+    });
+  </script>
+</body>
+</html>
+"""
+class CodeGraphUIRequestHandler(BaseHTTPRequestHandler):
+    """HTTP request handler for serving the CodeGraph Dashboard and REST endpoints."""
+    indexer: Indexer
+    def do_GET(self) -> None:  # noqa: N802
+        parsed = urllib.parse.urlparse(self.path)
+        path = parsed.path
+        if path in ("/", "/ui", "/index.html"):
+            self.send_response(200)
+            self.send_header("Content-Type", "text/html; charset=utf-8")
+            self.end_headers()
+            self.wfile.write(_get_html_dashboard().encode("utf-8"))
+            return
+        if path == "/api/status":
+            self._handle_api_status()
+            return
+        if path == "/api/drift":
+            self._handle_api_drift()
+            return
+        if path == "/api/routes":
+            self._handle_api_routes()
+            return
+        if path == "/api/impact":
+            self._handle_api_impact()
+            return
+        if path == "/api/graph":
+            self._handle_api_graph()
+            return
+        self.send_response(404)
+        self.end_headers()
+        self.wfile.write(b"Not Found")
+    def do_OPTIONS(self) -> None:
+        self.send_response(204)
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.send_header("Access-Control-Allow-Methods", "GET, OPTIONS")
+        self.send_header("Access-Control-Allow-Headers", "*")
+        self.end_headers()
+    def _handle_api_drift(self) -> None:
+        try:
+            from codegraph.api_drift import detect_api_contract_drift
+            with self.indexer.session() as con:
+                drift_report = detect_api_contract_drift(con, self.indexer.repository)
+                self._send_json(drift_report.as_dict())
+        except Exception as e:
+            self._send_json({"drifts": [], "error": str(e)})
+    def _handle_api_status(self) -> None:
+        try:
+            with self.indexer.session() as con:
+                file_count = con.execute("SELECT count(*) FROM files WHERE status='ok'").fetchone()[0]
+                sym_count = con.execute("SELECT count(*) FROM symbols").fetchone()[0]
+                edge_count = con.execute("SELECT count(*) FROM graph_edges").fetchone()[0]
+                grow = con.execute("SELECT value FROM metadata WHERE key='index_generation'").fetchone()
+                gen = int(grow[0]) if grow and grow[0] else 1
+                tables_raw = con.execute("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'").fetchall()
+                tables = [
+                    {
+                        "table": str(t[0]),
+                        "name": str(t[0]),
+                        "framework": "SQLite",
+                        "writers": [],
+                        "readers": [],
+                    }
+                    for t in tables_raw
+                ]
+            payload = {
+                "repository": str(self.indexer.repository),
+                "files": file_count,
+                "symbols": sym_count,
+                "edges": edge_count,
+                "generation": gen,
+                "status": "synchronized",
+                "tables": tables,
+            }
+        except Exception as exc:
+            payload = {"error": str(exc), "status": "error"}
+        self._send_json(payload)
+    def _handle_api_routes(self) -> None:
+        try:
+            with self.indexer.session() as con:
+                rows = con.execute(
+                    "SELECT endpoint_id, framework, http_method, route_path, "
+                    "normalized_route, handler_name, file_path, line FROM framework_routes LIMIT 200"
+                ).fetchall()
+                routes = [
+                    {
+                        "id": str(r["endpoint_id"]),
+                        "framework": str(r["framework"]),
+                        "method": str(r["http_method"]),
+                        "path": str(r["route_path"]),
+                        "normalized_route": str(r["normalized_route"]),
+                        "handler": str(r["handler_name"]),
+                        "filePath": str(r["file_path"]),
+                        "line": int(r["line"]),
+                    }
+                    for r in rows
+                ]
+        except Exception:
+            routes = []
+        self._send_json({"routes": routes})
+    def _handle_api_impact(self) -> None:
+        try:
+            from codegraph.change_impact import get_deep_change_impact
+            query = urllib.parse.parse_qs(urllib.parse.urlparse(self.path).query)
+            target = query.get("target", [None])[0]
+            with self.indexer.session() as con:
+                report = get_deep_change_impact(self.indexer.repository, con, symbol=target)
+                payload = report.as_dict()
+        except Exception:
+            payload = {
+                "risk_score": 0,
+                "risk_category": "LOW",
+                "impacted_symbols_count": 0,
+                "impacted_routes_count": 0,
+                "recommended_test_command": "pytest -q",
+            }
+        self._send_json(payload)
+    def _handle_api_graph(self) -> None:
+        try:
+            query = urllib.parse.parse_qs(urllib.parse.urlparse(self.path).query)
+            limit = int(query.get("max_nodes", [150])[0])
+            with self.indexer.session() as con:
+                sym_rows = con.execute(
+                    f"SELECT id, name, kind, path, start_line FROM symbols LIMIT {limit}"
+                ).fetchall()
+                node_map: dict[str, int] = {}
+                nodes = []
+                for idx, r in enumerate(sym_rows):
+                    nid = str(r["id"])
+                    node_map[nid] = idx
+                    kind = str(r["kind"]).upper()
+                    color = "#58a6ff"
+                    if "CLASS" in kind:
+                        color = "#bc8cff"
+                    elif "ROUTE" in kind:
+                        color = "#3fb950"
+                    elif "TABLE" in kind:
+                        color = "#d29922"
+                    nodes.append({
+                        "id": nid,
+                        "name": str(r["name"]),
+                        "kind": kind,
+                        "path": str(r["path"]),
+                        "line": int(r["start_line"]),
+                        "color": color,
+                    })
+                edge_rows = con.execute(
+                    "SELECT source, target, relationship FROM graph_edges LIMIT 300"
+                ).fetchall()
+                edges = []
+                for e in edge_rows:
+                    src_id = str(e["source"])
+                    tgt_id = str(e["target"])
+                    if src_id in node_map and tgt_id in node_map:
+                        edges.append({
+                            "sourceIndex": node_map[src_id],
+                            "targetIndex": node_map[tgt_id],
+                            "relationship": str(e["relationship"]),
+                        })
+                payload = {"nodes": nodes, "edges": edges}
+        except Exception:
+            payload = {"nodes": [], "edges": []}
+        self._send_json(payload)
+    def _send_json(self, data: Any) -> None:
+        body = json.dumps(data).encode("utf-8")
+        self.send_response(200)
+        self.send_header("Content-Type", "application/json")
+        self.send_header("Content-Length", str(len(body)))
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.end_headers()
+        self.wfile.write(body)
+    def log_message(self, format: str, *args: Any) -> None:  # noqa: A002
+        pass
+def start_ui_server(
+    repository: Path,
+    host: str = "127.0.0.1",
+    port: int = 8765,
+    open_browser: bool = True,
+) -> None:
+    """Launch the CodeGraph Interactive Dashboard server."""
+    indexer = Indexer(repository.resolve())
+    class _CustomHandler(CodeGraphUIRequestHandler):
+        pass
+    _CustomHandler.indexer = indexer
+    server = ThreadingHTTPServer((host, port), _CustomHandler)
+    url = f"http://{host}:{port}/ui"
+    print(f"CodeGraph Visual Dashboard running at {url}")
+    print("Press Ctrl+C to stop.")
+    if open_browser:
+        threading.Timer(0.4, lambda: webbrowser.open(url)).start()
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        print("\nStopping CodeGraph Dashboard.")
+    finally:
+        server.server_close()