faf-cli 5.2.0 → 6.0.0

package/scripts/prepare-release.ts

@@ -1,421 +0,0 @@
-#!/usr/bin/env ts-node
-
-/**
- * 🚀 Release Preparation Script - F1-Inspired Championship Releases
- * Automates version bumping, changelog generation, and release validation
- */
-
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { execSync } from 'child_process';
-import { FAF_COLORS, FAF_ICONS } from '../src/utils/championship-style';
-
-interface ReleaseOptions {
-  type: 'patch' | 'minor' | 'major' | 'prerelease';
-  dryRun: boolean;
-  skipTests: boolean;
-  prereleaseId?: string;
-}
-
-interface VersionInfo {
-  current: string;
-  next: string;
-  tag: string;
-}
-
-interface ChangelogEntry {
-  type: 'feat' | 'fix' | 'docs' | 'style' | 'refactor' | 'test' | 'chore';
-  scope?: string;
-  description: string;
-  breaking?: boolean;
-  hash: string;
-}
-
-/**
- * Main release preparation function
- */
-async function prepareRelease(options: ReleaseOptions): Promise<void> {
-  console.log(`${FAF_COLORS.fafCyan('🚀 FAF CLI Release Preparation')}`);
-  console.log(`${FAF_COLORS.fafCyan('├─')} F1-inspired championship engineering`);
-  console.log(`${FAF_COLORS.fafCyan('└─')} Release type: ${FAF_COLORS.fafGreen(options.type)}`);
-  console.log();
-
-  try {
-    // Pre-flight checks
-    await preflightChecks(options);
-    
-    // Calculate version info
-    const versionInfo = await calculateVersions(options);
-    console.log(`${FAF_COLORS.fafCyan('📊 Version Info:')}`);
-    console.log(`${FAF_COLORS.fafCyan('├─')} Current: ${versionInfo.current}`);
-    console.log(`${FAF_COLORS.fafCyan('├─')} Next: ${FAF_COLORS.fafGreen(versionInfo.next)}`);
-    console.log(`${FAF_COLORS.fafCyan('└─')} Tag: ${versionInfo.tag}`);
-    console.log();
-    
-    // Generate changelog
-    const changelog = await generateChangelog(versionInfo);
-    
-    // Update package.json
-    if (!options.dryRun) {
-      await updatePackageVersion(versionInfo.next);
-      console.log(`${FAF_COLORS.fafGreen('✅')} Updated package.json to ${versionInfo.next}`);
-    }
-    
-    // Run tests if not skipped
-    if (!options.skipTests) {
-      await runTestSuite();
-    }
-    
-    // Build project
-    await buildProject();
-    
-    // Show release summary
-    showReleaseSummary(versionInfo, changelog, options);
-    
-    // Create release commands
-    generateReleaseCommands(versionInfo, options);
-    
-  } catch (error) {
-    console.error(`${FAF_COLORS.fafOrange('❌ Release preparation failed:')} ${error}`);
-    process.exit(1);
-  }
-}
-
-/**
- * Pre-flight checks
- */
-async function preflightChecks(options: ReleaseOptions): Promise<void> {
-  console.log(`${FAF_COLORS.fafCyan('🔍 Pre-flight Checks:')}`);
-  
-  // Check git status
-  try {
-    const gitStatus = execSync('git status --porcelain', { encoding: 'utf8' });
-    if (gitStatus.trim() && !options.dryRun) {
-      throw new Error('Working directory not clean. Commit or stash changes first.');
-    }
-    console.log(`${FAF_COLORS.fafGreen('├─ ✅')} Git working directory clean`);
-  } catch (error) {
-    console.log(`${FAF_COLORS.fafOrange('├─ ⚠️')} Git status check failed`);
-    if (!options.dryRun) throw error;
-  }
-  
-  // Check we're on main branch
-  try {
-    const currentBranch = execSync('git branch --show-current', { encoding: 'utf8' }).trim();
-    if (currentBranch !== 'main' && !options.dryRun) {
-      console.log(`${FAF_COLORS.fafOrange('├─ ⚠️')} Currently on branch: ${currentBranch} (expected: main)`);
-    } else {
-      console.log(`${FAF_COLORS.fafGreen('├─ ✅')} On main branch`);
-    }
-  } catch (error) {
-    console.log(`${FAF_COLORS.fafOrange('├─ ⚠️')} Branch check failed`);
-  }
-  
-  // Check package.json exists
-  const packagePath = path.join(process.cwd(), 'package.json');
-  try {
-    await fs.access(packagePath);
-    console.log(`${FAF_COLORS.fafGreen('├─ ✅')} package.json found`);
-  } catch {
-    throw new Error('package.json not found in current directory');
-  }
-  
-  // Check npm credentials (for actual releases)
-  if (!options.dryRun) {
-    try {
-      execSync('npm whoami', { stdio: 'pipe' });
-      console.log(`${FAF_COLORS.fafGreen('└─ ✅')} NPM authentication ready`);
-    } catch {
-      console.log(`${FAF_COLORS.fafOrange('└─ ⚠️')} NPM authentication not configured`);
-    }
-  } else {
-    console.log(`${FAF_COLORS.fafGreen('└─ ✅')} Dry run mode - skipping NPM check`);
-  }
-  
-  console.log();
-}
-
-/**
- * Calculate version information
- */
-async function calculateVersions(options: ReleaseOptions): Promise<VersionInfo> {
-  const packagePath = path.join(process.cwd(), 'package.json');
-  const packageContent = await fs.readFile(packagePath, 'utf8');
-  const packageJson = JSON.parse(packageContent);
-  const currentVersion = packageJson.version;
-  
-  // Calculate next version using npm version --dry-run
-  let versionArgs = options.type;
-  if (options.type === 'prerelease' && options.prereleaseId) {
-    versionArgs += ` --preid=${options.prereleaseId}`;
-  }
-  
-  const nextVersion = execSync(`npm version ${versionArgs} --dry-run --no-git-tag-version`, { 
-    encoding: 'utf8' 
-  }).trim().replace(/^v/, '');
-  
-  return {
-    current: currentVersion,
-    next: nextVersion,
-    tag: `v${nextVersion}`
-  };
-}
-
-/**
- * Generate changelog from git commits
- */
-async function generateChangelog(versionInfo: VersionInfo): Promise<ChangelogEntry[]> {
-  console.log(`${FAF_COLORS.fafCyan('📝 Generating Changelog:')}`);
-  
-  try {
-    // Get commits since last tag
-    const lastTag = execSync('git describe --tags --abbrev=0 2>/dev/null || echo ""', { 
-      encoding: 'utf8' 
-    }).trim();
-    
-    const gitRange = lastTag ? `${lastTag}..HEAD` : 'HEAD';
-    const commits = execSync(`git log --pretty=format:"%H|%s" ${gitRange}`, { 
-      encoding: 'utf8' 
-    }).trim().split('\n').filter(line => line);
-    
-    const changelog: ChangelogEntry[] = commits.map(commit => {
-      const [hash, message] = commit.split('|');
-      return parseCommitMessage(message, hash);
-    });
-    
-    // Group by type
-    const grouped = changelog.reduce((acc, entry) => {
-      if (!acc[entry.type]) acc[entry.type] = [];
-      acc[entry.type].push(entry);
-      return acc;
-    }, {} as Record<string, ChangelogEntry[]>);
-    
-    // Display changelog preview
-    console.log(`${FAF_COLORS.fafCyan('├─')} Changes since ${lastTag || 'initial commit'}:`);
-    
-    const typeLabels = {
-      feat: '🚀 Features',
-      fix: '🐛 Bug Fixes', 
-      docs: '📚 Documentation',
-      style: '🎨 Style',
-      refactor: '♻️ Refactoring',
-      test: '🧪 Tests',
-      chore: '🔧 Maintenance'
-    };
-    
-    Object.entries(grouped).forEach(([type, entries]) => {
-      if (entries.length > 0) {
-        console.log(`${FAF_COLORS.fafCyan('│   ')}${typeLabels[type as keyof typeof typeLabels] || type}: ${entries.length} changes`);
-      }
-    });
-    
-    console.log(`${FAF_COLORS.fafGreen('└─')} Total commits: ${changelog.length}`);
-    console.log();
-    
-    return changelog;
-    
-  } catch (error) {
-    console.log(`${FAF_COLORS.fafOrange('└─ ⚠️')} Could not generate changelog: ${error}`);
-    return [];
-  }
-}
-
-/**
- * Parse conventional commit message
- */
-function parseCommitMessage(message: string, hash: string): ChangelogEntry {
-  // Parse conventional commit format: type(scope): description
-  const conventionalMatch = message.match(/^(feat|fix|docs|style|refactor|test|chore)(?:\\(([^)]+)\\))?: (.+)/);
-  
-  if (conventionalMatch) {
-    const [, type, scope, description] = conventionalMatch;
-    return {
-      type: type as ChangelogEntry['type'],
-      scope,
-      description,
-      breaking: message.includes('BREAKING CHANGE'),
-      hash: hash.substring(0, 7)
-    };
-  }
-  
-  // Fallback for non-conventional commits
-  return {
-    type: 'chore',
-    description: message,
-    hash: hash.substring(0, 7)
-  };
-}
-
-/**
- * Update package.json version
- */
-async function updatePackageVersion(newVersion: string): Promise<void> {
-  const packagePath = path.join(process.cwd(), 'package.json');
-  const packageContent = await fs.readFile(packagePath, 'utf8');
-  const packageJson = JSON.parse(packageContent);
-  
-  packageJson.version = newVersion;
-  
-  await fs.writeFile(packagePath, JSON.stringify(packageJson, null, 2) + '\n');
-}
-
-/**
- * Run test suite
- */
-async function runTestSuite(): Promise<void> {
-  console.log(`${FAF_COLORS.fafCyan('🧪 Running Test Suite:')}`);
-  
-  try {
-    // Run main tests
-    execSync('npm test', { stdio: 'inherit' });
-    console.log(`${FAF_COLORS.fafGreen('├─ ✅')} Unit tests passed`);
-    
-    // Run audit tests
-    execSync('npm run test:audit', { stdio: 'inherit' });
-    console.log(`${FAF_COLORS.fafGreen('├─ ✅')} Audit tests passed`);
-    
-    // Run linting
-    execSync('npm run lint', { stdio: 'inherit' });
-    console.log(`${FAF_COLORS.fafGreen('└─ ✅')} Linting passed`);
-    
-  } catch (error) {
-    throw new Error(`Test suite failed: ${error}`);
-  }
-  
-  console.log();
-}
-
-/**
- * Build project
- */
-async function buildProject(): Promise<void> {
-  console.log(`${FAF_COLORS.fafCyan('🏗️ Building Project:')}`);
-  
-  try {
-    execSync('npm run build', { stdio: 'inherit' });
-    console.log(`${FAF_COLORS.fafGreen('└─ ✅')} Build completed successfully`);
-  } catch (error) {
-    throw new Error(`Build failed: ${error}`);
-  }
-  
-  console.log();
-}
-
-/**
- * Show release summary
- */
-function showReleaseSummary(
-  versionInfo: VersionInfo, 
-  changelog: ChangelogEntry[], 
-  options: ReleaseOptions
-): void {
-  console.log(`${FAF_COLORS.fafCyan('📋 Release Summary:')}`);
-  console.log(`${FAF_COLORS.fafCyan('├─')} Version: ${versionInfo.current} → ${FAF_COLORS.fafGreen(versionInfo.next)}`);
-  console.log(`${FAF_COLORS.fafCyan('├─')} Type: ${options.type}`);
-  console.log(`${FAF_COLORS.fafCyan('├─')} Changes: ${changelog.length} commits`);
-  console.log(`${FAF_COLORS.fafCyan('├─')} Mode: ${options.dryRun ? 'DRY RUN' : 'LIVE RELEASE'}`);
-  console.log(`${FAF_COLORS.fafCyan('└─')} Ready for championship deployment! 🏎️`);
-  console.log();
-}
-
-/**
- * Generate release commands
- */
-function generateReleaseCommands(versionInfo: VersionInfo, options: ReleaseOptions): void {
-  console.log(`${FAF_COLORS.fafCyan('🚀 Release Commands:')}`);
-  console.log();
-  
-  if (options.dryRun) {
-    console.log(`${FAF_COLORS.fafOrange('📝 To complete the release, run:')}`);
-    console.log();
-    console.log(`${FAF_COLORS.fafCyan('# 1. Commit version change')}`);
-    console.log(`git add package.json`);
-    console.log(`git commit -m "chore: bump version to ${versionInfo.next}"`);
-    console.log();
-    console.log(`${FAF_COLORS.fafCyan('# 2. Create and push tag')}`);
-    console.log(`git tag ${versionInfo.tag}`);
-    console.log(`git push origin main --tags`);
-    console.log();
-    console.log(`${FAF_COLORS.fafCyan('# 3. GitHub Actions will handle the rest! 🏁')}`);
-  } else {
-    console.log(`${FAF_COLORS.fafGreen('✅ Release prepared! Push to trigger automation:')}`);
-    console.log();
-    console.log(`git push origin main --tags`);
-  }
-  
-  console.log();
-  console.log(`${FAF_COLORS.fafGreen('🏆 Championship release engineering complete!')}`);
-}
-
-/**
- * CLI argument parsing
- */
-function parseArgs(): ReleaseOptions {
-  const args = process.argv.slice(2);
-  
-  const options: ReleaseOptions = {
-    type: 'patch',
-    dryRun: false,
-    skipTests: false
-  };
-  
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    
-    switch (arg) {
-      case '--type':
-        options.type = args[++i] as ReleaseOptions['type'];
-        break;
-      case '--dry-run':
-        options.dryRun = true;
-        break;
-      case '--skip-tests':
-        options.skipTests = true;
-        break;
-      case '--preid':
-        options.prereleaseId = args[++i];
-        break;
-      case '--help':
-        showHelp();
-        process.exit(0);
-        break;
-    }
-  }
-  
-  return options;
-}
-
-/**
- * Show help message
- */
-function showHelp(): void {
-  console.log(`
-🚀 FAF CLI Release Preparation Script
-
-Usage: npm run release [options]
-
-Options:
-  --type <type>       Release type: patch|minor|major|prerelease (default: patch)
-  --dry-run          Show what would be done without making changes
-  --skip-tests       Skip running test suite
-  --preid <id>       Pre-release identifier (alpha, beta, rc)
-  --help             Show this help
-
-Examples:
-  npm run release                    # Patch release (1.0.0 → 1.0.1)
-  npm run release -- --type minor   # Minor release (1.0.0 → 1.1.0)  
-  npm run release -- --type major   # Major release (1.0.0 → 2.0.0)
-  npm run release -- --dry-run      # Preview changes only
-  npm run release -- --type prerelease --preid beta  # Beta release
-
-🏎️ F1-inspired engineering - Championship releases every time!
-`);
-}
-
-// Run if called directly
-if (require.main === module) {
-  const options = parseArgs();
-  prepareRelease(options).catch(console.error);
-}
-
-export { prepareRelease };

package/scripts/run-industry-showcase.ts

@@ -1,237 +0,0 @@
-#!/usr/bin/env node
-/**
- * Industry Showcase Runner
- *
- * Runs faf git on all famous repos and collects results
- * Output: industry-showcase-results.json
- */
-
-import { execSync } from 'child_process';
-import { readFileSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import * as yaml from 'yaml';
-
-interface ShowcaseData {
-  title: string;
-  description: string;
-  updated: string;
-  categories: Array<{
-    name: string;
-    repos: string[];
-  }>;
-}
-
-interface RepoResult {
-  repo: string;
-  owner: string;
-  name: string;
-  category: string;
-  currentScore: number;
-  newScore: number;
-  improvement: number;
-  tier: string;
-  stack: {
-    frontend?: string;
-    backend?: string;
-    runtime?: string;
-    build?: string;
-    database?: string;
-    hosting?: string;
-  };
-  projectType: string;
-  mainLanguage: string;
-  description: string;
-  status: 'success' | 'failed' | 'rate-limited';
-  error?: string;
-}
-
-interface ShowcaseResults {
-  generated: string;
-  totalRepos: number;
-  successCount: number;
-  failedCount: number;
-  avgImprovement: number;
-  categories: Array<{
-    name: string;
-    repos: RepoResult[];
-  }>;
-}
-
-function parseFafGitOutput(output: string): { currentScore: number; newScore: number; improvement: number; tier: string } | null {
-  // v4.3.0 format:
-  // Current:  No .faf file ⚠️
-  // With FAF: 100% 🏆 Trophy
-
-  const currentMatch = output.match(/Current:\s+No \.faf file/);
-  const withFafMatch = output.match(/With FAF:\s+(\d+)%\s+([🏆🥇🥈🥉🟢🟡🔴🤍⚠️]+)\s*(\w+)?/);
-
-  if (!withFafMatch) {
-    return null;
-  }
-
-  const currentScore = currentMatch ? 0 : 0; // Always 0 for "No .faf file"
-  const newScore = parseInt(withFafMatch[1]);
-  const tier = withFafMatch[3] || 'Unknown';
-  const improvement = newScore - currentScore;
-
-  return {
-    currentScore,
-    newScore,
-    improvement,
-    tier
-  };
-}
-
-function extractStackFromFaf(fafPath: string): any {
-  try {
-    const content = readFileSync(fafPath, 'utf-8');
-    const parsed = yaml.parse(content);
-
-    return {
-      stack: {
-        frontend: parsed.stack?.frontend !== 'slotignored' ? parsed.stack?.frontend : undefined,
-        backend: parsed.stack?.backend !== 'slotignored' ? parsed.stack?.backend : undefined,
-        runtime: parsed.stack?.runtime !== 'slotignored' ? parsed.stack?.runtime : undefined,
-        build: parsed.stack?.build !== 'slotignored' ? parsed.stack?.build : undefined,
-        database: parsed.stack?.database !== 'slotignored' ? parsed.stack?.database : undefined,
-        hosting: parsed.stack?.hosting !== 'slotignored' ? parsed.stack?.hosting : undefined,
-      },
-      projectType: parsed.project?.type || 'unknown',
-      mainLanguage: parsed.project?.main_language || 'unknown',
-      description: parsed.project?.goal || parsed.metadata?.description || ''
-    };
-  } catch (e) {
-    return {
-      stack: {},
-      projectType: 'unknown',
-      mainLanguage: 'unknown',
-      description: ''
-    };
-  }
-}
-
-async function runShowcase() {
-  console.log('🏎️  FAF Industry Showcase Runner\n');
-
-  // Read showcase data
-  const showcaseData: ShowcaseData = JSON.parse(
-    readFileSync(join(__dirname, 'industry-showcase.json'), 'utf-8')
-  );
-
-  const results: ShowcaseResults = {
-    generated: new Date().toISOString(),
-    totalRepos: 0,
-    successCount: 0,
-    failedCount: 0,
-    avgImprovement: 0,
-    categories: []
-  };
-
-  let totalImprovement = 0;
-
-  for (const category of showcaseData.categories) {
-    console.log(`\n📁 Category: ${category.name}`);
-    console.log(`   Testing ${category.repos.length} repos...\n`);
-
-    const categoryResults: RepoResult[] = [];
-
-    for (const repo of category.repos) {
-      results.totalRepos++;
-      const [owner, name] = repo.split('/');
-
-      process.stdout.write(`   ⚡ ${repo}... `);
-
-      try {
-        // Run faf git
-        const output = execSync(
-          `node ${join(__dirname, '../dist/cli.js')} git ${repo}`,
-          {
-            encoding: 'utf-8',
-            timeout: 30000,
-            stdio: 'pipe'
-          }
-        );
-
-        // Parse output
-        const scores = parseFafGitOutput(output);
-
-        if (!scores) {
-          throw new Error('Failed to parse output');
-        }
-
-        // Extract stack from generated .faf file
-        const fafPath = join(process.cwd(), `${name}.faf`);
-        const fafData = extractStackFromFaf(fafPath);
-
-        const result: RepoResult = {
-          repo,
-          owner,
-          name,
-          category: category.name,
-          currentScore: scores.currentScore,
-          newScore: scores.newScore,
-          improvement: scores.improvement,
-          tier: scores.tier,
-          stack: fafData.stack,
-          projectType: fafData.projectType,
-          mainLanguage: fafData.mainLanguage,
-          description: fafData.description,
-          status: 'success'
-        };
-
-        categoryResults.push(result);
-        results.successCount++;
-        totalImprovement += scores.improvement;
-
-        console.log(`✅ ${scores.currentScore}% → ${scores.newScore}% (+${scores.improvement})`);
-
-      } catch (error: any) {
-        results.failedCount++;
-
-        const result: RepoResult = {
-          repo,
-          owner,
-          name,
-          category: category.name,
-          currentScore: 0,
-          newScore: 0,
-          improvement: 0,
-          tier: 'Failed',
-          stack: {},
-          projectType: 'unknown',
-          mainLanguage: 'unknown',
-          description: '',
-          status: error.message?.includes('rate limit') ? 'rate-limited' : 'failed',
-          error: error.message
-        };
-
-        categoryResults.push(result);
-        console.log(`❌ ${error.message.split('\n')[0]}`);
-      }
-
-      // Rate limit protection
-      await new Promise(resolve => setTimeout(resolve, 1000));
-    }
-
-    results.categories.push({
-      name: category.name,
-      repos: categoryResults
-    });
-  }
-
-  // Calculate average improvement
-  results.avgImprovement = Math.round(totalImprovement / results.successCount);
-
-  // Save results
-  const outputPath = join(__dirname, 'industry-showcase-results.json');
-  writeFileSync(outputPath, JSON.stringify(results, null, 2));
-
-  console.log(`\n\n🏆 Showcase Complete!\n`);
-  console.log(`   Total Repos: ${results.totalRepos}`);
-  console.log(`   ✅ Success: ${results.successCount}`);
-  console.log(`   ❌ Failed: ${results.failedCount}`);
-  console.log(`   📈 Avg Improvement: +${results.avgImprovement} points\n`);
-  console.log(`📄 Results saved to: ${outputPath}\n`);
-}
-
-runShowcase().catch(console.error);