Quirl0.1 RC
ProjectRelease 0.1

0.1.0 exact-candidate performance record

Canonical Quirl project documentation synced from docs/benchmarks/release-v1.0.md.

Current exact-candidate evidence: This record measures candidate 23fd5d36907fc816bdafd9aa3c2dcb3afb69feb5 and artifact 9a893a5f1a0b49d62712f331c88966113d910d94efa9651dc4feffe9fd55b637. It is the current exact-candidate automated performance record. Human Linux/macOS terminal, remote-PTY, and real-terminal demo review remain incomplete.

Current exact-candidate evidence. This automated measurement record applies only to candidate 23fd5d36907fc816bdafd9aa3c2dcb3afb69feb5 and its named artifact. Evidence commit B records candidate A's results; it is not the measured binary source. Every automated merge-relevant gate passed. This is not a claim that human terminal, Linux, remote-PTY, or candidate-demo review occurred.

Measured: 16 August 2026 at 23:27:15 UTC

Candidate A: 23fd5d36907fc816bdafd9aa3c2dcb3afb69feb5 (tree 613b948814d2fecd91fbe170c5b13b699e89ff59, clean)

Artifact SHA-256: 9a893a5f1a0b49d62712f331c88966113d910d94efa9651dc4feffe9fd55b637

Measurement platform scope: macos-15.7.9-24g830-apple-m2-pro-aarch64-apple-darwin-automated-pty

Automated performance gate: passed all release budgets

Overall release readiness: blocked pending human and platform review. Named human terminal review on Linux and macOS, remote-PTY review, and human review of a candidate-derived real-terminal demo remain unavailable. No tag, release, upload, deployment, publication, or remote operation was performed.

This record measures the exact quirl 0.1.0 artifact named above. Report schema v7 rejected tracked or untracked source changes, required an independently supplied SHA-256, copied the artifact into a private read-only staging directory, and verified the staged copy before execution. It also verified the artifact's embedded source revision, profile, optimization level, panic strategy, operating system, architecture, and the independently embedded source identity of quirl-bench.

The harness ran the actual release binary in a fresh pseudo-terminal for every end-to-end sample and reconstructed terminal frames from the PTY byte stream. It did not measure terminal-emulator scheduling, GPU composition, monitor scanout, or human usability.

Source, toolchain, and artifact identity

FieldValue
Candidate parent082154e43048d792ce1f94c44f471475ad29a910
Candidate commit23fd5d36907fc816bdafd9aa3c2dcb3afb69feb5
Candidate tree613b948814d2fecd91fbe170c5b13b699e89ff59
Candidate stateDetached HEAD in an isolated Codex worktree; clean before the joint release build and both enforcing measurements
Cargo.lock SHA-25658e92276a6b4b55e53e61a70b753095048ac3f5cfaee832a1960545015a5e0bb
Cargo.toml SHA-256e74a48ef5c39ac7537fbf095ee249a4f08d4c3f210c78b6ded22bc564a594af2
rust-toolchain.toml SHA-2561492287aa0b458ad3277d11eae2175fb662a33e7d7958ec99a057973f2bac1a2
Generated Lua SDK SHA-25626241d77ba6d9eae18d1762fd90d9fe199a6fdcc77fc0c1bd5ff19b5b56cbfd6
Benchmark harness SHA-2564f1f41148cd0ae5bab234eceb4540eeb1cfdd9a7e34d22b939aab7dad2a27e3a
Rustrustc 1.88.0 (6b00bc388 2025-06-23), LLVM 20.1.5
Cargocargo 1.88.0 (873a06493 2025-05-10)
Target tripleaarch64-apple-darwin
Build profileCargo release; opt-level=z; fat LTO; one codegen unit; symbols stripped; panic=unwind
Embedded build identityschema 2; source candidate A; source_dirty=false; macos; aarch64; quirl 0.1.0
Artifact4,676,272 bytes; SHA-256 shown above

The digest was computed independently with shasum -a 256 and supplied to both enforcing harness entry points. The canonical JSON run reported artifact_digest_verified, artifact_profile_verified, artifact_source_verified, and harness_source_verified as true. The digest printed by the reproduction, the artifact's hidden build report, the harness source identity, and the independently recorded candidate commit all matched.

Measurement environment

