/**
 * Memory Command - Context tracking and prompt optimization
 * Provides CLI interface for Memory module operations
 */

import chalk from 'chalk';
import { getMemoryStore, type Entity, type HotEntity, type PromptHistory } 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,
  type EmbedOptions,
  type SearchOptions as EmbedSearchOptions
} from '../core/memory-embedder-bridge.js';
import { getCoreMemoryStore } from '../core/core-memory-store.js';
import { CliHistoryStore } from '../tools/cli-history-store.js';
import { MemoryExtractionPipeline, type PreviewResult, type SessionPreviewItem } from '../core/memory-extraction-pipeline.js';
import { MemoryConsolidationPipeline } from '../core/memory-consolidation-pipeline.js';
import { MemoryJobScheduler } from '../core/memory-job-scheduler.js';

interface TrackOptions {
  type?: string;
  action?: string;
  value?: string;
  session?: string;
  stdin?: boolean;
}

interface ImportOptions {
  source?: string;
  project?: string;
}

interface StatsOptions {
  type?: string;
  limit?: string;
  sort?: string;
  json?: boolean;
}

interface SearchOptions {
  limit?: string;
  json?: boolean;
}

interface SuggestOptions {
  context?: string;
  limit?: string;
  json?: boolean;
}

interface PruneOptions {
  olderThan?: string;
  dryRun?: boolean;
}

interface EmbedCommandOptions {
  id?: string;
  force?: boolean;
  batchSize?: string;
}

interface SearchCommandOptions {
  topK?: string;
  type?: 'core_memory' | 'workflow' | 'cli_history';
  minScore?: string;
  json?: boolean;
}

interface EmbedStatusOptions {
  json?: boolean;
}

// Memory Pipeline V2 subcommand options
interface PipelinePreviewOptions {
  includeNative?: boolean;
  path?: string;
  json?: boolean;
}

interface PipelineExtractOptions {
  maxSessions?: string;
  sessionIds?: string;
  path?: string;
}

interface PipelineConsolidateOptions {
  path?: string;
}

interface PipelineStatusOptions {
  path?: string;
  json?: boolean;
}

/**
 * Read JSON data from stdin (for Claude Code hooks)
 */
async function readStdin(): Promise<string> {
  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: string): string {
  // 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?: string): string {
  // Prefer hook's cwd (actual project workspace) over process.cwd()
  return hookCwd || process.cwd();
}

/**
 * Track entity access (used by hooks)
 */
async function trackAction(options: TrackOptions): Promise<void> {
  let { type, action, value, session, stdin } = options;
  let hookCwd: string | undefined;

  // 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 as Entity['type'],
      value: value,
      normalized_value: normalizedValue,
      first_seen_at: now,
      last_seen_at: now
    });

    // Log access
    store.logAccess({
      entity_id: entityId,
      action: action as 'read' | 'write' | 'mention',
      session_id: session,
      timestamp: now
    });

    // Update statistics
    store.updateStats(entityId, action as 'read' | 'write' | 'mention');

    // 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(() => { /* ignore errors - server may not be running */ });

    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 as Error).message}`));
    process.exit(1);
  }
}

/**
 * Import Claude Code history
 */
async function importAction(options: ImportOptions): Promise<void> {
  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(() => { /* ignore */ });
    }
  } catch (error) {
    console.error(chalk.red(`\n  Error importing: ${(error as Error).message}\n`));
    process.exit(1);
  }
}

/**
 * Show hotspot statistics
 */
async function statsAction(options: StatsOptions): Promise<void> {
  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: HotEntity[] = type
      ? hotEntities.filter((e: HotEntity) => e.type === type)
      : hotEntities;

    // Sort by specified field
    if (sort === 'reads') {
      filtered.sort((a: HotEntity, b: HotEntity) => b.stats.read_count - a.stats.read_count);
    } else if (sort === 'writes') {
      filtered.sort((a: HotEntity, b: HotEntity) => 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: HotEntity) => ({
        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 as Error).message }, null, 2));
    } else {
      console.error(chalk.red(`\n  Error: ${(error as Error).message}\n`));
    }
    process.exit(1);
  }
}

/**
 * Search through prompt history
 */
async function searchAction(query: string | undefined, options: SearchOptions): Promise<void> {
  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: PromptHistory) => ({
        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 as Error).message }, null, 2));
    } else {
      console.error(chalk.red(`\n  Error: ${(error as Error).message}\n`));
    }
    process.exit(1);
  }
}

/**
 * Get optimization suggestions based on similar successful prompts
 */
async function suggestAction(options: SuggestOptions): Promise<void> {
  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: HotEntity) => ({
      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 as Error).message }, null, 2));
    } else {
      console.error(chalk.red(`\n  Error: ${(error as Error).message}\n`));
    }
    process.exit(1);
  }
}

/**
 * Parse age string to milliseconds
 */
function parseAge(ageStr: string): number {
  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: PruneOptions): Promise<void> {
  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) as { count: number };

    const entitiesCount = db.prepare(`
      SELECT COUNT(*) as count FROM entities WHERE last_seen_at < ?
    `).get(cutoffStr) as { count: number };

    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(() => { /* ignore */ });
    }

  } catch (error) {
    console.error(chalk.red(`\n  Error: ${(error as Error).message}\n`));
    process.exit(1);
  }
}

/**
 * Chunk and prepare memories for embedding
 */
async function chunkMemoriesForEmbedding(projectPath: string, sourceId?: string, force?: boolean): Promise<number> {
  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: any) => `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: EmbedCommandOptions): Promise<void> {
  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: 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 as Error).message}\n`));
    process.exit(1);
  }
}

/**
 * Search memories using semantic search
 */
async function searchEmbedAction(query: string | undefined, options: SearchCommandOptions): Promise<void> {
  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: EmbedSearchOptions = {
      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 as Error).message }, null, 2));
    } else {
      console.error(chalk.red(`\nError: ${(error as Error).message}\n`));
    }
    process.exit(1);
  }
}

/**
 * Show embedding status
 */
async function embedStatusAction(options: EmbedStatusOptions): Promise<void> {
  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 as Error).message }, null, 2));
    } else {
      console.error(chalk.red(`\nError: ${(error as Error).message}\n`));
    }
    process.exit(1);
  }
}

// ============================================================
// Memory Pipeline V2 Subcommands
// ============================================================

/**
 * Preview eligible sessions for extraction
 */
async function pipelinePreviewAction(options: PipelinePreviewOptions): Promise<void> {
  const { includeNative, path: projectPath, json } = options;
  const basePath = projectPath || process.cwd();

  try {
    const pipeline = new MemoryExtractionPipeline(basePath);
    const preview = pipeline.previewEligibleSessions({
      includeNative: includeNative || false,
    });

    if (json) {
      console.log(JSON.stringify(preview, null, 2));
      return;
    }

    console.log(chalk.bold.cyan('\n  Extraction Queue Preview\n'));
    console.log(chalk.gray(`  Project: ${basePath}`));
    console.log(chalk.gray(`  Include Native: ${includeNative ? 'Yes' : 'No'}\n`));

    // Summary
    const { summary } = preview;
    console.log(chalk.bold.white('  Summary:'));
    console.log(chalk.white(`    Total Sessions: ${summary.total}`));
    console.log(chalk.white(`    Eligible: ${summary.eligible}`));
    console.log(chalk.white(`    Already Extracted: ${summary.alreadyExtracted}`));
    console.log(chalk.green(`    Ready for Extraction: ${summary.readyForExtraction}`));

    if (preview.sessions.length === 0) {
      console.log(chalk.yellow('\n  No eligible sessions found.\n'));
      return;
    }

    // Sessions table
    console.log(chalk.bold.white('\n  Sessions:\n'));
    console.log(chalk.gray('  ID                   Source      Tool        Turns  Bytes     Status'));
    console.log(chalk.gray('  ' + '-'.repeat(76)));

    for (const session of preview.sessions) {
      const id = session.sessionId.padEnd(20);
      const source = session.source.padEnd(11);
      const tool = (session.tool || '-').padEnd(11);
      const turns = String(session.turns).padStart(5);
      const bytes = String(session.bytes).padStart(9);
      const status = session.extracted
        ? chalk.green('extracted')
        : session.eligible
          ? chalk.cyan('ready')
          : chalk.gray('skipped');

      console.log(`  ${chalk.dim(id)} ${source} ${tool} ${turns} ${bytes}  ${status}`);
    }

    console.log(chalk.gray('\n  ' + '-'.repeat(76)));
    console.log(chalk.gray(`  Showing ${preview.sessions.length} sessions\n`));

  } catch (error) {
    if (json) {
      console.log(JSON.stringify({ error: (error as Error).message }, null, 2));
    } else {
      console.error(chalk.red(`\n  Error: ${(error as Error).message}\n`));
    }
    process.exit(1);
  }
}

/**
 * Trigger extraction for sessions
 */
async function pipelineExtractAction(options: PipelineExtractOptions): Promise<void> {
  const { maxSessions, sessionIds, path: projectPath } = options;
  const basePath = projectPath || process.cwd();

  try {
    const store = getCoreMemoryStore(basePath);
    const scheduler = new MemoryJobScheduler(store.getDb());
    const pipeline = new MemoryExtractionPipeline(basePath);

    // Selective extraction with specific session IDs
    if (sessionIds) {
      const ids = sessionIds.split(',').map(id => id.trim()).filter(Boolean);

      if (ids.length === 0) {
        console.error(chalk.red('Error: No valid session IDs provided'));
        process.exit(1);
      }

      console.log(chalk.bold.cyan('\n  Selective Extraction\n'));
      console.log(chalk.gray(`  Project: ${basePath}`));
      console.log(chalk.gray(`  Session IDs: ${ids.join(', ')}\n`));

      // Validate sessions
      const preview = pipeline.previewEligibleSessions({ includeNative: false });
      const validSessionIds = new Set(preview.sessions.map(s => s.sessionId));

      const queued: string[] = [];
      const skipped: string[] = [];
      const invalid: string[] = [];

      for (const sessionId of ids) {
        if (!validSessionIds.has(sessionId)) {
          invalid.push(sessionId);
          continue;
        }

        // Check if already extracted
        const existingOutput = store.getStage1Output(sessionId);
        if (existingOutput) {
          skipped.push(sessionId);
          continue;
        }

        // Enqueue job
        scheduler.enqueueJob('phase1_extraction', sessionId, Math.floor(Date.now() / 1000));
        queued.push(sessionId);
      }

      console.log(chalk.green(`  Queued: ${queued.length} sessions`));
      console.log(chalk.yellow(`  Skipped (already extracted): ${skipped.length}`));

      if (invalid.length > 0) {
        console.log(chalk.red(`  Invalid: ${invalid.length}`));
        console.log(chalk.gray(`    ${invalid.join(', ')}`));
      }

      // Process queued sessions
      if (queued.length > 0) {
        console.log(chalk.cyan('\n  Processing extraction jobs...\n'));

        let succeeded = 0;
        let failed = 0;

        for (const sessionId of queued) {
          try {
            await pipeline.runExtractionJob(sessionId);
            succeeded++;
            console.log(chalk.green(`  [OK] ${sessionId}`));
          } catch (err) {
            failed++;
            console.log(chalk.red(`  [FAIL] ${sessionId}: ${(err as Error).message}`));
          }
        }

        console.log(chalk.bold.white(`\n  Completed: ${succeeded} succeeded, ${failed} failed\n`));
      } else {
        console.log();
      }

      return;
    }

    // Batch extraction
    const max = maxSessions ? parseInt(maxSessions, 10) : 10;

    console.log(chalk.bold.cyan('\n  Batch Extraction\n'));
    console.log(chalk.gray(`  Project: ${basePath}`));
    console.log(chalk.gray(`  Max Sessions: ${max}\n`));

    // Get eligible sessions
    const eligible = pipeline.scanEligibleSessions(max);
    const preview = pipeline.previewEligibleSessions({ maxSessions: max });

    console.log(chalk.white(`  Found ${eligible.length} eligible sessions`));
    console.log(chalk.white(`  Ready for extraction: ${preview.summary.readyForExtraction}\n`));

    if (eligible.length === 0) {
      console.log(chalk.yellow('  No eligible sessions to extract.\n'));
      return;
    }

    // Queue jobs
    const jobId = `batch-${Date.now()}`;
    const queued: string[] = [];

    for (const session of eligible) {
      const existingOutput = store.getStage1Output(session.id);
      if (!existingOutput) {
        const watermark = Math.floor(new Date(session.updated_at).getTime() / 1000);
        scheduler.enqueueJob('phase1_extraction', session.id, watermark);
        queued.push(session.id);
      }
    }

    console.log(chalk.cyan(`  Job ID: ${jobId}`));
    console.log(chalk.cyan(`  Queued: ${queued.length} sessions\n`));

    // Process queued sessions
    if (queued.length > 0) {
      console.log(chalk.cyan('  Processing extraction jobs...\n'));

      let succeeded = 0;
      let failed = 0;

      for (const sessionId of queued) {
        try {
          await pipeline.runExtractionJob(sessionId);
          succeeded++;
          console.log(chalk.green(`  [OK] ${sessionId}`));
        } catch (err) {
          failed++;
          console.log(chalk.red(`  [FAIL] ${sessionId}: ${(err as Error).message}`));
        }
      }

      console.log(chalk.bold.white(`\n  Completed: ${succeeded} succeeded, ${failed} failed\n`));
    } else {
      console.log(chalk.yellow('  No new sessions to extract.\n'));
    }

  } catch (error) {
    console.error(chalk.red(`\n  Error: ${(error as Error).message}\n`));
    process.exit(1);
  }
}

/**
 * Trigger consolidation pipeline
 */
async function pipelineConsolidateAction(options: PipelineConsolidateOptions): Promise<void> {
  const { path: projectPath } = options;
  const basePath = projectPath || process.cwd();

  try {
    const pipeline = new MemoryConsolidationPipeline(basePath);

    console.log(chalk.bold.cyan('\n  Memory Consolidation\n'));
    console.log(chalk.gray(`  Project: ${basePath}\n`));

    // Get current status
    const status = pipeline.getStatus();

    if (status) {
      console.log(chalk.white(`  Current Status: ${status.status}`));
    }

    console.log(chalk.cyan('\n  Triggering consolidation...\n'));

    // Run consolidation
    await pipeline.runConsolidation();

    console.log(chalk.green('  Consolidation completed successfully.\n'));

    // Show result
    const memoryMd = pipeline.getMemoryMdContent();
    if (memoryMd) {
      console.log(chalk.white('  Memory.md Preview:'));
      console.log(chalk.gray('  ' + '-'.repeat(60)));
      const preview = memoryMd.substring(0, 500);
      console.log(chalk.dim(preview.split('\n').map(line => '  ' + line).join('\n')));
      if (memoryMd.length > 500) {
        console.log(chalk.gray('  ...'));
      }
      console.log(chalk.gray('  ' + '-'.repeat(60)));
      console.log(chalk.gray(`  (${memoryMd.length} bytes total)\n`));
    }

  } catch (error) {
    console.error(chalk.red(`\n  Error: ${(error as Error).message}\n`));
    process.exit(1);
  }
}

/**
 * Show pipeline status
 */
async function pipelineStatusAction(options: PipelineStatusOptions): Promise<void> {
  const { path: projectPath, json } = options;
  const basePath = projectPath || process.cwd();

  try {
    const store = getCoreMemoryStore(basePath);
    const scheduler = new MemoryJobScheduler(store.getDb());

    // Extraction status
    const stage1Count = store.countStage1Outputs();
    const extractionJobs = scheduler.listJobs('phase1_extraction');

    // Consolidation status
    let consolidationStatus = 'unavailable';
    let memoryMdAvailable = false;

    try {
      const consolidationPipeline = new MemoryConsolidationPipeline(basePath);
      const status = consolidationPipeline.getStatus();
      consolidationStatus = status?.status || 'unknown';
      memoryMdAvailable = !!consolidationPipeline.getMemoryMdContent();
    } catch {
      // Consolidation pipeline may not be initialized
    }

    // Job counts by status
    const jobCounts: Record<string, number> = {};
    for (const job of extractionJobs) {
      jobCounts[job.status] = (jobCounts[job.status] || 0) + 1;
    }

    const result = {
      extraction: {
        stage1Count,
        totalJobs: extractionJobs.length,
        jobCounts,
        recentJobs: extractionJobs.slice(0, 10).map(j => ({
          job_key: j.job_key,
          status: j.status,
          started_at: j.started_at,
          finished_at: j.finished_at,
          last_error: j.last_error,
        })),
      },
      consolidation: {
        status: consolidationStatus,
        memoryMdAvailable,
      },
    };

    if (json) {
      console.log(JSON.stringify(result, null, 2));
      return;
    }

    console.log(chalk.bold.cyan('\n  Memory Pipeline Status\n'));
    console.log(chalk.gray(`  Project: ${basePath}\n`));

    // Extraction status
    console.log(chalk.bold.white('  Extraction Pipeline:'));
    console.log(chalk.white(`    Stage 1 Outputs: ${stage1Count}`));
    console.log(chalk.white(`    Total Jobs: ${extractionJobs.length}`));

    if (Object.keys(jobCounts).length > 0) {
      console.log(chalk.white('    Job Status:'));
      for (const [status, count] of Object.entries(jobCounts)) {
        const statusColor = status === 'completed' ? chalk.green :
                           status === 'running' ? chalk.yellow : chalk.gray;
        console.log(`      ${statusColor(status)}: ${count}`);
      }
    }

    // Consolidation status
    console.log(chalk.bold.white('\n  Consolidation Pipeline:'));
    console.log(chalk.white(`    Status: ${consolidationStatus}`));
    console.log(chalk.white(`    Memory.md Available: ${memoryMdAvailable ? 'Yes' : 'No'}`));

    // Recent jobs
    if (extractionJobs.length > 0) {
      console.log(chalk.bold.white('\n  Recent Extraction Jobs:\n'));
      console.log(chalk.gray('  Status     Job Key'));
      console.log(chalk.gray('  ' + '-'.repeat(60)));

      for (const job of extractionJobs.slice(0, 10)) {
        const statusIcon = job.status === 'done' ? chalk.green('done    ') :
                          job.status === 'running' ? chalk.yellow('running ') :
                          job.status === 'pending' ? chalk.gray('pending ') :
                          chalk.red('error   ');
        console.log(`  ${statusIcon}  ${chalk.dim(job.job_key)}`);
      }

      if (extractionJobs.length > 10) {
        console.log(chalk.gray(`  ... and ${extractionJobs.length - 10} more`));
      }
    }

    console.log();

  } catch (error) {
    if (json) {
      console.log(JSON.stringify({ error: (error as Error).message }, null, 2));
    } else {
      console.error(chalk.red(`\n  Error: ${(error as Error).message}\n`));
    }
    process.exit(1);
  }
}

/**
 * Memory command entry point
 * @param {string} subcommand - Subcommand (track, import, stats, search, suggest, prune, embed, embed-status, preview, extract, consolidate, status)
 * @param {string|string[]} args - Arguments array
 * @param {Object} options - CLI options
 */
export async function memoryCommand(
  subcommand: string,
  args: string | string[],
  options: TrackOptions | ImportOptions | StatsOptions | SearchOptions | SuggestOptions | PruneOptions | EmbedCommandOptions | SearchCommandOptions | EmbedStatusOptions
): Promise<void> {
  const argsArray = Array.isArray(args) ? args : (args ? [args] : []);

  switch (subcommand) {
    case 'track':
      await trackAction(options as TrackOptions);
      break;

    case 'import':
      await importAction(options as ImportOptions);
      break;

    case 'stats':
      await statsAction(options as StatsOptions);
      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 as SearchCommandOptions);
      } else {
        await searchAction(argsArray[0], options as SearchOptions);
      }
      break;

    case 'suggest':
      await suggestAction(options as SuggestOptions);
      break;

    case 'prune':
      await pruneAction(options as PruneOptions);
      break;

    case 'embed':
      await embedAction(options as EmbedCommandOptions);
      break;

    case 'embed-status':
      await embedStatusAction(options as EmbedStatusOptions);
      break;

    // Memory Pipeline V2 subcommands
    case 'preview':
      await pipelinePreviewAction(options as PipelinePreviewOptions);
      break;

    case 'extract':
      await pipelineExtractAction(options as PipelineExtractOptions);
      break;

    case 'consolidate':
      await pipelineConsolidateAction(options as PipelineConsolidateOptions);
      break;

    case 'status':
      await pipelineStatusAction(options as PipelineStatusOptions);
      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(chalk.bold.cyan('  Memory Pipeline V2:'));
      console.log(chalk.gray('    preview             Preview eligible sessions for extraction'));
      console.log(chalk.gray('    extract             Trigger extraction for sessions'));
      console.log(chalk.gray('    consolidate         Trigger consolidation pipeline'));
      console.log(chalk.gray('    status              Show pipeline 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(chalk.bold.cyan('  Pipeline V2 Options:'));
      console.log();
      console.log('  Preview Options:');
      console.log(chalk.gray('    --include-native    Include native sessions in preview'));
      console.log(chalk.gray('    --path <path>       Project path (default: current directory)'));
      console.log(chalk.gray('    --json              Output as JSON'));
      console.log();
      console.log('  Extract Options:');
      console.log(chalk.gray('    --max-sessions <n>  Max sessions to extract (default: 10)'));
      console.log(chalk.gray('    --session-ids <ids> Comma-separated session IDs for selective extraction'));
      console.log(chalk.gray('    --path <path>       Project path (default: current directory)'));
      console.log();
      console.log('  Consolidate Options:');
      console.log(chalk.gray('    --path <path>       Project path (default: current directory)'));
      console.log();
      console.log('  Pipeline Status Options:');
      console.log(chalk.gray('    --path <path>       Project path (default: current directory)'));
      console.log(chalk.gray('    --json              Output as JSON'));
      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();
      console.log(chalk.cyan('  Pipeline V2 Examples:'));
      console.log(chalk.gray('    ccw memory preview                            # Preview extraction queue'));
      console.log(chalk.gray('    ccw memory preview --include-native           # Include native sessions'));
      console.log(chalk.gray('    ccw memory extract --max-sessions 10          # Batch extract up to 10'));
      console.log(chalk.gray('    ccw memory extract --session-ids sess-1,sess-2  # Selective extraction'));
      console.log(chalk.gray('    ccw memory consolidate                        # Run consolidation'));
      console.log(chalk.gray('    ccw memory status                             # Check pipeline status'));
      console.log();
  }
}