daemora 1.0.0-alpha.0

package/dist/scheduler/GoalPulse.js

@@ -0,0 +1,123 @@
+/**
+ * GoalPulse — periodic autonomous goal execution.
+ *
+ * Every 60 s, checks for active goals whose `checkCron` indicates they
+ * are due, enqueues them as tasks via the TaskRunner, and records
+ * progress. Consecutive failures (≥ 3 by default) auto-pause a goal.
+ *
+ * Goals without a `checkCron` are left alone — they're manually tracked.
+ */
+import { nextFire, parseCron } from "../cron/cronParser.js";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("goal-pulse");
+const TICK_MS = 60_000;
+const DEFAULT_MAX_FAILURES = 3;
+export class GoalPulse {
+    goals;
+    runner;
+    timer = null;
+    _running = false;
+    _checkCount = 0;
+    _lastCheckAt = null;
+    failures = new Map();
+    maxFailures;
+    tickMs;
+    constructor(goals, runner, opts = {}) {
+        this.goals = goals;
+        this.runner = runner;
+        this.maxFailures = opts.maxFailures ?? DEFAULT_MAX_FAILURES;
+        this.tickMs = opts.tickMs ?? TICK_MS;
+    }
+    start() {
+        if (this._running)
+            return;
+        this._running = true;
+        const fire = () => void this.tick().catch((e) => log.error({ err: e.message }, "goal pulse tick crashed"));
+        this.timer = setInterval(fire, this.tickMs);
+        if (typeof this.timer === "object" && "unref" in this.timer)
+            this.timer.unref();
+        log.info({ tickMs: this.tickMs }, "goal pulse started");
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        this._running = false;
+        log.info("goal pulse stopped");
+    }
+    stats() {
+        return { running: this._running, checkCount: this._checkCount, lastCheckAt: this._lastCheckAt };
+    }
+    /** Run one cycle. Exposed for tests / manual triggers. */
+    async tick() {
+        const now = Date.now();
+        this._lastCheckAt = now;
+        this._checkCount++;
+        const due = this.goals.activeGoals().filter((g) => this.isDue(g, now));
+        if (due.length === 0)
+            return;
+        log.info({ count: due.length }, "due goals found");
+        for (const goal of due) {
+            try {
+                await this.executeGoal(goal);
+                this.failures.delete(goal.id);
+            }
+            catch (e) {
+                const msg = e.message ?? String(e);
+                const count = (this.failures.get(goal.id) ?? 0) + 1;
+                this.failures.set(goal.id, count);
+                log.error({ goalId: goal.id, count, err: msg }, "goal execution failed");
+                if (count >= this.maxFailures) {
+                    this.goals.update(goal.id, { status: "paused", notes: `auto-paused after ${count} consecutive failures` }, true);
+                    this.failures.delete(goal.id);
+                    log.warn({ goalId: goal.id }, "goal auto-paused");
+                }
+                else {
+                    this.goals.update(goal.id, {}, true);
+                }
+            }
+        }
+    }
+    isDue(goal, now) {
+        if (!goal.checkCron)
+            return false;
+        if (goal.lastCheckedAt === null)
+            return true;
+        try {
+            const fields = parseCron(goal.checkCron);
+            const next = nextFire(fields, new Date(goal.lastCheckedAt), "UTC");
+            return next !== undefined && next <= now;
+        }
+        catch {
+            // Malformed cron — skip silently (shouldn't happen; validated on save).
+            return false;
+        }
+    }
+    async executeGoal(goal) {
+        const input = [
+            `[Goal Check] Autonomous check — no user present.`,
+            `Goal: ${goal.title}`,
+            goal.description ? `Description: ${goal.description}` : "",
+            goal.notes ? `Notes: ${goal.notes.slice(0, 300)}` : "",
+            "",
+            "Execute progress toward this goal. Report what you accomplished.",
+        ].filter(Boolean).join("\n");
+        // send() injects into a running "main" loop if one is active.
+        const sendResult = this.runner.send({
+            input,
+            sessionId: "main",
+        });
+        if (sendResult.mode === "injected") {
+            this.goals.update(goal.id, {}, true);
+            log.info({ goalId: goal.id, taskId: sendResult.taskId }, "goal injected into running loop");
+            return;
+        }
+        const terminal = await sendResult.done;
+        if (terminal.status === "failed") {
+            throw new Error(terminal.error ?? "goal task failed");
+        }
+        this.goals.update(goal.id, {}, true);
+        log.info({ goalId: goal.id, taskId: sendResult.taskId }, "goal progressed");
+    }
+}
+//# sourceMappingURL=GoalPulse.js.map

