Skip to content

Commit 78dbd52

Browse files
committed
docs(website): update to v0.8.4 release
Add v0.8.4 release notes for git analytics removal. Update latest version callout. Add deprecation notices to v0.8.0 section.
1 parent 69567d0 commit 78dbd52

File tree

2 files changed

+84
-48
lines changed

2 files changed

+84
-48
lines changed

website/content/latest-version.ts

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@
44
*/
55

66
export const latestVersion = {
7-
version: '0.8.2',
8-
title: 'Massive Indexing Performance & UX Improvements',
9-
date: 'December 13, 2025',
7+
version: '0.8.4',
8+
title: 'Refocus on Semantic Value',
9+
date: 'December 14, 2025',
1010
summary:
11-
'184% faster indexing with zero silent gaps, section-based progress display, and context-aware dev owners command.',
12-
link: '/updates#v082--massive-indexing-performance--ux-improvements',
11+
'Removed git analytics commands to focus on unique semantic capabilities. Cleaner codebase, clearer value proposition.',
12+
link: '/updates#v084--refocus-on-semantic-value',
1313
} as const;

website/content/updates/index.mdx

Lines changed: 79 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,83 @@ What's new in dev-agent. We ship improvements regularly to help AI assistants un
99

1010
---
1111

12+
## v0.8.4 — Refocus on Semantic Value
13+
14+
*December 14, 2025*
15+
16+
**Removed git analytics commands to refocus on dev-agent's unique semantic capabilities.**
17+
18+
### What Changed
19+
20+
**🗑️ Removed Features**
21+
22+
Eliminated CLI commands that duplicate git/GitHub functionality:
23+
24+
- **`dev owners`** — Use `git log --format="%ae" <path> | sort | uniq -c | sort -rn` or GitHub Contributors
25+
- **`dev activity`** — Use `git log --since="1 month" --name-only | sort | uniq -c | sort -rn`
26+
27+
**Impact:** -1,006 lines removed, cleaner codebase focused on unique semantic value.
28+
29+
### Why This Matters
30+
31+
Dev-agent's **unique value** is semantic understanding:
32+
33+
-**Semantic code search** (`dev_search`) — Find code by meaning, not keywords
34+
-**Semantic commit search** (`dev_history`) — Search git history by concept
35+
-**Code structure analysis** (`dev_map`, `dev_explore`) — AST + embeddings
36+
-**GitHub context** (`dev_plan`, `dev_gh`) — Cross-reference issues with code
37+
38+
Git analytics (ownership, activity) are better served by existing tools:
39+
- Git CLI has excellent built-in analytics
40+
- GitHub provides rich contributor visualizations
41+
- No need to duplicate what already works
42+
43+
### What's Kept
44+
45+
**Core semantic tools remain:**
46+
- `dev_search` — Semantic code search
47+
- `dev_history` — Semantic commit search
48+
- `dev_map` — Codebase structure with change frequency
49+
- `dev_plan` — GitHub issue context assembly
50+
- `dev_explore` — Code similarity and relationships
51+
- `dev_gh` — GitHub semantic search
52+
53+
**Supporting infrastructure:**
54+
- `code_metadata` table — Introspection of indexed code (LOC, functions, imports)
55+
- `calculateChangeFrequency` — Powers `dev_map` change frequency display
56+
57+
### Migration Guide
58+
59+
For git analytics, use standard tools:
60+
61+
```bash
62+
# Ownership by contributor
63+
git log --format="%ae" packages/core/ | sort | uniq -c | sort -rn
64+
65+
# Recent activity
66+
git log --since="1 month" --name-only | sort | uniq -c | sort -rn
67+
68+
# GitHub visualization
69+
# Visit: https://github.com/{org}/{repo}/graphs/contributors
70+
```
71+
72+
### Philosophy
73+
74+
**Dev-agent is an MCP context provider, not a CLI analytics dashboard.**
75+
76+
Focus on what AI assistants can't get elsewhere:
77+
- Semantic search over code and commits
78+
- AST-powered code structure analysis
79+
- Cross-referencing multiple data sources
80+
- Contextual code understanding
81+
82+
Leverage existing tools for what they do best:
83+
- Git for commit/author analytics
84+
- GitHub for contributor visualization
85+
- Dev-agent for semantic understanding
86+
87+
---
88+
1289
## v0.8.2 — Massive Indexing Performance & UX Improvements
1390

1491
*December 13, 2025*
@@ -52,52 +129,9 @@ dev index .
52129

53130
💡 Next steps:
54131
dev map Explore codebase structure
55-
dev owners See contributor stats
56-
dev activity Find active files
57132
```
58133

59134
**Applied to 4 commands:** `dev index`, `dev update`, `dev git index`, `dev github index`
60-
61-
**🔍 Context-Aware `dev owners` Command**
62-
63-
Completely redesigned to provide actionable insights based on your current context:
64-
65-
**Three Intelligent Modes:**
66-
67-
1. **Changed Files Mode** — Shows ownership of uncommitted changes (perfect for PR reviews)
68-
2. **Root Directory Mode** — High-level overview of top areas (`packages/cli/`, `packages/core/`)
69-
3. **Subdirectory Mode** — Detailed expertise for the specific area you're in
70-
71-
**Smart Ownership Display:**
72-
73-
```bash
74-
# Your file (minimal noise)
75-
└─ src/auth.ts
76-
@you • 50 commits • Last: 6 months ago
77-
78-
# Your file + recent activity by others (coordination warning)
79-
└─ src/auth.ts
80-
@you • 50 commits • Last: 6 months ago
81-
⚠️ Recent activity by @alice (yesterday)
82-
83-
💡 Suggested reviewers: @alice
84-
85-
# Someone else's stale file (review required)
86-
└─ ⚠️ src/legacy.ts
87-
@alice • 12 commits • Last: 2 years ago
88-
89-
# New file (no history)
90-
└─ 🆕 src/feature.ts
91-
New file
92-
```
93-
94-
**Key Features:**
95-
96-
- **Asymmetric icons** — Only flags exceptions (⚠️ others' files, 🆕 new files)
97-
- **Last touched timestamps** — Catches stale code and active development
98-
- **Recent activity detection** — Warns when others recently modified your files
99-
- **Suggested reviewers** — Auto-identifies who to loop in for code reviews
100-
- **Real-time git log analysis** — Works for uncommitted changes
101135
- **Git root detection** — Works from any subdirectory
102136

103137
### Architecture Simplifications
@@ -162,6 +196,8 @@ No re-index required. Changes take effect immediately.
162196

163197
*December 13, 2025*
164198

199+
> **⚠️ Deprecation Notice:** `dev owners` and `dev activity` were removed in v0.8.4. Use `git log` or GitHub for contributor analytics. Dev-agent now focuses on semantic search and code understanding.
200+
165201
**New developer activity and ownership commands with 35x faster queries via indexed author contributions.**
166202

167203
### What's New

0 commit comments

Comments
 (0)