memorix 1.1.7 → 1.1.9

package/src/cli/commands/cleanup.ts

@@ -1,255 +1,255 @@
-/**
- * CLI Command: memorix cleanup
- *
- * Identifies and removes low-quality auto-generated observations.
- * Also detects and archives demo/test/system-self pollution.
- * Inspired by Mem0's memory consolidation and Graphiti's temporal pruning.
- *
- * Usage:
- *   memorix cleanup                — Interactive: preview & confirm deletion of low-quality
- *   memorix cleanup --noise        — Also archive demo/test/Memorix-self pollution
- *   memorix cleanup --dry          — Preview only, no changes
- *   memorix cleanup --force        — Apply without confirmation
- *   memorix cleanup --project X    — Target a specific projectId
- */
-
-import { defineCommand } from 'citty';
-import { detectProject } from '../../project/detector.js';
-import { getProjectDataDir } from '../../store/persistence.js';
-import { getObservationStore, initObservationStore } from '../../store/obs-store.js';
-
-/** Patterns that indicate auto-generated, low-value observations */
-const LOW_QUALITY_PATTERNS = [
-    /^Session activity/i,
-    /^Updated \S+\.\w+$/i,
-    /^Created \S+\.\w+$/i,
-    /^Deleted \S+\.\w+$/i,
-    /^Modified \S+\.\w+$/i,
-    /^Ran command:/i,
-    /^Read file:/i,
-];
-
-/** Patterns for demo/test noise — matches session.ts NOISE_PATTERNS */
-const NOISE_PATTERNS = [
-    /\[测试\]/i, /\[test\]/i, /验证/i, /兼容/i, /\bcompat(?:ibility)?\b/i,
-    /\bdemo\b/i, /展示/i, /全能力/i, /handoff/i, /交接/i,
-    /for_memmcp_test/i, /\bbenchmark\b/i, /\bsandbox\b/i, /\bplayground\b/i,
-];
-
-/** Patterns for Memorix system self-reference — should not pollute unrelated projects */
-const SYSTEM_SELF_PATTERNS = [
-    /memorix.demo/i, /memorix.*全能力/i, /memorix.*工具.*能力/i,
-    /memorix.*runtime.*mode/i, /memorix.*运行模式/i, /memorix.*control.plane/i,
-    /session.*inject(?:ion)?/i, /注入.*逻辑/i,
-    /\b22\s*(?:个|tools?).*(?:工具|能力|capabilit)/i,
-    /memorix.*(?:v\d|版本|version)/i, /memorix.*(?:兼容|compat)/i,
-    /memorix.*(?:测试|test)/i, /memmcp/i,
-];
-
-/** Check if an observation title matches low-quality patterns */
-function isLowQuality(title: string): boolean {
-    return LOW_QUALITY_PATTERNS.some(p => p.test(title.trim()));
-}
-
-/** Check if observation text matches noise/demo/test/system-self patterns */
-function isNoisePollution(obs: { title?: string; narrative?: string; entityName?: string; facts?: string[]; concepts?: string[] }): { isNoise: boolean; reason: string } {
-    const text = [obs.title, obs.narrative, obs.entityName, ...(obs.facts ?? []), ...(obs.concepts ?? [])]
-        .filter(Boolean).join('\n');
-    for (const p of SYSTEM_SELF_PATTERNS) {
-        if (p.test(text)) return { isNoise: true, reason: 'system-self' };
-    }
-    for (const p of NOISE_PATTERNS) {
-        if (p.test(text)) return { isNoise: true, reason: 'demo/test/noise' };
-    }
-    return { isNoise: false, reason: '' };
-}
-
-export default defineCommand({
-    meta: {
-        name: 'cleanup',
-        description: 'Remove low-quality auto-generated observations',
-    },
-    args: {
-        dry: {
-            type: 'boolean',
-            description: 'Preview only — do not delete anything',
-            default: false,
-        },
-        force: {
-            type: 'boolean',
-            description: 'Delete without confirmation',
-            default: false,
-        },
-        noise: {
-            type: 'boolean',
-            description: 'Also archive demo/test/system-self pollution observations',
-            default: false,
-        },
-        project: {
-            type: 'string',
-            description: 'Target a specific projectId (e.g., AVIDS2/blog)',
-        },
-    },
-    async run({ args }) {
-        let projectId: string;
-        let projectName: string;
-
-        if (args.project) {
-            projectId = args.project;
-            projectName = args.project.split('/').pop() || args.project;
-        } else {
-            const project = detectProject();
-            if (!project) {
-                console.error('[ERROR] No .git found — not a project directory.');
-                console.error('Use --project <id> to target a specific project, or run from a git repo.');
-                process.exit(1);
-            }
-            projectId = project.id;
-            projectName = project.name;
-        }
-
-        console.log(`\nProject: ${projectName} (${projectId})\n`);
-
-        const dataDir = await getProjectDataDir(projectId);
-        await initObservationStore(dataDir);
-        const allObs = await getObservationStore().loadAll() as Array<{
-            id?: number;
-            type?: string;
-            title?: string;
-            narrative?: string;
-            entityName?: string;
-            facts?: string[];
-            concepts?: string[];
-            timestamp?: string;
-            projectId?: string;
-            status?: string;
-        }>;
-
-        if (allObs.length === 0) {
-            console.log('[OK] No observations found - nothing to clean up.');
-            return;
-        }
-
-        // Filter to project-scoped observations only
-        const projectObs = allObs.filter(o => o.projectId === projectId && (o.status ?? 'active') === 'active');
-
-        // Categorize: low-quality
-        const lowQuality = projectObs.filter(o => isLowQuality(o.title ?? ''));
-        const highQuality = projectObs.filter(o => !isLowQuality(o.title ?? ''));
-
-        // Find duplicates (same title + type + entity)
-        const seen = new Set<string>();
-        const duplicates: typeof projectObs = [];
-        const unique: typeof projectObs = [];
-        for (const obs of highQuality) {
-            const key = `${obs.type}|${obs.title}|${obs.entityName}`;
-            if (seen.has(key)) {
-                duplicates.push(obs);
-            } else {
-                seen.add(key);
-                unique.push(obs);
-            }
-        }
-
-        // Find noise pollution (demo/test/system-self)
-        const noiseHits: Array<{ obs: typeof projectObs[0]; reason: string }> = [];
-        if (args.noise) {
-            for (const obs of projectObs) {
-                if (lowQuality.includes(obs) || duplicates.includes(obs)) continue;
-                const { isNoise, reason } = isNoisePollution(obs);
-                if (isNoise) noiseHits.push({ obs, reason });
-            }
-        }
-
-        const toRemove = [...lowQuality, ...duplicates];
-        const toArchive = noiseHits.map(h => h.obs);
-
-        console.log(`Analysis (active observations for ${projectId}):`);
-        console.log(`   Total active:       ${projectObs.length}`);
-        console.log(`   High quality:       ${unique.length - toArchive.length}`);
-        console.log(`   Low quality:        ${lowQuality.length}`);
-        console.log(`   Duplicates:         ${duplicates.length}`);
-        if (args.noise) {
-            console.log(`   Noise pollution:    ${toArchive.length}`);
-        }
-        console.log(`   To delete:          ${toRemove.length}`);
-        if (args.noise) {
-            console.log(`   To archive:         ${toArchive.length}`);
-        }
-        console.log();
-
-        if (toRemove.length === 0 && toArchive.length === 0) {
-            console.log('[OK] All observations are clean — nothing to clean up!');
-            return;
-        }
-
-        // Preview deletions
-        if (toRemove.length > 0) {
-            console.log('Items to DELETE:');
-            toRemove.slice(0, 10).forEach(o => {
-                const tag = isLowQuality(o.title ?? '') ? '(low-quality)' : '(duplicate)';
-                console.log(`   ${tag} #${o.id ?? '?'} "${o.title}" [${o.type}]`);
-            });
-            if (toRemove.length > 10) {
-                console.log(`   ... and ${toRemove.length - 10} more`);
-            }
-            console.log();
-        }
-
-        // Preview noise archival
-        if (toArchive.length > 0) {
-            console.log('Items to ARCHIVE (noise pollution):');
-            noiseHits.slice(0, 15).forEach(({ obs, reason }) => {
-                console.log(`   (${reason}) #${obs.id ?? '?'} "${obs.title}" [${obs.type}] entity=${obs.entityName}`);
-            });
-            if (toArchive.length > 15) {
-                console.log(`   ... and ${toArchive.length - 15} more`);
-            }
-            console.log();
-        }
-
-        if (args.dry) {
-            console.log('[DRY RUN] No changes made.');
-            return;
-        }
-
-        if (!args.force) {
-            const readline = await import('node:readline');
-            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-            const desc = [
-                toRemove.length > 0 ? `delete ${toRemove.length}` : '',
-                toArchive.length > 0 ? `archive ${toArchive.length}` : '',
-            ].filter(Boolean).join(' and ');
-            const answer = await new Promise<string>(resolve => {
-                rl.question(`Proceed to ${desc} observations? (y/N) `, resolve);
-            });
-            rl.close();
-
-            if (answer.trim().toLowerCase() !== 'y') {
-                console.log('Cancelled.');
-                return;
-            }
-        }
-
-        // Archive noise observations (set status to 'archived' instead of deleting)
-        const archiveIds = new Set(toArchive.map(o => o.id));
-        let archivedCount = 0;
-        for (const obs of allObs) {
-            if (archiveIds.has(obs.id)) {
-                (obs as any).status = 'archived';
-                archivedCount++;
-            }
-        }
-
-        // Delete low-quality/duplicate observations
-        const removeIds = new Set(toRemove.map(o => JSON.stringify(o)));
-        const remaining = allObs.filter(o => !removeIds.has(JSON.stringify(o)));
-
-        await getObservationStore().bulkReplace(remaining as any);
-
-        const parts: string[] = [];
-        if (toRemove.length > 0) parts.push(`deleted ${toRemove.length}`);
-        if (archivedCount > 0) parts.push(`archived ${archivedCount}`);
-        console.log(`[OK] ${parts.join(', ')}. ${remaining.length} observations remaining.`);
-    },
-});
+/**
+ * CLI Command: memorix cleanup
+ *
+ * Identifies and removes low-quality auto-generated observations.
+ * Also detects and archives demo/test/system-self pollution.
+ * Inspired by Mem0's memory consolidation and Graphiti's temporal pruning.
+ *
+ * Usage:
+ *   memorix cleanup                — Interactive: preview & confirm deletion of low-quality
+ *   memorix cleanup --noise        — Also archive demo/test/Memorix-self pollution
+ *   memorix cleanup --dry          — Preview only, no changes
+ *   memorix cleanup --force        — Apply without confirmation
+ *   memorix cleanup --project X    — Target a specific projectId
+ */
+
+import { defineCommand } from 'citty';
+import { detectProject } from '../../project/detector.js';
+import { getProjectDataDir } from '../../store/persistence.js';
+import { getObservationStore, initObservationStore } from '../../store/obs-store.js';
+
+/** Patterns that indicate auto-generated, low-value observations */
+const LOW_QUALITY_PATTERNS = [
+    /^Session activity/i,
+    /^Updated \S+\.\w+$/i,
+    /^Created \S+\.\w+$/i,
+    /^Deleted \S+\.\w+$/i,
+    /^Modified \S+\.\w+$/i,
+    /^Ran command:/i,
+    /^Read file:/i,
+];
+
+/** Patterns for demo/test noise — matches session.ts NOISE_PATTERNS */
+const NOISE_PATTERNS = [
+    /\[测试\]/i, /\[test\]/i, /验证/i, /兼容/i, /\bcompat(?:ibility)?\b/i,
+    /\bdemo\b/i, /展示/i, /全能力/i, /handoff/i, /交接/i,
+    /for_memmcp_test/i, /\bbenchmark\b/i, /\bsandbox\b/i, /\bplayground\b/i,
+];
+
+/** Patterns for Memorix system self-reference — should not pollute unrelated projects */
+const SYSTEM_SELF_PATTERNS = [
+    /memorix.demo/i, /memorix.*全能力/i, /memorix.*工具.*能力/i,
+    /memorix.*runtime.*mode/i, /memorix.*运行模式/i, /memorix.*control.plane/i,
+    /session.*inject(?:ion)?/i, /注入.*逻辑/i,
+    /\b22\s*(?:个|tools?).*(?:工具|能力|capabilit)/i,
+    /memorix.*(?:v\d|版本|version)/i, /memorix.*(?:兼容|compat)/i,
+    /memorix.*(?:测试|test)/i, /memmcp/i,
+];
+
+/** Check if an observation title matches low-quality patterns */
+function isLowQuality(title: string): boolean {
+    return LOW_QUALITY_PATTERNS.some(p => p.test(title.trim()));
+}
+
+/** Check if observation text matches noise/demo/test/system-self patterns */
+function isNoisePollution(obs: { title?: string; narrative?: string; entityName?: string; facts?: string[]; concepts?: string[] }): { isNoise: boolean; reason: string } {
+    const text = [obs.title, obs.narrative, obs.entityName, ...(obs.facts ?? []), ...(obs.concepts ?? [])]
+        .filter(Boolean).join('\n');
+    for (const p of SYSTEM_SELF_PATTERNS) {
+        if (p.test(text)) return { isNoise: true, reason: 'system-self' };
+    }
+    for (const p of NOISE_PATTERNS) {
+        if (p.test(text)) return { isNoise: true, reason: 'demo/test/noise' };
+    }
+    return { isNoise: false, reason: '' };
+}
+
+export default defineCommand({
+    meta: {
+        name: 'cleanup',
+        description: 'Remove low-quality auto-generated observations',
+    },
+    args: {
+        dry: {
+            type: 'boolean',
+            description: 'Preview only — do not delete anything',
+            default: false,
+        },
+        force: {
+            type: 'boolean',
+            description: 'Delete without confirmation',
+            default: false,
+        },
+        noise: {
+            type: 'boolean',
+            description: 'Also archive demo/test/system-self pollution observations',
+            default: false,
+        },
+        project: {
+            type: 'string',
+            description: 'Target a specific projectId (e.g., AVIDS2/blog)',
+        },
+    },
+    async run({ args }) {
+        let projectId: string;
+        let projectName: string;
+
+        if (args.project) {
+            projectId = args.project;
+            projectName = args.project.split('/').pop() || args.project;
+        } else {
+            const project = detectProject();
+            if (!project) {
+                console.error('[ERROR] No .git found — not a project directory.');
+                console.error('Use --project <id> to target a specific project, or run from a git repo.');
+                process.exit(1);
+            }
+            projectId = project.id;
+            projectName = project.name;
+        }
+
+        console.log(`\nProject: ${projectName} (${projectId})\n`);
+
+        const dataDir = await getProjectDataDir(projectId);
+        await initObservationStore(dataDir);
+        const allObs = await getObservationStore().loadAll() as Array<{
+            id?: number;
+            type?: string;
+            title?: string;
+            narrative?: string;
+            entityName?: string;
+            facts?: string[];
+            concepts?: string[];
+            timestamp?: string;
+            projectId?: string;
+            status?: string;
+        }>;
+
+        if (allObs.length === 0) {
+            console.log('[OK] No observations found - nothing to clean up.');
+            return;
+        }
+
+        // Filter to project-scoped observations only
+        const projectObs = allObs.filter(o => o.projectId === projectId && (o.status ?? 'active') === 'active');
+
+        // Categorize: low-quality
+        const lowQuality = projectObs.filter(o => isLowQuality(o.title ?? ''));
+        const highQuality = projectObs.filter(o => !isLowQuality(o.title ?? ''));
+
+        // Find duplicates (same title + type + entity)
+        const seen = new Set<string>();
+        const duplicates: typeof projectObs = [];
+        const unique: typeof projectObs = [];
+        for (const obs of highQuality) {
+            const key = `${obs.type}|${obs.title}|${obs.entityName}`;
+            if (seen.has(key)) {
+                duplicates.push(obs);
+            } else {
+                seen.add(key);
+                unique.push(obs);
+            }
+        }
+
+        // Find noise pollution (demo/test/system-self)
+        const noiseHits: Array<{ obs: typeof projectObs[0]; reason: string }> = [];
+        if (args.noise) {
+            for (const obs of projectObs) {
+                if (lowQuality.includes(obs) || duplicates.includes(obs)) continue;
+                const { isNoise, reason } = isNoisePollution(obs);
+                if (isNoise) noiseHits.push({ obs, reason });
+            }
+        }
+
+        const toRemove = [...lowQuality, ...duplicates];
+        const toArchive = noiseHits.map(h => h.obs);
+
+        console.log(`Analysis (active observations for ${projectId}):`);
+        console.log(`   Total active:       ${projectObs.length}`);
+        console.log(`   High quality:       ${unique.length - toArchive.length}`);
+        console.log(`   Low quality:        ${lowQuality.length}`);
+        console.log(`   Duplicates:         ${duplicates.length}`);
+        if (args.noise) {
+            console.log(`   Noise pollution:    ${toArchive.length}`);
+        }
+        console.log(`   To delete:          ${toRemove.length}`);
+        if (args.noise) {
+            console.log(`   To archive:         ${toArchive.length}`);
+        }
+        console.log();
+
+        if (toRemove.length === 0 && toArchive.length === 0) {
+            console.log('[OK] All observations are clean — nothing to clean up!');
+            return;
+        }
+
+        // Preview deletions
+        if (toRemove.length > 0) {
+            console.log('Items to DELETE:');
+            toRemove.slice(0, 10).forEach(o => {
+                const tag = isLowQuality(o.title ?? '') ? '(low-quality)' : '(duplicate)';
+                console.log(`   ${tag} #${o.id ?? '?'} "${o.title}" [${o.type}]`);
+            });
+            if (toRemove.length > 10) {
+                console.log(`   ... and ${toRemove.length - 10} more`);
+            }
+            console.log();
+        }
+
+        // Preview noise archival
+        if (toArchive.length > 0) {
+            console.log('Items to ARCHIVE (noise pollution):');
+            noiseHits.slice(0, 15).forEach(({ obs, reason }) => {
+                console.log(`   (${reason}) #${obs.id ?? '?'} "${obs.title}" [${obs.type}] entity=${obs.entityName}`);
+            });
+            if (toArchive.length > 15) {
+                console.log(`   ... and ${toArchive.length - 15} more`);
+            }
+            console.log();
+        }
+
+        if (args.dry) {
+            console.log('[DRY RUN] No changes made.');
+            return;
+        }
+
+        if (!args.force) {
+            const readline = await import('node:readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const desc = [
+                toRemove.length > 0 ? `delete ${toRemove.length}` : '',
+                toArchive.length > 0 ? `archive ${toArchive.length}` : '',
+            ].filter(Boolean).join(' and ');
+            const answer = await new Promise<string>(resolve => {
+                rl.question(`Proceed to ${desc} observations? (y/N) `, resolve);
+            });
+            rl.close();
+
+            if (answer.trim().toLowerCase() !== 'y') {
+                console.log('Cancelled.');
+                return;
+            }
+        }
+
+        // Archive noise observations (set status to 'archived' instead of deleting)
+        const archiveIds = new Set(toArchive.map(o => o.id));
+        let archivedCount = 0;
+        for (const obs of allObs) {
+            if (archiveIds.has(obs.id)) {
+                (obs as any).status = 'archived';
+                archivedCount++;
+            }
+        }
+
+        // Delete low-quality/duplicate observations
+        const removeIds = new Set(toRemove.map(o => JSON.stringify(o)));
+        const remaining = allObs.filter(o => !removeIds.has(JSON.stringify(o)));
+
+        await getObservationStore().bulkReplace(remaining as any);
+
+        const parts: string[] = [];
+        if (toRemove.length > 0) parts.push(`deleted ${toRemove.length}`);
+        if (archivedCount > 0) parts.push(`archived ${archivedCount}`);
+        console.log(`[OK] ${parts.join(', ')}. ${remaining.length} observations remaining.`);
+    },
+});

