create-metaclaw 3.3.0

package/installer/templates/cron-manager.ts.txt

@@ -0,0 +1,273 @@
+/**
+ * MetaClaw Cron Manager — manages scheduled tasks
+ * Auto-generated by MetaClaw Installer
+ *
+ * Handles:
+ * - Setting up initial crons (self-update, dashboard refresh, health check)
+ * - Listing active crons
+ * - Rescheduling crons
+ * - Removing crons
+ * - Health monitoring of cron execution
+ *
+ * Uses Windows Task Scheduler (schtasks) with proper error handling.
+ * All tasks use .bat wrappers for PATH reliability.
+ */
+
+import { execSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { getDb, getConfig, setConfig } from "./db.js";
+import { log } from "./observability.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PROJECT_DIR = path.join(__dirname, "..");
+const SCRIPTS_DIR = path.join(PROJECT_DIR, "scripts");
+const AGENT_NAME = "__AGENT_NAME__";
+const SESSION_NAME = "__SESSION_NAME__";
+
+// Task prefix for all MetaClaw tasks
+const TASK_PREFIX = `MetaClaw-${SESSION_NAME}`;
+
+export type CronTask = {
+  name: string;
+  script: string;
+  intervalMinutes: number;
+  description: string;
+  businessHoursOnly: boolean;
+};
+
+// Default cron tasks every agent gets
+export const DEFAULT_CRONS: CronTask[] = [
+  {
+    name: "SelfUpdate",
+    script: "src/self-update.ts",
+    intervalMinutes: __SELF_UPDATE_INTERVAL__,
+    description: "Self-improvement cycle (dashboard, prompts, logs, metrics)",
+    businessHoursOnly: false,
+  },
+  {
+    name: "DashboardRefresh",
+    script: "src/update-dashboard.ts",
+    intervalMinutes: 5,
+    description: "Refresh dashboard data",
+    businessHoursOnly: false,
+  },
+  {
+    name: "HealthCheck",
+    script: "src/health-check.ts",
+    intervalMinutes: 60,
+    description: "System health check (circuit breakers, disk, errors)",
+    businessHoursOnly: false,
+  },
+];
+
+/**
+ * Create a .bat wrapper for a task (needed for schtasks PATH reliability).
+ */
+function createBatWrapper(task: CronTask): string {
+  const batPath = path.join(SCRIPTS_DIR, `${task.name.toLowerCase()}.bat`);
+  const logPath = path.join(PROJECT_DIR, "data", "logs", `${task.name.toLowerCase()}.log`);
+
+  // Critical: Task Scheduler runs with minimal PATH — must set explicitly
+  const content = [
+    "@echo off",
+    `setlocal`,
+    `set PATH=C:\\Program Files\\nodejs;%USERPROFILE%\\AppData\\Roaming\\npm;%USERPROFILE%\\.local\\bin;%PATH%`,
+    `cd /d "${PROJECT_DIR}"`,
+    `echo [%DATE% %TIME%] Running ${task.name} >> "${logPath}"`,
+    `call npx tsx ${task.script} >> "${logPath}" 2>&1`,
+    `echo [%DATE% %TIME%] ${task.name} complete (exit: %ERRORLEVEL%) >> "${logPath}"`,
+  ].join("\r\n");
+
+  fs.mkdirSync(SCRIPTS_DIR, { recursive: true });
+  fs.writeFileSync(batPath, content);
+  return batPath;
+}
+
+/**
+ * Register a task with Windows Task Scheduler.
+ * Falls back gracefully if admin not available.
+ */
+function registerTask(task: CronTask): { success: boolean; method: string; error?: string } {
+  const batPath = createBatWrapper(task);
+  const taskName = `${TASK_PREFIX}-${task.name}`;
+
+  // Build schtasks command
+  let schedArgs: string;
+  if (task.businessHoursOnly) {
+    schedArgs = `/sc MINUTE /mo ${task.intervalMinutes} /st 08:00 /et 18:00`;
+  } else {
+    schedArgs = `/sc MINUTE /mo ${task.intervalMinutes}`;
+  }
+
+  // Try Task Scheduler first
+  try {
+    execSync(
+      `schtasks /create /tn "${taskName}" /tr "\\"${batPath}\\"" ${schedArgs} /ru "%USERNAME%" /f`,
+      { stdio: "pipe", timeout: 10000 }
+    );
+    log("info", "cron.registered", { task: taskName, method: "schtasks", interval: task.intervalMinutes });
+    return { success: true, method: "schtasks" };
+  } catch {
+    // Task Scheduler failed (likely needs admin)
+  }
+
+  // Fallback: save to config for self-update to handle
+  try {
+    const cronConfig = JSON.parse(getConfig("cron_tasks") || "[]");
+    cronConfig.push({
+      name: task.name,
+      script: task.script,
+      intervalMinutes: task.intervalMinutes,
+      lastRun: null,
+    });
+    setConfig("cron_tasks", JSON.stringify(cronConfig));
+    log("info", "cron.registered", { task: task.name, method: "config_fallback", interval: task.intervalMinutes });
+    return { success: true, method: "config_fallback" };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { success: false, method: "failed", error: msg };
+  }
+}
+
+/**
+ * Set up all default cron tasks.
+ */
+export function setupDefaultCrons(): { registered: number; failed: number; method: string } {
+  let registered = 0;
+  let failed = 0;
+  let method = "";
+
+  for (const task of DEFAULT_CRONS) {
+    const result = registerTask(task);
+    if (result.success) {
+      registered++;
+      method = result.method;
+    } else {
+      failed++;
+    }
+  }
+
+  setConfig("crons_initialized", "true");
+  setConfig("crons_method", method);
+  return { registered, failed, method };
+}
+
+/**
+ * List all MetaClaw scheduled tasks.
+ */
+export function listCrons(): Array<{ name: string; status: string; nextRun: string }> {
+  const tasks: Array<{ name: string; status: string; nextRun: string }> = [];
+
+  try {
+    const output = execSync(
+      `schtasks /query /fo CSV /nh 2>nul | findstr "${TASK_PREFIX}"`,
+      { encoding: "utf-8", timeout: 5000 }
+    );
+    const lines = output.trim().split("\n").filter(Boolean);
+    for (const line of lines) {
+      const parts = line.split('","').map(s => s.replace(/"/g, ""));
+      if (parts.length >= 3) {
+        tasks.push({ name: parts[0], nextRun: parts[1], status: parts[2] });
+      }
+    }
+  } catch {
+    // No tasks found or schtasks not available
+  }
+
+  // Also check config fallback
+  try {
+    const cronConfig = JSON.parse(getConfig("cron_tasks") || "[]");
+    for (const c of cronConfig) {
+      if (!tasks.some(t => t.name.includes(c.name))) {
+        tasks.push({
+          name: `${TASK_PREFIX}-${c.name} (managed by self-update)`,
+          nextRun: c.lastRun ? `Last: ${c.lastRun}` : "Pending",
+          status: "Active (config)",
+        });
+      }
+    }
+  } catch {}
+
+  return tasks;
+}
+
+/**
+ * Remove a MetaClaw scheduled task.
+ */
+export function removeCron(taskName: string): boolean {
+  const fullName = taskName.startsWith(TASK_PREFIX) ? taskName : `${TASK_PREFIX}-${taskName}`;
+  try {
+    execSync(`schtasks /delete /tn "${fullName}" /f`, { stdio: "pipe", timeout: 5000 });
+    log("info", "cron.removed", { task: fullName });
+    return true;
+  } catch {
+    // Try removing from config
+    try {
+      const cronConfig = JSON.parse(getConfig("cron_tasks") || "[]");
+      const filtered = cronConfig.filter((c: any) => !fullName.includes(c.name));
+      setConfig("cron_tasks", JSON.stringify(filtered));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+
+/**
+ * Run any config-based crons that are due (called by self-update).
+ */
+export function runDueCrons(): number {
+  let ran = 0;
+  try {
+    const cronConfig = JSON.parse(getConfig("cron_tasks") || "[]");
+    const now = Date.now();
+
+    for (const c of cronConfig) {
+      const lastRun = c.lastRun ? new Date(c.lastRun).getTime() : 0;
+      const intervalMs = c.intervalMinutes * 60 * 1000;
+
+      if (now - lastRun >= intervalMs) {
+        try {
+          execSync(`npx tsx ${c.script}`, { cwd: PROJECT_DIR, stdio: "pipe", timeout: 60000 });
+          c.lastRun = new Date().toISOString();
+          ran++;
+        } catch (err) {
+          log("error", "cron.run_failed", { task: c.name, error: String(err) });
+        }
+      }
+    }
+
+    setConfig("cron_tasks", JSON.stringify(cronConfig));
+  } catch {}
+  return ran;
+}
+
+// --- CLI ---
+if (process.argv[1]?.includes("cron-manager")) {
+  getDb();
+  const cmd = process.argv[2];
+
+  if (cmd === "setup") {
+    console.log("Setting up default cron tasks...\n");
+    const result = setupDefaultCrons();
+    console.log(`Registered: ${result.registered}, Failed: ${result.failed}`);
+    console.log(`Method: ${result.method}`);
+  } else if (cmd === "list") {
+    const tasks = listCrons();
+    console.log("Active cron tasks:\n");
+    for (const t of tasks) {
+      console.log(`  ${t.name}`);
+      console.log(`    Next: ${t.nextRun} | Status: ${t.status}`);
+    }
+    if (tasks.length === 0) console.log("  No tasks found. Run: npm run crons setup");
+  } else if (cmd === "remove" && process.argv[3]) {
+    removeCron(process.argv[3]) ? console.log("Removed.") : console.log("Not found.");
+  } else {
+    console.log("Cron Manager — MetaClaw");
+    console.log("  npm run crons setup    — set up default crons");
+    console.log("  npm run crons list     — list active crons");
+    console.log("  npm run crons remove <name> — remove a cron");
+  }
+}