@delorenj/claude-notifications 2.0.0 → 2.1.0

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

@@ -1,112 +0,0 @@
-# hook post-task
-
-Execute post-task cleanup, performance analysis, and memory storage.
-
-## Usage
-
-```bash
-npx claude-flow 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 hook post-task --task-id "auth-implementation"
-```
-
-### With full analysis
-
-```bash
-npx claude-flow hook post-task -t "api-refactor" --analyze-performance --generate-report
-```
-
-### Memory storage
-
-```bash
-npx claude-flow hook post-task -t "bug-fix-123" --store-decisions --export-learnings
-```
-
-### Quick cleanup
-
-```bash
-npx claude-flow 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 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/commands/hooks/pre-edit.md

@@ -1,113 +0,0 @@
-# hook pre-edit
-
-Execute pre-edit validations and agent assignment before file modifications.
-
-## Usage
-
-```bash
-npx claude-flow 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 hook pre-edit --file "src/auth/login.js"
-```
-
-### With validation
-
-```bash
-npx claude-flow hook pre-edit -f "config/database.js" --validate-syntax
-```
-
-### Manual agent assignment
-
-```bash
-npx claude-flow hook pre-edit -f "api/users.ts" --auto-assign-agent false
-```
-
-### Safe editing with backup
-
-```bash
-npx claude-flow 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 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/commands/hooks/pre-task.md

@@ -1,111 +0,0 @@
-# hook pre-task
-
-Execute pre-task preparations and context loading.
-
-## Usage
-
-```bash
-npx claude-flow 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 hook pre-task --description "Implement user authentication"
-```
-
-### With memory loading
-
-```bash
-npx claude-flow hook pre-task -d "Continue API development" --load-memory
-```
-
-### Manual agent control
-
-```bash
-npx claude-flow hook pre-task -d "Debug issue #123" --auto-spawn-agents false
-```
-
-### Full optimization
-
-```bash
-npx claude-flow 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 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

package/.claude/commands/hooks/session-end.md

@@ -1,118 +0,0 @@
-# hook session-end
-
-Cleanup and persist session state before ending work.
-
-## Usage
-
-```bash
-npx claude-flow hook session-end [options]
-```
-
-## Options
-
-- `--session-id, -s <id>` - Session identifier to end
-- `--save-state` - Save current session state (default: true)
-- `--export-metrics` - Export session metrics
-- `--generate-summary` - Create session summary
-- `--cleanup-temp` - Remove temporary files
-
-## Examples
-
-### Basic session end
-
-```bash
-npx claude-flow hook session-end --session-id "dev-session-2024"
-```
-
-### With full export
-
-```bash
-npx claude-flow hook session-end -s "feature-auth" --export-metrics --generate-summary
-```
-
-### Quick close
-
-```bash
-npx claude-flow hook session-end -s "quick-fix" --save-state false --cleanup-temp
-```
-
-### Complete persistence
-
-```bash
-npx claude-flow hook session-end -s "major-refactor" --save-state --export-metrics --generate-summary
-```
-
-## Features
-
-### State Persistence
-
-- Saves current context
-- Stores open files
-- Preserves task progress
-- Maintains decisions
-
-### Metric Export
-
-- Session duration
-- Commands executed
-- Files modified
-- Tokens consumed
-- Performance data
-
-### Summary Generation
-
-- Work accomplished
-- Key decisions made
-- Problems solved
-- Next steps identified
-
-### Cleanup Operations
-
-- Removes temp files
-- Clears caches
-- Frees resources
-- Optimizes storage
-
-## Integration
-
-This hook is automatically called by Claude Code when:
-
-- Ending a conversation
-- Closing work session
-- Before shutdown
-- Switching contexts
-
-Manual usage in agents:
-
-```bash
-# At session end
-npx claude-flow hook session-end --session-id "your-session" --generate-summary
-```
-
-## Output
-
-Returns JSON with:
-
-```json
-{
-  "sessionId": "dev-session-2024",
-  "duration": 7200000,
-  "saved": true,
-  "metrics": {
-    "commandsRun": 145,
-    "filesModified": 23,
-    "tokensUsed": 85000,
-    "tasksCompleted": 8
-  },
-  "summaryPath": "/sessions/dev-session-2024-summary.md",
-  "cleanedUp": true,
-  "nextSession": "dev-session-2025"
-}
-```
-
-## See Also
-
-- `hook session-start` - Session initialization
-- `hook session-restore` - Session restoration
-- `performance report` - Detailed metrics
-- `memory backup` - State backup

package/.claude/commands/hooks/setup.md

@@ -1,103 +0,0 @@
-# Setting Up ruv-swarm Hooks
-
-## Quick Start
-
-### 1. Initialize with Hooks
-```bash
-npx claude-flow init --hooks
-```
-
-This automatically creates:
-- `.claude/settings.json` with hook configurations
-- Hook command documentation
-- Default hook handlers
-
-### 2. Test Hook Functionality
-```bash
-# Test pre-edit hook
-npx claude-flow hook pre-edit --file test.js
-
-# Test session summary
-npx claude-flow hook session-end --summary
-```
-
-### 3. Customize Hooks
-
-Edit `.claude/settings.json` to customize:
-
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "^Write$",
-        "hooks": [{
-          "type": "command",
-          "command": "npx claude-flow hook pre-write --file '${tool.params.file_path}'"
-        }]
-      }
-    ]
-  }
-}
-```
-
-## Hook Response Format
-
-Hooks return JSON with:
-- `continue`: Whether to proceed (true/false)
-- `reason`: Explanation for decision
-- `metadata`: Additional context
-
-Example blocking response:
-```json
-{
-  "continue": false,
-  "reason": "Protected file - manual review required",
-  "metadata": {
-    "file": ".env.production",
-    "protection_level": "high"
-  }
-}
-```
-
-## Performance Tips
-- Keep hooks lightweight (< 100ms)
-- Use caching for repeated operations
-- Batch related operations
-- Run non-critical hooks asynchronously
-
-## Debugging Hooks
-```bash
-# Enable debug output
-export CLAUDE_FLOW_DEBUG=true
-
-# Test specific hook
-npx claude-flow hook pre-edit --file app.js --debug
-```
-
-## Common Patterns
-
-### Auto-Format on Save
-Already configured by default for common file types.
-
-### Protected File Detection
-```json
-{
-  "matcher": "^(Write|Edit)$",
-  "hooks": [{
-    "type": "command",
-    "command": "npx claude-flow hook check-protected --file '${tool.params.file_path}'"
-  }]
-}
-```
-
-### Automatic Testing
-```json
-{
-  "matcher": "^Write$",
-  "hooks": [{
-    "type": "command",
-    "command": "test -f '${tool.params.file_path%.js}.test.js' && npm test '${tool.params.file_path%.js}.test.js'"
-  }]
-}
-```

package/.claude/commands/memory/README.md

@@ -1,9 +0,0 @@
-# Memory Commands
-
-Commands for memory operations in Claude Flow.
-
-## Available Commands
-
-- [memory-usage](./memory-usage.md)
-- [memory-persist](./memory-persist.md)
-- [memory-search](./memory-search.md)

package/.claude/commands/memory/memory-persist.md

@@ -1,25 +0,0 @@
-# memory-persist
-
-Persist memory across sessions.
-
-## Usage
-```bash
-npx claude-flow memory persist [options]
-```
-
-## Options
-- `--export <file>` - Export to file
-- `--import <file>` - Import from file
-- `--compress` - Compress memory data
-
-## Examples
-```bash
-# Export memory
-npx claude-flow memory persist --export memory-backup.json
-
-# Import memory
-npx claude-flow memory persist --import memory-backup.json
-
-# Compressed export
-npx claude-flow memory persist --export memory.gz --compress
-```

package/.claude/commands/memory/memory-search.md

@@ -1,25 +0,0 @@
-# memory-search
-
-Search through stored memory.
-
-## Usage
-```bash
-npx claude-flow memory search [options]
-```
-
-## Options
-- `--query <text>` - Search query
-- `--pattern <regex>` - Pattern matching
-- `--limit <n>` - Result limit
-
-## Examples
-```bash
-# Search memory
-npx claude-flow memory search --query "authentication"
-
-# Pattern search
-npx claude-flow memory search --pattern "api-.*"
-
-# Limited results
-npx claude-flow memory search --query "config" --limit 10
-```

package/.claude/commands/memory/memory-usage.md

@@ -1,25 +0,0 @@
-# memory-usage
-
-Manage persistent memory storage.
-
-## Usage
-```bash
-npx claude-flow memory usage [options]
-```
-
-## Options
-- `--action <type>` - Action (store, retrieve, list, clear)
-- `--key <key>` - Memory key
-- `--value <data>` - Data to store (JSON)
-
-## Examples
-```bash
-# Store memory
-npx claude-flow memory usage --action store --key "project-config" --value '{"api": "v2"}'
-
-# Retrieve memory
-npx claude-flow memory usage --action retrieve --key "project-config"
-
-# List all keys
-npx claude-flow memory usage --action list
-```

package/.claude/commands/memory/neural.md

@@ -1,47 +0,0 @@
-# Neural Pattern Training
-
-## 🎯 Key Principle
-**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
-
-## MCP Tool Usage in Claude Code
-
-**Tool:** `mcp__claude-flow__neural_train`
-
-## Parameters
-```json
-{
-  "pattern_type": "coordination",
-  "training_data": "task decomposition patterns",
-  "epochs": 50
-}
-```
-
-## Description
-Improve coordination patterns through neural network training
-
-## Details
-Training improves:
-- Task breakdown effectiveness
-- Coordination pattern selection
-- Resource allocation strategies
-- Overall coordination efficiency
-
-## Example Usage
-
-**In Claude Code:**
-1. Train coordination patterns: Use tool `mcp__claude-flow__neural_train` with parameters `{"pattern_type": "coordination", "training_data": "successful task patterns", "epochs": 50}`
-2. Train optimization patterns: Use tool `mcp__claude-flow__neural_train` with parameters `{"pattern_type": "optimization", "training_data": "performance metrics", "epochs": 30}`
-3. Check training status: Use tool `mcp__claude-flow__neural_status`
-4. Analyze patterns: Use tool `mcp__claude-flow__neural_patterns` with parameters `{"action": "analyze"}`
-
-## Important Reminders
-- ✅ This tool provides coordination and structure
-- ✅ Claude Code performs all actual implementation
-- ❌ The tool does NOT write code
-- ❌ The tool does NOT access files directly
-- ❌ The tool does NOT execute commands
-
-## See Also
-- Main documentation: /CLAUDE.md
-- Other commands in this category
-- Workflow examples in /workflows/