|
| 1 | +# Testing StackMemory Hooks & Persistence |
| 2 | + |
| 3 | +## Quick Test |
| 4 | + |
| 5 | +Run the automated test script: |
| 6 | +```bash |
| 7 | +./scripts/test-hooks-persistence.sh |
| 8 | +``` |
| 9 | + |
| 10 | +## Manual Testing |
| 11 | + |
| 12 | +### 1. Test Clear Hook (Context Preservation) |
| 13 | +```bash |
| 14 | +# Add some context |
| 15 | +stackmemory context add "Working on feature X" --type task |
| 16 | + |
| 17 | +# Trigger clear (simulates Claude clear) |
| 18 | +~/.claude/hooks/on-clear |
| 19 | + |
| 20 | +# Verify context survived |
| 21 | +stackmemory context list --limit 5 |
| 22 | +``` |
| 23 | + |
| 24 | +### 2. Test Task Completion Hook |
| 25 | +```bash |
| 26 | +# Simulate task completion |
| 27 | +export CLAUDE_TASK_SUMMARY="Implemented new API endpoint" |
| 28 | +export CLAUDE_TASK_STATUS="completed" |
| 29 | +~/.claude/hooks/on-task-complete |
| 30 | + |
| 31 | +# Check if recorded |
| 32 | +stackmemory context list --type task |
| 33 | +``` |
| 34 | + |
| 35 | +### 3. Test Quality Gate |
| 36 | +```bash |
| 37 | +# Create a file with issues |
| 38 | +echo 'console.log("debug");' > test.js |
| 39 | + |
| 40 | +# Test quality check |
| 41 | +export CLAUDE_ACTION="commit" |
| 42 | +export CLAUDE_FILES="test.js" |
| 43 | +~/.claude/hooks/on-action-blocked |
| 44 | + |
| 45 | +# Should show quality warnings |
| 46 | +``` |
| 47 | + |
| 48 | +### 4. Test Monitoring |
| 49 | +```bash |
| 50 | +# Start monitoring |
| 51 | +stackmemory monitor start |
| 52 | + |
| 53 | +# Do some work (add context) |
| 54 | +stackmemory context add "Debug session" --type debug |
| 55 | + |
| 56 | +# Check monitoring captured it |
| 57 | +stackmemory monitor status |
| 58 | +``` |
| 59 | + |
| 60 | +### 5. Test Shared Context Persistence |
| 61 | +```bash |
| 62 | +# Check shared context file |
| 63 | +cat ~/.stackmemory/data/shared-context.json | jq '.frames | length' |
| 64 | + |
| 65 | +# Add through CLI |
| 66 | +stackmemory context add "Shared knowledge" --tags important,shared |
| 67 | + |
| 68 | +# Verify in shared context |
| 69 | +cat ~/.stackmemory/data/shared-context.json | jq '.frames[-1]' |
| 70 | +``` |
| 71 | + |
| 72 | +### 6. Test Handoff Generation |
| 73 | +```bash |
| 74 | +# Generate handoff after some work |
| 75 | +stackmemory context handoff |
| 76 | + |
| 77 | +# Should show summary of recent work |
| 78 | +``` |
| 79 | + |
| 80 | +## Verification Points |
| 81 | + |
| 82 | +### Check Persistence Locations |
| 83 | + |
| 84 | +**Global Data:** |
| 85 | +```bash |
| 86 | +ls -la ~/.stackmemory/data/ |
| 87 | +# Should see: shared-context.json, frames/, monitoring.json |
| 88 | +``` |
| 89 | + |
| 90 | +**Project Context:** |
| 91 | +```bash |
| 92 | +ls -la ./.stackmemory/context/ |
| 93 | +# Should see: project-context.json, branch contexts |
| 94 | +``` |
| 95 | + |
| 96 | +### Inspect Frame Data |
| 97 | +```bash |
| 98 | +# List all frames |
| 99 | +stackmemory context list --json | jq '.frames[].type' | sort | uniq -c |
| 100 | + |
| 101 | +# Show specific frame |
| 102 | +stackmemory context show <frame-id> --json | jq |
| 103 | +``` |
| 104 | + |
| 105 | +### Monitor Hook Activity |
| 106 | +```bash |
| 107 | +# Check hook logs |
| 108 | +tail -f ~/.stackmemory/logs/hooks.log |
| 109 | + |
| 110 | +# Watch daemon activity |
| 111 | +stackmemory-daemon status --watch |
| 112 | +``` |
| 113 | + |
| 114 | +## Expected Behavior |
| 115 | + |
| 116 | +1. **on-clear**: Should preserve important context with 'clear_survival' tag |
| 117 | +2. **on-task-complete**: Should create task frame with completion details |
| 118 | +3. **on-action-blocked**: Should validate quality and potentially block |
| 119 | +4. **Monitoring**: Should auto-checkpoint every 15 minutes |
| 120 | +5. **Shared Context**: Should persist across sessions and branches |
| 121 | +6. **Handoff**: Should generate useful summary for next session |
| 122 | + |
| 123 | +## Troubleshooting |
| 124 | + |
| 125 | +### Hooks Not Firing |
| 126 | +```bash |
| 127 | +# Check hooks are installed |
| 128 | +ls -la ~/.claude/hooks/ |
| 129 | + |
| 130 | +# Verify executable |
| 131 | +chmod +x ~/.claude/hooks/* |
| 132 | + |
| 133 | +# Test directly |
| 134 | +~/.claude/hooks/on-clear |
| 135 | +``` |
| 136 | + |
| 137 | +### Data Not Persisting |
| 138 | +```bash |
| 139 | +# Check daemon is running |
| 140 | +stackmemory-daemon status |
| 141 | + |
| 142 | +# Restart if needed |
| 143 | +stackmemory-daemon restart |
| 144 | + |
| 145 | +# Check permissions |
| 146 | +ls -la ~/.stackmemory/data/ |
| 147 | +``` |
| 148 | + |
| 149 | +### Context Not Loading |
| 150 | +```bash |
| 151 | +# Force reload |
| 152 | +stackmemory context sync |
| 153 | + |
| 154 | +# Check shared context |
| 155 | +stackmemory context list --shared |
| 156 | + |
| 157 | +# Rebuild index |
| 158 | +stackmemory context reindex |
| 159 | +``` |
| 160 | + |
| 161 | +## Integration with Claude Code |
| 162 | + |
| 163 | +The hooks integrate with Claude Code's lifecycle: |
| 164 | + |
| 165 | +1. **Session Start**: Auto-loads context via STACKMEMORY.md |
| 166 | +2. **During Work**: Monitors and checkpoints progress |
| 167 | +3. **Task Complete**: Records completion via hook |
| 168 | +4. **Clear Command**: Preserves context via on-clear |
| 169 | +5. **Session End**: Generates handoff for next session |
| 170 | + |
| 171 | +Test in Claude Code by: |
| 172 | +1. Starting a new session - should load context |
| 173 | +2. Working on tasks - should track progress |
| 174 | +3. Using /clear - should preserve important context |
| 175 | +4. Completing tasks - should record achievements |
0 commit comments