diff --git a/.github/workflows/proofs.yml b/.github/workflows/proofs.yml index 3ad5320..79dd216 100644 --- a/.github/workflows/proofs.yml +++ b/.github/workflows/proofs.yml @@ -16,8 +16,9 @@ name: Agda proofs # Why: this repository has no Guix manifest and no proof container yet; # the hosted runner has no Guix. The Debian package is an exact, # signature-checked pin. -# Closes: when a Guix manifest (or the repo's container) provides Agda and -# this job installs from it. +# Closes: PN-7 (docs/status/PROOF-NEEDS.adoc): when the planned +# digest-pinned Agda image from the shared prover-images repo +# (not yet created) replaces this install. Owner ruling 2026-11-18. on: push: branches: [main] @@ -74,7 +75,9 @@ jobs: # Tool: Lean 4.35.0, the upstream release archive, checked against the # SHA256 below; the version is asserted against lean-toolchain. # Why: no Guix manifest or proof container provides Lean here yet. - # Closes: when a Guix manifest (or the repo's container) provides Lean. + # Closes: PN-7 (docs/status/PROOF-NEEDS.adoc): when the planned + # digest-pinned Lean image from the shared prover-images repo + # (not yet created) replaces this install. Owner ruling 2026-11-18. lean-leg: name: Lean recheck leg runs-on: ubuntu-latest diff --git a/docs/handoff/prover-images/README.adoc b/docs/handoff/prover-images/README.adoc new file mode 100644 index 0000000..f39ec67 --- /dev/null +++ b/docs/handoff/prover-images/README.adoc @@ -0,0 +1,259 @@ +// SPDX-License-Identifier: CC-BY-SA-4.0 += prover-images (DRAFT handoff) +:revdate: 2026-11-18 + +[WARNING] +==== +*DRAFT and UNTESTED.* + +* The images have never been built: the authoring container could not reach the Debian mirrors. +* The `snapshot.debian.org` timestamp (`SNAPSHOT_TS` in `agda/Containerfile`) is unverified. +* The `actions/attest` version is unconfirmed. +* Two hardening changes are unverified: the Agda image reaches `snapshot.debian.org` over https using a CA bundle copied from a first build stage (no `http://` URI remains), and both images end as the non-root user `prover` (uid 1001). Neither has been built, and whether a job `container:` still needs `options: --user root` is untested. +* The name `prover-images` has not been checked against `gv-clade-index`. +* The licence (SPDX lines) is a placeholder for the owner to decide. +* This directory moves to `hyperpolymath/prover-images` once that repository exists, and is then deleted here (PN-7 in `docs/status/PROOF-NEEDS.adoc`). +* The draft CI files are carried as listings at the end of this file, not as YAML files, so nothing in resource-algebra treats them as live config. In the target repository they become `.github/workflows/build.yml` and `.github/dependabot.yml`. +==== + +*Status: draft, untested.* Written by an agent from resource-algebra PN-7 for +the owner to adopt when this repository is created. Nothing here has been built +or published (see "Validation so far"). The name `prover-images` is provisional +and has not been checked against `gv-clade-index`. + +== Purpose + +Digest-pinned container images for proof checkers, so that a proof receipt can +name the image its checker ran in (`NAME[:TAG]@sha256:<64 hex>`), as +PROOF-POLICY §8.2 (standards#1625) requires for PWG-1. First consumer: +resource-algebra (Agda 2.6.4.3, Lean 4.35.0). + +== IS / IS-NOT (draft) + +IS:: digest-pinned prover images for PWG-1 receipts, with the checker baked in, +a smoke test per image, and published provenance. +IS-NOT:: a place for proofs, theorems or policy. Policy stays in `standards`; +proofs stay in the repositories that own them. + +== Layout + +* `agda/Containerfile`: `debian:trixie-slim@sha256:a72b4433…` (digest checked +against the Docker Hub API on 2026-11-18 and pulled by digest locally), Debian +`agda-bin 2.6.4.3-1+b2` from a snapshot.debian.org timestamp. +* `lean/Containerfile`: same base, the upstream Lean 4.35.0 archive checked +against the SHA256 in resource-algebra's `proofs.yml`. +* `.github/workflows/build.yml` (listing below): build, smoke test, push to +`ghcr.io/hyperpolymath/prover-images/{agda,lean}`, print the digest in the job +summary, attest provenance. Pushes only off `pull_request`. +* `.github/dependabot.yml` (listing below): weekly base-digest and action bumps. + +== How a consumer pins a digest + +Read the `image:` line in the build job's summary (or +`docker buildx imagetools inspect ghcr.io/hyperpolymath/prover-images/agda:sha-`) +and paste `ghcr.io/hyperpolymath/prover-images/agda@sha256:`. Never pin +a tag alone. Confirm with `gh attestation verify oci://…@sha256: +--repo hyperpolymath/prover-images`. + +== The resource-algebra diff this will need + +In `.github/workflows/proofs.yml`, keep every gate step and change only: + +[source,diff] +---- + proofs: +- container: debian:trixie-slim ++ container: ++ image: ghcr.io/hyperpolymath/prover-images/agda@sha256: + steps: +- - name: Install the pinned prover +- run: | +- apt-get update +- apt-get install --no-install-recommends -y ca-certificates git agda-bin=2.6.4.3-1+b2 + - uses: actions/checkout@… + lean-leg: +- runs-on: ubuntu-latest ++ runs-on: ubuntu-latest ++ container: ++ image: ghcr.io/hyperpolymath/prover-images/lean@sha256: + steps: +- - name: Install the pinned Lean +- … # curl + sha256sum + tar + GITHUB_PATH +---- + +Also: add `- image: \`ghcr.io/…@sha256:…\`` to the Agda, Lean and M-2 receipt +summaries; keep the version assertions (`agda --version`, `lean --version`, +`lean-toolchain`); the Agda receipt's `apt-cache show` index-SHA line no longer +fits (the package is baked in), so replace it with the image digest and the +image label `io.hyperpolymath.checker.package`; update the `DEVIATION (§6)` +comments (they already point at PN-7) and the actions lock if `container:` +changes it; then record a new receipt from a run on the merge commit. The images run as the non-root user `prover` (uid 1001, the uid of GitHub-hosted runners' `runner` user). A job `container:` using them may therefore need `options: --user root` for `actions/checkout`, as resource-algebra's Rocq leg sets today (`.github/workflows/proofs.yml`, `rocq-leg` `container:` block, with the comment "The image's user cannot write the runner's workspace"). Whether these images need it is untested. + +== Open questions + +. *Rocq consolidation.* Rocq already runs in the upstream +`rocq/rocq-prover:9.3.0@sha256:97a68f23…`. Should it be rebuilt here too, for +one provenance story, or stay upstream? +. *Reproducibility.* The Agda image installs from a fixed Debian snapshot, but +the Lean image's apt layer follows live trixie, and neither build is bit-for-bit +reproducible. Is a digest of a published image enough, or does the estate want +rebuild-and-compare? +. *Guix alternative.* The owner noted a Guix pack and did not choose it. Revisit +if reproducible builds become a requirement. +. *Snapshot timestamp.* `SNAPSHOT_TS` in `agda/Containerfile` is unverified. +. *Name.* Check `prover-images` against `gv-clade-index`; settle clade, IS/IS-NOT +and licence (MPL-2.0 used as a placeholder; a licence is the owner's call). +. *Action pins.* `build.yml` uses only refs found in resource-algebra's +`actions.lock` and plain `docker` commands; the `actions/attest` version is +unconfirmed. Re-pin with estate tooling. +. *Hardening (unbuilt).* The two-stage CA copy in `agda/Containerfile` and the `USER prover` in both files were added to satisfy SonarCloud (clear-text URI, root user); neither has been built or run. +. *Image user and extra libraries.* Whether Lean needs `libgmp10` (included as a +precaution) is untested. + +== Validation so far + +[cols="2,3",options="header"] +|=== +| Check | Result +| `actionlint` v1.7.7 on `build.yml` | exit 0 +| `yq` parse of `build.yml` and `dependabot.yml` | ok (before they were carried as listings) +| `hadolint` | not run: the release binary downloaded but no published sha256 could be fetched, so it was not executed +| `docker pull` of the base by digest | succeeded, digest matched +| `docker build` agda, lean | *failed* at `apt-get update` (exit 100) (re-tried after the hardening change, same result; the agda failure is in the new `certs` stage): the sandbox's build network cannot reach Debian mirrors; snapshot.debian.org and the Lean release download are unverified +| smoke tests (`agda --version`, `lean --version`) | not run: images unbuilt +|=== + +== Draft CI files (listings) + +These two files are carried as listings, not as standalone YAML files, so no +scanner in resource-algebra (SonarCloud, workflow linters, Dependabot, +lock-sync, KYAML checks) treats them as live configuration. In the target +repository save the first as `.github/workflows/build.yml` and the second as +`.github/dependabot.yml` (the estate KYAML rule allows `.yml` there because +GitHub demands the name). Both are DRAFT and UNTESTED apart from `actionlint` +v1.7.7 on `build.yml` (exit 0) in the authoring sandbox, run before the +listing was carried here and before `${{ }}` expressions were moved out of +`run:` blocks, so it is stale for this exact text. + +=== `.github/workflows/build.yml` + +[source,yaml] +---- +# DRAFT, UNTESTED (actionlint only). Handoff from resource-algebra PN-7. +# SPDX-License-Identifier: MPL-2.0 +name: Build prover images +on: + push: + branches: [main] + paths: ['agda/**', 'lean/**', '.github/workflows/build.yml'] + pull_request: + paths: ['agda/**', 'lean/**', '.github/workflows/build.yml'] + workflow_dispatch: +permissions: + contents: read +jobs: + build: + name: Build ${{ matrix.image }} + runs-on: ubuntu-latest + timeout-minutes: 30 + strategy: + fail-fast: false + matrix: + include: + - image: agda + checker_cmd: agda --version + checker_expect: 'Agda version 2.6.4.3' + - image: lean + checker_cmd: lean --version + checker_expect: 'version 4.35.0,' + permissions: + contents: read + packages: write # push to GHCR (not granted on pull_request runs, see push gate) + id-token: write # sign the provenance attestation + attestations: write + env: + IMAGE: ${{ matrix.image }} + REGISTRY_IMAGE: ghcr.io/hyperpolymath/prover-images/${{ matrix.image }} + steps: + # Only action refs with evidence: SHA from resource-algebra's actions.lock + # (checkout v7.0.1; attest ref present there, its version NOT confirmed). + # Docker is driven by plain `docker` commands so no unverified action SHA + # is invented. Re-pin with the estate's tooling when the repo exists. + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + persist-credentials: false + - name: Build + run: | + set -euo pipefail + docker build --pull=false --file "$IMAGE/Containerfile" \ + --tag "$REGISTRY_IMAGE:candidate" "$IMAGE" + - name: Smoke test the checker inside the image + env: + CHECKER_CMD: ${{ matrix.checker_cmd }} + CHECKER_EXPECT: ${{ matrix.checker_expect }} + run: | + set -euo pipefail + out="$(docker run --rm "$REGISTRY_IMAGE:candidate" bash -c "$CHECKER_CMD")" + echo "$out" + grep -F "$CHECKER_EXPECT" <<<"$out" + - name: Log in to GHCR + if: github.event_name != 'pull_request' + env: + GH_TOKEN: ${{ github.token }} + GH_ACTOR: ${{ github.actor }} + run: echo "$GH_TOKEN" | docker login ghcr.io -u "$GH_ACTOR" --password-stdin + - name: Push and record the digest + id: push + if: github.event_name != 'pull_request' + env: + SOURCE_SHA: ${{ github.sha }} + CHECKER_CMD: ${{ matrix.checker_cmd }} + CHECKER_EXPECT: ${{ matrix.checker_expect }} + run: | + set -euo pipefail + docker tag "$REGISTRY_IMAGE:candidate" "$REGISTRY_IMAGE:sha-$SOURCE_SHA" + docker push "$REGISTRY_IMAGE:sha-$SOURCE_SHA" + digest="$(docker inspect --format '{{index .RepoDigests 0}}' "$REGISTRY_IMAGE:sha-$SOURCE_SHA" | sed 's/.*@//')" + case "$digest" in sha256:[0-9a-f]*) ;; *) echo "::error::no digest: $digest"; exit 1;; esac + [ "${#digest}" -eq 71 ] || { echo "::error::bad digest length: $digest"; exit 1; } + echo "digest=$digest" >> "$GITHUB_OUTPUT" + { + echo "## Prover image: $IMAGE" + echo "" + echo "- image: \`$REGISTRY_IMAGE@$digest\`" + echo "- source commit: \`$SOURCE_SHA\`" + echo "- smoke test: \`$CHECKER_CMD\` matched \`$CHECKER_EXPECT\`" + echo "- consumer pin: \`container: image: $REGISTRY_IMAGE@$digest\`" + } >> "$GITHUB_STEP_SUMMARY" + - name: Attest build provenance + if: github.event_name != 'pull_request' + uses: actions/attest@508db95dd578ae2727ebd6217d5ba78e4fbda05d # version unconfirmed + with: + subject-name: ${{ env.REGISTRY_IMAGE }} + subject-digest: ${{ steps.push.outputs.digest }} + push-to-registry: true +---- + +=== `.github/dependabot.yml` + +[source,yaml] +---- +# DRAFT, UNTESTED. Bumps the digest-pinned base images. Each bump is a PR that +# must rebuild, pass the smoke test and publish a new digest; consumers then +# take that digest by their own PR. Note: the estate's KYAML rule allows .yml +# here because Dependabot demands the name. +version: 2 +updates: + - package-ecosystem: docker + directory: /agda + schedule: + interval: weekly + - package-ecosystem: docker + directory: /lean + schedule: + interval: weekly + - package-ecosystem: github-actions + directory: / + schedule: + interval: weekly +---- diff --git a/docs/handoff/prover-images/agda/Containerfile b/docs/handoff/prover-images/agda/Containerfile new file mode 100644 index 0000000..7160fc9 --- /dev/null +++ b/docs/handoff/prover-images/agda/Containerfile @@ -0,0 +1,76 @@ +# DRAFT, UNBUILT, UNTESTED. Handoff from resource-algebra PN-7 (2026-11-18). +# SPDX-License-Identifier: MPL-2.0 +# +# Agda 2.6.4.3 for PROOF-POLICY §8.2 receipts. Same binary resource-algebra's +# proofs.yml installs today: Debian trixie agda-bin 2.6.4.3-1+b2. +# +# Base digest verified against the Docker Hub API on 2026-11-18 (the manifest +# list digest of library/debian:trixie-slim, last_updated 2026-11-05). +# +# Stage 1: debian:trixie-slim ships no CA bundle, so apt cannot use https yet. +# Take ca-certificates from the base image's own default sources and hand only +# the CA files to the final stage. +FROM debian:trixie-slim@sha256:a72b4433de1cf7d6bae0c4cee74d0547f58601a643b3375f070c51600d63b6b2 AS certs +RUN set -eu; \ + apt-get update; \ + apt-get install --no-install-recommends -y ca-certificates; \ + rm -rf /var/lib/apt/lists/* + +# Final stage. +FROM debian:trixie-slim@sha256:a72b4433de1cf7d6bae0c4cee74d0547f58601a643b3375f070c51600d63b6b2 + +COPY --from=certs /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt +COPY --from=certs /usr/share/ca-certificates /usr/share/ca-certificates + +# UNVERIFIED: snapshot.debian.org was unreachable from the authoring sandbox +# (proxy 403), so this timestamp is a guess that the package exists at or after +# trixie's current state. The build FAILS LOUDLY if it does not: apt cannot +# find agda-bin=2.6.4.3-1+b2. Verify before first build: +# https://snapshot.debian.org/archive/debian//pool/main/a/agda/ +ARG SNAPSHOT_TS=20261105T000000Z +ARG AGDA_VERSION=2.6.4.3 +ARG AGDA_PKG_VERSION=2.6.4.3-1+b2 + +# Replace the live mirror with the fixed snapshot. Packages are still checked +# against Debian's signed Release files (Check-Valid-Until is off only because +# snapshot Release files age out of their Valid-Until window by design). +RUN set -eu; \ + rm -f /etc/apt/sources.list /etc/apt/sources.list.d/*; \ + printf '%s\n' \ + 'Types: deb' \ + "URIs: https://snapshot.debian.org/archive/debian/${SNAPSHOT_TS}/" \ + 'Suites: trixie' \ + 'Components: main' \ + 'Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg' \ + 'Check-Valid-Until: no' \ + > /etc/apt/sources.list.d/snapshot.sources; \ + apt-get update; \ + apt-get install --no-install-recommends -y \ + "agda-bin=${AGDA_PKG_VERSION}" \ + ca-certificates git bash grep sed gawk findutils coreutils perl diffutils; \ + apt-get clean; rm -rf /var/lib/apt/lists/*; \ + test "$(agda --version)" = "Agda version ${AGDA_VERSION}" + +# Tools used by resource-algebra's Agda job: bash scripts, find/sort/xargs/ +# sha256sum (findutils, coreutils), sed/paste/cut, perl (scan-postulates.pl), +# git (checkout), dpkg-query/apt-cache (receipt step; dpkg and apt are in base). + +# Non-root user. uid 1001 is the uid of GitHub-hosted runners' `runner` user, +# so workspace ownership lines up. A job `container:` may still need +# `options: --user root` for actions/checkout; UNTESTED (see README.adoc). +RUN useradd --create-home --uid 1001 --user-group prover +USER prover +WORKDIR /home/prover +RUN agda --version + +LABEL org.opencontainers.image.title="prover-images/agda" \ + org.opencontainers.image.description="Agda ${AGDA_VERSION} (Debian agda-bin ${AGDA_PKG_VERSION}) for digest-pinned proof receipts" \ + org.opencontainers.image.source="https://github.com/hyperpolymath/prover-images" \ + org.opencontainers.image.licenses="MPL-2.0" \ + org.opencontainers.image.version="${AGDA_VERSION}" \ + org.opencontainers.image.base.name="docker.io/library/debian:trixie-slim" \ + org.opencontainers.image.base.digest="sha256:a72b4433de1cf7d6bae0c4cee74d0547f58601a643b3375f070c51600d63b6b2" \ + io.hyperpolymath.checker="agda" \ + io.hyperpolymath.checker.version="${AGDA_VERSION}" \ + io.hyperpolymath.checker.package="agda-bin ${AGDA_PKG_VERSION}" \ + io.hyperpolymath.debian.snapshot="${SNAPSHOT_TS}" diff --git a/docs/handoff/prover-images/lean/Containerfile b/docs/handoff/prover-images/lean/Containerfile new file mode 100644 index 0000000..905a474 --- /dev/null +++ b/docs/handoff/prover-images/lean/Containerfile @@ -0,0 +1,53 @@ +# DRAFT, UNBUILT, UNTESTED. Handoff from resource-algebra PN-7 (2026-11-18). +# SPDX-License-Identifier: MPL-2.0 +# +# Lean 4.35.0 (core only, no Mathlib). URL and SHA256 copied from +# resource-algebra .github/workflows/proofs.yml (lean-leg env + install step). +FROM debian:trixie-slim@sha256:a72b4433de1cf7d6bae0c4cee74d0547f58601a643b3375f070c51600d63b6b2 + +ARG LEAN_VERSION=4.35.0 +ARG LEAN_SHA256=7289597a44543246c9227b8cae501767e095ce17f6d448b95fc4a8dc97268f6d + +# The Lean steps and scripts/check-lean-bridge.sh need: bash, git over https +# (ca-certificates), coreutils (sha256sum), grep, sed, findutils, mktemp. +# curl and zstd are for this install; kept so a consumer can reuse them. +# libgmp10 is a precaution: whether the archive needs it on trixie-slim is +# UNTESTED (the smoke test below fails the build if lean cannot run). +# The apt layer is unpinned (live trixie). Pin it by snapshot as in agda/ if +# the owner wants byte-for-byte rebuilds of the tool layer. +RUN set -eu; \ + apt-get update; \ + apt-get install --no-install-recommends -y \ + ca-certificates curl zstd git bash grep sed findutils coreutils libgmp10; \ + curl --proto '=https' --tlsv1.2 --fail --silent --show-error --location \ + --output /tmp/lean.tar.zst \ + "https://github.com/leanprover/lean4/releases/download/v${LEAN_VERSION}/lean-${LEAN_VERSION}-linux.tar.zst"; \ + echo "${LEAN_SHA256} /tmp/lean.tar.zst" | sha256sum --check --strict; \ + mkdir -p /opt; \ + tar --zstd -xf /tmp/lean.tar.zst -C /opt; \ + rm /tmp/lean.tar.zst; \ + apt-get clean; rm -rf /var/lib/apt/lists/* + +ENV PATH="/opt/lean-${LEAN_VERSION}-linux/bin:${PATH}" + +# Non-root user. uid 1001 is the uid of GitHub-hosted runners' `runner` user, +# so workspace ownership lines up. /opt/lean-* is world-readable, so the user +# can run it. A job `container:` may still need `options: --user root` for +# actions/checkout; UNTESTED (see README.adoc). +RUN useradd --create-home --uid 1001 --user-group prover +USER prover +WORKDIR /home/prover + +# Smoke test after USER: proves the non-root user can run lean. +RUN lean --version | grep -F "version ${LEAN_VERSION}," + +LABEL org.opencontainers.image.title="prover-images/lean" \ + org.opencontainers.image.description="Lean ${LEAN_VERSION} (upstream archive, SHA256-checked) for digest-pinned proof receipts" \ + org.opencontainers.image.source="https://github.com/hyperpolymath/prover-images" \ + org.opencontainers.image.licenses="MPL-2.0" \ + org.opencontainers.image.version="${LEAN_VERSION}" \ + org.opencontainers.image.base.name="docker.io/library/debian:trixie-slim" \ + org.opencontainers.image.base.digest="sha256:a72b4433de1cf7d6bae0c4cee74d0547f58601a643b3375f070c51600d63b6b2" \ + io.hyperpolymath.checker="lean" \ + io.hyperpolymath.checker.version="${LEAN_VERSION}" \ + io.hyperpolymath.checker.archive.sha256="${LEAN_SHA256}" diff --git a/docs/status/PROOF-NEEDS.adoc b/docs/status/PROOF-NEEDS.adoc index da6b1fe..4b193d9 100644 --- a/docs/status/PROOF-NEEDS.adoc +++ b/docs/status/PROOF-NEEDS.adoc @@ -1,7 +1,7 @@ // SPDX-License-Identifier: CC-BY-SA-4.0 // Copyright (c) Jonathan D.A. Jewell = Proof Requirements — resource-algebra -:revdate: 2026-11-17 +:revdate: 2026-11-18 What this repository owes, classified by the estate proof policy (`3-practice/PROOF-POLICY.adoc` in `hyperpolymath/standards`). What has been @@ -85,8 +85,60 @@ re-prove the three rows by hand, axiom-free, and the statement correspondence is recorded in `PROOF-STATUS.adoc`. The rows stay `ungraded` until a receipt records a run of all three legs. | `verification/proofs/coq/`, `verification/proofs/lean4/` + +| PN-7 +| Give the Agda and Lean legs a receipt that names the container image +the checker ran in, pinned by digest (policy §8.2 as changed by +standards#1625, 2026-11-16: `NAME[:TAG]@sha256:<64 hex>`). Rocq already does +(`rocq/rocq-prover:9.3.0@sha256:…`). Agda runs in `debian:trixie-slim` with +no digest and apt-installs `agda-bin 2.6.4.3-1+b2` at run time; Lean runs on +bare `ubuntu-latest` and installs the Lean 4.35.0 archive against a SHA256. +Until this closes, the receipt at `2b9bf3f` is PWG-2ii for 28 rows (`:image` +is what PWG-1 lacks). *OPEN, blocked* on the `prover-images` repository, +which does not exist yet. See "PN-7 ruling and route" below. + +Note: `PROOF-STATUS.adoc` (Census) and the receipt deed still record the receipt +at source commit 47de4a8 as PWG-1 for 27 rows; that receipt was graded before +standards#1625 (2026-11-16) made `:image` necessary for PWG-1. Under the current +reader, a receipt for a run at 2b9bf3f grades the 28 rows PWG-2ii, because their +Agda and Lean witnesses have no `:image`. The Census is refreshed by the next +receipt. +| `.github/workflows/proofs.yml` (`proofs`, `lean-leg`); +`verification/receipts/` |=== +[[pn-7]] +=== PN-7 ruling and route (owner, 2026-11-18) + +*Ruling.* The Agda and Lean legs earn `:image` through our own prover images, +published on GHCR and pinned by digest, with the checker baked in. The images +live in a shared estate repository, provisionally named `prover-images` (the +name is not yet checked against `gv-clade-index`), not in this repository. +Record now, build later. + +Draft handoff (untested, not built): `docs/handoff/prover-images/README.adoc`. + +*Blocker.* The `prover-images` repository does not exist; the owner will +create it. Nothing has been built or published. The 28 rows stay PWG-2ii. + +*Why not an upstream image.* + +* Agda: no official or trusted image ships Agda 2.6.4.3. The candidates +(`ltchentw/agda:2.6.4.3`, `zyasserd/agda:2.6.4.3`) are individuals' images and +build a different binary from the Debian `agda-bin` this repository pins. +* Lean: no image carries 4.35.0. The `leanprovercommunity` images stop at +2024-08 and GHCR has no `leanprover` images. +* Also rejected by the owner: a digest-pinned base with the install at run time +(not counted as isolated), and a Guix pack (an alternative path, noted, not +chosen). + +*What closes it.* All four: + +. the Agda and Lean images are published to GHCR; +. their digests are pinned in `proofs.yml` as `container: image: …@sha256:…`; +. each job summary prints the image digest the checker ran in; +. a new receipt is recorded from a run on the merge commit. + == Out of scope here * K-CUT-LOSS, and its transport along a morphism, belong to diff --git a/docs/status/ROADMAP.adoc b/docs/status/ROADMAP.adoc index 79e52f5..195d37f 100644 --- a/docs/status/ROADMAP.adoc +++ b/docs/status/ROADMAP.adoc @@ -18,6 +18,19 @@ Initial development phase. * [ ] Comprehensive tests * [ ] Production ready +== Blockers and Next Actions + +=== PN-7: image-pinned receipts for the Agda and Lean legs (blocked) +* [ ] Blocked on the owner creating the shared `prover-images` repository + (provisional name; check it against `gv-clade-index` first). +* [ ] Publish digest-pinned Agda and Lean images to GHCR with the checker + baked in (owner ruling 2026-11-18; nothing built yet). +* [ ] Pin the digests in `.github/workflows/proofs.yml`, print each image + digest in the job summaries, and record a new receipt from a run on the + merge commit. +* Until then the 28 rows stay PWG-2ii. Detail and rejected alternatives: + `docs/status/PROOF-NEEDS.adoc`, PN-7. + == Future Directions _To be determined based on community feedback._