claude-flow 2.0.0-alpha.81 → 2.0.0-alpha.83

package/src/cli/simple-cli.js

@@ -27,7 +27,23 @@ import process from 'process';
 import readline from 'readline';
 import { getMainHelp, getCommandHelp, getStandardizedCommandHelp } from './help-text.js';
 
-const VERSION = '2.0.0-alpha.80';
+const VERSION = '2.0.0-alpha.83';
+
+// Legacy agent type mapping for backward compatibility
+const LEGACY_AGENT_MAPPING = {
+  analyst: 'code-analyzer',
+  coordinator: 'task-orchestrator', 
+  optimizer: 'perf-analyzer',
+  documenter: 'api-docs',
+  monitor: 'performance-benchmarker',
+  specialist: 'system-architect',
+  architect: 'system-architect',
+};
+
+// Resolve legacy agent types to current equivalents
+function resolveLegacyAgentType(legacyType) {
+  return LEGACY_AGENT_MAPPING[legacyType] || legacyType;
+}
 
 function printHelp(plain = false) {
   console.log(getMainHelp(plain));
@@ -50,7 +66,8 @@ function printLegacyHelp() {
   console.log(`
 🌊 Claude-Flow v${VERSION} - Enterprise-Grade AI Agent Orchestration Platform
 
-🎯 ENTERPRISE FEATURES: Complete ruv-swarm integration with 27 MCP tools, neural networking, and production-ready infrastructure
+🎯 ENTERPRISE FEATURES: Complete ruv-swarm integration with 90+ MCP tools, neural networking, and production-ready infrastructure
+⚡ ALPHA 83: Enhanced GitHub hooks with npx commands, improved checkpoint reliability, seamless CI/CD integration
 
 USAGE:
   claude-flow <command> [options]
@@ -330,12 +347,13 @@ async function main() {
 
     case 'spawn':
       // Convenience alias for agent spawn
-      const spawnType = subArgs[0] || 'general';
+      const rawSpawnType = subArgs[0] || 'general';
+      const spawnType = resolveLegacyAgentType(rawSpawnType);
       const spawnName = flags.name || `agent-${Date.now()}`;
 
       printSuccess(`Spawning ${spawnType} agent: ${spawnName}`);
       console.log('🤖 Agent would be created with the following configuration:');
-      console.log(`   Type: ${spawnType}`);
+      console.log(`   Type: ${spawnType}${rawSpawnType !== spawnType ? ` (resolved from: ${rawSpawnType})` : ''}`);
       console.log(`   Name: ${spawnName}`);
       console.log('   Capabilities: Research, Analysis, Code Generation');
       console.log('   Status: Ready');
@@ -2348,7 +2366,8 @@ Shortcuts:
     const subCmd = args[0];
     switch (subCmd) {
       case 'spawn':
-        const type = args[1] || 'researcher';
+        const rawType = args[1] || 'researcher';
+        const type = resolveLegacyAgentType(rawType);
         const name = args[2] || `agent-${Date.now()}`;
         const agent = {
           id: `agent-${Date.now()}`,

package/src/cli/simple-cli.ts

@@ -14,7 +14,7 @@ import {
 } from './command-registry.js';
 import { parseFlags } from './utils.js';
 
-const VERSION = '2.0.0-alpha.80';
+const VERSION = '2.0.0-alpha.83';
 
 function printHelp() {
   console.log(`

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

@@ -326,7 +326,7 @@ async function createGitHubSettingsJson() {
             },
             {
               type: 'command',
-              command: './.claude/helpers/github-checkpoint-hooks.sh pre-edit "{{tool_input}}"'
+              command: 'bash .claude/helpers/github-checkpoint-hooks.sh pre-edit "{{tool_input}}"'
             }
           ]
         }
@@ -350,7 +350,7 @@ async function createGitHubSettingsJson() {
             },
             {
               type: 'command',
-              command: './.claude/helpers/github-checkpoint-hooks.sh post-edit "{{tool_input}}"'
+              command: 'bash .claude/helpers/github-checkpoint-hooks.sh post-edit "{{tool_input}}"'
             }
           ]
         }
@@ -360,7 +360,7 @@ async function createGitHubSettingsJson() {
           hooks: [
             {
               type: 'command',
-              command: './.claude/helpers/github-checkpoint-hooks.sh task "{{user_prompt}}"'
+              command: 'bash .claude/helpers/github-checkpoint-hooks.sh task "{{user_prompt}}"'
             }
           ]
         }
@@ -374,7 +374,7 @@ async function createGitHubSettingsJson() {
             },
             {
               type: 'command',
-              command: './.claude/helpers/github-checkpoint-hooks.sh session-end'
+              command: 'bash .claude/helpers/github-checkpoint-hooks.sh session-end'
             }
           ]
         }

package/src/cli/simple-commands/init/templates/CLAUDE.md

@@ -458,14 +458,14 @@ If you need to do X operations, they should be in 1 message, not X messages
   mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 6 }
   mcp__claude-flow__agent_spawn { type: "researcher" }
   mcp__claude-flow__agent_spawn { type: "coder" }
