Overview
This release fixes fresh clone crashes and reduces semantic-search triggers to eliminate overlap with multi-agent-researcher.
Bug Fixes
P0: Fresh Clone Crashes Fixed
- Problem: Fresh clones crashed when
~/.claude_code_search/projects/directory didn't exist - Root Cause:
_acquire_reindex_lock()didn't create storage directory before lock file creation - Fix: Added
storage_dir.mkdir(parents=True, exist_ok=True)
Debug Logging Added
- Added traceback logging to stderr in first-prompt hook exception handler
- Previously exceptions were silently swallowed, making debugging impossible
Refactoring
Semantic-Search Trigger Reduction (YAGNI)
| Metric | Before | After | Reduction |
|---|---|---|---|
| Keywords | 70 | 49 | 30% |
| Intent Patterns | 28 | 17 | 39% |
Removed (overlapped with multi-agent-researcher):
- Generic questions: "how does", "how is", "where is", "what is", "show me"
- Explanations: "explain the code", "explain implementation"
- Similarity: "find similar", "similar to", "like this"
- References: "all occurrences of", "where else", "show all references"
Kept (unambiguous):
- Indexing operations (18 keywords)
- Explicit codebase references (16 keywords)
- Documentation search (15 keywords)
Upgrade Notes
No breaking changes. Simply pull the latest:
git pull origin mainFiles Changed
.claude/utils/reindex_manager.py- Storage directory auto-creation.claude/hooks/first-prompt-reindex.py- Debug logging, state dir safety.claude/skills/skill-rules.json- Reduced semantic-search triggers (-30 lines)
Full Release Notes: docs/release/RELEASE_NOTES_v2.5.4.md