Skip to content

Commit 5de5ded

Browse files
committed
docs: update for Go language support (v0.6.0)
- README: Add supported languages table, update version history - AGENTS.md/CLAUDE.md: Add Go to tech stack, update test count - Website: Add v0.6.0 release notes, update architecture - Fix dates from 2024 to 2025
1 parent e57d780 commit 5de5ded

File tree

7 files changed

+116
-16
lines changed

7 files changed

+116
-16
lines changed

AGENTS.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,16 @@ This file provides guidance to AI agents (Claude, Cursor, etc.) when working wit
1616
- Package Manager: pnpm 8.15.4
1717
- Build System: Turborepo
1818
- Linter/Formatter: Biome
19-
- Testing: Vitest (1100+ tests)
19+
- Testing: Vitest (1500+ tests)
2020
- Vector Storage: LanceDB
2121
- Embeddings: @xenova/transformers (all-MiniLM-L6-v2)
22+
- Parsers: ts-morph (TypeScript/JS), tree-sitter WASM (Go)
2223
- AI Integration: MCP (Model Context Protocol)
2324
- CI/CD: GitHub Actions
2425
- Node.js: >= 22 (LTS)
2526

27+
**Supported Languages:** TypeScript, JavaScript, Go, Markdown
28+
2629
## Repository Structure
2730

2831
```

CLAUDE.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -62,20 +62,23 @@ pnpm -F "@lytics/dev-agent-core" dev
6262
- **packages/mcp-server**: MCP (Model Context Protocol) server implementation
6363

6464
### Key Technologies
65-
- TypeScript Compiler API & ts-morph for repository analysis
65+
- TypeScript Compiler API & ts-morph for TypeScript/JS analysis
66+
- tree-sitter WASM for Go analysis (extensible to Python/Rust)
6667
- LanceDB for vector storage (replaced Chroma DB for better performance)
6768
- @xenova/transformers for local embeddings (all-MiniLM-L6-v2)
6869
- remark for Markdown parsing
6970
- GitHub CLI for metadata integration
7071
- Turborepo for build orchestration
7172
- Biome for linting/formatting
72-
- Vitest for testing (1100+ tests)
73+
- Vitest for testing (1500+ tests)
7374
- MCP (Model Context Protocol) for AI tool integration
7475
- Token Bucket algorithm for rate limiting
7576
- Exponential backoff for retry logic
7677

78+
**Supported Languages:** TypeScript, JavaScript, Go, Markdown
79+
7780
### Core Components
78-
- **Scanner**: Uses TypeScript Compiler API and ts-morph to extract components and relationships
81+
- **Scanner**: Uses ts-morph (TS/JS) and tree-sitter (Go) to extract components and relationships
7982
- **Vector Storage**: Semantic search with LanceDB and @xenova/transformers embeddings
8083
- **GitHub Integration**: Metadata extraction and semantic search for issues/PRs using GitHub CLI
8184
- **Subagent System**: Specialized agents for planning, exploration, and PR management

README.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -262,15 +262,24 @@ dev-agent/
262262
└── website/ # Documentation website
263263
```
264264

265+
## Supported Languages
266+
267+
| Language | Scanner | Features |
268+
|----------|---------|----------|
269+
| **TypeScript/JavaScript** | ts-morph | Functions, classes, interfaces, JSDoc |
270+
| **Go** | tree-sitter | Functions, methods, structs, interfaces, generics |
271+
| **Markdown** | remark | Documentation sections, code blocks |
272+
265273
## Technology Stack
266274

267275
- **TypeScript** (strict mode)
268-
- **ts-morph** / TypeScript Compiler API (AST analysis)
276+
- **ts-morph** / TypeScript Compiler API (TypeScript/JS analysis)
277+
- **tree-sitter** WASM (Go analysis, extensible to Python/Rust)
269278
- **LanceDB** (embedded vector storage)
270279
- **@xenova/transformers** (local embeddings)
271280
- **MCP** (Model Context Protocol)
272281
- **Turborepo** (monorepo builds)
273-
- **Vitest** (1300+ tests)
282+
- **Vitest** (1500+ tests)
274283

275284
## Development
276285

@@ -294,6 +303,11 @@ pnpm typecheck
294303

295304
## Version History
296305

306+
- **v0.6.0** - Go Language Support
307+
- Go scanner with tree-sitter WASM (functions, methods, structs, interfaces, generics)
308+
- Indexer logging with `--verbose` flag and progress spinners
309+
- Go-specific exclusions (*.pb.go, *.gen.go, mocks/, testdata/)
310+
- Infrastructure for future Python/Rust support
297311
- **v0.4.0** - Intelligent Git History release
298312
- New `dev_history` tool for semantic commit search
299313
- Enhanced `dev_map` with change frequency indicators (🔥 hot, ✏️ active)

website/content/docs/architecture.mdx

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,10 @@ dev-agent is built as a TypeScript monorepo with specialized packages for differ
4848

4949
The foundation layer providing:
5050

51-
- **Scanner** — Multi-language AST parsing using TypeScript Compiler API and ts-morph
51+
- **Scanner** — Multi-language AST parsing:
52+
- TypeScript/JavaScript via ts-morph
53+
- Go via tree-sitter WASM
54+
- Markdown via remark
5255
- **Indexer** — Converts code components to vector embeddings
5356
- **Vector Storage** — LanceDB for fast similarity search
5457
- **GitHub Integration** — Fetches and indexes issues/PRs via GitHub CLI
@@ -91,18 +94,28 @@ Centralized logging:
9194
- JSON and pretty formatters
9295
- Structured metadata
9396