package/dist/scheduler/GoalPulse.js.map

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

package/dist/scheduler/Heartbeat.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Heartbeat — proactive self-check pulse + optional user-defined cadence.
+ *
+ * Two modes:
+ *   1. Proactive scan every `proactiveIntervalMs` (default 4h). Looks at
+ *      goals / cron / watchers / tasks for anomalies. If anything's off,
+ *      enqueues a single agent turn with the findings. Silent otherwise —
+ *      no wasted tokens.
+ *   2. User HEARTBEAT.md. If the file exists and changed since last
+ *      check, enqueue a turn that asks the agent to follow those
+ *      instructions. Dedup'd against previous content for 24 h.
+ *
+ * Active-hours window (default 08:00-22:00 host time) keeps the
+ * heartbeat quiet overnight. User-defined HEARTBEAT.md only fires in
+ * daemon mode — interactive use is already "the user is there".
+ */
+import type { TaskRunner } from "../core/TaskRunner.js";
+import type { CronStore } from "../cron/CronStore.js";
+import type { GoalStore } from "../goals/GoalStore.js";
+import type { TaskStore } from "../tasks/TaskStore.js";
+import type { WatcherStore } from "../watchers/WatcherStore.js";
+export interface HeartbeatOptions {
+    readonly rootDir: string;
+    readonly daemonMode: boolean;
+    /** User heartbeat cadence (min). Default 30. */
+    readonly intervalMinutes?: number;
+    /** Proactive scan cadence (min). Default 240. */
+    readonly proactiveIntervalMinutes?: number;
+    /** "08:00" etc. Default 08:00. */
+    readonly activeHourStart?: string;
+    /** "22:00" etc. Default 22:00. */
+    readonly activeHourEnd?: string;
+    /** IANA timezone for active-hour window. Default host. */
+    readonly activeTimezone?: string;
+    /** Live setting check — read each tick so the user can flip the
+     *  HEARTBEAT_ENABLED setting without restarting. Default: always on. */
+    readonly enabledFn?: () => boolean;
+}
+export interface HeartbeatStats {
+    readonly running: boolean;
+    readonly intervalMinutes: number;
+    readonly proactiveIntervalMinutes: number;
+    readonly activeHours: string;
+    readonly timezone: string;
+    readonly lastCheckAt: number | null;
+    readonly lastProactiveAt: number | null;
+    readonly checkCount: number;
+}
+export interface HeartbeatDeps {
+    readonly runner: TaskRunner;
+    readonly goals: GoalStore;
+    readonly cron: CronStore;
+    readonly watchers: WatcherStore;
+    readonly tasks: TaskStore;
+}
+export declare class Heartbeat {
+    private readonly deps;
+    private timer;
+    private _running;
+    private _checkCount;
+    private _lastCheckAt;
+    private _lastProactiveAt;
+    private _lastContentHash;
+    private _lastContentAt;
+    private readonly heartbeatPath;
+    private readonly intervalMs;
+    private readonly proactiveIntervalMs;
+    private readonly activeStart;
+    private readonly activeEnd;
+    private readonly activeTz;
+    private readonly daemonMode;
+    private readonly enabledFn;
+    constructor(deps: HeartbeatDeps, opts: HeartbeatOptions);
+    start(): void;
+    stop(): void;
+    stats(): HeartbeatStats;
+    /** One cycle. Exposed for tests. */
+    tick(): Promise<void>;
+    private proactiveCheck;
+    private overdueGoals;
+    private brokenCrons;
+    private silentWatchers;
+    private failedTasks;
+    private userHeartbeat;
+    private isActiveHour;
+}
+//# sourceMappingURL=Heartbeat.d.ts.map

package/dist/scheduler/Heartbeat.d.ts.map

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

package/dist/scheduler/Heartbeat.js

