@songsid/agend 0.0.1

package/dist/scheduler/scheduler.d.ts

@@ -0,0 +1,44 @@
+import { SchedulerDb } from "./db.js";
+import type { Schedule, CreateScheduleParams, UpdateScheduleParams, SchedulerConfig, ScheduleRun } from "./types.js";
+export declare class Scheduler {
+    /** Cap how far back we look for missed fires on init. Avoids dumping
+     * dozens of "morning standup" pings on the user after a long outage,
+     * while still recovering from short crashes/restarts. */
+    private static readonly CATCHUP_WINDOW_MS;
+    readonly db: SchedulerDb;
+    private jobs;
+    private onTrigger;
+    private config;
+    private isValidInstance;
+    /** IDs of schedules whose onTrigger is currently in flight; guards against
+     * a manual trigger and a cron firing (or two cron fires) overlapping. */
+    private executing;
+    constructor(dbPath: string, onTrigger: (schedule: Schedule) => void | Promise<void>, config: SchedulerConfig, isValidInstance: (name: string) => boolean);
+    init(): void;
+    /**
+     * On startup, fire any schedule whose most recent expected run was missed
+     * within the catch-up window. Only one catch-up fire per schedule — we
+     * don't replay every missed minute of `* * * * *`. Schedules that haven't
+     * been triggered yet use `created_at` as the reference point so a new
+     * schedule registered while the daemon was down still gets caught up.
+     */
+    private runCatchUp;
+    reload(): void;
+    shutdown(): void;
+    create(params: CreateScheduleParams): Schedule;
+    list(target?: string): Schedule[];
+    get(id: string): Schedule | null;
+    update(id: string, params: UpdateScheduleParams): Schedule;
+    delete(id: string): void;
+    trigger(id: string): void;
+    /** Invoke onTrigger while holding the per-schedule lock. Cleans up when
+     * the callback returns synchronously, throws, or settles a returned Promise. */
+    private runWithLock;
+    deleteByInstanceOrThread(instanceName: string, threadId: string): number;
+    recordRun(scheduleId: string, status: string, detail?: string): void;
+    getRuns(scheduleId: string, limit?: number): ScheduleRun[];
+    private registerAllJobs;
+    private registerJob;
+    private stopJob;
+    private stopAllJobs;
+}

package/dist/scheduler/scheduler.js

