myshell-tools 1.0.0 → 2.0.0

package/package.json

@@ -1,49 +1,55 @@
-{
-  "name": "myshell-tools",
-  "version": "1.0.0",
-  "description": "Hierarchical AI orchestration for your shell - Claude + GPT working together like an org chart",
-  "type": "module",
-  "bin": {
-    "cortex": "src/cli.mjs"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "keywords": [
-    "ai",
-    "claude",
-    "gpt",
-    "orchestration",
-    "cli",
-    "shell",
-    "coding",
-    "assistant",
-    "hierarchical",
-    "automation",
-    "developer-tools",
-    "artificial-intelligence"
-  ],
-  "author": "HeyVera <hello@heyvera.org>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/heyvera/cortex-ai.git"
-  },
-  "bugs": {
-    "url": "https://github.com/heyvera/cortex-ai/issues"
-  },
-  "homepage": "https://github.com/heyvera/cortex-ai#readme",
-  "files": [
-    "src/",
-    "data/",
-    "templates/",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "dependencies": {},
-  "scripts": {
-    "start": "node src/cli.mjs",
-    "test": "node src/cli.mjs --doctor"
-  }
-}
+{
+  "name": "myshell-tools",
+  "version": "2.0.0",
+  "type": "module",
+  "bin": {
+    "myshell-tools": "dist/cli.js",
+    "myshell": "dist/cli.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --import ./test/register.mjs --experimental-strip-types --test \"test/unit/**/*.test.ts\" \"test/arch/**/*.test.ts\"",
+    "test:contract": "node --import ./test/register.mjs --experimental-strip-types --test \"test/contract/**/*.test.ts\"",
+    "test:e2e": "CORTEX_E2E=1 node --import ./test/register.mjs --experimental-strip-types --test \"test/integration/**/*.test.ts\"",
+    "lint": "eslint src test",
+    "format": "prettier --check .",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepublishOnly": "npm run clean && npm run build && npm run test"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hey-vera/myshell-tools.git"
+  },
+  "author": "HeyVera <hello@heyvera.org>",
+  "license": "MIT",
+  "keywords": [
+    "ai",
+    "orchestration",
+    "cli",
+    "claude",
+    "codex",
+    "multi-model"
+  ],
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^20.0.0",
+    "c8": "^10.0.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "dependencies": {
+    "execa": "^9.6.1"
+  }
+}

package/data/orchestrator.json

@@ -1,113 +0,0 @@
-{
-  "subscriptions": {
-    "claude": {
-      "models": {
-        "opus": {
-          "tier": "manager",
-          "input_per_mtok": 5.0,
-          "output_per_mtok": 25.0,
-          "context_window": 1000000,
-          "max_output": 128000,
-          "model_id": "opus",
-          "strengths": ["complex reasoning", "architecture decisions", "code review", "error recovery"],
-          "best_for": "high-stakes decisions, complex debugging, escalations"
-        },
-        "sonnet": {
-          "tier": "ic",
-          "input_per_mtok": 3.0,
-          "output_per_mtok": 15.0,
-          "context_window": 1000000,
-          "max_output": 64000,
-          "model_id": "sonnet",
-          "strengths": ["best speed/intelligence ratio", "precise edits", "implementation"],
-          "best_for": "most coding tasks, refactoring, implementing features"
-        },
-        "haiku": {
-          "tier": "worker",
-          "input_per_mtok": 1.0,
-          "output_per_mtok": 5.0,
-          "context_window": 200000,
-          "max_output": 64000,
-          "model_id": "haiku",
-          "strengths": ["fastest latency", "cheapest", "good for simple tasks"],
-          "best_for": "file lookups, grep, simple tasks, gathering information"
-        }
-      }
-    },
-    "openai": {
-      "models": {
-        "gpt-5.5": {
-          "tier": "manager",
-          "input_per_mtok": 5.0,
-          "output_per_mtok": 30.0,
-          "context_window": 1000000,
-          "max_output": 128000,
-          "model_id": "gpt-5.5",
-          "strengths": ["complex reasoning", "independent perspective", "code review"],
-          "best_for": "architectural decisions, second opinions, escalations"
-        },
-        "gpt-5.4": {
-          "tier": "ic",
-          "input_per_mtok": 2.5,
-          "output_per_mtok": 15.0,
-          "context_window": 1000000,
-          "max_output": 128000,
-          "model_id": "gpt-5.4",
-          "strengths": ["good speed/cost ratio", "strong implementation"],
-          "best_for": "implementation and execution tasks"
-        },
-        "gpt-4.1-mini": {
-          "tier": "worker",
-          "input_per_mtok": 0.40,
-          "output_per_mtok": 1.60,
-          "context_window": 1047576,
-          "max_output": 32768,
-          "model_id": "gpt-4.1-mini",
-          "strengths": ["extremely cheap", "good for simple tasks"],
-          "best_for": "simple lookups, grep, file operations"
-        }
-      }
-    }
-  },
-
-  "tiers": {
-    "worker": {
-      "description": "Simple tasks: file lookups, grep, basic operations",
-      "escalation_threshold": 0.6,
-      "max_attempts": 2
-    },
-    "ic": {
-      "description": "Individual contributor: coding, implementation, most work",
-      "escalation_threshold": 0.5,
-      "max_attempts": 2
-    },
-    "manager": {
-      "description": "Manager: architecture, review, complex decisions",
-      "escalation_threshold": 0.3,
-      "max_attempts": 1
-    }
-  },
-
-  "escalation_triggers": {
-    "confidence_threshold": 0.5,
-    "keywords": {
-      "auth": "critical",
-      "credential": "critical",
-      "secret": "critical",
-      "token": "critical",
-      "password": "critical",
-      "login": "high",
-      "billing": "high",
-      "payment": "high",
-      "deploy": "high",
-      "migration": "high"
-    },
-    "file_patterns": {
-      "**/.env*": "critical",
-      "**/auth/**": "high",
-      "**/security/**": "high",
-      "**/payment/**": "high",
-      "**/billing/**": "high"
-    }
-  }
-}

