engramx 0.4.2 → 0.4.3

package/dist/cli.js

@@ -1773,6 +1773,42 @@ program.command("dashboard").alias("hud").description("Live terminal dashboard s
   await new Promise(() => {
   });
 });
+program.command("hud-label").description("Output JSON label for Claude HUD --extra-cmd (fast, <20ms)").argument("[path]", "Project directory", ".").action(async (projectPath) => {
+  const resolvedPath = pathResolve(projectPath);
+  const logPath = join8(resolvedPath, ".engram", "hook-log.jsonl");
+  if (!existsSync8(join8(resolvedPath, ".engram", "graph.db"))) {
+    console.log('{"label":""}');
+    return;
+  }
+  if (!existsSync8(logPath)) {
+    console.log('{"label":"\u26A1engram \u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591 ready"}');
+    return;
+  }
+  try {
+    const entries = readHookLog(resolvedPath);
+    const summary = summarizeHookLog(entries);
+    if (summary.totalInvocations === 0) {
+      console.log('{"label":"\u26A1engram \u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591 listening..."}');
+      return;
+    }
+    const totalPreTool = (summary.byDecision["deny"] ?? 0) + (summary.byDecision["allow"] ?? 0) + (summary.byDecision["passthrough"] ?? 0);
+    const denied = summary.readDenyCount;
+    const hitRate = totalPreTool > 0 ? Math.round(denied / totalPreTool * 100) : 0;
+    const tokens = summary.estimatedTokensSaved;
+    let formatted;
+    if (tokens >= 1e6) formatted = (tokens / 1e6).toFixed(1) + "M";
+    else if (tokens >= 1e3) formatted = (tokens / 1e3).toFixed(1) + "K";
+    else formatted = String(tokens);
+    const barWidth = 10;
+    let filled = Math.round(hitRate / 100 * barWidth);
+    if (filled > barWidth) filled = barWidth;
+    if (denied > 0 && filled === 0) filled = 1;
+    const bar2 = "\u25B0".repeat(filled) + "\u25B1".repeat(barWidth - filled);
+    console.log(JSON.stringify({ label: `\u26A1engram ${formatted} saved ${bar2} ${hitRate}%` }));
+  } catch {
+    console.log('{"label":"\u26A1engram"}');
+  }
+});
 program.command("query").description("Query the knowledge graph").argument("<question>", "Natural language question or keywords").option("--dfs", "Use DFS traversal", false).option("-d, --depth <n>", "Traversal depth", "3").option("-b, --budget <n>", "Token budget", "2000").option("-p, --project <path>", "Project directory", ".").action(async (question, opts) => {
   const result = await query(opts.project, question, {
     mode: opts.dfs ? "dfs" : "bfs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engramx",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "The structural code graph your AI agent can't forget to use. A Claude Code hook layer that intercepts Read/Edit/Write/Bash and replaces file contents with ~300-token structural graph summaries. 82% measured token reduction. Context rot is empirically solved — cite Chroma. Local SQLite, zero LLM cost, zero cloud, zero native deps.",
   "type": "module",
   "bin": {