Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 81 additions & 5 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Builds the uorc client from the committed LexLean-exported Rust (generated/rust)
# and publishes it: native binaries, the library source bundle, the WebAssembly
# module, a Canterbury and Silesia benchmark run, and the GitHub Pages site that runs the client.
# module, a Canterbury and Silesia benchmark run, the release's closed claims
# (frontier.toml, decided by running the client over κ-named corpora), and the
# GitHub Pages site that runs the client.
#
# Every stage is a factory obligation (factory/graph.json, scripts/factory.mjs)
# keyed on its own inputs. A stage proved by a receipt is not run again: its
Expand Down Expand Up @@ -60,6 +62,9 @@ jobs:
bench: ${{ steps.route.outputs.bench_route }}
bench_identity: ${{ steps.route.outputs.bench_identity }}
bench_run: ${{ steps.route.outputs.bench_run }}
frontier: ${{ steps.route.outputs.frontier_route }}
frontier_identity: ${{ steps.route.outputs.frontier_identity }}
frontier_run: ${{ steps.route.outputs.frontier_run }}
steps:
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
with:
Expand All @@ -81,7 +86,7 @@ jobs:
run: |
set -euo pipefail
node --test scripts/factory.test.mjs >/dev/null
node scripts/factory.mjs route gate native-x86_64-unknown-linux-gnu native-aarch64-unknown-linux-gnu wasm bench publish \
node scripts/factory.mjs route gate native-x86_64-unknown-linux-gnu native-aarch64-unknown-linux-gnu wasm bench frontier publish \
--context "mode=$MODE" --context "run=$GITHUB_RUN_ID-$GITHUB_RUN_ATTEMPT" | tee -a "$GITHUB_OUTPUT"
- name: List the native targets to build
id: matrix
Expand Down Expand Up @@ -246,12 +251,76 @@ jobs:
if-no-files-found: error
retention-days: 3

# Layer 2 of the performance model: closed claims. The decider
# (crates/frontier) runs the client over every corpus the register names
# (the offline git corpus, Canterbury and Silesia, each checked against its
# κ), records "this codec point codes corpus κ in exactly N bytes and S
# decode steps" for this release's point, and decides the UC-PERF-01 target
# (no larger than each pinned comparator) from it. A claim the factory
# already decided is never rerun; a stated claim the client does not
# reproduce is refuted and fails the obligation. Hermetic: only the decide
# step's outcome is recorded, so a failed download records nothing.
frontier:
name: closed claims
needs: [factory, native]
if: always() && needs.factory.outputs.frontier == 'observe' && (needs.native.result == 'success' || needs.native.result == 'skipped')
runs-on: ubuntu-24.04
timeout-minutes: 120
env:
TAG: ${{ needs.factory.outputs.tag }}
steps:
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
with:
ref: ${{ env.REF }}
fetch-depth: 0
persist-credentials: false
- name: Fetch the corpora
run: |
set -euo pipefail
mkdir -p corpus/canterbury corpus/silesia
curl -fsSL --retry 5 --retry-all-errors https://corpus.canterbury.ac.nz/resources/cantrbry.tar.gz | tar -xz -C corpus/canterbury
curl -fsSL --retry 5 --retry-all-errors -o silesia.zip https://sun.aei.polsl.pl/~sdeor/corpus/silesia.zip
unzip -q -d corpus/silesia silesia.zip
find corpus/silesia -mindepth 2 -type f -exec mv -t corpus/silesia {} +
- name: Decide the closed claims
id: run
env:
IDENTITY: ${{ needs.factory.outputs.frontier_identity }}
run: |
set -euo pipefail
cargo build --locked --release -p frontier
target/release/frontier decide --label "$TAG" --by "factory:$IDENTITY" \
--corpus uorc-v0.3.0 --corpus canterbury=corpus/canterbury --corpus silesia=corpus/silesia
target/release/frontier report --out frontier
- uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
if: always() && (steps.run.outcome == 'success' || steps.run.outcome == 'failure')
with:
name: factory-frontier
path: |
frontier.toml
frontier/
if-no-files-found: error
retention-days: 90
- name: Record the outcome
if: always() && (steps.run.outcome == 'success' || steps.run.outcome == 'failure')
env:
IDENTITY: ${{ needs.factory.outputs.frontier_identity }}
OUTCOME: ${{ steps.run.outcome }}
run: node scripts/factory.mjs outcome frontier "$IDENTITY" "$OUTCOME" .tmp/factory
- uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
if: always() && (steps.run.outcome == 'success' || steps.run.outcome == 'failure')
with:
name: factory-outcome-frontier
path: .tmp/factory/
if-no-files-found: error
retention-days: 3

