claude-flow-novice 1.2.1 → 1.3.1

package/scripts/utils/README.md

@@ -0,0 +1,261 @@
+# 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/scripts/utils/clean-build-artifacts.sh

@@ -0,0 +1,94 @@
+#!/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/scripts/utils/cleanup-root.sh

@@ -0,0 +1,69 @@
+#!/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"