@@ -0,0 +1,197 @@
+import { Cron } from "croner";
+import { SchedulerDb } from "./db.js";
+import { validateTimezone } from "../config.js";
+export class Scheduler {
+    /** Cap how far back we look for missed fires on init. Avoids dumping
+     * dozens of "morning standup" pings on the user after a long outage,
+     * while still recovering from short crashes/restarts. */
+    static CATCHUP_WINDOW_MS = 24 * 60 * 60 * 1000;
+    db;
+    jobs = new Map();
+    onTrigger;
+    config;
+    isValidInstance;
+    /** IDs of schedules whose onTrigger is currently in flight; guards against
+     * a manual trigger and a cron firing (or two cron fires) overlapping. */
+    executing = new Set();
+    constructor(dbPath, onTrigger, config, isValidInstance) {
+        this.db = new SchedulerDb(dbPath);
+        this.onTrigger = onTrigger;
+        this.config = config;
+        this.isValidInstance = isValidInstance;
+    }
+    init() {
+        this.db.pruneOldRuns();
+        this.runCatchUp();
+        this.registerAllJobs();
+    }
+    /**
+     * On startup, fire any schedule whose most recent expected run was missed
+     * within the catch-up window. Only one catch-up fire per schedule — we
+     * don't replay every missed minute of `* * * * *`. Schedules that haven't
+     * been triggered yet use `created_at` as the reference point so a new
+     * schedule registered while the daemon was down still gets caught up.
+     */
+    runCatchUp() {
+        const now = Date.now();
+        const cutoff = now - Scheduler.CATCHUP_WINDOW_MS;
+        for (const schedule of this.db.list()) {
+            if (!schedule.enabled)
+                continue;
+            const refIso = schedule.last_triggered_at ?? schedule.created_at;
+            // SQLite datetime('now') stores UTC without 'Z' suffix — append it for correct parsing
+            const refMs = Date.parse(refIso.endsWith("Z") ? refIso : refIso + "Z");
+            if (Number.isNaN(refMs))
+                continue;
+            try {
+                const cron = new Cron(schedule.cron, { timezone: schedule.timezone });
+                const next = cron.nextRun(new Date(refMs));
+                if (!next)
+                    continue;
+                const nextMs = next.getTime();
+                if (nextMs > now)
+                    continue; // not yet due
+                if (nextMs < cutoff)
+                    continue; // too old, don't spam
+                if (this.executing.has(schedule.id))
+                    continue;
+                this.runWithLock(schedule);
+            }
+            catch {
+                // Bad cron expression or croner edge case — skip rather than crash init
+                continue;
+            }
+        }
+    }
+    reload() {
+        this.stopAllJobs();
+        this.registerAllJobs();
+    }
+    shutdown() {
+        this.stopAllJobs();
+        this.db.close();
+    }
+    create(params) {
+        const tz = params.timezone ?? this.config.default_timezone;
+        validateTimezone(tz, "timezone");
+        try {
+            new Cron(params.cron, { timezone: tz });
+        }
+        catch (err) {
+            throw new Error(`Invalid cron expression: ${err.message}`);
+        }
+        if (!this.isValidInstance(params.target)) {
+            throw new Error(`Instance "${params.target}" not found in fleet config.`);
+        }
+        const schedule = this.db.create(params, this.config.max_schedules);
+        this.registerJob(schedule);
+        return schedule;
+    }
+    list(target) {
+        return this.db.list(target);
+    }
+    get(id) {
+        return this.db.get(id);
+    }
+    update(id, params) {
+        if (params.timezone !== undefined) {
+            validateTimezone(params.timezone, "timezone");
+        }
+        if (params.cron !== undefined) {
+            try {
+                new Cron(params.cron, { timezone: params.timezone ?? this.db.get(id)?.timezone ?? this.config.default_timezone });
+            }
+            catch (err) {
+                throw new Error(`Invalid cron expression: ${err.message}`);
+            }
+        }
+        if (params.target !== undefined && !this.isValidInstance(params.target)) {
+            throw new Error(`Instance "${params.target}" not found in fleet config.`);
+        }
+        const updated = this.db.update(id, params);
+        this.stopJob(id);
+        if (updated.enabled) {
+            this.registerJob(updated);
+        }
+        return updated;
+    }
+    delete(id) {
+        this.stopJob(id);
+        this.db.delete(id);
+    }
+    trigger(id) {
+        const schedule = this.db.get(id);
+        if (!schedule)
+            throw new Error(`Schedule "${id}" not found.`);
+        if (this.executing.has(id)) {
+            throw new Error(`Schedule "${id}" is already running.`);
+        }
+        this.runWithLock(schedule);
+    }
+    /** Invoke onTrigger while holding the per-schedule lock. Cleans up when
+     * the callback returns synchronously, throws, or settles a returned Promise. */
+    runWithLock(schedule) {
+        this.executing.add(schedule.id);
+        let result;
+        try {
+            result = this.onTrigger(schedule);
+        }
+        catch (err) {
+            this.executing.delete(schedule.id);
+            throw err;
+        }
+        if (result && typeof result.then === "function") {
+            result.finally(() => this.executing.delete(schedule.id));
+        }
+        else {
+            this.executing.delete(schedule.id);
+        }
+    }
+    deleteByInstanceOrThread(instanceName, threadId) {
+        const affected = this.db.list().filter((s) => s.target === instanceName || s.reply_thread_id === threadId);
+        for (const s of affected) {
+            this.stopJob(s.id);
+        }
+        return this.db.deleteByInstanceOrThread(instanceName, threadId);
+    }
+    recordRun(scheduleId, status, detail) {
+        this.db.recordRun(scheduleId, status, detail);
+    }
+    getRuns(scheduleId, limit) {
+        return this.db.getRuns(scheduleId, limit);
+    }
+    registerAllJobs() {
+        for (const schedule of this.db.list()) {
+            if (schedule.enabled) {
+                this.registerJob(schedule);
+            }
+        }
+    }
+    registerJob(schedule) {
+        const job = new Cron(schedule.cron, { timezone: schedule.timezone }, () => {
+            const current = this.db.get(schedule.id);
+            if (!current || !current.enabled)
+                return;
+            // Skip if a previous fire (or manual trigger) is still in flight —
+            // avoids overlapping runs of the same schedule.
+            if (this.executing.has(current.id))
+                return;
+            this.runWithLock(current);
+        });
+        this.jobs.set(schedule.id, job);
+    }
+    stopJob(id) {
+        const job = this.jobs.get(id);
+        if (job) {
+            job.stop();
+            this.jobs.delete(id);
+        }
+    }
+    stopAllJobs() {
+        for (const [, job] of this.jobs) {
+            job.stop();
+        }
+        this.jobs.clear();
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler/scheduler.js.map

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

package/dist/scheduler/scheduler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scheduler/scheduler.test.js

@@ -0,0 +1,119 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { Scheduler } from "./scheduler.js";
+import { DEFAULT_SCHEDULER_CONFIG } from "./types.js";
+describe("Scheduler", () => {
+    let dir;
+    let scheduler;
+    let triggered;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), "scheduler-engine-test-"));
+        triggered = [];
+        scheduler = new Scheduler(join(dir, "scheduler.db"), (schedule) => { triggered.push(schedule); }, DEFAULT_SCHEDULER_CONFIG, (instanceName) => true);
+        scheduler.init();
+    });
+    afterEach(() => {
+        scheduler.shutdown();
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it("creates a schedule and registers cron job", () => {
+        const s = scheduler.create({
+            cron: "0 7 * * *",
+            message: "hello",
+            source: "proj-a",
+            target: "proj-a",
+            reply_chat_id: "1",
+            reply_thread_id: null,
+        });
+        expect(s.id).toBeTruthy();
+        expect(scheduler.list()).toHaveLength(1);
+    });
+    it("rejects invalid cron expression", () => {
+        expect(() => scheduler.create({
+            cron: "not a cron",
+            message: "hello",
+            source: "a",
+            target: "a",
+            reply_chat_id: "1",
+            reply_thread_id: null,
+        })).toThrow(/cron/i);
+    });
+    it("rejects invalid target instance", () => {
+        const s2 = new Scheduler(join(dir, "scheduler2.db"), () => { }, DEFAULT_SCHEDULER_CONFIG, (name) => name === "proj-a");
+        s2.init();
+        expect(() => s2.create({
+            cron: "0 7 * * *",
+            message: "hello",
+            source: "proj-a",
+            target: "nonexistent",
+            reply_chat_id: "1",
+            reply_thread_id: null,
+        })).toThrow(/not found/i);
+        s2.shutdown();
+    });
+    it("manual trigger calls onTrigger callback", () => {
+        const s = scheduler.create({
+            cron: "0 7 * * *",
+            message: "hello",
+            source: "proj-a",
+            target: "proj-a",
+            reply_chat_id: "1",
+            reply_thread_id: null,
+        });
+        scheduler.trigger(s.id);
+        expect(triggered).toHaveLength(1);
+        expect(triggered[0].id).toBe(s.id);
+    });
+    it("delete removes schedule and cron job", () => {
+        const s = scheduler.create({
+            cron: "0 7 * * *",
+            message: "hello",
+            source: "a",
+            target: "a",
+            reply_chat_id: "1",
+            reply_thread_id: null,
+        });
+        scheduler.delete(s.id);
+        expect(scheduler.list()).toHaveLength(0);
+    });
+    it("update reschedules cron job", () => {
+        const s = scheduler.create({
+            cron: "0 7 * * *",
+            message: "hello",
+            source: "a",
+            target: "a",
+            reply_chat_id: "1",
+            reply_thread_id: null,
+        });
+        const updated = scheduler.update(s.id, { cron: "0 8 * * *" });
+        expect(updated.cron).toBe("0 8 * * *");
+    });
+    it("reload clears and re-registers all jobs", () => {
+        scheduler.create({
+            cron: "0 7 * * *",
+            message: "hello",
+            source: "a",
+            target: "a",
+            reply_chat_id: "1",
+            reply_thread_id: null,
+        });
+        scheduler.reload();
+        expect(scheduler.list()).toHaveLength(1);
+    });
+    it("deleteByInstanceOrThread cleans up and removes cron jobs", () => {
+        scheduler.create({
+            cron: "0 7 * * *",
+            message: "a",
+            source: "a",
+            target: "proj-a",
+            reply_chat_id: "1",
+            reply_thread_id: "42",
+        });
+        const count = scheduler.deleteByInstanceOrThread("proj-a", "42");
+        expect(count).toBe(1);
+        expect(scheduler.list()).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=scheduler.test.js.map

package/dist/scheduler/scheduler.test.js.map

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

package/dist/scheduler/types.d.ts

@@ -0,0 +1,107 @@
+export interface Schedule {
+    id: string;
+    cron: string;
+    message: string;
+    source: string;
+    target: string;
+    reply_chat_id: string;
+    reply_thread_id: string | null;
+    label: string | null;
+    enabled: boolean;
+    timezone: string;
+    created_at: string;
+    last_triggered_at: string | null;
+    last_status: string | null;
+}
+export interface ScheduleRun {
+    id: number;
+    schedule_id: string;
+    triggered_at: string;
+    status: "delivered" | "delivered_fallback" | "retry" | "instance_offline" | "channel_dead";
+    detail: string | null;
+}
+export interface CreateScheduleParams {
+    cron: string;
+    message: string;
+    source: string;
+    target: string;
+    reply_chat_id: string;
+    reply_thread_id: string | null;
+    label?: string;
+    timezone?: string;
+}
+export interface UpdateScheduleParams {
+    cron?: string;
+    message?: string;
+    target?: string;
+    label?: string;
+    timezone?: string;
+    enabled?: boolean;
+}
+export interface SchedulerConfig {
+    max_schedules: number;
+    default_timezone: string;
+    retry_count: number;
+    retry_interval_ms: number;
+}
+export declare const DEFAULT_SCHEDULER_CONFIG: SchedulerConfig;
+export type DecisionStatus = "active" | "superseded" | "archived";
+export type DecisionScope = "project" | "fleet";
+export interface Decision {
+    id: string;
+    project_root: string;
+    scope: DecisionScope;
+    title: string;
+    content: string;
+    tags: string[];
+    status: DecisionStatus;
+    superseded_by: string | null;
+    created_by: string;
+    created_at: string;
+    expires_at: string | null;
+    updated_at: string;
+}
+export interface CreateDecisionParams {
+    project_root: string;
+    scope?: DecisionScope;
+    title: string;
+    content: string;
+    tags?: string[];
+    ttl_days?: number;
+    created_by: string;
+    supersedes?: string;
+}
+export interface UpdateDecisionParams {
+    content?: string;
+    tags?: string[];
+    ttl_days?: number;
+}
+export type TaskStatus = "open" | "claimed" | "done" | "blocked" | "cancelled";
+export type TaskPriority = "low" | "normal" | "high" | "urgent";
+export interface Task {
+    id: string;
+    title: string;
+    description: string | null;
+    status: TaskStatus;
+    priority: TaskPriority;
+    assignee: string | null;
+    created_by: string;
+    depends_on: string[];
+    result: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateTaskParams {
+    title: string;
+    description?: string;
+    priority?: TaskPriority;
+    assignee?: string;
+    depends_on?: string[];
+    created_by: string;
+}
+export interface UpdateTaskParams {
+    status?: TaskStatus;
+    assignee?: string;
+    result?: string;
+    priority?: TaskPriority;
+}

package/dist/scheduler/types.js

@@ -0,0 +1,7 @@
+export const DEFAULT_SCHEDULER_CONFIG = {
+    max_schedules: 100,
+    default_timezone: "Asia/Taipei",
+    retry_count: 3,
+    retry_interval_ms: 30_000,
+};
+//# sourceMappingURL=types.js.map

package/dist/scheduler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scheduler/types.ts"],"names":[],"mappings":"AAmDA,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,aAAa,EAAE,GAAG;IAClB,gBAAgB,EAAE,aAAa;IAC/B,WAAW,EAAE,CAAC;IACd,iBAAiB,EAAE,MAAM;CAC1B,CAAC"}

package/dist/service-installer.d.ts

@@ -0,0 +1,17 @@
+interface ServiceVars {
+    label: string;
+    execPath: string;
+    path?: string;
+    workingDirectory: string;
+    logPath: string;
+}
+export declare function detectPlatform(): "macos" | "linux";
+export declare function renderLaunchdPlist(vars: ServiceVars): string;
+export declare function renderSystemdUnit(vars: ServiceVars): string;
+export declare function uninstallService(label: string): boolean;
+export declare function installService(vars: ServiceVars): string;
+export declare function getServicePath(): string | null;
+export declare function stopService(): boolean;
+export declare function startService(): boolean;
+export declare function activateService(plistPath: string, pidPath: string): void;
+export {};