myshell-tools 1.0.0 → 2.0.0-alpha.0

package/src/commands/doctor.mjs

@@ -1,375 +0,0 @@
-/**
- * doctor.mjs — Enhanced system health check with visual dashboard
- */
-
-import { detectEnvironment, getAvailableModels } from '../providers/detect.mjs';
-import { fmt, box, separator, providerBalanceBar } from '../ui/formatter.mjs';
-import { status, provider, tier, health } from '../ui/icons.mjs';
-
-/**
- * Run comprehensive system health check
- */
-export async function runDoctorCheck() {
-  console.log(box('🩺 Cortex System Health Check', {
-    borderColor: fmt.blue(''),
-    textColor: fmt.bold(''),
-    padding: 1,
-    margin: 1
-  }));
-
-  const env = detectEnvironment();
-  const models = getAvailableModels(env);
-
-  // Provider Status Section
-  console.log(fmt.bold('\n📋 Provider Status:'));
-  console.log(separator(50, '─'));
-
-  checkProviderStatus('Claude', env.claude);
-  checkProviderStatus('Codex', env.codex);
-
-  // Model Availability Section
-  console.log(fmt.bold('\n🤖 Model Availability:'));
-  console.log(separator(50, '─'));
-
-  checkModelTiers(models);
-
-  // Environment Section
-  console.log(fmt.bold('\n🌍 Environment:'));
-  console.log(separator(50, '─'));
-
-  checkEnvironment(env);
-
-  // Performance Section
-  console.log(fmt.bold('\n📊 Performance:'));
-  console.log(separator(50, '─'));
-
-  await checkPerformance(env);
-
-  // Overall Health Assessment with visual summary
-  console.log(fmt.bold('\n🏥 Health Summary:'));
-  console.log(separator(50, '─'));
-
-  const healthStatus = assessOverallHealth(env, models);
-  displayHealthSummary(healthStatus);
-
-  // Quick action summary
-  console.log(fmt.bold('\n🚀 Quick Actions:'));
-  console.log(separator(50, '─'));
-  displayQuickActions(healthStatus);
-
-  // Recommendations
-  if (healthStatus.issues.length > 0) {
-    console.log(fmt.bold('\n💡 Recommendations:'));
-    console.log(separator(50, '─'));
-    displayRecommendations(healthStatus.issues);
-  }
-
-  console.log('');
-}
-
-/**
- * Check individual provider status
- */
-function checkProviderStatus(name, providerInfo) {
-  const icon = provider[name.toLowerCase()] || '○';
-  const installIcon = providerInfo.installed ? status.success : status.error;
-  const authIcon = providerInfo.authed ? status.success : status.warning;
-
-  console.log(`  ${icon} ${fmt.bold(name)} Provider:`);
-  console.log(`    Installation: ${installIcon} ${providerInfo.installed ? 'Found' : 'Missing'}`);
-
-  if (providerInfo.version) {
-    console.log(`    Version: ${fmt.dim(providerInfo.version)}`);
-  }
-
-  console.log(`    Authentication: ${authIcon} ${providerInfo.authed ? 'Valid' : 'Invalid'}`);
-
-  if (!providerInfo.installed) {
-    displayInstallGuidance(name);
-  } else if (!providerInfo.authed) {
-    displayAuthGuidance(name);
-  }
-
-  console.log('');
-}
-
-/**
- * Check model tier availability
- */
-function checkModelTiers(models) {
-  const tiers = [
-    { name: 'Manager', key: 'manager', icon: tier.manager, description: 'Complex decisions, architecture, reviews' },
-    { name: 'IC', key: 'ic', icon: tier.ic, description: 'Implementation, coding, main workload' },
-    { name: 'Worker', key: 'worker', icon: tier.worker, description: 'Simple tasks, lookups, grep operations' }
-  ];
-
-  for (const tierInfo of tiers) {
-    const tierModels = models[tierInfo.key] || [];
-    const count = tierModels.length;
-    const healthIcon = count > 0 ? health.healthy : health.critical;
-
-    console.log(`  ${tierInfo.icon} ${fmt.bold(tierInfo.name)} Tier: ${healthIcon} ${count} model(s) available`);
-    console.log(`    ${fmt.dim(tierInfo.description)}`);
-
-    if (count > 0) {
-      for (const model of tierModels.slice(0, 3)) { // Show first 3 models
-        const modelDisplay = `${model.provider}/${model.model}`;
-        console.log(`    ${fmt.dim('├─')} ${fmt.green(modelDisplay)}`);
-      }
-      if (tierModels.length > 3) {
-        console.log(`    ${fmt.dim('└─')} ${fmt.dim(`... and ${tierModels.length - 3} more`)}`);
-      }
-    } else {
-      console.log(`    ${fmt.red('└─ No models available for this tier')}`);
-    }
-
-    console.log('');
-  }
-}
-
-/**
- * Check environment details
- */
-function checkEnvironment(env) {
-  console.log(`  📁 Workspace: ${fmt.cyan(env.workspace)}`);
-  console.log(`  📊 Sessions: ${fmt.cyan(env.workspace + '/.cortex/sessions/')}`);
-
-  const hasProviders = env.hasProviders;
-  const providerIcon = hasProviders ? status.success : status.error;
-  console.log(`  🔌 Providers: ${providerIcon} ${hasProviders ? 'Ready' : 'None authenticated'}`);
-
-  // Check session directory
-  try {
-    const sessionPath = env.workspace + '/.cortex/sessions/';
-    console.log(`  💾 Session Storage: ${status.success} Accessible`);
-  } catch (error) {
-    console.log(`  💾 Session Storage: ${status.error} Error - ${error.message}`);
-  }
-
-  console.log('');
-}
-
-/**
- * Check performance metrics
- */
-async function checkPerformance(env) {
-  // Mock performance check - in a real implementation this would test actual response times
-  console.log(`  ⚡ Claude Response Time: ${fmt.green('~1.2s')} ${fmt.dim('(excellent)')}`);
-  console.log(`  ⚡ Codex Response Time: ${fmt.green('~0.8s')} ${fmt.dim('(excellent)')}`);
-
-  // Show today's usage balance
-  const balance = mockGetUsageBalance();
-  console.log(`  📊 Today's Usage Balance:`);
-  console.log(`    ${providerBalanceBar(balance.claude, balance.openai)}`);
-  console.log(`    ${fmt.dim(balance.label)}`);
-
-  console.log('');
-}
-
-/**
- * Assess overall health
- */
-function assessOverallHealth(env, models) {
-  const issues = [];
-  let status = 'healthy';
-
-  // Check critical issues
-  if (!env.hasProviders) {
-    issues.push({
-      level: 'critical',
-      message: 'No authenticated providers found',
-      action: 'Authenticate at least one provider to use Cortex'
-    });
-    status = 'critical';
-  }
-
-  if (models.manager.length === 0 && models.ic.length === 0) {
-    issues.push({
-      level: 'critical',
-      message: 'No models available for work execution',
-      action: 'Check provider authentication and model availability'
-    });
-    status = 'critical';
-  }
-
-  // Check warnings
-  if (models.manager.length === 0) {
-    issues.push({
-      level: 'warning',
-      message: 'No Manager tier models available',
-      action: 'Complex tasks may not escalate properly'
-    });
-    if (status === 'healthy') status = 'warning';
-  }
-
-  if (!env.claude.authed && env.claude.installed) {
-    issues.push({
-      level: 'warning',
-      message: 'Claude CLI installed but not authenticated',
-      action: 'Run: claude auth login'
-    });
-    if (status === 'healthy') status = 'warning';
-  }
-
-  if (!env.codex.authed && env.codex.installed) {
-    issues.push({
-      level: 'warning',
-      message: 'Codex CLI installed but not authenticated',
-      action: 'Run: codex login'
-    });
-    if (status === 'healthy') status = 'warning';
-  }
-
-  return { status, issues, env, models };
-}
-
-/**
- * Display health summary
- */
-function displayHealthSummary(healthStatus) {
-  const { status: healthState, issues, models } = healthStatus;
-
-  let summaryIcon, summaryText, summaryColor;
-  switch (healthState) {
-    case 'healthy':
-      summaryIcon = health.healthy;
-      summaryText = 'System is healthy and ready for AI orchestration';
-      summaryColor = fmt.green;
-      break;
-    case 'warning':
-      summaryIcon = health.warning;
-      summaryText = 'System is functional but has some issues';
-      summaryColor = fmt.yellow;
-      break;
-    case 'critical':
-      summaryIcon = health.critical;
-      summaryText = 'System has critical issues that prevent operation';
-      summaryColor = fmt.red;
-      break;
-    default:
-      summaryIcon = health.unknown;
-      summaryText = 'Health status unknown';
-      summaryColor = fmt.dim;
-  }
-
-  console.log(`  ${summaryIcon} ${summaryColor(fmt.bold('Overall Health:'))} ${summaryColor(summaryText)}`);
-
-  // Show capability summary
-  const capabilities = [];
-  if (models.manager.length > 0) capabilities.push('Complex reasoning');
-  if (models.ic.length > 0) capabilities.push('Code implementation');
-  if (models.worker.length > 0) capabilities.push('Simple tasks');
-
-  if (capabilities.length > 0) {
-    console.log(`  ${status.info} ${fmt.bold('Available Capabilities:')} ${capabilities.join(', ')}`);
-  }
-
-  console.log(`  ${tier.worker} ${fmt.bold('Ready for:')} ${issues.length === 0 ? 'All operations' : 'Limited operations'}`);
-  console.log('');
-}
-
-/**
- * Display actionable recommendations
- */
-function displayRecommendations(issues) {
-  for (let i = 0; i < issues.length; i++) {
-    const issue = issues[i];
-    const levelIcon = issue.level === 'critical' ? status.error : status.warning;
-    const levelColor = issue.level === 'critical' ? fmt.red : fmt.yellow;
-
-    console.log(`  ${levelIcon} ${levelColor(fmt.bold(issue.message))}`);
-    console.log(`    ${status.info} ${issue.action}`);
-
-    if (i < issues.length - 1) {
-      console.log('');
-    }
-  }
-  console.log('');
-}
-
-/**
- * Display installation guidance
- */
-function displayInstallGuidance(providerName) {
-  const guides = {
-    Claude: {
-      command: 'pip install anthropic-cli',
-      docs: 'https://claude.ai/cli'
-    },
-    Codex: {
-      command: 'npm install -g @openai/codex',
-      docs: 'https://openai.com/codex'
-    }
-  };
-
-  const guide = guides[providerName];
-  if (guide) {
-    console.log(`    ${status.info} Install: ${fmt.cyan(guide.command)}`);
-    console.log(`    ${status.docs} Guide: ${fmt.cyan(guide.docs)}`);
-  }
-}
-
-/**
- * Display authentication guidance
- */
-function displayAuthGuidance(providerName) {
-  const commands = {
-    Claude: 'claude auth login',
-    Codex: 'codex login'
-  };
-
-  const command = commands[providerName];
-  if (command) {
-    console.log(`    ${status.info} Authenticate: ${fmt.cyan(command)}`);
-  }
-}
-
-/**
- * Mock function to get usage balance (replace with real implementation)
- */
-function mockGetUsageBalance() {
-  // This would read from actual usage logs
-  return {
-    claude: 45,
-    openai: 55,
-    total: 23,
-    label: 'Well balanced across providers'
-  };
-}
-
-/**
- * Display quick actions based on health status
- */
-function displayQuickActions(healthStatus) {
-  const { status: healthState, env } = healthStatus;
-
-  if (healthState === 'healthy') {
-    console.log(`  ${status.success} ${fmt.green('System is ready!')} Run ${fmt.cyan('cortex')} to start`);
-  } else {
-    const actions = [];
-
-    if (!env.claude.authed && env.claude.installed) {
-      actions.push(`Run: ${fmt.cyan('claude auth login')}`);
-    }
-    if (!env.claude.installed) {
-      actions.push(`Install: ${fmt.cyan('pip install anthropic-cli')}`);
-    }
-    if (!env.codex.authed && env.codex.installed) {
-      actions.push(`Run: ${fmt.cyan('codex login')}`);
-    }
-    if (!env.codex.installed) {
-      actions.push(`Install: ${fmt.cyan('npm install -g @openai/codex')}`);
-    }
-
-    for (let i = 0; i < actions.length; i++) {
-      const action = actions[i];
-      console.log(`  ${i + 1}. ${action}`);
-    }
-
-    if (actions.length === 0) {
-      console.log(`  ${status.info} Run ${fmt.cyan('cortex')} to continue`);
-    }
-  }
-
-  console.log('');
-}

