rho-graph 0.1.0

package/dist/mcp/tools/reindex.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { indexRepository } from "../../indexer/index.js";
+export function registerReindex(server, db, config, repoPath) {
+    server.tool("reindex", "Trigger re-indexing of the repository or a specific path. Use this when you know files have changed and the graph may be stale.", {
+        path: z.string().optional().describe("Specific path to reindex (defaults to changed files only)"),
+    }, async ({ path }) => {
+        const result = await indexRepository(db, repoPath, config.index, {
+            changedOnly: !path,
+            specificPath: path,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        filesIndexed: result.filesIndexed,
+                        functionsFound: result.functionsFound,
+                        classesFound: result.classesFound,
+                        orphansRemoved: result.orphansRemoved,
+                        errors: result.errors.length,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=reindex.js.map

package/dist/mcp/tools/reindex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex.js","sourceRoot":"","sources":["../../../src/mcp/tools/reindex.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,UAAU,eAAe,CAC7B,MAAiB,EACjB,EAAgB,EAChB,MAAc,EACd,QAAgB;IAEhB,MAAM,CAAC,IAAI,CACT,SAAS,EACT,iIAAiI,EACjI;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;KAClG,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE;YAC/D,WAAW,EAAE,CAAC,IAAI;YAClB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,YAAY,EAAE,MAAM,CAAC,YAAY;wBACjC,cAAc,EAAE,MAAM,CAAC,cAAc;wBACrC,YAAY,EAAE,MAAM,CAAC,YAAY;wBACjC,cAAc,EAAE,MAAM,CAAC,cAAc;wBACrC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;qBAC7B,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/search-code.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DbConnection } from "../../db/connection.js";
+export declare function registerSearchCode(server: McpServer, db: DbConnection): void;

package/dist/mcp/tools/search-code.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+export function registerSearchCode(server, db) {
+    server.tool("search_code", "Search for functions and classes by name, signature, or code content. Use this tool INSTEAD OF reading files directly when looking for code.", {
+        query: z.string().describe("Search query — function name, keyword, or code fragment"),
+        language: z.string().optional().describe("Filter by language (e.g. typescript, python)"),
+        repo: z.string().optional().describe("Filter by repository path"),
+        limit: z.number().optional().default(20).describe("Max results to return"),
+    }, async ({ query, language, repo, limit }) => {
+        const session = db.session();
+        try {
+            let cypher = `
+          CALL db.index.fulltext.queryNodes("code_search", $query)
+          YIELD node, score
+          WHERE (node:Function OR node:Class)
+        `;
+            const params = { query, limit: limit ?? 20 };
+            if (language) {
+                cypher += ` AND node.filePath ENDS WITH $languageExt`;
+                params.languageExt = `.${language}`;
+            }
+            if (repo) {
+                cypher += ` AND node.filePath STARTS WITH $repo`;
+                params.repo = repo;
+            }
+            cypher += `
+          RETURN node.name AS name, node.filePath AS filePath,
+                 node.signature AS signature, node.snippet AS snippet,
+                 node.startLine AS startLine, node.endLine AS endLine,
+                 labels(node)[0] AS type, score
+          ORDER BY score DESC LIMIT $limit
+        `;
+            const result = await session.run(cypher, params);
+            const records = result.records.map((r) => r.toObject());
+            return {
+                content: [{ type: "text", text: JSON.stringify(records, null, 2) }],
+            };
+        }
+        finally {
+            await session.close();
+        }
+    });
+}
+//# sourceMappingURL=search-code.js.map

package/dist/mcp/tools/search-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-code.js","sourceRoot":"","sources":["../../../src/mcp/tools/search-code.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,EAAgB;IACpE,MAAM,CAAC,IAAI,CACT,aAAa,EACb,8IAA8I,EAC9I;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;QACrF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QACxF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACjE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;KAC3E,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACzC,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,MAAM,GAAG;;;;SAIZ,CAAC;YACF,MAAM,MAAM,GAA4B,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;YACtE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,2CAA2C,CAAC;gBACtD,MAAM,CAAC,WAAW,GAAG,IAAI,QAAQ,EAAE,CAAC;YACtC,CAAC;YACD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,IAAI,sCAAsC,CAAC;gBACjD,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YACrB,CAAC;YACD,MAAM,IAAI;;;;;;SAMT,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACxD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACpE,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/visualize/public/graph.js

@@ -0,0 +1,445 @@
+// src/visualize/public/graph.js
+//
+// Sections:
+//   STATE   — viewState + loadedSet
+//   API     — fetch wrappers
+//   MERGE   — server response → loadedSet
+//   RENDER  — vis.Network init + applyViewFilters
+//   EVENTS  — DOM/network event handlers
+//   BOOT    — entry point
+
+// === STATE ===
+const GROUP_COLORS = {
+  Repository: { background: "#1f6feb", border: "#388bfd" },
+  File: { background: "#1a7f37", border: "#2ea043" },
+  Class: { background: "#8957e5", border: "#a371f7" },
+  Function: { background: "#da3633", border: "#f85149" },
+};
+
+const EDGE_STYLES = {
+  CONTAINS_FILE:  { color: "#1f6feb", width: 1 },
+  CONTAINS:       { color: "#1a7f37", width: 1 },
+  HAS_METHOD:     { color: "#8957e5", width: 1 },
+  IMPORTS:        { color: "#d29922", width: 1.5 },
+  CALLS:          { color: "#da3633", width: 1 },
+  IMPORTS_SYMBOL: { color: "#6e7681", width: 1, dashes: true },
+};
+
+const viewState = {
+  search: "",
+  visibleNodeTypes: new Set(["Repository", "File", "Class", "Function"]),
+  visibleEdgeTypes: new Set([
+    "CONTAINS_FILE",
+    "CONTAINS",
+    "HAS_METHOD",
+    "IMPORTS",
+    "CALLS",
+  ]),
+};
+
+const loadedSet = {
+  nodes: new vis.DataSet(),
+  edges: new vis.DataSet(),
+};
+
+let network = null;
+let edgeIdCounter = 0;
+const pendingExpands = new Set();
+
+// === API ===
+function parseUrlFilters() {
+  const p = new URLSearchParams(window.location.search);
+  const out = {};
+  for (const k of ["repo", "file", "function"]) {
+    const v = p.get(k);
+    if (v) out[k] = v;
+  }
+  return out;
+}
+
+async function fetchGraph(filters) {
+  const qs = new URLSearchParams(filters).toString();
+  const url = qs ? `/api/graph?${qs}` : "/api/graph";
+  const resp = await fetch(url);
+  if (!resp.ok) {
+    let detail = "";
+    try { detail = (await resp.json()).error ?? ""; } catch {}
+    throw new Error(`fetchGraph failed: ${detail || resp.statusText}`);
+  }
+  return resp.json();
+}
+
+async function fetchSearch(q) {
+  const resp = await fetch(`/api/search?q=${encodeURIComponent(q)}`);
+  if (!resp.ok) throw new Error("search failed");
+  return resp.json();
+}
+
+async function fetchExpand(type, params) {
+  const qs = new URLSearchParams({ type, ...params }).toString();
+  const resp = await fetch(`/api/expand?${qs}`);
+  if (!resp.ok) {
+    let detail = "";
+    try { detail = (await resp.json()).error ?? ""; } catch {}
+    throw new Error(`expand failed: ${detail || resp.statusText}`);
+  }
+  return resp.json();
+}
+
+// === MERGE ===
+function mergeIntoLoaded({ nodes, edges }, expandedFromId) {
+  for (const n of nodes) {
+    const existing = loadedSet.nodes.get(n.id);
+    if (!existing) {
+      loadedSet.nodes.add({
+        id: n.id,
+        label: n.label,
+        color: GROUP_COLORS[n.group] ?? { background: "#6e7681", border: "#8b949e" },
+        title: n.group,
+        font: { color: "#c9d1d9" },
+        _properties: n.properties,
+        _group: n.group,
+        _expanded: false,
+        _expandedBy: expandedFromId ? new Set([expandedFromId]) : new Set(),
+      });
+    } else if (expandedFromId) {
+      // Mark this node as also reachable from expandedFromId
+      existing._expandedBy.add(expandedFromId);
+    }
+  }
+  // Build a fingerprint set of existing edges to avoid duplicates
+  const existingEdgeKeys = new Set();
+  loadedSet.edges.forEach((e) => existingEdgeKeys.add(`${e.from}|${e.to}|${e._type}`));
+
+  for (const e of edges) {
+    const key = `${e.from}|${e.to}|${e.label}`;
+    if (existingEdgeKeys.has(key)) continue;
+    existingEdgeKeys.add(key);
+    const style = EDGE_STYLES[e.label] ?? { color: "#30363d", width: 1 };
+    loadedSet.edges.add({
+      id: edgeIdCounter++,
+      from: e.from,
+      to: e.to,
+      label: e.label,
+      arrows: "to",
+      color: { color: style.color, highlight: "#58a6ff" },
+      width: style.width,
+      dashes: style.dashes ?? false,
+      font: { color: "#8b949e", size: 10 },
+      _type: e.label,
+    });
+  }
+}
+
+// === RENDER ===
+function initNetwork() {
+  const container = document.getElementById("graph");
+  network = new vis.Network(
+    container,
+    { nodes: loadedSet.nodes, edges: loadedSet.edges },
+    {
+      physics: {
+        solver: "forceAtlas2Based",
+        forceAtlas2Based: {
+          gravitationalConstant: -50,
+          centralGravity: 0.01,
+          springLength: 150,
+          springConstant: 0.08,
+          damping: 0.4,
+          avoidOverlap: 0.5,
+        },
+        stabilization: { iterations: 250, updateInterval: 25 },
+        minVelocity: 0.5,
+      },
+      edges: {
+        smooth: { type: "continuous", roundness: 0.2 },
+        font: { size: 0, strokeWidth: 0 },
+        arrows: { to: { scaleFactor: 0.6 } },
+      },
+      interaction: { hover: true, hoverConnectedEdges: true },
+    }
+  );
+
+  network.on("click", onNodeClick);
+  network.on("doubleClick", onNodeDoubleClick);
+}
+
+function applyViewFilters() {
+  const nodeUpdates = [];
+  const edgeUpdates = [];
+  const q = viewState.search.trim().toLowerCase();
+
+  loadedSet.nodes.forEach((n) => {
+    const typeHidden = !viewState.visibleNodeTypes.has(n._group);
+    const matches = !q || (n.label && n.label.toLowerCase().includes(q));
+    const hidden = typeHidden;
+    const borderWidth = q && matches ? 4 : 1;
+    const update = {};
+    if (n.hidden !== hidden) update.hidden = hidden;
+    if ((n.borderWidth ?? 1) !== borderWidth) update.borderWidth = borderWidth;
+    if (Object.keys(update).length) {
+      update.id = n.id;
+      nodeUpdates.push(update);
+    }
+  });
+
+  loadedSet.edges.forEach((e) => {
+    const typeHidden = !viewState.visibleEdgeTypes.has(e._type);
+    const fromNode = loadedSet.nodes.get(e.from);
+    const toNode = loadedSet.nodes.get(e.to);
+    const endpointHidden =
+      (fromNode && fromNode.hidden) || (toNode && toNode.hidden);
+    const hidden = typeHidden || !!endpointHidden;
+    if (e.hidden !== hidden) {
+      edgeUpdates.push({ id: e.id, hidden });
+    }
+  });
+
+  if (nodeUpdates.length) loadedSet.nodes.update(nodeUpdates);
+  if (edgeUpdates.length) loadedSet.edges.update(edgeUpdates);
+  updateLoadedCounter();
+}
+
+function updateLoadedCounter() {
+  const visibleNodes = loadedSet.nodes.get({ filter: (n) => !n.hidden }).length;
+  const visibleEdges = loadedSet.edges.get({ filter: (e) => !e.hidden }).length;
+  const el = document.getElementById("loaded-counter");
+  if (el) {
+    el.textContent = `Loaded: ${loadedSet.nodes.length} nodes, ${loadedSet.edges.length} edges (${visibleNodes}/${visibleEdges} visible)`;
+  }
+}
+
+function degreeToSize(degree) {
+  return Math.min(35, 12 + Math.sqrt(degree) * 4);
+}
+
+function recomputeNodeSizes() {
+  const degree = new Map();
+  loadedSet.edges.forEach((e) => {
+    degree.set(e.from, (degree.get(e.from) ?? 0) + 1);
+    degree.set(e.to, (degree.get(e.to) ?? 0) + 1);
+  });
+
+  const updates = [];
+  loadedSet.nodes.forEach((n) => {
+    const newSize = degreeToSize(degree.get(n.id) ?? 0);
+    if (n.size !== newSize) {
+      updates.push({ id: n.id, size: newSize });
+    }
+  });
+  if (updates.length) loadedSet.nodes.update(updates);
+}
+
+// === EVENTS ===
+async function onNodeClick(params) {
+  if (params.nodes.length === 0) return;
+  const nodeId = params.nodes[0];
+  const node = loadedSet.nodes.get(nodeId);
+
+  // Always update the detail panel
+  document.getElementById("panel-hint").style.display = "none";
+  const content = document.getElementById("panel-content");
+  content.style.display = "block";
+  content.textContent = `[${node._group}] ${node.label}\n\n${JSON.stringify(node._properties, null, 2)}`;
+
+  // Expand if not already expanded and not already in flight
+  if (node._expanded || pendingExpands.has(nodeId)) return;
+
+  if (node._group === "File") {
+    pendingExpands.add(nodeId);
+    try {
+      const data = await fetchExpand("file", { filePath: node._properties.path });
+      mergeIntoLoaded(data, nodeId);
+      recomputeNodeSizes();
+      // Mark file as expanded
+      loadedSet.nodes.update({ id: nodeId, _expanded: true });
+      applyViewFilters();
+    } catch (err) {
+      document.getElementById("status").textContent = err.message;
+    } finally {
+      pendingExpands.delete(nodeId);
+    }
+  } else if (node._group === "Function") {
+    pendingExpands.add(nodeId);
+    try {
+      const data = await fetchExpand("function", {
+        name: node._properties.name,
+        filePath: node._properties.filePath,
+      });
+      mergeIntoLoaded(data, nodeId);
+      recomputeNodeSizes();
+      loadedSet.nodes.update({ id: nodeId, _expanded: true });
+      applyViewFilters();
+    } catch (err) {
+      document.getElementById("status").textContent = err.message;
+    } finally {
+      pendingExpands.delete(nodeId);
+    }
+  }
+  // Repository and Class clicks: detail panel only, no expand.
+}
+
+function onNodeDoubleClick(params) {
+  if (params.nodes.length === 0) return;
+  const nodeId = params.nodes[0];
+  const node = loadedSet.nodes.get(nodeId);
+  if (!node || !node._expanded) return;
+
+  // Find every node that was loaded *because of* nodeId
+  const candidatesToRemove = loadedSet.nodes.get({
+    filter: (n) => n._expandedBy && n._expandedBy.has(nodeId),
+  });
+
+  const removeIds = [];
+  for (const cand of candidatesToRemove) {
+    cand._expandedBy.delete(nodeId);
+    if (cand._expandedBy.size === 0) {
+      removeIds.push(cand.id);
+    }
+  }
+
+  if (removeIds.length > 0) {
+    // Remove edges touching removed nodes
+    const removeIdsSet = new Set(removeIds);
+    const edgeIds = loadedSet.edges.get({
+      filter: (e) => removeIdsSet.has(e.from) || removeIdsSet.has(e.to),
+      fields: ["id"],
+    }).map((e) => e.id);
+
+    loadedSet.edges.remove(edgeIds);
+    loadedSet.nodes.remove(removeIds);
+    recomputeNodeSizes();
+  }
+
+  loadedSet.nodes.update({ id: nodeId, _expanded: false });
+  applyViewFilters();
+}
+
+function bindSidebarEvents() {
+  document.querySelectorAll('input[data-node-type]').forEach((input) => {
+    input.addEventListener("change", (e) => {
+      const t = e.target.dataset.nodeType;
+      if (e.target.checked) {
+        viewState.visibleNodeTypes.add(t);
+      } else {
+        viewState.visibleNodeTypes.delete(t);
+      }
+      applyViewFilters();
+    });
+  });
+
+  document.querySelectorAll('input[data-edge-type]').forEach((input) => {
+    input.addEventListener("change", (e) => {
+      const t = e.target.dataset.edgeType;
+      if (e.target.checked) {
+        viewState.visibleEdgeTypes.add(t);
+      } else {
+        viewState.visibleEdgeTypes.delete(t);
+      }
+      applyViewFilters();
+    });
+  });
+
+  let searchTimer = null;
+  const searchInput = document.getElementById("search-input");
+  const searchResult = document.getElementById("search-result");
+  searchInput.addEventListener("input", (e) => {
+    viewState.search = e.target.value;
+    applyViewFilters();
+
+    // Count local matches
+    const q = viewState.search.trim().toLowerCase();
+    if (!q) {
+      searchResult.textContent = "";
+      return;
+    }
+    const localHits = loadedSet.nodes.get({
+      filter: (n) => n.label && n.label.toLowerCase().includes(q),
+    }).length;
+    searchResult.textContent = `${localHits} local match${localHits === 1 ? "" : "es"}`;
+
+    // Debounced server fallback for "load missing matches"
+    clearTimeout(searchTimer);
+    searchTimer = setTimeout(async () => {
+      if (viewState.search.trim().length < 2) return;
+      try {
+        const data = await fetchSearch(viewState.search.trim());
+        if (data.nodes && data.nodes.length > 0) {
+          mergeIntoLoaded(data);
+          recomputeNodeSizes();
+          applyViewFilters();
+          searchResult.textContent = `${localHits} local + ${data.nodes.length} server match${data.nodes.length === 1 ? "" : "es"}`;
+        } else if (localHits === 0) {
+          searchResult.textContent = "No matches";
+        }
+      } catch {
+        // Quietly ignore search failures — user is still typing
+      }
+    }, 350);
+  });
+
+  document.getElementById("reset-view-btn").addEventListener("click", () => {
+    viewState.search = "";
+    viewState.visibleNodeTypes = new Set(["Repository", "File", "Class", "Function"]);
+    viewState.visibleEdgeTypes = new Set([
+      "CONTAINS_FILE", "CONTAINS", "HAS_METHOD", "IMPORTS", "CALLS",
+    ]);
+    document.getElementById("search-input").value = "";
+    document.getElementById("search-result").textContent = "";
+    document.querySelectorAll('input[data-node-type]').forEach((i) => { i.checked = true; });
+    document.querySelectorAll('input[data-edge-type]').forEach((i) => {
+      i.checked = i.dataset.edgeType !== "IMPORTS_SYMBOL";
+    });
+    applyViewFilters();
+  });
+
+  document.getElementById("reset-all-btn").addEventListener("click", async () => {
+    loadedSet.nodes.clear();
+    loadedSet.edges.clear();
+    edgeIdCounter = 0;
+    try {
+      const data = await fetchGraph(parseUrlFilters());
+      mergeIntoLoaded(data);
+      recomputeNodeSizes();
+      applyViewFilters();
+    } catch (err) {
+      document.getElementById("status").textContent = err.message;
+    }
+  });
+
+  let physicsEnabled = true;
+  document.getElementById("freeze-btn").addEventListener("click", (e) => {
+    physicsEnabled = !physicsEnabled;
+    network.setOptions({ physics: { enabled: physicsEnabled } });
+    e.target.textContent = physicsEnabled ? "Freeze layout" : "Unfreeze layout";
+  });
+}
+
+// === BOOT ===
+async function boot() {
+  const status = document.getElementById("status");
+  status.textContent = "Fetching graph data...";
+
+  initNetwork();
+  bindSidebarEvents();
+
+  let data;
+  try {
+    data = await fetchGraph(parseUrlFilters());
+  } catch (err) {
+    status.textContent = err.message;
+    return;
+  }
+
+  if (data.nodes.length === 0) {
+    status.textContent = "No graph data — run `code-graph-rag index` first, then refresh.";
+    return;
+  }
+
+  mergeIntoLoaded(data);
+  recomputeNodeSizes();
+  applyViewFilters();
+  status.textContent = `${loadedSet.nodes.length} nodes, ${loadedSet.edges.length} edges`;
+}
+
+boot().catch(console.error);

package/dist/visualize/public/index.html

@@ -0,0 +1,88 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Code Graph RAG — Visualization</title>
+  <script src="https://unpkg.com/vis-network/standalone/umd/vis-network.min.js"></script>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: monospace; background: #0d1117; color: #c9d1d9; height: 100vh; display: flex; flex-direction: column; }
+    #header { padding: 12px 16px; background: #161b22; border-bottom: 1px solid #30363d; font-size: 14px; }
+    #header h1 { font-size: 16px; color: #58a6ff; }
+    #main { display: flex; flex: 1; overflow: hidden; }
+
+    #sidebar { width: 240px; background: #161b22; border-right: 1px solid #30363d; padding: 16px; overflow-y: auto; font-size: 12px; }
+    #sidebar h3 { font-size: 11px; color: #58a6ff; margin-bottom: 6px; margin-top: 14px; text-transform: uppercase; letter-spacing: 0.5px; }
+    #sidebar h3:first-child { margin-top: 0; }
+    #sidebar input[type="text"] {
+      width: 100%; padding: 6px 8px; background: #0d1117; color: #c9d1d9;
+      border: 1px solid #30363d; border-radius: 4px; font-family: inherit; font-size: 12px;
+    }
+    #sidebar label { display: flex; align-items: center; gap: 6px; padding: 3px 0; cursor: pointer; }
+    #sidebar label input { cursor: pointer; }
+    #sidebar .legend-row { display: flex; align-items: center; gap: 6px; padding: 2px 0; }
+    #sidebar .legend-swatch { width: 10px; height: 10px; border-radius: 50%; }
+    #sidebar button {
+      width: 100%; padding: 6px 8px; margin-top: 4px;
+      background: #21262d; color: #c9d1d9; border: 1px solid #30363d; border-radius: 4px;
+      font-family: inherit; font-size: 12px; cursor: pointer;
+    }
+    #sidebar button:hover { background: #30363d; }
+    #sidebar #search-result { color: #8b949e; font-size: 11px; margin-top: 4px; min-height: 14px; }
+    #sidebar #loaded-counter { color: #8b949e; margin-top: 12px; font-size: 11px; }
+
+    #graph { flex: 1; }
+    #panel { width: 300px; background: #161b22; border-left: 1px solid #30363d; padding: 16px; overflow-y: auto; font-size: 12px; }
+    #panel h2 { font-size: 14px; color: #58a6ff; margin-bottom: 8px; }
+    #panel pre { white-space: pre-wrap; word-break: break-all; color: #8b949e; }
+    #status { color: #8b949e; }
+  </style>
+</head>
+<body>
+  <div id="header">
+    <h1>Code Graph RAG</h1>
+    <span id="status">Loading graph...</span>
+  </div>
+  <div id="main">
+    <div id="sidebar">
+      <h3>Search</h3>
+      <input id="search-input" type="text" placeholder="function or class name…" autocomplete="off">
+      <div id="search-result"></div>
+
+      <h3>Show node types</h3>
+      <label><input type="checkbox" data-node-type="Repository" checked> Repository</label>
+      <label><input type="checkbox" data-node-type="File" checked> File</label>
+      <label><input type="checkbox" data-node-type="Class" checked> Class</label>
+      <label><input type="checkbox" data-node-type="Function" checked> Function</label>
+
+      <h3>Show edge types</h3>
+      <label><input type="checkbox" data-edge-type="CONTAINS_FILE" checked> CONTAINS_FILE</label>
+      <label><input type="checkbox" data-edge-type="CONTAINS" checked> CONTAINS</label>
+      <label><input type="checkbox" data-edge-type="HAS_METHOD" checked> HAS_METHOD</label>
+      <label><input type="checkbox" data-edge-type="IMPORTS" checked> IMPORTS</label>
+      <label><input type="checkbox" data-edge-type="CALLS" checked> CALLS</label>
+      <label><input type="checkbox" data-edge-type="IMPORTS_SYMBOL"> IMPORTS_SYMBOL</label>
+
+      <h3>Legend</h3>
+      <div class="legend-row"><span class="legend-swatch" style="background:#1f6feb"></span> Repository</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#1a7f37"></span> File</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#8957e5"></span> Class</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#da3633"></span> Function</div>
+
+      <button id="freeze-btn">Freeze layout</button>
+      <button id="reset-view-btn">Reset view filters</button>
+      <button id="reset-all-btn">Reset everything</button>
+      <div id="loaded-counter">Loaded: 0 nodes, 0 edges</div>
+    </div>
+
+    <div id="graph"></div>
+    <div id="panel">
+      <h2>Details</h2>
+      <p id="panel-hint" style="color:#8b949e">Click a node to see details</p>
+      <pre id="panel-content" style="display:none"></pre>
+    </div>
+  </div>
+  <script src="graph.js"></script>
+</body>
+</html>

package/dist/visualize/queries.d.ts

@@ -0,0 +1,14 @@
+export interface CypherQuery {
+    cypher: string;
+    params: Record<string, unknown>;
+}
+export declare const INITIAL_LIMIT = 500;
+export declare const EXPAND_FILE_LIMIT = 100;
+export declare const EXPAND_FUNCTION_LIMIT = 50;
+export declare const SEARCH_LIMIT = 25;
+export declare function repoOverview(repoName?: string): CypherQuery;
+export declare function filterByFile(relativePath: string): CypherQuery;
+export declare function filterByFunction(name: string): CypherQuery;
+export declare function expandFile(filePath: string): CypherQuery;
+export declare function expandFunction(name: string, filePath: string): CypherQuery;
+export declare function searchByName(prefix: string): CypherQuery;