pi-harness-runtime 0.10.7 → 0.10.11

package/packages/scheduler/test/scheduler.test.ts

@@ -1,125 +0,0 @@
-/**
- * Scheduler Tests
- */
-
-import { describe, it, expect, beforeEach } from "bun:test";
-import { mkdirSync, rmSync } from "node:fs";
-import { join } from "node:path";
-import { JsonRuntimeScheduler } from "../src/scheduler";
-
-const TMP = join(process.cwd(), ".test-scheduler-tmp");
-
-function scheduler(): JsonRuntimeScheduler {
-	return new JsonRuntimeScheduler(TMP);
-}
-
-beforeEach(() => {
-	rmSync(TMP, { force: true, recursive: true });
-	mkdirSync(TMP, { recursive: true });
-});
-
-describe("JsonRuntimeScheduler", () => {
-	describe("scheduleResume", () => {
-		it("writes a job to schedule.json", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-1", "2025-01-01T12:00:00Z", "test reason");
-			const jobs = await s.readAll();
-			expect(jobs).toHaveLength(1);
-			expect(jobs[0].jobId).toBe("job-1");
-			expect(jobs[0].status).toBe("scheduled");
-			expect(jobs[0].reason).toBe("test reason");
-		});
-
-		it("overwrites existing job with same ID", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-1", "2025-01-01T12:00:00Z", "reason A");
-			await s.scheduleResume("job-1", "2025-01-02T12:00:00Z", "reason B");
-			const jobs = await s.readAll();
-			expect(jobs).toHaveLength(1);
-			expect(jobs[0].reason).toBe("reason B");
-		});
-
-		it("keeps separate jobs distinct", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-A", "2025-01-01T12:00:00Z", "reason A");
-			await s.scheduleResume("job-B", "2025-01-02T12:00:00Z", "reason B");
-			const jobs = await s.readAll();
-			expect(jobs).toHaveLength(2);
-		});
-	});
-
-	describe("dueJobs", () => {
-		it("returns empty when nothing is due", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-1", "2099-12-31T23:59:59Z", "far future");
-			const due = await s.dueJobs(new Date("2025-01-01"));
-			expect(due).toHaveLength(0);
-		});
-
-		it("returns job when resumeAt has passed", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-1", "2024-01-01T12:00:00Z", "past");
-			const due = await s.dueJobs(new Date("2025-01-01"));
-			expect(due).toEqual(["job-1"]);
-		});
-
-		it("skips cancelled jobs", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-1", "2024-01-01T12:00:00Z", "cancelled");
-			await s.cancel("job-1");
-			const due = await s.dueJobs(new Date("2025-01-01"));
-			expect(due).toHaveLength(0);
-		});
-
-		it("returns multiple due jobs", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-A", "2024-01-01T12:00:00Z", "A");
-			await s.scheduleResume("job-B", "2024-01-02T12:00:00Z", "B");
-			await s.cancel("job-A");
-			const due = await s.dueJobs(new Date("2025-01-01"));
-			expect(due).toEqual(["job-B"]);
-		});
-
-		it("ignores resumeAt in the future", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-future", "2099-01-01T00:00:00Z", "too late");
-			const due = await s.dueJobs(new Date("2025-06-15"));
-			expect(due).toHaveLength(0);
-		});
-	});
-
-	describe("cancel", () => {
-		it("sets status to cancelled", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-1", "2024-01-01T00:00:00Z", "to cancel");
-			await s.cancel("job-1");
-			const jobs = await s.readAll();
-			expect(jobs).toHaveLength(1);
-			expect(jobs[0].status).toBe("cancelled");
-		});
-
-		it("no-op for unknown job", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-1", "2024-01-01T00:00:00Z", "exists");
-			await s.cancel("nonexistent");
-			const jobs = await s.readAll();
-			expect(jobs).toHaveLength(1);
-		});
-
-		it("cancelled job not returned by dueJobs", async () => {
-			const s = scheduler();
-			await s.scheduleResume("job-1", "2020-01-01T00:00:00Z", "was due");
-			await s.cancel("job-1");
-			const due = await s.dueJobs(new Date("2025-01-01"));
-			expect(due).toHaveLength(0);
-		});
-	});
-
-	describe("readAll", () => {
-		it("returns empty array for missing file", async () => {
-			const s = scheduler();
-			const jobs = await s.readAll();
-			expect(jobs).toEqual([]);
-		});
-	});
-});