package/src/cli/commands/codegraph.ts

@@ -3,6 +3,7 @@ import { CodeGraphStore } from '../../codegraph/store.js';
 import { indexProjectLite } from '../../codegraph/lite-provider.js';
 import { assembleContextPackForTask, buildContextPackPrompt } from '../../codegraph/context-pack.js';
 import { backfillMissingObservationCodeRefs } from '../../codegraph/binder.js';
+import { getResolvedConfig } from '../../config/resolved-config.js';
 import { getAllObservations } from '../../memory/observations.js';
 import { emitError, emitResult, getCliProjectContext, parsePositiveInt } from './operator-shared.js';
 
@@ -49,6 +50,7 @@ export default defineCommand({
       const store = new CodeGraphStore();
       await store.init(dataDir);
       const explicitAction = Boolean(positional[0] || (args.action as string | undefined));
+      const exclude = getResolvedConfig({ projectRoot: project.rootPath }).codegraph.excludePatterns;
 
       switch (action) {
         case 'status': {
@@ -64,6 +66,7 @@ export default defineCommand({
           const indexed = await indexProjectLite({
             projectId: project.id,
             projectRoot: project.rootPath,
+            exclude,
           });
           store.replaceProjectIndex(project.id, indexed);
           const activeObservations = getAllObservations()
@@ -99,6 +102,7 @@ export default defineCommand({
             task,
             observations,
             limit,
+            exclude,
           });
           emitResult({ project, pack }, buildContextPackPrompt(pack), asJson);
           return;

package/src/cli/commands/config-get.ts

@@ -29,12 +29,19 @@ export default defineCommand({
 function readDotted(source: Record<string, unknown>, key: string): unknown {
   let cursor: unknown = source;
   for (const part of key.split('.')) {
-    if (!cursor || typeof cursor !== 'object' || !(part in cursor)) return undefined;
-    cursor = (cursor as Record<string, unknown>)[part];
+    if (!cursor || typeof cursor !== 'object') return undefined;
+    const record = cursor as Record<string, unknown>;
+    const normalizedPart = part in record ? part : snakeToCamel(part);
+    if (!(normalizedPart in record)) return undefined;
+    cursor = record[normalizedPart];
   }
   return cursor;
 }
 
+function snakeToCamel(value: string): string {
+  return value.replace(/_([a-z])/g, (_, char: string) => char.toUpperCase());
+}
+
 function formatValue(value: unknown, key: string): string {
   if (typeof value === 'string') return shouldRedactKey(key) ? '<redacted>' : value;
   if (typeof value === 'number' || typeof value === 'boolean') return String(value);

package/src/cli/commands/doctor.ts

@@ -13,6 +13,14 @@ export default defineCommand({
     description: 'Diagnose Memorix health — project identity, embedding, data, conflicts',
   },
   args: {
+    agent: {
+      type: 'string',
+      description: 'Agent to inspect for "doctor agents" (default: all)',
+    },
+    scope: {
+      type: 'string',
+      description: 'Scope for "doctor agents": local, project, global, or all',
+    },
     json: {
       type: 'boolean',
       description: 'Output as JSON instead of human-readable text',
@@ -25,6 +33,21 @@ export default defineCommand({
     },
   },
   run: async ({ args }) => {
+    const positional = (args._ as string[]) ?? [];
+    if (positional[0] === 'agents') {
+      const { inspectAgentIntegrations, formatAgentIntegrationReport } = await import('./agent-integrations.js');
+      const report = await inspectAgentIntegrations({
+        agent: args.agent as string | undefined,
+        scope: args.scope as string | undefined,
+      });
+      if (args.json) {
+        console.log(JSON.stringify({ agents: report }, null, 2));
+      } else {
+        console.log(formatAgentIntegrationReport(report));
+      }
+      return;
+    }
+
     const { existsSync, readFileSync } = await import('node:fs');
     const { join, basename } = await import('node:path');
     const { homedir } = await import('node:os');
@@ -295,8 +318,10 @@ export default defineCommand({
       try {
         const { CodeGraphStore } = await import('../../codegraph/store.js');
         const { buildProjectContextOverview } = await import('../../codegraph/project-context.js');
+        const { getResolvedConfig } = await import('../../config/resolved-config.js');
         const codeStore = new CodeGraphStore();
         await codeStore.init(dataDir);
+        const exclude = getResolvedConfig({ projectRoot: projectRoot || process.cwd() }).codegraph.excludePatterns;
         const overview = buildProjectContextOverview({
           project: {
             id: projectId,
@@ -305,6 +330,7 @@ export default defineCommand({
           },
           store: codeStore,
           observations: projectObservations,
+          exclude,
         });
         const languageText = overview.code.languages.length > 0
           ? overview.code.languages.map((item: any) => `${item.language} ${item.files}`).join(', ')