eminiar 0.8.0 → 0.9.0

package/dist/server.js

@@ -18018,6 +18018,7 @@ __export(store_exports, {
   autoName: () => autoName,
   edit: () => edit,
   gitignoreHint: () => gitignoreHint,
+  impliedFileLinks: () => impliedFileLinks,
   isKind: () => isKind,
   isStatus: () => isStatus,
   isValidName: () => isValidName,
@@ -18116,6 +18117,20 @@ function memoryLinks(body, self) {
   }
   return [...out];
 }
+function impliedFileLinks(root, body, skipPrefix) {
+  const out = /* @__PURE__ */ new Set();
+  for (const m of body.matchAll(PATH_RE)) {
+    const p = m[1].replace(/[.,;:)]+$/, "");
+    if (!p || p.startsWith("..") || out.has(p) || skipPrefix && p.startsWith(`${skipPrefix}/`))
+      continue;
+    try {
+      if (statSync6(join12(root, p)).isFile()) out.add(p);
+    } catch {
+    }
+    if (out.size >= 30) break;
+  }
+  return [...out].map((p) => `file:${p}`);
+}
 function writeMemoryFile(ctx, name, meta4, body) {
   const abs = absOf(ctx, name);
   mkdirSync3(dirname7(abs), { recursive: true });
@@ -18138,13 +18153,14 @@ function syncGraph(db, name, rel, g) {
   ]);
   const edges = [];
   const seen = /* @__PURE__ */ new Set();
-  const push = (dst, kind) => {
+  const push = (dst, kind, confidence = 1) => {
     const key = `${kind}|${dst}`;
     if (dst === self || seen.has(key)) return;
     seen.add(key);
-    edges.push({ src: self, dst, kind, source: "curated", confidence: 1, weight: 1 });
+    edges.push({ src: self, dst, kind, source: "curated", confidence, weight: 1 });
   };
   for (const id of g.related) push(relatedTarget(id), "mentions");
+  for (const id of g.implied ?? []) push(id, "mentions", 0.6);
   for (const other of memoryLinks(g.body, name)) push(memoryId(other), "links");
   if (g.supersedes) push(memoryId(g.supersedes.replace(/^mem(?:ory)?:/, "")), "supersedes");
   if (edges.length) db.graphUpsertEdges(edges);
@@ -18205,6 +18221,9 @@ ${parsed.body.replace(/^\s*\n/, "")}`
     hash2 = hashText(text2);
   }
   const body = parsed.body.trim();
+  const implied = impliedFileLinks(ctx.root, body, memoriesRel(ctx)).filter(
+    (id) => !related.includes(id)
+  );
   const doc = indexContent(db, {
     source: "memory",
     uri: `memory:${name}`,
@@ -18221,7 +18240,8 @@ tags: ${tags.join(", ")}` : ""}`,
     kind,
     content: body,
     tags,
-    nodeIds: related,
+    // the header's deliberate list first, then the files the body names
+    nodeIds: [...related, ...implied],
     sessionId: opts.sessionId,
     documentId: doc.documentId,
     path: rel,
@@ -18233,7 +18253,7 @@ tags: ${tags.join(", ")}` : ""}`,
     status,
     supersedes
   });
-  syncGraph(db, name, rel, { kind, tags, related, status, supersedes, body });
+  syncGraph(db, name, rel, { kind, tags, related, implied, status, supersedes, body });
   return { changed: true, row: db.memoryGetByName(name) };
 }
 function setMeta(ctx, db, name, patch) {
@@ -18436,7 +18456,7 @@ function gitignoreHint(ctx) {
   const ignored = readFileSync8(file3, "utf8").split(/\r?\n/).map((l) => l.trim().replace(/^\//, "").replace(/\/$/, "")).some((l) => l === top || l === dir || l === `${top}/**` || l === `${dir}/**`);
   return ignored ? `note: .gitignore ignores ${dir}, so memories stay local to this machine (remove that line to share them with the team)` : void 0;
 }
-var import_fast_glob3, MEMORY_KINDS, SEGMENT, NAME_RE, MEM_LINK_RE, hinted;
+var import_fast_glob3, MEMORY_KINDS, SEGMENT, NAME_RE, MEM_LINK_RE, PATH_RE, hinted;
 var init_store = __esm({
   "src/memory/store.ts"() {
     "use strict";
@@ -18459,6 +18479,7 @@ var init_store = __esm({
     SEGMENT = "[a-z0-9][a-z0-9._-]*";
     NAME_RE = new RegExp(`^(?:${SEGMENT}/)?${SEGMENT}$`);
     MEM_LINK_RE = /(?<![A-Za-z0-9_./-])mem:([a-z0-9][a-z0-9._-]*(?:\/[a-z0-9][a-z0-9._-]*)?)/g;
+    PATH_RE = /(?<![\w/.-])(?:\.\/)?((?:[A-Za-z0-9_.-]+\/)+[A-Za-z0-9_.-]+\.[A-Za-z0-9]{1,8})(?![\w/-])/g;
     hinted = /* @__PURE__ */ new Set();
   }
 });
