daycare-cli 0.0.1

package/dist/engine/cron/cronTypes.d.ts

@@ -0,0 +1,81 @@
+import type { ExecGateDefinition } from "@/types";
+/**
+ * Cron task definition as stored/provided by the user.
+ */
+export type CronTaskDefinition = {
+    id: string;
+    taskUid?: string;
+    name: string;
+    description?: string;
+    schedule: string;
+    prompt: string;
+    agentId?: string;
+    gate?: ExecGateDefinition;
+    enabled?: boolean;
+    deleteAfterRun?: boolean;
+};
+/**
+ * Cron task with computed paths for file storage.
+ */
+export type CronTaskWithPaths = Omit<CronTaskDefinition, "taskUid"> & {
+    taskUid: string;
+    taskPath: string;
+    memoryPath: string;
+    filesPath: string;
+    lastRunAt?: string;
+};
+/**
+ * Internal state persisted for each cron task.
+ */
+export type CronTaskState = {
+    lastRunAt?: string;
+};
+/**
+ * Context passed to task handlers when a cron task executes.
+ */
+export type CronTaskContext = {
+    taskId: string;
+    taskUid: string;
+    taskName: string;
+    prompt: string;
+    memoryPath: string;
+    filesPath: string;
+    agentId?: string;
+};
+/**
+ * Simple key-value frontmatter from markdown files.
+ */
+export type Frontmatter = Record<string, unknown>;
+/**
+ * Parsed markdown document with frontmatter and body.
+ */
+export type ParsedDocument = {
+    frontmatter: Frontmatter;
+    body: string;
+};
+/**
+ * A single field from a parsed cron expression.
+ */
+export type CronField = {
+    values: Set<number>;
+    any: boolean;
+};
+/**
+ * Parsed 5-field cron expression.
+ */
+export type ParsedCron = {
+    minute: CronField;
+    hour: CronField;
+    day: CronField;
+    month: CronField;
+    weekday: CronField;
+};
+/**
+ * Internal tracking for a scheduled task in the scheduler.
+ */
+export type ScheduledTask = {
+    task: CronTaskWithPaths;
+    nextRun: Date;
+    timer: NodeJS.Timeout | null;
+};
+//# sourceMappingURL=cronTypes.d.ts.map

package/dist/engine/cron/cronTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronTypes.d.ts","sourceRoot":"","sources":["../../../sources/engine/cron/cronTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,GAAG;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CAC9B,CAAC"}

package/dist/engine/cron/cronTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cronTypes.js.map

package/dist/engine/cron/cronTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronTypes.js","sourceRoot":"","sources":["../../../sources/engine/cron/cronTypes.ts"],"names":[],"mappings":""}

package/dist/engine/cron/crons.d.ts

@@ -0,0 +1,33 @@
+import type { EngineEventBus } from "../ipc/events.js";
+import type { CronTaskDefinition, CronTaskWithPaths } from "./cronTypes.js";
+import type { AgentSystem } from "../agents/agentSystem.js";
+import type { ConfigModule } from "../config/configModule.js";
+export type CronsOptions = {
+    config: ConfigModule;
+    eventBus: EngineEventBus;
+    agentSystem: AgentSystem;
+};
+/**
+ * Coordinates cron storage + scheduling for engine runtime.
+ * Posts cron task prompts directly to the agent system.
+ */
+export declare class Crons {
+    private readonly eventBus;
+    private readonly agentSystem;
+    private readonly scheduler;
+    private readonly store;
+    constructor(options: CronsOptions);
+    ensureDir(): Promise<void>;
+    start(): Promise<void>;
+    stop(): void;
+    listScheduledTasks(): CronTaskWithPaths[];
+    listTasks(): Promise<CronTaskWithPaths[]>;
+    addTask(definition: Omit<CronTaskDefinition, "id"> & {
+        id?: string;
+    }): Promise<CronTaskWithPaths>;
+    deleteTask(taskId: string): Promise<boolean>;
+    loadTask(taskId: string): Promise<CronTaskWithPaths | null>;
+    readMemory(taskId: string): Promise<string>;
+    writeMemory(taskId: string, content: string): Promise<void>;
+}
+//# sourceMappingURL=crons.d.ts.map

