From 2c4618cbb496c96c2f857ad9bfcba80ac25ea801 Mon Sep 17 00:00:00 2001 From: Ryan Dombrowski Date: Wed, 22 Jul 2026 21:45:31 -0400 Subject: [PATCH] docs(release): publish-propagation operational note (dspack-spec v0.4.1 incident) Co-Authored-By: Claude Fable 5 --- .github/workflows/release.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 6313b3e..c21968f 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -11,6 +11,14 @@ name: release # Guards: # - tag must equal the package.json version (prevents accidental mismatches) # - full test suite + schema drift check run before publish +# +# Operational note (dspack-spec v0.4.1 incident): a successful trusted +# publish may temporarily APPEAR to fail because of registry +# read-after-write propagation — the publish lands but the CLI's +# post-publish lookup 404s. Before retrying an apparently failed +# publication, check the package version, dist.attestations, and registry +# availability directly. Do not retry solely on a post-publish metadata +# lookup failure: a second run may hit an immutable-version conflict. on: push: