claude-flow-novice 2.3.4 → 2.3.6

package/dist/scripts/utils/README.md

@@ -1,261 +0,0 @@
-# Utility Scripts
-
-This directory contains general utility scripts for maintenance, fixes, and system operations.
-
-## Scripts
-
-### Code Fixing Utilities
-
-#### Import & Module Fixes
-- **`fix-import-paths.js`** - Fixes import path issues across the codebase
-- **`fix-imports.js`** - General import statement fixes and optimizations
-- **`fix-duplicate-imports.js`** - Removes duplicate import statements
-- **`fix-cliffy-imports.js`** - Fixes specific Cliffy CLI library import issues
-
-#### TypeScript Fixes
-- **`fix-ts-comprehensive.py`** - Comprehensive TypeScript error resolution
-- **`fix-ts-targeted-batch.js`** - Targeted TypeScript fixes in batches
-- **`fix-test-modules.js`** - Fixes test module imports and configurations
-
-#### General Code Fixes
-- **`fix-shebang.js`** - Fixes shebang lines in script files
-- **`fix-error-handling.cjs`** - Improves error handling patterns
-- **`fix-timezone-issue-246.js`** - Fixes specific timezone handling issue
-- **`simple-test-fixer.js`** - Simple test file fixes and corrections
-
-### Cleanup & Maintenance
-
-#### Build Cleanup
-- **`clean-build-artifacts.sh`** - Removes build artifacts and temporary files
-- **`cleanup-root.sh`** - Cleans up root directory of unnecessary files
-- **`remove-benchmark-conflicts.sh`** - Resolves benchmark file conflicts
-
-## Usage
-
-### Import Fixes
-```bash
-# Fix import paths
-node scripts/utils/fix-import-paths.js
-
-# Remove duplicate imports
-node scripts/utils/fix-duplicate-imports.js
-
-# Fix Cliffy imports specifically
-node scripts/utils/fix-cliffy-imports.js
-
-# General import optimization
-node scripts/utils/fix-imports.js
-```
-
-### TypeScript Fixes
-```bash
-# Comprehensive TypeScript fixes
-python scripts/utils/fix-ts-comprehensive.py
-
-# Targeted batch fixes
-node scripts/utils/fix-ts-targeted-batch.js
-
-# Test module fixes
-node scripts/utils/fix-test-modules.js
-```
-
-### System Maintenance
-```bash
-# Clean build artifacts
-bash scripts/utils/clean-build-artifacts.sh
-
-# Clean root directory
-bash scripts/utils/cleanup-root.sh
-
-# Remove benchmark conflicts
-bash scripts/utils/remove-benchmark-conflicts.sh
-```
-
-### Code Quality
-```bash
-# Fix shebang lines
-node scripts/utils/fix-shebang.js
-
-# Improve error handling
-node scripts/utils/fix-error-handling.cjs
-
-# Fix timezone issues
-node scripts/utils/fix-timezone-issue-246.js
-
-# Simple test fixes
-node scripts/utils/simple-test-fixer.js
-```
-
-## Script Categories
-
-### 1. Import & Module Management
-Scripts that handle import statements, module resolution, and dependency management.
-
-**Common Use Cases:**
-- Fixing broken import paths after file moves
-- Removing duplicate imports
-- Updating import statements for library changes
-- Resolving module resolution issues
-
-### 2. TypeScript Error Resolution
-Scripts specifically designed to fix TypeScript compilation errors.
-
-**Common Use Cases:**
-- Type annotation fixes
-- Interface compliance fixes
-- Generic type resolution
-- Module declaration fixes
-
-### 3. Test Infrastructure Fixes
-Scripts that maintain and fix test-related code.
-
-**Common Use Cases:**
-- Test import fixes
-- Test configuration updates
-- Mock and fixture repairs
-- Test runner compatibility
-
-### 4. Build System Maintenance
-Scripts that clean up and maintain the build system.
-
-**Common Use Cases:**
-- Artifact cleanup
-- Temporary file removal
-- Build cache management
-- Dependency cleanup
-
-### 5. Code Quality & Standards
-Scripts that enforce and fix code quality issues.
-
-**Common Use Cases:**
-- Shebang line standardization
-- Error handling improvements
-- Code style fixes
-- Lint error resolution
-
-## Integration with Build Process
-
-Many utility scripts are integrated into the build process:
-
-```json
-{
-  "scripts": {
-    "prebuild": "scripts/utils/clean-build-artifacts.sh",
-    "postbuild": "scripts/utils/fix-imports.js",
-    "fix:imports": "node scripts/utils/fix-import-paths.js",
-    "fix:duplicates": "node scripts/utils/fix-duplicate-imports.js",
-    "clean": "rm -rf dist .crdt-data .demo-crdt-data && scripts/utils/cleanup-root.sh"
-  }
-}
-```
-
-## Automation Features
-
-### Batch Processing
-Most scripts support batch processing for efficiency:
-```bash
-# Process multiple files
-node scripts/utils/fix-import-paths.js --batch src/**/*.ts
-
-# Dry run mode
-node scripts/utils/fix-ts-targeted-batch.js --dry-run
-
-# Verbose output
-python scripts/utils/fix-ts-comprehensive.py --verbose
-```
-
-### Safety Features
-- **Dry run mode** - Preview changes before applying
-- **Backup creation** - Automatic backups before modifications
-- **Rollback capability** - Ability to revert changes
-- **Validation checks** - Verify fixes don't break functionality
-
-### Integration with Version Control
-```bash
-# Check for uncommitted changes before running
-if git diff-index --quiet HEAD --; then
-    node scripts/utils/fix-import-paths.js
-else
-    echo "Uncommitted changes detected. Commit first."
-fi
-```
-
-## Best Practices
-
-### Before Running Utilities
-1. **Commit current changes** to version control
-2. **Run tests** to establish baseline
-3. **Create backup** if not automated
-4. **Use dry-run mode** to preview changes
-
-### After Running Utilities
-1. **Verify fixes** don't break functionality
-2. **Run tests** to ensure no regressions
-3. **Review changes** in version control
-4. **Commit fixes** with descriptive messages
-
-### Safe Usage Patterns
-```bash
-# Safe fix pattern
-git add -A && git commit -m "Pre-fix checkpoint"
-node scripts/utils/fix-import-paths.js --dry-run
-node scripts/utils/fix-import-paths.js
-npm test
-git add -A && git commit -m "Fix: Import path corrections"
-```
-
-## Troubleshooting
-
-### Script Execution Issues
-```bash
-# Check Node.js version
-node --version
-
-# Install dependencies
-npm install
-
-# Check file permissions
-chmod +x scripts/utils/*.sh
-```
-
-### Fix Script Failures
-```bash
-# Run with verbose logging
-node scripts/utils/fix-import-paths.js --verbose
-
-# Check for syntax errors
-node --check scripts/utils/fix-import-paths.js
-
-# Use alternative Python version
-python3 scripts/utils/fix-ts-comprehensive.py
-```
-
-### Recovery from Bad Fixes
-```bash
-# Revert to last commit
-git reset --hard HEAD
-
-# Revert specific files
-git checkout HEAD -- path/to/file.ts
-
-# Use backup files (if created)
-cp file.ts.backup file.ts
-```
-
-## Contributing New Utilities
-
-When adding new utility scripts:
-
-1. **Follow naming convention** - `fix-[issue-type]-[specific-name].js`
-2. **Include safety features** - dry-run, backup, validation
-3. **Add comprehensive logging** - progress, errors, results
-4. **Write documentation** - usage, examples, troubleshooting
-5. **Test thoroughly** - various file types, edge cases
-6. **Update this README** - add script description and usage
-
-## Related Directories
-
-- `../build/` - Build-specific utilities
-- `../test/` - Test-specific utilities
-- `../dev/` - Development utilities
-- `../legacy/` - Superseded utility scripts

package/dist/scripts/utils/clean-build-artifacts.sh

@@ -1,94 +0,0 @@
-#!/bin/bash
-
-# Build Artifacts Cleanup Script
-# Safe removal of regenerable build artifacts
-# Author: CI/CD Pipeline Engineer
-# Generated: 2025-09-26
-
-set -e
-
-echo "🧹 Claude Flow Build Artifacts Cleanup"
-echo "======================================"
-
-# Verify we're in the right directory
-if [ ! -f "package.json" ]; then
-    echo "❌ Error: Not in project root directory"
-    exit 1
-fi
-
-# Function to safely remove if exists
-safe_remove() {
-    local path="$1"
-    local description="$2"
-
-    if [ -e "$path" ]; then
-        echo "🗑️  Removing $description: $path"
-        rm -rf "$path"
-        echo "✅ Removed successfully"
-    else
-        echo "ℹ️  Not found: $path"
-    fi
-}
-
-# Function to calculate size before removal
-calculate_size() {
-    local path="$1"
-    if [ -e "$path" ]; then
-        du -sh "$path" 2>/dev/null | cut -f1
-    else
-        echo "0"
-    fi
-}
-
-echo ""
-echo "📊 Calculating space to be recovered..."
-
-# Calculate sizes
-DIST_SIZE=$(calculate_size "dist")
-BUILD_CONSOLIDATED_SIZE=$(calculate_size "build-consolidated.js")
-STALE_PNPM_SIZE=$(calculate_size "pnpm-lock.yaml")
-
-echo "📁 dist/ directory: $DIST_SIZE"
-echo "📄 build-consolidated.js: $BUILD_CONSOLIDATED_SIZE"
-echo "📄 pnpm-lock.yaml (stale): $STALE_PNPM_SIZE"
-
-echo ""
-echo "🚀 Starting cleanup..."
-
-# 1. Remove main build output directory
-safe_remove "dist" "TypeScript compiled output directory"
-
-# 2. Remove temporary build script
-safe_remove "build-consolidated.js" "temporary build script"
-
-# 3. Remove stale PNPM lockfile (npm is being used)
-if [ -f "pnpm-lock.yaml" ] && [ -f "package-lock.json" ]; then
-    echo "🔍 Found both pnpm-lock.yaml and package-lock.json"
-    echo "📅 pnpm-lock.yaml is older (Sep 24) vs package-lock.json (Sep 26)"
-    safe_remove "pnpm-lock.yaml" "stale PNPM lockfile"
-fi
-
-# 4. Remove any temporary directories created during build
-safe_remove ".crdt-data" "temporary CRDT data"
-safe_remove ".demo-crdt-data" "temporary demo CRDT data"
-
-# 5. Remove TypeScript incremental build info (if any)
-find . -name "*.tsbuildinfo" -not -path "./node_modules/*" -delete 2>/dev/null || true
-
-# 6. Remove any Jest cache (if present)
-safe_remove ".jest" "Jest cache directory"
-
-# 7. Remove any coverage reports (if present)
-safe_remove "coverage" "test coverage reports"
-safe_remove ".nyc_output" "NYC coverage output"
-
-echo ""
-echo "✅ Build artifacts cleanup completed!"
-echo ""
-echo "🔧 To regenerate build artifacts:"
-echo "   npm run build       # Rebuilds dist/ directory"
-echo "   npm test            # Regenerates test artifacts"
-echo ""
-echo "📈 Space recovered: ~$DIST_SIZE + additional temp files"
-echo ""
-echo "⚠️  Note: All removed files can be regenerated via npm scripts"

