@ngommans/codefocus 0.1.0

package/dist/cli.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var pkg = require2("../package.json");
+var COMMANDS = ["index", "query", "find", "graph", "map", "benchmark", "serve"];
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  const flags = {};
+  const positional = [];
+  let command = null;
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith("--")) {
+      const key = arg.slice(2);
+      const next = args[i + 1];
+      if (next && !next.startsWith("--")) {
+        flags[key] = next;
+        i++;
+      } else {
+        flags[key] = true;
+      }
+    } else if (!command && COMMANDS.includes(arg)) {
+      command = arg;
+    } else {
+      positional.push(arg);
+    }
+  }
+  return { command, positional, flags };
+}
+function printHelp() {
+  console.log(`codefocus v${pkg.version} \u2014 Smart code context aggregator
+
+Usage: codefocus <command> [options]
+
+Commands:
+  index   Index the codebase (AST parse, build graph, store in SQLite)
+  query   Search and return ranked, structured code context
+  find    Quick symbol lookup (no graph expansion)
+  graph   Show dependency graph for a file or symbol
+  map     High-level codebase overview (Aider-style repo map)
+  serve   Start MCP server (stdio transport, keeps DB warm)
+  benchmark  Benchmark codefocus vs. Explore agent pattern
+
+Options:
+  --help     Show this help message
+  --version  Show version number
+
+Examples:
+  npx codefocus index --root ./src
+  npx codefocus query "handleCalendarSync" --budget 8000
+  npx codefocus find "CalendarEvent" --kind type
+  npx codefocus graph src/services/calendar.ts
+  npx codefocus map --budget 2000`);
+}
+async function main() {
+  const { command, positional, flags } = parseArgs(process.argv);
+  if (flags.version) {
+    console.log(pkg.version);
+    return;
+  }
+  if (flags.help && !command) {
+    printHelp();
+    return;
+  }
+  if (!command) {
+    printHelp();
+    process.exitCode = 2;
+    return;
+  }
+  const handlers = {
+    index: async () => {
+      const { runIndex } = await import("./commands-ICBN54MT.js");
+      await runIndex(positional, flags);
+    },
+    query: async () => {
+      const { runQuery } = await import("./query-DJNWYYJD.js");
+      await runQuery(positional, flags);
+    },
+    find: async () => {
+      const { runFind } = await import("./find-W5UDE4US.js");
+      await runFind(positional, flags);
+    },
+    graph: async () => {
+      const { runGraph } = await import("./graph-DZNBEATA.js");
+      await runGraph(positional, flags);
+    },
+    map: async () => {
+      const { runMap } = await import("./map-6WOMDLCP.js");
+      await runMap(positional, flags);
+    },
+    serve: async () => {
+      const { runServe } = await import("./mcp-7WYTXIQS.js");
+      await runServe(positional, flags);
+    },
+    benchmark: async () => {
+      const { runBenchmarkCommand } = await import("./benchmark-43DOYNYR.js");
+      await runBenchmarkCommand(positional, flags);
+    }
+  };
+  try {
+    await handlers[command]();
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Error: ${message}`);
+    process.exitCode = 1;
+  }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\n\nconst require = createRequire(import.meta.url);\nconst pkg = require(\"../package.json\");\n\nconst COMMANDS = [\"index\", \"query\", \"find\", \"graph\", \"map\", \"benchmark\", \"serve\"] as const;\ntype Command = (typeof COMMANDS)[number];\n\ninterface ParsedArgs {\n  command: Command | null;\n  positional: string[];\n  flags: Record<string, string | boolean>;\n}\n\nfunction parseArgs(argv: string[]): ParsedArgs {\n  const args = argv.slice(2);\n  const flags: Record<string, string | boolean> = {};\n  const positional: string[] = [];\n  let command: Command | null = null;\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    if (arg.startsWith(\"--\")) {\n      const key = arg.slice(2);\n      const next = args[i + 1];\n      if (next && !next.startsWith(\"--\")) {\n        flags[key] = next;\n        i++;\n      } else {\n        flags[key] = true;\n      }\n    } else if (!command && COMMANDS.includes(arg as Command)) {\n      command = arg as Command;\n    } else {\n      positional.push(arg);\n    }\n  }\n\n  return { command, positional, flags };\n}\n\nfunction printHelp(): void {\n  console.log(`codefocus v${pkg.version} — Smart code context aggregator\n\nUsage: codefocus <command> [options]\n\nCommands:\n  index   Index the codebase (AST parse, build graph, store in SQLite)\n  query   Search and return ranked, structured code context\n  find    Quick symbol lookup (no graph expansion)\n  graph   Show dependency graph for a file or symbol\n  map     High-level codebase overview (Aider-style repo map)\n  serve   Start MCP server (stdio transport, keeps DB warm)\n  benchmark  Benchmark codefocus vs. Explore agent pattern\n\nOptions:\n  --help     Show this help message\n  --version  Show version number\n\nExamples:\n  npx codefocus index --root ./src\n  npx codefocus query \"handleCalendarSync\" --budget 8000\n  npx codefocus find \"CalendarEvent\" --kind type\n  npx codefocus graph src/services/calendar.ts\n  npx codefocus map --budget 2000`);\n}\n\nasync function main(): Promise<void> {\n  const { command, positional, flags } = parseArgs(process.argv);\n\n  if (flags.version) {\n    console.log(pkg.version);\n    return;\n  }\n\n  if (flags.help && !command) {\n    printHelp();\n    return;\n  }\n\n  if (!command) {\n    printHelp();\n    process.exitCode = 2;\n    return;\n  }\n\n  const handlers: Record<Command, () => Promise<void>> = {\n    index: async () => {\n      const { runIndex } = await import(\"./commands/index.js\");\n      await runIndex(positional, flags);\n    },\n    query: async () => {\n      const { runQuery } = await import(\"./commands/query.js\");\n      await runQuery(positional, flags);\n    },\n    find: async () => {\n      const { runFind } = await import(\"./commands/find.js\");\n      await runFind(positional, flags);\n    },\n    graph: async () => {\n      const { runGraph } = await import(\"./commands/graph.js\");\n      await runGraph(positional, flags);\n    },\n    map: async () => {\n      const { runMap } = await import(\"./commands/map.js\");\n      await runMap(positional, flags);\n    },\n    serve: async () => {\n      const { runServe } = await import(\"./mcp.js\");\n      await runServe(positional, flags);\n    },\n    benchmark: async () => {\n      const { runBenchmarkCommand } = await import(\"./benchmark.js\");\n      await runBenchmarkCommand(positional, flags);\n    },\n  };\n\n  try {\n    await handlers[command]();\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(`Error: ${message}`);\n    process.exitCode = 1;\n  }\n}\n\nmain();\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAE9B,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,MAAMA,SAAQ,iBAAiB;AAErC,IAAM,WAAW,CAAC,SAAS,SAAS,QAAQ,SAAS,OAAO,aAAa,OAAO;AAShF,SAAS,UAAU,MAA4B;AAC7C,QAAM,OAAO,KAAK,MAAM,CAAC;AACzB,QAAM,QAA0C,CAAC;AACjD,QAAM,aAAuB,CAAC;AAC9B,MAAI,UAA0B;AAE9B,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAClB,QAAI,IAAI,WAAW,IAAI,GAAG;AACxB,YAAM,MAAM,IAAI,MAAM,CAAC;AACvB,YAAM,OAAO,KAAK,IAAI,CAAC;AACvB,UAAI,QAAQ,CAAC,KAAK,WAAW,IAAI,GAAG;AAClC,cAAM,GAAG,IAAI;AACb;AAAA,MACF,OAAO;AACL,cAAM,GAAG,IAAI;AAAA,MACf;AAAA,IACF,WAAW,CAAC,WAAW,SAAS,SAAS,GAAc,GAAG;AACxD,gBAAU;AAAA,IACZ,OAAO;AACL,iBAAW,KAAK,GAAG;AAAA,IACrB;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,YAAY,MAAM;AACtC;AAEA,SAAS,YAAkB;AACzB,UAAQ,IAAI,cAAc,IAAI,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kCAsBL;AAClC;AAEA,eAAe,OAAsB;AACnC,QAAM,EAAE,SAAS,YAAY,MAAM,IAAI,UAAU,QAAQ,IAAI;AAE7D,MAAI,MAAM,SAAS;AACjB,YAAQ,IAAI,IAAI,OAAO;AACvB;AAAA,EACF;AAEA,MAAI,MAAM,QAAQ,CAAC,SAAS;AAC1B,cAAU;AACV;AAAA,EACF;AAEA,MAAI,CAAC,SAAS;AACZ,cAAU;AACV,YAAQ,WAAW;AACnB;AAAA,EACF;AAEA,QAAM,WAAiD;AAAA,IACrD,OAAO,YAAY;AACjB,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,wBAAqB;AACvD,YAAM,SAAS,YAAY,KAAK;AAAA,IAClC;AAAA,IACA,OAAO,YAAY;AACjB,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,qBAAqB;AACvD,YAAM,SAAS,YAAY,KAAK;AAAA,IAClC;AAAA,IACA,MAAM,YAAY;AAChB,YAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,oBAAoB;AACrD,YAAM,QAAQ,YAAY,KAAK;AAAA,IACjC;AAAA,IACA,OAAO,YAAY;AACjB,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,qBAAqB;AACvD,YAAM,SAAS,YAAY,KAAK;AAAA,IAClC;AAAA,IACA,KAAK,YAAY;AACf,YAAM,EAAE,OAAO,IAAI,MAAM,OAAO,mBAAmB;AACnD,YAAM,OAAO,YAAY,KAAK;AAAA,IAChC;AAAA,IACA,OAAO,YAAY;AACjB,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,mBAAU;AAC5C,YAAM,SAAS,YAAY,KAAK;AAAA,IAClC;AAAA,IACA,WAAW,YAAY;AACrB,YAAM,EAAE,oBAAoB,IAAI,MAAM,OAAO,yBAAgB;AAC7D,YAAM,oBAAoB,YAAY,KAAK;AAAA,IAC7C;AAAA,EACF;AAEA,MAAI;AACF,UAAM,SAAS,OAAO,EAAE;AAAA,EAC1B,SAAS,KAAK;AACZ,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,YAAQ,MAAM,UAAU,OAAO,EAAE;AACjC,YAAQ,WAAW;AAAA,EACrB;AACF;AAEA,KAAK;","names":["require"]}

package/dist/commands-ICBN54MT.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import {
+  indexProject
+} from "./chunk-X7DRJUEX.js";
+import {
+  resolveRoot
+} from "./chunk-7RYHZOYF.js";
+import "./chunk-Q6DOBQ4F.js";
+
+// src/commands/index.ts
+import { resolve } from "path";
+async function runIndex(positional, flags) {
+  if (flags.help) {
+    console.log(`codefocus index \u2014 Index the codebase
+
+Usage: codefocus index [options]
+
+Options:
+  --root <path>   Root directory to index (default: .)
+  --lang <lang>   Language to parse (default: typescript)
+  --watch         Watch for file changes and re-index automatically
+  --help          Show this help message`);
+    return;
+  }
+  const root = resolveRoot(flags.root);
+  const dbPath = resolve(root, ".codefocus", "index.db");
+  console.log(`[codefocus] Indexing ${root} ...`);
+  const stats = await indexProject(root, dbPath);
+  console.log(`[codefocus] Index complete`);
+  console.log(`  files indexed: ${stats.filesIndexed}`);
+  console.log(`  files skipped: ${stats.filesSkipped}`);
+  console.log(`  symbols:       ${stats.symbolsExtracted}`);
+  console.log(`  imports:       ${stats.importsFound}`);
+  console.log(`  references:    ${stats.referencesCreated}`);
+  console.log(`  time:          ${stats.timeMs}ms`);
+  console.log(`  database:      ${dbPath}`);
+  if (flags.watch) {
+    const { startWatcher } = await import("./watcher-LFBZAM5E.js");
+    console.log(`[codefocus] Watching for changes in ${root} ...`);
+    console.log(`[codefocus] Press Ctrl+C to stop`);
+    const watcher = await startWatcher({
+      rootDir: root,
+      dbPath,
+      onReindex: (reindexStats) => {
+        if (reindexStats.filesIndexed > 0) {
+          console.log(
+            `[watch] Re-indexed: ${reindexStats.filesIndexed} files, ${reindexStats.symbolsExtracted} symbols, ${reindexStats.referencesCreated} refs (${reindexStats.timeMs}ms)`
+          );
+        }
+      }
+    });
+    process.on("SIGINT", () => {
+      console.log("\n[codefocus] Stopping watcher...");
+      watcher.close();
+      process.exit(0);
+    });
+    await new Promise(() => {
+    });
+  }
+}
+export {
+  runIndex
+};
+//# sourceMappingURL=commands-ICBN54MT.js.map

package/dist/commands-ICBN54MT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/index.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { indexProject } from \"../indexer.js\";\nimport { resolveRoot } from \"../root.js\";\n\nexport async function runIndex(\n  positional: string[],\n  flags: Record<string, string | boolean>,\n): Promise<void> {\n  if (flags.help) {\n    console.log(`codefocus index — Index the codebase\n\nUsage: codefocus index [options]\n\nOptions:\n  --root <path>   Root directory to index (default: .)\n  --lang <lang>   Language to parse (default: typescript)\n  --watch         Watch for file changes and re-index automatically\n  --help          Show this help message`);\n    return;\n  }\n\n  const root = resolveRoot(flags.root);\n  const dbPath = resolve(root, \".codefocus\", \"index.db\");\n\n  console.log(`[codefocus] Indexing ${root} ...`);\n\n  const stats = await indexProject(root, dbPath);\n\n  console.log(`[codefocus] Index complete`);\n  console.log(`  files indexed: ${stats.filesIndexed}`);\n  console.log(`  files skipped: ${stats.filesSkipped}`);\n  console.log(`  symbols:       ${stats.symbolsExtracted}`);\n  console.log(`  imports:       ${stats.importsFound}`);\n  console.log(`  references:    ${stats.referencesCreated}`);\n  console.log(`  time:          ${stats.timeMs}ms`);\n  console.log(`  database:      ${dbPath}`);\n\n  if (flags.watch) {\n    const { startWatcher } = await import(\"../watcher.js\");\n\n    console.log(`[codefocus] Watching for changes in ${root} ...`);\n    console.log(`[codefocus] Press Ctrl+C to stop`);\n\n    const watcher = await startWatcher({\n      rootDir: root,\n      dbPath,\n      onReindex: (reindexStats) => {\n        if (reindexStats.filesIndexed > 0) {\n          console.log(\n            `[watch] Re-indexed: ${reindexStats.filesIndexed} files, ` +\n              `${reindexStats.symbolsExtracted} symbols, ` +\n              `${reindexStats.referencesCreated} refs (${reindexStats.timeMs}ms)`,\n          );\n        }\n      },\n    });\n\n    // Keep process alive, clean up on exit\n    process.on(\"SIGINT\", () => {\n      console.log(\"\\n[codefocus] Stopping watcher...\");\n      watcher.close();\n      process.exit(0);\n    });\n\n    // Return a never-resolving promise to keep the process alive\n    await new Promise(() => {});\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA,SAAS,eAAe;AAIxB,eAAsB,SACpB,YACA,OACe;AACf,MAAI,MAAM,MAAM;AACd,YAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yCAQyB;AACrC;AAAA,EACF;AAEA,QAAM,OAAO,YAAY,MAAM,IAAI;AACnC,QAAM,SAAS,QAAQ,MAAM,cAAc,UAAU;AAErD,UAAQ,IAAI,wBAAwB,IAAI,MAAM;AAE9C,QAAM,QAAQ,MAAM,aAAa,MAAM,MAAM;AAE7C,UAAQ,IAAI,4BAA4B;AACxC,UAAQ,IAAI,oBAAoB,MAAM,YAAY,EAAE;AACpD,UAAQ,IAAI,oBAAoB,MAAM,YAAY,EAAE;AACpD,UAAQ,IAAI,oBAAoB,MAAM,gBAAgB,EAAE;AACxD,UAAQ,IAAI,oBAAoB,MAAM,YAAY,EAAE;AACpD,UAAQ,IAAI,oBAAoB,MAAM,iBAAiB,EAAE;AACzD,UAAQ,IAAI,oBAAoB,MAAM,MAAM,IAAI;AAChD,UAAQ,IAAI,oBAAoB,MAAM,EAAE;AAExC,MAAI,MAAM,OAAO;AACf,UAAM,EAAE,aAAa,IAAI,MAAM,OAAO,uBAAe;AAErD,YAAQ,IAAI,uCAAuC,IAAI,MAAM;AAC7D,YAAQ,IAAI,kCAAkC;AAE9C,UAAM,UAAU,MAAM,aAAa;AAAA,MACjC,SAAS;AAAA,MACT;AAAA,MACA,WAAW,CAAC,iBAAiB;AAC3B,YAAI,aAAa,eAAe,GAAG;AACjC,kBAAQ;AAAA,YACN,uBAAuB,aAAa,YAAY,WAC3C,aAAa,gBAAgB,aAC7B,aAAa,iBAAiB,UAAU,aAAa,MAAM;AAAA,UAClE;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAGD,YAAQ,GAAG,UAAU,MAAM;AACzB,cAAQ,IAAI,mCAAmC;AAC/C,cAAQ,MAAM;AACd,cAAQ,KAAK,CAAC;AAAA,IAChB,CAAC;AAGD,UAAM,IAAI,QAAQ,MAAM;AAAA,IAAC,CAAC;AAAA,EAC5B;AACF;","names":[]}

package/dist/config-OCBWYENF.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  DEFAULT_SCORING_CONFIG,
+  loadScoringConfig,
+  serializeConfig
+} from "./chunk-6XH2ZLP6.js";
+export {
+  DEFAULT_SCORING_CONFIG,
+  loadScoringConfig,
+  serializeConfig
+};
+//# sourceMappingURL=config-OCBWYENF.js.map

package/dist/config-OCBWYENF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/extended-benchmark-5RUXDG3D.js

@@ -0,0 +1,323 @@
+#!/usr/bin/env node
+import {
+  loadScoringConfig,
+  serializeConfig
+} from "./chunk-6XH2ZLP6.js";
+
+// src/extended-benchmark.ts
+import { createRequire } from "module";
+import { execFileSync } from "child_process";
+import { readFileSync, existsSync, rmSync } from "fs";
+import { resolve } from "path";
+var require2 = createRequire(import.meta.url);
+var { getEncoding } = require2("js-tiktoken");
+function discoverSuites(projectRoot) {
+  const suites = [];
+  const fastGlobRoot = resolve(
+    projectRoot,
+    "node_modules/fast-glob/out"
+  );
+  if (existsSync(fastGlobRoot)) {
+    suites.push({
+      id: "fast-glob",
+      name: "fast-glob",
+      rootDir: fastGlobRoot,
+      tasks: [
+        {
+          id: "fg-pattern-matching",
+          question: "How does fast-glob match file patterns?",
+          queryTerm: "pattern",
+          expectedPatterns: ["pattern"],
+          searchTerms: ["pattern", "match", "glob"]
+        },
+        {
+          id: "fg-sync-reader",
+          question: "How does the synchronous file reader work?",
+          queryTerm: "sync",
+          expectedPatterns: ["sync"],
+          searchTerms: ["sync", "read"]
+        },
+        {
+          id: "fg-entry-filter",
+          question: "How are file entries filtered?",
+          queryTerm: "filter",
+          expectedPatterns: ["filter"],
+          searchTerms: ["filter", "entry"]
+        },
+        {
+          id: "fg-stream-api",
+          question: "How does the streaming API work?",
+          queryTerm: "stream",
+          expectedPatterns: ["stream"],
+          searchTerms: ["stream", "readable"]
+        }
+      ]
+    });
+  }
+  const chokidarRoot = resolve(
+    projectRoot,
+    "node_modules/chokidar"
+  );
+  if (existsSync(chokidarRoot) && existsSync(resolve(chokidarRoot, "handler.js"))) {
+    suites.push({
+      id: "chokidar",
+      name: "chokidar",
+      rootDir: chokidarRoot,
+      tasks: [
+        {
+          id: "chokidar-watch",
+          question: "How does chokidar watch files?",
+          queryTerm: "watch",
+          expectedPatterns: ["index"],
+          searchTerms: ["watch", "FSWatcher"]
+        },
+        {
+          id: "chokidar-handler",
+          question: "How does chokidar handle file system events?",
+          queryTerm: "handler",
+          expectedPatterns: ["handler"],
+          searchTerms: ["handler", "event", "change"]
+        }
+      ]
+    });
+  }
+  return suites;
+}
+function simulateExploreForSuite(rootDir, task) {
+  const enc = getEncoding("cl100k_base");
+  const matchedFiles = /* @__PURE__ */ new Set();
+  for (const term of task.searchTerms) {
+    try {
+      const grepResult = execFileSync(
+        "grep",
+        ["-rl", "--include=*.js", "--include=*.ts", term, rootDir],
+        { encoding: "utf-8", timeout: 1e4 }
+      );
+      for (const line of grepResult.trim().split("\n")) {
+        if (line) matchedFiles.add(line);
+      }
+    } catch {
+    }
+  }
+  let totalTokens = 0;
+  for (const filePath of matchedFiles) {
+    try {
+      const content = readFileSync(filePath, "utf-8");
+      totalTokens += enc.encode(content).length;
+    } catch {
+    }
+  }
+  return totalTokens;
+}
+function runCodefocusQueryForSuite(rootDir, cliPath, task) {
+  let stdout;
+  try {
+    stdout = execFileSync(
+      "node",
+      [cliPath, "query", task.queryTerm, "--root", rootDir, "--budget", "8000"],
+      { encoding: "utf-8", timeout: 3e4 }
+    );
+  } catch (err) {
+    stdout = (err.stdout || "") + (err.stderr || "");
+  }
+  const tokenMatch = stdout.match(/~(\d+) tokens/);
+  const tokensOutput = tokenMatch ? parseInt(tokenMatch[1], 10) : 0;
+  const fileMatches = stdout.matchAll(/── ([\w/.\-@]+\.[jt]sx?):\d+-\d+/g);
+  const filesReturned = [...fileMatches].map((m) => m[1]);
+  return { tokensOutput, filesReturned };
+}
+function runExtendedBenchmark(projectRoot, cliPath, suites) {
+  const config = loadScoringConfig(projectRoot);
+  const resolvedSuites = suites ?? discoverSuites(projectRoot);
+  const suiteResults = [];
+  for (const suite of resolvedSuites) {
+    let indexStdout;
+    try {
+      indexStdout = execFileSync(
+        "node",
+        [cliPath, "index", "--root", suite.rootDir],
+        { encoding: "utf-8", timeout: 6e4 }
+      );
+    } catch (err) {
+      indexStdout = (err.stdout || "") + (err.stderr || "");
+    }
+    const filesMatch = indexStdout.match(/files indexed:\s*(\d+)/);
+    const symbolsMatch = indexStdout.match(/symbols:\s+(\d+)/);
+    const filesIndexed = filesMatch ? parseInt(filesMatch[1], 10) : 0;
+    const symbolsExtracted = symbolsMatch ? parseInt(symbolsMatch[1], 10) : 0;
+    const skippedMatch = indexStdout.match(/files skipped:\s*(\d+)/);
+    const totalFiles = filesIndexed + (skippedMatch ? parseInt(skippedMatch[1], 10) : 0);
+    const taskResults = [];
+    for (const task of suite.tasks) {
+      const exploreTokens = simulateExploreForSuite(suite.rootDir, task);
+      const { tokensOutput, filesReturned } = runCodefocusQueryForSuite(
+        suite.rootDir,
+        cliPath,
+        task
+      );
+      let patternHits = 0;
+      for (const pattern of task.expectedPatterns) {
+        const hasMatch = filesReturned.some(
+          (f) => f.toLowerCase().includes(pattern.toLowerCase())
+        );
+        if (hasMatch) patternHits++;
+      }
+      taskResults.push({
+        task,
+        filesReturned,
+        tokensOutput,
+        exploreTokens,
+        patternHits,
+        patternTotal: task.expectedPatterns.length,
+        patternRecall: task.expectedPatterns.length > 0 ? patternHits / task.expectedPatterns.length : 1,
+        tokenSavingsRatio: tokensOutput > 0 ? exploreTokens / tokensOutput : 0,
+        hasResults: filesReturned.length > 0,
+        filesIndexed: totalFiles
+      });
+    }
+    const avg2 = (arr) => arr.length > 0 ? arr.reduce((a, b) => a + b, 0) / arr.length : 0;
+    suiteResults.push({
+      suite,
+      filesIndexed: totalFiles,
+      symbolsExtracted,
+      tasks: taskResults,
+      avgPatternRecall: avg2(taskResults.map((t) => t.patternRecall)),
+      avgTokenSavingsRatio: avg2(taskResults.map((t) => t.tokenSavingsRatio)),
+      avgTokensOutput: avg2(taskResults.map((t) => t.tokensOutput))
+    });
+    const dbDir = resolve(suite.rootDir, ".codefocus");
+    if (existsSync(dbDir)) {
+      try {
+        rmSync(dbDir, { recursive: true });
+      } catch {
+      }
+    }
+  }
+  const allTasks = suiteResults.flatMap((s) => s.tasks);
+  const avg = (arr) => arr.length > 0 ? arr.reduce((a, b) => a + b, 0) / arr.length : 0;
+  return {
+    suites: suiteResults,
+    config,
+    aggregate: {
+      totalSuites: suiteResults.length,
+      totalTasks: allTasks.length,
+      avgPatternRecall: avg(allTasks.map((t) => t.patternRecall)),
+      avgTokenSavingsRatio: avg(allTasks.map((t) => t.tokenSavingsRatio)),
+      avgTokensOutput: avg(allTasks.map((t) => t.tokensOutput)),
+      emptyResultCount: allTasks.filter((t) => !t.hasResults).length
+    }
+  };
+}
+function pct(n) {
+  return `${Math.round(n * 100)}%`;
+}
+function formatExtendedResults(results) {
+  const lines = [];
+  lines.push("# codefocus Extended Benchmark \u2014 Spike 9");
+  lines.push("");
+  lines.push(
+    "Cross-codebase validation of scoring parameters against dependency libraries."
+  );
+  lines.push(`Benchmark run: ${(/* @__PURE__ */ new Date()).toISOString()}`);
+  lines.push("");
+  lines.push("## Aggregate Summary");
+  lines.push("");
+  lines.push(`| Metric | Value |`);
+  lines.push(`|--------|------:|`);
+  lines.push(
+    `| Libraries tested | ${results.aggregate.totalSuites} |`
+  );
+  lines.push(`| Total tasks | ${results.aggregate.totalTasks} |`);
+  lines.push(
+    `| Avg pattern recall | ${pct(results.aggregate.avgPatternRecall)} |`
+  );
+  lines.push(
+    `| Avg token savings | ${results.aggregate.avgTokenSavingsRatio.toFixed(1)}x |`
+  );
+  lines.push(
+    `| Avg tokens output | ${Math.round(results.aggregate.avgTokensOutput)} |`
+  );
+  lines.push(
+    `| Empty results | ${results.aggregate.emptyResultCount}/${results.aggregate.totalTasks} |`
+  );
+  lines.push("");
+  for (const suite of results.suites) {
+    lines.push(`## ${suite.suite.name}`);
+    lines.push("");
+    lines.push(
+      `Indexed: ${suite.filesIndexed} files, ${suite.symbolsExtracted} symbols`
+    );
+    lines.push("");
+    lines.push(
+      "| Task | CF tokens | Explore tokens | Savings | Pattern recall | Files returned |"
+    );
+    lines.push(
+      "|------|----------:|---------------:|--------:|---------------:|---------------:|"
+    );
+    for (const t of suite.tasks) {
+      const savings = t.tokenSavingsRatio > 0 ? t.tokenSavingsRatio.toFixed(1) + "x" : "\u2014";
+      lines.push(
+        `| ${t.task.id} | ${t.tokensOutput} | ${t.exploreTokens} | ${savings} | ${pct(t.patternRecall)} | ${t.filesReturned.length} |`
+      );
+    }
+    lines.push("");
+    lines.push(
+      `**Suite averages:** pattern recall=${pct(suite.avgPatternRecall)}, savings=${suite.avgTokenSavingsRatio.toFixed(1)}x, tokens=${Math.round(suite.avgTokensOutput)}`
+    );
+    lines.push("");
+  }
+  lines.push("## Active Scoring Config");
+  lines.push("");
+  lines.push("```json");
+  lines.push(serializeConfig(results.config));
+  lines.push("```");
+  lines.push("");
+  lines.push("## Overfitting Analysis");
+  lines.push("");
+  const recall = results.aggregate.avgPatternRecall;
+  if (recall >= 0.7) {
+    lines.push(
+      `Pattern recall ${pct(recall)} across ${results.aggregate.totalTasks} cross-codebase tasks suggests scoring parameters generalize well.`
+    );
+  } else if (recall >= 0.4) {
+    lines.push(
+      `Pattern recall ${pct(recall)} across ${results.aggregate.totalTasks} cross-codebase tasks is moderate \u2014 scoring parameters may need calibration for larger codebases.`
+    );
+    lines.push("");
+    lines.push("Parameters most likely to need adjustment:");
+    lines.push(
+      `- \`scoreFloorRatio\` (${results.config.scoreFloorRatio}) \u2014 may over-prune in larger codebases`
+    );
+    lines.push(
+      `- \`elbowDropRatio\` (${results.config.elbowDropRatio}) \u2014 may cut too aggressively`
+    );
+  } else {
+    lines.push(
+      `Pattern recall ${pct(recall)} across ${results.aggregate.totalTasks} cross-codebase tasks indicates likely overfitting to the original 16-file codebase.`
+    );
+    lines.push("");
+    lines.push("**Recommended actions:**");
+    lines.push(
+      "- Lower `scoreFloorRatio` (try 0.10-0.15) to retain more results"
+    );
+    lines.push(
+      "- Raise `elbowDropRatio` (try 0.70-0.80) to be less aggressive"
+    );
+    lines.push(
+      "- Lower `minMarginalValue` (try 0.00001) to include more sections"
+    );
+  }
+  if (results.aggregate.emptyResultCount > 0) {
+    lines.push("");
+    lines.push(
+      `**Warning:** ${results.aggregate.emptyResultCount} tasks returned zero results. This may indicate FTS5 indexing gaps or overly aggressive filtering.`
+    );
+  }
+  return lines.join("\n");
+}
+export {
+  discoverSuites,
+  formatExtendedResults,
+  runExtendedBenchmark
+};
+//# sourceMappingURL=extended-benchmark-5RUXDG3D.js.map

