claude-flow-novice 2.10.4 → 2.10.6

package/claude-assets/commands/hive-mind/hive-mind-sessions.md

@@ -0,0 +1,8 @@
+# hive-mind-sessions
+
+Command documentation for hive-mind-sessions in category hive-mind.
+
+Usage:
+```bash
+npx claude-flow-novice hive-mind hive-mind-sessions [options]
+```

package/claude-assets/commands/hive-mind/hive-mind-spawn.md

@@ -0,0 +1,21 @@
+# hive-mind-spawn
+
+Spawn a Hive Mind swarm with queen-led coordination.
+
+## Usage
+```bash
+npx claude-flow-novice hive-mind spawn <objective> [options]
+```
+
+## Options
+- `--queen-type <type>` - Queen type (strategic, tactical, adaptive)
+- `--max-workers <n>` - Maximum worker agents
+- `--consensus <type>` - Consensus algorithm
+- `--claude` - Generate Claude Code spawn commands
+
+## Examples
+```bash
+npx claude-flow-novice hive-mind spawn "Build API"
+npx claude-flow-novice hive-mind spawn "Research patterns" --queen-type adaptive
+npx claude-flow-novice hive-mind spawn "Build service" --claude
+```

package/claude-assets/commands/hive-mind/hive-mind-status.md

@@ -0,0 +1,8 @@
+# hive-mind-status
+
+Command documentation for hive-mind-status in category hive-mind.
+
+Usage:
+```bash
+npx claude-flow-novice hive-mind hive-mind-status [options]
+```

package/claude-assets/commands/hive-mind/hive-mind-stop.md

@@ -0,0 +1,8 @@
+# hive-mind-stop
+
+Command documentation for hive-mind-stop in category hive-mind.
+
+Usage:
+```bash
+npx claude-flow-novice hive-mind hive-mind-stop [options]
+```

package/claude-assets/commands/hive-mind/hive-mind-wizard.md

@@ -0,0 +1,8 @@
+# hive-mind-wizard
+
+Command documentation for hive-mind-wizard in category hive-mind.
+
+Usage:
+```bash
+npx claude-flow-novice hive-mind hive-mind-wizard [options]
+```

package/claude-assets/commands/hive-mind/hive-mind.md

@@ -0,0 +1,27 @@
+# hive-mind
+
+Hive Mind collective intelligence system for advanced swarm coordination.
+
+## Usage
+```bash
+npx claude-flow-novice hive-mind [subcommand] [options]
+```
+
+## Subcommands
+- `init` - Initialize hive mind system
+- `spawn` - Spawn hive mind swarm
+- `status` - Show hive mind status
+- `resume` - Resume paused session
+- `stop` - Stop running session
+
+## Examples
+```bash
+# Initialize hive mind
+npx claude-flow-novice hive-mind init
+
+# Spawn swarm
+npx claude-flow-novice hive-mind spawn "Build microservices"
+
+# Check status
+npx claude-flow-novice hive-mind status
+```

package/claude-assets/commands/hooks/README.md

@@ -0,0 +1,11 @@
+# Hooks Commands
+
+Commands for hooks operations in Claude Flow.
+
+## Available Commands
+
+- [pre-task](./pre-task.md)
+- [post-task](./post-task.md)
+- [pre-edit](./pre-edit.md)
+- [post-edit](./post-edit.md)
+- [session-end](./session-end.md)

package/claude-assets/commands/hooks/overview.md

@@ -0,0 +1,58 @@
+# Claude Code Hooks for claude-flow
+
+## Purpose
+Automatically coordinate, format, and learn from Claude Code operations using hooks.
+
+## Available Hooks
+
+### Pre-Operation Hooks
+- **pre-edit**: Validate and assign agents before file modifications
+- **pre-bash**: Check command safety and resource requirements
+- **pre-task**: Auto-spawn agents for complex tasks
+
+### Post-Operation Hooks
+- **post-edit**: Auto-format code and train neural patterns
+- **post-bash**: Log execution and update metrics
+- **post-search**: Cache results and improve search patterns
+
+### MCP Integration Hooks
+- **mcp-initialized**: Persist swarm configuration
+- **agent-spawned**: Update agent roster
+- **task-orchestrated**: Monitor task progress
+- **neural-trained**: Save pattern improvements
+
+### Session Hooks
+- **notify**: Custom notifications with swarm status
+- **session-end**: Generate summary and save state
+- **session-restore**: Load previous session state
+
+## Configuration
+Hooks are configured in `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "^(Write|Edit|MultiEdit)$",
+        "hooks": [{
+          "type": "command",
+          "command": "npx claude-flow-novice hook pre-edit --file '${tool.params.file_path}'"
+        }]
+      }
+    ]
+  }
+}
+```
+
+## Benefits
+- 🤖 Automatic agent assignment based on file type
+- 🎨 Consistent code formatting
+- 🧠 Continuous neural pattern improvement
+- 💾 Cross-session memory persistence
+- 📊 Performance metrics tracking
+
+## See Also
+- [Pre-Edit Hook](./pre-edit.md)
+- [Post-Edit Hook](./post-edit.md)
+- [Session End Hook](./session-end.md)

