Skip to content

docs: pin enscli/ensskills prerelease install refs to merged snapshot#2252

Merged
shrugs merged 2 commits into
mainfrom
hotfix/cli-skills-versions
Jun 3, 2026
Merged

docs: pin enscli/ensskills prerelease install refs to merged snapshot#2252
shrugs merged 2 commits into
mainfrom
hotfix/cli-skills-versions

Conversation

@shrugs
Copy link
Copy Markdown
Member

@shrugs shrugs commented Jun 3, 2026

Fast-follow to #2242. Now that it's merged, the docs install snippets for enscli/ensskills no longer need to track the floating @next tag / main branch — pin them to the immutable refs that merge's snapshot publish produced.

Changes

docs/ensnode.io/src/data/enscli-ensskills-prerelease.ts:

  • ENSCLI_ENSSKILLS_NPM_SPEC0.0.0-next-20260603190454 (the published snapshot version)
  • ENSCLI_ENSSKILLS_GIT_REF0eec193 (the main commit it was built from, so skills add tree/<ref> is pinned to an immutable commit)

Docs prose updated to match (ai-llm.mdx, ensskills.mdx): the prerelease window now "pins to an immutable main commit + exact snapshot version" rather than "tracks @next/main".

Hosted-instance warning (HostedInstanceVersionWarning.astro): notes that these prerelease refs are functional against the hosted instances running snapshot.sdkVersion.

Still temporary

The enscli-ensskills-prerelease.ts module and the TEMP prerelease markers remain — they get removed (snippets reverted to snapshot.sdkVersion / v${sdkVersion}) at the first official release that publishes enscli/ensskills in lockstep with the suite.

Validation

  • pnpm -F @docs/ensnode build ✓ (113 pages)
  • pnpm lint

Now that #2242 is merged, point the prerelease install shim at immutable refs from
that merge's snapshot publish instead of the floating @next/main:
- ENSCLI_ENSSKILLS_NPM_SPEC -> 0.0.0-next-20260603190454 (published snapshot version)
- ENSCLI_ENSSKILLS_GIT_REF  -> 0eec193 (the main commit it was built from)

Also note in the hosted-instance warning that these prerelease refs are functional
against the hosted instances running snapshot.sdkVersion.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@shrugs shrugs requested a review from a team as a code owner June 3, 2026 19:10
Copilot AI review requested due to automatic review settings June 3, 2026 19:10
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Jun 3, 2026

⚠️ No Changeset found

Latest commit: 4942cce

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Jun 3, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
enskit-react-example.ensnode.io Ready Ready Preview, Comment Jun 3, 2026 7:17pm
ensnode.io Ready Ready Preview, Comment Jun 3, 2026 7:17pm
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
admin.ensnode.io Skipped Skipped Jun 3, 2026 7:17pm
ensrainbow.io Skipped Skipped Jun 3, 2026 7:17pm

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jun 3, 2026

Review Change Stack

Warning

Review limit reached

@shrugs, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 54 minutes and 25 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: d2e663e7-f281-4ea2-9658-009a7a11bca6

📥 Commits

Reviewing files that changed from the base of the PR and between 35b1b25 and 4942cce.

📒 Files selected for processing (1)
  • docs/ensnode.io/src/content/docs/docs/integrate/integration-options/ensskills.mdx
📝 Walkthrough

Walkthrough

This PR updates prerelease pinning documentation and configuration for enscli and ensskills packages, moving from moving references (@next tag, main branch) to exact immutable snapshot identifiers (npm snapshot version and git commit SHA). Documentation across multiple integration guides and a user-facing component are updated to consistently describe and encourage this pinning strategy.

Changes

Prerelease Snapshot Pinning

Layer / File(s) Summary
Prerelease pinning constants and guidance
docs/ensnode.io/src/data/enscli-ensskills-prerelease.ts
Exported constants ENSCLI_ENSSKILLS_NPM_SPEC and ENSCLI_ENSSKILLS_GIT_REF are pinned to immutable snapshot identifiers: npm snapshot 0.0.0-next-20260603190454 and git commit 0eec193. Documentation comments describe the fixed snapshot build strategy.
Documentation and component updates for prerelease pinning
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/ensskills.mdx, docs/ensnode.io/src/content/docs/docs/integrate/ai-llm.mdx, docs/ensnode.io/src/components/molecules/HostedInstanceVersionWarning.astro
Integration documentation is updated to clarify pinning to exact prerelease snapshots built from immutable commits until first official release. The HostedInstanceVersionWarning component instructs installation from the prerelease snapshot with assurance of compatibility for hosted instances running the pinned version.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

  • namehash/ensnode#2112: Main PR's documentation edits to ensskills.mdx and ai-llm.mdx build on the retrieved PR's new integration documentation pages and routing.

Suggested labels

docs

Poem

📚 A snapshot frozen in time, immutable and true,
No more chasing the moving main, we've found what's new.
From 0eec193 we build, precise and clean,
The prerelease path is now crystalline. 🐰✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The PR description covers the key changes, rationale referencing a related PR, and validation testing, but deviates from the template structure by using custom section headers instead of the required 'Summary', 'Why', 'Testing', and 'Pre-Review Checklist' sections. Reformat the description to follow the 'Lite PR' template structure: use 'Summary' for bullet points, 'Why' for rationale, 'Testing' section with test results, and include the 'Pre-Review Checklist' with checkboxes.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: pinning enscli/ensskills prerelease install references to a merged snapshot build rather than floating tags.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch hotfix/cli-skills-versions

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

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Pins the documentation’s temporary prerelease installation references for enscli/ensskills to the specific snapshot artifacts produced from the now-merged work, replacing floating @next/main refs with immutable version/ref values to keep install snippets stable until the first official lockstep release.

Changes:

  • Updated prerelease install constants to a specific snapshot npm version and a specific main commit ref.
  • Adjusted docs prose in integration pages to describe the new “pinned snapshot” behavior.
  • Updated the hosted-instance compatibility warning copy to reflect prerelease snapshot installs and hosted compatibility.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
docs/ensnode.io/src/data/enscli-ensskills-prerelease.ts Replaces floating prerelease refs with pinned snapshot npm spec + commit ref and updates explanatory comments.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/ensskills.mdx Updates prerelease aside and pinning guidance text to match pinned snapshot behavior.
docs/ensnode.io/src/content/docs/docs/integrate/ai-llm.mdx Updates npx skills quickstart prose to describe pinning to an immutable commit during prerelease.
docs/ensnode.io/src/components/molecules/HostedInstanceVersionWarning.astro Updates hosted-instance warning text to reference prerelease snapshot installs and compatibility statement.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/ensnode.io/src/data/enscli-ensskills-prerelease.ts
Comment thread docs/ensnode.io/src/content/docs/docs/integrate/integration-options/ensskills.mdx Outdated
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Jun 3, 2026

Greptile Summary

This PR fast-follows #2242 to convert the enscli/ensskills prerelease install pins from floating refs (@next dist-tag, main branch) to immutable ones: npm spec 0.0.0-next-20260603190454 and short commit 0eec193. All three doc surfaces that render these values (HostedInstanceVersionWarning.astro, ai-llm.mdx, ensskills.mdx) are updated to match.

  • enscli-ensskills-prerelease.ts: two exported constants updated from \"next\" / \"main\" to the pinned snapshot version and commit hash; module comment updated accordingly.
  • HostedInstanceVersionWarning.astro: "prerelease tag" → "prerelease snapshot"; new sentence confirms compatibility with hosted instances.
  • ensskills.mdx: intended TEMP prerelease <Aside> removed, but two additional, unmarked Asides (the claude-code agent-key caution and monorepo scoping note) are also removed without explanation in the PR description.

Confidence Score: 5/5

Safe to merge; the core pin changes are correct and isolated to the prerelease data module.

The constant values in enscli-ensskills-prerelease.ts are updated from floating to immutable refs as described, and every downstream doc surface that consumes them is updated consistently. The only noteworthy item is that two Aside blocks in ensskills.mdx — the claude-code agent-key caution and the monorepo scoping note — are removed without explanation, but both were documentation-only and do not affect build output or runtime behavior.

docs/ensnode.io/src/content/docs/docs/integrate/integration-options/ensskills.mdx — verify the removal of the claude-code and monorepo Asides is intentional.

Important Files Changed

Filename Overview
docs/ensnode.io/src/data/enscli-ensskills-prerelease.ts Pins ENSCLI_ENSSKILLS_NPM_SPEC from the floating "@next" dist-tag to the exact snapshot "0.0.0-next-20260603190454", and ENSCLI_ENSSKILLS_GIT_REF from "main" to the immutable short commit "0eec193". Module comment updated to match.
docs/ensnode.io/src/components/molecules/HostedInstanceVersionWarning.astro Copy updated: "prerelease tag" → "prerelease snapshot" and a new sentence confirms these refs are functional against the hosted instances. Clean change.
docs/ensnode.io/src/content/docs/docs/integrate/ai-llm.mdx Prose updated to describe "pins to the immutable main commit" rather than "tracks main", matching the new ENSCLI_ENSSKILLS_GIT_REF constant. No structural changes.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/ensskills.mdx Removes the TEMP prerelease Aside (expected), but also removes two unrelated Asides: a caution about the claude-code vs claude agent key causing silent symlink failure, and a monorepo scoping note — neither was flagged as TEMP and neither is mentioned in the PR description.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[enscli-ensskills-prerelease.ts] -->|ENSCLI_ENSSKILLS_NPM_SPEC\n0.0.0-next-20260603190454| B[ai-llm.mdx]
    A -->|ENSCLI_ENSSKILLS_NPM_SPEC| C[ensskills.mdx]
    A -->|ENSCLI_ENSSKILLS_NPM_SPEC| D[HostedInstanceVersionWarning.astro]
    A -->|ENSCLI_ENSSKILLS_GIT_REF\n0eec193| B
    A -->|ENSCLI_ENSSKILLS_GIT_REF| C
    B -->|renders npm install snippet| E[Rendered Docs]
    B -->|renders npx skills URL| E
    C -->|renders npm install snippet| E
    C -->|renders npx skills URL| E
    D -->|renders prerelease notice| E
Loading

Reviews (2): Last reviewed commit: "fix" | Re-trigger Greptile

Comment thread docs/ensnode.io/src/data/enscli-ensskills-prerelease.ts
@shrugs shrugs merged commit 61ee0ac into main Jun 3, 2026
20 checks passed
@shrugs shrugs deleted the hotfix/cli-skills-versions branch June 3, 2026 19:21
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.

2 participants