package/dist/extended-benchmark-5RUXDG3D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extended-benchmark.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport { execFileSync } from \"node:child_process\";\nimport { readFileSync, existsSync, mkdirSync, rmSync } from \"node:fs\";\nimport { resolve, relative } from \"node:path\";\nimport {\n  loadScoringConfig,\n  serializeConfig,\n  type ScoringConfig,\n} from \"./config.js\";\n\nconst require = createRequire(import.meta.url);\nconst { getEncoding } = require(\"js-tiktoken\");\n\n// ── types ───────────────────────────────────────────────────────────────\n\nexport interface ExtendedTask {\n  id: string;\n  question: string;\n  queryTerm: string;\n  /** Substring patterns that should appear in returned file paths */\n  expectedPatterns: string[];\n  /** Search terms for explore simulation */\n  searchTerms: string[];\n}\n\nexport interface ExtendedSuite {\n  id: string;\n  name: string;\n  /** Absolute path to root directory of the library to index */\n  rootDir: string;\n  tasks: ExtendedTask[];\n}\n\ninterface ExtendedTaskResult {\n  task: ExtendedTask;\n  /** Files returned by codefocus query */\n  filesReturned: string[];\n  /** Tokens output by codefocus query */\n  tokensOutput: number;\n  /** Tokens consumed by explore simulation */\n  exploreTokens: number;\n  /** How many expectedPatterns matched at least one returned file */\n  patternHits: number;\n  /** Total expectedPatterns */\n  patternTotal: number;\n  /** Pattern hit rate (patternHits / patternTotal) */\n  patternRecall: number;\n  /** Token savings ratio */\n  tokenSavingsRatio: number;\n  /** Whether the query returned any results */\n  hasResults: boolean;\n  /** Number of files indexed for this suite */\n  filesIndexed: number;\n}\n\nexport interface ExtendedSuiteResult {\n  suite: ExtendedSuite;\n  filesIndexed: number;\n  symbolsExtracted: number;\n  tasks: ExtendedTaskResult[];\n  avgPatternRecall: number;\n  avgTokenSavingsRatio: number;\n  avgTokensOutput: number;\n}\n\nexport interface ExtendedBenchmarkResults {\n  suites: ExtendedSuiteResult[];\n  config: ScoringConfig;\n  aggregate: {\n    totalSuites: number;\n    totalTasks: number;\n    avgPatternRecall: number;\n    avgTokenSavingsRatio: number;\n    avgTokensOutput: number;\n    /** Tasks that returned zero results */\n    emptyResultCount: number;\n  };\n}\n\n// ── suite definitions ────────────────────────────────────────────────────\n\n/**\n * Discover available benchmark suites from installed dependencies.\n * Returns only suites whose source directories exist.\n */\nexport function discoverSuites(projectRoot: string): ExtendedSuite[] {\n  const suites: ExtendedSuite[] = [];\n\n  // fast-glob: compiled JS in out/ directory\n  const fastGlobRoot = resolve(\n    projectRoot,\n    \"node_modules/fast-glob/out\",\n  );\n  if (existsSync(fastGlobRoot)) {\n    suites.push({\n      id: \"fast-glob\",\n      name: \"fast-glob\",\n      rootDir: fastGlobRoot,\n      tasks: [\n        {\n          id: \"fg-pattern-matching\",\n          question: \"How does fast-glob match file patterns?\",\n          queryTerm: \"pattern\",\n          expectedPatterns: [\"pattern\"],\n          searchTerms: [\"pattern\", \"match\", \"glob\"],\n        },\n        {\n          id: \"fg-sync-reader\",\n          question: \"How does the synchronous file reader work?\",\n          queryTerm: \"sync\",\n          expectedPatterns: [\"sync\"],\n          searchTerms: [\"sync\", \"read\"],\n        },\n        {\n          id: \"fg-entry-filter\",\n          question: \"How are file entries filtered?\",\n          queryTerm: \"filter\",\n          expectedPatterns: [\"filter\"],\n          searchTerms: [\"filter\", \"entry\"],\n        },\n        {\n          id: \"fg-stream-api\",\n          question: \"How does the streaming API work?\",\n          queryTerm: \"stream\",\n          expectedPatterns: [\"stream\"],\n          searchTerms: [\"stream\", \"readable\"],\n        },\n      ],\n    });\n  }\n\n  // chokidar: small but high symbol density (2 files, ~100 symbols)\n  const chokidarRoot = resolve(\n    projectRoot,\n    \"node_modules/chokidar\",\n  );\n  if (\n    existsSync(chokidarRoot) &&\n    existsSync(resolve(chokidarRoot, \"handler.js\"))\n  ) {\n    suites.push({\n      id: \"chokidar\",\n      name: \"chokidar\",\n      rootDir: chokidarRoot,\n      tasks: [\n        {\n          id: \"chokidar-watch\",\n          question: \"How does chokidar watch files?\",\n          queryTerm: \"watch\",\n          expectedPatterns: [\"index\"],\n          searchTerms: [\"watch\", \"FSWatcher\"],\n        },\n        {\n          id: \"chokidar-handler\",\n          question: \"How does chokidar handle file system events?\",\n          queryTerm: \"handler\",\n          expectedPatterns: [\"handler\"],\n          searchTerms: [\"handler\", \"event\", \"change\"],\n        },\n      ],\n    });\n  }\n\n  return suites;\n}\n\n// ── explore simulation ──────────────────────────────────────────────────\n\nfunction simulateExploreForSuite(\n  rootDir: string,\n  task: ExtendedTask,\n): number {\n  const enc = getEncoding(\"cl100k_base\");\n  const matchedFiles = new Set<string>();\n\n  for (const term of task.searchTerms) {\n    try {\n      const grepResult = execFileSync(\n        \"grep\",\n        [\"-rl\", \"--include=*.js\", \"--include=*.ts\", term, rootDir],\n        { encoding: \"utf-8\", timeout: 10_000 },\n      );\n      for (const line of grepResult.trim().split(\"\\n\")) {\n        if (line) matchedFiles.add(line);\n      }\n    } catch {\n      // grep exit 1 = no matches\n    }\n  }\n\n  let totalTokens = 0;\n  for (const filePath of matchedFiles) {\n    try {\n      const content = readFileSync(filePath, \"utf-8\");\n      totalTokens += enc.encode(content).length;\n    } catch {\n      // skip\n    }\n  }\n\n  return totalTokens;\n}\n\n// ── codefocus query runner ──────────────────────────────────────────────\n\nfunction runCodefocusQueryForSuite(\n  rootDir: string,\n  cliPath: string,\n  task: ExtendedTask,\n): { tokensOutput: number; filesReturned: string[] } {\n  let stdout: string;\n  try {\n    stdout = execFileSync(\n      \"node\",\n      [cliPath, \"query\", task.queryTerm, \"--root\", rootDir, \"--budget\", \"8000\"],\n      { encoding: \"utf-8\", timeout: 30_000 },\n    );\n  } catch (err: any) {\n    stdout = (err.stdout || \"\") + (err.stderr || \"\");\n  }\n\n  const tokenMatch = stdout.match(/~(\\d+) tokens/);\n  const tokensOutput = tokenMatch ? parseInt(tokenMatch[1], 10) : 0;\n\n  const fileMatches = stdout.matchAll(/── ([\\w/.\\-@]+\\.[jt]sx?):\\d+-\\d+/g);\n  const filesReturned = [...fileMatches].map((m) => m[1]);\n\n  return { tokensOutput, filesReturned };\n}\n\n// ── main ────────────────────────────────────────────────────────────────\n\nexport function runExtendedBenchmark(\n  projectRoot: string,\n  cliPath: string,\n  suites?: ExtendedSuite[],\n): ExtendedBenchmarkResults {\n  const config = loadScoringConfig(projectRoot);\n  const resolvedSuites = suites ?? discoverSuites(projectRoot);\n  const suiteResults: ExtendedSuiteResult[] = [];\n\n  for (const suite of resolvedSuites) {\n    // Index the library\n    let indexStdout: string;\n    try {\n      indexStdout = execFileSync(\n        \"node\",\n        [cliPath, \"index\", \"--root\", suite.rootDir],\n        { encoding: \"utf-8\", timeout: 60_000 },\n      );\n    } catch (err: any) {\n      indexStdout = (err.stdout || \"\") + (err.stderr || \"\");\n    }\n\n    const filesMatch = indexStdout.match(/files indexed:\\s*(\\d+)/);\n    const symbolsMatch = indexStdout.match(/symbols:\\s+(\\d+)/);\n    const filesIndexed = filesMatch ? parseInt(filesMatch[1], 10) : 0;\n    const symbolsExtracted = symbolsMatch ? parseInt(symbolsMatch[1], 10) : 0;\n\n    // Also count skipped files as indexed (they were indexed in a prior run)\n    const skippedMatch = indexStdout.match(/files skipped:\\s*(\\d+)/);\n    const totalFiles =\n      filesIndexed + (skippedMatch ? parseInt(skippedMatch[1], 10) : 0);\n\n    const taskResults: ExtendedTaskResult[] = [];\n\n    for (const task of suite.tasks) {\n      const exploreTokens = simulateExploreForSuite(suite.rootDir, task);\n      const { tokensOutput, filesReturned } = runCodefocusQueryForSuite(\n        suite.rootDir,\n        cliPath,\n        task,\n      );\n\n      // Check pattern matches — each expectedPattern should match at least one file\n      let patternHits = 0;\n      for (const pattern of task.expectedPatterns) {\n        const hasMatch = filesReturned.some((f) =>\n          f.toLowerCase().includes(pattern.toLowerCase()),\n        );\n        if (hasMatch) patternHits++;\n      }\n\n      taskResults.push({\n        task,\n        filesReturned,\n        tokensOutput,\n        exploreTokens,\n        patternHits,\n        patternTotal: task.expectedPatterns.length,\n        patternRecall:\n          task.expectedPatterns.length > 0\n            ? patternHits / task.expectedPatterns.length\n            : 1,\n        tokenSavingsRatio:\n          tokensOutput > 0 ? exploreTokens / tokensOutput : 0,\n        hasResults: filesReturned.length > 0,\n        filesIndexed: totalFiles,\n      });\n    }\n\n    const avg = (arr: number[]) =>\n      arr.length > 0 ? arr.reduce((a, b) => a + b, 0) / arr.length : 0;\n\n    suiteResults.push({\n      suite,\n      filesIndexed: totalFiles,\n      symbolsExtracted,\n      tasks: taskResults,\n      avgPatternRecall: avg(taskResults.map((t) => t.patternRecall)),\n      avgTokenSavingsRatio: avg(taskResults.map((t) => t.tokenSavingsRatio)),\n      avgTokensOutput: avg(taskResults.map((t) => t.tokensOutput)),\n    });\n\n    // Clean up the index for this library\n    const dbDir = resolve(suite.rootDir, \".codefocus\");\n    if (existsSync(dbDir)) {\n      try {\n        rmSync(dbDir, { recursive: true });\n      } catch {\n        // ignore cleanup failures\n      }\n    }\n  }\n\n  // Aggregate results\n  const allTasks = suiteResults.flatMap((s) => s.tasks);\n  const avg = (arr: number[]) =>\n    arr.length > 0 ? arr.reduce((a, b) => a + b, 0) / arr.length : 0;\n\n  return {\n    suites: suiteResults,\n    config,\n    aggregate: {\n      totalSuites: suiteResults.length,\n      totalTasks: allTasks.length,\n      avgPatternRecall: avg(allTasks.map((t) => t.patternRecall)),\n      avgTokenSavingsRatio: avg(allTasks.map((t) => t.tokenSavingsRatio)),\n      avgTokensOutput: avg(allTasks.map((t) => t.tokensOutput)),\n      emptyResultCount: allTasks.filter((t) => !t.hasResults).length,\n    },\n  };\n}\n\n// ── formatting ──────────────────────────────────────────────────────────\n\nfunction pct(n: number): string {\n  return `${Math.round(n * 100)}%`;\n}\n\nexport function formatExtendedResults(\n  results: ExtendedBenchmarkResults,\n): string {\n  const lines: string[] = [];\n\n  lines.push(\"# codefocus Extended Benchmark — Spike 9\");\n  lines.push(\"\");\n  lines.push(\n    \"Cross-codebase validation of scoring parameters against dependency libraries.\",\n  );\n  lines.push(`Benchmark run: ${new Date().toISOString()}`);\n  lines.push(\"\");\n\n  // ── aggregate summary ──────────────────────────────────────────────\n\n  lines.push(\"## Aggregate Summary\");\n  lines.push(\"\");\n  lines.push(`| Metric | Value |`);\n  lines.push(`|--------|------:|`);\n  lines.push(\n    `| Libraries tested | ${results.aggregate.totalSuites} |`,\n  );\n  lines.push(`| Total tasks | ${results.aggregate.totalTasks} |`);\n  lines.push(\n    `| Avg pattern recall | ${pct(results.aggregate.avgPatternRecall)} |`,\n  );\n  lines.push(\n    `| Avg token savings | ${results.aggregate.avgTokenSavingsRatio.toFixed(1)}x |`,\n  );\n  lines.push(\n    `| Avg tokens output | ${Math.round(results.aggregate.avgTokensOutput)} |`,\n  );\n  lines.push(\n    `| Empty results | ${results.aggregate.emptyResultCount}/${results.aggregate.totalTasks} |`,\n  );\n  lines.push(\"\");\n\n  // ── per-suite results ──────────────────────────────────────────────\n\n  for (const suite of results.suites) {\n    lines.push(`## ${suite.suite.name}`);\n    lines.push(\"\");\n    lines.push(\n      `Indexed: ${suite.filesIndexed} files, ${suite.symbolsExtracted} symbols`,\n    );\n    lines.push(\"\");\n    lines.push(\n      \"| Task | CF tokens | Explore tokens | Savings | Pattern recall | Files returned |\",\n    );\n    lines.push(\n      \"|------|----------:|---------------:|--------:|---------------:|---------------:|\",\n    );\n\n    for (const t of suite.tasks) {\n      const savings =\n        t.tokenSavingsRatio > 0\n          ? t.tokenSavingsRatio.toFixed(1) + \"x\"\n          : \"—\";\n      lines.push(\n        `| ${t.task.id} | ${t.tokensOutput} | ${t.exploreTokens} | ${savings} | ${pct(t.patternRecall)} | ${t.filesReturned.length} |`,\n      );\n    }\n\n    lines.push(\"\");\n    lines.push(\n      `**Suite averages:** pattern recall=${pct(suite.avgPatternRecall)}, ` +\n        `savings=${suite.avgTokenSavingsRatio.toFixed(1)}x, ` +\n        `tokens=${Math.round(suite.avgTokensOutput)}`,\n    );\n    lines.push(\"\");\n  }\n\n  // ── scoring config ─────────────────────────────────────────────────\n\n  lines.push(\"## Active Scoring Config\");\n  lines.push(\"\");\n  lines.push(\"```json\");\n  lines.push(serializeConfig(results.config));\n  lines.push(\"```\");\n  lines.push(\"\");\n\n  // ── overfitting analysis ───────────────────────────────────────────\n\n  lines.push(\"## Overfitting Analysis\");\n  lines.push(\"\");\n\n  const recall = results.aggregate.avgPatternRecall;\n  if (recall >= 0.7) {\n    lines.push(\n      `Pattern recall ${pct(recall)} across ${results.aggregate.totalTasks} cross-codebase tasks ` +\n        `suggests scoring parameters generalize well.`,\n    );\n  } else if (recall >= 0.4) {\n    lines.push(\n      `Pattern recall ${pct(recall)} across ${results.aggregate.totalTasks} cross-codebase tasks ` +\n        `is moderate — scoring parameters may need calibration for larger codebases.`,\n    );\n    lines.push(\"\");\n    lines.push(\"Parameters most likely to need adjustment:\");\n    lines.push(\n      `- \\`scoreFloorRatio\\` (${results.config.scoreFloorRatio}) — may over-prune in larger codebases`,\n    );\n    lines.push(\n      `- \\`elbowDropRatio\\` (${results.config.elbowDropRatio}) — may cut too aggressively`,\n    );\n  } else {\n    lines.push(\n      `Pattern recall ${pct(recall)} across ${results.aggregate.totalTasks} cross-codebase tasks ` +\n        `indicates likely overfitting to the original 16-file codebase.`,\n    );\n    lines.push(\"\");\n    lines.push(\"**Recommended actions:**\");\n    lines.push(\n      \"- Lower `scoreFloorRatio` (try 0.10-0.15) to retain more results\",\n    );\n    lines.push(\n      \"- Raise `elbowDropRatio` (try 0.70-0.80) to be less aggressive\",\n    );\n    lines.push(\n      \"- Lower `minMarginalValue` (try 0.00001) to include more sections\",\n    );\n  }\n\n  if (results.aggregate.emptyResultCount > 0) {\n    lines.push(\"\");\n    lines.push(\n      `**Warning:** ${results.aggregate.emptyResultCount} tasks returned zero results. ` +\n        `This may indicate FTS5 indexing gaps or overly aggressive filtering.`,\n    );\n  }\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":["require","avg"]}

