Skip to content

docs: update build performance benchmarks #122

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
github-actions wants to merge 1 commit into from
Closed

docs: update build performance benchmarks #122

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 3 additions & 17 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -403,27 +403,13 @@ Self-measured on every release via CI ([build benchmarks](generated/BUILD-BENCHM

| Metric | Latest |
|---|---|
| Build speed (native) | **1.9 ms/file** |
| Build speed (WASM) | **6.6 ms/file** |
| Build speed (native) | **2.2 ms/file** |
| Build speed (WASM) | **6.4 ms/file** |
| Query time | **2ms** |
| ~50,000 files (est.) | **~95.0s build** |
| ~50,000 files (est.) | **~110.0s build** |

Metrics are normalized per file for cross-version comparability. Times above are for a full initial build — incremental rebuilds only re-parse changed files.

### Lightweight Footprint

<a href="https://www.npmjs.com/package/@optave/codegraph"><img src="https://img.shields.io/npm/unpacked-size/@optave/codegraph?style=flat-square&label=unpacked%20size" alt="npm unpacked size" /></a>

Only **3 runtime dependencies** — everything else is optional or a devDependency:

| Dependency | What it does | | |
|---|---|---|---|
| [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) | Fast, synchronous SQLite driver | ![GitHub stars](https://img.shields.io/github/stars/WiseLibs/better-sqlite3?style=flat-square&label=%E2%AD%90) | ![npm downloads](https://img.shields.io/npm/dw/better-sqlite3?style=flat-square&label=%F0%9F%93%A5%2Fwk) |
| [commander](https://github.com/tj/commander.js) | CLI argument parsing | ![GitHub stars](https://img.shields.io/github/stars/tj/commander.js?style=flat-square&label=%E2%AD%90) | ![npm downloads](https://img.shields.io/npm/dw/commander?style=flat-square&label=%F0%9F%93%A5%2Fwk) |
| [web-tree-sitter](https://github.com/tree-sitter/tree-sitter) | WASM tree-sitter bindings | ![GitHub stars](https://img.shields.io/github/stars/tree-sitter/tree-sitter?style=flat-square&label=%E2%AD%90) | ![npm downloads](https://img.shields.io/npm/dw/web-tree-sitter?style=flat-square&label=%F0%9F%93%A5%2Fwk) |

Optional: `@huggingface/transformers` (semantic search), `@modelcontextprotocol/sdk` (MCP server) — lazy-loaded only when needed.

## 🤖 AI Agent Integration
Copy link
Contributor

@greptile-apps greptile-apps bot Feb 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The "Lightweight Footprint" subsection (### heading with dependency table) was unintentionally removed. This is caused by a bug in scripts/update-benchmark-report.js line 220 — the regex /## 📊 Performance\r?\n[\s\S]*?(?=\r?\n## (?!#)|$)/ captures h3 subsections when replacing the Performance section.

The script should only replace the benchmark table, not the entire section including subsections.


### MCP Server
Expand Down
61 changes: 47 additions & 14 deletions generated/BUILD-BENCHMARKS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ Metrics are normalized per file for cross-version comparability.

| Version | Engine | Date | Files | Build (ms/file) | Query (ms) | Nodes/file | Edges/file | DB (bytes/file) |
|---------|--------|------|------:|----------------:|-----------:|-----------:|-----------:|----------------:|
| 2.4.0 | native | 2026-02-26 | 109 | 2.2 ↑16% | 1.6 ↑7% | 5.9 ~ | 9.6 ↑5% | 4397 ↑14% |
| 2.4.0 | wasm | 2026-02-26 | 109 | 6.4 ↓3% | 2.1 ~ | 5.9 ~ | 9.6 ↑5% | 4397 ↑14% |
| 2.3.0 | native | 2026-02-24 | 99 | 1.9 ~ | 1.5 ↑7% | 5.8 ↑7% | 9.1 ~ | 3848 ~ |
| 2.3.0 | wasm | 2026-02-24 | 99 | 6.6 ~ | 2.1 ↑11% | 5.8 ~ | 9.1 ↑3% | 3848 ~ |
| 2.1.0 | native | 2026-02-23 | 92 | 1.9 ↓24% | 1.4 ↑17% | 5.4 ↑6% | 9.1 ↓47% | 3829 ↓14% |
Expand All @@ -18,37 +20,68 @@ Metrics are normalized per file for cross-version comparability.

| Metric | Value |
|--------|-------|
| Build time | 183ms |
| Build time | 235ms |
| Query time | 2ms |
| Nodes | 575 |
| Edges | 897 |
| DB size | 372 KB |
| Files | 99 |
| Nodes | 640 |
| Edges | 1,049 |
| DB size | 468 KB |
| Files | 109 |

#### WASM

| Metric | Value |
|--------|-------|
| Build time | 649ms |
| Build time | 700ms |
| Query time | 2ms |
| Nodes | 575 |
| Edges | 897 |
| DB size | 372 KB |
| Files | 99 |
| Nodes | 640 |
| Edges | 1,049 |
| DB size | 468 KB |
| Files | 109 |

### Estimated performance at 50,000 files

Extrapolated linearly from per-file metrics above.

| Metric | Native (Rust) | WASM |
|--------|---:|---:|
| Build time | 95.0s | 330.0s |
| DB size | 183.5 MB | 183.5 MB |
| Nodes | 290,000 | 290,000 |
| Edges | 455,000 | 455,000 |
| Build time | 110.0s | 320.0s |
| DB size | 209.7 MB | 209.7 MB |
| Nodes | 295,000 | 295,000 |
| Edges | 480,000 | 480,000 |

<!-- BENCHMARK_DATA
[
{
"version": "2.4.0",
"date": "2026-02-26",
"files": 109,
"wasm": {
"buildTimeMs": 700,
"queryTimeMs": 2.1,
"nodes": 640,
"edges": 1049,
"dbSizeBytes": 479232,
"perFile": {
"buildTimeMs": 6.4,
"nodes": 5.9,
"edges": 9.6,
"dbSizeBytes": 4397
}
},
"native": {
"buildTimeMs": 235,
"queryTimeMs": 1.6,
"nodes": 640,
"edges": 1049,
"dbSizeBytes": 479232,
"perFile": {
"buildTimeMs": 2.2,
"nodes": 5.9,
"edges": 9.6,
"dbSizeBytes": 4397
}
}
},
{
"version": "2.3.0",
"date": "2026-02-24",
Expand Down