Skip to content

v0.1.3

Choose a tag to compare

@3leapsdave 3leapsdave released this 31 Oct 21:39
Immutable release. Only release title and notes can be modified.
v0.1.3
dd1a21e

v0.1.3

OIDC Trusted Publishing for PyPI (canonprims) and npm (@3leaps/canonprims),
published-release staging and live registry digest verification, and
release-script portability hardening. The library, language bindings,
conformance corpus and canon command are unchanged from 0.1.2.

What it ships

  • Rust crates canonprims-core and canonprims-json (crates.io).
  • Go module github.com/3leaps/canonprims (package canon), standard
    library only and cgo-free.
  • canon command for linux amd64/arm64, darwin arm64 and windows
    amd64/arm64.
  • Python package canonprims (PyPI): an abi3 wheel per platform for
    CPython 3.10 and later, on linux amd64/arm64 (manylinux2014, glibc 2.17 or
    later), darwin arm64 and windows amd64/arm64. No source distribution.
  • npm package @3leaps/canonprims: one WebAssembly module with no
    imports, embedded in an ES module with no runtime dependencies. Tested on
    Node.js 20 and 22.

The wheels and the npm package are release assets: built and tested in the
tag workflow, listed in both checksum manifests and covered by both
signatures. The packages on PyPI and npm are these exact files.

Release machinery and OIDC publication

  • .github/workflows/registry-publish.yml: manual workflow_dispatch
    workflow on a v* tag ref. The verify job restores and verifies the
    signed tag on origin, checks source inertness, stages and verifies the
    published GitHub release via scripts/release-stage-published.sh, and
    uploads the verified release bundle. The publish-pypi (publish-pypi
    environment) and publish-npm (publish-npm environment) jobs re-verify
    every wheel and tarball SHA-256 against the signed SHA256SUMS manifest
    (scripts/ci-prepare-pypi-publish.sh, scripts/ci-publish-npm-oidc.sh),
    publish via OIDC Trusted Publishing with PEP 740 and npm provenance
    attestations, and run scripts/release-verify-registries.sh.
  • Live registry and provenance verification (make release-stage-published, make release-verify-registries):
    binds staged public signing keys, fingerprint pins and release notes
    byte-for-byte to the verified tag commit, verifies both SHA256SUMS and
    SHA512SUMS signatures, and confirms that PyPI serves the exact five wheels
    under .ownership.organization == "3leaps" with PEP 740 provenance
    attestations (/integrity/canonprims/<version>/<wheel>/provenance) and npm
    serves the exact @3leaps/canonprims tarball (dist.integrity SHA-512 SRI
    and dist.shasum) with Sigstore provenance (dist.attestations.provenance).
  • GitHub environment, ruleset, and signing ceremony guards: adds
    scripts/release-github-preflight.sh (make release-github-preflight) to
    verify the publish-pypi and publish-npm environments (required reviewer +
    v* tag policy), the Tag Publish Protection ruleset, and
    immutable_releases; pins git -c gpg.format=openpgp -c gpg.program=gpg -c gpg.openpgp.program=gpg for tag signing and verification; refuses the
    default ~/.gnupg keyring during signing; and updates
    scripts/release-prepare-tag-message.py to the 3-line attribution trailer.
  • Portability and ceremony helpers: adds make release-stage,
    make release-crates-clean and make release-pack-npm-redirector, declares
    npm (>= 10.0.0) and uv (>= 0.5.0) in .goneat/tools.yaml and
    config/doctor-versions.txt, enforces lowercase-only ASCII hex in the Rust
    canon-diff crosscheck driver, guards against unguarded Bash 3.2 empty-array
    expansions in scripts/jq-portability.sh, uses mode-120000 git index
    entries and core.autocrlf=false in the surface-check test suites, and
    separates project name and trademark notices into NOTICE alongside verbatim
    LICENSE-MIT and LICENSE-APACHE files in the repository root and binding
    packages.

Conformance

  • Corpus conformance/canonical-json/v0, 180 cases, unchanged.
    MANIFEST.json sha256:
    de3ac543580ddb90f7e3a6e72239097274d3635ea783f302a9260b5a7d0c8d90.
  • Rust and Go agree byte for byte on the corpus and on generated input:
    crosscheck seeds 20261022 and 20261023, 5000 inputs each, on every
    native CI cell.
  • Each binding runs the whole corpus against its installed package (the
    wheel, or the packed npm tarball), and its corpus results and its output on
    the same crosscheck seeds equal Rust's byte for byte.

Verification

canon canonicalizes and digests; it verifies no signatures, so it embeds no
key. To verify this release, check the signed tag v0.1.3 and the signed
checksum manifests against the public pins committed in the tagged commit
(docs/security/); see docs/security/README.md. A wheel or the npm tarball
downloaded from PyPI or npm has the SHA-256 listed for it in SHA256SUMS.