OXYGENHUB
# 07eb99be126e oxygen / docs / benchmarks.md
3.1 KiB · Markdown · last changed Benchmark harness and first numbers 1 month ago renderedsource blame history raw

Benchmarks

The harness is crates/oxy-core/tests/bench.rs (spec §25). It builds a repository through the library, one commit at a time, then times the everyday operations against thresholds:

OXY_BENCH_DIR=~/.cache/oxy-bench \
  cargo test --release -p oxy-core --test bench -- --ignored --nocapture

OXY_BENCH_FILES (default 10 000) and OXY_BENCH_CHANGES (default 5 000) set the size. The data lands under OXY_BENCH_DIR; /tmp is often a RAM disk, which hides the cost of fsync, so measure on a real disk.

2026-09-28: first run

Machine: 8 cores, x86-64, NVMe (ext4 on LVM), release build, warm cache. Files are 21 lines each in 100 directories; one change in ten appends a line to hot.txt, the rest rewrite one ordinary file.

Operation (10 000 files, 5 000 changes)TimeThreshold
commit: import 10 000 files1 031 ms60 000 msok
commit: one file (mean of 4 999)3 761 ms250 msover
status: clean working copy (stat crawl)2 977 ms2 000 msover
status: 10 files modified3 062 ms2 000 msover
commit: 10 files9 089 ms500 msover
log: whole bookmark408 ms2 000 msok
blame: hot file (500 lines)2 920 ms2 000 msover
blame: ordinary file2 927 ms1 000 msover
checkpoint596 ms10 000 msok
status after checkpoint2 873 ms2 000 msover
push: everything to an empty remote782 ms60 000 msok
push: up to date4 ms1 000 msok
clone: everything, with checkout3 378 ms60 000 msok
fsck7 955 ms60 000 msok
gc9 489 ms60 000 msok
status after gc2 829 ms2 000 msover

Peak resident memory over the whole run: 1 405 MiB. The run took 5 h 14 min, almost all of it building the history, because each commit costs as much as a status.

Smaller runs, same machine:

Files, changesMean commitClean statusBlame (hot)Peak memory
1 000, 20090 ms62 ms62 ms70 MiB
1 000, 800166 ms130 ms119 ms118 MiB
4 000, 200343 ms235 ms239 ms254 MiB
10 000, 5 0003 761 ms2 977 ms2 920 ms1 405 MiB

What it shows

Sync, log, checkpoints and repository maintenance are fine. Everything that snapshots the working copy (status, commit, blame of the working copy's base) grows with both the number of files and the length of the history. Timing the phases of one snapshot at 4 000 files and 300 changes:

PhaseTime
load the base state (checkpoint plus the changes since)75–130 ms
materialize every file of the base state75 ms
walk the working copy against the manifest50 ms
build the working-copy change8 ms

A clean status should be a stat walk and nothing else. The fix is backlog item O10: skip loading and materializing when every file's stat matches a manifest written for the same base, make the base state lazy for the callers that need it, and cache materialized snapshots per state. The thresholds above stay as they are until then, so the harness reports the gap rather than hiding it.