package/dist/engine/cron/crons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crons.d.ts","sourceRoot":"","sources":["../../../sources/engine/cron/crons.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEtB,OAAO,EAAE,YAAY;IAwE3B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,IAAI,IAAI,IAAI;IAIZ,kBAAkB,IAAI,iBAAiB,EAAE;IAInC,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIzC,OAAO,CACX,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,OAAO,CAAC,iBAAiB,CAAC;IAMvB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAI3D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlE"}

package/dist/engine/cron/crons.js

@@ -0,0 +1,124 @@
+import path from "node:path";
+import { getLogger } from "../../log.js";
+import { CronScheduler } from "./ops/cronScheduler.js";
+import { CronStore } from "./ops/cronStore.js";
+import { permissionBuildCron } from "../permissions/permissionBuildCron.js";
+const logger = getLogger("cron.facade");
+/**
+ * Coordinates cron storage + scheduling for engine runtime.
+ * Posts cron task prompts directly to the agent system.
+ */
+export class Crons {
+    eventBus;
+    agentSystem;
+    scheduler;
+    store;
+    constructor(options) {
+        this.eventBus = options.eventBus;
+        this.agentSystem = options.agentSystem;
+        const currentConfig = options.config.current;
+        const basePath = path.join(currentConfig.configDir, "cron");
+        this.store = new CronStore(basePath);
+        this.scheduler = new CronScheduler({
+            config: options.config,
+            store: this.store,
+            defaultPermissions: currentConfig.defaultPermissions,
+            resolvePermissions: async (task) => {
+                if (task.agentId) {
+                    return this.agentSystem.permissionsForTarget({ agentId: task.agentId });
+                }
+                const base = permissionBuildCron(options.config.current.defaultPermissions, task.filesPath);
+                const current = await this.agentSystem.permissionsForTarget({
+                    descriptor: { type: "cron", id: task.taskUid, name: task.name }
+                });
+                return mergeCronPermissions(base, current);
+            },
+            onTask: async (task, messageContext) => {
+                const target = task.agentId
+                    ? { agentId: task.agentId }
+                    : {
+                        descriptor: {
+                            type: "cron",
+                            id: task.taskUid,
+                            name: task.taskName
+                        }
+                    };
+                logger.debug(`CronScheduler.onTask triggered taskUid=${task.taskUid} agentId=${task.agentId ?? "cron"}`);
+                await this.agentSystem.postAndAwait(target, {
+                    type: "message",
+                    message: { text: task.prompt },
+                    context: messageContext
+                });
+            },
+            onError: async (error, taskId) => {
+                logger.warn({ taskId, error }, "Cron task failed");
+            },
+            onGatePermissionSkip: async (task, missing) => {
+                const label = task.name ? `"${task.name}" (${task.id})` : task.id;
+                const notice = `Cron gate permissions not allowed for ${label}: ${missing.join(", ")}. The gate check was skipped and the task ran anyway.`;
+                const target = task.agentId
+                    ? { agentId: task.agentId }
+                    : {
+                        descriptor: {
+                            type: "cron",
+                            id: task.taskUid,
+                            name: task.name
+                        }
+                    };
+                await this.agentSystem.post(target, {
+                    type: "system_message",
+                    text: notice,
+                    origin: "system",
+                    silent: true
+                });
+            },
+            onTaskComplete: (task, runAt) => {
+                this.eventBus.emit("cron.task.ran", { taskId: task.id, runAt: runAt.toISOString() });
+            }
+        });
+    }
+    async ensureDir() {
+        await this.store.ensureDir();
+    }
+    async start() {
+        await this.scheduler.start();
+        this.eventBus.emit("cron.started", { tasks: this.scheduler.listTasks() });
+    }
+    stop() {
+        this.scheduler.stop();
+    }
+    listScheduledTasks() {
+        return this.scheduler.listTasks();
+    }
+    async listTasks() {
+        return this.store.listTasks();
+    }
+    async addTask(definition) {
+        const task = await this.scheduler.addTask(definition);
+        this.eventBus.emit("cron.task.added", { task });
+        return task;
+    }
+    async deleteTask(taskId) {
+        return this.scheduler.deleteTask(taskId);
+    }
+    async loadTask(taskId) {
+        return this.store.loadTask(taskId);
+    }
+    async readMemory(taskId) {
+        return this.store.readMemory(taskId);
+    }
+    async writeMemory(taskId, content) {
+        await this.store.writeMemory(taskId, content);
+    }
+}
+function mergeCronPermissions(base, current) {
+    const writeDirs = new Set([...base.writeDirs, ...current.writeDirs]);
+    const readDirs = new Set([...base.readDirs, ...current.readDirs]);
+    return {
+        workingDir: base.workingDir,
+        writeDirs: Array.from(writeDirs.values()),
+        readDirs: Array.from(readDirs.values()),
+        network: base.network || current.network
+    };
+}
+//# sourceMappingURL=crons.js.map

