Skip to content

docs(release): document the wrapper install-verification steps - #139

Merged
dipto0321 merged 1 commit into
mainfrom
docs/release/wrapper-verify-steps
Nov 2, 2026
Merged

dipto0321 merged 1 commit into
mainfrom
docs/release/wrapper-verify-steps

Conversation

@dipto0321

Copy link
Copy Markdown
Owner

Summary

Adds the missing verification procedure to docs/release-checklist.md
for the npm wrapper's install path.

The publish-npm job going green does not mean the version is visible
on npmjs.com yet — the registry takes a few minutes to propagate, and
verifying before that looks like a phantom failure.

The new section covers:

  • the propagation delay, with a "poll until it matches" instruction
  • the published-metadata check (npm view nodeupx version dependencies engines)
  • npm install + npm audit against the published package rather
    than the local checkout
  • the npm 12 allowScripts gate and its approve + re-install
    remedy
  • the xattr -p com.apple.quarantine check on the downloaded binary

That last one is the point of the exercise: the wrapper strips the
attribute itself, so a binary that still carries it would be killed by
macOS before main() ever runs — exactly the failure mode v1.2.2
fixed.

Test plan

  • make ci green (docs-only change)
  • Every command in the new section run verbatim against the
    published nodeupx@1.2.3 — including the quarantine check and
    the nodeup version run

The npm publish job going green does not mean the version is visible
on npmjs.com yet — the registry takes a few minutes to propagate. Add
that warning, plus the full verification procedure for the wrapper's
postinstall path (publish metadata, npm audit, the npm 12 allowScripts
gate, and the quarantine check on the downloaded binary).

The quarantine check is the part that matters most: the wrapper strips
the attribute itself, so a binary that still carries it would be killed
by macOS before main() ever runs.
@cocogitto-bot

cocogitto-bot Bot commented Nov 2, 2026

Copy link
Copy Markdown

✔️ db2b714 - Conventional commits check succeeded.

@dipto0321
dipto0321 merged commit f5cb8d7 into main Nov 2, 2026
11 checks passed
@dipto0321
dipto0321 deleted the docs/release/wrapper-verify-steps branch November 2, 2026 07:28
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.

1 participant