sigmap 1.5.0

package/gen-project-map.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * gen-project-map.js — SigMap v0.4
+ * Generates PROJECT_MAP.md with import graph, class hierarchy, and route table.
+ *
+ * Usage:
+ *   node gen-project-map.js           Generate PROJECT_MAP.md
+ *   node gen-project-map.js --version Print version and exit
+ *   node gen-project-map.js --help    Print usage and exit
+ *
+ * Zero npm dependencies — runs on Node.js 18+ with nothing installed.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const VERSION     = '0.4.0';
+const OUTPUT_FILE = 'PROJECT_MAP.md';
+
+// ---------------------------------------------------------------------------
+// CLI
+// ---------------------------------------------------------------------------
+const args = process.argv.slice(2);
+
+if (args.includes('--version')) {
+  console.log(`gen-project-map.js v${VERSION}`);
+  process.exit(0);
+}
+
+if (args.includes('--help')) {
+  console.log([
+    `gen-project-map.js v${VERSION} — SigMap project map generator`,
+    '',
+    'Usage:',
+    '  node gen-project-map.js           Generate PROJECT_MAP.md',
+    '  node gen-project-map.js --version Print version and exit',
+    '  node gen-project-map.js --help    Print this message',
+    '',
+    'Configuration: gen-context.config.json (same file as gen-context.js)',
+    '  srcDirs  — directories to scan  (default: ["src","app","lib",...])',
+    '  exclude  — patterns to skip     (default: ["node_modules",".git",...])',
+    '  maxDepth — recursion limit      (default: 6)',
+    '',
+    'Output: PROJECT_MAP.md (project root)',
+  ].join('\n'));
+  process.exit(0);
+}
+
+// ---------------------------------------------------------------------------
+// Config — reuse src/config/loader.js
+// ---------------------------------------------------------------------------
+const { loadConfig } = require('./src/config/loader');
+
+// ---------------------------------------------------------------------------
+// Compact inline file walker
+// ---------------------------------------------------------------------------
+const DEFAULT_EXCLUDE = new Set([
+  'node_modules', '.git', 'dist', 'build', 'out',
+  '__pycache__', '.next', 'coverage', 'target', 'vendor', '.context',
+]);
+
+function walkDir(dir, excludeSet, maxDepth, depth, results) {
+  if (depth > maxDepth) return;
+  let entries;
+  try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch (_) { return; }
+  for (const entry of entries) {
+    if (excludeSet.has(entry.name)) continue;
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      walkDir(full, excludeSet, maxDepth, depth + 1, results);
+    } else if (entry.isFile()) {
+      results.push(full);
+    }
+  }
+}
+
+function buildFileList(cwd, srcDirs, exclude, maxDepth) {
+  const excludeSet = new Set([...DEFAULT_EXCLUDE, ...exclude]);
+  const files = [];
+  for (const dir of srcDirs) {
+    const abs = path.isAbsolute(dir) ? dir : path.join(cwd, dir);
+    if (!fs.existsSync(abs)) continue;
+    walkDir(abs, excludeSet, maxDepth, 0, files);
+  }
+  // Also check for files directly in root (routes, config files, etc.)
+  // but only when srcDirs are explicit; skip to avoid noise
+  return files;
+}
+
+// ---------------------------------------------------------------------------
+// Analyzers (lazy-required so errors don't abort the run)
+// ---------------------------------------------------------------------------
+function runAnalyzer(name, files, cwd) {
+  try {
+    const mod = require(`./src/map/${name}`);
+    return mod.analyze(files, cwd) || '';
+  } catch (err) {
+    console.warn(`[sigmap] ${name} analyzer failed: ${err.message}`);
+    return '';
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Format PROJECT_MAP.md
+// ---------------------------------------------------------------------------
+function formatOutput(sections) {
+  const now = new Date().toISOString().slice(0, 10);
+  const lines = [
+    '# Project Map',
+    `<!-- Generated by gen-project-map.js v${VERSION} on ${now} -->`,
+    '',
+  ];
+
+  const parts = [
+    { key: 'imports',   header: '### Import graph',      content: sections.imports },
+    { key: 'classes',   header: '### Class hierarchy',   content: sections.classes },
+    { key: 'routes',    header: '### Route table',       content: sections.routes  },
+  ];
+
+  for (const { header, content } of parts) {
+    lines.push(header);
+    lines.push('');
+    if (content) {
+      lines.push(content);
+    } else {
+      lines.push('_No entries found._');
+    }
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+function main() {
+  const cwd = process.cwd();
+  const config = loadConfig(cwd);
+  const { srcDirs, exclude, maxDepth } = config;
+
+  console.log(`[sigmap] scanning ${srcDirs.join(', ')} (maxDepth=${maxDepth}) …`);
+
+  const files = buildFileList(cwd, srcDirs, exclude, maxDepth);
+
+  if (files.length === 0) {
+    console.warn(`[sigmap] no source files found — check srcDirs in gen-context.config.json`);
+  } else {
+    console.log(`[sigmap] found ${files.length} source files`);
+  }
+
+  const sections = {
+    imports: runAnalyzer('import-graph',     files, cwd),
+    classes: runAnalyzer('class-hierarchy',  files, cwd),
+    routes:  runAnalyzer('route-table',      files, cwd),
+  };
+
+  const output = formatOutput(sections);
+  const outPath = path.join(cwd, OUTPUT_FILE);
+
+  try {
+    fs.writeFileSync(outPath, output, 'utf8');
+    console.log(`[sigmap] wrote ${OUTPUT_FILE} (${output.length} bytes)`);
+  } catch (err) {
+    console.error(`[sigmap] failed to write ${OUTPUT_FILE}: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "sigmap",
+  "version": "1.5.0",
+  "description": "Zero-dependency AI context engine — 97% token reduction. No npm install. Runs on Node 18+.",
+  "main": "gen-context.js",
+  "bin": {
+    "sigmap": "./gen-context.js",
+    "gen-context": "./gen-context.js",
+    "gen-project-map": "./gen-project-map.js"
+  },
+  "scripts": {
+    "test": "node test/run.js",
+    "test:integration": "node test/integration/strategy.test.js && node test/integration/secret-scan.test.js && node test/integration/token-budget.test.js && node test/integration/mcp-server.test.js",
+    "test:all": "node test/run.js && node test/integration/strategy.test.js && node test/integration/secret-scan.test.js",
+    "generate": "node gen-context.js",
+    "watch": "node gen-context.js --watch",
+    "setup": "node gen-context.js --setup",
+    "init": "node gen-context.js --init",
+    "report": "node gen-context.js --report",
+    "health": "node gen-context.js --health",
+    "map": "node gen-project-map.js",
+    "mcp": "node gen-context.js --mcp"
+  },
+  "files": [
+    "gen-context.js",
+    "gen-project-map.js",
+    "src/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    ".contextignore.example",
+    "gen-context.config.json.example"
+  ],
+  "keywords": [
+    "ai",
+    "context",
+    "copilot",
+    "claude",
+    "cursor",
+    "windsurf",
+    "llm",
+    "tokens",
+    "token-reduction",
+    "code-signatures",
+    "ai-context",
+    "zero-dependency",
+    "mcp",
+    "github-copilot"
+  ],
+  "author": {
+    "name": "Manoj Mallick",
+    "url": "https://github.com/manojmallick"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/manojmallick/sigmap.git"
+  },
+  "homepage": "https://manojmallick.github.io/sigmap/",
+  "bugs": {
+    "url": "https://github.com/manojmallick/sigmap/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {}
+}

package/src/config/defaults.js

@@ -0,0 +1,61 @@
+'use strict';
+
+/**
+ * Default configuration values for SigMap.
+ * All keys documented here. Override via gen-context.config.json.
+ */
+const DEFAULTS = {
+  // Primary output file (used when outputs includes 'copilot')
+  output: '.github/copilot-instructions.md',
+
+  // Output targets: 'copilot' | 'claude' | 'cursor' | 'windsurf'
+  outputs: ['copilot'],
+
+  // Directories to scan (relative to project root)
+  srcDirs: ['src', 'app', 'lib', 'packages', 'services', 'api'],
+
+  // Directory/file names to exclude entirely
+  exclude: [
+    'node_modules', '.git', 'dist', 'build', 'out',
+    '__pycache__', '.next', 'coverage', 'target', 'vendor',
+    '.context',
+  ],
+
+  // Maximum directory depth to recurse
+  maxDepth: 6,
+
+  // Maximum signatures extracted per file
+  maxSigsPerFile: 25,
+
+  // Maximum tokens in final output before budget enforcement kicks in
+  maxTokens: 6000,
+
+  // Scan signatures for secrets and redact matches
+  secretScan: true,
+
+  // Auto-detect monorepo packages and write per-package output files
+  monorepo: false,
+
+  // Sort recently git-committed files higher in output
+  diffPriority: true,
+
+  // Debounce delay (ms) between file-system events and regeneration in watch mode
+  watchDebounce: 300,
+
+  // Append model routing hints section to the context output
+  // Routes files to fast/balanced/powerful model tiers based on complexity
+  routing: false,
+
+  // Output format: 'default' (markdown only) | 'cache' (also write Anthropic prompt-cache JSON)
+  format: 'default',
+
+  // Append run metrics to .context/usage.ndjson after each generate
+  tracking: false,
+
+  // MCP server configuration
+  mcp: {
+    autoRegister: true,
+  },
+};
+
+module.exports = { DEFAULTS };

package/src/config/loader.js

@@ -0,0 +1,60 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { DEFAULTS } = require('./defaults');
+
+// Keys that are valid in gen-context.config.json
+const KNOWN_KEYS = new Set(Object.keys(DEFAULTS));
+
+/**
+ * Load and merge configuration for a given working directory.
+ *
+ * @param {string} cwd - Project root directory
+ * @returns {object} Merged config (DEFAULTS + user overrides)
+ */
+function loadConfig(cwd) {
+  const configPath = path.join(cwd, 'gen-context.config.json');
+  if (!fs.existsSync(configPath)) {
+    return deepClone(DEFAULTS);
+  }
+
+  let userConfig;
+  try {
+    const raw = fs.readFileSync(configPath, 'utf8');
+    userConfig = JSON.parse(raw);
+  } catch (err) {
+    console.warn(`[sigmap] config parse error in ${configPath}: ${err.message}`);
+    return deepClone(DEFAULTS);
+  }
+
+  // Warn on unknown keys (helps catch typos)
+  for (const key of Object.keys(userConfig)) {
+    if (key.startsWith('_')) continue; // allow _comment etc.
+    if (!KNOWN_KEYS.has(key)) {
+      console.warn(`[sigmap] unknown config key: "${key}" (ignored)`);
+    }
+  }
+
+  // Deep merge: top-level known keys from user override defaults
+  // For object values (e.g. mcp), merge one level deep
+  const merged = deepClone(DEFAULTS);
+  for (const key of Object.keys(userConfig)) {
+    if (key.startsWith('_')) continue;
+    if (!KNOWN_KEYS.has(key)) continue; // skip unknown keys
+    const val = userConfig[key];
+    if (val !== null && typeof val === 'object' && !Array.isArray(val) &&
+        typeof merged[key] === 'object' && !Array.isArray(merged[key])) {
+      merged[key] = Object.assign({}, merged[key], val);
+    } else {
+      merged[key] = val;
+    }
+  }
+  return merged;
+}
+
+function deepClone(obj) {
+  return JSON.parse(JSON.stringify(obj));
+}
+
+module.exports = { loadConfig };

package/src/extractors/cpp.js

@@ -0,0 +1,60 @@
+'use strict';
+
+/**
+ * Extract signatures from C/C++ source code.
+ * @param {string} src - Raw file content
+ * @returns {string[]} Array of signature strings
+ */
+function extract(src) {
+  if (!src || typeof src !== 'string') return [];
+  const sigs = [];
+
+  const stripped = src
+    .replace(/\/\/.*$/gm, '')
+    .replace(/\/\*[\s\S]*?\*\//g, '');
+
+  // Classes and structs
+  const classRe = /^(?:class|struct)\s+(\w+)(?:\s*:\s*(?:public|protected|private)\s+[\w:]+)?\s*\{/gm;
+  for (const m of stripped.matchAll(classRe)) {
+    const kind = m[0].trimStart().startsWith('class') ? 'class' : 'struct';
+    sigs.push(`${kind} ${m[1]}`);
+    const block = extractBlock(stripped, m.index + m[0].length);
+    for (const meth of extractMembers(block)) sigs.push(`  ${meth}`);
+  }
+
+  // Top-level function declarations/definitions (not inside a class)
+  for (const m of stripped.matchAll(/^(?!class|struct|if|for|while|switch)[\w:*&<> ]+\s+(\w+)\s*\(([^)]*)\)\s*(?:const\s*)?\{/gm)) {
+    if (m[1].startsWith('_')) continue;
+    sigs.push(`${m[1]}(${normalizeParams(m[2])})`);
+  }
+
+  return sigs.slice(0, 25);
+}
+
+function extractBlock(src, startIndex) {
+  let depth = 1, i = startIndex;
+  const end = Math.min(src.length, startIndex + 4000);
+  while (i < end && depth > 0) {
+    if (src[i] === '{') depth++;
+    else if (src[i] === '}') depth--;
+    i++;
+  }
+  return src.slice(startIndex, i - 1);
+}
+
+function extractMembers(block) {
+  const members = [];
+  const methodRe = /^\s+(?:virtual\s+|static\s+|inline\s+)?(?!private:|protected:|public:)[\w:*&<> ]+\s+(\w+)\s*\(([^)]*)\)\s*(?:const\s*)?(?:override\s*)?(?:=\s*0\s*)?;/gm;
+  for (const m of block.matchAll(methodRe)) {
+    if (m[1].startsWith('_')) continue;
+    members.push(`${m[1]}(${normalizeParams(m[2])})`);
+  }
+  return members.slice(0, 8);
+}
+
+function normalizeParams(params) {
+  if (!params) return '';
+  return params.trim().replace(/\s+/g, ' ');
+}
+
+module.exports = { extract };

package/src/extractors/csharp.js

@@ -0,0 +1,48 @@
+'use strict';
+
+/**
+ * Extract signatures from C# source code.
+ * @param {string} src - Raw file content
+ * @returns {string[]} Array of signature strings
+ */
+function extract(src) {
+  if (!src || typeof src !== 'string') return [];
+  const sigs = [];
+
+  const stripped = src
+    .replace(/\/\/.*$/gm, '')
+    .replace(/\/\*[\s\S]*?\*\//g, '');
+
+  // Classes and interfaces
+  const typeRe = /^\s*(?:public\s+|internal\s+|protected\s+)?(?:abstract\s+|sealed\s+|static\s+)?(class|interface|enum|record|struct)\s+(\w+)(?:<[^{]*>)?(?:\s*:\s*[\w<>, .]+)?\s*\{/gm;
+  for (const m of stripped.matchAll(typeRe)) {
+    sigs.push(`${m[1]} ${m[2]}`);
+    const block = extractBlock(stripped, m.index + m[0].length);
+    for (const meth of extractMembers(block)) sigs.push(`  ${meth}`);
+  }
+
+  return sigs.slice(0, 25);
+}
+
+function extractBlock(src, startIndex) {
+  let depth = 1, i = startIndex;
+  const end = Math.min(src.length, startIndex + 5000);
+  while (i < end && depth > 0) {
+    if (src[i] === '{') depth++;
+    else if (src[i] === '}') depth--;
+    i++;
+  }
+  return src.slice(startIndex, i - 1);
+}
+
+function extractMembers(block) {
+  const members = [];
+  const methodRe = /^\s+(?:public|internal|protected)\s+(?:static\s+|virtual\s+|override\s+|async\s+)*(?:[\w<>\[\]?]+\s+)+(\w+)\s*\(([^)]*)\)/gm;
+  for (const m of block.matchAll(methodRe)) {
+    const sig = m[0].trim().split('{')[0].trim();
+    members.push(sig);
+  }
+  return members.slice(0, 8);
+}
+
+module.exports = { extract };

package/src/extractors/css.js

@@ -0,0 +1,51 @@
+'use strict';
+
+/**
+ * Extract signatures from CSS/SCSS/SASS/Less source code.
+ * @param {string} src - Raw file content
+ * @returns {string[]} Array of signature strings
+ */
+function extract(src) {
+  if (!src || typeof src !== 'string') return [];
+  const sigs = [];
+
+  const stripped = src
+    .replace(/\/\/.*$/gm, '')
+    .replace(/\/\*[\s\S]*?\*\//g, '');
+
+  // CSS custom properties (variables)
+  const rootMatch = stripped.match(/:root\s*\{([^}]*)\}/);
+  if (rootMatch) {
+    for (const m of rootMatch[1].matchAll(/(--[\w-]+)\s*:/g)) {
+      sigs.push(`var ${m[1]}`);
+    }
+  }
+
+  // SCSS/Less variables
+  for (const m of stripped.matchAll(/^(\$[\w-]+)\s*:/gm)) {
+    sigs.push(`$var ${m[1]}`);
+  }
+
+  // SCSS mixins
+  for (const m of stripped.matchAll(/^@mixin\s+([\w-]+)(?:\s*\(([^)]*)\))?/gm)) {
+    const params = m[2] ? `(${m[2].trim()})` : '';
+    sigs.push(`@mixin ${m[1]}${params}`);
+  }
+
+  // SCSS functions
+  for (const m of stripped.matchAll(/^@function\s+([\w-]+)\s*\(([^)]*)\)/gm)) {
+    sigs.push(`@function ${m[1]}(${m[2].trim()})`);
+  }
+
+  // Key class names (top-level)
+  const classNames = new Set();
+  for (const m of stripped.matchAll(/^\.([\w-]+)(?=[^{]*\{)/gm)) {
+    classNames.add(m[1]);
+    if (classNames.size >= 10) break;
+  }
+  for (const name of classNames) sigs.push(`.${name}`);
+
+  return sigs.slice(0, 25);
+}
+
+module.exports = { extract };

package/src/extractors/dart.js

@@ -0,0 +1,58 @@
+'use strict';
+
+/**
+ * Extract signatures from Dart source code.
+ * @param {string} src - Raw file content
+ * @returns {string[]} Array of signature strings
+ */
+function extract(src) {
+  if (!src || typeof src !== 'string') return [];
+  const sigs = [];
+
+  const stripped = src
+    .replace(/\/\/.*$/gm, '')
+    .replace(/\/\*[\s\S]*?\*\//g, '');
+
+  // Classes and abstract classes
+  for (const m of stripped.matchAll(/^(?:abstract\s+)?class\s+(\w+)(?:<[^{]*>)?(?:\s+extends\s+[\w<>, ]+)?(?:\s+(?:implements|with|on)\s+[\w<>, ]+)?\s*\{/gm)) {
+    const abs = m[0].trimStart().startsWith('abstract') ? 'abstract ' : '';
+    sigs.push(`${abs}class ${m[1]}`);
+    const block = extractBlock(stripped, m.index + m[0].length);
+    for (const meth of extractMembers(block)) sigs.push(`  ${meth}`);
+  }
+
+  // Top-level functions
+  for (const m of stripped.matchAll(/^(?:Future|void|[\w<>?]+)\s+(\w+)\s*\(([^)]*)\)/gm)) {
+    if (m[1].startsWith('_')) continue;
+    sigs.push(`${m[1]}(${normalizeParams(m[2])})`);
+  }
+
+  return sigs.slice(0, 25);
+}
+
+function extractBlock(src, startIndex) {
+  let depth = 1, i = startIndex;
+  const end = Math.min(src.length, startIndex + 4000);
+  while (i < end && depth > 0) {
+    if (src[i] === '{') depth++;
+    else if (src[i] === '}') depth--;
+    i++;
+  }
+  return src.slice(startIndex, i - 1);
+}
+
+function extractMembers(block) {
+  const members = [];
+  for (const m of block.matchAll(/^\s+(?:@override\s+)?(?:Future|void|[\w<>?]+)\s+(\w+)\s*\(([^)]*)\)/gm)) {
+    if (m[1].startsWith('_')) continue;
+    members.push(`${m[1]}(${normalizeParams(m[2])})`);
+  }
+  return members.slice(0, 8);
+}
+
+function normalizeParams(params) {
+  if (!params) return '';
+  return params.trim().replace(/\{[^}]*\}/g, '').replace(/\s+/g, ' ').trim();
+}
+
+module.exports = { extract };

package/src/extractors/dockerfile.js

@@ -0,0 +1,49 @@
+'use strict';
+
+/**
+ * Extract signatures from Dockerfiles.
+ * @param {string} src - Raw file content
+ * @returns {string[]} Array of signature strings
+ */
+function extract(src) {
+  if (!src || typeof src !== 'string') return [];
+  const sigs = [];
+
+  const lines = src.split('\n').filter((l) => l.trim() && !l.trimStart().startsWith('#'));
+
+  // FROM stages
+  for (const line of lines) {
+    const m = line.match(/^FROM\s+([^\s]+)(?:\s+AS\s+(\w+))?/i);
+    if (m) sigs.push(`FROM ${m[1]}${m[2] ? ` AS ${m[2]}` : ''}`);
+  }
+
+  // EXPOSE ports
+  const exposePorts = [];
+  for (const line of lines) {
+    const m = line.match(/^EXPOSE\s+([\d\s/]+)/i);
+    if (m) exposePorts.push(...m[1].trim().split(/\s+/));
+  }
+  if (exposePorts.length > 0) sigs.push(`EXPOSE ${exposePorts.join(' ')}`);
+
+  // ENTRYPOINT and CMD
+  for (const line of lines) {
+    if (/^ENTRYPOINT\s+/i.test(line)) sigs.push(line.trim());
+    if (/^CMD\s+/i.test(line)) sigs.push(line.trim());
+  }
+
+  // ENV variables
+  for (const line of lines) {
+    const m = line.match(/^ENV\s+([\w]+)/i);
+    if (m) sigs.push(`ENV ${m[1]}`);
+  }
+
+  // ARG variables
+  for (const line of lines) {
+    const m = line.match(/^ARG\s+([\w]+)/i);
+    if (m) sigs.push(`ARG ${m[1]}`);
+  }
+
+  return sigs.slice(0, 25);
+}
+
+module.exports = { extract };

package/src/extractors/go.js

@@ -0,0 +1,61 @@
+'use strict';
+
+/**
+ * Extract signatures from Go source code.
+ * @param {string} src - Raw file content
+ * @returns {string[]} Array of signature strings
+ */
+function extract(src) {
+  if (!src || typeof src !== 'string') return [];
+  const sigs = [];
+
+  const stripped = src
+    .replace(/\/\/.*$/gm, '')
+    .replace(/\/\*[\s\S]*?\*\//g, '');
+
+  // Structs
+  for (const m of stripped.matchAll(/^type\s+(\w+)\s+struct\s*\{/gm)) {
+    sigs.push(`type ${m[1]} struct`);
+  }
+
+  // Interfaces
+  for (const m of stripped.matchAll(/^type\s+(\w+)\s+interface\s*\{/gm)) {
+    sigs.push(`type ${m[1]} interface`);
+    const block = extractBlock(stripped, m.index + m[0].length);
+    for (const method of extractInterfaceMethods(block)) sigs.push(`  ${method}`);
+  }
+
+  // Functions and methods
+  for (const m of stripped.matchAll(/^func\s+(?:\((\w+)\s+[\w*]+\)\s+)?(\w+)\s*\(([^)]*)\)(?:\s*[\w*()\[\],\s]+)?\s*\{/gm)) {
+    const receiver = m[1] ? `(${m[1]}) ` : '';
+    sigs.push(`func ${receiver}${m[2]}(${normalizeParams(m[3])})`);
+  }
+
+  return sigs.slice(0, 25);
+}
+
+function extractBlock(src, startIndex) {
+  let depth = 1, i = startIndex;
+  const end = Math.min(src.length, startIndex + 2000);
+  while (i < end && depth > 0) {
+    if (src[i] === '{') depth++;
+    else if (src[i] === '}') depth--;
+    i++;
+  }
+  return src.slice(startIndex, i - 1);
+}
+
+function extractInterfaceMethods(block) {
+  const methods = [];
+  for (const m of block.matchAll(/^\s+(\w+)\s*\(([^)]*)\)/gm)) {
+    methods.push(`${m[1]}(${normalizeParams(m[2])})`);
+  }
+  return methods.slice(0, 8);
+}
+
+function normalizeParams(params) {
+  if (!params) return '';
+  return params.trim().replace(/\s+/g, ' ');
+}
+
+module.exports = { extract };