Skip to content

v1.7.0 — Curated-Docs Search Lane + Recovery Ladder

Latest
Latest

Choose a tag to compare

View all tags
@evoleinik evoleinik released this 04 Jun 03:14
· 5 commits to main since this release
v1.7.0
715e229

Two feature waves since the last release (v1.4.0): a smarter recovery ladder that escalates failed regex searches automatically, and a new curated-docs search lane that surfaces a repo's learnings/, docs/, and git-tracked README/CLAUDE/MEMORY files alongside your session history.

What's New

Curated-docs search lane

One command now covers both "what did we discuss" (sessions) and "what's the documented gotcha" (curated notes):

  • Searches the cwd repo's learnings/ then docs/ (or CLAUDE_GREP_DOCS=dir1:dir2), plus every git-tracked README.md / CLAUDE.md / MEMORY.md at any depth.
  • Each hit is a navigable file:line § heading pointer — jump straight to it.
  • -s fuses a dense embedding lane with a BM25 keyword lane via reciprocal-rank fusion. Keyword lane needs no index, so doc search still works when Ollama is down.
  • New flags: --docs-only (head-safe, no session scan), --no-docs, --index --docs, --bench-docs, --mine-docs-queries.

Recovery ladder

When a regex returns nothing, claude-grep escalates automatically — within your chosen scope, never widening -a/-d:

  1. regex as typed
  2. tokenized — multi-word queries retry as AND-of-terms (no Ollama needed)
  3. semantic — embedding search

A stderr note tells you which layer answered. Near-miss hints suggest a simpler pattern when a complex one fails.

Worktree-aware paths

Run from a git worktree and claude-grep substitutes the main repo path, so you search the project's real session history instead of an empty worktree scope.

Benchmark harness

claude-grep --bench bench/queries.json runs the recovery ladder over a labeled query set and reports layer attribution — measure recall changes against bench/baseline.json.

Full Changelog

  • feat: curated-docs search lane (#2)
  • feat: --docs-only flag for head-safe curated-docs search
  • feat: search git-tracked README/CLAUDE/MEMORY in the curated-docs lane
  • feat: show file:line in curated-docs hits for navigable pointers
  • feat: regex->tokenized->semantic recovery ladder with layer telemetry
  • feat: tokenizedSearch — AND-session, OR-message recovery
  • feat: --bench harness over the live recovery ladder
  • feat: substitute main repo path when run from a git worktree
  • docs: restructure README for GitHub presentability

Full diff: v1.4.0...v1.7.0

Assets 2
Loading