@pattern-stack/codegen 0.4.4 → 0.4.5

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

@@ -0,0 +1,425 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index4, decorator) => (target, key) => decorator(target, key, index4);
+
+// runtime/subsystems/observability/reporters/bridge-metrics.reporter.ts
+import {
+  Inject,
+  Injectable,
+  Logger
+} from "@nestjs/common";
+import { and, eq, gt, sql as sql3 } from "drizzle-orm";
+
+// runtime/constants/tokens.ts
+var DRIZZLE = "DRIZZLE";
+
+// runtime/subsystems/bridge/bridge-delivery.schema.ts
+import {
+  index as index3,
+  jsonb as jsonb3,
+  pgEnum as pgEnum2,
+  pgTable as pgTable3,
+  text as text3,
+  timestamp as timestamp3,
+  unique,
+  uuid as uuid3
+} from "drizzle-orm/pg-core";
+import { sql as sql2 } from "drizzle-orm";
+
+// runtime/subsystems/events/domain-events.schema.ts
+import {
+  index,
+  jsonb,
+  pgTable,
+  text,
+  timestamp,
+  uuid
+} from "drizzle-orm/pg-core";
+var domainEvents = pgTable(
+  "domain_events",
+  {
+    id: uuid("id").primaryKey(),
+    type: text("type").notNull(),
+    aggregateId: text("aggregate_id").notNull(),
+    aggregateType: text("aggregate_type").notNull(),
+    payload: jsonb("payload").notNull().$type(),
+    occurredAt: timestamp("occurred_at", { withTimezone: true }).notNull(),
+    processedAt: timestamp("processed_at", { withTimezone: true }),
+    /** Lifecycle status: pending | processed | failed */
+    status: text("status").notNull().default("pending"),
+    /** Error message from the last failed dispatch attempt. */
+    error: text("error"),
+    metadata: jsonb("metadata").$type(),
+    /** Routing pool (e.g. `events_inbound`, `events_change`, `events_outbound`). Populated by DrizzleEventBus.publish() in EVT-4. */
+    pool: text("pool"),
+    /** Routing direction: `inbound` | `change` | `outbound`. Populated by DrizzleEventBus.publish() in EVT-4. */
+    direction: text("direction"),
+    // conditional: emitted only when events.multi_tenant: true
+    tenantId: text("tenant_id")
+  },
+  (t) => ({
+    /** Polling drain filter (existing — promoted from comment to declaration in EVT-1). */
+    idxDomainEventsStatusOccurredAt: index("idx_domain_events_status_occurred_at").on(
+      t.status,
+      t.occurredAt
+    ),
+    /** Event replay per aggregate (existing — promoted from comment to declaration in EVT-1). */
+    idxDomainEventsAggregate: index("idx_domain_events_aggregate").on(
+      t.aggregateId,
+      t.aggregateType
+    ),
+    /** Per-pool drain filter (EVT-1). Enables DrizzleEventBus to drain a single pool without scanning all events. */
+    idxDomainEventsPoolStatusOccurredAt: index(
+      "idx_domain_events_pool_status_occurred_at"
+    ).on(t.pool, t.status, t.occurredAt)
+  })
+);
+
+// runtime/subsystems/jobs/job-orchestration.schema.ts
+import {
+  pgEnum,
+  pgTable as pgTable2,
+  uuid as uuid2,
+  text as text2,
+  jsonb as jsonb2,
+  integer,
+  timestamp as timestamp2,
+  index as index2,
+  uniqueIndex
+} from "drizzle-orm/pg-core";
+import { sql } from "drizzle-orm";
+var jobRunStatusEnum = pgEnum("job_run_status", [
+  "pending",
+  "running",
+  "waiting",
+  "completed",
+  "failed",
+  "timed_out",
+  "canceled"
+]);
+var jobStepKindEnum = pgEnum("job_step_kind", ["task"]);
+var jobStepStatusEnum = pgEnum("job_step_status", [
+  "pending",
+  "running",
+  "completed",
+  "failed",
+  "skipped"
+]);
+var collisionModeEnum = pgEnum("job_collision_mode", [
+  "queue",
+  "reject",
+  "replace"
+]);
+var replayFromEnum = pgEnum("job_replay_from", [
+  "scratch",
+  "last_step",
+  "last_checkpoint"
+]);
+var parentClosePolicyEnum = pgEnum("job_parent_close_policy", [
+  "terminate",
+  "cancel",
+  "abandon"
+]);
+var waitKindEnum = pgEnum("job_wait_kind", ["signal"]);
+var triggerSourceEnum = pgEnum("job_trigger_source", [
+  "manual",
+  "schedule",
+  "event",
+  "parent"
+]);
+var jobs = pgTable2("job", {
+  type: text2("type").primaryKey(),
+  version: integer("version").notNull().default(1),
+  pool: text2("pool").notNull(),
+  scopeEntityType: text2("scope_entity_type"),
+  retryPolicy: jsonb2("retry_policy").notNull().$type(),
+  timeoutMs: integer("timeout_ms"),
+  concurrencyKeyTemplate: text2("concurrency_key_template"),
+  collisionMode: collisionModeEnum("collision_mode").notNull().default("queue"),
+  dedupeKeyTemplate: text2("dedupe_key_template"),
+  dedupeWindowMs: integer("dedupe_window_ms"),
+  priorityDefault: integer("priority_default").notNull().default(0),
+  replayFrom: replayFromEnum("replay_from").notNull().default("last_checkpoint"),
+  createdAt: timestamp2("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp2("updated_at", { withTimezone: true }).notNull().defaultNow()
+});
+var jobRuns = pgTable2(
+  "job_run",
+  {
+    id: uuid2("id").primaryKey().defaultRandom(),
+    jobType: text2("job_type").notNull().references(() => jobs.type),
+    jobVersion: integer("job_version").notNull(),
+    parentRunId: uuid2("parent_run_id").references(() => jobRuns.id),
+    /**
+     * Service generates `id` client-side via randomUUID() and sets
+     * root_run_id = id for root runs (single INSERT, no self-FK race).
+     */
+    rootRunId: uuid2("root_run_id").notNull(),
+    parentClosePolicy: parentClosePolicyEnum("parent_close_policy").notNull().default("terminate"),
+    scopeEntityType: text2("scope_entity_type"),
+    scopeEntityId: text2("scope_entity_id"),
+    tenantId: text2("tenant_id"),
+    tags: jsonb2("tags").notNull().default({}).$type(),
+    pool: text2("pool").notNull(),
+    priority: integer("priority").notNull().default(0),
+    concurrencyKey: text2("concurrency_key"),
+    dedupeKey: text2("dedupe_key"),
+    status: jobRunStatusEnum("status").notNull().default("pending"),
+    input: jsonb2("input").notNull().$type(),
+    output: jsonb2("output").$type(),
+    error: jsonb2("error").$type(),
+    triggerSource: triggerSourceEnum("trigger_source").notNull(),
+    triggerRef: text2("trigger_ref"),
+    runAt: timestamp2("run_at", { withTimezone: true }).notNull().defaultNow(),
+    startedAt: timestamp2("started_at", { withTimezone: true }),
+    finishedAt: timestamp2("finished_at", { withTimezone: true }),
+    claimedAt: timestamp2("claimed_at", { withTimezone: true }),
+    attempts: integer("attempts").notNull().default(0),
+    // Phase 3 placeholder — see ADR-025
+    waitKind: waitKindEnum("wait_kind"),
+    // Phase 3 placeholder — see ADR-025
+    resumeToken: text2("resume_token"),
+    // Phase 3 placeholder — see ADR-025
+    waitDeadline: timestamp2("wait_deadline", { withTimezone: true }),
+    createdAt: timestamp2("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp2("updated_at", { withTimezone: true }).notNull().defaultNow()
+  },
+  (t) => ({
+    /** Claim query: ORDER BY priority DESC, run_at ASC. */
+    idxJobRunClaim: index2("idx_job_run_claim").on(t.status, t.pool, t.runAt),
+    /** Tree traversal / cascade cancel. */
+    idxJobRunRoot: index2("idx_job_run_root").on(t.rootRunId),
+    /** listForScope query. */
+    idxJobRunScope: index2("idx_job_run_scope").on(t.scopeEntityType, t.scopeEntityId),
+    /** Idempotency collapse — partial index. */
+    idxJobRunDedupe: index2("idx_job_run_dedupe").on(t.jobType, t.dedupeKey).where(sql`${t.dedupeKey} IS NOT NULL`),
+    /** Collision check — partial index. */
+    idxJobRunConcurrency: index2("idx_job_run_concurrency").on(t.concurrencyKey).where(
+      sql`${t.concurrencyKey} IS NOT NULL AND ${t.status} IN ('pending','running')`
+    )
+  })
+);
+var jobSteps = pgTable2(
+  "job_step",
+  {
+    id: uuid2("id").primaryKey().defaultRandom(),
+    jobRunId: uuid2("job_run_id").notNull().references(() => jobRuns.id),
+    stepId: text2("step_id").notNull(),
+    kind: jobStepKindEnum("kind").notNull().default("task"),
+    /**
+     * Monotonic within run. integer (max ~2B per run) is sufficient —
+     * downgraded from ADR-022's bigint; revisit only if a single run
+     * ever exceeds 2 billion steps.
+     */
+    seq: integer("seq").notNull(),
+    status: jobStepStatusEnum("status").notNull().default("pending"),
+    input: jsonb2("input").$type(),
+    /** Memoised on success for replay. */
+    output: jsonb2("output").$type(),
+    error: jsonb2("error").$type(),
+    attempts: integer("attempts").notNull().default(0),
+    startedAt: timestamp2("started_at", { withTimezone: true }),
+    finishedAt: timestamp2("finished_at", { withTimezone: true })
+  },
+  (t) => ({
+    /** No duplicate step IDs per run. */
+    idxJobStepRunStep: uniqueIndex("idx_job_step_run_step").on(t.jobRunId, t.stepId),
+    /** Ordered timeline reads. */
+    idxJobStepTimeline: index2("idx_job_step_timeline").on(t.jobRunId, t.seq)
+  })
+);
+
+// runtime/subsystems/bridge/bridge-delivery.schema.ts
+var bridgeDeliveryStatusEnum = pgEnum2("bridge_delivery_status", [
+  "pending",
+  "delivered",
+  "skipped",
+  "failed"
+]);
+var bridgeDelivery = pgTable3(
+  "bridge_delivery",
+  {
+    id: uuid3("id").primaryKey().defaultRandom(),
+    /** FK to the source event in the outbox. */
+    eventId: uuid3("event_id").notNull().references(() => domainEvents.id),
+    /**
+     * Stable codegen-emitted identifier for the (job, trigger) pair, of the
+     * form `<job_type>#<triggerIndex>` (BRIDGE-6). Forms the second half of
+     * the UNIQUE idempotency key.
+     */
+    triggerId: text3("trigger_id").notNull(),
+    /**
+     * Wrapper `job_run.id` (the framework `@framework/bridge_delivery` run
+     * that drove this delivery). Nullable: the facade-eager path
+     * (`publishAndStart` Case B) pre-writes a delivered row with no wrapper.
+     */
+    wrapperRunId: uuid3("wrapper_run_id").references(() => jobRuns.id),
+    /**
+     * Spawned user `job_run.id`. Null until status is `delivered`; remains
+     * null for `skipped` and `failed` deliveries.
+     */
+    userRunId: uuid3("user_run_id").references(() => jobRuns.id),
+    status: bridgeDeliveryStatusEnum("status").notNull().default("pending"),
+    /** Populated when status=`skipped` (e.g. `'when_returned_false'`, `'trigger_unregistered'`). */
+    skipReason: text3("skip_reason"),
+    /** Populated when status=`failed`. Mirrors `job_run.error` shape. */
+    error: jsonb3("error").$type(),
+    /**
+     * Emitted unconditionally and nullable (JOB-8 / SYNC-6 precedent).
+     * Enforcement gated on `BRIDGE_MULTI_TENANT` at the service layer
+     * (BRIDGE-8); no DB constraint.
+     */
+    tenantId: text3("tenant_id"),
+    attemptedAt: timestamp3("attempted_at", { withTimezone: true }).notNull().defaultNow(),
+    deliveredAt: timestamp3("delivered_at", { withTimezone: true })
+  },
+  (t) => ({
+    /**
+     * Idempotency ledger. Outbox replays and facade-vs-drain collisions both
+     * dedup through this constraint.
+     */
+    uqBridgeDeliveryEventTrigger: unique("uq_bridge_delivery_event_trigger").on(
+      t.eventId,
+      t.triggerId
+    ),
+    /** Lookup all deliveries for an event (fanout report, debugging). */
+    idxBridgeDeliveryEvent: index3("idx_bridge_delivery_event").on(t.eventId),
+    /**
+     * Ops dashboard filter — only the actionable states. Partial index keeps
+     * it small at scale (the bulk of rows will be `delivered`).
+     */
+    idxBridgeDeliveryStatus: index3("idx_bridge_delivery_status").on(t.status).where(sql2`${t.status} IN ('pending','failed')`),
+    /**
+     * Reverse lookup from a spawned user run back to its delivery row.
+     * Partial — most rows in the bridge ledger but only successful
+     * deliveries have a `user_run_id`.
+     */
+    idxBridgeDeliveryUserRun: index3("idx_bridge_delivery_user_run").on(t.userRunId).where(sql2`${t.userRunId} IS NOT NULL`)
+  })
+);
+
+// runtime/subsystems/observability/reporters/bridge-metrics.reporter.ts
+var INTERVAL_NAME = "bridge-metrics-tick";
+var DEFAULT_INTERVAL_MS = 6e4;
+var MIN_INTERVAL_MS = 1e3;
+var BridgeMetricsReporter = class {
+  constructor(db, scheduler) {
+    this.db = db;
+    this.scheduler = scheduler;
+    this.intervalMs = this.resolveIntervalMs();
+    this.lastTickAt = /* @__PURE__ */ new Date();
+  }
+  db;
+  scheduler;
+  logger = new Logger(BridgeMetricsReporter.name);
+  intervalMs;
+  lastTickAt;
+  onModuleInit() {
+    this.logger.log(
+      `BridgeMetricsReporter starting (intervalMs=${this.intervalMs}).`
+    );
+    const timer = setInterval(() => {
+      void this.tick();
+    }, this.intervalMs);
+    timer.unref?.();
+    this.scheduler.addInterval(INTERVAL_NAME, timer);
+  }
+  onModuleDestroy() {
+    if (this.scheduler.getIntervals().includes(INTERVAL_NAME)) {
+      this.scheduler.deleteInterval(INTERVAL_NAME);
+    }
+  }
+  /**
+   * Run one sampling tick. Public so tests can drive it deterministically
+   * without waiting on the timer.
+   */
+  async tick() {
+    const windowStart = this.lastTickAt;
+    const windowEnd = /* @__PURE__ */ new Date();
+    this.lastTickAt = windowEnd;
+    let rows = [];
+    try {
+      rows = await this.sample(windowStart, windowEnd);
+    } catch (err) {
+      this.logger.error(
+        `bridge metrics sample failed: ${err.message}`
+      );
+      return { windowStart, windowEnd, rows: [] };
+    }
+    this.emit({ windowStart, windowEnd, rows });
+    return { windowStart, windowEnd, rows };
+  }
+  async sample(windowStart, windowEnd) {
+    const lastTransition = sql3`COALESCE(${bridgeDelivery.deliveredAt}, ${bridgeDelivery.attemptedAt})`;
+    const result = await this.db.select({
+      status: bridgeDelivery.status,
+      eventType: domainEvents.type,
+      skipReason: bridgeDelivery.skipReason,
+      count: sql3`COUNT(*)::int`
+    }).from(bridgeDelivery).innerJoin(domainEvents, eq(bridgeDelivery.eventId, domainEvents.id)).where(
+      and(
+        gt(lastTransition, windowStart),
+        sql3`${lastTransition} <= ${windowEnd}`
+      )
+    ).groupBy(
+      bridgeDelivery.status,
+      domainEvents.type,
+      bridgeDelivery.skipReason
+    );
+    return result.map((r) => ({
+      status: r.status,
+      eventType: r.eventType,
+      skipReason: r.skipReason,
+      count: r.count
+    }));
+  }
+  emit(tick) {
+    if (tick.rows.length === 0) {
+      this.logger.log(
+        `bridge_metrics tick=empty window=[${tick.windowStart.toISOString()}..${tick.windowEnd.toISOString()}]`
+      );
+      return;
+    }
+    const totals = tick.rows.reduce(
+      (acc, r) => {
+        acc[r.status] = (acc[r.status] ?? 0) + r.count;
+        return acc;
+      },
+      {}
+    );
+    const detail = tick.rows.map(
+      (r) => `${r.eventType}|${r.status}${r.skipReason ? `:${r.skipReason}` : ""}=${r.count}`
+    ).join(" ");
+    this.logger.log(
+      `bridge_metrics tick window=[${tick.windowStart.toISOString()}..${tick.windowEnd.toISOString()}] totals=${JSON.stringify(totals)} detail=[${detail}]`
+    );
+  }
+  resolveIntervalMs() {
+    const raw = process.env["BRIDGE_METRICS_INTERVAL_MS"];
+    if (!raw) return DEFAULT_INTERVAL_MS;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed < MIN_INTERVAL_MS) {
+      new Logger(BridgeMetricsReporter.name).warn(
+        `Ignoring BRIDGE_METRICS_INTERVAL_MS='${raw}' (invalid or < ${MIN_INTERVAL_MS}ms); using default ${DEFAULT_INTERVAL_MS}ms.`
+      );
+      return DEFAULT_INTERVAL_MS;
+    }
+    return parsed;
+  }
+};
+BridgeMetricsReporter = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(DRIZZLE))
+], BridgeMetricsReporter);
+export {
+  BridgeMetricsReporter
+};
+//# sourceMappingURL=bridge-metrics.reporter.js.map

package/dist/runtime/subsystems/observability/reporters/bridge-metrics.reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../runtime/subsystems/observability/reporters/bridge-metrics.reporter.ts","../../../../../runtime/constants/tokens.ts","../../../../../runtime/subsystems/bridge/bridge-delivery.schema.ts","../../../../../runtime/subsystems/events/domain-events.schema.ts","../../../../../runtime/subsystems/jobs/job-orchestration.schema.ts"],"sourcesContent":["/**\n * BridgeMetricsReporter — periodic structured-log sampler for the\n * `bridge_delivery` ledger.\n *\n * Runs on a timer (default 60s, configurable via\n * `BRIDGE_METRICS_INTERVAL_MS`) and emits ONE `Logger.log` line per tick\n * describing counts of rows that transitioned through each terminal\n * status in the last tick window, grouped by `(status, event_type,\n * skip_reason)`.\n *\n * # Placement\n *\n * Lives under `observability/reporters/` rather than in the bridge\n * subsystem itself because:\n *   1. It's not part of the bridge's functional surface — a reporter is\n *      an observability concern composed on top.\n *   2. Future reporters (Prometheus exporter, OTel bridge, etc.) slot in\n *      here with no cross-subsystem import churn.\n *\n * # Opt-in via ObservabilityModule\n *\n * The reporter is NOT provided automatically. Opt in via\n * `ObservabilityModule.forRoot({ backend, reporters: { bridgeMetrics: true } })`\n * — the module only registers the reporter when that flag is set, which\n * keeps consumers without the bridge subsystem free of its schema import\n * tax (tree-shaken; see `observability.module.ts` for the gate).\n *\n * # Why a sampler instead of in-handler logs\n *\n * The bridge subsystem writes the `bridge_delivery` ledger directly; adding\n * per-transition log lines inside the handler would double every row at\n * 1:1 cardinality. Aggregating per-tick produces the \"counts per event\n * type of delivered/skipped/failed\" shape that ops dashboards want,\n * without touching the bridge runtime.\n *\n * # Why aggregate-per-tick rather than per-row\n *\n * Deliveries flow at bulk-sync cadence (one event per persisted CRM\n * record). Per-row logs would be noisy and duplicative of the ledger\n * itself; aggregates match the \"counts per event type of\n * delivered/skipped/failed\" operator surface.\n */\nimport {\n  Inject,\n  Injectable,\n  Logger,\n  type OnModuleDestroy,\n  type OnModuleInit,\n} from '@nestjs/common';\nimport { SchedulerRegistry } from '@nestjs/schedule';\nimport { and, eq, gt, sql } from 'drizzle-orm';\n\nimport { DRIZZLE } from '../../../constants/tokens';\nimport type { DrizzleClient } from '../../../types/drizzle';\nimport { bridgeDelivery } from '../../bridge/bridge-delivery.schema';\nimport { domainEvents } from '../../events/domain-events.schema';\n\nconst INTERVAL_NAME = 'bridge-metrics-tick';\n\n/** Default sampling interval (1 minute). */\nconst DEFAULT_INTERVAL_MS = 60_000;\n\n/** Minimum allowed interval — guards against env misconfig producing a hot loop. */\nconst MIN_INTERVAL_MS = 1_000;\n\nexport interface BridgeMetricsRow {\n  status: 'pending' | 'delivered' | 'skipped' | 'failed';\n  eventType: string;\n  skipReason: string | null;\n  count: number;\n}\n\nexport interface BridgeMetricsTick {\n  windowStart: Date;\n  windowEnd: Date;\n  rows: BridgeMetricsRow[];\n}\n\n@Injectable()\nexport class BridgeMetricsReporter implements OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(BridgeMetricsReporter.name);\n  private readonly intervalMs: number;\n  private lastTickAt: Date;\n\n  constructor(\n    @Inject(DRIZZLE) private readonly db: DrizzleClient,\n    private readonly scheduler: SchedulerRegistry,\n  ) {\n    this.intervalMs = this.resolveIntervalMs();\n    // Initialize the window tail at boot so the first tick reports only\n    // deliveries that transitioned after the reporter started.\n    this.lastTickAt = new Date();\n  }\n\n  onModuleInit(): void {\n    this.logger.log(\n      `BridgeMetricsReporter starting (intervalMs=${this.intervalMs}).`,\n    );\n    const timer = setInterval(() => {\n      void this.tick();\n    }, this.intervalMs);\n    // Allow the process to exit naturally in test runs — setInterval\n    // otherwise pins the event loop open.\n    timer.unref?.();\n    this.scheduler.addInterval(INTERVAL_NAME, timer);\n  }\n\n  onModuleDestroy(): void {\n    if (this.scheduler.getIntervals().includes(INTERVAL_NAME)) {\n      this.scheduler.deleteInterval(INTERVAL_NAME);\n    }\n  }\n\n  /**\n   * Run one sampling tick. Public so tests can drive it deterministically\n   * without waiting on the timer.\n   */\n  async tick(): Promise<BridgeMetricsTick> {\n    const windowStart = this.lastTickAt;\n    const windowEnd = new Date();\n    this.lastTickAt = windowEnd;\n\n    let rows: BridgeMetricsRow[] = [];\n    try {\n      rows = await this.sample(windowStart, windowEnd);\n    } catch (err) {\n      this.logger.error(\n        `bridge metrics sample failed: ${(err as Error).message}`,\n      );\n      return { windowStart, windowEnd, rows: [] };\n    }\n\n    this.emit({ windowStart, windowEnd, rows });\n    return { windowStart, windowEnd, rows };\n  }\n\n  private async sample(\n    windowStart: Date,\n    windowEnd: Date,\n  ): Promise<BridgeMetricsRow[]> {\n    // Terminal transitions land `delivered_at` for `delivered`, and leave\n    // `attempted_at` as the most recent timestamp for `skipped`/`failed`.\n    // Window on COALESCE so terminal skipped/failed rows are captured\n    // alongside delivered. Upper edge bounded by windowEnd so a long tick\n    // can't double-count rows that transitioned between sample and emit.\n    const lastTransition = sql<Date>`COALESCE(${bridgeDelivery.deliveredAt}, ${bridgeDelivery.attemptedAt})`;\n\n    const result = await this.db\n      .select({\n        status: bridgeDelivery.status,\n        eventType: domainEvents.type,\n        skipReason: bridgeDelivery.skipReason,\n        count: sql<number>`COUNT(*)::int`,\n      })\n      .from(bridgeDelivery)\n      .innerJoin(domainEvents, eq(bridgeDelivery.eventId, domainEvents.id))\n      .where(\n        and(\n          gt(lastTransition, windowStart),\n          sql`${lastTransition} <= ${windowEnd}`,\n        ),\n      )\n      .groupBy(\n        bridgeDelivery.status,\n        domainEvents.type,\n        bridgeDelivery.skipReason,\n      );\n\n    return result.map((r) => ({\n      status: r.status as BridgeMetricsRow['status'],\n      eventType: r.eventType,\n      skipReason: r.skipReason,\n      count: r.count,\n    }));\n  }\n\n  private emit(tick: BridgeMetricsTick): void {\n    if (tick.rows.length === 0) {\n      // Heartbeat — confirms the sampler is alive when deliveries are idle.\n      // Cheap enough at default 60s cadence; operators rely on this signal\n      // to distinguish \"bridge quiet\" from \"reporter dead\".\n      this.logger.log(\n        `bridge_metrics tick=empty window=[${tick.windowStart.toISOString()}..${tick.windowEnd.toISOString()}]`,\n      );\n      return;\n    }\n\n    const totals = tick.rows.reduce(\n      (acc, r) => {\n        acc[r.status] = (acc[r.status] ?? 0) + r.count;\n        return acc;\n      },\n      {} as Record<string, number>,\n    );\n\n    const detail = tick.rows\n      .map(\n        (r) =>\n          `${r.eventType}|${r.status}${r.skipReason ? `:${r.skipReason}` : ''}=${r.count}`,\n      )\n      .join(' ');\n\n    this.logger.log(\n      `bridge_metrics tick window=[${tick.windowStart.toISOString()}..${tick.windowEnd.toISOString()}] ` +\n        `totals=${JSON.stringify(totals)} detail=[${detail}]`,\n    );\n  }\n\n  private resolveIntervalMs(): number {\n    const raw = process.env['BRIDGE_METRICS_INTERVAL_MS'];\n    if (!raw) return DEFAULT_INTERVAL_MS;\n    const parsed = Number.parseInt(raw, 10);\n    if (!Number.isFinite(parsed) || parsed < MIN_INTERVAL_MS) {\n      new Logger(BridgeMetricsReporter.name).warn(\n        `Ignoring BRIDGE_METRICS_INTERVAL_MS='${raw}' (invalid or < ${MIN_INTERVAL_MS}ms); ` +\n          `using default ${DEFAULT_INTERVAL_MS}ms.`,\n      );\n      return DEFAULT_INTERVAL_MS;\n    }\n    return parsed;\n  }\n}\n","/**\n * NestJS injection tokens\n *\n * Used with @Inject() decorator in concrete repository constructors.\n */\n\n/**\n * Injection token for the Drizzle ORM database client.\n *\n * Usage in concrete repositories:\n * ```typescript\n * constructor(@Inject(DRIZZLE) db: DrizzleClient) { super(db); }\n * ```\n */\nexport const DRIZZLE = 'DRIZZLE' as const;\n\n/**\n * Injection token for the event bus (IEventBus).\n *\n * Optional — only resolved when EventsModule.forRoot() is registered.\n * BaseService uses this with @Optional() to emit lifecycle events\n * without requiring the events subsystem to be installed.\n *\n * Usage in services/use cases:\n * ```typescript\n * @Optional() @Inject(EVENT_BUS) eventBus?: IEventBus\n * ```\n */\nexport const EVENT_BUS = 'EVENT_BUS' as const;\n","/**\n * Drizzle schema for the `bridge_delivery` ledger (ADR-023 Phase 2, BRIDGE-1).\n *\n * The `bridge_delivery` table is the idempotency ledger for the event-to-job\n * bridge. Every (event, trigger) pair the bridge is asked to spawn produces\n * exactly one row; the `UNIQUE (event_id, trigger_id)` constraint guarantees\n * that:\n *\n *   1. Outbox replays of an event do not double-spawn user job runs — the\n *      drain attempts to insert the duplicate, the constraint trips, and the\n *      drain skips that trigger.\n *   2. The `IEventFlow.publishAndStart` facade can pre-write a\n *      `(status='delivered')` row before the drain runs (Case B from ADR-023\n *      §`publishAndStart` + existing `triggers:` collision); the drain then\n *      hits UNIQUE on that trigger and skips it while still spawning any\n *      other triggers for the same event normally.\n *\n * Status values:\n *   - `pending`   — wrapper run exists; user job not yet started.\n *   - `delivered` — user job started; `user_run_id` populated.\n *   - `skipped`   — intentional no-op (`when:` returned false, or\n *                   facade-eager path pre-empted the bridge spawn).\n *   - `failed`    — wrapper exhausted retry policy; no auto-retry past that\n *                   (mirrors events outbox stance — ops eyes only).\n *\n * `wrapper_run_id` is **nullable**: the facade-eager path (Case B) pre-writes\n * `bridge_delivery` with no wrapper. The bridge-drain path always populates\n * it.\n *\n * `tenant_id` is emitted **unconditionally and nullable** (per JOB-8\n * 2026-04-20 reversal); enforcement is service-layer (BRIDGE-8) gated on the\n * `BRIDGE_MULTI_TENANT` DI token, not a DB constraint.\n *\n * Indexes:\n *   - `bridge_delivery_event_idx` — lookup all deliveries for an event.\n *   - `bridge_delivery_status_idx` — partial; ops dashboards filter by\n *     `pending | failed`.\n *   - `bridge_delivery_user_run_idx` — partial; reverse lookup from a\n *     spawned user run back to its delivery row.\n *\n * No service logic, no DI wiring — this is the schema foundation. Backends\n * (memory + drizzle) and the framework handler land in BRIDGE-3 / BRIDGE-4 /\n * BRIDGE-5.\n */\nimport {\n  index,\n  jsonb,\n  pgEnum,\n  pgTable,\n  text,\n  timestamp,\n  unique,\n  uuid,\n} from 'drizzle-orm/pg-core';\nimport { sql } from 'drizzle-orm';\nimport type { InferSelectModel } from 'drizzle-orm';\n\nimport { domainEvents } from '../events/domain-events.schema';\nimport { jobRuns } from '../jobs/job-orchestration.schema';\n\n// ─── Enum ───────────────────────────────────────────────────────────────────\n\nexport const bridgeDeliveryStatusEnum = pgEnum('bridge_delivery_status', [\n  'pending',\n  'delivered',\n  'skipped',\n  'failed',\n]);\n\n// ─── Table ──────────────────────────────────────────────────────────────────\n\nexport const bridgeDelivery = pgTable(\n  'bridge_delivery',\n  {\n    id: uuid('id').primaryKey().defaultRandom(),\n    /** FK to the source event in the outbox. */\n    eventId: uuid('event_id')\n      .notNull()\n      .references(() => domainEvents.id),\n    /**\n     * Stable codegen-emitted identifier for the (job, trigger) pair, of the\n     * form `<job_type>#<triggerIndex>` (BRIDGE-6). Forms the second half of\n     * the UNIQUE idempotency key.\n     */\n    triggerId: text('trigger_id').notNull(),\n    /**\n     * Wrapper `job_run.id` (the framework `@framework/bridge_delivery` run\n     * that drove this delivery). Nullable: the facade-eager path\n     * (`publishAndStart` Case B) pre-writes a delivered row with no wrapper.\n     */\n    wrapperRunId: uuid('wrapper_run_id').references(() => jobRuns.id),\n    /**\n     * Spawned user `job_run.id`. Null until status is `delivered`; remains\n     * null for `skipped` and `failed` deliveries.\n     */\n    userRunId: uuid('user_run_id').references(() => jobRuns.id),\n    status: bridgeDeliveryStatusEnum('status').notNull().default('pending'),\n    /** Populated when status=`skipped` (e.g. `'when_returned_false'`, `'trigger_unregistered'`). */\n    skipReason: text('skip_reason'),\n    /** Populated when status=`failed`. Mirrors `job_run.error` shape. */\n    error: jsonb('error').$type<Record<string, unknown>>(),\n    /**\n     * Emitted unconditionally and nullable (JOB-8 / SYNC-6 precedent).\n     * Enforcement gated on `BRIDGE_MULTI_TENANT` at the service layer\n     * (BRIDGE-8); no DB constraint.\n     */\n    tenantId: text('tenant_id'),\n    attemptedAt: timestamp('attempted_at', { withTimezone: true })\n      .notNull()\n      .defaultNow(),\n    deliveredAt: timestamp('delivered_at', { withTimezone: true }),\n  },\n  (t) => ({\n    /**\n     * Idempotency ledger. Outbox replays and facade-vs-drain collisions both\n     * dedup through this constraint.\n     */\n    uqBridgeDeliveryEventTrigger: unique('uq_bridge_delivery_event_trigger').on(\n      t.eventId,\n      t.triggerId,\n    ),\n    /** Lookup all deliveries for an event (fanout report, debugging). */\n    idxBridgeDeliveryEvent: index('idx_bridge_delivery_event').on(t.eventId),\n    /**\n     * Ops dashboard filter — only the actionable states. Partial index keeps\n     * it small at scale (the bulk of rows will be `delivered`).\n     */\n    idxBridgeDeliveryStatus: index('idx_bridge_delivery_status')\n      .on(t.status)\n      .where(sql`${t.status} IN ('pending','failed')`),\n    /**\n     * Reverse lookup from a spawned user run back to its delivery row.\n     * Partial — most rows in the bridge ledger but only successful\n     * deliveries have a `user_run_id`.\n     */\n    idxBridgeDeliveryUserRun: index('idx_bridge_delivery_user_run')\n      .on(t.userRunId)\n      .where(sql`${t.userRunId} IS NOT NULL`),\n  }),\n);\n\nexport type BridgeDeliveryRecord = InferSelectModel<typeof bridgeDelivery>;\n","/**\n * Drizzle schema for the domain_events outbox table.\n *\n * This table backs the DrizzleEventBus. Events are inserted within the\n * same database transaction as the domain write (outbox pattern). A\n * polling process reads unprocessed rows and dispatches to subscribers.\n *\n * First-class routing columns (EVT-1):\n *   - `pool`       — populated by DrizzleEventBus.publish() (EVT-4); enables\n *                    pool-filtered drain queries without unpacking metadata JSON.\n *   - `direction`  — `inbound` | `change` | `outbound`; mirrors the routing\n *                    dimension used by jobs' reserved `events_inbound` /\n *                    `events_change` / `events_outbound` pools.\n *   - `tenant_id`  — conditional: emitted only when `events.multi_tenant: true`\n *                    in `codegen.config.yaml`. The runtime source declares it\n *                    unconditionally; EVT-8's scaffold template handles the\n *                    config-driven include/exclude.\n *\n * The `metadata` JSON column continues to carry these values for protocol\n * stability; the first-class columns are an optimization for drain filtering.\n *\n * Indexes (declared below in the index callback):\n *   - (status, occurred_at)             — polling drain filter\n *   - (aggregate_id, aggregate_type)    — event replay per aggregate\n *   - (pool, status, occurred_at)       — per-pool drain filter (EVT-1)\n */\nimport {\n  index,\n  jsonb,\n  pgTable,\n  text,\n  timestamp,\n  uuid,\n} from 'drizzle-orm/pg-core';\nimport type { InferSelectModel } from 'drizzle-orm';\n\nexport const domainEvents = pgTable(\n  'domain_events',\n  {\n    id: uuid('id').primaryKey(),\n    type: text('type').notNull(),\n    aggregateId: text('aggregate_id').notNull(),\n    aggregateType: text('aggregate_type').notNull(),\n    payload: jsonb('payload').notNull().$type<Record<string, unknown>>(),\n    occurredAt: timestamp('occurred_at', { withTimezone: true }).notNull(),\n    processedAt: timestamp('processed_at', { withTimezone: true }),\n    /** Lifecycle status: pending | processed | failed */\n    status: text('status').notNull().default('pending'),\n    /** Error message from the last failed dispatch attempt. */\n    error: text('error'),\n    metadata: jsonb('metadata').$type<Record<string, unknown>>(),\n    /** Routing pool (e.g. `events_inbound`, `events_change`, `events_outbound`). Populated by DrizzleEventBus.publish() in EVT-4. */\n    pool: text('pool'),\n    /** Routing direction: `inbound` | `change` | `outbound`. Populated by DrizzleEventBus.publish() in EVT-4. */\n    direction: text('direction'),\n    // conditional: emitted only when events.multi_tenant: true\n    tenantId: text('tenant_id'),\n  },\n  (t) => ({\n    /** Polling drain filter (existing — promoted from comment to declaration in EVT-1). */\n    idxDomainEventsStatusOccurredAt: index('idx_domain_events_status_occurred_at').on(\n      t.status,\n      t.occurredAt,\n    ),\n    /** Event replay per aggregate (existing — promoted from comment to declaration in EVT-1). */\n    idxDomainEventsAggregate: index('idx_domain_events_aggregate').on(\n      t.aggregateId,\n      t.aggregateType,\n    ),\n    /** Per-pool drain filter (EVT-1). Enables DrizzleEventBus to drain a single pool without scanning all events. */\n    idxDomainEventsPoolStatusOccurredAt: index(\n      'idx_domain_events_pool_status_occurred_at',\n    ).on(t.pool, t.status, t.occurredAt),\n  }),\n);\n\nexport type DomainEventRecord = InferSelectModel<typeof domainEvents>;\n","/**\n * Drizzle schema for the job orchestration domain (ADR-022).\n *\n * Three tables model the lifecycle of a durable job:\n *   - `job`       — definitions keyed by handler type (e.g. 'onboarding').\n *   - `job_run`   — one row per attempt to execute a job; worker claims\n *                   rows directly via SELECT ... FOR UPDATE SKIP LOCKED.\n *   - `job_step`  — individual steps within a run; memoises output for replay.\n *\n * Phase 1 ships only this layer. There is no `job_queue` table, no executor\n * port — see ADR-022 and `.claude/skills/jobs/SKILL.md` for the rationale.\n */\nimport {\n  pgEnum,\n  pgTable,\n  uuid,\n  text,\n  jsonb,\n  integer,\n  timestamp,\n  index,\n  uniqueIndex,\n} from 'drizzle-orm/pg-core';\nimport { sql } from 'drizzle-orm';\nimport type { InferSelectModel } from 'drizzle-orm';\n\n// ─── Internal $type<> helpers ───────────────────────────────────────────────\n// Annotation types for jsonb columns only. JOB-2 defines the public protocol\n// types; these remain private to this file.\n\ntype RetryPolicy = {\n  attempts: number;\n  backoff: 'fixed' | 'exponential';\n  baseMs: number;\n  nonRetryableErrors?: string[];\n};\n\ntype JobRunError = {\n  message: string;\n  stack?: string;\n  retryable: boolean;\n  attempt: number;\n};\n\n// ─── Enums ──────────────────────────────────────────────────────────────────\n\nexport const jobRunStatusEnum = pgEnum('job_run_status', [\n  'pending',\n  'running',\n  'waiting',\n  'completed',\n  'failed',\n  'timed_out',\n  'canceled',\n]);\n\n// extended in ADR-027: tool_call | llm_call | wait | checkpoint | message\nexport const jobStepKindEnum = pgEnum('job_step_kind', ['task']);\n\nexport const jobStepStatusEnum = pgEnum('job_step_status', [\n  'pending',\n  'running',\n  'completed',\n  'failed',\n  'skipped',\n]);\n\nexport const collisionModeEnum = pgEnum('job_collision_mode', [\n  'queue',\n  'reject',\n  'replace',\n]);\n\nexport const replayFromEnum = pgEnum('job_replay_from', [\n  'scratch',\n  'last_step',\n  'last_checkpoint',\n]);\n\nexport const parentClosePolicyEnum = pgEnum('job_parent_close_policy', [\n  'terminate',\n  'cancel',\n  'abandon',\n]);\n\n// Phase 3 placeholder — see ADR-025\nexport const waitKindEnum = pgEnum('job_wait_kind', ['signal']);\n\n// Phase 2 may add more sources; requires Atlas migration\nexport const triggerSourceEnum = pgEnum('job_trigger_source', [\n  'manual',\n  'schedule',\n  'event',\n  'parent',\n]);\n\n// ─── job ────────────────────────────────────────────────────────────────────\n\nexport const jobs = pgTable('job', {\n  type: text('type').primaryKey(),\n  version: integer('version').notNull().default(1),\n  pool: text('pool').notNull(),\n  scopeEntityType: text('scope_entity_type'),\n  retryPolicy: jsonb('retry_policy').notNull().$type<RetryPolicy>(),\n  timeoutMs: integer('timeout_ms'),\n  concurrencyKeyTemplate: text('concurrency_key_template'),\n  collisionMode: collisionModeEnum('collision_mode').notNull().default('queue'),\n  dedupeKeyTemplate: text('dedupe_key_template'),\n  dedupeWindowMs: integer('dedupe_window_ms'),\n  priorityDefault: integer('priority_default').notNull().default(0),\n  replayFrom: replayFromEnum('replay_from').notNull().default('last_checkpoint'),\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),\n});\n\nexport type JobDefinitionRow = InferSelectModel<typeof jobs>;\n\n// ─── job_run ────────────────────────────────────────────────────────────────\n\nexport const jobRuns = pgTable(\n  'job_run',\n  {\n    id: uuid('id').primaryKey().defaultRandom(),\n    jobType: text('job_type').notNull().references(() => jobs.type),\n    jobVersion: integer('job_version').notNull(),\n    parentRunId: uuid('parent_run_id').references((): any => jobRuns.id),\n    /**\n     * Service generates `id` client-side via randomUUID() and sets\n     * root_run_id = id for root runs (single INSERT, no self-FK race).\n     */\n    rootRunId: uuid('root_run_id').notNull(),\n    parentClosePolicy: parentClosePolicyEnum('parent_close_policy')\n      .notNull()\n      .default('terminate'),\n    scopeEntityType: text('scope_entity_type'),\n    scopeEntityId: text('scope_entity_id'),\n    tenantId: text('tenant_id'),\n    tags: jsonb('tags').notNull().default({}).$type<Record<string, string>>(),\n    pool: text('pool').notNull(),\n    priority: integer('priority').notNull().default(0),\n    concurrencyKey: text('concurrency_key'),\n    dedupeKey: text('dedupe_key'),\n    status: jobRunStatusEnum('status').notNull().default('pending'),\n    input: jsonb('input').notNull().$type<Record<string, unknown>>(),\n    output: jsonb('output').$type<Record<string, unknown>>(),\n    error: jsonb('error').$type<JobRunError>(),\n    triggerSource: triggerSourceEnum('trigger_source').notNull(),\n    triggerRef: text('trigger_ref'),\n    runAt: timestamp('run_at', { withTimezone: true }).notNull().defaultNow(),\n    startedAt: timestamp('started_at', { withTimezone: true }),\n    finishedAt: timestamp('finished_at', { withTimezone: true }),\n    claimedAt: timestamp('claimed_at', { withTimezone: true }),\n    attempts: integer('attempts').notNull().default(0),\n    // Phase 3 placeholder — see ADR-025\n    waitKind: waitKindEnum('wait_kind'),\n    // Phase 3 placeholder — see ADR-025\n    resumeToken: text('resume_token'),\n    // Phase 3 placeholder — see ADR-025\n    waitDeadline: timestamp('wait_deadline', { withTimezone: true }),\n    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),\n  },\n  (t) => ({\n    /** Claim query: ORDER BY priority DESC, run_at ASC. */\n    idxJobRunClaim: index('idx_job_run_claim').on(t.status, t.pool, t.runAt),\n    /** Tree traversal / cascade cancel. */\n    idxJobRunRoot: index('idx_job_run_root').on(t.rootRunId),\n    /** listForScope query. */\n    idxJobRunScope: index('idx_job_run_scope').on(t.scopeEntityType, t.scopeEntityId),\n    /** Idempotency collapse — partial index. */\n    idxJobRunDedupe: index('idx_job_run_dedupe')\n      .on(t.jobType, t.dedupeKey)\n      .where(sql`${t.dedupeKey} IS NOT NULL`),\n    /** Collision check — partial index. */\n    idxJobRunConcurrency: index('idx_job_run_concurrency')\n      .on(t.concurrencyKey)\n      .where(\n        sql`${t.concurrencyKey} IS NOT NULL AND ${t.status} IN ('pending','running')`,\n      ),\n  }),\n);\n\nexport type JobRunRow = InferSelectModel<typeof jobRuns>;\n\n// ─── job_step ───────────────────────────────────────────────────────────────\n\nexport const jobSteps = pgTable(\n  'job_step',\n  {\n    id: uuid('id').primaryKey().defaultRandom(),\n    jobRunId: uuid('job_run_id').notNull().references(() => jobRuns.id),\n    stepId: text('step_id').notNull(),\n    kind: jobStepKindEnum('kind').notNull().default('task'),\n    /**\n     * Monotonic within run. integer (max ~2B per run) is sufficient —\n     * downgraded from ADR-022's bigint; revisit only if a single run\n     * ever exceeds 2 billion steps.\n     */\n    seq: integer('seq').notNull(),\n    status: jobStepStatusEnum('status').notNull().default('pending'),\n    input: jsonb('input').$type<Record<string, unknown>>(),\n    /** Memoised on success for replay. */\n    output: jsonb('output').$type<Record<string, unknown>>(),\n    error: jsonb('error').$type<JobRunError>(),\n    attempts: integer('attempts').notNull().default(0),\n    startedAt: timestamp('started_at', { withTimezone: true }),\n    finishedAt: timestamp('finished_at', { withTimezone: true }),\n  },\n  (t) => ({\n    /** No duplicate step IDs per run. */\n    idxJobStepRunStep: uniqueIndex('idx_job_step_run_step').on(t.jobRunId, t.stepId),\n    /** Ordered timeline reads. */\n    idxJobStepTimeline: index('idx_job_step_timeline').on(t.jobRunId, t.seq),\n  }),\n);\n\nexport type JobStepRow = InferSelectModel<typeof jobSteps>;\n"],"mappings":";;;;;;;;;;;;;AA0CA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,SAAS,KAAK,IAAI,IAAI,OAAAA,YAAW;;;ACpC1B,IAAM,UAAU;;;AC8BvB;AAAA,EACE,SAAAC;AAAA,EACA,SAAAC;AAAA,EACA,UAAAC;AAAA,EACA,WAAAC;AAAA,EACA,QAAAC;AAAA,EACA,aAAAC;AAAA,EACA;AAAA,EACA,QAAAC;AAAA,OACK;AACP,SAAS,OAAAC,YAAW;;;AC5BpB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGA,IAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,IAAI,KAAK,IAAI,EAAE,WAAW;AAAA,IAC1B,MAAM,KAAK,MAAM,EAAE,QAAQ;AAAA,IAC3B,aAAa,KAAK,cAAc,EAAE,QAAQ;AAAA,IAC1C,eAAe,KAAK,gBAAgB,EAAE,QAAQ;AAAA,IAC9C,SAAS,MAAM,SAAS,EAAE,QAAQ,EAAE,MAA+B;AAAA,IACnE,YAAY,UAAU,eAAe,EAAE,cAAc,KAAK,CAAC,EAAE,QAAQ;AAAA,IACrE,aAAa,UAAU,gBAAgB,EAAE,cAAc,KAAK,CAAC;AAAA;AAAA,IAE7D,QAAQ,KAAK,QAAQ,EAAE,QAAQ,EAAE,QAAQ,SAAS;AAAA;AAAA,IAElD,OAAO,KAAK,OAAO;AAAA,IACnB,UAAU,MAAM,UAAU,EAAE,MAA+B;AAAA;AAAA,IAE3D,MAAM,KAAK,MAAM;AAAA;AAAA,IAEjB,WAAW,KAAK,WAAW;AAAA;AAAA,IAE3B,UAAU,KAAK,WAAW;AAAA,EAC5B;AAAA,EACA,CAAC,OAAO;AAAA;AAAA,IAEN,iCAAiC,MAAM,sCAAsC,EAAE;AAAA,MAC7E,EAAE;AAAA,MACF,EAAE;AAAA,IACJ;AAAA;AAAA,IAEA,0BAA0B,MAAM,6BAA6B,EAAE;AAAA,MAC7D,EAAE;AAAA,MACF,EAAE;AAAA,IACJ;AAAA;AAAA,IAEA,qCAAqC;AAAA,MACnC;AAAA,IACF,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU;AAAA,EACrC;AACF;;;AC9DA;AAAA,EACE;AAAA,EACA,WAAAC;AAAA,EACA,QAAAC;AAAA,EACA,QAAAC;AAAA,EACA,SAAAC;AAAA,EACA;AAAA,EACA,aAAAC;AAAA,EACA,SAAAC;AAAA,EACA;AAAA,OACK;AACP,SAAS,WAAW;AAuBb,IAAM,mBAAmB,OAAO,kBAAkB;AAAA,EACvD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGM,IAAM,kBAAkB,OAAO,iBAAiB,CAAC,MAAM,CAAC;AAExD,IAAM,oBAAoB,OAAO,mBAAmB;AAAA,EACzD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,oBAAoB,OAAO,sBAAsB;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,iBAAiB,OAAO,mBAAmB;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,wBAAwB,OAAO,2BAA2B;AAAA,EACrE;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGM,IAAM,eAAe,OAAO,iBAAiB,CAAC,QAAQ,CAAC;AAGvD,IAAM,oBAAoB,OAAO,sBAAsB;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAIM,IAAM,OAAOL,SAAQ,OAAO;AAAA,EACjC,MAAME,MAAK,MAAM,EAAE,WAAW;AAAA,EAC9B,SAAS,QAAQ,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;AAAA,EAC/C,MAAMA,MAAK,MAAM,EAAE,QAAQ;AAAA,EAC3B,iBAAiBA,MAAK,mBAAmB;AAAA,EACzC,aAAaC,OAAM,cAAc,EAAE,QAAQ,EAAE,MAAmB;AAAA,EAChE,WAAW,QAAQ,YAAY;AAAA,EAC/B,wBAAwBD,MAAK,0BAA0B;AAAA,EACvD,eAAe,kBAAkB,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,OAAO;AAAA,EAC5E,mBAAmBA,MAAK,qBAAqB;AAAA,EAC7C,gBAAgB,QAAQ,kBAAkB;AAAA,EAC1C,iBAAiB,QAAQ,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,CAAC;AAAA,EAChE,YAAY,eAAe,aAAa,EAAE,QAAQ,EAAE,QAAQ,iBAAiB;AAAA,EAC7E,WAAWE,WAAU,cAAc,EAAE,cAAc,KAAK,CAAC,EAAE,QAAQ,EAAE,WAAW;AAAA,EAChF,WAAWA,WAAU,cAAc,EAAE,cAAc,KAAK,CAAC,EAAE,QAAQ,EAAE,WAAW;AAClF,CAAC;AAMM,IAAM,UAAUJ;AAAA,EACrB;AAAA,EACA;AAAA,IACE,IAAIC,MAAK,IAAI,EAAE,WAAW,EAAE,cAAc;AAAA,IAC1C,SAASC,MAAK,UAAU,EAAE,QAAQ,EAAE,WAAW,MAAM,KAAK,IAAI;AAAA,IAC9D,YAAY,QAAQ,aAAa,EAAE,QAAQ;AAAA,IAC3C,aAAaD,MAAK,eAAe,EAAE,WAAW,MAAW,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,IAKnE,WAAWA,MAAK,aAAa,EAAE,QAAQ;AAAA,IACvC,mBAAmB,sBAAsB,qBAAqB,EAC3D,QAAQ,EACR,QAAQ,WAAW;AAAA,IACtB,iBAAiBC,MAAK,mBAAmB;AAAA,IACzC,eAAeA,MAAK,iBAAiB;AAAA,IACrC,UAAUA,MAAK,WAAW;AAAA,IAC1B,MAAMC,OAAM,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,MAA8B;AAAA,IACxE,MAAMD,MAAK,MAAM,EAAE,QAAQ;AAAA,IAC3B,UAAU,QAAQ,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC;AAAA,IACjD,gBAAgBA,MAAK,iBAAiB;AAAA,IACtC,WAAWA,MAAK,YAAY;AAAA,IAC5B,QAAQ,iBAAiB,QAAQ,EAAE,QAAQ,EAAE,QAAQ,SAAS;AAAA,IAC9D,OAAOC,OAAM,OAAO,EAAE,QAAQ,EAAE,MAA+B;AAAA,IAC/D,QAAQA,OAAM,QAAQ,EAAE,MAA+B;AAAA,IACvD,OAAOA,OAAM,OAAO,EAAE,MAAmB;AAAA,IACzC,eAAe,kBAAkB,gBAAgB,EAAE,QAAQ;AAAA,IAC3D,YAAYD,MAAK,aAAa;AAAA,IAC9B,OAAOE,WAAU,UAAU,EAAE,cAAc,KAAK,CAAC,EAAE,QAAQ,EAAE,WAAW;AAAA,IACxE,WAAWA,WAAU,cAAc,EAAE,cAAc,KAAK,CAAC;AAAA,IACzD,YAAYA,WAAU,eAAe,EAAE,cAAc,KAAK,CAAC;AAAA,IAC3D,WAAWA,WAAU,cAAc,EAAE,cAAc,KAAK,CAAC;AAAA,IACzD,UAAU,QAAQ,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC;AAAA;AAAA,IAEjD,UAAU,aAAa,WAAW;AAAA;AAAA,IAElC,aAAaF,MAAK,cAAc;AAAA;AAAA,IAEhC,cAAcE,WAAU,iBAAiB,EAAE,cAAc,KAAK,CAAC;AAAA,IAC/D,WAAWA,WAAU,cAAc,EAAE,cAAc,KAAK,CAAC,EAAE,QAAQ,EAAE,WAAW;AAAA,IAChF,WAAWA,WAAU,cAAc,EAAE,cAAc,KAAK,CAAC,EAAE,QAAQ,EAAE,WAAW;AAAA,EAClF;AAAA,EACA,CAAC,OAAO;AAAA;AAAA,IAEN,gBAAgBC,OAAM,mBAAmB,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK;AAAA;AAAA,IAEvE,eAAeA,OAAM,kBAAkB,EAAE,GAAG,EAAE,SAAS;AAAA;AAAA,IAEvD,gBAAgBA,OAAM,mBAAmB,EAAE,GAAG,EAAE,iBAAiB,EAAE,aAAa;AAAA;AAAA,IAEhF,iBAAiBA,OAAM,oBAAoB,EACxC,GAAG,EAAE,SAAS,EAAE,SAAS,EACzB,MAAM,MAAM,EAAE,SAAS,cAAc;AAAA;AAAA,IAExC,sBAAsBA,OAAM,yBAAyB,EAClD,GAAG,EAAE,cAAc,EACnB;AAAA,MACC,MAAM,EAAE,cAAc,oBAAoB,EAAE,MAAM;AAAA,IACpD;AAAA,EACJ;AACF;AAMO,IAAM,WAAWL;AAAA,EACtB;AAAA,EACA;AAAA,IACE,IAAIC,MAAK,IAAI,EAAE,WAAW,EAAE,cAAc;AAAA,IAC1C,UAAUA,MAAK,YAAY,EAAE,QAAQ,EAAE,WAAW,MAAM,QAAQ,EAAE;AAAA,IAClE,QAAQC,MAAK,SAAS,EAAE,QAAQ;AAAA,IAChC,MAAM,gBAAgB,MAAM,EAAE,QAAQ,EAAE,QAAQ,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMtD,KAAK,QAAQ,KAAK,EAAE,QAAQ;AAAA,IAC5B,QAAQ,kBAAkB,QAAQ,EAAE,QAAQ,EAAE,QAAQ,SAAS;AAAA,IAC/D,OAAOC,OAAM,OAAO,EAAE,MAA+B;AAAA;AAAA,IAErD,QAAQA,OAAM,QAAQ,EAAE,MAA+B;AAAA,IACvD,OAAOA,OAAM,OAAO,EAAE,MAAmB;AAAA,IACzC,UAAU,QAAQ,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC;AAAA,IACjD,WAAWC,WAAU,cAAc,EAAE,cAAc,KAAK,CAAC;AAAA,IACzD,YAAYA,WAAU,eAAe,EAAE,cAAc,KAAK,CAAC;AAAA,EAC7D;AAAA,EACA,CAAC,OAAO;AAAA;AAAA,IAEN,mBAAmB,YAAY,uBAAuB,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM;AAAA;AAAA,IAE/E,oBAAoBC,OAAM,uBAAuB,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG;AAAA,EACzE;AACF;;;AFxJO,IAAM,2BAA2BC,QAAO,0BAA0B;AAAA,EACvE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAIM,IAAM,iBAAiBC;AAAA,EAC5B;AAAA,EACA;AAAA,IACE,IAAIC,MAAK,IAAI,EAAE,WAAW,EAAE,cAAc;AAAA;AAAA,IAE1C,SAASA,MAAK,UAAU,EACrB,QAAQ,EACR,WAAW,MAAM,aAAa,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMnC,WAAWC,MAAK,YAAY,EAAE,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMtC,cAAcD,MAAK,gBAAgB,EAAE,WAAW,MAAM,QAAQ,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,IAKhE,WAAWA,MAAK,aAAa,EAAE,WAAW,MAAM,QAAQ,EAAE;AAAA,IAC1D,QAAQ,yBAAyB,QAAQ,EAAE,QAAQ,EAAE,QAAQ,SAAS;AAAA;AAAA,IAEtE,YAAYC,MAAK,aAAa;AAAA;AAAA,IAE9B,OAAOC,OAAM,OAAO,EAAE,MAA+B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMrD,UAAUD,MAAK,WAAW;AAAA,IAC1B,aAAaE,WAAU,gBAAgB,EAAE,cAAc,KAAK,CAAC,EAC1D,QAAQ,EACR,WAAW;AAAA,IACd,aAAaA,WAAU,gBAAgB,EAAE,cAAc,KAAK,CAAC;AAAA,EAC/D;AAAA,EACA,CAAC,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA,IAKN,8BAA8B,OAAO,kCAAkC,EAAE;AAAA,MACvE,EAAE;AAAA,MACF,EAAE;AAAA,IACJ;AAAA;AAAA,IAEA,wBAAwBC,OAAM,2BAA2B,EAAE,GAAG,EAAE,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA,IAKvE,yBAAyBA,OAAM,4BAA4B,EACxD,GAAG,EAAE,MAAM,EACX,MAAMC,OAAM,EAAE,MAAM,0BAA0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMjD,0BAA0BD,OAAM,8BAA8B,EAC3D,GAAG,EAAE,SAAS,EACd,MAAMC,OAAM,EAAE,SAAS,cAAc;AAAA,EAC1C;AACF;;;AFlFA,IAAM,gBAAgB;AAGtB,IAAM,sBAAsB;AAG5B,IAAM,kBAAkB;AAgBjB,IAAM,wBAAN,MAAqE;AAAA,EAK1E,YACoC,IACjB,WACjB;AAFkC;AACjB;AAEjB,SAAK,aAAa,KAAK,kBAAkB;AAGzC,SAAK,aAAa,oBAAI,KAAK;AAAA,EAC7B;AAAA,EAPoC;AAAA,EACjB;AAAA,EANF,SAAS,IAAI,OAAO,sBAAsB,IAAI;AAAA,EAC9C;AAAA,EACT;AAAA,EAYR,eAAqB;AACnB,SAAK,OAAO;AAAA,MACV,8CAA8C,KAAK,UAAU;AAAA,IAC/D;AACA,UAAM,QAAQ,YAAY,MAAM;AAC9B,WAAK,KAAK,KAAK;AAAA,IACjB,GAAG,KAAK,UAAU;AAGlB,UAAM,QAAQ;AACd,SAAK,UAAU,YAAY,eAAe,KAAK;AAAA,EACjD;AAAA,EAEA,kBAAwB;AACtB,QAAI,KAAK,UAAU,aAAa,EAAE,SAAS,aAAa,GAAG;AACzD,WAAK,UAAU,eAAe,aAAa;AAAA,IAC7C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAmC;AACvC,UAAM,cAAc,KAAK;AACzB,UAAM,YAAY,oBAAI,KAAK;AAC3B,SAAK,aAAa;AAElB,QAAI,OAA2B,CAAC;AAChC,QAAI;AACF,aAAO,MAAM,KAAK,OAAO,aAAa,SAAS;AAAA,IACjD,SAAS,KAAK;AACZ,WAAK,OAAO;AAAA,QACV,iCAAkC,IAAc,OAAO;AAAA,MACzD;AACA,aAAO,EAAE,aAAa,WAAW,MAAM,CAAC,EAAE;AAAA,IAC5C;AAEA,SAAK,KAAK,EAAE,aAAa,WAAW,KAAK,CAAC;AAC1C,WAAO,EAAE,aAAa,WAAW,KAAK;AAAA,EACxC;AAAA,EAEA,MAAc,OACZ,aACA,WAC6B;AAM7B,UAAM,iBAAiBC,gBAAqB,eAAe,WAAW,KAAK,eAAe,WAAW;AAErG,UAAM,SAAS,MAAM,KAAK,GACvB,OAAO;AAAA,MACN,QAAQ,eAAe;AAAA,MACvB,WAAW,aAAa;AAAA,MACxB,YAAY,eAAe;AAAA,MAC3B,OAAOA;AAAA,IACT,CAAC,EACA,KAAK,cAAc,EACnB,UAAU,cAAc,GAAG,eAAe,SAAS,aAAa,EAAE,CAAC,EACnE;AAAA,MACC;AAAA,QACE,GAAG,gBAAgB,WAAW;AAAA,QAC9BA,OAAM,cAAc,OAAO,SAAS;AAAA,MACtC;AAAA,IACF,EACC;AAAA,MACC,eAAe;AAAA,MACf,aAAa;AAAA,MACb,eAAe;AAAA,IACjB;AAEF,WAAO,OAAO,IAAI,CAAC,OAAO;AAAA,MACxB,QAAQ,EAAE;AAAA,MACV,WAAW,EAAE;AAAA,MACb,YAAY,EAAE;AAAA,MACd,OAAO,EAAE;AAAA,IACX,EAAE;AAAA,EACJ;AAAA,EAEQ,KAAK,MAA+B;AAC1C,QAAI,KAAK,KAAK,WAAW,GAAG;AAI1B,WAAK,OAAO;AAAA,QACV,qCAAqC,KAAK,YAAY,YAAY,CAAC,KAAK,KAAK,UAAU,YAAY,CAAC;AAAA,MACtG;AACA;AAAA,IACF;AAEA,UAAM,SAAS,KAAK,KAAK;AAAA,MACvB,CAAC,KAAK,MAAM;AACV,YAAI,EAAE,MAAM,KAAK,IAAI,EAAE,MAAM,KAAK,KAAK,EAAE;AACzC,eAAO;AAAA,MACT;AAAA,MACA,CAAC;AAAA,IACH;AAEA,UAAM,SAAS,KAAK,KACjB;AAAA,MACC,CAAC,MACC,GAAG,EAAE,SAAS,IAAI,EAAE,MAAM,GAAG,EAAE,aAAa,IAAI,EAAE,UAAU,KAAK,EAAE,IAAI,EAAE,KAAK;AAAA,IAClF,EACC,KAAK,GAAG;AAEX,SAAK,OAAO;AAAA,MACV,+BAA+B,KAAK,YAAY,YAAY,CAAC,KAAK,KAAK,UAAU,YAAY,CAAC,YAClF,KAAK,UAAU,MAAM,CAAC,YAAY,MAAM;AAAA,IACtD;AAAA,EACF;AAAA,EAEQ,oBAA4B;AAClC,UAAM,MAAM,QAAQ,IAAI,4BAA4B;AACpD,QAAI,CAAC,IAAK,QAAO;AACjB,UAAM,SAAS,OAAO,SAAS,KAAK,EAAE;AACtC,QAAI,CAAC,OAAO,SAAS,MAAM,KAAK,SAAS,iBAAiB;AACxD,UAAI,OAAO,sBAAsB,IAAI,EAAE;AAAA,QACrC,wCAAwC,GAAG,mBAAmB,eAAe,sBAC1D,mBAAmB;AAAA,MACxC;AACA,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AACF;AA9Ia,wBAAN;AAAA,EADN,WAAW;AAAA,EAOP,0BAAO,OAAO;AAAA,GANN;","names":["sql","index","jsonb","pgEnum","pgTable","text","timestamp","uuid","sql","pgTable","uuid","text","jsonb","timestamp","index","pgEnum","pgTable","uuid","text","jsonb","timestamp","index","sql","sql"]}

package/dist/runtime/subsystems/sync/sync-audit.schema.d.ts

@@ -340,7 +340,7 @@ declare const syncRuns: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "sync_runs";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "poll" | "cdc" | "webhook" | "manual" | "writeback";
+            data: "manual" | "poll" | "cdc" | "webhook" | "writeback";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -357,7 +357,7 @@ declare const syncRuns: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "sync_runs";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "success" | "failed" | "no_changes" | "running";
+            data: "running" | "failed" | "success" | "no_changes";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -639,7 +639,7 @@ declare const syncRunItems: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "sync_run_items";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "noop" | "created" | "updated" | "deleted";
+            data: "updated" | "noop" | "created" | "deleted";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -656,7 +656,7 @@ declare const syncRunItems: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "sync_run_items";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "success" | "failed" | "skipped";
+            data: "failed" | "skipped" | "success";
             driverParam: string;
             notNull: true;
             hasDefault: false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pattern-stack/codegen",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Entity-driven code generation for full-stack TypeScript applications",
   "license": "MIT",
   "type": "module",
@@ -75,6 +75,7 @@
     "@cubejs-client/core": ">=1.0.0",
     "@nestjs/common": "^10",
     "@nestjs/core": "^10",
+    "@nestjs/schedule": "^4.0.0 || ^5.0.0",
     "@nestjs/swagger": "^7.0.0 || ^8.0.0",
     "bullmq": ">=5.0.0",
     "class-transformer": ">=0.5.0",
@@ -91,6 +92,9 @@
     "@cubejs-client/core": {
       "optional": true
     },
+    "@nestjs/schedule": {
+      "optional": true
+    },
     "@nestjs/swagger": {
       "optional": true
     },
@@ -115,6 +119,7 @@
     "@cubejs-client/core": "^1.0.0",
     "@nestjs/common": "10",
     "@nestjs/core": "10",
+    "@nestjs/schedule": "^4.0.0",
     "@nestjs/testing": "^10",
     "@types/bun": "latest",
     "@types/ejs": "^3.1.5",

package/runtime/subsystems/index.ts

@@ -33,6 +33,29 @@ export { STORAGE } from './storage';
 export type { IStorageService } from './storage';
 export { StorageModule, LocalStorageBackend, MemoryStorageBackend } from './storage';
 
+// Observability (ADR-008, 5th subsystem)
+export { OBSERVABILITY, OBSERVABILITY_REPORTERS } from './observability';
+export type {
+  CursorSnapshot,
+  IObservabilityService,
+  JobRunFailure,
+  PoolDepth,
+  StatusHistogram,
+  SyncRunSummary,
+} from './observability';
+export {
+  ObservabilityModule,
+  DrizzleObservabilityService,
+  MemoryObservabilityService,
+  BridgeMetricsReporter,
+} from './observability';
+export type {
+  ObservabilityModuleOptions,
+  ObservabilityReporterOptions,
+  BridgeMetricsRow,
+  BridgeMetricsTick,
+} from './observability';
+
 // Auth
 export {
   ENCRYPTION_KEY,

package/runtime/subsystems/observability/index.ts

@@ -0,0 +1,35 @@
+/**
+ * Observability subsystem public API (ADR-008, 5th subsystem).
+ *
+ * Import token + protocol in services/controllers:
+ * ```typescript
+ * import { OBSERVABILITY, type IObservabilityService } from '@pattern-stack/codegen/runtime/subsystems/observability';
+ * ```
+ *
+ * Import the module in AppModule:
+ * ```typescript
+ * import { ObservabilityModule } from '@pattern-stack/codegen/runtime/subsystems/observability';
+ * ObservabilityModule.forRoot({ backend: 'drizzle', reporters: { bridgeMetrics: true } })
+ * ```
+ */
+export { OBSERVABILITY, OBSERVABILITY_REPORTERS } from './observability.tokens';
+export type {
+  CursorSnapshot,
+  IObservabilityService,
+  JobRunFailure,
+  PoolDepth,
+  StatusHistogram,
+  SyncRunSummary,
+} from './observability.protocol';
+export {
+  ObservabilityModule,
+  type ObservabilityModuleOptions,
+  type ObservabilityReporterOptions,
+} from './observability.module';
+export { DrizzleObservabilityService } from './observability.drizzle-backend';
+export { MemoryObservabilityService } from './observability.memory-backend';
+export {
+  BridgeMetricsReporter,
+  type BridgeMetricsRow,
+  type BridgeMetricsTick,
+} from './reporters/bridge-metrics.reporter';