@objectstack/trigger-schedule 17.0.0-rc.6 → 17.0.0

package/dist/index.js

@@ -32,6 +32,12 @@ module.exports = __toCommonJS(index_exports);
 
 // src/schedule-trigger.ts
 var JOB_PREFIX = "flow-schedule";
+function reportBindFailure(logger, tag, flowName, err) {
+  const report = logger.error?.bind(logger) ?? logger.warn.bind(logger);
+  report(
+    `[${tag}] flow '${flowName}' FAILED to bind to the job service: ${err?.message ?? String(err)}. The flow stays published and active \u2014 Studio, the metadata API and verify_build all keep reporting it healthy \u2014 but nothing will fire it until it binds. Re-publish the flow (or restart the environment) to retry.`
+  );
+}
 function normalizeSchedule(raw) {
   if (raw == null) return null;
   if (typeof raw === "string") {
@@ -110,9 +116,7 @@ var ScheduleTrigger = class {
       );
     }).catch((err) => {
       this.bound.delete(binding.flowName);
-      this.logger.warn(
-        `[schedule] failed to schedule flow '${binding.flowName}': ${err?.message ?? String(err)}`
-      );
+      reportBindFailure(this.logger, "schedule", binding.flowName, err);
     });
   }
   stop(flowName) {
@@ -269,9 +273,7 @@ var TimeRelativeTrigger = class {
       );
     }).catch((err) => {
       this.bound.delete(binding.flowName);
-      this.logger.warn(
-        `[time-relative] failed to schedule flow '${binding.flowName}': ${errMessage(err)}`
-      );
+      reportBindFailure(this.logger, "time-relative", binding.flowName, err);
     });
   }
   /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/schedule-trigger.ts","../src/plugin.ts","../src/time-relative-trigger.ts","../src/time-relative-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { ScheduleTriggerPlugin } from './plugin.js';\nexport { ScheduleTrigger, normalizeSchedule } from './schedule-trigger.js';\nexport type {\n    FlowTrigger,\n    FlowTriggerBinding,\n    JobServiceSurface,\n    TriggerLogger,\n} from './schedule-trigger.js';\n\nexport { TimeRelativeTriggerPlugin } from './time-relative-plugin.js';\nexport {\n    TimeRelativeTrigger,\n    computeDateWindows,\n    buildWindowWhere,\n} from './time-relative-trigger.js';\nexport type { TimeRelativeDataEngine, DateWindow } from './time-relative-trigger.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { AutomationContext } from '@objectstack/spec/contracts';\nimport type { JobSchedule, JobHandler } from '@objectstack/spec/contracts';\n\n/**\n * Structural mirror of the automation engine's `FlowTriggerBinding`\n * (service-automation/src/engine.ts). Declared locally so this trigger plugin\n * stays decoupled from the automation package — same pattern the record-change\n * trigger and the connector / messaging integrations use. The engine parses the\n * flow's start node and hands us a binding whose `schedule` carries the\n * cron/interval/once descriptor.\n */\nexport interface FlowTriggerBinding {\n    readonly flowName: string;\n    readonly object?: string;\n    readonly event?: string;\n    readonly condition?: string | { dialect?: string; source?: string; ast?: unknown };\n    readonly schedule?: unknown;\n    readonly config?: Record<string, unknown>;\n}\n\n/**\n * Structural mirror of the engine's `FlowTrigger` extension point. The engine\n * calls {@link start} with a parsed binding + a callback that runs the flow,\n * and {@link stop} when the flow is unregistered/disabled.\n */\nexport interface FlowTrigger {\n    readonly type: string;\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void;\n    stop(flowName: string): void;\n}\n\n/**\n * The slice of `IJobService` this trigger needs: schedule a named job and\n * cancel it. Typed structurally so the plugin depends on the spec contract\n * shape, not a concrete adapter.\n */\nexport interface JobServiceSurface {\n    schedule(name: string, schedule: JobSchedule, handler: JobHandler): Promise<void>;\n    cancel(name: string): Promise<void>;\n}\n\n/** Minimal logger surface (matches core's `ctx.logger`). */\nexport interface TriggerLogger {\n    info(msg: string, ...args: unknown[]): void;\n    warn(msg: string, ...args: unknown[]): void;\n    debug?(msg: string, ...args: unknown[]): void;\n    /**\n     * Execution failures log here when available (falling back to `warn`).\n     * ERROR matters operationally: the CLI's boot-quiet window swallows\n     * stdout (debug/info/warn) but stderr (error/fatal) always lands — so a\n     * per-record sweep failure stays visible. Mirrors the record-change\n     * trigger's logger surface.\n     */\n    error?(msg: string, ...args: unknown[]): void;\n}\n\nconst JOB_PREFIX = 'flow-schedule';\n\n/**\n * Normalize a flow's raw `schedule` descriptor into a {@link JobSchedule}, or\n * `null` if it can't be understood. Accepts the canonical\n * `{ type: 'cron'|'interval'|'once', ... }` shape plus a few ergonomic\n * shorthands (a bare cron string, `{ cron }`, `{ expression }`, `{ every }` /\n * `{ intervalMs }`, `{ at }`).\n */\nexport function normalizeSchedule(raw: unknown): JobSchedule | null {\n    if (raw == null) return null;\n\n    // Bare cron string, e.g. '0 1 * * *'.\n    if (typeof raw === 'string') {\n        const expr = raw.trim();\n        return expr ? { type: 'cron', expression: expr } : null;\n    }\n\n    if (typeof raw !== 'object') return null;\n    const s = raw as Record<string, unknown>;\n\n    const type = typeof s.type === 'string' ? s.type : undefined;\n\n    if (type === 'cron' || (!type && (typeof s.cron === 'string' || typeof s.expression === 'string'))) {\n        const expression =\n            (typeof s.expression === 'string' && s.expression) ||\n            (typeof s.cron === 'string' && s.cron) ||\n            undefined;\n        if (!expression) return null;\n        const out: JobSchedule = { type: 'cron', expression };\n        if (typeof s.timezone === 'string') out.timezone = s.timezone;\n        return out;\n    }\n\n    if (type === 'interval' || (!type && (typeof s.intervalMs === 'number' || typeof s.every === 'number'))) {\n        const intervalMs =\n            (typeof s.intervalMs === 'number' && s.intervalMs) ||\n            (typeof s.every === 'number' && s.every) ||\n            undefined;\n        if (!intervalMs || intervalMs <= 0) return null;\n        return { type: 'interval', intervalMs };\n    }\n\n    if (type === 'once' || (!type && typeof s.at === 'string')) {\n        const at = typeof s.at === 'string' ? s.at : undefined;\n        if (!at) return null;\n        return { type: 'once', at };\n    }\n\n    return null;\n}\n\n/**\n * ScheduleTrigger\n *\n * Bridges the automation engine's {@link FlowTrigger} extension point to the\n * platform {@link JobServiceSurface}. For each schedule-triggered flow the\n * engine activates, it registers a job whose handler runs the flow; the job\n * service owns the actual cron/interval/once timing (so this trigger stays\n * adapter-agnostic — cron schedules need a cron-capable adapter, which the\n * job service selects).\n *\n * The job service is resolved lazily (per `start()`) via the supplied accessor,\n * so we always pick up the job service's *upgraded* adapter (e.g. the durable\n * DbJobAdapter that replaces the bootstrap interval adapter on `kernel:ready`).\n */\nexport class ScheduleTrigger implements FlowTrigger {\n    readonly type = 'schedule';\n\n    private readonly getJobService: () => JobServiceSurface | null;\n    private readonly logger: TriggerLogger;\n    /** flowName → job name registered for it, so stop() can cancel it. */\n    private readonly bound = new Map<string, string>();\n\n    constructor(getJobService: () => JobServiceSurface | null, logger: TriggerLogger) {\n        this.getJobService = getJobService;\n        this.logger = logger;\n    }\n\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void {\n        const raw = binding.schedule ?? (binding.config as Record<string, unknown> | undefined)?.schedule;\n        const schedule = normalizeSchedule(raw);\n        if (!schedule) {\n            this.logger.warn(\n                `[schedule] flow '${binding.flowName}' has no recognizable schedule descriptor — not bound`,\n            );\n            return;\n        }\n\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.schedule !== 'function') {\n            this.logger.warn(\n                `[schedule] job service unavailable — flow '${binding.flowName}' not scheduled`,\n            );\n            return;\n        }\n\n        // Idempotent: drop any prior schedule for this flow before re-binding\n        // (covers disable→enable cycles and hot reload).\n        this.stop(binding.flowName);\n\n        const jobName = `${JOB_PREFIX}:${binding.flowName}`;\n\n        const handler: JobHandler = async ({ jobId }) => {\n            try {\n                const ctx: AutomationContext = {\n                    event: 'schedule',\n                    params: {\n                        jobId,\n                        flowName: binding.flowName,\n                        schedule,\n                    },\n                };\n                await callback(ctx);\n            } catch (err) {\n                // Error isolation: a scheduled flow failure must not crash the\n                // job runner / ticker. Log and swallow.\n                this.logger.warn(\n                    `[schedule] flow '${binding.flowName}' execution failed: ${(err as Error)?.message ?? String(err)}`,\n                );\n            }\n        };\n\n        this.bound.set(binding.flowName, jobName);\n        // FlowTrigger.start is sync; the job service's schedule() is async.\n        // Fire-and-forget with error logging.\n        void Promise.resolve(jobService.schedule(jobName, schedule, handler))\n            .then(() => {\n                this.logger.info(\n                    `[schedule] bound flow '${binding.flowName}' → ${schedule.type}` +\n                        (schedule.expression ? ` '${schedule.expression}'` : '') +\n                        (schedule.intervalMs ? ` every ${schedule.intervalMs}ms` : '') +\n                        (schedule.at ? ` at ${schedule.at}` : ''),\n                );\n            })\n            .catch((err) => {\n                this.bound.delete(binding.flowName);\n                this.logger.warn(\n                    `[schedule] failed to schedule flow '${binding.flowName}': ${(err as Error)?.message ?? String(err)}`,\n                );\n            });\n    }\n\n    stop(flowName: string): void {\n        const jobName = this.bound.get(flowName);\n        if (!jobName) return;\n        this.bound.delete(flowName);\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.cancel !== 'function') return;\n        void Promise.resolve(jobService.cancel(jobName))\n            .then(() => this.logger.debug?.(`[schedule] unbound flow '${flowName}'`))\n            .catch((err) => {\n                this.logger.warn(\n                    `[schedule] failed to unbind flow '${flowName}': ${(err as Error)?.message ?? String(err)}`,\n                );\n            });\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { ScheduleTrigger } from './schedule-trigger.js';\nimport type { FlowTrigger, JobServiceSurface } from './schedule-trigger.js';\n\n/**\n * The slice of the automation engine this plugin needs: register a trigger on\n * its `FlowTrigger` extension point. Declared structurally so the plugin does\n * not take a build dependency on `@objectstack/service-automation`.\n */\ninterface AutomationTriggerRegistry {\n    registerTrigger(trigger: FlowTrigger): void;\n    unregisterTrigger?(type: string): void;\n}\n\n/**\n * ScheduleTriggerPlugin\n *\n * Makes schedule-triggered flows actually fire. The automation engine ships the\n * `FlowTrigger` wiring (it parses each flow's start node — `flow.type ===\n * 'schedule'` or a start-node `config.schedule` descriptor — into a binding and\n * calls `trigger.start(...)`), but the *concrete* schedule trigger lives here as\n * a plugin and delegates timing to the platform `IJobService` (the `'job'`\n * service). This mirrors the connector / record-change split (engine baseline +\n * trigger plugin).\n *\n * With this plugin (and a job service) installed, a flow whose start node\n * declares `config: { schedule: { type: 'cron', expression: '0 1 * * *' } }`\n * auto-launches on that schedule — no manual `engine.execute()`.\n *\n * Depends on the job service plugin so its `kernel:ready` upgrade (to the\n * durable DbJobAdapter) runs before ours; the job service is nonetheless\n * resolved lazily per `start()` so we always use its current adapter.\n */\nexport class ScheduleTriggerPlugin implements Plugin {\n    name = 'com.objectstack.trigger.schedule';\n    type = 'standard';\n    version = '7.3.0';\n    dependencies = ['com.objectstack.service.job'];\n\n    async init(ctx: PluginContext): Promise<void> {\n        ctx.logger.info('Schedule trigger plugin initialized');\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        // The automation service + job service are resolvable once the kernel is\n        // ready (kernel:ready fires after AutomationServicePlugin.start() has\n        // pulled flows in and after the job service upgrades its adapter).\n        ctx.hook('kernel:ready', async () => {\n            const automation = this.resolveService<AutomationTriggerRegistry>(ctx, 'automation');\n            if (!automation || typeof automation.registerTrigger !== 'function') {\n                ctx.logger.warn(\n                    'ScheduleTriggerPlugin: automation service not available — schedule trigger NOT installed',\n                );\n                return;\n            }\n\n            // Probe once for a clear startup warning; the trigger re-resolves\n            // lazily on each start() so adapter upgrades are always picked up.\n            if (!this.resolveService<JobServiceSurface>(ctx, 'job')) {\n                ctx.logger.warn(\n                    'ScheduleTriggerPlugin: job service not available — scheduled flows will not run until one is registered',\n                );\n            }\n\n            const trigger = new ScheduleTrigger(\n                () => this.resolveService<JobServiceSurface>(ctx, 'job'),\n                ctx.logger,\n            );\n            automation.registerTrigger(trigger);\n            ctx.logger.info('ScheduleTriggerPlugin: schedule trigger registered');\n        });\n    }\n\n    private resolveService<T>(ctx: PluginContext, name: string): T | null {\n        try {\n            return ctx.getService<T>(name) ?? null;\n        } catch {\n            return null;\n        }\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { AutomationContext, JobSchedule, JobHandler } from '@objectstack/spec/contracts';\nimport {\n    TimeRelativeTriggerSchema,\n    TIME_RELATIVE_DEFAULT_CRON,\n    TIME_RELATIVE_DEFAULT_MAX_RECORDS,\n} from '@objectstack/spec/automation';\nimport type { TimeRelativeTrigger as TimeRelativeDescriptor } from '@objectstack/spec/automation';\nimport { normalizeSchedule } from './schedule-trigger.js';\nimport type { FlowTrigger, FlowTriggerBinding, JobServiceSurface, TriggerLogger } from './schedule-trigger.js';\n\n/**\n * The slice of the ObjectQL data engine this trigger needs: run a filtered\n * `find` (to discover the records whose date field falls in the window) and,\n * optionally, probe whether an object is registered. Typed structurally — same\n * decoupling pattern the record-change trigger uses for its hook surface — so\n * this plugin does not take a build dependency on the engine package.\n */\nexport interface TimeRelativeDataEngine {\n    find(\n        objectName: string,\n        query?: {\n            where?: Record<string, unknown>;\n            fields?: string[];\n            limit?: number;\n            /** Elevated context — a background sweep must see all rows, not RLS-scoped ones. */\n            context?: { isSystem?: boolean };\n        },\n    ): Promise<Array<Record<string, unknown>> | undefined>;\n    /**\n     * Optional object-existence probe (the ObjectQL engine's `getObject`).\n     * When present, {@link TimeRelativeTrigger.start} uses it to call out a\n     * descriptor whose `object` matches no registered object at bind time —\n     * otherwise the sweep just quietly finds nothing forever.\n     */\n    getObject?(name: string): unknown;\n}\n\n/** Job-name namespace so time-relative sweeps never collide with plain schedule jobs. */\nconst JOB_PREFIX = 'flow-time-relative';\n\nconst MS_PER_DAY = 86_400_000;\n\n/** A closed, inclusive instant window `[gte, lte]` as ISO-8601 strings. */\nexport interface DateWindow {\n    /** Lower bound (inclusive), ISO-8601. */\n    gte: string;\n    /** Upper bound (inclusive), ISO-8601. */\n    lte: string;\n}\n\n// ─── Pure window math (day-granular, UTC) ───────────────────────────\n\n/** Start of `d`'s UTC calendar day (00:00:00.000Z). */\nfunction startOfUtcDay(d: Date): Date {\n    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), 0, 0, 0, 0));\n}\n\n/** End of `d`'s UTC calendar day (23:59:59.999Z) — inclusive upper bound. */\nfunction endOfUtcDay(d: Date): Date {\n    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), 23, 59, 59, 999));\n}\n\n/** `d`'s UTC day shifted by `n` whole days (exact in UTC — no DST drift). */\nfunction addUtcDays(d: Date, n: number): Date {\n    return new Date(startOfUtcDay(d).getTime() + n * MS_PER_DAY);\n}\n\n/**\n * Compute the inclusive date window(s) a descriptor selects, relative to `now`.\n *\n * - `offsetDays` → one single-day window per offset (`today + offset`), so the\n *   sweep fires exactly on each threshold day (the robust T-minus reminder).\n * - `withinDays` → one range window: `[today, today + N]` when N ≥ 0 (upcoming),\n *   or `[today − |N|, today]` when N < 0 (overdue lookback). Always includes today.\n *\n * Day-granular and computed in UTC. The upper bound is the *end* of its day\n * (`23:59:59.999Z`), so a `datetime` field matches for the whole day and a\n * `date` field (compared as `YYYY-MM-DD` after the driver truncates) is inclusive.\n */\nexport function computeDateWindows(desc: TimeRelativeDescriptor, now: Date): DateWindow[] {\n    const today = startOfUtcDay(now);\n\n    if (desc.offsetDays && desc.offsetDays.length > 0) {\n        return desc.offsetDays.map((offset) => {\n            const day = addUtcDays(today, offset);\n            return { gte: startOfUtcDay(day).toISOString(), lte: endOfUtcDay(day).toISOString() };\n        });\n    }\n\n    const n = desc.withinDays ?? 0;\n    if (n >= 0) {\n        return [{ gte: startOfUtcDay(today).toISOString(), lte: endOfUtcDay(addUtcDays(today, n)).toISOString() }];\n    }\n    // Negative: window extends into the past, still anchored to (and including) today.\n    return [{ gte: startOfUtcDay(addUtcDays(today, n)).toISOString(), lte: endOfUtcDay(today).toISOString() }];\n}\n\n/**\n * Build the ObjectQL `where` map for one date window: the descriptor's static\n * `filter` (if any) ANDed with a `$gte`/`$lte` range on the date field. The map\n * form is the canonical filter shape both drivers evaluate verbatim (the same\n * shape the platform's own retention sweep uses).\n */\nexport function buildWindowWhere(desc: TimeRelativeDescriptor, window: DateWindow): Record<string, unknown> {\n    return {\n        ...(desc.filter ?? {}),\n        [desc.dateField]: { $gte: window.gte, $lte: window.lte },\n    };\n}\n\nfunction errMessage(err: unknown): string {\n    return (err as Error)?.message ?? String(err);\n}\n\n/**\n * TimeRelativeTrigger\n *\n * The declarative answer to \"act on records whose date field is coming up (or\n * overdue)\" (#1874). Instead of the fragile date-equality-on-record-change\n * pattern (which only fires if the record happens to be edited on the threshold\n * day) or a hand-rolled cron + range query per flow, a flow whose start node\n * declares `config.timeRelative` is swept on a schedule (daily by default) and\n * launched **once per matching record**.\n *\n * It composes the schedule trigger's two collaborators:\n *  - the platform {@link JobServiceSurface} owns the sweep cadence (like the\n *    plain schedule trigger), and\n *  - the {@link TimeRelativeDataEngine} runs the date-window query (like the\n *    record-change trigger reaching ObjectQL).\n *\n * Both are resolved lazily (per call) so adapter upgrades — the durable job\n * adapter that replaces the bootstrap ticker on `kernel:ready`, a late-registered\n * data engine — are always picked up. The engine owns the start-node `condition`\n * gate and `runAs` identity, so this trigger only has to put the matched record\n * on the {@link AutomationContext}; `{record.<field>}` interpolation and the\n * condition work exactly as they do for a record-change flow.\n */\nexport class TimeRelativeTrigger implements FlowTrigger {\n    readonly type = 'time_relative';\n\n    private readonly getJobService: () => JobServiceSurface | null;\n    private readonly getDataEngine: () => TimeRelativeDataEngine | null;\n    private readonly logger: TriggerLogger;\n    /** Injectable clock so window math is deterministic under test. */\n    private readonly now: () => Date;\n    /** flowName → job name registered for it, so stop() can cancel it. */\n    private readonly bound = new Map<string, string>();\n\n    constructor(\n        getJobService: () => JobServiceSurface | null,\n        getDataEngine: () => TimeRelativeDataEngine | null,\n        logger: TriggerLogger,\n        now: () => Date = () => new Date(),\n    ) {\n        this.getJobService = getJobService;\n        this.getDataEngine = getDataEngine;\n        this.logger = logger;\n        this.now = now;\n    }\n\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void {\n        const raw = (binding.config as Record<string, unknown> | undefined)?.timeRelative;\n        const parsed = TimeRelativeTriggerSchema.safeParse(raw);\n        if (!parsed.success) {\n            this.logger.warn(\n                `[time-relative] flow '${binding.flowName}' has no valid \\`timeRelative\\` descriptor — not bound. ` +\n                    `Provide { object, dateField, and exactly one of withinDays | offsetDays }. ` +\n                    `(${parsed.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`).join('; ')})`,\n            );\n            return;\n        }\n        const desc = parsed.data;\n\n        // Cadence: the flow's start-node schedule descriptor, or a daily default.\n        // A daily sweep is the whole point (evaluate the window every day so a\n        // threshold day is never missed), so an omitted schedule means \"daily\",\n        // not \"never\".\n        const schedule: JobSchedule =\n            normalizeSchedule(binding.schedule) ?? { type: 'cron', expression: TIME_RELATIVE_DEFAULT_CRON };\n\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.schedule !== 'function') {\n            this.logger.warn(\n                `[time-relative] job service unavailable — flow '${binding.flowName}' not scheduled`,\n            );\n            return;\n        }\n\n        // Best-effort object-existence probe at bind time (the engine may be\n        // available now even though the sweep resolves it lazily). A descriptor\n        // targeting an unknown object would sweep forever finding nothing.\n        const engineNow = this.getDataEngine();\n        if (desc.object && engineNow && typeof engineNow.getObject === 'function') {\n            let known: unknown;\n            try {\n                known = engineNow.getObject(desc.object);\n            } catch {\n                known = undefined;\n            }\n            if (!known) {\n                this.logger.warn(\n                    `[time-relative] flow '${binding.flowName}' targets unknown object '${desc.object}' — the sweep is bound but will match nothing until that object is registered. ` +\n                        `Object names match exactly; check config.timeRelative.object.`,\n                );\n            }\n        }\n\n        // Idempotent: drop any prior schedule for this flow before re-binding\n        // (covers disable→enable cycles and hot reload).\n        this.stop(binding.flowName);\n\n        const jobName = `${JOB_PREFIX}:${binding.flowName}`;\n        const maxRecords = desc.maxRecords ?? TIME_RELATIVE_DEFAULT_MAX_RECORDS;\n\n        const handler: JobHandler = async () => {\n            try {\n                await this.sweep(binding.flowName, desc, maxRecords, callback);\n            } catch (err) {\n                // Error isolation: a sweep failure must not crash the job\n                // runner / ticker. Log and swallow.\n                this.logger.warn(\n                    `[time-relative] flow '${binding.flowName}' sweep failed: ${errMessage(err)}`,\n                );\n            }\n        };\n\n        this.bound.set(binding.flowName, jobName);\n        // FlowTrigger.start is sync; the job service's schedule() is async.\n        // Fire-and-forget with error logging (mirrors ScheduleTrigger).\n        void Promise.resolve(jobService.schedule(jobName, schedule, handler))\n            .then(() => {\n                const mode = desc.offsetDays\n                    ? `offsets [${desc.offsetDays.join(', ')}]d`\n                    : `within ${desc.withinDays}d`;\n                this.logger.info(\n                    `[time-relative] bound flow '${binding.flowName}' → sweep '${desc.object}.${desc.dateField}' ${mode} on ${schedule.type}` +\n                        (schedule.expression ? ` '${schedule.expression}'` : '') +\n                        (schedule.intervalMs ? ` every ${schedule.intervalMs}ms` : ''),\n                );\n            })\n            .catch((err) => {\n                this.bound.delete(binding.flowName);\n                this.logger.warn(\n                    `[time-relative] failed to schedule flow '${binding.flowName}': ${errMessage(err)}`,\n                );\n            });\n    }\n\n    /**\n     * Run one sweep: query each date window, union the matched records (deduped\n     * by id, capped at `maxRecords`), and launch the flow once per record. A\n     * per-record failure is isolated so one bad row never aborts the batch.\n     */\n    private async sweep(\n        flowName: string,\n        desc: TimeRelativeDescriptor,\n        maxRecords: number,\n        callback: (ctx: AutomationContext) => Promise<void>,\n    ): Promise<void> {\n        const engine = this.getDataEngine();\n        if (!engine || typeof engine.find !== 'function') {\n            this.logger.warn(\n                `[time-relative] data engine unavailable — flow '${flowName}' sweep skipped this tick`,\n            );\n            return;\n        }\n\n        const windows = computeDateWindows(desc, this.now());\n        const seenIds = new Set<unknown>();\n        const matched: Array<Record<string, unknown>> = [];\n\n        for (const window of windows) {\n            if (matched.length >= maxRecords) break;\n            const where = buildWindowWhere(desc, window);\n            const rows =\n                (await engine.find(desc.object, {\n                    where,\n                    limit: maxRecords,\n                    context: { isSystem: true },\n                })) ?? [];\n            for (const row of rows) {\n                const id = (row as { id?: unknown }).id;\n                // Dedup across windows (offset mode) by id; rows without an id\n                // are always kept (can't dedup, better than dropping).\n                if (id != null) {\n                    if (seenIds.has(id)) continue;\n                    seenIds.add(id);\n                }\n                matched.push(row);\n                if (matched.length >= maxRecords) break;\n            }\n        }\n\n        if (matched.length >= maxRecords) {\n            this.logger.warn(\n                `[time-relative] flow '${flowName}' sweep hit the ${maxRecords}-record cap — some matching records were NOT processed this tick. ` +\n                    `Narrow the window/filter, or raise config.timeRelative.maxRecords.`,\n            );\n        }\n\n        let launched = 0;\n        let failed = 0;\n        for (const record of matched) {\n            try {\n                const ctx: AutomationContext = {\n                    record,\n                    object: desc.object,\n                    event: 'time_relative',\n                    // Expose the record as params too, so flows with named `isInput`\n                    // variables matching record fields get them seeded (parity with\n                    // the record-change trigger).\n                    params: record,\n                };\n                await callback(ctx);\n                launched++;\n            } catch (err) {\n                failed++;\n                // Error isolation per record: one failing flow run must not stop\n                // the sweep. ERROR when available (stderr survives the CLI's\n                // boot-quiet stdout window), else warn.\n                const log = this.logger.error?.bind(this.logger) ?? this.logger.warn.bind(this.logger);\n                log(\n                    `[time-relative] flow '${flowName}' failed for record '${String((record as { id?: unknown }).id ?? '?')}': ${errMessage(err)}`,\n                );\n            }\n        }\n\n        this.logger.debug?.(\n            `[time-relative] flow '${flowName}' swept '${desc.object}': ${matched.length} matched, ${launched} launched, ${failed} failed`,\n        );\n    }\n\n    stop(flowName: string): void {\n        const jobName = this.bound.get(flowName);\n        if (!jobName) return;\n        this.bound.delete(flowName);\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.cancel !== 'function') return;\n        void Promise.resolve(jobService.cancel(jobName))\n            .then(() => this.logger.debug?.(`[time-relative] unbound flow '${flowName}'`))\n            .catch((err) => {\n                this.logger.warn(\n                    `[time-relative] failed to unbind flow '${flowName}': ${errMessage(err)}`,\n                );\n            });\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { TimeRelativeTrigger } from './time-relative-trigger.js';\nimport type { TimeRelativeDataEngine } from './time-relative-trigger.js';\nimport type { FlowTrigger, JobServiceSurface } from './schedule-trigger.js';\n\n/**\n * The slice of the automation engine this plugin needs: register a trigger on\n * its `FlowTrigger` extension point. Declared structurally so the plugin does\n * not take a build dependency on `@objectstack/service-automation`.\n */\ninterface AutomationTriggerRegistry {\n    registerTrigger(trigger: FlowTrigger): void;\n    unregisterTrigger?(type: string): void;\n}\n\n/**\n * TimeRelativeTriggerPlugin\n *\n * Arms **declarative time-relative flows** (#1874): a flow whose start node\n * declares `config.timeRelative` (object + dateField + `withinDays`/`offsetDays`)\n * is swept on a schedule and launched once per record whose date field falls in\n * the window — no hand-written cron + range query, no fragile\n * date-equality-on-record-change.\n *\n * It ships in `@objectstack/trigger-schedule` alongside the plain schedule\n * trigger (both are schedule-driven) but is a **separate** plugin: the\n * time-relative trigger additionally needs the ObjectQL engine (for the sweep\n * query), so keeping it separate leaves the plain `ScheduleTriggerPlugin`'s\n * dependency surface unchanged. Depends on the job service (sweep cadence) and\n * the ObjectQL engine (record discovery); both are resolved lazily per `start()`\n * so adapter upgrades are always picked up.\n */\nexport class TimeRelativeTriggerPlugin implements Plugin {\n    name = 'com.objectstack.trigger.time-relative';\n    type = 'standard';\n    version = '1.0.0';\n    dependencies = ['com.objectstack.service.job', 'com.objectstack.engine.objectql'];\n\n    async init(ctx: PluginContext): Promise<void> {\n        ctx.logger.info('Time-relative trigger plugin initialized');\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        // The automation service, job service, and ObjectQL engine are all\n        // resolvable once the kernel is ready (kernel:ready fires after\n        // AutomationServicePlugin.start() has pulled flows in and after the job\n        // service upgrades its adapter).\n        ctx.hook('kernel:ready', async () => {\n            const automation = this.resolveService<AutomationTriggerRegistry>(ctx, 'automation');\n            if (!automation || typeof automation.registerTrigger !== 'function') {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: automation service not available — time-relative trigger NOT installed',\n                );\n                return;\n            }\n\n            // Probe once for a clear startup warning; the trigger re-resolves\n            // both collaborators lazily on each start()/sweep so late upgrades\n            // are always picked up.\n            if (!this.resolveService<JobServiceSurface>(ctx, 'job')) {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: job service not available — time-relative sweeps will not run until one is registered',\n                );\n            }\n            if (!this.resolveDataEngine(ctx)) {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: ObjectQL engine not available — time-relative sweeps will find no records until it is',\n                );\n            }\n\n            const trigger = new TimeRelativeTrigger(\n                () => this.resolveService<JobServiceSurface>(ctx, 'job'),\n                () => this.resolveDataEngine(ctx),\n                ctx.logger,\n            );\n            automation.registerTrigger(trigger);\n            ctx.logger.info('TimeRelativeTriggerPlugin: time-relative trigger registered');\n        });\n    }\n\n    private resolveService<T>(ctx: PluginContext, name: string): T | null {\n        try {\n            return ctx.getService<T>(name) ?? null;\n        } catch {\n            return null;\n        }\n    }\n\n    private resolveDataEngine(ctx: PluginContext): TimeRelativeDataEngine | null {\n        // Primary alias 'objectql', fallback 'data' (some kernels register the\n        // engine under both) — same lookup the record-change trigger uses.\n        return (\n            this.resolveService<TimeRelativeDataEngine>(ctx, 'objectql') ??\n            this.resolveService<TimeRelativeDataEngine>(ctx, 'data')\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC0DA,IAAM,aAAa;AASZ,SAAS,kBAAkB,KAAkC;AAChE,MAAI,OAAO,KAAM,QAAO;AAGxB,MAAI,OAAO,QAAQ,UAAU;AACzB,UAAM,OAAO,IAAI,KAAK;AACtB,WAAO,OAAO,EAAE,MAAM,QAAQ,YAAY,KAAK,IAAI;AAAA,EACvD;AAEA,MAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,QAAM,IAAI;AAEV,QAAM,OAAO,OAAO,EAAE,SAAS,WAAW,EAAE,OAAO;AAEnD,MAAI,SAAS,UAAW,CAAC,SAAS,OAAO,EAAE,SAAS,YAAY,OAAO,EAAE,eAAe,WAAY;AAChG,UAAM,aACD,OAAO,EAAE,eAAe,YAAY,EAAE,cACtC,OAAO,EAAE,SAAS,YAAY,EAAE,QACjC;AACJ,QAAI,CAAC,WAAY,QAAO;AACxB,UAAM,MAAmB,EAAE,MAAM,QAAQ,WAAW;AACpD,QAAI,OAAO,EAAE,aAAa,SAAU,KAAI,WAAW,EAAE;AACrD,WAAO;AAAA,EACX;AAEA,MAAI,SAAS,cAAe,CAAC,SAAS,OAAO,EAAE,eAAe,YAAY,OAAO,EAAE,UAAU,WAAY;AACrG,UAAM,aACD,OAAO,EAAE,eAAe,YAAY,EAAE,cACtC,OAAO,EAAE,UAAU,YAAY,EAAE,SAClC;AACJ,QAAI,CAAC,cAAc,cAAc,EAAG,QAAO;AAC3C,WAAO,EAAE,MAAM,YAAY,WAAW;AAAA,EAC1C;AAEA,MAAI,SAAS,UAAW,CAAC,QAAQ,OAAO,EAAE,OAAO,UAAW;AACxD,UAAM,KAAK,OAAO,EAAE,OAAO,WAAW,EAAE,KAAK;AAC7C,QAAI,CAAC,GAAI,QAAO;AAChB,WAAO,EAAE,MAAM,QAAQ,GAAG;AAAA,EAC9B;AAEA,SAAO;AACX;AAgBO,IAAM,kBAAN,MAA6C;AAAA,EAQhD,YAAY,eAA+C,QAAuB;AAPlF,SAAS,OAAO;AAKhB;AAAA,SAAiB,QAAQ,oBAAI,IAAoB;AAG7C,SAAK,gBAAgB;AACrB,SAAK,SAAS;AAAA,EAClB;AAAA,EAEA,MAAM,SAA6B,UAA2D;AAC1F,UAAM,MAAM,QAAQ,YAAa,QAAQ,QAAgD;AACzF,UAAM,WAAW,kBAAkB,GAAG;AACtC,QAAI,CAAC,UAAU;AACX,WAAK,OAAO;AAAA,QACR,oBAAoB,QAAQ,QAAQ;AAAA,MACxC;AACA;AAAA,IACJ;AAEA,UAAM,aAAa,KAAK,cAAc;AACtC,QAAI,CAAC,cAAc,OAAO,WAAW,aAAa,YAAY;AAC1D,WAAK,OAAO;AAAA,QACR,mDAA8C,QAAQ,QAAQ;AAAA,MAClE;AACA;AAAA,IACJ;AAIA,SAAK,KAAK,QAAQ,QAAQ;AAE1B,UAAM,UAAU,GAAG,UAAU,IAAI,QAAQ,QAAQ;AAEjD,UAAM,UAAsB,OAAO,EAAE,MAAM,MAAM;AAC7C,UAAI;AACA,cAAM,MAAyB;AAAA,UAC3B,OAAO;AAAA,UACP,QAAQ;AAAA,YACJ;AAAA,YACA,UAAU,QAAQ;AAAA,YAClB;AAAA,UACJ;AAAA,QACJ;AACA,cAAM,SAAS,GAAG;AAAA,MACtB,SAAS,KAAK;AAGV,aAAK,OAAO;AAAA,UACR,oBAAoB,QAAQ,QAAQ,uBAAwB,KAAe,WAAW,OAAO,GAAG,CAAC;AAAA,QACrG;AAAA,MACJ;AAAA,IACJ;AAEA,SAAK,MAAM,IAAI,QAAQ,UAAU,OAAO;AAGxC,SAAK,QAAQ,QAAQ,WAAW,SAAS,SAAS,UAAU,OAAO,CAAC,EAC/D,KAAK,MAAM;AACR,WAAK,OAAO;AAAA,QACR,0BAA0B,QAAQ,QAAQ,YAAO,SAAS,IAAI,MACzD,SAAS,aAAa,KAAK,SAAS,UAAU,MAAM,OACpD,SAAS,aAAa,UAAU,SAAS,UAAU,OAAO,OAC1D,SAAS,KAAK,OAAO,SAAS,EAAE,KAAK;AAAA,MAC9C;AAAA,IACJ,CAAC,EACA,MAAM,CAAC,QAAQ;AACZ,WAAK,MAAM,OAAO,QAAQ,QAAQ;AAClC,WAAK,OAAO;AAAA,QACR,uCAAuC,QAAQ,QAAQ,MAAO,KAAe,WAAW,OAAO,GAAG,CAAC;AAAA,MACvG;AAAA,IACJ,CAAC;AAAA,EACT;AAAA,EAEA,KAAK,UAAwB;AACzB,UAAM,UAAU,KAAK,MAAM,IAAI,QAAQ;AACvC,QAAI,CAAC,QAAS;AACd,SAAK,MAAM,OAAO,QAAQ;AAC1B,UAAM,aAAa,KAAK,cAAc;AACtC,QAAI,CAAC,cAAc,OAAO,WAAW,WAAW,WAAY;AAC5D,SAAK,QAAQ,QAAQ,WAAW,OAAO,OAAO,CAAC,EAC1C,KAAK,MAAM,KAAK,OAAO,QAAQ,4BAA4B,QAAQ,GAAG,CAAC,EACvE,MAAM,CAAC,QAAQ;AACZ,WAAK,OAAO;AAAA,QACR,qCAAqC,QAAQ,MAAO,KAAe,WAAW,OAAO,GAAG,CAAC;AAAA,MAC7F;AAAA,IACJ,CAAC;AAAA,EACT;AACJ;;;ACpLO,IAAM,wBAAN,MAA8C;AAAA,EAA9C;AACH,gBAAO;AACP,gBAAO;AACP,mBAAU;AACV,wBAAe,CAAC,6BAA6B;AAAA;AAAA,EAE7C,MAAM,KAAK,KAAmC;AAC1C,QAAI,OAAO,KAAK,qCAAqC;AAAA,EACzD;AAAA,EAEA,MAAM,MAAM,KAAmC;AAI3C,QAAI,KAAK,gBAAgB,YAAY;AACjC,YAAM,aAAa,KAAK,eAA0C,KAAK,YAAY;AACnF,UAAI,CAAC,cAAc,OAAO,WAAW,oBAAoB,YAAY;AACjE,YAAI,OAAO;AAAA,UACP;AAAA,QACJ;AACA;AAAA,MACJ;AAIA,UAAI,CAAC,KAAK,eAAkC,KAAK,KAAK,GAAG;AACrD,YAAI,OAAO;AAAA,UACP;AAAA,QACJ;AAAA,MACJ;AAEA,YAAM,UAAU,IAAI;AAAA,QAChB,MAAM,KAAK,eAAkC,KAAK,KAAK;AAAA,QACvD,IAAI;AAAA,MACR;AACA,iBAAW,gBAAgB,OAAO;AAClC,UAAI,OAAO,KAAK,oDAAoD;AAAA,IACxE,CAAC;AAAA,EACL;AAAA,EAEQ,eAAkB,KAAoB,MAAwB;AAClE,QAAI;AACA,aAAO,IAAI,WAAc,IAAI,KAAK;AAAA,IACtC,QAAQ;AACJ,aAAO;AAAA,IACX;AAAA,EACJ;AACJ;;;AC/EA,wBAIO;AAiCP,IAAMA,cAAa;AAEnB,IAAM,aAAa;AAanB,SAAS,cAAc,GAAe;AAClC,SAAO,IAAI,KAAK,KAAK,IAAI,EAAE,eAAe,GAAG,EAAE,YAAY,GAAG,EAAE,WAAW,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;AAC7F;AAGA,SAAS,YAAY,GAAe;AAChC,SAAO,IAAI,KAAK,KAAK,IAAI,EAAE,eAAe,GAAG,EAAE,YAAY,GAAG,EAAE,WAAW,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC;AAClG;AAGA,SAAS,WAAW,GAAS,GAAiB;AAC1C,SAAO,IAAI,KAAK,cAAc,CAAC,EAAE,QAAQ,IAAI,IAAI,UAAU;AAC/D;AAcO,SAAS,mBAAmB,MAA8B,KAAyB;AACtF,QAAM,QAAQ,cAAc,GAAG;AAE/B,MAAI,KAAK,cAAc,KAAK,WAAW,SAAS,GAAG;AAC/C,WAAO,KAAK,WAAW,IAAI,CAAC,WAAW;AACnC,YAAM,MAAM,WAAW,OAAO,MAAM;AACpC,aAAO,EAAE,KAAK,cAAc,GAAG,EAAE,YAAY,GAAG,KAAK,YAAY,GAAG,EAAE,YAAY,EAAE;AAAA,IACxF,CAAC;AAAA,EACL;AAEA,QAAM,IAAI,KAAK,cAAc;AAC7B,MAAI,KAAK,GAAG;AACR,WAAO,CAAC,EAAE,KAAK,cAAc,KAAK,EAAE,YAAY,GAAG,KAAK,YAAY,WAAW,OAAO,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;AAAA,EAC7G;AAEA,SAAO,CAAC,EAAE,KAAK,cAAc,WAAW,OAAO,CAAC,CAAC,EAAE,YAAY,GAAG,KAAK,YAAY,KAAK,EAAE,YAAY,EAAE,CAAC;AAC7G;AAQO,SAAS,iBAAiB,MAA8B,QAA6C;AACxG,SAAO;AAAA,IACH,GAAI,KAAK,UAAU,CAAC;AAAA,IACpB,CAAC,KAAK,SAAS,GAAG,EAAE,MAAM,OAAO,KAAK,MAAM,OAAO,IAAI;AAAA,EAC3D;AACJ;AAEA,SAAS,WAAW,KAAsB;AACtC,SAAQ,KAAe,WAAW,OAAO,GAAG;AAChD;AAyBO,IAAM,sBAAN,MAAiD;AAAA,EAWpD,YACI,eACA,eACA,QACA,MAAkB,MAAM,oBAAI,KAAK,GACnC;AAfF,SAAS,OAAO;AAQhB;AAAA,SAAiB,QAAQ,oBAAI,IAAoB;AAQ7C,SAAK,gBAAgB;AACrB,SAAK,gBAAgB;AACrB,SAAK,SAAS;AACd,SAAK,MAAM;AAAA,EACf;AAAA,EAEA,MAAM,SAA6B,UAA2D;AAC1F,UAAM,MAAO,QAAQ,QAAgD;AACrE,UAAM,SAAS,4CAA0B,UAAU,GAAG;AACtD,QAAI,CAAC,OAAO,SAAS;AACjB,WAAK,OAAO;AAAA,QACR,yBAAyB,QAAQ,QAAQ,4IAEjC,OAAO,MAAM,OAAO,IAAI,CAAC,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,KAAK,QAAQ,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,IAAI,CAAC;AAAA,MACtG;AACA;AAAA,IACJ;AACA,UAAM,OAAO,OAAO;AAMpB,UAAM,WACF,kBAAkB,QAAQ,QAAQ,KAAK,EAAE,MAAM,QAAQ,YAAY,6CAA2B;AAElG,UAAM,aAAa,KAAK,cAAc;AACtC,QAAI,CAAC,cAAc,OAAO,WAAW,aAAa,YAAY;AAC1D,WAAK,OAAO;AAAA,QACR,wDAAmD,QAAQ,QAAQ;AAAA,MACvE;AACA;AAAA,IACJ;AAKA,UAAM,YAAY,KAAK,cAAc;AACrC,QAAI,KAAK,UAAU,aAAa,OAAO,UAAU,cAAc,YAAY;AACvE,UAAI;AACJ,UAAI;AACA,gBAAQ,UAAU,UAAU,KAAK,MAAM;AAAA,MAC3C,QAAQ;AACJ,gBAAQ;AAAA,MACZ;AACA,UAAI,CAAC,OAAO;AACR,aAAK,OAAO;AAAA,UACR,yBAAyB,QAAQ,QAAQ,6BAA6B,KAAK,MAAM;AAAA,QAErF;AAAA,MACJ;AAAA,IACJ;AAIA,SAAK,KAAK,QAAQ,QAAQ;AAE1B,UAAM,UAAU,GAAGA,WAAU,IAAI,QAAQ,QAAQ;AACjD,UAAM,aAAa,KAAK,cAAc;AAEtC,UAAM,UAAsB,YAAY;AACpC,UAAI;AACA,cAAM,KAAK,MAAM,QAAQ,UAAU,MAAM,YAAY,QAAQ;AAAA,MACjE,SAAS,KAAK;AAGV,aAAK,OAAO;AAAA,UACR,yBAAyB,QAAQ,QAAQ,mBAAmB,WAAW,GAAG,CAAC;AAAA,QAC/E;AAAA,MACJ;AAAA,IACJ;AAEA,SAAK,MAAM,IAAI,QAAQ,UAAU,OAAO;AAGxC,SAAK,QAAQ,QAAQ,WAAW,SAAS,SAAS,UAAU,OAAO,CAAC,EAC/D,KAAK,MAAM;AACR,YAAM,OAAO,KAAK,aACZ,YAAY,KAAK,WAAW,KAAK,IAAI,CAAC,OACtC,UAAU,KAAK,UAAU;AAC/B,WAAK,OAAO;AAAA,QACR,+BAA+B,QAAQ,QAAQ,mBAAc,KAAK,MAAM,IAAI,KAAK,SAAS,KAAK,IAAI,OAAO,SAAS,IAAI,MAClH,SAAS,aAAa,KAAK,SAAS,UAAU,MAAM,OACpD,SAAS,aAAa,UAAU,SAAS,UAAU,OAAO;AAAA,MACnE;AAAA,IACJ,CAAC,EACA,MAAM,CAAC,QAAQ;AACZ,WAAK,MAAM,OAAO,QAAQ,QAAQ;AAClC,WAAK,OAAO;AAAA,QACR,4CAA4C,QAAQ,QAAQ,MAAM,WAAW,GAAG,CAAC;AAAA,MACrF;AAAA,IACJ,CAAC;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAc,MACV,UACA,MACA,YACA,UACa;AACb,UAAM,SAAS,KAAK,cAAc;AAClC,QAAI,CAAC,UAAU,OAAO,OAAO,SAAS,YAAY;AAC9C,WAAK,OAAO;AAAA,QACR,wDAAmD,QAAQ;AAAA,MAC/D;AACA;AAAA,IACJ;AAEA,UAAM,UAAU,mBAAmB,MAAM,KAAK,IAAI,CAAC;AACnD,UAAM,UAAU,oBAAI,IAAa;AACjC,UAAM,UAA0C,CAAC;AAEjD,eAAW,UAAU,SAAS;AAC1B,UAAI,QAAQ,UAAU,WAAY;AAClC,YAAM,QAAQ,iBAAiB,MAAM,MAAM;AAC3C,YAAM,OACD,MAAM,OAAO,KAAK,KAAK,QAAQ;AAAA,QAC5B;AAAA,QACA,OAAO;AAAA,QACP,SAAS,EAAE,UAAU,KAAK;AAAA,MAC9B,CAAC,KAAM,CAAC;AACZ,iBAAW,OAAO,MAAM;AACpB,cAAM,KAAM,IAAyB;AAGrC,YAAI,MAAM,MAAM;AACZ,cAAI,QAAQ,IAAI,EAAE,EAAG;AACrB,kBAAQ,IAAI,EAAE;AAAA,QAClB;AACA,gBAAQ,KAAK,GAAG;AAChB,YAAI,QAAQ,UAAU,WAAY;AAAA,MACtC;AAAA,IACJ;AAEA,QAAI,QAAQ,UAAU,YAAY;AAC9B,WAAK,OAAO;AAAA,QACR,yBAAyB,QAAQ,mBAAmB,UAAU;AAAA,MAElE;AAAA,IACJ;AAEA,QAAI,WAAW;AACf,QAAI,SAAS;AACb,eAAW,UAAU,SAAS;AAC1B,UAAI;AACA,cAAM,MAAyB;AAAA,UAC3B;AAAA,UACA,QAAQ,KAAK;AAAA,UACb,OAAO;AAAA;AAAA;AAAA;AAAA,UAIP,QAAQ;AAAA,QACZ;AACA,cAAM,SAAS,GAAG;AAClB;AAAA,MACJ,SAAS,KAAK;AACV;AAIA,cAAM,MAAM,KAAK,OAAO,OAAO,KAAK,KAAK,MAAM,KAAK,KAAK,OAAO,KAAK,KAAK,KAAK,MAAM;AACrF;AAAA,UACI,yBAAyB,QAAQ,wBAAwB,OAAQ,OAA4B,MAAM,GAAG,CAAC,MAAM,WAAW,GAAG,CAAC;AAAA,QAChI;AAAA,MACJ;AAAA,IACJ;AAEA,SAAK,OAAO;AAAA,MACR,yBAAyB,QAAQ,YAAY,KAAK,MAAM,MAAM,QAAQ,MAAM,aAAa,QAAQ,cAAc,MAAM;AAAA,IACzH;AAAA,EACJ;AAAA,EAEA,KAAK,UAAwB;AACzB,UAAM,UAAU,KAAK,MAAM,IAAI,QAAQ;AACvC,QAAI,CAAC,QAAS;AACd,SAAK,MAAM,OAAO,QAAQ;AAC1B,UAAM,aAAa,KAAK,cAAc;AACtC,QAAI,CAAC,cAAc,OAAO,WAAW,WAAW,WAAY;AAC5D,SAAK,QAAQ,QAAQ,WAAW,OAAO,OAAO,CAAC,EAC1C,KAAK,MAAM,KAAK,OAAO,QAAQ,iCAAiC,QAAQ,GAAG,CAAC,EAC5E,MAAM,CAAC,QAAQ;AACZ,WAAK,OAAO;AAAA,QACR,0CAA0C,QAAQ,MAAM,WAAW,GAAG,CAAC;AAAA,MAC3E;AAAA,IACJ,CAAC;AAAA,EACT;AACJ;;;AC1TO,IAAM,4BAAN,MAAkD;AAAA,EAAlD;AACH,gBAAO;AACP,gBAAO;AACP,mBAAU;AACV,wBAAe,CAAC,+BAA+B,iCAAiC;AAAA;AAAA,EAEhF,MAAM,KAAK,KAAmC;AAC1C,QAAI,OAAO,KAAK,0CAA0C;AAAA,EAC9D;AAAA,EAEA,MAAM,MAAM,KAAmC;AAK3C,QAAI,KAAK,gBAAgB,YAAY;AACjC,YAAM,aAAa,KAAK,eAA0C,KAAK,YAAY;AACnF,UAAI,CAAC,cAAc,OAAO,WAAW,oBAAoB,YAAY;AACjE,YAAI,OAAO;AAAA,UACP;AAAA,QACJ;AACA;AAAA,MACJ;AAKA,UAAI,CAAC,KAAK,eAAkC,KAAK,KAAK,GAAG;AACrD,YAAI,OAAO;AAAA,UACP;AAAA,QACJ;AAAA,MACJ;AACA,UAAI,CAAC,KAAK,kBAAkB,GAAG,GAAG;AAC9B,YAAI,OAAO;AAAA,UACP;AAAA,QACJ;AAAA,MACJ;AAEA,YAAM,UAAU,IAAI;AAAA,QAChB,MAAM,KAAK,eAAkC,KAAK,KAAK;AAAA,QACvD,MAAM,KAAK,kBAAkB,GAAG;AAAA,QAChC,IAAI;AAAA,MACR;AACA,iBAAW,gBAAgB,OAAO;AAClC,UAAI,OAAO,KAAK,6DAA6D;AAAA,IACjF,CAAC;AAAA,EACL;AAAA,EAEQ,eAAkB,KAAoB,MAAwB;AAClE,QAAI;AACA,aAAO,IAAI,WAAc,IAAI,KAAK;AAAA,IACtC,QAAQ;AACJ,aAAO;AAAA,IACX;AAAA,EACJ;AAAA,EAEQ,kBAAkB,KAAmD;AAGzE,WACI,KAAK,eAAuC,KAAK,UAAU,KAC3D,KAAK,eAAuC,KAAK,MAAM;AAAA,EAE/D;AACJ;","names":["JOB_PREFIX"]}
+{"version":3,"sources":["../src/index.ts","../src/schedule-trigger.ts","../src/plugin.ts","../src/time-relative-trigger.ts","../src/time-relative-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { ScheduleTriggerPlugin } from './plugin.js';\nexport { ScheduleTrigger, normalizeSchedule } from './schedule-trigger.js';\nexport type {\n    FlowTrigger,\n    FlowTriggerBinding,\n    JobServiceSurface,\n    TriggerLogger,\n} from './schedule-trigger.js';\n\nexport { TimeRelativeTriggerPlugin } from './time-relative-plugin.js';\nexport {\n    TimeRelativeTrigger,\n    computeDateWindows,\n    buildWindowWhere,\n} from './time-relative-trigger.js';\nexport type { TimeRelativeDataEngine, DateWindow } from './time-relative-trigger.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { AutomationContext } from '@objectstack/spec/contracts';\nimport type { JobSchedule, JobHandler } from '@objectstack/spec/contracts';\n\n/**\n * Structural mirror of the automation engine's `FlowTriggerBinding`\n * (service-automation/src/engine.ts). Declared locally so this trigger plugin\n * stays decoupled from the automation package — same pattern the record-change\n * trigger and the connector / messaging integrations use. The engine parses the\n * flow's start node and hands us a binding whose `schedule` carries the\n * cron/interval/once descriptor.\n */\nexport interface FlowTriggerBinding {\n    readonly flowName: string;\n    readonly object?: string;\n    readonly event?: string;\n    readonly condition?: string | { dialect?: string; source?: string; ast?: unknown };\n    readonly schedule?: unknown;\n    readonly config?: Record<string, unknown>;\n}\n\n/**\n * Structural mirror of the engine's `FlowTrigger` extension point. The engine\n * calls {@link start} with a parsed binding + a callback that runs the flow,\n * and {@link stop} when the flow is unregistered/disabled.\n */\nexport interface FlowTrigger {\n    readonly type: string;\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void;\n    stop(flowName: string): void;\n}\n\n/**\n * The slice of `IJobService` this trigger needs: schedule a named job and\n * cancel it. Typed structurally so the plugin depends on the spec contract\n * shape, not a concrete adapter.\n */\nexport interface JobServiceSurface {\n    schedule(name: string, schedule: JobSchedule, handler: JobHandler): Promise<void>;\n    cancel(name: string): Promise<void>;\n}\n\n/** Minimal logger surface (matches core's `ctx.logger`). */\nexport interface TriggerLogger {\n    info(msg: string, ...args: unknown[]): void;\n    warn(msg: string, ...args: unknown[]): void;\n    debug?(msg: string, ...args: unknown[]): void;\n    /**\n     * Execution failures log here when available (falling back to `warn`).\n     * ERROR matters operationally: the CLI's boot-quiet window swallows\n     * stdout (debug/info/warn) but stderr (error/fatal) always lands — so a\n     * per-record sweep failure stays visible. Mirrors the record-change\n     * trigger's logger surface.\n     */\n    error?(msg: string, ...args: unknown[]): void;\n}\n\nconst JOB_PREFIX = 'flow-schedule';\n\n/**\n * Report a scheduled flow that failed to bind to the job service.\n *\n * **Why this is `error` and not `warn`** — the repo's degradation-log-level\n * rule (AGENTS.md) decides the level with one question: after the degradation,\n * does the system still look normal from the outside while something it claims\n * is in place has not landed? Here it does, completely: the flow stays\n * published and active in `sys_metadata`, Studio lists it, the metadata API\n * serves it and `verify_build` passes — while nothing will ever fire it. That\n * is persisted state and runtime state disagreeing, which the rule puts in the\n * `error` class, not the functional-degradation class.\n *\n * The neighbouring composition branch — \"no job service is registered at all\" —\n * deliberately stays at `warn`: the system is *visibly* smaller and the rule\n * names that exact message as correctly a `warn`. The distinction is not the\n * severity of the outcome, it is whether the outside can see it.\n *\n * An `error` here owes two things, both in the first line it prints: the\n * concrete consequence (including that everything else keeps looking healthy)\n * and the remedy. Kept in one helper so both triggers say it the same way.\n */\nexport function reportBindFailure(\n    logger: TriggerLogger,\n    tag: 'schedule' | 'time-relative',\n    flowName: string,\n    err: unknown,\n): void {\n    const report = logger.error?.bind(logger) ?? logger.warn.bind(logger);\n    report(\n        `[${tag}] flow '${flowName}' FAILED to bind to the job service: ${(err as Error)?.message ?? String(err)}. ` +\n            'The flow stays published and active — Studio, the metadata API and verify_build all keep reporting it ' +\n            'healthy — but nothing will fire it until it binds. Re-publish the flow (or restart the environment) to retry.',\n    );\n}\n\n/**\n * Normalize a flow's raw `schedule` descriptor into a {@link JobSchedule}, or\n * `null` if it can't be understood. Accepts the canonical\n * `{ type: 'cron'|'interval'|'once', ... }` shape plus a few ergonomic\n * shorthands (a bare cron string, `{ cron }`, `{ expression }`, `{ every }` /\n * `{ intervalMs }`, `{ at }`).\n */\nexport function normalizeSchedule(raw: unknown): JobSchedule | null {\n    if (raw == null) return null;\n\n    // Bare cron string, e.g. '0 1 * * *'.\n    if (typeof raw === 'string') {\n        const expr = raw.trim();\n        return expr ? { type: 'cron', expression: expr } : null;\n    }\n\n    if (typeof raw !== 'object') return null;\n    const s = raw as Record<string, unknown>;\n\n    const type = typeof s.type === 'string' ? s.type : undefined;\n\n    if (type === 'cron' || (!type && (typeof s.cron === 'string' || typeof s.expression === 'string'))) {\n        const expression =\n            (typeof s.expression === 'string' && s.expression) ||\n            (typeof s.cron === 'string' && s.cron) ||\n            undefined;\n        if (!expression) return null;\n        const out: JobSchedule = { type: 'cron', expression };\n        if (typeof s.timezone === 'string') out.timezone = s.timezone;\n        return out;\n    }\n\n    if (type === 'interval' || (!type && (typeof s.intervalMs === 'number' || typeof s.every === 'number'))) {\n        const intervalMs =\n            (typeof s.intervalMs === 'number' && s.intervalMs) ||\n            (typeof s.every === 'number' && s.every) ||\n            undefined;\n        if (!intervalMs || intervalMs <= 0) return null;\n        return { type: 'interval', intervalMs };\n    }\n\n    if (type === 'once' || (!type && typeof s.at === 'string')) {\n        const at = typeof s.at === 'string' ? s.at : undefined;\n        if (!at) return null;\n        return { type: 'once', at };\n    }\n\n    return null;\n}\n\n/**\n * ScheduleTrigger\n *\n * Bridges the automation engine's {@link FlowTrigger} extension point to the\n * platform {@link JobServiceSurface}. For each schedule-triggered flow the\n * engine activates, it registers a job whose handler runs the flow; the job\n * service owns the actual cron/interval/once timing (so this trigger stays\n * adapter-agnostic — cron schedules need a cron-capable adapter, which the\n * job service selects).\n *\n * The job service is resolved lazily (per `start()`) via the supplied accessor,\n * so we always pick up the job service's *upgraded* adapter (e.g. the durable\n * DbJobAdapter that replaces the bootstrap interval adapter on `kernel:ready`).\n */\nexport class ScheduleTrigger implements FlowTrigger {\n    readonly type = 'schedule';\n\n    private readonly getJobService: () => JobServiceSurface | null;\n    private readonly logger: TriggerLogger;\n    /** flowName → job name registered for it, so stop() can cancel it. */\n    private readonly bound = new Map<string, string>();\n\n    constructor(getJobService: () => JobServiceSurface | null, logger: TriggerLogger) {\n        this.getJobService = getJobService;\n        this.logger = logger;\n    }\n\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void {\n        const raw = binding.schedule ?? (binding.config as Record<string, unknown> | undefined)?.schedule;\n        const schedule = normalizeSchedule(raw);\n        if (!schedule) {\n            this.logger.warn(\n                `[schedule] flow '${binding.flowName}' has no recognizable schedule descriptor — not bound`,\n            );\n            return;\n        }\n\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.schedule !== 'function') {\n            this.logger.warn(\n                `[schedule] job service unavailable — flow '${binding.flowName}' not scheduled`,\n            );\n            return;\n        }\n\n        // Idempotent: drop any prior schedule for this flow before re-binding\n        // (covers disable→enable cycles and hot reload).\n        this.stop(binding.flowName);\n\n        const jobName = `${JOB_PREFIX}:${binding.flowName}`;\n\n        const handler: JobHandler = async ({ jobId }) => {\n            try {\n                const ctx: AutomationContext = {\n                    event: 'schedule',\n                    params: {\n                        jobId,\n                        flowName: binding.flowName,\n                        schedule,\n                    },\n                };\n                await callback(ctx);\n            } catch (err) {\n                // Error isolation: a scheduled flow failure must not crash the\n                // job runner / ticker. Log and swallow.\n                this.logger.warn(\n                    `[schedule] flow '${binding.flowName}' execution failed: ${(err as Error)?.message ?? String(err)}`,\n                );\n            }\n        };\n\n        this.bound.set(binding.flowName, jobName);\n        // FlowTrigger.start is sync; the job service's schedule() is async.\n        // Fire-and-forget with error logging.\n        void Promise.resolve(jobService.schedule(jobName, schedule, handler))\n            .then(() => {\n                this.logger.info(\n                    `[schedule] bound flow '${binding.flowName}' → ${schedule.type}` +\n                        (schedule.expression ? ` '${schedule.expression}'` : '') +\n                        (schedule.intervalMs ? ` every ${schedule.intervalMs}ms` : '') +\n                        (schedule.at ? ` at ${schedule.at}` : ''),\n                );\n            })\n            .catch((err) => {\n                this.bound.delete(binding.flowName);\n                reportBindFailure(this.logger, 'schedule', binding.flowName, err);\n            });\n    }\n\n    stop(flowName: string): void {\n        const jobName = this.bound.get(flowName);\n        if (!jobName) return;\n        this.bound.delete(flowName);\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.cancel !== 'function') return;\n        void Promise.resolve(jobService.cancel(jobName))\n            .then(() => this.logger.debug?.(`[schedule] unbound flow '${flowName}'`))\n            .catch((err) => {\n                this.logger.warn(\n                    `[schedule] failed to unbind flow '${flowName}': ${(err as Error)?.message ?? String(err)}`,\n                );\n            });\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { ScheduleTrigger } from './schedule-trigger.js';\nimport type { FlowTrigger, JobServiceSurface } from './schedule-trigger.js';\n\n/**\n * The slice of the automation engine this plugin needs: register a trigger on\n * its `FlowTrigger` extension point. Declared structurally so the plugin does\n * not take a build dependency on `@objectstack/service-automation`.\n */\ninterface AutomationTriggerRegistry {\n    registerTrigger(trigger: FlowTrigger): void;\n    unregisterTrigger?(type: string): void;\n}\n\n/**\n * ScheduleTriggerPlugin\n *\n * Makes schedule-triggered flows actually fire. The automation engine ships the\n * `FlowTrigger` wiring (it parses each flow's start node — `flow.type ===\n * 'schedule'` or a start-node `config.schedule` descriptor — into a binding and\n * calls `trigger.start(...)`), but the *concrete* schedule trigger lives here as\n * a plugin and delegates timing to the platform `IJobService` (the `'job'`\n * service). This mirrors the connector / record-change split (engine baseline +\n * trigger plugin).\n *\n * With this plugin (and a job service) installed, a flow whose start node\n * declares `config: { schedule: { type: 'cron', expression: '0 1 * * *' } }`\n * auto-launches on that schedule — no manual `engine.execute()`.\n *\n * Depends on the job service plugin so its `kernel:ready` upgrade (to the\n * durable DbJobAdapter) runs before ours; the job service is nonetheless\n * resolved lazily per `start()` so we always use its current adapter.\n */\nexport class ScheduleTriggerPlugin implements Plugin {\n    name = 'com.objectstack.trigger.schedule';\n    type = 'standard';\n    version = '7.3.0';\n    dependencies = ['com.objectstack.service.job'];\n\n    async init(ctx: PluginContext): Promise<void> {\n        ctx.logger.info('Schedule trigger plugin initialized');\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        // The automation service + job service are resolvable once the kernel is\n        // ready (kernel:ready fires after AutomationServicePlugin.start() has\n        // pulled flows in and after the job service upgrades its adapter).\n        ctx.hook('kernel:ready', async () => {\n            const automation = this.resolveService<AutomationTriggerRegistry>(ctx, 'automation');\n            if (!automation || typeof automation.registerTrigger !== 'function') {\n                ctx.logger.warn(\n                    'ScheduleTriggerPlugin: automation service not available — schedule trigger NOT installed',\n                );\n                return;\n            }\n\n            // Probe once for a clear startup warning; the trigger re-resolves\n            // lazily on each start() so adapter upgrades are always picked up.\n            if (!this.resolveService<JobServiceSurface>(ctx, 'job')) {\n                ctx.logger.warn(\n                    'ScheduleTriggerPlugin: job service not available — scheduled flows will not run until one is registered',\n                );\n            }\n\n            const trigger = new ScheduleTrigger(\n                () => this.resolveService<JobServiceSurface>(ctx, 'job'),\n                ctx.logger,\n            );\n            automation.registerTrigger(trigger);\n            ctx.logger.info('ScheduleTriggerPlugin: schedule trigger registered');\n        });\n    }\n\n    private resolveService<T>(ctx: PluginContext, name: string): T | null {\n        try {\n            return ctx.getService<T>(name) ?? null;\n        } catch {\n            return null;\n        }\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { AutomationContext, JobSchedule, JobHandler } from '@objectstack/spec/contracts';\nimport {\n    TimeRelativeTriggerSchema,\n    TIME_RELATIVE_DEFAULT_CRON,\n    TIME_RELATIVE_DEFAULT_MAX_RECORDS,\n} from '@objectstack/spec/automation';\nimport type { TimeRelativeTrigger as TimeRelativeDescriptor } from '@objectstack/spec/automation';\nimport { normalizeSchedule, reportBindFailure } from './schedule-trigger.js';\nimport type { FlowTrigger, FlowTriggerBinding, JobServiceSurface, TriggerLogger } from './schedule-trigger.js';\n\n/**\n * The slice of the ObjectQL data engine this trigger needs: run a filtered\n * `find` (to discover the records whose date field falls in the window) and,\n * optionally, probe whether an object is registered. Typed structurally — same\n * decoupling pattern the record-change trigger uses for its hook surface — so\n * this plugin does not take a build dependency on the engine package.\n */\nexport interface TimeRelativeDataEngine {\n    find(\n        objectName: string,\n        query?: {\n            where?: Record<string, unknown>;\n            fields?: string[];\n            limit?: number;\n            /** Elevated context — a background sweep must see all rows, not RLS-scoped ones. */\n            context?: { isSystem?: boolean };\n        },\n    ): Promise<Array<Record<string, unknown>> | undefined>;\n    /**\n     * Optional object-existence probe (the ObjectQL engine's `getObject`).\n     * When present, {@link TimeRelativeTrigger.start} uses it to call out a\n     * descriptor whose `object` matches no registered object at bind time —\n     * otherwise the sweep just quietly finds nothing forever.\n     */\n    getObject?(name: string): unknown;\n}\n\n/** Job-name namespace so time-relative sweeps never collide with plain schedule jobs. */\nconst JOB_PREFIX = 'flow-time-relative';\n\nconst MS_PER_DAY = 86_400_000;\n\n/** A closed, inclusive instant window `[gte, lte]` as ISO-8601 strings. */\nexport interface DateWindow {\n    /** Lower bound (inclusive), ISO-8601. */\n    gte: string;\n    /** Upper bound (inclusive), ISO-8601. */\n    lte: string;\n}\n\n// ─── Pure window math (day-granular, UTC) ───────────────────────────\n\n/** Start of `d`'s UTC calendar day (00:00:00.000Z). */\nfunction startOfUtcDay(d: Date): Date {\n    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), 0, 0, 0, 0));\n}\n\n/** End of `d`'s UTC calendar day (23:59:59.999Z) — inclusive upper bound. */\nfunction endOfUtcDay(d: Date): Date {\n    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), 23, 59, 59, 999));\n}\n\n/** `d`'s UTC day shifted by `n` whole days (exact in UTC — no DST drift). */\nfunction addUtcDays(d: Date, n: number): Date {\n    return new Date(startOfUtcDay(d).getTime() + n * MS_PER_DAY);\n}\n\n/**\n * Compute the inclusive date window(s) a descriptor selects, relative to `now`.\n *\n * - `offsetDays` → one single-day window per offset (`today + offset`), so the\n *   sweep fires exactly on each threshold day (the robust T-minus reminder).\n * - `withinDays` → one range window: `[today, today + N]` when N ≥ 0 (upcoming),\n *   or `[today − |N|, today]` when N < 0 (overdue lookback). Always includes today.\n *\n * Day-granular and computed in UTC. The upper bound is the *end* of its day\n * (`23:59:59.999Z`), so a `datetime` field matches for the whole day and a\n * `date` field (compared as `YYYY-MM-DD` after the driver truncates) is inclusive.\n */\nexport function computeDateWindows(desc: TimeRelativeDescriptor, now: Date): DateWindow[] {\n    const today = startOfUtcDay(now);\n\n    if (desc.offsetDays && desc.offsetDays.length > 0) {\n        return desc.offsetDays.map((offset) => {\n            const day = addUtcDays(today, offset);\n            return { gte: startOfUtcDay(day).toISOString(), lte: endOfUtcDay(day).toISOString() };\n        });\n    }\n\n    const n = desc.withinDays ?? 0;\n    if (n >= 0) {\n        return [{ gte: startOfUtcDay(today).toISOString(), lte: endOfUtcDay(addUtcDays(today, n)).toISOString() }];\n    }\n    // Negative: window extends into the past, still anchored to (and including) today.\n    return [{ gte: startOfUtcDay(addUtcDays(today, n)).toISOString(), lte: endOfUtcDay(today).toISOString() }];\n}\n\n/**\n * Build the ObjectQL `where` map for one date window: the descriptor's static\n * `filter` (if any) ANDed with a `$gte`/`$lte` range on the date field. The map\n * form is the canonical filter shape both drivers evaluate verbatim (the same\n * shape the platform's own retention sweep uses).\n */\nexport function buildWindowWhere(desc: TimeRelativeDescriptor, window: DateWindow): Record<string, unknown> {\n    return {\n        ...(desc.filter ?? {}),\n        [desc.dateField]: { $gte: window.gte, $lte: window.lte },\n    };\n}\n\nfunction errMessage(err: unknown): string {\n    return (err as Error)?.message ?? String(err);\n}\n\n/**\n * TimeRelativeTrigger\n *\n * The declarative answer to \"act on records whose date field is coming up (or\n * overdue)\" (#1874). Instead of the fragile date-equality-on-record-change\n * pattern (which only fires if the record happens to be edited on the threshold\n * day) or a hand-rolled cron + range query per flow, a flow whose start node\n * declares `config.timeRelative` is swept on a schedule (daily by default) and\n * launched **once per matching record**.\n *\n * It composes the schedule trigger's two collaborators:\n *  - the platform {@link JobServiceSurface} owns the sweep cadence (like the\n *    plain schedule trigger), and\n *  - the {@link TimeRelativeDataEngine} runs the date-window query (like the\n *    record-change trigger reaching ObjectQL).\n *\n * Both are resolved lazily (per call) so adapter upgrades — the durable job\n * adapter that replaces the bootstrap ticker on `kernel:ready`, a late-registered\n * data engine — are always picked up. The engine owns the start-node `condition`\n * gate and `runAs` identity, so this trigger only has to put the matched record\n * on the {@link AutomationContext}; `{record.<field>}` interpolation and the\n * condition work exactly as they do for a record-change flow.\n */\nexport class TimeRelativeTrigger implements FlowTrigger {\n    readonly type = 'time_relative';\n\n    private readonly getJobService: () => JobServiceSurface | null;\n    private readonly getDataEngine: () => TimeRelativeDataEngine | null;\n    private readonly logger: TriggerLogger;\n    /** Injectable clock so window math is deterministic under test. */\n    private readonly now: () => Date;\n    /** flowName → job name registered for it, so stop() can cancel it. */\n    private readonly bound = new Map<string, string>();\n\n    constructor(\n        getJobService: () => JobServiceSurface | null,\n        getDataEngine: () => TimeRelativeDataEngine | null,\n        logger: TriggerLogger,\n        now: () => Date = () => new Date(),\n    ) {\n        this.getJobService = getJobService;\n        this.getDataEngine = getDataEngine;\n        this.logger = logger;\n        this.now = now;\n    }\n\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void {\n        const raw = (binding.config as Record<string, unknown> | undefined)?.timeRelative;\n        const parsed = TimeRelativeTriggerSchema.safeParse(raw);\n        if (!parsed.success) {\n            this.logger.warn(\n                `[time-relative] flow '${binding.flowName}' has no valid \\`timeRelative\\` descriptor — not bound. ` +\n                    `Provide { object, dateField, and exactly one of withinDays | offsetDays }. ` +\n                    `(${parsed.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`).join('; ')})`,\n            );\n            return;\n        }\n        const desc = parsed.data;\n\n        // Cadence: the flow's start-node schedule descriptor, or a daily default.\n        // A daily sweep is the whole point (evaluate the window every day so a\n        // threshold day is never missed), so an omitted schedule means \"daily\",\n        // not \"never\".\n        const schedule: JobSchedule =\n            normalizeSchedule(binding.schedule) ?? { type: 'cron', expression: TIME_RELATIVE_DEFAULT_CRON };\n\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.schedule !== 'function') {\n            this.logger.warn(\n                `[time-relative] job service unavailable — flow '${binding.flowName}' not scheduled`,\n            );\n            return;\n        }\n\n        // Best-effort object-existence probe at bind time (the engine may be\n        // available now even though the sweep resolves it lazily). A descriptor\n        // targeting an unknown object would sweep forever finding nothing.\n        const engineNow = this.getDataEngine();\n        if (desc.object && engineNow && typeof engineNow.getObject === 'function') {\n            let known: unknown;\n            try {\n                known = engineNow.getObject(desc.object);\n            } catch {\n                known = undefined;\n            }\n            if (!known) {\n                this.logger.warn(\n                    `[time-relative] flow '${binding.flowName}' targets unknown object '${desc.object}' — the sweep is bound but will match nothing until that object is registered. ` +\n                        `Object names match exactly; check config.timeRelative.object.`,\n                );\n            }\n        }\n\n        // Idempotent: drop any prior schedule for this flow before re-binding\n        // (covers disable→enable cycles and hot reload).\n        this.stop(binding.flowName);\n\n        const jobName = `${JOB_PREFIX}:${binding.flowName}`;\n        const maxRecords = desc.maxRecords ?? TIME_RELATIVE_DEFAULT_MAX_RECORDS;\n\n        const handler: JobHandler = async () => {\n            try {\n                await this.sweep(binding.flowName, desc, maxRecords, callback);\n            } catch (err) {\n                // Error isolation: a sweep failure must not crash the job\n                // runner / ticker. Log and swallow.\n                this.logger.warn(\n                    `[time-relative] flow '${binding.flowName}' sweep failed: ${errMessage(err)}`,\n                );\n            }\n        };\n\n        this.bound.set(binding.flowName, jobName);\n        // FlowTrigger.start is sync; the job service's schedule() is async.\n        // Fire-and-forget with error logging (mirrors ScheduleTrigger).\n        void Promise.resolve(jobService.schedule(jobName, schedule, handler))\n            .then(() => {\n                const mode = desc.offsetDays\n                    ? `offsets [${desc.offsetDays.join(', ')}]d`\n                    : `within ${desc.withinDays}d`;\n                this.logger.info(\n                    `[time-relative] bound flow '${binding.flowName}' → sweep '${desc.object}.${desc.dateField}' ${mode} on ${schedule.type}` +\n                        (schedule.expression ? ` '${schedule.expression}'` : '') +\n                        (schedule.intervalMs ? ` every ${schedule.intervalMs}ms` : ''),\n                );\n            })\n            .catch((err) => {\n                this.bound.delete(binding.flowName);\n                reportBindFailure(this.logger, 'time-relative', binding.flowName, err);\n            });\n    }\n\n    /**\n     * Run one sweep: query each date window, union the matched records (deduped\n     * by id, capped at `maxRecords`), and launch the flow once per record. A\n     * per-record failure is isolated so one bad row never aborts the batch.\n     */\n    private async sweep(\n        flowName: string,\n        desc: TimeRelativeDescriptor,\n        maxRecords: number,\n        callback: (ctx: AutomationContext) => Promise<void>,\n    ): Promise<void> {\n        const engine = this.getDataEngine();\n        if (!engine || typeof engine.find !== 'function') {\n            this.logger.warn(\n                `[time-relative] data engine unavailable — flow '${flowName}' sweep skipped this tick`,\n            );\n            return;\n        }\n\n        const windows = computeDateWindows(desc, this.now());\n        const seenIds = new Set<unknown>();\n        const matched: Array<Record<string, unknown>> = [];\n\n        for (const window of windows) {\n            if (matched.length >= maxRecords) break;\n            const where = buildWindowWhere(desc, window);\n            const rows =\n                (await engine.find(desc.object, {\n                    where,\n                    limit: maxRecords,\n                    context: { isSystem: true },\n                })) ?? [];\n            for (const row of rows) {\n                const id = (row as { id?: unknown }).id;\n                // Dedup across windows (offset mode) by id; rows without an id\n                // are always kept (can't dedup, better than dropping).\n                if (id != null) {\n                    if (seenIds.has(id)) continue;\n                    seenIds.add(id);\n                }\n                matched.push(row);\n                if (matched.length >= maxRecords) break;\n            }\n        }\n\n        if (matched.length >= maxRecords) {\n            this.logger.warn(\n                `[time-relative] flow '${flowName}' sweep hit the ${maxRecords}-record cap — some matching records were NOT processed this tick. ` +\n                    `Narrow the window/filter, or raise config.timeRelative.maxRecords.`,\n            );\n        }\n\n        let launched = 0;\n        let failed = 0;\n        for (const record of matched) {\n            try {\n                const ctx: AutomationContext = {\n                    record,\n                    object: desc.object,\n                    event: 'time_relative',\n                    // Expose the record as params too, so flows with named `isInput`\n                    // variables matching record fields get them seeded (parity with\n                    // the record-change trigger).\n                    params: record,\n                };\n                await callback(ctx);\n                launched++;\n            } catch (err) {\n                failed++;\n                // Error isolation per record: one failing flow run must not stop\n                // the sweep. ERROR when available (stderr survives the CLI's\n                // boot-quiet stdout window), else warn.\n                const log = this.logger.error?.bind(this.logger) ?? this.logger.warn.bind(this.logger);\n                log(\n                    `[time-relative] flow '${flowName}' failed for record '${String((record as { id?: unknown }).id ?? '?')}': ${errMessage(err)}`,\n                );\n            }\n        }\n\n        this.logger.debug?.(\n            `[time-relative] flow '${flowName}' swept '${desc.object}': ${matched.length} matched, ${launched} launched, ${failed} failed`,\n        );\n    }\n\n    stop(flowName: string): void {\n        const jobName = this.bound.get(flowName);\n        if (!jobName) return;\n        this.bound.delete(flowName);\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.cancel !== 'function') return;\n        void Promise.resolve(jobService.cancel(jobName))\n            .then(() => this.logger.debug?.(`[time-relative] unbound flow '${flowName}'`))\n            .catch((err) => {\n                this.logger.warn(\n                    `[time-relative] failed to unbind flow '${flowName}': ${errMessage(err)}`,\n                );\n            });\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { TimeRelativeTrigger } from './time-relative-trigger.js';\nimport type { TimeRelativeDataEngine } from './time-relative-trigger.js';\nimport type { FlowTrigger, JobServiceSurface } from './schedule-trigger.js';\n\n/**\n * The slice of the automation engine this plugin needs: register a trigger on\n * its `FlowTrigger` extension point. Declared structurally so the plugin does\n * not take a build dependency on `@objectstack/service-automation`.\n */\ninterface AutomationTriggerRegistry {\n    registerTrigger(trigger: FlowTrigger): void;\n    unregisterTrigger?(type: string): void;\n}\n\n/**\n * TimeRelativeTriggerPlugin\n *\n * Arms **declarative time-relative flows** (#1874): a flow whose start node\n * declares `config.timeRelative` (object + dateField + `withinDays`/`offsetDays`)\n * is swept on a schedule and launched once per record whose date field falls in\n * the window — no hand-written cron + range query, no fragile\n * date-equality-on-record-change.\n *\n * It ships in `@objectstack/trigger-schedule` alongside the plain schedule\n * trigger (both are schedule-driven) but is a **separate** plugin: the\n * time-relative trigger additionally needs the ObjectQL engine (for the sweep\n * query), so keeping it separate leaves the plain `ScheduleTriggerPlugin`'s\n * dependency surface unchanged. Depends on the job service (sweep cadence) and\n * the ObjectQL engine (record discovery); both are resolved lazily per `start()`\n * so adapter upgrades are always picked up.\n */\nexport class TimeRelativeTriggerPlugin implements Plugin {\n    name = 'com.objectstack.trigger.time-relative';\n    type = 'standard';\n    version = '1.0.0';\n    dependencies = ['com.objectstack.service.job', 'com.objectstack.engine.objectql'];\n\n    async init(ctx: PluginContext): Promise<void> {\n        ctx.logger.info('Time-relative trigger plugin initialized');\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        // The automation service, job service, and ObjectQL engine are all\n        // resolvable once the kernel is ready (kernel:ready fires after\n        // AutomationServicePlugin.start() has pulled flows in and after the job\n        // service upgrades its adapter).\n        ctx.hook('kernel:ready', async () => {\n            const automation = this.resolveService<AutomationTriggerRegistry>(ctx, 'automation');\n            if (!automation || typeof automation.registerTrigger !== 'function') {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: automation service not available — time-relative trigger NOT installed',\n                );\n                return;\n            }\n\n            // Probe once for a clear startup warning; the trigger re-resolves\n            // both collaborators lazily on each start()/sweep so late upgrades\n            // are always picked up.\n            if (!this.resolveService<JobServiceSurface>(ctx, 'job')) {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: job service not available — time-relative sweeps will not run until one is registered',\n                );\n            }\n            if (!this.resolveDataEngine(ctx)) {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: ObjectQL engine not available — time-relative sweeps will find no records until it is',\n                );\n            }\n\n            const trigger = new TimeRelativeTrigger(\n                () => this.resolveService<JobServiceSurface>(ctx, 'job'),\n                () => this.resolveDataEngine(ctx),\n                ctx.logger,\n            );\n            automation.registerTrigger(trigger);\n            ctx.logger.info('TimeRelativeTriggerPlugin: time-relative trigger registered');\n        });\n    }\n\n    private resolveService<T>(ctx: PluginContext, name: string): T | null {\n        try {\n            return ctx.getService<T>(name) ?? null;\n        } catch {\n            return null;\n        }\n    }\n\n    private resolveDataEngine(ctx: PluginContext): TimeRelativeDataEngine | null {\n        // Primary alias 'objectql', fallback 'data' (some kernels register the\n        // engine under both) — same lookup the record-change trigger uses.\n        return (\n            this.resolveService<TimeRelativeDataEngine>(ctx, 'objectql') ??\n            this.resolveService<TimeRelativeDataEngine>(ctx, 'data')\n        );\n    }\n}\n"],"mappings":"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","names":["JOB_PREFIX"]}

package/dist/index.mjs

@@ -1,5 +1,11 @@
 // src/schedule-trigger.ts
 var JOB_PREFIX = "flow-schedule";
+function reportBindFailure(logger, tag, flowName, err) {
+  const report = logger.error?.bind(logger) ?? logger.warn.bind(logger);
+  report(
+    `[${tag}] flow '${flowName}' FAILED to bind to the job service: ${err?.message ?? String(err)}. The flow stays published and active \u2014 Studio, the metadata API and verify_build all keep reporting it healthy \u2014 but nothing will fire it until it binds. Re-publish the flow (or restart the environment) to retry.`
+  );
+}
 function normalizeSchedule(raw) {
   if (raw == null) return null;
   if (typeof raw === "string") {
@@ -78,9 +84,7 @@ var ScheduleTrigger = class {
       );
     }).catch((err) => {
       this.bound.delete(binding.flowName);
-      this.logger.warn(
-        `[schedule] failed to schedule flow '${binding.flowName}': ${err?.message ?? String(err)}`
-      );
+      reportBindFailure(this.logger, "schedule", binding.flowName, err);
     });
   }
   stop(flowName) {
@@ -241,9 +245,7 @@ var TimeRelativeTrigger = class {
       );
     }).catch((err) => {
       this.bound.delete(binding.flowName);
-      this.logger.warn(
-        `[time-relative] failed to schedule flow '${binding.flowName}': ${errMessage(err)}`
-      );
+      reportBindFailure(this.logger, "time-relative", binding.flowName, err);
     });
   }
   /**

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schedule-trigger.ts","../src/plugin.ts","../src/time-relative-trigger.ts","../src/time-relative-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { AutomationContext } from '@objectstack/spec/contracts';\nimport type { JobSchedule, JobHandler } from '@objectstack/spec/contracts';\n\n/**\n * Structural mirror of the automation engine's `FlowTriggerBinding`\n * (service-automation/src/engine.ts). Declared locally so this trigger plugin\n * stays decoupled from the automation package — same pattern the record-change\n * trigger and the connector / messaging integrations use. The engine parses the\n * flow's start node and hands us a binding whose `schedule` carries the\n * cron/interval/once descriptor.\n */\nexport interface FlowTriggerBinding {\n    readonly flowName: string;\n    readonly object?: string;\n    readonly event?: string;\n    readonly condition?: string | { dialect?: string; source?: string; ast?: unknown };\n    readonly schedule?: unknown;\n    readonly config?: Record<string, unknown>;\n}\n\n/**\n * Structural mirror of the engine's `FlowTrigger` extension point. The engine\n * calls {@link start} with a parsed binding + a callback that runs the flow,\n * and {@link stop} when the flow is unregistered/disabled.\n */\nexport interface FlowTrigger {\n    readonly type: string;\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void;\n    stop(flowName: string): void;\n}\n\n/**\n * The slice of `IJobService` this trigger needs: schedule a named job and\n * cancel it. Typed structurally so the plugin depends on the spec contract\n * shape, not a concrete adapter.\n */\nexport interface JobServiceSurface {\n    schedule(name: string, schedule: JobSchedule, handler: JobHandler): Promise<void>;\n    cancel(name: string): Promise<void>;\n}\n\n/** Minimal logger surface (matches core's `ctx.logger`). */\nexport interface TriggerLogger {\n    info(msg: string, ...args: unknown[]): void;\n    warn(msg: string, ...args: unknown[]): void;\n    debug?(msg: string, ...args: unknown[]): void;\n    /**\n     * Execution failures log here when available (falling back to `warn`).\n     * ERROR matters operationally: the CLI's boot-quiet window swallows\n     * stdout (debug/info/warn) but stderr (error/fatal) always lands — so a\n     * per-record sweep failure stays visible. Mirrors the record-change\n     * trigger's logger surface.\n     */\n    error?(msg: string, ...args: unknown[]): void;\n}\n\nconst JOB_PREFIX = 'flow-schedule';\n\n/**\n * Normalize a flow's raw `schedule` descriptor into a {@link JobSchedule}, or\n * `null` if it can't be understood. Accepts the canonical\n * `{ type: 'cron'|'interval'|'once', ... }` shape plus a few ergonomic\n * shorthands (a bare cron string, `{ cron }`, `{ expression }`, `{ every }` /\n * `{ intervalMs }`, `{ at }`).\n */\nexport function normalizeSchedule(raw: unknown): JobSchedule | null {\n    if (raw == null) return null;\n\n    // Bare cron string, e.g. '0 1 * * *'.\n    if (typeof raw === 'string') {\n        const expr = raw.trim();\n        return expr ? { type: 'cron', expression: expr } : null;\n    }\n\n    if (typeof raw !== 'object') return null;\n    const s = raw as Record<string, unknown>;\n\n    const type = typeof s.type === 'string' ? s.type : undefined;\n\n    if (type === 'cron' || (!type && (typeof s.cron === 'string' || typeof s.expression === 'string'))) {\n        const expression =\n            (typeof s.expression === 'string' && s.expression) ||\n            (typeof s.cron === 'string' && s.cron) ||\n            undefined;\n        if (!expression) return null;\n        const out: JobSchedule = { type: 'cron', expression };\n        if (typeof s.timezone === 'string') out.timezone = s.timezone;\n        return out;\n    }\n\n    if (type === 'interval' || (!type && (typeof s.intervalMs === 'number' || typeof s.every === 'number'))) {\n        const intervalMs =\n            (typeof s.intervalMs === 'number' && s.intervalMs) ||\n            (typeof s.every === 'number' && s.every) ||\n            undefined;\n        if (!intervalMs || intervalMs <= 0) return null;\n        return { type: 'interval', intervalMs };\n    }\n\n    if (type === 'once' || (!type && typeof s.at === 'string')) {\n        const at = typeof s.at === 'string' ? s.at : undefined;\n        if (!at) return null;\n        return { type: 'once', at };\n    }\n\n    return null;\n}\n\n/**\n * ScheduleTrigger\n *\n * Bridges the automation engine's {@link FlowTrigger} extension point to the\n * platform {@link JobServiceSurface}. For each schedule-triggered flow the\n * engine activates, it registers a job whose handler runs the flow; the job\n * service owns the actual cron/interval/once timing (so this trigger stays\n * adapter-agnostic — cron schedules need a cron-capable adapter, which the\n * job service selects).\n *\n * The job service is resolved lazily (per `start()`) via the supplied accessor,\n * so we always pick up the job service's *upgraded* adapter (e.g. the durable\n * DbJobAdapter that replaces the bootstrap interval adapter on `kernel:ready`).\n */\nexport class ScheduleTrigger implements FlowTrigger {\n    readonly type = 'schedule';\n\n    private readonly getJobService: () => JobServiceSurface | null;\n    private readonly logger: TriggerLogger;\n    /** flowName → job name registered for it, so stop() can cancel it. */\n    private readonly bound = new Map<string, string>();\n\n    constructor(getJobService: () => JobServiceSurface | null, logger: TriggerLogger) {\n        this.getJobService = getJobService;\n        this.logger = logger;\n    }\n\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void {\n        const raw = binding.schedule ?? (binding.config as Record<string, unknown> | undefined)?.schedule;\n        const schedule = normalizeSchedule(raw);\n        if (!schedule) {\n            this.logger.warn(\n                `[schedule] flow '${binding.flowName}' has no recognizable schedule descriptor — not bound`,\n            );\n            return;\n        }\n\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.schedule !== 'function') {\n            this.logger.warn(\n                `[schedule] job service unavailable — flow '${binding.flowName}' not scheduled`,\n            );\n            return;\n        }\n\n        // Idempotent: drop any prior schedule for this flow before re-binding\n        // (covers disable→enable cycles and hot reload).\n        this.stop(binding.flowName);\n\n        const jobName = `${JOB_PREFIX}:${binding.flowName}`;\n\n        const handler: JobHandler = async ({ jobId }) => {\n            try {\n                const ctx: AutomationContext = {\n                    event: 'schedule',\n                    params: {\n                        jobId,\n                        flowName: binding.flowName,\n                        schedule,\n                    },\n                };\n                await callback(ctx);\n            } catch (err) {\n                // Error isolation: a scheduled flow failure must not crash the\n                // job runner / ticker. Log and swallow.\n                this.logger.warn(\n                    `[schedule] flow '${binding.flowName}' execution failed: ${(err as Error)?.message ?? String(err)}`,\n                );\n            }\n        };\n\n        this.bound.set(binding.flowName, jobName);\n        // FlowTrigger.start is sync; the job service's schedule() is async.\n        // Fire-and-forget with error logging.\n        void Promise.resolve(jobService.schedule(jobName, schedule, handler))\n            .then(() => {\n                this.logger.info(\n                    `[schedule] bound flow '${binding.flowName}' → ${schedule.type}` +\n                        (schedule.expression ? ` '${schedule.expression}'` : '') +\n                        (schedule.intervalMs ? ` every ${schedule.intervalMs}ms` : '') +\n                        (schedule.at ? ` at ${schedule.at}` : ''),\n                );\n            })\n            .catch((err) => {\n                this.bound.delete(binding.flowName);\n                this.logger.warn(\n                    `[schedule] failed to schedule flow '${binding.flowName}': ${(err as Error)?.message ?? String(err)}`,\n                );\n            });\n    }\n\n    stop(flowName: string): void {\n        const jobName = this.bound.get(flowName);\n        if (!jobName) return;\n        this.bound.delete(flowName);\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.cancel !== 'function') return;\n        void Promise.resolve(jobService.cancel(jobName))\n            .then(() => this.logger.debug?.(`[schedule] unbound flow '${flowName}'`))\n            .catch((err) => {\n                this.logger.warn(\n                    `[schedule] failed to unbind flow '${flowName}': ${(err as Error)?.message ?? String(err)}`,\n                );\n            });\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { ScheduleTrigger } from './schedule-trigger.js';\nimport type { FlowTrigger, JobServiceSurface } from './schedule-trigger.js';\n\n/**\n * The slice of the automation engine this plugin needs: register a trigger on\n * its `FlowTrigger` extension point. Declared structurally so the plugin does\n * not take a build dependency on `@objectstack/service-automation`.\n */\ninterface AutomationTriggerRegistry {\n    registerTrigger(trigger: FlowTrigger): void;\n    unregisterTrigger?(type: string): void;\n}\n\n/**\n * ScheduleTriggerPlugin\n *\n * Makes schedule-triggered flows actually fire. The automation engine ships the\n * `FlowTrigger` wiring (it parses each flow's start node — `flow.type ===\n * 'schedule'` or a start-node `config.schedule` descriptor — into a binding and\n * calls `trigger.start(...)`), but the *concrete* schedule trigger lives here as\n * a plugin and delegates timing to the platform `IJobService` (the `'job'`\n * service). This mirrors the connector / record-change split (engine baseline +\n * trigger plugin).\n *\n * With this plugin (and a job service) installed, a flow whose start node\n * declares `config: { schedule: { type: 'cron', expression: '0 1 * * *' } }`\n * auto-launches on that schedule — no manual `engine.execute()`.\n *\n * Depends on the job service plugin so its `kernel:ready` upgrade (to the\n * durable DbJobAdapter) runs before ours; the job service is nonetheless\n * resolved lazily per `start()` so we always use its current adapter.\n */\nexport class ScheduleTriggerPlugin implements Plugin {\n    name = 'com.objectstack.trigger.schedule';\n    type = 'standard';\n    version = '7.3.0';\n    dependencies = ['com.objectstack.service.job'];\n\n    async init(ctx: PluginContext): Promise<void> {\n        ctx.logger.info('Schedule trigger plugin initialized');\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        // The automation service + job service are resolvable once the kernel is\n        // ready (kernel:ready fires after AutomationServicePlugin.start() has\n        // pulled flows in and after the job service upgrades its adapter).\n        ctx.hook('kernel:ready', async () => {\n            const automation = this.resolveService<AutomationTriggerRegistry>(ctx, 'automation');\n            if (!automation || typeof automation.registerTrigger !== 'function') {\n                ctx.logger.warn(\n                    'ScheduleTriggerPlugin: automation service not available — schedule trigger NOT installed',\n                );\n                return;\n            }\n\n            // Probe once for a clear startup warning; the trigger re-resolves\n            // lazily on each start() so adapter upgrades are always picked up.\n            if (!this.resolveService<JobServiceSurface>(ctx, 'job')) {\n                ctx.logger.warn(\n                    'ScheduleTriggerPlugin: job service not available — scheduled flows will not run until one is registered',\n                );\n            }\n\n            const trigger = new ScheduleTrigger(\n                () => this.resolveService<JobServiceSurface>(ctx, 'job'),\n                ctx.logger,\n            );\n            automation.registerTrigger(trigger);\n            ctx.logger.info('ScheduleTriggerPlugin: schedule trigger registered');\n        });\n    }\n\n    private resolveService<T>(ctx: PluginContext, name: string): T | null {\n        try {\n            return ctx.getService<T>(name) ?? null;\n        } catch {\n            return null;\n        }\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { AutomationContext, JobSchedule, JobHandler } from '@objectstack/spec/contracts';\nimport {\n    TimeRelativeTriggerSchema,\n    TIME_RELATIVE_DEFAULT_CRON,\n    TIME_RELATIVE_DEFAULT_MAX_RECORDS,\n} from '@objectstack/spec/automation';\nimport type { TimeRelativeTrigger as TimeRelativeDescriptor } from '@objectstack/spec/automation';\nimport { normalizeSchedule } from './schedule-trigger.js';\nimport type { FlowTrigger, FlowTriggerBinding, JobServiceSurface, TriggerLogger } from './schedule-trigger.js';\n\n/**\n * The slice of the ObjectQL data engine this trigger needs: run a filtered\n * `find` (to discover the records whose date field falls in the window) and,\n * optionally, probe whether an object is registered. Typed structurally — same\n * decoupling pattern the record-change trigger uses for its hook surface — so\n * this plugin does not take a build dependency on the engine package.\n */\nexport interface TimeRelativeDataEngine {\n    find(\n        objectName: string,\n        query?: {\n            where?: Record<string, unknown>;\n            fields?: string[];\n            limit?: number;\n            /** Elevated context — a background sweep must see all rows, not RLS-scoped ones. */\n            context?: { isSystem?: boolean };\n        },\n    ): Promise<Array<Record<string, unknown>> | undefined>;\n    /**\n     * Optional object-existence probe (the ObjectQL engine's `getObject`).\n     * When present, {@link TimeRelativeTrigger.start} uses it to call out a\n     * descriptor whose `object` matches no registered object at bind time —\n     * otherwise the sweep just quietly finds nothing forever.\n     */\n    getObject?(name: string): unknown;\n}\n\n/** Job-name namespace so time-relative sweeps never collide with plain schedule jobs. */\nconst JOB_PREFIX = 'flow-time-relative';\n\nconst MS_PER_DAY = 86_400_000;\n\n/** A closed, inclusive instant window `[gte, lte]` as ISO-8601 strings. */\nexport interface DateWindow {\n    /** Lower bound (inclusive), ISO-8601. */\n    gte: string;\n    /** Upper bound (inclusive), ISO-8601. */\n    lte: string;\n}\n\n// ─── Pure window math (day-granular, UTC) ───────────────────────────\n\n/** Start of `d`'s UTC calendar day (00:00:00.000Z). */\nfunction startOfUtcDay(d: Date): Date {\n    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), 0, 0, 0, 0));\n}\n\n/** End of `d`'s UTC calendar day (23:59:59.999Z) — inclusive upper bound. */\nfunction endOfUtcDay(d: Date): Date {\n    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), 23, 59, 59, 999));\n}\n\n/** `d`'s UTC day shifted by `n` whole days (exact in UTC — no DST drift). */\nfunction addUtcDays(d: Date, n: number): Date {\n    return new Date(startOfUtcDay(d).getTime() + n * MS_PER_DAY);\n}\n\n/**\n * Compute the inclusive date window(s) a descriptor selects, relative to `now`.\n *\n * - `offsetDays` → one single-day window per offset (`today + offset`), so the\n *   sweep fires exactly on each threshold day (the robust T-minus reminder).\n * - `withinDays` → one range window: `[today, today + N]` when N ≥ 0 (upcoming),\n *   or `[today − |N|, today]` when N < 0 (overdue lookback). Always includes today.\n *\n * Day-granular and computed in UTC. The upper bound is the *end* of its day\n * (`23:59:59.999Z`), so a `datetime` field matches for the whole day and a\n * `date` field (compared as `YYYY-MM-DD` after the driver truncates) is inclusive.\n */\nexport function computeDateWindows(desc: TimeRelativeDescriptor, now: Date): DateWindow[] {\n    const today = startOfUtcDay(now);\n\n    if (desc.offsetDays && desc.offsetDays.length > 0) {\n        return desc.offsetDays.map((offset) => {\n            const day = addUtcDays(today, offset);\n            return { gte: startOfUtcDay(day).toISOString(), lte: endOfUtcDay(day).toISOString() };\n        });\n    }\n\n    const n = desc.withinDays ?? 0;\n    if (n >= 0) {\n        return [{ gte: startOfUtcDay(today).toISOString(), lte: endOfUtcDay(addUtcDays(today, n)).toISOString() }];\n    }\n    // Negative: window extends into the past, still anchored to (and including) today.\n    return [{ gte: startOfUtcDay(addUtcDays(today, n)).toISOString(), lte: endOfUtcDay(today).toISOString() }];\n}\n\n/**\n * Build the ObjectQL `where` map for one date window: the descriptor's static\n * `filter` (if any) ANDed with a `$gte`/`$lte` range on the date field. The map\n * form is the canonical filter shape both drivers evaluate verbatim (the same\n * shape the platform's own retention sweep uses).\n */\nexport function buildWindowWhere(desc: TimeRelativeDescriptor, window: DateWindow): Record<string, unknown> {\n    return {\n        ...(desc.filter ?? {}),\n        [desc.dateField]: { $gte: window.gte, $lte: window.lte },\n    };\n}\n\nfunction errMessage(err: unknown): string {\n    return (err as Error)?.message ?? String(err);\n}\n\n/**\n * TimeRelativeTrigger\n *\n * The declarative answer to \"act on records whose date field is coming up (or\n * overdue)\" (#1874). Instead of the fragile date-equality-on-record-change\n * pattern (which only fires if the record happens to be edited on the threshold\n * day) or a hand-rolled cron + range query per flow, a flow whose start node\n * declares `config.timeRelative` is swept on a schedule (daily by default) and\n * launched **once per matching record**.\n *\n * It composes the schedule trigger's two collaborators:\n *  - the platform {@link JobServiceSurface} owns the sweep cadence (like the\n *    plain schedule trigger), and\n *  - the {@link TimeRelativeDataEngine} runs the date-window query (like the\n *    record-change trigger reaching ObjectQL).\n *\n * Both are resolved lazily (per call) so adapter upgrades — the durable job\n * adapter that replaces the bootstrap ticker on `kernel:ready`, a late-registered\n * data engine — are always picked up. The engine owns the start-node `condition`\n * gate and `runAs` identity, so this trigger only has to put the matched record\n * on the {@link AutomationContext}; `{record.<field>}` interpolation and the\n * condition work exactly as they do for a record-change flow.\n */\nexport class TimeRelativeTrigger implements FlowTrigger {\n    readonly type = 'time_relative';\n\n    private readonly getJobService: () => JobServiceSurface | null;\n    private readonly getDataEngine: () => TimeRelativeDataEngine | null;\n    private readonly logger: TriggerLogger;\n    /** Injectable clock so window math is deterministic under test. */\n    private readonly now: () => Date;\n    /** flowName → job name registered for it, so stop() can cancel it. */\n    private readonly bound = new Map<string, string>();\n\n    constructor(\n        getJobService: () => JobServiceSurface | null,\n        getDataEngine: () => TimeRelativeDataEngine | null,\n        logger: TriggerLogger,\n        now: () => Date = () => new Date(),\n    ) {\n        this.getJobService = getJobService;\n        this.getDataEngine = getDataEngine;\n        this.logger = logger;\n        this.now = now;\n    }\n\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void {\n        const raw = (binding.config as Record<string, unknown> | undefined)?.timeRelative;\n        const parsed = TimeRelativeTriggerSchema.safeParse(raw);\n        if (!parsed.success) {\n            this.logger.warn(\n                `[time-relative] flow '${binding.flowName}' has no valid \\`timeRelative\\` descriptor — not bound. ` +\n                    `Provide { object, dateField, and exactly one of withinDays | offsetDays }. ` +\n                    `(${parsed.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`).join('; ')})`,\n            );\n            return;\n        }\n        const desc = parsed.data;\n\n        // Cadence: the flow's start-node schedule descriptor, or a daily default.\n        // A daily sweep is the whole point (evaluate the window every day so a\n        // threshold day is never missed), so an omitted schedule means \"daily\",\n        // not \"never\".\n        const schedule: JobSchedule =\n            normalizeSchedule(binding.schedule) ?? { type: 'cron', expression: TIME_RELATIVE_DEFAULT_CRON };\n\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.schedule !== 'function') {\n            this.logger.warn(\n                `[time-relative] job service unavailable — flow '${binding.flowName}' not scheduled`,\n            );\n            return;\n        }\n\n        // Best-effort object-existence probe at bind time (the engine may be\n        // available now even though the sweep resolves it lazily). A descriptor\n        // targeting an unknown object would sweep forever finding nothing.\n        const engineNow = this.getDataEngine();\n        if (desc.object && engineNow && typeof engineNow.getObject === 'function') {\n            let known: unknown;\n            try {\n                known = engineNow.getObject(desc.object);\n            } catch {\n                known = undefined;\n            }\n            if (!known) {\n                this.logger.warn(\n                    `[time-relative] flow '${binding.flowName}' targets unknown object '${desc.object}' — the sweep is bound but will match nothing until that object is registered. ` +\n                        `Object names match exactly; check config.timeRelative.object.`,\n                );\n            }\n        }\n\n        // Idempotent: drop any prior schedule for this flow before re-binding\n        // (covers disable→enable cycles and hot reload).\n        this.stop(binding.flowName);\n\n        const jobName = `${JOB_PREFIX}:${binding.flowName}`;\n        const maxRecords = desc.maxRecords ?? TIME_RELATIVE_DEFAULT_MAX_RECORDS;\n\n        const handler: JobHandler = async () => {\n            try {\n                await this.sweep(binding.flowName, desc, maxRecords, callback);\n            } catch (err) {\n                // Error isolation: a sweep failure must not crash the job\n                // runner / ticker. Log and swallow.\n                this.logger.warn(\n                    `[time-relative] flow '${binding.flowName}' sweep failed: ${errMessage(err)}`,\n                );\n            }\n        };\n\n        this.bound.set(binding.flowName, jobName);\n        // FlowTrigger.start is sync; the job service's schedule() is async.\n        // Fire-and-forget with error logging (mirrors ScheduleTrigger).\n        void Promise.resolve(jobService.schedule(jobName, schedule, handler))\n            .then(() => {\n                const mode = desc.offsetDays\n                    ? `offsets [${desc.offsetDays.join(', ')}]d`\n                    : `within ${desc.withinDays}d`;\n                this.logger.info(\n                    `[time-relative] bound flow '${binding.flowName}' → sweep '${desc.object}.${desc.dateField}' ${mode} on ${schedule.type}` +\n                        (schedule.expression ? ` '${schedule.expression}'` : '') +\n                        (schedule.intervalMs ? ` every ${schedule.intervalMs}ms` : ''),\n                );\n            })\n            .catch((err) => {\n                this.bound.delete(binding.flowName);\n                this.logger.warn(\n                    `[time-relative] failed to schedule flow '${binding.flowName}': ${errMessage(err)}`,\n                );\n            });\n    }\n\n    /**\n     * Run one sweep: query each date window, union the matched records (deduped\n     * by id, capped at `maxRecords`), and launch the flow once per record. A\n     * per-record failure is isolated so one bad row never aborts the batch.\n     */\n    private async sweep(\n        flowName: string,\n        desc: TimeRelativeDescriptor,\n        maxRecords: number,\n        callback: (ctx: AutomationContext) => Promise<void>,\n    ): Promise<void> {\n        const engine = this.getDataEngine();\n        if (!engine || typeof engine.find !== 'function') {\n            this.logger.warn(\n                `[time-relative] data engine unavailable — flow '${flowName}' sweep skipped this tick`,\n            );\n            return;\n        }\n\n        const windows = computeDateWindows(desc, this.now());\n        const seenIds = new Set<unknown>();\n        const matched: Array<Record<string, unknown>> = [];\n\n        for (const window of windows) {\n            if (matched.length >= maxRecords) break;\n            const where = buildWindowWhere(desc, window);\n            const rows =\n                (await engine.find(desc.object, {\n                    where,\n                    limit: maxRecords,\n                    context: { isSystem: true },\n                })) ?? [];\n            for (const row of rows) {\n                const id = (row as { id?: unknown }).id;\n                // Dedup across windows (offset mode) by id; rows without an id\n                // are always kept (can't dedup, better than dropping).\n                if (id != null) {\n                    if (seenIds.has(id)) continue;\n                    seenIds.add(id);\n                }\n                matched.push(row);\n                if (matched.length >= maxRecords) break;\n            }\n        }\n\n        if (matched.length >= maxRecords) {\n            this.logger.warn(\n                `[time-relative] flow '${flowName}' sweep hit the ${maxRecords}-record cap — some matching records were NOT processed this tick. ` +\n                    `Narrow the window/filter, or raise config.timeRelative.maxRecords.`,\n            );\n        }\n\n        let launched = 0;\n        let failed = 0;\n        for (const record of matched) {\n            try {\n                const ctx: AutomationContext = {\n                    record,\n                    object: desc.object,\n                    event: 'time_relative',\n                    // Expose the record as params too, so flows with named `isInput`\n                    // variables matching record fields get them seeded (parity with\n                    // the record-change trigger).\n                    params: record,\n                };\n                await callback(ctx);\n                launched++;\n            } catch (err) {\n                failed++;\n                // Error isolation per record: one failing flow run must not stop\n                // the sweep. ERROR when available (stderr survives the CLI's\n                // boot-quiet stdout window), else warn.\n                const log = this.logger.error?.bind(this.logger) ?? this.logger.warn.bind(this.logger);\n                log(\n                    `[time-relative] flow '${flowName}' failed for record '${String((record as { id?: unknown }).id ?? '?')}': ${errMessage(err)}`,\n                );\n            }\n        }\n\n        this.logger.debug?.(\n            `[time-relative] flow '${flowName}' swept '${desc.object}': ${matched.length} matched, ${launched} launched, ${failed} failed`,\n        );\n    }\n\n    stop(flowName: string): void {\n        const jobName = this.bound.get(flowName);\n        if (!jobName) return;\n        this.bound.delete(flowName);\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.cancel !== 'function') return;\n        void Promise.resolve(jobService.cancel(jobName))\n            .then(() => this.logger.debug?.(`[time-relative] unbound flow '${flowName}'`))\n            .catch((err) => {\n                this.logger.warn(\n                    `[time-relative] failed to unbind flow '${flowName}': ${errMessage(err)}`,\n                );\n            });\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { TimeRelativeTrigger } from './time-relative-trigger.js';\nimport type { TimeRelativeDataEngine } from './time-relative-trigger.js';\nimport type { FlowTrigger, JobServiceSurface } from './schedule-trigger.js';\n\n/**\n * The slice of the automation engine this plugin needs: register a trigger on\n * its `FlowTrigger` extension point. Declared structurally so the plugin does\n * not take a build dependency on `@objectstack/service-automation`.\n */\ninterface AutomationTriggerRegistry {\n    registerTrigger(trigger: FlowTrigger): void;\n    unregisterTrigger?(type: string): void;\n}\n\n/**\n * TimeRelativeTriggerPlugin\n *\n * Arms **declarative time-relative flows** (#1874): a flow whose start node\n * declares `config.timeRelative` (object + dateField + `withinDays`/`offsetDays`)\n * is swept on a schedule and launched once per record whose date field falls in\n * the window — no hand-written cron + range query, no fragile\n * date-equality-on-record-change.\n *\n * It ships in `@objectstack/trigger-schedule` alongside the plain schedule\n * trigger (both are schedule-driven) but is a **separate** plugin: the\n * time-relative trigger additionally needs the ObjectQL engine (for the sweep\n * query), so keeping it separate leaves the plain `ScheduleTriggerPlugin`'s\n * dependency surface unchanged. Depends on the job service (sweep cadence) and\n * the ObjectQL engine (record discovery); both are resolved lazily per `start()`\n * so adapter upgrades are always picked up.\n */\nexport class TimeRelativeTriggerPlugin implements Plugin {\n    name = 'com.objectstack.trigger.time-relative';\n    type = 'standard';\n    version = '1.0.0';\n    dependencies = ['com.objectstack.service.job', 'com.objectstack.engine.objectql'];\n\n    async init(ctx: PluginContext): Promise<void> {\n        ctx.logger.info('Time-relative trigger plugin initialized');\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        // The automation service, job service, and ObjectQL engine are all\n        // resolvable once the kernel is ready (kernel:ready fires after\n        // AutomationServicePlugin.start() has pulled flows in and after the job\n        // service upgrades its adapter).\n        ctx.hook('kernel:ready', async () => {\n            const automation = this.resolveService<AutomationTriggerRegistry>(ctx, 'automation');\n            if (!automation || typeof automation.registerTrigger !== 'function') {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: automation service not available — time-relative trigger NOT installed',\n                );\n                return;\n            }\n\n            // Probe once for a clear startup warning; the trigger re-resolves\n            // both collaborators lazily on each start()/sweep so late upgrades\n            // are always picked up.\n            if (!this.resolveService<JobServiceSurface>(ctx, 'job')) {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: job service not available — time-relative sweeps will not run until one is registered',\n                );\n            }\n            if (!this.resolveDataEngine(ctx)) {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: ObjectQL engine not available — time-relative sweeps will find no records until it is',\n                );\n            }\n\n            const trigger = new TimeRelativeTrigger(\n                () => this.resolveService<JobServiceSurface>(ctx, 'job'),\n                () => this.resolveDataEngine(ctx),\n                ctx.logger,\n            );\n            automation.registerTrigger(trigger);\n            ctx.logger.info('TimeRelativeTriggerPlugin: time-relative trigger registered');\n        });\n    }\n\n    private resolveService<T>(ctx: PluginContext, name: string): T | null {\n        try {\n            return ctx.getService<T>(name) ?? null;\n        } catch {\n            return null;\n        }\n    }\n\n    private resolveDataEngine(ctx: PluginContext): TimeRelativeDataEngine | null {\n        // Primary alias 'objectql', fallback 'data' (some kernels register the\n        // engine under both) — same lookup the record-change trigger uses.\n        return (\n            this.resolveService<TimeRelativeDataEngine>(ctx, 'objectql') ??\n            this.resolveService<TimeRelativeDataEngine>(ctx, 'data')\n        );\n    }\n}\n"],"mappings":"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","names":["JOB_PREFIX"]}
+{"version":3,"sources":["../src/schedule-trigger.ts","../src/plugin.ts","../src/time-relative-trigger.ts","../src/time-relative-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { AutomationContext } from '@objectstack/spec/contracts';\nimport type { JobSchedule, JobHandler } from '@objectstack/spec/contracts';\n\n/**\n * Structural mirror of the automation engine's `FlowTriggerBinding`\n * (service-automation/src/engine.ts). Declared locally so this trigger plugin\n * stays decoupled from the automation package — same pattern the record-change\n * trigger and the connector / messaging integrations use. The engine parses the\n * flow's start node and hands us a binding whose `schedule` carries the\n * cron/interval/once descriptor.\n */\nexport interface FlowTriggerBinding {\n    readonly flowName: string;\n    readonly object?: string;\n    readonly event?: string;\n    readonly condition?: string | { dialect?: string; source?: string; ast?: unknown };\n    readonly schedule?: unknown;\n    readonly config?: Record<string, unknown>;\n}\n\n/**\n * Structural mirror of the engine's `FlowTrigger` extension point. The engine\n * calls {@link start} with a parsed binding + a callback that runs the flow,\n * and {@link stop} when the flow is unregistered/disabled.\n */\nexport interface FlowTrigger {\n    readonly type: string;\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void;\n    stop(flowName: string): void;\n}\n\n/**\n * The slice of `IJobService` this trigger needs: schedule a named job and\n * cancel it. Typed structurally so the plugin depends on the spec contract\n * shape, not a concrete adapter.\n */\nexport interface JobServiceSurface {\n    schedule(name: string, schedule: JobSchedule, handler: JobHandler): Promise<void>;\n    cancel(name: string): Promise<void>;\n}\n\n/** Minimal logger surface (matches core's `ctx.logger`). */\nexport interface TriggerLogger {\n    info(msg: string, ...args: unknown[]): void;\n    warn(msg: string, ...args: unknown[]): void;\n    debug?(msg: string, ...args: unknown[]): void;\n    /**\n     * Execution failures log here when available (falling back to `warn`).\n     * ERROR matters operationally: the CLI's boot-quiet window swallows\n     * stdout (debug/info/warn) but stderr (error/fatal) always lands — so a\n     * per-record sweep failure stays visible. Mirrors the record-change\n     * trigger's logger surface.\n     */\n    error?(msg: string, ...args: unknown[]): void;\n}\n\nconst JOB_PREFIX = 'flow-schedule';\n\n/**\n * Report a scheduled flow that failed to bind to the job service.\n *\n * **Why this is `error` and not `warn`** — the repo's degradation-log-level\n * rule (AGENTS.md) decides the level with one question: after the degradation,\n * does the system still look normal from the outside while something it claims\n * is in place has not landed? Here it does, completely: the flow stays\n * published and active in `sys_metadata`, Studio lists it, the metadata API\n * serves it and `verify_build` passes — while nothing will ever fire it. That\n * is persisted state and runtime state disagreeing, which the rule puts in the\n * `error` class, not the functional-degradation class.\n *\n * The neighbouring composition branch — \"no job service is registered at all\" —\n * deliberately stays at `warn`: the system is *visibly* smaller and the rule\n * names that exact message as correctly a `warn`. The distinction is not the\n * severity of the outcome, it is whether the outside can see it.\n *\n * An `error` here owes two things, both in the first line it prints: the\n * concrete consequence (including that everything else keeps looking healthy)\n * and the remedy. Kept in one helper so both triggers say it the same way.\n */\nexport function reportBindFailure(\n    logger: TriggerLogger,\n    tag: 'schedule' | 'time-relative',\n    flowName: string,\n    err: unknown,\n): void {\n    const report = logger.error?.bind(logger) ?? logger.warn.bind(logger);\n    report(\n        `[${tag}] flow '${flowName}' FAILED to bind to the job service: ${(err as Error)?.message ?? String(err)}. ` +\n            'The flow stays published and active — Studio, the metadata API and verify_build all keep reporting it ' +\n            'healthy — but nothing will fire it until it binds. Re-publish the flow (or restart the environment) to retry.',\n    );\n}\n\n/**\n * Normalize a flow's raw `schedule` descriptor into a {@link JobSchedule}, or\n * `null` if it can't be understood. Accepts the canonical\n * `{ type: 'cron'|'interval'|'once', ... }` shape plus a few ergonomic\n * shorthands (a bare cron string, `{ cron }`, `{ expression }`, `{ every }` /\n * `{ intervalMs }`, `{ at }`).\n */\nexport function normalizeSchedule(raw: unknown): JobSchedule | null {\n    if (raw == null) return null;\n\n    // Bare cron string, e.g. '0 1 * * *'.\n    if (typeof raw === 'string') {\n        const expr = raw.trim();\n        return expr ? { type: 'cron', expression: expr } : null;\n    }\n\n    if (typeof raw !== 'object') return null;\n    const s = raw as Record<string, unknown>;\n\n    const type = typeof s.type === 'string' ? s.type : undefined;\n\n    if (type === 'cron' || (!type && (typeof s.cron === 'string' || typeof s.expression === 'string'))) {\n        const expression =\n            (typeof s.expression === 'string' && s.expression) ||\n            (typeof s.cron === 'string' && s.cron) ||\n            undefined;\n        if (!expression) return null;\n        const out: JobSchedule = { type: 'cron', expression };\n        if (typeof s.timezone === 'string') out.timezone = s.timezone;\n        return out;\n    }\n\n    if (type === 'interval' || (!type && (typeof s.intervalMs === 'number' || typeof s.every === 'number'))) {\n        const intervalMs =\n            (typeof s.intervalMs === 'number' && s.intervalMs) ||\n            (typeof s.every === 'number' && s.every) ||\n            undefined;\n        if (!intervalMs || intervalMs <= 0) return null;\n        return { type: 'interval', intervalMs };\n    }\n\n    if (type === 'once' || (!type && typeof s.at === 'string')) {\n        const at = typeof s.at === 'string' ? s.at : undefined;\n        if (!at) return null;\n        return { type: 'once', at };\n    }\n\n    return null;\n}\n\n/**\n * ScheduleTrigger\n *\n * Bridges the automation engine's {@link FlowTrigger} extension point to the\n * platform {@link JobServiceSurface}. For each schedule-triggered flow the\n * engine activates, it registers a job whose handler runs the flow; the job\n * service owns the actual cron/interval/once timing (so this trigger stays\n * adapter-agnostic — cron schedules need a cron-capable adapter, which the\n * job service selects).\n *\n * The job service is resolved lazily (per `start()`) via the supplied accessor,\n * so we always pick up the job service's *upgraded* adapter (e.g. the durable\n * DbJobAdapter that replaces the bootstrap interval adapter on `kernel:ready`).\n */\nexport class ScheduleTrigger implements FlowTrigger {\n    readonly type = 'schedule';\n\n    private readonly getJobService: () => JobServiceSurface | null;\n    private readonly logger: TriggerLogger;\n    /** flowName → job name registered for it, so stop() can cancel it. */\n    private readonly bound = new Map<string, string>();\n\n    constructor(getJobService: () => JobServiceSurface | null, logger: TriggerLogger) {\n        this.getJobService = getJobService;\n        this.logger = logger;\n    }\n\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void {\n        const raw = binding.schedule ?? (binding.config as Record<string, unknown> | undefined)?.schedule;\n        const schedule = normalizeSchedule(raw);\n        if (!schedule) {\n            this.logger.warn(\n                `[schedule] flow '${binding.flowName}' has no recognizable schedule descriptor — not bound`,\n            );\n            return;\n        }\n\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.schedule !== 'function') {\n            this.logger.warn(\n                `[schedule] job service unavailable — flow '${binding.flowName}' not scheduled`,\n            );\n            return;\n        }\n\n        // Idempotent: drop any prior schedule for this flow before re-binding\n        // (covers disable→enable cycles and hot reload).\n        this.stop(binding.flowName);\n\n        const jobName = `${JOB_PREFIX}:${binding.flowName}`;\n\n        const handler: JobHandler = async ({ jobId }) => {\n            try {\n                const ctx: AutomationContext = {\n                    event: 'schedule',\n                    params: {\n                        jobId,\n                        flowName: binding.flowName,\n                        schedule,\n                    },\n                };\n                await callback(ctx);\n            } catch (err) {\n                // Error isolation: a scheduled flow failure must not crash the\n                // job runner / ticker. Log and swallow.\n                this.logger.warn(\n                    `[schedule] flow '${binding.flowName}' execution failed: ${(err as Error)?.message ?? String(err)}`,\n                );\n            }\n        };\n\n        this.bound.set(binding.flowName, jobName);\n        // FlowTrigger.start is sync; the job service's schedule() is async.\n        // Fire-and-forget with error logging.\n        void Promise.resolve(jobService.schedule(jobName, schedule, handler))\n            .then(() => {\n                this.logger.info(\n                    `[schedule] bound flow '${binding.flowName}' → ${schedule.type}` +\n                        (schedule.expression ? ` '${schedule.expression}'` : '') +\n                        (schedule.intervalMs ? ` every ${schedule.intervalMs}ms` : '') +\n                        (schedule.at ? ` at ${schedule.at}` : ''),\n                );\n            })\n            .catch((err) => {\n                this.bound.delete(binding.flowName);\n                reportBindFailure(this.logger, 'schedule', binding.flowName, err);\n            });\n    }\n\n    stop(flowName: string): void {\n        const jobName = this.bound.get(flowName);\n        if (!jobName) return;\n        this.bound.delete(flowName);\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.cancel !== 'function') return;\n        void Promise.resolve(jobService.cancel(jobName))\n            .then(() => this.logger.debug?.(`[schedule] unbound flow '${flowName}'`))\n            .catch((err) => {\n                this.logger.warn(\n                    `[schedule] failed to unbind flow '${flowName}': ${(err as Error)?.message ?? String(err)}`,\n                );\n            });\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { ScheduleTrigger } from './schedule-trigger.js';\nimport type { FlowTrigger, JobServiceSurface } from './schedule-trigger.js';\n\n/**\n * The slice of the automation engine this plugin needs: register a trigger on\n * its `FlowTrigger` extension point. Declared structurally so the plugin does\n * not take a build dependency on `@objectstack/service-automation`.\n */\ninterface AutomationTriggerRegistry {\n    registerTrigger(trigger: FlowTrigger): void;\n    unregisterTrigger?(type: string): void;\n}\n\n/**\n * ScheduleTriggerPlugin\n *\n * Makes schedule-triggered flows actually fire. The automation engine ships the\n * `FlowTrigger` wiring (it parses each flow's start node — `flow.type ===\n * 'schedule'` or a start-node `config.schedule` descriptor — into a binding and\n * calls `trigger.start(...)`), but the *concrete* schedule trigger lives here as\n * a plugin and delegates timing to the platform `IJobService` (the `'job'`\n * service). This mirrors the connector / record-change split (engine baseline +\n * trigger plugin).\n *\n * With this plugin (and a job service) installed, a flow whose start node\n * declares `config: { schedule: { type: 'cron', expression: '0 1 * * *' } }`\n * auto-launches on that schedule — no manual `engine.execute()`.\n *\n * Depends on the job service plugin so its `kernel:ready` upgrade (to the\n * durable DbJobAdapter) runs before ours; the job service is nonetheless\n * resolved lazily per `start()` so we always use its current adapter.\n */\nexport class ScheduleTriggerPlugin implements Plugin {\n    name = 'com.objectstack.trigger.schedule';\n    type = 'standard';\n    version = '7.3.0';\n    dependencies = ['com.objectstack.service.job'];\n\n    async init(ctx: PluginContext): Promise<void> {\n        ctx.logger.info('Schedule trigger plugin initialized');\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        // The automation service + job service are resolvable once the kernel is\n        // ready (kernel:ready fires after AutomationServicePlugin.start() has\n        // pulled flows in and after the job service upgrades its adapter).\n        ctx.hook('kernel:ready', async () => {\n            const automation = this.resolveService<AutomationTriggerRegistry>(ctx, 'automation');\n            if (!automation || typeof automation.registerTrigger !== 'function') {\n                ctx.logger.warn(\n                    'ScheduleTriggerPlugin: automation service not available — schedule trigger NOT installed',\n                );\n                return;\n            }\n\n            // Probe once for a clear startup warning; the trigger re-resolves\n            // lazily on each start() so adapter upgrades are always picked up.\n            if (!this.resolveService<JobServiceSurface>(ctx, 'job')) {\n                ctx.logger.warn(\n                    'ScheduleTriggerPlugin: job service not available — scheduled flows will not run until one is registered',\n                );\n            }\n\n            const trigger = new ScheduleTrigger(\n                () => this.resolveService<JobServiceSurface>(ctx, 'job'),\n                ctx.logger,\n            );\n            automation.registerTrigger(trigger);\n            ctx.logger.info('ScheduleTriggerPlugin: schedule trigger registered');\n        });\n    }\n\n    private resolveService<T>(ctx: PluginContext, name: string): T | null {\n        try {\n            return ctx.getService<T>(name) ?? null;\n        } catch {\n            return null;\n        }\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { AutomationContext, JobSchedule, JobHandler } from '@objectstack/spec/contracts';\nimport {\n    TimeRelativeTriggerSchema,\n    TIME_RELATIVE_DEFAULT_CRON,\n    TIME_RELATIVE_DEFAULT_MAX_RECORDS,\n} from '@objectstack/spec/automation';\nimport type { TimeRelativeTrigger as TimeRelativeDescriptor } from '@objectstack/spec/automation';\nimport { normalizeSchedule, reportBindFailure } from './schedule-trigger.js';\nimport type { FlowTrigger, FlowTriggerBinding, JobServiceSurface, TriggerLogger } from './schedule-trigger.js';\n\n/**\n * The slice of the ObjectQL data engine this trigger needs: run a filtered\n * `find` (to discover the records whose date field falls in the window) and,\n * optionally, probe whether an object is registered. Typed structurally — same\n * decoupling pattern the record-change trigger uses for its hook surface — so\n * this plugin does not take a build dependency on the engine package.\n */\nexport interface TimeRelativeDataEngine {\n    find(\n        objectName: string,\n        query?: {\n            where?: Record<string, unknown>;\n            fields?: string[];\n            limit?: number;\n            /** Elevated context — a background sweep must see all rows, not RLS-scoped ones. */\n            context?: { isSystem?: boolean };\n        },\n    ): Promise<Array<Record<string, unknown>> | undefined>;\n    /**\n     * Optional object-existence probe (the ObjectQL engine's `getObject`).\n     * When present, {@link TimeRelativeTrigger.start} uses it to call out a\n     * descriptor whose `object` matches no registered object at bind time —\n     * otherwise the sweep just quietly finds nothing forever.\n     */\n    getObject?(name: string): unknown;\n}\n\n/** Job-name namespace so time-relative sweeps never collide with plain schedule jobs. */\nconst JOB_PREFIX = 'flow-time-relative';\n\nconst MS_PER_DAY = 86_400_000;\n\n/** A closed, inclusive instant window `[gte, lte]` as ISO-8601 strings. */\nexport interface DateWindow {\n    /** Lower bound (inclusive), ISO-8601. */\n    gte: string;\n    /** Upper bound (inclusive), ISO-8601. */\n    lte: string;\n}\n\n// ─── Pure window math (day-granular, UTC) ───────────────────────────\n\n/** Start of `d`'s UTC calendar day (00:00:00.000Z). */\nfunction startOfUtcDay(d: Date): Date {\n    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), 0, 0, 0, 0));\n}\n\n/** End of `d`'s UTC calendar day (23:59:59.999Z) — inclusive upper bound. */\nfunction endOfUtcDay(d: Date): Date {\n    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), 23, 59, 59, 999));\n}\n\n/** `d`'s UTC day shifted by `n` whole days (exact in UTC — no DST drift). */\nfunction addUtcDays(d: Date, n: number): Date {\n    return new Date(startOfUtcDay(d).getTime() + n * MS_PER_DAY);\n}\n\n/**\n * Compute the inclusive date window(s) a descriptor selects, relative to `now`.\n *\n * - `offsetDays` → one single-day window per offset (`today + offset`), so the\n *   sweep fires exactly on each threshold day (the robust T-minus reminder).\n * - `withinDays` → one range window: `[today, today + N]` when N ≥ 0 (upcoming),\n *   or `[today − |N|, today]` when N < 0 (overdue lookback). Always includes today.\n *\n * Day-granular and computed in UTC. The upper bound is the *end* of its day\n * (`23:59:59.999Z`), so a `datetime` field matches for the whole day and a\n * `date` field (compared as `YYYY-MM-DD` after the driver truncates) is inclusive.\n */\nexport function computeDateWindows(desc: TimeRelativeDescriptor, now: Date): DateWindow[] {\n    const today = startOfUtcDay(now);\n\n    if (desc.offsetDays && desc.offsetDays.length > 0) {\n        return desc.offsetDays.map((offset) => {\n            const day = addUtcDays(today, offset);\n            return { gte: startOfUtcDay(day).toISOString(), lte: endOfUtcDay(day).toISOString() };\n        });\n    }\n\n    const n = desc.withinDays ?? 0;\n    if (n >= 0) {\n        return [{ gte: startOfUtcDay(today).toISOString(), lte: endOfUtcDay(addUtcDays(today, n)).toISOString() }];\n    }\n    // Negative: window extends into the past, still anchored to (and including) today.\n    return [{ gte: startOfUtcDay(addUtcDays(today, n)).toISOString(), lte: endOfUtcDay(today).toISOString() }];\n}\n\n/**\n * Build the ObjectQL `where` map for one date window: the descriptor's static\n * `filter` (if any) ANDed with a `$gte`/`$lte` range on the date field. The map\n * form is the canonical filter shape both drivers evaluate verbatim (the same\n * shape the platform's own retention sweep uses).\n */\nexport function buildWindowWhere(desc: TimeRelativeDescriptor, window: DateWindow): Record<string, unknown> {\n    return {\n        ...(desc.filter ?? {}),\n        [desc.dateField]: { $gte: window.gte, $lte: window.lte },\n    };\n}\n\nfunction errMessage(err: unknown): string {\n    return (err as Error)?.message ?? String(err);\n}\n\n/**\n * TimeRelativeTrigger\n *\n * The declarative answer to \"act on records whose date field is coming up (or\n * overdue)\" (#1874). Instead of the fragile date-equality-on-record-change\n * pattern (which only fires if the record happens to be edited on the threshold\n * day) or a hand-rolled cron + range query per flow, a flow whose start node\n * declares `config.timeRelative` is swept on a schedule (daily by default) and\n * launched **once per matching record**.\n *\n * It composes the schedule trigger's two collaborators:\n *  - the platform {@link JobServiceSurface} owns the sweep cadence (like the\n *    plain schedule trigger), and\n *  - the {@link TimeRelativeDataEngine} runs the date-window query (like the\n *    record-change trigger reaching ObjectQL).\n *\n * Both are resolved lazily (per call) so adapter upgrades — the durable job\n * adapter that replaces the bootstrap ticker on `kernel:ready`, a late-registered\n * data engine — are always picked up. The engine owns the start-node `condition`\n * gate and `runAs` identity, so this trigger only has to put the matched record\n * on the {@link AutomationContext}; `{record.<field>}` interpolation and the\n * condition work exactly as they do for a record-change flow.\n */\nexport class TimeRelativeTrigger implements FlowTrigger {\n    readonly type = 'time_relative';\n\n    private readonly getJobService: () => JobServiceSurface | null;\n    private readonly getDataEngine: () => TimeRelativeDataEngine | null;\n    private readonly logger: TriggerLogger;\n    /** Injectable clock so window math is deterministic under test. */\n    private readonly now: () => Date;\n    /** flowName → job name registered for it, so stop() can cancel it. */\n    private readonly bound = new Map<string, string>();\n\n    constructor(\n        getJobService: () => JobServiceSurface | null,\n        getDataEngine: () => TimeRelativeDataEngine | null,\n        logger: TriggerLogger,\n        now: () => Date = () => new Date(),\n    ) {\n        this.getJobService = getJobService;\n        this.getDataEngine = getDataEngine;\n        this.logger = logger;\n        this.now = now;\n    }\n\n    start(binding: FlowTriggerBinding, callback: (ctx: AutomationContext) => Promise<void>): void {\n        const raw = (binding.config as Record<string, unknown> | undefined)?.timeRelative;\n        const parsed = TimeRelativeTriggerSchema.safeParse(raw);\n        if (!parsed.success) {\n            this.logger.warn(\n                `[time-relative] flow '${binding.flowName}' has no valid \\`timeRelative\\` descriptor — not bound. ` +\n                    `Provide { object, dateField, and exactly one of withinDays | offsetDays }. ` +\n                    `(${parsed.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`).join('; ')})`,\n            );\n            return;\n        }\n        const desc = parsed.data;\n\n        // Cadence: the flow's start-node schedule descriptor, or a daily default.\n        // A daily sweep is the whole point (evaluate the window every day so a\n        // threshold day is never missed), so an omitted schedule means \"daily\",\n        // not \"never\".\n        const schedule: JobSchedule =\n            normalizeSchedule(binding.schedule) ?? { type: 'cron', expression: TIME_RELATIVE_DEFAULT_CRON };\n\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.schedule !== 'function') {\n            this.logger.warn(\n                `[time-relative] job service unavailable — flow '${binding.flowName}' not scheduled`,\n            );\n            return;\n        }\n\n        // Best-effort object-existence probe at bind time (the engine may be\n        // available now even though the sweep resolves it lazily). A descriptor\n        // targeting an unknown object would sweep forever finding nothing.\n        const engineNow = this.getDataEngine();\n        if (desc.object && engineNow && typeof engineNow.getObject === 'function') {\n            let known: unknown;\n            try {\n                known = engineNow.getObject(desc.object);\n            } catch {\n                known = undefined;\n            }\n            if (!known) {\n                this.logger.warn(\n                    `[time-relative] flow '${binding.flowName}' targets unknown object '${desc.object}' — the sweep is bound but will match nothing until that object is registered. ` +\n                        `Object names match exactly; check config.timeRelative.object.`,\n                );\n            }\n        }\n\n        // Idempotent: drop any prior schedule for this flow before re-binding\n        // (covers disable→enable cycles and hot reload).\n        this.stop(binding.flowName);\n\n        const jobName = `${JOB_PREFIX}:${binding.flowName}`;\n        const maxRecords = desc.maxRecords ?? TIME_RELATIVE_DEFAULT_MAX_RECORDS;\n\n        const handler: JobHandler = async () => {\n            try {\n                await this.sweep(binding.flowName, desc, maxRecords, callback);\n            } catch (err) {\n                // Error isolation: a sweep failure must not crash the job\n                // runner / ticker. Log and swallow.\n                this.logger.warn(\n                    `[time-relative] flow '${binding.flowName}' sweep failed: ${errMessage(err)}`,\n                );\n            }\n        };\n\n        this.bound.set(binding.flowName, jobName);\n        // FlowTrigger.start is sync; the job service's schedule() is async.\n        // Fire-and-forget with error logging (mirrors ScheduleTrigger).\n        void Promise.resolve(jobService.schedule(jobName, schedule, handler))\n            .then(() => {\n                const mode = desc.offsetDays\n                    ? `offsets [${desc.offsetDays.join(', ')}]d`\n                    : `within ${desc.withinDays}d`;\n                this.logger.info(\n                    `[time-relative] bound flow '${binding.flowName}' → sweep '${desc.object}.${desc.dateField}' ${mode} on ${schedule.type}` +\n                        (schedule.expression ? ` '${schedule.expression}'` : '') +\n                        (schedule.intervalMs ? ` every ${schedule.intervalMs}ms` : ''),\n                );\n            })\n            .catch((err) => {\n                this.bound.delete(binding.flowName);\n                reportBindFailure(this.logger, 'time-relative', binding.flowName, err);\n            });\n    }\n\n    /**\n     * Run one sweep: query each date window, union the matched records (deduped\n     * by id, capped at `maxRecords`), and launch the flow once per record. A\n     * per-record failure is isolated so one bad row never aborts the batch.\n     */\n    private async sweep(\n        flowName: string,\n        desc: TimeRelativeDescriptor,\n        maxRecords: number,\n        callback: (ctx: AutomationContext) => Promise<void>,\n    ): Promise<void> {\n        const engine = this.getDataEngine();\n        if (!engine || typeof engine.find !== 'function') {\n            this.logger.warn(\n                `[time-relative] data engine unavailable — flow '${flowName}' sweep skipped this tick`,\n            );\n            return;\n        }\n\n        const windows = computeDateWindows(desc, this.now());\n        const seenIds = new Set<unknown>();\n        const matched: Array<Record<string, unknown>> = [];\n\n        for (const window of windows) {\n            if (matched.length >= maxRecords) break;\n            const where = buildWindowWhere(desc, window);\n            const rows =\n                (await engine.find(desc.object, {\n                    where,\n                    limit: maxRecords,\n                    context: { isSystem: true },\n                })) ?? [];\n            for (const row of rows) {\n                const id = (row as { id?: unknown }).id;\n                // Dedup across windows (offset mode) by id; rows without an id\n                // are always kept (can't dedup, better than dropping).\n                if (id != null) {\n                    if (seenIds.has(id)) continue;\n                    seenIds.add(id);\n                }\n                matched.push(row);\n                if (matched.length >= maxRecords) break;\n            }\n        }\n\n        if (matched.length >= maxRecords) {\n            this.logger.warn(\n                `[time-relative] flow '${flowName}' sweep hit the ${maxRecords}-record cap — some matching records were NOT processed this tick. ` +\n                    `Narrow the window/filter, or raise config.timeRelative.maxRecords.`,\n            );\n        }\n\n        let launched = 0;\n        let failed = 0;\n        for (const record of matched) {\n            try {\n                const ctx: AutomationContext = {\n                    record,\n                    object: desc.object,\n                    event: 'time_relative',\n                    // Expose the record as params too, so flows with named `isInput`\n                    // variables matching record fields get them seeded (parity with\n                    // the record-change trigger).\n                    params: record,\n                };\n                await callback(ctx);\n                launched++;\n            } catch (err) {\n                failed++;\n                // Error isolation per record: one failing flow run must not stop\n                // the sweep. ERROR when available (stderr survives the CLI's\n                // boot-quiet stdout window), else warn.\n                const log = this.logger.error?.bind(this.logger) ?? this.logger.warn.bind(this.logger);\n                log(\n                    `[time-relative] flow '${flowName}' failed for record '${String((record as { id?: unknown }).id ?? '?')}': ${errMessage(err)}`,\n                );\n            }\n        }\n\n        this.logger.debug?.(\n            `[time-relative] flow '${flowName}' swept '${desc.object}': ${matched.length} matched, ${launched} launched, ${failed} failed`,\n        );\n    }\n\n    stop(flowName: string): void {\n        const jobName = this.bound.get(flowName);\n        if (!jobName) return;\n        this.bound.delete(flowName);\n        const jobService = this.getJobService();\n        if (!jobService || typeof jobService.cancel !== 'function') return;\n        void Promise.resolve(jobService.cancel(jobName))\n            .then(() => this.logger.debug?.(`[time-relative] unbound flow '${flowName}'`))\n            .catch((err) => {\n                this.logger.warn(\n                    `[time-relative] failed to unbind flow '${flowName}': ${errMessage(err)}`,\n                );\n            });\n    }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { TimeRelativeTrigger } from './time-relative-trigger.js';\nimport type { TimeRelativeDataEngine } from './time-relative-trigger.js';\nimport type { FlowTrigger, JobServiceSurface } from './schedule-trigger.js';\n\n/**\n * The slice of the automation engine this plugin needs: register a trigger on\n * its `FlowTrigger` extension point. Declared structurally so the plugin does\n * not take a build dependency on `@objectstack/service-automation`.\n */\ninterface AutomationTriggerRegistry {\n    registerTrigger(trigger: FlowTrigger): void;\n    unregisterTrigger?(type: string): void;\n}\n\n/**\n * TimeRelativeTriggerPlugin\n *\n * Arms **declarative time-relative flows** (#1874): a flow whose start node\n * declares `config.timeRelative` (object + dateField + `withinDays`/`offsetDays`)\n * is swept on a schedule and launched once per record whose date field falls in\n * the window — no hand-written cron + range query, no fragile\n * date-equality-on-record-change.\n *\n * It ships in `@objectstack/trigger-schedule` alongside the plain schedule\n * trigger (both are schedule-driven) but is a **separate** plugin: the\n * time-relative trigger additionally needs the ObjectQL engine (for the sweep\n * query), so keeping it separate leaves the plain `ScheduleTriggerPlugin`'s\n * dependency surface unchanged. Depends on the job service (sweep cadence) and\n * the ObjectQL engine (record discovery); both are resolved lazily per `start()`\n * so adapter upgrades are always picked up.\n */\nexport class TimeRelativeTriggerPlugin implements Plugin {\n    name = 'com.objectstack.trigger.time-relative';\n    type = 'standard';\n    version = '1.0.0';\n    dependencies = ['com.objectstack.service.job', 'com.objectstack.engine.objectql'];\n\n    async init(ctx: PluginContext): Promise<void> {\n        ctx.logger.info('Time-relative trigger plugin initialized');\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        // The automation service, job service, and ObjectQL engine are all\n        // resolvable once the kernel is ready (kernel:ready fires after\n        // AutomationServicePlugin.start() has pulled flows in and after the job\n        // service upgrades its adapter).\n        ctx.hook('kernel:ready', async () => {\n            const automation = this.resolveService<AutomationTriggerRegistry>(ctx, 'automation');\n            if (!automation || typeof automation.registerTrigger !== 'function') {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: automation service not available — time-relative trigger NOT installed',\n                );\n                return;\n            }\n\n            // Probe once for a clear startup warning; the trigger re-resolves\n            // both collaborators lazily on each start()/sweep so late upgrades\n            // are always picked up.\n            if (!this.resolveService<JobServiceSurface>(ctx, 'job')) {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: job service not available — time-relative sweeps will not run until one is registered',\n                );\n            }\n            if (!this.resolveDataEngine(ctx)) {\n                ctx.logger.warn(\n                    'TimeRelativeTriggerPlugin: ObjectQL engine not available — time-relative sweeps will find no records until it is',\n                );\n            }\n\n            const trigger = new TimeRelativeTrigger(\n                () => this.resolveService<JobServiceSurface>(ctx, 'job'),\n                () => this.resolveDataEngine(ctx),\n                ctx.logger,\n            );\n            automation.registerTrigger(trigger);\n            ctx.logger.info('TimeRelativeTriggerPlugin: time-relative trigger registered');\n        });\n    }\n\n    private resolveService<T>(ctx: PluginContext, name: string): T | null {\n        try {\n            return ctx.getService<T>(name) ?? null;\n        } catch {\n            return null;\n        }\n    }\n\n    private resolveDataEngine(ctx: PluginContext): TimeRelativeDataEngine | null {\n        // Primary alias 'objectql', fallback 'data' (some kernels register the\n        // engine under both) — same lookup the record-change trigger uses.\n        return (\n            this.resolveService<TimeRelativeDataEngine>(ctx, 'objectql') ??\n            this.resolveService<TimeRelativeDataEngine>(ctx, 'data')\n        );\n    }\n}\n"],"mappings":"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","names":["JOB_PREFIX"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/trigger-schedule",
-  "version": "17.0.0-rc.6",
+  "version": "17.0.0",
   "license": "Apache-2.0",
   "description": "Schedule flow trigger for ObjectStack — auto-launches flows on a cron/interval/once schedule via the IJobService (ADR-0018)",
   "main": "dist/index.js",
@@ -13,14 +13,15 @@
     }
   },
   "dependencies": {
-    "@objectstack/spec": "17.0.0-rc.6",
-    "@objectstack/core": "17.0.0-rc.6"
+    "@objectstack/core": "17.0.0",
+    "@objectstack/spec": "17.0.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
+    "croner": "^10.0.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "@objectstack/service-automation": "17.0.0-rc.6"
+    "@objectstack/service-automation": "17.0.0"
   },
   "keywords": [
     "objectstack",