Skip to content

chore(changesets): enforce changesets, open Version Packages PR, document conventions - #403

Merged
ScriptedAlchemy merged 5 commits into
mainfrom
chore/changesets-enforcement
Sep 3, 2026
Merged

chore(changesets): enforce changesets, open Version Packages PR, document conventions#403
ScriptedAlchemy merged 5 commits into
mainfrom
chore/changesets-enforcement

Conversation

@ScriptedAlchemy

Copy link
Copy Markdown
Owner

Summary

Puts Changesets fully in force for the three publishable packages and documents it for agents.

  • .changeset/config.json: ignore the private packages (agent-bundle-workbench, @agent-bundle-example/*, @agent-bundle/rsc-agent-runtime-demo, @agent-bundle/docs), changedFilePatterns exempts tests/**, baseBranch: main, updateInternalDependencies: patch. No fixed/linked groups: agent-bundle declares @agent-bundle/runtime as an optional * peer and the runtime does not depend on agent-bundle, so the packages version independently (decision recorded in .changeset/README.md). access is untouched (maintainer decision).
  • .github/workflows/changeset.yml (new, check name Changeset present): runs pnpm changeset status --since=origin/main on every PR; fails when a publishable package changed without a new .changeset/*.md. Skips for the skip-changeset label (label created) and for changeset-release/* branches. Docs-only PRs pass because they change no publishable package. Lives outside ci.yml so label toggles re-run only this check, not the CI matrix, and to stay clear of the concurrent ci.yml host-proofs edit.
  • .github/workflows/release.yml: changesets/action@v2 now always runs on push to main and opens/updates the Version Packages PR. changeset publish stays off unless the repository variable AGENT_BUNDLE_NPM_PUBLISH=true and NPM_TOKEN exist; while off, merging Version Packages only runs the release gates (pnpm check:release). Permissions verified: contents: write, pull-requests: write, id-token: write. The repository setting "Allow GitHub Actions to create and approve pull requests" was off (which is why the stale changeset-release/main branch existed without a PR) — it has been enabled.
  • Docs: .changeset/README.md (packages, pre-1.0 semver rule, one-changeset-per-PR, summary style, ignore rationale, enforcement, release flow), docs/preview-packages.md release section, AGENTS.md "Changesets" and "Pull requests" sections.

Evidence

Local semantics of the check (pnpm changeset status --since=origin/main against this branch's base):

Scenario Exit
Config/workflow/docs only 0
packages/rsc-runtime/src/index.ts change, no changeset 1
packages/rsc-runtime/tests/*.test.ts change only 0
src change + .changeset/*.md 0
examples/mcp-app/src/index.ts only 0
packages/workbench/src/main.tsx only 0

pnpm changeset status with the new config: parses, 201 pending changesets, minor bump pending for all three packages. pnpm build, pnpm typecheck, pnpm lint green locally.

Test plan

  • Changeset present check runs on this PR and passes (no publishable change)
  • Temporary commit touching packages/rsc-runtime/src without a changeset turns the check red; reverted afterwards
  • CI green, automated review threads addressed
  • After merge: Release packages run on main opens the Version Packages PR

…ment conventions

Ignore private packages and exempt tests/** in .changeset/config.json; add a
`Changeset present` PR check (`changeset status --since=origin/main`) with a
`skip-changeset` label escape hatch; make release.yml always open/update the
Version Packages PR while keeping `changeset publish` behind the
AGENT_BUNDLE_NPM_PUBLISH repository variable; document the conventions in
.changeset/README.md, docs/preview-packages.md, and AGENTS.md.
@changeset-bot

changeset-bot Bot commented Sep 3, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 82cec69

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

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 3, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-03T07:07:54.826359Z 82cec69 Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 14d73058a7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .github/workflows/release.yml
Comment thread .github/workflows/changeset.yml Outdated
@pkg-pr-new

pkg-pr-new Bot commented Sep 3, 2026

Copy link
Copy Markdown
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle@403
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/create-agent-bundle@403
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/@agent-bundle/runtime@403

commit: 82cec69

…s PR; scope the release-branch exemption to this repo's changeset-release/main
@ScriptedAlchemy

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. 🎉

Reviewed commit: 82cec6980a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@ScriptedAlchemy
ScriptedAlchemy merged commit f9983cd into main Sep 3, 2026
16 of 17 checks passed
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