package/dist/engine/cron/crons.js.map

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

package/dist/engine/cron/ops/cronExpressionParse.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedCron } from "../cronTypes.js";
+/**
+ * Parses a 5-field cron expression into its components.
+ *
+ * Expects: cron expression string with format "minute hour day month weekday".
+ * Returns: ParsedCron object or null if the expression is invalid.
+ */
+export declare function cronExpressionParse(expression: string): ParsedCron | null;
+//# sourceMappingURL=cronExpressionParse.d.ts.map

package/dist/engine/cron/ops/cronExpressionParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronExpressionParse.d.ts","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronExpressionParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAmBzE"}

package/dist/engine/cron/ops/cronExpressionParse.js

@@ -0,0 +1,24 @@
+import { cronFieldParse } from "./cronFieldParse.js";
+/**
+ * Parses a 5-field cron expression into its components.
+ *
+ * Expects: cron expression string with format "minute hour day month weekday".
+ * Returns: ParsedCron object or null if the expression is invalid.
+ */
+export function cronExpressionParse(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        return null;
+    }
+    const [minuteStr, hourStr, dayStr, monthStr, weekdayStr] = parts;
+    const minute = cronFieldParse(minuteStr, 0, 59);
+    const hour = cronFieldParse(hourStr, 0, 23);
+    const day = cronFieldParse(dayStr, 1, 31);
+    const month = cronFieldParse(monthStr, 1, 12);
+    const weekday = cronFieldParse(weekdayStr, 0, 6);
+    if (!minute || !hour || !day || !month || !weekday) {
+        return null;
+    }
+    return { minute, hour, day, month, weekday };
+}
+//# sourceMappingURL=cronExpressionParse.js.map

package/dist/engine/cron/ops/cronExpressionParse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronExpressionParse.js","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronExpressionParse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC;IAEjE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAU,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,cAAc,CAAC,MAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,cAAc,CAAC,QAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,cAAc,CAAC,UAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAElD,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}

package/dist/engine/cron/ops/cronExpressionParse.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cronExpressionParse.spec.d.ts.map

package/dist/engine/cron/ops/cronExpressionParse.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronExpressionParse.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronExpressionParse.spec.ts"],"names":[],"mappings":""}

package/dist/engine/cron/ops/cronExpressionParse.spec.js

