@evermore.work/server 2026.509.0-canary.0

package/dist/services/cron.js

@@ -0,0 +1,300 @@
+/**
+ * Lightweight cron expression parser and next-run calculator.
+ *
+ * Supports standard 5-field cron expressions:
+ *
+ *   ┌────────────── minute (0–59)
+ *   │ ┌──────────── hour   (0–23)
+ *   │ │ ┌────────── day of month (1–31)
+ *   │ │ │ ┌──────── month  (1–12)
+ *   │ │ │ │ ┌────── day of week (0–6, Sun=0)
+ *   │ │ │ │ │
+ *   * * * * *
+ *
+ * Supported syntax per field:
+ *   - `*`        — any value
+ *   - `N`        — exact value
+ *   - `N-M`      — range (inclusive)
+ *   - `N/S`      — start at N, step S (within field bounds)
+ *   - `* /S`     — every S (from field min)   [no space — shown to avoid comment termination]
+ *   - `N-M/S`    — range with step
+ *   - `N,M,...`  — list of values, ranges, or steps
+ *
+ * @module
+ */
+const FIELD_SPECS = [
+    { min: 0, max: 59, name: "minute" },
+    { min: 0, max: 23, name: "hour" },
+    { min: 1, max: 31, name: "day of month" },
+    { min: 1, max: 12, name: "month" },
+    { min: 0, max: 6, name: "day of week" },
+];
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a single cron field token (e.g. `"5"`, `"1-3"`, `"* /10"`, `"1,3,5"`).
+ *
+ * @returns Sorted deduplicated array of matching integer values within bounds.
+ * @throws {Error} on invalid syntax or out-of-range values.
+ */
+function parseField(token, spec) {
+    const values = new Set();
+    // Split on commas first — each part can be a value, range, or step
+    const parts = token.split(",");
+    for (const part of parts) {
+        const trimmed = part.trim();
+        if (trimmed === "") {
+            throw new Error(`Empty element in cron ${spec.name} field`);
+        }
+        // Check for step syntax: "X/S" where X is "*" or a range or a number
+        const slashIdx = trimmed.indexOf("/");
+        if (slashIdx !== -1) {
+            const base = trimmed.slice(0, slashIdx);
+            const stepStr = trimmed.slice(slashIdx + 1);
+            const step = parseInt(stepStr, 10);
+            if (isNaN(step) || step <= 0) {
+                throw new Error(`Invalid step "${stepStr}" in cron ${spec.name} field`);
+            }
+            let rangeStart = spec.min;
+            let rangeEnd = spec.max;
+            if (base === "*") {
+                // */S — every S from field min
+            }
+            else if (base.includes("-")) {
+                // N-M/S — range with step
+                const [a, b] = base.split("-").map((s) => parseInt(s, 10));
+                if (isNaN(a) || isNaN(b)) {
+                    throw new Error(`Invalid range "${base}" in cron ${spec.name} field`);
+                }
+                rangeStart = a;
+                rangeEnd = b;
+            }
+            else {
+                // N/S — start at N, step S
+                const start = parseInt(base, 10);
+                if (isNaN(start)) {
+                    throw new Error(`Invalid start "${base}" in cron ${spec.name} field`);
+                }
+                rangeStart = start;
+            }
+            validateBounds(rangeStart, spec);
+            validateBounds(rangeEnd, spec);
+            for (let i = rangeStart; i <= rangeEnd; i += step) {
+                values.add(i);
+            }
+            continue;
+        }
+        // Check for range syntax: "N-M"
+        if (trimmed.includes("-")) {
+            const [aStr, bStr] = trimmed.split("-");
+            const a = parseInt(aStr, 10);
+            const b = parseInt(bStr, 10);
+            if (isNaN(a) || isNaN(b)) {
+                throw new Error(`Invalid range "${trimmed}" in cron ${spec.name} field`);
+            }
+            validateBounds(a, spec);
+            validateBounds(b, spec);
+            if (a > b) {
+                throw new Error(`Invalid range ${a}-${b} in cron ${spec.name} field (start > end)`);
+            }
+            for (let i = a; i <= b; i++) {
+                values.add(i);
+            }
+            continue;
+        }
+        // Wildcard
+        if (trimmed === "*") {
+            for (let i = spec.min; i <= spec.max; i++) {
+                values.add(i);
+            }
+            continue;
+        }
+        // Single value
+        const val = parseInt(trimmed, 10);
+        if (isNaN(val)) {
+            throw new Error(`Invalid value "${trimmed}" in cron ${spec.name} field`);
+        }
+        validateBounds(val, spec);
+        values.add(val);
+    }
+    if (values.size === 0) {
+        throw new Error(`Empty result for cron ${spec.name} field`);
+    }
+    return [...values].sort((a, b) => a - b);
+}
+function validateBounds(value, spec) {
+    if (value < spec.min || value > spec.max) {
+        throw new Error(`Value ${value} out of range [${spec.min}–${spec.max}] for cron ${spec.name} field`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a cron expression string into a structured {@link ParsedCron}.
+ *
+ * @param expression — A standard 5-field cron expression.
+ * @returns Parsed cron with sorted valid values for each field.
+ * @throws {Error} on invalid syntax.
+ *
+ * @example
+ * ```ts
+ * const parsed = parseCron("0 * * * *"); // every hour at minute 0
+ * // parsed.minutes === [0]
+ * // parsed.hours === [0,1,2,...,23]
+ * ```
+ */
+export function parseCron(expression) {
+    const trimmed = expression.trim();
+    if (!trimmed) {
+        throw new Error("Cron expression must not be empty");
+    }
+    const tokens = trimmed.split(/\s+/);
+    if (tokens.length !== 5) {
+        throw new Error(`Cron expression must have exactly 5 fields, got ${tokens.length}: "${trimmed}"`);
+    }
+    return {
+        minutes: parseField(tokens[0], FIELD_SPECS[0]),
+        hours: parseField(tokens[1], FIELD_SPECS[1]),
+        daysOfMonth: parseField(tokens[2], FIELD_SPECS[2]),
+        months: parseField(tokens[3], FIELD_SPECS[3]),
+        daysOfWeek: parseField(tokens[4], FIELD_SPECS[4]),
+    };
+}
+/**
+ * Validate a cron expression string. Returns `null` if valid, or an error
+ * message string if invalid.
+ *
+ * @param expression — A cron expression string to validate.
+ * @returns `null` on success, error message on failure.
+ */
+export function validateCron(expression) {
+    try {
+        parseCron(expression);
+        return null;
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+}
+/**
+ * Calculate the next run time after `after` for the given parsed cron schedule.
+ *
+ * Starts from the minute immediately following `after` and walks forward
+ * until a matching minute is found (up to a safety limit of ~4 years to
+ * prevent infinite loops on impossible schedules).
+ *
+ * @param cron  — Parsed cron schedule.
+ * @param after — The reference date. The returned date will be strictly after this.
+ * @returns The next matching `Date`, or `null` if no match found within the search window.
+ */
+export function nextCronTick(cron, after) {
+    // Work in local minutes — start from the minute after `after`
+    const d = new Date(after.getTime());
+    // Advance to the next whole minute
+    d.setUTCSeconds(0, 0);
+    d.setUTCMinutes(d.getUTCMinutes() + 1);
+    // Safety: search up to 4 years worth of minutes (~2.1M iterations max).
+    // Uses 366 to account for leap years.
+    const MAX_CRON_SEARCH_YEARS = 4;
+    const maxIterations = MAX_CRON_SEARCH_YEARS * 366 * 24 * 60;
+    for (let i = 0; i < maxIterations; i++) {
+        const month = d.getUTCMonth() + 1; // 1-12
+        const dayOfMonth = d.getUTCDate(); // 1-31
+        const dayOfWeek = d.getUTCDay(); // 0-6
+        const hour = d.getUTCHours(); // 0-23
+        const minute = d.getUTCMinutes(); // 0-59
+        // Check month
+        if (!cron.months.includes(month)) {
+            // Skip to the first day of the next matching month
+            advanceToNextMonth(d, cron.months);
+            continue;
+        }
+        // Check day of month AND day of week (both must match)
+        if (!cron.daysOfMonth.includes(dayOfMonth) || !cron.daysOfWeek.includes(dayOfWeek)) {
+            // Advance one day
+            d.setUTCDate(d.getUTCDate() + 1);
+            d.setUTCHours(0, 0, 0, 0);
+            continue;
+        }
+        // Check hour
+        if (!cron.hours.includes(hour)) {
+            // Advance to next matching hour within the day
+            const nextHour = findNext(cron.hours, hour);
+            if (nextHour !== null) {
+                d.setUTCHours(nextHour, 0, 0, 0);
+            }
+            else {
+                // No matching hour left today — advance to next day
+                d.setUTCDate(d.getUTCDate() + 1);
+                d.setUTCHours(0, 0, 0, 0);
+            }
+            continue;
+        }
+        // Check minute
+        if (!cron.minutes.includes(minute)) {
+            const nextMin = findNext(cron.minutes, minute);
+            if (nextMin !== null) {
+                d.setUTCMinutes(nextMin, 0, 0);
+            }
+            else {
+                // No matching minute left this hour — advance to next hour
+                d.setUTCHours(d.getUTCHours() + 1, 0, 0, 0);
+            }
+            continue;
+        }
+        // All fields match!
+        return new Date(d.getTime());
+    }
+    // No match found within the search window
+    return null;
+}
+/**
+ * Convenience: parse a cron expression and compute the next run time.
+ *
+ * @param expression — 5-field cron expression string.
+ * @param after — Reference date (defaults to `new Date()`).
+ * @returns The next matching Date, or `null` if no match within 4 years.
+ * @throws {Error} if the cron expression is invalid.
+ */
+export function nextCronTickFromExpression(expression, after = new Date()) {
+    const cron = parseCron(expression);
+    return nextCronTick(cron, after);
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Find the next value in `sortedValues` that is greater than `current`.
+ * Returns `null` if no such value exists.
+ */
+function findNext(sortedValues, current) {
+    for (const v of sortedValues) {
+        if (v > current)
+            return v;
+    }
+    return null;
+}
+/**
+ * Advance `d` (mutated in place) to midnight UTC of the first day of the next
+ * month whose 1-based month number is in `months`.
+ */
+function advanceToNextMonth(d, months) {
+    let year = d.getUTCFullYear();
+    let month = d.getUTCMonth() + 1; // 1-based
+    // Walk months forward until we find one in the set (max 48 iterations = 4 years)
+    for (let i = 0; i < 48; i++) {
+        month++;
+        if (month > 12) {
+            month = 1;
+            year++;
+        }
+        if (months.includes(month)) {
+            d.setUTCFullYear(year, month - 1, 1);
+            d.setUTCHours(0, 0, 0, 0);
+            return;
+        }
+    }
+}
+//# sourceMappingURL=cron.js.map

package/dist/services/cron.js.map

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

package/dist/services/dashboard.d.ts

@@ -0,0 +1,34 @@
+import type { Db } from "@evermore.work/db";
+export declare function getUtcMonthStart(date: Date): Date;
+export declare function dashboardService(db: Db): {
+    summary: (companyId: string) => Promise<{
+        companyId: string;
+        agents: {
+            active: number;
+            running: number;
+            paused: number;
+            error: number;
+        };
+        tasks: Record<string, number>;
+        costs: {
+            monthSpendCents: number;
+            monthBudgetCents: number;
+            monthUtilizationPercent: number;
+        };
+        pendingApprovals: number;
+        budgets: {
+            activeIncidents: number;
+            pendingApprovals: number;
+            pausedAgents: number;
+            pausedProjects: number;
+        };
+        runActivity: {
+            date: string;
+            succeeded: number;
+            failed: number;
+            other: number;
+            total: number;
+        }[];
+    }>;
+};
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/services/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/services/dashboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAW5C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAEjD;AAUD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE;yBAGR,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsIpC"}

package/dist/services/dashboard.js

@@ -0,0 +1,142 @@
+import { and, eq, gte, sql } from "drizzle-orm";
+import { agents, approvals, companies, costEvents, heartbeatRuns, issues } from "@evermore.work/db";
+import { notFound } from "../errors.js";
+import { budgetService } from "./budgets.js";
+const DASHBOARD_RUN_ACTIVITY_DAYS = 14;
+function formatUtcDateKey(date) {
+    return date.toISOString().slice(0, 10);
+}
+export function getUtcMonthStart(date) {
+    return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1));
+}
+function getRecentUtcDateKeys(now, days) {
+    const todayUtc = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+    return Array.from({ length: days }, (_, index) => {
+        const dayOffset = index - (days - 1);
+        return formatUtcDateKey(new Date(todayUtc + dayOffset * 24 * 60 * 60 * 1000));
+    });
+}
+export function dashboardService(db) {
+    const budgets = budgetService(db);
+    return {
+        summary: async (companyId) => {
+            const company = await db
+                .select()
+                .from(companies)
+                .where(eq(companies.id, companyId))
+                .then((rows) => rows[0] ?? null);
+            if (!company)
+                throw notFound("Company not found");
+            const agentRows = await db
+                .select({ status: agents.status, count: sql `count(*)` })
+                .from(agents)
+                .where(eq(agents.companyId, companyId))
+                .groupBy(agents.status);
+            const taskRows = await db
+                .select({ status: issues.status, count: sql `count(*)` })
+                .from(issues)
+                .where(eq(issues.companyId, companyId))
+                .groupBy(issues.status);
+            const pendingApprovals = await db
+                .select({ count: sql `count(*)` })
+                .from(approvals)
+                .where(and(eq(approvals.companyId, companyId), eq(approvals.status, "pending")))
+                .then((rows) => Number(rows[0]?.count ?? 0));
+            const agentCounts = {
+                active: 0,
+                running: 0,
+                paused: 0,
+                error: 0,
+            };
+            for (const row of agentRows) {
+                const count = Number(row.count);
+                // "idle" agents are operational — count them as active
+                const bucket = row.status === "idle" ? "active" : row.status;
+                agentCounts[bucket] = (agentCounts[bucket] ?? 0) + count;
+            }
+            const taskCounts = {
+                open: 0,
+                inProgress: 0,
+                blocked: 0,
+                done: 0,
+            };
+            for (const row of taskRows) {
+                const count = Number(row.count);
+                if (row.status === "in_progress")
+                    taskCounts.inProgress += count;
+                if (row.status === "blocked")
+                    taskCounts.blocked += count;
+                if (row.status === "done")
+                    taskCounts.done += count;
+                if (row.status !== "done" && row.status !== "cancelled")
+                    taskCounts.open += count;
+            }
+            const now = new Date();
+            const monthStart = getUtcMonthStart(now);
+            const runActivityDays = getRecentUtcDateKeys(now, DASHBOARD_RUN_ACTIVITY_DAYS);
+            const runActivityStart = new Date(`${runActivityDays[0]}T00:00:00.000Z`);
+            const [{ monthSpend }] = await db
+                .select({
+                monthSpend: sql `coalesce(sum(${costEvents.costCents}), 0)::double precision`,
+            })
+                .from(costEvents)
+                .where(and(eq(costEvents.companyId, companyId), gte(costEvents.occurredAt, monthStart)));
+            const monthSpendCents = Number(monthSpend);
+            const runActivityDayExpr = sql `to_char(${heartbeatRuns.createdAt} at time zone 'UTC', 'YYYY-MM-DD')`;
+            const runActivityRows = await db
+                .select({
+                date: runActivityDayExpr,
+                status: heartbeatRuns.status,
+                count: sql `count(*)::double precision`,
+            })
+                .from(heartbeatRuns)
+                .where(and(eq(heartbeatRuns.companyId, companyId), gte(heartbeatRuns.createdAt, runActivityStart)))
+                .groupBy(runActivityDayExpr, heartbeatRuns.status);
+            const runActivity = new Map(runActivityDays.map((date) => [
+                date,
+                { date, succeeded: 0, failed: 0, other: 0, total: 0 },
+            ]));
+            for (const row of runActivityRows) {
+                const bucket = runActivity.get(row.date);
+                if (!bucket)
+                    continue;
+                const count = Number(row.count);
+                if (row.status === "succeeded")
+                    bucket.succeeded += count;
+                else if (row.status === "failed" || row.status === "timed_out")
+                    bucket.failed += count;
+                else
+                    bucket.other += count;
+                bucket.total += count;
+            }
+            const utilization = company.budgetMonthlyCents > 0
+                ? (monthSpendCents / company.budgetMonthlyCents) * 100
+                : 0;
+            const budgetOverview = await budgets.overview(companyId);
+            return {
+                companyId,
+                agents: {
+                    active: agentCounts.active,
+                    running: agentCounts.running,
+                    paused: agentCounts.paused,
+                    error: agentCounts.error,
+                },
+                tasks: taskCounts,
+                costs: {
+                    monthSpendCents,
+                    monthBudgetCents: company.budgetMonthlyCents,
+                    monthUtilizationPercent: Number(utilization.toFixed(2)),
+                },
+                pendingApprovals,
+                budgets: {
+                    activeIncidents: budgetOverview.activeIncidents.length,
+                    pendingApprovals: budgetOverview.pendingApprovalCount,
+                    pausedAgents: budgetOverview.pausedAgentCount,
+                    pausedProjects: budgetOverview.pausedProjectCount,
+                },
+                runActivity: Array.from(runActivity.values()),
+            };
+        },
+    };
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/services/dashboard.js.map

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

package/dist/services/default-agent-instructions.d.ts

@@ -0,0 +1,9 @@
+declare const DEFAULT_AGENT_BUNDLE_FILES: {
+    readonly default: readonly ["AGENTS.md"];
+    readonly ceo: readonly ["AGENTS.md", "HEARTBEAT.md", "SOUL.md", "TOOLS.md"];
+};
+type DefaultAgentBundleRole = keyof typeof DEFAULT_AGENT_BUNDLE_FILES;
+export declare function loadDefaultAgentInstructionsBundle(role: DefaultAgentBundleRole): Promise<Record<string, string>>;
+export declare function resolveDefaultAgentInstructionsBundleRole(role: string): DefaultAgentBundleRole;
+export {};
+//# sourceMappingURL=default-agent-instructions.d.ts.map

package/dist/services/default-agent-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-agent-instructions.d.ts","sourceRoot":"","sources":["../../src/services/default-agent-instructions.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,0BAA0B;;;CAGtB,CAAC;AAEX,KAAK,sBAAsB,GAAG,MAAM,OAAO,0BAA0B,CAAC;AAMtE,wBAAsB,kCAAkC,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAStH;AAED,wBAAgB,yCAAyC,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAE9F"}

package/dist/services/default-agent-instructions.js

@@ -0,0 +1,20 @@
+import fs from "node:fs/promises";
+const DEFAULT_AGENT_BUNDLE_FILES = {
+    default: ["AGENTS.md"],
+    ceo: ["AGENTS.md", "HEARTBEAT.md", "SOUL.md", "TOOLS.md"],
+};
+function resolveDefaultAgentBundleUrl(role, fileName) {
+    return new URL(`../onboarding-assets/${role}/${fileName}`, import.meta.url);
+}
+export async function loadDefaultAgentInstructionsBundle(role) {
+    const fileNames = DEFAULT_AGENT_BUNDLE_FILES[role];
+    const entries = await Promise.all(fileNames.map(async (fileName) => {
+        const content = await fs.readFile(resolveDefaultAgentBundleUrl(role, fileName), "utf8");
+        return [fileName, content];
+    }));
+    return Object.fromEntries(entries);
+}
+export function resolveDefaultAgentInstructionsBundleRole(role) {
+    return role === "ceo" ? "ceo" : "default";
+}
+//# sourceMappingURL=default-agent-instructions.js.map

package/dist/services/default-agent-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-agent-instructions.js","sourceRoot":"","sources":["../../src/services/default-agent-instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,MAAM,0BAA0B,GAAG;IACjC,OAAO,EAAE,CAAC,WAAW,CAAC;IACtB,GAAG,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,CAAC;CACjD,CAAC;AAIX,SAAS,4BAA4B,CAAC,IAA4B,EAAE,QAAgB;IAClF,OAAO,IAAI,GAAG,CAAC,wBAAwB,IAAI,IAAI,QAAQ,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CAAC,IAA4B;IACnF,MAAM,SAAS,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACxF,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAU,CAAC;IACtC,CAAC,CAAC,CACH,CAAC;IACF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,yCAAyC,CAAC,IAAY;IACpE,OAAO,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC"}