eminiar 0.8.1 → 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. */
@@ -55338,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("/");
 }
@@ -55358,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("."))
@@ -57980,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"),
@@ -58336,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"),
@@ -58462,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(
@@ -58522,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")
   },
@@ -58535,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.1",
+  "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",