claude-flow 3.1.0-alpha.13 → 3.1.0-alpha.14

package/.claude/helpers/statusline.cjs

@@ -24,7 +24,7 @@ const CONFIG = {
   showPerformance: true,
   refreshInterval: 5000,
   maxAgents: 15,
-  topology: 'hierarchical',
+  topology: 'hierarchical-mesh',
 };
 
 // ANSI colors
@@ -178,52 +178,50 @@ function getLearningStats() {
   return { patterns, sessions, trajectories };
 }
 
-// Get V3 progress from learning state (grows as system learns)
+// Get V3 progress from REAL metrics files
 function getV3Progress() {
   const learning = getLearningStats();
+  const totalDomains = 5;
+
+  let dddProgress = 0;
+  let dddScore = 0;
+  let dddMaxScore = 100;
+  let moduleCount = 0;
 
-  // Check for metrics file first (created by init)
-  const metricsPath = path.join(process.cwd(), '.claude-flow', 'metrics', 'v3-progress.json');
-  if (fs.existsSync(metricsPath)) {
+  // Check ddd-progress.json for REAL DDD analysis
+  const dddPath = path.join(process.cwd(), '.claude-flow', 'metrics', 'ddd-progress.json');
+  if (fs.existsSync(dddPath)) {
     try {
-      const data = JSON.parse(fs.readFileSync(metricsPath, 'utf-8'));
-      if (data.domains) {
-        const domainsCompleted = data.domains.completed || 0;
-        const totalDomains = data.domains.total || 5;
-        // Use ddd.progress if provided and > 0, otherwise calculate from domains
-        const dddProgress = (data.ddd?.progress > 0)
-          ? data.ddd.progress
-          : Math.min(100, Math.floor((domainsCompleted / totalDomains) * 100));
-        return {
-          domainsCompleted,
-          totalDomains,
-          dddProgress,
-          patternsLearned: data.learning?.patternsLearned || learning.patterns,
-          sessionsCompleted: data.learning?.sessionsCompleted || learning.sessions
-        };
-      }
+      const data = JSON.parse(fs.readFileSync(dddPath, 'utf-8'));
+      dddProgress = data.progress || 0;
+      dddScore = data.score || 0;
+      dddMaxScore = data.maxScore || 100;
+      moduleCount = data.modules ? Object.keys(data.modules).length : 0;
     } catch (e) {
-      // Fall through to pattern-based calculation
+      // Ignore - use fallback
     }
   }
 
-  // DDD progress based on actual learned patterns
-  // New install: 0 patterns = 0/5 domains, 0% DDD
-  // As patterns grow: 10+ patterns = 1 domain, 50+ = 2, 100+ = 3, 200+ = 4, 500+ = 5
-  let domainsCompleted = 0;
-  if (learning.patterns >= 500) domainsCompleted = 5;
-  else if (learning.patterns >= 200) domainsCompleted = 4;
-  else if (learning.patterns >= 100) domainsCompleted = 3;
-  else if (learning.patterns >= 50) domainsCompleted = 2;
-  else if (learning.patterns >= 10) domainsCompleted = 1;
-
-  const totalDomains = 5;
-  const dddProgress = Math.min(100, Math.floor((domainsCompleted / totalDomains) * 100));
+  // Calculate domains completed from DDD progress (each 20% = 1 domain)
+  let domainsCompleted = Math.min(5, Math.floor(dddProgress / 20));
+
+  // Fallback: if no DDD data, use pattern-based calculation
+  if (dddProgress === 0 && learning.patterns > 0) {
+    if (learning.patterns >= 500) domainsCompleted = 5;
+    else if (learning.patterns >= 200) domainsCompleted = 4;
+    else if (learning.patterns >= 100) domainsCompleted = 3;
+    else if (learning.patterns >= 50) domainsCompleted = 2;
+    else if (learning.patterns >= 10) domainsCompleted = 1;
+    dddProgress = Math.floor((domainsCompleted / totalDomains) * 100);
+  }
 
   return {
     domainsCompleted,
     totalDomains,
     dddProgress,
+    dddScore,
+    dddMaxScore,
+    moduleCount,
     patternsLearned: learning.patterns,
     sessionsCompleted: learning.sessions
   };
@@ -358,15 +356,16 @@ function getSystemMetrics() {
   let memoryMB = 0;
   let subAgents = 0;
 
-  // Check learning.json first (works on all platforms)
+  // Check learning.json first for REAL intelligence metrics
   const learningMetricsPath = path.join(process.cwd(), '.claude-flow', 'metrics', 'learning.json');
   let intelligenceFromFile = null;
   let contextFromFile = null;
   if (fs.existsSync(learningMetricsPath)) {
     try {
       const data = JSON.parse(fs.readFileSync(learningMetricsPath, 'utf-8'));
-      if (data.routing?.accuracy !== undefined) {
-        intelligenceFromFile = Math.min(100, Math.floor(data.routing.accuracy));
+      // Use intelligence.score (the REAL metric) instead of routing.accuracy
+      if (data.intelligence?.score !== undefined) {
+        intelligenceFromFile = Math.min(100, Math.floor(data.intelligence.score));
       }
       if (data.sessions?.total !== undefined) {
         contextFromFile = Math.min(100, data.sessions.total * 5);
@@ -517,8 +516,29 @@ function getSystemMetrics() {
   };
 }
 
-// Get ADR (Architecture Decision Records) status
+// Get ADR (Architecture Decision Records) status from REAL compliance data
 function getADRStatus() {
+  let compliance = 0;
+  let totalChecks = 0;
+  let compliantChecks = 0;
+  let checks = {};
+
+  // Check adr-compliance.json for REAL compliance data
+  const compliancePath = path.join(process.cwd(), '.claude-flow', 'metrics', 'adr-compliance.json');
+  if (fs.existsSync(compliancePath)) {
+    try {
+      const data = JSON.parse(fs.readFileSync(compliancePath, 'utf-8'));
+      compliance = data.compliance || 0;
+      checks = data.checks || {};
+      totalChecks = Object.keys(checks).length;
+      compliantChecks = Object.values(checks).filter(c => c.compliant).length;
+      return { count: totalChecks, implemented: compliantChecks, compliance };
+    } catch (e) {
+      // Fall through to file-based detection
+    }
+  }
+
+  // Fallback: count ADR files directly
   const adrPaths = [
     path.join(process.cwd(), 'docs', 'adrs'),
     path.join(process.cwd(), 'docs', 'adr'),
@@ -540,7 +560,6 @@ function getADRStatus() {
         );
         count = files.length;
 
-        // Check for implemented status in ADR files
         for (const file of files) {
           try {
             const content = fs.readFileSync(path.join(adrPath, file), 'utf-8');
@@ -559,7 +578,8 @@ function getADRStatus() {
     }
   }
 
-  return { count, implemented };
+  compliance = count > 0 ? Math.floor((implemented / count) * 100) : 0;
+  return { count, implemented, compliance };
 }
 
 // Get hooks status (enabled/registered hooks)
@@ -1096,9 +1116,14 @@ function generateStatusline() {
   const vectorColor = agentdb.vectorCount > 0 ? c.brightGreen : c.dim;
   const testColor = tests.testFiles > 0 ? c.brightGreen : c.dim;
 
+  // Show ADR compliance % if from real data, otherwise show count
+  const adrDisplay = adrs.compliance > 0
+    ? `${adrColor}●${adrs.compliance}%${c.reset}`
+    : `${adrColor}●${adrs.implemented}/${adrs.count}${c.reset}`;
+
   lines.push(
     `${c.brightPurple}🔧 Architecture${c.reset}    ` +
-    `${c.cyan}ADRs${c.reset} ${adrColor}●${adrs.implemented}/${adrs.count}${c.reset}  ${c.dim}│${c.reset}  ` +
+    `${c.cyan}ADRs${c.reset} ${adrDisplay}  ${c.dim}│${c.reset}  ` +
     `${c.cyan}DDD${c.reset} ${dddColor}●${String(progress.dddProgress).padStart(3)}%${c.reset}  ${c.dim}│${c.reset}  ` +
     `${c.cyan}Security${c.reset} ${securityColor}●${security.status}${c.reset}`
   );

package/.claude/settings.json

@@ -32,7 +32,8 @@
     "CLAUDE_FLOW_CHECKPOINTS_ENABLED": "true",
     "CLAUDE_FLOW_V3_CLI_ENABLED": "true",
     "CLAUDE_FLOW_V3_CLI_PATH": "/workspaces/claude-flow/v3/@claude-flow/cli/bin/cli.js",
-    "CLAUDE_FLOW_V3_INTELLIGENCE": "true"
+    "CLAUDE_FLOW_V3_INTELLIGENCE": "true",
+    "CLAUDE_FLOW_V3_ENABLED": "true"
   },
   "permissions": {
     "allowedTools": [
@@ -173,12 +174,12 @@
             "timeout": 4000,
             "command": "/workspaces/claude-flow/.claude/helpers/learning-hooks.sh store \"Edit: $TOOL_INPUT_file_path\" code 0.7 2>/dev/null || true"
           },
-                    {
+          {
             "type": "command",
             "timeout": 4000,
             "command": "node /workspaces/claude-flow/v3/@claude-flow/cli/bin/cli.js hooks post-edit --file \"$TOOL_INPUT_file_path\" --success true --train-patterns true --memory-key \"edit/$TOOL_INPUT_file_path\" 2>/dev/null || true"
           },
-                    {
+          {
             "type": "command",
             "timeout": 10000,
             "command": "/workspaces/claude-flow/.claude/helpers/auto-commit.sh batch 'Checkpoint: File edits' 2>/dev/null || true"
@@ -510,7 +511,13 @@
   "v3Configuration": {
     "domains": {
       "total": 5,
-      "names": ["task-management", "session-management", "health-monitoring", "lifecycle-management", "event-coordination"],
+      "names": [
+        "task-management",
+        "session-management",
+        "health-monitoring",
+        "lifecycle-management",
+        "event-coordination"
+      ],
       "sourceDir": "src/domains"
     },
     "swarm": {
@@ -567,5 +574,36 @@
     "commit": "Co-Authored-By: claude-flow <ruv@ruv.net>",
     "pr": "🤖 Generated with [claude-flow](https://github.com/ruvnet/claude-flow)"
   },
-  "enabledMcpjsonServers": ["claude-flow", "ruv-swarm"]
-}
+  "enabledMcpjsonServers": [
+    "claude-flow",
+    "ruv-swarm"
+  ],
+  "claudeFlow": {
+    "version": "3.0.0",
+    "enabled": true,
+    "agentTeams": {
+      "enabled": true,
+      "teammateMode": "auto",
+      "taskListEnabled": true,
+      "mailboxEnabled": true,
+      "coordination": {
+        "autoAssignOnIdle": true,
+        "trainPatternsOnComplete": true,
+        "notifyLeadOnComplete": true,
+        "sharedMemoryNamespace": "agent-teams"
+      },
+      "hooks": {
+        "teammateIdle": {
+          "enabled": true,
+          "autoAssign": true,
+          "checkTaskList": true
+        },
+        "taskCompleted": {
+          "enabled": true,
+          "trainPatterns": true,
+          "notifyLead": true
+        }
+      }
+    }
+  }
+}

package/README.md

@@ -489,8 +489,8 @@ bunx claude-flow@alpha init
 
 | Profile | Size | Use Case |
 |---------|------|----------|
-| `--omit=optional` | ~340MB | Core features only |
-| Default | ~340MB | Standard install |
+| `--omit=optional` | ~45MB | Core CLI only (fastest) |
+| Default | ~340MB | Full install with ML/embeddings |
 
 ```bash
 # Minimal install (skip ML/embeddings)
@@ -1515,6 +1515,76 @@ npx claude-flow hive-mind sessions                # List active sessions
 
 </details>
 
+<details>
+<summary>👥 <strong>Agent Teams</strong> — Claude Code multi-instance coordination</summary>
+
+Native integration with Claude Code's experimental Agent Teams feature for spawning and coordinating multiple Claude instances.
+
+**Enable Agent Teams:**
+```bash
+# Automatically enabled with claude-flow init
+npx claude-flow@latest init
+
+# Or manually add to .claude/settings.json
+{
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
+  }
+}
+```
+
+**Agent Teams Components:**
+
+| Component | Tool | Purpose |
+|-----------|------|---------|
+| **Team Lead** | Main Claude | Coordinates teammates, assigns tasks, reviews results |
+| **Teammates** | `Task` tool | Sub-agents spawned to work on specific tasks |
+| **Task List** | `TaskCreate/TaskList/TaskUpdate` | Shared todos visible to all team members |
+| **Mailbox** | `SendMessage` | Inter-agent messaging for coordination |
+
+**Quick Start:**
+```javascript
+// Create a team
+TeamCreate({ team_name: "feature-dev", description: "Building feature" })
+
+// Create shared tasks
+TaskCreate({ subject: "Design API", description: "..." })
+TaskCreate({ subject: "Implement endpoints", description: "..." })
+
+// Spawn teammates (parallel background work)
+Task({ prompt: "Work on task #1...", subagent_type: "architect",
+       team_name: "feature-dev", name: "architect", run_in_background: true })
+Task({ prompt: "Work on task #2...", subagent_type: "coder",
+       team_name: "feature-dev", name: "developer", run_in_background: true })
+
+// Message teammates
+SendMessage({ type: "message", recipient: "developer",
+              content: "Prioritize auth", summary: "Priority update" })
+
+// Cleanup when done
+SendMessage({ type: "shutdown_request", recipient: "developer" })
+TeamDelete()
+```
+
+**Agent Teams Hooks:**
+
+| Hook | Trigger | Purpose |
+|------|---------|---------|
+| `teammate-idle` | Teammate finishes turn | Auto-assign pending tasks |
+| `task-completed` | Task marked complete | Train patterns, notify lead |
+
+```bash
+# Handle idle teammate
+npx claude-flow@latest hooks teammate-idle --auto-assign true
+
+# Handle task completion
+npx claude-flow@latest hooks task-completed --task-id <id> --train-patterns
+```
+
+**Display Modes:** `auto` (default), `in-process`, `tmux` (split-pane)
+
+</details>
+
 <details>
 <summary>🔧 <strong>MCP Tools & Integration</strong> — 31+ tools across 7 categories</summary>
 
@@ -1527,7 +1597,7 @@ Full MCP server with tools for coordination, monitoring, memory, and GitHub inte
 | **Memory & Neural** | `memory_usage`, `neural_status`, `neural_train`, `neural_patterns` | Memory operations and learning |
 | **GitHub** | `github_swarm`, `repo_analyze`, `pr_enhance`, `issue_triage`, `code_review` | Repository integration |
 | **Workers** | `worker/run`, `worker/status`, `worker/alerts`, `worker/history` | Background task management |
-| **Hooks** | `hooks/pre-*`, `hooks/post-*`, `hooks/route`, `hooks/session-*`, `hooks/intelligence/*` | 31 lifecycle hooks |
+| **Hooks** | `hooks/pre-*`, `hooks/post-*`, `hooks/route`, `hooks/session-*`, `hooks/teammate-*`, `hooks/task-*` | 33 lifecycle hooks |
 | **Progress** | `progress/check`, `progress/sync`, `progress/summary`, `progress/watch` | V3 implementation tracking |
 
 </details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.1.0-alpha.13",
+  "version": "3.1.0-alpha.14",
   "description": "Enterprise AI agent orchestration for Claude Code - Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
   "main": "dist/index.js",
   "type": "module",

package/v3/@claude-flow/cli/README.md

@@ -489,8 +489,8 @@ bunx claude-flow@alpha init
 
 | Profile | Size | Use Case |
 |---------|------|----------|
-| `--omit=optional` | ~340MB | Core features only |
-| Default | ~340MB | Standard install |
+| `--omit=optional` | ~45MB | Core CLI only (fastest) |
+| Default | ~340MB | Full install with ML/embeddings |
 
 ```bash
 # Minimal install (skip ML/embeddings)
@@ -1515,6 +1515,76 @@ npx claude-flow hive-mind sessions                # List active sessions
 
 </details>
 
+<details>
+<summary>👥 <strong>Agent Teams</strong> — Claude Code multi-instance coordination</summary>
+
+Native integration with Claude Code's experimental Agent Teams feature for spawning and coordinating multiple Claude instances.
+
+**Enable Agent Teams:**
+```bash
+# Automatically enabled with claude-flow init
+npx claude-flow@latest init
+
+# Or manually add to .claude/settings.json
+{
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
+  }
+}
+```
+
+**Agent Teams Components:**
+
+| Component | Tool | Purpose |
+|-----------|------|---------|
+| **Team Lead** | Main Claude | Coordinates teammates, assigns tasks, reviews results |
+| **Teammates** | `Task` tool | Sub-agents spawned to work on specific tasks |
+| **Task List** | `TaskCreate/TaskList/TaskUpdate` | Shared todos visible to all team members |
+| **Mailbox** | `SendMessage` | Inter-agent messaging for coordination |
+
+**Quick Start:**
+```javascript
+// Create a team
+TeamCreate({ team_name: "feature-dev", description: "Building feature" })
+
+// Create shared tasks
+TaskCreate({ subject: "Design API", description: "..." })
+TaskCreate({ subject: "Implement endpoints", description: "..." })
+
+// Spawn teammates (parallel background work)
+Task({ prompt: "Work on task #1...", subagent_type: "architect",
+       team_name: "feature-dev", name: "architect", run_in_background: true })
+Task({ prompt: "Work on task #2...", subagent_type: "coder",
+       team_name: "feature-dev", name: "developer", run_in_background: true })
+
+// Message teammates
+SendMessage({ type: "message", recipient: "developer",
+              content: "Prioritize auth", summary: "Priority update" })
+
+// Cleanup when done
+SendMessage({ type: "shutdown_request", recipient: "developer" })
+TeamDelete()
+```
+
+**Agent Teams Hooks:**
+
+| Hook | Trigger | Purpose |
+|------|---------|---------|
+| `teammate-idle` | Teammate finishes turn | Auto-assign pending tasks |
+| `task-completed` | Task marked complete | Train patterns, notify lead |
+
+```bash
+# Handle idle teammate
+npx claude-flow@latest hooks teammate-idle --auto-assign true
+
+# Handle task completion
+npx claude-flow@latest hooks task-completed --task-id <id> --train-patterns
+```
+
+**Display Modes:** `auto` (default), `in-process`, `tmux` (split-pane)
+
+</details>
+
 <details>
 <summary>🔧 <strong>MCP Tools & Integration</strong> — 31+ tools across 7 categories</summary>
 
@@ -1527,7 +1597,7 @@ Full MCP server with tools for coordination, monitoring, memory, and GitHub inte
 | **Memory & Neural** | `memory_usage`, `neural_status`, `neural_train`, `neural_patterns` | Memory operations and learning |
 | **GitHub** | `github_swarm`, `repo_analyze`, `pr_enhance`, `issue_triage`, `code_review` | Repository integration |
 | **Workers** | `worker/run`, `worker/status`, `worker/alerts`, `worker/history` | Background task management |
-| **Hooks** | `hooks/pre-*`, `hooks/post-*`, `hooks/route`, `hooks/session-*`, `hooks/intelligence/*` | 31 lifecycle hooks |
+| **Hooks** | `hooks/pre-*`, `hooks/post-*`, `hooks/route`, `hooks/session-*`, `hooks/teammate-*`, `hooks/task-*` | 33 lifecycle hooks |
 | **Progress** | `progress/check`, `progress/sync`, `progress/summary`, `progress/watch` | V3 implementation tracking |
 
 </details>

package/v3/@claude-flow/cli/dist/src/commands/init.js

@@ -736,24 +736,41 @@ const upgradeCommand = {
             type: 'boolean',
             default: false,
         },
+        {
+            name: 'settings',
+            short: 's',
+            description: 'Merge new settings (Agent Teams, hooks) into existing settings.json',
+            type: 'boolean',
+            default: false,
+        },
     ],
     action: async (ctx) => {
         const addMissing = (ctx.flags['add-missing'] || ctx.flags.addMissing);
+        const upgradeSettings = (ctx.flags.settings);
         output.writeln();
         output.writeln(output.bold('Upgrading Claude Flow'));
-        if (addMissing) {
+        if (addMissing && upgradeSettings) {
+            output.writeln(output.dim('Updates helpers, settings, and adds any missing skills/agents/commands'));
+        }
+        else if (addMissing) {
             output.writeln(output.dim('Updates helpers and adds any missing skills/agents/commands'));
         }
+        else if (upgradeSettings) {
+            output.writeln(output.dim('Updates helpers and merges new settings (Agent Teams, hooks)'));
+        }
         else {
             output.writeln(output.dim('Updates helpers while preserving your existing data'));
         }
         output.writeln();
-        const spinner = output.createSpinner({ text: addMissing ? 'Upgrading and adding missing assets...' : 'Upgrading...' });
+        const spinnerText = upgradeSettings
+            ? 'Upgrading helpers and settings...'
+            : (addMissing ? 'Upgrading and adding missing assets...' : 'Upgrading...');
+        const spinner = output.createSpinner({ text: spinnerText });
         spinner.start();
         try {
             const result = addMissing
-                ? await executeUpgradeWithMissing(ctx.cwd)
-                : await executeUpgrade(ctx.cwd);
+                ? await executeUpgradeWithMissing(ctx.cwd, upgradeSettings)
+                : await executeUpgrade(ctx.cwd, upgradeSettings);
             if (!result.success) {
                 spinner.fail('Upgrade failed');
                 for (const error of result.errors) {
@@ -795,8 +812,17 @@ const upgradeCommand = {
                 output.printBox(result.addedCommands.map(c => `+ ${c}`).join('\n'), `Added Commands (${result.addedCommands.length} new)`);
                 output.writeln();
             }
+            // Show settings updates
+            if (result.settingsUpdated && result.settingsUpdated.length > 0) {
+                output.printBox(result.settingsUpdated.map(s => `+ ${s}`).join('\n'), 'Settings Updated');
+                output.writeln();
+            }
             output.printSuccess('Your statusline helper has been updated to the latest version');
             output.printInfo('Existing metrics and learning data were preserved');
+            // Show settings summary
+            if (upgradeSettings && result.settingsUpdated && result.settingsUpdated.length > 0) {
+                output.printSuccess('Settings.json updated with new Agent Teams configuration');
+            }
             // Show summary for --add-missing
             if (addMissing) {
                 const totalAdded = (result.addedSkills?.length || 0) + (result.addedAgents?.length || 0) + (result.addedCommands?.length || 0);
@@ -910,6 +936,7 @@ export const initCommand = {
         { command: 'claude-flow init skills --all', description: 'Install all available skills' },
         { command: 'claude-flow init hooks --minimal', description: 'Create minimal hooks configuration' },
         { command: 'claude-flow init upgrade', description: 'Update helpers while preserving data' },
+        { command: 'claude-flow init upgrade --settings', description: 'Update helpers and merge new settings (Agent Teams)' },
         { command: 'claude-flow init upgrade --verbose', description: 'Show detailed upgrade info' },
         { command: 'claude-flow init --codex', description: 'Initialize for OpenAI Codex (AGENTS.md)' },
         { command: 'claude-flow init --codex --full', description: 'Codex init with all 137+ skills' },

package/v3/@claude-flow/cli/dist/src/init/executor.d.ts

@@ -20,16 +20,22 @@ export interface UpgradeResult {
     addedSkills?: string[];
     addedAgents?: string[];
     addedCommands?: string[];
+    /** Added by --settings flag */
+    settingsUpdated?: string[];
 }
 /**
  * Execute upgrade - updates helpers and creates missing metrics without losing data
  * This is safe for existing users who want the latest statusline fixes
+ * @param targetDir - Target directory
+ * @param upgradeSettings - If true, merge new settings into existing settings.json
  */
-export declare function executeUpgrade(targetDir: string): Promise<UpgradeResult>;
+export declare function executeUpgrade(targetDir: string, upgradeSettings?: boolean): Promise<UpgradeResult>;
 /**
  * Execute upgrade with --add-missing flag
  * Adds any new skills, agents, and commands that don't exist yet
+ * @param targetDir - Target directory
+ * @param upgradeSettings - If true, merge new settings into existing settings.json
  */
-export declare function executeUpgradeWithMissing(targetDir: string): Promise<UpgradeResult>;
+export declare function executeUpgradeWithMissing(targetDir: string, upgradeSettings?: boolean): Promise<UpgradeResult>;
 export default executeInit;
 //# sourceMappingURL=executor.d.ts.map

package/v3/@claude-flow/cli/dist/src/init/executor.js

@@ -10,7 +10,7 @@ import { dirname } from 'path';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 import { detectPlatform, DEFAULT_INIT_OPTIONS } from './types.js';
-import { generateSettingsJson } from './settings-generator.js';
+import { generateSettingsJson, generateSettings } from './settings-generator.js';
 import { generateMCPJson } from './mcp-generator.js';
 import { generateStatuslineScript, generateStatuslineHook } from './statusline-generator.js';
 import { generatePreCommitHook, generatePostCommitHook, generateSessionManager, generateAgentRouter, generateMemoryHelper, } from './helpers-generator.js';
@@ -204,17 +204,104 @@ export async function executeInit(options) {
     }
     return result;
 }
+/**
+ * Merge new settings into existing settings.json
+ * Preserves user customizations while adding new features like Agent Teams
+ * Uses platform-specific commands for Mac, Linux, and Windows
+ */
+function mergeSettingsForUpgrade(existing) {
+    const merged = { ...existing };
+    const platform = detectPlatform();
+    const isWindows = platform.os === 'windows';
+    // Platform-specific command wrappers
+    // Windows: Use PowerShell-compatible commands
+    // Mac/Linux: Use bash-compatible commands with 2>/dev/null
+    const teammateIdleCmd = isWindows
+        ? 'npx @claude-flow/cli@latest hooks teammate-idle --auto-assign true 2>$null; exit 0'
+        : 'npx @claude-flow/cli@latest hooks teammate-idle --auto-assign true 2>/dev/null || true';
+    const taskCompletedCmd = isWindows
+        ? 'if ($env:TASK_ID) { npx @claude-flow/cli@latest hooks task-completed --task-id $env:TASK_ID --train-patterns true 2>$null }; exit 0'
+        : '[ -n "$TASK_ID" ] && npx @claude-flow/cli@latest hooks task-completed --task-id "$TASK_ID" --train-patterns true 2>/dev/null || true';
+    // 1. Merge env vars (preserve existing, add new)
+    const existingEnv = existing.env || {};
+    merged.env = {
+        ...existingEnv,
+        CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: '1',
+        CLAUDE_FLOW_V3_ENABLED: existingEnv.CLAUDE_FLOW_V3_ENABLED || 'true',
+        CLAUDE_FLOW_HOOKS_ENABLED: existingEnv.CLAUDE_FLOW_HOOKS_ENABLED || 'true',
+    };
+    // 2. Merge hooks (preserve existing, add new Agent Teams hooks)
+    const existingHooks = existing.hooks || {};
+    merged.hooks = { ...existingHooks };
+    // Add TeammateIdle hook if not present
+    if (!existingHooks.TeammateIdle) {
+        merged.hooks.TeammateIdle = [
+            {
+                hooks: [
+                    {
+                        type: 'command',
+                        command: teammateIdleCmd,
+                        timeout: 5000,
+                        continueOnError: true,
+                    },
+                ],
+            },
+        ];
+    }
+    // Add TaskCompleted hook if not present
+    if (!existingHooks.TaskCompleted) {
+        merged.hooks.TaskCompleted = [
+            {
+                hooks: [
+                    {
+                        type: 'command',
+                        command: taskCompletedCmd,
+                        timeout: 5000,
+                        continueOnError: true,
+                    },
+                ],
+            },
+        ];
+    }
+    // 3. Merge claudeFlow settings (preserve existing, add agentTeams)
+    const existingClaudeFlow = existing.claudeFlow || {};
+    merged.claudeFlow = {
+        ...existingClaudeFlow,
+        version: existingClaudeFlow.version || '3.0.0',
+        enabled: existingClaudeFlow.enabled !== false,
+        agentTeams: {
+            enabled: true,
+            teammateMode: 'auto',
+            taskListEnabled: true,
+            mailboxEnabled: true,
+            coordination: {
+                autoAssignOnIdle: true,
+                trainPatternsOnComplete: true,
+                notifyLeadOnComplete: true,
+                sharedMemoryNamespace: 'agent-teams',
+            },
+            hooks: {
+                teammateIdle: { enabled: true, autoAssign: true, checkTaskList: true },
+                taskCompleted: { enabled: true, trainPatterns: true, notifyLead: true },
+            },
+        },
+    };
+    return merged;
+}
 /**
  * Execute upgrade - updates helpers and creates missing metrics without losing data
  * This is safe for existing users who want the latest statusline fixes
+ * @param targetDir - Target directory
+ * @param upgradeSettings - If true, merge new settings into existing settings.json
  */
-export async function executeUpgrade(targetDir) {
+export async function executeUpgrade(targetDir, upgradeSettings = false) {
     const result = {
         success: true,
         updated: [],
         created: [],
         preserved: [],
         errors: [],
+        settingsUpdated: [],
     };
     try {
         // Ensure required directories exist
@@ -320,6 +407,34 @@ export async function executeUpgrade(targetDir) {
         else {
             result.preserved.push('.claude-flow/security/audit-status.json');
         }
+        // 3. Merge settings if requested
+        if (upgradeSettings) {
+            const settingsPath = path.join(targetDir, '.claude', 'settings.json');
+            if (fs.existsSync(settingsPath)) {
+                try {
+                    const existingSettings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+                    const mergedSettings = mergeSettingsForUpgrade(existingSettings);
+                    fs.writeFileSync(settingsPath, JSON.stringify(mergedSettings, null, 2), 'utf-8');
+                    result.updated.push('.claude/settings.json');
+                    result.settingsUpdated = [
+                        'env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS',
+                        'hooks.TeammateIdle',
+                        'hooks.TaskCompleted',
+                        'claudeFlow.agentTeams',
+                    ];
+                }
+                catch (settingsError) {
+                    result.errors.push(`Settings merge failed: ${settingsError instanceof Error ? settingsError.message : String(settingsError)}`);
+                }
+            }
+            else {
+                // Create new settings.json with defaults
+                const defaultSettings = generateSettings(DEFAULT_INIT_OPTIONS);
+                fs.writeFileSync(settingsPath, JSON.stringify(defaultSettings, null, 2), 'utf-8');
+                result.created.push('.claude/settings.json');
+                result.settingsUpdated = ['Created new settings.json with Agent Teams'];
+            }
+        }
     }
     catch (error) {
         result.success = false;
@@ -330,10 +445,12 @@ export async function executeUpgrade(targetDir) {
 /**
  * Execute upgrade with --add-missing flag
  * Adds any new skills, agents, and commands that don't exist yet
+ * @param targetDir - Target directory
+ * @param upgradeSettings - If true, merge new settings into existing settings.json
  */
-export async function executeUpgradeWithMissing(targetDir) {
-    // First do the normal upgrade
-    const result = await executeUpgrade(targetDir);
+export async function executeUpgradeWithMissing(targetDir, upgradeSettings = false) {
+    // First do the normal upgrade (pass through upgradeSettings)
+    const result = await executeUpgrade(targetDir, upgradeSettings);
     if (!result.success) {
         return result;
     }

package/v3/@claude-flow/cli/dist/src/init/settings-generator.js

@@ -2,6 +2,7 @@
  * Settings.json Generator
  * Creates .claude/settings.json with V3-optimized hook configurations
  */
+import { detectPlatform } from './types.js';
 /**
  * Generate the complete settings.json content
  */
@@ -161,9 +162,33 @@ function generateStatusLineConfig(options) {
 }
 /**
  * Generate hooks configuration
+ * Detects platform and generates appropriate commands for Mac, Linux, and Windows
  */
 function generateHooksConfig(config) {
     const hooks = {};
+    const platform = detectPlatform();
+    const isWindows = platform.os === 'windows';
+    // Platform-specific command helpers
+    // Windows: PowerShell syntax with 2>$null and ; exit 0
+    // Mac/Linux: Bash syntax with 2>/dev/null || true
+    const cmd = {
+        // Check if variable is set and run command
+        ifVar: (varName, command) => isWindows
+            ? `if ($env:${varName}) { ${command} 2>$null }; exit 0`
+            : `[ -n "$${varName}" ] && ${command} 2>/dev/null || true`,
+        // Simple command with error suppression
+        simple: (command) => isWindows
+            ? `${command} 2>$null; exit 0`
+            : `${command} 2>/dev/null || true`,
+        // Echo JSON (different quote escaping)
+        echoJson: (json) => isWindows
+            ? `Write-Output '${json}'`
+            : `echo '${json}'`,
+        // Generate timestamp (for unique keys)
+        timestamp: () => isWindows
+            ? '$(Get-Date -UFormat %s)'
+            : '$(date +%s)',
+    };
     // PreToolUse hooks - cross-platform via npx with defensive guards
     if (config.preToolUse) {
         hooks.PreToolUse = [
@@ -173,7 +198,9 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: '[ -n "$TOOL_INPUT_file_path" ] && npx @claude-flow/cli@latest hooks pre-edit --file "$TOOL_INPUT_file_path" 2>/dev/null || true',
+                        command: cmd.ifVar('TOOL_INPUT_file_path', isWindows
+                            ? 'npx @claude-flow/cli@latest hooks pre-edit --file $env:TOOL_INPUT_file_path'
+                            : 'npx @claude-flow/cli@latest hooks pre-edit --file "$TOOL_INPUT_file_path"'),
                         timeout: config.timeout,
                         continueOnError: true,
                     },
@@ -185,7 +212,9 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: '[ -n "$TOOL_INPUT_command" ] && npx @claude-flow/cli@latest hooks pre-command --command "$TOOL_INPUT_command" 2>/dev/null || true',
+                        command: cmd.ifVar('TOOL_INPUT_command', isWindows
+                            ? 'npx @claude-flow/cli@latest hooks pre-command --command $env:TOOL_INPUT_command'
+                            : 'npx @claude-flow/cli@latest hooks pre-command --command "$TOOL_INPUT_command"'),
                         timeout: config.timeout,
                         continueOnError: true,
                     },
@@ -197,7 +226,9 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: '[ -n "$TOOL_INPUT_prompt" ] && npx @claude-flow/cli@latest hooks pre-task --task-id "task-$(date +%s)" --description "$TOOL_INPUT_prompt" 2>/dev/null || true',
+                        command: cmd.ifVar('TOOL_INPUT_prompt', isWindows
+                            ? `npx @claude-flow/cli@latest hooks pre-task --task-id "task-${cmd.timestamp()}" --description $env:TOOL_INPUT_prompt`
+                            : `npx @claude-flow/cli@latest hooks pre-task --task-id "task-${cmd.timestamp()}" --description "$TOOL_INPUT_prompt"`),
                         timeout: config.timeout,
                         continueOnError: true,
                     },
@@ -214,7 +245,9 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: '[ -n "$TOOL_INPUT_file_path" ] && npx @claude-flow/cli@latest hooks post-edit --file "$TOOL_INPUT_file_path" --success "${TOOL_SUCCESS:-true}" 2>/dev/null || true',
+                        command: cmd.ifVar('TOOL_INPUT_file_path', isWindows
+                            ? 'npx @claude-flow/cli@latest hooks post-edit --file $env:TOOL_INPUT_file_path --success $($env:TOOL_SUCCESS ?? "true")'
+                            : 'npx @claude-flow/cli@latest hooks post-edit --file "$TOOL_INPUT_file_path" --success "${TOOL_SUCCESS:-true}"'),
                         timeout: config.timeout,
                         continueOnError: true,
                     },
@@ -226,7 +259,9 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: '[ -n "$TOOL_INPUT_command" ] && npx @claude-flow/cli@latest hooks post-command --command "$TOOL_INPUT_command" --success "${TOOL_SUCCESS:-true}" 2>/dev/null || true',
+                        command: cmd.ifVar('TOOL_INPUT_command', isWindows
+                            ? 'npx @claude-flow/cli@latest hooks post-command --command $env:TOOL_INPUT_command --success $($env:TOOL_SUCCESS ?? "true")'
+                            : 'npx @claude-flow/cli@latest hooks post-command --command "$TOOL_INPUT_command" --success "${TOOL_SUCCESS:-true}"'),
                         timeout: config.timeout,
                         continueOnError: true,
                     },
@@ -238,7 +273,9 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: '[ -n "$TOOL_RESULT_agent_id" ] && npx @claude-flow/cli@latest hooks post-task --task-id "$TOOL_RESULT_agent_id" --success "${TOOL_SUCCESS:-true}" 2>/dev/null || true',
+                        command: cmd.ifVar('TOOL_RESULT_agent_id', isWindows
+                            ? 'npx @claude-flow/cli@latest hooks post-task --task-id $env:TOOL_RESULT_agent_id --success $($env:TOOL_SUCCESS ?? "true")'
+                            : 'npx @claude-flow/cli@latest hooks post-task --task-id "$TOOL_RESULT_agent_id" --success "${TOOL_SUCCESS:-true}"'),
                         timeout: config.timeout,
                         continueOnError: true,
                     },
@@ -253,7 +290,9 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: '[ -n "$PROMPT" ] && npx @claude-flow/cli@latest hooks route --task "$PROMPT" || true',
+                        command: cmd.ifVar('PROMPT', isWindows
+                            ? 'npx @claude-flow/cli@latest hooks route --task $env:PROMPT'
+                            : 'npx @claude-flow/cli@latest hooks route --task "$PROMPT"'),
                         timeout: config.timeout,
                         continueOnError: true,
                     },
@@ -268,13 +307,15 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx @claude-flow/cli@latest daemon start --quiet 2>/dev/null || true',
+                        command: cmd.simple('npx @claude-flow/cli@latest daemon start --quiet'),
                         timeout: 5000,
                         continueOnError: true,
                     },
                     {
                         type: 'command',
-                        command: '[ -n "$SESSION_ID" ] && npx @claude-flow/cli@latest hooks session-restore --session-id "$SESSION_ID" 2>/dev/null || true',
+                        command: cmd.ifVar('SESSION_ID', isWindows
+                            ? 'npx @claude-flow/cli@latest hooks session-restore --session-id $env:SESSION_ID'
+                            : 'npx @claude-flow/cli@latest hooks session-restore --session-id "$SESSION_ID"'),
                         timeout: 10000,
                         continueOnError: true,
                     },
@@ -290,7 +331,7 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'echo \'{"ok": true}\'',
+                        command: cmd.echoJson('{"ok": true}'),
                         timeout: 1000,
                     },
                 ],
@@ -304,7 +345,9 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: '[ -n "$NOTIFICATION_MESSAGE" ] && npx @claude-flow/cli@latest memory store --namespace notifications --key "notify-$(date +%s)" --value "$NOTIFICATION_MESSAGE" 2>/dev/null || true',
+                        command: cmd.ifVar('NOTIFICATION_MESSAGE', isWindows
+                            ? `npx @claude-flow/cli@latest memory store --namespace notifications --key "notify-${cmd.timestamp()}" --value $env:NOTIFICATION_MESSAGE`
+                            : `npx @claude-flow/cli@latest memory store --namespace notifications --key "notify-${cmd.timestamp()}" --value "$NOTIFICATION_MESSAGE"`),
                         timeout: 3000,
                         continueOnError: true,
                     },
@@ -320,7 +363,7 @@ function generateHooksConfig(config) {
             hooks: [
                 {
                     type: 'command',
-                    command: 'npx @claude-flow/cli@latest hooks teammate-idle --auto-assign true 2>/dev/null || true',
+                    command: cmd.simple('npx @claude-flow/cli@latest hooks teammate-idle --auto-assign true'),
                     timeout: 5000,
                     continueOnError: true,
                 },
@@ -332,7 +375,9 @@ function generateHooksConfig(config) {
             hooks: [
                 {
                     type: 'command',
-                    command: '[ -n "$TASK_ID" ] && npx @claude-flow/cli@latest hooks task-completed --task-id "$TASK_ID" --train-patterns true 2>/dev/null || true',
+                    command: cmd.ifVar('TASK_ID', isWindows
+                        ? 'npx @claude-flow/cli@latest hooks task-completed --task-id $env:TASK_ID --train-patterns true'
+                        : 'npx @claude-flow/cli@latest hooks task-completed --task-id "$TASK_ID" --train-patterns true'),
                     timeout: 5000,
                     continueOnError: true,
                 },

package/v3/@claude-flow/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.1.0-alpha.13",
+  "version": "3.1.0-alpha.14",
   "type": "module",
   "description": "Claude Flow CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",