nlm-memory 0.21.0 → 0.21.13

package/plugin/scripts/stop-hook.mjs

@@ -1,8 +1,5 @@
 #!/usr/bin/env node
 
-// src/hook/stop-hook.ts
-import { pathToFileURL } from "node:url";
-
 // src/core/hook/citation-detect.ts
 var MIN_ID_LEN = 6;
 function detectCitations(input) {
@@ -102,18 +99,48 @@ import {
   statSync,
   writeFileSync
 } from "node:fs";
+import { join as join2 } from "node:path";
+
+// src/core/tenancy/tenant-state-path.ts
+import { createHash } from "node:crypto";
 import { homedir } from "node:os";
 import { join } from "node:path";
-function stateDir() {
-  return process.env["NLM_HOOK_STATE_DIR"] ?? join(homedir(), ".nlm", "hook-state");
+
+// src/core/tenancy/default-team.ts
+var DEFAULT_TEAM_ID = "team_local";
+
+// src/core/tenancy/tenant-state-path.ts
+var TENANTS_DIRNAME = "tenants";
+var SAFE_TENANT_ID = /^[A-Za-z0-9_-]+$/;
+function sanitizeTenantId(tenantId) {
+  if (SAFE_TENANT_ID.test(tenantId)) return tenantId;
+  const sanitized = tenantId.replace(/[^A-Za-z0-9_-]/g, "_") || "unknown";
+  const hash = createHash("sha256").update(tenantId).digest("hex").slice(0, 8);
+  return `${sanitized}_${hash}`;
+}
+function stateRoot() {
+  return process.env["NLM_STATE_ROOT"] || join(homedir(), ".nlm");
+}
+function tenantStatePath(tenantId, ...segments) {
+  const base = stateRoot();
+  if (tenantId === DEFAULT_TEAM_ID) return join(base, ...segments);
+  return join(base, TENANTS_DIRNAME, sanitizeTenantId(tenantId), ...segments);
 }
-function memoPath(conversationId) {
+
+// src/core/hook/memo.ts
+function stateDir(tenantId) {
+  if (tenantId === DEFAULT_TEAM_ID) {
+    return process.env["NLM_HOOK_STATE_DIR"] ?? tenantStatePath(tenantId, "hook-state");
+  }
+  return tenantStatePath(tenantId, "hook-state");
+}
+function memoPath(tenantId, conversationId) {
   const safe = conversationId.replace(/[^A-Za-z0-9_-]/g, "_") || "unknown";
-  return join(stateDir(), `${safe}.json`);
+  return join2(stateDir(tenantId), `${safe}.json`);
 }
-function loadSurfaced(conversationId) {
+function loadSurfaced(tenantId, conversationId) {
   try {
-    const path = memoPath(conversationId);
+    const path = memoPath(tenantId, conversationId);
     if (!existsSync(path)) return /* @__PURE__ */ new Set();
     const parsed = JSON.parse(readFileSync(path, "utf8"));
     if (!Array.isArray(parsed)) return /* @__PURE__ */ new Set();
@@ -125,18 +152,20 @@ function loadSurfaced(conversationId) {
 
 // src/core/hook/cite-memo.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { join as join2 } from "node:path";
-function stateDir2() {
-  return process.env["NLM_HOOK_STATE_DIR"] ?? join2(homedir2(), ".nlm", "hook-state");
+import { join as join3 } from "node:path";
+function stateDir2(tenantId) {
+  if (tenantId === DEFAULT_TEAM_ID) {
+    return process.env["NLM_HOOK_STATE_DIR"] ?? tenantStatePath(tenantId, "hook-state");
+  }
+  return tenantStatePath(tenantId, "hook-state");
 }
-function memoPath2(conversationId) {
+function memoPath2(tenantId, conversationId) {
   const safe = conversationId.replace(/[^A-Za-z0-9_-]/g, "_") || "unknown";
-  return join2(stateDir2(), `${safe}.cited.json`);
+  return join3(stateDir2(tenantId), `${safe}.cited.json`);
 }
-function loadCited(conversationId) {
+function loadCited(tenantId, conversationId) {
   try {
-    const path = memoPath2(conversationId);
+    const path = memoPath2(tenantId, conversationId);
     if (!existsSync2(path)) return /* @__PURE__ */ new Set();
     const parsed = JSON.parse(readFileSync2(path, "utf8"));
     if (!Array.isArray(parsed)) return /* @__PURE__ */ new Set();
@@ -145,33 +174,35 @@ function loadCited(conversationId) {
     return /* @__PURE__ */ new Set();
   }
 }
-function recordCited(conversationId, ids) {
+function recordCited(tenantId, conversationId, ids) {
   if (ids.length === 0) return;
   try {
-    const merged = loadCited(conversationId);
+    const merged = loadCited(tenantId, conversationId);
     for (const id of ids) merged.add(id);
-    mkdirSync2(stateDir2(), { recursive: true });
-    writeFileSync2(memoPath2(conversationId), JSON.stringify([...merged]), "utf8");
+    mkdirSync2(stateDir2(tenantId), { recursive: true });
+    writeFileSync2(memoPath2(tenantId, conversationId), JSON.stringify([...merged]), "utf8");
   } catch {
   }
 }
 
 // src/core/recall/miss-log.ts
 import { appendFile, mkdir, readFile, stat } from "node:fs/promises";
-import { dirname, join as join3 } from "node:path";
-import { homedir as homedir3 } from "node:os";
-function defaultLogPath() {
-  return process.env["NLM_MISS_LOG"] ?? join3(homedir3(), ".nlm", "miss-log.jsonl");
+import { dirname } from "node:path";
+function defaultLogPath(tenantId) {
+  if (tenantId === DEFAULT_TEAM_ID) {
+    return process.env["NLM_MISS_LOG"] ?? tenantStatePath(tenantId, "miss-log.jsonl");
+  }
+  return tenantStatePath(tenantId, "miss-log.jsonl");
 }
 function isEnabled() {
   const raw = process.env["NLM_MISS_LOG_ENABLED"];
   if (raw === void 0) return true;
   return raw !== "0" && raw.toLowerCase() !== "false";
 }
-async function appendMisses(entries, logPath) {
+async function appendMisses(tenantId, entries, logPath) {
   if (!isEnabled()) return;
   if (entries.length === 0) return;
-  const path = logPath ?? defaultLogPath();
+  const path = logPath ?? defaultLogPath(tenantId);
   try {
     await mkdir(dirname(path), { recursive: true });
     const ts = (/* @__PURE__ */ new Date()).toISOString();
@@ -244,7 +275,7 @@ function readAllAssistantTurns(transcriptPath) {
 
 // src/llm/env-autoload.ts
 import { readFileSync as readFileSync3, existsSync as existsSync4 } from "node:fs";
-import { homedir as homedir4 } from "node:os";
+import { homedir as homedir2 } from "node:os";
 import { resolve } from "node:path";
 var DEFAULT_SEARCH_PATHS = [
   "~/.nlm/.env",
@@ -253,7 +284,7 @@ var DEFAULT_SEARCH_PATHS = [
   "../../.env"
 ];
 function expandHome(p) {
-  if (p.startsWith("~/")) return resolve(homedir4(), p.slice(2));
+  if (p.startsWith("~/")) return resolve(homedir2(), p.slice(2));
   return p;
 }
 function autoloadEnv(extraPaths = []) {
@@ -293,9 +324,135 @@ function hookAuthHeaders(extra = {}) {
 }
 
 // src/hook/hook-helpers.ts
-import { appendFileSync, mkdirSync as mkdirSync3 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
+import { appendFileSync, mkdirSync as mkdirSync3, realpathSync } from "node:fs";
+import { homedir as homedir3 } from "node:os";
 import { dirname as dirname2, join as join4 } from "node:path";
+import { pathToFileURL } from "node:url";
+
+// package.json
+var package_default = {
+  name: "nlm-memory",
+  version: "0.21.13",
+  description: "Local-first non-linear memory operating system for AI operators.",
+  type: "module",
+  license: "Apache-2.0",
+  engines: {
+    node: ">=22.0.0"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/pbmagnet4/nlm-memory.git"
+  },
+  homepage: "https://github.com/pbmagnet4/nlm-memory#readme",
+  bugs: {
+    url: "https://github.com/pbmagnet4/nlm-memory/issues"
+  },
+  keywords: [
+    "ai",
+    "memory",
+    "mcp",
+    "claude-code",
+    "codex",
+    "hermes",
+    "local-first",
+    "recall",
+    "session-memory"
+  ],
+  files: [
+    "dist",
+    "migrations",
+    "fixtures",
+    "templates",
+    "plugin",
+    "plugin-hermes-agent",
+    "nlm",
+    "assets",
+    "LICENSE",
+    "README.md"
+  ],
+  bin: {
+    nlm: "dist/cli/nlm.js"
+  },
+  scripts: {
+    dev: "tsx watch src/cli/nlm.ts start",
+    start: "node dist/cli/nlm.js start",
+    "build:server": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
+    "build:ui": "vite build --config src/ui/vite.config.ts",
+    "build:codex-plugin": "node scripts/build-codex-plugin.mjs",
+    "verify:codex-release": "node scripts/verify-codex-release.mjs",
+    build: "npm run build:server && npm run build:ui && npm run build:codex-plugin",
+    prepare: "[ -d src ] && npm run build || true",
+    "ui:dev": "vite --config src/ui/vite.config.ts",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:pg": "vitest run .pg.test.ts --test-timeout=20000",
+    typecheck: "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json && tsc -p tsconfig.scripts.json",
+    "bench:longmemeval": "tsx scripts/longmemeval/run-harness.ts",
+    "bench:classifier": "tsx scripts/longmemeval/run-harness.ts --classifier",
+    "bench:compare": "tsx scripts/longmemeval/compare-classifiers.ts",
+    "eval:signals": "tsx scripts/eval/signals-eval.ts",
+    "eval:classifier": "tsx scripts/eval/classifier-eval.ts",
+    "eval:fact-recall": "tsx scripts/eval/fact-recall-eval.ts",
+    "eval:recall-impact-replay": "tsx scripts/eval/recall-impact-replay.ts",
+    "eval:code-exemplar": "tsx scripts/eval/code-exemplar-eval.ts",
+    "eval:reranker": "tsx scripts/eval/reranker-ablation.ts",
+    "eval:floor": "tsx scripts/eval/floor-calibration.ts",
+    "eval:matcher": "tsx scripts/eval/tune-matcher.ts",
+    "eval:naming": "tsx scripts/eval/tune-naming.ts",
+    "eval:rederiv-sample": "tsx scripts/eval/re-derivation-sample.ts",
+    "eval:rederiv-label": "tsx scripts/eval/re-derivation-label.ts",
+    "eval:rederiv-calibrate": "tsx scripts/eval/re-derivation-calibrate.ts"
+  },
+  dependencies: {
+    "@clack/prompts": "^1.4.0",
+    "@hono/node-server": "^2.0.3",
+    "@huggingface/transformers": "4.2.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@toon-format/toon": "^2.3.0",
+    "better-sqlite3": "^13.0.1",
+    commander: "^15.0.0",
+    hono: "^4.6.0",
+    pg: "^8.21.0",
+    pgvector: "^0.3.0",
+    "sqlite-vec": "^0.1.6",
+    yaml: "^2.9.0",
+    zod: "^4.4.3"
+  },
+  devDependencies: {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.10.0",
+    "@types/pg": "^8.20.0",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.2",
+    esbuild: "^0.28.0",
+    react: "^19.2.7",
+    "react-dom": "^19.2.7",
+    "react-router-dom": "^6.30.3",
+    "tsc-alias": "^1.8.17",
+    tsx: "^4.19.0",
+    typescript: "^6.0.3",
+    vite: "^8.0.16",
+    vitest: "^4.1.8"
+  }
+};
+
+// src/shared/version.ts
+var NLM_VERSION = package_default.version;
+
+// src/hook/hook-helpers.ts
+function isMainModule(metaUrl, argv1) {
+  if (!argv1) return false;
+  let resolved;
+  try {
+    resolved = realpathSync(argv1);
+  } catch {
+    return false;
+  }
+  return metaUrl === pathToFileURL(resolved).href;
+}
 function readStdin() {
   return new Promise((resolve2) => {
     let data = "";
@@ -319,9 +476,9 @@ function hookModeFromEnv() {
 }
 function appendHookEvent(data) {
   try {
-    const path = process.env["NLM_HOOK_LOG"] ?? join4(homedir5(), ".nlm", "hook-log.jsonl");
+    const path = process.env["NLM_HOOK_LOG"] ?? join4(homedir3(), ".nlm", "hook-log.jsonl");
     mkdirSync3(dirname2(path), { recursive: true });
-    appendFileSync(path, `${JSON.stringify(data)}
+    appendFileSync(path, `${JSON.stringify({ ...data, v: NLM_VERSION })}
 `, "utf8");
   } catch {
   }
@@ -343,7 +500,7 @@ async function runStopHook(input, deps) {
       skipped: true
     };
   }
-  const surfaced = loadSurfaced(input.conversationId);
+  const surfaced = loadSurfaced(DEFAULT_TEAM_ID, input.conversationId);
   if (surfaced.size === 0) {
     return {
       conversationId: input.conversationId,
@@ -375,11 +532,12 @@ async function runStopHook(input, deps) {
     toolUses: allToolUses,
     surfacedIds: surfaced
   });
-  const alreadyCited = loadCited(input.conversationId);
+  const alreadyCited = loadCited(DEFAULT_TEAM_ID, input.conversationId);
   const fresh = detected.filter((c) => !alreadyCited.has(c.id));
   const misses = detectMisses({ toolUses: allToolUses, surfacedIds: surfaced });
   if (misses.length > 0) {
     void appendMisses(
+      DEFAULT_TEAM_ID,
       misses.map((m) => ({
         conversationId: input.conversationId,
         missedId: m.id,
@@ -394,7 +552,7 @@ async function runStopHook(input, deps) {
     fresh.map((c) => deps.postCitation(input.conversationId, c.id, c.kind, preview))
   );
   if (fresh.length > 0) {
-    recordCited(input.conversationId, fresh.map((c) => c.id));
+    recordCited(DEFAULT_TEAM_ID, input.conversationId, fresh.map((c) => c.id));
   }
   return {
     conversationId: input.conversationId,
@@ -446,7 +604,7 @@ async function main() {
   } catch {
   }
 }
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+if (isMainModule(import.meta.url, process.argv[1])) {
   void main();
 }
 export {