claude-flow-novice 1.3.0 → 1.3.2

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

@@ -0,0 +1,137 @@
+/**
+ * GitIgnore updater for Claude Flow initialization
+ * Ensures Claude Flow generated files are properly ignored
+ */
+
+import { existsSync, readTextFile, writeTextFile } from '../../node-compat.js';
+
+/**
+ * Default gitignore entries for Claude Flow
+ */
+const CLAUDE_FLOW_GITIGNORE_ENTRIES = `
+# Claude Flow generated files
+.claude/settings.local.json
+.mcp.json
+claude-flow.config.json
+.swarm/
+.hive-mind/
+memory/claude-flow-data.json
+memory/sessions/*
+!memory/sessions/README.md
+memory/agents/*
+!memory/agents/README.md
+coordination/memory_bank/*
+coordination/subtasks/*
+coordination/orchestration/*
+*.db
+*.db-journal
+*.db-wal
+*.sqlite
+*.sqlite-journal
+*.sqlite-wal
+claude-flow
+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);
+    }
+
+    // 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;
+  }
+}
+
+/**
+ * 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());
+}

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

@@ -0,0 +1,110 @@
+// 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 init [options]');
+  console.log();
+  console.log('🚀 DEFAULT BEHAVIOR:');
+  console.log('  claude-flow 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 init                    # ⭐ DEFAULT: Full Claude Flow v2.0.0 setup');
+  console.log('  claude-flow init --force            # Overwrite existing configuration');
+  console.log('  claude-flow init --dry-run          # Preview what will be created');
+  console.log('  claude-flow 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 init --sparc --force             # Optimized setup (existing project)',
+  );
+  console.log('  claude-flow init --sparc --modes architect,tdd,code  # Selective initialization');
+  console.log('  claude-flow init --dry-run --sparc          # Preview initialization');
+  console.log('  claude-flow init --minimal                  # Minimal setup');
+  console.log();
+  console.log('🔍 VERIFICATION & PAIR PROGRAMMING:');
+  console.log('  claude-flow init --verify                   # Truth Verification System setup');
+  console.log('  claude-flow init --pair                     # Pair Programming mode setup');
+  console.log('  claude-flow 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 init --validate                 # Validate existing setup');
+  console.log('  claude-flow init --rollback --full          # Full system rollback');
+  console.log('  claude-flow init --rollback --partial --phase sparc-init  # Rollback SPARC only');
+  console.log('  claude-flow 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 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 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');
+}