claude-flow-novice 2.0.3 → 2.0.4

package/dist/src/cli/simple-commands/init/executable-wrapper.js

@@ -1,13 +1,11 @@
 // executable-wrapper.js - Create local executable wrapper
-
-import { writeFile, chmod } from 'fs/promises';
-import { platform } from 'os';
-
+import { writeFile, chmod } from "node:fs/promises";
+import { platform } from "os";
 export async function createLocalExecutable(workingDir, dryRun = false) {
-  try {
-    if (platform() === 'win32') {
-      // Create Windows batch file
-      const wrapperScript = `@echo off
+    try {
+        if (platform() === 'win32') {
+            // Create Windows batch file
+            const wrapperScript = `@echo off
 REM Claude-Flow local wrapper
 REM This script ensures claude-flow-novice runs from your project directory
 
@@ -44,22 +42,18 @@ REM 4. Fallback to npx (will download if needed)
 cd /d "%PROJECT_DIR%"
 npx claude-flow@latest %*
 `;
-
-      // Write the Windows batch file
-      if (!dryRun) {
-        await writeFile(`${workingDir}/claude-flow.cmd`, wrapperScript, 'utf8');
-        console.log('  ✓ Created local claude-flow.cmd executable wrapper');
-        console.log('    You can now use: claude-flow-novice instead of npx claude-flow');
-      }
-    } else {
-      // Check if we're in development mode (claude-code-flow repo)
-      const isDevelopment = workingDir.includes('claude-code-flow');
-      const devBinPath = isDevelopment
-        ? workingDir.split('claude-code-flow')[0] + 'claude-code-flow/bin/claude-flow'
-        : '';
-
-      // Create Unix/Linux/Mac shell script
-      const wrapperScript = `#!/usr/bin/env bash
+            // Write the Windows batch file
+            if (!dryRun) {
+                await writeFile(`${workingDir}/claude-flow.cmd`, wrapperScript, 'utf8');
+                console.log('  ✓ Created local claude-flow.cmd executable wrapper');
+                console.log('    You can now use: claude-flow-novice instead of npx claude-flow');
+            }
+        } else {
+            // Check if we're in development mode (claude-code-flow repo)
+            const isDevelopment = workingDir.includes('claude-code-flow');
+            const devBinPath = isDevelopment ? workingDir.split('claude-code-flow')[0] + 'claude-code-flow/bin/claude-flow' : '';
+            // Create Unix/Linux/Mac shell script
+            const wrapperScript = `#!/usr/bin/env bash
 # Claude-Flow local wrapper
 # This script ensures claude-flow-novice runs from your project directory
 
@@ -73,17 +67,13 @@ export CLAUDE_WORKING_DIR="\${PROJECT_DIR}"
 # Try to find claude-flow-novice binary
 # Check common locations for npm/npx installations
 
-${
-  isDevelopment
-    ? `# Development mode - use local bin
+${isDevelopment ? `# Development mode - use local bin
 if [ -f "${devBinPath}" ]; then
   cd "\${PROJECT_DIR}"
   exec "${devBinPath}" "$@"
 fi
 
-`
-    : ''
-}# 1. Local node_modules (npm install claude-flow)
+` : ''}# 1. Local node_modules (npm install claude-flow)
 if [ -f "\${PROJECT_DIR}/node_modules/.bin/claude-flow" ]; then
   cd "\${PROJECT_DIR}"
   exec "\${PROJECT_DIR}/node_modules/.bin/claude-flow" "$@"
@@ -104,19 +94,16 @@ else
   exec npx claude-flow@latest "$@"
 fi
 `;
-
-      // Write the wrapper script
-      if (!dryRun) {
-        await writeFile(`${workingDir}/claude-flow`, wrapperScript, 'utf8');
-
-        // Make it executable
-        await chmod(`${workingDir}/claude-flow`, 0o755);
-
-        console.log('  ✓ Created local claude-flow-novice executable wrapper');
-        console.log('    You can now use: ./claude-flow-novice instead of npx claude-flow');
-      }
+            // Write the wrapper script
+            if (!dryRun) {
+                await writeFile(`${workingDir}/claude-flow`, wrapperScript, 'utf8');
+                // Make it executable
+                await chmod(`${workingDir}/claude-flow`, 0o755);
+                console.log('  ✓ Created local claude-flow-novice executable wrapper');
+                console.log('    You can now use: ./claude-flow-novice instead of npx claude-flow');
+            }
+        }
+    } catch (err) {
+        console.log(`  ⚠️  Could not create local executable: ${err.message}`);
     }
-  } catch (err) {
-    console.log(`  ⚠️  Could not create local executable: ${err.message}`);
-  }
 }

