@beignet/cli 0.0.36 → 0.0.38

package/src/make/shared.ts

@@ -273,7 +273,7 @@ export type FileChangeSet = {
  * A provider-backed app port a generator depends on.
  *
  * Generated code that publishes events or sends notifications needs the
- * matching port in `AppPorts`, the key deferred in `infra/app-ports.ts`, and a
+ * matching port in `AppPorts`, the key deferred in `infra/port-wiring.ts`, and a
  * dev-default provider registered in `server/providers.ts`. Wiring is
  * generation-time by design: the starter stays lean and each generator wires
  * its own dependencies.
@@ -434,8 +434,13 @@ export function wireListenersProviderSource(
   }
 
   if (!new RegExp(`\\bconst\\s+${providerName}\\b`).test(next)) {
+    next = addNamedImport(
+      next,
+      "tryReportException",
+      "@beignet/core/error-reporting",
+    );
     const providerDefinition = `const ${providerName} = createProvider<
-\tPick<AppPorts, "eventBus" | "logger">,
+\tPick<AppPorts, "errorReporter" | "eventBus" | "logger">,
 \tAppContext,
 \tAppServiceContextInput
 >()({
@@ -451,6 +456,20 @@ export function wireListenersProviderSource(
 \t\t\t\t\terror,
 \t\t\t\t\tlistenerName: listener.name,
 \t\t\t\t});
+\t\t\t\tvoid tryReportException({
+\t\t\t\t\treporter: ports.errorReporter,
+\t\t\t\t\terror,
+\t\t\t\t\treportOptions: {
+\t\t\t\t\t\tlevel: "error",
+\t\t\t\t\t\tmechanism: "beignet.listener",
+\t\t\t\t\t\thandled: false,
+\t\t\t\t\t\ttags: {
+\t\t\t\t\t\t\t"beignet.kind": "listener",
+\t\t\t\t\t\t\t"beignet.listener": listener.name,
+\t\t\t\t\t\t},
+\t\t\t\t\t\tcontexts: { listener: { name: listener.name } },
+\t\t\t\t\t},
+\t\t\t\t});
 \t\t\t},
 \t\t});
 
@@ -496,7 +515,7 @@ export async function wirePortProviders(
   options: { dryRun: boolean },
 ): Promise<{ updatedFiles: string[] }> {
   const portsFile = config.paths.ports;
-  const infrastructureFile = config.paths.infrastructurePorts;
+  const infrastructureFile = config.paths.portWiring;
   const providersFile = providersFilePath(config);
   const manualFor = (wiring: PortProviderWiring) =>
     `Wire the ${wiring.portKey} port manually: add ${wiring.portKey}: ${wiring.portType}; to AppPorts in ${portsFile}, defer "${wiring.portKey}" in ${infrastructureFile}, and register ${wiring.providerFactory}() from ${wiring.providerModule} in ${providersFile}.`;
@@ -536,7 +555,7 @@ export async function wirePortProviders(
   );
   if (infrastructureOriginal === undefined) {
     throw new Error(
-      `Could not find the generated infrastructure ports file ${infrastructureFile}. ${manualFor(active[0])}`,
+      `Could not find the generated port wiring file ${infrastructureFile}. ${manualFor(active[0])}`,
     );
   }
 
@@ -548,7 +567,7 @@ export async function wirePortProviders(
       !new RegExp(`["']${wiring.portKey}["']`).test(infrastructureNext)
     ) {
       throw new Error(
-        `Could not find the deferred port list in ${infrastructureFile}. ${manualFor(wiring)} Or restore the generated infrastructure ports file before running beignet ${wiring.command}.`,
+        `Could not find the deferred port list in ${infrastructureFile}. ${manualFor(wiring)} Or restore the generated port wiring file before running beignet ${wiring.command}.`,
       );
     }
     infrastructureNext = appended;
@@ -651,7 +670,7 @@ export async function assertStandardApp(
 ): Promise<void> {
   const requiredFiles = [
     config.paths.appContext,
-    config.paths.infrastructurePorts,
+    config.paths.portWiring,
     config.paths.ports,
     config.paths.server,
     config.paths.useCaseBuilder,
@@ -688,7 +707,7 @@ export async function assertTestApp(
 ): Promise<void> {
   const requiredFiles = [
     config.paths.appContext,
-    config.paths.infrastructurePorts,
+    config.paths.portWiring,
     useCaseFilePath(names, config),
   ];
 
@@ -707,7 +726,7 @@ export async function assertPortApp(
   targetDir: string,
   config: ResolvedBeignetConfig,
 ): Promise<void> {
-  const requiredFiles = [config.paths.ports, config.paths.infrastructurePorts];
+  const requiredFiles = [config.paths.ports, config.paths.portWiring];
 
   for (const file of requiredFiles) {
     try {
@@ -725,10 +744,7 @@ export async function assertAdapterApp(
   names: PortNames,
   config: ResolvedBeignetConfig,
 ): Promise<void> {
-  const requiredFiles = [
-    config.paths.infrastructurePorts,
-    portFilePath(names, config),
-  ];
+  const requiredFiles = [config.paths.portWiring, portFilePath(names, config)];
 
   for (const file of requiredFiles) {
     try {
@@ -740,16 +756,16 @@ export async function assertAdapterApp(
     }
   }
 
-  const infrastructurePorts = await readFile(
-    path.join(targetDir, config.paths.infrastructurePorts),
+  const portWiring = await readFile(
+    path.join(targetDir, config.paths.portWiring),
     "utf8",
   );
   if (
-    !infrastructurePorts.includes(portStubEntry(names)) &&
-    !infrastructurePorts.includes(adapterEntry(names))
+    !portWiring.includes(portStubEntry(names)) &&
+    !portWiring.includes(adapterEntry(names))
   ) {
     throw new Error(
-      `Could not find the generated ${names.interfaceName} infrastructure stub in ${config.paths.infrastructurePorts}. Wire ${names.adapterFactoryName}() manually or restore the generated stub before running make adapter.`,
+      `Could not find the generated ${names.interfaceName} infrastructure stub in ${config.paths.portWiring}. Wire ${names.adapterFactoryName}() manually or restore the generated stub before running make adapter.`,
     );
   }
 }
@@ -822,7 +838,7 @@ export async function assertServerRuntimeApp(
   const requiredFiles = [
     config.paths.appContext,
     config.paths.server,
-    config.paths.infrastructurePorts,
+    config.paths.portWiring,
   ];
 
   for (const file of requiredFiles) {
@@ -1254,11 +1270,11 @@ export async function updateInfrastructurePortStub(
   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;
   const portPath = portFilePath(names, config);
-  const importLine = `import type { ${names.interfaceName} } from "${relativeModule(config.paths.infrastructurePorts, portPath)}";`;
+  const importLine = `import type { ${names.interfaceName} } from "${relativeModule(config.paths.portWiring, portPath)}";`;
 
   if (!next.includes(importLine)) {
     next = insertAfterImports(next, importLine);
@@ -1273,7 +1289,7 @@ export async function updateInfrastructurePortStub(
     next = insertDefinePortsProperty(
       next,
       entry.trim(),
-      `Could not find definePorts({ in ${config.paths.infrastructurePorts}. Add the ${names.interfaceName} stub manually, or restore the generated infrastructure ports file before running make port.`,
+      `Could not find definePorts({ in ${config.paths.portWiring}. Add the ${names.interfaceName} stub manually, or restore the generated port wiring file before running make port.`,
     );
   }
 
@@ -1288,18 +1304,18 @@ export async function updateInfrastructureAdapterWiring(
   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;
   const adapterPath = adapterFilePath(names, config);
-  const adapterImportLine = `import { ${names.adapterFactoryName} } from "${relativeModule(config.paths.infrastructurePorts, adapterPath)}";`;
+  const adapterImportLine = `import { ${names.adapterFactoryName} } from "${relativeModule(config.paths.portWiring, adapterPath)}";`;
 
   if (!next.includes(adapterImportLine)) {
     next = insertAfterImports(next, adapterImportLine);
   }
 
   const portPath = portFilePath(names, config);
-  const portImportLine = `import type { ${names.interfaceName} } from "${relativeModule(config.paths.infrastructurePorts, portPath)}";`;
+  const portImportLine = `import type { ${names.interfaceName} } from "${relativeModule(config.paths.portWiring, portPath)}";`;
   if (next.includes(portImportLine)) {
     next = next.replace(`${portImportLine}\n`, "");
   }
@@ -1310,7 +1326,7 @@ export async function updateInfrastructureAdapterWiring(
     next = next.replace(stub, adapter);
   } else if (!next.includes(adapter)) {
     throw new Error(
-      `Could not find the generated ${names.interfaceName} infrastructure stub in ${config.paths.infrastructurePorts}. Wire ${names.adapterFactoryName}() manually or restore the generated stub before running make adapter.`,
+      `Could not find the generated ${names.interfaceName} infrastructure stub in ${config.paths.portWiring}. Wire ${names.adapterFactoryName}() manually or restore the generated stub before running make adapter.`,
     );
   }
 
@@ -1325,15 +1341,15 @@ export async function updateInfrastructurePorts(
   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;
   const repositoryPath = path.join(
-    path.dirname(config.paths.infrastructurePorts),
+    path.dirname(config.paths.portWiring),
     names.pluralKebab,
     `in-memory-${names.singularKebab}-repository.ts`,
   );
-  const importLine = `import { createInMemory${names.singularPascal}Repository } from "${relativeModule(config.paths.infrastructurePorts, repositoryPath)}";`;
+  const importLine = `import { createInMemory${names.singularPascal}Repository } from "${relativeModule(config.paths.portWiring, repositoryPath)}";`;
 
   if (!next.includes(importLine)) {
     next = insertAfterImports(next, importLine);
@@ -1343,9 +1359,9 @@ export async function updateInfrastructurePorts(
   if (!next.includes(repositoryConst)) {
     next = replaceRequired(
       next,
-      /(\nexport const appPorts = definePorts(?:<[^>]+>)?\((?:\)\()?\{)/,
+      /(\nexport const initialPorts = definePorts(?:<[^>]+>)?\((?:\)\()?\{)/,
       `\n${repositoryConst}\n$1`,
-      `Could not find definePorts({ in ${config.paths.infrastructurePorts}. Add ${repositoryConst} manually, or restore the generated infrastructure ports file before running make resource.`,
+      `Could not find definePorts({ in ${config.paths.portWiring}. Add ${repositoryConst} manually, or restore the generated port wiring file before running make resource.`,
     );
   }
 
@@ -1358,7 +1374,7 @@ export async function updateInfrastructurePorts(
     next = insertDefinePortsProperty(
       next,
       entry.trim(),
-      `Could not find definePorts({ in ${config.paths.infrastructurePorts}. Add ${entry.trim()} to appPorts manually, or restore the generated infrastructure ports file before running make resource.`,
+      `Could not find definePorts({ in ${config.paths.portWiring}. Add ${entry.trim()} to initialPorts manually, or restore the generated port wiring file before running make resource.`,
     );
   }
 
@@ -1371,7 +1387,7 @@ export async function updateInfrastructurePorts(
     next = insertNoopUnitOfWorkProperty(
       next,
       transactionEntry.trim(),
-      `Could not find the generated Unit of Work port list in ${config.paths.infrastructurePorts}. Add ${transactionEntry.trim()} manually, or restore the generated infrastructure ports file before running make resource.`,
+      `Could not find the generated Unit of Work port list in ${config.paths.portWiring}. Add ${transactionEntry.trim()} manually, or restore the generated port wiring file before running make resource.`,
     );
   }
 
@@ -1386,7 +1402,7 @@ export async function updateInfrastructureGatePolicies(
   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;
   const policyPath = path.join(
@@ -1394,7 +1410,7 @@ export async function updateInfrastructureGatePolicies(
     names.pluralKebab,
     "policy.ts",
   );
-  const importLine = `import { ${names.singularCamel}Policy } from "${relativeModule(config.paths.infrastructurePorts, policyPath)}";`;
+  const importLine = `import { ${names.singularCamel}Policy } from "${relativeModule(config.paths.portWiring, policyPath)}";`;
 
   if (!next.includes(importLine)) {
     next = insertAfterImports(next, importLine);
@@ -1403,7 +1419,7 @@ export async function updateInfrastructureGatePolicies(
   next = appendCreateGatePolicy(
     next,
     `${names.singularCamel}Policy`,
-    `Could not find createGate({ policies: [...] }) in ${config.paths.infrastructurePorts}. Add ${names.singularCamel}Policy to the gate policies manually, or restore the generated infrastructure ports file before running make resource --auth.`,
+    `Could not find createGate({ policies: [...] }) in ${config.paths.portWiring}. Add ${names.singularCamel}Policy to the gate policies manually, or restore the generated port wiring file before running make resource --auth.`,
   );
 
   if (next === original) return false;
@@ -1713,7 +1729,7 @@ export async function updateInfrastructureDeferredPorts(
   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");
   // Drizzle resources are provided by the app database provider at startup,
   // so deferred-form ports files defer the new repository key. Identity-form
@@ -1745,11 +1761,11 @@ export async function updateServerTransactionPorts(
 
   if (!/\bappPorts\b/.test(next)) {
     throw new Error(
-      `Could not find appPorts in ${config.paths.server}. Add ${names.pluralCamel}: appPorts.${names.pluralCamel} to createTransactionPorts manually, or restore the generated server file before running make resource.`,
+      `Could not find initialPorts in ${config.paths.server}. Add ${names.pluralCamel}: initialPorts.${names.pluralCamel} to createTransactionPorts manually, or restore the generated server file before running make resource.`,
     );
   }
 
-  const entry = `\t\t\t\t\t\t${names.pluralCamel}: appPorts.${names.pluralCamel},`;
+  const entry = `\t\t\t\t\t\t${names.pluralCamel}: initialPorts.${names.pluralCamel},`;
   next = insertDrizzleTransactionPortsProperty(
     next,
     entry.trim(),
@@ -3048,14 +3064,14 @@ export function adapterFilePath(
   config: ResolvedBeignetConfig,
 ): string {
   return path.join(
-    path.dirname(config.paths.infrastructurePorts),
+    path.dirname(config.paths.portWiring),
     names.kebab,
     `${names.kebab}-adapter.ts`,
   );
 }
 
 export function infrastructureDir(config: ResolvedBeignetConfig): string {
-  return path.dirname(config.paths.infrastructurePorts);
+  return path.dirname(config.paths.portWiring);
 }
 
 export function drizzleSchemaIndexPath(config: ResolvedBeignetConfig): string {

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);
+  }
+}