claude-flow-novice 2.3.4 → 2.3.6

package/dist/scripts/legacy/README.md

@@ -1,272 +0,0 @@
-# Legacy Scripts
-
-This directory contains scripts that have been superseded by consolidated versions in Phase 12 cleanup. These scripts are kept for reference, fallback purposes, and historical documentation.
-
-## Purpose
-
-Legacy scripts serve several important functions:
-
-1. **Reference Documentation** - Historical implementation patterns
-2. **Fallback Options** - Emergency alternatives if consolidated scripts fail
-3. **Migration Assistance** - Understanding changes between versions
-4. **Educational Value** - Learning from previous implementations
-5. **Debugging Support** - Comparing old vs new behavior
-
-## ⚠️ Important Notice
-
-**These scripts are considered DEPRECATED** and should not be used in normal operations. They are maintained for:
-- Emergency fallback scenarios
-- Development reference
-- Migration troubleshooting
-- Historical documentation
-
-For current operations, use the consolidated scripts in the appropriate directories:
-- `../build/` - Modern build scripts
-- `../test/` - Current testing scripts
-- `../dev/` - Active development tools
-- `../utils/` - Current utility scripts
-
-## Legacy Script Categories
-
-### Build Scripts (Superseded by `../build/unified-builder.sh`)
-
-#### Build Workarounds
-- **`build-workaround.sh`** - Basic build with workarounds
-- **`build-with-filter.sh`** - Filtered build output
-- **`build-migration.sh`** - Migration-compatible builds
-- **`force-build.sh`** - Force build ignoring errors
-- **`safe-build.sh`** - Safe build with backups
-
-#### Build Monitoring
-- **`build-monitor.js`** - Build process monitoring
-
-**Replacement:** Use `scripts/build/unified-builder.sh [mode]` where mode is one of: workaround, filter, migration, force, safe, monitor
-
-### TypeScript Fix Scripts (Superseded by `../build/typescript-fixer.js`)
-
-#### TypeScript Error Fixes
-- **`fix-typescript-errors.js`** - Basic TypeScript error fixes
-- **`fix-ts-advanced.js`** - Advanced TypeScript error resolution
-- **`fix-ts-final.sh`** - Final TypeScript fix pass
-- **`fix-ts-targeted.sh`** - Targeted TypeScript fixes
-- **`quick-fix-ts.js`** - Quick TypeScript error fixes
-- **`batch-fix-ts.sh`** - Batch TypeScript error processing
-
-**Replacement:** Use `node scripts/build/typescript-fixer.js [strategy]` where strategy is one of: basic, advanced, targeted, quick, batch, all
-
-### Performance Scripts (Superseded by `../build/performance-monitor.js`)
-
-#### Performance Testing
-- **`performance-test-runner.js`** - Basic performance test runner
-- **`performance-monitor.js`** - Performance monitoring
-- **`performance-monitoring.js`** - Extended performance monitoring
-- **`optimize-performance.js`** - Performance optimization
-
-**Replacement:** Use `node scripts/build/performance-monitor.js [command]` where command is one of: test, monitor, report, metrics
-
-## Migration Mapping
-
-### Old Script → New Script Mapping
-
-```bash
-# Build Scripts
-scripts/build-workaround.sh → scripts/build/unified-builder.sh workaround
-scripts/build-with-filter.sh → scripts/build/unified-builder.sh filter
-scripts/safe-build.sh → scripts/build/unified-builder.sh safe
-scripts/force-build.sh → scripts/build/unified-builder.sh force
-scripts/build-migration.sh → scripts/build/unified-builder.sh migration
-scripts/build-monitor.js → scripts/build/unified-builder.sh monitor
-
-# TypeScript Fixes
-scripts/fix-typescript-errors.js → node scripts/build/typescript-fixer.js basic
-scripts/fix-ts-advanced.js → node scripts/build/typescript-fixer.js advanced
-scripts/quick-fix-ts.js → node scripts/build/typescript-fixer.js quick
-scripts/batch-fix-ts.sh → node scripts/build/typescript-fixer.js batch
-scripts/fix-ts-targeted.sh → node scripts/build/typescript-fixer.js targeted
-
-# Performance Scripts
-scripts/performance-test-runner.js → node scripts/build/performance-monitor.js test
-scripts/performance-monitor.js → node scripts/build/performance-monitor.js monitor
-scripts/optimize-performance.js → node scripts/build/performance-monitor.js optimize
-```
-
-### NPM Script Migration
-
-```json
-{
-  "scripts": {
-    "// OLD SCRIPTS (deprecated)": "//",
-    "build:old-workaround": "scripts/legacy/build-workaround.sh",
-    "fix:old-typescript": "scripts/legacy/fix-typescript-errors.js",
-
-    "// NEW SCRIPTS (recommended)": "//",
-    "build": "scripts/build/unified-builder.sh safe",
-    "build:workaround": "scripts/build/unified-builder.sh workaround",
-    "fix:typescript": "node scripts/build/typescript-fixer.js"
-  }
-}
-```
-
-## Emergency Usage
-
-### When to Use Legacy Scripts
-
-**Only use legacy scripts in these scenarios:**
-
-1. **Consolidated script failure** - New script has a critical bug
-2. **Emergency debugging** - Need to compare old vs new behavior
-3. **Rollback scenario** - Need to revert to previous functionality
-4. **Development reference** - Understanding how features were implemented
-
-### Safe Usage Pattern
-
-```bash
-# 1. Backup current state
-git add -A && git commit -m "Pre-legacy-script checkpoint"
-
-# 2. Use legacy script with caution
-bash scripts/legacy/build-workaround.sh
-
-# 3. Test results thoroughly
-npm test
-
-# 4. Consider migrating to new script
-scripts/build/unified-builder.sh workaround
-```
-
-## Differences from Modern Scripts
-
-### Functionality Gaps
-
-Legacy scripts may lack:
-- **Coordination hooks integration**
-- **Enhanced error handling**
-- **Comprehensive logging**
-- **Parameter validation**
-- **Help systems**
-- **Dry-run capabilities**
-- **Performance optimizations**
-- **Security improvements**
-
-### Known Issues
-
-Legacy scripts may have:
-- **Deprecated dependencies**
-- **Security vulnerabilities**
-- **Performance limitations**
-- **Limited error recovery**
-- **Inconsistent interfaces**
-- **Missing documentation**
-
-## Development Value
-
-### Learning Opportunities
-
-Legacy scripts provide insights into:
-- **Evolution of build processes**
-- **TypeScript error handling approaches**
-- **Performance optimization techniques**
-- **Script organization patterns**
-- **Error handling strategies**
-
-### Code Archaeology
-
-Use legacy scripts to understand:
-- **Why certain decisions were made**
-- **How problems were solved historically**
-- **Evolution of project requirements**
-- **Performance optimization history**
-- **Testing strategy development**
-
-## Maintenance Policy
-
-### Retention Guidelines
-
-Legacy scripts are retained for:
-- **6 months minimum** after replacement
-- **Until next major version** release
-- **Historical reference** indefinitely
-- **Emergency fallback** scenarios
-
-### Update Policy
-
-Legacy scripts are **NOT UPDATED** except for:
-- **Critical security vulnerabilities**
-- **Emergency compatibility fixes**
-- **Documentation corrections**
-
-### Removal Schedule
-
-Legacy scripts may be removed when:
-- Consolidated scripts prove stable (6+ months)
-- No emergency usage in 1+ year
-- Storage optimization required
-- Major version upgrade
-
-## Troubleshooting Legacy Scripts
-
-### Common Issues
-
-#### Permission Problems
-```bash
-# Fix execute permissions
-chmod +x scripts/legacy/*.sh
-```
-
-#### Dependency Issues
-```bash
-# Install legacy dependencies
-npm install --legacy-peer-deps
-```
-
-#### Path Issues
-```bash
-# Run from project root
-cd /path/to/project-root
-bash scripts/legacy/script-name.sh
-```
-
-#### Environment Issues
-```bash
-# Set legacy environment
-export LEGACY_MODE=true
-export NODE_OPTIONS='--legacy-openssl-provider'
-```
-
-### Getting Help
-
-If you must use legacy scripts:
-
-1. **Check the modern equivalent first**
-2. **Review the migration mapping**
-3. **Test in safe environment**
-4. **Document the usage reason**
-5. **Plan migration to modern scripts**
-
-## Contributing to Legacy
-
-### New Additions
-
-**DO NOT add new scripts to legacy** unless:
-- Moving deprecated script from main directories
-- Adding emergency fallback for critical functionality
-- Documenting historical implementation
-
-### Documentation Updates
-
-When updating legacy documentation:
-- Keep historical accuracy
-- Note deprecation status clearly
-- Provide modern alternatives
-- Explain migration path
-
-## Related Documentation
-
-- **Phase 12 Cleanup Report** - Details of consolidation process
-- **Migration Guide** - How to migrate from legacy to modern scripts
-- **Troubleshooting Guide** - Common issues and solutions
-- **Development History** - Evolution of the script ecosystem
-
----
-
-**Remember: Legacy scripts are for reference and emergency use only. Always prefer the modern consolidated scripts in the appropriate category directories.**

