engramx 2.0.2 → 3.0.0

package/dist/wizard-UH27IO4I.js

@@ -0,0 +1,274 @@
+import {
+  buildReport,
+  formatReport
+} from "./chunk-XVYE4OX2.js";
+import "./chunk-RM2TBOVW.js";
+import {
+  installEngramHooks
+} from "./chunk-SMU4WR3D.js";
+import "./chunk-G4U3QOOW.js";
+import {
+  init
+} from "./chunk-B4UOE64J.js";
+import "./chunk-645NBY6L.js";
+
+// src/setup/wizard.ts
+import chalk from "chalk";
+import readline from "readline/promises";
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync, mkdirSync } from "fs";
+import { dirname, join as join2, resolve as pathResolve } from "path";
+import { homedir as homedir2 } from "os";
+
+// src/setup/detect.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+function detectClaudeCode(projectRoot) {
+  const settingsCandidates = [
+    join(projectRoot, ".claude", "settings.local.json"),
+    join(projectRoot, ".claude", "settings.json"),
+    join(homedir(), ".claude", "settings.json")
+  ];
+  const settingsPresent = settingsCandidates.some(existsSync);
+  const claudeCliPresent = existsSync(join(homedir(), ".claude")) || existsSync("/usr/local/bin/claude") || existsSync(join(homedir(), ".local/bin/claude"));
+  const installed = settingsPresent || claudeCliPresent;
+  let configured = false;
+  try {
+    configured = settingsCandidates.filter(existsSync).some((p) => readFileSync(p, "utf-8").includes("engram intercept"));
+  } catch {
+    configured = false;
+  }
+  return {
+    name: "Claude Code",
+    installed,
+    configured,
+    status: !installed ? "not detected" : configured ? "Sentinel hook installed" : "detected \u2014 hook not yet installed"
+  };
+}
+function detectCursor(projectRoot) {
+  const cursorConfigs = [
+    join(homedir(), "Library/Application Support/Cursor"),
+    join(homedir(), ".config/Cursor"),
+    join(homedir(), "AppData/Roaming/Cursor")
+  ];
+  const installed = cursorConfigs.some(existsSync);
+  const configured = existsSync(
+    join(projectRoot, ".cursor", "rules", "engram-context.mdc")
+  );
+  return {
+    name: "Cursor",
+    installed,
+    configured,
+    status: !installed ? "not detected" : configured ? "MDC adapter present" : "detected \u2014 run `engram gen-mdc`"
+  };
+}
+function detectWindsurf(projectRoot) {
+  const configured = existsSync(join(projectRoot, ".windsurfrules"));
+  return {
+    name: "Windsurf",
+    installed: configured,
+    configured,
+    status: configured ? ".windsurfrules present" : "run `engram gen-windsurfrules` to add"
+  };
+}
+function detectContinue() {
+  const path = join(homedir(), ".continue", "config.json");
+  const installed = existsSync(path);
+  let configured = false;
+  if (installed) {
+    try {
+      configured = readFileSync(path, "utf-8").includes("engram");
+    } catch {
+      configured = false;
+    }
+  }
+  return {
+    name: "Continue.dev",
+    installed,
+    configured,
+    status: !installed ? "not detected" : configured ? "engram configured" : "detected \u2014 add engram MCP server to config"
+  };
+}
+function detectAider(projectRoot) {
+  const configured = existsSync(join(projectRoot, ".aider-context.md"));
+  const installed = configured || existsSync(join(homedir(), ".aider"));
+  return {
+    name: "Aider",
+    installed,
+    configured,
+    status: !installed ? "not detected" : configured ? ".aider-context.md present" : "detected \u2014 run `engram gen-aider`"
+  };
+}
+function detectAllIdes(projectRoot) {
+  return [
+    detectClaudeCode(projectRoot),
+    detectCursor(projectRoot),
+    detectWindsurf(projectRoot),
+    detectContinue(),
+    detectAider(projectRoot)
+  ];
+}
+
+// src/setup/wizard.ts
+async function ask(rl, question, fallback) {
+  const prompt = `${question} ${fallback ? "[Y/n]" : "[y/N]"} `;
+  const answer = (await rl.question(prompt)).trim().toLowerCase();
+  if (answer === "") return fallback;
+  return answer === "y" || answer === "yes";
+}
+function banner(line) {
+  console.log(chalk.bold(line));
+}
+function step(n, title) {
+  console.log("");
+  console.log(chalk.cyan(`\u2500\u2500 step ${n} \xB7 `) + chalk.bold(title));
+}
+function done(msg) {
+  console.log(chalk.green("  \u2713 ") + msg);
+}
+function skip(msg) {
+  console.log(chalk.dim("  \xB7 ") + chalk.dim(msg));
+}
+function warn(msg) {
+  console.log(chalk.yellow("  \u26A0 ") + msg);
+}
+async function ensureGraphInit(opts, rl) {
+  const root = pathResolve(opts.projectPath);
+  const dbPath = join2(root, ".engram", "graph.db");
+  if (existsSync2(dbPath)) {
+    skip("graph.db already exists at .engram/graph.db \u2014 skipping init");
+    return false;
+  }
+  if (opts.dryRun) {
+    skip("[dry-run] would run `engram init`");
+    return false;
+  }
+  const go = opts.yes || rl === null || await ask(rl, "Index this repository now?", true);
+  if (!go) {
+    skip("skipped by user");
+    return false;
+  }
+  console.log(chalk.dim("  \u2192 running engram init..."));
+  const result = await init(root);
+  done(
+    `${result.nodes} nodes, ${result.edges} edges from ${result.fileCount} files (${result.timeMs}ms)`
+  );
+  return true;
+}
+async function ensureHookInstalled(opts, rl) {
+  const root = pathResolve(opts.projectPath);
+  const scope = opts.settingsScope ?? "local";
+  const settingsPath = scope === "user" ? join2(homedir2(), ".claude", "settings.json") : scope === "project" ? join2(root, ".claude", "settings.json") : join2(root, ".claude", "settings.local.json");
+  const existing = existsSync2(settingsPath) ? readFileSync2(settingsPath, "utf-8") : "";
+  if (existing.includes("engram intercept")) {
+    skip(`Sentinel hook already in ${scope}-scope settings`);
+    return false;
+  }
+  if (opts.dryRun) {
+    skip(`[dry-run] would install Sentinel hook (${scope} scope)`);
+    return false;
+  }
+  const go = opts.yes || rl === null || await ask(rl, `Install Sentinel hook in ${scope} scope?`, true);
+  if (!go) {
+    skip("skipped by user");
+    return false;
+  }
+  let settings = {};
+  if (existing) {
+    try {
+      settings = JSON.parse(existing);
+    } catch {
+      warn(`settings file at ${settingsPath} is not valid JSON \u2014 aborting`);
+      return false;
+    }
+  }
+  const result = installEngramHooks(settings);
+  mkdirSync(dirname(settingsPath), { recursive: true });
+  writeFileSync(settingsPath, JSON.stringify(result.updated, null, 2) + "\n", "utf-8");
+  done(`Sentinel hook installed (${scope} scope)`);
+  return true;
+}
+async function offerIdeAdapters(opts, rl) {
+  const root = pathResolve(opts.projectPath);
+  const detected = detectAllIdes(root);
+  const installedIdes = detected.filter((d) => d.installed);
+  if (installedIdes.length === 0) {
+    skip("no IDEs detected beyond Claude Code");
+    return [];
+  }
+  console.log(chalk.dim("  Detected:"));
+  for (const d of installedIdes) {
+    console.log(
+      chalk.dim(`    \xB7 ${d.name.padEnd(14)} \u2014 ${d.status}`)
+    );
+  }
+  if (opts.dryRun) {
+    skip("[dry-run] adapters left alone");
+    return [];
+  }
+  const unconfigured = installedIdes.filter((d) => !d.configured);
+  if (unconfigured.length === 0) {
+    done("all detected IDEs already have engram adapters");
+    return [];
+  }
+  const suggest = {
+    Cursor: "engram gen-mdc",
+    Windsurf: "engram gen-windsurfrules",
+    Aider: "engram gen-aider"
+  };
+  const suggested = [];
+  for (const ide of unconfigured) {
+    const cmd = suggest[ide.name];
+    if (cmd) suggested.push({ name: ide.name, cmd });
+  }
+  if (suggested.length === 0) {
+    const claudeCode = unconfigured.find((d) => d.name === "Claude Code");
+    if (claudeCode) {
+      skip("Claude Code hook declined or missing \u2014 re-run `engram install-hook`");
+    } else {
+      done("no additional adapters needed");
+    }
+    return [];
+  }
+  console.log("");
+  console.log(chalk.dim("  Next steps for detected IDEs:"));
+  const run = [];
+  for (const s of suggested) {
+    console.log(chalk.white(`    $ ${s.cmd}`));
+    run.push(s.name);
+  }
+  return run;
+}
+async function runSetup(opts) {
+  const root = pathResolve(opts.projectPath);
+  banner(`
+\u26A1 engram setup \u2014 ${root}`);
+  console.log(
+    chalk.dim(
+      `   Running ${opts.yes ? "non-interactively" : "interactively"}${opts.dryRun ? " (dry-run)" : ""}
+`
+    )
+  );
+  const rl = opts.yes || opts.dryRun ? null : readline.createInterface({ input: process.stdin, output: process.stdout });
+  let initRan = false;
+  let hookInstalled = false;
+  let ideAdapters = [];
+  try {
+    step(1, "graph");
+    initRan = await ensureGraphInit(opts, rl);
+    step(2, "hook");
+    hookInstalled = await ensureHookInstalled(opts, rl);
+    step(3, "adapters");
+    ideAdapters = await offerIdeAdapters(opts, rl);
+    step(4, "verify");
+    const report = buildReport(root, opts.engramVersion);
+    console.log(formatReport(report, false));
+    const exitCode = report.overallSeverity === "ok" ? 0 : report.overallSeverity === "warn" ? 1 : 2;
+    return { initRan, hookInstalled, ideAdaptersRun: ideAdapters, exitCode };
+  } finally {
+    rl?.close();
+  }
+}
+export {
+  runSetup
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "engramx",
-  "version": "2.0.2",
-  "description": "The context spine for AI coding agents. 8 providers + pluggable context sources, 3-layer memory cache, web dashboard, multi-IDE support (Claude Code, Cursor, Continue, Zed, Aider, Windsurf, Neovim, Emacs). 88.1% measured session-level token savings. Local SQLite, zero native deps, zero cloud.",
+  "version": "3.0.0",
+  "description": "The context spine for AI coding agents. 9 built-in providers + mcpConfig plugin contract (wrap any MCP server in 10 lines), generic MCP-client aggregator (stdio), pre-mortem mistake-guard, bi-temporal mistake memory, Anthropic Auto-Memory bridge, SSE streaming context packets, dual-emit AGENTS.md+CLAUDE.md. 90.8% measured real-world token savings (reproducible bench included). Local SQLite, zero cloud.",
   "repository": {
     "type": "git",
     "url": "https://github.com/NickCirv/engram.git"
@@ -56,6 +56,7 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "sql.js": "^1.14.1",

package/dist/{tuner-KFNNGKG3.js → tuner-Y2YENAZC.js}

@@ -1,10 +1,10 @@
+import {
+  readHookLog
+} from "./chunk-KL6NSPVA.js";
 import {
   readConfig,
   writeConfig
 } from "./chunk-22INHMKB.js";
-import {
-  readHookLog
-} from "./chunk-KL6NSPVA.js";
 
 // src/tuner/index.ts
 var MIN_CONFIDENCE_SAMPLES = 10;