@@ -0,0 +1,73 @@
+import { describe, it, expect } from "vitest";
+import { cronExpressionParse } from "./cronExpressionParse.js";
+describe("cronExpressionParse", () => {
+    it("parses wildcard expression", () => {
+        const result = cronExpressionParse("* * * * *");
+        expect(result).not.toBeNull();
+        expect(result.minute.any).toBe(true);
+        expect(result.hour.any).toBe(true);
+        expect(result.day.any).toBe(true);
+        expect(result.month.any).toBe(true);
+        expect(result.weekday.any).toBe(true);
+    });
+    it("parses specific values", () => {
+        const result = cronExpressionParse("30 9 * * *");
+        expect(result).not.toBeNull();
+        expect(result.minute.values.has(30)).toBe(true);
+        expect(result.hour.values.has(9)).toBe(true);
+    });
+    it("parses step values", () => {
+        const result = cronExpressionParse("*/15 * * * *");
+        expect(result).not.toBeNull();
+        expect(result.minute.values.has(0)).toBe(true);
+        expect(result.minute.values.has(15)).toBe(true);
+        expect(result.minute.values.has(30)).toBe(true);
+        expect(result.minute.values.has(45)).toBe(true);
+    });
+    it("parses ranges", () => {
+        const result = cronExpressionParse("* 9-17 * * *");
+        expect(result).not.toBeNull();
+        expect(result.hour.values.size).toBe(9);
+        expect(result.hour.values.has(9)).toBe(true);
+        expect(result.hour.values.has(17)).toBe(true);
+    });
+    it("parses comma-separated values", () => {
+        const result = cronExpressionParse("0,30 * * * *");
+        expect(result).not.toBeNull();
+        expect(result.minute.values.size).toBe(2);
+        expect(result.minute.values.has(0)).toBe(true);
+        expect(result.minute.values.has(30)).toBe(true);
+    });
+    it("parses weekday", () => {
+        const result = cronExpressionParse("0 9 * * 1");
+        expect(result).not.toBeNull();
+        expect(result.weekday.values.has(1)).toBe(true);
+    });
+    it("returns null for too few fields", () => {
+        expect(cronExpressionParse("* * *")).toBeNull();
+    });
+    it("returns null for too many fields", () => {
+        expect(cronExpressionParse("* * * * * *")).toBeNull();
+    });
+    it("returns null for invalid minute", () => {
+        expect(cronExpressionParse("60 * * * *")).toBeNull();
+    });
+    it("returns null for invalid hour", () => {
+        expect(cronExpressionParse("* 24 * * *")).toBeNull();
+    });
+    it("returns null for invalid day", () => {
+        expect(cronExpressionParse("* * 32 * *")).toBeNull();
+        expect(cronExpressionParse("* * 0 * *")).toBeNull();
+    });
+    it("returns null for invalid month", () => {
+        expect(cronExpressionParse("* * * 13 *")).toBeNull();
+        expect(cronExpressionParse("* * * 0 *")).toBeNull();
+    });
+    it("returns null for invalid weekday", () => {
+        expect(cronExpressionParse("* * * * 7")).toBeNull();
+    });
+    it("returns null for invalid expression", () => {
+        expect(cronExpressionParse("invalid")).toBeNull();
+    });
+});
+//# sourceMappingURL=cronExpressionParse.spec.js.map

package/dist/engine/cron/ops/cronExpressionParse.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronExpressionParse.spec.js","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronExpressionParse.spec.ts"],"names":[],"mappings":"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"}

package/dist/engine/cron/ops/cronFieldMatch.d.ts

@@ -0,0 +1,9 @@
+import type { CronField } from "../cronTypes.js";
+/**
+ * Checks if a value matches a cron field.
+ *
+ * Expects: a parsed CronField and a numeric value.
+ * Returns: true if the value matches (field is "any" or value is in the set).
+ */
+export declare function cronFieldMatch(field: CronField, value: number): boolean;
+//# sourceMappingURL=cronFieldMatch.d.ts.map

package/dist/engine/cron/ops/cronFieldMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronFieldMatch.d.ts","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronFieldMatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvE"}

package/dist/engine/cron/ops/cronFieldMatch.js

@@ -0,0 +1,10 @@
+/**
+ * Checks if a value matches a cron field.
+ *
+ * Expects: a parsed CronField and a numeric value.
+ * Returns: true if the value matches (field is "any" or value is in the set).
+ */
+export function cronFieldMatch(field, value) {
+    return field.any || field.values.has(value);
+}
+//# sourceMappingURL=cronFieldMatch.js.map

package/dist/engine/cron/ops/cronFieldMatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronFieldMatch.js","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronFieldMatch.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAE,KAAa;IAC5D,OAAO,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/engine/cron/ops/cronFieldMatch.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cronFieldMatch.spec.d.ts.map

package/dist/engine/cron/ops/cronFieldMatch.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronFieldMatch.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronFieldMatch.spec.ts"],"names":[],"mappings":""}

package/dist/engine/cron/ops/cronFieldMatch.spec.js

