claude-code-workflow 6.1.3 → 6.2.1

package/dist/commands/memory.js

@@ -0,0 +1,890 @@
+/**
+ * Memory Command - Context tracking and prompt optimization
+ * Provides CLI interface for Memory module operations
+ */
+import chalk from 'chalk';
+import { getMemoryStore } from '../core/memory-store.js';
+import { HistoryImporter } from '../core/history-importer.js';
+import { notifyMemoryUpdate, notifyRefreshRequired } from '../tools/notifier.js';
+import { join } from 'path';
+import { existsSync, readdirSync } from 'fs';
+import { StoragePaths } from '../config/storage-paths.js';
+import { generateEmbeddings, searchMemories, getEmbeddingStatus, isEmbedderAvailable } from '../core/memory-embedder-bridge.js';
+import { getCoreMemoryStore } from '../core/core-memory-store.js';
+import { CliHistoryStore } from '../tools/cli-history-store.js';
+/**
+ * Read JSON data from stdin (for Claude Code hooks)
+ */
+async function readStdin() {
+    return new Promise((resolve) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('readable', () => {
+            let chunk;
+            while ((chunk = process.stdin.read()) !== null) {
+                data += chunk;
+            }
+        });
+        process.stdin.on('end', () => {
+            resolve(data);
+        });
+        // Handle case where stdin is empty or not piped
+        if (process.stdin.isTTY) {
+            resolve('');
+        }
+    });
+}
+/**
+ * Normalize file path for consistent storage
+ */
+function normalizePath(filePath) {
+    // Convert Windows paths to forward slashes and remove drive letter variations
+    return filePath
+        .replace(/\\/g, '/')
+        .replace(/^[A-Za-z]:/, (match) => match.toLowerCase());
+}
+/**
+ * Get project path from hook data or current working directory
+ */
+function getProjectPath(hookCwd) {
+    // Prefer hook's cwd (actual project workspace) over process.cwd()
+    return hookCwd || process.cwd();
+}
+/**
+ * Track entity access (used by hooks)
+ */
+async function trackAction(options) {
+    let { type, action, value, session, stdin } = options;
+    let hookCwd;
+    // If --stdin flag is set, read from stdin (Claude Code hook format)
+    if (stdin) {
+        try {
+            const stdinData = await readStdin();
+            if (stdinData) {
+                const hookData = JSON.parse(stdinData);
+                session = hookData.session_id || session;
+                hookCwd = hookData.cwd; // Extract workspace path from hook
+                // Extract value based on hook event
+                if (hookData.tool_input) {
+                    // PostToolUse event
+                    value = hookData.tool_input.file_path ||
+                        hookData.tool_input.paths ||
+                        hookData.tool_input.path ||
+                        JSON.stringify(hookData.tool_input);
+                }
+                else if (hookData.prompt) {
+                    // UserPromptSubmit event
+                    value = hookData.prompt;
+                }
+            }
+        }
+        catch {
+            // Silently continue if stdin parsing fails
+        }
+    }
+    if (!type || !action) {
+        console.error(chalk.red('Error: --type and --action are required'));
+        console.error(chalk.gray('Usage: ccw memory track --type file --action read --value "path" --session "id"'));
+        console.error(chalk.gray('       ccw memory track --type file --action read --stdin'));
+        process.exit(1);
+    }
+    // Validate type and action
+    const validTypes = ['file', 'module', 'topic', 'url'];
+    const validActions = ['read', 'write', 'mention'];
+    if (!validTypes.includes(type)) {
+        if (!stdin) {
+            console.error(chalk.red(`Error: Invalid type "${type}". Must be one of: ${validTypes.join(', ')}`));
+        }
+        process.exit(stdin ? 0 : 1);
+    }
+    if (!validActions.includes(action)) {
+        if (!stdin) {
+            console.error(chalk.red(`Error: Invalid action "${action}". Must be one of: ${validActions.join(', ')}`));
+        }
+        process.exit(stdin ? 0 : 1);
+    }
+    // Skip if no value provided
+    if (!value) {
+        if (stdin) {
+            process.exit(0);
+        }
+        console.error(chalk.red('Error: --value is required'));
+        process.exit(1);
+    }
+    try {
+        const projectPath = getProjectPath(hookCwd);
+        const store = getMemoryStore(projectPath);
+        const now = new Date().toISOString();
+        // Normalize value for file types
+        const normalizedValue = type === 'file' ? normalizePath(value) : value.toLowerCase();
+        // Upsert entity
+        const entityId = store.upsertEntity({
+            type: type,
+            value: value,
+            normalized_value: normalizedValue,
+            first_seen_at: now,
+            last_seen_at: now
+        });
+        // Log access
+        store.logAccess({
+            entity_id: entityId,
+            action: action,
+            session_id: session,
+            timestamp: now
+        });
+        // Update statistics
+        store.updateStats(entityId, action);
+        // Calculate heat score periodically (every 10th access)
+        const stats = store.getStats(entityId);
+        if (stats) {
+            const totalAccess = stats.read_count + stats.write_count + stats.mention_count;
+            if (totalAccess % 10 === 0) {
+                store.calculateHeatScore(entityId);
+            }
+        }
+        // Notify server of memory update (best-effort, non-blocking)
+        notifyMemoryUpdate({
+            entityType: type,
+            entityId: String(entityId),
+            action: action
+        }).catch(() => { });
+        if (stdin) {
+            // Silent mode for hooks - just exit successfully
+            process.exit(0);
+        }
+        console.log(chalk.green('✓ Tracked:'), chalk.cyan(`${type}:${action}`), chalk.gray(value));
+    }
+    catch (error) {
+        if (stdin) {
+            // Silent failure for hooks
+            process.exit(0);
+        }
+        console.error(chalk.red(`Error tracking: ${error.message}`));
+        process.exit(1);
+    }
+}
+/**
+ * Import Claude Code history
+ */
+async function importAction(options) {
+    const { source = 'all', project } = options;
+    console.log(chalk.bold.cyan('\n  Importing Claude Code History\n'));
+    console.log(chalk.gray(`  Source: ${source}`));
+    if (project) {
+        console.log(chalk.gray(`  Project: ${project}`));
+    }
+    try {
+        const projectPath = getProjectPath();
+        const paths = StoragePaths.project(projectPath);
+        const dbPath = join(paths.memory, 'history.db');
+        // Ensure memory directory exists
+        const { mkdirSync } = await import('fs');
+        if (!existsSync(paths.memory)) {
+            mkdirSync(paths.memory, { recursive: true });
+        }
+        const importer = new HistoryImporter(dbPath);
+        let totalImported = 0;
+        let totalSkipped = 0;
+        let totalErrors = 0;
+        // Import global history
+        if (source === 'all' || source === 'history') {
+            console.log(chalk.gray('\n  Importing global history...'));
+            const globalResult = await importer.importGlobalHistory();
+            totalImported += globalResult.imported;
+            totalSkipped += globalResult.skipped;
+            totalErrors += globalResult.errors;
+            console.log(chalk.gray(`    Imported: ${globalResult.imported}, Skipped: ${globalResult.skipped}, Errors: ${globalResult.errors}`));
+        }
+        // Import project sessions
+        if (source === 'all' || source === 'sessions') {
+            const claudeHome = process.env.USERPROFILE || process.env.HOME || '';
+            const projectsDir = join(claudeHome, '.claude', 'projects');
+            if (existsSync(projectsDir)) {
+                const projects = project
+                    ? [project]
+                    : readdirSync(projectsDir).filter(f => {
+                        const fullPath = join(projectsDir, f);
+                        return existsSync(fullPath) && require('fs').statSync(fullPath).isDirectory();
+                    });
+                for (const proj of projects) {
+                    console.log(chalk.gray(`\n  Importing sessions for: ${proj}...`));
+                    const sessionResult = await importer.importProjectSessions(proj);
+                    totalImported += sessionResult.imported;
+                    totalSkipped += sessionResult.skipped;
+                    totalErrors += sessionResult.errors;
+                    console.log(chalk.gray(`    Imported: ${sessionResult.imported}, Skipped: ${sessionResult.skipped}, Errors: ${sessionResult.errors}`));
+                }
+            }
+        }
+        importer.close();
+        console.log(chalk.bold.green('\n  Import Complete\n'));
+        console.log(chalk.gray(`  Total Imported: ${totalImported}`));
+        console.log(chalk.gray(`  Total Skipped: ${totalSkipped}`));
+        console.log(chalk.gray(`  Total Errors: ${totalErrors}`));
+        console.log(chalk.gray(`  Database: ${dbPath}\n`));
+        // Notify server to refresh memory data
+        if (totalImported > 0) {
+            notifyRefreshRequired('memory').catch(() => { });
+        }
+    }
+    catch (error) {
+        console.error(chalk.red(`\n  Error importing: ${error.message}\n`));
+        process.exit(1);
+    }
+}
+/**
+ * Show hotspot statistics
+ */
+async function statsAction(options) {
+    const { type, limit = '20', sort = 'heat', json } = options;
+    const limitNum = parseInt(limit, 10);
+    try {
+        const projectPath = getProjectPath();
+        const store = getMemoryStore(projectPath);
+        // Get hot entities
+        const hotEntities = store.getHotEntities(limitNum * 2); // Get more to filter
+        // Filter by type if specified
+        let filtered = type
+            ? hotEntities.filter((e) => e.type === type)
+            : hotEntities;
+        // Sort by specified field
+        if (sort === 'reads') {
+            filtered.sort((a, b) => b.stats.read_count - a.stats.read_count);
+        }
+        else if (sort === 'writes') {
+            filtered.sort((a, b) => b.stats.write_count - a.stats.write_count);
+        }
+        // Default is already sorted by heat_score
+        // Limit results
+        filtered = filtered.slice(0, limitNum);
+        if (json) {
+            const output = filtered.map((e) => ({
+                type: e.type,
+                value: e.value,
+                reads: e.stats.read_count,
+                writes: e.stats.write_count,
+                mentions: e.stats.mention_count,
+                heat: Math.round(e.stats.heat_score * 100) / 100,
+                lastSeen: e.last_seen_at
+            }));
+            console.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        console.log(chalk.bold.cyan('\n  Memory Hotspot Statistics\n'));
+        if (type) {
+            console.log(chalk.gray(`  Type: ${type}`));
+        }
+        console.log(chalk.gray(`  Sort: ${sort} | Limit: ${limit}\n`));
+        if (filtered.length === 0) {
+            console.log(chalk.yellow('  No data yet. Use hooks to track file access or run:'));
+            console.log(chalk.gray('    ccw memory track --type file --action read --value "path/to/file"'));
+            console.log(chalk.gray('    ccw memory import --source all\n'));
+            return;
+        }
+        // Display table header
+        console.log(chalk.gray('  ─────────────────────────────────────────────────────────────────'));
+        console.log(chalk.bold('  Type     ') +
+            chalk.bold('Heat   ') +
+            chalk.bold('R   ') +
+            chalk.bold('W   ') +
+            chalk.bold('M   ') +
+            chalk.bold('Value'));
+        console.log(chalk.gray('  ─────────────────────────────────────────────────────────────────'));
+        for (const entity of filtered) {
+            const typeStr = entity.type.padEnd(8);
+            const heatStr = entity.stats.heat_score.toFixed(1).padStart(6);
+            const readStr = String(entity.stats.read_count).padStart(3);
+            const writeStr = String(entity.stats.write_count).padStart(3);
+            const mentionStr = String(entity.stats.mention_count).padStart(3);
+            // Truncate value if too long
+            const maxValueLen = 40;
+            let valueStr = entity.value;
+            if (valueStr.length > maxValueLen) {
+                valueStr = '...' + valueStr.slice(-maxValueLen + 3);
+            }
+            // Color based on type
+            const typeColor = entity.type === 'file' ? chalk.blue :
+                entity.type === 'module' ? chalk.magenta :
+                    entity.type === 'topic' ? chalk.yellow : chalk.gray;
+            console.log('  ' +
+                typeColor(typeStr) +
+                chalk.cyan(heatStr) + ' ' +
+                chalk.green(readStr) + ' ' +
+                chalk.red(writeStr) + ' ' +
+                chalk.yellow(mentionStr) + ' ' +
+                chalk.gray(valueStr));
+        }
+        console.log(chalk.gray('  ─────────────────────────────────────────────────────────────────'));
+        console.log(chalk.gray(`\n  R=Reads, W=Writes, M=Mentions, Heat=Composite score\n`));
+    }
+    catch (error) {
+        if (json) {
+            console.log(JSON.stringify({ error: error.message }, null, 2));
+        }
+        else {
+            console.error(chalk.red(`\n  Error: ${error.message}\n`));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Search through prompt history
+ */
+async function searchAction(query, options) {
+    if (!query) {
+        console.error(chalk.red('Error: Search query is required'));
+        console.error(chalk.gray('Usage: ccw memory search "<query>"'));
+        process.exit(1);
+    }
+    const { limit = '20', json } = options;
+    const limitNum = parseInt(limit, 10);
+    try {
+        const projectPath = getProjectPath();
+        const store = getMemoryStore(projectPath);
+        // Search prompts using FTS
+        const results = store.searchPrompts(query, limitNum);
+        if (json) {
+            const output = results.map((p) => ({
+                id: p.id,
+                sessionId: p.session_id,
+                prompt: p.prompt_text?.substring(0, 200) + (p.prompt_text && p.prompt_text.length > 200 ? '...' : ''),
+                timestamp: p.timestamp,
+                intentLabel: p.intent_label
+            }));
+            console.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        console.log(chalk.bold.cyan('\n  Searching Prompt History\n'));
+        console.log(chalk.gray(`  Query: ${query}`));
+        console.log(chalk.gray(`  Limit: ${limit}\n`));
+        if (results.length === 0) {
+            console.log(chalk.yellow('  No results found.'));
+            console.log(chalk.gray('  Try importing history first: ccw memory import --source all\n'));
+            return;
+        }
+        console.log(chalk.gray('  ─────────────────────────────────────────────────────────────────'));
+        for (const prompt of results) {
+            const timestamp = new Date(prompt.timestamp).toLocaleString();
+            const preview = prompt.prompt_text?.substring(0, 80).replace(/\n/g, ' ') || '(no content)';
+            console.log(chalk.gray(`  ${timestamp}`));
+            console.log(chalk.white(`  ${preview}${preview.length >= 80 ? '...' : ''}`));
+            if (prompt.intent_label) {
+                console.log(chalk.cyan(`  Intent: ${prompt.intent_label}`));
+            }
+            console.log(chalk.gray('  ─────────────────────────────────────────────────────────────────'));
+        }
+        console.log(chalk.gray(`\n  Found ${results.length} result(s)\n`));
+    }
+    catch (error) {
+        if (json) {
+            console.log(JSON.stringify({ error: error.message }, null, 2));
+        }
+        else {
+            console.error(chalk.red(`\n  Error: ${error.message}\n`));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Get optimization suggestions based on similar successful prompts
+ */
+async function suggestAction(options) {
+    const { context, limit = '5', json } = options;
+    const limitNum = parseInt(limit, 10);
+    try {
+        const projectPath = getProjectPath();
+        const store = getMemoryStore(projectPath);
+        // Get hot entities for suggestions
+        const hotEntities = store.getHotEntities(limitNum);
+        const suggestions = hotEntities.map((e) => ({
+            type: e.type,
+            value: e.value,
+            reason: `Frequently accessed (${e.stats.read_count} reads, ${e.stats.write_count} writes)`,
+            heat: e.stats.heat_score
+        }));
+        if (json) {
+            console.log(JSON.stringify({ suggestions, context }, null, 2));
+            return;
+        }
+        console.log(chalk.bold.cyan('\n  Memory Optimization Suggestions\n'));
+        if (context) {
+            console.log(chalk.gray(`  Context: ${context}\n`));
+        }
+        if (suggestions.length === 0) {
+            console.log(chalk.yellow('  No suggestions available yet.'));
+            console.log(chalk.gray('  Track more file access to get suggestions.\n'));
+            return;
+        }
+        console.log(chalk.gray('  Based on your access patterns:\n'));
+        for (let i = 0; i < suggestions.length; i++) {
+            const s = suggestions[i];
+            console.log(chalk.cyan(`  ${i + 1}. ${s.type}: `) + chalk.white(s.value));
+            console.log(chalk.gray(`     ${s.reason}`));
+        }
+        console.log(chalk.gray('\n  Tip: Include frequently accessed files in your context for better results.\n'));
+    }
+    catch (error) {
+        if (json) {
+            console.log(JSON.stringify({ error: error.message }, null, 2));
+        }
+        else {
+            console.error(chalk.red(`\n  Error: ${error.message}\n`));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Parse age string to milliseconds
+ */
+function parseAge(ageStr) {
+    const match = ageStr.match(/^(\d+)([dhm])$/);
+    if (!match) {
+        throw new Error(`Invalid age format: ${ageStr}. Use format like 30d, 24h, or 60m`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    switch (unit) {
+        case 'd': return value * 24 * 60 * 60 * 1000;
+        case 'h': return value * 60 * 60 * 1000;
+        case 'm': return value * 60 * 1000;
+        default: throw new Error(`Unknown unit: ${unit}`);
+    }
+}
+/**
+ * Clean up old data
+ */
+async function pruneAction(options) {
+    const { olderThan = '30d', dryRun } = options;
+    console.log(chalk.bold.cyan('\n  Pruning Memory Data\n'));
+    console.log(chalk.gray(`  Older than: ${olderThan}`));
+    console.log(chalk.gray(`  Mode: ${dryRun ? 'Dry run (preview)' : 'Delete'}\n`));
+    try {
+        const ageMs = parseAge(olderThan);
+        const cutoffDate = new Date(Date.now() - ageMs);
+        const cutoffStr = cutoffDate.toISOString();
+        const projectPath = getProjectPath();
+        const paths = StoragePaths.project(projectPath);
+        if (!existsSync(paths.memoryDb)) {
+            console.log(chalk.yellow('  No memory database found. Nothing to prune.\n'));
+            return;
+        }
+        // Use direct database access for pruning
+        const Database = require('better-sqlite3');
+        const db = new Database(paths.memoryDb);
+        // Count records to prune
+        const accessLogsCount = db.prepare(`
+      SELECT COUNT(*) as count FROM access_logs WHERE timestamp < ?
+    `).get(cutoffStr);
+        const entitiesCount = db.prepare(`
+      SELECT COUNT(*) as count FROM entities WHERE last_seen_at < ?
+    `).get(cutoffStr);
+        console.log(chalk.gray(`  Access logs to prune: ${accessLogsCount.count}`));
+        console.log(chalk.gray(`  Entities to prune: ${entitiesCount.count}`));
+        if (dryRun) {
+            console.log(chalk.yellow('\n  Dry run - no changes made.\n'));
+            db.close();
+            return;
+        }
+        if (accessLogsCount.count === 0 && entitiesCount.count === 0) {
+            console.log(chalk.green('\n  Nothing to prune.\n'));
+            db.close();
+            return;
+        }
+        // Delete old access logs
+        const deleteAccessLogs = db.prepare(`DELETE FROM access_logs WHERE timestamp < ?`);
+        const accessResult = deleteAccessLogs.run(cutoffStr);
+        // Delete entities not seen recently (and their stats)
+        const deleteStats = db.prepare(`
+      DELETE FROM entity_stats WHERE entity_id IN (
+        SELECT id FROM entities WHERE last_seen_at < ?
+      )
+    `);
+        deleteStats.run(cutoffStr);
+        const deleteEntities = db.prepare(`DELETE FROM entities WHERE last_seen_at < ?`);
+        const entitiesResult = deleteEntities.run(cutoffStr);
+        db.close();
+        console.log(chalk.green(`\n  Pruned ${accessResult.changes} access logs`));
+        console.log(chalk.green(`  Pruned ${entitiesResult.changes} entities\n`));
+        // Notify server to refresh memory data
+        if (accessResult.changes > 0 || entitiesResult.changes > 0) {
+            notifyRefreshRequired('memory').catch(() => { });
+        }
+    }
+    catch (error) {
+        console.error(chalk.red(`\n  Error: ${error.message}\n`));
+        process.exit(1);
+    }
+}
+/**
+ * Chunk and prepare memories for embedding
+ */
+async function chunkMemoriesForEmbedding(projectPath, sourceId, force) {
+    const coreMemoryStore = getCoreMemoryStore(projectPath);
+    let chunksCreated = 0;
+    // 1. Chunk core memories
+    const memories = coreMemoryStore.getMemories({ archived: false, limit: 1000 });
+    for (const memory of memories) {
+        if (sourceId && memory.id !== sourceId)
+            continue;
+        // Check if already chunked (skip unless force)
+        const existingChunks = coreMemoryStore.getChunks(memory.id);
+        if (existingChunks.length > 0 && !force)
+            continue;
+        // Delete old chunks if force
+        if (force && existingChunks.length > 0) {
+            coreMemoryStore.deleteChunks(memory.id);
+        }
+        // Chunk the memory content
+        const chunks = coreMemoryStore.chunkContent(memory.content, memory.id, 'core_memory');
+        // Insert chunks
+        for (let i = 0; i < chunks.length; i++) {
+            coreMemoryStore.insertChunk({
+                source_id: memory.id,
+                source_type: 'core_memory',
+                chunk_index: i,
+                content: chunks[i],
+                created_at: new Date().toISOString()
+            });
+            chunksCreated++;
+        }
+    }
+    // 2. Chunk CLI history
+    try {
+        const cliHistoryStore = new CliHistoryStore(projectPath);
+        const history = cliHistoryStore.getHistory({ limit: 500 });
+        for (const exec of history.executions) {
+            if (sourceId && exec.id !== sourceId)
+                continue;
+            // Check if already chunked
+            const existingChunks = coreMemoryStore.getChunks(exec.id);
+            if (existingChunks.length > 0 && !force)
+                continue;
+            // Delete old chunks if force
+            if (force && existingChunks.length > 0) {
+                coreMemoryStore.deleteChunks(exec.id);
+            }
+            // Get conversation content
+            const conversation = cliHistoryStore.getConversation(exec.id);
+            if (!conversation || !conversation.turns || conversation.turns.length === 0)
+                continue;
+            // Create content from turns
+            const content = conversation.turns
+                .map((t) => `Prompt: ${t.prompt}\nOutput: ${(t.stdout || '').substring(0, 500)}`)
+                .join('\n---\n');
+            // Chunk the content
+            const chunks = coreMemoryStore.chunkContent(content, exec.id, 'cli_history');
+            // Insert chunks
+            for (let i = 0; i < chunks.length; i++) {
+                coreMemoryStore.insertChunk({
+                    source_id: exec.id,
+                    source_type: 'cli_history',
+                    chunk_index: i,
+                    content: chunks[i],
+                    created_at: new Date().toISOString()
+                });
+                chunksCreated++;
+            }
+        }
+    }
+    catch {
+        // CLI history might not exist, continue
+    }
+    return chunksCreated;
+}
+/**
+ * Generate embeddings for memory chunks
+ */
+async function embedAction(options) {
+    const { id, force, batchSize } = options;
+    try {
+        // Check embedder availability
+        if (!isEmbedderAvailable()) {
+            console.error(chalk.red('\nError: Memory embedder not available'));
+            console.error(chalk.gray('Ensure CodexLens venv exists at ~/.codexlens/venv\n'));
+            process.exit(1);
+        }
+        const projectPath = getProjectPath();
+        const paths = StoragePaths.project(projectPath);
+        const dbPath = join(paths.root, 'core-memory', 'core_memory.db');
+        if (!existsSync(dbPath)) {
+            console.error(chalk.red('\nError: Core memory database not found'));
+            console.error(chalk.gray('Create memories first using "ccw core-memory import"\n'));
+            process.exit(1);
+        }
+        // Step 1: Chunk memories first
+        console.log(chalk.cyan('Chunking memories...'));
+        const chunksCreated = await chunkMemoriesForEmbedding(projectPath, id, force);
+        if (chunksCreated > 0) {
+            console.log(chalk.green(`  Created ${chunksCreated} new chunks`));
+        }
+        // Step 2: Generate embeddings
+        console.log(chalk.cyan('Generating embeddings...'));
+        const embedOptions = {
+            sourceId: id,
+            force: force || false,
+            batchSize: batchSize ? parseInt(batchSize, 10) : 8
+        };
+        const result = await generateEmbeddings(dbPath, embedOptions);
+        if (!result.success) {
+            console.error(chalk.red(`\nError: ${result.error}\n`));
+            process.exit(1);
+        }
+        console.log(chalk.green(`\n✓ Processed ${result.chunks_processed} chunks in ${result.elapsed_time.toFixed(1)}s`));
+        // Get status to show breakdown by type
+        const status = await getEmbeddingStatus(dbPath);
+        if (status.success && Object.keys(status.by_type).length > 0) {
+            for (const [type, stats] of Object.entries(status.by_type)) {
+                if (stats.total > 0) {
+                    console.log(chalk.white(`  - ${type}: ${stats.embedded} chunks`));
+                }
+            }
+        }
+        console.log();
+    }
+    catch (error) {
+        console.error(chalk.red(`\nError: ${error.message}\n`));
+        process.exit(1);
+    }
+}
+/**
+ * Search memories using semantic search
+ */
+async function searchEmbedAction(query, options) {
+    if (!query) {
+        console.error(chalk.red('Error: Search query is required'));
+        console.error(chalk.gray('Usage: ccw memory search "<query>"'));
+        process.exit(1);
+    }
+    const { topK = '10', type, minScore = '0.5', json } = options;
+    try {
+        // Check embedder availability
+        if (!isEmbedderAvailable()) {
+            console.error(chalk.red('\nError: Memory embedder not available'));
+            console.error(chalk.gray('Ensure CodexLens venv exists at ~/.codexlens/venv\n'));
+            process.exit(1);
+        }
+        const projectPath = getProjectPath();
+        const paths = StoragePaths.project(projectPath);
+        const dbPath = join(paths.root, 'core-memory', 'core_memory.db');
+        if (!existsSync(dbPath)) {
+            console.error(chalk.red('\nError: Core memory database not found'));
+            console.error(chalk.gray('Create memories first using "ccw core-memory import"\n'));
+            process.exit(1);
+        }
+        const searchOptions = {
+            topK: parseInt(topK, 10),
+            minScore: parseFloat(minScore),
+            sourceType: type
+        };
+        const result = await searchMemories(dbPath, query, searchOptions);
+        if (!result.success) {
+            console.error(chalk.red(`\nError: ${result.error}\n`));
+            process.exit(1);
+        }
+        if (json) {
+            const output = result.matches.map(m => ({
+                sourceId: m.source_id,
+                sourceType: m.source_type,
+                score: m.score,
+                content: m.content,
+                restoreCommand: m.restore_command
+            }));
+            console.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        console.log(chalk.bold.cyan(`\nFound ${result.matches.length} matches for "${query}":\n`));
+        if (result.matches.length === 0) {
+            console.log(chalk.yellow('No results found. Try:'));
+            console.log(chalk.gray('  - Using different keywords'));
+            console.log(chalk.gray('  - Lowering --min-score threshold'));
+            console.log(chalk.gray('  - Running "ccw memory embed" to generate embeddings\n'));
+            return;
+        }
+        for (let i = 0; i < result.matches.length; i++) {
+            const match = result.matches[i];
+            const preview = match.content.length > 80
+                ? match.content.substring(0, 80) + '...'
+                : match.content;
+            console.log(chalk.bold.white(`${i + 1}. [${match.score.toFixed(2)}] ${match.source_id}`) + chalk.gray(` (${match.source_type})`));
+            console.log(chalk.white(`   "${preview}"`));
+            console.log(chalk.cyan(`   → ${match.restore_command}`));
+            console.log();
+        }
+    }
+    catch (error) {
+        if (json) {
+            console.log(JSON.stringify({ error: error.message }, null, 2));
+        }
+        else {
+            console.error(chalk.red(`\nError: ${error.message}\n`));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Show embedding status
+ */
+async function embedStatusAction(options) {
+    const { json } = options;
+    try {
+        // Check embedder availability
+        if (!isEmbedderAvailable()) {
+            console.error(chalk.red('\nError: Memory embedder not available'));
+            console.error(chalk.gray('Ensure CodexLens venv exists at ~/.codexlens/venv\n'));
+            process.exit(1);
+        }
+        const projectPath = getProjectPath();
+        const paths = StoragePaths.project(projectPath);
+        const dbPath = join(paths.root, 'core-memory', 'core_memory.db');
+        if (!existsSync(dbPath)) {
+            console.error(chalk.red('\nError: Core memory database not found'));
+            console.error(chalk.gray('Create memories first using "ccw core-memory import"\n'));
+            process.exit(1);
+        }
+        const status = await getEmbeddingStatus(dbPath);
+        if (!status.success) {
+            console.error(chalk.red(`\nError: ${status.error}\n`));
+            process.exit(1);
+        }
+        if (json) {
+            console.log(JSON.stringify(status, null, 2));
+            return;
+        }
+        const embeddedPercent = status.total_chunks > 0
+            ? Math.round((status.embedded_chunks / status.total_chunks) * 100)
+            : 0;
+        console.log(chalk.bold.cyan('\nEmbedding Status:'));
+        console.log(chalk.white(`  Total chunks: ${status.total_chunks}`));
+        console.log(chalk.white(`  Embedded: ${status.embedded_chunks} (${embeddedPercent}%)`));
+        console.log(chalk.white(`  Pending: ${status.pending_chunks}`));
+        if (Object.keys(status.by_type).length > 0) {
+            console.log(chalk.bold.white('\nBy Type:'));
+            for (const [type, stats] of Object.entries(status.by_type)) {
+                const typePercent = stats.total > 0
+                    ? Math.round((stats.embedded / stats.total) * 100)
+                    : 0;
+                console.log(chalk.cyan(`  ${type}: `) + chalk.white(`${stats.embedded}/${stats.total} (${typePercent}%)`));
+            }
+        }
+        console.log();
+    }
+    catch (error) {
+        if (json) {
+            console.log(JSON.stringify({ error: error.message }, null, 2));
+        }
+        else {
+            console.error(chalk.red(`\nError: ${error.message}\n`));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Memory command entry point
+ * @param {string} subcommand - Subcommand (track, import, stats, search, suggest, prune, embed, embed-status)
+ * @param {string|string[]} args - Arguments array
+ * @param {Object} options - CLI options
+ */
+export async function memoryCommand(subcommand, args, options) {
+    const argsArray = Array.isArray(args) ? args : (args ? [args] : []);
+    switch (subcommand) {
+        case 'track':
+            await trackAction(options);
+            break;
+        case 'import':
+            await importAction(options);
+            break;
+        case 'stats':
+            await statsAction(options);
+            break;
+        case 'search':
+            // Check if this is semantic search (has --top-k or --min-score) or prompt history search
+            if ('topK' in options || 'minScore' in options) {
+                await searchEmbedAction(argsArray[0], options);
+            }
+            else {
+                await searchAction(argsArray[0], options);
+            }
+            break;
+        case 'suggest':
+            await suggestAction(options);
+            break;
+        case 'prune':
+            await pruneAction(options);
+            break;
+        case 'embed':
+            await embedAction(options);
+            break;
+        case 'embed-status':
+            await embedStatusAction(options);
+            break;
+        default:
+            console.log(chalk.bold.cyan('\n  CCW Memory Module\n'));
+            console.log('  Context tracking and prompt optimization.\n');
+            console.log('  Subcommands:');
+            console.log(chalk.gray('    track               Track entity access (used by hooks)'));
+            console.log(chalk.gray('    import              Import Claude Code history'));
+            console.log(chalk.gray('    stats               Show hotspot statistics'));
+            console.log(chalk.gray('    search <query>      Search through prompt history (semantic or FTS)'));
+            console.log(chalk.gray('    suggest             Get optimization suggestions'));
+            console.log(chalk.gray('    prune               Clean up old data'));
+            console.log(chalk.gray('    embed               Generate embeddings for semantic search'));
+            console.log(chalk.gray('    embed-status        Show embedding generation status'));
+            console.log();
+            console.log('  Track Options:');
+            console.log(chalk.gray('    --type <type>       Entity type: file, module, topic'));
+            console.log(chalk.gray('    --action <action>   Action: read, write, mention'));
+            console.log(chalk.gray('    --value <value>     Entity value (file path, etc.)'));
+            console.log(chalk.gray('    --session <id>      Session ID (optional)'));
+            console.log();
+            console.log('  Import Options:');
+            console.log(chalk.gray('    --source <source>   Source: history, sessions, all (default: all)'));
+            console.log(chalk.gray('    --project <name>    Project name filter (optional)'));
+            console.log();
+            console.log('  Stats Options:');
+            console.log(chalk.gray('    --type <type>       Filter: file, module, topic (optional)'));
+            console.log(chalk.gray('    --limit <n>         Number of results (default: 20)'));
+            console.log(chalk.gray('    --sort <field>      Sort by: heat, reads, writes (default: heat)'));
+            console.log(chalk.gray('    --json              Output as JSON'));
+            console.log();
+            console.log('  Search Options (Prompt History):');
+            console.log(chalk.gray('    --limit <n>         Number of results (default: 20)'));
+            console.log(chalk.gray('    --json              Output as JSON'));
+            console.log();
+            console.log('  Search Options (Semantic - requires embeddings):');
+            console.log(chalk.gray('    --top-k <n>         Number of results (default: 10)'));
+            console.log(chalk.gray('    --min-score <f>     Minimum similarity score (default: 0.5)'));
+            console.log(chalk.gray('    --type <type>       Filter: core_memory, workflow, cli_history'));
+            console.log(chalk.gray('    --json              Output as JSON'));
+            console.log();
+            console.log('  Embed Options:');
+            console.log(chalk.gray('    --id <id>           Specific memory/session ID to embed'));
+            console.log(chalk.gray('    --force             Force re-embed all chunks'));
+            console.log(chalk.gray('    --batch-size <n>    Batch size for embedding (default: 8)'));
+            console.log();
+            console.log('  Embed Status Options:');
+            console.log(chalk.gray('    --json              Output as JSON'));
+            console.log();
+            console.log('  Suggest Options:');
+            console.log(chalk.gray('    --context <text>    Current task context (optional)'));
+            console.log(chalk.gray('    --limit <n>         Number of suggestions (default: 5)'));
+            console.log(chalk.gray('    --json              Output as JSON'));
+            console.log();
+            console.log('  Prune Options:');
+            console.log(chalk.gray('    --older-than <age>  Age threshold (default: 30d)'));
+            console.log(chalk.gray('    --dry-run           Preview without deleting'));
+            console.log();
+            console.log('  Examples:');
+            console.log(chalk.gray('    ccw memory track --type file --action read --value "src/auth.ts"'));
+            console.log(chalk.gray('    ccw memory import --source history --project "my-app"'));
+            console.log(chalk.gray('    ccw memory stats --type file --sort heat --limit 10'));
+            console.log(chalk.gray('    ccw memory search "authentication patterns"  # FTS search'));
+            console.log(chalk.gray('    ccw memory embed                              # Generate all embeddings'));
+            console.log(chalk.gray('    ccw memory embed --id CMEM-xxx                # Embed specific memory'));
+            console.log(chalk.gray('    ccw memory embed-status                       # Check embedding status'));
+            console.log(chalk.gray('    ccw memory search "auth patterns" --top-k 5   # Semantic search'));
+            console.log(chalk.gray('    ccw memory suggest --context "implementing JWT auth"'));
+            console.log(chalk.gray('    ccw memory prune --older-than 60d --dry-run'));
+            console.log();
+    }
+}
+//# sourceMappingURL=memory.js.map