@beignet/cli 0.0.6 → 0.0.8

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @beignet/cli
 
+## 0.0.8
+
+### Patch Changes
+
+- 74a6859: Catch feature workflow artifacts that exist on disk but were never registered centrally. `beignet doctor` now reports unregistered feature schedules and tasks as errors, unregistered outbox events/jobs as warnings when the app has an outbox module, and feature listeners that no `registerListeners(...)` call references. `beignet doctor --fix` appends missing schedule, task, and outbox registries to their existing central files and bails out when the file is missing or customized. `beignet make event` and `beignet make job` now register new feature registries in an existing `server/outbox.ts` automatically.
+- 74a6859: Generators now wire the provider-backed ports their output depends on. `beignet make event` and `beignet make resource --events` add `eventBus: EventBusPort` to `AppPorts`, defer the key in `infra/app-ports.ts`, register `createInMemoryEventBusProvider()` in `server/providers.ts`, and add the `@beignet/provider-event-bus-memory` dependency. `beignet make notification` wires `mailer: MailerPort` with `createMemoryMailerProvider()` and `notifications: NotificationPort` with `createInlineNotificationsProvider()` from `@beignet/core`. Each port is wired independently and skipped when the ports file already has the key, so integration-provided and app-owned wiring is left untouched, and an anchor miss aborts the generator with a manual instruction before any file is written.
+- Updated dependencies [74a6859]
+- Updated dependencies [74a6859]
+  - @beignet/core@0.0.8
+
+## 0.0.7
+
+### Patch Changes
+
+- @beignet/core@0.0.7
+
 ## 0.0.6
 
 ### Patch Changes

package/README.md

@@ -468,7 +468,13 @@ increment it on success. Stale updates become the generated
 Use `--auth` to generate authorization metadata, policy wiring, and use-case
 `ctx.gate.authorize(...)` calls. Use `--tenant` to scope repository reads and
 writes by `ctx.tenant`. Use `--events` to generate created, updated, and
-deleted domain events and publish them through `ctx.ports.eventBus`. Use
+deleted domain events and publish them through `ctx.ports.eventBus`. The
+starter ships no event bus, so `--events` also wires one: it adds
+`eventBus: EventBusPort` to `AppPorts`, defers the key in
+`infra/app-ports.ts`, registers `createInMemoryEventBusProvider()` in
+`server/providers.ts`, and adds the `@beignet/provider-event-bus-memory`
+dependency. The wiring is skipped when the ports file already mentions
+`eventBus`, so apps that wired their own bus are left untouched. Use
 `--soft-delete` when delete routes should archive rows with `deletedAt` while
 list, get, and update operations continue to read only active records.
 
@@ -510,6 +516,26 @@ New task registries include `createTaskContext(...)` and
 `stopTaskContext(...)` placeholders so provider startup and teardown stay
 out of task definitions.
 
+`make event` and `make job` also register the feature's `postEvents` and
+`postJobs` registries in `defineOutboxRegistry({...})` when the app already
+has a `server/outbox.ts` (or `paths.outbox`) module. The outbox registry is
+opt-in, so the generators never create that file; `beignet doctor` reports
+events and jobs the registry cannot deliver.
+
+Generators wire the provider-backed ports their output depends on. `make
+event` (and `make resource --events`) wires `eventBus: EventBusPort` with
+`createInMemoryEventBusProvider()` from
+`@beignet/provider-event-bus-memory`, including the package dependency.
+`make notification` wires `mailer: MailerPort` with
+`createMemoryMailerProvider()` and `notifications: NotificationPort` with
+`createInlineNotificationsProvider()`, both dev-default providers from
+`@beignet/core`. Each port is wired independently — added to `AppPorts`,
+deferred in `infra/app-ports.ts`, and registered in `server/providers.ts` —
+and skipped when the ports file already has the key, so integrations such as
+resend (which contributes `mailer`) and app-owned adapters are left
+untouched. Swap the dev-default provider for a production adapter without
+rerunning the generator; the port stays the same.
+
 Task, job, listener, schedule, and notification generators define artifacts
 through app-owned context-bound builders in `lib/`. Each generator creates the
 builder file when it is missing:
@@ -690,6 +716,11 @@ Today it detects:
 
 - Contracts without a matching Next.js route handler
 - Feature route groups that are not registered in the central route list
+- Feature schedules and tasks that are not registered in `server/schedules.ts`
+  or `server/tasks.ts`
+- Feature events with listeners, and feature jobs, that are missing from
+  `defineOutboxRegistry({...})` when the app has a `server/outbox.ts` module
+- Feature listeners that no `registerListeners(...)` call ever references
 - Next.js route handlers that do not map to known contracts
 - OpenAPI drift in direct arrays, exported contract lists, and
   `contractsFromRoutes(routes)` route registries
@@ -755,8 +786,14 @@ passes `doctor --strict`. Use
 
 Use `beignet doctor --fix` for low-risk maintenance fixes. Today it can add
 a missing `test` script, register existing feature route groups in the central
-route list, and repair direct `createOpenAPIHandler([...])` arrays when the
-missing contracts are already imported in the OpenAPI route.
+route list, register unregistered feature schedule, task, and outbox
+event/job registries in their existing central registry files, and repair
+direct `createOpenAPIHandler([...])` arrays when the missing contracts are
+already imported in the OpenAPI route. Registry fixes are append-only: when a
+central file is missing, an anchor is customized beyond recognition, or some
+artifacts are already registered individually, the fix bails out and the
+diagnostic stays. Listener registration is report-only because apps own their
+event-bus wiring.
 
 Available presets:
 

package/dist/inspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,aAAa,EAIlB,KAAK,qBAAqB,EAE3B,MAAM,aAAa,CAAC;AAkBrB,KAAK,iBAAiB,GAAG;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,UAAU,GACX,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,yBAAyB,CAAC;CACtC,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,wBAAwB,EAAE,CAAC;CAC3C,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,aAAa,EAAE,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,wBAAwB,EAAE,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB,CAAC;AAuCF,wBAAsB,UAAU,CAC9B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAsC3B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,EAAE,CAAC,CAyDvB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAmB7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,MAAM,CAkER;AAWD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAUnE"}

package/dist/inspect.js

@@ -5,6 +5,7 @@ import { parseProviderPackageMetadata, } from "@beignet/core/providers";
 import { createPainter } from "./ansi.js";
 import { directoryPath, loadBeignetConfig, normalizePath, resolveConfig, } from "./config.js";
 import { formatGithubAnnotation, } from "./github-annotations.js";