@@ -0,0 +1,29 @@
+import { describe, it, expect } from "vitest";
+import { cronFieldMatch } from "./cronFieldMatch.js";
+describe("cronFieldMatch", () => {
+    it("matches any field with any value", () => {
+        const field = { values: new Set(), any: true };
+        expect(cronFieldMatch(field, 0)).toBe(true);
+        expect(cronFieldMatch(field, 30)).toBe(true);
+        expect(cronFieldMatch(field, 59)).toBe(true);
+    });
+    it("matches specific values", () => {
+        const field = { values: new Set([0, 15, 30, 45]), any: false };
+        expect(cronFieldMatch(field, 0)).toBe(true);
+        expect(cronFieldMatch(field, 15)).toBe(true);
+        expect(cronFieldMatch(field, 30)).toBe(true);
+        expect(cronFieldMatch(field, 45)).toBe(true);
+    });
+    it("does not match non-included values", () => {
+        const field = { values: new Set([0, 15, 30, 45]), any: false };
+        expect(cronFieldMatch(field, 1)).toBe(false);
+        expect(cronFieldMatch(field, 10)).toBe(false);
+        expect(cronFieldMatch(field, 59)).toBe(false);
+    });
+    it("handles empty value set (not any)", () => {
+        const field = { values: new Set(), any: false };
+        expect(cronFieldMatch(field, 0)).toBe(false);
+        expect(cronFieldMatch(field, 30)).toBe(false);
+    });
+});
+//# sourceMappingURL=cronFieldMatch.spec.js.map

package/dist/engine/cron/ops/cronFieldMatch.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronFieldMatch.spec.js","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronFieldMatch.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAc,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAC1D,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,KAAK,GAAc,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC1E,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,KAAK,GAAc,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC1E,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAc,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC3D,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/cron/ops/cronFieldParse.d.ts

@@ -0,0 +1,9 @@
+import type { CronField } from "../cronTypes.js";
+/**
+ * Parses a single cron field (minute, hour, day, month, or weekday).
+ *
+ * Expects: field string and valid min/max range for that field.
+ * Returns: CronField with values set, or null if invalid.
+ */
+export declare function cronFieldParse(field: string, min: number, max: number): CronField | null;
+//# sourceMappingURL=cronFieldParse.d.ts.map

package/dist/engine/cron/ops/cronFieldParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronFieldParse.d.ts","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronFieldParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CA2CxF"}

package/dist/engine/cron/ops/cronFieldParse.js

@@ -0,0 +1,48 @@
+/**
+ * Parses a single cron field (minute, hour, day, month, or weekday).
+ *
+ * Expects: field string and valid min/max range for that field.
+ * Returns: CronField with values set, or null if invalid.
+ */
+export function cronFieldParse(field, min, max) {
+    if (field === "*") {
+        return { values: new Set(), any: true };
+    }
+    const values = new Set();
+    // Handle step values like */5
+    if (field.startsWith("*/")) {
+        const step = parseInt(field.slice(2), 10);
+        if (isNaN(step) || step <= 0) {
+            return null;
+        }
+        for (let i = min; i <= max; i += step) {
+            values.add(i);
+        }
+        return { values, any: false };
+    }
+    // Handle comma-separated values
+    const parts = field.split(",");
+    for (const part of parts) {
+        // Handle ranges like 1-5
+        if (part.includes("-")) {
+            const [startStr, endStr] = part.split("-");
+            const start = parseInt(startStr, 10);
+            const end = parseInt(endStr, 10);
+            if (isNaN(start) || isNaN(end) || start < min || end > max || start > end) {
+                return null;
+            }
+            for (let i = start; i <= end; i++) {
+                values.add(i);
+            }
+        }
+        else {
+            const value = parseInt(part, 10);
+            if (isNaN(value) || value < min || value > max) {
+                return null;
+            }
+            values.add(value);
+        }
+    }
+    return { values, any: false };
+}
+//# sourceMappingURL=cronFieldParse.js.map

package/dist/engine/cron/ops/cronFieldParse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronFieldParse.js","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronFieldParse.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpE,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,8BAA8B;IAC9B,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,gCAAgC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,yBAAyB;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAS,EAAE,EAAE,CAAC,CAAC;YACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAO,EAAE,EAAE,CAAC,CAAC;YAClC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;gBAC1E,OAAO,IAAI,CAAC;YACd,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;gBAC/C,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC"}