package/claude-assets/commands/hooks/post-edit.md

@@ -0,0 +1,117 @@
+# hook post-edit
+
+Execute post-edit processing including formatting, validation, and memory updates.
+
+## Usage
+
+```bash
+npx claude-flow-novice hook post-edit [options]
+```
+
+## Options
+
+- `--file, -f <path>` - File path that was edited
+- `--auto-format` - Automatically format code (default: true)
+- `--memory-key, -m <key>` - Store edit context in memory
+- `--train-patterns` - Train neural patterns from edit
+- `--validate-output` - Validate edited file
+
+## Examples
+
+### Basic post-edit hook
+
+```bash
+npx claude-flow-novice hook post-edit --file "src/components/Button.jsx"
+```
+
+### With memory storage
+
+```bash
+npx claude-flow-novice hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"
+```
+
+### Format and validate
+
+```bash
+npx claude-flow-novice hook post-edit -f "config/webpack.js" --auto-format --validate-output
+```
+
+### Neural training
+
+```bash
+npx claude-flow-novice hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"
+```
+
+## Features
+
+### Auto Formatting
+
+- Language-specific formatters
+- Prettier for JS/TS/JSON
+- Black for Python
+- gofmt for Go
+- Maintains consistency
+
+### Memory Storage
+
+- Saves edit context
+- Records decisions made
+- Tracks implementation details
+- Enables knowledge sharing
+
+### Pattern Training
+
+- Learns from successful edits
+- Improves future suggestions
+- Adapts to coding style
+- Enhances coordination
+
+### Output Validation
+
+- Checks syntax correctness
+- Runs linting rules
+- Validates formatting
+- Ensures quality
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+
+- After Edit tool completes
+- Following MultiEdit operations
+- During file saves
+- After code generation
+
+Manual usage in agents:
+
+```bash
+# After editing files
+npx claude-flow-novice hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"
+```
+
+## Output
+
+Returns JSON with:
+
+```json
+{
+  "file": "src/components/Button.jsx",
+  "formatted": true,
+  "formatterUsed": "prettier",
+  "lintPassed": true,
+  "memorySaved": "component/button-refactor",
+  "patternsTrained": 3,
+  "warnings": [],
+  "stats": {
+    "linesChanged": 45,
+    "charactersAdded": 234
+  }
+}
+```
+
+## See Also
+
+- `hook pre-edit` - Pre-edit preparation
+- `Edit` - File editing tool
+- `memory usage` - Memory management
+- `neural train` - Pattern training

package/claude-assets/commands/hooks/post-task.md

@@ -0,0 +1,112 @@
+# hook post-task
+
+Execute post-task cleanup, performance analysis, and memory storage.
+
+## Usage
+
+```bash
+npx claude-flow-novice hook post-task [options]
+```
+
+## Options
+
+- `--task-id, -t <id>` - Task identifier for tracking
+- `--analyze-performance` - Generate performance metrics (default: true)
+- `--store-decisions` - Save task decisions to memory
+- `--export-learnings` - Export neural pattern learnings
+- `--generate-report` - Create task completion report
+
+## Examples
+
+### Basic post-task hook
+
+```bash
+npx claude-flow-novice hook post-task --task-id "auth-implementation"
+```
+
+### With full analysis
+
+```bash
+npx claude-flow-novice hook post-task -t "api-refactor" --analyze-performance --generate-report
+```
+
+### Memory storage
+
+```bash
+npx claude-flow-novice hook post-task -t "bug-fix-123" --store-decisions --export-learnings
+```
+
+### Quick cleanup
+
+```bash
+npx claude-flow-novice hook post-task -t "minor-update" --analyze-performance false
+```
+
+## Features
+
+### Performance Analysis
+
+- Measures execution time
+- Tracks token usage
+- Identifies bottlenecks
+- Suggests optimizations
+
+### Decision Storage
+
+- Saves key decisions made
+- Records implementation choices
+- Stores error resolutions
+- Maintains knowledge base
+
+### Neural Learning
+
+- Exports successful patterns
+- Updates coordination models
+- Improves future performance
+- Trains on task outcomes
+
+### Report Generation
+
+- Creates completion summary
+- Documents changes made
+- Lists files modified
+- Tracks metrics achieved
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+
+- Completing a task
+- Switching to a new task
+- Ending a work session
+- After major milestones
+
+Manual usage in agents:
+
+```bash
+# In agent coordination
+npx claude-flow-novice hook post-task --task-id "your-task-id" --analyze-performance true
+```
+
+## Output
+
+Returns JSON with:
+
+```json
+{
+  "taskId": "auth-implementation",
+  "duration": 1800000,
+  "tokensUsed": 45000,
+  "filesModified": 12,
+  "performanceScore": 0.92,
+  "learningsExported": true,
+  "reportPath": "/reports/task-auth-implementation.md"
+}
+```
+
+## See Also
+
+- `hook pre-task` - Pre-task setup
+- `performance report` - Detailed metrics
+- `memory usage` - Memory management
+- `neural patterns` - Pattern analysis

package/claude-assets/commands/hooks/pre-edit.md

