Files
peltier.io/targets/comrak/target.toml
T
Claude 7c3c59f5f8 phase0: dry run — comrak & tokei vendored, 3 attempts in ledger
Target selection (SPEC §6): comrak 0.53.0 (45c1995, BSD-2-Clause) and
tokei 14.0.0 (fa44e51, MIT/Apache-2.0); both CPU-bound with pinned
corpora (progit book 11MB; 8x replicated pinned trees, 221MB) and
committed MANIFEST.sha256 + golden-output pins + regen scripts.

Calibration: A/A null verdicts on both real workloads; taskset -c 2
pinning tightens the A/A CI from [0.938, 1.008] to [0.993, 1.008],
making the 2% accept threshold meaningful in this container.

Profiles (callgrind; perf unavailable): comrak allocator symbols 26.7%
of Ir; tokei perform_multi_line_analysis 31.7%.

Attempts (ledger + results/phase0/):
- comrak class-1 target-cpu=native: null [0.983, 1.011], rejected-bench
- comrak class-2 mimalloc swap: +4.6% [1.033, 1.058], 848 upstream
  tests green, golden byte-identical, ASan-proper clean; LSan flags
  484B in onig (reachability false-positive analysis in case study) ->
  needs-human-review per SPEC §8
- tokei class-1 fat LTO+cgu=1: +1.6% [1.003, 1.026], real but under
  the 2% bar, rejected-bench

Also: ledger-cli for manual rows, targets/ excluded from trust-layer
workspace, corpora/build artifacts gitignored, case study written.
Phase 0 exit criteria (>=10% verified win) not yet met; next
hypotheses logged in results/phase0/attempts.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EcKPWQ3MQD4NdEHwar96u2
2026-07-06 19:28:50 +00:00

34 lines
1.4 KiB
TOML

# comrak — CommonMark + GFM parser/renderer (Rust)
# Selection vs SPEC §6: CPU-bound parser; upstream spec test suite;
# upstream-defined benchmark workload (benches/bench.sh, Pro Git book);
# BSD-2-Clause; active, no dedicated perf team.
[source]
repo = "https://github.com/kivikakk/comrak.git"
commit = "45c1995fe922b6d5782b971a377721f088025fc8" # v0.53.0
license = "BSD-2-Clause"
[source.submodules]
# Upstream benchmark corpus (Pro Git book, all translations).
"vendor/progit" = { repo = "https://github.com/progit/progit.git", commit = "61833a527c6ac0c44cc40793c034b81599c25efc" }
[fetch]
# targets/*/workspace is gitignored; reproduce it with:
# git clone <repo> workspace && git -C workspace checkout <commit>
# git clone <submodule repo> workspace/vendor/progit && git -C ... checkout <commit>
[build]
baseline = "cargo build --release --manifest-path workspace/Cargo.toml"
binary = "workspace/target/release/comrak"
[bench]
# Upstream workload (benches/bench.sh): full Pro Git book through the
# renderer, output discarded. Corpus pinned via corpora/comrak/MANIFEST.sha256.
command = "cat corpora/comrak/progit.md | {binary} > /dev/null"
workload = "Pro Git book, all translations, 11.0 MB concatenated markdown, single stream"
[gates]
tests = "cargo test --release --manifest-path workspace/Cargo.toml"
# Golden replay: corpus through the binary, stdout must be byte-identical.
golden = "cat corpora/comrak/progit.md | {binary}"