Skip to content

Commit 4bc1497

Browse files
committed
docs(website): add Updates section with release notes
- Add /updates page with friendly release notes for all versions - Cover v0.5.0, v0.4.4, v0.4.0, v0.3.0, and v0.1.0 - Update home page callout to link to Updates instead of GitHub - Write in accessible language for developers and product managers
1 parent d0481b4 commit 4bc1497

File tree

4 files changed

+204
-1
lines changed

4 files changed

+204
-1
lines changed

website/content/_meta.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
export default {
22
index: 'Home',
33
docs: 'Documentation',
4+
updates: 'Updates',
45
};

website/content/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Local semantic code search for Cursor and Claude Code via MCP.
1111
[Get Started](/docs) · [View on GitHub](https://github.com/lytics/dev-agent)
1212

1313
<Callout type="info">
14-
**v0.4.4**Search results now show related test files automatically. [See what's new →](https://github.com/lytics/dev-agent/releases)
14+
**v0.5.0 coming soon**Arrow functions, React hooks, and exported constants now indexed. [See what's new →](/updates)
1515
</Callout>
1616

1717
<Callout type="default">

website/content/updates/_meta.js

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
export default {
2+
index: 'Release Notes',
3+
};

website/content/updates/index.mdx

Lines changed: 199 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,199 @@
1+
# Updates
2+
3+
What's new in dev-agent. We ship improvements regularly to help AI assistants understand your code better.
4+
5+
---
6+
7+
## v0.5.0 — Modern JavaScript Support
8+
9+
*Coming soon*
10+
11+
**Better coverage for how developers actually write code today.**
12+
13+
Modern JavaScript and TypeScript codebases look very different from traditional OOP. React hooks, arrow functions, and configuration objects are the primary APIs — and dev-agent now understands them.
14+
15+
### What's New
16+
17+
**🎯 Arrow Functions**
18+
19+
```typescript
20+
// Now indexed! AI can find these via semantic search
21+
export const useAuth = () => { ... }
22+
const validateEmail = (email: string) => email.includes('@')
23+
```
24+
25+
**⚛️ React Hooks Detection**
26+
27+
Hooks are automatically detected by the `use*` naming pattern. When you search for "authentication hook", dev-agent knows `useAuth` is a hook — not just a function.
28+
29+
**📦 Exported Constants**
30+
31+
Configuration objects, context providers, and factory-created values are now searchable:
32+
33+
```typescript
34+
export const API_CONFIG = { baseUrl: '/api', timeout: 5000 }
35+
export const ThemeContext = createContext({ dark: false })
36+
export const SUPPORTED_LANGUAGES = ['typescript', 'javascript']
37+
```
38+
39+
### Why This Matters
40+
41+
Before v0.5.0, searching for "API configuration" wouldn't find `export const API_CONFIG = {...}`. Now it does. This means:
42+
43+
- **Better search results** for modern React/TypeScript codebases
44+
- **More context** for AI assistants to understand your code
45+
- **Fewer "I couldn't find..." moments** when asking about hooks or configs
46+
47+
---
48+
49+
## v0.4.4 — Test File Discovery
50+
51+
*Released November 2024*
52+
53+
**Search results now show related test files automatically.**
54+
55+
When `dev_search` returns source files, it checks for matching test files (`*.test.ts`, `*.spec.ts`) and includes them in the response:
56+
57+
```
58+
1. [89%] function: authenticate (src/auth.ts:15)
59+
2. [84%] class: AuthMiddleware (src/middleware.ts:5)
60+
61+
---
62+
Related test files:
63+
• src/auth.test.ts
64+
• src/middleware.test.ts
65+
```
66+
67+
This helps AI assistants find both implementation *and* tests without extra searches — useful when fixing bugs or understanding expected behavior.
68+
69+
---
70+
71+
## v0.4.0 — Intelligent Git History
72+
73+
*Released November 2024*
74+
75+
**Semantic search over your commit history.**
76+
77+
Ever tried to find "when did we add rate limiting?" by scrolling through `git log`? Now you can just ask:
78+
79+
### New Tool: `dev_history`
80+
81+
Search commits by meaning, not just keywords:
82+
83+
```
84+
> "Find commits related to authentication changes"
85+
86+
1. [92%] fix(auth): resolve token refresh race condition
87+
Author: [email protected] | 3 days ago
88+
Files: src/auth/refresh.ts, src/auth/token.ts
89+
90+
2. [87%] feat(auth): add OAuth2 provider support
91+
Author: [email protected] | 2 weeks ago
92+
Files: src/auth/oauth.ts, src/auth/providers/
93+
```
94+
95+
### Change Frequency in `dev_map`
96+
97+
See which parts of your codebase are actively changing:
98+
99+
```
100+
packages/
101+
├── 🔥 core/ (45 components) — 12 commits in 30d
102+
├── ✏️ mcp-server/ (28 components) — 3 commits in 30d
103+
├── 📝 cli/ (15 components) — 2 commits in 90d
104+
└── subagents/ (35 components)
105+
```
106+
107+
- 🔥 **Hot** — 10+ commits in last 30 days
108+
- ✏️ **Active** — 3-9 commits in last 30 days
109+
- 📝 **Recent** — Any commits in last 90 days
110+
111+
### Context Assembly Improvements
112+
113+
`dev_plan` now includes related commits when assembling context for GitHub issues. AI assistants can see both *what* the issue asks for and *how* similar changes were made before.
114+
115+
---
116+
117+
## v0.3.0 — Code Relationships
118+
119+
*Released November 2024*
120+
121+
**Understand how your code connects.**
122+
123+
### New Tool: `dev_refs`
124+
125+
Find what calls what — and what's called by what:
126+
127+
```
128+
> "What functions call validateUser?"
129+
130+
Callers of validateUser:
131+
1. AuthMiddleware.authenticate (src/middleware.ts:45)
132+
2. LoginController.handleLogin (src/controllers/login.ts:23)
133+
3. SessionManager.validateSession (src/session.ts:67)
134+
```
135+
136+
Essential for impact analysis before refactoring.
137+
138+
### Hot Paths in `dev_map`
139+
140+
See the most-referenced files in your codebase:
141+
142+
```
143+
Hot Paths (most referenced):
144+
🔥 src/utils/logger.ts (47 references)
145+
🔥 src/types/index.ts (34 references)
146+
🔥 src/config.ts (28 references)
147+
```
148+
149+
### Smarter Context Assembly
150+
151+
`dev_plan` was refactored from generating task breakdowns to assembling rich context. Instead of making assumptions about *how* to implement something, it now gives AI assistants the context they need to figure it out themselves.
152+
153+
---
154+
155+
## v0.1.0 — Initial Release
156+
157+
*Released November 2024*
158+
159+
**The foundation: local-first code understanding for AI tools.**
160+
161+
### Core Features
162+
163+
- **Semantic Search** — Find code by meaning, not keywords
164+
- **MCP Integration** — Works with Cursor, Claude Code, and any MCP client
165+
- **Multi-language** — TypeScript, JavaScript, Go, Python, Rust, Markdown
166+
- **100% Local** — No cloud, no telemetry, all processing on your machine
167+
168+
### Five Tools at Launch
169+
170+
| Tool | Purpose |
171+
|------|---------|
172+
| `dev_search` | Semantic code search |
173+
| `dev_plan` | Context assembly for issues |
174+
| `dev_explore` | Pattern discovery |
175+
| `dev_gh` | GitHub issue/PR search |
176+
| `dev_status` | Repository health |
177+
178+
### Installation
179+
180+
One command to index, one command to install:
181+
182+
```bash
183+
npm install -g dev-agent
184+
dev index .
185+
dev mcp install --cursor
186+
```
187+
188+
---
189+
190+
## What's Next?
191+
192+
We're working on:
193+
194+
- **Incremental indexing** — Only re-index changed files
195+
- **More languages** — Better Go and Python support via tree-sitter
196+
- **Parallel search** — Query multiple repos simultaneously
197+
198+
Have ideas? [Open an issue](https://github.com/lytics/dev-agent/issues) or join the discussion.
199+

0 commit comments

Comments
 (0)