Skip to content

docs(changelog): update changelog & fix release - #2678

Merged
miguelg719 merged 3 commits into
mainfrom
changelog-4-0-0-migration
Aug 10, 2026
Merged

docs(changelog): update changelog & fix release#2678
miguelg719 merged 3 commits into
mainfrom
changelog-4-0-0-migration

Conversation

@miguelg719

@miguelg719 miguelg719 commented Aug 10, 2026

Copy link
Copy Markdown
Collaborator

Three fixes, all wanted before the 4.0.0 release run (merging this PR to main is itself the release trigger):

  1. 4.0.0 changelog entries now carry the cutover one-liner from Stagehand v4 #2671 and link the v3→v4 migration guide, matching the 3.0.0 entry's pattern.
  2. 3.0.1–3.7.1 history restored — the consolidated root changelog seeded on v4-spike jumped from 4.0.0 straight to 3.0.0, silently dropping 16 releases. Spliced back verbatim from packages/core/CHANGELOG.md on the v3 branch (that history's maintenance home going forward).
  3. Release workflow unblocked — the 4.0.0 publish run failed with EBADDEVENGINES: devEngines.packageManager with onFail: "download" makes every npm command in the repo hard-fail (npm can't download itself into being pnpm), and changeset publish preflights with npm info (the publish itself uses pnpm publish, so catalog: deps resolve fine — verified in @changesets/cli 2.31's getPublishTool). onFail: "warn" keeps the pnpm nudge without blocking npm tooling; verified npm info now succeeds in-repo.

consolidate-changelogs.ts --check passes.

Match the 3.0.0 entry's pattern: the major-bump entries now carry the
one-line summary from the cutover PR (#2671) and link to the docs
migration guide.
@changeset-bot

changeset-bot Bot commented Aug 10, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: d100395

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

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

No issues found across 1 file

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Re-trigger cubic

The consolidated root changelog seeded on v4-spike jumped from 4.0.0
straight to 3.0.0, dropping 16 releases of 3.x history. Splice the
entries back in from packages/core/CHANGELOG.md on the v3 branch.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

1 issue found across 1 file (changes from recent commits).

Confidence score: 5/5

  • In CHANGELOG.md, the 3.1.0 caching note’s passive phrasing can obscure who enables caching by default and who can opt out, which may cause mild reader confusion in public release communication—rewrite it in active voice naming Stagehand and users explicitly.
Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="CHANGELOG.md">

<violation number="1" location="CHANGELOG.md:289">
P3: The 3.1.0 caching note uses passive voice for default and opt-out behavior. Name Stagehand and users as actors.

(Based on your team's feedback about active voice in public documentation.)</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread CHANGELOG.md

When running `env: "BROWSERBASE"`, Stagehand automatically caches `act()`, `extract()`, and `observe()` results server-side — repeated calls with the same inputs return instantly without consuming LLM tokens.

Caching is enabled by default and can be disabled via `serverCache: false` on the Stagehand instance or per individual call. Check out the [browserbase blog](https://www.browserbase.com/blog/stagehand-caching) for more details.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

P3: The 3.1.0 caching note uses passive voice for default and opt-out behavior. Name Stagehand and users as actors.

(Based on your team's feedback about active voice in public documentation.)

View Feedback

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At CHANGELOG.md, line 289:

<comment>The 3.1.0 caching note uses passive voice for default and opt-out behavior. Name Stagehand and users as actors.

(Based on your team's feedback about active voice in public documentation.) </comment>

<file context>
@@ -19,6 +19,513 @@ describe the TypeScript SDK.
+
+  When running `env: "BROWSERBASE"`, Stagehand automatically caches `act()`, `extract()`, and `observe()` results server-side — repeated calls with the same inputs return instantly without consuming LLM tokens.
+
+  Caching is enabled by default and can be disabled via `serverCache: false` on the Stagehand instance or per individual call. Check out the [browserbase blog](https://www.browserbase.com/blog/stagehand-caching) for more details.
+
+- [#1642](https://github.com/browserbase/stagehand/pull/1642) [`3673369`](https://github.com/browserbase/stagehand/commit/36733691f90c15386cf2a7b47d04ef429b7195ae) Thanks [@seanmcguire12](https://github.com/seanmcguire12)! - fix issue where scripts added via context.addInitScripts() were not being injected into new pages that were opened via popups (eg, clicking a link that opens a new page) and/or calling context.newPage(url)
</file context>
Suggested change
Caching is enabled by default and can be disabled via `serverCache: false` on the Stagehand instance or per individual call. Check out the [browserbase blog](https://www.browserbase.com/blog/stagehand-caching) for more details.
Stagehand enables caching by default; users can disable it with `serverCache: false` on the Stagehand instance or per individual call. Check out the [browserbase blog](https://www.browserbase.com/blog/stagehand-caching) for more details.

devEngines.packageManager with onFail: 'download' makes every npm
command in the repo hard-fail (npm cannot download itself into being
pnpm). changeset publish shells out to 'npm info' to check published
versions before publishing (the publish itself uses pnpm), so the
Release workflow died on EBADDEVENGINES. onFail: 'warn' keeps the
pnpm nudge for contributors without blocking npm-based tooling.
@miguelg719 miguelg719 changed the title docs(changelog): point 4.0.0 entries at the v3→v4 migration guide docs(changelog): 4.0.0 migration link + restore 3.x history; fix release publish blocker Aug 10, 2026
@seanmcguire12 seanmcguire12 changed the title docs(changelog): 4.0.0 migration link + restore 3.x history; fix release publish blocker docs(changelog): update changelog & fix release Aug 10, 2026
@miguelg719
miguelg719 merged commit d3142a7 into main Aug 10, 2026
19 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.

2 participants