claude-flow 2.0.0-alpha.2 → 2.0.0-alpha.21

package/src/cli/simple-commands/init/templates/commands/hooks/pre-search.md

@@ -0,0 +1,105 @@
+# hook pre-search
+
+Optimize search operations with caching and intelligent filtering.
+
+## Usage
+
+```bash
+npx claude-flow hook pre-search [options]
+```
+
+## Options
+
+- `--query, -q <text>` - Search query to optimize
+- `--cache-results` - Cache search results (default: true)
+- `--suggest-filters` - Suggest search filters
+- `--check-memory` - Check memory for answers
+- `--expand-query` - Expand search terms
+
+## Examples
+
+### Basic pre-search hook
+```bash
+npx claude-flow hook pre-search --query "authentication implementation"
+```
+
+### With caching
+```bash
+npx claude-flow hook pre-search -q "React hooks usage" --cache-results
+```
+
+### Memory check first
+```bash
+npx claude-flow hook pre-search -q "previous bug fixes" --check-memory
+```
+
+### Query expansion
+```bash
+npx claude-flow hook pre-search -q "auth" --expand-query --suggest-filters
+```
+
+## Features
+
+### Result Caching
+- Stores search results
+- Enables instant retrieval
+- Reduces redundant searches
+- Updates intelligently
+
+### Filter Suggestions
+- File type filters
+- Directory scoping
+- Time-based filtering
+- Pattern matching
+
+### Memory Checking
+- Searches stored knowledge
+- Finds previous results
+- Avoids repetition
+- Speeds up retrieval
+
+### Query Expansion
+- Adds synonyms
+- Includes related terms
+- Handles abbreviations
+- Improves coverage
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+- Using Grep tool
+- Using Glob tool
+- Searching codebase
+- Finding patterns
+
+Manual usage in agents:
+```bash
+# Before searching
+npx claude-flow hook pre-search --query "your search" --cache-results --check-memory
+```
+
+## Output
+
+Returns JSON with:
+```json
+{
+  "query": "authentication implementation",
+  "cached": true,
+  "cacheHit": false,
+  "memoryResults": 3,
+  "expandedQuery": "(auth|authentication|login|oauth) (impl|implementation|code)",
+  "suggestedFilters": [
+    "*.js",
+    "*.ts",
+    "src/**"
+  ],
+  "estimatedFiles": 45
+}
+```
+
+## See Also
+
+- `Grep` - Content search tool
+- `Glob` - File pattern tool
+- `memory search` - Memory queries
+- `cache manage` - Cache operations

package/src/cli/simple-commands/init/templates/commands/hooks/pre-task.md

@@ -1,11 +1,11 @@
-# hooks pre-task
+# hook pre-task
 
 Execute pre-task preparations and context loading.
 
 ## Usage
 
 ```bash
-npx claude-flow hooks pre-task [options]
+npx claude-flow hook pre-task [options]
 ```
 
 ## Options
@@ -20,22 +20,22 @@ npx claude-flow hooks pre-task [options]
 
 ### Basic pre-task hook
 ```bash
-npx claude-flow hooks pre-task --description "Implement user authentication"
+npx claude-flow hook pre-task --description "Implement user authentication"
 ```
 
 ### With memory loading
 ```bash
-npx claude-flow hooks pre-task -d "Continue API development" --load-memory
+npx claude-flow hook pre-task -d "Continue API development" --load-memory
 ```
 
 ### Manual agent control
 ```bash
-npx claude-flow hooks pre-task -d "Debug issue #123" --auto-spawn-agents false
+npx claude-flow hook pre-task -d "Debug issue #123" --auto-spawn-agents false
 ```
 
 ### Full optimization
 ```bash
-npx claude-flow hooks pre-task -d "Refactor codebase" --optimize-topology --estimate-complexity
+npx claude-flow hook pre-task -d "Refactor codebase" --optimize-topology --estimate-complexity
 ```
 
 ## Features
@@ -75,7 +75,7 @@ This hook is automatically called by Claude Code when:
 Manual usage in agents:
 ```bash
 # In agent coordination
-npx claude-flow hooks pre-task --description "Your task here"
+npx claude-flow hook pre-task --description "Your task here"
 ```
 
 ## Output
@@ -94,7 +94,7 @@ Returns JSON with:
 
 ## See Also
 
-- `hooks post-task` - Post-task cleanup
+- `hook post-task` - Post-task cleanup
 - `agent spawn` - Manual agent creation
 - `memory usage` - Memory management
 - `swarm init` - Swarm initialization

package/src/cli/simple-commands/init/templates/commands/hooks/session-end.md

@@ -0,0 +1,107 @@
+# 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/src/cli/simple-commands/init/templates/commands/hooks/session-restore.md

@@ -0,0 +1,110 @@
+# hook session-restore
+
+Restore a previous session's context and state.
+
+## Usage
+
+```bash
+npx claude-flow hook session-restore [options]
+```
+
+## Options
+
+- `--session-id, -s <id>` - Session ID to restore
+- `--load-memory` - Load session memories (default: true)
+- `--restore-files` - Reopen previous files
+- `--resume-tasks` - Continue incomplete tasks
+- `--merge-context` - Merge with current context
+
+## Examples
+
+### Basic session restore
+```bash
+npx claude-flow hook session-restore --session-id "dev-session-2024"
+```
+
+### Full restoration
+```bash
+npx claude-flow hook session-restore -s "feature-auth" --load-memory --restore-files --resume-tasks
+```
+
+### Selective restore
+```bash
+npx claude-flow hook session-restore -s "bug-fix-123" --load-memory --resume-tasks
+```
+
+### Context merging
+```bash
+npx claude-flow hook session-restore -s "refactor-api" --merge-context
+```
+
+## Features
+
+### Memory Loading
+- Retrieves stored decisions
+- Loads implementation notes
+- Restores agent configs
+- Recovers context
+
+### File Restoration
+- Lists previously open files
+- Suggests file reopening
+- Maintains edit history
+- Preserves cursor positions
+
+### Task Resumption
+- Shows incomplete tasks
+- Restores task progress
+- Loads task dependencies
+- Continues workflows
+
+### Context Merging
+- Combines sessions
+- Merges memories
+- Unifies task lists
+- Prevents conflicts
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+- Resuming previous work
+- After unexpected shutdown
+- Loading saved sessions
+- Switching between projects
+
+Manual usage in agents:
+```bash
+# To restore context
+npx claude-flow hook session-restore --session-id "previous-session" --load-memory
+```
+
+## Output
+
+Returns JSON with:
+```json
+{
+  "sessionId": "dev-session-2024",
+  "restored": true,
+  "memories": 25,
+  "files": [
+    "src/auth/login.js",
+    "src/api/users.js"
+  ],
+  "tasks": {
+    "incomplete": 3,
+    "completed": 12
+  },
+  "context": {
+    "project": "auth-system",
+    "branch": "feature/oauth"
+  },
+  "warnings": []
+}
+```
+
+## See Also
+
+- `hook session-start` - New session setup
+- `hook session-end` - Session cleanup
+- `memory usage` - Memory operations
+- `task status` - Task checking

package/src/cli/simple-commands/init/templates/commands/hooks/session-start.md

@@ -0,0 +1,106 @@
+# hook session-start
+
+Initialize a new work session with context loading and environment setup.
+
+## Usage
+
+```bash
+npx claude-flow hook session-start [options]
+```
+
+## Options
+
+- `--session-id, -s <id>` - Unique session identifier
+- `--restore-context` - Restore previous session context (default: true)
+- `--load-preferences` - Load user preferences
+- `--init-swarm` - Initialize swarm automatically
+- `--telemetry` - Enable session telemetry
+
+## Examples
+
+### Basic session start
+```bash
+npx claude-flow hook session-start --session-id "dev-session-2024"
+```
+
+### With full restoration
+```bash
+npx claude-flow hook session-start -s "feature-auth" --restore-context --load-preferences
+```
+
+### Auto swarm initialization
+```bash
+npx claude-flow hook session-start -s "bug-fix-789" --init-swarm
+```
+
+### Telemetry enabled
+```bash
+npx claude-flow hook session-start -s "performance-opt" --telemetry
+```
+
+## Features
+
+### Context Restoration
+- Loads previous session state
+- Restores open files
+- Recovers task progress
+- Maintains continuity
+
+### Preference Loading
+- User configuration
+- Editor settings
+- Tool preferences
+- Custom shortcuts
+
+### Swarm Initialization
+- Auto-detects project type
+- Spawns relevant agents
+- Configures topology
+- Prepares coordination
+
+### Telemetry Setup
+- Tracks session metrics
+- Monitors performance
+- Records patterns
+- Enables analytics
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+- Starting a new conversation
+- Beginning work session
+- After Claude Code restart
+- Switching projects
+
+Manual usage in agents:
+```bash
+# At session start
+npx claude-flow hook session-start --session-id "your-session" --restore-context
+```
+
+## Output
+
+Returns JSON with:
+```json
+{
+  "sessionId": "dev-session-2024",
+  "restored": true,
+  "previousSession": "dev-session-2023",
+  "contextLoaded": {
+    "files": 5,
+    "tasks": 3,
+    "memories": 12
+  },
+  "swarmInitialized": true,
+  "topology": "hierarchical",
+  "agentsReady": 6,
+  "telemetryEnabled": true
+}
+```
+
+## See Also
+
+- `hook session-end` - Session cleanup
+- `hook session-restore` - Manual restoration
+- `swarm init` - Swarm initialization
+- `memory usage` - Memory management