Roadmap
Where Aburi stands today, and what comes next.
Status
The v1 schemas are frozen. Every published package is implemented, unit tested, and exercised end to end against a NestJS-shaped fixture project.
Working today
Analysis. TypeScript and JavaScript, parsed with tree-sitter WASM. Aburi detects pnpm, npm, Yarn, and Bun workspaces and nx projects on its own, recognises NestJS, Next.js App Router, Express, React, and the tRPC server as frameworks, and reads Prisma, Drizzle, tRPC client calls, and NestJS events as effects.
Dependencies. Aburi resolves calls to the symbols they reach within a file, an import, a component, or the workspace, and builds a symbol-level dependency graph from them. It draws an edge between two components wherever a file of one imports a module of the other. It counts and buckets the calls it could not resolve, so you can see what the graph is missing. Effects propagate along that graph, so a controller that reaches prisma.invoice.create through a service carries the db.write too.
Diff. All seven statuses (added, removed, moved, changed, moved+changed, dropped-toggled, and unknown for a file one revision could not read), a --fail-on gate, a --filter that narrows the report to chosen statuses, and Slice View, which clusters changed symbols along the call graph so a feature cutting through controller, service, and repository reads as one section.
Output. The JSON analysis, a workspace overview, per-component detail, the pull request diff, and per-symbol explain views. aburi vocab lists the effect ids and extension kinds the configured plugins declare, and which plugin owns each.
Terminal. Coloured warnings and errors and a progress line on an interactive terminal, honouring NO_COLOR, FORCE_COLOR and CI, with stdout left plain for pipes.
Delivery. @aburi/cli on npm, and @aburi/github-action for pull request comments.
Performance. Measured monthly against nine public repositories at pinned commits, from zustand's 49 files to cal-com's 5,002. On a 4-core runner a 1,081-file scan takes 3.7 s and a 5,002-file one 14.7 s, single-threaded, with no scan passing 470 MiB peak — cost is roughly linear in file count. Three consecutive scans of an unchanged tree produce byte-identical IR. aburi diff runs its two scans at once on a machine with two or more CPUs, so it takes about 1.3× one scan where it took 1.7–2.2×; on one CPU it still runs them in turn. Each scan extracts its files on a pool of worker threads, one fewer than the processors by default and none for a small workspace, and writes the same analysis and log as on one thread: on four processors it takes a scan of Aburi's own 878 files from 6.0 s to 3.9 s. --concurrency 1 keeps every file on the main thread.
Not yet
| Limitation | Status |
|---|---|
| TypeScript and JavaScript only | Other languages planned below |
| Call resolution is syntactic unless a language server is configured — 6–29% of call sites resolve on public repositories | Opt-in LSP enrichment (lsp.enabled with lsp.servers.ts) resolves this. / super. calls; interface-typed receivers are not resolved yet |
| No graph visualisation beyond the workspace overview and Slice View | No design yet |
| No LLM integration | Deliberate. Aburi produces the facts, and interpreting them belongs to a separate tool. |
Next
- LSP enrichment. Use type resolution to sharpen effect inference and fill in column-level source ranges. The number it has to beat is measured on the benchmark's public repositories: from 6.3% of call sites resolved on
shadcn-uito 29.0% onzod, with NestJS itself at 8.1%.no-matchis the largest unresolved bucket everywhere but NestJS, whose constructor-injected interfaces makedynamiclarger, and a hand-classified sample of it puts 70% ± 5% of it within reach of a rule that needs no types. Little of that is a missing edge, though: most of it is a global, a binding of the caller or a method of a builtin or package type, filed in the wrong bucket. Rules would turn 4.9% ± 2.3% ofno-matchinto call edges, and type information another 2.0% ± 1.6%.
Later
- More languages. Python and Go, with uv, poetry, cargo, and
go.workworkspace detection, and a single analysis spanning all of them in one monorepo. - More effects plugins. Django, FastAPI, SQLAlchemy, GORM.
- A functional language. Scala or Rust, proving that the extension vocabulary can express pattern matching and algebraic data types.
Under consideration
Nothing here is committed.
- A merge-base ref form,
aburi diff main...HEAD, comparing the head against the point it branched from the way a GitHub compare URL reads. Today the three-dot spelling is rejected with a message pointing atgit merge-base. - Expose Aburi as an MCP server, callable from AI coding agents.
aburi review, feeding the diff to a model for automated review comments.- Name Slice View clusters automatically. The report heads each with the members its calls start from today.
- Browse the analysis in a web UI.
The design documents specify everything above, and the JSON Schemas live in schema/.