@gobing-ai/ts-infra 0.4.28 → 0.4.30

package/README.md

@@ -7,7 +7,7 @@ Infrastructure backbone — typed event bus, queue/scheduler contracts, adapter
 `ts-infra` provides the subsystems that form the application backbone:
 
 | Subsystem | Module | Purpose |
-|-----------|--------|---------|
+| ----------- | -------- | --------- |
 | **Event Bus** | `event-bus/` | Typed pub/sub with sync + async dispatch, named async handlers, queue consumer bridge, lifecycle self-observability |
 | **Job Queue** | core + `/job-queue-db` | Queue interfaces in core; DB-backed enqueue/consume flow (`DBJobQueue`, `DBQueueConsumer`) via opt-in subpath; optional typed event emission |
 | **Scheduler** | core + scheduler subpaths | Scheduler contracts, registry, built-in actions, noop adapter in core; Node and Cloudflare adapters via opt-in subpaths |
@@ -326,6 +326,11 @@ export default {
 };
 ```
 
+**Cron support is deliberately minimal (task 0060 F7):** a positive millisecond number
+(`'60000'`), `'* * * * *'`, or `'*/N * * * *'` (N > 0). Any other expression — including a
+full 5-field cron like `'0 3 * * *'` — makes `register()` throw a `RangeError`; it never
+silently falls back to a 60s interval.
+
 ### API Client — typed HTTP with tracing
 
 ```ts
@@ -497,7 +502,6 @@ bun add @opentelemetry/sdk-trace-node @opentelemetry/sdk-metrics \
         @opentelemetry/exporter-metrics-otlp-http
 ```
 
-
 ### Application Bootstrap
 
 The application bootstrap API provides a deterministic lifecycle for wiring
@@ -606,6 +610,7 @@ billing:
 ```
 
 Config validators accept four shapes:
+
 - `{ safeParse(raw) → { success, data?, errors? } }` — Zod-compatible
 - `(raw) => TAppConfig` — bare function
 - `{ validate(raw) => TAppConfig }` — method form
@@ -640,6 +645,7 @@ await runCliApplication({
 ```
 
 Differences from `runNodeApplication`:
+
 - `start` returns `number | void` — the number becomes the exit code (void = 0)
 - On success, calls `app.stop('shutdown')` then `process.exit(code)`
 - On error, writes the message to stderr and exits 1 (after graceful teardown)
@@ -719,7 +725,7 @@ attached — land in the JSONL System Events log alongside the domain event itse
 **Six System Events prefixes and where they originate:**
 
 | Prefix | Source | Constructed when `events` is omitted |
-|--------|--------|---------------------------------------|
+| -------- | -------- | --------------------------------------- |
 | `bus.*` | `EventBus` lifecycle self-observability (the `lifecycleBus` itself) | always — `runApplication` creates it |
 | `api.*` | `APIClient` (`api.request.error`) | `new EventBus<ApiClientEvents>({ lifecycleBus })` (R5) |
 | `rule.*` | `RuleEngine` (rule-run structured observability) | `new EventBus<RuleEngineEvents>({ lifecycleBus })` (R2) |
@@ -788,6 +794,7 @@ The host forwards the optional teardown `reason` (a plain `string` on the core c
 `ApplicationStopReason` — `'manual' | 'signal' | 'error' | 'shutdown'` — at the app level)
 to every plugin's `onStop`/`onUnload`. Built-in service plugins use this for log context;
 the user-callback plugin delivers it to your `stop(app, reason)`.
+
 ```
 
 ### Graceful shutdown

package/dist/api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/api-client.js

@@ -112,6 +112,7 @@ export class APIClient {
             method,
             ...(status !== undefined ? { status } : {}),
             error,
+            severity: 'error',
         });
     }
     /**

package/dist/event-bus/event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/event-bus/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,KAAK,EAER,oBAAoB,EACpB,kBAAkB,EAElB,QAAQ,EAER,gBAAgB,EACnB,MAAM,SAAS,CAAC;AAQjB;;;GAGG;AACH,qBAAa,QAAQ,CAAC,OAAO,SAAS,QAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyD;IACtF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyD;IACvF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6C;IAC7E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6C;IAC/E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsC;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,kBAAkB,CAAK;gBACnB,IAAI,CAAC,EAAE;QACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,YAAY,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB;IAMD,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAQzF,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAS3F,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAmBjE,kBAAkB,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAgBtD,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoF7F,aAAa,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM;IAMjF,UAAU,IAAI,MAAM,EAAE;IAOtB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,iBAAiB;IAUzB,6EAA6E;IAC7E,OAAO,CAAC,4BAA4B;IAWpC;;;;;;;;;;;;OAYG;IACH,gBAAgB,IAAI,UAAU,CAAC,oBAAoB,CAAC;IAepD,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,oBAAoB;CAU/B"}
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/event-bus/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,KAAK,EAER,oBAAoB,EACpB,kBAAkB,EAElB,QAAQ,EAER,gBAAgB,EACnB,MAAM,SAAS,CAAC;AAQjB;;;GAGG;AACH,qBAAa,QAAQ,CAAC,OAAO,SAAS,QAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyD;IACtF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyD;IACvF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6C;IAC7E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6C;IAC/E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsC;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,kBAAkB,CAAK;gBACnB,IAAI,CAAC,EAAE;QACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,YAAY,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB;IAMD,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAQzF,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAS3F,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAmBjE,kBAAkB,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAgBtD,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4F7F,aAAa,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM;IAMjF,UAAU,IAAI,MAAM,EAAE;IAOtB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,iBAAiB;IAUzB,6EAA6E;IAC7E,OAAO,CAAC,4BAA4B;IAWpC;;;;;;;;;;;;OAYG;IACH,gBAAgB,IAAI,UAAU,CAAC,oBAAoB,CAAC;IAepD,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,oBAAoB;CAU/B"}

package/dist/event-bus/event-bus.js

@@ -146,7 +146,15 @@ export class EventBus {
         getEventbusEmitsTotal().add(1, { event: eventName });
         if (errors > 0)
             getEventbusErrorsTotal().add(errors, { event: eventName });
-        this.publishEmitDone({ event: eventName, syncCount, asyncCount, emitDurationMs: durationMs, errors, detail });
+        this.publishEmitDone({
+            event: eventName,
+            syncCount,
+            asyncCount,
+            emitDurationMs: durationMs,
+            errors,
+            detail,
+            severity: errors > 0 ? 'warning' : 'info',
+        });
         if (syncCount === 0 && asyncCount === 0) {
             busLogger().debug('emit with zero handlers', { event: eventName });
             this.publishEmitNoop(eventName);
@@ -246,7 +254,7 @@ export class EventBus {
     publishEmitNoop(event) {
         if (this.lifecycleBus) {
             try {
-                void this.lifecycleBus.emit('bus.emit.noop', { event });
+                void this.lifecycleBus.emit('bus.emit.noop', { event, severity: 'info' });
             }
             catch {
                 // Swallow.
@@ -255,7 +263,7 @@ export class EventBus {
     }
     publishHandlerError(event, mode, error) {
         if (this.lifecycleBus) {
-            const detail = { event, mode, error };
+            const detail = { event, mode, error, severity: 'error' };
             try {
                 void this.lifecycleBus.emit('bus.handler.error', detail);
             }
@@ -266,7 +274,7 @@ export class EventBus {
     }
     publishAsyncEnqueued(event, jobId, handlerCount) {
         if (this.lifecycleBus) {
-            const detail = { event, jobId, handlerCount };
+            const detail = { event, jobId, handlerCount, severity: 'info' };
             try {
                 void this.lifecycleBus.emit('bus.handler.async.enqueued', detail);
             }

package/dist/event-bus/types.d.ts

@@ -1,6 +1,7 @@
 /**
  * Event bus types — shared constraints for typed pub-sub.
  */
+import type { WithEventSeverity } from '@gobing-ai/ts-utils';
 /** Type constraint for event maps — keys are event names, values are listener signatures. */
 export type EventMap = Record<string, (...args: never[]) => void>;
 /** Options for subscribing to an event, including async dispatch mode. */
@@ -27,7 +28,7 @@ export interface AsyncEventJobPayload {
     handlerId: string;
 }
 /** Payload emitted on `bus.emit.done` after synchronous handlers complete. */
-export interface EmitDoneDetail {
+export interface EmitDoneDetail extends WithEventSeverity {
     event: string;
     syncCount: number;
     asyncCount: number;
@@ -36,13 +37,13 @@ export interface EmitDoneDetail {
     detail?: unknown;
 }
 /** Payload emitted on `bus.handler.error` when a handler throws. */
-export interface HandlerErrorDetail {
+export interface HandlerErrorDetail extends WithEventSeverity {
     event: string;
     mode: 'sync' | 'async';
     error: string;
 }
 /** Payload emitted on `bus.handler.async.enqueued` when async handlers are scheduled. */
-export interface AsyncEnqueuedDetail {
+export interface AsyncEnqueuedDetail extends WithEventSeverity {
     event: string;
     jobId: string;
     handlerCount: number;
@@ -52,7 +53,7 @@ export type BusLifecycleEvents = {
     'bus.emit.done': (detail: EmitDoneDetail) => void;
     'bus.emit.noop': (detail: {
         event: string;
-    }) => void;
+    } & WithEventSeverity) => void;
     'bus.handler.error': (detail: HandlerErrorDetail) => void;
     'bus.handler.async.enqueued': (detail: AsyncEnqueuedDetail) => void;
 };

package/dist/event-bus/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/event-bus/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6FAA6F;AAC7F,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC;AAElE,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC7B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACjC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;CACrB;AAID,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG;IAC7B,eAAe,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,eAAe,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACrD,mBAAmB,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC1D,4BAA4B,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACvE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/event-bus/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,6FAA6F;AAC7F,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC;AAElE,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC7B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACjC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;CACrB;AAID,8EAA8E;AAC9E,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,yFAAyF;AACzF,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG;IAC7B,eAAe,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,eAAe,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,KAAK,IAAI,CAAC;IACzE,mBAAmB,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC1D,4BAA4B,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACvE,CAAC"}

package/dist/events.d.ts

@@ -17,9 +17,11 @@
  * Consume via `EventBus<InfraEvents>` or compose individual maps into a wider
  * app event map.
  */
+import type { EventSeverity, WithEventSeverity } from '@gobing-ai/ts-utils';
 import type { QueueStats } from './job-queue/types';
+export type { EventSeverity, WithEventSeverity };
 /** Payload for `db.connection.error`. */
-export interface DbConnectionErrorDetail {
+export interface DbConnectionErrorDetail extends WithEventSeverity {
     /** Error message. */
     error: string;
     /** Adapter type (e.g. 'sqlite', 'd1'). */
@@ -33,7 +35,7 @@ export interface QueueJobRef {
     type: string;
 }
 /** Payload for `queue.job.enqueued` — a new job was added to the queue. */
-export interface QueueJobEnqueuedDetail extends QueueJobRef {
+export interface QueueJobEnqueuedDetail extends QueueJobRef, WithEventSeverity {
     /** Epoch ms when the job was enqueued. */
     enqueuedAt: number;
     /** Max retry count from `EnqueueOptions.maxRetries`, when supplied. */
@@ -44,7 +46,7 @@ export interface QueueJobEnqueuedDetail extends QueueJobRef {
     ttlMs?: number;
 }
 /** Payload for `queue.consumer.started` — the polling loop began. */
-export interface QueueConsumerStartedDetail {
+export interface QueueConsumerStartedDetail extends WithEventSeverity {
     /** Epoch ms when the consumer was started. */
     startedAt: number;
     /** Polling interval in ms. */
@@ -57,7 +59,7 @@ export interface QueueConsumerStartedDetail {
     visibilityTimeout: number;
 }
 /** Payload for `queue.consumer.stopped` — the polling loop was halted. */
-export interface QueueConsumerStoppedDetail {
+export interface QueueConsumerStoppedDetail extends WithEventSeverity {
     /** Epoch ms when `stop()` was called. */
     stoppedAt: number;
     /** Drain deadline in ms applied to in-flight handlers at stop time. */
@@ -68,14 +70,14 @@ export interface QueueConsumerStoppedDetail {
     drained: boolean;
 }
 /** Payload for `queue.job.completed` — a job ran to success. */
-export interface QueueJobCompletedDetail extends QueueJobRef {
+export interface QueueJobCompletedDetail extends QueueJobRef, WithEventSeverity {
     /** Handler wall-clock duration in ms. */
     durationMs: number;
     /** Attempts counter on the job row at success (0 on the first successful run). */
     attempt: number;
 }
 /** Payload for `queue.job.failed` — a job exhausted retries. */
-export interface QueueJobFailedDetail extends QueueJobRef {
+export interface QueueJobFailedDetail extends QueueJobRef, WithEventSeverity {
     /** Error message from the final attempt. */
     error: string;
     /** 1-based attempt number of the failure. */
@@ -86,7 +88,7 @@ export interface QueueJobFailedDetail extends QueueJobRef {
     durationMs?: number;
 }
 /** Payload for `queue.job.retrying` — a job will be retried after backoff. */
-export interface QueueJobRetryingDetail extends QueueJobRef {
+export interface QueueJobRetryingDetail extends QueueJobRef, WithEventSeverity {
     /** 1-based attempt number of the failure that triggers this retry. */
     attempt: number;
     /** Maximum retry count configured for the job. */
@@ -97,7 +99,7 @@ export interface QueueJobRetryingDetail extends QueueJobRef {
     error: string;
 }
 /** Payload for `scheduler.job.executed`. */
-export interface SchedulerJobExecutedDetail {
+export interface SchedulerJobExecutedDetail extends WithEventSeverity {
     /** Job name. */
     name: string;
     /** Wall-clock duration in milliseconds. */
@@ -106,7 +108,7 @@ export interface SchedulerJobExecutedDetail {
     error?: string;
 }
 /** Payload for `api.request.error`. */
-export interface ApiRequestErrorDetail {
+export interface ApiRequestErrorDetail extends WithEventSeverity {
     url: string;
     method: string;
     /** HTTP status code, if a response was received. */
@@ -135,7 +137,7 @@ export type QueueEvents = {
     /** A job will be retried after backoff. */
     'queue.job.retrying': (detail: QueueJobRetryingDetail) => void;
     /** Queue depth snapshot emitted on a poll cycle. */
-    'queue.stats': (detail: QueueStats) => void;
+    'queue.stats': (detail: QueueStats & WithEventSeverity) => void;
 };
 /** Scheduler events emitted by scheduler adapters and the handler wrapper. */
 export type SchedulerEvents = {

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { APIClient, type APIClientConfig, APIError, type RawHttpResponse, type RawRequestOptions, type RequestOptions, } from './api-client';
 export { type AsyncEventJobPayload, attachDefaultObservers, attachFileObserver, attachLogObserver, attachTelemetryObserver, type BusLifecycleEvents, createLifecycleBus, EventBus, type EventMap, type FileObserverWriter, type SubscribeOptions, } from './event-bus/index';
-export type { ApiClientEvents, ApiRequestErrorDetail, DbConnectionErrorDetail, DbEvents, InfraEvents, QueueConsumerStartedDetail, QueueConsumerStoppedDetail, QueueEvents, QueueJobCompletedDetail, QueueJobEnqueuedDetail, QueueJobFailedDetail, QueueJobRef, QueueJobRetryingDetail, SchedulerEvents, SchedulerJobExecutedDetail, } from './events';
+export type { ApiClientEvents, ApiRequestErrorDetail, DbConnectionErrorDetail, DbEvents, EventSeverity, InfraEvents, QueueConsumerStartedDetail, QueueConsumerStoppedDetail, QueueEvents, QueueJobCompletedDetail, QueueJobEnqueuedDetail, QueueJobFailedDetail, QueueJobRef, QueueJobRetryingDetail, SchedulerEvents, SchedulerJobExecutedDetail, WithEventSeverity, } from './events';
 export type { EnqueueOptions, Job, JobHandler, JobQueue, QueueConsumer, QueueConsumerConfig, QueueStats, } from './job-queue/index';
 export { getLogger, type InitLoggerOptions, initializeLogger, type Logger, type LogLevel, setLoggerMuted, } from './logger';
 export { ActionRegistry, type CreateDefaultRegistryOptions, createDefaultRegistry, HealthPingAction, type HealthPingWriter, initScheduler, LogAction, NoopSchedulerAdapter, QueueStatsAction, type QueueStatsDaoProvider, type ScheduledAction, type SchedulerAction, type SchedulerAdapter, toScheduledAction, wrapScheduledHandler, } from './scheduler/index';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,SAAS,EACT,KAAK,eAAe,EACpB,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,KAAK,oBAAoB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACR,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,QAAQ,EACR,WAAW,EACX,0BAA0B,EAC1B,0BAA0B,EAC1B,WAAW,EACX,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,0BAA0B,GAC7B,MAAM,UAAU,CAAC;AAElB,YAAY,EACR,cAAc,EACd,GAAG,EACH,UAAU,EACV,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,UAAU,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,SAAS,EACT,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,cAAc,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACH,cAAc,EACd,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,oBAAoB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,UAAU,EACV,SAAS,EACT,QAAQ,GACX,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,SAAS,EACT,KAAK,eAAe,EACpB,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,KAAK,oBAAoB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACR,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,QAAQ,EACR,aAAa,EACb,WAAW,EACX,0BAA0B,EAC1B,0BAA0B,EAC1B,WAAW,EACX,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,0BAA0B,EAC1B,iBAAiB,GACpB,MAAM,UAAU,CAAC;AAElB,YAAY,EACR,cAAc,EACd,GAAG,EACH,UAAU,EACV,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,UAAU,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,SAAS,EACT,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,cAAc,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACH,cAAc,EACd,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,oBAAoB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,UAAU,EACV,SAAS,EACT,QAAQ,GACX,MAAM,mBAAmB,CAAC"}

package/dist/job-queue/db-job-queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-job-queue.d.ts","sourceRoot":"","sources":["../../src/job-queue/db-job-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAkB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAER,WAAW,EAKd,MAAM,WAAW,CAAC;AAUnB,OAAO,KAAK,EAAE,cAAc,EAAO,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAQ7G,kFAAkF;AAClF,qBAAa,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAEnD,QAAQ,CAAC,GAAG,EAAE,WAAW;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBADf,GAAG,EAAE,WAAW,EACR,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,YAAA;IAG7C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5E,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,CAAA;KAAE,GAAG,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY3F,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;CAGrC;AAcD,qFAAqF;AACrF,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAgB7D,OAAO,CAAC,QAAQ,CAAC,GAAG;IAfxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAA8B;gBAG5B,GAAG,EAAE,WAAW,EACjC,MAAM,GAAE,mBAAwB;IAYpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAI9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCrB,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAIlC,sFAAsF;IAChF,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BpC,OAAO,CAAC,QAAQ;YAWF,IAAI;YAgBJ,UAAU;YA6CV,WAAW;CAmC5B"}
+{"version":3,"file":"db-job-queue.d.ts","sourceRoot":"","sources":["../../src/job-queue/db-job-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAkB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAER,WAAW,EAKd,MAAM,WAAW,CAAC;AAUnB,OAAO,KAAK,EAAE,cAAc,EAAO,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAQ7G,kFAAkF;AAClF,qBAAa,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAEnD,QAAQ,CAAC,GAAG,EAAE,WAAW;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBADf,GAAG,EAAE,WAAW,EACR,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,YAAA;IAG7C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5E,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,CAAA;KAAE,GAAG,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY3F,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;CAGrC;AAcD,qFAAqF;AACrF,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAgB7D,OAAO,CAAC,QAAQ,CAAC,GAAG;IAfxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAA8B;gBAG5B,GAAG,EAAE,WAAW,EACjC,MAAM,GAAE,mBAAwB;IAYpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAI9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCrB,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAIlC,sFAAsF;IAChF,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BpC,OAAO,CAAC,QAAQ;YAWF,IAAI;YAgBJ,UAAU;YA8CV,WAAW;CAqC5B"}

package/dist/job-queue/db-job-queue.js

@@ -42,7 +42,7 @@ export class DBJobQueue {
  * fields only when supplied. Shared by single and batch enqueue so both emit one shape.
  */
 function enqueuedDetail(jobId, type, options) {
-    const detail = { jobId, type, enqueuedAt: Date.now() };
+    const detail = { jobId, type, enqueuedAt: Date.now(), severity: 'info' };
     if (options && options.maxRetries !== undefined)
         detail.maxRetries = options.maxRetries;
     if (options && options.delay !== undefined)
@@ -92,6 +92,7 @@ export class DBQueueConsumer {
             batchSize: this.batchSize,
             maxConcurrency: this.maxConcurrency,
             visibilityTimeout: this.visibilityTimeout,
+            severity: 'info',
         });
     }
     async stop() {
@@ -115,11 +116,13 @@ export class DBQueueConsumer {
             await sleep(10);
         }
         if (wasRunning) {
+            const drained = this.inFlight === 0;
             const detail = {
                 stoppedAt: Date.now(),
                 drainTimeoutMs: this.drainTimeoutMs,
                 inFlightAtStop: this.inFlight,
-                drained: this.inFlight === 0,
+                drained,
+                severity: drained ? 'info' : 'warning',
             };
             await this.events?.emit('queue.consumer.stopped', detail);
         }
@@ -215,6 +218,7 @@ export class DBQueueConsumer {
                     type: job.type,
                     durationMs: Number.isFinite(durationMs) ? durationMs : 0,
                     attempt: job.attempts,
+                    severity: 'info',
                 };
                 await this.events?.emit('queue.job.completed', completed);
             }
@@ -238,6 +242,7 @@ export class DBQueueConsumer {
                 attempt: attempts,
                 maxRetries: job.maxRetries,
                 durationMs,
+                severity: 'error',
             };
             await this.events?.emit('queue.job.failed', failed);
             return;
@@ -252,6 +257,7 @@ export class DBQueueConsumer {
             maxRetries: job.maxRetries,
             nextRetryAt,
             error: message,
+            severity: 'warning',
         };
         await this.events?.emit('queue.job.retrying', retrying);
     }

package/dist/scheduler/action.js

@@ -70,7 +70,7 @@ export class QueueStatsAction {
         const dao = await this.daoProvider();
         const stats = await dao.getStats();
         logger.info('Queue stats snapshot', { action: this.name, ...stats });
-        await this.systemBus?.emit('queue.stats', stats);
+        await this.systemBus?.emit('queue.stats', { ...stats, severity: 'info' });
     }
 }
 /**

package/dist/scheduler/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/scheduler/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAoCjE,4DAA4D;AAC5D,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAEzC,MAAM,GAAE,0BAA+B;IAUnD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAU/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,OAAO,CAAC,UAAU;YAiBJ,gBAAgB;CAYjC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/scheduler/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA2CjE,4DAA4D;AAC5D,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAEzC,MAAM,GAAE,0BAA+B;IAUnD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAa/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,OAAO,CAAC,UAAU;YAiBJ,gBAAgB;CAYjC"}

package/dist/scheduler/node.js

@@ -3,7 +3,6 @@
  * No external cron library dependency — cron expressions are parsed minimally.
  */
 import { settleWithin } from '../internals/drain.js';
-import { getLogger } from '../logger.js';
 import { getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, } from '../telemetry/metrics.js';
 /** Simple helper to parse cron-like interval strings into milliseconds. */
 function parseInterval(cron) {
@@ -18,19 +17,23 @@ function parseInterval(cron) {
     }
     else {
         const parts = trimmed.split(/\s+/);
-        if (parts.length === 5 && parts[0] === '*') {
-            return 60_000; // every minute
+        // Only the documented 5-field forms are every-N-minutes: "* * * * *" and
+        // "*/N * * * *". A first-field wildcard alone ("* 3 * * *") is real cron
+        // and must not silently fire every 60s (task 0060 F7).
+        const restWild = parts.length === 5 && parts[1] === '*' && parts[2] === '*' && parts[3] === '*' && parts[4] === '*';
+        if (restWild && parts[0] === '*') {
+            return 60_000;
         }
-        // */N pattern
-        const match = parts[0]?.match(/^\*\/(\d+)$/);
+        const nField = restWild ? parts[0] : parts.length === 1 ? parts[0] : undefined;
+        const match = nField?.match(/^\*\/(\d+)$/);
         if (match && Number(match[1]) > 0) {
             return Number(match[1]) * 60_000;
         }
     }
-    // Real cron field expressions ("0 3 * * *") are NOT supported — running
-    // them every minute silently would badly misfire, so warn on fallback.
-    getLogger('scheduler.node').warn('Unsupported cron expression — falling back to a 60s interval', { cron });
-    return 60_000;
+    // Real cron field expressions ("0 3 * * *") are NOT supported — silently running
+    // them every minute would badly misfire. 0032 made that a warn; task 0060 F7 makes
+    // it a hard error so an unsupported schedule can never fire at the wrong cadence.
+    throw new RangeError(`Unsupported cron expression: "${cron}" — supported forms are a positive millisecond number, "* * * * *", or "*/N * * * *" with N > 0`);
 }
 /**
  * Scheduler adapter for Node.js using a setInterval-based approach.
@@ -53,6 +56,9 @@ export class NodeSchedulerAdapter {
         this.drainTimeoutMs = drainTimeoutMs ?? 30_000;
     }
     register(cron, action) {
+        // Fail at registration time: an unsupported expression must never reach start(),
+        // where it would otherwise create a silently-wrong interval (task 0060 F7).
+        parseInterval(cron);
         this.entries.push({ cron, action });
         if (this.running) {
             const last = this.entries[this.entries.length - 1];

package/dist/scheduler/wrap-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-handler.d.ts","sourceRoot":"","sources":["../../src/scheduler/wrap-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,GAC7C,eAAe,CA2BjB"}
+{"version":3,"file":"wrap-handler.d.ts","sourceRoot":"","sources":["../../src/scheduler/wrap-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,GAC7C,eAAe,CA4BjB"}

package/dist/scheduler/wrap-handler.js

@@ -38,6 +38,7 @@ export function wrapScheduledHandler(name, action, systemBus) {
                     name,
                     durationMs,
                     ...(execError !== undefined ? { error: execError } : {}),
+                    severity: execError !== undefined ? 'error' : 'info',
                 });
             }
         });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-infra",
-    "version": "0.4.28",
+    "version": "0.4.30",
     "description": "@gobing-ai/ts-infra — Infrastructure backbone: event bus, job queue, scheduler, telemetry, API client, and logging.",
     "keywords": [
         "typescript",
@@ -78,12 +78,12 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-infra-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-utils": "^0.4.28",
+        "@gobing-ai/ts-utils": "^0.4.30",
         "@logtape/logtape": "^2.0.0"
     },
     "peerDependencies": {
-        "@gobing-ai/ts-db": "^0.4.28",
-        "@gobing-ai/ts-runtime": "^0.4.28",
+        "@gobing-ai/ts-db": "^0.4.30",
+        "@gobing-ai/ts-runtime": "^0.4.30",
         "@opentelemetry/api": "^1.9.0",
         "@opentelemetry/sdk-trace-node": "^2.0.0",
         "@opentelemetry/sdk-metrics": "^2.0.0",
@@ -116,8 +116,8 @@
         }
     },
     "devDependencies": {
-        "@gobing-ai/ts-db": "^0.4.28",
-        "@gobing-ai/ts-runtime": "^0.4.28",
+        "@gobing-ai/ts-db": "^0.4.30",
+        "@gobing-ai/ts-runtime": "^0.4.30",
         "@types/bun": "1.3.14",
         "@opentelemetry/api": "^1.9.0",
         "@opentelemetry/sdk-trace-node": "^2.0.0",

package/src/api-client.ts

@@ -176,6 +176,7 @@ export class APIClient {
             method,
             ...(status !== undefined ? { status } : {}),
             error,
+            severity: 'error',
         });
     }
 

package/src/event-bus/event-bus.ts

@@ -168,7 +168,15 @@ export class EventBus<TEvents extends EventMap> {
         getEventbusEmitsTotal().add(1, { event: eventName });
         if (errors > 0) getEventbusErrorsTotal().add(errors, { event: eventName });
 
-        this.publishEmitDone({ event: eventName, syncCount, asyncCount, emitDurationMs: durationMs, errors, detail });
+        this.publishEmitDone({
+            event: eventName,
+            syncCount,
+            asyncCount,
+            emitDurationMs: durationMs,
+            errors,
+            detail,
+            severity: errors > 0 ? 'warning' : 'info',
+        });
 
         if (syncCount === 0 && asyncCount === 0) {
             busLogger().debug('emit with zero handlers', { event: eventName });
@@ -279,7 +287,7 @@ export class EventBus<TEvents extends EventMap> {
     private publishEmitNoop(event: string): void {
         if (this.lifecycleBus) {
             try {
-                void this.lifecycleBus.emit('bus.emit.noop', { event });
+                void this.lifecycleBus.emit('bus.emit.noop', { event, severity: 'info' });
             } catch {
                 // Swallow.
             }
@@ -288,7 +296,7 @@ export class EventBus<TEvents extends EventMap> {
 
     private publishHandlerError(event: string, mode: 'sync' | 'async', error: string): void {
         if (this.lifecycleBus) {
-            const detail: HandlerErrorDetail = { event, mode, error };
+            const detail: HandlerErrorDetail = { event, mode, error, severity: 'error' };
             try {
                 void this.lifecycleBus.emit('bus.handler.error', detail);
             } catch {
@@ -299,7 +307,7 @@ export class EventBus<TEvents extends EventMap> {
 
     private publishAsyncEnqueued(event: string, jobId: string, handlerCount: number): void {
         if (this.lifecycleBus) {
-            const detail: AsyncEnqueuedDetail = { event, jobId, handlerCount };
+            const detail: AsyncEnqueuedDetail = { event, jobId, handlerCount, severity: 'info' };
             try {
                 void this.lifecycleBus.emit('bus.handler.async.enqueued', detail);
             } catch {

package/src/event-bus/types.ts

@@ -2,6 +2,8 @@
  * Event bus types — shared constraints for typed pub-sub.
  */
 
+import type { WithEventSeverity } from '@gobing-ai/ts-utils';
+
 /** Type constraint for event maps — keys are event names, values are listener signatures. */
 export type EventMap = Record<string, (...args: never[]) => void>;
 
@@ -33,7 +35,7 @@ export interface AsyncEventJobPayload {
 // ── Lifecycle events ────────────────────────────────────────────────
 
 /** Payload emitted on `bus.emit.done` after synchronous handlers complete. */
-export interface EmitDoneDetail {
+export interface EmitDoneDetail extends WithEventSeverity {
     event: string;
     syncCount: number;
     asyncCount: number;
@@ -43,14 +45,14 @@ export interface EmitDoneDetail {
 }
 
 /** Payload emitted on `bus.handler.error` when a handler throws. */
-export interface HandlerErrorDetail {
+export interface HandlerErrorDetail extends WithEventSeverity {
     event: string;
     mode: 'sync' | 'async';
     error: string;
 }
 
 /** Payload emitted on `bus.handler.async.enqueued` when async handlers are scheduled. */
-export interface AsyncEnqueuedDetail {
+export interface AsyncEnqueuedDetail extends WithEventSeverity {
     event: string;
     jobId: string;
     handlerCount: number;
@@ -59,7 +61,7 @@ export interface AsyncEnqueuedDetail {
 /** Strongly-typed lifecycle events emitted by the event bus. */
 export type BusLifecycleEvents = {
     'bus.emit.done': (detail: EmitDoneDetail) => void;
-    'bus.emit.noop': (detail: { event: string }) => void;
+    'bus.emit.noop': (detail: { event: string } & WithEventSeverity) => void;
     'bus.handler.error': (detail: HandlerErrorDetail) => void;
     'bus.handler.async.enqueued': (detail: AsyncEnqueuedDetail) => void;
 };

package/src/events.ts

@@ -18,12 +18,15 @@
  * app event map.
  */
 
+import type { EventSeverity, WithEventSeverity } from '@gobing-ai/ts-utils';
 import type { QueueStats } from './job-queue/types';
 
+export type { EventSeverity, WithEventSeverity };
+
 // ── Detail payloads ────────────────────────────────────────────────────────
 
 /** Payload for `db.connection.error`. */
-export interface DbConnectionErrorDetail {
+export interface DbConnectionErrorDetail extends WithEventSeverity {
     /** Error message. */
     error: string;
     /** Adapter type (e.g. 'sqlite', 'd1'). */
@@ -39,7 +42,7 @@ export interface QueueJobRef {
 }
 
 /** Payload for `queue.job.enqueued` — a new job was added to the queue. */
-export interface QueueJobEnqueuedDetail extends QueueJobRef {
+export interface QueueJobEnqueuedDetail extends QueueJobRef, WithEventSeverity {
     /** Epoch ms when the job was enqueued. */
     enqueuedAt: number;
     /** Max retry count from `EnqueueOptions.maxRetries`, when supplied. */
@@ -51,7 +54,7 @@ export interface QueueJobEnqueuedDetail extends QueueJobRef {
 }
 
 /** Payload for `queue.consumer.started` — the polling loop began. */
-export interface QueueConsumerStartedDetail {
+export interface QueueConsumerStartedDetail extends WithEventSeverity {
     /** Epoch ms when the consumer was started. */
     startedAt: number;
     /** Polling interval in ms. */
@@ -65,7 +68,7 @@ export interface QueueConsumerStartedDetail {
 }
 
 /** Payload for `queue.consumer.stopped` — the polling loop was halted. */
-export interface QueueConsumerStoppedDetail {
+export interface QueueConsumerStoppedDetail extends WithEventSeverity {
     /** Epoch ms when `stop()` was called. */
     stoppedAt: number;
     /** Drain deadline in ms applied to in-flight handlers at stop time. */
@@ -77,7 +80,7 @@ export interface QueueConsumerStoppedDetail {
 }
 
 /** Payload for `queue.job.completed` — a job ran to success. */
-export interface QueueJobCompletedDetail extends QueueJobRef {
+export interface QueueJobCompletedDetail extends QueueJobRef, WithEventSeverity {
     /** Handler wall-clock duration in ms. */
     durationMs: number;
     /** Attempts counter on the job row at success (0 on the first successful run). */
@@ -85,7 +88,7 @@ export interface QueueJobCompletedDetail extends QueueJobRef {
 }
 
 /** Payload for `queue.job.failed` — a job exhausted retries. */
-export interface QueueJobFailedDetail extends QueueJobRef {
+export interface QueueJobFailedDetail extends QueueJobRef, WithEventSeverity {
     /** Error message from the final attempt. */
     error: string;
     /** 1-based attempt number of the failure. */
@@ -97,7 +100,7 @@ export interface QueueJobFailedDetail extends QueueJobRef {
 }
 
 /** Payload for `queue.job.retrying` — a job will be retried after backoff. */
-export interface QueueJobRetryingDetail extends QueueJobRef {
+export interface QueueJobRetryingDetail extends QueueJobRef, WithEventSeverity {
     /** 1-based attempt number of the failure that triggers this retry. */
     attempt: number;
     /** Maximum retry count configured for the job. */
@@ -109,7 +112,7 @@ export interface QueueJobRetryingDetail extends QueueJobRef {
 }
 
 /** Payload for `scheduler.job.executed`. */
-export interface SchedulerJobExecutedDetail {
+export interface SchedulerJobExecutedDetail extends WithEventSeverity {
     /** Job name. */
     name: string;
     /** Wall-clock duration in milliseconds. */
@@ -119,7 +122,7 @@ export interface SchedulerJobExecutedDetail {
 }
 
 /** Payload for `api.request.error`. */
-export interface ApiRequestErrorDetail {
+export interface ApiRequestErrorDetail extends WithEventSeverity {
     url: string;
     method: string;
     /** HTTP status code, if a response was received. */
@@ -152,7 +155,7 @@ export type QueueEvents = {
     /** A job will be retried after backoff. */
     'queue.job.retrying': (detail: QueueJobRetryingDetail) => void;
     /** Queue depth snapshot emitted on a poll cycle. */
-    'queue.stats': (detail: QueueStats) => void;
+    'queue.stats': (detail: QueueStats & WithEventSeverity) => void;
 };
 
 /** Scheduler events emitted by scheduler adapters and the handler wrapper. */

package/src/index.ts

@@ -29,6 +29,7 @@ export type {
     ApiRequestErrorDetail,
     DbConnectionErrorDetail,
     DbEvents,
+    EventSeverity,
     InfraEvents,
     QueueConsumerStartedDetail,
     QueueConsumerStoppedDetail,
@@ -40,6 +41,7 @@ export type {
     QueueJobRetryingDetail,
     SchedulerEvents,
     SchedulerJobExecutedDetail,
+    WithEventSeverity,
 } from './events';
 
 export type {

package/src/job-queue/db-job-queue.ts

@@ -61,7 +61,7 @@ export class DBJobQueue<T = unknown> implements JobQueue<T> {
  * fields only when supplied. Shared by single and batch enqueue so both emit one shape.
  */
 function enqueuedDetail(jobId: string, type: string, options: EnqueueOptions | undefined): QueueJobEnqueuedDetail {
-    const detail: QueueJobEnqueuedDetail = { jobId, type, enqueuedAt: Date.now() };
+    const detail: QueueJobEnqueuedDetail = { jobId, type, enqueuedAt: Date.now(), severity: 'info' };
     if (options && options.maxRetries !== undefined) detail.maxRetries = options.maxRetries;
     if (options && options.delay !== undefined) detail.delayMs = options.delay;
     if (options && options.ttlMs !== undefined) detail.ttlMs = options.ttlMs;
@@ -112,6 +112,7 @@ export class DBQueueConsumer<T = unknown> implements QueueConsumer<T> {
             batchSize: this.batchSize,
             maxConcurrency: this.maxConcurrency,
             visibilityTimeout: this.visibilityTimeout,
+            severity: 'info',
         });
     }
 
@@ -139,11 +140,13 @@ export class DBQueueConsumer<T = unknown> implements QueueConsumer<T> {
             await sleep(10);
         }
         if (wasRunning) {
+            const drained = this.inFlight === 0;
             const detail: QueueConsumerStoppedDetail = {
                 stoppedAt: Date.now(),
                 drainTimeoutMs: this.drainTimeoutMs,
                 inFlightAtStop: this.inFlight,
-                drained: this.inFlight === 0,
+                drained,
+                severity: drained ? 'info' : 'warning',
             };
             await this.events?.emit('queue.consumer.stopped', detail);
         }
@@ -244,6 +247,7 @@ export class DBQueueConsumer<T = unknown> implements QueueConsumer<T> {
                     type: job.type,
                     durationMs: Number.isFinite(durationMs) ? durationMs : 0,
                     attempt: job.attempts,
+                    severity: 'info',
                 };
                 await this.events?.emit('queue.job.completed', completed);
             } catch (error) {
@@ -271,6 +275,7 @@ export class DBQueueConsumer<T = unknown> implements QueueConsumer<T> {
                 attempt: attempts,
                 maxRetries: job.maxRetries,
                 durationMs,
+                severity: 'error',
             };
             await this.events?.emit('queue.job.failed', failed);
             return;
@@ -286,6 +291,7 @@ export class DBQueueConsumer<T = unknown> implements QueueConsumer<T> {
             maxRetries: job.maxRetries,
             nextRetryAt,
             error: message,
+            severity: 'warning',
         };
         await this.events?.emit('queue.job.retrying', retrying);
     }

package/src/scheduler/action.ts

@@ -110,7 +110,7 @@ export class QueueStatsAction implements SchedulerAction {
         const dao = await this.daoProvider();
         const stats = await dao.getStats();
         logger.info('Queue stats snapshot', { action: this.name, ...stats });
-        await this.systemBus?.emit('queue.stats', stats);
+        await this.systemBus?.emit('queue.stats', { ...stats, severity: 'info' });
     }
 }
 

package/src/scheduler/node.ts

@@ -4,7 +4,6 @@
  */
 
 import { settleWithin } from '../internals/drain';
-import { getLogger } from '../logger';
 import {
     getSchedulerJobDuration,
     getSchedulerJobExecutedTotal,
@@ -23,21 +22,28 @@ function parseInterval(cron: string): number {
         if (num > 0) return num;
     } else {
         const parts = trimmed.split(/\s+/);
-        if (parts.length === 5 && parts[0] === '*') {
-            return 60_000; // every minute
+        // Only the documented 5-field forms are every-N-minutes: "* * * * *" and
+        // "*/N * * * *". A first-field wildcard alone ("* 3 * * *") is real cron
+        // and must not silently fire every 60s (task 0060 F7).
+        const restWild =
+            parts.length === 5 && parts[1] === '*' && parts[2] === '*' && parts[3] === '*' && parts[4] === '*';
+        if (restWild && parts[0] === '*') {
+            return 60_000;
         }
 
-        // */N pattern
-        const match = parts[0]?.match(/^\*\/(\d+)$/);
+        const nField = restWild ? parts[0] : parts.length === 1 ? parts[0] : undefined;
+        const match = nField?.match(/^\*\/(\d+)$/);
         if (match && Number(match[1]) > 0) {
             return Number(match[1]) * 60_000;
         }
     }
 
-    // Real cron field expressions ("0 3 * * *") are NOT supported — running
-    // them every minute silently would badly misfire, so warn on fallback.
-    getLogger('scheduler.node').warn('Unsupported cron expression — falling back to a 60s interval', { cron });
-    return 60_000;
+    // Real cron field expressions ("0 3 * * *") are NOT supported — silently running
+    // them every minute would badly misfire. 0032 made that a warn; task 0060 F7 makes
+    // it a hard error so an unsupported schedule can never fire at the wrong cadence.
+    throw new RangeError(
+        `Unsupported cron expression: "${cron}" — supported forms are a positive millisecond number, "* * * * *", or "*/N * * * *" with N > 0`,
+    );
 }
 
 interface ScheduledEntry {
@@ -81,6 +87,9 @@ export class NodeSchedulerAdapter implements SchedulerAdapter {
     }
 
     register(cron: string, action: ScheduledAction): void {
+        // Fail at registration time: an unsupported expression must never reach start(),
+        // where it would otherwise create a silently-wrong interval (task 0060 F7).
+        parseInterval(cron);
         this.entries.push({ cron, action });
         if (this.running) {
             const last = this.entries[this.entries.length - 1];

package/src/scheduler/wrap-handler.ts

@@ -47,6 +47,7 @@ export function wrapScheduledHandler(
                     name,
                     durationMs,
                     ...(execError !== undefined ? { error: execError } : {}),
+                    severity: execError !== undefined ? 'error' : 'info',
                 });
             }
         });