package/dist/scripts/legacy/batch-fix-ts.sh

@@ -1,54 +0,0 @@
-#!/bin/bash
-
-echo "🔧 Starting batch TypeScript fixes..."
-
-# Fix 1: Add missing .js extensions to relative imports
-echo "📝 Adding .js extensions to imports..."
-find src -name "*.ts" -type f -exec sed -i.bak -E "s/from '(\.\.[^']+)'/from '\1.js'/g" {} \;
-find src -name "*.ts" -type f -exec sed -i.bak -E "s/from '(\.\/[^']+)'/from '\1.js'/g" {} \;
-
-# Fix 2: Replace 'developer' with 'coder' and 'analyzer' with 'analyst'
-echo "📝 Fixing AgentType references..."
-find src -name "*.ts" -type f -exec sed -i.bak "s/'developer'/'coder'/g" {} \;
-find src -name "*.ts" -type f -exec sed -i.bak "s/'analyzer'/'analyst'/g" {} \;
-find src -name "*.ts" -type f -exec sed -i.bak 's/"developer"/"coder"/g' {} \;
-find src -name "*.ts" -type f -exec sed -i.bak 's/"analyzer"/"analyst"/g' {} \;
-
-# Fix 3: Add override modifiers
-echo "📝 Adding override modifiers..."
-find src -name "*.ts" -type f -exec sed -i.bak -E 's/^(\s*)(async )?(\w+)\(/$1$2override $3(/g' {} \;
-
-# Fix 4: Fix type imports
-echo "📝 Converting import type to regular imports for value usage..."
-find src -name "*.ts" -type f -exec sed -i.bak -E 's/import type \{ TodoItem \}/import \{ TodoItem \}/g' {} \;
-find src -name "*.ts" -type f -exec sed -i.bak -E 's/import type \{ MemoryEntry \}/import \{ MemoryEntry \}/g' {} \;
-find src -name "*.ts" -type f -exec sed -i.bak -E 's/import type \{ AgentState \}/import \{ AgentState \}/g' {} \;
-
-# Fix 5: Fix never array issues
-echo "📝 Fixing never[] array assignments..."
-find src -name "*.ts" -type f -exec sed -i.bak -E 's/(\w+)\.push\(/((\1 as any[]).push(/g' {} \;
-
-# Fix 6: Add missing imports
-echo "📝 Adding missing Node.js imports..."
-for file in $(find src -name "*.ts" -type f); do
-  if grep -q "__dirname" "$file" && ! grep -q "fileURLToPath" "$file"; then
-    sed -i.bak '1i\
-import { dirname } from "node:path";\
-import { fileURLToPath } from "node:url";\
-const __dirname = dirname(fileURLToPath(import.meta.url));' "$file"
-  fi
-  
-  if grep -q "process\." "$file" && ! grep -q "import.*process" "$file"; then
-    sed -i.bak '1i\
-import process from "node:process";' "$file"
-  fi
-done
-
-# Clean up backup files
-echo "🧹 Cleaning up backup files..."
-find src -name "*.bak" -type f -delete
-
-echo "✅ Batch fixes applied!"
-echo "🔧 Running TypeScript build to check remaining errors..."
-
-npm run build:ts 2>&1 | grep -c "error TS" || echo "0 errors"