@@ -0,0 +1,313 @@
+/**
+ * Heartbeat — proactive self-check pulse + optional user-defined cadence.
+ *
+ * Two modes:
+ *   1. Proactive scan every `proactiveIntervalMs` (default 4h). Looks at
+ *      goals / cron / watchers / tasks for anomalies. If anything's off,
+ *      enqueues a single agent turn with the findings. Silent otherwise —
+ *      no wasted tokens.
+ *   2. User HEARTBEAT.md. If the file exists and changed since last
+ *      check, enqueue a turn that asks the agent to follow those
+ *      instructions. Dedup'd against previous content for 24 h.
+ *
+ * Active-hours window (default 08:00-22:00 host time) keeps the
+ * heartbeat quiet overnight. User-defined HEARTBEAT.md only fires in
+ * daemon mode — interactive use is already "the user is there".
+ */
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { nextFire, parseCron } from "../cron/cronParser.js";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("heartbeat");
+const DEFAULT_INTERVAL_MINUTES = 30;
+const DEFAULT_PROACTIVE_MINUTES = 240; // 4 hours
+const TICK_CAP_MS = 5 * 60 * 1000; // never tick slower than 5 min
+const SILENT_WATCHER_DAYS = 7;
+const OVERDUE_GOAL_MS = 60 * 60 * 1000; // flag if next fire is > 1h overdue
+const BROKEN_CRON_ERR_THRESHOLD = 3;
+const FAILED_TASK_WINDOW_MS = 24 * 60 * 60 * 1000;
+export class Heartbeat {
+    deps;
+    timer = null;
+    _running = false;
+    _checkCount = 0;
+    _lastCheckAt = null;
+    _lastProactiveAt = null;
+    _lastContentHash = null;
+    _lastContentAt = 0;
+    heartbeatPath;
+    intervalMs;
+    proactiveIntervalMs;
+    activeStart;
+    activeEnd;
+    activeTz;
+    daemonMode;
+    enabledFn;
+    constructor(deps, opts) {
+        this.deps = deps;
+        this.heartbeatPath = join(opts.rootDir, "HEARTBEAT.md");
+        this.daemonMode = opts.daemonMode;
+        this.intervalMs = (opts.intervalMinutes ?? DEFAULT_INTERVAL_MINUTES) * 60_000;
+        this.proactiveIntervalMs = (opts.proactiveIntervalMinutes ?? DEFAULT_PROACTIVE_MINUTES) * 60_000;
+        this.activeStart = opts.activeHourStart ?? process.env["HEARTBEAT_ACTIVE_START"] ?? "08:00";
+        this.activeEnd = opts.activeHourEnd ?? process.env["HEARTBEAT_ACTIVE_END"] ?? "22:00";
+        this.activeTz = opts.activeTimezone ?? process.env["HEARTBEAT_TIMEZONE"] ?? undefined;
+        this.enabledFn = opts.enabledFn ?? (() => true);
+    }
+    start() {
+        if (this._running)
+            return;
+        this._running = true;
+        const tickMs = Math.min(this.intervalMs, TICK_CAP_MS);
+        this.timer = setInterval(() => void this.tick(), tickMs);
+        this.timer.unref?.();
+        // first fire 2 minutes in so startup surges don't trigger a scan immediately
+        setTimeout(() => void this.tick(), 120_000).unref?.();
+        log.info({
+            intervalMinutes: this.intervalMs / 60_000,
+            proactiveIntervalMinutes: this.proactiveIntervalMs / 60_000,
+            active: `${this.activeStart}-${this.activeEnd}`,
+            tz: this.activeTz ?? "host",
+        }, "heartbeat started");
+    }
+    stop() {
+        this._running = false;
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        log.info("heartbeat stopped");
+    }
+    stats() {
+        return {
+            running: this._running,
+            intervalMinutes: this.intervalMs / 60_000,
+            proactiveIntervalMinutes: this.proactiveIntervalMs / 60_000,
+            activeHours: `${this.activeStart}-${this.activeEnd}`,
+            timezone: this.activeTz ?? "host",
+            lastCheckAt: this._lastCheckAt,
+            lastProactiveAt: this._lastProactiveAt,
+            checkCount: this._checkCount,
+        };
+    }
+    /** One cycle. Exposed for tests. */
+    async tick() {
+        if (!this._running)
+            return;
+        // Live-read the HEARTBEAT_ENABLED setting on every tick so the user
+        // can flip it from the UI and the next tick respects the new value
+        // without a restart.
+        if (!this.enabledFn())
+            return;
+        if (!this.isActiveHour())
+            return;
+        await this.proactiveCheck();
+        if (this.daemonMode)
+            await this.userHeartbeat();
+    }
+    // ── Proactive checks ────────────────────────────────────────────────
+    async proactiveCheck() {
+        const now = Date.now();
+        if (this._lastProactiveAt && (now - this._lastProactiveAt) < this.proactiveIntervalMs)
+            return;
+        this._lastProactiveAt = now;
+        const findings = [];
+        try {
+            findings.push(...this.overdueGoals());
+        }
+        catch (e) {
+            log.debug({ err: e.message }, "overdue-goals check failed");
+        }
+        try {
+            findings.push(...this.brokenCrons());
+        }
+        catch (e) {
+            log.debug({ err: e.message }, "broken-crons check failed");
+        }
+        try {
+            findings.push(...this.silentWatchers());
+        }
+        catch (e) {
+            log.debug({ err: e.message }, "silent-watchers check failed");
+        }
+        try {
+            findings.push(...this.failedTasks());
+        }
+        catch (e) {
+            log.debug({ err: e.message }, "failed-tasks check failed");
+        }
+        if (findings.length === 0) {
+            log.info("proactive check — all clear");
+            return;
+        }
+        const body = findings.map((f, i) => `${i + 1}. [${f.type}] ${f.message}`).join("\n");
+        const input = [
+            "[Proactive Check] The system detected issues that may need attention. Review each finding and take action.",
+            "",
+            "FINDINGS:",
+            body,
+            "",
+            "For each finding:",
+            "- If you can fix it, fix it (retry a failed task, resume a paused goal, rotate a watcher token, etc.).",
+            "- If you can't fix it, notify the user via replyToUser() with a clear summary.",
+            "- If informational only, note it and move on.",
+            "",
+            "If nothing actually needs action after review, respond with just HEARTBEAT_OK.",
+            "",
+            `Current time: ${new Date().toISOString()}`,
+        ].join("\n");
+        log.info({ count: findings.length }, "proactive findings — enqueuing task");
+        // send() injects into a running "main" loop instead of spawning a parallel one.
+        this.deps.runner.send({
+            input,
+            sessionId: "main",
+        });
+    }
+    overdueGoals() {
+        const out = [];
+        const now = Date.now();
+        for (const g of this.deps.goals.activeGoals()) {
+            if (!g.checkCron || !g.lastCheckedAt)
+                continue;
+            try {
+                const fields = parseCron(g.checkCron);
+                const next = nextFire(fields, new Date(g.lastCheckedAt), "UTC");
+                if (next === undefined)
+                    continue;
+                const overdueMs = now - next;
+                if (overdueMs > OVERDUE_GOAL_MS) {
+                    const hours = (overdueMs / 3_600_000).toFixed(1);
+                    out.push({
+                        type: "OVERDUE_GOAL",
+                        message: `Goal "${g.title}" (${g.id.slice(0, 8)}) is ${hours}h overdue.`,
+                    });
+                }
+            }
+            catch {
+                // malformed cron — skip silently; validator should've caught it
+            }
+        }
+        return out;
+    }
+    brokenCrons() {
+        const out = [];
+        for (const job of this.deps.cron.listJobs()) {
+            if (!job.enabled)
+                continue;
+            const runs = this.deps.cron.listRuns(job.id, BROKEN_CRON_ERR_THRESHOLD);
+            if (runs.length < BROKEN_CRON_ERR_THRESHOLD)
+                continue;
+            const allErrored = runs.every((r) => r.status === "error");
+            if (!allErrored)
+                continue;
+            const lastErr = (runs[0]?.error ?? "unknown").slice(0, 100);
+            out.push({
+                type: "BROKEN_CRON",
+                message: `Cron "${job.name}" has ${BROKEN_CRON_ERR_THRESHOLD}+ consecutive errors. Last: ${lastErr}`,
+            });
+        }
+        return out;
+    }
+    silentWatchers() {
+        const out = [];
+        const cutoff = Date.now() - SILENT_WATCHER_DAYS * 24 * 60 * 60_000;
+        for (const w of this.deps.watchers.list()) {
+            if (!w.enabled || w.triggerCount === 0)
+                continue;
+            if (w.lastTriggeredAt === null)
+                continue;
+            if (w.lastTriggeredAt < cutoff) {
+                const days = Math.floor((Date.now() - w.lastTriggeredAt) / (24 * 60 * 60_000));
+                out.push({
+                    type: "SILENT_WATCHER",
+                    message: `Watcher "${w.name}" hasn't fired in ${days} days (total fires: ${w.triggerCount}). Source may have stopped sending.`,
+                });
+            }
+        }
+        return out;
+    }
+    failedTasks() {
+        const out = [];
+        const rows = this.deps.tasks.recentFailed(Date.now() - FAILED_TASK_WINDOW_MS, 5);
+        if (rows.length === 0)
+            return out;
+        const summary = rows
+            .map((t) => `${t.id.slice(0, 8)}: "${(t.input ?? "").slice(0, 60)}…" — ${(t.error ?? "unknown").slice(0, 80)}`)
+            .join("\n  ");
+        out.push({
+            type: "FAILED_TASKS",
+            message: `${rows.length} task(s) failed in the last 24h:\n  ${summary}`,
+        });
+        return out;
+    }
+    // ── User HEARTBEAT.md ──────────────────────────────────────────────
+    async userHeartbeat() {
+        if (!existsSync(this.heartbeatPath))
+            return;
+        let instructions;
+        try {
+            instructions = readFileSync(this.heartbeatPath, "utf-8").trim();
+        }
+        catch (e) {
+            log.warn({ err: e.message }, "HEARTBEAT.md read failed");
+            return;
+        }
+        if (!instructions)
+            return;
+        const contentHash = createHash("sha256").update(instructions).digest("hex");
+        const now = Date.now();
+        if (contentHash === this._lastContentHash && (now - this._lastContentAt) < 24 * 60 * 60_000)
+            return;
+        this._lastContentHash = contentHash;
+        this._lastContentAt = now;
+        this._checkCount++;
+        this._lastCheckAt = now;
+        log.info({ check: this._checkCount }, "user heartbeat fired");
+        // send() injects into a running "main" loop instead of spawning a parallel one.
+        this.deps.runner.send({
+            input: [
+                `[Heartbeat check #${this._checkCount}] Follow HEARTBEAT.md strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`,
+                "",
+                "Instructions from HEARTBEAT.md:",
+                instructions,
+                "",
+                `Current time: ${new Date().toISOString()}`,
+            ].join("\n"),
+            sessionId: "main",
+        });
+    }
+    // ── Helpers ────────────────────────────────────────────────────────
+    isActiveHour() {
+        const now = new Date();
+        let h = now.getHours();
+        let m = now.getMinutes();
+        if (this.activeTz) {
+            try {
+                const fmt = now.toLocaleTimeString("en-US", {
+                    timeZone: this.activeTz,
+                    hour12: false,
+                    hour: "2-digit",
+                    minute: "2-digit",
+                });
+                const [hh, mm] = fmt.split(":").map(Number);
+                if (hh !== undefined && mm !== undefined) {
+                    h = hh;
+                    m = mm;
+                }
+            }
+            catch { /* fallback to host */ }
+        }
+        const cur = h * 60 + m;
+        const start = parseHm(this.activeStart);
+        const end = parseHm(this.activeEnd);
+        return cur >= start && cur < end;
+    }
+}
+function parseHm(s) {
+    if (s.includes(":")) {
+        const [h, m] = s.split(":").map(Number);
+        return (h ?? 0) * 60 + (m ?? 0);
+    }
+    return Number.parseInt(s, 10) * 60;
+}
+//# sourceMappingURL=Heartbeat.js.map

