bobbin-ai 0.25.2

Local-first context injection engine for AI coding agents
# Roadmap

> **Implementation status (2026-07-23, kelly):** 🟡 **Phased — 1-2 complete, 3-4 in
> progress** (self-tracked by the `[x]` checkboxes below, which are the per-item source
> of truth). Spot-checked against `src/`: the Phase 1-2 items (tree-sitter indexing,
> LanceDB storage, hybrid search, git coupling, related-files) are shipped. NOTE the
> "Phase 4: Higher-Order Analysis -- In Progress" header UNDERSTATES — its features
> (`similar` / `hotspots` / `review` / `impact` / `refs`) are actually shipped as CLI
> subcommands + MCP tools (see `docs/design/phase-4-features.md`, ✅).

## Phase 1: Foundation (MVP) -- Complete

- [x] Tree-sitter code indexing (Rust, TypeScript, Python)
- [x] LanceDB vector storage
- [x] SQLite metadata + FTS
- [x] CLI: `init` command
- [x] CLI: `index` command (full and incremental)
- [x] Configuration management
- [x] ONNX embedding generation
- [x] CLI: `search` command
- [x] CLI: `grep` command
- [x] CLI: `status` command

## Phase 2: Intelligence -- Complete

- [x] Hybrid search (RRF combining semantic + keyword)
- [x] Git temporal coupling analysis
- [x] Related files suggestions
- [x] Additional language support (Go, Java, C++)

## Phase 3: Polish -- In Progress

- [x] MCP server integration (`bobbin serve`)
- [x] Multi-repo support (`--repo` flag)
- [x] LanceDB-primary storage consolidation
- [x] Contextual embeddings
- [x] Semantic markdown chunking (pulldown-cmark)
- [x] File history and churn analysis (`bobbin history`)
- [x] Context assembly command (`bobbin context`)
- [x] Watch mode / file watcher daemon (`bobbin watch`)
- [x] Shell completions (`bobbin completions`)
- [x] Code hotspot identification (`bobbin hotspots`)
- [x] Symbol reference resolution (`bobbin refs`)
- [x] Import/dependency analysis (`bobbin deps`)
- [x] AST complexity metrics
- [x] Transitive impact analysis with decay
- [x] Thin-client HTTP mode (`--server` flag)
- [ ] Configurable embedding models (infrastructure exists, UI incomplete)
- [ ] Integration tests against real repos
- [ ] Performance optimizations at scale

### Phase 3.5: Production Hardening -- In Progress

See `docs/plans/production-hardening.md` for details.

- [x] Install protoc + `just setup` recipe (bobbin-1nv)
- [x] Clean up tambour references (bobbin-7pn)
- [x] Fix production unwrap() calls (bobbin-ehp)
- [x] Integration test foundation (bobbin-ul6)
- [ ] Add missing MCP tools — deps, history, status (bobbin-tnt)
- [x] Add missing HTTP endpoints (bobbin-pid)
- [x] Wire up incremental indexing (bobbin-thb)
- [x] CI pipeline — GitHub Actions (bobbin-ola)
- [x] Update AGENTS.md and CONTRIBUTING.md (bobbin-6lx)

## Phase 4: Higher-Order Analysis -- In Progress

Compose existing signals into capabilities greater than the sum of their parts.
See `docs/plans/backlog.md` for detailed exploration of each feature.

- [ ] Test coverage mapping via git coupling
- [x] Claude Code hooks / tool integration
- [ ] Semantic commit indexing
- [ ] Refactoring planner (rename, move, extract)
- [ ] Cross-repo temporal coupling
- [ ] PageRank / Personalized PageRank ranking signal — compose git coupling,
      import deps, and symbol edges into a graph-proximity signal fused into RRF.
      See `docs/plans/ppr-ranking-signal.md` (Quipu owns the primitive; Bobbin
      consumes it). Motivated by the HippoRAG comparison.