@beignet/cli 0.0.37 → 0.0.38

package/src/make/tenancy.ts

@@ -330,7 +330,7 @@ export async function updateTenancyWiring(
   if (
     await updateWorkspaceInfrastructurePorts(targetDir, config, editOptions)
   ) {
-    updated.add(config.paths.infrastructurePorts);
+    updated.add(config.paths.portWiring);
   }
   if (
     await updateDrizzleSchemaIndexExports(
@@ -524,7 +524,7 @@ export async function updateWorkspaceInfrastructurePorts(
   config: ResolvedBeignetConfig,
   options: { dryRun: boolean },
 ): Promise<boolean> {
-  const filePath = path.join(targetDir, config.paths.infrastructurePorts);
+  const filePath = path.join(targetDir, config.paths.portWiring);
   const original = await readFile(filePath, "utf8");
   let next = original;
 
@@ -532,21 +532,21 @@ export async function updateWorkspaceInfrastructurePorts(
     const appended = appendDeferredPortKey(next, portKey);
     if (appended === next && !new RegExp(`["']${portKey}["']`).test(next)) {
       throw new Error(
-        `Could not find the deferred port list in ${config.paths.infrastructurePorts}. Add "${portKey}" manually, or restore the generated infrastructure ports file before running make tenancy.`,
+        `Could not find the deferred port list in ${config.paths.portWiring}. Add "${portKey}" manually, or restore the generated port wiring file before running make tenancy.`,
       );
     }
     next = appended;
   }
 
   const policyModule = relativeModule(
-    config.paths.infrastructurePorts,
+    config.paths.portWiring,
     path.join(config.paths.features, "workspaces/policy.ts"),
   );
   next = addNamedImport(next, "workspacePolicy", policyModule);
   next = appendCreateGatePolicy(
     next,
     "workspacePolicy",
-    `Could not find createGate({ policies: [...] }) in ${config.paths.infrastructurePorts}. Add workspacePolicy to the gate policies manually, or restore the generated infrastructure ports file before running make tenancy.`,
+    `Could not find createGate({ policies: [...] }) in ${config.paths.portWiring}. Add workspacePolicy to the gate policies manually, or restore the generated port wiring file before running make tenancy.`,
   );
 
   if (next === original) return false;
@@ -2274,7 +2274,7 @@ import type {
 \tWorkspaceMemberWithUser,
 \tWorkspaceRepository,
 } from "@/features/workspaces/ports";
-import { appPorts } from "@/infra/app-ports";
+import { initialPorts } from "@/infra/port-wiring";
 import type { AppTransactionPorts } from "@/ports";
 
 export type MemoryWorkspacePorts = {
@@ -2468,9 +2468,9 @@ export type WorkspaceTestFixture = TestPortsFixture<
 export function createWorkspaceFixture(): WorkspaceTestFixture {
 \tconst repositories = createMemoryWorkspacePorts();
 \tconst fixture = createTestPorts<AppContext["ports"], AppTransactionPorts>({
-\t\tbase: appPorts,
+\t\tbase: initialPorts,
 \t\toverrides: {
-\t\t\tgate: appPorts.gate,
+\t\t\tgate: initialPorts.gate,
 \t\t\t...repositories,
 \t\t},
 \t});

package/src/make.ts

@@ -911,7 +911,7 @@ export async function makePort(
       dryRun: Boolean(options.dryRun),
     })
   ) {
-    updatedFiles.push(config.paths.infrastructurePorts);
+    updatedFiles.push(config.paths.portWiring);
   }
 
   return {
@@ -957,7 +957,7 @@ export async function makeAdapter(
       dryRun: Boolean(options.dryRun),
     })
   ) {
-    updatedFiles.push(config.paths.infrastructurePorts);
+    updatedFiles.push(config.paths.portWiring);
   }
 
   return {
@@ -1034,6 +1034,9 @@ export async function makeEvent(
   const outboxDrainPlan = await planOutboxDrainWiring(targetDir, config, {
     force: Boolean(options.force),
   });
+  await updateOutboxRegistry(targetDir, names, "events", config, {
+    dryRun: true,
+  });
 
   const result = await makeFeatureArtifact({
     targetDir,
@@ -1078,6 +1081,9 @@ export async function makeJob(options: MakeJobOptions): Promise<MakeJobResult> {
   const outboxDrainPlan = await planOutboxDrainWiring(targetDir, config, {
     force: Boolean(options.force),
   });
+  await updateOutboxRegistry(targetDir, names, "jobs", config, {
+    dryRun: true,
+  });
 
   const result = await makeFeatureArtifact({
     targetDir,
@@ -1697,7 +1703,7 @@ async function updateOutboxPortWiring(
     changes.updatedFiles.push(config.paths.ports);
   }
   if (await updateOutboxInfrastructurePorts(targetDir, config, options)) {
-    changes.updatedFiles.push(config.paths.infrastructurePorts);
+    changes.updatedFiles.push(config.paths.portWiring);
   }
   if (await updateOutboxDatabaseProvider(targetDir, config, options)) {
     changes.updatedFiles.push(
@@ -1805,7 +1811,7 @@ async function updateOutboxInfrastructurePorts(
   config: ResolvedBeignetConfig,
   options: { dryRun: boolean },
 ): Promise<boolean> {
-  const filePath = path.join(targetDir, config.paths.infrastructurePorts);
+  const filePath = path.join(targetDir, config.paths.portWiring);
   const original = await readFile(filePath, "utf8");
   let next = appendDeferredPortKey(original, "outbox");
   next = appendDeferredPortKey(next, "outboxAdmin");
@@ -2166,7 +2172,7 @@ export async function makeOutbox(
       ...cronSecretPlan.files.map((file) => file.path),
       ...cronSecretPlan.skippedFiles,
       config.paths.ports,
-      config.paths.infrastructurePorts,
+      config.paths.portWiring,
       path.join(infrastructureDir(config), "db/provider.ts"),
       drizzleRepositoriesPath(config),
       outboxDrizzleSchemaFilePath(config),
@@ -2361,19 +2367,19 @@ async function updateResourceWiring(
     persistence === "memory" &&
     (await updateInfrastructurePorts(targetDir, names, config, options))
   ) {
-    updated.add(config.paths.infrastructurePorts);
+    updated.add(config.paths.portWiring);
   }
   if (
     generationOptions.auth &&
     (await updateInfrastructureGatePolicies(targetDir, names, config, options))
   ) {
-    updated.add(config.paths.infrastructurePorts);
+    updated.add(config.paths.portWiring);
   }
   if (
     persistence === "drizzle" &&
     (await updateInfrastructureDeferredPorts(targetDir, names, config, options))
   ) {
-    updated.add(config.paths.infrastructurePorts);
+    updated.add(config.paths.portWiring);
   }
   if (
     persistence === "drizzle" &&
@@ -3381,7 +3387,13 @@ async function updateOutboxRegistry(
     importLine,
   );
 
-  if (appended.kind === "missing" || appended.kind === "unchanged") {
+  if (appended.kind === "missing") {
+    throw new Error(
+      `Could not find the ${kind} array in ${config.paths.outbox}. Register ${registryName} manually, or restore the generated outbox file before running this command.`,
+    );
+  }
+
+  if (appended.kind === "unchanged") {
     return "skipped";
   }
 
@@ -3988,6 +4000,7 @@ export const outboxMessages = mysqlTable(
 \t\tkind: varchar("kind", { length: 32 }).notNull(),
 \t\tname: varchar("name", { length: 255 }).notNull(),
 \t\tpayloadJson: longtext("payload_json").notNull(),
+\t\ttraceContextJson: longtext("trace_context_json"),
 \t\tstatus: varchar("status", { length: 32 }).notNull(),
 \t\tattempts: int("attempts").notNull().default(0),
 \t\tmaxAttempts: int("max_attempts").notNull().default(3),
@@ -4023,6 +4036,7 @@ export const outboxMessages = ${dialect.tableFunction}(
 \t\tkind: text("kind").notNull(),
 \t\tname: text("name").notNull(),
 \t\tpayloadJson: text("payload_json").notNull(),
+\t\ttraceContextJson: text("trace_context_json"),
 \t\tstatus: text("status").notNull(),
 \t\tattempts: integer("attempts").notNull().default(0),
 \t\tmaxAttempts: integer("max_attempts").notNull().default(3),
@@ -4503,15 +4517,15 @@ import { createInMemoryDevtools } from "@beignet/devtools";
 import { createTestContextFactory, createTestPorts } from "@beignet/core/testing";
 import { createTestAnonymousActor } from "@beignet/core/testing";
 import type { AppContext } from "${aliasModule(config.paths.appContext)}";
-import { appPorts } from "${aliasModule(config.paths.infrastructurePorts)}";
+import { initialPorts } from "${aliasModule(config.paths.portWiring)}";
 import { ${names.exportName} } from "${relativeModule(filePath, useCaseFilePath(names, config))}";
 
 describe("${names.exportName}", () => {
 	it("runs ${names.action.camel}", async () => {
 		const testFixture = createTestPorts<AppContext["ports"]>({
-			base: appPorts,
+			base: initialPorts,
 			overrides: {
-				gate: appPorts.gate,
+				gate: initialPorts.gate,
 				devtools: createInMemoryDevtools(),
 			},
 		});
@@ -5276,7 +5290,7 @@ function testFile(
   options: ResourceGenerationOptions,
 ): string {
   const repositoryPath = path.join(
-    path.dirname(config.paths.infrastructurePorts),
+    path.dirname(config.paths.portWiring),
     names.pluralKebab,
     `in-memory-${names.singularKebab}-repository.ts`,
   );
@@ -5294,7 +5308,7 @@ import { createInMemoryDevtools } from "@beignet/devtools";
 import { createTestContextFactory, createTestPorts } from "@beignet/core/testing";
 import { ${options.auth ? "createTestUserActor" : "createTestAnonymousActor"}${options.tenant ? ", createTestTenant" : ""} } from "@beignet/core/testing";
 import type { AppContext } from "${aliasModule(config.paths.appContext)}";
-import { appPorts } from "${aliasModule(config.paths.infrastructurePorts)}";
+import { initialPorts } from "${aliasModule(config.paths.portWiring)}";
 import { appContext } from "${aliasModule(serverContextPath)}";
 import {
 	create${names.singularPascal},
@@ -5334,7 +5348,7 @@ ${options.tenant ? `\t\t\t\ttenantId: "tenant_test",\n` : ""}				name: "Gamma ${
 ${options.tenant ? `\t\t\t{\n\t\t\t\tid: "00000000-0000-4000-8000-000000000104",\n\t\t\t\ttenantId: "tenant_other",\n\t\t\t\tname: "Other Tenant ${names.singularPascal}",\n\t\t\t\tversion: 1,\n\t\t\t\tcreatedAt: "2024-01-04T00:00:00.000Z",\n\t\t\t\tupdatedAt: "2024-01-04T00:00:00.000Z",\n\t\t\t},\n` : ""}		];
 		const ${names.pluralCamel} = createInMemory${names.singularPascal}Repository(seed${names.pluralPascal});
 		const testFixture = createTestPorts<AppContext["ports"]>({
-			base: appPorts,
+			base: initialPorts,
 			overrides: {
 				${names.pluralCamel},
 ${
@@ -5345,7 +5359,7 @@ ${
 ${options.tenant ? `\t\t\t\t\t\tsession: { tenantId: "tenant_test" },\n` : ""}
 					}),
 				},
-${options.auth ? `\t\t\t\tgate: appPorts.gate,\n` : ""}
+${options.auth ? `\t\t\t\tgate: initialPorts.gate,\n` : ""}
 `
     : `\t\t\t\tauth: {
 					getSession: async () => null,

package/src/operational-error-reporting.ts

@@ -0,0 +1,60 @@
+import type {
+  ErrorReporterPort,
+  ErrorReportOptions,
+} from "@beignet/core/error-reporting";
+
+export type OperationalErrorReportingContext = {
+  requestId?: string;
+  traceId?: string;
+  ports?: {
+    errorReporter?: ErrorReporterPort;
+  };
+};
+
+export async function reportOperationalFailure(args: {
+  ctx: OperationalErrorReportingContext;
+  error: unknown;
+  reportOptions: ErrorReportOptions;
+}): Promise<void> {
+  const reporter = args.ctx.ports?.errorReporter;
+  if (!reporter) return;
+
+  try {
+    const { tryReportException } = await import(
+      "@beignet/core/error-reporting"
+    );
+    await tryReportException({
+      reporter,
+      error: args.error,
+      reportOptions: {
+        requestId: args.ctx.requestId,
+        traceId: args.ctx.traceId,
+        ...args.reportOptions,
+      },
+    });
+  } catch {
+    // Reporting must not replace the operational command failure.
+  }
+}
+
+export async function flushOperationalErrorReporter(
+  ctx: OperationalErrorReportingContext,
+  timeoutMs = 1000,
+): Promise<void> {
+  const reporter = ctx.ports?.errorReporter;
+  if (!reporter) return;
+
+  let timeout: ReturnType<typeof setTimeout> | undefined;
+  try {
+    await Promise.race([
+      reporter.flush({ timeoutMs }),
+      new Promise<boolean>((resolve) => {
+        timeout = setTimeout(() => resolve(false), timeoutMs);
+      }),
+    ]);
+  } catch {
+    // Reporting shutdown must not replace the operational command result.
+  } finally {
+    if (timeout !== undefined) clearTimeout(timeout);
+  }
+}

package/src/outbox.ts

@@ -1,5 +1,6 @@
 import { readFile, stat } from "node:fs/promises";
 import path from "node:path";
+import type { ErrorReporterPort } from "@beignet/core/error-reporting";
 import type {
   DrainOutboxOptions,
   DrainOutboxResult,
@@ -11,6 +12,10 @@ import type {
 } from "@beignet/core/outbox";
 import { createJiti } from "jiti";
 import { loadBeignetConfig, normalizePath } from "./config.js";
+import {
+  flushOperationalErrorReporter,
+  reportOperationalFailure,
+} from "./operational-error-reporting.js";
 
 /**
  * Options for running one bounded outbox drain pass.
@@ -159,6 +164,7 @@ type OutboxDrainPorts = {
   logger?: OutboxDrainLogger;
   devtools?: OutboxDrainInstrumentation;
   instrumentation?: OutboxDrainInstrumentation;
+  errorReporter?: ErrorReporterPort;
 };
 
 type OutboxDrainContext = {
@@ -240,6 +246,60 @@ export async function runOutboxDrain(
           attempts: message.attempts,
         });
       },
+      onDeadLetter(error, message) {
+        return reportOperationalFailure({
+          ctx,
+          error,
+          reportOptions: {
+            level: "error",
+            mechanism: "beignet.outbox.cli",
+            handled: false,
+            tags: {
+              "beignet.kind": "outbox",
+              "beignet.outbox.kind": message.kind,
+              "beignet.outbox.name": message.name,
+              "beignet.outbox.outcome": "deadLettered",
+            },
+            contexts: {
+              outbox: {
+                messageId: message.id,
+                kind: message.kind,
+                name: message.name,
+                attempts: message.attempts,
+                maxAttempts: message.maxAttempts,
+                outcome: "deadLettered",
+              },
+            },
+          },
+        });
+      },
+      onSettlementError(settlementError, message) {
+        return reportOperationalFailure({
+          ctx,
+          error: settlementError,
+          reportOptions: {
+            level: "error",
+            mechanism: "beignet.outbox.cli",
+            handled: false,
+            tags: {
+              "beignet.kind": "outbox",
+              "beignet.outbox.kind": message.kind,
+              "beignet.outbox.name": message.name,
+              "beignet.outbox.outcome": "settlementFailed",
+            },
+            contexts: {
+              outbox: {
+                messageId: message.id,
+                kind: message.kind,
+                name: message.name,
+                attempts: message.attempts,
+                maxAttempts: message.maxAttempts,
+                outcome: "settlementFailed",
+              },
+            },
+          },
+        });
+      },
     });
 
     await recordOutboxDrain(ctx, result);
@@ -251,7 +311,24 @@ export async function runOutboxDrain(
       result,
       durationMs: Math.round(performance.now() - startedAt),
     };
+  } catch (error) {
+    await reportOperationalFailure({
+      ctx,
+      error,
+      reportOptions: {
+        level: "error",
+        mechanism: "beignet.outbox.cli",
+        handled: false,
+        tags: {
+          "beignet.kind": "outbox",
+          "beignet.outbox.outcome": "drainFailed",
+        },
+        contexts: { outbox: { outcome: "drainFailed" } },
+      },
+    });
+    throw error;
   } finally {
+    await flushOperationalErrorReporter(ctx);
     await outboxModule.stopOutboxDrainContext?.(ctx, contextArgs);
   }
 }

package/src/provider-add.ts

@@ -97,7 +97,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-flags-openfeature`",
       "- Peer dependency: `@openfeature/server-sdk`",
-      "- The preset wires `createOpenFeatureFlagsProvider()` in `server/providers.ts` and defers `flags` in `infra/app-ports.ts`.",
+      "- The preset wires `createOpenFeatureFlagsProvider()` in `server/providers.ts` and defers `flags` in `infra/port-wiring.ts`.",
       "- Configure the OpenFeature provider globally or replace this preset with `createOpenFeatureFlagsProvider(...)` when the app needs provider-specific setup.",
       "- Use `ctx.ports.flags` in app code; `ctx.ports.openFeature` is available as an escape hatch.",
       "",
@@ -138,7 +138,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-jobs-bullmq`",
       "- Peer dependency: `bullmq`",
-      "- The preset wires `createBullMQJobsProvider()` in `server/providers.ts` and defers `jobs` in `infra/app-ports.ts`.",
+      "- The preset wires `createBullMQJobsProvider()` in `server/providers.ts` and defers `jobs` in `infra/port-wiring.ts`.",
       "- Set `BULLMQ_REDIS_URL` before booting the app; the default points at local Redis.",
       "- Dispatching enqueues jobs, but nothing executes them until a worker entrypoint runs `createBullMQJobWorker(...)` in a worker process. See the jobs docs page.",
       "- Use `ctx.ports.jobs.dispatch(...)` in app code; `ctx.ports.bullMQJobs` is available as an escape hatch.",
@@ -180,7 +180,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-jobs-inngest`",
       "- Peer dependency: `inngest`",
-      "- The preset wires `createInngestJobsProvider()` in `server/providers.ts` and defers `jobs` in `infra/app-ports.ts`.",
+      "- The preset wires `createInngestJobsProvider()` in `server/providers.ts` and defers `jobs` in `infra/port-wiring.ts`.",
       "- Define jobs with `defineJob(...)` and dispatch them through `ctx.ports.jobs.dispatch(...)`.",
       "- Execution needs an Inngest serve route built from `createInngestJobFunction(...)` and `serve(...)`. See the jobs docs page.",
       "- Use `ctx.ports.inngest` only as an escape hatch for Inngest-specific workflow APIs; prefer `ctx.ports.jobs.dispatch(...)` for Beignet jobs.",
@@ -222,7 +222,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-mail-resend`",
       "- Peer dependency: `resend`",
-      "- The preset wires `createResendMailProvider()` in `server/providers.ts` and defers `mailer` in `infra/app-ports.ts`.",
+      "- The preset wires `createResendMailProvider()` in `server/providers.ts` and defers `mailer` in `infra/port-wiring.ts`.",
       "- `.env.example` ships dev placeholders so the app boots; set real `RESEND_API_KEY` and `RESEND_FROM` values before sending mail.",
       "- Use `ctx.ports.mailer` in app code; `ctx.ports.resend` is available as an escape hatch.",
       "",
@@ -268,7 +268,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-mail-smtp`",
       "- Peer dependency: `nodemailer`",
-      "- The preset wires `createSmtpMailProvider()` in `server/providers.ts` and defers `mailer` in `infra/app-ports.ts`.",
+      "- The preset wires `createSmtpMailProvider()` in `server/providers.ts` and defers `mailer` in `infra/port-wiring.ts`.",
       "- `.env.example` ships dev placeholders so the app boots; set real `MAIL_*` values before sending mail.",
       "- Use `ctx.ports.mailer` in app code; `ctx.ports.smtp` is available as an escape hatch.",
       "",
@@ -317,7 +317,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-payments-stripe`",
       "- Peer dependency: `stripe`",
-      "- The preset wires `createStripePaymentsProvider()` in `server/providers.ts` and defers `payments` in `infra/app-ports.ts`.",
+      "- The preset wires `createStripePaymentsProvider()` in `server/providers.ts` and defers `payments` in `infra/port-wiring.ts`.",
       "- `.env.example` ships dev placeholders so the app boots; set real `STRIPE_SECRET_KEY` and `STRIPE_WEBHOOK_SECRET` values before taking payments.",
       "- Stripe requires a webhook route: run `beignet make payments` for the full billing slice, including a `createPaymentWebhookRoute(...)` route.",
       "- Use `ctx.ports.payments` in app code; `ctx.ports.stripe` is available as an escape hatch.",
@@ -360,7 +360,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "## Meilisearch search",
       "",
       "- Package: `@beignet/provider-search-meilisearch`",
-      "- The preset wires `createMeilisearchSearchProvider()` in `server/providers.ts` and defers `search` in `infra/app-ports.ts`.",
+      "- The preset wires `createMeilisearchSearchProvider()` in `server/providers.ts` and defers `search` in `infra/port-wiring.ts`.",
       "- Set `MEILISEARCH_HOST` before booting the app; set `MEILISEARCH_API_KEY` when your Meilisearch server requires one.",
       "- Use `ctx.ports.search` in app code; `ctx.ports.meilisearch` is available as an escape hatch.",
       "",
@@ -434,7 +434,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-cache-redis`",
       "- Peer dependency: `ioredis`",
-      "- The preset wires `createRedisCacheProvider()` in `server/providers.ts` and defers `cache` in `infra/app-ports.ts`.",
+      "- The preset wires `createRedisCacheProvider()` in `server/providers.ts` and defers `cache` in `infra/port-wiring.ts`.",
       "- Set `REDIS_URL` before booting the app.",
       "- Use `ctx.ports.cache` in app code; `ctx.ports.redis` is available as an escape hatch.",
       "",
@@ -475,7 +475,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-event-bus-redis`",
       "- Peer dependency: `ioredis`",
-      "- The preset wires `createRedisEventBusProvider()` in `server/providers.ts` and defers `eventBus` in `infra/app-ports.ts`.",
+      "- The preset wires `createRedisEventBusProvider()` in `server/providers.ts` and defers `eventBus` in `infra/port-wiring.ts`.",
       "- Set `REDIS_EVENT_BUS_URL` before booting the app.",
       "- Redis Pub/Sub delivery is best-effort and cross-process, but not durable: use outbox/jobs for side effects that need retry, replay, or dead-letter handling.",
       "- Use `ctx.ports.eventBus` in app code; `ctx.ports.redisEventBus` is available as an escape hatch.",
@@ -518,7 +518,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-locks-redis`",
       "- Peer dependency: `ioredis`",
-      "- The preset wires `createRedisLocksProvider()` in `server/providers.ts` and defers `locks` in `infra/app-ports.ts`.",
+      "- The preset wires `createRedisLocksProvider()` in `server/providers.ts` and defers `locks` in `infra/port-wiring.ts`.",
       "- Set `REDIS_LOCKS_URL` before booting the app.",
       "- Use `ctx.ports.locks` in app code; `ctx.ports.redisLocks` is available as an escape hatch.",
       "",
@@ -579,7 +579,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-storage-s3`",
       "- Peer dependencies: `@aws-sdk/client-s3` and `@aws-sdk/s3-request-presigner`",
-      "- The preset wires `createS3StorageProvider()` in `server/providers.ts` and defers `storage` in `infra/app-ports.ts`.",
+      "- The preset wires `createS3StorageProvider()` in `server/providers.ts` and defers `storage` in `infra/port-wiring.ts`.",
       "- Set `STORAGE_S3_BUCKET` before booting the app; set endpoint and credentials when using an S3-compatible host outside AWS defaults.",
       "- Use `ctx.ports.storage` in app code; `ctx.ports.s3Storage` is available as an escape hatch.",
       "",
@@ -625,7 +625,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-storage-vercel-blob`",
       "- Peer dependency: `@vercel/blob`",
-      "- The preset wires `createVercelBlobStorageProvider()` in `server/providers.ts` and defers `storage` in `infra/app-ports.ts`.",
+      "- The preset wires `createVercelBlobStorageProvider()` in `server/providers.ts` and defers `storage` in `infra/port-wiring.ts`.",
       "- On Vercel, connect a Blob store to the project and `BLOB_READ_WRITE_TOKEN` is set automatically; set it manually elsewhere.",
       "- The store is uniform-visibility (`BLOB_ACCESS`, default `private`): Vercel Blob does not report per-object access back, so mixed visibility needs a second store.",
       "- Use `ctx.ports.storage` in app code; `ctx.ports.vercelBlob` is available as an escape hatch.",
@@ -673,7 +673,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-rate-limit-upstash`",
       "- Peer dependencies: `@upstash/ratelimit` and `@upstash/redis`",
-      "- The preset wires `createUpstashRateLimitProvider()` in `server/providers.ts` and defers `rateLimit` in `infra/app-ports.ts`.",
+      "- The preset wires `createUpstashRateLimitProvider()` in `server/providers.ts` and defers `rateLimit` in `infra/port-wiring.ts`.",
       "- `.env.example` ships dev placeholders so the app boots; set real `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` values before rate limiting requests.",
       "- Use `ctx.ports.rateLimit` in app code; `ctx.ports.upstash` is available as an escape hatch.",
       "",
@@ -778,9 +778,9 @@ export async function addProviderPreset(
       ),
     },
     {
-      path: config.paths.infrastructurePorts,
+      path: config.paths.portWiring,
       content: updateInfrastructurePortsFile(
-        await readRequiredAppFile(targetDir, config.paths.infrastructurePorts),
+        await readRequiredAppFile(targetDir, config.paths.portWiring),
         preset.appPort.key,
       ),
     },
@@ -1056,13 +1056,17 @@ function ensureTypeProperty(
 function ensureDeferredPort(source: string, portKey: string): string {
   const match = /\bdeferred\s*:\s*\[/.exec(source);
   if (!match) {
-    throw new Error("Could not find `deferred: [...]` in infra/app-ports.ts.");
+    throw new Error(
+      "Could not find `deferred: [...]` in infra/port-wiring.ts.",
+    );
   }
 
   const openBracket = source.indexOf("[", match.index);
   const closeBracket = matchingDelimiterIndex(source, openBracket, "[", "]");
   if (closeBracket === -1) {
-    throw new Error("Could not parse `deferred` array in infra/app-ports.ts.");
+    throw new Error(
+      "Could not parse `deferred` array in infra/port-wiring.ts.",
+    );
   }
 
   const arrayText = source.slice(openBracket, closeBracket + 1);

package/src/provider-audit.ts

@@ -149,7 +149,7 @@ export async function auditProviders(
     ? await readCachedSource(targetDir, config.paths.ports, sourceCache)
     : "";
   const infrastructurePath = directoryPath(
-    path.dirname(config.paths.infrastructurePorts),
+    path.dirname(config.paths.portWiring),
   );
   const schemaDir = `${infrastructurePath}/db/schema`;
 
@@ -1679,13 +1679,13 @@ function isInfraOrServerFile(
 ): boolean {
   const serverDir = directoryPath(path.dirname(config.paths.server));
   const infrastructureDir = directoryPath(
-    path.dirname(config.paths.infrastructurePorts),
+    path.dirname(config.paths.portWiring),
   );
 
   return (
     file === config.paths.server ||
     file.startsWith(`${serverDir}/`) ||
-    file === config.paths.infrastructurePorts ||
+    file === config.paths.portWiring ||
     file.startsWith(`${infrastructureDir}/`)
   );
 }

package/src/schedule.ts

@@ -1,5 +1,6 @@
 import { readFile, stat } from "node:fs/promises";
 import path from "node:path";
+import type { ErrorReporterPort } from "@beignet/core/error-reporting";
 import type { ProviderInstrumentationPort } from "@beignet/core/providers";
 import type {
   ScheduleDef,
@@ -8,6 +9,10 @@ import type {
 } from "@beignet/core/schedules";
 import { createJiti } from "jiti";
 import { loadBeignetConfig, normalizePath } from "./config.js";
+import {
+  flushOperationalErrorReporter,
+  reportOperationalFailure,
+} from "./operational-error-reporting.js";
 
 /**
  * Options for running one app-owned schedule.
@@ -56,6 +61,7 @@ type ScheduleContext = {
     logger?: ScheduleLogger;
     devtools?: ProviderInstrumentationPort;
     instrumentation?: ProviderInstrumentationPort;
+    errorReporter?: ErrorReporterPort;
   };
 };
 
@@ -131,7 +137,31 @@ export async function runAppSchedule(
       },
     });
 
-    await runner.run(schedule, runOptions);
+    try {
+      await runner.run(schedule, runOptions);
+    } catch (error) {
+      await reportOperationalFailure({
+        ctx: scheduleContext,
+        error,
+        reportOptions: {
+          level: "error",
+          mechanism: "beignet.schedule.cli",
+          handled: false,
+          tags: {
+            "beignet.kind": "schedule",
+            "beignet.schedule": schedule.name,
+          },
+          contexts: {
+            schedule: {
+              name: schedule.name,
+              source: runOptions.source ?? "beignet-cli",
+              attempt: runOptions.attempt ?? null,
+            },
+          },
+        },
+      });
+      throw error;
+    }
 
     return {
       schemaVersion: 1,
@@ -148,6 +178,7 @@ export async function runAppSchedule(
       durationMs: Math.round(performance.now() - startedAt),
     };
   } finally {
+    await flushOperationalErrorReporter(scheduleContext);
     await scheduleModule.stopScheduleContext?.(ctx, contextArgs);
   }
 }