@rk0429/agentic-relay 20.1.1 → 21.0.0

package/dist/application/routine-event-log-sink.js

@@ -0,0 +1,82 @@
+import { RoutineName } from "../domain/routine-name.js";
+export class RoutineEventLogSink {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async logTriggered(opts) {
+        await this.appendRoutineLog("routine_triggered", "running", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            scheduled_time: opts.scheduledTime.toISOString(),
+            trigger_time: opts.triggerTime.toISOString(),
+            is_catch_up: opts.isCatchUp,
+        }, opts.occurredAt);
+        if (!opts.isCatchUp) {
+            return;
+        }
+        await this.appendRoutineLog("routine_catch_up", "running", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            scheduled_time: opts.scheduledTime.toISOString(),
+            trigger_time: opts.triggerTime.toISOString(),
+            skipped_count: opts.skippedCount ?? 0,
+        }, opts.occurredAt);
+    }
+    async logCompleted(opts) {
+        await this.appendRoutineLog("routine_completed", "success", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            duration: opts.duration,
+        }, opts.occurredAt);
+    }
+    async logFailed(opts) {
+        await this.appendRoutineLog("routine_failed", "error", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            duration: opts.duration,
+            error_code: opts.errorCode,
+            error_message: opts.errorMessage,
+            workflow_execution_id: opts.workflowExecutionId ?? null,
+        }, opts.occurredAt);
+    }
+    async logSkipped(opts) {
+        await this.appendRoutineLog("routine_skipped", "success", { ...opts, routineRunId: null }, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            reason: opts.reason,
+            scheduled_time: opts.scheduledTime.toISOString(),
+        }, opts.occurredAt);
+    }
+    async logStateUpdated(opts) {
+        await this.appendRoutineLog("routine_state_updated", "success", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            state: serializeRoutineState(opts.state),
+        }, opts.occurredAt);
+    }
+    async appendRoutineLog(eventType, status, envelope, payload, occurredAt = new Date()) {
+        const routineName = toRoutineNameValue(envelope.routineName);
+        const routineRunId = envelope.routineRunId ?? null;
+        await this.store.appendLog({
+            timestamp: occurredAt.toISOString(),
+            session_id: routineRunId ?? routineName,
+            event_type: eventType,
+            status,
+            details: {
+                routine: {
+                    routine_name: routineName,
+                    owner_pid: envelope.ownerPid,
+                    routine_run_id: routineRunId,
+                    ...payload,
+                },
+            },
+        });
+    }
+}
+function serializeRoutineState(state) {
+    return {
+        last_executed_at: state.lastExecutedAt?.toISOString() ?? null,
+        last_scheduled_at: state.lastScheduledAt?.toISOString() ?? null,
+        next_scheduled_at: state.nextScheduledAt?.toISOString() ?? null,
+        last_status: state.lastStatus,
+    };
+}
+function toRoutineNameValue(value) {
+    return value instanceof RoutineName ? value.value : value;
+}
+//# sourceMappingURL=routine-event-log-sink.js.map

package/dist/application/routine-event-log-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-event-log-sink.js","sourceRoot":"","sources":["../../src/application/routine-event-log-sink.ts"],"names":[],"mappings":"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"}

package/dist/application/routine-run-service.d.ts

