daycare-cli 0.0.1

package/dist/engine/heartbeat/ops/heartbeatScheduler.js

@@ -0,0 +1,193 @@
+import { getLogger } from "../../../log.js";
+import { execGateCheck } from "../../scheduling/execGateCheck.js";
+import { execGateOutputAppend } from "../../scheduling/execGateOutputAppend.js";
+import { permissionClone } from "../../permissions/permissionClone.js";
+import { gatePermissionsCheck } from "../../scheduling/gatePermissionsCheck.js";
+const logger = getLogger("heartbeat.scheduler");
+/**
+ * Manages interval-based heartbeat task execution.
+ *
+ * Runs all heartbeat tasks in a single batch at regular intervals.
+ */
+export class HeartbeatScheduler {
+    config;
+    store;
+    intervalMs;
+    onRun;
+    onError;
+    onGatePermissionSkip;
+    onTaskComplete;
+    defaultPermissions;
+    resolvePermissions;
+    gateCheck;
+    timer = null;
+    started = false;
+    stopped = false;
+    running = false;
+    nextRunAt = null;
+    constructor(options) {
+        this.config = options.config;
+        this.store = options.store;
+        this.intervalMs = options.intervalMs ?? 30 * 60 * 1000;
+        this.onRun = options.onRun;
+        this.onError = options.onError;
+        this.onGatePermissionSkip = options.onGatePermissionSkip;
+        this.onTaskComplete = options.onTaskComplete;
+        this.defaultPermissions = options.defaultPermissions;
+        this.resolvePermissions = options.resolvePermissions;
+        this.gateCheck = options.gateCheck ?? execGateCheck;
+        logger.debug("HeartbeatScheduler initialized");
+    }
+    async start() {
+        logger.debug(`start() called started=${this.started} stopped=${this.stopped}`);
+        if (this.started || this.stopped) {
+            return;
+        }
+        this.started = true;
+        this.scheduleNext();
+    }
+    stop() {
+        logger.debug(`stop() called stopped=${this.stopped}`);
+        if (this.stopped) {
+            return;
+        }
+        this.stopped = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        logger.debug("HeartbeatScheduler stopped");
+    }
+    async runNow(taskIds) {
+        return this.runOnce(taskIds);
+    }
+    async listTasks() {
+        return this.store.listTasks();
+    }
+    getIntervalMs() {
+        return this.intervalMs;
+    }
+    getNextRunAt() {
+        return this.nextRunAt;
+    }
+    scheduleNext() {
+        if (this.stopped) {
+            return;
+        }
+        if (this.timer) {
+            clearTimeout(this.timer);
+        }
+        this.nextRunAt = new Date(Date.now() + this.intervalMs);
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.tick();
+        }, this.intervalMs);
+    }
+    async tick() {
+        if (this.stopped) {
+            return;
+        }
+        try {
+            await this.runOnce();
+        }
+        finally {
+            this.scheduleNext();
+        }
+    }
+    async runOnce(taskIds) {
+        return this.config.inReadLock(async () => this.runOnceUnlocked(taskIds));
+    }
+    async runOnceUnlocked(taskIds) {
+        if (this.running) {
+            logger.debug("HeartbeatScheduler run skipped (already running)");
+            return { ran: 0, taskIds: [] };
+        }
+        this.running = true;
+        try {
+            const tasks = await this.store.listTasks();
+            const filtered = taskIds && taskIds.length > 0
+                ? tasks.filter((task) => taskIds.includes(task.id))
+                : tasks;
+            if (filtered.length === 0) {
+                return { ran: 0, taskIds: [] };
+            }
+            const basePermissions = await this.resolvePermissions?.() ?? this.defaultPermissions;
+            const gated = await this.filterByGate(filtered, basePermissions);
+            if (gated.length === 0) {
+                return { ran: 0, taskIds: [] };
+            }
+            const runAt = new Date();
+            const ids = gated.map((task) => task.id);
+            logger.info({
+                taskCount: gated.length,
+                taskIds: ids
+            }, "Heartbeat run started");
+            try {
+                await this.onRun(gated, runAt);
+            }
+            catch (error) {
+                logger.warn({ taskIds: ids, error }, "Heartbeat run failed");
+                await this.onError?.(error, ids);
+            }
+            finally {
+                await this.store.recordRun(runAt);
+                for (const task of gated) {
+                    task.lastRunAt = runAt.toISOString();
+                    await this.onTaskComplete?.(task, runAt);
+                }
+            }
+            logger.info({
+                taskCount: filtered.length,
+                taskIds: ids
+            }, "Heartbeat run completed");
+            return { ran: gated.length, taskIds: ids };
+        }
+        catch (error) {
+            logger.warn({ error }, "Heartbeat run failed");
+            await this.onError?.(error, undefined);
+            return { ran: 0, taskIds: [] };
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    async filterByGate(tasks, basePermissions) {
+        const eligible = [];
+        for (const task of tasks) {
+            if (!task.gate) {
+                eligible.push(task);
+                continue;
+            }
+            const permissions = permissionClone(basePermissions);
+            const permissionCheck = await gatePermissionsCheck(permissions, task.gate.permissions);
+            if (!permissionCheck.allowed) {
+                logger.warn({ taskId: task.id, missing: permissionCheck.missing }, "Heartbeat gate permissions not satisfied; continuing without gate");
+                await this.onGatePermissionSkip?.(task, permissionCheck.missing);
+                eligible.push(task);
+                continue;
+            }
+            const result = await this.gateCheck?.({
+                gate: task.gate,
+                permissions,
+                workingDir: permissions.workingDir
+            });
+            if (!result) {
+                eligible.push(task);
+                continue;
+            }
+            if (result.error) {
+                logger.warn({ taskId: task.id, error: result.error }, "Heartbeat gate failed");
+                await this.onError?.(result.error, [task.id]);
+                continue;
+            }
+            if (!result.shouldRun) {
+                logger.debug({ taskId: task.id, exitCode: result.exitCode }, "Heartbeat gate skipped execution");
+                continue;
+            }
+            const prompt = execGateOutputAppend(task.prompt, result);
+            eligible.push(prompt === task.prompt ? task : { ...task, prompt });
+        }
+        return eligible;
+    }
+}
+//# sourceMappingURL=heartbeatScheduler.js.map

package/dist/engine/heartbeat/ops/heartbeatScheduler.js.map

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

package/dist/engine/heartbeat/ops/heartbeatScheduler.spec.d.ts

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

package/dist/engine/heartbeat/ops/heartbeatScheduler.spec.d.ts.map

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

package/dist/engine/heartbeat/ops/heartbeatScheduler.spec.js

@@ -0,0 +1,140 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { HeartbeatScheduler } from "./heartbeatScheduler.js";
+import { HeartbeatStore } from "./heartbeatStore.js";
+import { configResolve } from "../../../config/configResolve.js";
+import { ConfigModule } from "../../config/configModule.js";
+async function createTempStore() {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-heartbeat-"));
+    const store = new HeartbeatStore(dir);
+    await store.ensureDir();
+    return { dir, store };
+}
+async function cleanupTempStore(dir) {
+    await fs.rm(dir, { recursive: true, force: true });
+}
+describe("HeartbeatScheduler", () => {
+    const temps = [];
+    const defaultPermissions = (workingDir) => ({
+        workingDir,
+        writeDirs: [],
+        readDirs: [],
+        network: false
+    });
+    const configModule = (workingDir) => new ConfigModule(configResolve({ engine: { dataDir: workingDir } }, path.join(workingDir, "settings.json")));
+    afterEach(async () => {
+        await Promise.all(temps.map((dir) => cleanupTempStore(dir)));
+        temps.length = 0;
+    });
+    it("runs all tasks in a single batch", async () => {
+        const { dir, store } = await createTempStore();
+        temps.push(dir);
+        const taskA = await store.createTask({ title: "Alpha", prompt: "Check alpha." });
+        const taskB = await store.createTask({ title: "Beta", prompt: "Check beta." });
+        const onRun = vi.fn();
+        const onTaskComplete = vi.fn();
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            store,
+            onRun,
+            onTaskComplete,
+            defaultPermissions: defaultPermissions(dir)
+        });
+        const result = await scheduler.runNow();
+        expect(result.ran).toBe(2);
+        expect(result.taskIds.sort()).toEqual([taskA.id, taskB.id].sort());
+        expect(onRun).toHaveBeenCalledTimes(1);
+        const [runTasks, runAt] = onRun.mock.calls[0];
+        expect(Array.isArray(runTasks)).toBe(true);
+        expect(runAt).toBeInstanceOf(Date);
+        expect(onTaskComplete).toHaveBeenCalledTimes(2);
+        const refreshed = await store.listTasks();
+        expect(refreshed.every((task) => Boolean(task.lastRunAt))).toBe(true);
+        const [first, ...rest] = refreshed;
+        expect(rest.every((task) => task.lastRunAt === first?.lastRunAt)).toBe(true);
+    });
+    it("filters tasks by id while keeping a single run", async () => {
+        const { dir, store } = await createTempStore();
+        temps.push(dir);
+        const taskA = await store.createTask({ title: "Alpha", prompt: "Check alpha." });
+        await store.createTask({ title: "Beta", prompt: "Check beta." });
+        const onRun = vi.fn();
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            store,
+            onRun,
+            defaultPermissions: defaultPermissions(dir)
+        });
+        const result = await scheduler.runNow([taskA.id]);
+        expect(result.ran).toBe(1);
+        expect(result.taskIds).toEqual([taskA.id]);
+        expect(onRun).toHaveBeenCalledTimes(1);
+        const [runTasks] = onRun.mock.calls[0];
+        expect(Array.isArray(runTasks)).toBe(true);
+        expect(runTasks.map((task) => task.id)).toEqual([taskA.id]);
+    });
+    it("skips gated tasks when gate check denies", async () => {
+        const { dir, store } = await createTempStore();
+        temps.push(dir);
+        await store.createTask({
+            title: "Alpha",
+            prompt: "Check alpha.",
+            gate: { command: "echo gate" }
+        });
+        await store.createTask({ title: "Beta", prompt: "Check beta." });
+        const onRun = vi.fn();
+        const gateCheck = vi.fn().mockResolvedValue({
+            shouldRun: false,
+            exitCode: 1,
+            stdout: "",
+            stderr: ""
+        });
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            store,
+            onRun,
+            gateCheck,
+            defaultPermissions: defaultPermissions(dir)
+        });
+        const result = await scheduler.runNow();
+        expect(gateCheck).toHaveBeenCalledTimes(1);
+        expect(result.ran).toBe(1);
+        expect(result.taskIds).toEqual(["beta"]);
+        expect(onRun).toHaveBeenCalledTimes(1);
+        const [runTasks] = onRun.mock.calls[0];
+        expect(Array.isArray(runTasks)).toBe(true);
+        expect(runTasks.map((task) => task.id)).toEqual(["beta"]);
+    });
+    it("appends gate output to the prompt", async () => {
+        const { dir, store } = await createTempStore();
+        temps.push(dir);
+        await store.createTask({
+            title: "Alpha",
+            prompt: "Base prompt",
+            gate: { command: "echo gate" }
+        });
+        const onRun = vi.fn();
+        const gateCheck = vi.fn().mockResolvedValue({
+            shouldRun: true,
+            exitCode: 0,
+            stdout: " ok ",
+            stderr: ""
+        });
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            store,
+            onRun,
+            gateCheck,
+            defaultPermissions: defaultPermissions(dir)
+        });
+        const result = await scheduler.runNow();
+        expect(result.ran).toBe(1);
+        const [runTasks] = onRun.mock.calls[0];
+        expect(Array.isArray(runTasks)).toBe(true);
+        const task = runTasks[0];
+        expect(task?.prompt).toBe("Base prompt\n\n[Gate output]\nok");
+    });
+});
+//# sourceMappingURL=heartbeatScheduler.spec.js.map

