claude-flow 3.32.8 → 3.32.10

package/.claude-plugin/docs/STRUCTURE.md

@@ -1,128 +1,128 @@
-# Claude Flow Plugin Structure
-
-## Official Claude Code Plugin Format
-
-This plugin follows the official Claude Code plugin specification.
-
-## Directory Structure
-
-```
-claude-flow/
-├── .claude-plugin/              # Plugin metadata and documentation
-│   ├── plugin.json              # Plugin manifest
-│   ├── marketplace.json         # Marketplace distribution metadata
-│   ├── README.md                # Complete documentation (20KB)
-│   ├── STRUCTURE.md             # This file
-│   ├── docs/
-│   │   └── QUICKSTART.md        # 5-minute quickstart
-│   └── scripts/
-│       ├── install.sh           # Installation script
-│       ├── verify.sh            # Verification script
-│       └── uninstall.sh         # Uninstallation script
-│
-├── commands/                     # 150+ slash commands
-│   ├── coordination/            # Swarm coordination (6 commands)
-│   ├── sparc/                   # SPARC methodology (18 commands)
-│   ├── github/                  # GitHub integration (18 commands)
-│   ├── hive-mind/               # Hive mind (11 commands)
-│   ├── hooks/                   # Hooks configuration (5 commands)
-│   ├── memory/                  # Memory management (5 commands)
-│   ├── monitoring/              # Monitoring (5 commands)
-│   ├── optimization/            # Optimization (5 commands)
-│   ├── analysis/                # Analysis (5 commands)
-│   ├── automation/              # Automation (6 commands)
-│   ├── swarm/                   # Swarm management (15 commands)
-│   ├── workflows/               # Workflows (5 commands)
-│   ├── training/                # Neural training (5 commands)
-│   └── flow-nexus/              # Flow Nexus integration (9 commands)
-│
-├── agents/                      # 74+ specialized agents
-│   ├── core/                    # Core development (5 agents)
-│   ├── swarm/                   # Swarm coordination (5 agents)
-│   ├── consensus/               # Consensus protocols (7 agents)
-│   ├── github/                  # GitHub automation (13 agents)
-│   ├── specialized/             # Specialized development (8 agents)
-│   ├── sparc/                   # SPARC methodology (4 agents)
-│   ├── hive-mind/               # Hive mind (5 agents)
-│   └── optimization/            # Performance optimization (5 agents)
-│
-└── hooks/                       # Event handlers
-    └── hooks.json               # Hook configuration
-
-```
-
-## Installation
-
-Users install with:
-
-```
-/plugin add ruvnet/claude-flow
-/restart
-```
-
-## Components
-
-### Plugin Metadata
-- **plugin.json**: Plugin manifest with configuration
-  - Plugin name, version, description
-  - Author and repository information
-  - MCP server configuration
-  - Engine requirements
-- **marketplace.json**: Marketplace distribution metadata
-  - Marketplace owner information
-  - Plugin listing and features
-  - Requirements and dependencies
-
-### Commands (`commands/`)
-- Markdown files (.md)
-- Automatically discovered by Claude Code
-- 150+ commands across 19 categories
-- Named with kebab-case (e.g., `coordination-swarm-init.md`)
-
-### Agents (`agents/`)
-- Markdown files with YAML frontmatter
-- Available for delegation
-- 74+ specialized agents across 20 categories
-- Named with kebab-case (e.g., `backend-dev.md`)
-
-### Hooks (`hooks/hooks.json`)
-- Event handler configuration
-- Integration with Claude Flow coordination
-- Pre/post task execution, session management
-
-## MCP Integration
-
-The plugin configures 3 MCP servers:
-
-1. **claude-flow** (Required)
-   - 40+ orchestration tools
-   - Swarm coordination
-   - Agent management
-
-2. **ruv-swarm** (Optional)
-   - Enhanced coordination
-   - WASM acceleration
-
-3. **flow-nexus** (Optional)
-   - 70+ cloud tools
-   - Requires authentication
-
-## Documentation
-
-- **README.md**: Complete plugin documentation (20KB)
-- **marketplace.json**: Marketplace distribution metadata
-- **docs/INSTALLATION.md**: Installation instructions
-- **docs/PLUGIN_SUMMARY.md**: Production status
-- **docs/STRUCTURE.md**: This file
-- **docs/QUICKSTART.md**: 5-minute quickstart
-
-## Version
-
-- **Version**: 2.5.0
-- **License**: MIT
-- **Author**: rUv
-- **Compatibility**: Claude Code >= 2.0.0
-
-## Status
-
-✅ **PRODUCTION READY**
+# Claude Flow Plugin Structure
+
+## Official Claude Code Plugin Format
+
+This plugin follows the official Claude Code plugin specification.
+
+## Directory Structure
+
+```
+claude-flow/
+├── .claude-plugin/              # Plugin metadata and documentation
+│   ├── plugin.json              # Plugin manifest
+│   ├── marketplace.json         # Marketplace distribution metadata
+│   ├── README.md                # Complete documentation (20KB)
+│   ├── STRUCTURE.md             # This file
+│   ├── docs/
+│   │   └── QUICKSTART.md        # 5-minute quickstart
+│   └── scripts/
+│       ├── install.sh           # Installation script
+│       ├── verify.sh            # Verification script
+│       └── uninstall.sh         # Uninstallation script
+│
+├── commands/                     # 150+ slash commands
+│   ├── coordination/            # Swarm coordination (6 commands)
+│   ├── sparc/                   # SPARC methodology (18 commands)
+│   ├── github/                  # GitHub integration (18 commands)
+│   ├── hive-mind/               # Hive mind (11 commands)
+│   ├── hooks/                   # Hooks configuration (5 commands)
+│   ├── memory/                  # Memory management (5 commands)
+│   ├── monitoring/              # Monitoring (5 commands)
+│   ├── optimization/            # Optimization (5 commands)
+│   ├── analysis/                # Analysis (5 commands)
+│   ├── automation/              # Automation (6 commands)
+│   ├── swarm/                   # Swarm management (15 commands)
+│   ├── workflows/               # Workflows (5 commands)
+│   ├── training/                # Neural training (5 commands)
+│   └── flow-nexus/              # Flow Nexus integration (9 commands)
+│
+├── agents/                      # 74+ specialized agents
+│   ├── core/                    # Core development (5 agents)
+│   ├── swarm/                   # Swarm coordination (5 agents)
+│   ├── consensus/               # Consensus protocols (7 agents)
+│   ├── github/                  # GitHub automation (13 agents)
+│   ├── specialized/             # Specialized development (8 agents)
+│   ├── sparc/                   # SPARC methodology (4 agents)
+│   ├── hive-mind/               # Hive mind (5 agents)
+│   └── optimization/            # Performance optimization (5 agents)
+│
+└── hooks/                       # Event handlers
+    └── hooks.json               # Hook configuration
+
+```
+
+## Installation
+
+Users install with:
+
+```
+/plugin add ruvnet/claude-flow
+/restart
+```
+
+## Components
+
+### Plugin Metadata
+- **plugin.json**: Plugin manifest with configuration
+  - Plugin name, version, description
+  - Author and repository information
+  - MCP server configuration
+  - Engine requirements
+- **marketplace.json**: Marketplace distribution metadata
+  - Marketplace owner information
+  - Plugin listing and features
+  - Requirements and dependencies
+
+### Commands (`commands/`)
+- Markdown files (.md)
+- Automatically discovered by Claude Code
+- 150+ commands across 19 categories
+- Named with kebab-case (e.g., `coordination-swarm-init.md`)
+
+### Agents (`agents/`)
+- Markdown files with YAML frontmatter
+- Available for delegation
+- 74+ specialized agents across 20 categories
+- Named with kebab-case (e.g., `backend-dev.md`)
+
+### Hooks (`hooks/hooks.json`)
+- Event handler configuration
+- Integration with Claude Flow coordination
+- Pre/post task execution, session management
+
+## MCP Integration
+
+The plugin configures 3 MCP servers:
+
+1. **claude-flow** (Required)
+   - 40+ orchestration tools
+   - Swarm coordination
+   - Agent management
+
+2. **ruv-swarm** (Optional)
+   - Enhanced coordination
+   - WASM acceleration
+
+3. **flow-nexus** (Optional)
+   - 70+ cloud tools
+   - Requires authentication
+
+## Documentation
+
+- **README.md**: Complete plugin documentation (20KB)
+- **marketplace.json**: Marketplace distribution metadata
+- **docs/INSTALLATION.md**: Installation instructions
+- **docs/PLUGIN_SUMMARY.md**: Production status
+- **docs/STRUCTURE.md**: This file
+- **docs/QUICKSTART.md**: 5-minute quickstart
+
+## Version
+
+- **Version**: 2.5.0
+- **License**: MIT
+- **Author**: rUv
+- **Compatibility**: Claude Code >= 2.0.0
+
+## Status
+
+✅ **PRODUCTION READY**

package/.claude-plugin/hooks/hooks.json

@@ -1,77 +1,79 @@
-{
-  "_note": "#1921 — hook commands invoke scripts/ruflo-hook.sh (resilient shim): prefers a locally-installed `ruflo`/`claude-flow` binary, falls back to `npx --prefer-offline`, and always exits 0 so a CLI/install failure (e.g. arborist `Invalid Version` on npm 10.8.x) never surfaces an error in Claude Code or blocks a turn. The trailing `|| true` guards the case where $CLAUDE_PLUGIN_ROOT is unset (older Claude Code) — the hook then no-ops silently. DO NOT revert to a bare `npx <pkg>@alpha hooks …` per fire.",
-  "_platform": "posix",
-  "_platform_note": "#2132 — This hooks.json uses /bin/bash, POSIX pipelines (jq, xargs, tr), and .sh scripts. It is intentionally POSIX-only (Mac/Linux). On Windows, ruflo init writes a .claude/settings.json that overrides these entries with node-based equivalents via plugins/ruflo-core/scripts/ruflo-hook.cjs. The audit exempts files with _platform:posix from the cross-platform check.",
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" modify-bash || true"
-          }
-        ]
-      },
-      {
-        "matcher": "Write|Edit|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" modify-file || true"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} \"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" post-command --command '{}' --track-metrics true --store-results true || true"
-          }
-        ]
-      },
-      {
-        "matcher": "Write|Edit|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} \"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" post-edit --file '{}' --format true --update-memory true || true"
-          }
-        ]
-      }
-    ],
-    "PreCompact": [
-      {
-        "matcher": "manual",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "/bin/bash -c 'INPUT=$(cat); CUSTOM=$(echo \"$INPUT\" | jq -r \".custom_instructions // \\\"\\\"\"); echo \"🔄 PreCompact Guidance:\"; echo \"📋 IMPORTANT: Review CLAUDE.md in project root for:\"; echo \"   • 54 available agents and concurrent usage patterns\"; echo \"   • Swarm coordination strategies (hierarchical, mesh, adaptive)\"; echo \"   • SPARC methodology workflows with batchtools optimization\"; echo \"   • Critical concurrent execution rules (GOLDEN RULE: 1 MESSAGE = ALL OPERATIONS)\"; if [ -n \"$CUSTOM\" ]; then echo \"🎯 Custom compact instructions: $CUSTOM\"; fi; echo \"✅ Ready for compact operation\"'"
-          }
-        ]
-      },
-      {
-        "matcher": "auto",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "/bin/bash -c 'echo \"🔄 Auto-Compact Guidance (Context Window Full):\"; echo \"📋 CRITICAL: Before compacting, ensure you understand:\"; echo \"   • All 54 agents available in .claude/agents/ directory\"; echo \"   • Concurrent execution patterns from CLAUDE.md\"; echo \"   • Batchtools optimization for 300% performance gains\"; echo \"   • Swarm coordination strategies for complex tasks\"; echo \"⚡ Apply GOLDEN RULE: Always batch operations in single messages\"; echo \"✅ Auto-compact proceeding with full agent context\"'"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" session-end --generate-summary true --persist-state true --export-metrics true || true"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "_note": "#1921 — hook commands invoke scripts/ruflo-hook.sh (resilient shim): prefers a locally-installed `ruflo`/`claude-flow` binary, falls back to `npx --prefer-offline`, and always exits 0 so a CLI/install failure (e.g. arborist `Invalid Version` on npm 10.8.x) never surfaces an error in Claude Code or blocks a turn. The trailing `|| true` guards the case where $CLAUDE_PLUGIN_ROOT is unset (older Claude Code) — the hook then no-ops silently. DO NOT revert to a bare `npx <pkg>@alpha hooks …` per fire.",
+  "_platform": "posix",
+  "_platform_note": "#2132 — This hooks.json uses /bin/bash, POSIX pipelines (jq, xargs, tr), and .sh scripts. It is intentionally POSIX-only (Mac/Linux) today and known-broken on native Windows (#2721 shape). The previous claim here that `ruflo init` overrides these entries with node-based equivalents on Windows was never actually implemented and is incorrect — Claude Code merges plugin-declared hooks additively with any init-generated settings.json, it does not replace them. This package (separate from plugins/ruflo-core, which got the #2721 fix) still needs its own Windows-compatible rewrite; see _legacy_unaudited_shim below.",
+  "_legacy_unaudited_shim": true,
+  "_legacy_unaudited_shim_note": "#2721 fixed plugins/ruflo-core and plugins/ruflo-cost-tracker (marketplace-listed in .claude-plugin/marketplace.json) by rewiring hooks.json to a `node -e` bootstrap around scripts/ruflo-hook.cjs. This older, separately-published \"claude-flow\" plugin package (not in the ruflo marketplace list) has its own, larger jq/xargs-based hook set and its own scripts/ruflo-hook.cjs that hooks.json never references — same underlying bug shape, NOT fixed as part of #2721. Needs its own audited pass before this flag can be removed.",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" modify-bash || true"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" modify-file || true"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} \"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" post-command --command '{}' --track-metrics true --store-results true || true"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} \"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" post-edit --file '{}' --format true --update-memory true || true"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "manual",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/bin/bash -c 'INPUT=$(cat); CUSTOM=$(echo \"$INPUT\" | jq -r \".custom_instructions // \\\"\\\"\"); echo \"🔄 PreCompact Guidance:\"; echo \"📋 IMPORTANT: Review CLAUDE.md in project root for:\"; echo \"   • 54 available agents and concurrent usage patterns\"; echo \"   • Swarm coordination strategies (hierarchical, mesh, adaptive)\"; echo \"   • SPARC methodology workflows with batchtools optimization\"; echo \"   • Critical concurrent execution rules (GOLDEN RULE: 1 MESSAGE = ALL OPERATIONS)\"; if [ -n \"$CUSTOM\" ]; then echo \"🎯 Custom compact instructions: $CUSTOM\"; fi; echo \"✅ Ready for compact operation\"'"
+          }
+        ]
+      },
+      {
+        "matcher": "auto",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/bin/bash -c 'echo \"🔄 Auto-Compact Guidance (Context Window Full):\"; echo \"📋 CRITICAL: Before compacting, ensure you understand:\"; echo \"   • All 54 agents available in .claude/agents/ directory\"; echo \"   • Concurrent execution patterns from CLAUDE.md\"; echo \"   • Batchtools optimization for 300% performance gains\"; echo \"   • Swarm coordination strategies for complex tasks\"; echo \"⚡ Apply GOLDEN RULE: Always batch operations in single messages\"; echo \"✅ Auto-compact proceeding with full agent context\"'"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/ruflo-hook.sh\" session-end --generate-summary true --persist-state true --export-metrics true || true"
+          }
+        ]
+      }
+    ]
+  }
+}