package/dist/scripts/utils/cleanup-root.sh

@@ -1,69 +0,0 @@
-#!/bin/bash
-
-# Claude-Flow Root Directory Cleanup Script
-# This script organizes test files and documentation into appropriate directories
-
-echo "🧹 Starting Claude-Flow root directory cleanup..."
-
-# Create archive directories if they don't exist
-mkdir -p archive/reports
-mkdir -p archive/test-files
-mkdir -p archive/debug-docs
-
-# Move test reports and debugging documentation to archive
-echo "📁 Moving test reports and debug documentation..."
-mv -v CONFIGURATION_SUMMARY.md archive/reports/ 2>/dev/null || true
-mv -v DEPENDENCY_RESOLUTION_GUIDE.md archive/reports/ 2>/dev/null || true
-mv -v DOCKER_TEST_REPORT.md archive/reports/ 2>/dev/null || true
-mv -v ERROR_HANDLING_IMPLEMENTATION_REPORT.md archive/reports/ 2>/dev/null || true
-mv -v QA_TEST_REPORT.md archive/reports/ 2>/dev/null || true
-mv -v ROLLBACK_PLAN.md archive/reports/ 2>/dev/null || true
-mv -v WEB_UI_IMPLEMENTATION.md archive/reports/ 2>/dev/null || true
-mv -v debug-findings.md archive/debug-docs/ 2>/dev/null || true
-mv -v debug-hooks-system-SOLUTION.md archive/debug-docs/ 2>/dev/null || true
-mv -v mcp-validation-report.md archive/reports/ 2>/dev/null || true
-mv -v ruv-swarm-performance-analysis.md archive/reports/ 2>/dev/null || true
-
-# Move test JavaScript files to test archive
-echo "📁 Moving test JavaScript files..."
-mv -v test*.js archive/test-files/ 2>/dev/null || true
-mv -v test*.cjs archive/test-files/ 2>/dev/null || true
-mv -v terminal-test.cjs archive/test-files/ 2>/dev/null || true
-
-# Move deployment audit log
-echo "📁 Moving audit logs..."
-mv -v deployment-audit.log archive/reports/ 2>/dev/null || true
-
-# Keep only essential files in root:
-# - README.md (main documentation)
-# - CHANGELOG.md (version history)
-# - CLAUDE.md (Claude Code integration guide)
-# - LICENSE
-# - package.json, package-lock.json
-# - configuration files
-# - main entry points
-
-echo ""
-echo "✅ Essential files kept in root:"
-echo "- README.md (main documentation)"
-echo "- CHANGELOG.md (version history)"
-echo "- CLAUDE.md (Claude Code integration)"
-echo "- LICENSE"
-echo "- package.json & package-lock.json"
-echo "- Configuration files (.gitignore, .npmignore, etc.)"
-echo "- Main entry points (cli.js, claude-flow)"
-
-echo ""
-echo "📊 Cleanup Summary:"
-echo "- Test reports moved to: archive/reports/"
-echo "- Test files moved to: archive/test-files/"
-echo "- Debug docs moved to: archive/debug-docs/"
-
-# Show current root directory status
-echo ""
-echo "📂 Current root directory (*.md files):"
-ls -la *.md 2>/dev/null | grep -v "^d" || echo "No .md files remaining"
-
-echo ""
-echo "🧹 Cleanup complete! Root directory is now organized."
-echo "💡 To restore files, check the archive/ directory"