@@ -49189,7 +49210,12 @@ var ConfigSchema = external_exports.object({
     /** Before WebSearch / WebFetch: the indexed doc pages that already answer it. */
     onWeb: external_exports.boolean().default(true),
     maxMemories: external_exports.number().int().min(0).max(10).default(3),
-    maxDocs: external_exports.number().int().min(0).max(10).default(2)
+    maxDocs: external_exports.number().int().min(0).max(10).default(2),
+    /**
+     * Prompts after which an item already shown in this context window may be injected
+     * again when it matches (0 = once per context window only).
+     */
+    repeatAfter: external_exports.number().int().min(0).max(1e3).default(10)
   }).prefault({}),
   docs: external_exports.object({
     /** Project-relative manifest of documentation sources (`em_docs`); commit it. */
@@ -51937,7 +51963,7 @@ import { join as join17 } from "path";
 
 // src/permissions/settings.ts
 init_esm_shims();
-import { existsSync as existsSync10, readFileSync as readFileSync11, statSync as statSync8 } from "fs";
+import { existsSync as existsSync10, readFileSync as readFileSync11, realpathSync as realpathSync2, statSync as statSync8 } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join15 } from "path";
 
@@ -51978,15 +52004,24 @@ function matchBash(rule, command) {
   if (rule.pattern === void 0) return true;
   return bashRegex(rule.pattern).test(command);
 }
+var readRegexCache = /* @__PURE__ */ new Map();
+function readRegex(pattern2) {
+  let re = readRegexCache.get(pattern2);
+  if (!re) {
+    if (readRegexCache.size >= 1024) readRegexCache.clear();
+    re = new RegExp(
+      `^${pattern2.split("**").map((seg) => seg.split("*").map(escapeRe2).join("[^/]*")).join(".*")}$`
+    );
+    readRegexCache.set(pattern2, re);
+  }
+  return re;
+}
 function matchRead(rule, absPath) {
   if (rule.tool !== "Read") return false;
   if (rule.pattern === void 0) return true;
   let p = rule.pattern;
   if (p.startsWith("~")) p = (process.env.HOME ?? "") + p.slice(1);
-  const re = new RegExp(
-    `^${p.split("**").map((seg) => seg.split("*").map(escapeRe2).join("[^/]*")).join(".*")}$`
-  );
-  return re.test(absPath);
+  return readRegex(p).test(absPath);
 }
 
 // src/permissions/split.ts
@@ -52148,6 +52183,17 @@ function checkCommand(rules, command) {
   }
   return { allowed: true };
 }
+function checkRead(rules, absPaths) {
+  for (const kind of ["deny", "ask"]) {
+    for (const r of rules[kind]) {
+      if (absPaths.some((p) => matchRead(r, p))) return { allowed: false, rule: r.raw, kind };
+    }
+  }
+  return { allowed: true };
+}
+function checkReadPath(rules, abs) {
+  return checkRead(rules, [.../* @__PURE__ */ new Set([abs, realpathSync2(abs), realpathSync2.native(abs)])]);
+}
 
 // src/sandbox/env.ts
 init_esm_shims();