-  mcp__claude-flow__agent_spawn { type: "analyst" }
+  mcp__claude-flow__agent_spawn { type: "code-analyzer" }
   mcp__claude-flow__agent_spawn { type: "tester" }
-  mcp__claude-flow__agent_spawn { type: "coordinator" }
+  mcp__claude-flow__agent_spawn { type: "task-orchestrator" }
 
   // Claude Code execution - ALL in parallel
   Task("You are researcher agent. MUST coordinate via hooks...")
   Task("You are coder agent. MUST coordinate via hooks...")
-  Task("You are analyst agent. MUST coordinate via hooks...")
+  Task("You are code-analyzer agent. MUST coordinate via hooks...")
   Task("You are tester agent. MUST coordinate via hooks...")
   TodoWrite { todos: [5-10 todos with all priorities and statuses] }
 
@@ -601,7 +601,7 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:
 - Tool: `mcp__claude-flow__agent_spawn`
 - Parameters: `{"type": "researcher", "name": "Literature Review"}`
 - Tool: `mcp__claude-flow__agent_spawn`
-- Parameters: `{"type": "analyst", "name": "Data Analysis"}`
+- Parameters: `{"type": "code-analyzer", "name": "Data Analysis"}`
 - Result: Different cognitive patterns for Claude Code to use
 
 **Step 3:** Coordinate research execution
@@ -634,7 +634,7 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:
 **Step 2:** Define development perspectives
 
 - Tool: `mcp__claude-flow__agent_spawn`
-- Parameters: `{"type": "architect", "name": "System Design"}`
+- Parameters: `{"type": "system-architect", "name": "System Design"}`
 - Result: Architectural thinking pattern for Claude Code
 
 **Step 3:** Coordinate implementation
@@ -802,9 +802,9 @@ See `.claude/commands/` for detailed documentation on all features.
    - Medium tasks (4-6 components): 5-7 agents
    - Complex tasks (7+ components): 8-12 agents
 3. **Agent Type Distribution**: Balance agent types based on task:
-   - Always include 1 coordinator
+   - Always include 1 task-orchestrator
    - For code-heavy tasks: more coders
-   - For design tasks: more architects/analysts
+   - For design tasks: more system-architects/code-analyzers
    - For quality tasks: more testers/reviewers
 
 **Example Auto-Decision Logic:**
@@ -896,15 +896,15 @@ Message 1: [BatchTool]
   - mcp__claude-flow__swarm_init
   - mcp__claude-flow__agent_spawn (researcher)
   - mcp__claude-flow__agent_spawn (coder)
-  - mcp__claude-flow__agent_spawn (analyst)
+  - mcp__claude-flow__agent_spawn (code-analyzer)
   - mcp__claude-flow__agent_spawn (tester)
-  - mcp__claude-flow__agent_spawn (coordinator)
+  - mcp__claude-flow__agent_spawn (task-orchestrator)
 
 Message 2: [BatchTool - Claude Code execution]
   // Task agents with full coordination instructions
   - Task("You are researcher agent. MANDATORY: Run hooks pre-task, post-edit, post-task. Task: Research API patterns")
   - Task("You are coder agent. MANDATORY: Run hooks pre-task, post-edit, post-task. Task: Implement REST endpoints")
-  - Task("You are analyst agent. MANDATORY: Run hooks pre-task, post-edit, post-task. Task: Analyze performance")
+  - Task("You are code-analyzer agent. MANDATORY: Run hooks pre-task, post-edit, post-task. Task: Analyze performance")
   - Task("You are tester agent. MANDATORY: Run hooks pre-task, post-edit, post-task. Task: Write comprehensive tests")
 
   // TodoWrite with ALL todos batched
@@ -940,13 +940,13 @@ STEP 1: IMMEDIATE PARALLEL SPAWN (Single Message!)
 
   // Spawn agents based on maxAgents count and task requirements
   // If CLI specifies 3 agents, spawn 3. If no args, auto-decide optimal count (3-12)
-  - mcp__claude-flow__agent_spawn { type: "architect", name: "System Designer" }
+  - mcp__claude-flow__agent_spawn { type: "system-architect", name: "System Designer" }
   - mcp__claude-flow__agent_spawn { type: "coder", name: "API Developer" }
   - mcp__claude-flow__agent_spawn { type: "coder", name: "Frontend Dev" }
-  - mcp__claude-flow__agent_spawn { type: "analyst", name: "DB Designer" }
+  - mcp__claude-flow__agent_spawn { type: "code-analyzer", name: "DB Designer" }
   - mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
   - mcp__claude-flow__agent_spawn { type: "researcher", name: "Tech Lead" }
-  - mcp__claude-flow__agent_spawn { type: "coordinator", name: "PM" }
+  - mcp__claude-flow__agent_spawn { type: "task-orchestrator", name: "PM" }
   - TodoWrite { todos: [multiple todos at once] }
 
 STEP 2: PARALLEL TASK EXECUTION (Single Message!)
@@ -998,12 +998,12 @@ Dependencies: ↳ X deps | Actionable: ▶
 [BatchTool - Message 1]:
   // Initialize and spawn ALL agents at once
   mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 8, strategy: "parallel" }
-  mcp__claude-flow__agent_spawn { type: "architect", name: "System Designer" }
+  mcp__claude-flow__agent_spawn { type: "system-architect", name: "System Designer" }
   mcp__claude-flow__agent_spawn { type: "coder", name: "API Developer" }
   mcp__claude-flow__agent_spawn { type: "coder", name: "Auth Expert" }
-  mcp__claude-flow__agent_spawn { type: "analyst", name: "DB Designer" }
+  mcp__claude-flow__agent_spawn { type: "code-analyzer", name: "DB Designer" }
   mcp__claude-flow__agent_spawn { type: "tester", name: "Test Engineer" }
-  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Lead" }
+  mcp__claude-flow__agent_spawn { type: "task-orchestrator", name: "Lead" }
 
   // Update ALL todos at once - NEVER split todos!
   TodoWrite { todos: [
@@ -1109,12 +1109,12 @@ When showing swarm status, use this format:
 └── 🧠 Memory: 15 coordination points stored
 
 Agent Activity:
-├── 🟢 architect: Designing database schema...
+├── 🟢 system-architect: Designing database schema...
 ├── 🟢 coder-1: Implementing auth endpoints...
 ├── 🟢 coder-2: Building user CRUD operations...
-├── 🟢 analyst: Optimizing query performance...
+├── 🟢 code-analyzer: Optimizing query performance...
 ├── 🟡 tester: Waiting for auth completion...
-└── 🟢 coordinator: Monitoring progress...
+└── 🟢 task-orchestrator: Monitoring progress...
 ```
 
 ## 📝 CRITICAL: TODOWRITE AND TASK TOOL BATCHING

package/src/cli/simple-commands/process-ui-enhanced.js

@@ -1,4 +1,4 @@
-// process-ui-enhanced.js - Enhanced process management UI with multiple views - v2.0.0-alpha.80
+// process-ui-enhanced.js - Enhanced process management UI with multiple views - v2.0.0-alpha.83
 import { printSuccess, printError, printWarning, printInfo } from '../utils.js';
 import { compat } from '../runtime-detector.js';
 import SwarmWebUIIntegration from './swarm-webui-integration.js';

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

@@ -19,7 +19,7 @@ export async function statusCommand(subArgs, flags) {
 async function getSystemStatus(verbose = false) {
   const status = {
     timestamp: Date.now(),
-    version: '2.0.0-alpha.80',
+    version: '2.0.0-alpha.83',
     orchestrator: {
       running: false,
       uptime: 0,

package/src/constants/agent-types.ts

@@ -3,21 +3,18 @@
  * This file provides type-safe access to dynamically loaded agent definitions
  */
 
-import { getAvailableAgentTypes, isValidAgentType as validateAgentType } from '../agents/agent-loader.js';
+import { 
+  getAvailableAgentTypes, 
+  isValidAgentType as validateAgentType,
+  resolveLegacyAgentType as resolveLegacy,
+  LEGACY_AGENT_MAPPING as LEGACY_MAPPING
+} from '../agents/agent-loader.js';
 
 // Dynamic agent type - will be a string that matches available agents
 export type AgentType = string;
 
-// Legacy agent type mapping for backward compatibility
-export const LEGACY_AGENT_MAPPING = {
-  analyst: 'code-analyzer',
-  coordinator: 'task-orchestrator', 
-  optimizer: 'perf-analyzer',
-  documenter: 'api-docs',
-  monitor: 'performance-benchmarker',
-  specialist: 'system-architect',
-  architect: 'system-architect',
-} as const;
+// Re-export legacy mapping from agent-loader
+export const LEGACY_AGENT_MAPPING = LEGACY_MAPPING;
 
 /**
  * Get all valid agent types dynamically
@@ -36,10 +33,7 @@ export async function isValidAgentType(type: string): Promise<boolean> {
 /**
  * Resolve legacy agent types to current equivalents
  */
-export function resolveLegacyAgentType(legacyType: string): string {
-  const mapped = LEGACY_AGENT_MAPPING[legacyType as keyof typeof LEGACY_AGENT_MAPPING];
-  return mapped || legacyType;
-}
+export const resolveLegacyAgentType = resolveLegacy;
 
 /**
  * Create JSON Schema for agent type validation (async)

package/.claude/checkpoints/1753906298.json

@@ -1,12 +0,0 @@
-{
-  "tag": "checkpoint-20250730-201138",
-  "file": "demo.txt",
-  "timestamp": "2025-07-30T20:11:38Z",
-  "type": "post-edit",
-  "branch": "alpha-80",
-  "diff_summary": " .gitignore       |  1 +
- README.md        | 20 ++++++++++++++++++++
- claude-flow-wiki |  0
- demo.txt         |  1 +
- 4 files changed, 22 insertions(+)"
-}