clawd
d81e403f01
COMPLETED TASKS: ✅ 06-01: Workout Swap System - Added swapped_from_id to workout_logs - Created workout_swaps table for history - POST /api/workouts/:id/swap endpoint - GET /api/workouts/available endpoint - Reversible swaps with audit trail ✅ 06-02: Muscle Group Recovery Tracking - Created muscle_group_recovery table - Implemented calculateRecoveryScore() function - GET /api/recovery/muscle-groups endpoint - GET /api/recovery/most-recovered endpoint - Auto-tracking on workout log completion ✅ 06-03: Smart Workout Recommendations - GET /api/recommendations/smart-workout endpoint - 7-day workout analysis algorithm - Recovery-based filtering (>30% threshold) - Top 3 recommendations with context - Context-aware reasoning messages DATABASE CHANGES: - Added 4 new tables: muscle_group_recovery, workout_swaps, custom_workouts, custom_workout_exercises - Extended workout_logs with: swapped_from_id, source_type, custom_workout_id, custom_workout_exercise_id - Created 7 new indexes for performance IMPLEMENTATION: - Recovery service with 4 core functions - 2 new route handlers (recovery, smartRecommendations) - Updated workouts router with swap endpoints - Integrated recovery tracking into POST /api/logs - Full error handling and logging TESTING: - Test file created: /backend/test/phase-06-tests.js - Ready for E2E and staging validation STATUS: Ready for frontend integration and production review Branch: feature/06-phase-06
103 lines
1.9 KiB
Markdown
103 lines
1.9 KiB
Markdown
# 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'"
|
|
}]
|
|
}
|
|
``` |