@gobing-ai/ts-infra 0.4.49 → 0.4.51

package/README.md

@@ -331,10 +331,24 @@ 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.
+**Cron support (task 0734).** Three legacy cadences are preserved as interval forms measured from
+adapter start: a positive millisecond number (`'60000'`), `'* * * * *'` (60s), and `'*/N * * * *'`
+(N > 0). Every other valid five-field expression is real cron, evaluated in local wall-clock time
+and self-rescheduled with `setTimeout` so ticks never overlap and missed occurrences are skipped.
+Supported fields: minute `0-59`, hour `0-23`, day-of-month `1-31`, month `1-12`, day-of-week `0-7`
+(`0` and `7` are Sunday); each accepts `*`, a step form, a comma-separated list of numbers or
+inclusive non-wrapping ranges, or a single number. When both day fields are restricted, standard
+cron OR semantics apply. Wrong field counts, out-of-range values, descending ranges, zero steps,
+empty list members, names/macros, and unsupported operators throw a `RangeError` at registration —
+nothing silently falls back.
+
+**Declarative jobs.** `runNodeApplication` (see `./application-node`) validates
+`bootstrap.scheduler.jobs`, an array of `SchedulerJobConfig` items — each a non-empty `name` and
+`command` plus exactly one of an integer `intervalMinutes` (`1..35791`) or a cron string using the
+grammar above. Jobs are validated and normalized whether or not the scheduler is enabled; a disabled
+scheduler retains validated definitions but creates no adapter and runs nothing. ts-infra treats
+`command` as declarative data and never executes it — the consuming application binds it to its own
+handler.
 
 ### API Client — typed HTTP with tracing
 

package/dist/application/index.d.ts

@@ -55,6 +55,7 @@ import type { ApplicationBootstrapOptions, ApplicationRuntime } from './types';
 export declare function runApplication<TAppConfig = unknown, TEvents extends EventMap = InfraEvents>(options: ApplicationBootstrapOptions<TAppConfig, TEvents>): Promise<ApplicationRuntime<TAppConfig, TEvents>>;
 export type { BusLifecycleEvents, EventMap } from '../event-bus/types';
 export type { InfraEvents } from '../events';
+export type { SchedulerJobConfig } from '../scheduler/types';
 export type { PluginHost } from './plugins/host';
 export type { Plugin, PluginSummary } from './plugins/types';
 export type { ApplicationBootstrapConfig, ApplicationBootstrapOptions, ApplicationConfigLoader, ApplicationConfigValidator, ApplicationRuntime, ApplicationServices, ApplicationStopReason, ConfigValidationResult, DbAdapterLike, EventsOptions, LoggingOptions, SchedulerOptions, TelemetryOptions, } from './types';

package/dist/application/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAsB,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAM7C,OAAO,KAAK,EAER,2BAA2B,EAC3B,kBAAkB,EAGrB,MAAM,SAAS,CAAC;AAiCjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,cAAc,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW,EAC7F,OAAO,EAAE,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,GAC1D,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CA0JlD;AAED,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7D,YAAY,EACR,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAsB,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAM7C,OAAO,KAAK,EAER,2BAA2B,EAC3B,kBAAkB,EAGrB,MAAM,SAAS,CAAC;AAiCjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,cAAc,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW,EAC7F,OAAO,EAAE,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,GAC1D,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CA2JlD;AAED,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7D,YAAY,EACR,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,SAAS,CAAC"}

package/dist/application/index.js