package/dist/scheduler/Heartbeat.js.map

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

package/dist/scheduler/MorningPulse.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MorningPulse — ensure a daily briefing cron job is present.
+ *
+ * Idempotent: running this at startup either finds the existing job or
+ * creates it with the default expression + task prompt. All actual
+ * execution goes through the normal cron scheduler + CronExecutor.
+ */
+import type { CronJob, CronStore } from "../cron/CronStore.js";
+export declare const MORNING_PULSE_NAME = "Morning Pulse";
+export interface MorningPulseOptions {
+    readonly timezone?: string;
+    readonly delivery?: Record<string, unknown>;
+}
+/**
+ * Create the Morning Pulse cron job if it doesn't exist.
+ * Returns the existing or newly created job plus a `created` flag.
+ */
+export declare function ensureMorningPulse(store: CronStore, opts?: MorningPulseOptions): {
+    job: CronJob;
+    created: boolean;
+};
+export declare function removeMorningPulse(store: CronStore): boolean;
+//# sourceMappingURL=MorningPulse.d.ts.map

package/dist/scheduler/MorningPulse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorningPulse.d.ts","sourceRoot":"","sources":["../../src/scheduler/MorningPulse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAK/D,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAYlD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,mBAAwB,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAavH;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAI5D"}

package/dist/scheduler/MorningPulse.js

