pi-harness-runtime 1.1.445 → 1.1.447

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

@@ -1,203 +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 { execSync } from "node:child_process";
-import { existsSync, mkdirSync, writeFileSync, unlinkSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-// ScheduledTask duplicated here — see interface.ts for details.
-/**
- * Install systemd user units (runs `systemctl --user`).
- * Must call this once before scheduling.
- */
-export class SystemdAdapter {
-    name = "systemd";
-    /** Per-task unit files live in ~/.config/systemd/user/ */
-    unitDir;
-    installed = false;
-    constructor(unitDir) {
-        this.unitDir = unitDir ?? join(homedir(), ".config", "systemd", "user");
-    }
-    async install() {
-        // Verify systemd user mode is available
-        try {
-            execSync("systemctl --user show-environment >/dev/null 2>&1", {
-                stdio: "pipe",
-            });
-        }
-        catch {
-            throw new Error("[SystemdAdapter] systemd user mode is not available. " +
-                "Ensure systemd is running and $SYSTEMD_RUNTIME_DIRECTORY is set.");
-        }
-        // Ensure unit directory exists
-        if (!existsSync(this.unitDir)) {
-            mkdirSync(this.unitDir, { recursive: true });
-        }
-        // Reload systemd to pick up new units
-        try {
-            execSync("systemctl --user daemon-reload", { stdio: "pipe" });
-        }
-        catch {
-            throw new Error("[SystemdAdapter] Failed to reload systemd daemon");
-        }
-        this.installed = true;
-    }
-    async schedule(task) {
-        if (!this.installed)
-            await this.install();
-        const id = task.id.replace(/[^a-zA-Z0-9_-]/g, "-");
-        const base = `pi-runtime-${id}`;
-        const servicePath = join(this.unitDir, `${base}.service`);
-        const timerPath = join(this.unitDir, `${base}.timer`);
-        const scriptPath = join(this.unitDir, `${base}.sh`);
-        // Build the run script
-        const runScript = [
-            "#!/usr/bin/env bash",
-            `# Generated by pi-harness-runtime — ${new Date().toISOString()}`,
-            "",
-            `PI_HARNESS_TASK_ID="${task.id}" \\`,
-            `PI_HARNESS_WORKER_ID="$(hostname)-$(id -u)" \\`,
-            `PI_HARNESS_RUNTIME_ROOT="${process.env.PI_HARNESS_RUNTIME_ROOT ?? join(homedir(), ".pi", "harness")}" \\`,
-            `exec "${process.env.PI_HARNESS_RUNTIME_ROOT}/bin/run-task.sh" \\`,
-            `  --task-id "${task.id}" \\`,
-            `  --worker-id "$PI_HARNESS_WORKER_ID"`,
-        ].join("\n");
-        // Write script
-        writeFileSync(scriptPath, runScript, { mode: 0o755 });
-        // Service unit: runs the script
-        const service = [
-            "[Unit]",
-            "Description=pi-harness-runtime task: ${task.id}",
-            "[Service]",
-            `ExecStart=${scriptPath}`,
-            "Type=oneshot",
-            "Environment=SYSTEMD_EXEC_PID=$$",
-            "[Install]",
-            "WantedBy=default.target",
-        ].join("\n");
-        // Timer unit: schedules the service
-        const timerContent = [
-            "[Unit]",
-            `Description=pi-harness-runtime schedule: ${task.id}`,
-            "[Timer]",
-            this._toTimerLine(task.schedule),
-            "Persistent=true",
-            "[Install]",
-            "WantedBy=timers.target",
-        ].join("\n");
-        writeFileSync(servicePath, service);
-        writeFileSync(timerPath, timerContent);
-        // Reload and enable
-        try {
-            execSync("systemctl --user daemon-reload", { stdio: "pipe" });
-            execSync(`systemctl --user enable ${base}.timer`, { stdio: "pipe" });
-            execSync(`systemctl --user start ${base}.timer`, { stdio: "pipe" });
-        }
-        catch (e) {
-            const err = e;
-            throw new Error(`[SystemdAdapter] Failed to enable/start ${base}.timer: ${err?.message ?? String(e)}`);
-        }
-    }
-    async unschedule(taskId) {
-        const id = taskId.replace(/[^a-zA-Z0-9_-]/g, "-");
-        const base = `pi-runtime-${id}`;
-        const servicePath = join(this.unitDir, `${base}.service`);
-        const timerPath = join(this.unitDir, `${base}.timer`);
-        const scriptPath = join(this.unitDir, `${base}.sh`);
-        // Stop and disable
-        try {
-            execSync(`systemctl --user stop ${base}.timer`, { stdio: "pipe" });
-            execSync(`systemctl --user disable ${base}.timer`, { stdio: "pipe" });
-        }
-        catch {
-            // Ignore if not running
-        }
-        // Remove files
-        for (const p of [servicePath, timerPath, scriptPath]) {
-            try {
-                if (existsSync(p))
-                    unlinkSync(p);
-            }
-            catch {
-                // Ignore cleanup errors
-            }
-        }
-        try {
-            execSync("systemctl --user daemon-reload", { stdio: "pipe" });
-        }
-        catch {
-            // Ignore
-        }
-    }
-    async listScheduled() {
-        try {
-            const out = execSync("systemctl --user list-timers --all --no-legend --output json 2>/dev/null | grep pi-runtime- || true", { encoding: "utf8" });
-            if (!out.trim())
-                return [];
-            let timers = [];
-            try {
-                timers = JSON.parse(out.trim());
-            }
-            catch {
-                return [];
-            }
-            return timers
-                .filter((t) => t.Unit?.startsWith("pi-runtime-"))
-                .map((t) => {
-                const id = (t.Unit ?? "").replace(/^pi-runtime-(.+)\.timer$/, "$1");
-                return {
-                    id,
-                    taskTemplate: {},
-                    schedule: { kind: "interval", intervalMs: 0 },
-                    enabled: true,
-                };
-            });
-        }
-        catch {
-            return [];
-        }
-    }
-    /** Convert a schedule to a systemd.timer OnCalendar or OnUnitActiveSec line. */
-    _toTimerLine(schedule) {
-        if (schedule.kind === "cron") {
-            // Convert cron to systemd calendar format
-            const parts = schedule.expression.trim().split(/\s+/);
-            if (parts.length >= 5) {
-                const [min, hour, dom, month] = parts;
-                return `OnCalendar=${dom}.${month}.* ${hour}:${min.padStart(2, "0")}`;
-            }
-            return `OnCalendar=${schedule.expression}`;
-        }
-        if (schedule.kind === "interval") {
-            const sec = Math.round(schedule.intervalMs / 1000);
-            if (sec >= 86400)
-                return `OnUnitActiveSec=${Math.round(sec / 86400)}d`;
-            if (sec >= 3600)
-                return `OnUnitActiveSec=${Math.round(sec / 3600)}h`;
-            if (sec >= 60)
-                return `OnUnitActiveSec=${Math.round(sec / 60)}min`;
-            return `OnUnitActiveSec=${sec}s`;
-        }
-        if (schedule.kind === "once") {
-            return `OnCalendar=${new Date(schedule.at).toISOString().split("T").join(" ")}`;
-        }
-        return "OnUnitActiveSec=1h"; // fallback
-    }
-    async healthCheck() {
-        try {
-            execSync("systemctl --user show-environment >/dev/null 2>&1", {
-                stdio: "pipe",
-            });
-            return { healthy: true };
-        }
-        catch {
-            return { healthy: false, error: "systemd user mode not available" };
-        }
-    }
-}
-//# sourceMappingURL=systemd.js.map

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

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

package/packages/scheduler-adapter/package.json

@@ -1,32 +0,0 @@
-{
-  "name": "@pi/scheduler-adapter",
-  "version": "1.1.445",
-  "description": "Scheduler Adapter — cron, systemd, launchd, internal adapters for autonomous runtime (RFC-0101 §6)",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.js",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.js"
-    }
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "bun test",
-    "clean": "rm -rf dist"
-  },
-  "keywords": [
-    "scheduler",
-    "cron",
-    "systemd",
-    "launchd",
-    "rfc-0101"
-  ],
-  "author": "",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^20.11.0",
-    "typescript": "^7.0.2"
-  }
-}