@@ -0,0 +1,56 @@
+import type { LoopExecutionResult, ResumeLoopOptions, WorkflowExecutionService } from "./workflow-execution-service.js";
+import { RoutineEventLogSink } from "./routine-event-log-sink.js";
+import type { RoutineCatalogEntry } from "./routine-catalog-service.js";
+import { RoutineExecutionLeaseRepository } from "../infrastructure/store/routine-execution-lease-repository.js";
+import { RoutineRuntimeProjectionRepository } from "../infrastructure/store/routine-runtime-projection-repository.js";
+import { RoutineStateRepository } from "../infrastructure/store/routine-state-repository.js";
+export interface RoutineRunServiceDeps {
+    workflowExecutionService: Pick<WorkflowExecutionService, "startLoop" | "resumeLoop">;
+    leaseRepo: RoutineExecutionLeaseRepository;
+    runtimeRepo: RoutineRuntimeProjectionRepository;
+    stateRepo: RoutineStateRepository;
+    eventLog: RoutineEventLogSink;
+}
+export type RoutineDispatchSource = "scheduled" | "manual" | "catch_up" | "skip";
+export interface RoutineDispatchOptions {
+    source: RoutineDispatchSource;
+    firingTimes?: Date[];
+    scheduledTime?: Date;
+    triggerTime?: Date;
+    skippedSchedules?: Date[];
+    vars?: Record<string, string>;
+    cwd?: string;
+    signal?: AbortSignal;
+    skippedCount?: number;
+}
+export interface RoutineDispatchRunResult {
+    status: "completed" | "failed" | "skipped";
+    scheduledTime: string;
+    triggerTime?: string;
+    routineRunId?: string;
+    workflowExecutionId?: string;
+}
+export interface RoutineDispatchResult {
+    status: "completed" | "failed" | "skipped";
+    runs: RoutineDispatchRunResult[];
+}
+export interface RoutineRunServiceOptions {
+    now?: () => Date;
+    ownerPid?: number;
+    heartbeatIntervalMs?: number;
+}
+export declare class RoutineRunService {
+    private readonly deps;
+    private readonly now;
+    private readonly ownerPid;
+    private readonly heartbeatIntervalMs;
+    constructor(deps: RoutineRunServiceDeps, options?: RoutineRunServiceOptions);
+    dispatch(entry: RoutineCatalogEntry, options: RoutineDispatchOptions): Promise<RoutineDispatchResult>;
+    dispatchResume(entry: RoutineCatalogEntry, options: Omit<ResumeLoopOptions, "workflowPath" | "routineRunId">): Promise<LoopExecutionResult>;
+    dispatchSingle(entry: RoutineCatalogEntry, options: Omit<RoutineDispatchOptions, "firingTimes"> & {
+        scheduledTime: Date;
+        triggerTime: Date;
+    }): Promise<RoutineDispatchRunResult>;
+    private handleSkip;
+    private persistState;
+}

package/dist/application/routine-run-service.js

