@massu/core 1.6.1 → 1.6.3

package/dist/cli.js

@@ -17612,7 +17612,7 @@ import { existsSync as existsSync23, mkdirSync as mkdirSync9, readdirSync as rea
 function getCodeGraphDb() {
   const dbPath = getResolvedPaths().codegraphDbPath;
   if (!existsSync23(dbPath)) {
-    throw new Error(`CodeGraph database not found at ${dbPath}. Run 'npx @colbymchenry/codegraph sync' first.`);
+    throw new CodegraphDbNotInitializedError(dbPath);
   }
   const db = new Database2(dbPath, { readonly: true });
   db.pragma("journal_mode = WAL");
@@ -17876,18 +17876,18 @@ function initDataSchema(db) {
     END;
   `);
 }
-function isDataStale(dataDb2, codegraphDb2) {
-  const lastBuild = dataDb2.prepare("SELECT value FROM massu_meta WHERE key = 'last_build_time'").get();
+function isDataStale(dataDb, codegraphDb) {
+  const lastBuild = dataDb.prepare("SELECT value FROM massu_meta WHERE key = 'last_build_time'").get();
   if (!lastBuild) return true;
-  const latestIndexed = codegraphDb2.prepare("SELECT MAX(indexed_at) as latest FROM files").get();
+  const latestIndexed = codegraphDb.prepare("SELECT MAX(indexed_at) as latest FROM files").get();
   if (!latestIndexed?.latest) return true;
   return latestIndexed.latest * 1e3 > new Date(lastBuild.value).getTime();
 }
-function updateBuildTimestamp(dataDb2) {
-  dataDb2.prepare("INSERT OR REPLACE INTO massu_meta (key, value) VALUES ('last_build_time', ?)").run((/* @__PURE__ */ new Date()).toISOString());
+function updateBuildTimestamp(dataDb) {
+  dataDb.prepare("INSERT OR REPLACE INTO massu_meta (key, value) VALUES ('last_build_time', ?)").run((/* @__PURE__ */ new Date()).toISOString());
 }
-function isPythonDataStale(dataDb2, pythonRoot) {
-  const lastBuild = dataDb2.prepare("SELECT value FROM massu_py_meta WHERE key = 'last_build_time'").get();
+function isPythonDataStale(dataDb, pythonRoot) {
+  const lastBuild = dataDb.prepare("SELECT value FROM massu_py_meta WHERE key = 'last_build_time'").get();
   if (!lastBuild) return true;
   const lastBuildTime = new Date(lastBuild.value).getTime();
   function checkDir(dir) {
@@ -17908,13 +17908,22 @@ function isPythonDataStale(dataDb2, pythonRoot) {
   }
   return checkDir(pythonRoot);
 }
-function updatePythonBuildTimestamp(dataDb2) {
-  dataDb2.prepare("INSERT OR REPLACE INTO massu_py_meta (key, value) VALUES ('last_build_time', ?)").run((/* @__PURE__ */ new Date()).toISOString());
+function updatePythonBuildTimestamp(dataDb) {
+  dataDb.prepare("INSERT OR REPLACE INTO massu_py_meta (key, value) VALUES ('last_build_time', ?)").run((/* @__PURE__ */ new Date()).toISOString());
 }
+var CodegraphDbNotInitializedError;
 var init_db = __esm({
   "src/db.ts"() {
     "use strict";
     init_config();
+    CodegraphDbNotInitializedError = class extends Error {
+      dbPath;
+      constructor(dbPath) {
+        super(`CodeGraph database not found at ${dbPath}`);
+        this.name = "CodegraphDbNotInitializedError";
+        this.dbPath = dbPath;
+      }
+    };
   }
 });
 
@@ -18088,15 +18097,15 @@ function toRelative(absPath) {
   }
   return absPath;
 }
-function buildImportIndex(dataDb2, codegraphDb2) {
-  const files = codegraphDb2.prepare("SELECT path FROM files WHERE path LIKE 'src/%'").all();
-  dataDb2.exec("DELETE FROM massu_imports");
-  const insertStmt = dataDb2.prepare(
+function buildImportIndex(dataDb, codegraphDb) {
+  const files = codegraphDb.prepare("SELECT path FROM files WHERE path LIKE 'src/%'").all();
+  dataDb.exec("DELETE FROM massu_imports");
+  const insertStmt = dataDb.prepare(
     "INSERT INTO massu_imports (source_file, target_file, import_type, imported_names, line) VALUES (?, ?, ?, ?, ?)"
   );
   let edgeCount = 0;
   const projectRoot = getProjectRoot();
-  const insertMany = dataDb2.transaction((edges) => {
+  const insertMany = dataDb.transaction((edges) => {
     for (const edge of edges) {
       insertStmt.run(edge.source_file, edge.target_file, edge.import_type, edge.imported_names, edge.line);
     }
@@ -18255,20 +18264,20 @@ function searchDirectory(dir, pattern, results) {
 function escapeRegex2(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function buildTrpcIndex(dataDb2) {
-  dataDb2.exec("DELETE FROM massu_trpc_call_sites");
-  dataDb2.exec("DELETE FROM massu_trpc_procedures");
+function buildTrpcIndex(dataDb) {
+  dataDb.exec("DELETE FROM massu_trpc_call_sites");
+  dataDb.exec("DELETE FROM massu_trpc_procedures");
   const routerMappings = parseRootRouter();
-  const insertProc = dataDb2.prepare(
+  const insertProc = dataDb.prepare(
     "INSERT INTO massu_trpc_procedures (router_file, router_name, procedure_name, procedure_type, has_ui_caller) VALUES (?, ?, ?, ?, ?)"
   );
-  const insertCallSite = dataDb2.prepare(
+  const insertCallSite = dataDb.prepare(
     "INSERT INTO massu_trpc_call_sites (procedure_id, file, line, call_pattern) VALUES (?, ?, ?, ?)"
   );
   let totalProcedures = 0;
   let withCallers = 0;
   let withoutCallers = 0;
-  const insertAll = dataDb2.transaction(() => {
+  const insertAll = dataDb.transaction(() => {
     for (const router of routerMappings) {
       const procedures = extractProcedures(router.file);
       for (const proc of procedures) {
@@ -18312,10 +18321,10 @@ function derivePortal(route) {
   const parts = route.split("/").filter(Boolean);
   return parts[0] ?? "default";
 }
-function traceImports(startFile, dataDb2, visited, components, hooks, maxDepth = 5) {
+function traceImports(startFile, dataDb, visited, components, hooks, maxDepth = 5) {
   if (maxDepth <= 0 || visited.has(startFile)) return;
   visited.add(startFile);
-  const imports = dataDb2.prepare(
+  const imports = dataDb.prepare(
     "SELECT target_file, imported_names FROM massu_imports WHERE source_file = ?"
   ).all(startFile);
   for (const imp of imports) {
@@ -18327,7 +18336,7 @@ function traceImports(startFile, dataDb2, visited, components, hooks, maxDepth =
       hooks.add(target);
     }
     if (target.startsWith("src/")) {
-      traceImports(target, dataDb2, visited, components, hooks, maxDepth - 1);
+      traceImports(target, dataDb, visited, components, hooks, maxDepth - 1);
     }
   }
 }
@@ -18349,10 +18358,10 @@ function findRouterCalls(files) {
   }
   return [...routers];
 }
-function findTablesFromRouters(routerNames, dataDb2) {
+function findTablesFromRouters(routerNames, dataDb) {
   const tables = /* @__PURE__ */ new Set();
   for (const routerName of routerNames) {
-    const procs = dataDb2.prepare(
+    const procs = dataDb.prepare(
       "SELECT DISTINCT router_file FROM massu_trpc_procedures WHERE router_name = ?"
     ).all(routerName);
     for (const proc of procs) {
@@ -18373,26 +18382,26 @@ function findTablesFromRouters(routerNames, dataDb2) {
   }
   return [...tables];
 }
-function buildPageDeps(dataDb2, codegraphDb2) {
-  dataDb2.exec("DELETE FROM massu_page_deps");
-  const pages = codegraphDb2.prepare(
+function buildPageDeps(dataDb, codegraphDb) {
+  dataDb.exec("DELETE FROM massu_page_deps");
+  const pages = codegraphDb.prepare(
     "SELECT path FROM files WHERE path LIKE 'src/app/%/page.tsx' OR path = 'src/app/page.tsx'"
   ).all();
-  const insertStmt = dataDb2.prepare(
+  const insertStmt = dataDb.prepare(
     "INSERT INTO massu_page_deps (page_file, route, portal, components, hooks, routers, tables_touched) VALUES (?, ?, ?, ?, ?, ?, ?)"
   );
   let count = 0;
-  const insertAll = dataDb2.transaction(() => {
+  const insertAll = dataDb.transaction(() => {
     for (const page of pages) {
       const route = deriveRoute(page.path);
       const portal = derivePortal(route);
       const visited = /* @__PURE__ */ new Set();
       const components = /* @__PURE__ */ new Set();
       const hooks = /* @__PURE__ */ new Set();
-      traceImports(page.path, dataDb2, visited, components, hooks);
+      traceImports(page.path, dataDb, visited, components, hooks);
       const allFiles = [...visited];
       const routers = findRouterCalls(allFiles);
-      const tables = findTablesFromRouters(routers, dataDb2);
+      const tables = findTablesFromRouters(routers, dataDb);
       insertStmt.run(
         page.path,
         route,
@@ -18408,8 +18417,8 @@ function buildPageDeps(dataDb2, codegraphDb2) {
   insertAll();
   return count;
 }
-function getPageChain(dataDb2, pageFile) {
-  const row = dataDb2.prepare("SELECT * FROM massu_page_deps WHERE page_file = ?").get(pageFile);
+function getPageChain(dataDb, pageFile) {
+  const row = dataDb.prepare("SELECT * FROM massu_page_deps WHERE page_file = ?").get(pageFile);
   if (!row) return null;
   return {
     page: row.page_file,
@@ -18421,10 +18430,10 @@ function getPageChain(dataDb2, pageFile) {
     tables: JSON.parse(row.tables_touched)
   };
 }
-function findAffectedPages(dataDb2, file) {
-  const directPage = getPageChain(dataDb2, file);
+function findAffectedPages(dataDb, file) {
+  const directPage = getPageChain(dataDb, file);
   if (directPage) return [directPage];
-  const importers = dataDb2.prepare(
+  const importers = dataDb.prepare(
     "SELECT source_file FROM massu_imports WHERE target_file = ?"
   ).all(file);
   const affectedFiles = /* @__PURE__ */ new Set([file, ...importers.map((i) => i.source_file)]);
@@ -18435,7 +18444,7 @@ function findAffectedPages(dataDb2, file) {
   while (frontier.length > 0 && depth < maxDepth) {
     const next = [];
     for (const f2 of frontier) {
-      const upstreamImporters = dataDb2.prepare(
+      const upstreamImporters = dataDb.prepare(
         "SELECT source_file FROM massu_imports WHERE target_file = ?"
       ).all(f2);
       for (const imp of upstreamImporters) {
@@ -18449,7 +18458,7 @@ function findAffectedPages(dataDb2, file) {
     frontier = next;
     depth++;
   }
-  const allPages = dataDb2.prepare("SELECT * FROM massu_page_deps").all();
+  const allPages = dataDb.prepare("SELECT * FROM massu_page_deps").all();
   const results = [];
   for (const row of allPages) {
     if (affectedFiles.has(row.page_file)) {
@@ -18475,8 +18484,8 @@ var init_page_deps = __esm({
 });
 
 // src/middleware-tree.ts
-function buildMiddlewareTree(dataDb2) {
-  dataDb2.exec("DELETE FROM massu_middleware_tree");
+function buildMiddlewareTree(dataDb) {
+  dataDb.exec("DELETE FROM massu_middleware_tree");
   const config = getConfig();
   const middlewareFile = config.paths.middleware ?? "src/middleware.ts";
   if (!middlewareFile) return 0;
@@ -18485,7 +18494,7 @@ function buildMiddlewareTree(dataDb2) {
   visited.add(middlewareFile);
   while (queue.length > 0) {
     const current = queue.shift();
-    const imports = dataDb2.prepare(
+    const imports = dataDb.prepare(
       "SELECT target_file FROM massu_imports WHERE source_file = ?"
     ).all(current);
     for (const imp of imports) {
@@ -18495,8 +18504,8 @@ function buildMiddlewareTree(dataDb2) {
       }
     }
   }
-  const insertStmt = dataDb2.prepare("INSERT INTO massu_middleware_tree (file) VALUES (?)");
-  const insertAll = dataDb2.transaction(() => {
+  const insertStmt = dataDb.prepare("INSERT INTO massu_middleware_tree (file) VALUES (?)");
+  const insertAll = dataDb.transaction(() => {
     for (const file of visited) {
       insertStmt.run(file);
     }
@@ -18504,8 +18513,8 @@ function buildMiddlewareTree(dataDb2) {
   insertAll();
   return visited.size;
 }
-function isInMiddlewareTree(dataDb2, file) {
-  const result = dataDb2.prepare("SELECT 1 FROM massu_middleware_tree WHERE file = ?").get(file);
+function isInMiddlewareTree(dataDb, file) {
+  const result = dataDb.prepare("SELECT 1 FROM massu_middleware_tree WHERE file = ?").get(file);
   return result !== void 0;
 }
 var init_middleware_tree = __esm({
@@ -18567,12 +18576,12 @@ function globMatchSimple(name, pattern) {
   const regexStr = pattern.replace(/\./g, "\\.").replace(/\*/g, ".*").replace(/\?/g, ".");
   return new RegExp(`^${regexStr}$`).test(name);
 }
-function findCrossDomainImports(dataDb2) {
+function findCrossDomainImports(dataDb) {
   const domains = getDomains();
   const config = getConfig();
   const srcPrefix = config.paths.source;
   const srcPattern = srcPrefix + "/%";
-  const imports = dataDb2.prepare(
+  const imports = dataDb.prepare(
     "SELECT source_file, target_file FROM massu_imports WHERE source_file LIKE ? AND target_file LIKE ?"
   ).all(srcPattern, srcPattern);
   const crossings = [];
@@ -18594,7 +18603,7 @@ function findCrossDomainImports(dataDb2) {
   }
   return crossings;
 }
-function getFilesInDomain(dataDb2, codegraphDb2, domainName) {
+function getFilesInDomain(dataDb, codegraphDb, domainName) {
   const domains = getDomains();
   const config = getConfig();
   const domain = domains.find((d2) => d2.name === domainName);
@@ -18602,7 +18611,7 @@ function getFilesInDomain(dataDb2, codegraphDb2, domainName) {
   const srcPrefix = config.paths.source;
   const routersPath = config.paths.routers ?? "src/server/api/routers";
   const srcPattern = srcPrefix + "/%";
-  const allFiles = codegraphDb2.prepare("SELECT path FROM files WHERE path LIKE ?").all(srcPattern);
+  const allFiles = codegraphDb.prepare("SELECT path FROM files WHERE path LIKE ?").all(srcPattern);
   const routers = [];
   const pages = [];
   const components = [];
@@ -18956,16 +18965,16 @@ function walkPythonFiles(dir, excludeDirs) {
   }
   return files;
 }
-function buildPythonImportIndex(dataDb2, pythonRoot, excludeDirs = ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache"]) {
+function buildPythonImportIndex(dataDb, pythonRoot, excludeDirs = ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache"]) {
   const projectRoot = getProjectRoot();
   const absRoot = resolve24(projectRoot, pythonRoot);
-  dataDb2.exec("DELETE FROM massu_py_imports");
-  const insertStmt = dataDb2.prepare(
+  dataDb.exec("DELETE FROM massu_py_imports");
+  const insertStmt = dataDb.prepare(
     "INSERT INTO massu_py_imports (source_file, target_file, import_type, imported_names, line) VALUES (?, ?, ?, ?, ?)"
   );
   const files = walkPythonFiles(absRoot, excludeDirs);
   let edgeCount = 0;
-  const insertMany = dataDb2.transaction((edges) => {
+  const insertMany = dataDb.transaction((edges) => {
     for (const edge of edges) {
       insertStmt.run(edge.source, edge.target, edge.type, edge.names, edge.line);
     }
@@ -19259,17 +19268,17 @@ function walkPyFiles(dir, excludeDirs) {
   }
   return files;
 }
-function buildPythonRouteIndex(dataDb2, pythonRoot, excludeDirs = ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache"]) {
+function buildPythonRouteIndex(dataDb, pythonRoot, excludeDirs = ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache"]) {
   const projectRoot = getProjectRoot();
   const absRoot = join16(projectRoot, pythonRoot);
-  dataDb2.exec("DELETE FROM massu_py_routes");
-  dataDb2.exec("DELETE FROM massu_py_route_callers");
-  const insertStmt = dataDb2.prepare(
+  dataDb.exec("DELETE FROM massu_py_routes");
+  dataDb.exec("DELETE FROM massu_py_route_callers");
+  const insertStmt = dataDb.prepare(
     "INSERT INTO massu_py_routes (file, method, path, function_name, dependencies, request_model, response_model, is_authenticated, line) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)"
   );
   const files = walkPyFiles(absRoot, excludeDirs);
   let count = 0;
-  dataDb2.transaction(() => {
+  dataDb.transaction(() => {
     for (const absFile of files) {
       const relFile = relative7(projectRoot, absFile);
       let source;
@@ -19503,20 +19512,20 @@ function walkPyFiles2(dir, excludeDirs) {
   }
   return files;
 }
-function buildPythonModelIndex(dataDb2, pythonRoot, excludeDirs = ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache"]) {
+function buildPythonModelIndex(dataDb, pythonRoot, excludeDirs = ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache"]) {
   const projectRoot = getProjectRoot();
   const absRoot = join17(projectRoot, pythonRoot);
-  dataDb2.exec("DELETE FROM massu_py_models");
-  dataDb2.exec("DELETE FROM massu_py_fk_edges");
-  const insertModel = dataDb2.prepare(
+  dataDb.exec("DELETE FROM massu_py_models");
+  dataDb.exec("DELETE FROM massu_py_fk_edges");
+  const insertModel = dataDb.prepare(
     "INSERT INTO massu_py_models (class_name, table_name, file, line, columns, relationships, foreign_keys) VALUES (?, ?, ?, ?, ?, ?, ?)"
   );
-  const insertFk = dataDb2.prepare(
+  const insertFk = dataDb.prepare(
     "INSERT INTO massu_py_fk_edges (source_table, source_column, target_table, target_column) VALUES (?, ?, ?, ?)"
   );
   const files = walkPyFiles2(absRoot, excludeDirs);
   let count = 0;
-  dataDb2.transaction(() => {
+  dataDb.transaction(() => {
     for (const absFile of files) {
       const relFile = relative8(projectRoot, absFile);
       let source;
@@ -19783,10 +19792,10 @@ var init_migration_parser = __esm({
 // src/python/migration-indexer.ts
 import { readFileSync as readFileSync29, readdirSync as readdirSync20 } from "fs";
 import { join as join18, relative as relative9 } from "path";
-function buildPythonMigrationIndex(dataDb2, alembicDir) {
+function buildPythonMigrationIndex(dataDb, alembicDir) {
   const projectRoot = getProjectRoot();
   const absDir = join18(projectRoot, alembicDir);
-  dataDb2.exec("DELETE FROM massu_py_migrations");
+  dataDb.exec("DELETE FROM massu_py_migrations");
   const versionsDir = join18(absDir, "versions");
   let files = [];
   try {
@@ -19797,7 +19806,7 @@ function buildPythonMigrationIndex(dataDb2, alembicDir) {
     } catch {
     }
   }
-  const insertStmt = dataDb2.prepare(
+  const insertStmt = dataDb.prepare(
     "INSERT INTO massu_py_migrations (revision, down_revision, file, description, operations, is_head) VALUES (?, ?, ?, ?, ?, ?)"
   );
   let count = 0;
@@ -19823,7 +19832,7 @@ function buildPythonMigrationIndex(dataDb2, alembicDir) {
       operations: JSON.stringify(parsed.operations)
     });
   }
-  dataDb2.transaction(() => {
+  dataDb.transaction(() => {
     for (const row of rows) {
       const isHead = !hasDownRef.has(row.revision) ? 1 : 0;
       insertStmt.run(row.revision, row.downRevision, row.file, row.description, row.operations, isHead);
@@ -19843,15 +19852,15 @@ var init_migration_indexer = __esm({
 // src/python/coupling-detector.ts
 import { readFileSync as readFileSync30, readdirSync as readdirSync21 } from "fs";
 import { join as join19, relative as relative10 } from "path";
-function buildPythonCouplingIndex(dataDb2) {
+function buildPythonCouplingIndex(dataDb) {
   const projectRoot = getProjectRoot();
   const config = getConfig();
   const srcDir = join19(projectRoot, config.paths.source);
-  const routes = dataDb2.prepare("SELECT id, method, path FROM massu_py_routes").all();
+  const routes = dataDb.prepare("SELECT id, method, path FROM massu_py_routes").all();
   if (routes.length === 0) return 0;
-  dataDb2.exec("DELETE FROM massu_py_route_callers");
+  dataDb.exec("DELETE FROM massu_py_route_callers");
   const frontendFiles = walkFrontendFiles(srcDir);
-  const insertStmt = dataDb2.prepare(
+  const insertStmt = dataDb.prepare(
     "INSERT INTO massu_py_route_callers (route_id, frontend_file, line, call_pattern) VALUES (?, ?, ?, ?)"
   );
   let count = 0;
@@ -19873,7 +19882,7 @@ function buildPythonCouplingIndex(dataDb2) {
     /\.patch\s*\(\s*[`'"](\/api\/[^`'"]*)[`'"]/g
     // client.patch('/api/...')
   ];
-  dataDb2.transaction(() => {
+  dataDb.transaction(() => {
     for (const absFile of frontendFiles) {
       const relFile = relative10(projectRoot, absFile);
       let source;
@@ -21389,22 +21398,22 @@ function getSentinelToolDefinitions() {
     }
   ];
 }
-function handleSentinelToolCall(name, args2, dataDb2) {
+function handleSentinelToolCall(name, args2, dataDb) {
   const prefix3 = getConfig().toolPrefix + "_";
   const baseName = name.startsWith(prefix3) ? name.slice(prefix3.length) : name;
   switch (baseName) {
     case "sentinel_search":
-      return handleSearch2(args2, dataDb2);
+      return handleSearch2(args2, dataDb);
     case "sentinel_detail":
-      return handleDetail2(args2, dataDb2);
+      return handleDetail2(args2, dataDb);
     case "sentinel_impact":
-      return handleImpact(args2, dataDb2);
+      return handleImpact(args2, dataDb);
     case "sentinel_validate":
-      return handleValidate(args2, dataDb2);
+      return handleValidate(args2, dataDb);
     case "sentinel_register":
-      return handleRegister(args2, dataDb2);
+      return handleRegister(args2, dataDb);
     case "sentinel_parity":
-      return handleParityCheck(args2, dataDb2);
+      return handleParityCheck(args2, dataDb);
     default:
       return text4(`Unknown sentinel tool: ${name}`);
   }
@@ -21718,10 +21727,10 @@ function parseFeatureAnnotations(source) {
   }
   return annotations;
 }
-function scanTrpcProcedures(dataDb2) {
+function scanTrpcProcedures(dataDb) {
   const features = [];
   const featureMap = /* @__PURE__ */ new Map();
-  const procedures = dataDb2.prepare(`
+  const procedures = dataDb.prepare(`
     SELECT router_name, procedure_name, procedure_type, router_file
     FROM massu_trpc_procedures
     ORDER BY router_name, procedure_name
@@ -21761,9 +21770,9 @@ function scanTrpcProcedures(dataDb2) {
   }
   return Array.from(featureMap.values());
 }
-function scanPageRoutes(dataDb2) {
+function scanPageRoutes(dataDb) {
   const features = [];
-  const pages = dataDb2.prepare(`
+  const pages = dataDb.prepare(`
     SELECT page_file, route, portal, components, hooks, routers
     FROM massu_page_deps
     ORDER BY route
@@ -21795,7 +21804,7 @@ function scanPageRoutes(dataDb2) {
   }
   return features;
 }
-function scanComponentExports(dataDb2) {
+function scanComponentExports(dataDb) {
   const features = [];
   const config = getConfig();
   const projectRoot = getProjectRoot();
@@ -21885,10 +21894,10 @@ function walkDir2(dir) {
   }
   return results;
 }
-function runFeatureScan(dataDb2) {
-  const procedureFeatures = scanTrpcProcedures(dataDb2);
-  const pageFeatures = scanPageRoutes(dataDb2);
-  const componentFeatures = scanComponentExports(dataDb2);
+function runFeatureScan(dataDb) {
+  const procedureFeatures = scanTrpcProcedures(dataDb);
+  const pageFeatures = scanPageRoutes(dataDb);
+  const componentFeatures = scanComponentExports(dataDb);
   const allFeatures = /* @__PURE__ */ new Map();
   for (const f2 of procedureFeatures) {
     allFeatures.set(f2.feature_key, f2);
@@ -21901,7 +21910,7 @@ function runFeatureScan(dataDb2) {
   }
   let registered = 0;
   for (const feature of allFeatures.values()) {
-    const featureId = upsertFeature(dataDb2, {
+    const featureId = upsertFeature(dataDb, {
       feature_key: feature.feature_key,
       domain: feature.domain,
       subdomain: feature.subdomain,
@@ -21912,15 +21921,15 @@ function runFeatureScan(dataDb2) {
       portal_scope: feature.portal_scope
     });
     for (const comp of feature.components) {
-      linkComponent(dataDb2, featureId, comp.file, comp.name, comp.role, comp.isPrimary);
+      linkComponent(dataDb, featureId, comp.file, comp.name, comp.role, comp.isPrimary);
     }
     for (const proc of feature.procedures) {
-      linkProcedure(dataDb2, featureId, proc.router, proc.procedure, proc.type);
+      linkProcedure(dataDb, featureId, proc.router, proc.procedure, proc.type);
     }
     for (const page of feature.pages) {
-      linkPage(dataDb2, featureId, page.route, page.portal ?? void 0);
+      linkPage(dataDb, featureId, page.route, page.portal ?? void 0);
     }
-    logChange(dataDb2, featureId, "created", "Auto-discovered by sentinel scanner", void 0, "scanner");
+    logChange(dataDb, featureId, "created", "Auto-discovered by sentinel scanner", void 0, "scanner");
     registered++;
   }
   return {
@@ -25696,9 +25705,9 @@ function handleGaps(db, args2) {
   lines.push(`## Knowledge Gap Analysis (${checkType})`);
   lines.push("");
   if (checkType === "features") {
-    let dataDb2 = null;
+    let dataDb = null;
     try {
-      dataDb2 = getDataDb();
+      dataDb = getDataDb();
       let sql = "SELECT feature_key, title, domain, status FROM massu_sentinel WHERE status = 'active'";
       const params = [];
       if (domain) {
@@ -25706,7 +25715,7 @@ function handleGaps(db, args2) {
         params.push(`%${domain}%`);
       }
       sql += " ORDER BY domain, feature_key";
-      const features = dataDb2.prepare(sql).all(...params);
+      const features = dataDb.prepare(sql).all(...params);
       lines.push(`| Feature | Domain | Knowledge Hits | Status |`);
       lines.push(`|---------|--------|----------------|--------|`);
       let gapCount = 0;
@@ -25735,7 +25744,7 @@ function handleGaps(db, args2) {
     } catch (error) {
       lines.push(`Error querying sentinel: ${error instanceof Error ? error.message : String(error)}`);
     } finally {
-      dataDb2?.close();
+      dataDb?.close();
     }
   } else if (checkType === "routers") {
     try {
@@ -25762,10 +25771,10 @@ function handleGaps(db, args2) {
     lines.push("### Pattern Coverage");
     lines.push(`Documented domains: ${[...documentedDomains].join(", ")}`);
     lines.push("");
-    let dataDb2 = null;
+    let dataDb = null;
     try {
-      dataDb2 = getDataDb();
-      const domains = dataDb2.prepare(
+      dataDb = getDataDb();
+      const domains = dataDb.prepare(
         "SELECT DISTINCT domain FROM massu_sentinel WHERE status = 'active' ORDER BY domain"
       ).all();
       for (const d2 of domains) {
@@ -25774,7 +25783,7 @@ function handleGaps(db, args2) {
       }
     } catch {
     } finally {
-      dataDb2?.close();
+      dataDb?.close();
     }
   } else if (checkType === "incidents") {
     const incidents = db.prepare(
@@ -26217,30 +26226,30 @@ function isPythonTool(name) {
   const base = stripPrefix2(name);
   return base.startsWith("py_");
 }
-function handlePythonToolCall(name, args2, dataDb2) {
+function handlePythonToolCall(name, args2, dataDb) {
   const baseName = stripPrefix2(name);
   switch (baseName) {
     case "py_imports":
-      return handlePyImports(args2, dataDb2);
+      return handlePyImports(args2, dataDb);
     case "py_routes":
-      return handlePyRoutes(args2, dataDb2);
+      return handlePyRoutes(args2, dataDb);
     case "py_coupling":
-      return handlePyCoupling(args2, dataDb2);
+      return handlePyCoupling(args2, dataDb);
     case "py_models":
-      return handlePyModels(args2, dataDb2);
+      return handlePyModels(args2, dataDb);
     case "py_migrations":
-      return handlePyMigrations(args2, dataDb2);
+      return handlePyMigrations(args2, dataDb);
     case "py_domains":
-      return handlePyDomains(args2, dataDb2);
+      return handlePyDomains(args2, dataDb);
     case "py_impact":
-      return handlePyImpact(args2, dataDb2);
+      return handlePyImpact(args2, dataDb);
     case "py_context":
-      return handlePyContext(args2, dataDb2);
+      return handlePyContext(args2, dataDb);
     default:
       return text16(`Unknown Python tool: ${name}`);
   }
 }
-function handlePyImports(args2, dataDb2) {
+function handlePyImports(args2, dataDb) {
   const lines = [];
   const file = args2.file;
   const importedBy = args2.imported_by;
@@ -26251,7 +26260,7 @@ function handlePyImports(args2, dataDb2) {
       let traverse2 = function(f2, depth) {
         if (depth > maxDepth || visited.has(f2)) return;
         visited.add(f2);
-        const imports = dataDb2.prepare(
+        const imports = dataDb.prepare(
           "SELECT target_file, imported_names FROM massu_py_imports WHERE source_file = ?"
         ).all(f2);
         for (const imp of imports) {
@@ -26266,7 +26275,7 @@ function handlePyImports(args2, dataDb2) {
       const visited = /* @__PURE__ */ new Set();
       traverse2(file, 0);
     } else {
-      const imports = dataDb2.prepare(
+      const imports = dataDb.prepare(
         "SELECT target_file, import_type, imported_names, line FROM massu_py_imports WHERE source_file = ? ORDER BY line"
       ).all(file);
       lines.push(`## Imports from ${file} (${imports.length} edges)`);
@@ -26276,7 +26285,7 @@ function handlePyImports(args2, dataDb2) {
       }
     }
   } else if (importedBy) {
-    const importers = dataDb2.prepare(
+    const importers = dataDb.prepare(
       "SELECT source_file, imported_names, line FROM massu_py_imports WHERE target_file = ? ORDER BY source_file"
     ).all(importedBy);
     lines.push(`## Files importing ${importedBy} (${importers.length} edges)`);
@@ -26285,8 +26294,8 @@ function handlePyImports(args2, dataDb2) {
       lines.push(`- ${imp.source_file}:${imp.line}${names.length > 0 ? " (" + names.join(", ") + ")" : ""}`);
     }
   } else {
-    const total = dataDb2.prepare("SELECT COUNT(*) as cnt FROM massu_py_imports").get().cnt;
-    const files = dataDb2.prepare("SELECT COUNT(DISTINCT source_file) as cnt FROM massu_py_imports").get().cnt;
+    const total = dataDb.prepare("SELECT COUNT(*) as cnt FROM massu_py_imports").get().cnt;
+    const files = dataDb.prepare("SELECT COUNT(DISTINCT source_file) as cnt FROM massu_py_imports").get().cnt;
     lines.push("## Python Import Index Summary");
     lines.push(`- Total import edges: ${total}`);
     lines.push(`- Files with imports: ${files}`);
@@ -26296,7 +26305,7 @@ function handlePyImports(args2, dataDb2) {
   }
   return text16(lines.join("\n") || "No Python import data available. Run sync first.");
 }
-function handlePyRoutes(args2, dataDb2) {
+function handlePyRoutes(args2, dataDb) {
   const lines = [];
   const limit = Math.min(Math.max(args2.limit || 500, 1), 5e3);
   let query = "SELECT * FROM massu_py_routes WHERE 1=1";
@@ -26317,9 +26326,9 @@ function handlePyRoutes(args2, dataDb2) {
     query += " AND is_authenticated = 0";
   }
   query += ` ORDER BY file, line LIMIT ${limit}`;
-  const routes = dataDb2.prepare(query).all(...params);
+  const routes = dataDb.prepare(query).all(...params);
   if (args2.uncoupled) {
-    const callerCountStmt = dataDb2.prepare("SELECT COUNT(*) as cnt FROM massu_py_route_callers WHERE route_id = ?");
+    const callerCountStmt = dataDb.prepare("SELECT COUNT(*) as cnt FROM massu_py_route_callers WHERE route_id = ?");
     const uncoupledRoutes = routes.filter((r2) => {
       const callers = callerCountStmt.get(r2.id).cnt;
       return callers === 0;
@@ -26340,7 +26349,7 @@ function handlePyRoutes(args2, dataDb2) {
   }
   return text16(lines.join("\n") || "No Python routes found.");
 }
-function handlePyCoupling(args2, dataDb2) {
+function handlePyCoupling(args2, dataDb) {
   const lines = [];
   let query = `
     SELECT rc.frontend_file, rc.call_pattern, rc.line as caller_line,
@@ -26359,7 +26368,7 @@ function handlePyCoupling(args2, dataDb2) {
     params.push(`%${args2.backend_path}%`);
   }
   query += " ORDER BY rc.frontend_file, rc.line";
-  const couplings = dataDb2.prepare(query).all(...params);
+  const couplings = dataDb.prepare(query).all(...params);
   lines.push(`## Frontend \u2194 Backend Coupling (${couplings.length} connections)`);
   let currentFrontend = "";
   for (const c2 of couplings) {
@@ -26372,17 +26381,17 @@ function handlePyCoupling(args2, dataDb2) {
   }
   return text16(lines.join("\n") || "No coupling data found.");
 }
-function handlePyModels(args2, dataDb2) {
+function handlePyModels(args2, dataDb) {
   const lines = [];
   if (args2.fk_graph) {
-    const edges = dataDb2.prepare("SELECT * FROM massu_py_fk_edges ORDER BY source_table").all();
+    const edges = dataDb.prepare("SELECT * FROM massu_py_fk_edges ORDER BY source_table").all();
     lines.push(`## Foreign Key Graph (${edges.length} edges)`);
     for (const e2 of edges) {
       lines.push(`- ${e2.source_table}.${e2.source_column} \u2192 ${e2.target_table}.${e2.target_column}`);
     }
   } else if (args2.model || args2.table) {
     const search = args2.model || args2.table;
-    const model = dataDb2.prepare(
+    const model = dataDb.prepare(
       "SELECT * FROM massu_py_models WHERE class_name = ? OR table_name = ?"
     ).get(search, search);
     if (!model) return text16(`Model "${search}" not found.`);
@@ -26411,7 +26420,7 @@ function handlePyModels(args2, dataDb2) {
     }
   } else {
     const limit = Math.min(Math.max(args2.limit || 500, 1), 5e3);
-    const models = dataDb2.prepare(`SELECT class_name, table_name, file, line FROM massu_py_models ORDER BY class_name LIMIT ${limit}`).all();
+    const models = dataDb.prepare(`SELECT class_name, table_name, file, line FROM massu_py_models ORDER BY class_name LIMIT ${limit}`).all();
     lines.push(`## Python Models (${models.length})`);
     for (const m3 of models) {
       lines.push(`- ${m3.class_name} (${m3.table_name || "no table"}) \u2014 ${m3.file}:${m3.line}`);
@@ -26419,11 +26428,11 @@ function handlePyModels(args2, dataDb2) {
   }
   return text16(lines.join("\n") || "No Python models found.");
 }
-function handlePyMigrations(args2, dataDb2) {
+function handlePyMigrations(args2, dataDb) {
   const lines = [];
   if (args2.drift) {
-    const models = dataDb2.prepare("SELECT class_name, table_name, columns FROM massu_py_models").all();
-    const migrations = dataDb2.prepare("SELECT revision, operations FROM massu_py_migrations").all();
+    const models = dataDb.prepare("SELECT class_name, table_name, columns FROM massu_py_models").all();
+    const migrations = dataDb.prepare("SELECT revision, operations FROM massu_py_migrations").all();
     const migratedTables = /* @__PURE__ */ new Set();
     for (const m3 of migrations) {
       const ops = safeParseArray(m3.operations);
@@ -26444,14 +26453,14 @@ function handlePyMigrations(args2, dataDb2) {
     }
   } else if (args2.chain) {
     const limit = Math.min(Math.max(args2.limit || 500, 1), 5e3);
-    const migrations = dataDb2.prepare(`SELECT * FROM massu_py_migrations ORDER BY id LIMIT ${limit}`).all();
+    const migrations = dataDb.prepare(`SELECT * FROM massu_py_migrations ORDER BY id LIMIT ${limit}`).all();
     lines.push(`## Migration Chain (${migrations.length} revisions)`);
     for (const m3 of migrations) {
       const head = m3.is_head ? " [HEAD]" : "";
       lines.push(`- ${m3.revision}${head} \u2190 ${m3.down_revision || "BASE"}: ${m3.description || "(no description)"} (${m3.file})`);
     }
   } else if (args2.revision) {
-    const m3 = dataDb2.prepare("SELECT * FROM massu_py_migrations WHERE revision = ?").get(args2.revision);
+    const m3 = dataDb.prepare("SELECT * FROM massu_py_migrations WHERE revision = ?").get(args2.revision);
     if (!m3) return text16(`Revision "${args2.revision}" not found.`);
     lines.push(`## Revision: ${m3.revision}`);
     lines.push(`Down: ${m3.down_revision || "BASE"}`);
@@ -26465,15 +26474,15 @@ function handlePyMigrations(args2, dataDb2) {
       }
     }
   } else {
-    const total = dataDb2.prepare("SELECT COUNT(*) as cnt FROM massu_py_migrations").get().cnt;
-    const head = dataDb2.prepare("SELECT revision FROM massu_py_migrations WHERE is_head = 1").get();
+    const total = dataDb.prepare("SELECT COUNT(*) as cnt FROM massu_py_migrations").get().cnt;
+    const head = dataDb.prepare("SELECT revision FROM massu_py_migrations WHERE is_head = 1").get();
     lines.push("## Migration Summary");
     lines.push(`- Total revisions: ${total}`);
     lines.push(`- Current head: ${head?.revision || "N/A"}`);
   }
   return text16(lines.join("\n") || "No Python migration data found.");
 }
-function handlePyDomains(args2, dataDb2) {
+function handlePyDomains(args2, dataDb) {
   const lines = [];
   const config = getConfig();
   const domains = config.python?.domains || [];
@@ -26487,7 +26496,7 @@ function handlePyDomains(args2, dataDb2) {
       lines.push(`Allowed imports from: ${domainConfig.allowed_imports_from.join(", ") || "any"}`);
     }
   } else if (args2.crossings) {
-    const imports = dataDb2.prepare("SELECT source_file, target_file FROM massu_py_imports").all();
+    const imports = dataDb.prepare("SELECT source_file, target_file FROM massu_py_imports").all();
     const violations = [];
     for (const imp of imports) {
       const srcDomain = classifyPythonFileDomain(imp.source_file);
@@ -26506,7 +26515,7 @@ function handlePyDomains(args2, dataDb2) {
     if (violations.length > 50) lines.push(`... and ${violations.length - 50} more`);
   } else if (args2.domain) {
     const domainName = args2.domain;
-    const allFiles = dataDb2.prepare("SELECT DISTINCT source_file FROM massu_py_imports UNION SELECT DISTINCT target_file FROM massu_py_imports").all();
+    const allFiles = dataDb.prepare("SELECT DISTINCT source_file FROM massu_py_imports UNION SELECT DISTINCT target_file FROM massu_py_imports").all();
     const filesInDomain = allFiles.filter((f2) => classifyPythonFileDomain(f2.source_file) === domainName);
     lines.push(`## Domain: ${domainName} (${filesInDomain.length} files)`);
     for (const f2 of filesInDomain) {
@@ -26520,17 +26529,17 @@ function handlePyDomains(args2, dataDb2) {
   }
   return text16(lines.join("\n") || "No Python domains configured.");
 }
-function handlePyImpact(args2, dataDb2) {
+function handlePyImpact(args2, dataDb) {
   const file = args2.file;
   const lines = [`## Impact Analysis: ${file}`, ""];
-  const importedBy = dataDb2.prepare(
+  const importedBy = dataDb.prepare(
     "SELECT source_file FROM massu_py_imports WHERE target_file = ?"
   ).all(file);
   lines.push(`### Imported By (${importedBy.length} files)`);
   for (const imp of importedBy.slice(0, 20)) {
     lines.push(`- ${imp.source_file}`);
   }
-  const routes = dataDb2.prepare(
+  const routes = dataDb.prepare(
     "SELECT method, path, function_name FROM massu_py_routes WHERE file = ?"
   ).all(file);
   if (routes.length > 0) {
@@ -26540,7 +26549,7 @@ function handlePyImpact(args2, dataDb2) {
       lines.push(`- ${r2.method} ${r2.path} \u2192 ${r2.function_name}`);
     }
   }
-  const models = dataDb2.prepare(
+  const models = dataDb.prepare(
     "SELECT class_name, table_name FROM massu_py_models WHERE file = ?"
   ).all(file);
   if (models.length > 0) {
@@ -26550,10 +26559,10 @@ function handlePyImpact(args2, dataDb2) {
       lines.push(`- ${m3.class_name} (${m3.table_name || "no table"})`);
     }
   }
-  const routeIds = dataDb2.prepare("SELECT id FROM massu_py_routes WHERE file = ?").all(file);
+  const routeIds = dataDb.prepare("SELECT id FROM massu_py_routes WHERE file = ?").all(file);
   if (routeIds.length > 0) {
     const placeholders = routeIds.map(() => "?").join(",");
-    const callers = dataDb2.prepare(
+    const callers = dataDb.prepare(
       `SELECT DISTINCT frontend_file FROM massu_py_route_callers WHERE route_id IN (${placeholders})`
     ).all(...routeIds.map((r2) => r2.id));
     if (callers.length > 0) {
@@ -26570,13 +26579,13 @@ function handlePyImpact(args2, dataDb2) {
 ### Domain: ${domain}`);
   return text16(lines.join("\n"));
 }
-function handlePyContext(args2, dataDb2) {
+function handlePyContext(args2, dataDb) {
   const file = args2.file;
   const lines = [`## Python Context: ${file}`, ""];
   const config = getConfig();
   const domain = classifyPythonFileDomain(file);
   lines.push(`**Domain**: ${domain}`);
-  const imports = dataDb2.prepare(
+  const imports = dataDb.prepare(
     "SELECT target_file, imported_names FROM massu_py_imports WHERE source_file = ? LIMIT 20"
   ).all(file);
   if (imports.length > 0) {
@@ -26586,7 +26595,7 @@ function handlePyContext(args2, dataDb2) {
       lines.push(`- ${imp.target_file}${names.length > 0 ? ": " + names.join(", ") : ""}`);
     }
   }
-  const importedBy = dataDb2.prepare(
+  const importedBy = dataDb.prepare(
     "SELECT source_file FROM massu_py_imports WHERE target_file = ? LIMIT 10"
   ).all(file);
   if (importedBy.length > 0) {
@@ -26595,14 +26604,14 @@ function handlePyContext(args2, dataDb2) {
       lines.push(`- ${imp.source_file}`);
     }
   }
-  const routes = dataDb2.prepare("SELECT method, path, function_name, line FROM massu_py_routes WHERE file = ?").all(file);
+  const routes = dataDb.prepare("SELECT method, path, function_name, line FROM massu_py_routes WHERE file = ?").all(file);
   if (routes.length > 0) {
     lines.push("\n### Routes");
     for (const r2 of routes) {
       lines.push(`- ${r2.method} ${r2.path} \u2192 ${r2.function_name} (L${r2.line})`);
     }
   }
-  const models = dataDb2.prepare("SELECT class_name, table_name, line FROM massu_py_models WHERE file = ?").all(file);
+  const models = dataDb.prepare("SELECT class_name, table_name, line FROM massu_py_models WHERE file = ?").all(file);
   if (models.length > 0) {
     lines.push("\n### Models");
     for (const m3 of models) {
@@ -26650,41 +26659,41 @@ function stripPrefix3(name) {
   }
   return name;
 }
-function ensureIndexes(dataDb2, codegraphDb2, force = false) {
+function ensureIndexes(dataDb, codegraphDb, force = false) {
   const results = [];
   const config = getConfig();
-  if (force || isDataStale(dataDb2, codegraphDb2)) {
-    const importCount = buildImportIndex(dataDb2, codegraphDb2);
+  if (codegraphDb !== void 0 && (force || isDataStale(dataDb, codegraphDb))) {
+    const importCount = buildImportIndex(dataDb, codegraphDb);
     results.push(`Import edges: ${importCount}`);
     if (config.framework.router === "trpc") {
-      const trpcStats = buildTrpcIndex(dataDb2);
+      const trpcStats = buildTrpcIndex(dataDb);
       results.push(`tRPC procedures: ${trpcStats.totalProcedures} (${trpcStats.withCallers} with UI, ${trpcStats.withoutCallers} without)`);
     }
-    const pageCount = buildPageDeps(dataDb2, codegraphDb2);
+    const pageCount = buildPageDeps(dataDb, codegraphDb);
     results.push(`Page deps: ${pageCount} pages`);
     if (config.paths.middleware) {
-      const middlewareCount = buildMiddlewareTree(dataDb2);
+      const middlewareCount = buildMiddlewareTree(dataDb);
       results.push(`Middleware tree: ${middlewareCount} files`);
     }
-    updateBuildTimestamp(dataDb2);
+    updateBuildTimestamp(dataDb);
   }
   if (config.python?.root) {
     const pythonRoot = config.python.root;
     const excludeDirs = config.python.exclude_dirs || ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache"];
-    if (force || isPythonDataStale(dataDb2, resolve31(getProjectRoot(), pythonRoot))) {
-      const pyImports = buildPythonImportIndex(dataDb2, pythonRoot, excludeDirs);
+    if (force || isPythonDataStale(dataDb, resolve31(getProjectRoot(), pythonRoot))) {
+      const pyImports = buildPythonImportIndex(dataDb, pythonRoot, excludeDirs);
       results.push(`Python imports: ${pyImports}`);
-      const pyRoutes = buildPythonRouteIndex(dataDb2, pythonRoot, excludeDirs);
+      const pyRoutes = buildPythonRouteIndex(dataDb, pythonRoot, excludeDirs);
       results.push(`Python routes: ${pyRoutes}`);
-      const pyModels = buildPythonModelIndex(dataDb2, pythonRoot, excludeDirs);
+      const pyModels = buildPythonModelIndex(dataDb, pythonRoot, excludeDirs);
       results.push(`Python models: ${pyModels}`);
       if (config.python.alembic_dir) {
-        const pyMigrations = buildPythonMigrationIndex(dataDb2, config.python.alembic_dir);
+        const pyMigrations = buildPythonMigrationIndex(dataDb, config.python.alembic_dir);
         results.push(`Python migrations: ${pyMigrations}`);
       }
-      const pyCoupling = buildPythonCouplingIndex(dataDb2);
+      const pyCoupling = buildPythonCouplingIndex(dataDb);
       results.push(`Python coupling: ${pyCoupling}`);
-      updatePythonBuildTimestamp(dataDb2);
+      updatePythonBuildTimestamp(dataDb);
     }
   }
   if (results.length === 0) return "Indexes are up-to-date.";
@@ -26812,13 +26821,24 @@ function getToolDefinitions() {
     }] : []
   ]);
 }
-async function handleToolCall(name, args2, dataDb2, codegraphDb2) {
+function assertDataDb(dataDb, toolName) {
+  if (!dataDb) {
+    throw new Error(`Internal: tool "${toolName}" routed to a Data-DB branch but dispatcher did not resolve Data DB. Check TOOL_DB_NEEDS manifest entry includes 'data'.`);
+  }
+  return dataDb;
+}
+function assertCodegraphDb(codegraphDb, toolName) {
+  if (!codegraphDb) {
+    throw new Error(`Internal: tool "${toolName}" routed to a CodeGraph branch but dispatcher did not resolve CodeGraph DB. Check TOOL_DB_NEEDS manifest entry includes 'codegraph'.`);
+  }
+  return codegraphDb;
+}
+async function handleToolCall(name, args2, dataDb, codegraphDb) {
   const userTier = await getCurrentTier();
   const requiredTier = getToolTier(name);
   if (!isToolAllowed(name, userTier)) {
     return text17(`This tool requires ${requiredTier} tier. Current tier: ${userTier}. Upgrade at https://massu.ai/pricing`);
   }
-  const syncMessage = ensureIndexes(dataDb2, codegraphDb2);
   const pfx = prefix2();
   try {
     if (name.startsWith(pfx + "_memory_")) {
@@ -26841,7 +26861,7 @@ async function handleToolCall(name, args2, dataDb2, codegraphDb2) {
       return handleDocsToolCall(name, args2);
     }
     if (name.startsWith(pfx + "_sentinel_")) {
-      return handleSentinelToolCall(name, args2, dataDb2);
+      return handleSentinelToolCall(name, args2, assertDataDb(dataDb, name));
     }
     if (isAnalyticsTool(name)) {
       const memDb = getMemoryDb();
@@ -26932,7 +26952,9 @@ async function handleToolCall(name, args2, dataDb2, codegraphDb2) {
       }
     }
     if (isPythonTool(name)) {
-      return handlePythonToolCall(name, args2, dataDb2);
+      const pyDataDb = assertDataDb(dataDb, name);
+      ensureIndexes(pyDataDb);
+      return handlePythonToolCall(name, args2, pyDataDb);
     }
     if (isLicenseTool(name)) {
       const memDb = getMemoryDb();
@@ -26944,18 +26966,40 @@ async function handleToolCall(name, args2, dataDb2, codegraphDb2) {
     }
     const baseName = stripPrefix3(name);
     switch (baseName) {
-      case "sync":
-        return handleSync(dataDb2, codegraphDb2);
-      case "context":
-        return handleContext(args2.file, dataDb2, codegraphDb2);
-      case "trpc_map":
-        return handleTrpcMap(args2, dataDb2);
-      case "coupling_check":
-        return handleCouplingCheck(args2, dataDb2, codegraphDb2);
-      case "impact":
-        return handleImpact2(args2.file, dataDb2, codegraphDb2);
-      case "domains":
-        return handleDomains(args2, dataDb2, codegraphDb2);
+      case "sync": {
+        const d2 = assertDataDb(dataDb, name);
+        const c2 = assertCodegraphDb(codegraphDb, name);
+        return handleSync(d2, c2);
+      }
+      case "context": {
+        const d2 = assertDataDb(dataDb, name);
+        const c2 = assertCodegraphDb(codegraphDb, name);
+        ensureIndexes(d2, c2);
+        return handleContext(args2.file, d2, c2);
+      }
+      case "trpc_map": {
+        const d2 = assertDataDb(dataDb, name);
+        ensureIndexes(d2, codegraphDb);
+        return handleTrpcMap(args2, d2);
+      }
+      case "coupling_check": {
+        const d2 = assertDataDb(dataDb, name);
+        const c2 = assertCodegraphDb(codegraphDb, name);
+        ensureIndexes(d2, c2);
+        return handleCouplingCheck(args2, d2, c2);
+      }
+      case "impact": {
+        const d2 = assertDataDb(dataDb, name);
+        const c2 = assertCodegraphDb(codegraphDb, name);
+        ensureIndexes(d2, c2);
+        return handleImpact2(args2.file, d2, c2);
+      }
+      case "domains": {
+        const d2 = assertDataDb(dataDb, name);
+        const c2 = assertCodegraphDb(codegraphDb, name);
+        ensureIndexes(d2, c2);
+        return handleDomains(args2, d2, c2);
+      }
       case "schema":
         return handleSchema(args2);
       default:
@@ -26970,10 +27014,10 @@ async function handleToolCall(name, args2, dataDb2, codegraphDb2) {
 function text17(content) {
   return { content: [{ type: "text", text: content }] };
 }
-function handleSync(dataDb2, codegraphDb2) {
-  const result = ensureIndexes(dataDb2, codegraphDb2, true);
+function handleSync(dataDb, codegraphDb) {
+  const result = ensureIndexes(dataDb, codegraphDb, true);
   try {
-    const scanResult = runFeatureScan(dataDb2);
+    const scanResult = runFeatureScan(dataDb);
     return text17(`${result}
 
 Feature scan: ${scanResult.registered} features registered (${scanResult.fromProcedures} from procedures, ${scanResult.fromPages} from pages, ${scanResult.fromComponents} from components)`);
@@ -26983,9 +27027,9 @@ Feature scan: ${scanResult.registered} features registered (${scanResult.fromPro
 Feature scan failed: ${error instanceof Error ? error.message : String(error)}`);
   }
 }
-function handleContext(file, dataDb2, codegraphDb2) {
+function handleContext(file, dataDb, codegraphDb) {
   const lines = [];
-  const nodes = codegraphDb2.prepare(
+  const nodes = codegraphDb.prepare(
     "SELECT name, kind, start_line, end_line FROM nodes WHERE file_path = ? ORDER BY start_line"
   ).all(file);
   if (nodes.length > 0) {
@@ -27012,7 +27056,7 @@ function handleContext(file, dataDb2, codegraphDb2) {
     }
     lines.push("");
   }
-  if (isInMiddlewareTree(dataDb2, file)) {
+  if (isInMiddlewareTree(dataDb, file)) {
     lines.push("## WARNING: Middleware Import Tree");
     lines.push("This file is imported (directly or transitively) by the middleware entry point.");
     lines.push("NO Node.js dependencies allowed (pino, winston, fs, crypto, path, child_process).");
@@ -27021,7 +27065,7 @@ function handleContext(file, dataDb2, codegraphDb2) {
   const domain = classifyFile(file);
   lines.push(`## Domain: ${domain}`);
   lines.push("");
-  const imports = dataDb2.prepare(
+  const imports = dataDb.prepare(
     "SELECT target_file, imported_names FROM massu_imports WHERE source_file = ? LIMIT 20"
   ).all(file);
   if (imports.length > 0) {
@@ -27032,7 +27076,7 @@ function handleContext(file, dataDb2, codegraphDb2) {
     }
     lines.push("");
   }
-  const importedBy = dataDb2.prepare(
+  const importedBy = dataDb.prepare(
     "SELECT source_file FROM massu_imports WHERE target_file = ? LIMIT 20"
   ).all(file);
   if (importedBy.length > 0) {
@@ -27196,10 +27240,10 @@ function handleContext(file, dataDb2, codegraphDb2) {
   }
   return text17(lines.join("\n") || "No context available for this file.");
 }
-function handleTrpcMap(args2, dataDb2) {
+function handleTrpcMap(args2, dataDb) {
   const lines = [];
   if (args2.uncoupled) {
-    const uncoupled = dataDb2.prepare(
+    const uncoupled = dataDb.prepare(
       "SELECT router_name, procedure_name, procedure_type, router_file FROM massu_trpc_procedures WHERE has_ui_caller = 0 ORDER BY router_name, procedure_name"
     ).all();
     lines.push(`## Uncoupled Procedures (${uncoupled.length} total)`);
@@ -27214,7 +27258,7 @@ function handleTrpcMap(args2, dataDb2) {
       lines.push(`- ${proc.procedure_name} (${proc.procedure_type})`);
     }
   } else if (args2.router) {
-    const procs = dataDb2.prepare(
+    const procs = dataDb.prepare(
       "SELECT id, procedure_name, procedure_type, has_ui_caller FROM massu_trpc_procedures WHERE router_name = ? ORDER BY procedure_name"
     ).all(args2.router);
     lines.push(`## Router: ${args2.router} (${procs.length} procedures)`);
@@ -27222,7 +27266,7 @@ function handleTrpcMap(args2, dataDb2) {
     for (const proc of procs) {
       const status = proc.has_ui_caller ? "" : " [NO UI CALLERS]";
       lines.push(`### ${args2.router}.${proc.procedure_name} (${proc.procedure_type})${status}`);
-      const callSites = dataDb2.prepare(
+      const callSites = dataDb.prepare(
         "SELECT file, line, call_pattern FROM massu_trpc_call_sites WHERE procedure_id = ?"
       ).all(proc.id);
       if (callSites.length > 0) {
@@ -27236,7 +27280,7 @@ function handleTrpcMap(args2, dataDb2) {
       lines.push("");
     }
   } else if (args2.procedure) {
-    const procs = dataDb2.prepare(
+    const procs = dataDb.prepare(
       "SELECT id, router_name, router_file, procedure_type, has_ui_caller FROM massu_trpc_procedures WHERE procedure_name = ? ORDER BY router_name"
     ).all(args2.procedure);
     lines.push(`## Procedure "${args2.procedure}" found in ${procs.length} routers`);
@@ -27244,7 +27288,7 @@ function handleTrpcMap(args2, dataDb2) {
     for (const proc of procs) {
       lines.push(`### ${proc.router_name}.${args2.procedure} (${proc.procedure_type})`);
       lines.push(`File: ${proc.router_file}`);
-      const callSites = dataDb2.prepare(
+      const callSites = dataDb.prepare(
         "SELECT file, line, call_pattern FROM massu_trpc_call_sites WHERE procedure_id = ?"
       ).all(proc.id);
       if (callSites.length > 0) {
@@ -27258,8 +27302,8 @@ function handleTrpcMap(args2, dataDb2) {
       lines.push("");
     }
   } else {
-    const total = dataDb2.prepare("SELECT COUNT(*) as count FROM massu_trpc_procedures").get();
-    const coupled = dataDb2.prepare("SELECT COUNT(*) as count FROM massu_trpc_procedures WHERE has_ui_caller = 1").get();
+    const total = dataDb.prepare("SELECT COUNT(*) as count FROM massu_trpc_procedures").get();
+    const coupled = dataDb.prepare("SELECT COUNT(*) as count FROM massu_trpc_procedures WHERE has_ui_caller = 1").get();
     const uncoupled = total.count - coupled.count;
     lines.push("## tRPC Procedure Summary");
     lines.push(`- Total procedures: ${total.count}`);
@@ -27271,16 +27315,16 @@ function handleTrpcMap(args2, dataDb2) {
   }
   return text17(lines.join("\n"));
 }
-function handleCouplingCheck(args2, dataDb2, codegraphDb2) {
+function handleCouplingCheck(args2, dataDb, codegraphDb) {
   const lines = [];
   const stagedFiles = args2.staged_files;
   let uncoupledProcs;
   if (stagedFiles) {
-    uncoupledProcs = dataDb2.prepare(
+    uncoupledProcs = dataDb.prepare(
       `SELECT router_name, procedure_name, procedure_type, router_file FROM massu_trpc_procedures WHERE has_ui_caller = 0 AND router_file IN (${stagedFiles.map(() => "?").join(",")})`
     ).all(...stagedFiles);
   } else {
-    uncoupledProcs = dataDb2.prepare(
+    uncoupledProcs = dataDb.prepare(
       "SELECT router_name, procedure_name, procedure_type, router_file FROM massu_trpc_procedures WHERE has_ui_caller = 0"
     ).all();
   }
@@ -27296,12 +27340,12 @@ function handleCouplingCheck(args2, dataDb2, codegraphDb2) {
     lines.push("### Uncoupled Procedures: 0 (PASS)");
     lines.push("");
   }
-  const allPages = codegraphDb2.prepare(
+  const allPages = codegraphDb.prepare(
     "SELECT path FROM files WHERE path LIKE 'src/app/%/page.tsx' OR path = 'src/app/page.tsx'"
   ).all();
   const pageImports = /* @__PURE__ */ new Set();
   for (const page of allPages) {
-    const imports = dataDb2.prepare(
+    const imports = dataDb.prepare(
       "SELECT target_file FROM massu_imports WHERE source_file = ?"
     ).all(page.path);
     for (const imp of imports) {
@@ -27311,7 +27355,7 @@ function handleCouplingCheck(args2, dataDb2, codegraphDb2) {
   let componentFiles;
   if (stagedFiles) {
     const placeholders = stagedFiles.map(() => "?").join(",");
-    componentFiles = codegraphDb2.prepare(
+    componentFiles = codegraphDb.prepare(
       `SELECT path FROM files WHERE path LIKE 'src/components/%' AND path IN (${placeholders})`
     ).all(...stagedFiles);
   } else {
@@ -27329,11 +27373,11 @@ function handleCouplingCheck(args2, dataDb2, codegraphDb2) {
   lines.push(`### RESULT: ${totalIssues === 0 ? "PASS" : `FAIL (${totalIssues} issues)`}`);
   return text17(lines.join("\n"));
 }
-function handleImpact2(file, dataDb2, codegraphDb2) {
+function handleImpact2(file, dataDb, codegraphDb) {
   const lines = [];
   lines.push(`## Impact Analysis: ${file}`);
   lines.push("");
-  const affectedPages = findAffectedPages(dataDb2, file);
+  const affectedPages = findAffectedPages(dataDb, file);
   if (affectedPages.length > 0) {
     const portals = [...new Set(affectedPages.map((p19) => p19.portal))];
     const allTables = [...new Set(affectedPages.flatMap((p19) => p19.tables))];
@@ -27363,7 +27407,7 @@ function handleImpact2(file, dataDb2, codegraphDb2) {
     lines.push("No pages affected (file may not be in any page dependency chain).");
     lines.push("");
   }
-  const inMiddleware = isInMiddlewareTree(dataDb2, file);
+  const inMiddleware = isInMiddlewareTree(dataDb, file);
   if (inMiddleware) {
     lines.push("### WARNING: In Middleware Import Tree");
     lines.push("Changes to this file affect Edge Runtime. No Node.js deps allowed.");
@@ -27373,7 +27417,7 @@ function handleImpact2(file, dataDb2, codegraphDb2) {
   lines.push("");
   const fileDomain = classifyFile(file);
   lines.push(`### Domain: ${fileDomain}`);
-  const imports = dataDb2.prepare(
+  const imports = dataDb.prepare(
     "SELECT target_file FROM massu_imports WHERE source_file = ?"
   ).all(file);
   const crossings = [];
@@ -27391,7 +27435,7 @@ function handleImpact2(file, dataDb2, codegraphDb2) {
   }
   return text17(lines.join("\n"));
 }
-function handleDomains(args2, dataDb2, codegraphDb2) {
+function handleDomains(args2, dataDb, codegraphDb) {
   const lines = [];
   const domains = getConfig().domains;
   if (args2.file) {
@@ -27404,7 +27448,7 @@ function handleDomains(args2, dataDb2, codegraphDb2) {
       lines.push(`Allowed imports from: ${domainConfig.allowedImportsFrom.join(", ") || "any domain (system)"}`);
     }
   } else if (args2.crossings) {
-    const crossings = findCrossDomainImports(dataDb2);
+    const crossings = findCrossDomainImports(dataDb);
     const violations = crossings.filter((c2) => !c2.allowed);
     const allowed = crossings.filter((c2) => c2.allowed);
     lines.push(`## Cross-Domain Import Analysis`);
@@ -27423,7 +27467,7 @@ function handleDomains(args2, dataDb2, codegraphDb2) {
     }
   } else if (args2.domain) {
     const domainName = args2.domain;
-    const files = getFilesInDomain(dataDb2, codegraphDb2, domainName);
+    const files = getFilesInDomain(dataDb, codegraphDb, domainName);
     const config = domains.find((d2) => d2.name === domainName);
     lines.push(`## Domain: ${domainName}`);
     if (config) {
@@ -27576,69 +27620,302 @@ var init_tools = __esm({
   }
 });
 
-// src/server.ts
-var server_exports = {};
-import { readFileSync as readFileSync39 } from "fs";
-import { resolve as resolve32, dirname as dirname16 } from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
-function getDb() {
-  if (!codegraphDb) codegraphDb = getCodeGraphDb();
-  if (!dataDb) dataDb = getDataDb();
-  return { codegraphDb, dataDb };
-}
-async function handleRequest(request) {
-  const { method, params, id } = request;
-  switch (method) {
-    case "initialize": {
-      return {
-        jsonrpc: "2.0",
-        id: id ?? null,
-        result: {
-          protocolVersion: "2024-11-05",
-          capabilities: {
-            tools: {}
-          },
-          serverInfo: {
-            name: getConfig().toolPrefix || "massu",
-            version: PKG_VERSION
+// src/tool-db-needs.ts
+function stripConfiguredPrefix(toolName, prefix3) {
+  const pfx = `${prefix3}_`;
+  return toolName.startsWith(pfx) ? toolName.slice(pfx.length) : toolName;
+}
+function getToolDbNeeds(toolName, prefix3) {
+  const shortName = stripConfiguredPrefix(toolName, prefix3);
+  const needs = TOOL_DB_NEEDS[shortName];
+  if (needs === void 0) {
+    throw new UnknownToolError(toolName);
+  }
+  return needs;
+}
+var UnknownToolError, TOOL_DB_NEEDS;
+var init_tool_db_needs = __esm({
+  "src/tool-db-needs.ts"() {
+    "use strict";
+    UnknownToolError = class extends Error {
+      toolName;
+      constructor(toolName) {
+        super(`Tool not registered in TOOL_DB_NEEDS manifest: ${toolName}. Add an entry to packages/core/src/tool-db-needs.ts.`);
+        this.name = "UnknownToolError";
+        this.toolName = toolName;
+      }
+    };
+    TOOL_DB_NEEDS = {
+      // === Core code-intel tools (tools.ts:393-406) ===
+      // Use CodeGraph DB (read-only AST) + Data DB (Massu's import/trpc/sentinel
+      // tables). All call `ensureIndexes` directly or via shared infrastructure.
+      sync: ["codegraph", "data"],
+      context: ["codegraph", "data"],
+      coupling_check: ["codegraph", "data"],
+      impact: ["codegraph", "data"],
+      domains: ["codegraph", "data"],
+      // `trpc_map` reads only Data DB (tRPC index lives there); no CodeGraph access.
+      trpc_map: ["data"],
+      // `schema` reads filesystem (Prisma schema files); no DB access at all.
+      schema: [],
+      // === Memory tools (memory-tools.ts) ===
+      // Routed via `name.startsWith(pfx + '_memory_')` at tools.ts:284-290.
+      // Handler opens memory DB per-call (with try/finally close).
+      memory_search: ["memory"],
+      memory_timeline: ["memory"],
+      memory_detail: ["memory"],
+      memory_sessions: ["memory"],
+      memory_failures: ["memory"],
+      memory_ingest: ["memory"],
+      memory_backfill: ["memory"],
+      // === Observability tools (observability-tools.ts) ===
+      // Routed via `isObservabilityTool(name)` at tools.ts:294-300. Memory DB only.
+      session_replay: ["memory"],
+      session_stats: ["memory"],
+      tool_patterns: ["memory"],
+      prompt_analysis: ["memory"],
+      // === Docs tools (docs-tools.ts) ===
+      // Routed via `name.startsWith(pfx + '_docs_')` at tools.ts:303-306.
+      // No DB access — pure filesystem traversal.
+      docs_audit: [],
+      docs_coverage: [],
+      // === Sentinel registry tools (sentinel-tools.ts:180-184) ===
+      // Routed via `name.startsWith(pfx + '_sentinel_')` at tools.ts:308.
+      // Handler signature: `(name, args, dataDb)` — Data DB only.
+      sentinel_register: ["data"],
+      sentinel_validate: ["data"],
+      sentinel_search: ["data"],
+      sentinel_detail: ["data"],
+      sentinel_impact: ["data"],
+      sentinel_parity: ["data"],
+      // === Knowledge layer tools (knowledge-tools.ts) ===
+      // Routed via `isKnowledgeTool(name)` at tools.ts:372-376. Primary DB is
+      // `knowledgeDb` (separate SQLite file). Handlers ALSO call `getDataDb()`
+      // (knowledge-tools.ts:1187,1275) and `getMemoryDb()` (knowledge-tools.ts:1332)
+      // for cross-DB joins — declare all three so the AST completeness test
+      // (P-B-002) verifies the full access pattern.
+      knowledge_search: ["knowledge", "data", "memory"],
+      knowledge_pattern: ["knowledge", "data", "memory"],
+      knowledge_rule: ["knowledge", "data", "memory"],
+      knowledge_correct: ["knowledge", "data", "memory"],
+      knowledge_incident: ["knowledge", "data", "memory"],
+      knowledge_plan: ["knowledge", "data", "memory"],
+      knowledge_command: ["knowledge", "data", "memory"],
+      knowledge_gaps: ["knowledge", "data", "memory"],
+      knowledge_verification: ["knowledge", "data", "memory"],
+      knowledge_effectiveness: ["knowledge", "data", "memory"],
+      knowledge_graph: ["knowledge", "data", "memory"],
+      knowledge_schema_check: ["knowledge", "data", "memory"],
+      // === Analytics / quality (analytics.ts) ===
+      // Routed via `isAnalyticsTool(name)`. Memory DB only.
+      quality_score: ["memory"],
+      quality_report: ["memory"],
+      quality_trend: ["memory"],
+      // === Cost tracker (cost-tracker.ts) ===
+      cost_session: ["memory"],
+      cost_feature: ["memory"],
+      cost_trend: ["memory"],
+      // === Prompt analyzer (prompt-analyzer.ts) ===
+      prompt_effectiveness: ["memory"],
+      prompt_suggestions: ["memory"],
+      // === Audit trail (audit-trail.ts) ===
+      audit_chain: ["memory"],
+      audit_log: ["memory"],
+      audit_report: ["memory"],
+      // === Validation engine (validation-engine.ts) ===
+      validation_check: ["memory"],
+      validation_report: ["memory"],
+      // === ADR generator (adr-generator.ts) ===
+      adr_create: ["memory"],
+      adr_list: ["memory"],
+      adr_detail: ["memory"],
+      // === Security scorer (security-scorer.ts) ===
+      security_score: ["memory"],
+      security_heatmap: ["memory"],
+      security_trend: ["memory"],
+      // === Dependency scorer (dependency-scorer.ts) ===
+      dep_score: ["memory"],
+      dep_alternatives: ["memory"],
+      // === Team knowledge (team-knowledge.ts) ===
+      team_expertise: ["memory"],
+      team_conflicts: ["memory"],
+      team_search: ["memory"],
+      // === Regression detector (regression-detector.ts) ===
+      regression_risk: ["memory"],
+      feature_health: ["memory"],
+      // === Python code-intel tools (python-tools.ts) ===
+      // Routed via `isPythonTool(name)` at tools.ts:379-381. Data DB only.
+      py_imports: ["data"],
+      py_routes: ["data"],
+      py_models: ["data"],
+      py_migrations: ["data"],
+      py_coupling: ["data"],
+      py_context: ["data"],
+      py_impact: ["data"],
+      py_domains: ["data"],
+      // === License tool (license.ts) ===
+      license_status: ["memory"]
+    };
+  }
+});
+
+// src/server-dispatch.ts
+function createDispatcher(options) {
+  let codegraphDbCache = null;
+  let dataDbCache = null;
+  function resolveDbsForTool(toolName) {
+    const needs = getToolDbNeeds(toolName, getConfig().toolPrefix);
+    let dataDbResolved;
+    let codegraphDbResolved;
+    if (needs.includes("data")) {
+      if (!dataDbCache) dataDbCache = getDataDb();
+      dataDbResolved = dataDbCache;
+    }
+    if (needs.includes("codegraph")) {
+      if (!codegraphDbCache) codegraphDbCache = getCodeGraphDb();
+      codegraphDbResolved = codegraphDbCache;
+    }
+    return { needs, dataDb: dataDbResolved, codegraphDb: codegraphDbResolved };
+  }
+  async function handleRequest(request) {
+    const { method, params, id } = request;
+    switch (method) {
+      case "initialize": {
+        return {
+          jsonrpc: "2.0",
+          id: id ?? null,
+          result: {
+            protocolVersion: "2024-11-05",
+            capabilities: { tools: {} },
+            serverInfo: {
+              name: getConfig().toolPrefix || "massu",
+              version: options.serverInfoVersion
+            }
+          }
+        };
+      }
+      case "notifications/initialized": {
+        return { jsonrpc: "2.0", id: id ?? null, result: {} };
+      }
+      case "tools/list": {
+        const tools = getToolDefinitions();
+        return { jsonrpc: "2.0", id: id ?? null, result: { tools } };
+      }
+      case "tools/call": {
+        const toolName = params?.name ?? "";
+        const toolArgs = params?.arguments ?? {};
+        try {
+          const { dataDb, codegraphDb } = resolveDbsForTool(toolName);
+          const result = await handleToolCall(toolName, toolArgs, dataDb, codegraphDb);
+          return { jsonrpc: "2.0", id: id ?? null, result };
+        } catch (err) {
+          if (err instanceof CodegraphDbNotInitializedError) {
+            return {
+              jsonrpc: "2.0",
+              id: id ?? null,
+              error: {
+                code: -32001,
+                message: "Tool requires CodeGraph database which is not initialized for this repo",
+                data: {
+                  remedy: "npx @colbymchenry/codegraph@0.7.4 init . && npx @colbymchenry/codegraph@0.7.4 index .",
+                  codegraphDbPath: err.dbPath,
+                  tool: toolName
+                }
+              }
+            };
+          }
+          if (err instanceof UnknownToolError) {
+            return {
+              jsonrpc: "2.0",
+              id: id ?? null,
+              error: {
+                code: -32602,
+                message: `Unknown tool: ${err.toolName}`,
+                data: {
+                  remedy: "Tool not registered in TOOL_DB_NEEDS manifest. See packages/core/src/tool-db-needs.ts.",
+                  tool: toolName
+                }
+              }
+            };
           }
+          throw err;
         }
-      };
-    }
-    case "notifications/initialized": {
-      return { jsonrpc: "2.0", id: id ?? null, result: {} };
+      }
+      case "ping": {
+        return { jsonrpc: "2.0", id: id ?? null, result: {} };
+      }
+      default: {
+        return {
+          jsonrpc: "2.0",
+          id: id ?? null,
+          error: { code: -32601, message: `Method not found: ${method}` }
+        };
+      }
     }
-    case "tools/list": {
-      const tools = getToolDefinitions();
+  }
+  async function processLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) return null;
+    let request;
+    try {
+      request = JSON.parse(trimmed);
+    } catch (parseError) {
       return {
-        jsonrpc: "2.0",
-        id: id ?? null,
-        result: { tools }
+        response: {
+          jsonrpc: "2.0",
+          id: null,
+          error: {
+            code: -32700,
+            message: `Parse error: ${parseError instanceof Error ? parseError.message : String(parseError)}`
+          }
+        },
+        emit: true
       };
     }
-    case "tools/call": {
-      const toolName = params?.name;
-      const toolArgs = params?.arguments ?? {};
-      const { codegraphDb: cgDb, dataDb: lDb } = getDb();
-      const result = await handleToolCall(toolName, toolArgs, lDb, cgDb);
+    try {
+      const response = await handleRequest(request);
+      return { response, emit: request.id !== void 0 };
+    } catch (error) {
       return {
-        jsonrpc: "2.0",
-        id: id ?? null,
-        result
+        response: {
+          jsonrpc: "2.0",
+          id: request.id ?? null,
+          error: {
+            code: -32603,
+            message: `Internal error: ${error instanceof Error ? error.message : String(error)}`
+          }
+        },
+        emit: true
       };
     }
-    case "ping": {
-      return { jsonrpc: "2.0", id: id ?? null, result: {} };
+  }
+  function closeCachedDbs() {
+    if (codegraphDbCache) {
+      codegraphDbCache.close();
+      codegraphDbCache = null;
     }
-    default: {
-      return {
-        jsonrpc: "2.0",
-        id: id ?? null,
-        error: { code: -32601, message: `Method not found: ${method}` }
-      };
+    if (dataDbCache) {
+      dataDbCache.close();
+      dataDbCache = null;
     }
   }
+  return { handleRequest, processLine, closeCachedDbs };
 }
+var init_server_dispatch = __esm({
+  "src/server-dispatch.ts"() {
+    "use strict";
+    init_db();
+    init_config();
+    init_tools();
+    init_tool_db_needs();
+  }
+});
+
+// src/server.ts
+var server_exports = {};
+import { readFileSync as readFileSync39 } from "fs";
+import { resolve as resolve32, dirname as dirname16 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
 function pruneMemoryOnStartup() {
   try {
     const memDb = getMemoryDb();
@@ -27662,15 +27939,13 @@ function pruneMemoryOnStartup() {
     );
   }
 }
-var __dirname4, PKG_VERSION, codegraphDb, dataDb, buffer;
+var __dirname4, PKG_VERSION, dispatcher, buffer;
 var init_server = __esm({
   "src/server.ts"() {
     "use strict";
-    init_db();
-    init_config();
-    init_tools();
     init_memory_db();
     init_license();
+    init_server_dispatch();
     __dirname4 = dirname16(fileURLToPath4(import.meta.url));
     PKG_VERSION = (() => {
       try {
@@ -27680,8 +27955,7 @@ var init_server = __esm({
         return "0.0.0";
       }
     })();
-    codegraphDb = null;
-    dataDb = null;
+    dispatcher = createDispatcher({ serverInfoVersion: PKG_VERSION });
     pruneMemoryOnStartup();
     getCurrentTier().then((tier) => {
       process.stderr.write(`massu: License tier: ${tier}
@@ -27698,32 +27972,16 @@ var init_server = __esm({
       buffer += chunk;
       let newlineIndex;
       while ((newlineIndex = buffer.indexOf("\n")) !== -1) {
-        const line = buffer.slice(0, newlineIndex).trim();
+        const line = buffer.slice(0, newlineIndex);
         buffer = buffer.slice(newlineIndex + 1);
-        if (!line) continue;
-        try {
-          const request = JSON.parse(line);
-          const response = await handleRequest(request);
-          if (request.id !== void 0) {
-            const responseStr = JSON.stringify(response);
-            process.stdout.write(responseStr + "\n");
-          }
-        } catch (error) {
-          const errorResponse = {
-            jsonrpc: "2.0",
-            id: null,
-            error: {
-              code: -32700,
-              message: `Parse error: ${error instanceof Error ? error.message : String(error)}`
-            }
-          };
-          process.stdout.write(JSON.stringify(errorResponse) + "\n");
+        const result = await dispatcher.processLine(line);
+        if (result && result.emit) {
+          process.stdout.write(JSON.stringify(result.response) + "\n");
         }
       }
     });
     process.stdin.on("end", () => {
-      if (codegraphDb) codegraphDb.close();
-      if (dataDb) dataDb.close();
+      dispatcher.closeCachedDbs();
       process.exit(0);
     });
     process.on("uncaughtException", (error) => {