claude-flow 2.5.0-alpha.139 → 2.5.0-alpha.141

package/src/cli/commands/index.ts

@@ -22,7 +22,6 @@ import { startCommand } from './start.js';
 import { statusCommand } from './status.js';
 import { monitorCommand } from './monitor.js';
 import { sessionCommand } from './session.js';
-import { checkpointCommand } from './checkpoint.js';
 
 let orchestrator: Orchestrator | null = null;
 let configManager: ConfigManager | null = null;
@@ -2134,33 +2133,7 @@ Now, please proceed with the task: ${task}`;
     action: (ctx: CommandContext) => {
       const command = ctx.args[0];
 
-      if (command === 'checkpoint') {
-        console.log(bold(blue('Checkpoint Management (SDK Integration)')));
-        console.log();
-        console.log('Manage session checkpoints with Git-like time travel for AI sessions.');
-        console.log();
-        console.log(bold('Subcommands:'));
-        console.log('  create <session-id> [description]    Create checkpoint for session');
-        console.log('  list <session-id>                    List checkpoints for session');
-        console.log('  info <checkpoint-id>                 Get checkpoint details');
-        console.log('  rollback <checkpoint-id>             Rollback to checkpoint');
-        console.log('  delete <checkpoint-id>               Delete checkpoint');
-        console.log();
-        console.log(bold('Examples:'));
-        console.log(`  ${blue('claude-flow checkpoint create')} my-session "Before deployment"`);
-        console.log(`  ${blue('claude-flow checkpoint list')} my-session`);
-        console.log(`  ${blue('claude-flow checkpoint rollback')} cp-abc123`);
-        console.log();
-        console.log(bold('MCP Tools (Available through claude-flow MCP server):'));
-        console.log('  checkpoint/create       Create checkpoint via MCP');
-        console.log('  checkpoint/list         List checkpoints via MCP');
-        console.log('  checkpoint/rollback     Rollback via MCP');
-        console.log('  session/fork            Fork session for parallel exploration');
-        console.log('  session/info            Get session info');
-        console.log('  query/pause             Pause query with SDK');
-        console.log('  query/resume            Resume paused query');
-        console.log();
-      } else if (command === 'claude') {
+      if (command === 'claude') {
         console.log(bold(blue('Claude Instance Management')));
         console.log();
         console.log('Spawn and manage Claude Code instances with specific configurations.');
@@ -2558,62 +2531,6 @@ Now, please proceed with the task: ${task}`;
     },
   });
 
