Dokumentation
Auf dieser Seite
  1. Build ownership
  2. Registry acceptance

Build generations and registry acceptance

Trackers: pm-cxc4jc, pm-ygli86, pm-63i8nr, pm-p5u6.

Build ownership

Build/test/coverage and distribution-packing sessions own .cache/build-lease through completion; other producers/consumers wait twenty minutes. Nested readers inherit a verified PID/token receipt; nested builds require independent workspaces. Direct stages and arbitrary dist reads bypass this protocol.

Leases never expire or get stolen. Two matching reads proving PID absence fail promptly with recovery guidance. Missing/malformed/changing/ambiguous receipts use the timeout; PID reuse is ambiguous. Inspect owner and children before abandoned-lease removal. Failed builds leave .cache/build-incomplete; prebuilt tests and distribution packing refuse it until a successful build. Packing holds the lease from source inventory through isolated staging and the final archive; its asynchronous helper validates inherited consumer receipts in the same physical workspace. See SDK consumer receipts.

Interrupts stop the child and stage admission, allowing five seconds for settlement, lease release and cleanup; unsettled children retain storage. Subprocess tests cover build/prebuilt paths and installer exits bypassing finally. Storage lifecycle defines retention and platform limits.

Registry acceptance

Release publishes once, chooses the registry's closest older calendar version and runs the same eleven-step session against control then candidate in separate roots. Linux/macOS/Windows cover npm local/global and Bun local. Installed CLI/SDK and selected runtimes have two-minute step deadlines, bounded output and token receipts. Synthetic telemetry/external reporting are disabled.

Control failure indicates harness/environment problems; candidate-only failure requires regression investigation. Both block advertisement, which requires every matrix leg. Artifacts name manager/step. Immutable versions are never republished; exact-tag recovery retains the reviewed control selector. Parent deadlines cover preparation and publish/verify/advertise.

The artifact gate validates one npm array/keyed receipt, identity and size/file/map limits. Release-note fixtures own generator/changelog/Git roots, isolating dated/Unreleased over-budget cases from checkout regeneration.

npm run release:verify-installed-agent -- --version "$CANDIDATE" --previous-version "$CONTROL" --manager npm --global --json
npm run release:verify-installed-agent -- --version "$CANDIDATE" --previous-version "$CONTROL" --manager bun --json

Set both versions. Windows npm run supplies npm's JavaScript entrypoint. See packed first run and release policy (repository-only, excluded from npm).

Aus docs/BUILD_AND_RELEASE_ACCEPTANCE.md in pm 2026.11.13. Auf GitHub ansehen