Skip to content

feat: expand plugin scaffolds and scenario coverage - #139

Merged
zbeyens merged 32 commits into
mainfrom
feat/plugins
Mar 30, 2026
Merged

zbeyens merged 32 commits into
mainfrom
feat/plugins

Conversation

@zbeyens

@zbeyens zbeyens commented Mar 28, 2026

Copy link
Copy Markdown
Member

Summary

  • expand the plugin-focused Better Convex branch with the new auth/client surfaces, generated API cleanup, and broader plugin/schema coverage
  • harden scaffold and scenario tooling around the packaged Node CLI contract, template sync, create-convex flows, and full auth stress coverage
  • ship the paired docs, skills, AGENTS, and fixture updates that match the current branch behavior

Validation

  • bun lint:fix
  • bun check

zbeyens added 19 commits March 5, 2026 14:41
# Conflicts:
#	bun.lock
#	example/convex/functions/generated/server.ts
#	package.json
#	packages/better-convex/package.json
#	packages/better-convex/src/auth/create-schema.ts
#	packages/better-convex/src/auth/generated-contract.ts
#	packages/better-convex/src/cli/codegen.test.ts
#	packages/better-convex/src/cli/codegen.ts
#	packages/better-convex/src/cli/watcher.test.ts
#	packages/better-convex/src/cli/watcher.ts
#	packages/better-convex/src/crpc/types.ts
#	vitest.config.mts
#	www/content/docs/orm/schema/triggers.mdx
# Conflicts:
#	packages/better-convex/src/cli/env.ts
#	www/content/docs/auth/server.mdx
@changeset-bot

changeset-bot Bot commented Mar 28, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 39039d4

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

vercel Bot commented Mar 28, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
better-convex Ready Ready Preview, Comment Mar 30, 2026 1:22pm

Request Review

@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: 78c38f9cd2

ℹ️ 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 packages/kitcn/src/server/env.ts Resolved

@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: 38c9e8f7f9

ℹ️ 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 packages/kitcn/src/cli/commands/env.ts Resolved

@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: 5d1c3485dc

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

@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: 738b4116de

ℹ️ 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 packages/kitcn/src/cli/config.ts Resolved

@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

https://github.com/udecode/better-convex/blob/9096168f35da5832a2977d8f0fdcdfc31940f708/packages/kitcn/src/cli/codegen.ts#L943
P1 Badge Avoid schema import in generated auth fallback runtime

emitGeneratedAuthFile always emits import schema ... even when auth is disabled and ORM schema metadata is absent. Since codegen still writes generated/auth.ts for default scopes, schema-less Convex projects end up with a generated file importing schema.ts that may not exist, which breaks subsequent typecheck/build despite auth being disabled.

ℹ️ 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 packages/kitcn/src/cli/commands/init.ts Resolved

@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: da40894f76

ℹ️ 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 packages/kitcn/src/cli/backend-core.ts Resolved

@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: ba70af965e

ℹ️ 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 packages/kitcn/src/cli/backend-core.ts Resolved

@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: 42d4a188dd

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

@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: 19ce505bdf

ℹ️ 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 www/content/docs/templates.mdx Resolved

@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: b891a3ecd1

ℹ️ 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 on lines +410 to +412
clientSiteUrlEnvKey: 'VITE_SITE_URL',
convexUrlEnvKey: 'VITE_CONVEX_URL',
convexSiteUrlEnvKey: 'VITE_CONVEX_SITE_URL',

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Use Next env keys for next-pages scaffold context

next-pages is routed through the generic React scaffold branch, which hardcodes VITE_* env keys here. Downstream, handleAddCommand reads projectContext.convexUrlEnvKey to validate raw Convex auth setup (packages/kitcn/src/cli/commands/add.ts), so a valid Next Pages app that correctly uses NEXT_PUBLIC_CONVEX_URL is rejected as “deployment not ready.” This blocks kitcn add auth flows on supported Next Pages projects.

Useful? React with 👍 / 👎.

@zbeyens
zbeyens merged commit 11aa0ee into main Mar 30, 2026
2 of 3 checks passed

@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: 39039d4e72

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

const parsed = parseArgs(argv);
const commandIndex = argv.indexOf(parsed.command);
const prefix = commandIndex >= 0 ? argv.slice(0, commandIndex) : [];
return [...prefix, 'dev', '--once', ...parsed.restArgs];

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Keep global flags when rewriting verify argv

buildVerifyDevArgv rebuilds the delegated dev command from parsed.restArgs, but parseArgs strips global options like --config and --api before they ever reach restArgs. When users run kitcn verify --config <path> or kitcn verify --api <dir> (flags after the command), those overrides are silently dropped and handleDevCommand runs with defaults, so verification can execute against the wrong config/shared directory and report misleading results.

Useful? React with 👍 / 👎.

Comment on lines +118 to +119
const targetArgs = extractBackendRunTargetArgs(backend, parsed.convexArgs);
if (getAggregateBackfillDeploymentKey(targetArgs) !== 'local') {

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Enforce verify local-only guard with config dev args

The local-only safety check only inspects parsed.convexArgs, but handleDevCommand later prepends config.dev.args to the effective dev argv. If concave.json sets dev.args to remote selectors like --prod/--deployment-name, kitcn verify passes the local-only check and then still runs against a remote deployment, violating the command's stated local-only contract.

Useful? React with 👍 / 👎.

This branch was successfully deployed

1 active deployment
Preview — 39039d4e Deployed Mar 30, 2026 by vercel[bot]
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