myshell-tools 1.0.0 → 2.0.0

package/src/repl.mjs

@@ -1,321 +0,0 @@
-/**
- * repl.mjs — Enhanced interactive conversation loop with rich hierarchy display
- */
-
-import * as readline from 'readline';
-import { chef } from './chef.mjs';
-import { addMessage, loadSession, getSessionSummary } from './state/session.mjs';
-import { endPerformanceSession } from './monitor/performance.mjs';
-import { displayQuickSummary } from './monitor/report.mjs';
-import { fmt, separator, formatTier, formatDuration, timeAgo, formatConfidence } from './ui/formatter.mjs';
-import { status, tier, session as sessionIcons, getConfidenceIcon } from './ui/icons.mjs';
-import { createSpinner, HierarchicalProgress } from './ui/progress.mjs';
-import { displayError, handleError } from './ui/errors.mjs';
-
-/**
- * Create and configure readline interface
- */
-function createReadlineInterface() {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-    prompt: 'You: ',
-    history: [],
-    historySize: 100
-  });
-
-  // Handle Ctrl+C gracefully with enhanced output
-  rl.on('SIGINT', () => {
-    console.log('\n');
-    const spinner = createSpinner('Finalizing session...');
-    spinner.start();
-
-    setTimeout(() => {
-      spinner.success('Session finalized');
-      endPerformanceSession();
-      displayQuickSummary();
-      console.log(fmt.success('Session saved. Goodbye!'));
-      process.exit(0);
-    }, 500);
-  });
-
-  return rl;
-}
-
-/**
- * Display enhanced session resume info
- */
-function displaySessionResume() {
-  const summary = getSessionSummary();
-
-  if (summary.messageCount > 0) {
-    const sessionIcon = sessionIcons.active;
-    const lastTime = summary.lastMessage
-      ? timeAgo(summary.lastMessage.timestamp)
-      : 'Unknown';
-    const duration = summary.duration ? formatDuration(summary.duration) : '';
-
-    console.log(`\n${sessionIcon} ${fmt.cyan('Resuming active session')}`);
-    console.log(`  ${fmt.dim('Messages:')} ${fmt.bold(summary.userMessageCount)} exchanges`);
-    if (duration) {
-      console.log(`  ${fmt.dim('Duration:')} ${fmt.bold(duration)}`);
-    }
-    console.log(`  ${fmt.dim('Last activity:')} ${fmt.bold(lastTime)}`);
-
-    // Show recent context
-    if (summary.lastMessage) {
-      const preview = summary.lastMessage.content.slice(0, 80);
-      const truncated = summary.lastMessage.content.length > 80 ? '...' : '';
-      console.log(`  ${fmt.dim('Context:')} ${fmt.dim(`"${preview}${truncated}"`)}`);
-    }
-  } else {
-    console.log(`\n${sessionIcons.new} ${fmt.green('Starting new session')}`);
-    console.log(`  ${fmt.dim('Ready for AI-powered development workflow')}`);
-  }
-}
-
-/**
- * Display enhanced result with rich formatting and visual hierarchy
- */
-function displayResult(result) {
-  if (result.success) {
-    console.log('\n' + separator(60, '═', fmt.green('')));
-
-    // Status line with tier and model info
-    const tierIcon = tier[result.tier] || tier.worker;
-    const formattedTier = formatTier(result.tier);
-    console.log(`${status.success} ${fmt.success('Completed by')} ${tierIcon} ${formattedTier}`);
-
-    // Model information
-    if (result.model) {
-      const modelDisplay = `${result.model.provider}/${result.model.model}`;
-      console.log(`  ${fmt.dim('Model:')} ${fmt.formatModel(result.model.provider, result.model.model)}`);
-    }
-
-    // Confidence display with visual indicator
-    if (result.confidence !== null) {
-      const confidenceIcon = getConfidenceIcon(result.confidence);
-      const confidenceText = formatConfidence(result.confidence);
-      console.log(`  ${confidenceIcon} ${fmt.dim('Confidence:')} ${confidenceText}`);
-    }
-
-    // Escalation information
-    if (result.totalAttempts > 1) {
-      const escalations = result.totalAttempts - 1;
-      console.log(`  ${status.loading} ${fmt.warning(`Escalations: ${escalations}`)}`);
-    }
-
-    // Duration with smart formatting
-    if (result.durationMs) {
-      const duration = formatDuration(result.durationMs);
-      const durationColor = result.durationMs > 30000 ? fmt.yellow : fmt.green;
-      console.log(`  ${fmt.dim('Duration:')} ${durationColor(duration)}`);
-    }
-
-    // Token efficiency (if available)
-    if (result.tokensUsed) {
-      console.log(`  ${fmt.dim('Tokens:')} ${fmt.cyan(result.tokensUsed.toLocaleString())}`);
-    }
-
-    console.log(separator(60, '═', fmt.green('')));
-    console.log('\n' + result.output);
-
-  } else {
-    console.log('\n' + separator(60, '═', fmt.red('')));
-
-    // Error status line
-    const tierIcon = result.tier ? tier[result.tier] || tier.worker : status.error;
-    console.log(`${status.error} ${fmt.error('Task Failed')}`);
-
-    // Final tier information
-    if (result.tier) {
-      const formattedTier = formatTier(result.tier);
-      console.log(`  ${fmt.dim('Final tier:')} ${tierIcon} ${formattedTier}`);
-    }
-
-    // Attempt information
-    if (result.totalAttempts) {
-      console.log(`  ${fmt.dim('Attempts:')} ${fmt.yellow(result.totalAttempts)}`);
-    }
-
-    // Duration
-    if (result.durationMs) {
-      const duration = formatDuration(result.durationMs);
-      console.log(`  ${fmt.dim('Duration:')} ${fmt.dim(duration)}`);
-    }
-
-    console.log(separator(60, '═', fmt.red('')));
-
-    // Error message with proper formatting
-    const errorMsg = result.output || result.error || 'Unknown error';
-    console.log('\n' + fmt.error(errorMsg));
-  }
-  console.log('\n');
-}
-
-/**
- * Main REPL loop
- */
-export async function startREPL(context) {
-  const rl = createReadlineInterface();
-
-  displaySessionResume();
-
-  console.log('\nType your request and press Enter. Use Ctrl+C to exit.\n');
-
-  const askQuestion = () => {
-    rl.prompt();
-  };
-
-  rl.on('line', async (input) => {
-    const userInput = input.trim();
-
-    if (!userInput) {
-      askQuestion();
-      return;
-    }
-
-    // Handle special commands
-    if (userInput === '/quit' || userInput === '/exit') {
-      console.log('\nGoodbye! Session saved.');
-      rl.close();
-      return;
-    }
-
-    if (userInput === '/clear') {
-      console.clear();
-      displaySessionResume();
-      askQuestion();
-      return;
-    }
-
-    if (userInput === '/help') {
-      console.log(fmt.bold('\n📋 Available Commands:'));
-      console.log(separator(50, '─'));
-
-      const helpSections = [
-        {
-          title: 'Chat Commands:',
-          commands: [
-            { cmd: '/help', desc: 'Show this help' },
-            { cmd: '/clear', desc: 'Clear screen and show session info' },
-            { cmd: '/status', desc: 'Show detailed session status' },
-            { cmd: '/quit or /exit', desc: 'Exit Cortex gracefully' }
-          ]
-        },
-        {
-          title: 'AI Org Chart Hierarchy:',
-          commands: [
-            { cmd: `${tier.worker} WORKER`, desc: 'Simple tasks, file search, documentation' },
-            { cmd: `${tier.ic} IC`, desc: 'Implementation, coding, main development work' },
-            { cmd: `${tier.manager} MANAGER`, desc: 'Architecture, reviews, complex decisions' }
-          ]
-        }
-      ];
-
-      for (const section of helpSections) {
-        console.log(`\n  ${fmt.bold(section.title)}`);
-        for (const item of section.commands) {
-          const cmdPadded = item.cmd.padEnd(20);
-          console.log(`    ${fmt.cyan(cmdPadded)} ${fmt.dim('—')} ${item.desc}`);
-        }
-      }
-
-      console.log(`\n  ${fmt.dim('Cortex automatically routes tasks to the right tier and escalates when needed.')}`);
-      console.log('');
-      askQuestion();
-      return;
-    }
-
-    if (userInput === '/status') {
-      const summary = getSessionSummary();
-
-      console.log('\n' + fmt.bold('📊 Session Status:'));
-      console.log(separator(40, '─'));
-
-      console.log(`  ${sessionIcons.active} ${fmt.bold('Active Session')}`);
-      console.log(`    Messages: ${fmt.cyan(summary.messageCount)} (${summary.userMessageCount} user, ${summary.assistantMessageCount} assistant)`);
-
-      if (summary.duration) {
-        const duration = formatDuration(summary.duration);
-        console.log(`    Duration: ${fmt.cyan(duration)}`);
-      }
-
-      if (summary.lastMessage) {
-        const lastTime = timeAgo(summary.lastMessage.timestamp);
-        console.log(`    Last activity: ${fmt.cyan(lastTime)}`);
-
-        // Show performance stats if available
-        const avgResponseTime = '1.3s'; // Mock - replace with real data
-        const successRate = '96%'; // Mock - replace with real data
-        console.log(`    Performance: ${fmt.green(avgResponseTime)} avg, ${fmt.green(successRate)} success`);
-      }
-
-      console.log('');
-      askQuestion();
-      return;
-    }
-
-    // Save user message
-    addMessage('user', userInput);
-
-    // Process with the chef with enhanced progress indication
-    try {
-      // Show processing indicator
-      const spinner = createSpinner('Processing request...');
-      spinner.start();
-
-      const result = await chef(userInput, context);
-
-      // Stop spinner and show result
-      spinner.stop();
-
-      // Save assistant response
-      addMessage('assistant', result.output, {
-        tier: result.tier,
-        confidence: result.confidence,
-        success: result.success,
-        model: result.model ? `${result.model.provider}/${result.model.model}` : null,
-        duration: result.durationMs,
-        tokensUsed: result.tokensUsed
-      });
-
-      // Display enhanced result
-      displayResult(result);
-
-    } catch (error) {
-      // Enhanced error display
-      console.log('\n' + separator(60, '═', fmt.red('')));
-      console.log(`${status.error} ${fmt.error('Orchestration Error')}`);
-      console.log(`  ${fmt.dim('Details:')} ${error.message}`);
-      console.log(`  ${status.info} Try rephrasing your request or check --doctor`);
-      console.log(separator(60, '═', fmt.red('')) + '\n');
-
-      // Save error message
-      addMessage('assistant', `Error: ${error.message}`, {
-        success: false,
-        error: true,
-        timestamp: Date.now()
-      });
-    }
-
-    askQuestion();
-  });
-
-  rl.on('close', () => {
-    console.log('\n');
-    const spinner = createSpinner('Finalizing session...');
-    spinner.start();
-
-    setTimeout(() => {
-      spinner.success('Session finalized');
-      endPerformanceSession();
-      displayQuickSummary();
-      console.log(fmt.success('Session saved. Goodbye!'));
-      process.exit(0);
-    }, 500);
-  });
-
-  // Start the conversation
-  askQuestion();
-}

