cortex-engine 0.4.1 → 0.5.0

package/dist/bin/maintain-cmd.js

@@ -0,0 +1,352 @@
+/**
+ * maintain-cmd.ts — fozikio maintain command.
+ *
+ * Subcommands:
+ *   fozikio maintain fix              Scan and repair data issues
+ *   fozikio maintain re-embed         Re-embed all memories with current provider
+ *   fozikio maintain re-embed --dry-run  Show what would be re-embedded
+ *
+ * Flags:
+ *   --dry-run     Show what would change without writing
+ *   --limit N     Max memories to process (default: 500)
+ *   --collection  memories | observations (for re-embed, default: memories)
+ *   --null-only   Re-embed only docs with null/empty embeddings
+ *   --verbose     Detailed per-item output
+ */
+import { loadConfig } from './config-loader.js';
+import { createStore, createEmbedProvider } from './store-factory.js';
+function parseArgs(args) {
+    const subcommand = args[0] && !args[0].startsWith('--') ? args[0] : null;
+    const rest = subcommand ? args.slice(1) : args;
+    let dryRun = false;
+    let limit = 500;
+    let collection = 'memories';
+    let nullOnly = false;
+    let verbose = false;
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        if (arg === '--dry-run') {
+            dryRun = true;
+        }
+        else if (arg === '--null-only') {
+            nullOnly = true;
+        }
+        else if (arg === '--verbose') {
+            verbose = true;
+        }
+        else if (arg === '--limit' && rest[i + 1]) {
+            const parsed = parseInt(rest[++i], 10);
+            if (!isNaN(parsed) && parsed > 0)
+                limit = parsed;
+        }
+        else if (arg === '--collection' && rest[i + 1]) {
+            const val = rest[++i];
+            if (val === 'observations')
+                collection = 'observations';
+        }
+    }
+    return { subcommand, dryRun, limit, collection, nullOnly, verbose };
+}
+/**
+ * Strip LLM output artifacts that leaked into definitions in older cortex versions.
+ * Pattern: "YES\n\nDefinition:" or "YES\n\nUpdated Definition:" or "YES:" prefix.
+ */
+function stripYesPrefix(text) {
+    return text
+        .replace(/^YES[:\s]*\n*(?:Updated\s+)?(?:Definition[:\s]*)?\n*/i, '')
+        .trim();
+}
+/**
+ * Detect whether a memory that is categorized as 'topic' or 'belief' should
+ * be re-categorized based on keyword heuristics.
+ */
+function detectBetterCategory(name, definition, currentCategory) {
+    if (currentCategory !== 'topic' && currentCategory !== 'belief')
+        return null;
+    const text = `${name} ${definition}`.toLowerCase();
+    const valueSignals = [
+        'loyalty', 'honesty', 'transparency', 'integrity', 'absolute transparency',
+        'no hidden state', 'genuinely useful', 'usefulness over', 'continuity matters',
+        'grow genuinely', 'worth having around', 'honest about limits',
+    ];
+    const hasValueSignal = valueSignals.some(s => text.includes(s)) || /\bvalue[sd]?\b/.test(text);
+    const patternSignals = [
+        'disposition', 'tendency', 'practical and direct', 'pushes back',
+        'read before acting', 'tinkerer', 'goes wide before', 'go wide before',
+    ];
+    const hasPatternSignal = patternSignals.some(s => text.includes(s));
+    if (hasValueSignal)
+        return 'value';
+    if (currentCategory === 'topic' && hasPatternSignal)
+        return 'pattern';
+    return null;
+}
+async function runFix(args) {
+    const config = loadConfig();
+    const store = await createStore(config);
+    console.log('[maintain fix] Scanning memories for data issues...');
+    const memories = await store.getAllMemories();
+    console.log(`[maintain fix] Loaded ${memories.length} memories`);
+    const issuesList = [];
+    for (const memory of memories) {
+        const issues = [];
+        const fixes = {};
+        // Check 1: Missing or empty definition
+        if (!memory.definition || memory.definition.trim().length === 0) {
+            issues.push('empty definition');
+            fixes['definition'] = memory.name; // fallback to name
+        }
+        // Check 2: YES prefix artifact in definition
+        const cleanDef = stripYesPrefix(memory.definition ?? '');
+        if (cleanDef !== (memory.definition ?? '')) {
+            issues.push('YES prefix artifact in definition');
+            fixes['definition'] = cleanDef;
+        }
+        // Check 3: Missing embedding (null or empty array)
+        const hasEmbedding = Array.isArray(memory.embedding) && memory.embedding.length > 0;
+        if (!hasEmbedding) {
+            issues.push('missing embedding');
+            // Cannot fix here — use re-embed subcommand
+        }
+        // Check 4: Salience out of range
+        if (typeof memory.salience === 'number' && (memory.salience < 0 || memory.salience > 1)) {
+            issues.push(`salience out of range: ${memory.salience}`);
+            fixes['salience'] = Math.max(0, Math.min(1, memory.salience));
+        }
+        // Check 5: Null access_count
+        if (memory.access_count == null || typeof memory.access_count !== 'number') {
+            issues.push('null access_count');
+            fixes['access_count'] = 0;
+        }
+        // Check 6: Miscategorized identity memories (topic/belief that should be value/pattern)
+        const defToCheck = fixes['definition'] ?? memory.definition ?? '';
+        const betterCat = detectBetterCategory(memory.name, defToCheck, memory.category);
+        if (betterCat) {
+            issues.push(`miscategorized: '${memory.category}' should be '${betterCat}'`);
+            fixes['category'] = betterCat;
+        }
+        if (issues.length > 0) {
+            issuesList.push({ id: memory.id, name: memory.name, issues, fixes });
+        }
+    }
+    if (issuesList.length === 0) {
+        console.log('[maintain fix] No issues found.');
+        return;
+    }
+    // Separate fixable from unfixable
+    const fixable = issuesList.filter(item => Object.keys(item.fixes).length > 0);
+    const unfixable = issuesList.filter(item => Object.keys(item.fixes).length === 0);
+    console.log(`\n[maintain fix] Found ${issuesList.length} memories with issues:`);
+    console.log(`  Fixable: ${fixable.length}`);
+    console.log(`  Needs manual attention: ${unfixable.length} (missing embeddings — run re-embed)`);
+    if (unfixable.length > 0 && args.verbose) {
+        console.log('\nMemories needing re-embed:');
+        for (const item of unfixable) {
+            console.log(`  [${item.id}] ${item.name.slice(0, 60)}: ${item.issues.join(', ')}`);
+        }
+    }
+    if (fixable.length === 0) {
+        console.log('\n[maintain fix] Nothing to fix automatically.');
+        return;
+    }
+    if (args.dryRun) {
+        console.log('\n[maintain fix] Dry run — would apply these fixes:');
+        for (const item of fixable) {
+            console.log(`  [${item.id}] ${item.name.slice(0, 55)}`);
+            for (const issue of item.issues.filter(i => !i.includes('missing embedding'))) {
+                console.log(`    - ${issue}`);
+            }
+            const fixKeys = Object.keys(item.fixes);
+            console.log(`    fixes: ${fixKeys.join(', ')}`);
+        }
+        return;
+    }
+    let applied = 0;
+    let failed = 0;
+    console.log('\n[maintain fix] Applying fixes...');
+    for (const item of fixable) {
+        try {
+            await store.updateMemory(item.id, item.fixes);
+            if (args.verbose) {
+                console.log(`  [OK] ${item.name.slice(0, 60)} — fixed: ${Object.keys(item.fixes).join(', ')}`);
+            }
+            applied++;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`  [FAIL] ${item.name.slice(0, 60)}: ${msg}`);
+            failed++;
+        }
+    }
+    console.log(`\n[maintain fix] Done.`);
+    console.log(`  Applied: ${applied}`);
+    console.log(`  Failed:  ${failed}`);
+    if (unfixable.length > 0) {
+        console.log(`  Skipped (needs re-embed): ${unfixable.length}`);
+        console.log(`  Run: fozikio maintain re-embed --null-only`);
+    }
+}
+// ─── re-embed subcommand ──────────────────────────────────────────────────────
+const EMBED_DELAY_MS = parseInt(process.env['EMBED_DELAY_MS'] ?? '200', 10);
+const ABORT_THRESHOLD = 5;
+async function runReEmbed(args) {
+    const config = loadConfig();
+    const store = await createStore(config);
+    const embed = await createEmbedProvider(config);
+    console.log(`[maintain re-embed] Provider: ${embed.name} (${embed.dimensions}d)`);
+    console.log(`[maintain re-embed] Collection: ${args.collection}`);
+    console.log(`[maintain re-embed] Limit: ${args.limit}`);
+    if (args.nullOnly)
+        console.log('[maintain re-embed] Filter: null/empty embeddings only');
+    if (args.dryRun)
+        console.log('[maintain re-embed] DRY RUN — no writes');
+    console.log('');
+    let docs;
+    let totalFetched;
+    if (args.collection === 'memories') {
+        const all = await store.getAllMemories();
+        const filtered = args.nullOnly
+            ? all.filter(m => !Array.isArray(m.embedding) || m.embedding.length === 0)
+            : all;
+        docs = filtered.slice(0, args.limit);
+        totalFetched = all.length;
+    }
+    else {
+        // observations — use generic query
+        const filters = args.nullOnly
+            ? [{ field: 'embedding', op: '==', value: null }]
+            : [];
+        const rawDocs = await store.query('observations', filters, { limit: args.limit });
+        docs = rawDocs;
+        totalFetched = docs.length;
+    }
+    console.log(`[maintain re-embed] Fetched ${totalFetched} total, processing ${docs.length}`);
+    console.log('');
+    let updated = 0;
+    let skipped = 0;
+    let failed = 0;
+    let consecutiveFailures = 0;
+    for (const doc of docs) {
+        const isMemory = args.collection === 'memories';
+        const name = isMemory
+            ? doc.name ?? doc.id
+            : doc.content?.slice(0, 60) ?? doc.id;
+        const label = name.slice(0, 60);
+        // Build embed input
+        let embedInput;
+        if (isMemory) {
+            const m = doc;
+            embedInput = `${m.name ?? ''}: ${m.definition ?? ''}`;
+        }
+        else {
+            const o = doc;
+            embedInput = o.content ?? '';
+        }
+        if (!embedInput || embedInput.trim().length < 10) {
+            if (args.verbose)
+                console.log(`  Skip (empty): ${label}`);
+            skipped++;
+            continue;
+        }
+        if (args.dryRun) {
+            console.log(`  Would re-embed: ${label} (${embedInput.length} chars)`);
+            updated++;
+            continue;
+        }
+        // Embed
+        let embedding;
+        try {
+            process.stdout.write(`  ${label} ... `);
+            embedding = await embed.embed(embedInput);
+            console.log(`OK (${embedding.length}d)`);
+            consecutiveFailures = 0;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.log(`FAILED: ${msg}`);
+            failed++;
+            consecutiveFailures++;
+            if (consecutiveFailures >= ABORT_THRESHOLD) {
+                console.error(`[maintain re-embed] ${ABORT_THRESHOLD} consecutive failures — aborting.`);
+                console.error('[maintain re-embed] Check that your embed provider is running and credentials are set.');
+                process.exit(1);
+            }
+            continue;
+        }
+        // Write back
+        try {
+            if (isMemory) {
+                await store.updateMemory(doc.id, { embedding });
+            }
+            else {
+                await store.update('observations', doc.id, {
+                    embedding,
+                    updated_at: new Date(),
+                });
+            }
+            updated++;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`  Write failed for ${label}: ${msg}`);
+            failed++;
+        }
+        if (EMBED_DELAY_MS > 0) {
+            await new Promise(r => setTimeout(r, EMBED_DELAY_MS));
+        }
+    }
+    console.log('');
+    console.log('[maintain re-embed] ─────────────────────────────────');
+    console.log(`[maintain re-embed] Updated:  ${updated}`);
+    console.log(`[maintain re-embed] Skipped:  ${skipped}`);
+    console.log(`[maintain re-embed] Failed:   ${failed}`);
+    if (args.dryRun) {
+        console.log('[maintain re-embed] (Dry run — no writes performed)');
+    }
+}
+// ─── Help ─────────────────────────────────────────────────────────────────────
+function printMaintainHelp() {
+    process.stderr.write(`fozikio maintain — data maintenance for cortex stores
+
+Usage:
+  fozikio maintain fix                 Scan and repair data issues
+  fozikio maintain re-embed            Re-embed memories with current provider
+  fozikio maintain re-embed --dry-run  Show what would be re-embedded
+
+Fix flags:
+  --dry-run     Show issues and fixes without writing
+  --verbose     Show detail per memory
+
+Re-embed flags:
+  --dry-run               Show what would be re-embedded without writing
+  --null-only             Only re-embed docs with missing/null embeddings
+  --limit N               Max docs to process (default: 500)
+  --collection <name>     memories | observations (default: memories)
+  --verbose               Show detail per doc
+
+Environment:
+  EMBED_DELAY_MS          Delay between embed calls in ms (default: 200)
+`);
+}
+// ─── Main Export ─────────────────────────────────────────────────────────────
+export async function runMaintain(args) {
+    const parsed = parseArgs(args);
+    switch (parsed.subcommand) {
+        case 'fix':
+            await runFix(parsed);
+            break;
+        case 're-embed':
+            await runReEmbed(parsed);
+            break;
+        case null:
+        case undefined:
+            printMaintainHelp();
+            process.exit(1);
+            break;
+        default:
+            process.stderr.write(`[fozikio maintain] Unknown subcommand: ${parsed.subcommand}\n\n`);
+            printMaintainHelp();
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=maintain-cmd.js.map

package/dist/bin/maintain-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintain-cmd.js","sourceRoot":"","sources":["../../src/bin/maintain-cmd.ts"],"names":[],"mappings":"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"}

package/dist/bin/report-cmd.d.ts

@@ -0,0 +1,17 @@
+/**
+ * report-cmd.ts — fozikio report command.
+ *
+ * Generates a weekly quality report across five layers:
+ *   1. Memory health — salience distribution, staleness, FSRS states
+ *   2. Observation health — unprocessed count, prediction error coverage
+ *   3. Retrieval quality — retry rate, intent distribution (via threads)
+ *   4. Cognitive integration — edge density, observation prediction errors
+ *   5. Session quality — ops volume, open threads, resolved threads
+ *
+ * Usage:
+ *   fozikio report
+ *   fozikio report --days 14
+ *   fozikio report --json
+ */
+export declare function runReport(args: string[]): Promise<void>;
+//# sourceMappingURL=report-cmd.d.ts.map

package/dist/bin/report-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-cmd.d.ts","sourceRoot":"","sources":["../../src/bin/report-cmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmFH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyQ7D"}