Production Benchmarks, Budgets, And Release Integration

Native performance is a release property. A release may claim

production-ready native performance only for listed targets, runtime profiles,

and optimization modes that have passed the native performance release gate.

Run the bounded release evidence gate with:


make native-performance-release-check

The gate validates benchmark-suite coverage, release budgets, baseline

comparisons, native artifact manifests, support-matrix claims, resource-safe

final-gate receipts, compatibility contracts, and public documentation links.

Evidence Files

native-release/benchmark-suites.tsv is the release-owned suite index. It

requires coverage for microbenchmarks, compiler workloads, standard libraries,

Index, Kukulkan, embedded kernels, IO-heavy programs, and no-OS firmware.

perf/native-release-benchmarks.tsv carries the representative workload rows

used by the release integration gate. Every row must pass elapsed-time, peak

RSS, and binary-size budgets before the suite can be counted.

release/native-performance-budget-matrix.tsv is the budget source of truth for

run time, compile time, peak RSS, binary size, section size, stack size, static

memory, dynamic allocation count, and generated symbol count.

The gate rejects missing budget classes, missing evidence paths, malformed

integers, or values that exceed their configured budget.

release/native-performance-baseline-comparison.tsv compares current native

release values against recorded baselines. The support matrix is the public

support boundary. It distinguishes hosted production-ready targets from

emulator-ready bare-metal targets.

Do not generalize a support claim from one row to another. The release can

claim production-ready native performance only for listed targets.

release/native-performance-release-manifest.tsv records native artifacts,

runtime profile, target, debug/unwind settings, GC absence, dynamic dependency

absence, compiler version, profile data, optimization mode, reproducibility

hash, and pass status.

release/native-performance-resource-safe-gates.tsv records the final release,

self-host, benchmark, and freestanding gate receipts in the documented

resource-safe mode:


ZERO_JOBS=1;NATIVE_RELEASE_RESOURCE_SAFE=1

This repository does not use broad unbounded commands as release evidence for

native performance. The resource-safe receipts are indexed by

release/native-performance-evidence-index.tsv.

native-release/documentation-publication.tsv records the public pages that

must move with release behavior changes. A native performance release change

updates this page, the release guide, performance characterization, the static

site reference page, release notes, ADR/RFC records, and the roadmap evidence.

The release gate fails closed on: