Epic: Intelligent Git History (v0.4.0)

[prosdev]

Epic: Intelligent Git History (v0.4.0)

Overview

Add semantic search over git history and integrate change intelligence into existing tools. This isn't just wrapping git log - we're making history searchable by meaning and automatically relevant.

Philosophy

"Who changed what and why" - completing the context picture.

Git history is valuable context that LLMs can't easily access. But raw git log output isn't enough - we add intelligence:

• Semantic search over commit messages (can't do with git log --grep)
• Change frequency insights (which code is "hot"?)
• Auto-inclusion in planning context

Success Criteria

• dev_history finds commits by semantic meaning
• dev_map shows change frequency per directory
• dev_plan auto-includes relevant commit history
• Commits indexed during dev index .
• Token budgets respected
• Works on repos with 10K+ commits
• Architecture supports future: blame, cross-repo, contributor stats

Tasks

• Git types and extractor infrastructure #91 Git types and extractor infrastructure
• Commit indexing in core #92 Commit indexing in core
• dev_history MCP adapter #93 dev_history MCP adapter
• Change frequency in dev_map #94 Change frequency in dev_map
• History integration in dev_plan #95 History integration in dev_plan

Architecture Decisions

Extensibility built-in:

• GitExtractor interface (swap local git for GitHub API later)
• GitCommit type includes PR/issue refs (for future linking)
• Blame methods stubbed (for future dev_blame)
• Cross-repo repository field in types

Keep it simple:

• Shell out to git (no new dependencies)
• Same LanceDB for commit embeddings
• Consistent indexer shape (not full adapter pattern yet)

Out of Scope (v0.5+)

• dev_blame (line-level attribution)
• PR/issue linking from commits
• Contributor expertise mapping
• Cross-repo history

Estimate

~5 days total

Related

• Builds on: Epic Epic: Context Quality (v0.2) #79 (Context Quality)
• Philosophy: PLAN.md "be the best context provider"