Skip to content

feat: graduate the linked install strategy from experimental to stable#9674

Merged
owlstronaut merged 1 commit into
npm:latestfrom
manzoorwanijk:feat/stabilize-linked-install-strategy
Jun 26, 2026
Merged

feat: graduate the linked install strategy from experimental to stable#9674
owlstronaut merged 1 commit into
npm:latestfrom
manzoorwanijk:feat/stabilize-linked-install-strategy

Conversation

@manzoorwanijk

Copy link
Copy Markdown
Contributor

Removes the experimental designation from install-strategy=linked (isolated mode): drops the install-time warning and the (experimental) note in the config docs. linked is now a supported, opt-in install strategy. The default stays hoisted.

Why

install-strategy=linked (RFC-0042) has been experimental since it shipped, warning on every install. It has since been hardened extensively — the discrepancies tracked in #9608, plus ~50 earlier PRs, are resolved — and it now produces hoisted-equivalent results across install/ci/ls/query/explain/audit/sbom/exec/run/link/uninstall, the supply-chain controls (allow-scripts/allow-remote/allow-git, --strict-allow-scripts), and the v12 features (npm patch, packageExtensions, .npm-extension), with a project lockfile identical to hoisted. It has also been exercised against the Gutenberg monorepo, which powers the WordPress Block Editor. The experimental warning no longer reflects its state.

How

  • @npmcli/arborist (reify.js): remove the The "linked" install strategy is EXPERIMENTAL and may contain bugs. warning emitted on every linked install.
  • @npmcli/config (definitions.js): drop (experimental) from the install-strategy description for linked.
  • Regenerate the config docs snapshot to match.

The node_modules/.store/ layout remains an internal implementation detail. This does not change the default install strategy.

References

@manzoorwanijk manzoorwanijk marked this pull request as ready for review June 26, 2026 16:15
@manzoorwanijk manzoorwanijk requested review from a team as code owners June 26, 2026 16:15
@owlstronaut owlstronaut merged commit 86416a6 into npm:latest Jun 26, 2026
64 checks passed
@manzoorwanijk manzoorwanijk deleted the feat/stabilize-linked-install-strategy branch June 26, 2026 17:03
@manzoorwanijk

Copy link
Copy Markdown
Contributor Author

@owlstronaut the feature is no different in v11, should this be backported?

@github-actions

Copy link
Copy Markdown
Contributor

🎉 Backport to release/v11 created: #9677

owlstronaut pushed a commit that referenced this pull request Jun 26, 2026
#9677)

Backport of #9674 to `release/v11`.

Co-authored-by: Manzoor Wani <manzoorwani.jk@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants