30 lines
1 KiB
Markdown
30 lines
1 KiB
Markdown
|
# Benchmarks
|
||
|
|
|
||
|
|
Milestone 0 records measurements before changing compiler, storage, rendering, or response
|
||
|
|
contracts.
|
||
|
|
|
||
|
|
Run the maintained smoke benchmark:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
make benchmark-smoke
|
||
|
|
```
|
||
|
|
|
||
|
|
Run the 1,000-node generic baseline:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
make benchmark
|
||
|
|
```
|
||
|
|
|
||
|
|
The benchmark creates canonical sources, derived state, changesets, rendered output, and caches
|
||
|
|
only in a disposable temporary directory. It does not read another project, self-host DocForge, or
|
||
|
|
mutate repository content.
|
||
|
|
|
||
|
|
`milestone0-2026-07-29.json` is the clean-tree baseline captured from commit
|
||
|
|
`fd4759096e90edb13a745621aae4872f23079357`. It uses compact sorted JSON for response sizes and
|
||
|
|
`time.perf_counter_ns()` for durations. The file is data, not a performance threshold. Later work
|
||
|
|
must explain fixture or environment changes before comparing results.
|
||
|
|
|
||
|
|
The generic fixture exposes whole-source scaling. It does not replace the incremental adapter
|
||
|
|
equivalence tests and does not claim to measure a portable graph renderer, because Milestone 0 has
|
||
|
|
no portable graph-planning or graph-rendering contract.
|