Five gates define usable installation.
Package bytes and manifest exist.
Every declared runtime export exists.
The manifest names a valid DSH bundle patch.
The profile includes the dependency-managed layer.
A fifth gate is operational: the resolved config and an isolated boot must succeed. Never collapse these gates into one filesystem-existence check.
Retry to zero, or remove to known-good.
Rerun the original DSH command and require a zero exit.
Require successful removal and compare the known-good graph.
Stop writers and retain manifest, lockfile, workspace policy, and output.
A blocked Git `prepare` may leave `package.json` while omitting `dist/` or `lib/`. Manual activation converts an install diagnostic into a profile boot failure.
Primary evidence.
- Official discussion #3451
- rc.8 plugin control flow
- Plugin-management contract
- Profile manifest and bundle resolution
Make partial success explicit.
The complete runbook includes the rc.8 branch trace, classification matrix, reviewed retry, known-good rollback, unsafe shortcuts, an upstream policy decision, and twelve regression gates.
Read the complete runbook