package/dist/engine/heartbeat/ops/heartbeatScheduler.spec.js.map

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

package/dist/engine/heartbeat/ops/heartbeatStore.d.ts

@@ -0,0 +1,25 @@
+import type { HeartbeatDefinition, HeartbeatState, HeartbeatCreateTaskArgs, HeartbeatStoreInterface } from "../heartbeatTypes.js";
+/**
+ * Manages heartbeat tasks stored as markdown files.
+ *
+ * Structure:
+ * - /heartbeat/<task-id>.md - frontmatter (title) + prompt body
+ * - /heartbeat/.heartbeat-state.json - shared state (lastRunAt)
+ */
+export declare class HeartbeatStore implements HeartbeatStoreInterface {
+    private basePath;
+    constructor(basePath: string);
+    ensureDir(): Promise<void>;
+    listTasks(): Promise<HeartbeatDefinition[]>;
+    createTask(definition: HeartbeatCreateTaskArgs): Promise<HeartbeatDefinition>;
+    deleteTask(taskId: string): Promise<boolean>;
+    loadTask(filePath: string, state?: HeartbeatState): Promise<HeartbeatDefinition | null>;
+    recordRun(runAt: Date): Promise<void>;
+    private getStatePath;
+    private getTaskPath;
+    private generateTaskIdFromTitle;
+    private isTaskIdAvailable;
+    private readState;
+    private writeState;
+}
+//# sourceMappingURL=heartbeatStore.d.ts.map

package/dist/engine/heartbeat/ops/heartbeatStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatStore.d.ts","sourceRoot":"","sources":["../../../../sources/engine/heartbeat/ops/heartbeatStore.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAK9B;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,uBAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAItB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,SAAS,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAqB3C,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0C7E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAiCvF,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;YAIL,uBAAuB;YAWvB,iBAAiB;YAajB,SAAS;YAkBT,UAAU;CASzB"}

package/dist/engine/heartbeat/ops/heartbeatStore.js

@@ -0,0 +1,188 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { getLogger } from "../../../log.js";
+import { stringSlugify } from "../../../utils/stringSlugify.js";
+import { taskIdIsSafe } from "../../../utils/taskIdIsSafe.js";
+import { cronFrontmatterParse } from "../../cron/ops/cronFrontmatterParse.js";
+import { cronFrontmatterSerialize } from "../../cron/ops/cronFrontmatterSerialize.js";
+import { heartbeatParse } from "./heartbeatParse.js";
+import { execGateNormalize } from "../../scheduling/execGateNormalize.js";
+const logger = getLogger("heartbeat.store");
+/**
+ * Manages heartbeat tasks stored as markdown files.
+ *
+ * Structure:
+ * - /heartbeat/<task-id>.md - frontmatter (title) + prompt body
+ * - /heartbeat/.heartbeat-state.json - shared state (lastRunAt)
+ */
+export class HeartbeatStore {
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    async ensureDir() {
+        await fs.mkdir(this.basePath, { recursive: true });
+    }
+    async listTasks() {
+        await this.ensureDir();
+        const entries = await fs.readdir(this.basePath, { withFileTypes: true });
+        const tasks = [];
+        const state = await this.readState();
+        for (const entry of entries) {
+            if (!entry.isFile() || !entry.name.toLowerCase().endsWith(".md")) {
+                continue;
+            }
+            const filePath = path.join(this.basePath, entry.name);
+            const task = await this.loadTask(filePath, state);
+            if (task) {
+                tasks.push(task);
+            }
+        }
+        return tasks;
+    }
+    async createTask(definition) {
+        await this.ensureDir();
+        const title = definition.title.trim();
+        const prompt = definition.prompt.trim();
+        if (!title) {
+            throw new Error("Heartbeat title is required.");
+        }
+        if (!prompt) {
+            throw new Error("Heartbeat prompt is required.");
+        }
+        const providedId = definition.id?.trim();
+        if (providedId && !taskIdIsSafe(providedId)) {
+            throw new Error("Heartbeat id contains invalid characters.");
+        }
+        const id = providedId ?? await this.generateTaskIdFromTitle(title);
+        const filePath = this.getTaskPath(id);
+        if (!definition.overwrite) {
+            const available = await this.isTaskIdAvailable(id);
+            if (!available) {
+                throw new Error(`Heartbeat already exists: ${id}`);
+            }
+        }
+        const gate = execGateNormalize(definition.gate);
+        const frontmatter = { title };
+        if (gate) {
+            frontmatter.gate = gate;
+        }
+        const content = cronFrontmatterSerialize(frontmatter, prompt);
+        await fs.writeFile(filePath, content, "utf8");
+        return {
+            id,
+            title,
+            prompt,
+            filePath,
+            gate,
+            lastRunAt: undefined
+        };
+    }
+    async deleteTask(taskId) {
+        if (!taskIdIsSafe(taskId)) {
+            throw new Error("Heartbeat id contains invalid characters.");
+        }
+        const filePath = this.getTaskPath(taskId);
+        try {
+            await fs.unlink(filePath);
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return false;
+            }
+            throw error;
+        }
+        return true;
+    }
+    async loadTask(filePath, state) {
+        try {
+            const content = await fs.readFile(filePath, "utf8");
+            const parsed = cronFrontmatterParse(content);
+            const baseName = path.basename(filePath, path.extname(filePath));
+            const id = stringSlugify(baseName) || baseName;
+            const { title, prompt } = heartbeatParse(parsed.body, parsed.frontmatter, baseName);
+            if (!prompt) {
+                logger.warn({ filePath }, "Heartbeat file missing prompt");
+                return null;
+            }
+            const lastRunAt = state?.lastRunAt;
+            const gate = execGateNormalize(parsed.frontmatter.gate);
+            return {
+                id,
+                title,
+                prompt,
+                filePath,
+                gate,
+                lastRunAt: typeof lastRunAt === "string" ? lastRunAt : undefined
+            };
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return null;
+            }
+            logger.warn({ filePath, error }, "Failed to load heartbeat file");
+            return null;
+        }
+    }
+    async recordRun(runAt) {
+        await this.writeState({ lastRunAt: runAt.toISOString() });
+    }
+    getStatePath() {
+        return path.join(this.basePath, ".heartbeat-state.json");
+    }
+    getTaskPath(taskId) {
+        return path.join(this.basePath, `${taskId}.md`);
+    }
+    async generateTaskIdFromTitle(title) {
+        const base = stringSlugify(title) || "heartbeat";
+        let candidate = base;
+        let suffix = 2;
+        while (!(await this.isTaskIdAvailable(candidate))) {
+            candidate = `${base}-${suffix}`;
+            suffix += 1;
+        }
+        return candidate;
+    }
+    async isTaskIdAvailable(taskId) {
+        const filePath = this.getTaskPath(taskId);
+        try {
+            const stat = await fs.stat(filePath);
+            return !stat.isFile();
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return true;
+            }
+            throw error;
+        }
+    }
+    async readState() {
+        const statePath = this.getStatePath();
+        try {
+            const raw = await fs.readFile(statePath, "utf8");
+            const parsed = JSON.parse(raw);
+            if (!parsed || typeof parsed !== "object") {
+                return {};
+            }
+            return { lastRunAt: typeof parsed.lastRunAt === "string" ? parsed.lastRunAt : undefined };
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return {};
+            }
+            logger.warn({ error }, "Failed to read heartbeat state");
+            return {};
+        }
+    }
+    async writeState(state) {
+        await this.ensureDir();
+        const statePath = this.getStatePath();
+        try {
+            await fs.writeFile(statePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+        }
+        catch (error) {
+            logger.warn({ error }, "Failed to write heartbeat state");
+        }
+    }
+}
+//# sourceMappingURL=heartbeatStore.js.map

