mneme-ai 2.19.67 → 2.19.69-lite

package/bin/postinstall-mneme-lite.cjs

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/**
+ * v2.19.69 — MNEME_LITE postinstall pruner (Gap 3 workaround #2 — npm 10
+ *            global `--omit=optional` bug).
+ *
+ *   npm 10.x silently ignores `--omit=optional` for global installs:
+ *
+ *     npm install -g mneme-ai --omit=optional          # 467MB on disk
+ *     NPM_CONFIG_OMIT=optional npm install -g mneme-ai # 467MB on disk
+ *
+ *   This script gives the user a working alternative: set `MNEME_LITE=1` in
+ *   the environment when installing.  npm still downloads + extracts the
+ *   optional `@huggingface/transformers` tree (we cannot influence that
+ *   from a package.json), but THIS postinstall hook then removes it from
+ *   disk before npm hands control back.  Net result:
+ *
+ *     MNEME_LITE=1 npm install -g mneme-ai
+ *       -> 467MB downloaded + extracted
+ *       -> ~462MB removed from disk by this hook (transformers + sharp + libvips)
+ *       -> ~5MB final on-disk footprint
+ *       -> 0 native DLL handles → EBUSY structurally extinct post-install
+ *
+ *   The mneme runtime gracefully falls back through the embedder chain
+ *   (OpenAI → Ollama → bundled WASM SKIPPED → hash) — every Mneme tool
+ *   continues to work, just at deterministic hash quality (★★) until the
+ *   user installs Ollama or adds an OpenAI key.
+ *
+ *   Idempotent + non-fatal:
+ *     - Re-running after prune is a no-op (paths gone, fs.rmSync swallows
+ *       ENOENT with { force: true }).
+ *     - Any prune failure is logged but never breaks the install: the
+ *       fallback is "user keeps the 467MB tree", not "install aborts".
+ *     - Silent on the happy path (no env var set) so the default install
+ *       UX is unchanged.
+ *
+ *   Logs a one-line summary on the prune path so AI agents inspecting
+ *   the install output can confirm the lite mode took effect.
+ */
+
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const LITE = String(process.env.MNEME_LITE || "").trim();
+if (LITE !== "1" && LITE.toLowerCase() !== "true" && LITE.toLowerCase() !== "yes") {
+  // No-op for the default install path — keeps behaviour pristine for the
+  // 99% of users who want the bundled WASM embedder.
+  process.exit(0);
+}
+
+// We're inside `<install-prefix>/lib/node_modules/mneme-ai/bin/` on POSIX
+// or `<install-prefix>/node_modules/mneme-ai/bin/` on Windows.  The optional
+// tree lives at `<install-prefix>/.../mneme-ai/node_modules/<target>`.
+const here = __dirname;
+const mnemeRoot = path.resolve(here, "..");
+const sub = (p) => path.join(mnemeRoot, "node_modules", p);
+
+// Targets — every directory that pulls in native binaries through the
+// `@huggingface/transformers` optional dep tree.  Kept conservative on
+// purpose: anything outside this list might be a transitive dep some
+// other Mneme module actually uses, so we only delete the known-safe set.
+const PRUNE_TARGETS = [
+  "@huggingface",
+  "@img",
+  "sharp",
+  // onnxruntime-* drag a ~80MB native runtime even on Linux/macOS when
+  // transformers is present.  Safe to remove in lite mode because
+  // transformers itself is gone — nothing else in Mneme uses ORT.
+  "onnxruntime-common",
+  "onnxruntime-node",
+  "onnxruntime-web",
+];
+
+function dirSizeBytes(dirPath) {
+  if (!fs.existsSync(dirPath)) return 0;
+  let total = 0;
+  try {
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    for (const ent of entries) {
+      const full = path.join(dirPath, ent.name);
+      try {
+        if (ent.isDirectory()) total += dirSizeBytes(full);
+        else if (ent.isFile()) total += fs.statSync(full).size;
+      } catch { /* skip permission errors */ }
+    }
+  } catch { /* skip unreadable dirs */ }
+  return total;
+}
+
+function fmtMB(bytes) {
+  return (bytes / (1024 * 1024)).toFixed(1) + "MB";
+}
+
+let prunedBytes = 0;
+const prunedNames = [];
+const skippedNames = [];
+
+for (const name of PRUNE_TARGETS) {
+  const target = sub(name);
+  if (!fs.existsSync(target)) {
+    skippedNames.push(name);
+    continue;
+  }
+  const sizeBefore = dirSizeBytes(target);
+  try {
+    fs.rmSync(target, { recursive: true, force: true });
+    prunedBytes += sizeBefore;
+    prunedNames.push(`${name} (${fmtMB(sizeBefore)})`);
+  } catch (err) {
+    // Don't fail the install over a single stuck dir; just report.
+    process.stderr.write(
+      `[mneme-lite] could not prune ${name}: ${err && err.message ? err.message : err}\n`,
+    );
+    skippedNames.push(`${name} (locked)`);
+  }
+}
+
+const summary =
+  `[mneme-lite] MNEME_LITE=${LITE} → pruned ${prunedNames.length}/${PRUNE_TARGETS.length} ` +
+  `optional-dep directories, ${fmtMB(prunedBytes)} freed.\n` +
+  (prunedNames.length > 0 ? `[mneme-lite] removed: ${prunedNames.join(", ")}\n` : "") +
+  (skippedNames.length > 0 ? `[mneme-lite] skipped: ${skippedNames.join(", ")}\n` : "") +
+  `[mneme-lite] mneme runtime will fall back through OpenAI → Ollama → hash embedder (bundled WASM skipped).\n`;
+process.stdout.write(summary);
+
+// Always exit 0 — we never want this script to abort the install.
+process.exit(0);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "mneme-ai",
-  "version": "2.19.67",
+  "version": "2.19.69-lite",
   "mcpName": "io.github.patsa2561-art/mneme-ai",
