feat(v3): migrate generated integrations to canonical stack DX by olliethedev · Pull Request #240 · better-stack-ai/better-stack

olliethedev · 2026-08-29T08:59:54Z

Closes #223

Summary

migrate the CLI, scaffold templates, playground, and maintained Next.js, React Router, and TanStack Start overlays to createBackendStack, createClientStack, canonical camelCase plugin IDs, and inferred provider overrides
keep one shared client runtime while separating fresh request stacks (origin + headers) from header-free browser stacks; hydrate only the validated tri-state identity and browser-safe request origin
migrate generated lifecycle examples and seed helpers to the canonical factory and trust contracts, including a public third-party plugin fixture with inferred overrides
make Route Docs a representative client-only registry consumer and validate real UI Builder-over-CMS composition with pinned upstream registry snapshots
strengthen reproducibility, bundle-boundary, server-module, storage-adapter, request-header, and authorization-boundary checks across generated artifacts
document the React Router and TanStack Start request-origin hydration contract without expanding the broader v3 docs migration scope

Important boundaries

OpenAPI remains backend-only, Route Docs remains client-only, and UI Builder remains client-only over CMS
request headers and resolved server stack instances never cross loader/provider serialization boundaries
browser providers receive a header-free client stack; server loaders create a fresh request-specific stack
only real two-sided plugins participate in backend/client ID agreement checks
Form Builder is rejected for the non-isolating memory playground configuration instead of bypassing the compatibility guard

Verification

pnpm build
pnpm typecheck
pnpm lint
CLI scaffold plan: 84/84
CLI packed test:init, including third-party public extension compile and Next.js production build
stack identity layout tests: 7/7
registry generation twice with a clean second generation
registry installation and production build for data, client-only, and composed UI Builder/CMS consumers
Route Docs browser regression: 13/13
docs production build
playground typecheck and production build
overlay contract and client/server bundle scans
Next.js codegen production build/E2E: 152 passed, 34 skipped (AI-key-only tests)
React Router codegen production build/E2E: 149 passed, 34 skipped (AI-key-only tests)
TanStack Start codegen production build/E2E: 149 passed, 34 skipped (AI-key-only tests)

The three framework suites exercise raw SSR HTML and hydrated browser runtime origins on ports other than the fallback port, plus the existing tri-state identity and API authorization boundary.

vercel · 2026-08-29T09:00:00Z

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

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
better-stack-docs	Ignored		Aug 29, 2026 12:30pm
better-stack-playground	Ignored		Aug 29, 2026 12:30pm

olliethedev · 2026-08-29T09:00:01Z

@codex security review

chatgpt-codex-connector · 2026-08-29T09:00:06Z

You have reached your Codex usage limits for security reviews. Please try again later.

chatgpt-codex-connector · 2026-08-29T09:00:07Z

Codex Review Summary

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

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-08-29T12:40:53.054812Z	`44c3e06`	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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d7aecdc768

ℹ️ 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 · 2026-08-29T09:06:52Z

✅ Shadcn registry validated — no registry changes detected.

olliethedev · 2026-08-29T09:07:30Z

@codex security review

chatgpt-codex-connector · 2026-08-29T09:07:36Z

You have reached your Codex usage limits for security reviews. Please try again later.

olliethedev · 2026-08-29T09:12:42Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1ece82401f

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

olliethedev · 2026-08-29T09:41:55Z

@codex review

olliethedev · 2026-08-29T10:58:28Z

@codex review

chatgpt-codex-connector · 2026-08-29T11:07:30Z

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

Reviewed commit: eaae014ab3

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

olliethedev · 2026-08-29T11:08:10Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6bc3510a0b

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

olliethedev · 2026-08-29T11:19:10Z

@codex review

chatgpt-codex-connector · 2026-08-29T11:25:28Z

Codex Review: Didn't find any major issues. Already looking forward to the next diff.

Reviewed commit: dd98360a33

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

olliethedev · 2026-08-29T11:28:58Z