package/src/state/archive.mjs

@@ -1,366 +0,0 @@
-/**
- * archive.mjs — Session archiving and long-term state management
- */
-
-import { existsSync, readFileSync, writeFileSync, readdirSync, statSync, mkdirSync } from 'fs';
-import { join } from 'path';
-import { atomicWriteJSON } from './atomic.mjs';
-import { loadSession, getSessionSummary } from './session.mjs';
-
-/**
- * Get archive directory
- */
-function getArchiveDir(workspace = process.cwd()) {
-  const archiveDir = join(workspace, '.cortex', 'archive');
-  if (!existsSync(archiveDir)) {
-    mkdirSync(archiveDir, { recursive: true });
-  }
-  return archiveDir;
-}
-
-/**
- * Create a comprehensive session archive
- */
-export function createSessionArchive(reason = 'manual', metadata = {}, workspace = process.cwd()) {
-  const summary = getSessionSummary(workspace);
-
-  if (summary.messageCount === 0) {
-    return { archived: false, reason: 'No session data to archive' };
-  }
-
-  const archiveId = `session-${Date.now()}-${Math.random().toString(36).substr(2, 8)}`;
-  const archiveDir = getArchiveDir(workspace);
-
-  const archive = {
-    id: archiveId,
-    timestamp: new Date().toISOString(),
-    reason,
-    summary,
-    messages: loadSession(workspace),
-    workspace: workspace,
-    metadata: {
-      ...metadata,
-      cortexVersion: '1.0.0',
-      nodeVersion: process.version,
-      platform: process.platform
-    }
-  };
-
-  // Add performance metrics if available
-  if (summary.duration) {
-    archive.performance = {
-      totalDuration: summary.duration,
-      avgResponseTime: summary.duration / Math.max(summary.assistantMessageCount, 1),
-      messagesPerMinute: (summary.messageCount / (summary.duration / 60000)).toFixed(2)
-    };
-  }
-
-  const archivePath = join(archiveDir, `${archiveId}.json`);
-  atomicWriteJSON(archivePath, archive);
-
-  // Create human-readable summary
-  const summaryPath = join(archiveDir, `${archiveId}-summary.md`);
-  const summaryContent = createMarkdownSummary(archive);
-  writeFileSync(summaryPath, summaryContent);
-
-  return {
-    archived: true,
-    archiveId,
-    archivePath,
-    summaryPath,
-    messageCount: summary.messageCount,
-    duration: summary.duration
-  };
-}
-
-/**
- * Create markdown summary of the session
- */
-function createMarkdownSummary(archive) {
-  const { summary, messages, performance, reason, timestamp } = archive;
-
-  let content = `# Cortex Session Archive\n\n`;
-  content += `**Archive ID:** ${archive.id}\n`;
-  content += `**Created:** ${new Date(timestamp).toLocaleString()}\n`;
-  content += `**Reason:** ${reason}\n`;
-  content += `**Workspace:** ${archive.workspace}\n\n`;
-
-  content += `## Summary\n\n`;
-  content += `- **Total Messages:** ${summary.messageCount}\n`;
-  content += `- **User Messages:** ${summary.userMessageCount}\n`;
-  content += `- **Assistant Messages:** ${summary.assistantMessageCount}\n`;
-
-  if (summary.duration) {
-    const durationMin = Math.round(summary.duration / 60000);
-    content += `- **Duration:** ${durationMin} minutes\n`;
-  }
-
-  if (performance) {
-    content += `\n## Performance\n\n`;
-    content += `- **Average Response Time:** ${Math.round(performance.avgResponseTime / 1000)}s\n`;
-    content += `- **Messages Per Minute:** ${performance.messagesPerMinute}\n`;
-  }
-
-  // Add sample of conversations
-  const userMessages = messages.filter(m => m.role === 'user');
-  if (userMessages.length > 0) {
-    content += `\n## Conversation Topics\n\n`;
-    const sampleSize = Math.min(5, userMessages.length);
-    const samples = userMessages.slice(0, sampleSize);
-
-    for (const [index, msg] of samples.entries()) {
-      const preview = msg.content.length > 80 ?
-        msg.content.substring(0, 80) + '...' :
-        msg.content;
-      content += `${index + 1}. ${preview}\n`;
-    }
-
-    if (userMessages.length > sampleSize) {
-      content += `\n_(${userMessages.length - sampleSize} more messages not shown)_\n`;
-    }
-  }
-
-  // Add handoff statistics if available
-  const handoffMessages = messages.filter(m => m.type === 'handoff');
-  if (handoffMessages.length > 0) {
-    content += `\n## Hierarchy Activity\n\n`;
-    content += `- **Total Handoffs:** ${handoffMessages.length}\n`;
-
-    const escalations = handoffMessages.filter(m => m.operation === 'escalate').length;
-    const delegations = handoffMessages.filter(m => m.operation === 'delegate').length;
-    const bounces = handoffMessages.filter(m => m.operation === 'bounce').length;
-
-    if (escalations > 0) content += `- **Escalations:** ${escalations}\n`;
-    if (delegations > 0) content += `- **Delegations:** ${delegations}\n`;
-    if (bounces > 0) content += `- **Bounces:** ${bounces}\n`;
-  }
-
-  content += `\n## Archive Details\n\n`;
-  content += `Full conversation data is available in: \`${archive.id}.json\`\n`;
-
-  return content;
-}
-
-/**
- * List available archives with metadata
- */
-export function listArchives(workspace = process.cwd()) {
-  const archiveDir = getArchiveDir(workspace);
-
-  if (!existsSync(archiveDir)) {
-    return [];
-  }
-
-  try {
-    const archiveFiles = readdirSync(archiveDir)
-      .filter(f => f.endsWith('.json') && f.startsWith('session-'))
-      .map(f => join(archiveDir, f))
-      .map(filePath => {
-        try {
-          const archive = JSON.parse(readFileSync(filePath, 'utf8'));
-          const stat = statSync(filePath);
-
-          return {
-            id: archive.id,
-            timestamp: archive.timestamp,
-            reason: archive.reason,
-            messageCount: archive.summary.messageCount,
-            duration: archive.summary.duration,
-            fileSize: stat.size,
-            filePath
-          };
-        } catch {
-          return null;
-        }
-      })
-      .filter(Boolean)
-      .sort((a, b) => new Date(b.timestamp) - new Date(a.timestamp));
-
-    return archiveFiles;
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Get archive by ID
- */
-export function getArchive(archiveId, workspace = process.cwd()) {
-  const archiveDir = getArchiveDir(workspace);
-  const archivePath = join(archiveDir, `${archiveId}.json`);
-
-  if (!existsSync(archivePath)) {
-    throw new Error(`Archive ${archiveId} not found`);
-  }
-
-  try {
-    return JSON.parse(readFileSync(archivePath, 'utf8'));
-  } catch (error) {
-    throw new Error(`Failed to load archive ${archiveId}: ${error.message}`);
-  }
-}
-
-/**
- * Delete old archives to manage storage
- */
-export function cleanupOldArchives(maxAge = 30, workspace = process.cwd()) {
-  const archiveDir = getArchiveDir(workspace);
-  const maxAgeMs = maxAge * 24 * 60 * 60 * 1000; // Convert days to ms
-  const cutoff = Date.now() - maxAgeMs;
-
-  if (!existsSync(archiveDir)) {
-    return { deleted: 0, preserved: 0, errors: [] };
-  }
-
-  const archives = listArchives(workspace);
-  let deleted = 0;
-  let preserved = 0;
-  const errors = [];
-
-  for (const archive of archives) {
-    const archiveDate = new Date(archive.timestamp).getTime();
-
-    if (archiveDate < cutoff) {
-      try {
-        const archivePath = archive.filePath;
-        const summaryPath = archivePath.replace('.json', '-summary.md');
-
-        // Delete both files
-        if (existsSync(archivePath)) {
-          require('fs').unlinkSync(archivePath);
-        }
-        if (existsSync(summaryPath)) {
-          require('fs').unlinkSync(summaryPath);
-        }
-
-        deleted++;
-      } catch (error) {
-        errors.push(`Failed to delete ${archive.id}: ${error.message}`);
-      }
-    } else {
-      preserved++;
-    }
-  }
-
-  return { deleted, preserved, errors };
-}
-
-/**
- * Export archives to external format
- */
-export function exportArchives(format = 'json', outputPath = null, workspace = process.cwd()) {
-  const archives = listArchives(workspace);
-
-  if (archives.length === 0) {
-    return { exported: false, reason: 'No archives to export' };
-  }
-
-  const exportData = {
-    exported: new Date().toISOString(),
-    cortexVersion: '1.0.0',
-    workspace: workspace,
-    archiveCount: archives.length,
-    archives: archives.map(meta => {
-      try {
-        return getArchive(meta.id, workspace);
-      } catch (error) {
-        return { error: error.message, id: meta.id };
-      }
-    })
-  };
-
-  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-  const filename = outputPath || join(workspace, `.cortex-export-${timestamp}.${format}`);
-
-  try {
-    if (format === 'json') {
-      writeFileSync(filename, JSON.stringify(exportData, null, 2));
-    } else {
-      throw new Error(`Unsupported export format: ${format}`);
-    }
-
-    return {
-      exported: true,
-      filename,
-      archiveCount: archives.length,
-      fileSize: require('fs').statSync(filename).size
-    };
-  } catch (error) {
-    return {
-      exported: false,
-      error: error.message
-    };
-  }
-}
-
-/**
- * Get storage usage statistics
- */
-export function getStorageStats(workspace = process.cwd()) {
-  const cortexDir = join(workspace, '.cortex');
-
-  if (!existsSync(cortexDir)) {
-    return { totalSize: 0, breakdown: {} };
-  }
-
-  const stats = {
-    totalSize: 0,
-    breakdown: {
-      sessions: 0,
-      archives: 0,
-      plans: 0,
-      auth: 0,
-      other: 0
-    }
-  };
-
-  function calculateDirSize(dir, category = 'other') {
-    if (!existsSync(dir)) return 0;
-
-    let size = 0;
-    try {
-      const entries = readdirSync(dir);
-
-      for (const entry of entries) {
-        const fullPath = join(dir, entry);
-        const stat = statSync(fullPath);
-
-        if (stat.isDirectory()) {
-          size += calculateDirSize(fullPath, category);
-        } else {
-          size += stat.size;
-        }
-      }
-    } catch {
-      // Permission or access error
-    }
-
-    stats.breakdown[category] += size;
-    return size;
-  }
-
-  // Calculate sizes by category
-  calculateDirSize(join(cortexDir, 'sessions'), 'sessions');
-  calculateDirSize(join(cortexDir, 'archive'), 'archives');
-  calculateDirSize(join(cortexDir, 'plans'), 'plans');
-  calculateDirSize(join(cortexDir, 'auth'), 'auth');
-
-  // Calculate other files
-  try {
-    const cortexEntries = readdirSync(cortexDir);
-    for (const entry of cortexEntries) {
-      const fullPath = join(cortexDir, entry);
-      const stat = statSync(fullPath);
-
-      if (stat.isFile()) {
-        stats.breakdown.other += stat.size;
-      }
-    }
-  } catch {
-    // Access error
-  }
-
-  stats.totalSize = Object.values(stats.breakdown).reduce((sum, size) => sum + size, 0);
-
-  return stats;
-}