@@ -0,0 +1,45 @@
+/**
+ * MorningPulse — ensure a daily briefing cron job is present.
+ *
+ * Idempotent: running this at startup either finds the existing job or
+ * creates it with the default expression + task prompt. All actual
+ * execution goes through the normal cron scheduler + CronExecutor.
+ */
+import { createLogger } from "../util/logger.js";
+const log = createLogger("morning-pulse");
+export const MORNING_PULSE_NAME = "Morning Pulse";
+const DEFAULT_EXPRESSION = "0 8 * * *";
+const DEFAULT_TASK = [
+    "Morning briefing. Summarise:",
+    "- Pending tasks and goals: use the goal/task tools to list active goals and recent/failed tasks.",
+    "- Overnight activity: if ./data/daily.log exists, read it; otherwise skip.",
+    "- Upcoming scheduled jobs: use the cron tool to list enabled jobs and their next-run times.",
+    "- Any failed tasks or alerts: check recent task failures and audit events.",
+    "",
+    "Be concise. Prioritise actionable items. Never guess or invent files — if a source doesn't exist, say so in one line and move on.",
+].join("\n");
+/**
+ * Create the Morning Pulse cron job if it doesn't exist.
+ * Returns the existing or newly created job plus a `created` flag.
+ */
+export function ensureMorningPulse(store, opts = {}) {
+    const existing = store.listJobs().find((j) => j.name === MORNING_PULSE_NAME);
+    if (existing)
+        return { job: existing, created: false };
+    const job = store.addJob({
+        name: MORNING_PULSE_NAME,
+        expression: DEFAULT_EXPRESSION,
+        task: DEFAULT_TASK,
+        ...(opts.timezone ? { timezone: opts.timezone } : {}),
+        ...(opts.delivery ? { delivery: opts.delivery } : {}),
+    });
+    log.info({ id: job.id, expression: DEFAULT_EXPRESSION, tz: job.timezone }, "morning pulse created");
+    return { job, created: true };
+}
+export function removeMorningPulse(store) {
+    const existing = store.listJobs().find((j) => j.name === MORNING_PULSE_NAME);
+    if (!existing)
+        return false;
+    return store.deleteJob(existing.id);
+}
+//# sourceMappingURL=MorningPulse.js.map

package/dist/scheduler/MorningPulse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorningPulse.js","sourceRoot":"","sources":["../../src/scheduler/MorningPulse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAClD,MAAM,kBAAkB,GAAG,WAAW,CAAC;AACvC,MAAM,YAAY,GAAG;IACnB,8BAA8B;IAC9B,kGAAkG;IAClG,4EAA4E;IAC5E,6FAA6F;IAC7F,4EAA4E;IAC5E,EAAE;IACF,mIAAmI;CACpI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAOb;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgB,EAAE,OAA4B,EAAE;IACjF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;IAC7E,IAAI,QAAQ;QAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAEvD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,kBAAkB;QAC9B,IAAI,EAAE,YAAY;QAClB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,kBAAkB,EAAE,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,uBAAuB,CAAC,CAAC;IACpG,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;IAC7E,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC"}