@codex review

chatgpt-codex-connector · 2026-08-29T11:36:51Z

Codex Review: Didn't find any major issues. Can't wait for the next one!

Reviewed commit: 82df2b6240

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

olliethedev · 2026-08-29T11:40:48Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3e937445d6

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

olliethedev · 2026-08-29T11:54:17Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bc0d361357

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

olliethedev · 2026-08-29T12:17:00Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3b53b6cb38

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

olliethedev · 2026-08-29T12:31:15Z

@codex review

chatgpt-codex-connector · 2026-08-29T12:40:51Z

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

Reviewed commit: 44c3e06a4a

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

olliethedev added 17 commits August 29, 2026 03:42

feat(registry): add canonical route docs consumer

29475bd

feat(cli): generate canonical v3 stack wiring

f423d00

fix(cli): seed through trusted plugin operations

03259a0

feat(codegen): migrate framework overlays to canonical stacks

08525b5

fix(route-docs): preserve ejected page override

4c11f24

test(registry): require owned installs to succeed

1ba5f25

fix(codegen): keep identity partitions server-only

6e8dec3

fix(codegen): align canonical stack helper overlays

7ca7580

test(registry): validate composed installs deterministically

4581c0b

test(codegen): enforce canonical extension boundaries

99f2fea

ci(registry): validate pinned fixture updates

5bf4697

fix(cli): keep extension fixtures factory-shaped

05dc636

fix(codegen): hydrate Vite provider origins

48aa24b

test(codegen): tolerate optional runtime API typing

be2bb10

docs(auth): document Vite SSR provider origins

66dcf6f

docs(installation): accept serialized provider origins

7a1c7dc

chore(registry): preserve exact fixture snapshots

d7aecdc

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread scripts/codegen/files/nextjs/lib/stack.ts Outdated

fix(codegen): reconcile WealthReview queue columns

1ece824

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/cli/src/templates/react-router/pages-route.tsx.hbs Outdated

fix(codegen): trust configured request destinations

16739ec

fix(codegen): secure managed API browser flows

eaae014

olliethedev added 2 commits August 29, 2026 07:03

fix(codegen): derive reverse sync manifests

b7e4674

docs: include managed API browser credentials

6bc3510

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/cli/src/templates/nextjs/pages-layout.tsx.hbs Outdated

fix(codegen): align Next request origins

dd98360

fix(codegen): migrate legacy Next page routes

82df2b6

fix(codegen): verify legacy scaffold snapshots

3e93744

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/cli/src/utils/legacy-next-scaffold.ts Outdated

fix(codegen): migrate historical Next scaffolds safely

bc0d361

docs(integration): align public API origin names

da58fff

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/cli/src/templates/shared/lib/stack-client.server.ts.hbs

Comment thread packages/cli/src/utils/legacy-next-scaffold.ts

fix(codegen): preserve supported legacy scaffold variants

3b53b6c

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/cli/src/utils/legacy-next-scaffold.ts

Comment thread packages/cli/src/utils/legacy-next-scaffold.ts

olliethedev added 2 commits August 29, 2026 08:27

fix(codegen): verify historical migration inputs

5559dd3

fix(codegen): fail closed around legacy child routes

44c3e06

olliethedev merged commit 3dd2141 into v3 Aug 29, 2026
9 checks passed

olliethedev deleted the feat/223-canonical-generated-integrations branch August 29, 2026 12:43

olliethedev mentioned this pull request Aug 29, 2026

[v3 DX] Migrate generated integrations, playground and registry to the canonical stack DX #223

Closed

20 tasks

Uh oh!

Conversation

olliethedev commented Aug 29, 2026

Summary

Important boundaries

Verification

Uh oh!

vercel Bot commented Aug 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codex Review Summary

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

github-actions Bot commented Aug 29, 2026

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

vercel Bot commented Aug 29, 2026 •

edited

Loading

chatgpt-codex-connector Bot commented Aug 29, 2026 •

edited

Loading