@@ -94,6 +94,7 @@ export async function runApplication(options) {
     const schedulerConfig = {
         enabled: schedOpts?.enabled ?? false,
         autoStart: schedOpts?.autoStart ?? true,
+        jobs: schedOpts?.jobs ?? [],
     };
     const eventsEnabled = options.config?.events?.enabled ?? true;
     const eventsLifecycle = options.config?.events?.lifecycle ?? true;

package/dist/application/types.d.ts

@@ -12,7 +12,7 @@ import type { FileObserverWriter } from '../event-bus/file-observer';
 import type { BusLifecycleEvents, EventMap } from '../event-bus/types';
 import type { InfraEvents } from '../events';
 import type { Logger, LogLevel } from '../logger';
-import type { SchedulerAdapter } from '../scheduler/types';
+import type { SchedulerAdapter, SchedulerJobConfig } from '../scheduler/types';
 import type { PluginHost } from './plugins/host';
 import type { Plugin } from './plugins/types';
 /** Logging feature flags. */
@@ -77,6 +77,13 @@ export interface SchedulerOptions {
     entries?: Array<[string, () => Promise<void>]>;
     /** Start scheduler immediately after registration. Default `true` when enabled. */
     autoStart?: boolean;
+    /**
+     * Declarative scheduler jobs (task 0734). Validated and normalized by the
+     * Node subpath (`runNodeApplication`) before the user `start` callback;
+     * forwarded as data into the resolved config. ts-infra never executes the
+     * job `command` itself.
+     */
+    jobs?: readonly SchedulerJobConfig[];
 }
 /**
  * Fully-resolved bootstrap config (all optionals filled with defaults).
@@ -104,6 +111,7 @@ export interface ApplicationBootstrapConfig {
     readonly scheduler: {
         enabled: boolean;
         autoStart: boolean;
+        jobs: readonly SchedulerJobConfig[];
     };
 }
 /** Services that may be pre-injected instead of created by the bootstrap. */

package/dist/application/types.d.ts.map

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

package/dist/application-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-node.d.ts","sourceRoot":"","sources":["../src/application-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,OAAO,KAAK,EACR,2BAA2B,EAC3B,uBAAuB,EAEvB,kBAAkB,EAClB,qBAAqB,EAGrB,QAAQ,EACR,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,qBAAqB,CAAC;AAM7B,kGAAkG;AAClG,qBAAa,qBAAsB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI9B;AAgHD;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,gBAAgB;IACnE,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW;IAChG,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC5D,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAChC,SAAS,CAAC,EAAE,6BAA6B,CAAC;QAC1C,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAChC,CAAC;IACF,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IACjF,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvF,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,CACZ,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,EAC5C,MAAM,EAAE,qBAAqB,KAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW,EACjG,OAAO,EAAE,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,GACrD,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAuIlD"}
+{"version":3,"file":"application-node.d.ts","sourceRoot":"","sources":["../src/application-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,OAAO,KAAK,EACR,2BAA2B,EAC3B,uBAAuB,EAEvB,kBAAkB,EAClB,qBAAqB,EAGrB,QAAQ,EACR,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,qBAAqB,CAAC;AAQ7B,kGAAkG;AAClG,qBAAa,qBAAsB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI9B;AAyMD;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,gBAAgB;IACnE,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW;IAChG,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC5D,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAChC,SAAS,CAAC,EAAE,6BAA6B,CAAC;QAC1C,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAChC,CAAC;IACF,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IACjF,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvF,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,CACZ,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,EAC5C,MAAM,EAAE,qBAAqB,KAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW,EACjG,OAAO,EAAE,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,GACrD,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CA6IlD"}

package/dist/application-node.js

@@ -20,6 +20,7 @@ import { createDbAdapter } from '@gobing-ai/ts-db';
 import { createNodeFileSystem, interpolateTree, parseYamlObject } from '@gobing-ai/ts-runtime';
 import { runApplication } from './application/index.js';
 import { dbPlugin } from './application/plugins/builtins.js';
+import { parseCronExpression } from './scheduler/cron.js';
 import { NodeSchedulerAdapter } from './scheduler-node.js';
 import { initNodeTelemetry, shutdownNodeTelemetry } from './telemetry/otel-node.js';
 // ── Errors ────────────────────────────────────────────────────────────────
@@ -30,6 +31,8 @@ export class ConfigValidationError extends Error {
         this.name = 'ConfigValidationError';
     }
 }
+/** Platform timer maximum for `setTimeout` (2^31 - 1 ms). */
+const MAX_TIMEOUT_MS = 2_147_483_647;
 // ── Config validation helper ──────────────────────────────────────────────
 /**
  * Validate a raw config section using the caller-provided validator.
@@ -57,6 +60,78 @@ function validateAppConfig(validator, raw, section, filePath) {
     }
     throw new ConfigValidationError(`Unsupported validator shape for section "${section}"`);
 }
+// ── Scheduler job validation (task 0734) ────────────────────────────────────
+/** Max `intervalMinutes` so that `intervalMinutes * 60_000` fits in the platform timer maximum. */
+const MAX_INTERVAL_MINUTES = Math.floor(MAX_TIMEOUT_MS / 60_000);
+/**
+ * Validate and normalize a raw `bootstrap.scheduler.jobs` array.
+ *
+ * Accepts only object entries, trims `name`/`command`/`cron`, enforces the
+ * schedule XOR and `intervalMinutes` bounds, validates cron through the shared
+ * internal parser, and rejects duplicate post-trim names case-sensitively.
+ * Runs whether the scheduler is enabled or disabled; a disabled scheduler may
+ * retain validated job definitions but creates no adapter (R4).
+ *
+ * Throws `ConfigValidationError` with a `bootstrap.scheduler.jobs.<index>.<field>`
+ * path so a bad job aborts startup before the user `start` callback.
+ */
+function normalizeSchedulerJobs(raw) {
+    if (raw === undefined || raw === null)
+        return [];
+    if (!Array.isArray(raw)) {
+        throw new ConfigValidationError('bootstrap.scheduler.jobs must be an array');
+    }
+    const seen = new Set();
+    const jobs = [];
+    raw.forEach((item, index) => {
+        if (typeof item !== 'object' || item === null || Array.isArray(item)) {
+            throw new ConfigValidationError(`bootstrap.scheduler.jobs.${index} must be an object`);
+        }
+        const entry = item;
+        const name = typeof entry.name === 'string' ? entry.name.trim() : '';
+        const command = typeof entry.command === 'string' ? entry.command.trim() : '';
+        const cron = typeof entry.cron === 'string' ? entry.cron.trim() : '';
+        const interval = entry.intervalMinutes;
+        if (name === '') {
+            throw new ConfigValidationError(`bootstrap.scheduler.jobs.${index}.name must be a non-empty string`);
+        }
+        if (command === '') {
+            throw new ConfigValidationError(`bootstrap.scheduler.jobs.${index}.command must be a non-empty string`);
+        }
+        const hasCron = entry.cron !== undefined && entry.cron !== null;
+        const hasInterval = interval !== undefined && interval !== null;
+        if (hasCron === hasInterval) {
+            throw new ConfigValidationError(`bootstrap.scheduler.jobs.${index} must have exactly one of intervalMinutes or cron`);
+        }
+        if (seen.has(name)) {
+            throw new ConfigValidationError(`bootstrap.scheduler.jobs.${index}.name duplicates the name of an earlier job: "${name}"`);
+        }
+        seen.add(name);
+        if (hasInterval) {
+            if (typeof interval !== 'number' ||
+                !Number.isInteger(interval) ||
+                interval < 1 ||
+                interval > MAX_INTERVAL_MINUTES) {
+                throw new ConfigValidationError(`bootstrap.scheduler.jobs.${index}.intervalMinutes must be an integer in 1..${MAX_INTERVAL_MINUTES}`);
+            }
+            jobs.push({ name, command, intervalMinutes: interval });
+        }
+        else {
+            if (cron === '') {
+                throw new ConfigValidationError(`bootstrap.scheduler.jobs.${index}.cron must be a non-empty string`);
+            }
+            try {
+                parseCronExpression(cron);
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                throw new ConfigValidationError(`bootstrap.scheduler.jobs.${index}.cron: ${detail}`);
+            }
+            jobs.push({ name, command, cron });
+        }
+    });
+    return jobs;
+}
 // ── File sink helper ──────────────────────────────────────────────────────
 function createFileSink(filePath) {
     return (line) => {
@@ -168,16 +243,22 @@ export async function runNodeApplication(options) {
     const eventsOpts = { ...yamlEvents, ...options.config?.events };
     const logFilePath = yamlBootstrap.logging?.filePath;
     const loggingConfig = typeof logFilePath === 'string' ? { ...loggingOpts, fileSink: createFileSink(logFilePath) } : loggingOpts;
-    // ── Scheduler adapter ───────────────────────────────────────────────
+    // ── Scheduler adapter + jobs ────────────────────────────────────────
     // Honour a caller-supplied `SchedulerOptions.adapter` (documented injection
     // point, application/types.ts:82) instead of unconditionally overwriting
     // it. Only default-construct a NodeSchedulerAdapter when none was provided.
     // `drainTimeoutMs` (ADR-024) is reachable by passing a pre-built adapter;
     // the auto-wired default keeps the 30000 ms bound (CHANGELOG.md:16).
-    const schedulerConfig = {};
-    if (schedulerOpts.enabled === true) {
-        schedulerConfig.enabled = true;
-        schedulerConfig.autoStart = schedulerOpts.autoStart;
+    //
+    // Declarative jobs (task 0734) are validated and normalized whether or not
+    // the scheduler is enabled — a disabled scheduler may retain validated job
+    // definitions but creates no adapter and runs nothing (R4).
+    const schedulerConfig = {
+        enabled: schedulerOpts.enabled === true,
+        autoStart: schedulerOpts.autoStart,
+        jobs: normalizeSchedulerJobs(schedulerOpts.jobs),
+    };
+    if (schedulerConfig.enabled) {
         schedulerConfig.adapter = schedulerOpts.adapter ?? new NodeSchedulerAdapter();
         if (schedulerOpts.entries) {
             schedulerConfig.entries = schedulerOpts.entries;

package/dist/scheduler/cron.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Internal cron expression grammar + matching (task 0734).
+ *
+ * This module is deliberately NOT exported from package.json — it is a shared
+ * internal seam between `application-node.ts` (SchedulerJobConfig validation)
+ * and `scheduler/node.ts` (adapter matching), so both consume the same grammar.
+ * The public surface remains `NodeSchedulerAdapter` and `SchedulerJobConfig`.
+ *
+ * Supported grammar (five fields, whitespace-separated):
+ *   minute       0-59
+ *   hour         0-23
+ *   day-of-month 1-31
+ *   month        1-12
+ *   day-of-week  0-7  (0 and 7 are both Sunday)
+ *
+ * Each field accepts a wildcard, a step-N wildcard form, a comma-separated list
+ * of numbers or inclusive non-wrapping ranges, or a single number. Names/macros
+ * (`MON`, `JAN`, `@daily`) and operators (`?`, `L`, `W`, `#`) are rejected.
+ *
+ * Matching uses local wall-clock fields (ADR / task 0734 R2): the fall-back hour
+ * can fire twice at two distinct instants; a nonexistent spring-forward minute
+ * never fires. No per-job timezone.
+ */
+/** A single cron field: either a wildcard (whole range) or an explicit value set. */
+export interface CronFieldSpec {
+    /** True when the whole field is `*` (matches every value in its range). */
+    readonly wildcard: boolean;
+    /** Allowed values when restricted. Day-of-week 7 is normalized into 0. */
+    readonly values: ReadonlySet<number>;
+}
+/** A parsed five-field cron expression. */
+export interface CronExpression {
+    readonly minute: CronFieldSpec;
+    readonly hour: CronFieldSpec;
+    readonly dayOfMonth: CronFieldSpec;
+    readonly month: CronFieldSpec;
+    readonly dayOfWeek: CronFieldSpec;
+    /** The original expression, for error messages and metrics. */
+    readonly source: string;
+}
+/**
+ * Parse a five-field cron expression into its spec.
+ *
+ * Throws `RangeError` on a wrong field count, any unsupported field grammar, or
+ * out-of-range values. Day-of-week `7` normalizes to `0` (Sunday).
+ */
+export declare function parseCronExpression(source: string): CronExpression;
+/**
+ * Whether the instant matches the expression (local wall-clock fields).
+ *
+ * Day semantics follow standard cron: when both day fields are wildcards both
+ * pass; when one is a wildcard the restricted field must match; when both are
+ * restricted, either may match (OR).
+ */
+export declare function matchesCron(date: Date, expr: CronExpression): boolean;
+/**
+ * Compute the next matching minute strictly after `nowMs`, in local time.
+ *
+ * Starts at the next epoch-minute boundary and scans forward in one-minute
+ * steps (fixed epoch increments, local wall-clock fields read per instant), so
+ * DST fall-back selects both distinct instants and spring-forward skips
+ * nonexistent minutes. Bounded to eight calendar years so an unsatisfiable
+ * expression fails here (at registration) rather than silently never firing.
+ *
+ * # ponytail: O(minutes-to-next) forward scan, fine for small job counts; a
+ * field-jumping search would matter only if startup cost with hundreds of jobs
+ * ever shows up in measurements.
+ */
+export declare function nextCronTime(expr: CronExpression, nowMs: number): Date;
+//# sourceMappingURL=cron.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/scheduler/cron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AA+ED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAwBlE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAgBrE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAYtE"}

package/dist/scheduler/cron.js

@@ -0,0 +1,175 @@
+/**
+ * Internal cron expression grammar + matching (task 0734).
+ *
+ * This module is deliberately NOT exported from package.json — it is a shared
+ * internal seam between `application-node.ts` (SchedulerJobConfig validation)
+ * and `scheduler/node.ts` (adapter matching), so both consume the same grammar.
+ * The public surface remains `NodeSchedulerAdapter` and `SchedulerJobConfig`.
+ *
+ * Supported grammar (five fields, whitespace-separated):
+ *   minute       0-59
+ *   hour         0-23
+ *   day-of-month 1-31
+ *   month        1-12
+ *   day-of-week  0-7  (0 and 7 are both Sunday)
+ *
+ * Each field accepts a wildcard, a step-N wildcard form, a comma-separated list
+ * of numbers or inclusive non-wrapping ranges, or a single number. Names/macros
+ * (`MON`, `JAN`, `@daily`) and operators (`?`, `L`, `W`, `#`) are rejected.
+ *
+ * Matching uses local wall-clock fields (ADR / task 0734 R2): the fall-back hour
+ * can fire twice at two distinct instants; a nonexistent spring-forward minute
+ * never fires. No per-job timezone.
+ */
+/** Upper bound on the forward minute scan (8 calendar years, upper-capped at 366 days). */
+const MAX_SCAN_MINUTES = 8 * 366 * 24 * 60;
+const DAYS_OF_WEEK = 7; // 0-7 accepted on input, 7 aliases to 0
+/**
+ * Parse a single cron field into its wildcard/values spec.
+ *
+ * Throws `RangeError` for anything outside the supported grammar: names/macros,
+ * operators, zero steps, empty list members, descending ranges, non-integer
+ * values, or out-of-range values. Nothing silently falls back (task 0060 F7).
+ */
+function parseField(raw, min, max) {
+    const trimmed = raw.trim();
+    if (trimmed === '*') {
+        return { wildcard: true, values: new Set() };
+    }
+    // Names ('MON', 'JAN'), macros ('@daily'), and '?' are unsupported operators.
+    if (/^[A-Za-z@?]/.test(trimmed)) {
+        throw new RangeError(`unsupported cron field "${raw}": names/macros are not supported`);
+    }
+    // Whole-field step form: */N
+    const stepMatch = trimmed.match(/^\*\/(\d+)$/);
+    if (stepMatch) {
+        const step = Number(stepMatch[1]);
+        if (step <= 0) {
+            throw new RangeError(`unsupported cron field "${raw}": step must be a positive integer`);
+        }
+        const values = new Set();
+        for (let v = min; v <= max; v += step) {
+            values.add(v);
+        }
+        return { wildcard: false, values };
+    }
+    // Comma-separated list of numbers or inclusive non-wrapping ranges.
+    const members = trimmed.split(',');
+    if (members.some((m) => m.trim() === '')) {
+        throw new RangeError(`unsupported cron field "${raw}": empty list member`);
+    }
+    const values = new Set();
+    for (const rawMember of members) {
+        const member = rawMember.trim();
+        if (member.includes('-')) {
+            const rangeParts = member.split('-');
+            if (rangeParts.length !== 2 || rangeParts.some((p) => p === '' || !/^\d+$/.test(p))) {
+                throw new RangeError(`unsupported cron field "${raw}": invalid range "${rawMember}"`);
+            }
+            const lo = Number(rangeParts[0]);
+            const hi = Number(rangeParts[1]);
+            if (lo > hi) {
+                throw new RangeError(`unsupported cron field "${raw}": descending range "${rawMember}"`);
+            }
+            if (lo < min || hi > max) {
+                throw new RangeError(`cron field "${raw}" value out of range [${min}-${max}] in range "${rawMember}"`);
+            }
+            for (let v = lo; v <= hi; v++) {
+                values.add(v);
+            }
+        }
+        else {
+            if (!/^\d+$/.test(member)) {
+                throw new RangeError(`unsupported cron field "${raw}": invalid value "${rawMember}"`);
+            }
+            const v = Number(member);
+            if (v < min || v > max) {
+                throw new RangeError(`cron field "${raw}" value out of range [${min}-${max}]: ${rawMember}`);
+            }
+            values.add(v);
+        }
+    }
+    return { wildcard: false, values };
+}
+/**
+ * Parse a five-field cron expression into its spec.
+ *
+ * Throws `RangeError` on a wrong field count, any unsupported field grammar, or
+ * out-of-range values. Day-of-week `7` normalizes to `0` (Sunday).
+ */
+export function parseCronExpression(source) {
+    const trimmed = source.trim();
+    const parts = trimmed.split(/\s+/);
+    if (parts.length !== 5) {
+        throw new RangeError(`unsupported cron expression "${source}": expected exactly 5 fields, got ${parts.length}`);
+    }
+    const [rawMinute, rawHour, rawDom, rawMonth, rawDow] = parts;
+    const minute = parseField(rawMinute, 0, 59);
+    const hour = parseField(rawHour, 0, 23);
+    const dayOfMonth = parseField(rawDom, 1, 31);
+    const month = parseField(rawMonth, 1, 12);
+    let dayOfWeek = parseField(rawDow, 0, DAYS_OF_WEEK);
+    // Standard cron: 7 is an alias for 0 (Sunday).
+    if (!dayOfWeek.wildcard && dayOfWeek.values.has(DAYS_OF_WEEK)) {
+        const values = new Set(dayOfWeek.values);
+        values.delete(DAYS_OF_WEEK);
+        values.add(0);
+        dayOfWeek = { wildcard: false, values };
+    }
+    return { minute, hour, dayOfMonth, month, dayOfWeek, source: trimmed };
+}
+/**
+ * Whether the instant matches the expression (local wall-clock fields).
+ *
+ * Day semantics follow standard cron: when both day fields are wildcards both
+ * pass; when one is a wildcard the restricted field must match; when both are
+ * restricted, either may match (OR).
+ */
+export function matchesCron(date, expr) {
+    const minute = date.getMinutes();
+    if (!expr.minute.wildcard && !expr.minute.values.has(minute))
+        return false;
+    const hour = date.getHours();
+    if (!expr.hour.wildcard && !expr.hour.values.has(hour))
+        return false;
+    const month = date.getMonth() + 1;
+    if (!expr.month.wildcard && !expr.month.values.has(month))
+        return false;
+    const domWild = expr.dayOfMonth.wildcard;
+    const dowWild = expr.dayOfWeek.wildcard;
+    if (domWild && dowWild)
+        return true;
+    const domMatch = domWild || expr.dayOfMonth.values.has(date.getDate());
+    const dowMatch = dowWild || expr.dayOfWeek.values.has(date.getDay());
+    if (domWild)
+        return dowMatch;
+    if (dowWild)
+        return domMatch;
+    return domMatch || dowMatch;
+}
+/**
+ * Compute the next matching minute strictly after `nowMs`, in local time.
+ *
+ * Starts at the next epoch-minute boundary and scans forward in one-minute
+ * steps (fixed epoch increments, local wall-clock fields read per instant), so
+ * DST fall-back selects both distinct instants and spring-forward skips
+ * nonexistent minutes. Bounded to eight calendar years so an unsatisfiable
+ * expression fails here (at registration) rather than silently never firing.
+ *
+ * # ponytail: O(minutes-to-next) forward scan, fine for small job counts; a
+ * field-jumping search would matter only if startup cost with hundreds of jobs
+ * ever shows up in measurements.
+ */
+export function nextCronTime(expr, nowMs) {
+    // Next epoch-minute boundary strictly after now (never the current minute).
+    let candidate = Math.floor(nowMs / 60_000) * 60_000 + 60_000;
+    const limit = candidate + MAX_SCAN_MINUTES * 60_000;
+    while (candidate < limit) {
+        const instant = new Date(candidate);
+        if (matchesCron(instant, expr)) {
+            return instant;
+        }
+        candidate += 60_000;
+    }
+    throw new RangeError(`unsupported cron expression "${expr.source}": no matching time within 8 years`);
+}

package/dist/scheduler/index.d.ts

@@ -1,6 +1,6 @@
 export { ActionRegistry, type CreateDefaultRegistryOptions, createDefaultRegistry, HealthPingAction, type HealthPingWriter, LogAction, QueueStatsAction, type QueueStatsDaoProvider, type SchedulerAction, toScheduledAction, } from './action';
 export { initScheduler } from './factory';
 export { NoopSchedulerAdapter } from './noop';
-export type { ScheduledAction, SchedulerAdapter } from './types';
+export type { ScheduledAction, SchedulerAdapter, SchedulerJobConfig } from './types';
 export { wrapScheduledHandler } from './wrap-handler';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,SAAS,EACT,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,iBAAiB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,SAAS,EACT,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,iBAAiB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/scheduler/node.d.ts

@@ -1,6 +1,9 @@
 /**
- * Node.js scheduler adapter using a simple setInterval-based approach.
- * No external cron library dependency — cron expressions are parsed minimally.
+ * Node.js scheduler adapter — interval-based for the three legacy cadence
+ * forms, self-rescheduling setTimeout for real five-field cron (task 0734).
+ *
+ * No external cron library dependency — cron expressions are parsed by the
+ * internal `scheduler/cron.ts` grammar shared with `application-node.ts`.
  */
 import type { ScheduledAction, SchedulerAdapter } from './types';
 /** Constructor options for {@link NodeSchedulerAdapter}. */
@@ -11,10 +14,16 @@ export interface NodeSchedulerAdapterConfig {
      * Defaults to 30000 (matching `DBQueueConsumer`).
      */
     readonly drainTimeoutMs?: number;
+    /**
+     * Deterministic clock seam (task 0734 R2). Returns epoch milliseconds;
+     * defaults to `Date.now`. Used for cron target computation and re-checks.
+     */
+    readonly now?: () => number;
 }
 /**
- * Scheduler adapter for Node.js using a setInterval-based approach.
- * No external cron library dependency — cron expressions are parsed minimally.
+ * Scheduler adapter for Node.js. Interval entries use `setInterval`; real cron
+ * entries self-reschedule with `setTimeout` so ticks never overlap and
+ * occurrences missed while a tick runs are skipped (task 0734 R2).
  *
  * `stop()` drains in-flight ticks, bounded by `drainTimeoutMs` (ADR-024): an
  * action already running when `stop()` is called is awaited rather than torn
@@ -23,13 +32,28 @@ export interface NodeSchedulerAdapterConfig {
 export declare class NodeSchedulerAdapter implements SchedulerAdapter {
     private readonly entries;
     private readonly drainTimeoutMs;
+    private readonly now;
     private running;
     private readonly inflight;
     constructor(config?: NodeSchedulerAdapterConfig);
     register(cron: string, action: ScheduledAction): void;
+    private parseEntry;
     start(): Promise<void>;
     stop(): Promise<void>;
     private startEntry;
+    /**
+     * Arm the cron entry's next `setTimeout`, chunking any delay beyond the
+     * platform timer maximum. On a chunk wake the wall clock is re-checked
+     * before firing, so an injected/real clock shift never fires early.
+     */
+    private armCron;
+    /**
+     * Fire a cron tick: re-check the wall clock against the target, run the
+     * action once, then recompute the next occurrence strictly from `now()` and
+     * re-arm only while still running. Ticks never overlap and occurrences
+     * missed while a tick runs are skipped (task 0734 R2).
+     */
+    private fireCron;
     private _onScheduledTick;
 }
 //# sourceMappingURL=node.d.ts.map

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;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"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/scheduler/node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA0DjE,4DAA4D;AAC5D,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAEzC,MAAM,GAAE,0BAA+B;IAWnD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAWrD,OAAO,CAAC,UAAU;IAYZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B,OAAO,CAAC,UAAU;IAiBlB;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAwBf;;;;;OAKG;YACW,QAAQ;YAsBR,gBAAgB;CAYjC"}