package/src/commands/help.mjs

@@ -1,324 +0,0 @@
-/**
- * help.mjs — Rich help system with examples and visual formatting
- */
-
-import { fmt, box, separator, createTree } from '../ui/formatter.mjs';
-import { status, tier, actions } from '../ui/icons.mjs';
-
-const VERSION = '1.0.0';
-
-/**
- * Display comprehensive help information
- */
-export function displayHelp() {
-  // Header
-  console.log(box(`Cortex v${VERSION} — AI Org Chart Orchestration`, {
-    borderColor: fmt.brightBlue(''),
-    textColor: fmt.bold(''),
-    padding: 1,
-    margin: 1
-  }));
-
-  // Quick Start
-  displayQuickStart();
-
-  // Commands
-  displayCommands();
-
-  // Hierarchy
-  displayHierarchy();
-
-  // Examples
-  displayExamples();
-
-  // Advanced Usage
-  displayAdvancedUsage();
-
-  console.log('');
-}
-
-/**
- * Display quick start section
- */
-function displayQuickStart() {
-  console.log(fmt.bold('\n🚀 Quick Start:'));
-  console.log(separator(60, '─'));
-
-  const quickSteps = [
-    {
-      text: fmt.green('cortex --doctor') + ' — Check system health',
-      children: [
-        { text: fmt.dim('Verify providers are installed and authenticated') }
-      ]
-    },
-    {
-      text: fmt.green('cortex') + ' — Start interactive chat',
-      children: [
-        { text: fmt.dim('Begin AI-powered development workflow') }
-      ]
-    },
-    {
-      text: fmt.dim('Type your request and press Enter'),
-      children: [
-        { text: fmt.dim('AI will route to appropriate tier automatically') }
-      ]
-    }
-  ];
-
-  const tree = createTree(quickSteps);
-  tree.forEach(line => console.log('  ' + line));
-
-  console.log('');
-}
-
-/**
- * Display all available commands
- */
-function displayCommands() {
-  console.log(fmt.bold('\n📋 Commands:'));
-  console.log(separator(60, '─'));
-
-  const commands = [
-    {
-      category: 'Main Usage',
-      items: [
-        { cmd: 'cortex', desc: 'Start interactive chat with AI hierarchy' },
-        { cmd: 'cortex --help', desc: 'Show this help information' },
-        { cmd: 'cortex --version', desc: 'Show version information' }
-      ]
-    },
-    {
-      category: 'System Health',
-      items: [
-        { cmd: 'cortex --doctor', desc: 'Run comprehensive health check' },
-        { cmd: 'cortex --status', desc: 'Show current session and system status' }
-      ]
-    },
-    {
-      category: 'Session Management',
-      items: [
-        { cmd: 'cortex --reset [level]', desc: 'Reset state (sessions, state, all, nuclear)' },
-        { cmd: 'cortex --cleanup', desc: 'Clean up old files and optimize storage' },
-        { cmd: 'cortex --resume [plan-id]', desc: 'Resume interrupted work' },
-        { cmd: 'cortex --recovery', desc: 'Show recovery options for interrupted work' }
-      ]
-    },
-    {
-      category: 'Analytics & Reporting',
-      items: [
-        { cmd: 'cortex --report', desc: 'Generate comprehensive session report' },
-        { cmd: 'cortex --trends [days]', desc: 'Show performance trends (default: 7 days)' }
-      ]
-    }
-  ];
-
-  for (const category of commands) {
-    console.log(`\n  ${fmt.bold(category.category)}:`);
-
-    for (const item of category.items) {
-      console.log(`    ${fmt.cyan(item.cmd.padEnd(25))} ${fmt.dim('—')} ${item.desc}`);
-    }
-  }
-
-  console.log('');
-}
-
-/**
- * Display AI hierarchy information
- */
-function displayHierarchy() {
-  console.log(fmt.bold('\n🏢 AI Org Chart Hierarchy:'));
-  console.log(separator(60, '─'));
-
-  const hierarchyLevels = [
-    {
-      name: 'MANAGER',
-      icon: tier.manager,
-      color: fmt.red,
-      description: 'Complex decisions, architecture, code review, escalations',
-      models: 'Claude Opus, GPT-5.5',
-      when: 'High complexity, architecture decisions, final reviews'
-    },
-    {
-      name: 'IC (Individual Contributor)',
-      icon: tier.ic,
-      color: fmt.yellow,
-      description: 'Main workhorses for implementation and coding tasks',
-      models: 'Claude Sonnet, GPT-5.4',
-      when: 'Implementation, bug fixes, feature development'
-    },
-    {
-      name: 'WORKER',
-      icon: tier.worker,
-      color: fmt.blue,
-      description: 'Fast, cheap models for simple tasks',
-      models: 'Claude Haiku, GPT-4.1-mini',
-      when: 'File search, grep, simple lookups, documentation'
-    }
-  ];
-
-  for (const level of hierarchyLevels) {
-    console.log(`  ${level.icon} ${level.color(fmt.bold(level.name))}`);
-    console.log(`    ${fmt.dim('Description:')} ${level.description}`);
-    console.log(`    ${fmt.dim('Models:')} ${fmt.green(level.models)}`);
-    console.log(`    ${fmt.dim('Best for:')} ${level.when}`);
-    console.log('');
-  }
-
-  console.log(fmt.bold('📈 How Escalation Works:'));
-  console.log(`  1. Tasks start at appropriate tier (usually ${fmt.yellow('IC')})`);
-  console.log(`  2. Models escalate ${fmt.red('UP')} when they need help or hit complexity`);
-  console.log(`  3. Managers can delegate ${fmt.blue('DOWN')} to workers for simple subtasks`);
-  console.log(`  4. Everything is transparent — you see the org chart in action`);
-
-  console.log('');
-}
-
-/**
- * Display usage examples
- */
-function displayExamples() {
-  console.log(fmt.bold('\n💡 Usage Examples:'));
-  console.log(separator(60, '─'));
-
-  const examples = [
-    {
-      category: 'Development Tasks',
-      examples: [
-        {
-          input: 'Fix the authentication bug in login.ts',
-          flow: 'IC → implements fix → Manager review if complex'
-        },
-        {
-          input: 'Find all files that import React hooks',
-          flow: 'Worker → searches codebase → returns file list'
-        },
-        {
-          input: 'Design a new microservices architecture',
-          flow: 'Manager → architectural planning → delegates implementation'
-        }
-      ]
-    },
-    {
-      category: 'Code Analysis',
-      examples: [
-        {
-          input: 'Explain how the authentication system works',
-          flow: 'Worker → reads files → IC → explains patterns'
-        },
-        {
-          input: 'Review this pull request for security issues',
-          flow: 'Manager → comprehensive security review'
-        },
-        {
-          input: 'What are the performance bottlenecks?',
-          flow: 'IC → analyzes code → Manager → strategic recommendations'
-        }
-      ]
-    },
-    {
-      category: 'Documentation',
-      examples: [
-        {
-          input: 'Write API documentation for the user service',
-          flow: 'Worker → reads code → IC → writes documentation'
-        },
-        {
-          input: 'Create a deployment guide',
-          flow: 'Manager → strategic overview → Worker → detailed steps'
-        }
-      ]
-    }
-  ];
-
-  for (const category of examples) {
-    console.log(`\n  ${fmt.bold(category.category)}:`);
-
-    for (const example of category.examples) {
-      console.log(`    ${status.info} ${fmt.green(`"${example.input}"`)}`);
-      console.log(`      ${fmt.dim('→')} ${fmt.dim(example.flow)}`);
-      console.log('');
-    }
-  }
-}
-
-/**
- * Display advanced usage information
- */
-function displayAdvancedUsage() {
-  console.log(fmt.bold('\n🔧 Advanced Usage:'));
-  console.log(separator(60, '─'));
-
-  console.log(fmt.bold('\n  Provider Setup:'));
-  const providers = [
-    {
-      name: 'Claude',
-      install: 'pip install anthropic-cli',
-      auth: 'claude auth login',
-      models: 'Opus (Manager), Sonnet (IC), Haiku (Worker)'
-    },
-    {
-      name: 'Codex',
-      install: 'npm install -g @openai/codex',
-      auth: 'codex login',
-      models: 'GPT-5.5 (Manager), GPT-5.4 (IC), GPT-4.1-mini (Worker)'
-    }
-  ];
-
-  for (const provider of providers) {
-    console.log(`\n    ${fmt.bold(provider.name)}:`);
-    console.log(`      Install: ${fmt.cyan(provider.install)}`);
-    console.log(`      Auth: ${fmt.cyan(provider.auth)}`);
-    console.log(`      Models: ${fmt.dim(provider.models)}`);
-  }
-
-  console.log(fmt.bold('\n  Reset Levels:'));
-  const resetLevels = [
-    { level: 'sessions', desc: 'Clear current session but keep archives and auth' },
-    { level: 'state', desc: 'Clear all state files but keep auth and archives' },
-    { level: 'all', desc: 'Clear everything except authentication' },
-    { level: 'nuclear', desc: 'Clear absolutely everything including authentication' }
-  ];
-
-  for (const level of resetLevels) {
-    console.log(`    ${fmt.cyan(level.level.padEnd(10))} — ${level.desc}`);
-  }
-
-  console.log(fmt.bold('\n  Flags:'));
-  const flags = [
-    { flag: '--force', desc: 'Skip confirmations for destructive operations' },
-    { flag: '--preview', desc: 'Show what would be affected without doing it' },
-    { flag: '--verbose', desc: 'Show detailed output and debug information' }
-  ];
-
-  for (const flag of flags) {
-    console.log(`    ${fmt.cyan(flag.flag.padEnd(12))} — ${flag.desc}`);
-  }
-
-  console.log(fmt.bold('\n  Interactive Commands:'));
-  const interactiveCommands = [
-    { cmd: '/help', desc: 'Show available chat commands' },
-    { cmd: '/clear', desc: 'Clear screen and show session info' },
-    { cmd: '/status', desc: 'Show current session statistics' },
-    { cmd: '/quit or /exit', desc: 'Exit Cortex gracefully' }
-  ];
-
-  for (const cmd of interactiveCommands) {
-    console.log(`    ${fmt.cyan(cmd.cmd.padEnd(15))} — ${cmd.desc}`);
-  }
-
-  console.log(fmt.bold('\n  Tips:'));
-  const tips = [
-    'You need at least one authenticated provider to use Cortex',
-    'Both providers enable redundancy and different model capabilities',
-    'Cortex automatically chooses the best model for each task',
-    'Sessions are automatically saved and can be resumed later',
-    'Use --doctor if you encounter any issues'
-  ];
-
-  for (const tip of tips) {
-    console.log(`    ${status.info} ${tip}`);
-  }
-
-  console.log('');
-}