@@ -0,0 +1,370 @@
+import path from "node:path";
+import { ValidationError } from "../core/errors.js";
+import { createRoutineRunId, RoutineExecutionState } from "../domain/routine-execution-state.js";
+import { FiringContext, RoutineFiring } from "../domain/routine-firing.js";
+import { RoutineSchedule } from "../domain/routine-schedule.js";
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 15_000;
+export class RoutineRunService {
+    deps;
+    now;
+    ownerPid;
+    heartbeatIntervalMs;
+    constructor(deps, options = {}) {
+        this.deps = deps;
+        this.now = options.now ?? (() => new Date());
+        this.ownerPid = options.ownerPid ?? process.pid;
+        this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
+    }
+    async dispatch(entry, options) {
+        if (options.source === "skip") {
+            const scheduledTime = options.skippedSchedules?.at(-1) ?? requireSingleTime(options);
+            await this.handleSkip(entry, scheduledTime, "missed_policy_skip");
+            return {
+                status: "skipped",
+                runs: [
+                    {
+                        status: "skipped",
+                        scheduledTime: scheduledTime.toISOString(),
+                    },
+                ],
+            };
+        }
+        if (options.source === "catch_up") {
+            const firingTimes = requireFiringTimes(options);
+            if ((options.skippedSchedules?.length ?? 0) > 0) {
+                await this.handleSkip(entry, options.skippedSchedules.at(-1), "missed_policy_skip");
+            }
+            const runs = [];
+            for (const scheduledTime of firingTimes) {
+                const result = await this.dispatchSingle(entry, {
+                    source: "catch_up",
+                    scheduledTime,
+                    triggerTime: this.now(),
+                    vars: options.vars,
+                    cwd: options.cwd,
+                    signal: options.signal,
+                    skippedCount: options.skippedCount ?? options.skippedSchedules?.length ?? 0,
+                });
+                runs.push(result);
+                if (result.status === "failed") {
+                    return { status: "failed", runs };
+                }
+            }
+            return { status: "completed", runs };
+        }
+        const result = await this.dispatchSingle(entry, {
+            ...options,
+            scheduledTime: options.scheduledTime ??
+                (options.source === "manual" ? this.now() : requireSingleTime(options)),
+            triggerTime: options.triggerTime ?? this.now(),
+        });
+        return {
+            status: result.status,
+            runs: [result],
+        };
+    }
+    async dispatchResume(entry, options) {
+        const persisted = await this.deps.stateRepo.load(entry.definition.name);
+        const state = persisted?.state ?? RoutineExecutionState.create();
+        const schedule = new RoutineSchedule(entry.definition.trigger ?? null, state);
+        const routineRunId = createRoutineRunId();
+        const startedAt = this.now();
+        await this.deps.leaseRepo.acquire(entry.definition.name, this.ownerPid, routineRunId);
+        const heartbeat = setInterval(() => {
+            void this.deps.leaseRepo.heartbeat(entry.definition.name).catch(() => {
+                // Lease heartbeat loss is surfaced by the final execution result.
+            });
+        }, this.heartbeatIntervalMs);
+        try {
+            schedule.markFiring(routineRunId, startedAt, { isManual: true });
+            await this.deps.runtimeRepo.publish(entry.definition.name, {
+                routineRunId,
+                source: "manual",
+                startedAt: startedAt.toISOString(),
+                pid: this.ownerPid,
+            });
+            const result = await this.deps.workflowExecutionService.resumeLoop({
+                ...options,
+                workflowPath: entry.yamlPath,
+                routineRunId,
+            });
+            const finishedAt = this.now();
+            if (result.status === "completed") {
+                schedule.markCompleted(routineRunId, finishedAt);
+                await this.persistState(entry, schedule.executionState);
+                await this.deps.eventLog.logCompleted({
+                    routineName: entry.definition.name,
+                    ownerPid: this.ownerPid,
+                    routineRunId,
+                    duration: result.totalDuration,
+                });
+                await this.deps.eventLog.logStateUpdated({
+                    routineName: entry.definition.name,
+                    ownerPid: this.ownerPid,
+                    routineRunId,
+                    state: schedule.executionState,
+                });
+                return result;
+            }
+            schedule.markFailed(routineRunId, finishedAt);
+            await this.persistState(entry, schedule.executionState);
+            await this.deps.eventLog.logFailed({
+                routineName: entry.definition.name,
+                ownerPid: this.ownerPid,
+                routineRunId,
+                duration: result.totalDuration,
+                errorCode: "ROUTINE_EXECUTION_INTERRUPTED",
+                errorMessage: "Workflow execution was interrupted.",
+                workflowExecutionId: result.executionId,
+            });
+            await this.deps.eventLog.logStateUpdated({
+                routineName: entry.definition.name,
+                ownerPid: this.ownerPid,
+                routineRunId,
+                state: schedule.executionState,
+            });
+            return result;
+        }
+        catch (error) {
+            const failedAt = this.now();
+            const errorMessage = formatError(error);
+            try {
+                schedule.markFailed(routineRunId, failedAt);
+                await this.persistState(entry, schedule.executionState);
+                await this.deps.eventLog.logFailed({
+                    routineName: entry.definition.name,
+                    ownerPid: this.ownerPid,
+                    routineRunId,
+                    duration: 0,
+                    errorCode: "ROUTINE_EXECUTION_FAILED",
+                    errorMessage,
+                    workflowExecutionId: null,
+                });
+                await this.deps.eventLog.logStateUpdated({
+                    routineName: entry.definition.name,
+                    ownerPid: this.ownerPid,
+                    routineRunId,
+                    state: schedule.executionState,
+                });
+            }
+            catch {
+                // Best-effort cleanup must not mask the original resume failure.
+            }
+            throw error;
+        }
+        finally {
+            clearInterval(heartbeat);
+            await this.deps.runtimeRepo.remove(entry.definition.name);
+            await this.deps.leaseRepo.release(entry.definition.name);
+        }
+    }
+    async dispatchSingle(entry, options) {
+        const persisted = await this.deps.stateRepo.load(entry.definition.name);
+        const state = persisted?.state ?? RoutineExecutionState.create();
+        const schedule = new RoutineSchedule(entry.definition.trigger ?? null, state);
+        const routineRunId = createRoutineRunId();
+        const isManual = options.source === "manual";
+        const isCatchUp = options.source === "catch_up";
+        const scheduledTime = options.scheduledTime;
+        const triggerTime = options.triggerTime;
+        try {
+            await this.deps.leaseRepo.acquire(entry.definition.name, this.ownerPid, routineRunId);
+        }
+        catch (error) {
+            if (isManual) {
+                throw error;
+            }
+            if (error instanceof ValidationError) {
+                await this.handleSkip(entry, scheduledTime, "concurrent_execution", state);
+                return {
+                    status: "skipped",
+                    scheduledTime: scheduledTime.toISOString(),
+                };
+            }
+            throw error;
+        }
+        const heartbeat = setInterval(() => {
+            void this.deps.leaseRepo.heartbeat(entry.definition.name).catch(() => {
+                // Lease heartbeat loss is surfaced by the final execution result.
+            });
+        }, this.heartbeatIntervalMs);
+        try {
+            const firing = new RoutineFiring({
+                scheduledTime,
+                triggerTime,
+                isManual,
+                isCatchUp,
+                routineRunId,
+            });
+            const firingContext = new FiringContext(firing);
+            schedule.markFiring(routineRunId, scheduledTime, { isManual });
+            await this.deps.runtimeRepo.publish(entry.definition.name, {
+                routineRunId,
+                source: isManual ? "manual" : isCatchUp ? "catch_up" : "scheduled",
+                startedAt: triggerTime.toISOString(),
+                pid: this.ownerPid,
+            });
+            await this.deps.eventLog.logTriggered({
+                routineName: entry.definition.name,
+                ownerPid: this.ownerPid,
+                routineRunId,
+                scheduledTime,
+                triggerTime,
+                isCatchUp,
+                skippedCount: options.skippedCount,
+            });
+            const startedAt = this.now();
+            const workflowResult = await this.deps.workflowExecutionService.startLoop({
+                workflowPath: entry.yamlPath,
+                cwd: options.cwd ?? path.dirname(entry.yamlPath),
+                signal: options.signal,
+                vars: {
+                    ...firingContext.toTemplateVars(),
+                    ...(options.vars ?? {}),
+                },
+                routineRunId,
+                preloadedWorkflow: entry.workflowLoadResult,
+            });
+            const completedAt = this.now();
+            const duration = completedAt.getTime() - startedAt.getTime();
+            if (workflowResult.status === "completed") {
+                schedule.markCompleted(routineRunId, completedAt);
+                await this.persistState(entry, schedule.executionState);
+                await this.deps.eventLog.logCompleted({
+                    routineName: entry.definition.name,
+                    ownerPid: this.ownerPid,
+                    routineRunId,
+                    duration,
+                });
+                await this.deps.eventLog.logStateUpdated({
+                    routineName: entry.definition.name,
+                    ownerPid: this.ownerPid,
+                    routineRunId,
+                    state: schedule.executionState,
+                });
+                return {
+                    status: "completed",
+                    scheduledTime: scheduledTime.toISOString(),
+                    triggerTime: triggerTime.toISOString(),
+                    routineRunId,
+                    workflowExecutionId: workflowResult.executionId,
+                };
+            }
+            schedule.markFailed(routineRunId, completedAt);
+            await this.persistState(entry, schedule.executionState);
+            await this.deps.eventLog.logFailed({
+                routineName: entry.definition.name,
+                ownerPid: this.ownerPid,
+                routineRunId,
+                duration,
+                errorCode: "ROUTINE_EXECUTION_INTERRUPTED",
+                errorMessage: "Workflow execution was interrupted.",
+                workflowExecutionId: workflowResult.executionId,
+            });
+            await this.deps.eventLog.logStateUpdated({
+                routineName: entry.definition.name,
+                ownerPid: this.ownerPid,
+                routineRunId,
+                state: schedule.executionState,
+            });
+            return {
+                status: "failed",
+                scheduledTime: scheduledTime.toISOString(),
+                triggerTime: triggerTime.toISOString(),
+                routineRunId,
+                workflowExecutionId: workflowResult.executionId,
+            };
+        }
+        catch (error) {
+            const failedAt = this.now();
+            const errorMessage = formatError(error);
+            try {
+                schedule.markFailed(routineRunId, failedAt);
+                await this.persistState(entry, schedule.executionState);
+                await this.deps.eventLog.logFailed({
+                    routineName: entry.definition.name,
+                    ownerPid: this.ownerPid,
+                    routineRunId,
+                    duration: 0,
+                    errorCode: "ROUTINE_EXECUTION_FAILED",
+                    errorMessage,
+                    workflowExecutionId: null,
+                });
+                await this.deps.eventLog.logStateUpdated({
+                    routineName: entry.definition.name,
+                    ownerPid: this.ownerPid,
+                    routineRunId,
+                    state: schedule.executionState,
+                });
+            }
+            catch {
+                // Best-effort cleanup must not mask the original dispatch failure.
+            }
+            return {
+                status: "failed",
+                scheduledTime: scheduledTime.toISOString(),
+                triggerTime: triggerTime.toISOString(),
+                routineRunId,
+            };
+        }
+        finally {
+            clearInterval(heartbeat);
+            await this.deps.runtimeRepo.remove(entry.definition.name);
+            await this.deps.leaseRepo.release(entry.definition.name);
+        }
+    }
+    async handleSkip(entry, scheduledTime, reason, currentState) {
+        const state = currentState ?? (await this.deps.stateRepo.load(entry.definition.name))?.state;
+        const schedule = new RoutineSchedule(entry.definition.trigger ?? null, state ?? RoutineExecutionState.create());
+        schedule.markSkipped(scheduledTime);
+        await this.persistState(entry, schedule.executionState);
+        await this.deps.eventLog.logSkipped({
+            routineName: entry.definition.name,
+            ownerPid: this.ownerPid,
+            reason,
+            scheduledTime,
+        });
+        await this.deps.eventLog.logStateUpdated({
+            routineName: entry.definition.name,
+            ownerPid: this.ownerPid,
+            routineRunId: null,
+            state: schedule.executionState,
+        });
+    }
+    async persistState(entry, state) {
+        await this.deps.stateRepo.save(entry.definition.name, entry.yamlPath, state);
+    }
+}
+function requireSingleTime(options) {
+    if (options.scheduledTime) {
+        return options.scheduledTime;
+    }
+    const first = options.firingTimes?.[0];
+    if (!first) {
+        throw new ValidationError("scheduledTime is required for this routine dispatch.", {
+            recoveryHint: "Provide a scheduledTime for scheduled or skip dispatches.",
+        });
+    }
+    return first;
+}
+function requireFiringTimes(options) {
+    if (options.firingTimes && options.firingTimes.length > 0) {
+        return [...options.firingTimes].sort((left, right) => left.getTime() - right.getTime());
+    }
+    if (options.scheduledTime) {
+        return [options.scheduledTime];
+    }
+    throw new ValidationError("firingTimes is required for catch-up dispatch.", {
+        recoveryHint: "Provide one or more firingTimes for catch-up execution.",
+    });
+}
+function formatError(error) {
+    if (error instanceof ValidationError) {
+        return error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=routine-run-service.js.map

package/dist/application/routine-run-service.js.map

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

package/dist/application/routine-scheduler.d.ts

@@ -0,0 +1,34 @@
+import { RoutineExecutionState } from "../domain/routine-execution-state.js";
+import type { RoutineCatalogEntry } from "./routine-catalog-service.js";
+export declare const DEFAULT_ROUTINE_POLL_INTERVAL_MS = 15000;
+export declare const DEFAULT_ROUTINE_RESCAN_INTERVAL_MS = 60000;
+export interface RoutineSchedulerDecision {
+    definition: RoutineCatalogEntry["definition"];
+    yamlPath: string;
+    source: "scheduled" | "catch_up" | "skip";
+    firingTimes: Date[];
+    skippedSchedules: Date[];
+    skippedCount: number;
+}
+export interface RoutineSchedulerTickResult {
+    now: Date;
+    shouldRescan: boolean;
+    wokeFromSleep: boolean;
+    decisions: RoutineSchedulerDecision[];
+}
+export interface RoutineSchedulerOptions {
+    now?: () => Date;
+    monotonicNow?: () => number;
+    pollIntervalMs?: number;
+    rescanIntervalMs?: number;
+}
+export declare class RoutineScheduler {
+    private readonly now;
+    private readonly monotonicNow;
+    private readonly pollIntervalMs;
+    private readonly rescanIntervalMs;
+    private lastTickAt?;
+    private lastRescanAt?;
+    constructor(options?: RoutineSchedulerOptions);
+    tick(catalog: Map<string, RoutineCatalogEntry>, states: Map<string, RoutineExecutionState>): RoutineSchedulerTickResult;
+}

package/dist/application/routine-scheduler.js

@@ -0,0 +1,82 @@
+import { RoutineExecutionState } from "../domain/routine-execution-state.js";
+import { RoutineSchedule } from "../domain/routine-schedule.js";
+export const DEFAULT_ROUTINE_POLL_INTERVAL_MS = 15_000;
+export const DEFAULT_ROUTINE_RESCAN_INTERVAL_MS = 60_000;
+export class RoutineScheduler {
+    now;
+    monotonicNow;
+    pollIntervalMs;
+    rescanIntervalMs;
+    lastTickAt;
+    lastRescanAt;
+    constructor(options = {}) {
+        this.now = options.now ?? (() => new Date());
+        this.monotonicNow = options.monotonicNow ?? (() => performance.now());
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_ROUTINE_POLL_INTERVAL_MS;
+        this.rescanIntervalMs = options.rescanIntervalMs ?? DEFAULT_ROUTINE_RESCAN_INTERVAL_MS;
+    }
+    tick(catalog, states) {
+        const now = this.now();
+        const monotonicNow = this.monotonicNow();
+        const wokeFromSleep = this.lastTickAt !== undefined &&
+            monotonicNow - this.lastTickAt > this.pollIntervalMs * 2;
+        const shouldRescan = this.lastRescanAt === undefined ||
+            monotonicNow - this.lastRescanAt >= this.rescanIntervalMs;
+        const decisions = [];
+        for (const [name, entry] of [...catalog.entries()].sort(([left], [right]) => left.localeCompare(right))) {
+            if (!entry.definition.trigger) {
+                continue;
+            }
+            const trigger = entry.definition.trigger;
+            const state = states.get(name) ?? RoutineExecutionState.create();
+            const schedule = new RoutineSchedule(trigger, state);
+            const evaluation = schedule.evaluateMissedFires(now);
+            if (evaluation.firesToExecute.length === 0 &&
+                evaluation.skippedSchedules.length > 0) {
+                decisions.push({
+                    definition: entry.definition,
+                    yamlPath: entry.yamlPath,
+                    source: "skip",
+                    firingTimes: [evaluation.skippedSchedules.at(-1)],
+                    skippedSchedules: evaluation.skippedSchedules,
+                    skippedCount: evaluation.skippedSchedules.length,
+                });
+                continue;
+            }
+            if (evaluation.firesToExecute.length === 0) {
+                continue;
+            }
+            const isCatchUp = wokeFromSleep ||
+                evaluation.firesToExecute.length > 1 ||
+                evaluation.skippedSchedules.length > 0 ||
+                now.getTime() - evaluation.firesToExecute[0].getTime() > this.pollIntervalMs;
+            decisions.push({
+                definition: entry.definition,
+                yamlPath: entry.yamlPath,
+                source: isCatchUp ? "catch_up" : "scheduled",
+                firingTimes: evaluation.firesToExecute,
+                skippedSchedules: evaluation.skippedSchedules,
+                skippedCount: evaluation.skippedSchedules.length,
+            });
+        }
+        decisions.sort((left, right) => {
+            const leftTime = left.firingTimes[0].getTime();
+            const rightTime = right.firingTimes[0].getTime();
+            if (leftTime !== rightTime) {
+                return leftTime - rightTime;
+            }
+            return left.definition.name.value.localeCompare(right.definition.name.value);
+        });
+        this.lastTickAt = monotonicNow;
+        if (shouldRescan) {
+            this.lastRescanAt = monotonicNow;
+        }
+        return {
+            now,
+            shouldRescan,
+            wokeFromSleep,
+            decisions,
+        };
+    }
+}
+//# sourceMappingURL=routine-scheduler.js.map

package/dist/application/routine-scheduler.js.map

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