@pattern-stack/codegen 0.23.0 → 0.25.0

package/dist/src/cli/index.js

@@ -44,13 +44,13 @@ import {
   validateOrchestrationProject,
   validateProviders,
   writeManifest
-} from "../../chunk-4M66MQYA.js";
+} from "../../chunk-K4BQQ2NN.js";
 import "../../chunk-KVOWSC5S.js";
-import "../../chunk-QFUIE37H.js";
-import "../../chunk-FFUDEIFF.js";
-import "../../chunk-EO2QPOKH.js";
 import "../../chunk-PRWIX6UW.js";
-import "../../chunk-O2A6XHGD.js";
+import "../../chunk-KFXXOFDC.js";
+import "../../chunk-HN5HT5WL.js";
+import "../../chunk-EO2QPOKH.js";
+import "../../chunk-LLDJS7PJ.js";
 import "../../chunk-HNWZFNKP.js";
 import "../../chunk-AHV4GDYM.js";
 import "../../chunk-SQDOBLBP.js";
@@ -63,8 +63,8 @@ import {
 } from "../../chunk-5TK7MEN4.js";
 import "../../chunk-4KNXX6TI.js";
 import "../../chunk-3CJFPU6Q.js";
-import "../../chunk-TDEHU73T.js";
-import "../../chunk-S7C6TIIF.js";
+import "../../chunk-YIVQ7KLS.js";
+import "../../chunk-S5G3HO7N.js";
 import "../../chunk-MZ6GV4YF.js";
 import "../../chunk-LG57S2SC.js";
 import "../../chunk-U64T4YZE.js";