package/src/auth/recovery.mjs

@@ -1,328 +0,0 @@
-/**
- * recovery.mjs — Authentication failure recovery with helpful guidance
- */
-
-import { spawnSync } from 'child_process';
-import { backgroundRefresh, displayRefreshStatus } from './refresh.mjs';
-
-/**
- * Check if a provider CLI is installed
- */
-function isCliInstalled(command) {
-  try {
-    const result = spawnSync('which', [command], {
-      encoding: 'utf8',
-      stdio: 'pipe'
-    });
-    return result.status === 0;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Detect OS for platform-specific installation guidance
- */
-function detectOS() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  if (platform === 'darwin') return 'macOS';
-  if (platform === 'win32') return 'Windows';
-  if (platform === 'linux') {
-    // Try to detect specific Linux distribution
-    try {
-      const result = spawnSync('cat', ['/etc/os-release'], {
-        encoding: 'utf8',
-        stdio: 'pipe'
-      });
-      if (result.status === 0) {
-        if (result.stdout.includes('Ubuntu')) return 'Ubuntu';
-        if (result.stdout.includes('Debian')) return 'Debian';
-        if (result.stdout.includes('CentOS') || result.stdout.includes('Red Hat')) return 'RHEL/CentOS';
-      }
-    } catch {}
-    return 'Linux';
-  }
-
-  return platform;
-}
-
-/**
- * Provide installation guidance for missing CLIs
- */
-export function provideCLIInstallationGuidance(provider) {
-  const os = detectOS();
-
-  console.log(`\n❌ ${provider.toUpperCase()} CLI not found`);
-  console.log(`📦 Installation Instructions for ${os}:`);
-
-  if (provider === 'claude') {
-    switch (os) {
-      case 'macOS':
-        console.log('  # Option 1: Using pip');
-        console.log('  pip install anthropic-cli');
-        console.log('\n  # Option 2: Using Homebrew (if available)');
-        console.log('  brew install anthropic-cli');
-        break;
-
-      case 'Ubuntu':
-      case 'Debian':
-        console.log('  # Install pip if not available');
-        console.log('  sudo apt update && sudo apt install python3-pip');
-        console.log('\n  # Install Claude CLI');
-        console.log('  pip3 install anthropic-cli');
-        break;
-
-      case 'RHEL/CentOS':
-        console.log('  # Install pip if not available');
-        console.log('  sudo yum install python3-pip');
-        console.log('\n  # Install Claude CLI');
-        console.log('  pip3 install anthropic-cli');
-        break;
-
-      case 'Windows':
-        console.log('  # Install via pip (requires Python)');
-        console.log('  pip install anthropic-cli');
-        console.log('\n  # Or download from: https://claude.ai/cli');
-        break;
-
-      default:
-        console.log('  pip install anthropic-cli');
-        break;
-    }
-
-    console.log('\n🔐 After installation, authenticate:');
-    console.log('  claude auth login');
-
-  } else if (provider === 'codex') {
-    switch (os) {
-      case 'macOS':
-        console.log('  # Using npm (recommended)');
-        console.log('  npm install -g @openai/codex');
-        console.log('\n  # Or using Homebrew');
-        console.log('  brew install openai-codex');
-        break;
-
-      case 'Ubuntu':
-      case 'Debian':
-        console.log('  # Install Node.js if not available');
-        console.log('  curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -');
-        console.log('  sudo apt-get install -y nodejs');
-        console.log('\n  # Install Codex CLI');
-        console.log('  sudo npm install -g @openai/codex');
-        break;
-
-      case 'RHEL/CentOS':
-        console.log('  # Install Node.js if not available');
-        console.log('  curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -');
-        console.log('  sudo yum install nodejs npm');
-        console.log('\n  # Install Codex CLI');
-        console.log('  sudo npm install -g @openai/codex');
-        break;
-
-      case 'Windows':
-        console.log('  # Install via npm (requires Node.js)');
-        console.log('  npm install -g @openai/codex');
-        console.log('\n  # Or download from: https://platform.openai.com/docs/tools/codex-cli');
-        break;
-
-      default:
-        console.log('  npm install -g @openai/codex');
-        break;
-    }
-
-    console.log('\n🔐 After installation, authenticate:');
-    console.log('  codex login');
-  }
-
-  console.log('\n💡 You need at least one authenticated CLI to use Cortex.');
-  console.log('   Both CLIs enable different model tiers and redundancy.');
-}
-
-/**
- * Provide authentication guidance for installed but unauth'd CLIs
- */
-export function provideAuthGuidance(provider) {
-  console.log(`\n⚠️  ${provider.toUpperCase()} CLI found but not authenticated`);
-
-  if (provider === 'claude') {
-    console.log('🔐 Authenticate Claude CLI:');
-    console.log('  claude auth login');
-    console.log('\n💡 This will open a browser to sign in to your Claude account.');
-    console.log('   If running on a server, use: claude auth login --no-browser');
-
-  } else if (provider === 'codex') {
-    console.log('🔐 Authenticate Codex CLI:');
-    console.log('  codex login');
-    console.log('\n💡 This will prompt for your OpenAI API key.');
-    console.log('   Get your key from: https://platform.openai.com/api-keys');
-  }
-
-  console.log('\n🔄 After authentication, restart Cortex to refresh provider status.');
-}
-
-/**
- * Handle authentication failures during operation
- */
-export async function handleAuthFailure(provider, error) {
-  console.log(`\n🔴 Authentication failed for ${provider.toUpperCase()}`);
-  console.log(`   Error: ${error}`);
-
-  // Try to refresh tokens first
-  console.log('\n🔄 Attempting token refresh...');
-  const refreshResult = await backgroundRefresh();
-
-  if (refreshResult.success && !refreshResult.needReauth.includes(provider)) {
-    console.log('✅ Token refresh successful! Please retry your request.');
-    return { recovered: true, action: 'retry' };
-  }
-
-  // If refresh failed or this provider needs reauth
-  console.log('❌ Token refresh failed or expired. Re-authentication required.');
-
-  if (provider === 'claude') {
-    console.log('\n🔐 Re-authenticate Claude CLI:');
-    console.log('  claude auth login');
-
-    // Check if it's a subscription issue
-    if (error.includes('subscription') || error.includes('billing')) {
-      console.log('\n💳 Possible subscription issue detected.');
-      console.log('   Check your Claude Pro subscription at: https://claude.ai/settings');
-    }
-
-  } else if (provider === 'codex' || provider === 'openai') {
-    console.log('\n🔐 Re-authenticate Codex CLI:');
-    console.log('  codex login');
-
-    // Check if it's an API quota/billing issue
-    if (error.includes('quota') || error.includes('billing') || error.includes('insufficient')) {
-      console.log('\n💳 Possible API quota/billing issue detected.');
-      console.log('   Check your OpenAI account at: https://platform.openai.com/usage');
-    }
-  }
-
-  return { recovered: false, action: 'reauth_required' };
-}
-
-/**
- * Comprehensive provider health check
- */
-export async function checkProviderHealth(environment) {
-  const health = {
-    claude: { healthy: false, issues: [] },
-    codex: { healthy: false, issues: [] },
-    overall: { healthy: false, availableProviders: 0 }
-  };
-
-  // Check Claude
-  if (!environment.claude.installed) {
-    health.claude.issues.push('CLI not installed');
-  } else if (!environment.claude.authed) {
-    health.claude.issues.push('Not authenticated');
-  } else {
-    health.claude.healthy = true;
-    health.overall.availableProviders++;
-  }
-
-  // Check Codex
-  if (!environment.codex.installed) {
-    health.codex.issues.push('CLI not installed');
-  } else if (!environment.codex.authed) {
-    health.codex.issues.push('Not authenticated');
-  } else {
-    health.codex.healthy = true;
-    health.overall.availableProviders++;
-  }
-
-  health.overall.healthy = health.overall.availableProviders > 0;
-
-  return health;
-}
-
-/**
- * Auto-recovery sequence with user guidance
- */
-export async function autoRecovery(environment) {
-  console.log('🔧 Running auto-recovery sequence...\n');
-
-  const health = await checkProviderHealth(environment);
-
-  // Try token refresh first if we have any auth'd providers
-  if (health.overall.availableProviders > 0) {
-    console.log('🔄 Refreshing authentication tokens...');
-    const refreshResult = await backgroundRefresh();
-    displayRefreshStatus(refreshResult);
-
-    if (refreshResult.success && refreshResult.refreshed.length > 0) {
-      console.log('✅ Some tokens refreshed successfully.');
-      return { recovered: true, action: 'tokens_refreshed' };
-    }
-  }
-
-  // Provide guidance for missing/unauth'd providers
-  if (!health.claude.healthy) {
-    if (health.claude.issues.includes('CLI not installed')) {
-      provideCLIInstallationGuidance('claude');
-    } else if (health.claude.issues.includes('Not authenticated')) {
-      provideAuthGuidance('claude');
-    }
-  }
-
-  if (!health.codex.healthy) {
-    if (health.codex.issues.includes('CLI not installed')) {
-      provideCLIInstallationGuidance('codex');
-    } else if (health.codex.issues.includes('Not authenticated')) {
-      provideAuthGuidance('codex');
-    }
-  }
-
-  // Final status
-  if (health.overall.healthy) {
-    console.log('\n✅ At least one provider is healthy. Cortex can continue.');
-    return { recovered: true, action: 'partial_recovery' };
-  } else {
-    console.log('\n❌ No healthy providers available. Please follow the guidance above.');
-    return { recovered: false, action: 'manual_intervention_required' };
-  }
-}
-
-/**
- * Recovery suggestions based on error type
- */
-export function getRecoverySuggestions(error) {
-  const errorString = error.toString().toLowerCase();
-  const suggestions = [];
-
-  if (errorString.includes('enoent') || errorString.includes('command not found')) {
-    suggestions.push('CLI tool not installed or not in PATH');
-    suggestions.push('Check installation instructions above');
-  }
-
-  if (errorString.includes('authentication') || errorString.includes('unauthorized') || errorString.includes('401')) {
-    suggestions.push('Authentication failed or expired');
-    suggestions.push('Try re-authenticating with the CLI');
-  }
-
-  if (errorString.includes('timeout') || errorString.includes('network') || errorString.includes('enotfound')) {
-    suggestions.push('Network connectivity issue');
-    suggestions.push('Check internet connection and try again');
-  }
-
-  if (errorString.includes('rate limit') || errorString.includes('429')) {
-    suggestions.push('API rate limit exceeded');
-    suggestions.push('Wait a few minutes before retrying');
-  }
-
-  if (errorString.includes('quota') || errorString.includes('billing') || errorString.includes('subscription')) {
-    suggestions.push('Account/billing issue detected');
-    suggestions.push('Check your account status and subscription');
-  }
-
-  if (suggestions.length === 0) {
-    suggestions.push('Unknown error occurred');
-    suggestions.push('Try running with --doctor for more details');
-  }
-
-  return suggestions;
-}