97+
## Supported Languages
98+
99+
| Language | Scanner | Features |
100+
|----------|---------|----------|
101+
| TypeScript/JavaScript | ts-morph | Functions, classes, interfaces, JSDoc |
102+
| Go | tree-sitter WASM | Functions, methods, structs, interfaces, generics |
103+
| Markdown | remark | Documentation sections, code blocks |
104+
94105
## Key Technologies
95106

96107
| Component | Technology | Purpose |
97108
|-----------|------------|---------|
98109
| Language | TypeScript (strict) | Type safety |
99110
| Build | Turborepo | Monorepo orchestration |
100-
| Testing | Vitest | 1100+ tests |
111+
| Testing | Vitest | 1500+ tests |
101112
| Linting | Biome | Fast linting/formatting |
102113
| Vector DB | LanceDB | Embedded vector storage |
103114
| Embeddings | @xenova/transformers | Local ML inference |
104115
| Model | all-MiniLM-L6-v2 | Sentence embeddings |
105116
| Protocol | MCP | AI tool integration |
117+
| TS/JS Parser | ts-morph | TypeScript Compiler API |
118+
| Go Parser | tree-sitter WASM | Fast, portable parsing |
106119

107120
## Data Flow
108121

website/content/index.mdx

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -201,9 +201,10 @@ dev mcp install # For Claude Code
201201

202202
- **Context Bundling**`dev_plan` replaces 5-10 tool calls with one
203203
- **Code Snippets** — Search returns code, not just file paths
204+
- **Multi-Language** — TypeScript, JavaScript, Go, Markdown
204205
- **100% Local** — Your code never leaves your machine
205206
- **Sub-second Search** — Fast even on large repos with LanceDB
206-
- **1379+ Tests** — Production-grade reliability
207+
- **1500+ Tests** — Production-grade reliability
207208

208209
---
209210

website/content/latest-version.ts

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

66
export const latestVersion = {
7-
version: '0.5.2',
8-
title: 'GitHub Indexing for Large Repositories',
9-
date: 'December 6, 2024',
10-
summary: 'Fixed `ENOBUFS` errors when indexing repositories with many GitHub issues/PRs.',
11-
link: '/updates#v052--github-indexing-for-large-repositories',
7+
version: '0.6.0',
8+
title: 'Go Language Support',
9+
date: 'December 10, 2025',
10+
summary:
11+
'Full Go language support with tree-sitter — functions, methods, structs, interfaces, and generics.',
12+
link: '/updates#v060--go-language-support',
1213
} as const;

website/content/updates/index.mdx

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

1010
---
1111

12+
## v0.6.0 — Go Language Support
13+
14+
*December 10, 2025*
15+
16+
**Full Go language support with tree-sitter.** Index Go codebases with the same quality as TypeScript — functions, methods, structs, interfaces, and generics.
17+
18+
### What's New
19+
20+
**🐹 Go Scanner**
21+
22+
dev-agent now fully supports Go codebases:
23+
24+
```go
25+
// All of these are now indexed and searchable:
26+
func NewServer(cfg Config) *Server { ... }
27+
func (s *Server) Start(ctx context.Context) error { ... }
28+
type Config struct { Host string; Port int }
29+
type Handler interface { Handle(ctx context.Context) error }
30+
type Stack[T any] struct { items []T } // Generics!
31+
```
32+
33+
**Features:**
34+
- Functions and methods with receiver information
35+
- Structs, interfaces, and type aliases
36+
- Go 1.18+ generics support
37+
- Go doc comment extraction
38+
- Exported symbol detection (capital letter convention)
39+
40+
**📋 Progress Logging**
41+
42+
New `--verbose` flag shows detailed progress:
43+
44+
```bash
45+
dev index . --verbose
46+
[scanner] Found 4338 go files {language: "go", files: 4338}
47+
⠧ Embedding 4480/49151 documents (9%)
48+
[indexer] Embedding complete {documentsIndexed: 49151}
49+
```
50+
51+
**🚫 Smart Exclusions**
52+
53+
Generated files are automatically skipped:
54+
- `*.pb.go` — Protobuf
55+
- `*.gen.go`, `*_gen.go` — Code generators
56+
- `*.pb.gw.go` — gRPC gateway
57+
- `mock_*.go`, `mocks/` — Mock files
58+
- `testdata/` — Test fixtures
59+
60+
### Why This Matters
61+
62+
Go teams can now use dev-agent for semantic code search across their entire codebase. Search for "authentication middleware" and find your Go handlers, not just TypeScript files.
63+
64+
**Tested on:** Large Go codebase (~4k files, 49k documents) ✅
65+
66+
### Technical Details
67+
68+
Go parsing uses **tree-sitter WASM** — the same parser used by GitHub, Neovim, and other tools. This provides:
69+
- Fast, incremental parsing
70+
- No Go installation required
71+
- Portable across platforms
72+
- Foundation for future Python/Rust support
73+
74+
---
75+
1276
## v0.5.2 — GitHub Indexing for Large Repositories
1377

14-
*December 6, 2024*
78+
*December 6, 2025*
1579

1680
**Fixed `ENOBUFS` errors when indexing repositories with many GitHub issues/PRs.** Large active repositories can now be fully indexed without buffer overflow issues.
1781

@@ -283,7 +347,8 @@ dev mcp install --cursor
283347

284348
We're working on:
285349

286-
- **More languages** — Better Go and Python support via tree-sitter
350+
- **Python support** — Using tree-sitter infrastructure from Go scanner
351+
- **Rust support** — Structs, traits, impl blocks
287352
- **Parallel search** — Query multiple repos simultaneously
288353

289354
Have ideas? [Open an issue](https://github.com/lytics/dev-agent/issues) or join the discussion.

0 commit comments

Comments
 (0)