package/dist/scripts/legacy/build-migration.sh

@@ -1,105 +0,0 @@
-#!/bin/bash
-
-# Build script for Claude-Flow Migration System
-
-set -e
-
-echo "🚀 Building Claude-Flow Migration System..."
-
-# Check if we're in the right directory
-if [ ! -f "package.json" ]; then
-    echo "❌ Error: package.json not found. Please run from project root."
-    exit 1
-fi
-
-# Clean previous builds
-echo "🧹 Cleaning previous builds..."
-rm -rf dist/migration
-rm -rf src/migration/dist
-
-# Install dependencies
-echo "📦 Installing dependencies..."
-npm install
-
-# Build TypeScript
-echo "🔨 Compiling TypeScript..."
-cd src/migration
-npm run build || {
-    echo "⚠️  TypeScript build with npm not available, using tsc directly..."
-    npx tsc
-}
-cd ../..
-
-# Create distribution directory
-echo "📁 Creating distribution structure..."
-mkdir -p dist/migration
-cp -r src/migration/dist/* dist/migration/
-cp src/migration/package.json dist/migration/
-cp src/migration/README.md dist/migration/
-cp src/migration/migration-manifest.json dist/migration/
-
-# Copy source templates for development
-echo "📋 Copying templates..."
-mkdir -p dist/migration/templates
-cp -r .claude/ dist/migration/templates/claude || echo "⚠️  .claude folder not found, skipping..."
-cp CLAUDE.md dist/migration/templates/ || echo "⚠️  CLAUDE.md not found, skipping..."
-cp .roomodes dist/migration/templates/ || echo "⚠️  .roomodes not found, skipping..."
-
-# Make executable
-chmod +x dist/migration/index.js
-
-# Create symlink for global usage
-echo "🔗 Creating symlinks..."
-mkdir -p bin
-ln -sf ../dist/migration/index.js bin/claude-flow-migrate
-
-# Run tests
-echo "🧪 Running tests..."
-cd src/migration
-npm test || echo "⚠️  Tests failed or not configured"
-cd ../..
-
-# Create package info
-echo "📄 Creating package information..."
-cat > dist/migration/INSTALL.md << 'EOF'
-# Claude-Flow Migration System Installation
-
-## Quick Install
-
-```bash
-# From project root
-npm install -g ./dist/migration
-
-# Or use directly
-./bin/claude-flow-migrate --help
-```
-
-## Usage
-
-```bash
-# Analyze project
-claude-flow-migrate analyze
-
-# Migrate with selective strategy
-claude-flow-migrate --strategy selective --preserve-custom
-
-# Rollback if needed
-claude-flow-migrate rollback
-```
-
-## Documentation
-
-See README.md for complete documentation.
-EOF
-
-echo "✅ Build completed successfully!"
-echo ""
-echo "📋 Next steps:"
-echo "   1. Test installation: ./bin/claude-flow-migrate --help"
-echo "   2. Run on test project: ./bin/claude-flow-migrate analyze /path/to/project"
-echo "   3. Create distribution: npm pack dist/migration"
-echo ""
-echo "📦 Built files:"
-echo "   - dist/migration/ - Complete migration system"
-echo "   - bin/claude-flow-migrate - Executable symlink"
-echo ""

package/dist/scripts/legacy/build-monitor.js

@@ -1,209 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Build Monitor - Continuous build verification for alpha release
- * Agent: Build-Verifier
- * Mission: Monitor and verify build progress toward zero-error alpha
- */
-
-const { exec } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-class BuildMonitor {
-  constructor() {
-    this.errorCount = 282; // Baseline
-    this.lastCheck = Date.now();
-    this.monitoringActive = true;
-    this.buildHistory = [];
-    this.errorCategories = {
-      'type_compatibility': 87,
-      'missing_properties': 56,
-      'import_export': 45,
-      'null_undefined': 41,
-      'constructor_issues': 23,
-      'other': 30
-    };
-  }
-
-  async runBuild() {
-    return new Promise((resolve, reject) => {
-      console.log('🔨 Running build verification...');
-      exec('npm run build', (error, stdout, stderr) => {
-        const buildOutput = stderr || stdout;
-        const errors = this.parseErrors(buildOutput);
-        
-        const buildResult = {
-          timestamp: new Date().toISOString(),
-          errorCount: errors.length,
-          errors: errors,
-          success: errors.length === 0
-        };
-
-        this.buildHistory.push(buildResult);
-        resolve(buildResult);
-      });
-    });
-  }
-
-  parseErrors(buildOutput) {
-    if (!buildOutput) return [];
-    
-    const errorLines = buildOutput.split('\n').filter(line => 
-      line.includes('error TS') || line.includes('Error:')
-    );
-    
-    return errorLines.map(line => {
-      const match = line.match(/([^:]+):\s*error\s+TS(\d+):\s*(.+)/);
-      if (match) {
-        return {
-          file: match[1],
-          code: match[2],
-          message: match[3]
-        };
-      }
-      return { message: line };
-    });
-  }
-
-  async checkSwarmMemory() {
-    try {
-      // Check for swarm agent updates
-      const result = await new Promise((resolve) => {
-        exec('npx ruv-swarm hook pre-search --query "agent-progress" --cache-results true', 
-          (error, stdout) => {
-            resolve(stdout || '');
-          }
-        );
-      });
-      
-      return result.includes('progress') || result.includes('fixed');
-    } catch (error) {
-      return false;
-    }
-  }
-
-  async monitor() {
-    console.log('🐝 Build-Verifier Agent - Continuous Monitoring Active');
-    console.log(`📊 Baseline: ${this.errorCount} TypeScript errors`);
-    console.log('🎯 Target: 0 errors for alpha release');
-    
-    while (this.monitoringActive) {
-      try {
-        // Check for swarm activity
-        const swarmActivity = await this.checkSwarmMemory();
-        
-        if (swarmActivity) {
-          console.log('🔄 Swarm activity detected - Running build verification...');
-          const buildResult = await this.runBuild();
-          
-          if (buildResult.errorCount < this.errorCount) {
-            const reduction = this.errorCount - buildResult.errorCount;
-            console.log(`✅ Progress! Errors reduced by ${reduction}: ${this.errorCount} → ${buildResult.errorCount}`);
-            
-            // Update baseline
-            this.errorCount = buildResult.errorCount;
-            
-            // Store progress
-            await this.storeProgress(buildResult);
-            
-            // Alert swarm
-            await this.alertSwarm(buildResult);
-          } else if (buildResult.errorCount > this.errorCount) {
-            const increase = buildResult.errorCount - this.errorCount;
-            console.log(`⚠️  WARNING: New errors introduced! +${increase} errors: ${this.errorCount} → ${buildResult.errorCount}`);
-            
-            // Alert swarm of regression
-            await this.alertRegression(buildResult);
-          }
-          
-          if (buildResult.errorCount === 0) {
-            console.log('🎉 ALPHA RELEASE READY: ZERO ERRORS ACHIEVED!');
-            await this.certifyAlphaReady();
-            break;
-          }
-        }
-        
-        // Wait before next check
-        await new Promise(resolve => setTimeout(resolve, 30000)); // 30 second intervals
-        
-      } catch (error) {
-        console.error('❌ Monitor error:', error.message);
-        await new Promise(resolve => setTimeout(resolve, 60000)); // 1 minute on error
-      }
-    }
-  }
-
-  async storeProgress(buildResult) {
-    try {
-      exec(`npx ruv-swarm hook notification --message "BUILD PROGRESS: ${buildResult.errorCount} errors remaining (${this.errorCount - buildResult.errorCount} fixed)" --telemetry true`);
-    } catch (error) {
-      console.error('Failed to store progress:', error.message);
-    }
-  }
-
-  async alertSwarm(buildResult) {
-    const message = `🔨 BUILD UPDATE: ${buildResult.errorCount} errors remaining. Progress: ${this.errorCount - buildResult.errorCount} errors fixed.`;
-    console.log(message);
-    
-    try {
-      exec(`npx ruv-swarm hook notification --message "${message}" --telemetry true`);
-    } catch (error) {
-      console.error('Failed to alert swarm:', error.message);
-    }
-  }
-
-  async alertRegression(buildResult) {
-    const message = `⚠️ REGRESSION ALERT: ${buildResult.errorCount - this.errorCount} new errors introduced. Review recent changes.`;
-    console.log(message);
-    
-    try {
-      exec(`npx ruv-swarm hook notification --message "${message}" --telemetry true`);
-    } catch (error) {
-      console.error('Failed to alert regression:', error.message);
-    }
-  }
-
-  async certifyAlphaReady() {
-    const certification = {
-      timestamp: new Date().toISOString(),
-      status: 'ALPHA_READY',
-      errorCount: 0,
-      buildSuccess: true,
-      verifiedBy: 'Build-Verifier-Agent'
-    };
-    
-    console.log('🏆 ALPHA CERTIFICATION COMPLETE');
-    console.log('✅ Zero TypeScript compilation errors');
-    console.log('✅ Build successful');
-    console.log('✅ Ready for alpha release');
-    
-    try {
-      exec(`npx ruv-swarm hook notification --message "🏆 ALPHA CERTIFICATION: Zero errors achieved! Build ready for alpha release." --telemetry true`);
-      exec(`npx ruv-swarm hook post-task --task-id "alpha-build-verification" --analyze-performance true`);
-    } catch (error) {
-      console.error('Failed to certify alpha:', error.message);
-    }
-  }
-
-  generateReport() {
-    const report = {
-      timestamp: new Date().toISOString(),
-      currentErrorCount: this.errorCount,
-      buildHistory: this.buildHistory,
-      errorCategories: this.errorCategories,
-      status: this.errorCount === 0 ? 'ALPHA_READY' : 'IN_PROGRESS'
-    };
-    
-    fs.writeFileSync('build-verification-status.json', JSON.stringify(report, null, 2));
-    return report;
-  }
-}
-
-// Start monitoring if run directly
-if (require.main === module) {
-  const monitor = new BuildMonitor();
-  monitor.monitor().catch(console.error);
-}
-
-module.exports = BuildMonitor;