# Packages what the stages proved (from this run or the runs that proved
# them) under the tag, and publishes it; a rehearsal keeps the package as an
# artifact instead.
publish:
name: ${{ github.event.inputs.mode == 'rehearsal' && 'package (rehearsal)' || 'publish release' }}
needs: [factory, native, wasm, bench]
needs: [factory, native, wasm, bench, frontier]
if: always() && needs.factory.result == 'success' && !contains(needs.*.result, 'failure') && !contains(needs.*.result, 'cancelled')
runs-on: ubuntu-24.04
timeout-minutes: 15
Expand Down Expand Up @@ -290,6 +359,12 @@ jobs:
path: bench
run-id: ${{ needs.factory.outputs.bench_run }}
github-token: ${{ needs.factory.outputs.bench_run != github.run_id && github.token || '' }}
- uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093
with:
name: factory-frontier
path: claims
run-id: ${{ needs.factory.outputs.frontier_run }}
github-token: ${{ needs.factory.outputs.frontier_run != github.run_id && github.token || '' }}
- name: Package the binaries, the source bundle, the wasm bundle and the site
run: |
set -euo pipefail
Expand All @@ -314,7 +389,8 @@ jobs:
git archive --format=tar.gz --prefix="uorc-${TAG}-src/" -o "dist/uorc-${TAG}-src.tar.gz" HEAD \
Cargo.toml Cargo.lock rust-toolchain.toml crates/uorc crates/uorc-wasm generated/rust LICENSE-APACHE LICENSE-MIT
cp bench/bench.json "dist/uorc-${TAG}-bench.json"
(cd dist && sha256sum uorc-*-wasm.tar.gz uorc-*-src.tar.gz *.json > SHA256SUMS-wasm-src)
cp claims/frontier.toml "dist/uorc-${TAG}-frontier.toml"
(cd dist && sha256sum uorc-*-wasm.tar.gz uorc-*-src.tar.gz *.json *.toml > SHA256SUMS-wasm-src)
ls -la dist
- uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
if: env.MODE == 'rehearsal'
Expand All @@ -329,7 +405,7 @@ jobs:
GH_TOKEN: ${{ github.token }}
run: |
set -euo pipefail
{ printf 'uorc %s\n\n' "$TAG"; printf 'Client: https://%s.github.io/%s/\n\n' "${GITHUB_REPOSITORY_OWNER,,}" "${GITHUB_REPOSITORY#*/}"; cat bench/bench.md; } > notes.md
{ printf 'uorc %s\n\n' "$TAG"; printf 'Client: https://%s.github.io/%s/\n\n' "${GITHUB_REPOSITORY_OWNER,,}" "${GITHUB_REPOSITORY#*/}"; cat claims/frontier/frontier.md; echo; cat bench/bench.md; } > notes.md
if gh release view "$TAG" >/dev/null 2>&1; then
gh release upload "$TAG" dist/* --clobber
else
Expand Down
4 changes: 2 additions & 2 deletions CONFORMANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,7 @@ The three honesty levels (R2):
| --- | --- | --- |
| `UC-CHR-01` | `build` | UORC charter, claim-boundary, evidence-boundary, and research-position records are accepted by the locked LexLean project and generate the committed project documentation projections. |
| `UC-CHR-02` | `build` | Handwritten project prose cannot define a second UORC specification or BCP-14 semantic rule, while non-authoritative evidence and planning prose remain permitted. |
| `UC-PERF-01` | `open` | measured public-corpus compression: every release runs scripts/bench.mjs on the Canterbury and Silesia corpora against gzip, bzip2, xz, zstd, brotli, zpaq and 7-Zip PPMd, reports each throughput against the host's measured core count and memory copy rate, and publishes archive sizes and times in the release notes, the release's bench.json and the Pages site; open because the measurement sets no target |
| `UC-PERF-01` | `open` | closed public-corpus claims with a target: every release runs crates/frontier over the Canterbury and Silesia corpora, each pinned by its κ in frontier.toml, records the exact archive bytes and decode steps of its codec point as closed claims the factory decides, and publishes them in the release notes and the release's frontier.toml; the target is that on every public corpus the archive is no larger than each pinned comparator's (gzip, bzip2, xz, zstd, brotli, zpaq and 7-Zip PPMd from the v0.3.0 release run), decided per comparator as a bound claim; open with the target unmet while any bound is refuted (Silesia against zpaq -m5, 41726363 against 39112562 bytes at v0.3.0); scripts/bench.mjs still reports times against the host's core count and memory copy rate |
| `UC-REC-01` | `open` | externally accepted compression record; open unless the external authority actually accepts it |

## varint
Expand Down Expand Up @@ -154,7 +154,7 @@ The three honesty levels (R2):
| --- | --- | --- | --- | --- |
| `UC-CHR-01` | `build` | `build_evidence` | `not_measured` | UORC charter, claim-boundary, evidence-boundary, and research-position records are accepted by the locked LexLean project and generate the committed project documentation projections. |
| `UC-CHR-02` | `build` | `build_evidence` | `not_measured` | Handwritten project prose cannot define a second UORC specification or BCP-14 semantic rule, while non-authoritative evidence and planning prose remain permitted. |
| `UC-PERF-01` | `open` | `benchmark_measurement` | `measured_no_target` | measured public-corpus compression: every release runs scripts/bench.mjs on the Canterbury and Silesia corpora against gzip, bzip2, xz, zstd, brotli, zpaq and 7-Zip PPMd, reports each throughput against the host's measured core count and memory copy rate, and publishes archive sizes and times in the release notes, the release's bench.json and the Pages site; open because the measurement sets no target |
| `UC-PERF-01` | `open` | `benchmark_target_unmet` | `measured_target_unmet` | closed public-corpus claims with a target: every release runs crates/frontier over the Canterbury and Silesia corpora, each pinned by its κ in frontier.toml, records the exact archive bytes and decode steps of its codec point as closed claims the factory decides, and publishes them in the release notes and the release's frontier.toml; the target is that on every public corpus the archive is no larger than each pinned comparator's (gzip, bzip2, xz, zstd, brotli, zpaq and 7-Zip PPMd from the v0.3.0 release run), decided per comparator as a bound claim; open with the target unmet while any bound is refuted (Silesia against zpaq -m5, 41726363 against 39112562 bytes at v0.3.0); scripts/bench.mjs still reports times against the host's core count and memory copy rate |
| `UC-REC-01` | `open` | `none` | `not_measured` | externally accepted compression record; open unless the external authority actually accepts it |
| `UC-REP-01` | `build` | `build_evidence` | `not_measured` | Source-derived charter projections and complete LexLean build and verification artifacts are byte-identical across clean absolute roots under the locked SDK. |
| `UC-REP-02` | `build` | `build_evidence` | `not_measured` | Dependency and execution-boundary failures are explicit and planted SDK-lock, source-lock, adjacent-checkout, and host-PATH fallbacks are rejected. |
Expand Down
10 changes: 10 additions & 0 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ repo-model = { version = "0.4.0", path = "crates/model" }
# `cargo deny` refuses those (`wildcards = "deny"`). Every internal dependency
# carries both.
repo-conformance = { version = "0.4.0", path = "crates/conformance" }
uorc = { version = "0.4.0", path = "crates/uorc" }

[workspace.lints.rust]
missing_docs = "deny"
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ This table classifies evidence within its verified scope. It does not validate a

## Current research dispositions

- `UC-PERF-01`: `measured_no_target`; evidence `benchmark_measurement`; honesty level `open`.
- `UC-PERF-01`: `measured_target_unmet`; evidence `benchmark_target_unmet`; honesty level `open`.
- `UC-REC-01`: `not_measured`; evidence `none`; honesty level `open`.

The source-owned bounded ULEB128 codec, errors, and proof inventory are projected in [UORC-VARINT.md](UORC-VARINT.md).
Expand Down
2 changes: 1 addition & 1 deletion UORC-VERIFICATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ This table classifies evidence within its verified scope. It does not validate a

## Current research dispositions

- `UC-PERF-01`: `measured_no_target`; evidence `benchmark_measurement`; honesty level `open`.
- `UC-PERF-01`: `measured_target_unmet`; evidence `benchmark_target_unmet`; honesty level `open`.
- `UC-REC-01`: `not_measured`; evidence `none`; honesty level `open`.

The source-owned bounded ULEB128 codec, errors, and proof inventory are projected in [UORC-VARINT.md](UORC-VARINT.md).
Expand Down
27 changes: 27 additions & 0 deletions crates/frontier/Cargo.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
[package]
name = "frontier"
description = "uorc's claim register (frontier.toml) and decider: closed performance claims over κ-named corpora, decided by running the shipped codec."
version.workspace = true
edition.workspace = true
rust-version.workspace = true
license.workspace = true
repository.workspace = true
homepage.workspace = true
authors.workspace = true
publish = false

[lib]
path = "src/lib.rs"

[[bin]]
name = "frontier"
path = "src/main.rs"

[dependencies]
serde = { version = "1.0.229", features = ["derive"] }
sha2 = "0.11.1"
toml = "0.8.23"
uorc = { workspace = true }

[lints]
workspace = true
Loading
Loading