+import { appendToArrayExpression, appendToNamedArray, appendToOutboxRegistryArray, arrayInitializerInfo, identifiersFromArrayExpression, insertAfterImports, matchingDelimiterIndex, outboxRegistryValueInfo, } from "./registry-edits.js";
 import { getCliVersion } from "./version.js";
 export async function inspectApp(options = {}) {
     const targetDir = path.resolve(options.cwd ?? process.cwd());
@@ -52,6 +53,14 @@ export async function applyDoctorFixes(options = {}) {
     const routeGroupFix = await fixUnregisteredRouteGroups(targetDir, files, config);
     if (routeGroupFix)
         fixes.push(routeGroupFix);
+    const drift = await workflowRegistrationDrift(targetDir, files, config);
+    const scheduleFix = await fixUnregisteredSchedules(targetDir, files, drift, config);
+    if (scheduleFix)
+        fixes.push(scheduleFix);
+    const taskFix = await fixUnregisteredTasks(targetDir, files, drift, config);
+    if (taskFix)
+        fixes.push(taskFix);
+    fixes.push(...(await fixUnregisteredOutboxEntries(targetDir, files, drift, config)));
     const openApiFix = await fixDirectOpenApiArrayDrift(targetDir, files, config, convention, contracts, matchedRoutes);
     if (openApiFix)
         fixes.push(openApiFix);
@@ -775,7 +784,7 @@ async function inspectDiagnostics(targetDir, files, config, convention, contract
     for (const routeHandler of matchedRoutes.unmatchedRouteHandlers) {
         diagnostics.push(unmatchedRouteDiagnostic(routeHandler));
     }
-    diagnostics.push(...(await inspectPackageScripts(targetDir, files, convention)), ...(await inspectOpenApiDrift(targetDir, files, config, convention, contracts, matchedRoutes)), ...(await inspectFeatureRouteRegistration(targetDir, files, config, convention, contracts)), ...(await inspectRouteErrorCatalogDrift(targetDir, files, config, convention, contracts, strict)), ...(await inspectCanonicalConformance(targetDir, files, config, convention, strict)), ...(await inspectVersionSkew(targetDir, files)), ...(await inspectProviderMetadataDrift(targetDir, files, convention)), ...(await inspectPortProviderDrift(targetDir, files, config, convention)), ...(await inspectProviderRegistrationDrift(targetDir, files, config, convention)), ...(await inspectDatabaseLifecycleDrift(targetDir, files, config, convention, strict)), ...(await inspectAuthzAuditDrift(targetDir, files, config, convention, contracts)), ...(await inspectServerlessFootguns(targetDir, files)), ...(await inspectProductionReadiness(targetDir, files, config, convention)), ...(await inspectFeatureArtifactDrift(targetDir, files, config, convention)), ...(await inspectResourceSlices(targetDir, files, config, convention, strict)));
+    diagnostics.push(...(await inspectPackageScripts(targetDir, files, convention)), ...(await inspectOpenApiDrift(targetDir, files, config, convention, contracts, matchedRoutes)), ...(await inspectFeatureRouteRegistration(targetDir, files, config, convention, contracts)), ...(await inspectRouteErrorCatalogDrift(targetDir, files, config, convention, contracts, strict)), ...(await inspectCanonicalConformance(targetDir, files, config, convention, strict)), ...(await inspectVersionSkew(targetDir, files)), ...(await inspectProviderMetadataDrift(targetDir, files, convention)), ...(await inspectPortProviderDrift(targetDir, files, config, convention)), ...(await inspectProviderRegistrationDrift(targetDir, files, config, convention)), ...(await inspectDatabaseLifecycleDrift(targetDir, files, config, convention, strict)), ...(await inspectAuthzAuditDrift(targetDir, files, config, convention, contracts)), ...(await inspectServerlessFootguns(targetDir, files)), ...(await inspectProductionReadiness(targetDir, files, config, convention)), ...(await inspectFeatureArtifactDrift(targetDir, files, config, convention)), ...(await inspectWorkflowRegistrationDrift(targetDir, files, config, convention)), ...(await inspectResourceSlices(targetDir, files, config, convention, strict)));
     return dedupeDiagnostics(diagnostics);
 }
 async function inspectCanonicalConformance(targetDir, files, config, convention, strict) {
@@ -1810,6 +1819,290 @@ function isInfraOrServerFile(file, config) {
 function containsCallExpression(source, name) {
     return new RegExp(`\\b${escapeRegExp(name)}\\s*(?:<[^;=(){}]*>\\s*)?\\(`).test(source);
 }
+const workflowRegistrySuffixes = {
+    schedules: "Schedules",
+    tasks: "Tasks",
+    events: "Events",
+    jobs: "Jobs",
+    listeners: "Listeners",
+};
+async function inspectWorkflowRegistrationDrift(targetDir, files, config, convention) {
+    if (!convention.resourceGenerator)
+        return [];
+    const drift = await workflowRegistrationDrift(targetDir, files, config);
+    const diagnostics = [];
+    for (const kind of ["schedules", "tasks"]) {
+        const { centralExists, unregistered } = drift[kind];
+        const centralFile = kind === "schedules" ? config.paths.schedules : config.paths.tasks;
+        const code = kind === "schedules"
+            ? "BEIGNET_SCHEDULE_UNREGISTERED"
+            : "BEIGNET_TASK_UNREGISTERED";
+        const registrationTarget = kind === "schedules" ? "the schedules array" : "defineTasks([...])";
+        const makeCommand = kind === "schedules" ? "beignet make schedule" : "beignet make task";
+        const noun = kind === "schedules" ? "schedule" : "task";
+        for (const { registry, missingMembers } of unregistered) {
+            for (const member of missingMembers) {
+                diagnostics.push({
+                    severity: "error",
+                    code,
+                    file: centralExists ? centralFile : registry.indexFile,
+                    message: centralExists
+                        ? `${workflowArtifactOrigin(registry, member)}, but it is not registered in ${registrationTarget} in ${centralFile}, so the ${noun} never runs. Import ${registry.registryName} and spread it into the ${kind} list.`
+                        : `${workflowArtifactOrigin(registry, member)}, but ${centralFile} does not exist, so the ${noun} never runs. Register ${registry.registryName} in ${centralFile} (or run \`${makeCommand}\` to create it).`,
+                });
+            }
+        }
+    }
+    if (drift.outbox.exists) {
+        for (const { registry, missingMembers } of drift.outbox.events) {
+            for (const member of missingMembers) {
+                diagnostics.push({
+                    severity: "warning",
+                    code: "BEIGNET_OUTBOX_EVENT_UNREGISTERED",
+                    file: config.paths.outbox,
+                    message: `${workflowArtifactOrigin(registry, member)} and listeners react to it, but it is not registered in the events list of defineOutboxRegistry({...}) in ${config.paths.outbox}, so outbox drain cannot deliver it. Import ${registry.registryName} and spread it into the events list.`,
+                });
+            }
+        }
+        for (const { registry, missingMembers } of drift.outbox.jobs) {
+            for (const member of missingMembers) {
+                diagnostics.push({
+                    severity: "warning",
+                    code: "BEIGNET_OUTBOX_JOB_UNREGISTERED",
+                    file: config.paths.outbox,
+                    message: `${workflowArtifactOrigin(registry, member)}, but it is not registered in the jobs list of defineOutboxRegistry({...}) in ${config.paths.outbox}, so outbox drain cannot deliver it. Import ${registry.registryName} and spread it into the jobs list.`,
+                });
+            }
+        }
+    }
+    const infraDir = directoryPath(path.dirname(config.paths.infrastructurePorts));
+    const listenerTarget = drift.listeners.wiringFile
+        ? `${drift.listeners.wiringFile}, which already calls registerListeners(...)`
+        : drift.listeners.eventBusFile
+            ? `${drift.listeners.eventBusFile}, which creates the event bus`
+            : `an infra provider under ${infraDir}/`;
+    for (const { registry, missingMembers } of drift.listeners.unregistered) {
+        for (const member of missingMembers) {
+            diagnostics.push({
+                severity: "warning",
+                code: "BEIGNET_LISTENER_UNREGISTERED",
+                file: drift.listeners.wiringFile ??
+                    drift.listeners.eventBusFile ??
+                    registry.indexFile,
+                message: `${workflowArtifactOrigin(registry, member)}, but no registerListeners(...) call references it, so the listener never receives events. Register ${registry.registryName} with registerListeners(...) in ${listenerTarget}.`,
+            });
+        }
+    }
+    return diagnostics;
+}
+function workflowArtifactOrigin(registry, member) {
+    const memberFile = registry.memberFiles.get(member) ?? registry.indexFile;
+    if (memberFile === registry.indexFile) {
+        return `${registry.indexFile} declares ${member} in ${registry.registryName}`;
+    }
+    return `${memberFile} declares ${member} (exported through ${registry.registryName} in ${registry.indexFile})`;
+}
+async function workflowRegistrationDrift(targetDir, files, config) {
+    const registries = await readFeatureWorkflowRegistries(targetDir, files, config);
+    const byKind = (kind) => registries.filter((registry) => registry.kind === kind);
+    const drift = {
+        schedules: {
+            centralExists: files.includes(config.paths.schedules),
+            unregistered: [],
+        },
+        tasks: {
+            centralExists: files.includes(config.paths.tasks),
+            unregistered: [],
+        },
+        outbox: {
+            exists: files.includes(config.paths.outbox),
+            events: [],
+            jobs: [],
+        },
+        listeners: { unregistered: [] },
+    };
+    if (registries.length === 0)
+        return drift;
+    for (const kind of ["schedules", "tasks"]) {
+        const kindRegistries = byKind(kind);
+        if (kindRegistries.length === 0)
+            continue;
+        const central = drift[kind];
+        const registered = central.centralExists
+            ? registeredWorkflowIdentifiers(await readFile(path.join(targetDir, kind === "schedules"
+                ? config.paths.schedules
+                : config.paths.tasks), "utf8"), kind)
+            : new Set();
+        central.unregistered = unregisteredWorkflowRegistries(kindRegistries, registered);
+    }
+    if (drift.outbox.exists) {
+        const eventRegistries = byKind("events");
+        const jobRegistries = byKind("jobs");
+        if (eventRegistries.length > 0 || jobRegistries.length > 0) {
+            const outboxSource = await readFile(path.join(targetDir, config.paths.outbox), "utf8");
+            if (eventRegistries.length > 0) {
+                // Events without listeners have nothing to deliver on drain, so only
+                // record-only events stay out of the registry without a warning.
+                const listened = await listenedEventNames(targetDir, files, config);
+                const value = outboxRegistryValueInfo(outboxSource, "events");
+                const registered = value
+                    ? identifiersFromArrayExpression(value.text)
+                    : new Set();
+                drift.outbox.events = unregisteredWorkflowRegistries(eventRegistries, registered, (member) => listened.has(member));
+            }
+            if (jobRegistries.length > 0) {
+                const value = outboxRegistryValueInfo(outboxSource, "jobs");
+                const registered = value
+                    ? identifiersFromArrayExpression(value.text)
+                    : new Set();
+                drift.outbox.jobs = unregisteredWorkflowRegistries(jobRegistries, registered);
+            }
+        }
+    }
+    const listenerRegistries = byKind("listeners");
+    if (listenerRegistries.length > 0) {
+        const wiring = await listenerWiringReferences(targetDir, files);
+        drift.listeners = {
+            unregistered: unregisteredWorkflowRegistries(listenerRegistries, wiring.identifiers),
+            wiringFile: wiring.wiringFile,
+            eventBusFile: wiring.eventBusFile,
+        };
+    }
+    return drift;
+}
+function unregisteredWorkflowRegistries(registries, registered, memberApplies = () => true) {
+    const unregistered = [];
+    for (const registry of registries) {
+        if (registered.has(registry.registryName))
+            continue;
+        const missingMembers = registry.members.filter((member) => !registered.has(member) && memberApplies(member));
+        if (missingMembers.length === 0)
+            continue;
+        unregistered.push({
+            registry,
+            missingMembers,
+            fullyUnregistered: registry.members.every((member) => !registered.has(member)),
+        });
+    }
+    return unregistered;
+}
+async function readFeatureWorkflowRegistries(targetDir, files, config) {
+    const registries = [];
+    const featuresPath = directoryPath(config.paths.features);
+    const kinds = [
+        "schedules",
+        "tasks",
+        "events",
+        "jobs",
+        "listeners",
+    ];
+    for (const kind of kinds) {
+        const folder = kind === "events" ? "domain/events" : kind;
+        const pattern = new RegExp(`^${escapeRegExp(featuresPath)}/[^/]+/${escapeRegExp(folder)}/index\\.ts$`);
+        for (const file of files) {
+            if (!pattern.test(file))
+                continue;
+            const source = await readFile(path.join(targetDir, file), "utf8");
+            const memberFiles = exportedMemberFiles(source, file, files);
+            const exportRegex = new RegExp(`(?:^|\\n)export const\\s+([A-Za-z_$][\\w$]*${workflowRegistrySuffixes[kind]})\\s*=`, "g");
+            for (const exportMatch of source.matchAll(exportRegex)) {
+                const registryName = exportMatch[1];
+                const info = arrayInitializerInfo(source, registryName);
+                if (!info)
+                    continue;
+                const members = [...identifiersFromArrayExpression(info.text)];
+                if (members.length === 0)
+                    continue;
+                registries.push({
+                    kind,
+                    registryName,
+                    indexFile: file,
+                    members,
+                    memberFiles,
+                });
+            }
+        }
+    }
+    return registries;
+}
+function exportedMemberFiles(source, indexFile, files) {
+    const memberFiles = new Map();
+    const referenceRegex = /(?:import|export)\s+\{([^}]+)\}\s+from\s+["']([^"']+)["']/g;
+    for (const match of source.matchAll(referenceRegex)) {
+        const resolved = sourceFileFromImport(match[2], indexFile, files);
+        if (!resolved || !files.includes(resolved))
+            continue;
+        for (const member of match[1].split(",")) {
+            const parsed = parseImportMember(member);
+            if (parsed)
+                memberFiles.set(parsed.localName, resolved);
+        }
+    }
+    return memberFiles;
+}
+function registeredWorkflowIdentifiers(source, kind) {
+    if (kind === "tasks") {
+        const call = /\bdefineTasks\s*(?:<[^>]*>\s*)?\(/.exec(source);
+        if (call) {
+            const firstArg = firstCallArgInfo(source, call.index + call[0].length);
+            if (firstArg)
+                return identifiersFromArrayExpression(firstArg.text);
+        }
+    }
+    const info = arrayInitializerInfo(source, kind === "tasks" ? "tasks" : "schedules");
+    return info ? identifiersFromArrayExpression(info.text) : new Set();
+}
+async function listenedEventNames(targetDir, files, config) {
+    const featuresPath = directoryPath(config.paths.features);
+    const listenerPattern = new RegExp(`^${escapeRegExp(featuresPath)}/[^/]+/listeners/[^/]+\\.ts$`);
+    const listened = new Set();
+    for (const file of files) {
+        if (!listenerPattern.test(file) || isWorkflowTestFile(file))
+            continue;
+        const source = await readFile(path.join(targetDir, file), "utf8");
+        for (const match of source.matchAll(/\bdefineListener\s*(?:<[^>]*>\s*)?\(\s*([A-Za-z_$][\w$]*)/g)) {
+            listened.add(match[1]);
+        }
+    }
+    return listened;
+}
+async function listenerWiringReferences(targetDir, files) {
+    const identifiers = new Set();
+    let wiringFile;
+    let eventBusFile;
+    for (const file of files) {
+        if (!file.endsWith(".ts") && !file.endsWith(".tsx"))
+            continue;
+        if (file.endsWith(".d.ts") || isWorkflowTestFile(file))
+            continue;
+        const source = await readFile(path.join(targetDir, file), "utf8");
+        let foundCall = false;
+        for (const match of source.matchAll(/\bregisterListeners\s*\(/g)) {
+            const openParen = (match.index ?? 0) + match[0].length - 1;
+            const closeParen = matchingDelimiterIndex(source, openParen, "(", ")");
+            const argsText = closeParen === -1
+                ? source.slice(openParen)
+                : source.slice(openParen + 1, closeParen);
+            foundCall = true;
+            for (const identifier of identifiersFromArrayExpression(argsText)) {
+                identifiers.add(identifier);
+            }
+        }
+        if (foundCall) {
+            wiringFile ??= file;
+        }
+        else if (!eventBusFile && /\bcreate\w*EventBus\s*\(/.test(source)) {
+            eventBusFile = file;
+        }
+    }
+    return { identifiers, wiringFile, eventBusFile };
+}
+function isWorkflowTestFile(file) {
+    return (file.endsWith(".test.ts") ||
+        file.endsWith(".test.tsx") ||
+        file.startsWith("tests/") ||
+        file.includes("/tests/"));
+}
 async function inspectServerlessFootguns(targetDir, files) {
     const diagnostics = [];
     for (const file of files) {
@@ -2612,6 +2905,115 @@ async function fixUnregisteredRouteGroups(targetDir, files, config) {
             .join(", ")} in the central route list.`,
     };
 }
+async function fixUnregisteredSchedules(targetDir, files, drift, config) {
+    if (!drift.schedules.centralExists)
+        return undefined;
+    return applyWorkflowRegistryFix({
+        targetDir,
+        files,
+        centralFile: config.paths.schedules,
+        unregistered: drift.schedules.unregistered,
+        code: "BEIGNET_SCHEDULE_UNREGISTERED",
+        listName: "the schedules array",
+        importSpecifier: (indexFile) => `@/${modulePath(indexFile)}`,
+        append: (source, entry, importLine) => appendToNamedArray(source, "schedules", entry, importLine),
+    });
+}
+async function fixUnregisteredTasks(targetDir, files, drift, config) {
+    if (!drift.tasks.centralExists)
+        return undefined;
+    return applyWorkflowRegistryFix({
+        targetDir,
+        files,
+        centralFile: config.paths.tasks,
+        unregistered: drift.tasks.unregistered,
+        code: "BEIGNET_TASK_UNREGISTERED",
+        listName: "defineTasks([...])",
+        importSpecifier: (indexFile) => relativeModule(config.paths.tasks, indexFile),
+        append: (source, entry, importLine) => appendToNamedArray(source, "tasks", entry, importLine),
+    });
+}
+async function fixUnregisteredOutboxEntries(targetDir, files, drift, config) {
+    if (!drift.outbox.exists)
+        return [];
+    const fixes = [];
+    const eventFix = await applyWorkflowRegistryFix({
+        targetDir,
+        files,
+        centralFile: config.paths.outbox,
+        unregistered: drift.outbox.events,
+        code: "BEIGNET_OUTBOX_EVENT_UNREGISTERED",
+        listName: "the outbox events list",
+        importSpecifier: (indexFile) => `@/${modulePath(indexFile)}`,
+        append: (source, entry, importLine) => appendToOutboxRegistryArray(source, "events", entry, importLine),
+    });
+    if (eventFix)
+        fixes.push(eventFix);
+    const jobFix = await applyWorkflowRegistryFix({
+        targetDir,
+        files,
+        centralFile: config.paths.outbox,
+        unregistered: drift.outbox.jobs,
+        code: "BEIGNET_OUTBOX_JOB_UNREGISTERED",
+        listName: "the outbox jobs list",
+        importSpecifier: (indexFile) => `@/${modulePath(indexFile)}`,
+        append: (source, entry, importLine) => appendToOutboxRegistryArray(source, "jobs", entry, importLine),
+    });
+    if (jobFix)
+        fixes.push(jobFix);
+    return fixes;
+}
+/**
+ * Append `...<feature><Kind>` registry spreads to an existing central
+ * registry file.
+ *
+ * Bails without writing when an import for the registry name resolves to a
+ * different file, when the registry anchor is missing or unparseable, or when
+ * some members are already individually registered (appending the registry
+ * spread would run those members twice). The diagnostic stays in that case.
+ */
+async function applyWorkflowRegistryFix(options) {
+    const candidates = options.unregistered.filter((entry) => entry.fullyUnregistered);
+    if (candidates.length === 0)
+        return undefined;
+    const centralPath = path.join(options.targetDir, options.centralFile);
+    let original;
+    try {
+        original = await readFile(centralPath, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    let next = original;
+    const registeredNames = [];
+    for (const { registry } of candidates) {
+        const imported = parseNamedImportSources(next).get(registry.registryName);
+        let importLine;
+        if (imported) {
+            const importedFile = sourceFileFromImport(imported.sourcePath, options.centralFile, options.files);
+            if (importedFile !== registry.indexFile)
+                return undefined;
+        }
+        else {
+            importLine = `import { ${registry.registryName} } from "${options.importSpecifier(registry.indexFile)}";`;
+        }
+        const result = options.append(next, `...${registry.registryName}`, importLine);
+        if (result.kind === "missing")
+            return undefined;
+        if (result.kind === "updated") {
+            next = result.source;
+            registeredNames.push(registry.registryName);
+        }
+    }
+    if (next === original || registeredNames.length === 0)
+        return undefined;
+    await writeFile(centralPath, next);
+    return {
+        code: options.code,
+        file: options.centralFile,
+        message: `Registered ${registeredNames.join(", ")} in ${options.listName}.`,
+    };
+}
 function routeRegistryFileFromServerSource(source, serverFile, files) {
     const imports = parseNamedImportSources(source);
     for (const identifier of routeOptionIdentifiers(source)) {
@@ -2753,49 +3155,7 @@ function trimmedSlice(source, start, end) {
         end: trimmedEnd,
     };
 }
-function contractsFromArrayExpression(expression) {
-    const withoutBrackets = expression.replace(/^\[/, "").replace(/\]$/, "");
-    return new Set(Array.from(withoutBrackets.matchAll(/\b[A-Za-z_$][\w$]*\b/g), ([name]) => name));
-}
-function appendToArrayExpression(expression, names) {
-    const closingBracket = /\]\s*$/.exec(expression);
-    if (!closingBracket)
-        return expression;
-    const beforeClosingBracket = expression.slice(0, closingBracket.index);
-    const closingBracketText = expression.slice(closingBracket.index);
-    const inner = beforeClosingBracket.replace(/^\[/, "");
-    if (!inner.trim())
-        return `[${names.join(", ")}]`;
-    if (!expression.includes("\n")) {
-        const separator = /,\s*$/.test(inner) ? " " : ", ";
-        return `${beforeClosingBracket}${separator}${names.join(", ")}${closingBracketText}`;
-    }
-    const itemIndent = inner
-        .split("\n")
-        .find((line) => line.trim())
-        ?.match(/^[\t ]*/)?.[0] ?? "\t";
-    const closingIndent = inner.match(/\n([\t ]*)$/)?.[1] ?? "";
-    const trimmedBeforeClosingBracket = beforeClosingBracket.replace(/\s*$/, "");
-    const appendedNames = names.join(`,\n${itemIndent}`);
-    if (/,\s*$/.test(inner)) {
-        return `${trimmedBeforeClosingBracket}\n${itemIndent}${appendedNames},\n${closingIndent}${closingBracketText}`;
-    }
-    return `${trimmedBeforeClosingBracket},\n${itemIndent}${appendedNames}${closingBracketText}`;
-}
-function insertAfterImports(source, line) {
-    const lines = source.split("\n");
-    let lastImportIndex = -1;
-    for (let index = 0; index < lines.length; index++) {
-        if (lines[index].startsWith("import ")) {
-            lastImportIndex = index;
-        }
-    }
-    if (lastImportIndex === -1) {
-        return `${line}\n${source}`;
-    }
-    lines.splice(lastImportIndex + 1, 0, line);
-    return lines.join("\n");
-}
+const contractsFromArrayExpression = identifiersFromArrayExpression;
 function hasImportedIdentifier(source, identifier) {
     const importRegex = /import\s+\{([^}]+)\}\s+from\s+["'][^"']+["']/g;
     for (const match of source.matchAll(importRegex)) {