memorix 1.9.1 → 1.9.2

package/dist/sdk.js

@@ -10928,7 +10928,8 @@ function clampCursor(afterId) {
 }
 async function loadConsolidationPage(projectId, options) {
   const limit2 = clampBatchSize(options.limit);
-  const page = await getObservationStore().loadByProject(projectId, {
+  const store = options.store ?? getObservationStore();
+  const page = await store.loadByProject(projectId, {
     status: "active",
     afterId: clampCursor(options.afterId),
     limit: limit2 + 1
@@ -10988,7 +10989,7 @@ async function findConsolidationCandidates(_projectDir, projectId, opts) {
   return findClusters(page.observations, threshold);
 }
 async function executeConsolidation(_projectDir, projectId, opts) {
-  const store = getObservationStore();
+  const store = opts?.store ?? getObservationStore();
   const page = await loadConsolidationPage(projectId, opts ?? {});
   const clusters = findClusters(page.observations, opts?.threshold ?? DEFAULT_SIMILARITY_THRESHOLD);
   if (clusters.length === 0) {
@@ -148928,7 +148929,7 @@ __export(lite_provider_exports, {
   refreshProjectLite: () => refreshProjectLite
 });
 import { createHash as createHash10 } from "crypto";
-import { readdirSync as readdirSync2, readFileSync as readFileSync8, statSync as statSync3 } from "fs";
+import { existsSync as existsSync12, readdirSync as readdirSync2, readFileSync as readFileSync8, statSync as statSync3 } from "fs";
 import { join as join4, relative as relative2 } from "path";
 function hashText2(text3) {
   return createHash10("sha256").update(text3).digest("hex");
@@ -148945,6 +148946,9 @@ function resolveMaxFileBytes(value) {
   if (!Number.isFinite(value)) return DEFAULT_CODEGRAPH_MAX_FILE_BYTES;
   return Math.max(1, Math.floor(value));
 }
+function isPythonVirtualenvDir(dir) {
+  return existsSync12(join4(dir, "pyvenv.cfg"));
+}
 function walk(root, exclude, maxFiles) {
   const out = [];
   const visit = (dir) => {
@@ -148962,6 +148966,7 @@ function walk(root, exclude, maxFiles) {
       if (entry.isDirectory()) {
         if (entry.name === ".git" || entry.name === ".worktrees" || entry.name === ".tmp" || entry.name === "node_modules") continue;
         if (rel === ".claude/worktrees" || rel.startsWith(".claude/worktrees/")) continue;
+        if (isPythonVirtualenvDir(abs)) continue;
         visit(abs);
         if (out.length >= maxFiles) return;
         continue;
@@ -152858,7 +152863,7 @@ __export(vector_backfill_runner_exports, {
 import { spawn as spawn4 } from "child_process";
 import {
   closeSync,
-  existsSync as existsSync12,
+  existsSync as existsSync13,
   mkdirSync as mkdirSync2,
   openSync,
   readFileSync as readFileSync9,
@@ -152986,7 +152991,7 @@ function releaseVectorBackfillLock(lockPath = process.env.MEMORIX_VECTOR_BACKFIL
 }
 function launchDetachedVectorBackfill(request, options = {}) {
   const runnerPath = options.runnerPath ?? resolveVectorBackfillRunnerPath();
-  const exists = options.exists ?? existsSync12;
+  const exists = options.exists ?? existsSync13;
   if (!exists(runnerPath)) return false;
   const lock = acquireVectorBackfillLock(request.dataDir, request.projectId, options.lockPath);
   if (!lock) return false;
@@ -155664,7 +155669,7 @@ __export(behavior_exports, {
   getBehaviorConfig: () => getBehaviorConfig,
   resetBehaviorConfigCache: () => resetBehaviorConfigCache
 });
-import { existsSync as existsSync15, readFileSync as readFileSync11 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync11 } from "fs";
 import { homedir as homedir22 } from "os";
 function isSessionInject(value) {
   return value === "full" || value === "minimal" || value === "silent";
@@ -155675,7 +155680,7 @@ function isFormationMode(value) {
 function legacyBehavior(homeDir) {
   const configPath = getLegacyConfigJsonPath(homeDir);
   try {
-    if (!existsSync15(configPath)) return {};
+    if (!existsSync16(configPath)) return {};
     const parsed = JSON.parse(readFileSync11(configPath, "utf-8"));
     return parsed.behavior && typeof parsed.behavior === "object" && !Array.isArray(parsed.behavior) ? parsed.behavior : {};
   } catch {
@@ -157029,11 +157034,11 @@ __export(current_facts_exports, {
   formatGitFact: () => formatGitFact
 });
 import { execFileSync } from "child_process";
-import { existsSync as existsSync16, readFileSync as readFileSync12 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync12 } from "fs";
 import path29 from "path";
 function readTextIfExists(filePath) {
   try {
-    if (!existsSync16(filePath)) return null;
+    if (!existsSync17(filePath)) return null;
     return readFileSync12(filePath, "utf8");
   } catch {
     return null;
@@ -157324,7 +157329,7 @@ __export(external_provider_exports, {
   runExternalCodeGraphLifecycle: () => runExternalCodeGraphLifecycle
 });
 import { spawn as spawn5 } from "child_process";
-import { existsSync as existsSync17, readFileSync as readFileSync13 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync13 } from "fs";
 import { delimiter, dirname as dirname2, extname, isAbsolute as isAbsolute3, join as join20, relative as relative4, resolve as resolve3, sep } from "path";
 function boundedTimeout(value) {
   if (!Number.isFinite(value)) return DEFAULT_EXTERNAL_CODEGRAPH_TIMEOUT_MS;
@@ -157361,13 +157366,13 @@ function resolveCommandCandidates(command) {
 }
 function resolveLaunch(command) {
   for (const candidate of resolveCommandCandidates(command)) {
-    if (!existsSync17(candidate)) continue;
+    if (!existsSync18(candidate)) continue;
     const extension3 = extname(candidate).toLowerCase();
     if (extension3 === ".cmd") {
       const bundleRoot = resolve3(dirname2(candidate), "..");
       const node = join20(bundleRoot, "node.exe");
       const entry = join20(bundleRoot, "lib", "dist", "bin", "codegraph.js");
-      if (existsSync17(node) && existsSync17(entry)) {
+      if (existsSync18(node) && existsSync18(entry)) {
         return { executable: node, prefixArgs: ["--liftoff-only", entry] };
       }
       try {
@@ -157376,7 +157381,7 @@ function resolveLaunch(command) {
         if (match2?.[1]) {
           const base = dirname2(candidate).endsWith(sep) ? dirname2(candidate) : dirname2(candidate) + sep;
           const entry2 = resolve3(match2[1].replace(/%(?:~)?dp0%?/gi, base));
-          if (existsSync17(entry2)) return { executable: process.execPath, prefixArgs: [entry2] };
+          if (existsSync18(entry2)) return { executable: process.execPath, prefixArgs: [entry2] };
         }
       } catch {
       }
@@ -157524,7 +157529,7 @@ async function inspectExternalCodeGraph(input) {
     const health2 = { state: "disabled", reason: "External CodeGraph is disabled by configuration." };
     return { health: health2, quality: providerQuality({ mode, health: health2 }) };
   }
-  if (!existsSync17(join20(input.projectRoot, ".codegraph"))) {
+  if (!existsSync18(join20(input.projectRoot, ".codegraph"))) {
     const health2 = { state: "not-detected", reason: "No local .codegraph index is present for this project." };
     return { health: health2, quality: providerQuality({ mode, health: health2 }) };
   }
@@ -157560,7 +157565,7 @@ async function runExternalCodeGraphLifecycle(input) {
     };
   }
   const indexPath = join20(input.projectRoot, ".codegraph");
-  if (input.action === "sync" && !existsSync17(indexPath)) {
+  if (input.action === "sync" && !existsSync18(indexPath)) {
     const health = { state: "not-detected", reason: "No local .codegraph index is present for this project." };
     return {
       action: input.action,
@@ -157570,7 +157575,7 @@ async function runExternalCodeGraphLifecycle(input) {
       quality: providerQuality({ mode, health })
     };
   }
-  if (input.action === "init" && existsSync17(indexPath)) {
+  if (input.action === "init" && existsSync18(indexPath)) {
     const inspected2 = await inspectExternalCodeGraph(input);
     return {
       action: input.action,
@@ -158631,7 +158636,7 @@ __export(auto_context_exports, {
   formatAutoProjectContextSummary: () => formatAutoProjectContextSummary,
   formatLegacyAutoProjectContextPrompt: () => formatLegacyAutoProjectContextPrompt
 });
-import { existsSync as existsSync18, statSync as statSync5 } from "fs";
+import { existsSync as existsSync19, statSync as statSync5 } from "fs";
 import path30 from "path";
 function activeProjectObservations(observations2, projectId) {
   return observations2.filter((obs) => obs.projectId === projectId && (obs.status ?? "active") === "active");
@@ -158977,7 +158982,7 @@ function existingLensCandidates(rootPath, lens) {
   for (const candidate of lensPathCandidates(lens)) {
     const absolute = path30.join(rootPath, candidate);
     try {
-      if (!existsSync18(absolute)) continue;
+      if (!existsSync19(absolute)) continue;
       const stat5 = statSync5(absolute);
       if (stat5.isFile()) out.push(candidate);
       if (stat5.isDirectory()) out.push(candidate.replace(/\\/g, "/"));
@@ -159511,7 +159516,7 @@ var engine_exports2 = {};
 __export(engine_exports2, {
   SkillsEngine: () => SkillsEngine
 });
-import { existsSync as existsSync19, readFileSync as readFileSync14, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, readdirSync as readdirSync4 } from "fs";
+import { existsSync as existsSync20, readFileSync as readFileSync14, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, readdirSync as readdirSync4 } from "fs";
 import { join as join21 } from "path";
 import { homedir as homedir23 } from "os";
 var SKILLS_DIRS, SKILL_WORTHY_TYPES, MIN_OBS_FOR_SKILL, MIN_SCORE_FOR_SKILL, LOW_SIGNAL_TITLE_PATTERNS, LOW_SIGNAL_ENTITY_PATTERNS, COMMAND_TRACE_PATTERNS2, SkillsEngine;
@@ -159592,7 +159597,7 @@ var init_engine3 = __esm({
               paths.push(join21(home, dir));
             }
             for (const skillsRoot of paths) {
-              if (!existsSync19(skillsRoot)) continue;
+              if (!existsSync20(skillsRoot)) continue;
               try {
                 const entries = readdirSync4(skillsRoot, { withFileTypes: true });
                 for (const entry of entries) {
@@ -159600,7 +159605,7 @@ var init_engine3 = __esm({
                   const name = entry.name;
                   if (seen.has(name)) continue;
                   const skillMd = join21(skillsRoot, name, "SKILL.md");
-                  if (!existsSync19(skillMd)) continue;
+                  if (!existsSync20(skillMd)) continue;
                   try {
                     const content = readFileSync14(skillMd, "utf-8");
                     const description = this.parseDescription(content);
@@ -161401,7 +161406,8 @@ async function executeDeduplicate(context, payload, token) {
 async function previewConsolidate(context) {
   const clusters = await findConsolidationCandidates(
     context.projectRoot ?? context.dataDir,
-    context.projectId
+    context.projectId,
+    { store: context.store }
   );
   const payload = { clusterIds: normalizeClusters(clusters.map((cluster) => cluster.ids)) };
   return {
@@ -161424,11 +161430,19 @@ async function executeConsolidate(context, payload, token) {
   const clusterIds = record80.clusterIds.map((ids, index) => payloadIds(ids, `clusterIds[${index}]`));
   const normalized = { clusterIds: normalizeClusters(clusterIds) };
   verify("consolidate", context.projectId, normalized, token);
-  const current = await findConsolidationCandidates(context.projectRoot ?? context.dataDir, context.projectId);
+  const current = await findConsolidationCandidates(
+    context.projectRoot ?? context.dataDir,
+    context.projectId,
+    { store: context.store }
+  );
   if (JSON.stringify(normalized.clusterIds) !== JSON.stringify(normalizeClusters(current.map((cluster) => cluster.ids)))) {
     throw new DashboardMaintenanceError("Memory changed after the preview. Refresh before consolidating.", 409);
   }
-  const result = await executeConsolidation(context.projectRoot ?? context.dataDir, context.projectId);
+  const result = await executeConsolidation(
+    context.projectRoot ?? context.dataDir,
+    context.projectId,
+    { store: context.store }
+  );
   return { action: "consolidate", projectId: context.projectId, ...result };
 }
 async function retentionCandidates(context) {
@@ -162585,7 +162599,7 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
       }
       case "/config": {
         const os6 = await import("os");
-        const { existsSync: existsSync22 } = await import("fs");
+        const { existsSync: existsSync23 } = await import("fs");
         const { join: join25 } = await import("path");
         const configProjectRoot = effectiveProjectRoot;
         const resolved = getResolvedConfig({ projectRoot: configProjectRoot });
@@ -162613,7 +162627,7 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
             if (fpath === null) {
               files[key] = { exists: false, path: "unavailable", unavailable: true };
             } else {
-              files[key] = { exists: existsSync22(fpath), path: fpath };
+              files[key] = { exists: existsSync23(fpath), path: fpath };
             }
           }
         } catch {
@@ -163423,7 +163437,7 @@ var init_task_graph = __esm({
 
 // src/orchestrate/context-collector.ts
 import { execFileSync as execFileSync2 } from "child_process";
-import { readFileSync as readFileSync15, existsSync as existsSync20 } from "fs";
+import { readFileSync as readFileSync15, existsSync as existsSync21 } from "fs";
 import { join as join22 } from "path";
 function normalizeEntryLimit(value, fallback) {
   if (!Number.isSafeInteger(value) || value < 1) return fallback;
@@ -163500,7 +163514,7 @@ function collectFileTree(projectDir2, maxEntries) {
 function collectDependencies(projectDir2) {
   try {
     const pkgPath = join22(projectDir2, "package.json");
-    if (!existsSync20(pkgPath)) return "";
+    if (!existsSync21(pkgPath)) return "";
     const pkg = JSON.parse(readFileSync15(pkgPath, "utf-8"));
     const parts = [];
     if (pkg.dependencies && Object.keys(pkg.dependencies).length > 0) {
@@ -166001,11 +166015,11 @@ __export(hooks_path_exports, {
   resolveGitDir: () => resolveGitDir,
   resolveHooksDir: () => resolveHooksDir
 });
-import { existsSync as existsSync21, readFileSync as readFileSync16, statSync as statSync6, mkdirSync as mkdirSync6 } from "fs";
+import { existsSync as existsSync22, readFileSync as readFileSync16, statSync as statSync6, mkdirSync as mkdirSync6 } from "fs";
 import path35 from "path";
 function resolveGitDir(projectRoot) {
   const dotGit = path35.join(projectRoot, ".git");
-  if (!existsSync21(dotGit)) return null;
+  if (!existsSync22(dotGit)) return null;
   const stat5 = statSync6(dotGit);
   if (stat5.isDirectory()) {
     return dotGit;
@@ -166017,7 +166031,7 @@ function resolveGitDir(projectRoot) {
       if (match2) {
         const gitdir = match2[1].trim();
         const resolved = path35.isAbsolute(gitdir) ? gitdir : path35.resolve(projectRoot, gitdir);
-        if (existsSync21(resolved)) {
+        if (existsSync22(resolved)) {
           return resolved;
         }
       }
@@ -168233,7 +168247,7 @@ var RulesSyncer = class {
 
 // src/workspace/engine.ts
 init_esm_shims();
-import { readFileSync as readFileSync10, readdirSync as readdirSync3, existsSync as existsSync14, cpSync, mkdirSync as mkdirSync4 } from "fs";
+import { readFileSync as readFileSync10, readdirSync as readdirSync3, existsSync as existsSync15, cpSync, mkdirSync as mkdirSync4 } from "fs";
 import { join as join19 } from "path";
 import { homedir as homedir21 } from "os";
 
@@ -169185,7 +169199,7 @@ function sanitize(input) {
 
 // src/workspace/applier.ts
 init_esm_shims();
-import { existsSync as existsSync13, mkdirSync as mkdirSync3, copyFileSync, writeFileSync as writeFileSync3, unlinkSync as unlinkSync2, renameSync } from "fs";
+import { existsSync as existsSync14, mkdirSync as mkdirSync3, copyFileSync, writeFileSync as writeFileSync3, unlinkSync as unlinkSync2, renameSync } from "fs";
 import { dirname } from "path";
 var WorkspaceSyncApplier = class {
   /**
@@ -169211,7 +169225,7 @@ var WorkspaceSyncApplier = class {
     for (const file of files) {
       try {
         const dir = dirname(file.filePath);
-        if (!existsSync13(dir)) {
+        if (!existsSync14(dir)) {
           mkdirSync3(dir, { recursive: true });
         }
       } catch (err) {
@@ -169220,7 +169234,7 @@ var WorkspaceSyncApplier = class {
       }
     }
     for (const file of files) {
-      if (existsSync13(file.filePath)) {
+      if (existsSync14(file.filePath)) {
         try {
           const backupPath = file.filePath + `.backup-${Date.now()}`;
           copyFileSync(file.filePath, backupPath);
@@ -169271,7 +169285,7 @@ var WorkspaceSyncApplier = class {
   cleanBackups(backups) {
     for (const backup of backups) {
       try {
-        if (existsSync13(backup.backupPath)) {
+        if (existsSync14(backup.backupPath)) {
           unlinkSync2(backup.backupPath);
         }
       } catch {
@@ -169336,7 +169350,7 @@ var WorkspaceSyncEngine = class _WorkspaceSyncEngine {
       }
       const merged = /* @__PURE__ */ new Map();
       for (const path36 of pathsToCheck) {
-        if (existsSync14(path36)) {
+        if (existsSync15(path36)) {
           try {
             const content = readFileSync10(path36, "utf-8");
             const servers = adapter.parse(content);
@@ -169390,7 +169404,7 @@ var WorkspaceSyncEngine = class _WorkspaceSyncEngine {
       const adapter = this.adapters.get(target);
       const configPath = adapter.getConfigPath(this.projectRoot);
       let configContent;
-      if (target === "antigravity" && existsSync14(configPath)) {
+      if (target === "antigravity" && existsSync15(configPath)) {
         try {
           const existing = JSON.parse(readFileSync10(configPath, "utf-8"));
           const generated = JSON.parse(adapter.generate(result.mcpServers.scanned));
@@ -169466,13 +169480,13 @@ var WorkspaceSyncEngine = class _WorkspaceSyncEngine {
           join19(home, dir)
         ];
         for (const skillsRoot of paths) {
-          if (!existsSync14(skillsRoot)) continue;
+          if (!existsSync15(skillsRoot)) continue;
           try {
             const entries = readdirSync3(skillsRoot, { withFileTypes: true });
             for (const entry of entries) {
               if (!entry.isDirectory()) continue;
               const skillMd = join19(skillsRoot, entry.name, "SKILL.md");
-              if (!existsSync14(skillMd)) continue;
+              if (!existsSync15(skillMd)) continue;
               let description = "";
               try {
                 const content = readFileSync10(skillMd, "utf-8");
@@ -169521,7 +169535,7 @@ var WorkspaceSyncEngine = class _WorkspaceSyncEngine {
     for (const skill2 of skills) {
       if (skill2.sourceAgent === target) continue;
       const dest = join19(targetDir, skill2.name);
-      if (existsSync14(dest)) {
+      if (existsSync15(dest)) {
         skipped.push(`${skill2.name} (already exists in ${target})`);
         continue;
       }
@@ -169537,7 +169551,7 @@ var WorkspaceSyncEngine = class _WorkspaceSyncEngine {
   scanWorkflows() {
     const workflows = [];
     const wfDir = join19(this.projectRoot, ".windsurf", "workflows");
-    if (!existsSync14(wfDir)) return workflows;
+    if (!existsSync15(wfDir)) return workflows;
     try {
       const files = readdirSync3(wfDir).filter((f3) => f3.endsWith(".md"));
       for (const file of files) {
@@ -169882,7 +169896,7 @@ var MCP_SERVER_INFO_META_KEY = "io.modelcontextprotocol/serverInfo";
 function getMcpServerInfo() {
   return {
     name: "memorix",
-    version: true ? "1.9.1" : "1.0.1"
+    version: true ? "1.9.2" : "1.0.1"
   };
 }
 function createMcpDiscoverResult(capabilities, serverInfo) {
@@ -174499,10 +174513,10 @@ Preview: ${analysis.description.slice(0, 300)}${analysis.description.length > 30
         const { ensureHooksDir: ensureHooksDir2 } = await Promise.resolve().then(() => (init_hooks_path(), hooks_path_exports));
         const resolved = ensureHooksDir2(project.rootPath);
         if (resolved) {
-          const { existsSync: existsSync22, readFileSync: readFileSync17, writeFileSync: writeFileSync5, chmodSync } = await import("fs");
+          const { existsSync: existsSync23, readFileSync: readFileSync17, writeFileSync: writeFileSync5, chmodSync } = await import("fs");
           const { hookPath } = resolved;
           const HOOK_MARKER = "# [memorix-git-hook]";
-          const needsInstall = !existsSync22(hookPath) || !readFileSync17(hookPath, "utf-8").includes(HOOK_MARKER);
+          const needsInstall = !existsSync23(hookPath) || !readFileSync17(hookPath, "utf-8").includes(HOOK_MARKER);
           if (needsInstall) {
             const hookScript = `#!/bin/sh
 ${HOOK_MARKER}
@@ -174511,7 +174525,7 @@ if command -v memorix >/dev/null 2>&1; then
   memorix ingest commit --auto >/dev/null 2>&1 &
 fi
 `;
-            if (existsSync22(hookPath)) {
+            if (existsSync23(hookPath)) {
               const existing = readFileSync17(hookPath, "utf-8");
               writeFileSync5(hookPath, existing.trimEnd() + `
 

package/dist/vector-backfill-runner.js

@@ -11716,7 +11716,8 @@ function clampCursor(afterId) {
 }
 async function loadConsolidationPage(projectId, options) {
   const limit2 = clampBatchSize(options.limit);
-  const page = await getObservationStore().loadByProject(projectId, {
+  const store = options.store ?? getObservationStore();
+  const page = await store.loadByProject(projectId, {
     status: "active",
     afterId: clampCursor(options.afterId),
     limit: limit2 + 1
@@ -11776,7 +11777,7 @@ async function findConsolidationCandidates(_projectDir, projectId, opts) {
   return findClusters(page.observations, threshold);
 }
 async function executeConsolidation(_projectDir, projectId, opts) {
-  const store = getObservationStore();
+  const store = opts?.store ?? getObservationStore();
   const page = await loadConsolidationPage(projectId, opts ?? {});
   const clusters = findClusters(page.observations, opts?.threshold ?? DEFAULT_SIMILARITY_THRESHOLD);
   if (clusters.length === 0) {
@@ -148353,7 +148354,7 @@ __export(lite_provider_exports, {
   refreshProjectLite: () => refreshProjectLite
 });
 import { createHash as createHash10 } from "crypto";
-import { readdirSync as readdirSync2, readFileSync as readFileSync8, statSync as statSync3 } from "fs";
+import { existsSync as existsSync11, readdirSync as readdirSync2, readFileSync as readFileSync8, statSync as statSync3 } from "fs";
 import { join as join4, relative as relative2 } from "path";
 function hashText2(text2) {
   return createHash10("sha256").update(text2).digest("hex");
@@ -148370,6 +148371,9 @@ function resolveMaxFileBytes(value) {
   if (!Number.isFinite(value)) return DEFAULT_CODEGRAPH_MAX_FILE_BYTES;
   return Math.max(1, Math.floor(value));
 }
+function isPythonVirtualenvDir(dir) {
+  return existsSync11(join4(dir, "pyvenv.cfg"));
+}
 function walk(root, exclude, maxFiles) {
   const out = [];
   const visit = (dir) => {
@@ -148387,6 +148391,7 @@ function walk(root, exclude, maxFiles) {
       if (entry.isDirectory()) {
         if (entry.name === ".git" || entry.name === ".worktrees" || entry.name === ".tmp" || entry.name === "node_modules") continue;
         if (rel === ".claude/worktrees" || rel.startsWith(".claude/worktrees/")) continue;
+        if (isPythonVirtualenvDir(abs)) continue;
         visit(abs);
         if (out.length >= maxFiles) return;
         continue;
@@ -151749,7 +151754,7 @@ __export(vector_backfill_runner_exports, {
 import { spawn as spawn3 } from "child_process";
 import {
   closeSync,
-  existsSync as existsSync11,
+  existsSync as existsSync12,
   mkdirSync as mkdirSync2,
   openSync,
   readFileSync as readFileSync9,
@@ -151877,7 +151882,7 @@ function releaseVectorBackfillLock(lockPath = process.env.MEMORIX_VECTOR_BACKFIL
 }
 function launchDetachedVectorBackfill(request, options = {}) {
   const runnerPath = options.runnerPath ?? resolveVectorBackfillRunnerPath();
-  const exists = options.exists ?? existsSync11;
+  const exists = options.exists ?? existsSync12;
   if (!exists(runnerPath)) return false;
   const lock = acquireVectorBackfillLock(request.dataDir, request.projectId, options.lockPath);
   if (!lock) return false;

package/docs/INTEGRATIONS.md

@@ -122,6 +122,10 @@ If an agent only needs a raw stdio MCP entry:
 
 Avoid `npx` in persistent MCP configs. Use the globally installed `memorix` binary so startup is predictable.
 
+For npm-based MCP clients or registry testers, the complete package command is
+`npx -y memorix serve`. Do not omit `serve`: bare `memorix` is the interactive
+memcode entry in a human terminal.
+
 For HTTP mode:
 
 ```bash

package/docs/SETUP.md

@@ -170,6 +170,11 @@ Generic stdio MCP config:
 
 Avoid `npx` in persistent MCP configs. Use the globally installed `memorix` binary so startup is predictable.
 
+When an npm-based MCP client or registry tester must launch the package
+directly, use `npx -y memorix serve`. The explicit `serve` argument selects
+the stdio MCP server; a human running bare `memorix` in a terminal gets the
+bundled memcode agent instead.
+
 ### Option C: memcode terminal agent
 
 ```bash

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorix",
   "mcpName": "io.github.AVIDS2/memorix",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
   "type": "module",
   "sideEffects": false,
@@ -77,7 +77,6 @@
     "benchmark:codegraph:scale": "node scripts/benchmark-codegraph-scale.mjs",
     "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",
     "sync:plugin-release": "node scripts/sync-plugin-release-manifests.mjs",

package/plugins/antigravity/memorix/plugin.json

@@ -1,4 +1,4 @@
 {
   "name": "memorix",
-  "version": "1.9.1"
+  "version": "1.9.2"
 }

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.9.1",
+  "version": "1.9.2",
   "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.9.1",
+  "version": "1.9.2",
   "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.9.1",
+  "version": "1.9.2",
   "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.9.1",
+  "version": "1.9.2",
   "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.9.1",
+  "version": "1.9.2",
   "mcpServers": {
     "memorix": {
       "command": "memorix",

package/plugins/hermes/memorix/plugin.yaml

@@ -1,5 +1,5 @@
 name: memorix
-version: "1.9.1"
+version: "1.9.2"
 description: Shared workspace memory bridge for Hermes Agent.
 author: AVIDS2
 license: Apache-2.0

package/plugins/omp/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-omp-package",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "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.9.1",
+  "version": "1.9.2",
   "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.9.1",
+  "version": "1.9.2",
   "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.9.1",
+  "version": "1.9.2",
   "websiteUrl": "https://mem.rglens.com",
   "icons": [
     {
@@ -22,7 +22,7 @@
     {
       "registryType": "npm",
       "identifier": "memorix",
-      "version": "1.9.1",
+      "version": "1.9.2",
       "runtimeHint": "npx",
       "packageArguments": [
         {

package/src/cli/commands/memory.ts

@@ -280,7 +280,8 @@ export default defineCommand({
         case 'deduplicate': {
           const query = asStringArg(args.query);
           const dryRun = !!args.dryRun || !!args['dry-run'];
-          const { isLLMEnabled } = await import('../../llm/provider.js');
+          const { initLLM, isLLMEnabled } = await import('../../llm/provider.js');
+          initLLM({ scope: 'memory', projectRoot: project.rootPath });
           if (!isLLMEnabled()) {
             emitResult(
               { project, available: false, usedLLM: false },

package/src/cli/default-mode.ts

@@ -0,0 +1,15 @@
+export interface CliInteractivity {
+  stdinIsTTY?: boolean;
+  stdoutIsTTY?: boolean;
+}
+
+/**
+ * MCP hosts start package commands with piped stdio, while a human terminal
+ * has TTYs on both streams. Keep the friendly memcode default for humans and
+ * make the package safe for registry probes and generic MCP launchers.
+ */
+export function shouldDefaultToMcp(options: CliInteractivity = {}): boolean {
+  const stdinIsTTY = options.stdinIsTTY ?? process.stdin.isTTY;
+  const stdoutIsTTY = options.stdoutIsTTY ?? process.stdout.isTTY;
+  return stdinIsTTY !== true || stdoutIsTTY !== true;
+}