FieldValue
HardwareApple Mac14,9; Apple M2 Pro; 12 physical/logical CPUs; 32 GiB memory
PlatformmacOS 15.7.9 (24G830), Darwin 24.6.0, aarch64
Reference shellsGNU Bash 5.3.15 at /opt/homebrew/bin/bash; Zsh 5.9 at /bin/zsh
Automated PTYportable-pty 0.9.0 with vt100 0.15.2; 120 columns x 40 rows; TERM=xterm-256color; truecolor advertised
Human terminal applicationNone used. No graphical terminal application received human review.
Warmup and cache methodNo discarded warmup samples. Every PTY timing used a new process. Filesystem caches were not flushed.
Load controlsThe machine was not isolated; CPU frequency, thermal state, scheduler load, and filesystem cache state were not controlled.

These measurements ran on actual local macOS hardware. They are automated PTY evidence only, not a named human macOS terminal signoff. No actual Linux hardware, named Linux terminal reviewer, SSH session, or remote PTY was used.

End-to-end release budgets

Times are wall-clock milliseconds. Percentiles use nearest rank over 101 independent fresh processes. All samples completed successfully before the phase timeout, and every enforcing release budget passed on the single canonical run.

MeasurementValidMinimumP50P95MaximumTargetOutcome
Process start to editable prompt101/10110.50908321.52291723.46833324.169458P50 ≤25 msWithin by 3.477083 ms
Final keystroke to corresponding frame101/1010.4224171.3548752.4360003.688834P95 ≤8 msWithin by 5.564000 ms
Process start to first prompt frame101/1017.75450017.35504119.15420819.463500P95 ≤21 msWithin by 1.845792 ms
Release executable size--4,676,272 bytes--≤10,485,760 bytes hard ceilingWithin ideal 5 MiB tier

The first-prompt gate uses P95. Binary units are MiB, where one MiB is exactly 1,048,576 bytes. This artifact is 566,608 bytes below the 5 MiB ideal limit, 3,712,336 bytes below the 8 MiB soft cap, and 5,809,488 bytes below the 10 MiB hard ceiling.

The one independent cargo xtask release-gate reproduction also passed all budgets: editable-prompt P50 21.704 ms, keystroke P95 2.364 ms, and first-prompt P95 19.311 ms, each with 101/101 valid samples. That reproduction confirms the gate result; it does not replace or average the canonical JSON measurement.

Stream retention evidence

LiveBuffer received 100,000 bounded typed samples at each supported window capacity. Retained samples equal min(input, capacity) and dropped samples equal input - capacity; this demonstrates O(window) sample retention. It is not an RSS, allocator, record-size, or producer-backpressure claim.

Window capacityRetainedDroppedSerialized snapshot bytes
1199,999109
161699,984845
25625699,74412,606

The production buffer invariant was valid at every tested capacity and the enforcing harness accepted the stream-retention gate.

Supplementary diagnostics

These probes are exact raw aggregate values from the canonical enforcing run. They are diagnostic only and cannot satisfy an end-to-end release gate.

ProbeValidMinimumP50P95MaximumScope
quirl --version subprocess31/312.995875 ms3.704833 ms5.543541 ms5.753667 msProcess/loading/argument lower bound
Completion, semantic-highlight proxy, prompt render2,000/2,0000.024333 ms0.025792 ms0.033208 ms0.094292 msHeadless CPU only
Fresh prompt construction and render500/5000.018625 ms0.019333 ms0.026625 ms0.050167 msHeadless CPU only

Commands and outcomes

Every duration below is the observed /usr/bin/time -p real duration. The single canonical JSON benchmark and the single independent reproduction both returned zero; neither was retried.

