depgraph-core 1.8.0 → 1.9.1

package/depgraph.js

@@ -65,7 +65,8 @@ var require_constants = __commonJS({
       ".vue",
       ".svelte",
       ".dart",
-      ".rs"
+      ".rs",
+      ".sql"
     ]);
     exports2.MAX_FILE_SIZE = 3e5;
     exports2.MAX_BFS_DEPTH = 10;
@@ -3466,6 +3467,322 @@ var require_rust = __commonJS({
   }
 });
 
+// dist/languages/sql/helpers.js
+var require_helpers = __commonJS({
+  "dist/languages/sql/helpers.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.NON_TABLES = exports2.ROUTINE_RECOVERY_RX = exports2.QUAL_NAME = exports2.NAME_PART = void 0;
+    exports2.lineOf = lineOf;
+    exports2.normIdent = normIdent;
+    exports2.maskSqlComments = maskSqlComments;
+    exports2.collectCteNames = collectCteNames;
+    exports2.collectTableRefs = collectTableRefs;
+    exports2.collectFkRefs = collectFkRefs;
+    exports2.NAME_PART = '(?:"(?:[^"\\n]|"")*"|`(?:[^`\\n]|``)*`|\\[(?:[^\\]\\n]|\\]\\])*\\]|[\\w$]+)';
+    exports2.QUAL_NAME = `${exports2.NAME_PART}(?:\\s*\\.\\s*${exports2.NAME_PART})*`;
+    exports2.ROUTINE_RECOVERY_RX = new RegExp(`\\bCREATE\\s+(?:OR\\s+(?:REPLACE|ALTER)\\s+)?(?:FUNCTION|PROC(?:EDURE)?)\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(${exports2.QUAL_NAME})`, "gi");
+    function lineOf(text, offset) {
+      return text.slice(0, offset).split("\n").length;
+    }
+    function normIdent(name) {
+      return name.split(".").map((p) => {
+        const s = p.trim();
+        if (s.length >= 2 && (s[0] === s[s.length - 1] && (s[0] === '"' || s[0] === "`") || s[0] === "[" && s[s.length - 1] === "]")) {
+          return s.slice(1, -1).toLowerCase();
+        }
+        return s.toLowerCase();
+      }).join(".");
+    }
+    function maskSqlComments(text) {
+      const out = [];
+      let i = 0;
+      const n = text.length;
+      function blank(upto) {
+        for (const ch of text.slice(i, upto))
+          out.push(ch === "\n" ? "\n" : " ");
+        return upto;
+      }
+      while (i < n) {
+        const c = text[i];
+        if (c === "'") {
+          let j = i + 1;
+          while (j < n && text[j] !== "\n") {
+            if (text[j] === "'") {
+              if (j + 1 < n && text[j + 1] === "'") {
+                j += 2;
+                continue;
+              }
+              j++;
+              break;
+            }
+            j++;
+          }
+          i = blank(j);
+        } else if (c === '"' || c === "`" || c === "[") {
+          const closer = c === "[" ? "]" : c;
+          let j = i + 1;
+          let closed = false;
+          while (j < n && text[j] !== "\n") {
+            if (text[j] === closer) {
+              if (j + 1 < n && text[j + 1] === closer) {
+                j += 2;
+                continue;
+              }
+              j++;
+              closed = true;
+              break;
+            }
+            j++;
+          }
+          const span = text.slice(i, j);
+          if (closed && !span.includes("--") && !span.includes("/*")) {
+            out.push(span);
+            i = j;
+          } else {
+            let eol = text.indexOf("\n", i);
+            if (eol === -1)
+              eol = n;
+            i = blank(eol);
+          }
+        } else if (c === "-" && i + 1 < n && text[i + 1] === "-") {
+          let j = i;
+          while (j < n && text[j] !== "\n")
+            j++;
+          i = blank(j);
+        } else if (c === "/" && i + 1 < n && text[i + 1] === "*") {
+          let depth = 1;
+          let j = i + 2;
+          while (j < n && depth > 0) {
+            if (text[j] === "/" && j + 1 < n && text[j + 1] === "*") {
+              depth++;
+              j += 2;
+            } else if (text[j] === "*" && j + 1 < n && text[j + 1] === "/") {
+              depth--;
+              j += 2;
+            } else
+              j++;
+          }
+          i = blank(j);
+        } else {
+          out.push(c);
+          i++;
+        }
+      }
+      return out.join("");
+    }
+    var NON_TABLES = /* @__PURE__ */ new Set([
+      "select",
+      "where",
+      "set",
+      "dual",
+      "null",
+      "true",
+      "false",
+      "first",
+      "skip",
+      "rows",
+      "next",
+      "only",
+      "lateral",
+      "values",
+      "inserted",
+      "deleted",
+      "new",
+      "old"
+    ]);
+    exports2.NON_TABLES = NON_TABLES;
+    function collectCteNames(text) {
+      const ctes = /* @__PURE__ */ new Set();
+      const rx = /\bWITH\s+(?:RECURSIVE\s+)?([\w$]+)\s*(?:\([^()]*\))?\s+AS\s*\(/gi;
+      for (const m of text.matchAll(rx))
+        ctes.add(normIdent(m[1]));
+      return ctes;
+    }
+    function collectTableRefs(masked, extraNonTables = /* @__PURE__ */ new Set()) {
+      const skip = /* @__PURE__ */ new Set([...NON_TABLES, ...extraNonTables]);
+      const refs = [];
+      const seen = /* @__PURE__ */ new Set();
+      const rx = new RegExp(`\\b(?:FROM|JOIN|INTO|UPDATE)\\s+(${exports2.QUAL_NAME})`, "gi");
+      for (const m of masked.matchAll(rx)) {
+        const raw = m[1];
+        const key = normIdent(raw);
+        if (skip.has(key) || seen.has(key))
+          continue;
+        seen.add(key);
+        refs.push({ name: raw, line: lineOf(masked, m.index ?? 0) });
+      }
+      return refs;
+    }
+    function collectFkRefs(masked) {
+      const refs = [];
+      const seen = /* @__PURE__ */ new Set();
+      const rx = new RegExp(`\\bREFERENCES\\s+(${exports2.QUAL_NAME})`, "gi");
+      for (const m of masked.matchAll(rx)) {
+        const raw = m[1];
+        const key = normIdent(raw);
+        if (seen.has(key))
+          continue;
+        seen.add(key);
+        refs.push({ name: raw, line: lineOf(masked, m.index ?? 0) });
+      }
+      return refs;
+    }
+  }
+});
+
+// dist/languages/sql/patterns.js
+var require_patterns = __commonJS({
+  "dist/languages/sql/patterns.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.sqlEntityPatterns = void 0;
+    var helpers_1 = require_helpers();
+    exports2.sqlEntityPatterns = [
+      {
+        regex: new RegExp(`\\bCREATE\\s+(?:TEMP(?:ORARY)?\\s+)?TABLE\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(${helpers_1.QUAL_NAME})`, "gi"),
+        type: "table"
+      },
+      {
+        regex: new RegExp(`\\bCREATE\\s+(?:OR\\s+(?:REPLACE|ALTER)\\s+)?(?:MATERIALIZED\\s+)?VIEW\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(${helpers_1.QUAL_NAME})`, "gi"),
+        type: "view"
+      },
+      {
+        regex: new RegExp(`\\bCREATE\\s+(?:OR\\s+(?:REPLACE|ALTER)\\s+)?FUNCTION\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(${helpers_1.QUAL_NAME})`, "gi"),
+        type: "function"
+      },
+      {
+        regex: new RegExp(`\\bCREATE\\s+(?:OR\\s+(?:REPLACE|ALTER)\\s+)?PROC(?:EDURE)?\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(${helpers_1.QUAL_NAME})`, "gi"),
+        type: "procedure"
+      },
+      {
+        regex: new RegExp(`\\bCREATE\\s+(?:OR\\s+(?:REPLACE|ALTER)\\s+)?TRIGGER\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(${helpers_1.QUAL_NAME})`, "gi"),
+        type: "trigger"
+      },
+      {
+        regex: new RegExp(`\\bCREATE\\s+(?:UNIQUE\\s+)?INDEX\\s+(?:CONCURRENTLY\\s+)?(?:IF\\s+NOT\\s+EXISTS\\s+)?(${helpers_1.QUAL_NAME})\\s+ON\\b`, "gi"),
+        type: "index"
+      }
+    ];
+  }
+});
+
+// dist/languages/sql/extractor.js
+var require_extractor = __commonJS({
+  "dist/languages/sql/extractor.js"(exports2) {
+    "use strict";
+    var __importDefault2 = exports2 && exports2.__importDefault || function(mod) {
+      return mod && mod.__esModule ? mod : { "default": mod };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.extractEntities = extractEntities;
+    exports2.extractImports = extractImports;
+    exports2.extractExports = extractExports;
+    var path_1 = __importDefault2(require("path"));
+    var patterns_1 = require_patterns();
+    var helpers_1 = require_helpers();
+    var _currentFile = "";
+    function extractEntities(code, filePath) {
+      _currentFile = filePath;
+      const masked = (0, helpers_1.maskSqlComments)(code);
+      const entities = [];
+      const seenNames = /* @__PURE__ */ new Set();
+      for (const { regex, type } of patterns_1.sqlEntityPatterns) {
+        regex.lastIndex = 0;
+        for (const m of masked.matchAll(regex)) {
+          const raw = m[1].trim();
+          const key = (0, helpers_1.normIdent)(raw);
+          if (seenNames.has(key))
+            continue;
+          seenNames.add(key);
+          entities.push({ name: raw, type, line: (0, helpers_1.lineOf)(code, m.index ?? 0), complexity: "low" });
+        }
+      }
+      helpers_1.ROUTINE_RECOVERY_RX.lastIndex = 0;
+      for (const m of masked.matchAll(helpers_1.ROUTINE_RECOVERY_RX)) {
+        const raw = m[1].trim();
+        const key = (0, helpers_1.normIdent)(raw);
+        if (seenNames.has(key))
+          continue;
+        seenNames.add(key);
+        entities.push({ name: `${raw}()`, type: "procedure", line: (0, helpers_1.lineOf)(code, m.index ?? 0), complexity: "low" });
+      }
+      return entities;
+    }
+    function extractImports(code) {
+      const masked = (0, helpers_1.maskSqlComments)(code);
+      const imports = [];
+      const fileBase = path_1.default.basename(_currentFile, path_1.default.extname(_currentFile));
+      if (!fileBase)
+        return imports;
+      const ctes = (0, helpers_1.collectCteNames)(masked);
+      for (const ref of (0, helpers_1.collectFkRefs)(masked)) {
+        imports.push({ source: fileBase, names: [ref.name], isLocal: true });
+      }
+      for (const ref of (0, helpers_1.collectTableRefs)(masked, ctes)) {
+        imports.push({ source: fileBase, names: [ref.name], isLocal: true });
+      }
+      return imports;
+    }
+    function extractExports(code) {
+      const masked = (0, helpers_1.maskSqlComments)(code);
+      const names = [];
+      const seen = /* @__PURE__ */ new Set();
+      for (const { regex } of patterns_1.sqlEntityPatterns) {
+        regex.lastIndex = 0;
+        for (const m of masked.matchAll(regex)) {
+          const key = (0, helpers_1.normIdent)(m[1].trim());
+          if (!seen.has(key)) {
+            seen.add(key);
+            names.push(m[1].trim());
+          }
+        }
+      }
+      return names;
+    }
+  }
+});
+
+// dist/languages/sql/index.js
+var require_sql = __commonJS({
+  "dist/languages/sql/index.js"(exports2) {
+    "use strict";
+    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __exportStar = exports2 && exports2.__exportStar || function(m, exports3) {
+      for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports3, p)) __createBinding(exports3, m, p);
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.SqlParser = void 0;
+    var registry_1 = require_registry();
+    var patterns_1 = require_patterns();
+    var extractor_1 = require_extractor();
+    __exportStar(require_helpers(), exports2);
+    __exportStar(require_patterns(), exports2);
+    __exportStar(require_extractor(), exports2);
+    exports2.SqlParser = {
+      lang: "sql",
+      extensions: [".sql"],
+      extractEntities: extractor_1.extractEntities,
+      extractImports: extractor_1.extractImports,
+      extractExports: extractor_1.extractExports,
+      entityPatterns: patterns_1.sqlEntityPatterns
+    };
+    (0, registry_1.registerParser)(exports2.SqlParser);
+  }
+});
+
 // dist/stages/collector.js
 var require_collector = __commonJS({
   "dist/stages/collector.js"(exports2) {
@@ -3683,7 +4000,8 @@ var require_graph = __commonJS({
         `${base}/index.ts`,
         `${base}/index.js`,
         `${base}.dart`,
-        `${base}.rs`
+        `${base}.rs`,
+        `${base}.sql`
       ];
       for (const candidate of candidates) {
         const normalized = candidate.replace(/\\/g, "/");
@@ -4145,6 +4463,7 @@ require_ruby();
 require_swift();
 require_dart();
 require_rust();
+require_sql();
 var fs_1 = __importDefault(require("fs"));
 var collector_1 = require_collector();
 var parser_1 = require_parser();
@@ -4173,7 +4492,7 @@ function getFlag(flag) {
 }
 function printHelp() {
   console.log(`
-${bold("DepGraph")} ${dim("v1.8.0")}
+${bold("DepGraph")} ${dim("v1.9.1")}
 ${dim("Dependency mapping \xB7 Impact simulation \xB7 Developer intelligence")}
 
 ${bold("USAGE")}
@@ -4222,7 +4541,7 @@ ${bold("GIT EXAMPLES")}
 function printBanner() {
   console.log(`
 ${bold("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501")}
-${bold("  DepGraph")}  ${dim("v1.8.0")}
+${bold("  DepGraph")}  ${dim("v1.9.1")}
 ${bold("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501")}
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "depgraph-core",
-  "version": "1.8.0",
+  "version": "1.9.1",
   "description": "Dependency mapping and impact simulation for JS/TS projects",
   "main": "depgraph.js",
   "bin": {
@@ -15,6 +15,7 @@
     "release:mcp": "npm run build && npm run bundle:mcp",
     "release:all": "npm run build && npm run bundle && npm run bundle:mcp",
     "mcp:register": "claude mcp add depgraph -- node $(pwd)/depgraph-mcp.js",
+    "benchmark": "node scripts/benchmark.js",
     "test": "vitest",
     "test:run": "vitest run"
   },

package/scripts/benchmark.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+// Measures real response sizes from depgraph-mcp.js for each tool variant.
+// Usage:
+//   node scripts/benchmark.js
+//   BENCH_DIR=/other/project node scripts/benchmark.js
+'use strict';
+const { execSync } = require('child_process');
+const path = require('path');
+
+const SERVER = path.resolve(__dirname, '..', 'depgraph-mcp.js');
+const DIR    = process.env.BENCH_DIR ?? path.resolve(__dirname, '..');
+
+const os   = require('os');
+const fs   = require('fs');
+const TMPF = path.join(os.tmpdir(), `depgraph-bench-${process.pid}.txt`);
+
+function call(toolName, args) {
+  const messages = [
+    {
+      jsonrpc: '2.0', id: 1, method: 'initialize',
+      params: { protocolVersion: '2024-11-05', capabilities: {},
+                clientInfo: { name: 'bench', version: '1.0' } },
+    },
+    {
+      jsonrpc: '2.0', id: 2, method: 'tools/call',
+      params: { name: toolName, arguments: args },
+    },
+  ].map(m => JSON.stringify(m)).join('\n') + '\n';
+
+  fs.writeFileSync(TMPF, messages, 'utf-8');
+
+  const out = execSync(
+    `cat ${TMPF} | node ${SERVER}`,
+    { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+  );
+
+  const lines = out.trim().split('\n').filter(Boolean);
+  const result = JSON.parse(lines[lines.length - 1]);
+  return result?.result?.content?.[0]?.text ?? '';
+}
+
+// ~3.5 chars/token for dense JSON; ~4.0 for prose (matches Claude/GPT-4 closely enough)
+const tokEst = (s, prose = false) => Math.round(s.length / (prose ? 4.0 : 3.5));
+
+const CASES = [
+  {
+    label: 'analyze_project — full (BASELINE)',
+    fn: () => call('analyze_project', { projectDir: DIR }),
+  },
+  {
+    label: 'analyze_project — verbosity:"overview"',
+    fn: () => call('analyze_project', { projectDir: DIR, verbosity: 'overview' }),
+  },
+  {
+    label: 'analyze_project — verbosity:"sketch"',
+    fn: () => call('analyze_project', { projectDir: DIR, verbosity: 'sketch' }),
+  },
+  {
+    label: 'analyze_project — focus + depth:2 (overview)',
+    fn: () => call('analyze_project',
+      { projectDir: DIR, focus: 'buildGraph', depth: 2, verbosity: 'overview' }),
+  },
+  {
+    label: 'analyze_project — focus + depth:1 (overview)',
+    fn: () => call('analyze_project',
+      { projectDir: DIR, focus: 'buildGraph', depth: 1, verbosity: 'overview' }),
+  },
+  {
+    label: 'get_graph_summary — overview',
+    fn: () => call('get_graph_summary', { projectDir: DIR }),
+  },
+  {
+    label: 'get_graph_summary — verbosity:"sketch"',
+    fn: () => call('get_graph_summary', { projectDir: DIR, verbosity: 'sketch' }),
+  },
+  {
+    label: 'get_graph_summary — format:"prose"',
+    fn: () => call('get_graph_summary', { projectDir: DIR, format: 'prose' }),
+    prose: true,
+  },
+  {
+    label: 'describe_node("buildGraph")',
+    fn: () => call('describe_node', { projectDir: DIR, nodeName: 'buildGraph' }),
+  },
+  {
+    label: 'describe_node("simulateImpact")',
+    fn: () => call('describe_node', { projectDir: DIR, nodeName: 'simulateImpact' }),
+  },
+  {
+    label: 'simulate_impact("buildGraph", ...)',
+    fn: () => call('simulate_impact', {
+      projectDir: DIR,
+      targetNode: 'buildGraph',
+      changeDescription: 'removing parsed arg',
+    }),
+  },
+];
+
+console.log(`\nBenchmarking against: ${DIR}`);
+console.log(`MCP server:           ${SERVER}\n`);
+
+const rows = CASES.map(c => {
+  process.stdout.write(`  ${c.label} ...`);
+  const text   = c.fn();
+  const chars  = text.length;
+  const tokens = tokEst(text, c.prose ?? false);
+  process.stdout.write(` ${tokens.toLocaleString()} tokens\n`);
+  return { label: c.label, chars, tokens };
+});
+
+const baseline = rows[0].tokens;
+
+const W = { label: 50, chars: 10, tokens: 9, pct: 14 };
+const rule = '─'.repeat(W.label + W.chars + W.tokens + W.pct + 4);
+
+console.log('\n' + rule);
+console.log(
+  'Tool call'.padEnd(W.label) +
+  'Chars'.padStart(W.chars) +
+  'Tokens'.padStart(W.tokens) +
+  'vs baseline'.padStart(W.pct)
+);
+console.log(rule);
+
+rows.forEach((r, i) => {
+  const pct = i === 0
+    ? '(baseline)'
+    : `−${Math.round((1 - r.tokens / baseline) * 100)} %`;
+  console.log(
+    r.label.padEnd(W.label) +
+    r.chars.toLocaleString().padStart(W.chars) +
+    r.tokens.toLocaleString().padStart(W.tokens) +
+    pct.padStart(W.pct)
+  );
+});
+
+console.log(rule);
+console.log(`\nBaseline: ${baseline.toLocaleString()} tokens  (${rows[0].chars.toLocaleString()} chars)\n`);