package/packages/scheduler-adapter/src/cron.ts

@@ -1,123 +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";
-import type { SchedulerAdapter } from "./interface.js";
-import type { ScheduledTask } from "./interface.js";
-
-export class CronAdapter implements SchedulerAdapter {
-	readonly name = "cron" as const;
-	private readonly runtimeBin: string;
-
-	constructor(options: { runtimeBin?: string } = {}) {
-		this.runtimeBin = options.runtimeBin ?? "/usr/local/bin/pi-harness-runtime";
-	}
-
-	async install(): Promise<void> {
-		// 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: ScheduledTask): Promise<void> {
-		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: string): Promise<void> {
-		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(): Promise<ScheduledTask[]> {
-		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" as const, expression: "" },
-					enabled: true,
-				} as unknown as ScheduledTask;
-			});
-	}
-
-	async healthCheck(): Promise<{ healthy: boolean; error?: string }> {
-		try {
-			execSync("crontab -l >/dev/null 2>&1", { stdio: "pipe" });
-			return { healthy: true };
-		} catch {
-			return { healthy: false, error: "crontab not accessible" };
-		}
-	}
-
-	private _getCrontab(): string[] {
-		try {
-			const out = execSync("crontab -l 2>/dev/null", { encoding: "utf8" });
-			return out.split("\n").filter((l) => l.trim());
-		} catch {
-			return [];
-		}
-	}
-
-	private _setCrontab(content: string): void {
-		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 */
-			}
-		}
-	}
-
-	private _toCronExpr(task: ScheduledTask): string {
-		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 "* * * * *";
-	}
-}

