@beignet/cli 0.0.14 → 0.0.16

package/src/mcp.ts

@@ -15,6 +15,7 @@ import {
   makeJob,
   makeListener,
   makeNotification,
+  makeOutbox,
   makePayments,
   makePolicy,
   makePort,
@@ -44,6 +45,7 @@ const makeArtifactChoices = [
   "job",
   "listener",
   "notification",
+  "outbox",
   "payments",
   "policy",
   "port",
@@ -66,13 +68,13 @@ const makeInputSchema = {
     .string()
     .optional()
     .describe(
-      "Artifact name. Required except for payments. Feature-owned artifacts use feature-scoped paths such as posts/backfill.",
+      "Artifact name. Required except for outbox and payments. Feature-owned artifacts use feature-scoped paths such as posts/backfill.",
     ),
   with: z
     .array(z.enum(makeFeatureAddonChoices))
     .optional()
     .describe(
-      "feature only: add feature-owned artifacts such as policy, events, jobs, notifications, tasks, ui, and uploads.",
+      "feature only: add feature-owned artifacts such as policy, factories, seeds, events, listeners, jobs, notifications, schedules, tasks, ui, and uploads.",
     ),
   event: z
     .string()
@@ -186,6 +188,13 @@ async function runMakeTool(
       dryRun: input.dryRun,
     });
   }
+  if (input.artifact === "outbox") {
+    return makeOutbox({
+      cwd,
+      force: input.force,
+      dryRun: input.dryRun,
+    });
+  }
   if (!input.name) {
     throw new Error(`make ${input.artifact} requires a name.`);
   }
@@ -352,7 +361,7 @@ export function buildBeignetMcpServer(options: McpServerOptions): McpServer {
     "make",
     {
       description:
-        "Generate Beignet app files for one artifact: adapter, contract, event, factory, feature, job, listener, notification, policy, port, resource, schedule, seed, task, test, upload, or use-case. Generators auto-register artifacts, so doctor stays clean. Options by artifact: feature accepts with (addons); resource accepts auth, tenant, events, softDelete; listener requires event; schedule accepts cron, timezone, route. All artifacts accept force and dryRun. Returns created, updated, and skipped files as JSON.",
+        "Generate Beignet app files for one artifact: adapter, contract, event, factory, feature, job, listener, notification, outbox, payments, policy, port, resource, schedule, seed, task, test, upload, or use-case. Generators auto-register artifacts, so doctor stays clean. Options by artifact: feature accepts with (addons); resource accepts auth, tenant, events, softDelete; listener requires event; schedule accepts cron, timezone, route. All artifacts accept force and dryRun. Returns created, updated, and skipped files as JSON.",
       inputSchema: makeInputSchema,
     },
     async (input) =>

package/src/templates/agents.ts

@@ -32,10 +32,10 @@ https://beignetjs.com (agent-friendly index at https://beignetjs.com/llms.txt).
 README.md covers setup and the app map; this file covers what is not
 discoverable from the code.
 
-## Registration is not automatic
+## Registration is explicit
 
-Creating an artifact file does not wire it into the app. Non-registration is
-a silent failure — the file exists but never runs:
+Hand-writing an artifact file does not wire it into the app. Non-registration
+is a silent failure — the file exists but never runs:
 
 - Feature route groups in \`features/<feature>/routes.ts\` must be composed in
   \`server/routes.ts\` via \`defineRoutes([...])\`.
@@ -47,9 +47,12 @@ a silent failure — the file exists but never runs:
   wiring.
 
 The starter ships no workflow registries — generators create them on first
-use, so their absence is fine. \`${cli} doctor\` detects registration drift.
-\`${cli} doctor --fix\` repairs route-group, schedule, task, and outbox
-registration; listener drift is report-only and must be fixed by hand.
+use, so their absence is fine. \`${cli} make event\`, \`${cli} make job\`,
+\`${cli} make schedule\`, \`${cli} make task\`, \`${cli} make seed\`, and
+\`${cli} make upload\` create or update their required app entrypoints.
+\`${cli} doctor\` detects registration drift. \`${cli} doctor --fix\` repairs
+route-group, schedule, task, and outbox registration; listener drift is
+report-only and must be fixed by hand.
 
 ## Prefer generators
 
@@ -90,26 +93,25 @@ ${typecheck}
 
 ## MCP server
 
-\`.mcp.json\` registers the \`beignet mcp\` stdio server, which exposes
-routes/doctor/lint/make as structured tools named exactly: \`routes\`,
-\`doctor\`, \`doctor_fix\`, \`lint\`, \`make\`. Clients that do not read
-\`.mcp.json\` can launch \`${cli} mcp\` directly.
+\`.mcp.json\` registers the app-local \`@beignet/cli\` bin at
+\`./node_modules/.bin/beignet mcp\`, which exposes routes/doctor/lint/make as
+structured tools named exactly: \`routes\`, \`doctor\`, \`doctor_fix\`,
+\`lint\`, \`make\`. Clients that do not read \`.mcp.json\` can use the same
+command from the app root; use \`${cli} mcp\` only for terminal debugging.
 `;
 }
 
 /**
  * .mcp.json registers the `beignet mcp` stdio server for MCP-aware clients.
  * The runner must not print banners on stdout, which corrupts JSON-RPC, so
- * the config launches the locally installed CLI bin via bunx/npx.
+ * the config launches the locally installed CLI bin directly.
  */
-export function mcpJson(ctx: TemplateContext): string {
-  const command = ctx.packageManager === "bun" ? "bunx" : "npx";
-
+export function mcpJson(_ctx: TemplateContext): string {
   return json({
     mcpServers: {
       beignet: {
-        command,
-        args: ["beignet", "mcp"],
+        command: "./node_modules/.bin/beignet",
+        args: ["mcp"],
       },
     },
   });

package/src/templates/base.ts

@@ -321,11 +321,11 @@ export function integrationsDoc(ctx: TemplateContext): string {
         "## Inngest",
         "",
         "- Package: `@beignet/core` (`@beignet/core/events`, `@beignet/core/jobs`)",
-        "- Package: `@beignet/provider-inngest`",
+        "- Package: `@beignet/provider-jobs-inngest`",
         "- Peer dependency: `inngest`",
-        "- The starter wires `inngestProvider` in `server/providers.ts`.",
+        "- The starter wires `inngestJobsProvider` in `server/providers.ts`.",
         "- Define jobs with `defineJob(...)` and dispatch them through `ctx.ports.jobs.dispatch(...)`.",
-        "- Keep direct Inngest client usage inside infrastructure code unless you intentionally add an app-owned escape-hatch port.",
+        "- Use `ctx.ports.inngest` only as an escape hatch for Inngest-specific workflow APIs; prefer `ctx.ports.jobs.dispatch(...)` for Beignet jobs.",
         "",
       );
     }

package/src/templates/server.ts

@@ -13,7 +13,7 @@ export function serverProviders(ctx: TemplateContext): string {
     'import { createAuthBetterAuthProvider } from "@beignet/provider-auth-better-auth";',
     `import { ${db.providerFactory} } from "@beignet/provider-db-drizzle/${db.subpath}";`,
     hasIntegration(ctx, "inngest")
-      ? 'import { inngestProvider } from "@beignet/provider-inngest";'
+      ? 'import { inngestJobsProvider } from "@beignet/provider-jobs-inngest";'
       : undefined,
     'import { loggerPinoProvider } from "@beignet/provider-logger-pino";',
     hasIntegration(ctx, "resend")
@@ -34,7 +34,7 @@ export function serverProviders(ctx: TemplateContext): string {
     "\tloggerPinoProvider,",
     `\t${db.providerInstance},`,
     "\tstarterDatabaseProvider,",
-    hasIntegration(ctx, "inngest") ? "\tinngestProvider," : undefined,
+    hasIntegration(ctx, "inngest") ? "\tinngestJobsProvider," : undefined,
     hasIntegration(ctx, "resend") ? "\tmailResendProvider," : undefined,
     hasIntegration(ctx, "upstash-rate-limit")
       ? "\tupstashRateLimitProvider,"
@@ -67,7 +67,8 @@ export function ports(ctx: TemplateContext): string {
     ? 'import type { MailerPort } from "@beignet/core/mail";\n'
     : "";
 
-  return `import type { IdempotencyPort } from "@beignet/core/idempotency";
+  return `import type { ErrorReporterPort } from "@beignet/core/error-reporting";
+import type { IdempotencyPort } from "@beignet/core/idempotency";
 ${mailImport}import type {
 ${coreImports.join("\n")}
 } from "@beignet/core/ports";
@@ -84,6 +85,7 @@ export type AppGate = BoundGate<[typeof todoPolicy]>;
 
 export type AppPorts = {
 	auth: AuthPort;
+	errorReporter: ErrorReporterPort;
 	gate: GatePort<AuthorizationContext, [typeof todoPolicy]>;
 	idempotency: IdempotencyPort;
 ${usesInngest ? "\tjobs: JobDispatcherPort;\n" : ""}	logger: LoggerPort;
@@ -105,7 +107,8 @@ export function infrastructurePorts(ctx: TemplateContext): string {
     '\t\t"uow",',
   ].filter((entry): entry is string => Boolean(entry));
 
-  return `import { createGate, definePorts } from "@beignet/core/ports";
+  return `import { createNoopErrorReporter } from "@beignet/core/error-reporting";
+import { createGate, definePorts } from "@beignet/core/ports";
 import { todoPolicy } from "@/features/todos/policy";
 import { appError } from "@/features/shared/errors";
 import type { AppPorts } from "@/ports";
@@ -129,6 +132,7 @@ const gate = createGate({
  */
 export const appPorts = definePorts<AppPorts>()({
 	bound: {
+		errorReporter: createNoopErrorReporter(),
 		gate,
 	},
 	deferred: [
@@ -281,7 +285,7 @@ export function server(ctx: TemplateContext): string {
 
   return `import type { beignetServerOnly } from "@beignet/core/server-only";
 import { createNextServer } from "@beignet/next";
-import { createIdempotencyHooks } from "@beignet/core/server";
+import { createErrorReportingHooks, createIdempotencyHooks } from "@beignet/core/server";
 import type { AppContext } from "@/app-context";
 import { appPorts } from "@/infra/app-ports";
 import { env } from "@/lib/env";
@@ -295,7 +299,10 @@ export const server = await createNextServer({
 	providerConfig: {
 ${providerConfigEntries}
 	},
-	hooks: [createIdempotencyHooks<AppContext>()],
+	hooks: [
+		createErrorReportingHooks<AppContext>(),
+		createIdempotencyHooks<AppContext>(),
+	],
 	context: appContext,
 	routes,
 	mapUnhandledError: ({ err, ctx }) => {

package/src/templates/shared.ts

@@ -44,7 +44,7 @@ export const externalVersions = {
   tanstackReactQuery: "^5.100.7",
   hookformResolvers: "^5.0.0",
   reactHookForm: "^7.74.0",
-  betterAuth: "1.6.11",
+  betterAuth: "1.6.20",
   drizzleKit: "^0.31.10",
   drizzleOrm: "^0.45.2",
   inngest: "^3.0.0",
@@ -53,7 +53,7 @@ export const externalVersions = {
   pg: "^8.13.0",
   pglite: "^0.5.2",
   pino: "^9.7.0",
-  resend: "^4.0.1",
+  resend: "^6.14.0",
   typesPg: "^8.11.0",
   upstashRateLimit: "^2.0.0",
   upstashRedis: "^1.0.0",
@@ -154,7 +154,7 @@ export const integrationDeps: Record<
   Record<string, string>
 > = {
   inngest: {
-    "@beignet/provider-inngest": "",
+    "@beignet/provider-jobs-inngest": "",
     inngest: externalVersions.inngest,
   },
   resend: {

package/src/templates/shell.ts

@@ -1,4 +1,5 @@
 import {
+  externalVersions,
   packageRunner,
   type TemplateContext,
   type TemplateFile,
@@ -1219,7 +1220,7 @@ export function shellTemplateFiles(ctx: TemplateContext): TemplateFile[] {
 }
 
 export const shellDependencies: Record<string, string> = {
-  "better-auth": "1.6.11",
+  "better-auth": externalVersions.betterAuth,
   "lucide-react": "^1.16.0",
   "next-themes": "^0.4.6",
 };

package/src/templates/todos.ts

@@ -190,7 +190,7 @@ import {
 	updateTodoUseCase,
 } from "@/features/todos/use-cases";
 
-export const todoRoutes = defineRouteGroup<AppContext>({
+export const todoRoutes = defineRouteGroup<AppContext>()({
 	name: "todos",
 	routes: [
 		{ contract: listTodos, useCase: listTodosUseCase },

package/dist/templates/db.d.ts

@@ -1,15 +0,0 @@
-declare const files: {
-    drizzleConfig: string;
-    dbSchema: string;
-    drizzleTodoRepository: string;
-    dbRepositories: string;
-    databaseReady: string;
-    dbProvider: string;
-    dbReset: string;
-    dbTestDatabase: string;
-    starterMigrationSql: string;
-    starterMigrationJournal: string;
-    starterMigrationSnapshot: string;
-};
-export { files as dbFiles };
-//# sourceMappingURL=db.d.ts.map

package/dist/templates/db.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/templates/db.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,KAAK;;;;;;;;;;;;CA49BV,CAAC;AAEF,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAC"}