@pattern-stack/codegen 0.9.0 → 0.9.2

package/dist/runtime/subsystems/jobs/jobs-errors.d.ts

@@ -1,4 +1,4 @@
-import { i as JobRun } from '../../../job-orchestrator.protocol-BwsBd37o.js';
+import { i as JobRun } from '../../../job-orchestrator.protocol-CHOEqBDk.js';
 import '../events/event-bus.protocol.js';
 import '../../types/drizzle.js';
 import 'drizzle-orm/node-postgres';
@@ -6,6 +6,7 @@ import './job-orchestration.schema.js';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm';
 import '@nestjs/common';
+import '../events/generated/types.js';
 
 /**
  * Typed errors for the job orchestration domain (ADR-022, JOB-3).

package/dist/runtime/subsystems/observability/index.d.ts

@@ -12,7 +12,7 @@ import '@nestjs/common';
 import '../events/event-bus.protocol.js';
 import '../../types/drizzle.js';
 import 'drizzle-orm/node-postgres';
-import '../../../job-orchestrator.protocol-BwsBd37o.js';
+import '../../../job-orchestrator.protocol-CHOEqBDk.js';
 import '../jobs/job-orchestration.schema.js';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm';

package/dist/runtime/subsystems/observability/observability.protocol.d.ts

@@ -3,7 +3,7 @@ import { ListEventsQuery, EventPage, EventSummary } from '../events/event-read.p
 import { StatusHistogram } from '../bridge/bridge.protocol.js';
 import { SyncRunSummary } from '../sync/sync-run-recorder.protocol.js';
 import { CursorSnapshot } from '../sync/sync-cursor-store.protocol.js';
-import '../../../job-orchestrator.protocol-BwsBd37o.js';
+import '../../../job-orchestrator.protocol-CHOEqBDk.js';
 import '../events/event-bus.protocol.js';
 import '../../types/drizzle.js';
 import 'drizzle-orm/node-postgres';

package/dist/runtime/subsystems/observability/observability.service.d.ts

@@ -4,7 +4,7 @@ import { IJobBridge, StatusHistogram } from '../bridge/bridge.protocol.js';
 import { ISyncRunRecorder, SyncRunSummary } from '../sync/sync-run-recorder.protocol.js';
 import { ICursorStore, CursorSnapshot } from '../sync/sync-cursor-store.protocol.js';
 import { IObservability, CorrelationTimeline } from './observability.protocol.js';
-import '../../../job-orchestrator.protocol-BwsBd37o.js';
+import '../../../job-orchestrator.protocol-CHOEqBDk.js';
 import '../events/event-bus.protocol.js';
 import '../../types/drizzle.js';
 import 'drizzle-orm/node-postgres';

package/dist/runtime/subsystems/observability/reporters/bridge-metrics.reporter.d.ts

@@ -2,16 +2,16 @@ import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
 import { IObservability } from '../observability.protocol.js';
 import { ObservabilityModuleOptions } from '../observability.module.js';
 import '../../jobs/job-run-service.protocol.js';
-import '../../../../job-orchestrator.protocol-BwsBd37o.js';
+import '../../../../job-orchestrator.protocol-CHOEqBDk.js';
 import '../../events/event-bus.protocol.js';
 import '../../../types/drizzle.js';
 import 'drizzle-orm/node-postgres';
 import '../../jobs/job-orchestration.schema.js';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm';
+import '../../events/generated/types.js';
 import '../../events/event-read.protocol.js';
 import '../../bridge/bridge.protocol.js';
-import '../../events/generated/types.js';
 import '../../bridge/bridge-delivery.schema.js';
 import '../../sync/sync-run-recorder.protocol.js';
 import '../../sync/sync-field-diff.protocol.js';

package/dist/runtime/subsystems/observability/reporters/index.d.ts

@@ -2,16 +2,16 @@ export { BridgeMetricsReporter } from './bridge-metrics.reporter.js';
 import '@nestjs/common';
 import '../observability.protocol.js';
 import '../../jobs/job-run-service.protocol.js';
-import '../../../../job-orchestrator.protocol-BwsBd37o.js';
+import '../../../../job-orchestrator.protocol-CHOEqBDk.js';
 import '../../events/event-bus.protocol.js';
 import '../../../types/drizzle.js';
 import 'drizzle-orm/node-postgres';
 import '../../jobs/job-orchestration.schema.js';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm';
+import '../../events/generated/types.js';
 import '../../events/event-read.protocol.js';
 import '../../bridge/bridge.protocol.js';
-import '../../events/generated/types.js';
 import '../../bridge/bridge-delivery.schema.js';
 import '../../sync/sync-run-recorder.protocol.js';
 import '../../sync/sync-field-diff.protocol.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pattern-stack/codegen",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Entity-driven code generation for full-stack TypeScript applications",
   "license": "MIT",
   "type": "module",
@@ -131,9 +131,11 @@
     "@nestjs/core": "10",
     "@nestjs/schedule": "^4.0.0",
     "@nestjs/testing": "^10",
+    "@testcontainers/postgresql": "^12.0.0",
     "@types/bun": "latest",
     "@types/ejs": "^3.1.5",
     "@types/node": "^25.6.0",
+    "@types/pg": "^8.20.0",
     "@types/pluralize": "^0.0.33",
     "bullmq": "^5.0.0",
     "class-transformer": "^0.5.1",
@@ -141,8 +143,10 @@
     "ejs": "^5.0.2",
     "hygen": "^6.2.11",
     "ioredis": "^5.3.0",
+    "pg": "^8.21.0",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.2",
+    "testcontainers": "^12.0.0",
     "tsup": "^8.5.1"
   },
   "directories": {

package/runtime/subsystems/jobs/job-handler.base.ts

@@ -16,6 +16,7 @@
  */
 // TODO(logging-subsystem): swap to ILogger once ADR-028 lands
 import type { Logger } from '@nestjs/common';