@@ -2151,7 +2151,7 @@ function loadEvents(eventsDir, entityNames) {
 function desugarEntityEvents(entity) {
   const entityName = entity.entity.name;
   const entityEvents = entity.events ?? [];
-  return entityEvents.map((ev) => {
+  const explicit = entityEvents.map((ev) => {
     const payload = {};
     for (const [key, typeString] of Object.entries(ev.body)) {
       if (!isEventFieldType(typeString)) {
@@ -2173,6 +2173,56 @@ function desugarEntityEvents(entity) {
     };
     return def;
   });
+  const changeTriad = desugarEmitChangeEvents(entity);
+  return [...explicit, ...changeTriad];
+}
+var EMIT_CHANGE_SUFFIXES = ["created", "edited", "deleted"];
+function desugarEmitChangeEvents(entity) {
+  if (entity.integration?.sink?.emit_changes !== true) return [];
+  const entityName = entity.entity.name;
+  const basePayload = {
+    entity_id: {
+      type: "uuid",
+      nullable: false,
+      description: "Local aggregate id the sink wrote/soft-deleted."
+    },
+    external_id: {
+      type: "string",
+      nullable: false,
+      description: "Vendor external id the change keyed on."
+    },
+    provider: {
+      type: "string",
+      nullable: false,
+      description: "Provider label (e.g. 'slack', 'google')."
+    },
+    source: {
+      type: "string",
+      nullable: false,
+      description: "Provenance marker \u2014 always 'integration'. A write-back action reads this to avoid echoing the change back to the vendor."
+    }
+  };
+  return EMIT_CHANGE_SUFFIXES.map((suffix) => {
+    const payload = { ...basePayload };
+    if (suffix !== "deleted") {
+      payload.changed_fields = {
+        type: "json",
+        nullable: true,
+        description: "Differ's per-field before/after map (same value as integration_run_items.changed_fields)."
+      };
+    }
+    const def = {
+      type: `${entityName}_${suffix}`,
+      tier: "domain",
+      direction: "change",
+      aggregate: entityName,
+      payload,
+      retry: { attempts: 3, backoff: "exponential" },
+      version: 1,
+      pool: DIRECTION_TO_POOL.change
+    };
+    return def;
+  });
 }
 function isEventFieldType(s) {
   return EVENT_FIELD_TYPES.includes(s);
@@ -3696,6 +3746,97 @@ import {
 } from "fs";
 import { dirname, join as join8 } from "path";
 
+// src/cli/shared/change-emitter-emission-generator.ts
+function generatedBanner(sourceDesc) {
+  return `// @generated by @pattern-stack/codegen from ${sourceDesc} \u2014 DO NOT EDIT.
+// Hand edits are overwritten on re-emit. Regenerate with \`bun run codegen\`.`;
+}
+function changeEmitterClass(entityClass) {
+  return `${entityClass}ChangeEmitter`;
+}
+function generateChangeEmitter(input) {
+  const mode = input.mode ?? "package";
+  const cls = changeEmitterClass(input.entityClass);
+  const eventsImport = subsystemsImport(mode, "events");
+  const integrationImport = subsystemsImport(mode, "integration");
+  const createdType = `${input.entityName}_created`;
+  const editedType = `${input.entityName}_edited`;
+  const deletedType = `${input.entityName}_deleted`;
+  return `${generatedBanner(input.sourceDesc)}
+import { Inject, Injectable } from '@nestjs/common';
+import { TYPED_EVENT_BUS } from '${eventsImport}';
+import type {
+  IIntegrationChangeEmitter,
+  IntegrationChangeNotification,
+} from '${integrationImport}';
+
+/**
+ * Minimal publisher shape the emitter calls \u2014 decoupled from BOTH the package's
+ * \`TypedEventBus\` (whose \`EventTypeName\` union is the package's own events) and
+ * the consumer's generated \`TypedEventBus\` (whose union is the consumer's
+ * events). The \`${createdType}\` / \`${editedType}\` / \`${deletedType}\` events
+ * THIS class publishes live in the CONSUMER's registry; the structural \`publish\`
+ * here accepts the string types without depending on either compile-time union.
+ * The TYPED_EVENT_BUS token resolves to the consumer's generated bus at runtime
+ * (bound by EventsModule.forRoot()), which validates the payload against the
+ * generated event schema.
+ */
+interface ChangeEventPublisher {
+  publish(
+    type: string,
+    aggregateId: string,
+    payload: Record<string, unknown>,
+    opts?: { tx?: unknown; metadata?: Record<string, unknown> },
+  ): Promise<void>;
+}
+
+/**
+ * ${cls} \u2014 publishes the typed ${input.entityName} data-level change events
+ * (\`${createdType}\` / \`${editedType}\` / \`${deletedType}\`) after the
+ * integration orchestrator's sink write/soft-delete (EMIT-CHANGES seam).
+ *
+ * Bound to INTEGRATION_CHANGE_EMITTER in the ${input.entityName} integration
+ * assembly; the orchestrator calls \`emitChange\` once per real change. The
+ * payload carries \`source: 'integration'\` so a write-back action can detect an
+ * integration-originated change and decline to echo it back to the vendor.
+ */
+@Injectable()
+export class ${cls} implements IIntegrationChangeEmitter {
+  constructor(
+    @Inject(TYPED_EVENT_BUS) private readonly bus: ChangeEventPublisher,
+  ) {}
+
+  async emitChange(notification: IntegrationChangeNotification): Promise<void> {
+    const type =
+      notification.action === 'created'
+        ? '${createdType}'
+        : notification.action === 'updated'
+          ? '${editedType}'
+          : '${deletedType}';
+
+    const payload: Record<string, unknown> = {
+      entityId: notification.entityId,
+      externalId: notification.externalId,
+      provider: notification.provider,
+      source: 'integration',
+    };
+    // changedFields is present on created/edited only (deletes are tombstones).
+    if (notification.changedFields !== undefined) {
+      payload['changedFields'] = notification.changedFields;
+    }
+
+    await this.bus.publish(type, notification.entityId, payload, {
+      tx: notification.tx,
+      metadata:
+        notification.tenantId !== undefined && notification.tenantId !== null
+          ? { tenantId: notification.tenantId }
+          : undefined,
+    });
+  }
+}
+`;
+}
+
 // src/cli/shared/sink-emission-generator.ts
 var USER_ID_FIELD = "userId";
 function sinkNames(entityClass) {
@@ -3916,7 +4057,7 @@ export class ${n.sinkClass} extends ${n.sinkBaseClass} {
 
 // src/cli/shared/assembly-emission-generator.ts
 import { relative, resolve as resolve2, sep } from "path";
-function generatedBanner(sourceDesc) {
+function generatedBanner2(sourceDesc) {
   return `// @generated by @pattern-stack/codegen from ${sourceDesc} \u2014 DO NOT EDIT.
 // Hand edits are overwritten on re-emit. Regenerate with \`bun run codegen\`.`;
 }
@@ -3947,19 +4088,30 @@ function generateAssemblyModule(input) {
   const token = integrationUseCaseToken(input.entityName, input.provider);
   const moduleClass = assemblyModuleClass(input.entityName, input.provider);
   const tokensImport = `../../${input.surface}-integration.tokens`;
-  return `${generatedBanner(input.sourceDesc)}
+  const emitChanges = input.emitChanges === true;
+  const emitterClass = changeEmitterClass(input.entityClass);
+  const emitterImport = `../../sinks/${input.entityName}.change-emitter`;
+  const integrationTokenImports = emitChanges ? `  INTEGRATION_CHANGE_EMITTER,
+  INTEGRATION_CHANGE_SOURCE,
+  INTEGRATION_SINK,` : `  INTEGRATION_CHANGE_SOURCE,
+  INTEGRATION_SINK,`;
+  const emitterImportLine = emitChanges ? `
+import { ${emitterClass} } from '${emitterImport}';` : "";
+  const emitterProviderBlock = emitChanges ? `
+    ${emitterClass},
+    { provide: INTEGRATION_CHANGE_EMITTER, useExisting: ${emitterClass} },` : "";
+  return `${generatedBanner2(input.sourceDesc)}
 import { Module } from '@nestjs/common';
 import {
   ExecuteIntegrationUseCase,
-  INTEGRATION_CHANGE_SOURCE,
-  INTEGRATION_SINK,
+${integrationTokenImports}
 } from '${subsystemsImport(input.mode ?? "package", "integration")}';
 import { ${adapterClass} } from '${adapterImport}';
 import { ${adapterModuleClass} } from '${adapterModuleImport}';
 import { ${sinkClass} } from '${sinkImport}';
 import { ${input.repoClass} } from '${input.repoImportSpecifier}';
 import { ${input.moduleClass} } from '${input.moduleImportSpecifier}';
-import { ${token} } from '${tokensImport}';
+import { ${token} } from '${tokensImport}';${emitterImportLine}
 
 /**
  * ${moduleClass} \u2014 the ${input.surface}/${input.entityName} \u2190 ${input.provider}
@@ -3969,7 +4121,12 @@ import { ${token} } from '${tokensImport}';
  * \`changeSources.${input.entityName}\` and INTEGRATION_SINK from
  * ${sinkClass}, provides a local ExecuteIntegrationUseCase, and aliases+exports
  * it under ${token} (the bare class token is ambiguous at app root \u2014 every
- * assembly provides it). The substrate (cursor store, run recorder, differ,
+ * assembly provides it).${emitChanges ? `
+ *
+ * EMIT-CHANGES: binds INTEGRATION_CHANGE_EMITTER to ${emitterClass} so the
+ * orchestrator publishes typed ${input.entityName}_created/_edited/_deleted events
+ * after every sink write/soft-delete (integration.sink.emit_changes).
+ *` : ""} The substrate (cursor store, run recorder, differ,
  * multi-tenant flag) comes from the global IntegrationModule.forRoot(...) in
  * AppModule, never re-bound here.
  */
@@ -3985,7 +4142,7 @@ import { ${token} } from '${tokensImport}';
       provide: INTEGRATION_SINK,
       useFactory: (repo: ${input.repoClass}) => new ${sinkClass}(repo, '${input.provider}'),
       inject: [${input.repoClass}],
-    },
+    },${emitterProviderBlock}
     ExecuteIntegrationUseCase,
     { provide: ${token}, useExisting: ExecuteIntegrationUseCase },
   ],
@@ -4005,7 +4162,7 @@ function generateIntegrationTokens(surface, entries) {
  *  (${assemblyModuleClass(e.entityName, e.provider)}). A trigger grabs this to run it. */
 export const ${token} = Symbol.for('${key}');`;
   }).join("\n\n");
-  return `${generatedBanner(`surface: ${surface}`)}
+  return `${generatedBanner2(`surface: ${surface}`)}
 /**
  * Use-case handles for the \`${surface}\` surface \u2014 one per (entity, provider)
  * assembly. Each is a Symbol \`provide:\` token a per-entity
@@ -4031,7 +4188,7 @@ function generateIntegrationAggregator(surface, entries) {
     return `import { ${cls} } from '${path36}';`;
   }).join("\n");
   const membersInline = moduleClasses.join(", ");
-  return `${generatedBanner(`surface: ${surface}`)}
+  return `${generatedBanner2(`surface: ${surface}`)}
 import { Module } from '@nestjs/common';
 ${importLines || "// no (entity, provider) integration assemblies on this surface yet"}
 
@@ -4184,7 +4341,7 @@ function isClientlessProvider(surfaces) {
   return surfaces.length > 0 && surfaces.every((s) => SURFACE_REGISTRY[s]?.readPrimitive === true);
 }
 var SCAFFOLD_SENTINEL = "// <CODEGEN-SCAFFOLD-V1>";
-function generatedBanner2(sourceDesc) {
+function generatedBanner3(sourceDesc) {
   return `// @generated by @pattern-stack/codegen from ${sourceDesc} \u2014 DO NOT EDIT.
 // Hand edits are overwritten on re-emit. Regenerate with \`bun run codegen\`.`;
 }
@@ -4424,7 +4581,7 @@ ${changeSourcesDecl}
 }
 function generateAdapterModule(def, surface) {
   const n = names(def.slug, surface);
-  return `${generatedBanner2(`definitions/providers/${def.slug}.yaml (surface: ${surface})`)}
+  return `${generatedBanner3(`definitions/providers/${def.slug}.yaml (surface: ${surface})`)}
 import { Module } from '@nestjs/common';
 import { ${n.providerModuleClass} } from '../../../providers/${def.slug}/${def.slug}.provider.module';
 import { ${n.adapterClass} } from './${def.slug}-${surface}.adapter';
@@ -4442,13 +4599,13 @@ function generateAdaptersBarrel(surface, providerSlugs) {
     const n = names(slug, surface);
     return `export { ${n.adapterModuleClass} } from './${slug}/${slug}-${surface}.adapter.module';`;
   }).join("\n");
-  return `${generatedBanner2(`definitions/providers/*.yaml (surface: ${surface})`)}
+  return `${generatedBanner3(`definitions/providers/*.yaml (surface: ${surface})`)}
 ${lines}
 `;
 }
 function generateSurfaceTokens(surface, mode = "package") {
   const n = names("__placeholder__", surface);
-  return `${generatedBanner2(`surface: ${surface}`)}
+  return `${generatedBanner3(`surface: ${surface}`)}
 import type { IChangeSource } from '${subsystemsImport(mode, "integration")}';
 
 /** The assembled list of every ${surface} adapter's contribution. */
@@ -4487,7 +4644,7 @@ function generateSurfaceAggregator(surface, providerSlugs, mode = "package") {
     return `${lowerFirst(p.adapterClass)}: ${p.adapterClass}`;
   }).join(", ");
   const injectTokens = per.map((p) => p.adapterClass).join(", ");
-  return `${generatedBanner2(`surface: ${surface}`)}
+  return `${generatedBanner3(`surface: ${surface}`)}
 import { Module } from '@nestjs/common';
 import {
   MemoryEntityChangeSourceRegistry,
@@ -4559,7 +4716,7 @@ function generateTypedView(surface, providerSlugs, entities) {
   const providerUnion = slugs.length ? slugs.map((s) => `'${s}'`).join(" | ") : "never";
   const entityUnion = ents.length ? ents.map((e) => `'${e}'`).join(" | ") : "never";
   const mapEntries = slugs.map((s) => `  ${jsKey(s)}: ${surfacePascal}Entity;`).join("\n");
-  return `${generatedBanner2(`surface: ${surface}`)}
+  return `${generatedBanner3(`surface: ${surface}`)}
 /**
  * Per-consumer typed view for the \`${surface}\` surface. Surface-scoped unions
  * + a (provider, entity) validity map for compile-time-checked consumer
@@ -4589,6 +4746,7 @@ function emitAdapters(opts) {
     scaffoldsSkipped: [],
     skippedSurfaces: [],
     assembliesWritten: [],
+    changeEmittersWritten: [],
     tokensWritten: [],
     integrationAggregatorsWritten: [],
     skippedAssemblies: []
@@ -4702,6 +4860,19 @@ function emitAdapters(opts) {
           if (!opts.dryRun) writeFile(subclassPath, subclassContent);
           result.scaffoldsWritten.push(subclassPath);
         }
+        const emitChanges = def?.integration?.sink?.emit_changes === true;
+        if (emitChanges) {
+          const emitterPath = join8(sinksDir, `${entityName}.change-emitter.ts`);
+          const emitterContent = generateChangeEmitter({
+            entityName,
+            entityClass: loc.entityClass,
+            surface,
+            sourceDesc: `definitions entity '${entityName}' (integration.sink.emit_changes)`,
+            mode
+          });
+          if (!opts.dryRun) writeIfChanged(emitterPath, emitterContent);
+          result.changeEmittersWritten.push(emitterPath);
+        }
         for (const slug of slugs) {
           const assemblyPath = join8(
             modulesDir,
@@ -4718,7 +4889,8 @@ function emitAdapters(opts) {
             repoImportSpecifier: loc.repoImportSpecifier,
             repoClass: loc.repoClass,
             sourceDesc: `definitions/providers/${slug}.yaml`,
-            mode
+            mode,
+            emitChanges
           });
           if (!opts.dryRun) writeIfChanged(assemblyPath, assemblyContent);
           result.assembliesWritten.push(assemblyPath);
@@ -5052,12 +5224,12 @@ function resolveSyncMode(entity, config) {
 // src/emitters/frontend/emit-utils.ts
 import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
 import { dirname as dirname3 } from "path";
-function generatedBanner3(sourceDesc) {
+function generatedBanner4(sourceDesc) {
   return `// @generated by @pattern-stack/codegen from ${sourceDesc} \u2014 DO NOT EDIT.
 // Hand edits are overwritten on re-emit. Regenerate with \`bun run codegen\`.`;
 }
 function withBanner(sourceDesc, body) {
-  return `${generatedBanner3(sourceDesc)}
+  return `${generatedBanner4(sourceDesc)}
 
 ${body}`;
 }
@@ -6893,6 +7065,11 @@ var EntityNewCommand = class extends Command2 {
               `integration assembly codegen: ${adapterResult.assembliesWritten.length} module(s) + ${adapterResult.tokensWritten.length} tokens file(s) + ${adapterResult.integrationAggregatorsWritten.length} aggregator(s)`
             );
           }
+          if (adapterResult.changeEmittersWritten.length) {
+            printInfo(
+              `integration change-emitters (emit_changes): ${adapterResult.changeEmittersWritten.length} emitter(s)`
+            );
+          }
           for (const s of adapterResult.scaffoldsSkipped) {
             printInfo(`skipped scaffold ${s} (author-owned)`);
           }
@@ -7231,7 +7408,7 @@ function resolveJobsScaffoldLocals(input) {
   const { cwd, config, fileExists, readFile } = input;
   const jobsBlock = config?.jobs ?? {};
   const subsystemsRoot = resolveSubsystemsRootFromConfig(cwd, config);
-  const workerPath = path16.resolve(cwd, "worker.ts");
+  const workerPath = path16.resolve(cwd, "src", "worker.ts");
   const mainTsPath = path16.resolve(cwd, "src/main.ts");
   const configPath = path16.resolve(cwd, "codegen.config.yaml");
   const schemaPath = path16.resolve(
@@ -7249,10 +7426,37 @@ function resolveJobsScaffoldLocals(input) {
     configPath,
     workerExists: fileExists(workerPath),
     workerPath,
+    jobWorkerModuleImport: resolveJobWorkerModuleImport(config),
+    workerForRootOpts: resolveWorkerForRootOpts(jobsBlock),
     schemaPath,
-    mainHookInjected
+    mainHookInjected,
+    // #517 — in package mode the schema ships in the package (consumed via the
+    // schema barrel), so the template is skipped; vendored mode renders it.
+    skipSchema: resolveRuntimeMode(config) === "package"
   };
 }
+function resolveJobWorkerModuleImport(config) {
+  return runtimeImport(resolveRuntimeMode(config), "subsystems/jobs/index");
+}
+function resolveWorkerForRootOpts(jobsBlock) {
+  const backend = jobsBlock.backend ?? "drizzle";
+  const parts = [`mode: 'standalone'`];
+  if (backend === "bullmq") {
+    parts.push(`backend: 'bullmq'`);
+    const bullExt = jobsBlock.extensions?.bullmq;
+    if (bullExt) {
+      parts.push(`domainModuleExtensions: { bullmq: ${jsonToTs(bullExt)} }`);
+    }
+  } else {
+    const workerExtClause = drizzleExtensionsClause(
+      drizzleJobsExtensions(backend, jobsBlock),
+      "domainModuleExtensions"
+    );
+    if (workerExtClause) parts.push(workerExtClause);
+  }
+  parts.push(`allPools: true`);
+  return `{ ${parts.join(", ")} }`;
+}
 function normaliseWorkerMode(raw) {
   if (raw === "standalone") return "standalone";
   return "embedded";
@@ -7260,6 +7464,9 @@ function normaliseWorkerMode(raw) {
 function normaliseMultiTenant2(raw) {
   return raw === true;
 }
+function encodeWorkerForRootOpts(opts) {
+  return Buffer.from(opts, "utf-8").toString("base64");
+}
 function localsToHygenArgs2(locals) {
   return [
     "--appName",
@@ -7276,10 +7483,19 @@ function localsToHygenArgs2(locals) {
     workerSkipValue(locals.workerExists),
     "--workerPath",
     locals.workerPath,
+    "--jobWorkerModuleImport",
+    locals.jobWorkerModuleImport,
+    "--workerForRootOpts",
+    encodeWorkerForRootOpts(locals.workerForRootOpts),
     "--schemaPath",
     locals.schemaPath,
     "--mainHookInjected",
-    workerSkipValue(locals.mainHookInjected)
+    workerSkipValue(locals.mainHookInjected),
+    // #517 — boolean-ish for `skip_if` (same '' / 'true' encoding as
+    // workerExists / mainHookInjected). 'true' in package mode → the schema
+    // template is skipped (the package ships the schema).
+    "--skipSchema",
+    workerSkipValue(locals.skipSchema)
   ];
 }
 
@@ -8137,6 +8353,12 @@ var SubsystemInstallCommand = class extends Command3 {
       return 1;
     }
     if (this.dryRun) {
+      const jobsScaffoldDryRun = desc.name === "jobs" ? runJobsScaffold(ctx.cwd, ctx.config, {
+        dryRun: true,
+        json: isJsonMode(),
+        forceConfig: this.forceConfig,
+        skipConfigBlock: true
+      }) : null;
       if (isJsonMode()) {
         printJson({
           command: "subsystem install",
@@ -8144,7 +8366,8 @@ var SubsystemInstallCommand = class extends Command3 {
           runtime: "package",
           dryRun: true,
           installList: already ? installed : [...installed, desc.name],
-          configBlockOutcome
+          configBlockOutcome,
+          ...jobsScaffoldDryRun ? { scaffold: jobsScaffoldDryRun } : {}
         });
       } else {
         printInfo(`Dry run \u2014 runtime: package (no files vendored).`);
@@ -8153,6 +8376,14 @@ var SubsystemInstallCommand = class extends Command3 {
           printInfo(`  ${desc.name} config block would be ${configBlockOutcome}`);
         }
         printInfo("  would regenerate <generated>/subsystems.ts + subsystems-schema.ts");
+        if (jobsScaffoldDryRun?.planned?.length) {
+          printInfo(
+            `  jobs scaffold \u2014 ${jobsScaffoldDryRun.planned.length} template targets (worker + main.ts hook; schema ships in the package)`
+          );
+          for (const p of jobsScaffoldDryRun.planned) {
+            console.log(`  ${theme.muted(icons.arrow)} ${path24.relative(ctx.cwd, p) || p}`);
+          }
+        }
       }
       return 0;
     }
@@ -8197,6 +8428,12 @@ var SubsystemInstallCommand = class extends Command3 {
       const msg = err instanceof Error ? err.message : String(err);
       printWarning(`barrel regeneration failed \u2014 ${msg}`);
     }
+    const jobsScaffold = desc.name === "jobs" ? runJobsScaffold(ctx.cwd, refreshed.config, {
+      dryRun: false,
+      json: isJsonMode(),
+      forceConfig: this.forceConfig,
+      skipConfigBlock: true
+    }) : null;
     if (isJsonMode()) {
       printJson({
         command: "subsystem install",
@@ -8208,7 +8445,8 @@ var SubsystemInstallCommand = class extends Command3 {
         installOutcome: installResult.outcome,
         configBlockOutcome,
         barrelEmitted,
-        schemaEmitted
+        schemaEmitted,
+        ...jobsScaffold ? { scaffold: jobsScaffold } : {}
       });
       return 0;
     }
@@ -8216,6 +8454,17 @@ var SubsystemInstallCommand = class extends Command3 {
     if (installResult.outcome === "added") {
       printInfo(`Added '${desc.name}' to subsystems.install.`);
     }
+    if (jobsScaffold) {
+      if (jobsScaffold.ok) {
+        printSuccess(
+          `jobs scaffold applied (emitted src/worker.ts + src/main.ts hook; schema ships in the package).`
+        );
+      } else {
+        printWarning(
+          `jobs scaffold (Hygen) failed \u2014 config + barrels were written; re-run after fixing: ${jobsScaffold.error ?? "unknown error"}`
+        );
+      }
+    }
     printInfo(
       `Regenerated <generated>/subsystems.ts (${barrelEmitted.join(", ") || "none"}) + subsystems-schema.ts (${schemaEmitted.join(", ") || "none"}).`
     );
@@ -8445,14 +8694,10 @@ function runJobsScaffold(cwd, config, opts) {
   const planned = [
     ...!locals.workerExists ? [locals.workerPath] : [],
     locals.mainTsPath,
-    locals.configPath,
-    locals.schemaPath
+    ...opts.skipConfigBlock ? [] : [locals.configPath],
+    ...locals.skipSchema ? [] : [locals.schemaPath]
   ];
-  const configBlockOutcome = planConfigBlockAction(
-    locals.configPath,
-    "jobs",
-    opts.forceConfig
-  );
+  const configBlockOutcome = opts.skipConfigBlock ? void 0 : planConfigBlockAction(locals.configPath, "jobs", opts.forceConfig);
   if (configBlockOutcome === "parse-error") {
     return { ok: false, planned, configBlockOutcome };
   }
@@ -8475,21 +8720,23 @@ function runJobsScaffold(cwd, config, opts) {
       configBlockOutcome
     };
   }
-  const configResult = runConfigBlockAction({
-    cwd,
-    actionFolder: "jobs-config",
-    configPath: locals.configPath,
-    subsystem: "jobs",
-    outcome: configBlockOutcome,
-    json: opts.json
-  });
-  if (!configResult.ok) {
-    return {
-      ok: false,
-      planned,
-      error: configResult.error,
-      configBlockOutcome
-    };
+  if (!opts.skipConfigBlock && configBlockOutcome) {
+    const configResult = runConfigBlockAction({
+      cwd,
+      actionFolder: "jobs-config",
+      configPath: locals.configPath,
+      subsystem: "jobs",
+      outcome: configBlockOutcome,
+      json: opts.json
+    });
+    if (!configResult.ok) {
+      return {
+        ok: false,
+        planned,
+        error: configResult.error,
+        configBlockOutcome
+      };
+    }
   }
   return { ok: true, planned, configBlockOutcome };
 }