monomind 2.7.12 → 2.7.13

package/packages/@monomind/cli/dist/src/commands/memory-list.js

@@ -1,321 +0,0 @@
-/**
- * Memory List Commands
- * formatRelativeTime, listCommand, editCommand, templatesCommand
- */
-import { output } from '../output.js';
-import { input } from '../prompt.js';
-// Helper function to format relative time
-export function formatRelativeTime(isoDate) {
-    const now = Date.now();
-    const date = new Date(isoDate).getTime();
-    const diff = now - date;
-    const seconds = Math.floor(diff / 1000);
-    const minutes = Math.floor(seconds / 60);
-    const hours = Math.floor(minutes / 60);
-    const days = Math.floor(hours / 24);
-    if (days > 0)
-        return `${days}d ago`;
-    if (hours > 0)
-        return `${hours}h ago`;
-    if (minutes > 0)
-        return `${minutes}m ago`;
-    return 'just now';
-}
-// List command
-export const listCommand = {
-    name: 'list',
-    aliases: ['ls'],
-    description: 'List memory entries',
-    options: [
-        {
-            name: 'namespace',
-            short: 'n',
-            description: 'Filter by namespace',
-            type: 'string'
-        },
-        {
-            name: 'tags',
-            short: 't',
-            description: 'Filter by tags (comma-separated)',
-            type: 'string'
-        },
-        {
-            name: 'limit',
-            short: 'l',
-            description: 'Maximum entries',
-            type: 'number',
-            default: 20
-        }
-    ],
-    action: async (ctx) => {
-        const namespace = ctx.flags.namespace;
-        const limit = ctx.flags.limit;
-        // Use sql.js directly for consistent data access
-        try {
-            const { listEntries } = await import('../memory/memory-initializer.js');
-            const listResult = await listEntries({ namespace, limit, offset: 0 });
-            if (!listResult.success) {
-                output.printError(`Failed to list: ${listResult.error}`);
-                return { success: false, exitCode: 1 };
-            }
-            // Format entries for display
-            const entries = listResult.entries.map(e => ({
-                key: e.key,
-                namespace: e.namespace,
-                size: e.size + ' B',
-                vector: e.hasEmbedding ? '✓' : '-',
-                accessCount: e.accessCount,
-                updated: formatRelativeTime(e.updatedAt)
-            }));
-            if (ctx.flags.format === 'json') {
-                output.printJson(listResult.entries);
-                return { success: true, data: listResult.entries };
-            }
-            output.writeln();
-            output.writeln(output.bold('Memory Entries'));
-            output.writeln();
-            if (entries.length === 0) {
-                output.printWarning('No entries found');
-                output.printInfo('Store data: monomind memory store -k "key" --value "data"');
-                return { success: true, data: [] };
-            }
-            output.printTable({
-                columns: [
-                    { key: 'key', header: 'Key', width: 25 },
-                    { key: 'namespace', header: 'Namespace', width: 12 },
-                    { key: 'size', header: 'Size', width: 10, align: 'right' },
-                    { key: 'vector', header: 'Vector', width: 8, align: 'center' },
-                    { key: 'accessCount', header: 'Accessed', width: 10, align: 'right' },
-                    { key: 'updated', header: 'Updated', width: 12 }
-                ],
-                data: entries
-            });
-            output.writeln();
-            output.printInfo(`Showing ${entries.length} of ${listResult.total} entries`);
-            return { success: true, data: listResult.entries };
-        }
-        catch (error) {
-            output.printError(`Failed to list: ${error instanceof Error ? error.message : 'Unknown error'}`);
-            return { success: false, exitCode: 1 };
-        }
-    }
-};
-// Edit command
-export const editCommand = {
-    name: 'edit',
-    description: 'Edit a memory entry (SQLite-backed, Memory Palace, or knowledge chunk)',
-    options: [
-        { name: 'key', short: 'k', description: 'Storage key', type: 'string' },
-        { name: 'namespace', short: 'n', description: 'Memory namespace', type: 'string', default: 'default' },
-        { name: 'value', description: 'New value/content', type: 'string' },
-        { name: 'source', short: 's', description: 'Source to edit: lancedb, palace, knowledge', type: 'string', default: 'lancedb', choices: ['lancedb', 'palace', 'knowledge'] },
-        { name: 'id', description: 'Entry ID (palace/knowledge)', type: 'string' }
-    ],
-    examples: [
-        { command: 'monomind memory edit -k "pattern/auth" --value "updated content"', description: 'Edit SQLite-backed entry' },
-        { command: 'monomind memory edit --source palace --id "abc123" --value "new content"', description: 'Edit Memory Palace drawer' },
-        { command: 'monomind memory edit --source knowledge --id "chunk-42" --value "updated"', description: 'Edit knowledge chunk' }
-    ],
-    action: async (ctx) => {
-        const source = ctx.flags.source || 'lancedb';
-        let value = ctx.flags.value || ctx.args[0];
-        const fs = await import('fs');
-        const path = await import('path');
-        if (source === 'lancedb') {
-            const key = ctx.flags.key;
-            const namespace = ctx.flags.namespace || 'default';
-            if (!key) {
-                output.printError('Key is required for lancedb edit. Use --key or -k');
-                return { success: false, exitCode: 1 };
-            }
-            if (!value && ctx.interactive) {
-                value = await input({ message: 'Enter new value:', validate: v => v.length > 0 || 'Value required' });
-            }
-            if (!value) {
-                output.printError('Value is required. Use --value');
-                return { success: false, exitCode: 1 };
-            }
-            try {
-                const { storeEntry } = await import('../memory/memory-initializer.js');
-                const result = await storeEntry({ key, value, namespace, generateEmbeddingFlag: true, upsert: true });
-                if (!result.success) {
-                    output.printError(result.error || 'Failed to update');
-                    return { success: false, exitCode: 1 };
-                }
-                output.printSuccess(`Updated "${key}" in namespace "${namespace}"`);
-                return { success: true, data: result };
-            }
-            catch (error) {
-                output.printError(`Failed to edit: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                return { success: false, exitCode: 1 };
-            }
-        }
-        // palace or knowledge — JSONL file edit
-        const id = ctx.flags.id;
-        if (!id) {
-            output.printError('Entry ID is required for palace/knowledge edit. Use --id');
-            return { success: false, exitCode: 1 };
-        }
-        if (!/^[a-zA-Z0-9_\-]{1,128}$/.test(id)) {
-            output.printError('ID must be 1-128 chars: alphanumeric, underscore, or hyphen only');
-            return { success: false, exitCode: 1 };
-        }
-        const filePath = source === 'palace'
-            ? path.join(process.cwd(), '.monomind', 'palace', 'drawers.jsonl')
-            : path.join(process.cwd(), '.monomind', 'knowledge', 'chunks.jsonl');
-        if (!fs.existsSync(filePath)) {
-            output.printError(`File not found: ${filePath}`);
-            return { success: false, exitCode: 1 };
-        }
-        const MAX_MEMORY_FILE_BYTES = 50 * 1024 * 1024; // 50 MB
-        if (fs.statSync(filePath).size > MAX_MEMORY_FILE_BYTES) {
-            output.printError(`Memory file too large (> 50 MB): ${filePath}`);
-            return { success: false, exitCode: 1 };
-        }
-        let entries;
-        try {
-            const raw = fs.readFileSync(filePath, 'utf8');
-            entries = [];
-            for (const line of raw.split('\n').filter(Boolean)) {
-                try {
-                    entries.push(JSON.parse(line));
-                }
-                catch {
-                    output.printError(`Malformed JSONL entry in ${source} file`);
-                    return { success: false, exitCode: 1 };
-                }
-            }
-        }
-        catch (err) {
-            output.printError(`Failed to read ${source} file: ${err instanceof Error ? err.message : 'Unknown error'}`);
-            return { success: false, exitCode: 1 };
-        }
-        const idx = entries.findIndex(e => e.id === id);
-        if (idx === -1) {
-            output.printWarning(`Entry not found with id "${id}"`);
-            return { success: false, exitCode: 1 };
-        }
-        if (!value && ctx.interactive) {
-            output.writeln(output.dim('Current content:'));
-            output.writeln(entries[idx].content || '(empty)');
-            output.writeln();
-            value = await input({ message: 'Enter new content:', validate: v => v.length > 0 || 'Content required' });
-        }
-        if (!value) {
-            output.printError('Value is required. Use --value');
-            return { success: false, exitCode: 1 };
-        }
-        entries[idx] = { ...entries[idx], content: value, ts: new Date().toISOString() };
-        try {
-            const tmpPath = filePath + '.tmp';
-            fs.writeFileSync(tmpPath, entries.map(e => JSON.stringify(e)).join('\n') + '\n');
-            fs.renameSync(tmpPath, filePath);
-            output.printSuccess(`Updated ${source} entry "${id}"`);
-            return { success: true, data: entries[idx] };
-        }
-        catch (err) {
-            output.printError(`Failed to write ${source} file: ${err instanceof Error ? err.message : 'Unknown error'}`);
-            return { success: false, exitCode: 1 };
-        }
-    }
-};
-// Templates command
-export const templatesCommand = {
-    name: 'templates',
-    description: 'Show best-practice templates for memory entries',
-    options: [
-        { name: 'type', short: 't', description: 'Template type: user, feedback, project, reference', type: 'string', choices: ['user', 'feedback', 'project', 'reference'] }
-    ],
-    examples: [
-        { command: 'monomind memory templates', description: 'Show all templates' },
-        { command: 'monomind memory templates -t feedback', description: 'Show feedback template only' }
-    ],
-    action: async (ctx) => {
-        const filter = ctx.flags.type;
-        const templates = {
-            user: {
-                label: 'User Memory',
-                description: 'Role, goals, preferences, knowledge level',
-                example: [
-                    '---',
-                    'name: user_role',
-                    'description: <one-line summary of user role and context>',
-                    'type: user',
-                    '---',
-                    '',
-                    '<Role and experience description. What does the user know well? What are they new to?>',
-                    'Frame explanations accordingly.'
-                ].join('\n')
-            },
-            feedback: {
-                label: 'Feedback Memory',
-                description: 'How to approach work — corrections and validated choices',
-                example: [
-                    '---',
-                    'name: feedback_<topic>',
-                    'description: <one-line rule that triggers on lookup>',
-                    'type: feedback',
-                    '---',
-                    '',
-                    '<The rule itself — what to do or avoid.>',
-                    '',
-                    '**Why:** <Reason the user gave — past incident, strong preference, etc.>',
-                    '',
-                    '**How to apply:** <When does this kick in? What edge cases does it cover?>'
-                ].join('\n')
-            },
-            project: {
-                label: 'Project Memory',
-                description: 'Ongoing work context, goals, decisions, deadlines',
-                example: [
-                    '---',
-                    'name: project_<initiative>',
-                    'description: <one-line fact about the project decision or constraint>',
-                    'type: project',
-                    '---',
-                    '',
-                    '<The fact or decision — what is happening and what was decided.>',
-                    '',
-                    '**Why:** <Motivation — constraint, deadline, stakeholder ask, compliance issue.>',
-                    '',
-                    '**How to apply:** <How should this shape future suggestions and decisions?>'
-                ].join('\n')
-            },
-            reference: {
-                label: 'Reference Memory',
-                description: 'Pointers to external resources and where to find information',
-                example: [
-                    '---',
-                    'name: reference_<resource>',
-                    'description: <what this resource contains and when to use it>',
-                    'type: reference',
-                    '---',
-                    '',
-                    '<Resource name and location (URL, project name, channel, etc.)>',
-                    '',
-                    'Use this when: <specific scenarios where this reference is relevant>.'
-                ].join('\n')
-            }
-        };
-        output.writeln();
-        output.writeln(output.bold('Memory Entry Templates'));
-        output.writeln(output.dim('Best-practice scaffolds for .claude/projects/.../memory/ entries'));
-        output.writeln();
-        const keys = filter ? [filter] : Object.keys(templates);
-        for (const key of keys) {
-            const t = templates[key];
-            if (!t) {
-                output.printError(`Unknown type: "${key}". Valid types: user, feedback, project, reference`);
-                return { success: false, exitCode: 1 };
-            }
-            output.writeln(output.bold(`── ${t.label}  (--type ${key})`));
-            output.writeln(output.dim(`   ${t.description}`));
-            output.writeln();
-            output.writeln(t.example);
-            output.writeln();
-        }
-        output.writeln(output.dim('Save with: monomind memory store -k "<name>" --value "<content>" --namespace auto-memory'));
-        return { success: true };
-    }
-};
-//# sourceMappingURL=memory-list.js.map

package/packages/@monomind/cli/dist/src/commands/memory-transfer.d.ts

@@ -1,8 +0,0 @@
-/**
- * Memory Transfer Commands
- * exportCommand, importCommand
- */
-import type { Command } from '../types.js';
-export declare const exportCommand: Command;
-export declare const importCommand: Command;
-//# sourceMappingURL=memory-transfer.d.ts.map

package/packages/@monomind/cli/dist/src/commands/memory-transfer.js

@@ -1,199 +0,0 @@
-/**
- * Memory Transfer Commands
- * exportCommand, importCommand
- */
-import { output } from '../output.js';
-// Export command
-export const exportCommand = {
-    name: 'export',
-    description: 'Export memory to file',
-    options: [
-        {
-            name: 'output',
-            short: 'o',
-            description: 'Output file path',
-            type: 'string',
-            required: true
-        },
-        {
-            name: 'format',
-            short: 'f',
-            description: 'Export format (only okf is currently implemented)',
-            type: 'string',
-            choices: ['okf'],
-            default: 'okf'
-        },
-        {
-            name: 'namespace',
-            short: 'n',
-            description: 'Export specific namespace',
-            type: 'string'
-        }
-    ],
-    examples: [
-        { command: 'monomind memory export -o ./backup', description: 'Export all as OKF bundle (directory of .md files)' },
-        { command: 'monomind memory export -o ./knowledge -f okf', description: 'Export as OKF bundle (directory of .md files)' }
-    ],
-    action: async (ctx) => {
-        const outputPath = ctx.flags.output;
-        const format = ctx.flags.format || 'okf';
-        if (!outputPath) {
-            output.printError('Output path is required. Use --output or -o');
-            return { success: false, exitCode: 1 };
-        }
-        output.printInfo(`Exporting memory to ${outputPath}...`);
-        // OKF bundle: native export — directory of .md files with YAML frontmatter
-        if (format === 'okf') {
-            try {
-                const fs = await import('fs');
-                const path = await import('path');
-                const { listEntries, getEntry } = await import('../memory/memory-initializer.js');
-                const namespace = ctx.flags.namespace;
-                const listed = await listEntries({ namespace, limit: 10000 });
-                if (!listed.success) {
-                    output.printError(`Failed to list entries: ${listed.error}`);
-                    return { success: false, exitCode: 1 };
-                }
-                let written = 0;
-                for (const entry of listed.entries) {
-                    const got = await getEntry({ key: entry.key, namespace: entry.namespace });
-                    if (!got.found || !got.entry)
-                        continue;
-                    const { key, namespace: ns, content, tags, createdAt } = got.entry;
-                    const safeKey = key.replace(/[/\\:*?"<>|]/g, '-');
-                    const dir = path.join(outputPath, ns);
-                    fs.mkdirSync(dir, { recursive: true });
-                    const yamlEscape = (s) => s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-                    const tagsLine = tags.length > 0 ? `tags: [${tags.join(', ')}]\n` : '';
-                    const md = `---\ntype: Memory\nkey: "${yamlEscape(key)}"\nnamespace: "${yamlEscape(ns)}"\n${tagsLine}timestamp: ${createdAt}\n---\n\n${content}`;
-                    fs.writeFileSync(path.join(dir, `${safeKey}.md`), md, 'utf-8');
-                    written++;
-                }
-                output.printSuccess(`Exported ${written} entries to ${outputPath}`);
-                if (listed.total > 10000) {
-                    output.printInfo(`Note: only first 10000 of ${listed.total} entries exported`);
-                }
-                return { success: true, data: { written, outputPath } };
-            }
-            catch (error) {
-                output.printError(`OKF export error: ${String(error)}`);
-                return { success: false, exitCode: 1 };
-            }
-        }
-        output.printError(`Format '${format}' is not yet implemented. Use --format okf (the only supported format).`);
-        return { success: false, exitCode: 1 };
-    }
-};
-// Import command
-export const importCommand = {
-    name: 'import',
-    description: 'Import memory from file',
-    options: [
-        {
-            name: 'input',
-            short: 'i',
-            description: 'Input file path',
-            type: 'string',
-            required: true
-        },
-        {
-            name: 'merge',
-            short: 'm',
-            description: 'Merge with existing (skip duplicates)',
-            type: 'boolean',
-            default: true
-        },
-        {
-            name: 'namespace',
-            short: 'n',
-            description: 'Import into specific namespace',
-            type: 'string'
-        }
-    ],
-    examples: [
-        { command: 'monomind memory import -i ./backup.json', description: 'Import from file' },
-        { command: 'monomind memory import -i ./data.json -n archive', description: 'Import to namespace' }
-    ],
-    action: async (ctx) => {
-        const inputPath = ctx.flags.input || ctx.args[0];
-        if (!inputPath) {
-            output.printError('Input path is required. Use --input or -i');
-            return { success: false, exitCode: 1 };
-        }
-        output.printInfo(`Importing memory from ${inputPath}...`);
-        // OKF bundle: native import — detect directory of .md files with YAML frontmatter
-        const fsCheck = await import('fs');
-        const isDir = fsCheck.existsSync(inputPath) && fsCheck.statSync(inputPath).isDirectory();
-        if (isDir) {
-            try {
-                const fs = await import('fs');
-                const path = await import('path');
-                const { storeEntry } = await import('../memory/memory-initializer.js');
-                function parseOkfFrontmatter(raw) {
-                    if (!raw.startsWith('---\n'))
-                        return { meta: {}, body: raw };
-                    const end = raw.indexOf('\n---\n', 4);
-                    if (end === -1)
-                        return { meta: {}, body: raw };
-                    const meta = {};
-                    for (const line of raw.slice(4, end).split('\n')) {
-                        const colon = line.indexOf(':');
-                        if (colon <= 0)
-                            continue;
-                        const k = line.slice(0, colon).trim();
-                        const rawV = line.slice(colon + 1).trim();
-                        const isQuoted = rawV.startsWith('"') && rawV.endsWith('"') && rawV.length >= 2;
-                        const v = isQuoted ? rawV.slice(1, -1).replace(/\\(["\\])/g, '$1') : rawV;
-                        if (v.startsWith('[') && v.endsWith(']')) {
-                            meta[k] = v.slice(1, -1).split(',').map(s => s.trim()).filter(Boolean);
-                        }
-                        else {
-                            meta[k] = v;
-                        }
-                    }
-                    return { meta, body: raw.slice(end + 5) };
-                }
-                function findMdFiles(dir) {
-                    const results = [];
-                    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-                        const full = path.join(dir, entry.name);
-                        if (entry.isDirectory())
-                            results.push(...findMdFiles(full));
-                        else if (entry.name.endsWith('.md'))
-                            results.push(full);
-                    }
-                    return results;
-                }
-                const overrideNs = ctx.flags.namespace;
-                const merge = ctx.flags.merge ?? true;
-                const files = findMdFiles(inputPath);
-                let imported = 0, skipped = 0;
-                const start = Date.now();
-                for (const file of files) {
-                    const raw = fs.readFileSync(file, 'utf-8');
-                    const { meta, body } = parseOkfFrontmatter(raw);
-                    const key = meta['key'] || path.basename(file, '.md');
-                    const ns = overrideNs || meta['namespace'] || path.basename(path.dirname(file));
-                    const tags = Array.isArray(meta['tags']) ? meta['tags'] : meta['tags'] ? [meta['tags']] : [];
-                    const result = await storeEntry({ key, value: body.trim(), namespace: ns, tags, upsert: !merge });
-                    if (result.success)
-                        imported++;
-                    else
-                        skipped++;
-                }
-                output.printSuccess(`Imported ${imported} entries from ${inputPath}`);
-                if (skipped > 0)
-                    output.printInfo(`Skipped ${skipped} entries (duplicates or errors)`);
-                output.printInfo(`Duration: ${Date.now() - start}ms`);
-                return { success: true, data: { imported, skipped } };
-            }
-            catch (error) {
-                output.printError(`OKF import error: ${String(error)}`);
-                return { success: false, exitCode: 1 };
-            }
-        }
-        output.printError(`Unsupported import format. Provide a directory of .md files (OKF bundle) for file-based import.`);
-        return { success: false, exitCode: 1 };
-    }
-};
-//# sourceMappingURL=memory-transfer.js.map

package/packages/@monomind/cli/dist/src/commands/memory.d.ts

@@ -1,14 +0,0 @@
-/**
- * CLI Memory Command
- * Memory operations — SQLite-backed (better-sqlite3, sql.js WASM fallback)
- *
- * Split into sub-modules:
- *   memory-crud.ts     — store, retrieve, search
- *   memory-list.ts     — list, edit, templates
- *   memory-admin.ts    — delete, stats, configure, cleanup
- *   memory-transfer.ts — compress, export, import
- */
-import type { Command } from '../types.js';
-export declare const memoryCommand: Command;
-export default memoryCommand;
-//# sourceMappingURL=memory.d.ts.map