-  // Checkpoint command for SDK session management
-  cli.command({
-    name: 'checkpoint',
-    description: 'Manage session checkpoints (Git-like time travel for AI sessions)',
-    subcommands: [
-      {
-        name: 'create',
-        description: 'Create a checkpoint for a session',
-        action: async (ctx: CommandContext) => {
-          const { checkpointCommand } = await import('./checkpoint.js');
-          // Delegate to the checkpoint command implementation
-          await checkpointCommand.parseAsync(['node', 'checkpoint', 'create', ...ctx.args], { from: 'user' });
-        },
-      },
-      {
-        name: 'list',
-        description: 'List checkpoints for a session',
-        action: async (ctx: CommandContext) => {
-          const { checkpointCommand } = await import('./checkpoint.js');
-          await checkpointCommand.parseAsync(['node', 'checkpoint', 'list', ...ctx.args], { from: 'user' });
-        },
-      },
-      {
-        name: 'info',
-        description: 'Get checkpoint information',
-        action: async (ctx: CommandContext) => {
-          const { checkpointCommand } = await import('./checkpoint.js');
-          await checkpointCommand.parseAsync(['node', 'checkpoint', 'info', ...ctx.args], { from: 'user' });
-        },
-      },
-      {
-        name: 'rollback',
-        description: 'Rollback session to a checkpoint',
-        action: async (ctx: CommandContext) => {
-          const { checkpointCommand } = await import('./checkpoint.js');
-          await checkpointCommand.parseAsync(['node', 'checkpoint', 'rollback', ...ctx.args], { from: 'user' });
-        },
-      },
-      {
-        name: 'delete',
-        description: 'Delete a checkpoint',
-        action: async (ctx: CommandContext) => {
-          const { checkpointCommand } = await import('./checkpoint.js');
-          await checkpointCommand.parseAsync(['node', 'checkpoint', 'delete', ...ctx.args], { from: 'user' });
-        },
-      },
-    ],
-    action: async (ctx: CommandContext) => {
-      // Show help if no subcommand
-      if (ctx.args.length === 0) {
-        const { checkpointCommand } = await import('./checkpoint.js');
-        checkpointCommand.help();
-      }
-    },
-  });
-
   // Add enterprise commands
   for (const command of enterpriseCommands) {
     cli.command(command);

package/src/cli/commands/swarm-spawn.ts

@@ -1,11 +1,7 @@
 /**
  * Swarm spawning utilities
- * Enhanced with SDK session forking for REAL parallel exploration
  */
 
-import { sessionForking } from '../../sdk/session-forking.js';
-import { checkpointManager } from '../../sdk/checkpoint-manager.js';
-
 interface Agent {
   id: string;
   type: string;
@@ -14,7 +10,6 @@ interface Agent {
   task: string;
   parentId?: string;
   terminalId?: string;
-  sessionId?: string; // SDK session ID for forking
 }
 
 interface SwarmState {
@@ -22,81 +17,42 @@ interface SwarmState {
   objective: string;
   agents: Map<string, Agent>;
   startTime: number;
-  sessionId: string; // Main session ID
-  forks: string[]; // Forked session IDs
 }
 
 const swarmStates = new Map<string, SwarmState>();
 
-export async function initializeSwarm(swarmId: string, objective: string): Promise<void> {
+export function initializeSwarm(swarmId: string, objective: string): void {
   swarmStates.set(swarmId, {
     swarmId: swarmId,
     objective,
     agents: new Map<string, Agent>(),
     startTime: Date.now(),
-    sessionId: swarmId, // Use swarmId as main session
-    forks: [],
   });
-
-  // Create initial checkpoint
-  console.log('[SWARM] Creating initial checkpoint...');
-  // Checkpoint will be created when session starts tracking
 }
 
 export async function spawnSwarmAgent(
   swarmId: string,
   agentType: string,
   task: string,
-  options?: { fork?: boolean; checkpointBefore?: boolean }
 ): Promise<string> {
   const swarm = swarmStates.get(swarmId);
   if (!swarm) {
     throw new Error(`Swarm ${swarmId} not found`);
   }
 
-  // Checkpoint before spawning if requested
-  if (options?.checkpointBefore) {
-    try {
-      await checkpointManager.createCheckpoint(
-        swarm.sessionId,
-        `Before spawning ${agentType} agent`
-      );
-      console.log(`[SWARM] Checkpoint created before spawn`);
-    } catch (error) {
-      console.log(`[SWARM] Note: Checkpoint creation skipped (session not tracked)`);
-    }
-  }
-
   const agentId = `${swarmId}-agent-${Date.now()}`;
-  let agentSessionId = swarm.sessionId;
-
-  // Fork session for parallel exploration if requested
-  if (options?.fork) {
-    try {
-      const fork = await sessionForking.fork(swarm.sessionId, {});
-      agentSessionId = fork.sessionId;
-      swarm.forks.push(fork.sessionId);
-      console.log(`[SWARM] Forked session for agent: ${fork.sessionId.substring(0, 8)}...`);
-    } catch (error) {
-      console.log(`[SWARM] Note: Fork creation skipped (session not tracked)`);
-    }
-  }
-
   const agent: Agent = {
     id: agentId,
     type: agentType,
     status: 'active',
     name: `${agentType}-${agentId}`,
     task: task,
-    sessionId: agentSessionId,
   };
   swarm.agents.set(agentId, agent);
 
+  // In a real implementation, this would spawn actual Claude instances
   console.log(`[SWARM] Spawned ${agentType} agent: ${agentId}`);
-  if (options?.fork) {
-    console.log(`[SWARM]   Session: ${agentSessionId.substring(0, 8)}... (forked)`);
-  }
-  console.log(`[SWARM]   Task: ${task}`);
+  console.log(`[SWARM] Task: ${task}`);
 
   return agentId;
 }

package/src/cli/help-text.js

@@ -95,11 +95,25 @@ USAGE:
   batch <action>           Batch operations
   stream-chain <workflow>  Stream-JSON chaining for multi-agent pipelines
 
-🔥 MCP TOOLS AVAILABLE:
+🔥 NEW MCP TOOLS (v2.5.0-alpha.130):
   Available via Claude Code after installing:
     claude mcp add claude-flow npx claude-flow@alpha mcp start
 
-  See full tool list with: claude-flow mcp tools
+  mcp__claude-flow__agents_spawn_parallel    Spawn agents in parallel (10-20x faster)
+    • Spawn multiple agents concurrently
+    • 10-20x speedup vs sequential spawning
+    • Example: 3 agents in 150ms instead of 2250ms
+
+  mcp__claude-flow__query_control            Control running queries in real-time
+    • Actions: pause, resume, terminate
+    • Change model mid-execution (Sonnet → Haiku for cost savings)
+    • Change permissions dynamically
+    • Execute commands in query context
+
+  mcp__claude-flow__query_list               List active queries with status
+    • View all running queries
+    • Monitor query status and performance
+    • Filter by active or include history
 
 🔍 GET HELP:
   npx claude-flow --help                Show this help

package/src/cli/simple-cli.ts

@@ -58,7 +58,6 @@ USAGE:
   agent <subcommand>          # Advanced agent management with neural patterns
   sparc <subcommand>          # 17 SPARC modes with neural enhancement
   memory <subcommand>         # Cross-session persistent memory with neural learning
-  checkpoint <subcommand>     # SDK session checkpoints (Git-like time travel)
   status                      # Comprehensive system status with performance metrics
 
 🤖 NEURAL AGENT TYPES (ruv-swarm Integration):

package/src/cli/simple-commands/hooks.js

@@ -86,6 +86,17 @@ export async function hooksAction(subArgs, flags) {
         await notifyCommand(subArgs, flags);
         break;
 
+      // NEW: PreToolUse Modification Hooks (v2.0.10+)
+      case 'modify-bash':
+        await modifyBashCommand(subArgs, flags);
+        break;
+      case 'modify-file':
+        await modifyFileCommand(subArgs, flags);
+        break;
+      case 'modify-git-commit':
+        await modifyGitCommitCommand(subArgs, flags);
+        break;
+
       default:
         printError(`Unknown hooks command: ${subcommand}`);
         showHooksHelp();
@@ -1155,6 +1166,282 @@ async function notifyCommand(subArgs, flags) {
   }
 }
 
+// ===== PRETOOLUSE MODIFICATION HOOKS (v2.0.10+) =====
+
+async function modifyBashCommand(subArgs, flags) {
+  // Read JSON from stdin with timeout to detect if data is piped
+  let input = '';
+  let hasInput = false;
+
+  const timeout = setTimeout(() => {
+    if (!hasInput) {
+      console.log('Usage: echo \'{"tool_input":{"command":"your command"}}\' | claude-flow hooks modify-bash');
+      console.log('\nThis hook reads JSON from stdin and outputs modified JSON.');
+      console.log('It is designed for use with Claude Code v2.0.10+ PreToolUse feature.');
+      console.log('\nExample:');
+      console.log('  echo \'{"tool_input":{"command":"rm test.txt"}}\' | claude-flow hooks modify-bash');
+      process.exit(0);
+    }
+  }, 100); // 100ms timeout
+
+  for await (const chunk of process.stdin) {
+    hasInput = true;
+    clearTimeout(timeout);
+    input += chunk;
+  }
+
+  if (!input.trim()) {
+    return; // Silently exit if no input
+  }
+
+  const toolInput = JSON.parse(input);
+  const command = toolInput.tool_input?.command || '';
+
+  if (!command) {
+    console.log(input); // Pass through if no command
+    return;
+  }
+
+  let modifiedCommand = command;
+  const notes = [];
+
+  // 1. Safety: Add -i flag to rm commands
+  if (/^rm\s/.test(command) && !/-[iI]/.test(command)) {
+    modifiedCommand = command.replace(/^rm /, 'rm -i ');
+    notes.push('[Safety: Added -i flag for interactive confirmation]');
+  }
+
+  // 2. Aliases
+  if (/^ll(\s|$)/.test(command)) {
+    modifiedCommand = command.replace(/^ll/, 'ls -lah');
+    notes.push('[Alias: ll → ls -lah]');
+  } else if (/^la(\s|$)/.test(command)) {
+    modifiedCommand = command.replace(/^la/, 'ls -la');
+    notes.push('[Alias: la → ls -la]');
+  }
+
+  // 3. Path correction: Redirect test files to /tmp
+  if (/>\s*test.*\.(txt|log|tmp|json|md)/.test(command) && !/\/tmp\//.test(command)) {
+    modifiedCommand = command.replace(/>\s*(test[^/]*\.(txt|log|tmp|json|md))/, '> /tmp/$1');
+    notes.push('[Path: Redirected test file to /tmp/]');
+  }
+
+  // 4. Secret detection
+  if (/(password|secret|token|api[-_]?key|auth)/i.test(command) && !/#\s*SECRETS_OK/.test(command)) {
+    notes.push('[Security: Command contains sensitive keywords. Add "# SECRETS_OK" to bypass]');
+  }
+
+  // Output modified JSON
+  const output = {
+    ...toolInput,
+    tool_input: {
+      ...toolInput.tool_input,
+      command: modifiedCommand,
+    },
+  };
+
+  if (notes.length > 0) {
+    output.modification_notes = notes.join(' ');
+  }
+
+  console.log(JSON.stringify(output, null, 2));
+}
+
+async function modifyFileCommand(subArgs, flags) {
+  // Read JSON from stdin with timeout to detect if data is piped
+  let input = '';
+  let hasInput = false;
+
+  const timeout = setTimeout(() => {
+    if (!hasInput) {
+      console.log('Usage: echo \'{"tool_input":{"file_path":"your/file.js"}}\' | claude-flow hooks modify-file');
+      console.log('\nThis hook reads JSON from stdin and outputs modified JSON.');
+      console.log('It is designed for use with Claude Code v2.0.10+ PreToolUse feature.');
+      console.log('\nExample:');
+      console.log('  echo \'{"tool_input":{"file_path":"test.js"}}\' | claude-flow hooks modify-file');
+      process.exit(0);
+    }
+  }, 100); // 100ms timeout
+
+  for await (const chunk of process.stdin) {
+    hasInput = true;
+    clearTimeout(timeout);
+    input += chunk;
+  }
+
+  if (!input.trim()) {
+    return; // Silently exit if no input
+  }
+
+  const toolInput = JSON.parse(input);
+  const filePath = toolInput.tool_input?.file_path || toolInput.tool_input?.path || '';
+
+  if (!filePath) {
+    console.log(input); // Pass through if no file path
+    return;
+  }
+
+  let modifiedPath = filePath;
+  let shouldModify = false;
+  const notes = [];
+
+  // 1. Root folder protection
+  const isRootFile = /^[^/]*\.(js|ts|jsx|tsx|py|java|go|rs|cpp|c|h)$/.test(filePath) ||
+                     /^test.*\.(txt|log|tmp|json|md)$/.test(filePath) ||
+                     /^(temp|tmp|working)/.test(filePath);
+
+  if (isRootFile) {
+    if (/test.*\.(test|spec)\.|\.test\.|\.spec\./.test(filePath)) {
+      modifiedPath = `tests/${filePath}`;
+      shouldModify = true;
+      notes.push('[Organization: Moved test file to /tests/]');
+    } else if (/test.*\.md|temp.*\.md|working.*\.md|scratch.*\.md/.test(filePath)) {
+      modifiedPath = `docs/working/${filePath}`;
+      shouldModify = true;
+      notes.push('[Organization: Moved working document to /docs/working/]');
+    } else if (/\.(js|ts|jsx|tsx|py)$/.test(filePath)) {
+      modifiedPath = `src/${filePath}`;
+      shouldModify = true;
+      notes.push('[Organization: Moved source file to /src/]');
+    } else if (/^(temp|tmp|scratch)/.test(filePath)) {
+      modifiedPath = `/tmp/${filePath}`;
+      shouldModify = true;
+      notes.push('[Organization: Redirected temporary file to /tmp/]');
+    }
+  }
+
+  // 2. Format hints
+  if (/\.(ts|tsx|js|jsx)$/.test(modifiedPath)) {
+    notes.push('[Tip: Auto-format with Prettier/ESLint recommended]');
+  } else if (/\.py$/.test(modifiedPath)) {
+    notes.push('[Tip: Auto-format with Black/autopep8 recommended]');
+  }
+
+  // Output modified JSON
+  const output = {
+    ...toolInput,
+    tool_input: {
+      ...toolInput.tool_input,
+    },
+  };
+
+  if (shouldModify) {
+    if (toolInput.tool_input.file_path) {
+      output.tool_input.file_path = modifiedPath;
+    } else {
+      output.tool_input.path = modifiedPath;
+    }
+  }
+
+  if (notes.length > 0) {
+    output.modification_notes = notes.join(' ');
+  }
+
+  console.log(JSON.stringify(output, null, 2));
+}
+
+async function modifyGitCommitCommand(subArgs, flags) {
+  // Read JSON from stdin with timeout to detect if data is piped
+  let input = '';
+  let hasInput = false;
+
+  const timeout = setTimeout(() => {
+    if (!hasInput) {
+      console.log('Usage: echo \'{"tool_input":{"command":"git commit -m \\"message\\""}}\'  | claude-flow hooks modify-git-commit');
+      console.log('\nThis hook reads JSON from stdin and outputs modified JSON.');
+      console.log('It is designed for use with Claude Code v2.0.10+ PreToolUse feature.');
+      console.log('\nExample:');
+      console.log('  echo \'{"tool_input":{"command":"git commit -m \\"fix bug\\""}}\'  | claude-flow hooks modify-git-commit');
+      process.exit(0);
+    }
+  }, 100); // 100ms timeout
+
+  for await (const chunk of process.stdin) {
+    hasInput = true;
+    clearTimeout(timeout);
+    input += chunk;
+  }
+
+  if (!input.trim()) {
+    return; // Silently exit if no input
+  }
+
+  const toolInput = JSON.parse(input);
+  const command = toolInput.tool_input?.command || '';
+
+  if (!command || !/git commit/.test(command)) {
+    console.log(input); // Pass through if not git commit
+    return;
+  }
+
+  // Extract commit message
+  const msgMatch = command.match(/-m\s+["']([^"']+)["']/) || command.match(/-m\s+(\S+)/);
+  const commitMsg = msgMatch ? msgMatch[1] : '';
+
+  if (!commitMsg || /^\[(feat|fix|docs|style|refactor|test|chore|perf)\]/.test(commitMsg)) {
+    console.log(input); // Already formatted or no message
+    return;
+  }
+
+  const notes = [];
+
+  // Get current branch
+  let branch = 'main';
+  let ticket = '';
+  try {
+    const { execSync } = await import('child_process');
+    branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf8' }).trim();
+
+    // Extract JIRA ticket
+    const ticketMatch = branch.match(/[A-Z]+-[0-9]+/);
+    if (ticketMatch) {
+      ticket = ticketMatch[0];
+    }
+  } catch {
+    // Git not available, continue
+  }
+
+  // Detect conventional commit type
+  let type = 'chore';
+  if (/^(add|implement|create|new)/i.test(commitMsg)) type = 'feat';
+  else if (/^(fix|resolve|patch|correct)/i.test(commitMsg)) type = 'fix';
+  else if (/^(update|modify|change|improve)/i.test(commitMsg)) type = 'refactor';
+  else if (/^(doc|documentation|readme)/i.test(commitMsg)) type = 'docs';
+  else if (/^(test|testing|spec)/i.test(commitMsg)) type = 'test';
+  else if (/^(style|format|lint)/i.test(commitMsg)) type = 'style';
+  else if (/^(perf|optimize|speed)/i.test(commitMsg)) type = 'perf';
+
+  // Format message
+  let formattedMsg = ticket
+    ? `[${type}] ${commitMsg} (${ticket})`
+    : `[${type}] ${commitMsg}`;
+
+  // Add co-author
+  if (!/Co-Authored-By/.test(command)) {
+    formattedMsg += `\n\n🤖 Generated with Claude Flow\nCo-Authored-By: claude-flow <noreply@ruv.io>`;
+  }
+
+  // Replace message in command
+  const modifiedCommand = command.replace(
+    /-m\s+["'][^"']+["']|-m\s+\S+/,
+    `-m "$(cat <<'EOF'\n${formattedMsg}\nEOF\n)"`
+  );
+
+  notes.push(`[Auto-formatted: ${type} type${ticket ? ` + ${ticket}` : ''}]`);
+
+  // Output modified JSON
+  const output = {
+    ...toolInput,
+    tool_input: {
+      ...toolInput.tool_input,
+      command: modifiedCommand,
+    },
+    modification_notes: notes.join(' '),
+  };
+
+  console.log(JSON.stringify(output, null, 2));
+}
+
 function showHooksHelp() {
   console.log('Claude Flow Hooks (with .swarm/memory.db persistence):\n');
 
@@ -1194,6 +1481,23 @@ function showHooksHelp() {
   console.log('  session-restore    Load previous session state');
   console.log('  notify             Custom notifications');
 
+  console.log('\n===== NEW: PreToolUse Modification Hooks (v2.0.10+) =====');
+  console.log('  modify-bash        Modify Bash tool inputs (reads/writes JSON via stdin/stdout)');
+  console.log('                     • Safety: Adds -i flag to rm commands');
+  console.log('                     • Aliases: ll → ls -lah, la → ls -la');
+  console.log('                     • Path correction: Redirects test files to /tmp');
+  console.log('                     • Secret detection: Warns about sensitive keywords');
+  console.log('');
+  console.log('  modify-file        Modify Write/Edit tool inputs (reads/writes JSON via stdin/stdout)');
+  console.log('                     • Root folder protection: Moves files to appropriate directories');
+  console.log('                     • Organization: Tests → /tests/, Sources → /src/, Docs → /docs/');
+  console.log('                     • Format hints: Suggests Prettier, Black, etc.');
+  console.log('');
+  console.log('  modify-git-commit  Modify git commit messages (reads/writes JSON via stdin/stdout)');
+  console.log('                     • Conventional commits: Auto-adds [feat], [fix], [docs], etc.');
+  console.log('                     • Ticket extraction: Extracts JIRA tickets from branch names');
+  console.log('                     • Co-author: Adds Claude Flow co-author footer');
+
   console.log('\nExamples:');
   console.log('  hooks pre-command --command "npm test" --validate-safety true');
   console.log('  hooks pre-edit --file "src/app.js" --auto-assign-agents true');
@@ -1202,12 +1506,18 @@ function showHooksHelp() {
   console.log('  hooks session-end --generate-summary true --export-metrics true');
   console.log('  hooks agent-spawned --name "CodeReviewer" --type "reviewer"');
   console.log('  hooks notify --message "Build completed" --level "success"');
+  console.log('');
+  console.log('  # New modification hooks (stdin/stdout JSON):');
+  console.log('  echo \'{"tool_input":{"command":"rm test.txt"}}\' | hooks modify-bash');
+  console.log('  echo \'{"tool_input":{"file_path":"test.js"}}\' | hooks modify-file');
+  console.log('  echo \'{"tool_input":{"command":"git commit -m \\"fix bug\\""}}\' | hooks modify-git-commit');
 
   console.log('\nCompatibility:');
   console.log('  • pre-command and pre-bash are aliases');
   console.log('  • post-command and post-bash are aliases');
   console.log('  • Both --dash-case and camelCase parameters supported');
   console.log('  • All parameters from settings.json template supported');
+  console.log('  • New modification hooks work with Claude Code v2.0.10+ PreToolUse feature');
 }
 
 export default hooksAction;

package/src/hooks/index.ts

@@ -14,11 +14,6 @@ export {
   initializeAgenticFlowHooks,
 } from '../services/agentic-flow-hooks/index.js';
 
-// Export SDK checkpoint manager for hooks
-export { checkpointManager } from '../sdk/checkpoint-manager.js';
-export { queryController } from '../sdk/query-control.js';
-export { sessionForking } from '../sdk/session-forking.js';
-
 // Re-export verification system
 export {
   verificationHookManager,