@@ -55318,7 +55364,7 @@ function categoryRank(id) {
 var DOCUMENTS_EDGE = "documents";
 var MAX_PAGES = 500;
 var MAX_EDGES = 400;
-var PATH_RE = /(?:^|[\s(`'"[<])((?:\.{1,2}\/)*(?:[\w@.-]+\/)+[\w@.-]+\.[A-Za-z0-9]{1,8})(?=$|[\s)`'"\]>:#,;!?]|\.(?:\s|$))/gm;
+var PATH_RE2 = /(?:^|[\s(`'"[<])((?:\.{1,2}\/)*(?:[\w@.-]+\/)+[\w@.-]+\.[A-Za-z0-9]{1,8})(?=$|[\s)`'"\]>:#,;!?]|\.(?:\s|$))/gm;
 function manifestRel(ctx) {
   return relative8(ctx.root, manifestPath(ctx)).split(sep2).join("/");
 }
@@ -55338,7 +55384,7 @@ function packageCandidates(provider) {
 }
 function pathsIn(text2, pageRel, files) {
   const out = /* @__PURE__ */ new Set();
-  for (const m of text2.matchAll(PATH_RE)) {
+  for (const m of text2.matchAll(PATH_RE2)) {
     const raw = m[1];
     const tries = [raw.replace(/^(\.\/)+/, "")];
     if (pageRel && raw.startsWith("."))
@@ -57097,16 +57143,18 @@ init_esm_shims();
 
 // src/sandbox/file.ts
 init_esm_shims();
-import { realpathSync as realpathSync2 } from "fs";
+import { realpathSync as realpathSync3 } from "fs";
 import { isAbsolute, relative as relative9, resolve as resolve7 } from "path";
 function confinePath(root, target, rules) {
   const abs = resolve7(root, target);
+  refuse(checkRead(rules, [abs]), target);
   let real;
   try {
-    real = realpathSync2(abs);
+    real = realpathSync3(abs);
   } catch {
     throw new Error(`file not found: ${target}`);
   }
+  refuse(checkReadPath(rules, abs), target);
   const rel = relative9(root, real);
   const inside = rel !== "" && !rel.startsWith("..") && !isAbsolute(rel);
   if (inside) return real;
@@ -57115,11 +57163,15 @@ function confinePath(root, target, rules) {
     `${target} is outside the project root; add a Read(${real}) rule to permissions.allow to opt it in`
   );
 }
+function refuse(check3, target) {
+  if (!check3.allowed)
+    throw new Error(`refused by permission rule ${check3.rule} (${check3.kind}) on path: ${target}`);
+}
 
 // src/tools/em_execute_file.ts
 var emExecuteFile = defineTool({
   name: "em_execute_file",
-  description: "Process a file in the sandbox without reading it into context. Your code receives the absolute path as $EM_FILE (shell) / process.env.EM_FILE (node) / os.environ['EM_FILE'] (python); print only what you need. The file must be inside the project root unless a Read(<path>) allow rule opts it in. Omit `code` to get a quick summary (size, lines, head).",
+  description: "Process a file in the sandbox without reading it into context. Your code receives the absolute path as $EM_FILE (shell) / process.env.EM_FILE (node) / os.environ['EM_FILE'] (python); print only what you need. The file must be inside the project root unless a Read(<path>) allow rule opts it in; a matching Read deny or ask rule refuses the path, inside the root or out. Omit `code` to get a quick summary (size, lines, head).",
   schema: {
     path: external_exports.string().describe("File to process, relative to the project root or absolute"),
     language: LANG_ENUM.optional(),
@@ -57954,7 +58006,7 @@ function parseWhen(s) {
 }
 var emHistory = defineTool({
   name: "em_history",
-  description: "Understand the project's git history instead of reading git log: commits classified by kind (feat/fix/refactor/\u2026), branches with ahead/behind and merge state, and a fix-origin trace that blames each fix's removed lines back to the commit that wrote them, so changes that later needed fixing are flagged. Use `overview` to orient, `file` before editing a file (its fixes, what broke after past changes, who knows it), `risk` for the files in the working tree (or given paths), `commit` for one change, `branch` to compare a branch with the base, `symbol` for a function's line history, `timeline`/`search` to find when and why something happened. Commit messages are also indexed for em_search (source `git`).",
+  description: "Understand the project's git history instead of running git log/blame/show (the hooks route those here): commits classified by kind (feat/fix/refactor/\u2026), branches with ahead/behind and merge state, and a fix-origin trace that blames each fix's removed lines back to the commit that wrote them, so changes that later needed fixing are flagged. Use `overview` to orient (it also builds the table the hooks use to flag bug-prone files), `file` before editing a file (its fixes, what broke after past changes, who knows it), `risk` for the files in the working tree (or given paths), `commit` for one change, `branch` to compare a branch with the base, `symbol` for a function's line history, `timeline`/`search` to find when and why something happened. Commit messages are also indexed for em_search (source `git`).",
   schema: {
     action: external_exports.enum(["overview", "timeline", "search", "file", "commit", "branch", "risk", "symbol"]).optional().describe("default overview"),
     path: external_exports.string().optional().describe("file: the file; timeline: restrict to this path prefix"),
@@ -58310,7 +58362,7 @@ init_queue();
 init_store();
 var emRecall = defineTool({
   name: "em_recall",
-  description: 'Recall memories (.eminiar/memories, written by em_remember) and captured session history \u2014 decisions, constraints, errors and their fixes, rejected approaches \u2014 matching a query (hybrid keyword + semantic). Without a query, lists the most recent memories, onboarding first. Use at the start of a task to avoid re-deciding or re-breaking things; em_memory {action:"read"} shows a whole memory.',
+  description: 'Call this first when a task starts, a design changes or an approach is chosen: it recalls memories (.eminiar/memories, written by em_remember) and captured session history \u2014 decisions, constraints, errors and their fixes, rejected approaches \u2014 matching a query (hybrid keyword + semantic), so nothing is re-decided or re-broken. Without a query, lists the most recent memories, onboarding first. The hooks also push matching memories on their own ("eminiar recall", "eminiar memory"); this tool searches further, with synonyms. em_memory {action:"read"} shows a whole memory.',
   schema: {
     query: external_exports.string().optional(),
     kind: external_exports.enum(MEMORY_KINDS).optional().describe("Restrict to one memory kind"),
@@ -58436,7 +58488,7 @@ function sourceFilter(source) {
 }
 var emSearch = defineTool({
   name: "em_search",
-  description: "Search everything eminiar has indexed: sandbox outputs, files, fetched pages, session memory, memories and code (chunks named by symbol, e.g. `src/auth.ts > Session.refresh`). Pass several queries at once \u2014 the round trip is paid once. Hybrid BM25 (porter + trigram) with typo correction; `sort: timeline` orders by recency (use after a resume); `mode: regex` scans indexed content with a JS regular expression and returns the matching lines with context (for ad-hoc greps over files not indexed, use em_execute with rg).",
+  description: 'Search everything eminiar has indexed: sandbox outputs, files, fetched pages, session memory, memories, commit messages (source git) and code (chunks named by symbol, e.g. `src/auth.ts > Session.refresh`). Reach for it before Grep or Bash when looking for where something lives, what an earlier command printed, or what a past session found: `source: "code"` answers code questions by symbol, `sort: timeline` orders by recency (use after a resume), `mode: regex` scans indexed content with a JS regular expression and returns the matching lines with context (for ad-hoc greps over files not indexed, use em_execute with rg). Pass several queries at once \u2014 the round trip is paid once. Hybrid BM25 (porter + trigram) with typo correction.',
   schema: {
     queries: external_exports.array(external_exports.string().min(1)).min(1).describe("One or more search queries"),
     source: external_exports.union([external_exports.string(), external_exports.array(external_exports.string())]).optional().describe(
@@ -58496,9 +58548,60 @@ var emSearch = defineTool({
 
 // src/tools/em_stats.ts
 init_esm_shims();
+
+// src/session/recall.ts
+init_esm_shims();
+init_ids();
+init_model();
+var RECALL_CATEGORY = "recall";
+function recallStats(events) {
+  const byPath = {};
+  const gated = /* @__PURE__ */ new Map();
+  let decisions = 0;
+  for (const e of events) {
+    if (e.category !== RECALL_CATEGORY) continue;
+    let p;
+    try {
+      p = JSON.parse(e.payload);
+    } catch {
+      continue;
+    }
+    decisions++;
+    const path3 = p.path ?? "file";
+    byPath[path3] ??= { fired: 0, quiet: 0, items: 0 };
+    const row = byPath[path3];
+    const n = p.keys?.length ?? 0;
+    if (n) {
+      row.fired++;
+      row.items += n;
+    } else row.quiet++;
+    for (const g of p.gated ?? []) {
+      const why = g.replace(/^\S+\s+/, "").replace(/\d+\/\d+ terms/, "too few terms");
+      gated.set(why, (gated.get(why) ?? 0) + 1);
+    }
+  }
+  return {
+    decisions,
+    byPath,
+    gated: [...gated.entries()].map(([why, n]) => ({ why, n })).sort((a, b) => b.n - a.n).slice(0, 6)
+  };
+}
+function formatRecallStats(title, s) {
+  if (!s.decisions) return `${title}: no recall decisions recorded yet`;
+  const paths2 = Object.entries(s.byPath).sort((a, b) => b[1].fired + b[1].quiet - (a[1].fired + a[1].quiet)).map(([path3, r]) => {
+    const total = r.fired + r.quiet;
+    return `${path3} ${r.fired}/${total} fired (${Math.round(100 * r.fired / total)}%, ${r.items} items)`;
+  });
+  const lines = [`${title}: ${s.decisions} decision(s) \u2014 ${paths2.join(" \xB7 ")}`];
+  if (s.gated.length)
+    lines.push(`  held back: ${s.gated.map((g) => `${g.why} \xD7${g.n}`).join(", ")}`);
+  return lines.join("\n");
+}
+
+// src/tools/em_stats.ts
 var emStats = defineTool({
   name: "em_stats",
-  description: "Show how much context eminiar has kept out of the conversation: tokens seen vs returned per tool for this session, this project, and lifetime across all projects, plus index/graph sizes.",
+  description: "Show how much context eminiar has kept out of the conversation: tokens seen vs returned per tool for this session, this project, and lifetime across all projects, plus index/graph sizes and how often proactive recall (memories, docs, history before prompts, reads and edits) fired versus stayed quiet, with the reasons.",
   schema: {
     scope: external_exports.enum(["session", "project", "lifetime", "all"]).optional().describe("default all")
   },
@@ -58509,9 +58612,21 @@ var emStats = defineTool({
     const parts = [];
     if (scope === "session" || scope === "all") {
       parts.push(formatStats(`session ${sessionId.slice(0, 8)}`, db.statsBySession(sessionId)));
+      parts.push(
+        formatRecallStats(
+          "recall (session)",
+          recallStats(db.eventsBySession(sessionId, { categories: [RECALL_CATEGORY] }))
+        )
+      );
     }
     if (scope === "project" || scope === "all") {
       parts.push(formatStats(`project ${ctx.root}`, mergeByTool(db.statsAll())));
+      parts.push(
+        formatRecallStats(
+          "recall (project, last 2000 decisions)",
+          recallStats(db.eventsRecent(2e3, [RECALL_CATEGORY]))
+        )
+      );
     }
     if (scope === "lifetime" || scope === "all") {
       const g = globalDb();

package/eminiar.config.schema.json

@@ -245,6 +245,12 @@
           "type": "integer",
           "minimum": 0,
           "maximum": 10
+        },
+        "repeatAfter": {
+          "default": 10,
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1000
         }
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eminiar",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Local-first context, memory and knowledge-graph plugin for Claude Code. Sandboxed execution, FTS5 + vector search, session continuity, and a code graph — nothing leaves your machine.",
   "type": "module",
   "license": "MIT",