@pattern-stack/codegen 0.7.2 → 0.7.3

package/dist/src/cli/index.js

@@ -1047,8 +1047,8 @@ var icons = {
 };
 
 // src/cli/commands/entity.ts
-import fs7 from "fs";
-import path11 from "path";
+import fs9 from "fs";
+import path13 from "path";
 import { Command as Command2, Option as Option2 } from "clipanion";
 
 // src/utils/yaml-loader.ts
@@ -2917,8 +2917,8 @@ function loadEntityFromYaml(filePath) {
 }
 function formatZodErrors(error) {
   return error.errors.map((err) => {
-    const path30 = err.path.join(".");
-    const location = path30 ? `at '${path30}'` : "at root";
+    const path31 = err.path.join(".");
+    const location = path31 ? `at '${path31}'` : "at root";
     return `${err.message} ${location}`;
   });
 }
@@ -3516,19 +3516,19 @@ function findCircularDependencies(graph) {
   const cycles = [];
   const visited = /* @__PURE__ */ new Set();
   const recursionStack = /* @__PURE__ */ new Set();
-  function dfs(node, path30) {
+  function dfs(node, path31) {
     visited.add(node);
     recursionStack.add(node);
     const outgoingEdges = graph.edges.filter((e) => e.from === node);
     for (const edge of outgoingEdges) {
       if (!visited.has(edge.to)) {
-        dfs(edge.to, [...path30, edge.to]);
+        dfs(edge.to, [...path31, edge.to]);
       } else if (recursionStack.has(edge.to)) {
-        const cycleStart = path30.indexOf(edge.to);
+        const cycleStart = path31.indexOf(edge.to);
         if (cycleStart !== -1) {
-          cycles.push([...path30.slice(cycleStart), edge.to]);
+          cycles.push([...path31.slice(cycleStart), edge.to]);
         } else {
-          cycles.push([...path30, edge.to]);
+          cycles.push([...path31, edge.to]);
         }
       }
     }
@@ -4125,8 +4125,8 @@ function suggestTransitiveRelationships(graph, options) {
   for (const [entityName, entity] of graph.entities) {
     if (shouldExcludeEntity(entityName, opts)) continue;
     const paths = findTransitivePaths(graph, entityName, opts);
-    for (const path30 of paths) {
-      suggestions.push(createSuggestion(path30));
+    for (const path31 of paths) {
+      suggestions.push(createSuggestion(path31));
     }
   }
   return suggestions;
@@ -4157,7 +4157,7 @@ function findTransitivePaths(graph, sourceEntity, opts) {
   while (queue.length > 0) {
     const current = queue.shift();
     if (!current) continue;
-    const { entity, depth, path: path30, visited } = current;
+    const { entity, depth, path: path31, visited } = current;
     if (depth >= opts.maxDepth) continue;
     const currentEntity = graph.entities.get(entity);
     if (!currentEntity) continue;
@@ -4168,7 +4168,7 @@ function findTransitivePaths(graph, sourceEntity, opts) {
       if (shouldExcludeEntity(target, opts)) continue;
       if (visited.has(target)) continue;
       const newPath = [
-        ...path30,
+        ...path31,
         {
           via: entity,
           relationship: relName,
@@ -4236,15 +4236,15 @@ function generateYamlSnippet(name, target, throughPath) {
     target: ${target}
     through: "${throughPath}"`;
 }
-function createSuggestion(path30) {
-  const pathDescription = [path30.source, ...path30.hops.map((h) => h.via), path30.target].join(" -> ");
+function createSuggestion(path31) {
+  const pathDescription = [path31.source, ...path31.hops.map((h) => h.via), path31.target].join(" -> ");
   return {
     severity: "info",
     type: "transitive_suggestion",
-    entity: path30.source,
+    entity: path31.source,
     message: `Potential transitive relationship: ${pathDescription}`,
-    suggestion: `Add "${path30.suggestedName}" relationship via "${path30.throughPath}"`,
-    path: path30
+    suggestion: `Add "${path31.suggestedName}" relationship via "${path31.throughPath}"`,
+    path: path31
   };
 }
 
@@ -5875,11 +5875,357 @@ async function generateScopeEntityType(opts) {
   return { outputPath, scopeableNames, written, content };
 }
 
-// src/cli/shared/bridge-registry-generator.ts
+// src/cli/shared/subsystem-barrel-generator.ts
+import fs5 from "fs";
+import path8 from "path";
+
+// src/cli/shared/subsystem-detect.ts
 import fs4 from "fs";
 import path6 from "path";
+var SUBSYSTEMS = [
+  {
+    name: "events",
+    description: "Domain event bus (transactional outbox)",
+    backends: ["drizzle", "memory"],
+    defaultBackend: "drizzle"
+  },
+  {
+    name: "jobs",
+    description: "Background job queue",
+    backends: ["drizzle", "memory"],
+    defaultBackend: "drizzle"
+  },
+  {
+    name: "cache",
+    description: "Key-value cache with TTL",
+    backends: ["drizzle", "memory"],
+    defaultBackend: "drizzle"
+  },
+  {
+    name: "storage",
+    description: "File/object storage",
+    backends: ["local", "memory"],
+    defaultBackend: "local"
+  },
+  {
+    name: "sync",
+    description: "External-system sync engine (IChangeSource<T> + orchestrator + audit log)",
+    backends: ["drizzle", "memory"],
+    defaultBackend: "drizzle"
+  },
+  {
+    name: "bridge",
+    description: "Event-to-job bridge (durable async fanout via @JobHandler.triggers)",
+    backends: ["drizzle", "memory"],
+    defaultBackend: "drizzle"
+  },
+  {
+    // OPENAPI-4. "Config-only" pseudo-subsystem — the runtime helpers
+    // (OpenApiRegistry, ErrorResponseDto) are already vendored by
+    // `codegen project init`. Installing this subsystem just injects the
+    // `openapi:` block into codegen.config.yaml.
+    name: "openapi-config",
+    description: "OpenAPI/Swagger config block (registry is vendored at init)",
+    backends: ["config-only"],
+    defaultBackend: "config-only"
+  },
+  {
+    // OBS-7 / ADR-025. Combiner subsystem — no schema, no worker, no
+    // generated/ dir. `ObservabilityModule` composes sibling read ports
+    // (events/jobs/bridge/sync) via @Optional() DI. The `combiner`
+    // pseudo-backend is parallel to `openapi-config`'s `config-only`.
+    name: "observability",
+    description: "Observability combiner \u2014 composes sibling read ports via @Optional() DI (ADR-025)",
+    backends: ["combiner"],
+    defaultBackend: "combiner"
+  },
+  {
+    // #287. Auth subsystem (PR #289) — AuthModule + ports + OAuth state
+    // store + AuthController. Backends: drizzle (prod, persists OAuth
+    // state in `auth_oauth_state`) or memory (dev/tests). Detection in
+    // `detectInstalledSubsystems` is a special case: auth's protocols
+    // live under `protocols/`, not at the subsystem root, so we look
+    // for `auth.module.ts` instead of `*.protocol.ts`.
+    name: "auth",
+    description: "OAuth integration auth (AuthModule + ports + state store)",
+    backends: ["drizzle", "memory"],
+    defaultBackend: "drizzle"
+  },
+  {
+    // #287. Auth-integrations starter (PR #290) — vendored from
+    // `examples/auth-integrations/`, NOT from `runtime/subsystems/`.
+    // Bundles a canonical `integration` entity yaml + the three
+    // integration-store-port adapters + the `IntegrationsService`
+    // facade. Single-backend (drizzle); the runtime adapters call
+    // directly into the codegen-emitted `IntegrationService` from the
+    // entity layer. Detection: presence of
+    // `<sharedRoot>/integrations/integrations-auth.module.ts`.
+    name: "auth-integrations",
+    description: "Vendored integrations entity + adapters (consumes auth subsystem)",
+    backends: ["drizzle"],
+    defaultBackend: "drizzle"
+  }
+];
+var KNOWN_NAMES = SUBSYSTEMS.map((s) => s.name);
+function candidateRoots(cwd, configured) {
+  const roots = [
+    ...configured ? [path6.resolve(cwd, configured)] : [],
+    path6.resolve(cwd, "src/shared/subsystems"),
+    path6.resolve(cwd, "src/subsystems"),
+    path6.resolve(cwd, "shared/subsystems")
+  ];
+  return Array.from(new Set(roots));
+}
+function inferBackend(dir, name) {
+  if (name === "observability") return "combiner";
+  if (name === "auth") return "drizzle";
+  if (name === "auth-integrations") return "drizzle";
+  const hasDrizzle = fs4.existsSync(path6.join(dir, `${name.replace(/s$/, "")}-bus.drizzle-backend.ts`)) || fs4.readdirSync(dir).some((f) => f.endsWith(".drizzle-backend.ts"));
+  const hasMemory = fs4.readdirSync(dir).some((f) => f.endsWith(".memory-backend.ts"));
+  const hasLocal = fs4.readdirSync(dir).some((f) => f.includes("local"));
+  if (hasDrizzle && hasMemory) return "drizzle";
+  if (hasDrizzle) return "drizzle";
+  if (hasLocal) return "local";
+  if (hasMemory) return "memory";
+  return "unknown";
+}
+async function detectInstalledSubsystems(ctx) {
+  const configured = ctx.config?.paths?.subsystems;
+  const roots = candidateRoots(ctx.cwd, configured);
+  const found = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const root of roots) {
+    if (!fs4.existsSync(root)) continue;
+    for (const name of KNOWN_NAMES) {
+      if (seen.has(name)) continue;
+      if (name === "openapi-config") continue;
+      if (name === "auth-integrations") continue;
+      const dir = path6.join(root, name);
+      if (!fs4.existsSync(dir) || !fs4.statSync(dir).isDirectory()) continue;
+      const files = fs4.readdirSync(dir);
+      let hasProtocol = files.some((f) => f.endsWith(".protocol.ts"));
+      if (name === "auth") {
+        hasProtocol = files.includes("auth.module.ts");
+      }
+      if (!hasProtocol) continue;
+      seen.add(name);
+      found.push({
+        name,
+        path: dir,
+        backend: inferBackend(dir, name)
+      });
+    }
+  }
+  if (!seen.has("openapi-config")) {
+    const configPath = path6.resolve(
+      ctx.cwd,
+      ctx.config ? "codegen.config.yaml" : "codegen.config.yaml"
+    );
+    if (fs4.existsSync(configPath)) {
+      try {
+        const source = fs4.readFileSync(configPath, "utf-8");
+        if (/^openapi\s*:/m.test(source)) {
+          found.push({
+            name: "openapi-config",
+            path: configPath,
+            backend: "config-only"
+          });
+        }
+      } catch {
+      }
+    }
+  }
+  if (!seen.has("auth-integrations")) {
+    const backendSrc = ctx.config?.paths?.backend_src ?? "src";
+    const pathsAny = ctx.config?.paths;
+    const modulesConfigured = pathsAny?.modules_dir;
+    const vendorRoot = typeof modulesConfigured === "string" && modulesConfigured.length > 0 ? path6.resolve(ctx.cwd, modulesConfigured) : path6.resolve(ctx.cwd, backendSrc, "modules");
+    const sharedConfigured = pathsAny?.shared;
+    const sharedRoot = typeof sharedConfigured === "string" && sharedConfigured.length > 0 ? path6.resolve(ctx.cwd, sharedConfigured) : path6.resolve(ctx.cwd, backendSrc, "shared");
+    const candidates = [
+      path6.join(vendorRoot, "integrations", "integrations-auth.module.ts"),
+      path6.join(sharedRoot, "integrations", "integrations-auth.module.ts")
+    ];
+    for (const moduleFile of candidates) {
+      if (fs4.existsSync(moduleFile)) {
+        found.push({
+          name: "auth-integrations",
+          path: path6.dirname(moduleFile),
+          backend: "drizzle"
+        });
+        break;
+      }
+    }
+  }
+  return found;
+}
+
+// src/cli/shared/subsystems-path.ts
+import path7 from "path";
+var FALLBACK_BACKEND_SRC = "src";
+function resolveSubsystemsRootFromConfig(cwd, config) {
+  const configured = config?.paths?.subsystems;
+  if (typeof configured === "string" && configured.length > 0) {
+    return path7.resolve(cwd, configured);
+  }
+  const backendSrc = config?.paths?.backend_src;
+  const base = typeof backendSrc === "string" && backendSrc.length > 0 ? backendSrc : FALLBACK_BACKEND_SRC;
+  return path7.resolve(cwd, base, "shared", "subsystems");
+}
+function resolveSubsystemsRoot(ctx, overrideTarget) {
+  if (overrideTarget) return path7.resolve(ctx.cwd, overrideTarget);
+  return resolveSubsystemsRootFromConfig(ctx.cwd, ctx.config);
+}
+
+// src/cli/shared/subsystem-barrel-generator.ts
+function quoteOpts(opts) {
+  const entries = Object.entries(opts).filter(([, v]) => v !== void 0);
+  if (entries.length === 0) return "";
+  return "{ " + entries.map(([k, v]) => `${k}: ${typeof v === "string" ? `'${v}'` : String(v)}`).join(", ") + " }";
+}
+var COMPOSERS = {
+  events: ({ subsystemsRel, cfg }) => {
+    const backend = cfg?.backend ?? "drizzle";
+    const multiTenant = Boolean(cfg?.multi_tenant);
+    return {
+      imports: [
+        `import { EventsModule } from '${subsystemsRel}/events/events.module';`
+      ],
+      calls: [
+        `	EventsModule.forRoot(${quoteOpts({ backend, multiTenant })}),`
+      ]
+    };
+  },
+  jobs: ({ subsystemsRel, cfg }) => {
+    const backend = cfg?.backend ?? "drizzle";
+    const multiTenant = Boolean(cfg?.multi_tenant);
+    const workerMode = (cfg?.worker_mode ?? "standalone").trim();
+    const imports = [
+      `import { JobsDomainModule } from '${subsystemsRel}/jobs/jobs-domain.module';`
+    ];
+    const calls = [
+      `	JobsDomainModule.forRoot(${quoteOpts({ backend, multiTenant })}),`
+    ];
+    if (workerMode === "embedded") {
+      imports.push(
+        `import { JobWorkerModule } from '${subsystemsRel}/jobs/job-worker.module';`
+      );
+      calls.push(`	JobWorkerModule.forRoot({ mode: 'embedded' }),`);
+    }
+    return { imports, calls };
+  },
+  bridge: ({ subsystemsRel, cfg }) => {
+    const backend = cfg?.backend ?? "drizzle";
+    const multiTenant = Boolean(cfg?.multi_tenant);
+    return {
+      imports: [
+        `import { BridgeModule } from '${subsystemsRel}/bridge/bridge.module';`
+      ],
+      calls: [
+        `	BridgeModule.forRoot(${quoteOpts({ backend, multiTenant })}),`
+      ]
+    };
+  },
+  sync: ({ subsystemsRel, cfg }) => {
+    const backend = cfg?.backend ?? "drizzle";
+    const multiTenant = Boolean(cfg?.multi_tenant);
+    return {
+      imports: [
+        `import { SyncModule } from '${subsystemsRel}/sync/sync.module';`
+      ],
+      calls: [
+        `	SyncModule.forRoot(${quoteOpts({ backend, multiTenant })}),`
+      ]
+    };
+  }
+};
+var COMPOSABLE_ORDER = ["events", "jobs", "bridge", "sync"];
+var HEADER3 = `// AUTO-GENERATED by @pattern-stack/codegen. DO NOT EDIT.
+// Subsystem composition barrel \u2014 reflects \`subsystems.install\` in
+// codegen.config.yaml and the per-subsystem option blocks
+// (\`events:\`, \`jobs:\`, \`bridge:\`, \`sync:\`).
+//
+// Wire into AppModule once:
+//
+//   import { SUBSYSTEM_MODULES } from './generated/subsystems';
+//   @Module({ imports: [DatabaseModule, ...SUBSYSTEM_MODULES, ...GENERATED_MODULES] })
+//
+// Regenerated by every \`codegen entity new\` / \`codegen subsystem install\`.
+
+`;
+function buildSubsystemBarrel(installed, config, subsystemsRel) {
+  const installedNames = new Set(installed.map((i) => i.name));
+  const emitted = [];
+  const skipped = [];
+  const allImports = [`import type { DynamicModule } from '@nestjs/common';`];
+  const allCalls = [];
+  for (const name of COMPOSABLE_ORDER) {
+    if (!installedNames.has(name)) continue;
+    const composer = COMPOSERS[name];
+    if (!composer) {
+      skipped.push(name);
+      continue;
+    }
+    const cfg = config?.[name] ?? void 0;
+    const out = composer({ subsystemsRel, cfg });
+    allImports.push(...out.imports);
+    allCalls.push(...out.calls);
+    emitted.push(name);
+  }
+  for (const inst of installed) {
+    if (!COMPOSABLE_ORDER.includes(inst.name) && !COMPOSERS[inst.name]) {
+      skipped.push(inst.name);
+    }
+  }
+  if (allCalls.length === 0) {
+    return {
+      content: HEADER3 + `export const SUBSYSTEM_MODULES: DynamicModule[] = [];
+`,
+      emitted,
+      skipped
+    };
+  }
+  const body = allImports.join("\n") + `
+
+export const SUBSYSTEM_MODULES: DynamicModule[] = [
+${allCalls.join("\n")}
+];
+`;
+  return { content: HEADER3 + body, emitted, skipped };
+}
+async function regenerateSubsystemBarrel(opts) {
+  const { ctx, dryRun = false } = opts;
+  const generatedDir = opts.generatedDir ?? resolveGeneratedDir(ctx);
+  const installed = await detectInstalledSubsystems(ctx);
+  const subsystemsAbs = resolveSubsystemsRoot(ctx);
+  const barrelAbs = path8.resolve(generatedDir, "subsystems.ts");
+  let subsystemsRel = path8.relative(path8.dirname(barrelAbs), subsystemsAbs).split(path8.sep).join("/");
+  if (!subsystemsRel.startsWith(".")) subsystemsRel = "./" + subsystemsRel;
+  const { content, emitted, skipped } = buildSubsystemBarrel(
+    installed,
+    ctx.config,
+    subsystemsRel
+  );
+  let written = false;
+  if (!dryRun) {
+    fs5.mkdirSync(path8.dirname(barrelAbs), { recursive: true });
+    fs5.writeFileSync(barrelAbs, content);
+    written = true;
+  }
+  return {
+    subsystemBarrel: barrelAbs,
+    emitted,
+    skipped,
+    content,
+    written
+  };
+}
+
+// src/cli/shared/bridge-registry-generator.ts
+import fs6 from "fs";
+import path9 from "path";
 import ts from "typescript";
-var HEADER3 = `// AUTO-GENERATED by @pattern-stack/codegen. Do not edit.
+var HEADER4 = `// AUTO-GENERATED by @pattern-stack/codegen. Do not edit.
 // Run \`codegen entity new --all\` to refresh.
 `;
 var DuplicateTriggerError = class extends Error {
@@ -5937,12 +6283,12 @@ var UnknownTriggerEventError = class extends Error {
   name = "UnknownTriggerEventError";
 };
 function findHandlerFiles(dir) {
-  if (!fs4.existsSync(dir)) return [];
+  if (!fs6.existsSync(dir)) return [];
   const out = [];
-  for (const entry of fs4.readdirSync(dir, { withFileTypes: true })) {
+  for (const entry of fs6.readdirSync(dir, { withFileTypes: true })) {
     if (entry.name.startsWith(".")) continue;
     if (entry.name === "node_modules" || entry.name === "generated") continue;
-    const full = path6.join(dir, entry.name);
+    const full = path9.join(dir, entry.name);
     if (entry.isDirectory()) {
       out.push(...findHandlerFiles(full));
     } else if (entry.isFile() && entry.name.endsWith(".ts") && !entry.name.endsWith(".d.ts")) {
@@ -6005,7 +6351,7 @@ function scanHandlerFiles(handlersDir) {
   const files = findHandlerFiles(handlersDir);
   const out = [];
   for (const filePath of files) {
-    const text2 = fs4.readFileSync(filePath, "utf8");
+    const text2 = fs6.readFileSync(filePath, "utf8");
     const sourceFile = ts.createSourceFile(
       filePath,
       text2,
@@ -6020,9 +6366,9 @@ function scanHandlerFiles(handlersDir) {
 }
 function readKnownEventTypes(eventsGeneratedDir) {
   if (!eventsGeneratedDir) return [];
-  const registryPath = path6.join(eventsGeneratedDir, "registry.ts");
-  if (!fs4.existsSync(registryPath)) return [];
-  const text2 = fs4.readFileSync(registryPath, "utf8");
+  const registryPath = path9.join(eventsGeneratedDir, "registry.ts");
+  if (!fs6.existsSync(registryPath)) return [];
+  const text2 = fs6.readFileSync(registryPath, "utf8");
   const out = /* @__PURE__ */ new Set();
   const re = /^\s*'([a-zA-Z0-9_.-]+)':\s*\{/gm;
   let m;
@@ -6034,9 +6380,9 @@ function readKnownEventTypes(eventsGeneratedDir) {
 function readEventTiers(eventsGeneratedDir) {
   const out = /* @__PURE__ */ new Map();
   if (!eventsGeneratedDir) return out;
-  const registryPath = path6.join(eventsGeneratedDir, "registry.ts");
-  if (!fs4.existsSync(registryPath)) return out;
-  const text2 = fs4.readFileSync(registryPath, "utf8");
+  const registryPath = path9.join(eventsGeneratedDir, "registry.ts");
+  if (!fs6.existsSync(registryPath)) return out;
+  const text2 = fs6.readFileSync(registryPath, "utf8");
   const re = /'([a-zA-Z0-9_.-]+)':\s*\{[^}]*?tier:\s*'(domain|audit)'/g;
   let m;
   while ((m = re.exec(text2)) !== null) {
@@ -6093,7 +6439,7 @@ function validateAgainstEventRegistry(triggers, knownEventTypes) {
 }
 function buildBridgeRegistryContent(triggers) {
   const chunks = [];
-  chunks.push(HEADER3);
+  chunks.push(HEADER4);
   chunks.push("");
   chunks.push(`import type { BridgeRegistry } from '../bridge.protocol';`);
   chunks.push("");
@@ -6131,11 +6477,11 @@ function buildBridgeRegistryContent(triggers) {
 var OUTPUT_FILE_NAME = "registry.ts";
 async function generateBridgeRegistry(opts) {
   const { handlersDir, eventsGeneratedDir, outputDir, dryRun = false } = opts;
-  const bridgeProtocolPath = path6.resolve(outputDir, "..", "bridge.protocol.ts");
-  if (!fs4.existsSync(bridgeProtocolPath)) {
-    const strayPath = path6.join(outputDir, OUTPUT_FILE_NAME);
-    if (!dryRun && fs4.existsSync(strayPath)) {
-      fs4.rmSync(strayPath);
+  const bridgeProtocolPath = path9.resolve(outputDir, "..", "bridge.protocol.ts");
+  if (!fs6.existsSync(bridgeProtocolPath)) {
+    const strayPath = path9.join(outputDir, OUTPUT_FILE_NAME);
+    if (!dryRun && fs6.existsSync(strayPath)) {
+      fs6.rmSync(strayPath);
     }
     return {
       outputDir,
@@ -6156,13 +6502,13 @@ async function generateBridgeRegistry(opts) {
   const content = buildBridgeRegistryContent(triggers);
   const file = {
     name: OUTPUT_FILE_NAME,
-    outputPath: path6.join(outputDir, OUTPUT_FILE_NAME),
+    outputPath: path9.join(outputDir, OUTPUT_FILE_NAME),
     content
   };
   let written = false;
   if (!dryRun) {
-    fs4.mkdirSync(outputDir, { recursive: true });
-    fs4.writeFileSync(file.outputPath, file.content);
+    fs6.mkdirSync(outputDir, { recursive: true });
+    fs6.writeFileSync(file.outputPath, file.content);
     written = true;
   }
   const eventTypeCount = new Set(triggers.map((t) => t.event)).size;
@@ -6178,8 +6524,8 @@ async function generateBridgeRegistry(opts) {
 }
 
 // src/cli/shared/orchestration-generator.ts
-import fs5 from "fs";
-import path7 from "path";
+import fs7 from "fs";
+import path10 from "path";
 var OrchestrationEmissionError = class extends Error {
   constructor(issueType, patternName, message) {
     super(`[${issueType}] ${patternName}: ${message}`);
@@ -6190,7 +6536,7 @@ var OrchestrationEmissionError = class extends Error {
   patternName;
   name = "OrchestrationEmissionError";
 };
-var HEADER4 = `// AUTO-GENERATED by @pattern-stack/codegen. Do not edit.
+var HEADER5 = `// AUTO-GENERATED by @pattern-stack/codegen. Do not edit.
 // See ADR-032 \u2014 Orchestration Patterns.
 `;
 function splitWords(str) {
@@ -6354,7 +6700,7 @@ function buildTokensTs(pattern) {
     typeImports.push({ specifier: reg.valueTypeImport, name: reg.valueType });
   }
   const lines = [];
-  lines.push(HEADER4.trimEnd());
+  lines.push(HEADER5.trimEnd());
   lines.push("");
   for (const i of emitTypeImports(typeImports)) lines.push(i);
   lines.push("");
@@ -6387,7 +6733,7 @@ function buildProvidersTs(pattern) {
   }
   const optsType = forRootOptionsTypeName(pattern);
   const lines = [];
-  lines.push(HEADER4.trimEnd());
+  lines.push(HEADER5.trimEnd());
   lines.push("");
   lines.push(`import type { Provider } from '@nestjs/common';`);
   for (const i of emitTypeImports(typeImports)) lines.push(i);
@@ -6454,7 +6800,7 @@ function buildDispatcherTs(pattern) {
   const tokenValues = registries.map(({ names }) => names.tokenConst);
   const mapTypes = registries.map(({ names }) => names.mapType);
   const lines = [];
-  lines.push(HEADER4.trimEnd());
+  lines.push(HEADER5.trimEnd());
   lines.push("");
   lines.push(`import { Inject, Injectable } from '@nestjs/common';`);
   for (const i of emitTypeImports(typeImports)) lines.push(i);
@@ -6528,7 +6874,7 @@ function buildModuleTs(pattern) {
   }
   const tokenValues = registries.map(({ names }) => names.tokenConst);
   const lines = [];
-  lines.push(HEADER4.trimEnd());
+  lines.push(HEADER5.trimEnd());
   lines.push("");
   lines.push(`import { type DynamicModule, Module } from '@nestjs/common';`);
   for (const i of emitTypeImports(typeImports)) lines.push(i);
@@ -6562,7 +6908,7 @@ function buildModuleTs(pattern) {
 }
 function buildIndexTs(pattern) {
   const lines = [];
-  lines.push(HEADER4.trimEnd());
+  lines.push(HEADER5.trimEnd());
   lines.push("");
   lines.push(`export * from './tokens.js';`);
   lines.push(`export * from './dispatcher.js';`);
@@ -6573,7 +6919,7 @@ function buildIndexTs(pattern) {
 }
 function buildRootBarrelTs(patterns) {
   const lines = [];
-  lines.push(HEADER4.trimEnd());
+  lines.push(HEADER5.trimEnd());
   lines.push("");
   if (patterns.length === 0) {
     lines.push("// No orchestration patterns registered.");
@@ -6591,11 +6937,11 @@ function buildRootBarrelTs(patterns) {
 function buildPatternFiles(pattern, outputRoot) {
   assertEmittable(pattern);
   const slug = toKebabCase2(pattern.name);
-  const outputDir = path7.join(outputRoot, slug);
+  const outputDir = path10.join(outputRoot, slug);
   const make = (name, content) => ({
     name,
-    outputPath: path7.join(outputDir, name),
-    relativePath: path7.join(slug, name),
+    outputPath: path10.join(outputDir, name),
+    relativePath: path10.join(slug, name),
     content
   });
   const files = [
@@ -6623,21 +6969,21 @@ function generateOrchestrationModules(opts) {
   }
   const rootBarrel = {
     name: "index.ts",
-    outputPath: path7.join(outputRoot, "index.ts"),
+    outputPath: path10.join(outputRoot, "index.ts"),
     relativePath: "index.ts",
     content: buildRootBarrelTs(patterns)
   };
   allFiles.push(rootBarrel);
   let written = false;
   if (!dryRun && patterns.length > 0) {
-    fs5.mkdirSync(outputRoot, { recursive: true });
+    fs7.mkdirSync(outputRoot, { recursive: true });
     for (const r of perPattern) {
-      fs5.mkdirSync(r.outputDir, { recursive: true });
+      fs7.mkdirSync(r.outputDir, { recursive: true });
       for (const f of r.files) {
-        fs5.writeFileSync(f.outputPath, f.content);
+        fs7.writeFileSync(f.outputPath, f.content);
       }
     }
-    fs5.writeFileSync(rootBarrel.outputPath, rootBarrel.content);
+    fs7.writeFileSync(rootBarrel.outputPath, rootBarrel.content);
     written = true;
   }
   return {
@@ -6649,8 +6995,8 @@ function generateOrchestrationModules(opts) {
 }
 
 // src/cli/shared/event-codegen-generator.ts
-import fs6 from "fs";
-import path8 from "path";
+import fs8 from "fs";
+import path11 from "path";
 
 // src/parser/load-events.ts
 import { readdirSync as readdirSync7 } from "fs";
@@ -6781,7 +7127,7 @@ function isEventFieldType(s) {
 }
 
 // src/cli/shared/event-codegen-generator.ts
-var HEADER5 = `// AUTO-GENERATED by @pattern-stack/codegen. Do not edit.
+var HEADER6 = `// AUTO-GENERATED by @pattern-stack/codegen. Do not edit.
 // Run \`codegen entity new --all\` to refresh.
 `;
 function toCamelCase2(input) {
@@ -6835,10 +7181,10 @@ function aggregateTypeLiteral(ev) {
 function collectEntityEvents(entitiesDir) {
   const events = [];
   const issues = [];
-  if (!fs6.existsSync(entitiesDir)) {
+  if (!fs8.existsSync(entitiesDir)) {
     return { events, issues };
   }
-  const files = fs6.readdirSync(entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path8.join(entitiesDir, f)).sort();
+  const files = fs8.readdirSync(entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path11.join(entitiesDir, f)).sort();
   for (const filePath of files) {
     const result = loadEntityFromYaml(filePath);
     if (!result.success) continue;
@@ -6879,8 +7225,8 @@ function mergeEvents(topLevel, entitySugar) {
 function collectMergedEvents(opts) {
   const { entitiesDir, eventsDir } = opts;
   const entityNames = [];
-  if (fs6.existsSync(entitiesDir)) {
-    const entityFiles = fs6.readdirSync(entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path8.join(entitiesDir, f)).sort();
+  if (fs8.existsSync(entitiesDir)) {
+    const entityFiles = fs8.readdirSync(entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path11.join(entitiesDir, f)).sort();
     for (const f of entityFiles) {
       const result = loadEntityFromYaml(f);
       if (result.success) entityNames.push(result.definition.entity.name);
@@ -6902,7 +7248,7 @@ function collectMergedEvents(opts) {
 function buildTypesContent(events) {
   const sorted = [...events].sort((a, b) => a.type.localeCompare(b.type));
   if (sorted.length === 0) {
-    return HEADER5 + `
+    return HEADER6 + `
 import type { DomainEvent } from '../event-bus.protocol';
 
 export type AppDomainEvent = never;
@@ -6913,7 +7259,7 @@ export type PayloadOfType<T extends EventTypeName> = never;
 `;
   }
   const chunks = [];
-  chunks.push(HEADER5);
+  chunks.push(HEADER6);
   chunks.push("");
   chunks.push(`import type { DomainEvent } from '../event-bus.protocol';`);
   chunks.push("");
@@ -6961,7 +7307,7 @@ export type PayloadOfType<T extends EventTypeName> = never;
 function buildSchemasContent(events) {
   const sorted = [...events].sort((a, b) => a.type.localeCompare(b.type));
   if (sorted.length === 0) {
-    return HEADER5 + `
+    return HEADER6 + `
 import { z } from 'zod';
 import type { EventTypeName } from './types';
 
@@ -6969,7 +7315,7 @@ export const eventPayloadSchemas = {} as Record<EventTypeName, z.ZodType>;
 `;
   }
   const chunks = [];
-  chunks.push(HEADER5);
+  chunks.push(HEADER6);
   chunks.push("");
   chunks.push(`import { z } from 'zod';`);
   chunks.push(`import type { EventTypeName } from './types';`);
@@ -7024,7 +7370,7 @@ var REGISTRY_GETTER = [
 function buildRegistryContent(events) {
   const sorted = [...events].sort((a, b) => a.type.localeCompare(b.type));
   const chunks = [];
-  chunks.push(HEADER5);
+  chunks.push(HEADER6);
   chunks.push("");
   chunks.push(`import type { EventTypeName } from './types';`);
   chunks.push("");
@@ -7204,10 +7550,10 @@ export class TypedEventBus {
 }
 `;
 function buildBusContent(_events) {
-  return HEADER5 + "\n" + BUS_BODY;
+  return HEADER6 + "\n" + BUS_BODY;
 }
 function buildIndexContent(_events) {
-  return HEADER5 + `
+  return HEADER6 + `
 export * from './types';
 export * from './schemas';
 export * from './registry';
@@ -7236,15 +7582,15 @@ async function generateEventCodegen(opts) {
   };
   const files = OUTPUT_FILE_NAMES.map((name) => ({
     name,
-    outputPath: path8.join(outputDir, name),
+    outputPath: path11.join(outputDir, name),
     content: builders[name](merged)
   }));
   const hasError = issues.some((i) => i.severity === "error");
   let written = false;
   if (!dryRun && !hasError) {
-    fs6.mkdirSync(outputDir, { recursive: true });
+    fs8.mkdirSync(outputDir, { recursive: true });
     for (const file of files) {
-      fs6.writeFileSync(file.outputPath, file.content);
+      fs8.writeFileSync(file.outputPath, file.content);
     }
     written = true;
   }
@@ -7326,32 +7672,15 @@ function validateEntityEmits(entities, events) {
   return issues;
 }
 
-// src/cli/shared/subsystems-path.ts
-import path9 from "path";
-var FALLBACK_BACKEND_SRC = "src";
-function resolveSubsystemsRootFromConfig(cwd, config) {
-  const configured = config?.paths?.subsystems;
-  if (typeof configured === "string" && configured.length > 0) {
-    return path9.resolve(cwd, configured);
-  }
-  const backendSrc = config?.paths?.backend_src;
-  const base = typeof backendSrc === "string" && backendSrc.length > 0 ? backendSrc : FALLBACK_BACKEND_SRC;
-  return path9.resolve(cwd, base, "shared", "subsystems");
-}
-function resolveSubsystemsRoot(ctx, overrideTarget) {
-  if (overrideTarget) return path9.resolve(ctx.cwd, overrideTarget);
-  return resolveSubsystemsRootFromConfig(ctx.cwd, ctx.config);
-}
-
 // src/cli/shared/events-path.ts
-import path10 from "path";
+import path12 from "path";
 var FALLBACK = "events";
 function resolveEventsDirFromConfig(cwd, config) {
   const configured = config?.paths?.events_dir;
   if (typeof configured === "string" && configured.length > 0) {
-    return path10.resolve(cwd, configured);
+    return path12.resolve(cwd, configured);
   }
-  return path10.resolve(cwd, FALLBACK);
+  return path12.resolve(cwd, FALLBACK);
 }
 function resolveEventsDir(ctx) {
   return resolveEventsDirFromConfig(ctx.cwd, ctx.config);
@@ -7379,8 +7708,8 @@ function printInfo(msg) {
 
 // src/cli/commands/entity.ts
 function listEntityYamls2(dir) {
-  if (!fs7.existsSync(dir)) return [];
-  return fs7.readdirSync(dir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path11.join(dir, f));
+  if (!fs9.existsSync(dir)) return [];
+  return fs9.readdirSync(dir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path13.join(dir, f));
 }
 function summarizePatternLabel(entity) {
   if (typeof entity.pattern === "string" && entity.pattern.length > 0) {
@@ -7490,14 +7819,14 @@ var EntityNewCommand = class extends Command2 {
     }
     let targets = [];
     if (this.all) {
-      const dir = ctx.entitiesDir ?? path11.resolve(ctx.cwd, "entities");
+      const dir = ctx.entitiesDir ?? path13.resolve(ctx.cwd, "entities");
       targets = listEntityYamls2(dir);
       if (targets.length === 0) {
         printError(`No entity YAML files found in ${dir}`);
         return 1;
       }
     } else if (this.yaml) {
-      targets = [path11.resolve(ctx.cwd, this.yaml)];
+      targets = [path13.resolve(ctx.cwd, this.yaml)];
     } else {
       printError("Missing YAML path. Pass a file or --all.");
       return 2;
@@ -7514,13 +7843,13 @@ var EntityNewCommand = class extends Command2 {
     }
     if (invalid.length > 0 && !this.continueOnError) {
       for (const i of invalid) {
-        printError(`${path11.basename(i.file)} \u2014 ${i.message}`);
+        printError(`${path13.basename(i.file)} \u2014 ${i.message}`);
       }
       if (!isJsonMode()) {
         return 1;
       }
     }
-    const entitiesDirForEmits = ctx.entitiesDir ?? path11.resolve(ctx.cwd, "entities");
+    const entitiesDirForEmits = ctx.entitiesDir ?? path13.resolve(ctx.cwd, "entities");
     const eventsDirForEmits = resolveEventsDir(ctx);
     const allEntitiesForEmits = loadEntities(entitiesDirForEmits).entities;
     const validatedNames = new Set(validated.map((v) => v.name));
@@ -7567,34 +7896,34 @@ var EntityNewCommand = class extends Command2 {
         if (!isJsonMode()) return 1;
       }
     }
-    const entitiesDir = ctx.entitiesDir ?? path11.resolve(ctx.cwd, "entities");
-    const relationshipsDir = path11.resolve(ctx.cwd, "relationships");
+    const entitiesDir = ctx.entitiesDir ?? path13.resolve(ctx.cwd, "entities");
+    const relationshipsDir = path13.resolve(ctx.cwd, "relationships");
     const generatedDir = resolveGeneratedDir(ctx);
     const architecture = resolveArchitecture(ctx);
     const subsystemsRoot = resolveSubsystemsRoot(ctx);
-    const scopeEntityTypePath = path11.resolve(
+    const scopeEntityTypePath = path13.resolve(
       subsystemsRoot,
       "jobs/generated/scope-entity-type.ts"
     );
     const eventsDir = resolveEventsDir(ctx);
-    const eventCodegenOutputDir = path11.resolve(
+    const eventCodegenOutputDir = path13.resolve(
       subsystemsRoot,
       "events/generated"
     );
-    const bridgeRegistryOutputDir = path11.resolve(
+    const bridgeRegistryOutputDir = path13.resolve(
       subsystemsRoot,
       "bridge/generated"
     );
     const backendSrcForHandlers = ctx.config?.paths?.backend_src ?? "src";
-    const bridgeHandlersDir = path11.resolve(
+    const bridgeHandlersDir = path13.resolve(
       ctx.cwd,
       backendSrcForHandlers,
       "jobs"
     );
     const orchestrationConfigured = ctx.config?.paths?.orchestration_src;
-    const orchestrationOutputRoot = path11.resolve(
+    const orchestrationOutputRoot = path13.resolve(
       ctx.cwd,
-      typeof orchestrationConfigured === "string" && orchestrationConfigured.length > 0 ? orchestrationConfigured : path11.join(backendSrcForHandlers, "orchestration")
+      typeof orchestrationConfigured === "string" && orchestrationConfigured.length > 0 ? orchestrationConfigured : path13.join(backendSrcForHandlers, "orchestration")
     );
     const orchestrationGlobs = (() => {
       const fromCfg = ctx.config?.patterns;
@@ -7722,7 +8051,7 @@ var EntityNewCommand = class extends Command2 {
         }
         if (invalid.length > 0) {
           for (const i of invalid) {
-            printWarning(`${path11.basename(i.file)} \u2014 ${i.message}`);
+            printWarning(`${path13.basename(i.file)} \u2014 ${i.message}`);
           }
         }
         console.log("");
@@ -7740,7 +8069,7 @@ var EntityNewCommand = class extends Command2 {
     }
     const succeeded = [];
     const failed = [
-      ...invalid.map((i) => ({ name: path11.basename(i.file), file: i.file, message: i.message }))
+      ...invalid.map((i) => ({ name: path13.basename(i.file), file: i.file, message: i.message }))
     ];
     for (const v of validated) {
       if (!isJsonMode()) {
@@ -7775,6 +8104,14 @@ var EntityNewCommand = class extends Command2 {
         printWarning(`barrel regeneration failed \u2014 ${msg}`);
       }
     }
+    try {
+      await regenerateSubsystemBarrel({ ctx, generatedDir });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (!isJsonMode()) {
+        printWarning(`subsystem barrel regeneration failed \u2014 ${msg}`);
+      }
+    }
     let scopeResult = null;
     try {
       scopeResult = await generateScopeEntityType({
@@ -7914,22 +8251,22 @@ var EntityNewCommand = class extends Command2 {
       }
       if (barrelResult) {
         printInfo(
-          `barrels regenerated (${barrelResult.entityCount} entities) \u2192 ${path11.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path11.relative(ctx.cwd, barrelResult.schemaBarrel)}`
+          `barrels regenerated (${barrelResult.entityCount} entities) \u2192 ${path13.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path13.relative(ctx.cwd, barrelResult.schemaBarrel)}`
         );
       }
       if (scopeResult) {
         printInfo(
-          `scope-entity-type regenerated (${scopeResult.scopeableNames.length} scopeable) \u2192 ${path11.relative(ctx.cwd, scopeResult.outputPath)}`
+          `scope-entity-type regenerated (${scopeResult.scopeableNames.length} scopeable) \u2192 ${path13.relative(ctx.cwd, scopeResult.outputPath)}`
         );
       }
       if (eventCodegenResult) {
         printInfo(
-          `event codegen regenerated (${eventCodegenResult.eventCount} events) \u2192 ${path11.relative(ctx.cwd, eventCodegenResult.outputDir)}`
+          `event codegen regenerated (${eventCodegenResult.eventCount} events) \u2192 ${path13.relative(ctx.cwd, eventCodegenResult.outputDir)}`
         );
       }
       if (orchestrationResult && orchestrationResult.patterns.length > 0) {
         printInfo(
-          `orchestration regenerated (${orchestrationResult.patterns.length} patterns, ${orchestrationResult.files.length} files) \u2192 ${path11.relative(ctx.cwd, orchestrationResult.outputRoot)}`
+          `orchestration regenerated (${orchestrationResult.patterns.length} patterns, ${orchestrationResult.files.length} files) \u2192 ${path13.relative(ctx.cwd, orchestrationResult.outputRoot)}`
         );
       }
     }
@@ -8015,8 +8352,8 @@ var EntityValidateCommand = class extends Command2 {
       json: this.json,
       skipDetection: true
     });
-    const targetDir = this.dir ? path11.resolve(ctx.cwd, this.dir) : ctx.entitiesDir ?? path11.resolve(ctx.cwd, "entities");
-    if (!fs7.existsSync(targetDir)) {
+    const targetDir = this.dir ? path13.resolve(ctx.cwd, this.dir) : ctx.entitiesDir ?? path13.resolve(ctx.cwd, "entities");
+    if (!fs9.existsSync(targetDir)) {
       printError(`Directory not found: ${targetDir}`);
       return 1;
     }
@@ -8067,8 +8404,8 @@ var entityNoun = {
 var entity_default = entityNoun;
 
 // src/cli/commands/subsystem.ts
-import fs10 from "fs";
-import path21 from "path";
+import fs11 from "fs";
+import path22 from "path";
 import { Command as Command3, Option as Option3 } from "clipanion";
 
 // src/cli/shared/config-block-detect.ts
@@ -8101,26 +8438,26 @@ function stripConfigBlock(yamlSource, subsystem) {
 }
 
 // src/cli/shared/events-scaffold-locals.ts
-import path12 from "path";
+import path14 from "path";
 function resolveEventsScaffoldLocals(input) {
   const { cwd, config } = input;
   void input.fileExists;
   const eventsBlock = config?.events ?? {};
   const subsystemsRoot = resolveSubsystemsRootFromConfig(cwd, config);
-  const configPath = path12.resolve(cwd, "codegen.config.yaml");
-  const schemaPath = path12.resolve(
+  const configPath = path14.resolve(cwd, "codegen.config.yaml");
+  const schemaPath = path14.resolve(
     subsystemsRoot,
     "events",
     "domain-events.schema.ts"
   );
-  const generatedKeepPath = path12.resolve(
+  const generatedKeepPath = path14.resolve(
     subsystemsRoot,
     "events",
     "generated",
     ".gitkeep"
   );
   return {
-    appName: path12.basename(cwd),
+    appName: path14.basename(cwd),
     multiTenant: normaliseMultiTenant(eventsBlock.multi_tenant),
     configPath,
     schemaPath,
@@ -8146,7 +8483,7 @@ function localsToHygenArgs(locals) {
 }
 
 // src/cli/shared/jobs-scaffold-locals.ts
-import path13 from "path";
+import path15 from "path";
 var MAIN_HOOK_SENTINEL = "JOBS \u2014 Embedded worker mode (optional)";
 function workerSkipValue(exists) {
   return exists ? "true" : "";
@@ -8155,10 +8492,10 @@ function resolveJobsScaffoldLocals(input) {
   const { cwd, config, fileExists, readFile } = input;
   const jobsBlock = config?.jobs ?? {};
   const subsystemsRoot = resolveSubsystemsRootFromConfig(cwd, config);
-  const workerPath = path13.resolve(cwd, "worker.ts");
-  const mainTsPath = path13.resolve(cwd, "src/main.ts");
-  const configPath = path13.resolve(cwd, "codegen.config.yaml");
-  const schemaPath = path13.resolve(
+  const workerPath = path15.resolve(cwd, "worker.ts");
+  const mainTsPath = path15.resolve(cwd, "src/main.ts");
+  const configPath = path15.resolve(cwd, "codegen.config.yaml");
+  const schemaPath = path15.resolve(
     subsystemsRoot,
     "jobs",
     "job-orchestration.schema.ts"
@@ -8166,7 +8503,7 @@ function resolveJobsScaffoldLocals(input) {
   const mainContent = readFile(mainTsPath);
   const mainHookInjected = mainContent !== null && mainContent.includes(MAIN_HOOK_SENTINEL);
   return {
-    appName: path13.basename(cwd),
+    appName: path15.basename(cwd),
     workerMode: normaliseWorkerMode(jobsBlock.worker_mode),
     multiTenant: normaliseMultiTenant2(jobsBlock.multi_tenant),
     mainTsPath,
@@ -8208,20 +8545,20 @@ function localsToHygenArgs2(locals) {
 }
 
 // src/cli/shared/sync-scaffold-locals.ts
-import path14 from "path";
+import path16 from "path";
 function resolveSyncScaffoldLocals(input) {
   const { cwd, config } = input;
   void input.fileExists;
   const syncBlock = config?.sync ?? {};
   const subsystemsRoot = resolveSubsystemsRootFromConfig(cwd, config);
-  const configPath = path14.resolve(cwd, "codegen.config.yaml");
-  const schemaPath = path14.resolve(
+  const configPath = path16.resolve(cwd, "codegen.config.yaml");
+  const schemaPath = path16.resolve(
     subsystemsRoot,
     "sync",
     "sync-audit.schema.ts"
   );
   return {
-    appName: path14.basename(cwd),
+    appName: path16.basename(cwd),
     multiTenant: normaliseMultiTenant3(syncBlock.multi_tenant),
     configPath,
     schemaPath
@@ -8244,21 +8581,21 @@ function localsToHygenArgs3(locals) {
 }
 
 // src/cli/shared/bridge-scaffold-locals.ts
-import path15 from "path";
+import path17 from "path";
 function resolveBridgeScaffoldLocals(input) {
   const { cwd, config } = input;
   void input.fileExists;
   const bridgeBlock = config?.bridge ?? {};
   const subsystemsRoot = resolveSubsystemsRootFromConfig(cwd, config);
-  const configPath = path15.resolve(cwd, "codegen.config.yaml");
-  const generatedKeepPath = path15.resolve(
+  const configPath = path17.resolve(cwd, "codegen.config.yaml");
+  const generatedKeepPath = path17.resolve(
     subsystemsRoot,
     "bridge",
     "generated",
     ".gitkeep"
   );
   return {
-    appName: path15.basename(cwd),
+    appName: path17.basename(cwd),
     multiTenant: normaliseMultiTenant4(bridgeBlock.multi_tenant),
     configPath,
     generatedKeepPath
@@ -8281,19 +8618,19 @@ function localsToHygenArgs4(locals) {
 }
 
 // src/cli/shared/observability-scaffold-locals.ts
-import path16 from "path";
+import path18 from "path";
 var FALLBACK_BACKEND_SRC2 = "src";
 function resolveObservabilityScaffoldLocals(input) {
   const { cwd, config } = input;
   void input.fileExists;
   const backendSrc = typeof config?.paths?.backend_src === "string" && config.paths.backend_src.length > 0 ? config.paths.backend_src : FALLBACK_BACKEND_SRC2;
-  const appModulePath = path16.resolve(cwd, backendSrc, "app.module.ts");
-  const configPath = path16.resolve(cwd, "codegen.config.yaml");
+  const appModulePath = path18.resolve(cwd, backendSrc, "app.module.ts");
+  const configPath = path18.resolve(cwd, "codegen.config.yaml");
   const obsBlock = config?.observability ?? {};
   const reporters = obsBlock.reporters ?? {};
   const bridgeMetrics = reporters.bridgeMetrics ?? {};
   return {
-    appName: path16.basename(cwd),
+    appName: path18.basename(cwd),
     appModulePath,
     configPath,
     bridgeMetricsEnabled: bridgeMetrics.enabled === true
@@ -8314,7 +8651,7 @@ function localsToHygenArgs5(locals) {
 
 // src/cli/shared/auth-scaffold-locals.ts
 import crypto2 from "crypto";
-import path17 from "path";
+import path19 from "path";
 var FALLBACK_BACKEND_SRC3 = "src";
 var DEFAULT_REDIRECT_URI_BASE = "http://localhost:3000";
 function resolveAuthScaffoldLocals(input) {
@@ -8326,15 +8663,15 @@ function resolveAuthScaffoldLocals(input) {
   const redirectUriBase = typeof redirectRaw === "string" && redirectRaw.length > 0 ? redirectRaw : DEFAULT_REDIRECT_URI_BASE;
   const tokenEncryptionKey = crypto2.randomBytes(32).toString("base64");
   return {
-    appName: path17.basename(cwd),
-    configPath: path17.resolve(cwd, "codegen.config.yaml"),
-    schemaPath: path17.resolve(
+    appName: path19.basename(cwd),
+    configPath: path19.resolve(cwd, "codegen.config.yaml"),
+    schemaPath: path19.resolve(
       subsystemsRoot,
       "auth",
       "auth-oauth-state.schema.ts"
     ),
-    appModulePath: path17.resolve(cwd, backendSrc, "app.module.ts"),
-    envConfigPath: path17.resolve(cwd, ".env.config"),
+    appModulePath: path19.resolve(cwd, backendSrc, "app.module.ts"),
+    envConfigPath: path19.resolve(cwd, ".env.config"),
     redirectUriBase,
     tokenEncryptionKey
   };
@@ -8359,7 +8696,7 @@ function localsToHygenArgs6(locals) {
 }
 
 // src/cli/shared/auth-integrations-scaffold-locals.ts
-import path18 from "path";
+import path20 from "path";
 var FALLBACK_BACKEND_SRC4 = "src";
 var SHARED_DIR_NAME = "shared";
 var DEFAULT_MODULES_DIR = "modules";
@@ -8369,19 +8706,19 @@ function resolveAuthIntegrationsScaffoldLocals(input) {
   const backendSrc = typeof config?.paths?.backend_src === "string" && config.paths.backend_src.length > 0 ? config.paths.backend_src : FALLBACK_BACKEND_SRC4;
   const pathsAny = config?.paths;
   const sharedConfigured = pathsAny?.shared;
-  const sharedRoot = typeof sharedConfigured === "string" && sharedConfigured.length > 0 ? path18.resolve(cwd, sharedConfigured) : path18.resolve(cwd, backendSrc, SHARED_DIR_NAME);
+  const sharedRoot = typeof sharedConfigured === "string" && sharedConfigured.length > 0 ? path20.resolve(cwd, sharedConfigured) : path20.resolve(cwd, backendSrc, SHARED_DIR_NAME);
   const modulesConfigured = pathsAny?.modules_dir;
-  const vendorRoot = typeof modulesConfigured === "string" && modulesConfigured.length > 0 ? path18.resolve(cwd, modulesConfigured) : path18.resolve(cwd, backendSrc, DEFAULT_MODULES_DIR);
+  const vendorRoot = typeof modulesConfigured === "string" && modulesConfigured.length > 0 ? path20.resolve(cwd, modulesConfigured) : path20.resolve(cwd, backendSrc, DEFAULT_MODULES_DIR);
   const entitiesConfigured = typeof pathsAny?.entities === "string" && pathsAny.entities.length > 0 ? pathsAny.entities : typeof pathsAny?.entities_dir === "string" && pathsAny.entities_dir.length > 0 ? pathsAny.entities_dir : null;
-  const definitionsPath = entitiesConfigured !== null ? path18.resolve(cwd, entitiesConfigured, "integration.yaml") : path18.resolve(cwd, DEFAULT_DEFINITIONS_DIR, "integration.yaml");
-  const appModulePath = path18.resolve(cwd, backendSrc, "app.module.ts");
+  const definitionsPath = entitiesConfigured !== null ? path20.resolve(cwd, entitiesConfigured, "integration.yaml") : path20.resolve(cwd, DEFAULT_DEFINITIONS_DIR, "integration.yaml");
+  const appModulePath = path20.resolve(cwd, backendSrc, "app.module.ts");
   let authModuleRegistered = false;
   const appModuleSource = input.readFile(appModulePath);
   if (appModuleSource && appModuleSource.includes("AuthModule.forRoot")) {
     authModuleRegistered = true;
   }
   return {
-    appName: path18.basename(cwd),
+    appName: path20.basename(cwd),
     appModulePath,
     sharedRoot,
     vendorRoot,
@@ -8399,11 +8736,11 @@ function localsToHygenArgs7(locals) {
 }
 
 // src/cli/shared/runtime-copier.ts
-import fs8 from "fs";
-import path19 from "path";
+import fs10 from "fs";
+import path21 from "path";
 function readIfExists(p) {
   try {
-    return fs8.readFileSync(p, "utf-8");
+    return fs10.readFileSync(p, "utf-8");
   } catch {
     return null;
   }
@@ -8411,8 +8748,8 @@ function readIfExists(p) {
 function writeFile(target, content) {
   const existing = readIfExists(target);
   if (existing === content) return "unchanged";
-  fs8.mkdirSync(path19.dirname(target), { recursive: true });
-  fs8.writeFileSync(target, content);
+  fs10.mkdirSync(path21.dirname(target), { recursive: true });
+  fs10.writeFileSync(target, content);
   return existing === null ? "written" : "updated";
 }
 function extractRelativeImports(source) {
@@ -8425,20 +8762,20 @@ function extractRelativeImports(source) {
   return out;
 }
 function resolveSourceImport(sourceFile, specifier) {
-  const base = path19.resolve(path19.dirname(sourceFile), specifier);
-  const candidates = [base + ".ts", base + ".tsx", path19.join(base, "index.ts")];
+  const base = path21.resolve(path21.dirname(sourceFile), specifier);
+  const candidates = [base + ".ts", base + ".tsx", path21.join(base, "index.ts")];
   for (const c of candidates) {
-    if (fs8.existsSync(c)) return c;
+    if (fs10.existsSync(c)) return c;
   }
   return null;
 }
 async function copyRuntime(opts) {
   const { sourceDir, targetDir, filter, resolveDeps, dryRun } = opts;
-  if (!fs8.existsSync(sourceDir) || !fs8.statSync(sourceDir).isDirectory()) {
+  if (!fs10.existsSync(sourceDir) || !fs10.statSync(sourceDir).isDirectory()) {
     throw new Error(`runtime source directory not found: ${sourceDir}`);
   }
-  const runtimeRoot4 = opts.runtimeRoot ? path19.resolve(opts.runtimeRoot) : path19.resolve(sourceDir, "..", "..");
-  const depsTargetRoot = opts.depsTargetRoot ?? path19.resolve(targetDir, "..");
+  const runtimeRoot4 = opts.runtimeRoot ? path21.resolve(opts.runtimeRoot) : path21.resolve(sourceDir, "..", "..");
+  const depsTargetRoot = opts.depsTargetRoot ?? path21.resolve(targetDir, "..");
   const result = {
     written: [],
     updated: [],
@@ -8448,9 +8785,9 @@ async function copyRuntime(opts) {
   };
   const queue = [];
   function walk(dir) {
-    for (const entry of fs8.readdirSync(dir)) {
-      const src = path19.join(dir, entry);
-      const stat = fs8.statSync(src);
+    for (const entry of fs10.readdirSync(dir)) {
+      const src = path21.join(dir, entry);
+      const stat = fs10.statSync(src);
       if (stat.isDirectory()) {
         if (entry === "generated") continue;
         walk(src);
@@ -8458,9 +8795,9 @@ async function copyRuntime(opts) {
       }
       if (!stat.isFile()) continue;
       if (!entry.endsWith(".ts") && !entry.endsWith(".tsx")) continue;
-      const rel = path19.relative(sourceDir, src);
+      const rel = path21.relative(sourceDir, src);
       if (filter && !filter(rel) && !filter(entry)) continue;
-      queue.push({ src, dest: path19.join(targetDir, rel), isDep: false });
+      queue.push({ src, dest: path21.join(targetDir, rel), isDep: false });
     }
   }
   walk(sourceDir);
@@ -8469,7 +8806,7 @@ async function copyRuntime(opts) {
     const next = queue.shift();
     if (visited.has(next.src)) continue;
     visited.add(next.src);
-    const content = fs8.readFileSync(next.src, "utf-8");
+    const content = fs10.readFileSync(next.src, "utf-8");
     result.planned.push(next.dest);
     if (!dryRun) {
       const status = writeFile(next.dest, content);
@@ -8482,11 +8819,11 @@ async function copyRuntime(opts) {
       for (const spec of extractRelativeImports(content)) {
         const resolvedSrc = resolveSourceImport(next.src, spec);
         if (!resolvedSrc) continue;
-        const relToRuntime = path19.relative(runtimeRoot4, resolvedSrc);
-        if (relToRuntime.startsWith("..") || path19.isAbsolute(relToRuntime)) continue;
-        const relToSource = path19.relative(sourceDir, resolvedSrc);
-        if (!relToSource.startsWith("..") && !path19.isAbsolute(relToSource)) continue;
-        const depDest = path19.join(depsTargetRoot, relToRuntime);
+        const relToRuntime = path21.relative(runtimeRoot4, resolvedSrc);
+        if (relToRuntime.startsWith("..") || path21.isAbsolute(relToRuntime)) continue;
+        const relToSource = path21.relative(sourceDir, resolvedSrc);
+        if (!relToSource.startsWith("..") && !path21.isAbsolute(relToSource)) continue;
+        const depDest = path21.join(depsTargetRoot, relToRuntime);
         queue.push({ src: resolvedSrc, dest: depDest, isDep: true });
       }
     }
@@ -8494,196 +8831,15 @@ async function copyRuntime(opts) {
   return result;
 }
 
-// src/cli/shared/subsystem-detect.ts
-import fs9 from "fs";
-import path20 from "path";
-var SUBSYSTEMS = [
-  {
-    name: "events",
-    description: "Domain event bus (transactional outbox)",
-    backends: ["drizzle", "memory"],
-    defaultBackend: "drizzle"
-  },
-  {
-    name: "jobs",
-    description: "Background job queue",
-    backends: ["drizzle", "memory"],
-    defaultBackend: "drizzle"
-  },
-  {
-    name: "cache",
-    description: "Key-value cache with TTL",
-    backends: ["drizzle", "memory"],
-    defaultBackend: "drizzle"
-  },
-  {
-    name: "storage",
-    description: "File/object storage",
-    backends: ["local", "memory"],
-    defaultBackend: "local"
-  },
-  {
-    name: "sync",
-    description: "External-system sync engine (IChangeSource<T> + orchestrator + audit log)",
-    backends: ["drizzle", "memory"],
-    defaultBackend: "drizzle"
-  },
-  {
-    name: "bridge",
-    description: "Event-to-job bridge (durable async fanout via @JobHandler.triggers)",
-    backends: ["drizzle", "memory"],
-    defaultBackend: "drizzle"
-  },
-  {
-    // OPENAPI-4. "Config-only" pseudo-subsystem — the runtime helpers
-    // (OpenApiRegistry, ErrorResponseDto) are already vendored by
-    // `codegen project init`. Installing this subsystem just injects the
-    // `openapi:` block into codegen.config.yaml.
-    name: "openapi-config",
-    description: "OpenAPI/Swagger config block (registry is vendored at init)",
-    backends: ["config-only"],
-    defaultBackend: "config-only"
-  },
-  {
-    // OBS-7 / ADR-025. Combiner subsystem — no schema, no worker, no
-    // generated/ dir. `ObservabilityModule` composes sibling read ports
-    // (events/jobs/bridge/sync) via @Optional() DI. The `combiner`
-    // pseudo-backend is parallel to `openapi-config`'s `config-only`.
-    name: "observability",
-    description: "Observability combiner \u2014 composes sibling read ports via @Optional() DI (ADR-025)",
-    backends: ["combiner"],
-    defaultBackend: "combiner"
-  },
-  {
-    // #287. Auth subsystem (PR #289) — AuthModule + ports + OAuth state
-    // store + AuthController. Backends: drizzle (prod, persists OAuth
-    // state in `auth_oauth_state`) or memory (dev/tests). Detection in
-    // `detectInstalledSubsystems` is a special case: auth's protocols
-    // live under `protocols/`, not at the subsystem root, so we look
-    // for `auth.module.ts` instead of `*.protocol.ts`.
-    name: "auth",
-    description: "OAuth integration auth (AuthModule + ports + state store)",
-    backends: ["drizzle", "memory"],
-    defaultBackend: "drizzle"
-  },
-  {
-    // #287. Auth-integrations starter (PR #290) — vendored from
-    // `examples/auth-integrations/`, NOT from `runtime/subsystems/`.
-    // Bundles a canonical `integration` entity yaml + the three
-    // integration-store-port adapters + the `IntegrationsService`
-    // facade. Single-backend (drizzle); the runtime adapters call
-    // directly into the codegen-emitted `IntegrationService` from the
-    // entity layer. Detection: presence of
-    // `<sharedRoot>/integrations/integrations-auth.module.ts`.
-    name: "auth-integrations",
-    description: "Vendored integrations entity + adapters (consumes auth subsystem)",
-    backends: ["drizzle"],
-    defaultBackend: "drizzle"
-  }
-];
-var KNOWN_NAMES = SUBSYSTEMS.map((s) => s.name);
-function candidateRoots(cwd, configured) {
-  const roots = [
-    ...configured ? [path20.resolve(cwd, configured)] : [],
-    path20.resolve(cwd, "src/shared/subsystems"),
-    path20.resolve(cwd, "src/subsystems"),
-    path20.resolve(cwd, "shared/subsystems")
-  ];
-  return Array.from(new Set(roots));
-}
-function inferBackend(dir, name) {
-  if (name === "observability") return "combiner";
-  if (name === "auth") return "drizzle";
-  if (name === "auth-integrations") return "drizzle";
-  const hasDrizzle = fs9.existsSync(path20.join(dir, `${name.replace(/s$/, "")}-bus.drizzle-backend.ts`)) || fs9.readdirSync(dir).some((f) => f.endsWith(".drizzle-backend.ts"));
-  const hasMemory = fs9.readdirSync(dir).some((f) => f.endsWith(".memory-backend.ts"));
-  const hasLocal = fs9.readdirSync(dir).some((f) => f.includes("local"));
-  if (hasDrizzle && hasMemory) return "drizzle";
-  if (hasDrizzle) return "drizzle";
-  if (hasLocal) return "local";
-  if (hasMemory) return "memory";
-  return "unknown";
-}
-async function detectInstalledSubsystems(ctx) {
-  const configured = ctx.config?.paths?.subsystems;
-  const roots = candidateRoots(ctx.cwd, configured);
-  const found = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const root of roots) {
-    if (!fs9.existsSync(root)) continue;
-    for (const name of KNOWN_NAMES) {
-      if (seen.has(name)) continue;
-      if (name === "openapi-config") continue;
-      if (name === "auth-integrations") continue;
-      const dir = path20.join(root, name);
-      if (!fs9.existsSync(dir) || !fs9.statSync(dir).isDirectory()) continue;
-      const files = fs9.readdirSync(dir);
-      let hasProtocol = files.some((f) => f.endsWith(".protocol.ts"));
-      if (name === "auth") {
-        hasProtocol = files.includes("auth.module.ts");
-      }
-      if (!hasProtocol) continue;
-      seen.add(name);
-      found.push({
-        name,
-        path: dir,
-        backend: inferBackend(dir, name)
-      });
-    }
-  }
-  if (!seen.has("openapi-config")) {
-    const configPath = path20.resolve(
-      ctx.cwd,
-      ctx.config ? "codegen.config.yaml" : "codegen.config.yaml"
-    );
-    if (fs9.existsSync(configPath)) {
-      try {
-        const source = fs9.readFileSync(configPath, "utf-8");
-        if (/^openapi\s*:/m.test(source)) {
-          found.push({
-            name: "openapi-config",
-            path: configPath,
-            backend: "config-only"
-          });
-        }
-      } catch {
-      }
-    }
-  }
-  if (!seen.has("auth-integrations")) {
-    const backendSrc = ctx.config?.paths?.backend_src ?? "src";
-    const pathsAny = ctx.config?.paths;
-    const modulesConfigured = pathsAny?.modules_dir;
-    const vendorRoot = typeof modulesConfigured === "string" && modulesConfigured.length > 0 ? path20.resolve(ctx.cwd, modulesConfigured) : path20.resolve(ctx.cwd, backendSrc, "modules");
-    const sharedConfigured = pathsAny?.shared;
-    const sharedRoot = typeof sharedConfigured === "string" && sharedConfigured.length > 0 ? path20.resolve(ctx.cwd, sharedConfigured) : path20.resolve(ctx.cwd, backendSrc, "shared");
-    const candidates = [
-      path20.join(vendorRoot, "integrations", "integrations-auth.module.ts"),
-      path20.join(sharedRoot, "integrations", "integrations-auth.module.ts")
-    ];
-    for (const moduleFile of candidates) {
-      if (fs9.existsSync(moduleFile)) {
-        found.push({
-          name: "auth-integrations",
-          path: path20.dirname(moduleFile),
-          backend: "drizzle"
-        });
-        break;
-      }
-    }
-  }
-  return found;
-}
-
 // src/cli/commands/subsystem.ts
 function runtimeRoot() {
-  const pkgRoot = path21.resolve(import.meta.dirname, "..", "..", "..");
-  const topLevel = path21.join(pkgRoot, "runtime");
-  if (fs10.existsSync(topLevel)) return topLevel;
-  return path21.join(pkgRoot, "dist", "runtime");
+  const pkgRoot = path22.resolve(import.meta.dirname, "..", "..", "..");
+  const topLevel = path22.join(pkgRoot, "runtime");
+  if (fs11.existsSync(topLevel)) return topLevel;
+  return path22.join(pkgRoot, "dist", "runtime");
 }
 function subsystemSource(name) {
-  return path21.join(runtimeRoot(), "subsystems", name);
+  return path22.join(runtimeRoot(), "subsystems", name);
 }
 function describeSubsystem(name) {
   return SUBSYSTEMS.find((s) => s.name === name) ?? null;
@@ -8710,7 +8866,7 @@ async function summary2(ctx) {
   }
   body.push(theme.muted("Installed:"));
   for (const i of installed) {
-    const rel = path21.relative(ctx.cwd, i.path) || i.path;
+    const rel = path22.relative(ctx.cwd, i.path) || i.path;
     body.push(
       `  ${theme.success(icons.check)} ${i.name.padEnd(10)} ${theme.muted(
         `${i.backend} backend`
@@ -8848,14 +9004,14 @@ var SubsystemInstallCommand = class extends Command3 {
       return 0;
     }
     const targetRoot = resolveSubsystemsRoot(ctx, this.target);
-    const subsystemTarget = path21.join(targetRoot, desc3.name);
+    const subsystemTarget = path22.join(targetRoot, desc3.name);
     const source = subsystemSource(desc3.name);
-    if (!fs10.existsSync(source)) {
+    if (!fs11.existsSync(source)) {
       printError(`Runtime subsystem source missing: ${source}`);
       return 1;
     }
     if (!this.force) {
-      const gitCheck = checkGitSafety([path21.relative(ctx.cwd, subsystemTarget) || subsystemTarget], ctx.cwd);
+      const gitCheck = checkGitSafety([path22.relative(ctx.cwd, subsystemTarget) || subsystemTarget], ctx.cwd);
       if (gitCheck.inRepo && !gitCheck.clean) {
         printWarning(
           `Uncommitted changes under ${subsystemTarget}. Pass --force to overwrite.`
@@ -8864,7 +9020,7 @@ var SubsystemInstallCommand = class extends Command3 {
       }
     }
     if (!isJsonMode()) {
-      printInfo(`target = ${path21.relative(ctx.cwd, subsystemTarget) || subsystemTarget}`);
+      printInfo(`target = ${path22.relative(ctx.cwd, subsystemTarget) || subsystemTarget}`);
       printInfo(`backend = ${backend}`);
     }
     const result = await copyRuntime({
@@ -8873,7 +9029,7 @@ var SubsystemInstallCommand = class extends Command3 {
       filter: backendFileFilter(backend, desc3.name),
       resolveDeps: true,
       runtimeRoot: runtimeRoot(),
-      depsTargetRoot: path21.resolve(targetRoot, ".."),
+      depsTargetRoot: path22.resolve(targetRoot, ".."),
       dryRun: this.dryRun
     });
     const jobsScaffold = desc3.name === "jobs" ? runJobsScaffold(ctx.cwd, ctx.config, {
@@ -8968,14 +9124,14 @@ var SubsystemInstallCommand = class extends Command3 {
     if (this.dryRun) {
       printInfo(`Dry run \u2014 ${result.planned.length} files would be written`);
       for (const p of result.planned) {
-        console.log(`  ${theme.muted(icons.arrow)} ${path21.relative(ctx.cwd, p) || p}`);
+        console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`);
       }
       if (jobsScaffold?.planned?.length) {
         printInfo(
           `Jobs scaffold \u2014 ${jobsScaffold.planned.length} template targets`
         );
         for (const p of jobsScaffold.planned) {
-          console.log(`  ${theme.muted(icons.arrow)} ${path21.relative(ctx.cwd, p) || p}`);
+          console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`);
         }
       }
       if (eventsScaffold?.planned?.length) {
@@ -8983,7 +9139,7 @@ var SubsystemInstallCommand = class extends Command3 {
           `Events scaffold \u2014 ${eventsScaffold.planned.length} template targets`
         );
         for (const p of eventsScaffold.planned) {
-          console.log(`  ${theme.muted(icons.arrow)} ${path21.relative(ctx.cwd, p) || p}`);
+          console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`);
         }
       }
       if (syncScaffold?.planned?.length) {
@@ -8991,7 +9147,7 @@ var SubsystemInstallCommand = class extends Command3 {
           `Sync scaffold \u2014 ${syncScaffold.planned.length} template targets`
         );
         for (const p of syncScaffold.planned) {
-          console.log(`  ${theme.muted(icons.arrow)} ${path21.relative(ctx.cwd, p) || p}`);
+          console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`);
         }
       }
       if (bridgeScaffold?.planned?.length) {
@@ -8999,7 +9155,7 @@ var SubsystemInstallCommand = class extends Command3 {
           `Bridge scaffold \u2014 ${bridgeScaffold.planned.length} template targets`
         );
         for (const p of bridgeScaffold.planned) {
-          console.log(`  ${theme.muted(icons.arrow)} ${path21.relative(ctx.cwd, p) || p}`);
+          console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`);
         }
       }
       if (observabilityScaffold?.planned?.length) {
@@ -9007,7 +9163,7 @@ var SubsystemInstallCommand = class extends Command3 {
           `Observability scaffold \u2014 ${observabilityScaffold.planned.length} template targets`
         );
         for (const p of observabilityScaffold.planned) {
-          console.log(`  ${theme.muted(icons.arrow)} ${path21.relative(ctx.cwd, p) || p}`);
+          console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`);
         }
       }
       if (authScaffold?.planned?.length) {
@@ -9015,7 +9171,7 @@ var SubsystemInstallCommand = class extends Command3 {
           `Auth scaffold \u2014 ${authScaffold.planned.length} template targets`
         );
         for (const p of authScaffold.planned) {
-          console.log(`  ${theme.muted(icons.arrow)} ${path21.relative(ctx.cwd, p) || p}`);
+          console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`);
         }
       }
       return 0;
@@ -9094,6 +9250,13 @@ var SubsystemInstallCommand = class extends Command3 {
       }
     }
     printSuccess(`${desc3.name} subsystem installed with ${backend} backend.`);
+    try {
+      const generatedDir = resolveGeneratedDir(ctx);
+      await regenerateSubsystemBarrel({ ctx, generatedDir });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      printWarning(`subsystem barrel regeneration failed \u2014 ${msg}`);
+    }
     if (desc3.name === "observability") {
       printInfo(
         "Register `ObservabilityModule.forRoot()` AFTER Events/Jobs/Bridge/Sync in app.module.ts"
@@ -9128,7 +9291,7 @@ var SubsystemInstallCommand = class extends Command3 {
    * semantics as jobs/events/sync/bridge.
    */
   async executeOpenApiConfig(ctx) {
-    const configPath = path21.join(ctx.cwd, "codegen.config.yaml");
+    const configPath = path22.join(ctx.cwd, "codegen.config.yaml");
     const outcome = planConfigBlockAction(configPath, "openapi", this.forceConfig);
     if (outcome === "parse-error") {
       printError(
@@ -9147,7 +9310,7 @@ var SubsystemInstallCommand = class extends Command3 {
         });
       } else {
         printInfo(`Dry run \u2014 openapi config block would be ${outcome}`);
-        console.log(`  ${theme.muted(icons.arrow)} ${path21.relative(ctx.cwd, configPath) || configPath}`);
+        console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, configPath) || configPath}`);
       }
       return 0;
     }
@@ -9242,7 +9405,7 @@ var SubsystemInstallCommand = class extends Command3 {
       );
       for (const p of scaffold.planned) {
         console.log(
-          `  ${theme.muted(icons.arrow)} ${path21.relative(ctx.cwd, p) || p}`
+          `  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`
         );
       }
       return 0;
@@ -9266,10 +9429,10 @@ var SubsystemInstallCommand = class extends Command3 {
   }
 };
 function planConfigBlockAction(configPath, subsystem, forceConfig) {
-  if (!fs10.existsSync(configPath)) {
+  if (!fs11.existsSync(configPath)) {
     return "inject";
   }
-  const source = fs10.readFileSync(configPath, "utf-8");
+  const source = fs11.readFileSync(configPath, "utf-8");
   const state = detectConfigBlock(source, subsystem);
   if (state === "parse-error") return "parse-error";
   if (state === "missing") return "inject";
@@ -9292,9 +9455,9 @@ function runConfigBlockAction(input) {
         );
       }
       try {
-        const source = fs10.readFileSync(input.configPath, "utf-8");
+        const source = fs11.readFileSync(input.configPath, "utf-8");
         const stripped = stripConfigBlock(source, input.subsystem);
-        fs10.writeFileSync(input.configPath, stripped, "utf-8");
+        fs11.writeFileSync(input.configPath, stripped, "utf-8");
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         return { ok: false, error: `strip failed: ${message}` };
@@ -9332,8 +9495,8 @@ function runJobsScaffold(cwd, config, opts) {
   const locals = resolveJobsScaffoldLocals({
     cwd,
     config,
-    fileExists: (p) => fs10.existsSync(p),
-    readFile: (p) => fs10.existsSync(p) ? fs10.readFileSync(p, "utf-8") : null
+    fileExists: (p) => fs11.existsSync(p),
+    readFile: (p) => fs11.existsSync(p) ? fs11.readFileSync(p, "utf-8") : null
   });
   const planned = [
     ...!locals.workerExists ? [locals.workerPath] : [],
@@ -9390,7 +9553,7 @@ function runEventsScaffold(cwd, config, opts) {
   const locals = resolveEventsScaffoldLocals({
     cwd,
     config,
-    fileExists: (p) => fs10.existsSync(p)
+    fileExists: (p) => fs11.existsSync(p)
   });
   const planned = [
     locals.configPath,
@@ -9446,7 +9609,7 @@ function runSyncScaffold(cwd, config, opts) {
   const locals = resolveSyncScaffoldLocals({
     cwd,
     config,
-    fileExists: (p) => fs10.existsSync(p)
+    fileExists: (p) => fs11.existsSync(p)
   });
   const planned = [
     locals.configPath,
@@ -9501,7 +9664,7 @@ function runBridgeScaffold(cwd, config, opts) {
   const locals = resolveBridgeScaffoldLocals({
     cwd,
     config,
-    fileExists: (p) => fs10.existsSync(p)
+    fileExists: (p) => fs11.existsSync(p)
   });
   const planned = [
     locals.configPath,
@@ -9555,7 +9718,7 @@ function runObservabilityScaffold(cwd, config, opts) {
   const locals = resolveObservabilityScaffoldLocals({
     cwd,
     config,
-    fileExists: (p) => fs10.existsSync(p)
+    fileExists: (p) => fs11.existsSync(p)
   });
   const planned = [locals.configPath, locals.appModulePath];
   const configBlockOutcome = planConfigBlockAction(
@@ -9624,9 +9787,9 @@ function runAuthScaffold(cwd, config, opts) {
   if (opts.dryRun) {
     return { ok: true, planned, configBlockOutcome };
   }
-  if (!fs10.existsSync(locals.envConfigPath)) {
-    fs10.mkdirSync(path21.dirname(locals.envConfigPath), { recursive: true });
-    fs10.writeFileSync(locals.envConfigPath, "", "utf-8");
+  if (!fs11.existsSync(locals.envConfigPath)) {
+    fs11.mkdirSync(path22.dirname(locals.envConfigPath), { recursive: true });
+    fs11.writeFileSync(locals.envConfigPath, "", "utf-8");
   }
   const result = invokeHygen({
     generator: "subsystem",
@@ -9662,57 +9825,57 @@ function runAuthScaffold(cwd, config, opts) {
   return { ok: true, planned, configBlockOutcome };
 }
 function authIntegrationsExamplesRoot() {
-  const pkgRoot = path21.resolve(import.meta.dirname, "..", "..", "..");
-  const topLevel = path21.join(pkgRoot, "examples", "auth-integrations");
-  if (fs10.existsSync(topLevel)) return topLevel;
-  return path21.join(pkgRoot, "dist", "examples", "auth-integrations");
+  const pkgRoot = path22.resolve(import.meta.dirname, "..", "..", "..");
+  const topLevel = path22.join(pkgRoot, "examples", "auth-integrations");
+  if (fs11.existsSync(topLevel)) return topLevel;
+  return path22.join(pkgRoot, "dist", "examples", "auth-integrations");
 }
 function copyTreeIdempotent(srcDir, destDir, force, transform) {
   const written = [];
   const skipped = [];
   const walk = (src, dest) => {
-    const entries = fs10.readdirSync(src, { withFileTypes: true });
+    const entries = fs11.readdirSync(src, { withFileTypes: true });
     for (const entry of entries) {
-      const srcPath = path21.join(src, entry.name);
-      const destPath = path21.join(dest, entry.name);
+      const srcPath = path22.join(src, entry.name);
+      const destPath = path22.join(dest, entry.name);
       if (entry.isDirectory()) {
-        fs10.mkdirSync(destPath, { recursive: true });
+        fs11.mkdirSync(destPath, { recursive: true });
         walk(srcPath, destPath);
         continue;
       }
       if (!entry.isFile()) continue;
-      if (fs10.existsSync(destPath) && !force) {
+      if (fs11.existsSync(destPath) && !force) {
         skipped.push(destPath);
         continue;
       }
-      fs10.mkdirSync(path21.dirname(destPath), { recursive: true });
+      fs11.mkdirSync(path22.dirname(destPath), { recursive: true });
       const isTextSource = transform && (entry.name.endsWith(".ts") || entry.name.endsWith(".tsx"));
       if (isTextSource && transform) {
-        const raw = fs10.readFileSync(srcPath, "utf-8");
-        fs10.writeFileSync(destPath, transform(raw, destPath), "utf-8");
+        const raw = fs11.readFileSync(srcPath, "utf-8");
+        fs11.writeFileSync(destPath, transform(raw, destPath), "utf-8");
       } else {
-        fs10.copyFileSync(srcPath, destPath);
+        fs11.copyFileSync(srcPath, destPath);
       }
       written.push(destPath);
     }
   };
-  if (!fs10.existsSync(srcDir)) return { written, skipped };
-  fs10.mkdirSync(destDir, { recursive: true });
+  if (!fs11.existsSync(srcDir)) return { written, skipped };
+  fs11.mkdirSync(destDir, { recursive: true });
   walk(srcDir, destDir);
   return { written, skipped };
 }
 var AUTH_BARE_IMPORT_RE = /(['"])@pattern-stack\/codegen\/runtime\/subsystems\/auth\1/g;
 function buildAuthImportRewriter(subsystemsRoot) {
-  const authRoot = path21.join(subsystemsRoot, "auth");
+  const authRoot = path22.join(subsystemsRoot, "auth");
   return (content, destPath) => {
     if (!AUTH_BARE_IMPORT_RE.test(content)) {
       AUTH_BARE_IMPORT_RE.lastIndex = 0;
       return content;
     }
     AUTH_BARE_IMPORT_RE.lastIndex = 0;
-    let rel = path21.relative(path21.dirname(destPath), authRoot);
+    let rel = path22.relative(path22.dirname(destPath), authRoot);
     if (!rel.startsWith(".")) rel = `./${rel}`;
-    const relPosix = rel.split(path21.sep).join("/");
+    const relPosix = rel.split(path22.sep).join("/");
     return content.replace(
       AUTH_BARE_IMPORT_RE,
       (_match, quote) => `${quote}${relPosix}${quote}`
@@ -9723,20 +9886,20 @@ function runAuthIntegrationsScaffold(cwd, config, opts) {
   const locals = resolveAuthIntegrationsScaffoldLocals({
     cwd,
     config,
-    fileExists: (p) => fs10.existsSync(p),
-    readFile: (p) => fs10.existsSync(p) ? fs10.readFileSync(p, "utf-8") : null
+    fileExists: (p) => fs11.existsSync(p),
+    readFile: (p) => fs11.existsSync(p) ? fs11.readFileSync(p, "utf-8") : null
   });
   const examplesRoot = authIntegrationsExamplesRoot();
-  if (!fs10.existsSync(examplesRoot)) {
+  if (!fs11.existsSync(examplesRoot)) {
     return {
       ok: false,
       planned: [],
       error: `auth-integrations starter source missing: ${examplesRoot}`
     };
   }
-  const adaptersSrc = path21.join(examplesRoot, "runtime", "integrations");
-  const adaptersDest = path21.join(locals.vendorRoot, "integrations");
-  const integrationYamlSrc = path21.join(
+  const adaptersSrc = path22.join(examplesRoot, "runtime", "integrations");
+  const adaptersDest = path22.join(locals.vendorRoot, "integrations");
+  const integrationYamlSrc = path22.join(
     examplesRoot,
     "definitions",
     "entities",
@@ -9765,11 +9928,11 @@ function runAuthIntegrationsScaffold(cwd, config, opts) {
   let yamlWritten = false;
   let yamlSkipped = false;
   try {
-    if (fs10.existsSync(integrationYamlDest) && !opts.force) {
+    if (fs11.existsSync(integrationYamlDest) && !opts.force) {
       yamlSkipped = true;
-    } else if (fs10.existsSync(integrationYamlSrc)) {
-      fs10.mkdirSync(path21.dirname(integrationYamlDest), { recursive: true });
-      fs10.copyFileSync(integrationYamlSrc, integrationYamlDest);
+    } else if (fs11.existsSync(integrationYamlSrc)) {
+      fs11.mkdirSync(path22.dirname(integrationYamlDest), { recursive: true });
+      fs11.copyFileSync(integrationYamlSrc, integrationYamlDest);
       yamlWritten = true;
     }
   } catch (err) {
@@ -9834,7 +9997,7 @@ var SubsystemListCommand = class extends Command3 {
         name: s.name,
         status: inst ? "installed" : "available",
         backend: inst ? inst.backend : null,
-        path: inst ? path21.relative(ctx.cwd, inst.path) || inst.path : null
+        path: inst ? path22.relative(ctx.cwd, inst.path) || inst.path : null
       };
     });
     if (isJsonMode()) {
@@ -9894,28 +10057,28 @@ var subsystemNoun = {
 var subsystem_default = subsystemNoun;
 
 // src/cli/commands/project.ts
-import fs13 from "fs";
-import path24 from "path";
+import fs14 from "fs";
+import path25 from "path";
 import readline from "readline";
 import { Command as Command5, Option as Option5 } from "clipanion";
 import { stringify as stringifyYaml2 } from "yaml";
 
 // src/cli/shared/init-scaffold.ts
-import fs11 from "fs";
-import path22 from "path";
+import fs12 from "fs";
+import path23 from "path";
 import { stringify as stringifyYaml } from "yaml";
 function runtimeRoot2() {
-  const pkgRoot = path22.resolve(import.meta.dirname, "..", "..", "..");
-  const topLevel = path22.join(pkgRoot, "runtime");
-  if (fs11.existsSync(topLevel)) return topLevel;
-  return path22.join(pkgRoot, "dist", "runtime");
+  const pkgRoot = path23.resolve(import.meta.dirname, "..", "..", "..");
+  const topLevel = path23.join(pkgRoot, "runtime");
+  if (fs12.existsSync(topLevel)) return topLevel;
+  return path23.join(pkgRoot, "dist", "runtime");
 }
 function resolveRuntimePath(cwd) {
-  const shimDir = path22.join(cwd, "src", "shared", "base-classes");
-  return path22.relative(shimDir, runtimeRoot2());
+  const shimDir = path23.join(cwd, "src", "shared", "base-classes");
+  return path23.relative(shimDir, runtimeRoot2());
 }
 function loadRuntimeFile(relPath2) {
-  return fs11.readFileSync(path22.join(runtimeRoot2(), relPath2), "utf-8");
+  return fs12.readFileSync(path23.join(runtimeRoot2(), relPath2), "utf-8");
 }
 var VENDORED_RUNTIME_FILES = [
   // base-classes — consumer-facing inheritance targets
@@ -10312,10 +10475,10 @@ function mergeTsconfig(raw) {
   };
 }
 function relOf(cwd, abs) {
-  return path22.relative(cwd, abs) || abs;
+  return path23.relative(cwd, abs) || abs;
 }
 function fileEntry(cwd, absPath, content, opts) {
-  const exists = fs11.existsSync(absPath);
+  const exists = fs12.existsSync(absPath);
   let action;
   let reason = opts.skipReason;
   if (!exists) {
@@ -10330,7 +10493,7 @@ function fileEntry(cwd, absPath, content, opts) {
   return { path: absPath, relPath: relOf(cwd, absPath), action, content, reason };
 }
 function dirEntry(cwd, absPath) {
-  const exists = fs11.existsSync(absPath);
+  const exists = fs12.existsSync(absPath);
   return {
     path: absPath,
     relPath: relOf(cwd, absPath),
@@ -10362,7 +10525,7 @@ async function buildInitPlan(ctx, options) {
   const runtimePath = options.runtimePath ?? resolveRuntimePath(cwd);
   const entries = [];
   {
-    const configPath = path22.join(cwd, "codegen.config.yaml");
+    const configPath = path23.join(cwd, "codegen.config.yaml");
     const config = {
       paths: {
         backend_src: "src",
@@ -10392,9 +10555,9 @@ async function buildInitPlan(ctx, options) {
     entries.push(fileEntry(cwd, configPath, content, { force }));
   }
   {
-    const tsconfigPath = path22.join(cwd, "tsconfig.json");
-    if (fs11.existsSync(tsconfigPath)) {
-      const raw = fs11.readFileSync(tsconfigPath, "utf-8");
+    const tsconfigPath = path23.join(cwd, "tsconfig.json");
+    if (fs12.existsSync(tsconfigPath)) {
+      const raw = fs12.readFileSync(tsconfigPath, "utf-8");
       const merged = mergeTsconfig(raw);
       if (merged.parseError) {
         entries.push({
@@ -10439,20 +10602,20 @@ async function buildInitPlan(ctx, options) {
   entries.push(
     fileEntry(
       cwd,
-      path22.join(cwd, "src", "shared", "database", "database.module.ts"),
+      path23.join(cwd, "src", "shared", "database", "database.module.ts"),
       databaseModuleContent(),
       { force }
     )
   );
   for (const v of VENDORED_RUNTIME_FILES) {
     entries.push(
-      fileEntry(cwd, path22.join(cwd, v.target), loadRuntimeFile(v.runtime), { force })
+      fileEntry(cwd, path23.join(cwd, v.target), loadRuntimeFile(v.runtime), { force })
     );
   }
   entries.push(
     fileEntry(
       cwd,
-      path22.join(cwd, "src", "generated", "modules.ts"),
+      path23.join(cwd, "src", "generated", "modules.ts"),
       emptyModulesBarrel(),
       { force }
     )
@@ -10460,14 +10623,14 @@ async function buildInitPlan(ctx, options) {
   entries.push(
     fileEntry(
       cwd,
-      path22.join(cwd, "src", "generated", "schema.ts"),
+      path23.join(cwd, "src", "generated", "schema.ts"),
       emptySchemaBarrel(),
       { force }
     )
   );
   {
-    const appModulePath = path22.join(cwd, "src", "app.module.ts");
-    if (!fs11.existsSync(appModulePath)) {
+    const appModulePath = path23.join(cwd, "src", "app.module.ts");
+    if (!fs12.existsSync(appModulePath)) {
       entries.push({
         path: appModulePath,
         relPath: relOf(cwd, appModulePath),
@@ -10484,8 +10647,8 @@ async function buildInitPlan(ctx, options) {
     }
   }
   {
-    const mainPath = path22.join(cwd, "src", "main.ts");
-    if (!fs11.existsSync(mainPath)) {
+    const mainPath = path23.join(cwd, "src", "main.ts");
+    if (!fs12.existsSync(mainPath)) {
       entries.push({
         path: mainPath,
         relPath: relOf(cwd, mainPath),
@@ -10502,8 +10665,8 @@ async function buildInitPlan(ctx, options) {
     }
   }
   {
-    const schemaPath = path22.join(cwd, "src", "schema.ts");
-    if (!fs11.existsSync(schemaPath)) {
+    const schemaPath = path23.join(cwd, "src", "schema.ts");
+    if (!fs12.existsSync(schemaPath)) {
       entries.push({
         path: schemaPath,
         relPath: relOf(cwd, schemaPath),
@@ -10519,14 +10682,14 @@ async function buildInitPlan(ctx, options) {
       });
     }
   }
-  entries.push(dirEntry(cwd, path22.join(cwd, "entities")));
+  entries.push(dirEntry(cwd, path23.join(cwd, "entities")));
   {
-    const entitiesDir = path22.join(cwd, "entities");
-    const examplePath = path22.join(entitiesDir, "example.yaml");
-    const hasOtherYamls = fs11.existsSync(entitiesDir) && fs11.readdirSync(entitiesDir).some(
+    const entitiesDir = path23.join(cwd, "entities");
+    const examplePath = path23.join(entitiesDir, "example.yaml");
+    const hasOtherYamls = fs12.existsSync(entitiesDir) && fs12.readdirSync(entitiesDir).some(
       (f) => (f.endsWith(".yaml") || f.endsWith(".yml")) && f !== "example.yaml"
     );
-    if (fs11.existsSync(examplePath)) {
+    if (fs12.existsSync(examplePath)) {
       entries.push({
         path: examplePath,
         relPath: relOf(cwd, examplePath),
@@ -10572,7 +10735,7 @@ function writePlan(plan) {
       continue;
     }
     if (e.directory) {
-      fs11.mkdirSync(e.path, { recursive: true });
+      fs12.mkdirSync(e.path, { recursive: true });
       created.push(e);
       continue;
     }
@@ -10580,8 +10743,8 @@ function writePlan(plan) {
       skipped.push(e);
       continue;
     }
-    fs11.mkdirSync(path22.dirname(e.path), { recursive: true });
-    fs11.writeFileSync(e.path, e.content, "utf-8");
+    fs12.mkdirSync(path23.dirname(e.path), { recursive: true });
+    fs12.writeFileSync(e.path, e.content, "utf-8");
     if (e.action === "create") created.push(e);
     else if (e.action === "merge") merged.push(e);
     else if (e.action === "overwrite") overwritten.push(e);
@@ -10590,8 +10753,8 @@ function writePlan(plan) {
 }
 
 // src/cli/commands/project-upgrade-openapi.ts
-import fs12 from "fs";
-import path23 from "path";
+import fs13 from "fs";
+import path24 from "path";
 import { Command as Command4, Option as Option4 } from "clipanion";
 import { Project, IndentationText, QuoteKind, NewLineKind } from "ts-morph";
 
@@ -10830,35 +10993,35 @@ var MAIN_SWAGGER_IMPORTS = [
   "import { OPENAPI_REGISTRY, OpenApiRegistry } from './shared/openapi';"
 ];
 function runtimeRoot3() {
-  const pkgRoot = path23.resolve(import.meta.dirname, "..", "..", "..");
-  const topLevel = path23.join(pkgRoot, "runtime");
-  if (fs12.existsSync(topLevel)) return topLevel;
-  return path23.join(pkgRoot, "dist", "runtime");
+  const pkgRoot = path24.resolve(import.meta.dirname, "..", "..", "..");
+  const topLevel = path24.join(pkgRoot, "runtime");
+  if (fs13.existsSync(topLevel)) return topLevel;
+  return path24.join(pkgRoot, "dist", "runtime");
 }
 function loadRuntimeFile2(rel) {
-  return fs12.readFileSync(path23.join(runtimeRoot3(), rel), "utf-8");
+  return fs13.readFileSync(path24.join(runtimeRoot3(), rel), "utf-8");
 }
 function resolveProjectRoot(startDir) {
-  let dir = path23.resolve(startDir);
+  let dir = path24.resolve(startDir);
   for (let i = 0; i < 16; i++) {
-    if (fs12.existsSync(path23.join(dir, "codegen.config.yaml")) || fs12.existsSync(path23.join(dir, "package.json"))) {
+    if (fs13.existsSync(path24.join(dir, "codegen.config.yaml")) || fs13.existsSync(path24.join(dir, "package.json"))) {
       return dir;
     }
-    const parent = path23.dirname(dir);
+    const parent = path24.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return path23.resolve(startDir);
+  return path24.resolve(startDir);
 }
 async function runUpgradeOpenapi(opts) {
   const { projectRoot, dryRun, force } = opts;
   const changes = [];
   for (const v of OPENAPI_VENDORED_FILES) {
-    const target = path23.join(projectRoot, v.target);
-    const exists = fs12.existsSync(target);
+    const target = path24.join(projectRoot, v.target);
+    const exists = fs13.existsSync(target);
     const newContent = loadRuntimeFile2(v.runtime);
     if (exists && !force) {
-      const existing = fs12.readFileSync(target, "utf-8");
+      const existing = fs13.readFileSync(target, "utf-8");
       if (existing === newContent) {
         changes.push({ path: v.target, action: "unchanged" });
       } else {
@@ -10870,8 +11033,8 @@ async function runUpgradeOpenapi(opts) {
       }
     } else {
       if (!dryRun) {
-        fs12.mkdirSync(path23.dirname(target), { recursive: true });
-        fs12.writeFileSync(target, newContent);
+        fs13.mkdirSync(path24.dirname(target), { recursive: true });
+        fs13.writeFileSync(target, newContent);
       }
       changes.push({
         path: v.target,
@@ -10879,8 +11042,8 @@ async function runUpgradeOpenapi(opts) {
       });
     }
   }
-  const appModulePath = path23.join(projectRoot, "src", "app.module.ts");
-  if (!fs12.existsSync(appModulePath)) {
+  const appModulePath = path24.join(projectRoot, "src", "app.module.ts");
+  if (!fs13.existsSync(appModulePath)) {
     return {
       projectRoot,
       changes,
@@ -10963,8 +11126,8 @@ async function runUpgradeOpenapi(opts) {
   } else {
     changes.push({ path: "src/app.module.ts", action: "unchanged" });
   }
-  const mainPath = path23.join(projectRoot, "src", "main.ts");
-  if (fs12.existsSync(mainPath)) {
+  const mainPath = path24.join(projectRoot, "src", "main.ts");
+  if (fs13.existsSync(mainPath)) {
     const mainSource = project.addSourceFileAtPath(mainPath);
     const mainBefore = mainSource.getFullText();
     const result = ensureMainSwaggerBlock(mainSource, {
@@ -11044,8 +11207,8 @@ var ProjectUpgradeOpenapiCommand = class extends Command4 {
   json = Option4.Boolean("--json", false);
   async execute() {
     if (this.json) setJsonMode(true);
-    const startDir = this.pathOpt ? path23.resolve(this.pathOpt) : process.cwd();
-    if (!fs12.existsSync(startDir)) {
+    const startDir = this.pathOpt ? path24.resolve(this.pathOpt) : process.cwd();
+    if (!fs13.existsSync(startDir)) {
       printError(`Directory not found: ${startDir}`);
       return 1;
     }
@@ -11329,9 +11492,9 @@ var ProjectScanCommand = class extends Command5 {
   cwd = Option5.String("--cwd", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
-    const baseCwd = this.cwd ? path24.resolve(this.cwd) : process.cwd();
-    const target = this.directory ? path24.resolve(baseCwd, this.directory) : baseCwd;
-    if (!fs13.existsSync(target)) {
+    const baseCwd = this.cwd ? path25.resolve(this.cwd) : process.cwd();
+    const target = this.directory ? path25.resolve(baseCwd, this.directory) : baseCwd;
+    if (!fs14.existsSync(target)) {
       printError(`Directory not found: ${target}`);
       return 1;
     }
@@ -11381,8 +11544,8 @@ var ProjectScanCommand = class extends Command5 {
         `architecture: ${profile.architecture.evidence.join(", ") || "\u2014"}`
       ]);
     }
-    const outPath = path24.join(target, "codegen.config.yaml");
-    const existsNow = fs13.existsSync(outPath);
+    const outPath = path25.join(target, "codegen.config.yaml");
+    const existsNow = fs14.existsSync(outPath);
     if (this.dryRun) {
       console.log("");
       printInfo("Dry run \u2014 proposed codegen.config.yaml:");
@@ -11395,7 +11558,7 @@ var ProjectScanCommand = class extends Command5 {
         printWarning(`${outPath} already exists \u2014 pass --force via edit; skipping.`);
         return 0;
       }
-      fs13.writeFileSync(outPath, yamlText);
+      fs14.writeFileSync(outPath, yamlText);
       printSuccess(`wrote ${outPath}`);
       return 0;
     }
@@ -11502,12 +11665,12 @@ var ProjectInspectCommand = class extends Command5 {
     return 2;
   }
   resolveEntitiesDir(ctx) {
-    if (this.dir) return path24.resolve(ctx.cwd, this.dir);
-    return ctx.entitiesDir ?? path24.resolve(ctx.cwd, "entities");
+    if (this.dir) return path25.resolve(ctx.cwd, this.dir);
+    return ctx.entitiesDir ?? path25.resolve(ctx.cwd, "entities");
   }
   async runAnalysis(ctx, kind) {
     const entitiesDir = this.resolveEntitiesDir(ctx);
-    if (!entitiesDir || !fs13.existsSync(entitiesDir)) {
+    if (!entitiesDir || !fs14.existsSync(entitiesDir)) {
       printError(`Directory not found: ${entitiesDir ?? "(no entities/ dir)"}`);
       return 1;
     }
@@ -11537,7 +11700,7 @@ var ProjectInspectCommand = class extends Command5 {
       out = formatConsole(filtered);
     }
     if (this.output) {
-      fs13.writeFileSync(this.output, out);
+      fs14.writeFileSync(this.output, out);
       if (!isJsonMode()) printSuccess(`wrote ${this.output}`);
     } else {
       console.log(out);
@@ -11550,7 +11713,7 @@ var ProjectInspectCommand = class extends Command5 {
   }
   async runManifest(ctx) {
     const entitiesDir = this.resolveEntitiesDir(ctx);
-    if (!entitiesDir || !fs13.existsSync(entitiesDir)) {
+    if (!entitiesDir || !fs14.existsSync(entitiesDir)) {
       printError(`Directory not found: ${entitiesDir ?? "(no entities/ dir)"}`);
       return 1;
     }
@@ -11706,17 +11869,17 @@ var ProjectGraphCommand = class extends Command5 {
       json: this.json,
       skipDetection: true
     });
-    const entitiesDir = this.dir ? path24.resolve(ctx.cwd, this.dir) : ctx.entitiesDir ?? path24.resolve(ctx.cwd, "entities");
-    if (!fs13.existsSync(entitiesDir)) {
+    const entitiesDir = this.dir ? path25.resolve(ctx.cwd, this.dir) : ctx.entitiesDir ?? path25.resolve(ctx.cwd, "entities");
+    if (!fs14.existsSync(entitiesDir)) {
       printError(`Entity directory not found: ${entitiesDir}`);
       return 1;
     }
     const relCandidates = [
-      path24.resolve(path24.dirname(entitiesDir), "relationships"),
-      path24.resolve(entitiesDir, "relationships"),
-      path24.resolve(ctx.cwd, "relationships")
+      path25.resolve(path25.dirname(entitiesDir), "relationships"),
+      path25.resolve(entitiesDir, "relationships"),
+      path25.resolve(ctx.cwd, "relationships")
     ];
-    const relationshipsDir = relCandidates.find((d) => fs13.existsSync(d));
+    const relationshipsDir = relCandidates.find((d) => fs14.existsSync(d));
     const result = await analyzeDomain(entitiesDir, relationshipsDir);
     const serialized = serializeDomainGraph(result.graph);
     if (isJsonMode()) {
@@ -11730,20 +11893,20 @@ var ProjectGraphCommand = class extends Command5 {
       return 0;
     }
     if (this.output) {
-      const outPath = path24.resolve(ctx.cwd, this.output);
-      fs13.writeFileSync(outPath, JSON.stringify(serialized, null, 2));
+      const outPath = path25.resolve(ctx.cwd, this.output);
+      fs14.writeFileSync(outPath, JSON.stringify(serialized, null, 2));
       printSuccess(`Graph written to ${outPath}`);
       printInfo(`${result.entities.length} entities, ${result.relationshipDefinitions.length} relationships, ${result.graph.edges.length} edges`);
       return 0;
     }
     const os = await import("os");
-    const tmpDir = fs13.mkdtempSync(path24.join(os.default.tmpdir(), "codegen-graph-"));
-    const graphPath = path24.join(tmpDir, "graph.json");
-    fs13.writeFileSync(graphPath, JSON.stringify(serialized, null, 2));
-    const viewerDir = path24.resolve(import.meta.dirname, "..", "..", "..", "tools", "schema-graph-viewer");
-    const viewerDist = path24.join(viewerDir, "dist", "index.html");
-    if (fs13.existsSync(viewerDist)) {
-      fs13.copyFileSync(graphPath, path24.join(viewerDir, "dist", "graph.json"));
+    const tmpDir = fs14.mkdtempSync(path25.join(os.default.tmpdir(), "codegen-graph-"));
+    const graphPath = path25.join(tmpDir, "graph.json");
+    fs14.writeFileSync(graphPath, JSON.stringify(serialized, null, 2));
+    const viewerDir = path25.resolve(import.meta.dirname, "..", "..", "..", "tools", "schema-graph-viewer");
+    const viewerDist = path25.join(viewerDir, "dist", "index.html");
+    if (fs14.existsSync(viewerDist)) {
+      fs14.copyFileSync(graphPath, path25.join(viewerDir, "dist", "graph.json"));
       printSuccess("Graph exported");
       printInfo(`${result.entities.length} entities, ${result.relationshipDefinitions.length} relationships, ${result.graph.edges.length} edges`);
       printInfo(`Graph JSON: ${graphPath}`);
@@ -11773,8 +11936,8 @@ var projectNoun = {
 var project_default = projectNoun;
 
 // src/cli/commands/dev.ts
-import fs14 from "fs";
-import path25 from "path";
+import fs15 from "fs";
+import path26 from "path";
 import { execSync as execSync3, spawn, spawnSync } from "child_process";
 import { Command as Command6, Option as Option6 } from "clipanion";
 var DEFAULT_APP_PORT = 3e3;
@@ -11807,33 +11970,33 @@ function getRedisPort(_ctx) {
   return Number(process.env.DEV_REDIS_PORT ?? DEFAULT_REDIS_PORT);
 }
 function composeFilePath(cwd) {
-  const devPath = path25.join(cwd, COMPOSE_FILE);
-  if (fs14.existsSync(devPath)) return devPath;
-  const rootPath = path25.join(cwd, "docker-compose.yml");
-  if (fs14.existsSync(rootPath)) return rootPath;
+  const devPath = path26.join(cwd, COMPOSE_FILE);
+  if (fs15.existsSync(devPath)) return devPath;
+  const rootPath = path26.join(cwd, "docker-compose.yml");
+  if (fs15.existsSync(rootPath)) return rootPath;
   return devPath;
 }
 function pidFilePath(cwd) {
-  return path25.join(cwd, PID_FILE);
+  return path26.join(cwd, PID_FILE);
 }
 function readAppPid(cwd) {
   const p = pidFilePath(cwd);
-  if (!fs14.existsSync(p)) return null;
-  const pid = parseInt(fs14.readFileSync(p, "utf-8").trim(), 10);
+  if (!fs15.existsSync(p)) return null;
+  const pid = parseInt(fs15.readFileSync(p, "utf-8").trim(), 10);
   if (isNaN(pid)) return null;
   try {
     process.kill(pid, 0);
     return pid;
   } catch {
-    fs14.rmSync(p, { force: true });
+    fs15.rmSync(p, { force: true });
     return null;
   }
 }
 function writeAppPid(cwd, pid) {
-  fs14.writeFileSync(pidFilePath(cwd), String(pid));
+  fs15.writeFileSync(pidFilePath(cwd), String(pid));
 }
 function clearAppPid(cwd) {
-  fs14.rmSync(pidFilePath(cwd), { force: true });
+  fs15.rmSync(pidFilePath(cwd), { force: true });
 }
 function checkPostgres(cwd, port) {
   const r = runCmd(`docker exec codegen-dev-postgres pg_isready -U postgres`, cwd, {
@@ -11873,8 +12036,8 @@ function checkApp(cwd, port) {
   };
 }
 function listEntityNames(ctx) {
-  if (!ctx.entitiesDir || !fs14.existsSync(ctx.entitiesDir)) return [];
-  return fs14.readdirSync(ctx.entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => f.replace(/\.ya?ml$/, ""));
+  if (!ctx.entitiesDir || !fs15.existsSync(ctx.entitiesDir)) return [];
+  return fs15.readdirSync(ctx.entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => f.replace(/\.ya?ml$/, ""));
 }
 function formatServiceLine(svc) {
   const icon = svc.healthy ? theme.success(icons.check) : theme.error(icons.error);
@@ -11883,8 +12046,8 @@ function formatServiceLine(svc) {
   return `${icon} ${svc.name.padEnd(12)}  ${theme.muted(`${svc.host}:${svc.port}`)}    ${status}${pidStr}`;
 }
 function ensureComposeFile(cwd, pgPort, redisPort) {
-  const composePath = path25.join(cwd, COMPOSE_FILE);
-  if (fs14.existsSync(composePath)) return composePath;
+  const composePath = path26.join(cwd, COMPOSE_FILE);
+  if (fs15.existsSync(composePath)) return composePath;
   const content = `# Auto-generated by codegen dev
 # Ports offset from defaults to avoid conflicts with other local services.
 services:
@@ -11919,7 +12082,7 @@ services:
 volumes:
   codegen-dev-pgdata:
 `;
-  fs14.writeFileSync(composePath, content);
+  fs15.writeFileSync(composePath, content);
   return composePath;
 }
 var DevUpCommand = class extends Command6 {
@@ -11968,7 +12131,7 @@ var DevUpCommand = class extends Command6 {
     if (!pgReady) printWarning("postgres did not become healthy in time");
     if (!redisReady) printWarning("redis did not become healthy in time");
     const drizzleConfig = ["drizzle.config.ts", "drizzle.config.js"].find(
-      (f) => fs14.existsSync(path25.join(ctx.cwd, f))
+      (f) => fs15.existsSync(path26.join(ctx.cwd, f))
     );
     if (drizzleConfig) {
       if (!isJsonMode()) printInfo("pushing database schema...");
@@ -11988,8 +12151,8 @@ var DevUpCommand = class extends Command6 {
         if (!isJsonMode()) printInfo("starting NestJS app...");
         const dbUrl = `postgres://postgres:postgres@localhost:${pgPort}/codegen_dev`;
         const redisUrl = `redis://localhost:${redisPort}`;
-        const logFile = path25.join(ctx.cwd, ".dev-app.log");
-        const logFd = fs14.openSync(logFile, "a");
+        const logFile = path26.join(ctx.cwd, ".dev-app.log");
+        const logFd = fs15.openSync(logFile, "a");
         const child = spawn("bun", ["src/main.ts"], {
           cwd: ctx.cwd,
           detached: true,
@@ -12002,7 +12165,7 @@ var DevUpCommand = class extends Command6 {
           }
         });
         child.unref();
-        fs14.closeSync(logFd);
+        fs15.closeSync(logFd);
         if (child.pid) {
           writeAppPid(ctx.cwd, child.pid);
           spawnSync("sleep", ["2"]);
@@ -12146,8 +12309,8 @@ var DevLogsCommand = class extends Command6 {
       }
       return 0;
     }
-    const logFile = path25.join(ctx.cwd, ".dev-app.log");
-    if (!fs14.existsSync(logFile)) {
+    const logFile = path26.join(ctx.cwd, ".dev-app.log");
+    if (!fs15.existsSync(logFile)) {
       printInfo("no app logs found \u2014 is the app running?");
       return 0;
     }
@@ -12190,8 +12353,8 @@ var DevRestartCommand = class extends Command6 {
     spawnSync("sleep", ["1"]);
     const dbUrl = `postgres://postgres:postgres@localhost:${pgPort}/codegen_dev`;
     const redisUrl = `redis://localhost:${redisPort}`;
-    const logFile = path25.join(ctx.cwd, ".dev-app.log");
-    const logFd = fs14.openSync(logFile, "a");
+    const logFile = path26.join(ctx.cwd, ".dev-app.log");
+    const logFd = fs15.openSync(logFile, "a");
     const child = spawn("bun", ["src/main.ts"], {
       cwd: ctx.cwd,
       detached: true,
@@ -12204,7 +12367,7 @@ var DevRestartCommand = class extends Command6 {
       }
     });
     child.unref();
-    fs14.closeSync(logFd);
+    fs15.closeSync(logFd);
     if (child.pid) {
       writeAppPid(ctx.cwd, child.pid);
       spawnSync("sleep", ["2"]);
@@ -12319,15 +12482,15 @@ var devNoun = {
 var dev_default = devNoun;
 
 // src/cli/commands/relationship.ts
-import fs15 from "fs";
-import path26 from "path";
+import fs16 from "fs";
+import path27 from "path";
 import { Command as Command7, Option as Option7 } from "clipanion";
 function listRelationshipYamls2(dir) {
-  if (!fs15.existsSync(dir)) return [];
-  return fs15.readdirSync(dir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).filter((f) => {
-    const fullPath = path26.join(dir, f);
+  if (!fs16.existsSync(dir)) return [];
+  return fs16.readdirSync(dir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).filter((f) => {
+    const fullPath = path27.join(dir, f);
     return detectYamlType(fullPath) === "relationship";
-  }).map((f) => path26.join(dir, f));
+  }).map((f) => path27.join(dir, f));
 }
 function summarizeRelationshipFile(filePath) {
   const result = loadRelationshipFromYaml(filePath);
@@ -12348,7 +12511,7 @@ function padRight2(s, n) {
   return s.length >= n ? s : s + " ".repeat(n - s.length);
 }
 async function summary5(ctx) {
-  const relDir = path26.resolve(ctx.cwd, "relationships");
+  const relDir = path27.resolve(ctx.cwd, "relationships");
   const files = listRelationshipYamls2(relDir);
   if (files.length === 0) {
     return {
@@ -12418,14 +12581,14 @@ var RelationshipNewCommand = class extends Command7 {
     }
     let targets = [];
     if (this.all) {
-      const dir = path26.resolve(ctx.cwd, "relationships");
+      const dir = path27.resolve(ctx.cwd, "relationships");
       targets = listRelationshipYamls2(dir);
       if (targets.length === 0) {
         printError(`No relationship YAML files found in ${dir}`);
         return 1;
       }
     } else if (this.yaml) {
-      targets = [path26.resolve(ctx.cwd, this.yaml)];
+      targets = [path27.resolve(ctx.cwd, this.yaml)];
     } else {
       printError("Missing YAML path. Pass a file or --all.");
       return 2;
@@ -12442,7 +12605,7 @@ var RelationshipNewCommand = class extends Command7 {
     }
     if (invalid.length > 0) {
       for (const i of invalid) {
-        printError(`${path26.basename(i.file)} \u2014 ${i.message}`);
+        printError(`${path27.basename(i.file)} \u2014 ${i.message}`);
       }
       if (!isJsonMode()) return 1;
     }
@@ -12473,7 +12636,7 @@ var RelationshipNewCommand = class extends Command7 {
     }
     const succeeded = [];
     const failed = [
-      ...invalid.map((i) => ({ name: path26.basename(i.file), file: i.file, message: i.message }))
+      ...invalid.map((i) => ({ name: path27.basename(i.file), file: i.file, message: i.message }))
     ];
     for (const v of validated) {
       if (!isJsonMode()) {
@@ -12492,8 +12655,8 @@ var RelationshipNewCommand = class extends Command7 {
         if (!isJsonMode()) printError(`${v.name} \u2014 ${res.stderr ?? "failed"}`);
       }
     }
-    const entitiesDir = ctx.entitiesDir ?? path26.resolve(ctx.cwd, "entities");
-    const relationshipsDir = path26.resolve(ctx.cwd, "relationships");
+    const entitiesDir = ctx.entitiesDir ?? path27.resolve(ctx.cwd, "entities");
+    const relationshipsDir = path27.resolve(ctx.cwd, "relationships");
     const generatedDir = resolveGeneratedDir(ctx);
     const architecture = resolveArchitecture(ctx);
     let barrelResult = null;
@@ -12538,7 +12701,7 @@ var RelationshipNewCommand = class extends Command7 {
       }
       if (barrelResult) {
         printInfo(
-          `barrels regenerated (${barrelResult.entityCount} modules) \u2192 ${path26.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path26.relative(ctx.cwd, barrelResult.schemaBarrel)}`
+          `barrels regenerated (${barrelResult.entityCount} modules) \u2192 ${path27.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path27.relative(ctx.cwd, barrelResult.schemaBarrel)}`
         );
       }
     }
@@ -12561,7 +12724,7 @@ var RelationshipListCommand = class extends Command7 {
       json: this.json,
       skipDetection: true
     });
-    const relDir = path26.resolve(ctx.cwd, "relationships");
+    const relDir = path27.resolve(ctx.cwd, "relationships");
     const files = listRelationshipYamls2(relDir);
     if (files.length === 0) {
       printInfo("No relationship definitions found.");
@@ -12601,7 +12764,7 @@ var relationshipNoun = {
 var relationship_default = relationshipNoun;
 
 // src/cli/commands/junction.ts
-import path27 from "path";
+import path28 from "path";
 import { Command as Command8, Option as Option8 } from "clipanion";
 function summarizeJunctionFile(filePath) {
   const result = loadJunctionFromYaml(filePath);
@@ -12624,7 +12787,7 @@ function padRight3(s, n) {
   return s.length >= n ? s : s + " ".repeat(n - s.length);
 }
 async function summary6(ctx) {
-  const junctionDir = path27.resolve(ctx.cwd, "junctions");
+  const junctionDir = path28.resolve(ctx.cwd, "junctions");
   const files = listJunctionYamls(junctionDir);
   if (files.length === 0) {
     return {
@@ -12694,14 +12857,14 @@ var JunctionNewCommand = class extends Command8 {
     }
     let targets = [];
     if (this.all) {
-      const dir = path27.resolve(ctx.cwd, "junctions");
+      const dir = path28.resolve(ctx.cwd, "junctions");
       targets = listJunctionYamls(dir);
       if (targets.length === 0) {
         printError(`No junction YAML files found in ${dir}`);
         return 1;
       }
     } else if (this.yaml) {
-      targets = [path27.resolve(ctx.cwd, this.yaml)];
+      targets = [path28.resolve(ctx.cwd, this.yaml)];
     } else {
       printError("Missing YAML path. Pass a file or --all.");
       return 2;
@@ -12720,7 +12883,7 @@ var JunctionNewCommand = class extends Command8 {
     }
     if (invalid.length > 0) {
       for (const i of invalid) {
-        printError(`${path27.basename(i.file)} \u2014 ${i.message}`);
+        printError(`${path28.basename(i.file)} \u2014 ${i.message}`);
       }
       if (!isJsonMode()) return 1;
     }
@@ -12751,7 +12914,7 @@ var JunctionNewCommand = class extends Command8 {
     }
     const succeeded = [];
     const failed = [
-      ...invalid.map((i) => ({ name: path27.basename(i.file), file: i.file, message: i.message }))
+      ...invalid.map((i) => ({ name: path28.basename(i.file), file: i.file, message: i.message }))
     ];
     for (const v of validated) {
       if (!isJsonMode()) {
@@ -12770,9 +12933,9 @@ var JunctionNewCommand = class extends Command8 {
         if (!isJsonMode()) printError(`${v.name} \u2014 ${res.stderr ?? "failed"}`);
       }
     }
-    const entitiesDir = ctx.entitiesDir ?? path27.resolve(ctx.cwd, "entities");
-    const relationshipsDir = path27.resolve(ctx.cwd, "relationships");
-    const junctionsDir = path27.resolve(ctx.cwd, "junctions");
+    const entitiesDir = ctx.entitiesDir ?? path28.resolve(ctx.cwd, "entities");
+    const relationshipsDir = path28.resolve(ctx.cwd, "relationships");
+    const junctionsDir = path28.resolve(ctx.cwd, "junctions");
     const generatedDir = resolveGeneratedDir(ctx);
     const architecture = resolveArchitecture(ctx);
     let barrelResult = null;
@@ -12818,7 +12981,7 @@ var JunctionNewCommand = class extends Command8 {
       }
       if (barrelResult) {
         printInfo(
-          `barrels regenerated (${barrelResult.entityCount} modules) \u2192 ${path27.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path27.relative(ctx.cwd, barrelResult.schemaBarrel)}`
+          `barrels regenerated (${barrelResult.entityCount} modules) \u2192 ${path28.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path28.relative(ctx.cwd, barrelResult.schemaBarrel)}`
         );
       }
     }
@@ -12841,7 +13004,7 @@ var JunctionListCommand = class extends Command8 {
       json: this.json,
       skipDetection: true
     });
-    const junctionDir = path27.resolve(ctx.cwd, "junctions");
+    const junctionDir = path28.resolve(ctx.cwd, "junctions");
     const files = listJunctionYamls(junctionDir);
     if (files.length === 0) {
       printInfo("No junction definitions found.");
@@ -12881,8 +13044,8 @@ var junctionNoun = {
 var junction_default = junctionNoun;
 
 // src/cli/commands/events.ts
-import fs16 from "fs";
-import path28 from "path";
+import fs17 from "fs";
+import path29 from "path";
 import ts2 from "typescript";
 import { Command as Command9, Option as Option9 } from "clipanion";
 function scanSourceFileForConsumers(sourceFile, filePath, eventType) {
@@ -12981,7 +13144,7 @@ function scanDirectoryForConsumers(rootDir, eventType) {
   const tier1 = [];
   let hasEventFlowImport = false;
   for (const filePath of files) {
-    const text2 = fs16.readFileSync(filePath, "utf8");
+    const text2 = fs17.readFileSync(filePath, "utf8");
     const sourceFile = ts2.createSourceFile(
       filePath,
       text2,
@@ -13018,7 +13181,7 @@ function suggestEventTypes(target, known, limit = 3) {
   return known.map((t) => ({ t, d: levenshtein(target, t) })).sort((a, b) => a.d - b.d).slice(0, limit).map((x) => x.t);
 }
 function renderConsumerReport(result, cwd) {
-  const rel = (p) => path28.relative(cwd, p) || p;
+  const rel = (p) => path29.relative(cwd, p) || p;
   const lines = [];
   const total = result.tier3.length + result.tier2.length + result.tier1.length;
   lines.push(`Event: ${result.eventType}`);
@@ -13054,7 +13217,7 @@ function renderConsumerReport(result, cwd) {
   return lines;
 }
 function runConsumersScan(opts) {
-  const scanRoot = opts.scanRoot ?? path28.join(opts.cwd, "src");
+  const scanRoot = opts.scanRoot ?? path29.join(opts.cwd, "src");
   const handlersDir = opts.handlersDir ?? scanRoot;
   const allTriggers = scanHandlerFiles(handlersDir);
   const tier3 = allTriggers.filter((t) => t.event === opts.eventType).map((t) => ({
@@ -13063,8 +13226,8 @@ function runConsumersScan(opts) {
     sourceFile: t.sourceFile,
     sourceLine: t.sourceLine
   }));
-  const tier21 = fs16.existsSync(scanRoot) ? scanDirectoryForConsumers(scanRoot, opts.eventType) : { tier2: [], tier1: [], hasEventFlowImport: false };
-  const eventsGeneratedDir = opts.eventsGeneratedDir ?? path28.join(
+  const tier21 = fs17.existsSync(scanRoot) ? scanDirectoryForConsumers(scanRoot, opts.eventType) : { tier2: [], tier1: [], hasEventFlowImport: false };
+  const eventsGeneratedDir = opts.eventsGeneratedDir ?? path29.join(
     resolveSubsystemsRootFromContext(opts.cwd, opts.config),
     "events",
     "generated"
@@ -13085,11 +13248,11 @@ function runConsumersScan(opts) {
 function resolveSubsystemsRootFromContext(cwd, config) {
   const configured = config?.paths?.subsystems;
   if (typeof configured === "string" && configured.length > 0) {
-    return path28.resolve(cwd, configured);
+    return path29.resolve(cwd, configured);
   }
   const backendSrc = config?.paths?.backend_src;
   const base = typeof backendSrc === "string" && backendSrc.length > 0 ? backendSrc : "src";
-  return path28.resolve(cwd, base, "shared", "subsystems");
+  return path29.resolve(cwd, base, "shared", "subsystems");
 }
 var EventsConsumersCommand = class extends Command9 {
   static paths = [["events", "consumers"]];
@@ -13178,7 +13341,7 @@ var eventsNoun = {
 var events_default = eventsNoun;
 
 // src/cli/commands/orchestration.ts
-import path29 from "path";
+import path30 from "path";
 import { Command as Command10, Option as Option10 } from "clipanion";
 var DEFAULT_PATTERN_GLOBS = ["src/patterns/*.pattern.ts"];
 function resolvePatternGlobs(ctx) {
@@ -13192,10 +13355,10 @@ function resolveOrchestrationOutputRoot(ctx) {
   const paths = ctx.config?.paths;
   const explicit = paths?.orchestration_src;
   if (typeof explicit === "string" && explicit.length > 0) {
-    return path29.resolve(ctx.cwd, explicit);
+    return path30.resolve(ctx.cwd, explicit);
   }
   const backendSrc = typeof paths?.backend_src === "string" && paths.backend_src.length > 0 ? paths.backend_src : "app/backend/src";
-  return path29.resolve(ctx.cwd, backendSrc, "orchestration");
+  return path30.resolve(ctx.cwd, backendSrc, "orchestration");
 }
 async function reloadRegistry(ctx) {
   _resetRegistryForTests({ includeLibrary: false });
@@ -13284,12 +13447,12 @@ var OrchestrationGenCommand = class extends Command10 {
         );
         for (const f of result.files) {
           console.log(
-            `  ${theme.muted(icons.arrow)} ${path29.relative(ctx.cwd, f.outputPath)}`
+            `  ${theme.muted(icons.arrow)} ${path30.relative(ctx.cwd, f.outputPath)}`
           );
         }
       } else {
         printSuccess(
-          `Emitted ${result.files.length} file(s) across ${targets.length} pattern(s) \u2192 ${path29.relative(ctx.cwd, outputRoot)}`
+          `Emitted ${result.files.length} file(s) across ${targets.length} pattern(s) \u2192 ${path30.relative(ctx.cwd, outputRoot)}`
         );
       }
       return 0;