NPL OCI PASSPORT — maintained release procedure, 2026-11-16

Purpose: offline Form 1 supplied-packet evaluator; independent local/purchased
Passport verifier; reproducible reference for the existing NPL service. This
does not replace Home, retrieve an owner Map, authorize an action or bill locally.
The existing R18A Azure HTTP/EasyAuth/Blob image and adapters remain preserved.
Current paid execution remains the Cloudflare Python Worker with private R2.
Do not reactivate the old Azure site as a prerequisite to offline distribution.

The new image has no third-party Python dependencies, runs as UID 10001, and
works with no network, a read-only root, no capabilities and no new privileges.
Supply exactly {"packet": ...}; Form 2 shorthand remains on the service/Home.
Use synthetic fixtures for public examples. Maximum JSON input: 2 MiB.
Packet identifiers are declarations checked for internal consistency, not an
authenticated owner, vault principal, Map-access grant or recovery credential.

Normal repo-relative commands (Python 3.11+ and Docker with Buildx required):
  python3 -B pass_machine_oci_gate.py
  python3 -B npl_passport_oci.py self-test
  python3 -B scripts/release_npl_oci.py prepare --directory npl-artifact-custody/release-01
  python3 -B scripts/release_npl_oci.py build --directory npl-artifact-custody/release-01
  python3 -B scripts/release_npl_oci.py check --directory npl-artifact-custody/release-01

Prepare requires every allowlisted input to match HEAD. A source snapshot made
with --allow-dirty is a LOCAL CANDIDATE and cannot be published to the registry.
Commit reviewed implementation only with owner authorization. Preserve other
work and never force-reset. Repeat prepare/build in release-02 and compare the
image_id in both build.json files before claiming byte-reproducibility.
The Dockerfile normalizes file/directory timestamps inside an isolated build
stage before copying into the runtime; ZIP extraction times cannot change the
runtime source layer. Pinned base, platform, source files and SHA-256 are in npl_oci_release.json and
prepared.json. There is no floating pip install or dependency resolution.

Clean checkout (substitute the actual accepted full commit, not a branch tip):
  git clone https://github.com/Max-ROI-LLCt/codespaces-validation-harness.git npl-release
  cd npl-release
  git checkout --detach ACCEPTED_FULL_COMMIT
  python3 -B pass_machine_oci_gate.py
  python3 -B scripts/release_npl_oci.py prepare --directory npl-artifact-custody/release-01
  python3 -B scripts/release_npl_oci.py build --directory npl-artifact-custody/release-01

For a downloaded verified source ZIP without Git: unzip into a NEW directory.
Run python3 -B npl_passport_oci.py verify-source --expected-source-sha256 DIGEST
using the independently retained digest. Read base/epoch/commit from
release-source.json, then docker buildx build --load --network=none
--provenance=false --platform linux/amd64 -f Dockerfile.passport.oci
--build-arg SOURCE_DATE_EPOCH=EPOCH --build-arg NPL_SOURCE_COMMIT=COMMIT
--build-arg NPL_SOURCE_SHA256=DIGEST -t npl-passport-offline:verified .
The publication page supplies these exact candidate values and a one-line
command. Do not claim the ZIP's uncommitted inputs belong to its base commit.

Run/verify (IMAGE is the accepted image ID locally or registry@sha256 remotely):
  docker run --rm --network none --read-only --cap-drop ALL --security-opt no-new-privileges IMAGE self-test
  docker run --rm -i --network none --read-only --cap-drop ALL --security-opt no-new-privileges IMAGE evaluate < request.json > local-result.json
  docker run --rm --network none --read-only --cap-drop ALL --security-opt no-new-privileges -v "$PWD:/evidence:ro" IMAGE verify --request /evidence/request.json --result /evidence/local-result.json
The last command also verifies an NPL_COMPLETE_MACHINE_RESULT_V1 purchased
receipt against the buyer's separately retained request. Verification never
performs a payment or reaches receipt storage. Retain private evidence with
umask 077; never publish recovery credentials or usable owner grants.

Durable image custody:
  docker save --output npl-artifact-custody/accepted-image.tar IMAGE
  sha256sum npl-artifact-custody/accepted-image.tar
Keep this archive and prepared source in a backed-up operator artifact store;
the workspace alone is not remote custody. Archives are Git-ignored. Preserve
the original npl-passport-r18a:local image and its export before any upgrade.

Existing registry target: nplazval0534fa9.azurecr.io/npl/decision-state-passport.
This is authenticated ACR, not assumed publicly pullable. No registry secret is
embedded in the image, source archive, public metadata or shell instructions.
Use the existing Azure session/account. Exact tenant/subscription/access steps
are in NPL_AZURE_RECOVERY.txt; metadata read and push rights are distinct.
With the correct existing login and scoped ACR push permission:
  python3 -B scripts/release_npl_oci.py publish --directory npl-artifact-custody/release-01
The command uses oci-FULL_COMMIT, never overwrites an existing tag, reconciles
an interrupted push by pulling/checking the existing digest, runs the remote
self-test, locks write/delete and reads the lock back. published.json retains
the immutable remote reference. Rerun to recheck that reference without debit.

Source hashes/image digests prove integrity against retained evidence; they are
not an issuer signature. No existing NPL asymmetric artifact signing key or
hardware-attestation chain has yet been recovered. A denied vault listing is
not evidence of absence. Do not rotate a key or invent a signature requirement.
Do not equate Docker base-image provenance with NPL runtime attestation.
If an actual NPL signer contract is recovered, add that same signer and verify
its public fingerprint before labeling a release signed. Do not borrow keys.

Release acceptance: exact source snapshot + local image self-test + separate
process verification of Form 1 PASS/HOLD challenges + browser/public catalog
and download readback. Registry publication, issuer signing, hardware evidence,
and real payment settlement are independent statuses. HOLD is a valid delivery.
Base remains disabled. Testnet hosted Passport costs 110116999 microCCD plus
network fees. Offline evaluation/verification is not a paid hosted issuance.

Rollback: preserve the prior manifest/digest and pull it by immutable digest;
never move or delete published commit tags. This OCI release has no live Home
deployment. Website changes use the existing buyer Worker rollback procedure
and prior Worker version recorded in NPL_REENTRY.txt. Never replace Home state,
keys, paid-order journals or retained results to roll back documentation/code.