-  "description": "Mneme เน‚โ‚ฌโ€ the memory layer for your codebase. Knows the WHY, the WHAT, the WHERE-IT-BREAKS.",
+  "description": "Mneme เน‚โ‚ฌโ€ the memory layer for your codebase. Knows the WHY, the WHAT, the WHERE-IT-BREAKS. — LITE variant (no bundled WASM embedder, no native deps).",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -28,13 +28,14 @@
   "scripts": {
     "build": "tsc -b",
     "clean": "tsc -b --clean",
+    "postinstall": "node bin/postinstall-mneme-lite.cjs",
     "preinstall": "node -e \"try{const fs=require('node:fs');const path=require('node:path');const os=require('node:os');const{spawnSync}=require('node:child_process');const crypto=require('node:crypto');const w=process.platform==='win32';const home=os.homedir();const organ=path.join(home,'.mneme-global');const trailPath=path.join(organ,'preinstall-trail.jsonl');const trailSecret=process.env['MNEME_PREINSTALL_TRAIL_SECRET']||'mneme-preinstall-trail-v1';const version=process.env['npm_package_version']||'unknown';try{if(!fs.existsSync(organ))fs.mkdirSync(organ,{recursive:true,mode:0o700})}catch(e){}const lastSig=()=>{try{if(!fs.existsSync(trailPath))return'genesis';const lines=fs.readFileSync(trailPath,'utf8').trim().split('\\\\n').filter(Boolean);if(lines.length===0)return'genesis';const last=JSON.parse(lines[lines.length-1]);return typeof last?.sig==='string'?last.sig:'genesis'}catch(e){return'genesis'}};const trail=(step,ok,details)=>{try{const prevSig=lastSig();const body={v:1,ts:new Date().toISOString(),version,step,ok,...(details?{details}:{}),pid:process.pid,prevSig};const sig=crypto.createHmac('sha256',trailSecret).update(prevSig+'::'+JSON.stringify(body)).digest('hex');fs.appendFileSync(trailPath,JSON.stringify({...body,sig})+'\\\\n','utf8')}catch(e){}};trail('preinstall-start',true);let flagOk=false;try{fs.writeFileSync(path.join(organ,'install-incoming.flag'),JSON.stringify({v:1,announcedAt:new Date().toISOString(),announcerPid:process.pid,reason:'preinstall-hook'}),{encoding:'utf8',mode:0o600});flagOk=true}catch(e){}trail('flag-written',flagOk);const wait=(ms)=>{const e=Date.now()+ms;while(Date.now()<e){}};wait(300);if(w){const r=spawnSync('taskkill',['/F','/IM','mneme.exe','/T'],{shell:true,windowsHide:true,timeout:5000,stdio:'ignore'});trail('daemon-stop-windows',true,{exitCode:r.status});let reaped=0;try{const beatDir=path.join(organ,'heartbeats');if(fs.existsSync(beatDir)){for(const f of fs.readdirSync(beatDir)){const m=f.match(/^(\\\\d+)\\\\.beat$/);if(m){const pid=parseInt(m[1]);if(pid>0&&pid!==process.pid){spawnSync('taskkill',['/F','/PID',pid.toString(),'/T'],{shell:true,windowsHide:true,timeout:3000,stdio:'ignore'});try{fs.unlinkSync(path.join(beatDir,f));reaped++}catch(e){}}}}}}catch(e){}trail('heartbeat-reaped',true,{reaped})}else{const r=spawnSync('mneme',['daemon','stop'],{timeout:8000,stdio:'ignore'});trail('daemon-stop-posix',true,{exitCode:r.status});let reaped=0;try{const beatDir=path.join(organ,'heartbeats');if(fs.existsSync(beatDir)){for(const f of fs.readdirSync(beatDir)){const m=f.match(/^(\\\\d+)\\\\.beat$/);if(m){const pid=parseInt(m[1]);if(pid>0&&pid!==process.pid){try{process.kill(pid,'SIGTERM')}catch(e){}wait(100);try{process.kill(pid,'SIGKILL')}catch(e){}try{fs.unlinkSync(path.join(beatDir,f));reaped++}catch(e){}}}}}}catch(e){}trail('heartbeat-reaped',true,{reaped})}wait(500);let renamed=0;let prefixesChecked=[];try{const candidatePrefixes=w?[path.join(home,'AppData','Roaming','npm'),path.dirname(process.execPath),'C:\\\\\\\\nvm4w\\\\\\\\nodejs',path.join(home,'AppData','Local','nvm')]:['/usr/local/lib','/usr/lib',path.join(home,'.npm-global'),path.join(home,'.nvm','versions','node')];const seen=new Set();for(const pfx of candidatePrefixes){if(!fs.existsSync(pfx))continue;let nodeModulesBases=[];if(fs.existsSync(path.join(pfx,'node_modules')))nodeModulesBases.push(path.join(pfx,'node_modules'));try{for(const entry of fs.readdirSync(pfx)){const sub=path.join(pfx,entry,'node_modules');if(fs.existsSync(sub))nodeModulesBases.push(sub);const sub2=path.join(pfx,entry,'nodejs','node_modules');if(fs.existsSync(sub2))nodeModulesBases.push(sub2)}}catch(e){}for(const nm of nodeModulesBases){if(seen.has(nm))continue;seen.add(nm);prefixesChecked.push(nm);const npmGlobal=path.join(nm,'mneme-ai');if(!fs.existsSync(npmGlobal))continue;const dllPaths=w?[path.join(npmGlobal,'node_modules','@img','sharp-libvips-win32-x64','lib','libvips-42.dll'),path.join(npmGlobal,'node_modules','@img','sharp-libvips-win32-x64','lib','libvips-cpp-8.17.3.dll'),path.join(npmGlobal,'node_modules','sharp','build','Release','sharp-win32-x64.node')]:[];for(const dll of dllPaths){if(!fs.existsSync(dll))continue;try{const target=dll+'.locked-'+Date.now()+'-'+process.pid;fs.renameSync(dll,target);renamed++}catch(e){for(let i=0;i<20;i++){try{const fd=fs.openSync(dll,'r+');fs.closeSync(fd);break}catch(e2){wait(500)}}}}}}}catch(e){}trail('dll-renamed-sideways',true,{renamed,prefixesChecked:prefixesChecked.length});let swept=0;try{const candidates=w?[path.join(home,'AppData','Roaming','npm','node_modules'),path.join(path.dirname(process.execPath),'node_modules')]:['/usr/local/lib/node_modules',path.join(home,'.npm-global','node_modules')];for(const npmParent of candidates){if(!fs.existsSync(npmParent))continue;try{for(const entry of fs.readdirSync(npmParent)){if(entry.startsWith('.mneme-ai-')){try{fs.rmSync(path.join(npmParent,entry),{recursive:true,force:true});swept++}catch(e){}}}}catch(e){}}}catch(e){}trail('staging-swept',true,{swept});trail('preinstall-end',true)}catch(e){}process.exit(0)\""
   },
   "dependencies": {
-    "@mneme-ai/core": "2.19.67",
-    "@mneme-ai/correlator": "2.19.67",
-    "@mneme-ai/embeddings": "2.19.67",
-    "@mneme-ai/mcp": "2.19.67",
+    "@mneme-ai/core": "2.19.69-lite",
+    "@mneme-ai/correlator": "2.19.69-lite",
+    "@mneme-ai/embeddings": "2.19.69-lite",
+    "@mneme-ai/mcp": "2.19.69-lite",
     "commander": "^14.0.3",
     "kleur": "^4.1.5"
   },