package/dist/src/cli/simple-commands/init/gitignore-updater.js

@@ -1,14 +1,10 @@
 /**
  * GitIgnore updater for Claude Flow initialization
  * Ensures Claude Flow generated files are properly ignored
- */
-
-import { existsSync, readTextFile, writeTextFile } from '../../node-compat.js';
-
+ */ import { existsSync, readTextFile, writeTextFile } from "../../node-compat.js";
 /**
  * Default gitignore entries for Claude Flow
- */
-const CLAUDE_FLOW_GITIGNORE_ENTRIES = `
+ */ const CLAUDE_FLOW_GITIGNORE_ENTRIES = `
 # Claude Flow generated files
 .claude/settings.local.json
 .mcp.json
@@ -34,104 +30,82 @@ claude-flow.bat
 claude-flow.ps1
 hive-mind-prompt-*.txt
 `;
-
 /**
  * Update or create .gitignore with Claude Flow entries
  * @param {string} workingDir - The working directory
  * @param {boolean} force - Whether to force update even if entries exist
  * @param {boolean} dryRun - Whether to run in dry-run mode
  * @returns {Promise<{success: boolean, message: string}>}
- */
-export async function updateGitignore(workingDir, force = false, dryRun = false) {
-  const gitignorePath = `${workingDir}/.gitignore`;
-
-  try {
-    let gitignoreContent = '';
-    let fileExists = false;
-
-    // Check if .gitignore exists
-    if (existsSync(gitignorePath)) {
-      fileExists = true;
-      gitignoreContent = await readTextFile(gitignorePath);
+ */ export async function updateGitignore(workingDir, force = false, dryRun = false) {
+    const gitignorePath = `${workingDir}/.gitignore`;
+    try {
+        let gitignoreContent = '';
+        let fileExists = false;
+        // Check if .gitignore exists
+        if (existsSync(gitignorePath)) {
+            fileExists = true;
+            gitignoreContent = await readTextFile(gitignorePath);
+        }
+        // Check if Claude Flow section already exists
+        const claudeFlowMarker = '# Claude Flow generated files';
+        if (gitignoreContent.includes(claudeFlowMarker) && !force) {
+            return {
+                success: true,
+                message: '.gitignore already contains Claude Flow entries'
+            };
+        }
+        // Prepare the new content
+        let newContent = gitignoreContent;
+        // Remove existing Claude Flow section if force updating
+        if (force && gitignoreContent.includes(claudeFlowMarker)) {
+            const startIndex = gitignoreContent.indexOf(claudeFlowMarker);
+            const endIndex = gitignoreContent.indexOf('\n# ', startIndex + 1);
+            if (endIndex !== -1) {
+                newContent = gitignoreContent.substring(0, startIndex) + gitignoreContent.substring(endIndex);
+            } else {
+                // Claude Flow section is at the end
+                newContent = gitignoreContent.substring(0, startIndex);
+            }
+        }
+        // Add Claude Flow entries
+        if (!newContent.endsWith('\n') && newContent.length > 0) {
+            newContent += '\n';
+        }
+        newContent += CLAUDE_FLOW_GITIGNORE_ENTRIES;
+        // Write the file
+        if (!dryRun) {
+            await writeTextFile(gitignorePath, newContent);
+        }
+        return {
+            success: true,
+            message: fileExists ? (dryRun ? '[DRY RUN] Would update' : 'Updated') + ' existing .gitignore with Claude Flow entries' : (dryRun ? '[DRY RUN] Would create' : 'Created') + ' .gitignore with Claude Flow entries'
+        };
+    } catch (error) {
+        return {
+            success: false,
+            message: `Failed to update .gitignore: ${error.message}`
+        };
     }
-
-    // Check if Claude Flow section already exists
-    const claudeFlowMarker = '# Claude Flow generated files';
-    if (gitignoreContent.includes(claudeFlowMarker) && !force) {
-      return {
-        success: true,
-        message: '.gitignore already contains Claude Flow entries',
-      };
-    }
-
-    // Prepare the new content
-    let newContent = gitignoreContent;
-
-    // Remove existing Claude Flow section if force updating
-    if (force && gitignoreContent.includes(claudeFlowMarker)) {
-      const startIndex = gitignoreContent.indexOf(claudeFlowMarker);
-      const endIndex = gitignoreContent.indexOf('\n# ', startIndex + 1);
-      if (endIndex !== -1) {
-        newContent =
-          gitignoreContent.substring(0, startIndex) + gitignoreContent.substring(endIndex);
-      } else {
-        // Claude Flow section is at the end
-        newContent = gitignoreContent.substring(0, startIndex);
-      }
-    }
-
-    // Add Claude Flow entries
-    if (!newContent.endsWith('\n') && newContent.length > 0) {
-      newContent += '\n';
-    }
-    newContent += CLAUDE_FLOW_GITIGNORE_ENTRIES;
-
-    // Write the file
-    if (!dryRun) {
-      await writeTextFile(gitignorePath, newContent);
-    }
-
-    return {
-      success: true,
-      message: fileExists
-        ? (dryRun ? '[DRY RUN] Would update' : 'Updated') +
-          ' existing .gitignore with Claude Flow entries'
-        : (dryRun ? '[DRY RUN] Would create' : 'Created') + ' .gitignore with Claude Flow entries',
-    };
-  } catch (error) {
-    return {
-      success: false,
-      message: `Failed to update .gitignore: ${error.message}`,
-    };
-  }
 }
-
 /**
  * Check if gitignore needs updating
  * @param {string} workingDir - The working directory
  * @returns {Promise<boolean>}
- */
-export async function needsGitignoreUpdate(workingDir) {
-  const gitignorePath = `${workingDir}/.gitignore`;
-
-  if (!existsSync(gitignorePath)) {
-    return true;
-  }
-
-  try {
-    const content = await readTextFile(gitignorePath);
-    return !content.includes('# Claude Flow generated files');
-  } catch {
-    return true;
-  }
+ */ export async function needsGitignoreUpdate(workingDir) {
+    const gitignorePath = `${workingDir}/.gitignore`;
+    if (!existsSync(gitignorePath)) {
+        return true;
+    }
+    try {
+        const content = await readTextFile(gitignorePath);
+        return !content.includes('# Claude Flow generated files');
+    } catch  {
+        return true;
+    }
 }
-
 /**
  * Get list of files that should be gitignored
  * @returns {string[]}
- */
-export function getGitignorePatterns() {
-  return CLAUDE_FLOW_GITIGNORE_ENTRIES.split('\n')
-    .filter((line) => line.trim() && !line.startsWith('#') && !line.startsWith('!'))
-    .map((line) => line.trim());
+ */ export function getGitignorePatterns() {
+    return CLAUDE_FLOW_GITIGNORE_ENTRIES.split('\n').filter((line)=>line.trim() && !line.startsWith('#') && !line.startsWith('!')).map((line)=>line.trim());
 }

package/dist/src/cli/simple-commands/init/help.js

@@ -1,110 +1,107 @@
 // help.js - Help text for init command
-
 export function showInitHelp() {
-  console.log('Initialize Claude Code integration files with Claude Flow v2.0.0');
-  console.log();
-  console.log('Usage: claude-flow-novice init [options]');
-  console.log();
-  console.log('🚀 DEFAULT BEHAVIOR:');
-  console.log('  claude-flow-novice init     Initialize with Claude Flow v2.0.0 enhanced features');
-  console.log('                       Creates CLAUDE.md & .claude/commands for MCP integration');
-  console.log();
-  console.log('Standard Options:');
-  console.log('  --force, -f          Overwrite existing files (also updates .gitignore)');
-  console.log('  --dry-run, -d        Preview what would be created without making changes');
-  console.log('  --help, -h           Show this help message');
-  console.log();
-  console.log('Alternative Initialization Modes:');
-  console.log('  --basic              Use basic initialization (pre-v2.0.0 behavior)');
-  console.log('  --sparc, -s          Initialize with SPARC development environment');
-  console.log('  --minimal, -m        Create minimal configuration files');
-  console.log('  --modes <list>       Initialize only specific SPARC modes (comma-separated)');
-  console.log('  --skip-mcp           Skip automatic MCP server setup in Claude Code');
-  console.log('  --monitoring         Enable token usage tracking and telemetry setup');
-  console.log();
-  console.log('Verification & Pair Programming:');
-  console.log('  --verify             Initialize with Truth Verification System enabled');
-  console.log('  --pair               Initialize with Pair Programming mode enabled');
-  console.log('                       (These options create verification-focused CLAUDE.md)');
-  console.log();
-  console.log('Advanced Options:');
-  console.log('  --enhanced, --safe   Enhanced initialization with validation and rollback');
-  console.log('  --validate           Run validation checks only');
-  console.log('  --validate-only      Validate without initializing');
-  console.log('  --rollback           Rollback previous initialization');
-  console.log('  --list-backups       List available backups and rollback points');
-  console.log();
-  console.log('Validation & Rollback Options:');
-  console.log('  --skip-pre-validation    Skip pre-initialization checks');
-  console.log('  --skip-backup           Skip backup creation');
-  console.log('  --rollback --full       Perform full system rollback');
-  console.log('  --rollback --partial --phase <name>  Rollback specific phase');
-  console.log('  --validate --skip-pre-init           Skip pre-init validation');
-  console.log('  --validate --skip-config            Skip configuration validation');
-  console.log('  --validate --skip-mode-test         Skip SPARC mode testing');
-  console.log();
-  console.log('Examples:');
-  console.log('🌊 CLAUDE FLOW v2.0.0 (DEFAULT):');
-  console.log('  claude-flow-novice init                    # ⭐ DEFAULT: Full Claude Flow v2.0.0 setup');
-  console.log('  claude-flow-novice init --force            # Overwrite existing configuration');
-  console.log('  claude-flow-novice init --dry-run          # Preview what will be created');
-  console.log('  claude-flow-novice init --monitoring       # Initialize with token tracking enabled');
-  console.log();
-  console.log('🚀 STANDARD INITIALIZATION:');
-  console.log('  npx claude-flow@latest init --sparc --force  # ⭐ RECOMMENDED: Optimized setup');
-  console.log('  npx claude-flow@latest init --sparc          # Standard SPARC setup');
-  console.log(
-    '  claude-flow-novice init --sparc --force             # Optimized setup (existing project)',
-  );
-  console.log('  claude-flow-novice init --sparc --modes architect,tdd,code  # Selective initialization');
-  console.log('  claude-flow-novice init --dry-run --sparc          # Preview initialization');
-  console.log('  claude-flow-novice init --minimal                  # Minimal setup');
-  console.log();
-  console.log('🔍 VERIFICATION & PAIR PROGRAMMING:');
-  console.log('  claude-flow-novice init --verify                   # Truth Verification System setup');
-  console.log('  claude-flow-novice init --pair                     # Pair Programming mode setup');
-  console.log('  claude-flow-novice init --verify --pair            # Both verification and pairing');
-  console.log('  npx claude-flow@alpha init --verify --pair  # Complete verification setup');
-  console.log();
-  console.log('🔄 VALIDATION & ROLLBACK:');
-  console.log('  claude-flow-novice init --validate                 # Validate existing setup');
-  console.log('  claude-flow-novice init --rollback --full          # Full system rollback');
-  console.log('  claude-flow-novice init --rollback --partial --phase sparc-init  # Rollback SPARC only');
-  console.log('  claude-flow-novice init --list-backups             # Show available backups');
-  console.log();
-  console.log('What gets created:');
-  console.log('  • .claude/settings.json - Claude Code configuration with hooks');
-  console.log('  • .claude/settings.local.json - Pre-approved MCP permissions (no prompts!)');
-  console.log('  • .mcp.json - Project-scoped MCP server configuration');
-  console.log('  • claude-flow.config.json - Claude Flow features and performance settings');
-  console.log('  • .claude/commands/ directory with 20+ Claude Code slash commands');
-  console.log('  • CLAUDE.md with project instructions (v2.0.0 enhanced by default)');
-  console.log('  • memory/ directory for persistent context storage');
-  console.log('  • coordination/ directory for agent orchestration');
-  console.log('  • ./claude-flow-novice local executable wrapper');
-  console.log('  • .gitignore entries for Claude Flow generated files');
-  console.log('  • Automatic MCP server setup if Claude Code CLI is installed');
-  console.log('  • Pre-configured for TDD, architecture, and code generation');
-  console.log();
-  console.log('Claude Code Slash Commands Created:');
-  console.log('  • /sparc - Execute SPARC methodology workflows');
-  console.log('  • /sparc-<mode> - Run specific SPARC modes (17+ modes)');
-  console.log('  • /claude-flow-help - Show all claude-flow-novice commands');
-  console.log('  • /claude-flow-memory - Interact with memory system');
-  console.log('  • /claude-flow-swarm - Coordinate multi-agent swarms');
-  console.log();
-  console.log('Available SPARC modes:');
-  console.log('  • architect - System design and architecture');
-  console.log('  • code - Clean, modular implementation');
-  console.log('  • tdd - Test-driven development');
-  console.log('  • debug - Advanced debugging and optimization');
-  console.log('  • security-review - Security analysis and hardening');
-  console.log('  • docs-writer - Documentation creation');
-  console.log('  • integration - System integration');
-  console.log('  • swarm - Multi-agent coordination');
-  console.log('  • spec-pseudocode - Requirements and specifications');
-  console.log('  • devops - Deployment and infrastructure');
-  console.log('  • And 7+ more specialized modes...');
-  console.log();
-  console.log('Learn more: https://github.com/ruvnet/claude-code-flow');
+    console.log('Initialize Claude Code integration files with Claude Flow v2.0.0');
+    console.log();
+    console.log('Usage: claude-flow-novice init [options]');
+    console.log();
+    console.log('🚀 DEFAULT BEHAVIOR:');
+    console.log('  claude-flow-novice init     Initialize with Claude Flow v2.0.0 enhanced features');
+    console.log('                       Creates CLAUDE.md & .claude/commands for MCP integration');
+    console.log();
+    console.log('Standard Options:');
+    console.log('  --force, -f          Overwrite existing files (also updates .gitignore)');
+    console.log('  --dry-run, -d        Preview what would be created without making changes');
+    console.log('  --help, -h           Show this help message');
+    console.log();
+    console.log('Alternative Initialization Modes:');
+    console.log('  --basic              Use basic initialization (pre-v2.0.0 behavior)');
+    console.log('  --sparc, -s          Initialize with SPARC development environment');
+    console.log('  --minimal, -m        Create minimal configuration files');
+    console.log('  --modes <list>       Initialize only specific SPARC modes (comma-separated)');
+    console.log('  --skip-mcp           Skip automatic MCP server setup in Claude Code');
+    console.log('  --monitoring         Enable token usage tracking and telemetry setup');
+    console.log();
+    console.log('Verification & Pair Programming:');
+    console.log('  --verify             Initialize with Truth Verification System enabled');
+    console.log('  --pair               Initialize with Pair Programming mode enabled');
+    console.log('                       (These options create verification-focused CLAUDE.md)');
+    console.log();
+    console.log('Advanced Options:');
+    console.log('  --enhanced, --safe   Enhanced initialization with validation and rollback');
+    console.log('  --validate           Run validation checks only');
+    console.log('  --validate-only      Validate without initializing');
+    console.log('  --rollback           Rollback previous initialization');
+    console.log('  --list-backups       List available backups and rollback points');
+    console.log();
+    console.log('Validation & Rollback Options:');
+    console.log('  --skip-pre-validation    Skip pre-initialization checks');
+    console.log('  --skip-backup           Skip backup creation');
+    console.log('  --rollback --full       Perform full system rollback');
+    console.log('  --rollback --partial --phase <name>  Rollback specific phase');
+    console.log('  --validate --skip-pre-init           Skip pre-init validation');
+    console.log('  --validate --skip-config            Skip configuration validation');
+    console.log('  --validate --skip-mode-test         Skip SPARC mode testing');
+    console.log();
+    console.log('Examples:');
+    console.log('🌊 CLAUDE FLOW v2.0.0 (DEFAULT):');
+    console.log('  claude-flow-novice init                    # ⭐ DEFAULT: Full Claude Flow v2.0.0 setup');
+    console.log('  claude-flow-novice init --force            # Overwrite existing configuration');
+    console.log('  claude-flow-novice init --dry-run          # Preview what will be created');
+    console.log('  claude-flow-novice init --monitoring       # Initialize with token tracking enabled');
+    console.log();
+    console.log('🚀 STANDARD INITIALIZATION:');
+    console.log('  npx claude-flow@latest init --sparc --force  # ⭐ RECOMMENDED: Optimized setup');
+    console.log('  npx claude-flow@latest init --sparc          # Standard SPARC setup');
+    console.log('  claude-flow-novice init --sparc --force             # Optimized setup (existing project)');
+    console.log('  claude-flow-novice init --sparc --modes architect,tdd,code  # Selective initialization');
+    console.log('  claude-flow-novice init --dry-run --sparc          # Preview initialization');
+    console.log('  claude-flow-novice init --minimal                  # Minimal setup');
+    console.log();
+    console.log('🔍 VERIFICATION & PAIR PROGRAMMING:');
+    console.log('  claude-flow-novice init --verify                   # Truth Verification System setup');
+    console.log('  claude-flow-novice init --pair                     # Pair Programming mode setup');
+    console.log('  claude-flow-novice init --verify --pair            # Both verification and pairing');
+    console.log('  npx claude-flow@alpha init --verify --pair  # Complete verification setup');
+    console.log();
+    console.log('🔄 VALIDATION & ROLLBACK:');
+    console.log('  claude-flow-novice init --validate                 # Validate existing setup');
+    console.log('  claude-flow-novice init --rollback --full          # Full system rollback');
+    console.log('  claude-flow-novice init --rollback --partial --phase sparc-init  # Rollback SPARC only');
+    console.log('  claude-flow-novice init --list-backups             # Show available backups');
+    console.log();
+    console.log('What gets created:');
+    console.log('  • .claude/settings.json - Claude Code configuration with hooks');
+    console.log('  • .claude/settings.local.json - Pre-approved MCP permissions (no prompts!)');
+    console.log('  • .mcp.json - Project-scoped MCP server configuration');
+    console.log('  • claude-flow.config.json - Claude Flow features and performance settings');
+    console.log('  • .claude/commands/ directory with 20+ Claude Code slash commands');
+    console.log('  • CLAUDE.md with project instructions (v2.0.0 enhanced by default)');
+    console.log('  • memory/ directory for persistent context storage');
+    console.log('  • coordination/ directory for agent orchestration');
+    console.log('  • ./claude-flow-novice local executable wrapper');
+    console.log('  • .gitignore entries for Claude Flow generated files');
+    console.log('  • Automatic MCP server setup if Claude Code CLI is installed');
+    console.log('  • Pre-configured for TDD, architecture, and code generation');
+    console.log();
+    console.log('Claude Code Slash Commands Created:');
+    console.log('  • /sparc - Execute SPARC methodology workflows');
+    console.log('  • /sparc-<mode> - Run specific SPARC modes (17+ modes)');
+    console.log('  • /claude-flow-help - Show all claude-flow-novice commands');
+    console.log('  • /claude-flow-memory - Interact with memory system');
+    console.log('  • /claude-flow-swarm - Coordinate multi-agent swarms');
+    console.log();
+    console.log('Available SPARC modes:');
+    console.log('  • architect - System design and architecture');
+    console.log('  • code - Clean, modular implementation');
+    console.log('  • tdd - Test-driven development');
+    console.log('  • debug - Advanced debugging and optimization');
+    console.log('  • security-review - Security analysis and hardening');
+    console.log('  • docs-writer - Documentation creation');
+    console.log('  • integration - System integration');
+    console.log('  • swarm - Multi-agent coordination');
+    console.log('  • spec-pseudocode - Requirements and specifications');
+    console.log('  • devops - Deployment and infrastructure');
+    console.log('  • And 7+ more specialized modes...');
+    console.log();
+    console.log('Learn more: https://github.com/ruvnet/claude-code-flow');
 }