package/packages/scheduler-adapter/src/index.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";

package/packages/scheduler-adapter/src/interface.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.
- */
-// ScheduledTask duplicated here to avoid cross-package import resolution issues
-// in the workspace. Replace with:
-//   import type { ScheduledTask } from "@pi/autonomous-runtime";
-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 }>;
-}

package/packages/scheduler-adapter/src/internal.ts

@@ -1,99 +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";
-
-interface InternalTask {
-	task: ScheduledTask;
-	timerId: ReturnType<typeof setTimeout>;
-	createdAt: Date;
-}
-
-export class InternalAdapter implements SchedulerAdapter {
-	readonly name = "internal" as const;
-
-	private tasks = new Map<string, InternalTask>();
-	private handlers = new Map<string, (task: ScheduledTask) => unknown>();
-
-	async install(): Promise<void> {
-		// Nothing to install for in-process scheduling
-	}
-
-	async healthCheck(): Promise<{ healthy: boolean; error?: string }> {
-		return { healthy: true };
-	}
-
-	/**
-	 * Register a task handler before scheduling.
-	 * The adapter calls `handler(task)` when the task fires.
-	 */
-	setHandler(handler: (task: ScheduledTask) => unknown): void {
-		this.handlers.set("default", handler);
-	}
-
-	async schedule(task: ScheduledTask): Promise<void> {
-		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: number;
-		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 = (): void => {
-			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: string): Promise<void> {
-		const t = this.tasks.get(taskId);
-		if (t) {
-			clearTimeout(t.timerId);
-			this.tasks.delete(taskId);
-		}
-	}
-
-	async listScheduled(): Promise<ScheduledTask[]> {
-		return Array.from(this.tasks.values()).map((t) => t.task);
-	}
-
-	/** Fire a task immediately (useful for testing). */
-	fireNow(taskId: string): void {
-		const t = this.tasks.get(taskId);
-		if (!t) return;
-		const handler = this.handlers.get("default");
-		if (handler) handler(t.task);
-	}
-}