@@ -0,0 +1,113 @@
+# hook pre-edit
+
+Execute pre-edit validations and agent assignment before file modifications.
+
+## Usage
+
+```bash
+npx claude-flow-novice hook pre-edit [options]
+```
+
+## Options
+
+- `--file, -f <path>` - File path to be edited
+- `--auto-assign-agent` - Automatically assign best agent (default: true)
+- `--validate-syntax` - Pre-validate syntax before edit
+- `--check-conflicts` - Check for merge conflicts
+- `--backup-file` - Create backup before editing
+
+## Examples
+
+### Basic pre-edit hook
+
+```bash
+npx claude-flow-novice hook pre-edit --file "src/auth/login.js"
+```
+
+### With validation
+
+```bash
+npx claude-flow-novice hook pre-edit -f "config/database.js" --validate-syntax
+```
+
+### Manual agent assignment
+
+```bash
+npx claude-flow-novice hook pre-edit -f "api/users.ts" --auto-assign-agent false
+```
+
+### Safe editing with backup
+
+```bash
+npx claude-flow-novice hook pre-edit -f "production.env" --backup-file --check-conflicts
+```
+
+## Features
+
+### Auto Agent Assignment
+
+- Analyzes file type and content
+- Assigns specialist agents
+- TypeScript → TypeScript expert
+- Database → Data specialist
+- Tests → QA engineer
+
+### Syntax Validation
+
+- Pre-checks syntax validity
+- Identifies potential errors
+- Suggests corrections
+- Prevents broken code
+
+### Conflict Detection
+
+- Checks for git conflicts
+- Identifies concurrent edits
+- Warns about stale files
+- Suggests merge strategies
+
+### File Backup
+
+- Creates safety backups
+- Enables quick rollback
+- Tracks edit history
+- Preserves originals
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+
+- Using Edit or MultiEdit tools
+- Before file modifications
+- During refactoring operations
+- When updating critical files
+
+Manual usage in agents:
+
+```bash
+# Before editing files
+npx claude-flow-novice hook pre-edit --file "path/to/file.js" --validate-syntax
+```
+
+## Output
+
+Returns JSON with:
+
+```json
+{
+  "continue": true,
+  "file": "src/auth/login.js",
+  "assignedAgent": "auth-specialist",
+  "syntaxValid": true,
+  "conflicts": false,
+  "backupPath": ".backups/login.js.bak",
+  "warnings": []
+}
+```
+
+## See Also
+
+- `hook post-edit` - Post-edit processing
+- `Edit` - File editing tool
+- `MultiEdit` - Multiple edits tool
+- `agent spawn` - Manual agent creation

package/claude-assets/commands/hooks/pre-task.md

@@ -0,0 +1,111 @@
+# hook pre-task
+
+Execute pre-task preparations and context loading.
+
+## Usage
+
+```bash
+npx claude-flow-novice hook pre-task [options]
+```
+
+## Options
+
+- `--description, -d <text>` - Task description for context
+- `--auto-spawn-agents` - Automatically spawn required agents (default: true)
+- `--load-memory` - Load relevant memory from previous sessions
+- `--optimize-topology` - Select optimal swarm topology
+- `--estimate-complexity` - Analyze task complexity
+
+## Examples
+
+### Basic pre-task hook
+
+```bash
+npx claude-flow-novice hook pre-task --description "Implement user authentication"
+```
+
+### With memory loading
+
+```bash
+npx claude-flow-novice hook pre-task -d "Continue API development" --load-memory
+```
+
+### Manual agent control
+
+```bash
+npx claude-flow-novice hook pre-task -d "Debug issue #123" --auto-spawn-agents false
+```
+
+### Full optimization
+
+```bash
+npx claude-flow-novice hook pre-task -d "Refactor codebase" --optimize-topology --estimate-complexity
+```
+
+## Features
+
+### Auto Agent Assignment
+
+- Analyzes task requirements
+- Determines needed agent types
+- Spawns agents automatically
+- Configures agent parameters
+
+### Memory Loading
+
+- Retrieves relevant past decisions
+- Loads previous task contexts
+- Restores agent configurations
+- Maintains continuity
+
+### Topology Optimization
+
+- Analyzes task structure
+- Selects best swarm topology
+- Configures communication patterns
+- Optimizes for performance
+
+### Complexity Estimation
+
+- Evaluates task difficulty
+- Estimates time requirements
+- Suggests agent count
+- Identifies dependencies
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+
+- Starting a new task
+- Resuming work after a break
+- Switching between projects
+- Beginning complex operations
+
+Manual usage in agents:
+
+```bash
+# In agent coordination
+npx claude-flow-novice hook pre-task --description "Your task here"
+```
+
+## Output
+
+Returns JSON with:
+
+```json
+{
+  "continue": true,
+  "topology": "hierarchical",
+  "agentsSpawned": 5,
+  "complexity": "medium",
+  "estimatedMinutes": 30,
+  "memoryLoaded": true
+}
+```
+
+## See Also
+
+- `hook post-task` - Post-task cleanup
+- `agent spawn` - Manual agent creation
+- `memory usage` - Memory management
+- `swarm init` - Swarm initialization