Skip to content

docs(release): publish-propagation operational note#11

Merged
ryandmonk merged 1 commit into
mainfrom
docs/publish-propagation-note
Jul 23, 2026
Merged

docs(release): publish-propagation operational note#11
ryandmonk merged 1 commit into
mainfrom
docs/publish-propagation-note

Conversation

@ryandmonk

Copy link
Copy Markdown
Contributor

Owner-directed operational note from the dspack-spec v0.4.1 incident: a successful trusted publish can appear to fail on registry read-after-write lag — verify version/dist.attestations before retrying; never retry on the lookup failure alone (immutable-version conflict risk). Comment-only change to release.yml.

🤖 Generated with Claude Code

….1 incident)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 23, 2026 01:45
@ryandmonk
ryandmonk merged commit cc10047 into main Jul 23, 2026
2 checks passed

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds an operational note to the release workflow documenting a known npm registry read-after-write propagation lag scenario observed during the dspack-spec v0.4.1 incident, to help prevent unsafe retry behavior that can trigger immutable-version conflicts.

Changes:

  • Document that a trusted publish can succeed while a post-publish metadata lookup temporarily 404s due to propagation lag.
  • Recommend verifying published version and dist.attestations directly before retrying, and caution against retrying based solely on lookup failure.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants