fix: align v3 auth dependency cohort

[olliethedev]

Summary

• align @btst/stack, database adapters, Better Auth, Drizzle, and Better Auth UI on one exact v3-compatible dependency cohort
• migrate generated Better Auth UI layouts to the top-level v3 auth provider bridge and carry exact package versions into StackBlitz projects without changing extraPackages semantics
• isolate @btst/cli@2.2.3 behind the codegen passthrough so its dependency graph and competing btst binary do not pollute consumer applications
• document the RC migration cohort and removal of legacy local CLI installs

Type of change

• Bug fix
• New plugin
• Feature / enhancement to an existing plugin
• Documentation
• Chore / refactor / tooling

Checklist

• pnpm build passes
• pnpm typecheck passes
• pnpm lint passes
• Tests added or updated (unit and/or E2E)
• Docs updated (docs/content/docs/) if consumer-facing types or behavior changed
• All three codegen-projects create successfully and pass E2E tests (covered by required PR matrix)
• New plugin: submission checklist in CONTRIBUTING.md completed (not applicable)

Verification

Run in the configured Linux Podman devcontainer:

• pnpm install --frozen-lockfile
• pnpm build
• pnpm test (497 stack tests and 108 codegen tests)
• pnpm typecheck
• pnpm lint
• pnpm --filter btst-playground typecheck
• pnpm --filter btst-playground build
• docs: pnpm build
• pnpm --filter @btst/codegen test:init
  • strict npm peer resolution enabled for the runtime/auth cohort
  • exact published @btst/cli@2.2.3 executed without entering node_modules
  • second init remained idempotent
  • generated all-plugin Next.js application built successfully
• all three generated StackBlitz manifests verified to contain valid package names and the exact v3 auth cohort

Closes #163

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
better-stack-docs	Ready	Preview	Aug 22, 2026 6:52pm
better-stack-playground	Ready	Preview	Aug 22, 2026 6:52pm

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b6ed90933f

ℹ️ 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".

[github-actions]

✅ Shadcn registry validated — no registry changes detected.

[olliethedev]

@codex review

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. Nice work!

Reviewed commit: 8cc569c372

ℹ️ 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".