package/dist/find-W5UDE4US.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import {
+  resolveRoot
+} from "./chunk-7RYHZOYF.js";
+import {
+  IndexDatabase
+} from "./chunk-Q6DOBQ4F.js";
+
+// src/commands/find.ts
+import { resolve } from "path";
+import { existsSync } from "fs";
+async function runFind(positional, flags) {
+  if (flags.help) {
+    console.log(`codefocus find \u2014 Quick symbol lookup
+
+Usage: codefocus find <symbol-name> [options]
+
+Options:
+  --kind <type>  Filter by kind: function, class, interface, type, enum, variable, method, all (default: all)
+  --root <path>  Root directory of indexed project (default: .)
+  --help         Show this help message`);
+    return;
+  }
+  const symbol = positional[0];
+  if (!symbol) {
+    console.error("Error: find requires a symbol name");
+    process.exitCode = 2;
+    return;
+  }
+  const kind = flags.kind || "all";
+  const root = resolveRoot(flags.root);
+  const dbPath = resolve(root, ".codefocus", "index.db");
+  if (!existsSync(dbPath)) {
+    console.error(
+      `Error: no index found at ${dbPath}
+Run 'codefocus index --root ${root}' first.`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  const db = new IndexDatabase(dbPath);
+  try {
+    const results = db.findSymbols(symbol, kind);
+    if (results.length === 0) {
+      console.log(`No symbols found matching "${symbol}"${kind !== "all" ? ` (kind: ${kind})` : ""}`);
+      return;
+    }
+    console.log(
+      `Found ${results.length} symbol${results.length !== 1 ? "s" : ""} matching "${symbol}"${kind !== "all" ? ` (kind: ${kind})` : ""}:
+`
+    );
+    for (const sym of results) {
+      const sig = sym.signature ? `  ${sym.signature}` : "";
+      console.log(`  ${sym.name}  ${sym.kind}  ${sym.file_path}:${sym.start_line}${sig}`);
+    }
+  } finally {
+    db.close();
+  }
+}
+export {
+  runFind
+};
+//# sourceMappingURL=find-W5UDE4US.js.map

package/dist/find-W5UDE4US.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/find.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { IndexDatabase } from \"../db.js\";\nimport { resolveRoot } from \"../root.js\";\n\nexport async function runFind(\n  positional: string[],\n  flags: Record<string, string | boolean>,\n): Promise<void> {\n  if (flags.help) {\n    console.log(`codefocus find — Quick symbol lookup\n\nUsage: codefocus find <symbol-name> [options]\n\nOptions:\n  --kind <type>  Filter by kind: function, class, interface, type, enum, variable, method, all (default: all)\n  --root <path>  Root directory of indexed project (default: .)\n  --help         Show this help message`);\n    return;\n  }\n\n  const symbol = positional[0];\n  if (!symbol) {\n    console.error(\"Error: find requires a symbol name\");\n    process.exitCode = 2;\n    return;\n  }\n\n  const kind = (flags.kind as string) || \"all\";\n  const root = resolveRoot(flags.root);\n  const dbPath = resolve(root, \".codefocus\", \"index.db\");\n\n  if (!existsSync(dbPath)) {\n    console.error(\n      `Error: no index found at ${dbPath}\\nRun 'codefocus index --root ${root}' first.`,\n    );\n    process.exitCode = 1;\n    return;\n  }\n\n  const db = new IndexDatabase(dbPath);\n  try {\n    const results = db.findSymbols(symbol, kind);\n\n    if (results.length === 0) {\n      console.log(`No symbols found matching \"${symbol}\"${kind !== \"all\" ? ` (kind: ${kind})` : \"\"}`);\n      return;\n    }\n\n    console.log(\n      `Found ${results.length} symbol${results.length !== 1 ? \"s\" : \"\"} matching \"${symbol}\"${kind !== \"all\" ? ` (kind: ${kind})` : \"\"}:\\n`,\n    );\n\n    for (const sym of results) {\n      const sig = sym.signature ? `  ${sym.signature}` : \"\";\n      console.log(`  ${sym.name}  ${sym.kind}  ${sym.file_path}:${sym.start_line}${sig}`);\n    }\n  } finally {\n    db.close();\n  }\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,eAAe;AACxB,SAAS,kBAAkB;AAI3B,eAAsB,QACpB,YACA,OACe;AACf,MAAI,MAAM,MAAM;AACd,YAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAOwB;AACpC;AAAA,EACF;AAEA,QAAM,SAAS,WAAW,CAAC;AAC3B,MAAI,CAAC,QAAQ;AACX,YAAQ,MAAM,oCAAoC;AAClD,YAAQ,WAAW;AACnB;AAAA,EACF;AAEA,QAAM,OAAQ,MAAM,QAAmB;AACvC,QAAM,OAAO,YAAY,MAAM,IAAI;AACnC,QAAM,SAAS,QAAQ,MAAM,cAAc,UAAU;AAErD,MAAI,CAAC,WAAW,MAAM,GAAG;AACvB,YAAQ;AAAA,MACN,4BAA4B,MAAM;AAAA,8BAAiC,IAAI;AAAA,IACzE;AACA,YAAQ,WAAW;AACnB;AAAA,EACF;AAEA,QAAM,KAAK,IAAI,cAAc,MAAM;AACnC,MAAI;AACF,UAAM,UAAU,GAAG,YAAY,QAAQ,IAAI;AAE3C,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,IAAI,8BAA8B,MAAM,IAAI,SAAS,QAAQ,WAAW,IAAI,MAAM,EAAE,EAAE;AAC9F;AAAA,IACF;AAEA,YAAQ;AAAA,MACN,SAAS,QAAQ,MAAM,UAAU,QAAQ,WAAW,IAAI,MAAM,EAAE,cAAc,MAAM,IAAI,SAAS,QAAQ,WAAW,IAAI,MAAM,EAAE;AAAA;AAAA,IAClI;AAEA,eAAW,OAAO,SAAS;AACzB,YAAM,MAAM,IAAI,YAAY,KAAK,IAAI,SAAS,KAAK;AACnD,cAAQ,IAAI,KAAK,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,IAAI,SAAS,IAAI,IAAI,UAAU,GAAG,GAAG,EAAE;AAAA,IACpF;AAAA,EACF,UAAE;AACA,OAAG,MAAM;AAAA,EACX;AACF;","names":[]}