@ijfw/install 1.4.4 → 1.5.0

package/dist/ijfw.js

@@ -1583,7 +1583,7 @@ var init_project_type_detector = __esm({
 });
 
 // ../mcp-server/src/gate-result.js
-import { mkdir, writeFile } from "node:fs/promises";
+import { mkdir, writeFile, readdir, stat, unlink, appendFile } from "node:fs/promises";
 import { basename, dirname as dirname2, join as join6 } from "node:path";
 async function emitGateResult(gateOpts, context = {}) {
   if (gateOpts === null || typeof gateOpts !== "object") {
@@ -1643,6 +1643,7 @@ async function makeReceipt(gateResult, opts = {}) {
     await mkdir(dirname2(receiptPath), { recursive: true });
     const body = JSON.stringify(gateResult, null, 2) + "\n";
     await writeFile(receiptPath, body, "utf8");
+    await evictOldReceipts(dirname2(receiptPath));
   } catch (err) {
     const msg = err && err.message ? err.message : String(err);
     try {
@@ -1652,6 +1653,58 @@ async function makeReceipt(gateResult, opts = {}) {
     }
   }
 }
+async function evictOldReceipts(dir, opts = {}) {
+  const keep = Number.isFinite(opts.keep) && opts.keep > 0 ? opts.keep | 0 : RECEIPTS_KEEP;
+  try {
+    let entries;
+    try {
+      entries = await readdir(dir);
+    } catch {
+      return { evicted: 0 };
+    }
+    const jsonFiles = entries.filter((f) => f.endsWith(".json"));
+    if (jsonFiles.length <= keep) return { evicted: 0 };
+    const stamped = [];
+    for (const f of jsonFiles) {
+      const full = join6(dir, f);
+      try {
+        const s = await stat(full);
+        stamped.push({ full, name: f, mtimeMs: s.mtimeMs });
+      } catch {
+        stamped.push({ full, name: f, mtimeMs: 0 });
+      }
+    }
+    stamped.sort((a, b2) => b2.mtimeMs - a.mtimeMs);
+    const toEvict = stamped.slice(keep);
+    if (toEvict.length === 0) return { evicted: 0 };
+    const archivePath = join6(dir, RECEIPTS_ARCHIVE);
+    let evicted = 0;
+    for (const victim of toEvict) {
+      try {
+        let body;
+        try {
+          const { readFile } = await import("node:fs/promises");
+          body = await readFile(victim.full, "utf8");
+        } catch {
+          continue;
+        }
+        let archiveLine;
+        try {
+          archiveLine = JSON.stringify(JSON.parse(body)) + "\n";
+        } catch {
+          archiveLine = JSON.stringify({ raw: body, evicted_from: victim.name }) + "\n";
+        }
+        await appendFile(archivePath, archiveLine, "utf8");
+        await unlink(victim.full);
+        evicted++;
+      } catch {
+      }
+    }
+    return { evicted };
+  } catch {
+    return { evicted: 0 };
+  }
+}
 async function resolveProjectType(projectRoot) {
   try {
     const root = typeof projectRoot === "string" && projectRoot.length > 0 ? projectRoot : process.cwd();
@@ -1667,12 +1720,14 @@ async function resolveProjectType(projectRoot) {
     return "unknown";
   }
 }
-var RECEIPT_GATE_ID_PATTERN;
+var RECEIPT_GATE_ID_PATTERN, RECEIPTS_KEEP, RECEIPTS_ARCHIVE;
 var init_gate_result = __esm({
   "../mcp-server/src/gate-result.js"() {
     init_gate_result_schema();
     init_project_type_detector();
     RECEIPT_GATE_ID_PATTERN = /^[a-z][a-z0-9-]+$/;
+    RECEIPTS_KEEP = 1e3;
+    RECEIPTS_ARCHIVE = ".archive.jsonl";
   }
 });
 

package/docs/GUIDE.md

@@ -172,7 +172,7 @@ Run `/team setup` in Claude Code, or `ijfw team` from the shell, to see your cur
 |------|-------|--------------|
 | Hot  | Plain markdown in `.ijfw/memory/` | Always on. Instant reads. Git friendly. |
 | Warm | BM25 ranked search | Always on. Scales to around 10,000 entries per project. |
-| Cold | Optional semantic vectors | Off by default. Requires a user-installed embedding provider. |
+| Cold | Optional semantic vectors (hybrid BM25 + cosine rerank) | Off by default. Enable with `IJFW_VECTORS=on` and `npm i @xenova/transformers` (one-time ~23MB MiniLM model cached locally). Top-K BM25 candidates are reranked via cosine similarity with weights 0.6 BM25 / 0.4 vector. Pure no-op fallback to BM25 if disabled, the package isn't installed, or the model fails to load. |
 
 Every session also ends with an optional "dream cycle". Run `/consolidate` or "run a dream cycle" to have IJFW sweep the day's memory: promote observed patterns into your knowledge base, prune stale entries, reconcile contradictions, optionally lift winners into global memory so every future project benefits. Memory that grows sharper over time instead of heavier.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ijfw/install",
-  "version": "1.4.4",
+  "version": "1.5.0",
   "description": "One-command installer for IJFW -- the AI efficiency layer. One install, every AI coding agent, zero config.",
   "type": "module",
   "bin": {