Skip to content

Commit 959bfe7

Browse files
committed
docs: add Intelligent Git History epic (v0.4.0) to PLAN.md
- Mark Polish & Stabilize as complete - Add new current epic: Intelligent Git History (#90) - Document 5 sub-tasks (#91-#95) - Update architecture decisions - Move future git enhancements to v0.5+
1 parent 61c6c39 commit 959bfe7

File tree

1 file changed

+58
-26
lines changed

1 file changed

+58
-26
lines changed

PLAN.md

Lines changed: 58 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -126,46 +126,78 @@ Don't generate prose—provide structured data and let the LLM synthesize.
126126

127127
---
128128

129-
## Current: Polish & Stabilize (v0.3.x)
129+
## Completed: Polish & Stabilize (v0.3.x)
130130

131-
Focus on quality, documentation, and developer experience before adding new features.
131+
Focus on quality, documentation, and developer experience.
132132

133-
### Documentation
133+
### Documentation
134134

135-
| Task | Status | Priority |
136-
|------|--------|----------|
137-
| CLI reference docs | ✅ Done | 🟡 Medium |
138-
| Configuration guide | ✅ Done | 🟡 Medium |
139-
| Troubleshooting guide | ✅ Done | 🟡 Medium |
140-
| Examples for new tools | ✅ Done | 🟢 Low |
135+
| Task | Status |
136+
|------|--------|
137+
| CLI reference docs | ✅ Done |
138+
| Configuration guide | ✅ Done |
139+
| Troubleshooting guide | ✅ Done |
140+
| Examples for new tools | ✅ Done |
141141

142-
### Code Quality
142+
### Code Quality
143143

144-
| Task | Status | Priority |
145-
|------|--------|----------|
146-
| Fix lint warnings | ✅ Done | 🔴 High |
147-
| Context assembler tests | ✅ Done | 🟡 Medium |
148-
| Integration tests for new tools | ✅ Done | 🟢 Low |
144+
| Task | Status |
145+
|------|--------|
146+
| Fix lint warnings | ✅ Done |
147+
| Context assembler tests | ✅ Done |
148+
| Integration tests | ✅ Done |
149149

150-
### Issue Cleanup
150+
---
151+
152+
## Current: Intelligent Git History (v0.4.0)
153+
154+
> "Who changed what and why" - completing the context picture.
155+
156+
**Epic:** #90
157+
158+
### Philosophy
159+
160+
Git history is valuable context that LLMs can't easily access. We add intelligence:
161+
- **Semantic search** over commit messages (can't do with `git log --grep`)
162+
- **Change frequency** insights (which code is "hot"?)
163+
- **Auto-inclusion** in planning context
164+
165+
### Tasks
166+
167+
| Task | Issue | Status |
168+
|------|-------|--------|
169+
| Git types and extractor infrastructure | #91 | 🔲 Todo |
170+
| Commit indexing in core | #92 | 🔲 Todo |
171+
| `dev_history` MCP adapter | #93 | 🔲 Todo |
172+
| Change frequency in `dev_map` | #94 | 🔲 Todo |
173+
| History integration in `dev_plan` | #95 | 🔲 Todo |
174+
175+
### Architecture
176+
177+
- `GitExtractor` interface (pluggable for future GitHub API)
178+
- `GitCommit` type with PR/issue refs (for future linking)
179+
- Blame methods stubbed (for future `dev_blame`)
180+
- Cross-repo `repository` field in types
181+
182+
### Out of Scope (v0.5+)
151183

152-
| Task | Status | Priority |
153-
|------|--------|----------|
154-
| Close completed epics | ✅ Done | 🟡 Medium |
155-
| Update stale issues | ✅ Done | 🟢 Low |
184+
- `dev_blame` (line-level attribution)
185+
- PR/issue linking from commits
186+
- Contributor expertise mapping
187+
- Cross-repo history
156188

157189
---
158190

159-
## Future: Extended Intelligence (v0.4+)
191+
## Future: Extended Intelligence (v0.5+)
160192

161-
### Git History Context
193+
### Git History Enhancements
162194

163195
| Feature | Priority |
164196
|---------|----------|
165-
| Recent commits affecting file | 🟡 Medium |
166-
| Git blame integration | 🟡 Medium |
167-
| Related PRs for file/function | 🟡 Medium |
168-
| Change frequency analysis | ✅ Done (hot paths) |
197+
| `dev_blame` - line attribution | 🟡 Medium |
198+
| PR/issue linking from commits | 🟡 Medium |
199+
| Contributor expertise mapping | 🟢 Low |
200+
| Cross-repo history | 🟢 Low |
169201

170202
### Multi-Language Support
171203

0 commit comments

Comments
 (0)