package/dist/engine/cron/ops/cronFieldParse.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cronFieldParse.spec.d.ts.map

package/dist/engine/cron/ops/cronFieldParse.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronFieldParse.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronFieldParse.spec.ts"],"names":[],"mappings":""}

package/dist/engine/cron/ops/cronFieldParse.spec.js

@@ -0,0 +1,62 @@
+import { describe, it, expect } from "vitest";
+import { cronFieldParse } from "./cronFieldParse.js";
+describe("cronFieldParse", () => {
+    it("parses wildcard", () => {
+        const result = cronFieldParse("*", 0, 59);
+        expect(result).not.toBeNull();
+        expect(result.any).toBe(true);
+        expect(result.values.size).toBe(0);
+    });
+    it("parses single value", () => {
+        const result = cronFieldParse("30", 0, 59);
+        expect(result).not.toBeNull();
+        expect(result.any).toBe(false);
+        expect(result.values.has(30)).toBe(true);
+    });
+    it("parses step values", () => {
+        const result = cronFieldParse("*/15", 0, 59);
+        expect(result).not.toBeNull();
+        expect(result.values.has(0)).toBe(true);
+        expect(result.values.has(15)).toBe(true);
+        expect(result.values.has(30)).toBe(true);
+        expect(result.values.has(45)).toBe(true);
+        expect(result.values.size).toBe(4);
+    });
+    it("parses ranges", () => {
+        const result = cronFieldParse("9-17", 0, 23);
+        expect(result).not.toBeNull();
+        expect(result.values.size).toBe(9);
+        expect(result.values.has(9)).toBe(true);
+        expect(result.values.has(17)).toBe(true);
+    });
+    it("parses comma-separated values", () => {
+        const result = cronFieldParse("0,30", 0, 59);
+        expect(result).not.toBeNull();
+        expect(result.values.size).toBe(2);
+        expect(result.values.has(0)).toBe(true);
+        expect(result.values.has(30)).toBe(true);
+    });
+    it("parses mixed comma and range", () => {
+        const result = cronFieldParse("1-3,10,20-22", 0, 59);
+        expect(result).not.toBeNull();
+        expect(result.values.size).toBe(7);
+        expect([...result.values].sort((a, b) => a - b)).toEqual([1, 2, 3, 10, 20, 21, 22]);
+    });
+    it("returns null for out-of-range value", () => {
+        expect(cronFieldParse("60", 0, 59)).toBeNull();
+        expect(cronFieldParse("-1", 0, 59)).toBeNull();
+    });
+    it("returns null for invalid range", () => {
+        expect(cronFieldParse("10-5", 0, 59)).toBeNull();
+        expect(cronFieldParse("0-60", 0, 59)).toBeNull();
+    });
+    it("returns null for invalid step", () => {
+        expect(cronFieldParse("*/0", 0, 59)).toBeNull();
+        expect(cronFieldParse("*/-1", 0, 59)).toBeNull();
+        expect(cronFieldParse("*/abc", 0, 59)).toBeNull();
+    });
+    it("returns null for non-numeric value", () => {
+        expect(cronFieldParse("abc", 0, 59)).toBeNull();
+    });
+});
+//# sourceMappingURL=cronFieldParse.spec.js.map

package/dist/engine/cron/ops/cronFieldParse.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronFieldParse.spec.js","sourceRoot":"","sources":["../../../../sources/engine/cron/ops/cronFieldParse.spec.ts"],"names":[],"mappings":"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"}

package/dist/engine/cron/ops/cronFrontmatterParse.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedDocument } from "../cronTypes.js";
+/**
+ * Parses YAML frontmatter from markdown content using gray-matter.
+ *
+ * Expects: markdown content string, optionally with --- delimited frontmatter.
+ * Returns: parsed frontmatter object and remaining body text.
+ */
+export declare function cronFrontmatterParse(content: string): ParsedDocument;
+//# sourceMappingURL=cronFrontmatterParse.d.ts.map