brain-cache 0.4.2 → 2.1.0

package/dist/{chunk-KQZSBRRH.js → chunk-RKPICQU7.js}

@@ -4,7 +4,7 @@ import {
   DEFAULT_EMBEDDING_DIMENSION,
   EMBED_TIMEOUT_MS,
   childLogger
-} from "./chunk-EEC7KYPY.js";
+} from "./chunk-TXLCXXKY.js";
 
 // src/services/embedder.ts
 import ollama from "ollama";

package/dist/{chunk-EEC7KYPY.js → chunk-TXLCXXKY.js}

@@ -18,13 +18,12 @@ var VECTOR_INDEX_THRESHOLD = 256;
 var EMBED_TIMEOUT_MS = 3e4;
 var COLD_START_RETRY_DELAY_MS = 2e3;
 var EMBED_MAX_TOKENS = 8192;
-var DEFAULT_SEARCH_LIMIT = 10;
-var DEFAULT_DISTANCE_THRESHOLD = 0.4;
-var DIAGNOSTIC_DISTANCE_THRESHOLD = 0.45;
-var DIAGNOSTIC_SEARCH_LIMIT = 20;
 var DEFAULT_TOKEN_BUDGET = 4096;
 var FILE_HASHES_FILENAME = "file-hashes.json";
 var TOOL_CALL_OVERHEAD_TOKENS = 300;
+var COMPRESSION_TOKEN_THRESHOLD = 500;
+var HIGH_RELEVANCE_SIMILARITY_THRESHOLD = 0.85;
+var COMPRESSION_HARD_LIMIT = 800;
 
 // src/services/logger.ts
 import pino from "pino";
