Skip to content

fix(Felt): realign docs @patternfly alias pins with workspace versions - #12705

Merged
gabipodolnikova merged 1 commit into
patternfly:felt-v1from
gabipodolnikova:fix-docs-alias-workspace-links
Nov 2, 2026
Merged

gabipodolnikova merged 1 commit into
patternfly:felt-v1from
gabipodolnikova:fix-docs-alias-workspace-links

Conversation

@gabipodolnikova

Copy link
Copy Markdown
Contributor

What: Fixes the failing felt-v1 Release workflow (run 41410237436), where every job fails at the setup step.

Additional issues: Follow-up to #12699 (PF-4694)

What happened

After #12699 merged, all jobs on felt-v1 fail in ~20s at Set up project:

YN0028: The lockfile would have been modified by this install,
which is explicitly forbidden.

Root cause: the release commit (48515fc1c) bumped the react-core, react-table, and react-code-editor workspaces to 0.0.1-prerelease.4, but the @patternfly/* npm aliases in react-docs (kept for @patternfly/documentation-framework, which resolves the PatternFly names internally) still pin 0.0.1-prerelease.3. The squash merge combined both states, so yarn can no longer link those three aliases to the workspaces — it needs registry fallbacks instead, meaning the committed lockfile no longer matches the manifests and yarn install --immutable (what the setup action runs) fails.

This also blocks the Deploy release job, which is why 0.0.1-prerelease.4 is not on npm yet.

The fix

Bump the three stale alias pins in packages/react-docs/package.json to 0.0.1-prerelease.4 so they match the workspace versions and link to the local packages again. The remaining aliases (react-icons@0.0.1-prerelease.2, react-styles@0.0.1-prerelease.3, react-tokens@0.0.1-prerelease.2) still match their workspace versions. (I also tried aliasing via the workspace: protocol so the pins would track the workspaces automatically — yarn 4 doesn't support that form, Workspace not found.)

Note

These alias pins must be bumped in lockstep with releases of the aliased packages until the Felt-compatible documentation framework removes the need for the aliases (PF-4694 follow-up).

Verification

  • yarn install --immutable passes cleanly on this branch (the exact failing CI invocation)
  • node_modules/@patternfly/{react-core,react-table,react-code-editor} are workspace symlinks again
  • Lockfile entries re-merge the aliases with the workspace descriptors (version: 0.0.0-use.local)

The release commit that bumped react-core, react-table, and
react-code-editor to 0.0.1-prerelease.4 left the @patternfly/* npm
aliases in react-docs pinning 0.0.1-prerelease.3. The version
mismatch stops yarn from linking those aliases to the workspaces, so
the committed lockfile no longer satisfies yarn install --immutable
(YN0028) and every CI job fails at setup, which also blocks the
release deploy job.

Bump the three alias pins to 0.0.1-prerelease.4 so they link to the
workspaces again. The remaining aliases (icons, styles, tokens) still
match their workspace versions.

These pins must be bumped in lockstep with future releases of the
aliased packages until the Felt-compatible documentation framework
removes the need for the aliases.
@coderabbitai

coderabbitai Bot commented Nov 2, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: a53d4fbb-4e41-496e-9181-96489e5ed15a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@gabipodolnikova
gabipodolnikova merged commit 7a90395 into patternfly:felt-v1 Nov 2, 2026
15 checks passed
gabipodolnikova added a commit that referenced this pull request Nov 2, 2026
…otocol (#12706)

Replace the exact-version pins on the six @patternfly/* npm aliases in
react-docs with workspace ranges:

    "@patternfly/react-core": "npm:@rh-felt/react-core@workspace:^"

The exact pins had to match the workspace versions for yarn to link
the aliases to the local packages, so every release of an aliased
package silently broke `yarn install --immutable` (YN0028) until the
pins were bumped in lockstep (#12705). The `npm:<name>@workspace:^`
form binds each alias to the local workspace regardless of its
current version, so releases no longer require pin bumps.

The @patternfly/patternfly -> @rh-felt/styles alias keeps its registry
pin because styles is not a workspace in this repo; a stale pin there
only lags the published CSS package and cannot break installs.

Verified: yarn install --immutable passes; a simulated version bump
to an unpublished 0.0.1-prerelease.5 keeps every alias linked to its
workspace with no manifest changes; yarn build and yarn build:docs
pass.
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