memorix 1.6.1 → 1.6.3

package/docs/PERFORMANCE.md

@@ -78,6 +78,7 @@ On the release development machine used for this check, the healthy HTTP service
 | `MEMORIX_RERANK_TIMEOUT_MS` | provider default | Bound slow LLM rerank calls |
 | `memorix memory search --quality fast` | n/a | Force a fully local retrieval path for a latency-sensitive call |
 | `npm run benchmark:retrieval -- --records 1000 --runs 100` | n/a | Reproduce hot in-process lexical retrieval latency; not an end-to-end claim |
+| `npm run gate:large-store -- --records 40000` | n/a | Exercise SDK, HTTP MCP, hook persistence, cache integrity, and reopen behavior against a large isolated store |
 | `[codegraph].max_file_bytes` | `2097152` | Raise only when a large file is intentional source that should enter Code Memory |
 | `memorix retention status` | report only | Inspect whether memory growth needs cleanup |
 | `memorix retention archive` | explicit | Archive expired memories when the project gets noisy |
@@ -96,6 +97,20 @@ On the release development machine used for this check, the healthy HTTP service
   `/api/maintenance` on that local dashboard before assuming a Code Memory scan
   or lifecycle task completed.
 
+## Large-Store Release Gate
+
+`npm run gate:large-store -- --records 40000` builds Memorix and creates a
+temporary Git project with an isolated data directory. It runs with embeddings
+disabled, so it does not use provider credentials or make paid network calls.
+The gate measures steady-state writes, first lexical search, process memory,
+HTTP MCP and hook persistence, and an SDK close/reopen cycle. It also verifies
+that the personal hook candidate remains durable on disk without becoming
+visible to an unbound SDK reader.
+
+Results are machine-specific and should be compared on the same OS and Node
+version. The release gate is an integrity and regression check, not a public
+latency guarantee.
+
 ## Current Optimization Opportunities
 
 These are not release blockers, but they are reasonable future improvements:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorix",
   "mcpName": "io.github.AVIDS2/memorix",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
   "type": "module",
   "sideEffects": false,
@@ -67,6 +67,7 @@
     "test:e2e": "vitest run tests/e2e/",
     "benchmark:codegraph": "node scripts/benchmark-codegraph-provider.cjs",
     "benchmark:retrieval": "npm run build && node scripts/benchmark-retrieval.mjs",
+    "gate:large-store": "npm run build && node scripts/large-store-gate.mjs",
     "generate:star-history": "node scripts/generate-star-history.mjs",
     "sync:mcp-registry": "node scripts/sync-mcp-registry-manifest.mjs",
     "check:mcp-registry": "node scripts/check-mcp-registry-manifest.mjs",

package/plugins/claude/memorix/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "memorix",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Shared workspace memory for Claude Code and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Local-first project memory for CodeBuddy Code and other coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codex/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Shared workspace memory for Codex and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/copilot/memorix/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Shared local workspace memory for GitHub Copilot CLI and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/gemini/memorix/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "mcpServers": {
     "memorix": {
       "command": "memorix",

package/plugins/omp/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-omp-package",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Memorix shared workspace memory package for Oh-my-Pi.",
   "license": "Apache-2.0",
   "keywords": [

package/plugins/openclaw/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Shared workspace memory for OpenClaw and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/pi/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-pi-package",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Memorix shared workspace memory package for Pi coding agent.",
   "license": "Apache-2.0",
   "keywords": [

package/server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/AVIDS2/memorix",
     "source": "github"
   },
-  "version": "1.6.1",
+  "version": "1.6.3",
   "websiteUrl": "https://github.com/AVIDS2/memorix#readme",
   "icons": [
     {
@@ -22,7 +22,7 @@
     {
       "registryType": "npm",
       "identifier": "memorix",
-      "version": "1.6.1",
+      "version": "1.6.3",
       "runtimeHint": "npx",
       "packageArguments": [
         {

package/src/audit/index.ts

@@ -1,156 +1,156 @@
-/**
- * Audit Module - Track Memorix-written files
- *
- * Records all files written by Memorix to distinguish them from
- * project-native files. Provides audit trail for cleanup and rollback.
- */
-
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { homedir } from 'node:os';
-
-function getAuditFilePath(): string {
-  return process.env.MEMORIX_AUDIT_FILE || path.join(homedir(), '.memorix', 'audit.json');
-}
-
-export interface AuditEntry {
-  type: 'hook' | 'rule' | 'other';
-  agent?: string;
-  path: string;
-  createdAt: string;
-}
-
-export interface ProjectAudit {
-  projectRoot: string;
-  installedAt: string;
-  entries: AuditEntry[];
-}
-
-export interface AuditData {
-  version: string;
-  projects: Record<string, ProjectAudit>;
-}
-
-/**
- * Load audit data from disk.
- */
-export async function loadAudit(): Promise<AuditData> {
-  try {
-    const content = await fs.readFile(getAuditFilePath(), 'utf-8');
-    return JSON.parse(content) as AuditData;
-  } catch {
-    // No audit file yet
-    return {
-      version: '1.0.0',
-      projects: {},
-    };
-  }
-}
-
-/**
- * Save audit data to disk.
- */
-export async function saveAudit(data: AuditData): Promise<void> {
-  const auditFile = getAuditFilePath();
-  const dir = path.dirname(auditFile);
-  await fs.mkdir(dir, { recursive: true });
-  await fs.writeFile(auditFile, JSON.stringify(data, null, 2), 'utf-8');
-}
-
-/**
- * Get project ID from project root via .git detection.
- */
-export function getProjectId(projectRoot: string): string {
-  try {
-    const { detectProject } = require('../project/detector.js');
-    const project = detectProject(projectRoot);
-    if (project) return project.id;
-  } catch { /* fallback below */ }
-  const normalized = projectRoot.replace(/\\/g, '/');
-  return `untracked/${normalized}`;
-}
-
-/**
- * Record a file written by Memorix.
- */
-export async function recordFile(
-  projectRoot: string,
-  type: AuditEntry['type'],
-  filePath: string,
-  agent?: string,
-): Promise<void> {
-  const data = await loadAudit();
-  const projectId = getProjectId(projectRoot);
-
-  if (!data.projects[projectId]) {
-    data.projects[projectId] = {
-      projectRoot,
-      installedAt: new Date().toISOString(),
-      entries: [],
-    };
-  }
-
-  // Check if entry already exists
-  const existingIndex = data.projects[projectId].entries.findIndex(
-    (e) => e.path === filePath
-  );
-
-  if (existingIndex === -1) {
-    data.projects[projectId].entries.push({
-      type,
-      agent,
-      path: filePath,
-      createdAt: new Date().toISOString(),
-    });
-  }
-
-  await saveAudit(data);
-}
-
-/**
- * Get all files written by Memorix for a project.
- */
-export async function getProjectFiles(projectRoot: string): Promise<AuditEntry[]> {
-  const data = await loadAudit();
-  const projectId = getProjectId(projectRoot);
-  return data.projects[projectId]?.entries || [];
-}
-
-/**
- * Remove a file from audit (when uninstalled).
- */
-export async function removeFile(projectRoot: string, filePath: string): Promise<void> {
-  const data = await loadAudit();
-  const projectId = getProjectId(projectRoot);
-
-  if (!data.projects[projectId]) return;
-
-  data.projects[projectId].entries = data.projects[projectId].entries.filter(
-    (e) => e.path !== filePath
-  );
-
-  // If no entries left, remove the project
-  if (data.projects[projectId].entries.length === 0) {
-    delete data.projects[projectId];
-  }
-
-  await saveAudit(data);
-}
-
-/**
- * Get all audit entries across all projects.
- */
-export async function getAllAuditEntries(): Promise<
-  Array<{ projectId: string; entry: AuditEntry }>
-> {
-  const data = await loadAudit();
-  const entries: Array<{ projectId: string; entry: AuditEntry }> = [];
-
-  for (const [projectId, project] of Object.entries(data.projects)) {
-    for (const entry of project.entries) {
-      entries.push({ projectId, entry });
-    }
-  }
-
-  return entries;
-}
+/**
+ * Audit Module - Track Memorix-written files
+ *
+ * Records all files written by Memorix to distinguish them from
+ * project-native files. Provides audit trail for cleanup and rollback.
+ */
+
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+
+function getAuditFilePath(): string {
+  return process.env.MEMORIX_AUDIT_FILE || path.join(homedir(), '.memorix', 'audit.json');
+}
+
+export interface AuditEntry {
+  type: 'hook' | 'rule' | 'other';
+  agent?: string;
+  path: string;
+  createdAt: string;
+}
+
+export interface ProjectAudit {
+  projectRoot: string;
+  installedAt: string;
+  entries: AuditEntry[];
+}
+
+export interface AuditData {
+  version: string;
+  projects: Record<string, ProjectAudit>;
+}
+
+/**
+ * Load audit data from disk.
+ */
+export async function loadAudit(): Promise<AuditData> {
+  try {
+    const content = await fs.readFile(getAuditFilePath(), 'utf-8');
+    return JSON.parse(content) as AuditData;
+  } catch {
+    // No audit file yet
+    return {
+      version: '1.0.0',
+      projects: {},
+    };
+  }
+}
+
+/**
+ * Save audit data to disk.
+ */
+export async function saveAudit(data: AuditData): Promise<void> {
+  const auditFile = getAuditFilePath();
+  const dir = path.dirname(auditFile);
+  await fs.mkdir(dir, { recursive: true });
+  await fs.writeFile(auditFile, JSON.stringify(data, null, 2), 'utf-8');
+}
+
+/**
+ * Get project ID from project root via .git detection.
+ */
+export function getProjectId(projectRoot: string): string {
+  try {
+    const { detectProject } = require('../project/detector.js');
+    const project = detectProject(projectRoot);
+    if (project) return project.id;
+  } catch { /* fallback below */ }
+  const normalized = projectRoot.replace(/\\/g, '/');
+  return `untracked/${normalized}`;
+}
+
+/**
+ * Record a file written by Memorix.
+ */
+export async function recordFile(
+  projectRoot: string,
+  type: AuditEntry['type'],
+  filePath: string,
+  agent?: string,
+): Promise<void> {
+  const data = await loadAudit();
+  const projectId = getProjectId(projectRoot);
+
+  if (!data.projects[projectId]) {
+    data.projects[projectId] = {
+      projectRoot,
+      installedAt: new Date().toISOString(),
+      entries: [],
+    };
+  }
+
+  // Check if entry already exists
+  const existingIndex = data.projects[projectId].entries.findIndex(
+    (e) => e.path === filePath
+  );
+
+  if (existingIndex === -1) {
+    data.projects[projectId].entries.push({
+      type,
+      agent,
+      path: filePath,
+      createdAt: new Date().toISOString(),
+    });
+  }
+
+  await saveAudit(data);
+}
+
+/**
+ * Get all files written by Memorix for a project.
+ */
+export async function getProjectFiles(projectRoot: string): Promise<AuditEntry[]> {
+  const data = await loadAudit();
+  const projectId = getProjectId(projectRoot);
+  return data.projects[projectId]?.entries || [];
+}
+
+/**
+ * Remove a file from audit (when uninstalled).
+ */
+export async function removeFile(projectRoot: string, filePath: string): Promise<void> {
+  const data = await loadAudit();
+  const projectId = getProjectId(projectRoot);
+
+  if (!data.projects[projectId]) return;
+
+  data.projects[projectId].entries = data.projects[projectId].entries.filter(
+    (e) => e.path !== filePath
+  );
+
+  // If no entries left, remove the project
+  if (data.projects[projectId].entries.length === 0) {
+    delete data.projects[projectId];
+  }
+
+  await saveAudit(data);
+}
+
+/**
+ * Get all audit entries across all projects.
+ */
+export async function getAllAuditEntries(): Promise<
+  Array<{ projectId: string; entry: AuditEntry }>
+> {
+  const data = await loadAudit();
+  const entries: Array<{ projectId: string; entry: AuditEntry }> = [];
+
+  for (const [projectId, project] of Object.entries(data.projects)) {
+    for (const entry of project.entries) {
+      entries.push({ projectId, entry });
+    }
+  }
+
+  return entries;
+}

package/src/cli/commands/background.ts

@@ -19,9 +19,13 @@
 
 import { defineCommand } from 'citty';
 import * as fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { spawn, execFileSync } from 'node:child_process';
 import { randomBytes } from 'node:crypto';
+import os from 'node:os';
 import { parseTcpPort } from '../port.js';
+import { homeProjectRootError, inheritProjectRootFromHome, isHomeDirectory } from '../../project/launch-root.js';
 
 // ============================================================
 // Paths & Types
@@ -38,6 +42,16 @@ interface BackgroundState {
   startCwd?: string;
 }
 
+export function resolveBackgroundCwd(cwd: string, homeDir: string = os.homedir()): string {
+  if (!isHomeDirectory(cwd, homeDir)) return cwd;
+  const inherited = inheritProjectRootFromHome({
+    homeDir,
+    envProjectRoot: process.env.MEMORIX_PROJECT_ROOT,
+  });
+  if (inherited) return inherited;
+  throw new Error(homeProjectRootError(cwd));
+}
+
 function getMemorixDir(): string {
   const home = process.env.HOME || process.env.USERPROFILE || '';
   // Use join-style path to ensure native separators on Windows
@@ -73,6 +87,33 @@ function parseBackgroundPort(value: string | undefined): number {
   return parseTcpPort(value, 3211);
 }
 
+/**
+ * Resolve the CLI file that `background start` should spawn.
+ * `process.argv[1]` follows the launcher shim and can point at a different
+ * install (for example `$HOME/node_modules/memorix` after `bun add` in $HOME).
+ * When this module is bundled into `dist/cli/index.js`, `../index.js` is the
+ * library stdio entry (`dist/index.js`) — never spawn that.
+ */
+function resolveBackgroundCliEntryFrom(here: string, argv1: string): string {
+  const dir = path.dirname(here);
+  if (path.basename(here) === 'index.js' && path.basename(dir) === 'cli') {
+    return here;
+  }
+  const compiledSibling = path.resolve(dir, '..', 'index.js');
+  if (fs.existsSync(compiledSibling) && path.basename(path.dirname(compiledSibling)) === 'cli') {
+    return compiledSibling;
+  }
+  return argv1;
+}
+
+function resolveBackgroundCliEntry(argv1 = process.argv[1]): string {
+  try {
+    return resolveBackgroundCliEntryFrom(fileURLToPath(import.meta.url), argv1);
+  } catch {
+    return argv1;
+  }
+}
+
 function parseLogLines(value: string | undefined): number {
   return parseBoundedPositiveInteger(value, 50, 'Log line count', 10_000);
 }
@@ -343,13 +384,15 @@ export async function doStart(port: number): Promise<void> {
 
   // 5. Find the memorix CLI entry point
   // We need to spawn `node <cli-entry> serve-http --port <port>`
-  // The entry point is the same binary that's running now
-  const cliEntry = process.argv[1]; // e.g., dist/cli/index.js or node_modules/.bin/memorix
+  // Prefer this package's compiled CLI so a bun/npm shim cannot spawn a
+  // different (often unpatched) memorix from ~/node_modules.
+  const cliEntry = resolveBackgroundCliEntry();
 
   // 6. Start the service without a visible console. A regular non-detached child
   // can be reclaimed with its parent by terminal hosts on Windows; a detached Node
   // child can flash a console. Start-Process gives us a hidden, independent child
   // and its real Node PID. POSIX retains the direct detached child path.
+  const startCwd = resolveBackgroundCwd(process.cwd());
   let pid: number;
   try {
     if (process.platform === 'win32') {
@@ -357,7 +400,7 @@ export async function doStart(port: number): Promise<void> {
         nodePath: process.execPath,
         cliEntry,
         port,
-        cwd: process.cwd(),
+        cwd: startCwd,
         stdoutLogFile: `${logFile}.stdout`,
         stderrLogFile: logFile,
       });
@@ -367,7 +410,7 @@ export async function doStart(port: number): Promise<void> {
         detached: true,
         stdio: ['ignore', logFd, logFd],
         env: { ...process.env },
-        cwd: process.cwd(),
+        cwd: startCwd,
       });
       child.unref();
       fs.closeSync(logFd);
@@ -388,7 +431,7 @@ export async function doStart(port: number): Promise<void> {
     startedAt: new Date().toISOString(),
     logFile,
     instanceToken,
-    startCwd: process.cwd(),
+    startCwd,
   });
 
   // 8. Print essential info immediately
@@ -792,4 +835,7 @@ export const _testing = {
   parseBackgroundPort,
   parseLogLines,
   formatBackgroundCommandError,
+  resolveBackgroundCliEntry,
+  resolveBackgroundCliEntryFrom,
+  resolveBackgroundCwd,
 };

package/src/cli/commands/formation.ts

@@ -1,48 +1,48 @@
-import { defineCommand } from 'citty';
-import { getBeforeAfterMetrics, getMetricsSummary } from '../../memory/formation/index.js';
-import { emitError, emitResult } from './operator-shared.js';
-
-export default defineCommand({
-  meta: {
-    name: 'formation',
-    description: 'Inspect Memory Formation Pipeline runtime metrics',
-  },
-  args: {
-    json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
-  },
-  run: async ({ args }) => {
-    const action = (args._ as string[])?.[0] || '';
-    const asJson = !!args.json;
-
-    try {
-      switch (action) {
-        case 'metrics': {
-          const summary = getMetricsSummary();
-          const beforeAfter = getBeforeAfterMetrics();
-          emitResult(
-            { summary, beforeAfter },
-            summary.total === 0
-              ? 'Formation Pipeline: No metrics collected yet.'
-              : [
-                  'Formation Pipeline Metrics',
-                  `- Total observations processed: ${summary.total}`,
-                  `- Average value score: ${summary.avgValueScore.toFixed(3)}`,
-                  `- Average processing time: ${summary.avgDurationMs.toFixed(1)}ms`,
-                ].join('\n'),
-            asJson,
-          );
-          return;
-        }
-
-        default:
-          console.log('Memorix Formation Commands');
-          console.log('');
-          console.log('Usage:');
-          console.log('  memorix formation metrics');
-      }
-    } catch (error) {
-      emitError(error instanceof Error ? error.message : String(error), asJson);
-    }
-  },
-});
-
+import { defineCommand } from 'citty';
+import { getBeforeAfterMetrics, getMetricsSummary } from '../../memory/formation/index.js';
+import { emitError, emitResult } from './operator-shared.js';
+
+export default defineCommand({
+  meta: {
+    name: 'formation',
+    description: 'Inspect Memory Formation Pipeline runtime metrics',
+  },
+  args: {
+    json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
+  },
+  run: async ({ args }) => {
+    const action = (args._ as string[])?.[0] || '';
+    const asJson = !!args.json;
+
+    try {
+      switch (action) {
+        case 'metrics': {
+          const summary = getMetricsSummary();
+          const beforeAfter = getBeforeAfterMetrics();
+          emitResult(
+            { summary, beforeAfter },
+            summary.total === 0
+              ? 'Formation Pipeline: No metrics collected yet.'
+              : [
+                  'Formation Pipeline Metrics',
+                  `- Total observations processed: ${summary.total}`,
+                  `- Average value score: ${summary.avgValueScore.toFixed(3)}`,
+                  `- Average processing time: ${summary.avgDurationMs.toFixed(1)}ms`,
+                ].join('\n'),
+            asJson,
+          );
+          return;
+        }
+
+        default:
+          console.log('Memorix Formation Commands');
+          console.log('');
+          console.log('Usage:');
+          console.log('  memorix formation metrics');
+      }
+    } catch (error) {
+      emitError(error instanceof Error ? error.message : String(error), asJson);
+    }
+  },
+});
+