package/packages/scheduler-adapter/README.md

@@ -1,36 +0,0 @@
-# Scheduler Adapter
-
-Pluggable scheduling backend for pi-harness-runtime.
-
-## Backends
-
-| Backend | File | When to use |
-|---|---|---|
-| Internal (in-process) | `internal.ts` | Local dev, testing, no system deps |
-| Cron | `cron.ts` | Linux/macOS with cron |
-| systemd | `systemd.ts` | Linux with systemd (recommended for autonomous) |
-
-## Usage
-
-```typescript
-import { SystemdAdapter } from "./index.js";
-
-const scheduler = new SystemdAdapter();
-await scheduler.install();
-await scheduler.schedule({
-  id: "nightly-compact",
-  taskTemplate: { kind: "compact" },
-  schedule: { kind: "cron", expression: "0 3 * * *" },
-});
-```
-
-## Adapter Interface
-
-```typescript
-interface SchedulerAdapter {
-  install(): Promise<void>;
-  schedule(task: ScheduledTask): Promise<void>;
-  unschedule(taskId: string): Promise<void>;
-  listScheduled(): Promise<ScheduledTask[]>;
-}
-```

package/packages/scheduler-adapter/dist/cron.d.ts

@@ -1,21 +0,0 @@
-import type { SchedulerAdapter } from "./interface.js";
-import type { ScheduledTask } from "./interface.js";
-export declare class CronAdapter implements SchedulerAdapter {
-    readonly name: "cron";
-    private readonly runtimeBin;
-    constructor(options?: {
-        runtimeBin?: string;
-    });
-    install(): Promise<void>;
-    schedule(task: ScheduledTask): Promise<void>;
-    unschedule(taskId: string): Promise<void>;
-    listScheduled(): Promise<ScheduledTask[]>;
-    healthCheck(): Promise<{
-        healthy: boolean;
-        error?: string;
-    }>;
-    private _getCrontab;
-    private _setCrontab;
-    private _toCronExpr;
-}
-//# sourceMappingURL=cron.d.ts.map

package/packages/scheduler-adapter/dist/cron.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../src/cron.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,qBAAa,WAAY,YAAW,gBAAgB;IACnD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,YAAY,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,EAEhD;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAO7B;IAEK,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjD;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9C;IAEK,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAa9C;IAEK,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAOjE;IAED,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,WAAW;CAenB"}

package/packages/scheduler-adapter/dist/cron.js

@@ -1,116 +0,0 @@
-/**
- * Cron Scheduler Adapter — RFC-0101 §6
- *
- * Writes crontab entries for scheduled tasks.
- * Entries are managed via a marker block so unschedule() is clean.
- */
-import { execSync } from "node:child_process";
-import { writeFileSync, unlinkSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-export class CronAdapter {
-    name = "cron";
-    runtimeBin;
-    constructor(options = {}) {
-        this.runtimeBin = options.runtimeBin ?? "/usr/local/bin/pi-harness-runtime";
-    }
-    async install() {
-        // Idempotent — verify cron is available
-        try {
-            execSync("crontab -l >/dev/null 2>&1", { stdio: "pipe" });
-        }
-        catch {
-            // No existing crontab — that's fine
-        }
-    }
-    async schedule(task) {
-        const cronExpr = this._toCronExpr(task);
-        const marker = `# PI-HARNESS-RUNTIME: ${task.id}`;
-        const line = `${cronExpr} ${this.runtimeBin} run-scheduled --task-id ${task.id}`;
-        const existing = this._getCrontab();
-        // Remove any existing entry for this task
-        const cleaned = existing.filter((l) => !l.includes(`PI-HARNESS-RUNTIME: ${task.id}`));
-        const updated = [...cleaned, marker, line].join("\n") + "\n";
-        this._setCrontab(updated);
-    }
-    async unschedule(taskId) {
-        const existing = this._getCrontab();
-        const cleaned = existing.filter((l) => !l.includes(`PI-HARNESS-RUNTIME: ${taskId}`));
-        if (cleaned.length === 0) {
-            try {
-                execSync("crontab -r 2>/dev/null", { stdio: "pipe" });
-            }
-            catch {
-                // No crontab to remove — that's fine
-            }
-        }
-        else {
-            this._setCrontab(cleaned.join("\n") + "\n");
-        }
-    }
-    async listScheduled() {
-        const lines = this._getCrontab();
-        return lines
-            .filter((l) => l.includes("PI-HARNESS-RUNTIME: "))
-            .map((l) => {
-            const match = l.match(/PI-HARNESS-RUNTIME: ([\w-]+)/);
-            return {
-                id: match?.[1] ?? "unknown",
-                taskTemplate: {},
-                schedule: { kind: "cron", expression: "" },
-                enabled: true,
-            };
-        });
-    }
-    async healthCheck() {
-        try {
-            execSync("crontab -l >/dev/null 2>&1", { stdio: "pipe" });
-            return { healthy: true };
-        }
-        catch {
-            return { healthy: false, error: "crontab not accessible" };
-        }
-    }
-    _getCrontab() {
-        try {
-            const out = execSync("crontab -l 2>/dev/null", { encoding: "utf8" });
-            return out.split("\n").filter((l) => l.trim());
-        }
-        catch {
-            return [];
-        }
-    }
-    _setCrontab(content) {
-        const tmpFile = join(tmpdir(), `pi-harness-cron-${Date.now()}.tmp`);
-        try {
-            writeFileSync(tmpFile, content);
-            execSync(`crontab "${tmpFile}"`, { stdio: "pipe" });
-        }
-        finally {
-            try {
-                unlinkSync(tmpFile);
-            }
-            catch {
-                /* ignore */
-            }
-        }
-    }
-    _toCronExpr(task) {
-        if (task.schedule.kind === "cron")
-            return task.schedule.expression;
-        if (task.schedule.kind === "interval") {
-            const ms = task.schedule.intervalMs;
-            const minutes = Math.round(ms / 60_000);
-            if (minutes < 60)
-                return `*/${minutes} * * * *`;
-            const hours = Math.round(ms / 3_600_000);
-            return `${minutes % 60} */${hours} * * *`;
-        }
-        if (task.schedule.kind === "once") {
-            const d = new Date(task.schedule.at);
-            return `${d.getUTCMinutes()} ${d.getUTCHours()} ${d.getUTCDate()} ${d.getUTCMonth() + 1} *`;
-        }
-        return "* * * * *";
-    }
-}
-//# sourceMappingURL=cron.js.map

package/packages/scheduler-adapter/dist/cron.js.map

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

package/packages/scheduler-adapter/dist/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * Scheduler Adapter Package — Barrel
- * RFC-0101 §6
- */
-export type { SchedulerAdapter, ScheduledTask } from "./interface.js";
-export { CronAdapter } from "./cron.js";
-export { SystemdAdapter } from "./systemd.js";
-export { InternalAdapter } from "./internal.js";
-//# sourceMappingURL=index.d.ts.map

package/packages/scheduler-adapter/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/packages/scheduler-adapter/dist/index.js

@@ -1,8 +0,0 @@
-/**
- * Scheduler Adapter Package — Barrel
- * RFC-0101 §6
- */
-export { CronAdapter } from "./cron.js";
-export { SystemdAdapter } from "./systemd.js";
-export { InternalAdapter } from "./internal.js";
-//# sourceMappingURL=index.js.map

package/packages/scheduler-adapter/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/packages/scheduler-adapter/dist/interface.d.ts

@@ -1,61 +0,0 @@
-/**
- * Scheduler Adapter — Common Interface
- * RFC-0101 §6
- *
- * All scheduler adapters implement this interface.
- * The runtime selects an adapter at install time and uses it for all scheduled tasks.
- */
-export type ScheduledTask = {
-    id: string;
-    taskTemplate: Record<string, unknown>;
-    schedule: {
-        kind: "cron";
-        expression: string;
-    } | {
-        kind: "interval";
-        intervalMs: number;
-    } | {
-        kind: "once";
-        at: string;
-    };
-    enabled: boolean;
-    lastFiredAt?: string;
-    nextFireAt?: string;
-};
-/**
- * Supported scheduler adapter backends.
- * Set at install time; can be changed via config.
- */
-export type SchedulerAdapterKind = "systemd" | "cron" | "launchd" | "internal";
-export interface SchedulerAdapter {
-    /** Human-readable name. */
-    readonly name: SchedulerAdapterKind;
-    /**
-     * Install the scheduler adapter.
-     * Idempotent — re-running does not duplicate units.
-     * @throws if installation fails (e.g. no systemd on this system)
-     */
-    install(): Promise<void>;
-    /**
-     * Schedule a task. Installs the timer/unit if not yet installed.
-     * @param task The scheduled task to materialise
-     */
-    schedule(task: ScheduledTask): Promise<void>;
-    /**
-     * Remove a scheduled task.
-     * @param taskId The id of the task to unschedule
-     */
-    unschedule(taskId: string): Promise<void>;
-    /**
-     * List all scheduled tasks currently installed by this adapter.
-     */
-    listScheduled(): Promise<ScheduledTask[]>;
-    /**
-     * Check if the adapter is healthy (e.g. systemd is running).
-     */
-    healthCheck(): Promise<{
-        healthy: boolean;
-        error?: string;
-    }>;
-}
-//# sourceMappingURL=interface.d.ts.map

package/packages/scheduler-adapter/dist/interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,aAAa,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,EACL;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACpC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACxC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAEpC;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE1C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D"}

package/packages/scheduler-adapter/dist/interface.js

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

package/packages/scheduler-adapter/dist/interface.js.map

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

package/packages/scheduler-adapter/dist/internal.d.ts

@@ -1,30 +0,0 @@
-/**
- * Scheduler Adapter — Internal (In-Process) Backend
- * RFC-0101 §6
- *
- * Uses in-process setTimeout / setInterval for scheduling.
- * Useful for testing, local development, and environments where
- * systemd/cron are not available.
- */
-import type { SchedulerAdapter, ScheduledTask } from "./interface.js";
-export declare class InternalAdapter implements SchedulerAdapter {
-    readonly name: "internal";
-    private tasks;
-    private handlers;
-    install(): Promise<void>;
-    healthCheck(): Promise<{
-        healthy: boolean;
-        error?: string;
-    }>;
-    /**
-     * Register a task handler before scheduling.
-     * The adapter calls `handler(task)` when the task fires.
-     */
-    setHandler(handler: (task: ScheduledTask) => unknown): void;
-    schedule(task: ScheduledTask): Promise<void>;
-    unschedule(taskId: string): Promise<void>;
-    listScheduled(): Promise<ScheduledTask[]>;
-    /** Fire a task immediately (useful for testing). */
-    fireNow(taskId: string): void;
-}
-//# sourceMappingURL=internal.d.ts.map

package/packages/scheduler-adapter/dist/internal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQtE,qBAAa,eAAgB,YAAW,gBAAgB;IACvD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAEpC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,QAAQ,CAAuD;IAEjE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7B;IAEK,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAEjE;IAED;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,GAAG,IAAI,CAE1D;IAEK,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCjD;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9C;IAEK,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAE9C;IAED,oDAAoD;IACpD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAK5B;CACD"}

package/packages/scheduler-adapter/dist/internal.js

@@ -1,82 +0,0 @@
-/**
- * Scheduler Adapter — Internal (In-Process) Backend
- * RFC-0101 §6
- *
- * Uses in-process setTimeout / setInterval for scheduling.
- * Useful for testing, local development, and environments where
- * systemd/cron are not available.
- */
-export class InternalAdapter {
-    name = "internal";
-    tasks = new Map();
-    handlers = new Map();
-    async install() {
-        // Nothing to install for in-process scheduling
-    }
-    async healthCheck() {
-        return { healthy: true };
-    }
-    /**
-     * Register a task handler before scheduling.
-     * The adapter calls `handler(task)` when the task fires.
-     */
-    setHandler(handler) {
-        this.handlers.set("default", handler);
-    }
-    async schedule(task) {
-        if (this.tasks.has(task.id)) {
-            await this.unschedule(task.id);
-        }
-        const handler = this.handlers.get("default");
-        if (!handler) {
-            throw new Error("[InternalAdapter] No task handler registered. Call setHandler() first.");
-        }
-        if (!task.enabled)
-            return; // skip disabled tasks
-        let delayMs;
-        if (task.schedule.kind === "once") {
-            delayMs = new Date(task.schedule.at).getTime() - Date.now();
-        }
-        else if (task.schedule.kind === "interval") {
-            delayMs = task.schedule.intervalMs;
-        }
-        else {
-            // cron — resolve to next occurrence (simplified: 1h from now)
-            delayMs = 3_600_000;
-        }
-        if (delayMs <= 0)
-            delayMs = 1000;
-        const tick = () => {
-            const t = this.tasks.get(task.id);
-            if (!t)
-                return;
-            handler(task);
-            // Re-schedule if interval
-            if (task.schedule.kind === "interval") {
-                t.timerId = setTimeout(tick, task.schedule.intervalMs);
-            }
-        };
-        const timerId = setTimeout(tick, delayMs);
-        this.tasks.set(task.id, { task, timerId, createdAt: new Date() });
-    }
-    async unschedule(taskId) {
-        const t = this.tasks.get(taskId);
-        if (t) {
-            clearTimeout(t.timerId);
-            this.tasks.delete(taskId);
-        }
-    }
-    async listScheduled() {
-        return Array.from(this.tasks.values()).map((t) => t.task);
-    }
-    /** Fire a task immediately (useful for testing). */
-    fireNow(taskId) {
-        const t = this.tasks.get(taskId);
-        if (!t)
-            return;
-        const handler = this.handlers.get("default");
-        if (handler)
-            handler(t.task);
-    }
-}
-//# sourceMappingURL=internal.js.map

package/packages/scheduler-adapter/dist/internal.js.map

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

package/packages/scheduler-adapter/dist/systemd.d.ts

@@ -1,31 +0,0 @@
-/**
- * Scheduler Adapter — systemd Backend
- * RFC-0101 §6
- *
- * Uses systemd user timers as the scheduling backend.
- * Each scheduled task becomes a .timer + .service unit pair.
- * Works on any Linux system with systemd (no root required for user units).
- */
-import type { SchedulerAdapter, ScheduledTask } from "./interface.js";
-/**
- * Install systemd user units (runs `systemctl --user`).
- * Must call this once before scheduling.
- */
-export declare class SystemdAdapter implements SchedulerAdapter {
-    readonly name: "systemd";
-    /** Per-task unit files live in ~/.config/systemd/user/ */
-    private readonly unitDir;
-    private installed;
-    constructor(unitDir?: string);
-    install(): Promise<void>;
-    schedule(task: ScheduledTask): Promise<void>;
-    unschedule(taskId: string): Promise<void>;
-    listScheduled(): Promise<ScheduledTask[]>;
-    /** Convert a schedule to a systemd.timer OnCalendar or OnUnitActiveSec line. */
-    private _toTimerLine;
-    healthCheck(): Promise<{
-        healthy: boolean;
-        error?: string;
-    }>;
-}
-//# sourceMappingURL=systemd.d.ts.map

package/packages/scheduler-adapter/dist/systemd.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"systemd.d.ts","sourceRoot":"","sources":["../src/systemd.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAItE;;;GAGG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IACtD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;IAE1B,YAAY,OAAO,CAAC,EAAE,MAAM,EAE3B;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA0B7B;IAEK,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DjD;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B9C;IAEK,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CA8B9C;IAED,gFAAgF;IAChF,OAAO,CAAC,YAAY;IAuBd,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CASjE;CACD"}