+import type { EventOfType, EventTypeName } from '../events/generated/types';
 import type { JobRun } from './job-orchestrator.protocol';
 
 // ─── ParentClosePolicy ──────────────────────────────────────────────────────
@@ -60,6 +61,35 @@ export interface ScopeRef<TInput, TScope extends string = string> {
   from: (input: TInput) => string;
 }
 
+/**
+ * Bridge trigger authoring shape (BRIDGE-6 follow-up — BRIDGE-6 shipped the
+ * generator + runtime for `@JobHandler({ triggers })` but never added the
+ * authoring field to this type; the generator's tests scan source as strings,
+ * so a real decorator was never compiled and the gap went uncaught).
+ *
+ * Declared on `@JobHandler({ triggers })`; the codegen bridge-registry
+ * generator (`src/cli/shared/bridge-registry-generator.ts`) scans these from
+ * source and emits `bridge/generated/registry.ts`, validating each `event`
+ * against the generated `eventRegistry` at `gen-all`. The distributed union
+ * narrows `map`/`when` per `event`, so callbacks are typed against the event
+ * payload (ADR-023, "typed against PayloadOfType<T>").
+ *
+ * Typed against events' generated types — the same `import type` coupling the
+ * bridge already has (erased at runtime). `jobs` must NOT import `bridge`, so
+ * the post-gen `BridgeTriggerEntry` is deliberately not referenced here;
+ * `triggerId`/`jobType` are computed by the generator, not authored.
+ */
+export type JobTrigger<TInput> = {
+  [T in EventTypeName]: {
+    /** Event type that fires this trigger. Validated against `eventRegistry`. */
+    event: T;
+    /** Maps the event to the job input. Inlined verbatim into the registry. */
+    map: (event: EventOfType<T>) => TInput;
+    /** Optional guard; `false` → wrapper records `status='skipped'`. */
+    when?: (event: EventOfType<T>) => boolean;
+  };
+}[EventTypeName];
+
 export interface JobHandlerMeta<TInput> {
   pool?: string;
   scope?: ScopeRef<TInput>;
@@ -68,6 +98,12 @@ export interface JobHandlerMeta<TInput> {
   dedupe?: DedupePolicy<TInput>;
   timeoutMs?: number;
   replayFrom?: 'scratch' | 'last_step' | 'last_checkpoint';
+  /**
+   * Bridge triggers (ADR-023 Tier 3). Codegen scans these into `bridgeRegistry`;
+   * the framework `BridgeDeliveryHandler` starts this job per matched event.
+   * Absent for jobs started directly or via `IEventFlow.publishAndStart`.
+   */
+  triggers?: readonly JobTrigger<TInput>[];
 }
 
 // ─── Runtime option shapes ──────────────────────────────────────────────────

package/runtime/subsystems/jobs/job-run-keyset-cursor.ts

@@ -72,6 +72,9 @@ export function toJobRunSummary(r: JobRunRow): JobRunSummary {
   return {
     runId: r.id,
     rootRunId: r.rootRunId,
+    parentRunId: r.parentRunId,
+    triggerSource: r.triggerSource,
+    triggerRef: r.triggerRef,
     jobType: r.jobType,
     pool: r.pool,
     status: r.status,

package/runtime/subsystems/jobs/job-run-service.protocol.ts

@@ -95,11 +95,19 @@ export interface ListJobRunsQuery {
 /**
  * Summary row for the `job_run` list (OBS-LIST-1). A narrow projection over
  * `JobRun` carrying the columns a runs viewer renders. `rootRunId` is
- * included so the correlation timeline can stitch runs to events.
+ * included so the correlation timeline can stitch runs to events; the
+ * lineage fields (`parentRunId`, `triggerSource`, `triggerRef`) let a viewer
+ * render the run tree and explain why each run was started without a second
+ * fetch. `triggerSource` is non-null (the column is `NOT NULL`); the literal
+ * union mirrors `job_trigger_source` — `JobRun['triggerSource']` is optional
+ * and would admit `undefined`, which this projection never produces.
  */
 export interface JobRunSummary {
   runId: string;
   rootRunId: string;
+  parentRunId: string | null;
+  triggerSource: 'manual' | 'schedule' | 'event' | 'parent';
+  triggerRef: string | null;
   jobType: string;
   pool: string;
   status: JobRun['status'];