package/dist/engine/heartbeat/ops/heartbeatStore.js.map

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

package/dist/engine/heartbeat/ops/heartbeatStore.spec.d.ts

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

package/dist/engine/heartbeat/ops/heartbeatStore.spec.d.ts.map

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

package/dist/engine/heartbeat/ops/heartbeatStore.spec.js

@@ -0,0 +1,30 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { HeartbeatStore } from "./heartbeatStore.js";
+async function createTempStore() {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-heartbeat-store-"));
+    const store = new HeartbeatStore(dir);
+    await store.ensureDir();
+    return { dir, store };
+}
+describe("HeartbeatStore", () => {
+    const temps = [];
+    afterEach(async () => {
+        await Promise.all(temps.map((dir) => fs.rm(dir, { recursive: true, force: true })));
+        temps.length = 0;
+    });
+    it("persists gate permissions on create", async () => {
+        const { dir, store } = await createTempStore();
+        temps.push(dir);
+        await store.createTask({
+            title: "Gate Task",
+            prompt: "Prompt",
+            gate: { command: "echo gate", permissions: ["@network"] }
+        });
+        const tasks = await store.listTasks();
+        expect(tasks[0]?.gate?.permissions).toEqual(["@network"]);
+    });
+});
+//# sourceMappingURL=heartbeatStore.spec.js.map

package/dist/engine/heartbeat/ops/heartbeatStore.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatStore.spec.js","sourceRoot":"","sources":["../../../../sources/engine/heartbeat/ops/heartbeatStore.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,KAAK,UAAU,eAAe;IAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC;AAED,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpF,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEhB,MAAM,KAAK,CAAC,UAAU,CAAC;YACrB,KAAK,EAAE,WAAW;YAClB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE;SAC1D,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}