CommandOutcomeReal duration
cargo xtask checkPassed formatting, example formatting, Clippy, Rustdoc, workspace tests, all 11 real-PTY scenarios, and two guest Lua tests62.43 s
cargo xtask testPassed workspace tests, all 11 real-PTY scenarios, and two guest Lua tests23.22 s
cargo xtask docsPassed workspace Rustdoc with warnings denied1.50 s
cargo xtask sdk plus git diff --exit-code -- docs/quirl.luaPassed; generated Lua SDK was byte-identical1.85 s
cargo xtask demoPassed the deterministic text-only product tour61.18 s
npm ci --prefix websiteInstalled 561 locked packages; audit reported zero vulnerabilities4.65 s
npm --prefix website run test:evidencePassed all 10 focused P19 evidence tests0.21 s
npm --prefix website run check:evidencePassed historical pre-update semantic attribution0.16 s
npm --prefix website run sync:docs:checkPassed freshness for 46 documentation sources before update0.16 s
npm --prefix website run sync:reference:checkPassed freshness for two compiled reference pages3.42 s
npm --prefix website run lintPassed ESLint1.92 s
npm --prefix website run types:checkGenerated route types and passed TypeScript without emitting2.56 s
npm --prefix website run buildSynchronized 46 sources and built 203 production pages9.96 s
cargo build --release -p quirl-cli -p quirl-benchBuilt the clean candidate binary and benchmark harness together47.23 s
target/release/quirl-bench release --quirl target/release/quirl --expected-sha256 9a893a5f1a0b49d62712f331c88966113d910d94efa9651dc4feffe9fd55b637 --jsonPassed all exact-candidate evidence and performance gates; 101/101 samples valid in every enforcing PTY phase45.71 s
cargo xtask release-gate 9a893a5f1a0b49d62712f331c88966113d910d94efa9651dc4feffe9fd55b637Independently reproduced all release-budget passes, then passed the complete website gate58.58 s

The post-generation idempotence checks and post-commit semantic attribution and website results are reported with evidence commit B.

Missing evidence and blockers

All automated merge-relevant gates passed. Overall release readiness remains blocked on:

  • a named human reviewer completing the real-terminal checklist in an actual macOS terminal application, including resize, narrow, custom-theme, config web, foreground-terminal, and remote-PTY observations;
  • the same named real-terminal and process/job-control review on actual Linux hardware;
  • remote-PTY observations on candidate A; and
  • human review of a candidate-derived real-terminal demo before any README or release asset is published.

The automated real-PTY harness passed all 11 scenarios against the candidate source: rich editing, deferred catalog admission, catalog-failure terminal restoration, completion, integrated runtime, rich regressions, native job control, noninteractive dialect islands, suspend/resume, fallback selection, and NO_COLOR semantic hints. That is supporting automated evidence, not human or cross-platform signoff.

Immutable historical P20 evidence

P20 remains historical evidence only for corrected candidate 631d7849a22d04a028cbe90315dd63b8a526b03a, tree 25508427d228209ff026fdcd89f62e30ee73703c, and artifact 6ab5d8c5069956b5b5fe2d0b37b50e7d3c2a287df33a36ae75b88c87f900d8a0. Evidence commit 31e9b9b9c6ee8b0b7fdcc8f4ebc7aabbdb006bf8 preserves its full measurement record, environment, commands, and aggregate results. It measured on 16 August 2026 at 21:54:29 UTC with the same automated-macOS-PTY platform scope. Its enforcing run had 101/101 valid samples but failed the first-prompt budget at P95 21.140250 ms, a 0.140250 ms miss; editable-prompt P50 was 23.557333 ms and keystroke P95 was 2.229959 ms. Its independent reproduction also failed only first-prompt P95 at 21.463 ms. None of those timings, that failure state, its environment, or its artifact identity is attributed to candidate A in the current record.

Immutable historical P14 evidence

P14 remains immutable historical evidence for candidate 7bf188344ca61798a3cd8657787eacb8ec26ef84, tree 60df4fe8309f624642273ca8981a43d95217191e, and artifact 81cd33388cf610a7aac23a9781dbf2771b5dfb6b01b17522c2257cd3676d0ae6. Evidence commit 05df4b09349394cfd34f24d514e0e005365d0ed8 preserves its full measurement record, environment, commands, and aggregate results. It measured on 16 August 2026 at 18:51:07 UTC with platform scope macos-15.7.9-24g830-apple-m2-pro-aarch64-apple-darwin-automated-pty and passed the budgets then observed. None of its timings, pass state, environment, or artifact identity is attributed to candidate A in the current record.

An earlier record for commit c5a8d757a35a92a9a269686a1cd166c5a486e2b3 and artifact 12989bce23eccda4330cd815f5b234fb7c59e5c5cc23f5f93987592af3f0341e is also historical only. None of its measurements or pass state is copied into this candidate's evidence.

On this page