@@ -72,6 +71,7 @@ function setLogLevel(level) {
 export {
   GLOBAL_CONFIG_DIR,
   PROFILE_PATH,
+  CONFIG_PATH,
   PROJECT_DATA_DIR,
   EMBEDDING_DIMENSIONS,
   DEFAULT_EMBEDDING_DIMENSION,
@@ -81,13 +81,12 @@ export {
   EMBED_TIMEOUT_MS,
   COLD_START_RETRY_DELAY_MS,
   EMBED_MAX_TOKENS,
-  DEFAULT_SEARCH_LIMIT,
-  DEFAULT_DISTANCE_THRESHOLD,
-  DIAGNOSTIC_DISTANCE_THRESHOLD,
-  DIAGNOSTIC_SEARCH_LIMIT,
   DEFAULT_TOKEN_BUDGET,
   FILE_HASHES_FILENAME,
   TOOL_CALL_OVERHEAD_TOKENS,
+  COMPRESSION_TOKEN_THRESHOLD,
+  HIGH_RELEVANCE_SIMILARITY_THRESHOLD,
+  COMPRESSION_HARD_LIMIT,
   childLogger,
   setLogLevel
 };

package/dist/claude-md-section-O5LMKH4O.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+
+// src/lib/claude-md-section.ts
+var CLAUDE_MD_SECTION = `
+## Brain-Cache MCP Tools
+
+Use brain-cache tools before reading files or using Grep/Glob for codebase questions.
+
+| Query type | Tool | NOT this |
+|-----------|------|---------|
+| Locate a function, type, or symbol | \`search_codebase\` | \`build_context\` |
+| Understand how specific code works across files | \`build_context\` | file reads |
+| Trace a call path across files | \`trace_flow\` | \`build_context\` |
+| Explain project architecture or structure | \`explain_codebase\` | \`build_context\` |
+| Diagnose brain-cache failures | \`doctor\` | -- |
+| Reindex the project | \`index_repo\` | -- |
+
+### search_codebase (locate code)
+
+Call \`mcp__brain-cache__search_codebase\` to find functions, types, definitions, or implementations by meaning rather than keyword match.
+
+Do NOT use for understanding how code works \u2014 use build_context once you have located the symbol.
+
+### build_context (understand specific behavior)
+
+Call \`mcp__brain-cache__build_context\` with a focused question about how specific code works. It retrieves semantically relevant code, deduplicates results, and fits them to a token budget.
+
+Use for: "How does X work?", "What does this function do?", debugging unfamiliar code paths.
+
+Do NOT use for architecture overviews (use explain_codebase) or call-path tracing (use trace_flow).
+
+### trace_flow (trace call paths)
+
+Call \`mcp__brain-cache__trace_flow\` to trace how a function call propagates through the codebase. Returns structured hops showing the call chain across files.
+
+Use for: "How does X flow to Y?", "Trace how X calls Y across files", "What happens when X is called?", "Call path from X to Y".
+
+Do NOT use for code understanding queries like "how does X work" or "what does X do" \u2014 use build_context instead.
+
+Use trace_flow instead of build_context when the question is about call propagation or execution flow across files.
+
+### explain_codebase (architecture overview)
+
+Call \`mcp__brain-cache__explain_codebase\` to get a module-grouped architecture overview. No follow-up question needed.
+
+Use for: "Explain the project architecture", "How is this project structured?", "What does this project do?", "Give me an overview of the codebase".
+
+Do NOT use for questions about specific code behavior or how a particular function works \u2014 use build_context instead.
+
+Use explain_codebase instead of build_context when the question is about overall structure or getting oriented.
+
+### doctor (diagnose issues)
+
+Call \`mcp__brain-cache__doctor\` when any brain-cache tool fails or returns unexpected results.
+
+### index_repo (reindex)
+
+Call \`mcp__brain-cache__index_repo\` only when the user explicitly asks to reindex, or after major code changes. Do not call proactively.
+`;
+export {
+  CLAUDE_MD_SECTION
+};

package/dist/cli.js

@@ -1,27 +1,31 @@
 #!/usr/bin/env node
 import {
   formatTokenSavings
-} from "./chunk-ZGYLHFHJ.js";
+} from "./chunk-6C2OYMKD.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
-var version = "0.4.2";
+var version = true ? "2.1.0" : "dev";
 var program = new Command();
 program.name("brain-cache").description("Local AI runtime \u2014 GPU cache layer for Claude").version(version);
 program.command("init").description("Detect hardware, pull embedding model, create config directory").action(async () => {
-  const { runInit } = await import("./init-QNN5H3DR.js");
+  const { runInit } = await import("./init-BCMT64T2.js");
   await runInit();
 });
 program.command("doctor").description("Report system health: GPU, VRAM tier, Ollama status").action(async () => {
-  const { runDoctor } = await import("./doctor-KRNLXE4R.js");
+  const { runDoctor } = await import("./doctor-FCET2MNJ.js");
   await runDoctor();
 });
 program.command("index").description("Index a codebase: parse, chunk, embed, and store in LanceDB").argument("[path]", "Directory to index (defaults to current directory)").option("-f, --force", "Force full reindex, ignoring cached file hashes").action(async (path, opts) => {
-  const { runIndex } = await import("./workflows-KYCBR7TC.js");
+  const { runIndex } = await import("./workflows-MWEY7OAI.js");
   await runIndex(path, { force: opts.force });
 });
+program.command("watch").description("Watch a directory for file changes and auto-reindex").argument("[path]", "Directory to watch (defaults to current directory)").action(async (path) => {
+  const { runWatch } = await import("./watch-QPMAB62P.js");
+  await runWatch(path);
+});
 program.command("search").description("Search indexed codebase with a natural language query").argument("<query>", "Natural language query string").option("-n, --limit <n>", "Maximum number of results", "10").option("-p, --path <path>", "Project root directory").action(async (query, opts) => {
-  const { runSearch } = await import("./search-O4CFAH45.js");
+  const { runSearch } = await import("./search-7ISZ7EXI.js");
   await runSearch(query, {
     limit: parseInt(opts.limit, 10),
     path: opts.path
@@ -30,12 +34,12 @@ program.command("search").description("Search indexed codebase with a natural la
 program.command("status").description(
   "Show index stats: files indexed, chunks stored, last indexed time"
 ).argument("[path]", "Project root directory (defaults to current directory)").action(async (path) => {
-  const { runStatus } = await import("./status-7MT4IROA.js");
+  const { runStatus } = await import("./status-VKTSG2SN.js");
   await runStatus(path);
 });
 program.command("context").description("Build token-budgeted context from codebase for a query").argument("<query>", "Natural language query string").option("-n, --limit <n>", "Maximum number of search results", "10").option("-b, --budget <tokens>", "Token budget for assembled context", "4096").option("-p, --path <path>", "Project root directory").option("--raw", "Output raw JSON (MCP transport compatible)").action(
   async (query, opts) => {
-    const { runBuildContext } = await import("./buildContext-APWOPZMJ.js");
+    const { runBuildContext } = await import("./buildContext-GWVDAYH6.js");
     const result = await runBuildContext(query, {
       limit: parseInt(opts.limit, 10),
       maxTokens: parseInt(opts.budget, 10),
@@ -60,7 +64,7 @@ ${formatTokenSavings({ tokensSent: result.metadata.tokensSent, estimatedWithout:
 program.command("ask").description(
   "Ask a natural language question about the codebase \u2014 retrieves context locally, reasons via Claude"
 ).argument("<question>", "Natural language question about the codebase").option("-b, --budget <tokens>", "Token budget for context retrieval", "4096").option("-p, --path <path>", "Project root directory").action(async (question, opts) => {
-  const { runAskCodebase } = await import("./askCodebase-BZIXS3EV.js");
+  const { runAskCodebase } = await import("./askCodebase-EE32B7BP.js");
   const result = await runAskCodebase(question, {
     path: opts.path,
     maxContextTokens: parseInt(opts.budget, 10)

package/dist/{doctor-KRNLXE4R.js → doctor-FCET2MNJ.js}

@@ -4,14 +4,14 @@ import {
   isOllamaInstalled,
   isOllamaRunning,
   modelMatches
-} from "./chunk-FQL4HV4R.js";
+} from "./chunk-HRJ3OT6Q.js";
 import {
   detectCapabilities,
   readProfile
-} from "./chunk-PJQNHMQH.js";
+} from "./chunk-DPH5X5HL.js";
 import {
   PROFILE_PATH
-} from "./chunk-EEC7KYPY.js";
+} from "./chunk-TXLCXXKY.js";
 
 // src/workflows/doctor.ts
 import ollama from "ollama";

package/dist/{embedder-ZLHAZZUI.js → embedder-HVEXDJAU.js}

@@ -2,8 +2,8 @@
 import {
   embedBatch,
   embedBatchWithRetry
-} from "./chunk-KQZSBRRH.js";
-import "./chunk-EEC7KYPY.js";
+} from "./chunk-RKPICQU7.js";
+import "./chunk-TXLCXXKY.js";
 export {
   embedBatch,
   embedBatchWithRetry

package/dist/{init-QNN5H3DR.js → init-BCMT64T2.js}

@@ -5,15 +5,17 @@ import {
   isOllamaRunning,
   pullModelIfMissing,
   startOllama
-} from "./chunk-FQL4HV4R.js";
+} from "./chunk-HRJ3OT6Q.js";
 import {
   detectCapabilities,
   writeProfile
-} from "./chunk-PJQNHMQH.js";
-import "./chunk-EEC7KYPY.js";
+} from "./chunk-DPH5X5HL.js";
+import "./chunk-TXLCXXKY.js";
 
 // src/workflows/init.ts
-import { existsSync, readFileSync, writeFileSync, appendFileSync } from "fs";
+import { existsSync, readFileSync, writeFileSync, appendFileSync, chmodSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
 async function runInit() {
   process.stderr.write("brain-cache: detecting hardware capabilities...\n");
   const profile = await detectCapabilities();
@@ -52,7 +54,7 @@ async function runInit() {
     `brain-cache: warming model ${profileWithVersion.embeddingModel} into VRAM...
 `
   );
-  const { embedBatchWithRetry } = await import("./embedder-ZLHAZZUI.js");
+  const { embedBatchWithRetry } = await import("./embedder-HVEXDJAU.js");
   await embedBatchWithRetry(profileWithVersion.embeddingModel, ["warmup"]);
   process.stderr.write("brain-cache: model warm.\n");
   await writeProfile(profileWithVersion);
@@ -86,7 +88,7 @@ async function runInit() {
     process.stderr.write("brain-cache: created .mcp.json with brain-cache MCP server.\n");
   }
   const claudeMdPath = "CLAUDE.md";
-  const { CLAUDE_MD_SECTION: brainCacheSection } = await import("./claude-md-section-6ZJ3TMO4.js");
+  const { CLAUDE_MD_SECTION: brainCacheSection } = await import("./claude-md-section-O5LMKH4O.js");
   if (existsSync(claudeMdPath)) {
     const content = readFileSync(claudeMdPath, "utf-8");
     if (content.includes("## Brain-Cache MCP Tools")) {
@@ -99,6 +101,54 @@ async function runInit() {
     writeFileSync(claudeMdPath, brainCacheSection.trimStart());
     process.stderr.write("brain-cache: created CLAUDE.md with Brain-Cache MCP Tools section.\n");
   }
+  const { STATUSLINE_SCRIPT_CONTENT } = await import("./statusline-script-NFUDFOWK.js");
+  const statuslinePath = join(homedir(), ".brain-cache", "statusline.mjs");
+  if (existsSync(statuslinePath)) {
+    const existingScript = readFileSync(statuslinePath, "utf-8");
+    if (existingScript === STATUSLINE_SCRIPT_CONTENT) {
+      process.stderr.write("brain-cache: statusline.mjs already installed, skipping.\n");
+    } else {
+      process.stderr.write(
+        "brain-cache: Warning: ~/.brain-cache/statusline.mjs already exists with custom content. Skipping to preserve user changes.\n"
+      );
+    }
+  } else {
+    writeFileSync(statuslinePath, STATUSLINE_SCRIPT_CONTENT, "utf-8");
+    chmodSync(statuslinePath, 493);
+    process.stderr.write("brain-cache: installed statusline.mjs to ~/.brain-cache/statusline.mjs\n");
+  }
+  const claudeDir = join(homedir(), ".claude");
+  const settingsPath = join(claudeDir, "settings.json");
+  const statusLineEntry = {
+    type: "command",
+    command: `node "${join(homedir(), ".brain-cache", "statusline.mjs")}"`
+  };
+  try {
+    if (existsSync(settingsPath)) {
+      const rawSettings = readFileSync(settingsPath, "utf-8");
+      const parsed = JSON.parse(rawSettings);
+      if (parsed["statusLine"]) {
+        process.stderr.write(
+          "brain-cache: Warning: ~/.claude/settings.json already has a statusLine entry. Skipping to preserve existing configuration.\n"
+        );
+      } else {
+        parsed["statusLine"] = statusLineEntry;
+        writeFileSync(settingsPath, JSON.stringify(parsed, null, 2) + "\n");
+        process.stderr.write("brain-cache: added statusLine to ~/.claude/settings.json\n");
+      }
+    } else {
+      mkdirSync(claudeDir, { recursive: true });
+      const newSettings = { statusLine: statusLineEntry };
+      writeFileSync(settingsPath, JSON.stringify(newSettings, null, 2) + "\n");
+      process.stderr.write("brain-cache: created ~/.claude/settings.json with statusLine entry.\n");
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(
+      `brain-cache: Warning: Could not configure ~/.claude/settings.json: ${msg}. Status line will not appear in Claude Code until settings.json is configured manually.
+`
+    );
+  }
 }
 export {
   runInit