claude-flow-novice 1.5.2 → 1.5.3

package/.claude-flow-novice/dist/src/cli/simple-commands/init/templates/commands/hooks/pre-search.md

@@ -0,0 +1,112 @@
+# 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/.claude-flow-novice/dist/src/cli/simple-commands/init/templates/commands/hooks/pre-task.md

@@ -0,0 +1,111 @@
+# 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-flow-novice/dist/src/cli/simple-commands/init/templates/commands/hooks/session-end.md

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

@@ -0,0 +1,118 @@
+# 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/.claude-flow-novice/dist/src/cli/simple-commands/init/templates/commands/hooks/session-start.md

@@ -0,0 +1,117 @@
+# 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