Remove unnecessary troubleshooting checks from skill
Simplified troubleshooting diagnostics by removing checks that are: - Too brittle (300+ packages requirement) - Not relevant to v5.2.2 issues (version cache) - Redundant (Node.js version checks) Changes: - Removed "300+ packages installed" expectation - Removed entire "Step 5: Check Version Cache" section - Removed dependency count check (ls node_modules/ | wc -l) - Removed Node.js version checks from multiple sections - Renumbered steps from 8 to 7 Result: More focused diagnostics for reported issues (memory persistence, viewer state, observation freshness) without false positives. Co-authored-by: Alex Newman <thedotmack@users.noreply.github.com>
This commit is contained in:
@@ -109,7 +109,6 @@ Verify all required npm packages are installed:
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd ~/.claude/plugins/marketplaces/thedotmack/
|
cd ~/.claude/plugins/marketplaces/thedotmack/
|
||||||
ls node_modules/ | wc -l
|
|
||||||
|
|
||||||
# Check for critical packages
|
# Check for critical packages
|
||||||
ls node_modules/@anthropic-ai/claude-agent-sdk 2>&1 | head -1
|
ls node_modules/@anthropic-ai/claude-agent-sdk 2>&1 | head -1
|
||||||
@@ -118,9 +117,7 @@ ls node_modules/express 2>&1 | head -1
|
|||||||
ls node_modules/pm2 2>&1 | head -1
|
ls node_modules/pm2 2>&1 | head -1
|
||||||
```
|
```
|
||||||
|
|
||||||
**Expected:**
|
**Expected:** All critical packages present
|
||||||
- 300+ packages installed
|
|
||||||
- All critical packages present
|
|
||||||
|
|
||||||
**If dependencies missing:**
|
**If dependencies missing:**
|
||||||
```bash
|
```bash
|
||||||
@@ -128,26 +125,7 @@ cd ~/.claude/plugins/marketplaces/thedotmack/
|
|||||||
npm install
|
npm install
|
||||||
```
|
```
|
||||||
|
|
||||||
### 5. Check Version Cache
|
### 5. Check Worker Logs
|
||||||
|
|
||||||
The plugin uses smart caching to avoid redundant npm installs. Check if cache is stale:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Check installed version marker
|
|
||||||
cat ~/.claude/plugins/marketplaces/thedotmack/.install-version 2>/dev/null
|
|
||||||
|
|
||||||
# Compare with package.json
|
|
||||||
grep '"version"' ~/.claude/plugins/marketplaces/thedotmack/package.json
|
|
||||||
```
|
|
||||||
|
|
||||||
**If versions don't match:**
|
|
||||||
```bash
|
|
||||||
cd ~/.claude/plugins/marketplaces/thedotmack/
|
|
||||||
npm install
|
|
||||||
# Cache will auto-update on next session
|
|
||||||
```
|
|
||||||
|
|
||||||
### 6. Check Worker Logs
|
|
||||||
|
|
||||||
Review recent worker logs for errors:
|
Review recent worker logs for errors:
|
||||||
|
|
||||||
@@ -163,7 +141,7 @@ node_modules/.bin/pm2 logs claude-mem-worker --lines 50 --nostream
|
|||||||
pm2 logs claude-mem-worker --lines 100 --nostream | grep -i "error\|exception\|failed"
|
pm2 logs claude-mem-worker --lines 100 --nostream | grep -i "error\|exception\|failed"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 7. Test Viewer UI
|
### 6. Test Viewer UI
|
||||||
|
|
||||||
Check if the web viewer is accessible:
|
Check if the web viewer is accessible:
|
||||||
|
|
||||||
@@ -179,7 +157,7 @@ curl -s http://127.0.0.1:37777/api/stats
|
|||||||
- `/` returns HTML page with React viewer
|
- `/` returns HTML page with React viewer
|
||||||
- `/api/stats` returns JSON with database counts
|
- `/api/stats` returns JSON with database counts
|
||||||
|
|
||||||
### 8. Check Port Configuration
|
### 7. Check Port Configuration
|
||||||
|
|
||||||
Verify port settings and availability:
|
Verify port settings and availability:
|
||||||
|
|
||||||
@@ -273,20 +251,16 @@ node_modules/.bin/pm2 logs claude-mem-worker --lines 20 --nostream
|
|||||||
**Root cause:**
|
**Root cause:**
|
||||||
- Port already in use
|
- Port already in use
|
||||||
- PM2 not installed or not in PATH
|
- PM2 not installed or not in PATH
|
||||||
- Node.js version incompatible
|
- Missing dependencies
|
||||||
|
|
||||||
**Fix:**
|
**Fix:**
|
||||||
1. Check Node.js version (requires >= 18.0.0):
|
1. Try manual worker start:
|
||||||
```bash
|
|
||||||
node --version
|
|
||||||
```
|
|
||||||
2. Try manual worker start:
|
|
||||||
```bash
|
```bash
|
||||||
cd ~/.claude/plugins/marketplaces/thedotmack/
|
cd ~/.claude/plugins/marketplaces/thedotmack/
|
||||||
node plugin/scripts/worker-service.cjs
|
node plugin/scripts/worker-service.cjs
|
||||||
# Should start server on port 37777
|
# Should start server on port 37777
|
||||||
```
|
```
|
||||||
3. If port in use, change it:
|
2. If port in use, change it:
|
||||||
```bash
|
```bash
|
||||||
echo '{"env":{"CLAUDE_MEM_WORKER_PORT":"37778"}}' > ~/.claude-mem/settings.json
|
echo '{"env":{"CLAUDE_MEM_WORKER_PORT":"37778"}}' > ~/.claude-mem/settings.json
|
||||||
```
|
```
|
||||||
@@ -300,13 +274,11 @@ Run this comprehensive diagnostic script:
|
|||||||
echo "=== Claude-Mem Troubleshooting Report ==="
|
echo "=== Claude-Mem Troubleshooting Report ==="
|
||||||
echo ""
|
echo ""
|
||||||
echo "1. Environment"
|
echo "1. Environment"
|
||||||
echo " Node version: $(node --version)"
|
|
||||||
echo " OS: $(uname -s)"
|
echo " OS: $(uname -s)"
|
||||||
echo ""
|
echo ""
|
||||||
echo "2. Plugin Installation"
|
echo "2. Plugin Installation"
|
||||||
echo " Plugin directory exists: $([ -d ~/.claude/plugins/marketplaces/thedotmack ] && echo 'YES' || echo 'NO')"
|
echo " Plugin directory exists: $([ -d ~/.claude/plugins/marketplaces/thedotmack ] && echo 'YES' || echo 'NO')"
|
||||||
echo " Package version: $(grep '"version"' ~/.claude/plugins/marketplaces/thedotmack/package.json 2>/dev/null | head -1)"
|
echo " Package version: $(grep '"version"' ~/.claude/plugins/marketplaces/thedotmack/package.json 2>/dev/null | head -1)"
|
||||||
echo " Dependencies count: $(ls ~/.claude/plugins/marketplaces/thedotmack/node_modules/ 2>/dev/null | wc -l)"
|
|
||||||
echo ""
|
echo ""
|
||||||
echo "3. Database"
|
echo "3. Database"
|
||||||
echo " Database exists: $([ -f ~/.claude-mem/claude-mem.db ] && echo 'YES' || echo 'NO')"
|
echo " Database exists: $([ -f ~/.claude-mem/claude-mem.db ] && echo 'YES' || echo 'NO')"
|
||||||
@@ -360,7 +332,6 @@ Post to: https://github.com/thedotmack/claude-mem/issues
|
|||||||
- Monitor database size (shouldn't grow unbounded)
|
- Monitor database size (shouldn't grow unbounded)
|
||||||
- Update plugin when new versions are released
|
- Update plugin when new versions are released
|
||||||
- Keep Claude Code updated
|
- Keep Claude Code updated
|
||||||
- Ensure Node.js stays >= 18.0.0
|
|
||||||
|
|
||||||
**Performance tuning:**
|
**Performance tuning:**
|
||||||
- Adjust `CLAUDE_MEM_CONTEXT_OBSERVATIONS` if context is too large/small
|
- Adjust `CLAUDE_MEM_CONTEXT_OBSERVATIONS` if context is too large/small
|
||||||
|
|||||||
Reference in New Issue
Block a user