@todu/engine 0.1.0

package/dist/schedule.js

@@ -0,0 +1,330 @@
+import { validateRRule as coreValidateRRule, validationError, } from "@todu/core";
+// rrule is CJS. Node wraps it in { default: ... }, Bun resolves ESM named exports.
+// Use namespace import and unwrap at runtime to support both.
+import * as rruleNs from "rrule";
+// biome-ignore lint/suspicious/noExplicitAny: CJS/ESM interop requires runtime detection
+const rruleMod = rruleNs.default ?? rruleNs;
+const RRule = rruleMod.RRule;
+/** Internal: create an RRule from parsed options */
+function createRRule(options) {
+    return new RRule(options);
+}
+/** Internal: parse an RRULE string into options */
+function parseRRuleString(rule) {
+    return RRule.parseString(rule);
+}
+// ============================================================================
+// RRULE parsing and occurrence calculation
+// ============================================================================
+/**
+ * Parse an RRULE string into an internal RRule instance with a start date.
+ * Returns the instance for use by nextOccurrence/nextOccurrences.
+ * The RRule type is not exposed — consumers use the higher-level functions.
+ */
+function parseRule(rule, startDate, timezone) {
+    // Validate format first
+    const formatError = coreValidateRRule(rule);
+    if (formatError)
+        return { error: formatError };
+    try {
+        // Parse start date as a Date in UTC (rrule library works in UTC internally)
+        const dtstart = dateStringToUTC(startDate, timezone);
+        // Parse the RRULE string and create instance
+        const parsed = parseRRuleString(rule);
+        const rrule = createRRule({
+            ...parsed,
+            dtstart,
+        });
+        return { rrule };
+    }
+    catch (e) {
+        return {
+            error: validationError("schedule", `Failed to parse RRULE: ${e instanceof Error ? e.message : String(e)}`),
+        };
+    }
+}
+/**
+ * Calculate the next occurrence after a given date.
+ *
+ * @param rule - RRULE string
+ * @param startDate - Schedule start date (YYYY-MM-DD)
+ * @param timezone - IANA timezone
+ * @param afterDate - Find next occurrence after this date (YYYY-MM-DD)
+ * @param endDate - Optional end date (YYYY-MM-DD) — no occurrences after this
+ * @returns Next occurrence as YYYY-MM-DD string, or null if no more occurrences
+ */
+export function nextOccurrence(rule, startDate, timezone, afterDate, endDate) {
+    const parsed = parseRule(rule, startDate, timezone);
+    if (parsed.error)
+        return null;
+    const after = dateStringToUTC(afterDate, timezone);
+    const next = parsed.rrule.after(after);
+    if (!next)
+        return null;
+    // Convert back to date string in the template's timezone
+    const dateStr = utcToDateString(next, timezone);
+    // Check against end date
+    if (endDate && dateStr > endDate)
+        return null;
+    return dateStr;
+}
+/**
+ * Calculate the next N occurrences starting from a given date (inclusive).
+ * Used for the "upcoming" view.
+ *
+ * @param rule - RRULE string
+ * @param startDate - Schedule start date (YYYY-MM-DD)
+ * @param timezone - IANA timezone
+ * @param fromDate - Start listing from this date (YYYY-MM-DD), inclusive
+ * @param count - Number of occurrences to return
+ * @param endDate - Optional end date (YYYY-MM-DD)
+ * @returns Array of YYYY-MM-DD date strings
+ */
+export function nextOccurrences(rule, startDate, timezone, fromDate, count, endDate) {
+    const parsed = parseRule(rule, startDate, timezone);
+    if (parsed.error)
+        return [];
+    const results = [];
+    // Get occurrences starting from the day before fromDate
+    // (so fromDate itself is included if it matches)
+    const dayBefore = shiftDate(fromDate, -1);
+    const after = dateStringToUTC(dayBefore, timezone);
+    // Use between() for bounded queries when we have an end date
+    const effectiveEnd = endDate ? dateStringToUTC(endDate, timezone) : null;
+    let current = parsed.rrule.after(after);
+    while (current && results.length < count) {
+        const dateStr = utcToDateString(current, timezone);
+        // Check end date
+        if (effectiveEnd && current > effectiveEnd)
+            break;
+        results.push(dateStr);
+        current = parsed.rrule.after(current);
+    }
+    return results;
+}
+/**
+ * Check if a specific date is a valid occurrence of the schedule.
+ * Used to validate early materialization requests.
+ */
+export function isScheduledDate(rule, startDate, timezone, date, endDate) {
+    const parsed = parseRule(rule, startDate, timezone);
+    if (parsed.error)
+        return false;
+    // Check if date is within bounds
+    if (date < startDate)
+        return false;
+    if (endDate && date > endDate)
+        return false;
+    // Check the day before to see if this date is the next occurrence
+    const dayBefore = shiftDate(date, -1);
+    const after = dateStringToUTC(dayBefore, timezone);
+    const next = parsed.rrule.after(after);
+    if (!next)
+        return false;
+    const nextStr = utcToDateString(next, timezone);
+    return nextStr === date;
+}
+// ============================================================================
+// Human-readable schedule descriptions
+// ============================================================================
+const DAY_NAMES = {
+    MO: "Monday",
+    TU: "Tuesday",
+    WE: "Wednesday",
+    TH: "Thursday",
+    FR: "Friday",
+    SA: "Saturday",
+    SU: "Sunday",
+};
+const SHORT_DAY_NAMES = {
+    MO: "Mon",
+    TU: "Tue",
+    WE: "Wed",
+    TH: "Thu",
+    FR: "Fri",
+    SA: "Sat",
+    SU: "Sun",
+};
+/**
+ * Convert an RRULE string to a human-readable description.
+ */
+export function describeSchedule(rule) {
+    const parts = parseRRuleParts(rule);
+    const freq = (parts.FREQ || "").toUpperCase();
+    const interval = parts.INTERVAL ? Number.parseInt(parts.INTERVAL, 10) : 1;
+    const byday = parts.BYDAY;
+    const bymonthday = parts.BYMONTHDAY;
+    const bymonth = parts.BYMONTH;
+    switch (freq) {
+        case "DAILY": {
+            if (interval === 1) {
+                if (byday)
+                    return `Daily on ${formatDayList(byday)}`;
+                return "Daily";
+            }
+            return `Every ${interval} days`;
+        }
+        case "WEEKLY": {
+            const prefix = interval === 1 ? "Weekly" : `Every ${interval} weeks`;
+            if (byday) {
+                const days = byday.split(",");
+                // Check for common patterns
+                if (isWeekdays(days))
+                    return interval === 1 ? "Every weekday" : `${prefix} on weekdays`;
+                return `${prefix} on ${formatDayList(byday)}`;
+            }
+            return prefix;
+        }
+        case "MONTHLY": {
+            const prefix = interval === 1 ? "Monthly" : `Every ${interval} months`;
+            if (bymonthday)
+                return `${prefix} on day ${bymonthday}`;
+            return prefix;
+        }
+        case "YEARLY": {
+            const prefix = interval === 1 ? "Yearly" : `Every ${interval} years`;
+            if (bymonth && bymonthday) {
+                const monthName = getMonthName(Number.parseInt(bymonth, 10));
+                return `${prefix} on ${monthName} ${bymonthday}`;
+            }
+            return prefix;
+        }
+        default:
+            return rule;
+    }
+}
+// ============================================================================
+// Today helper — get current date in a timezone
+// ============================================================================
+/**
+ * Get today's date in the given timezone as YYYY-MM-DD.
+ */
+export function todayInTimezone(timezone) {
+    const formatter = new Intl.DateTimeFormat("en-CA", {
+        timeZone: timezone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    });
+    return formatter.format(new Date());
+}
+// ============================================================================
+// Internal helpers
+// ============================================================================
+/**
+ * Convert a YYYY-MM-DD date string to a UTC Date object,
+ * treating the date as midnight in the given timezone.
+ */
+function dateStringToUTC(dateStr, timezone) {
+    // Parse the date parts
+    const [year, month, day] = dateStr.split("-").map(Number);
+    // Create a date at midnight UTC first
+    const utcDate = new Date(Date.UTC(year, month - 1, day));
+    // Get the timezone offset for this date
+    // We use a formatter to determine what time it is in the target timezone
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        year: "numeric",
+        month: "numeric",
+        day: "numeric",
+        hour: "numeric",
+        minute: "numeric",
+        hourCycle: "h23",
+    });
+    // Find the offset by comparing the formatted date to the UTC date
+    const parts = formatter.formatToParts(utcDate);
+    const getPart = (type) => Number(parts.find((p) => p.type === type)?.value || 0);
+    const tzYear = getPart("year");
+    const tzMonth = getPart("month");
+    const tzDay = getPart("day");
+    const tzHour = getPart("hour");
+    const tzMinute = getPart("minute");
+    // If the timezone date differs from what we want, we need to adjust
+    // We want midnight in the target timezone
+    const tzDate = new Date(Date.UTC(tzYear, tzMonth - 1, tzDay, tzHour, tzMinute));
+    const offsetMs = tzDate.getTime() - utcDate.getTime();
+    // Midnight in the target timezone = UTC midnight minus the offset
+    return new Date(Date.UTC(year, month - 1, day) - offsetMs);
+}
+/**
+ * Convert a UTC Date object to a YYYY-MM-DD string in the given timezone.
+ */
+function utcToDateString(date, timezone) {
+    const formatter = new Intl.DateTimeFormat("en-CA", {
+        timeZone: timezone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    });
+    return formatter.format(date);
+}
+/**
+ * Shift a YYYY-MM-DD date string by N days.
+ */
+function shiftDate(dateStr, days) {
+    const [year, month, day] = dateStr.split("-").map(Number);
+    const date = new Date(Date.UTC(year, month - 1, day + days));
+    const y = date.getUTCFullYear();
+    const m = String(date.getUTCMonth() + 1).padStart(2, "0");
+    const d = String(date.getUTCDate()).padStart(2, "0");
+    return `${y}-${m}-${d}`;
+}
+/**
+ * Parse an RRULE string into key-value pairs.
+ */
+function parseRRuleParts(rule) {
+    const result = {};
+    for (const part of rule.split(";")) {
+        const [key, value] = part.split("=", 2);
+        if (key && value) {
+            result[key.toUpperCase()] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Format a comma-separated BYDAY list into human-readable form.
+ */
+function formatDayList(byday) {
+    const days = byday.split(",").map((d) => d.trim().toUpperCase());
+    if (days.length === 1) {
+        return DAY_NAMES[days[0]] || days[0];
+    }
+    // Use short names for multiple days
+    const names = days.map((d) => SHORT_DAY_NAMES[d] || d);
+    if (names.length === 2) {
+        return `${names[0]} and ${names[1]}`;
+    }
+    return `${names.slice(0, -1).join(", ")}, and ${names[names.length - 1]}`;
+}
+/**
+ * Check if a set of days represents weekdays (Mon-Fri).
+ */
+function isWeekdays(days) {
+    const weekdays = new Set(["MO", "TU", "WE", "TH", "FR"]);
+    if (days.length !== 5)
+        return false;
+    return days.every((d) => weekdays.has(d.toUpperCase()));
+}
+/**
+ * Get month name from number (1-12).
+ */
+function getMonthName(month) {
+    const names = [
+        "",
+        "January",
+        "February",
+        "March",
+        "April",
+        "May",
+        "June",
+        "July",
+        "August",
+        "September",
+        "October",
+        "November",
+        "December",
+    ];
+    return names[month] || String(month);
+}
+//# sourceMappingURL=schedule.js.map

package/dist/schedule.js.map

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

package/dist/scheduling.d.ts

@@ -0,0 +1,62 @@
+import type { DocHandle } from "@automerge/automerge-repo";
+import type { CatalogDocument } from "@todu/core";
+/**
+ * A schedulable item from the catalog — either a recurring template or a habit.
+ * Both share these fields that the framework needs to check.
+ */
+export interface SchedulableItem {
+    id: string;
+    nextDue: string;
+    timezone: string;
+    paused: boolean;
+    endDate?: string;
+}
+/**
+ * Context passed to template processors during processTemplates().
+ * Processors determine "today" per-item using todayInTimezone()
+ * with each item's configured timezone.
+ */
+export interface ProcessingContext {
+    /** The catalog document handle for reading/writing */
+    catalog: DocHandle<CatalogDocument>;
+}
+/**
+ * A handler that processes due items of a specific type.
+ * Registered by recurring templates and habits modules.
+ *
+ * @param context - Processing context with catalog access
+ * @returns Number of items processed
+ */
+export type TemplateProcessor = (context: ProcessingContext) => Promise<number>;
+/**
+ * Register a template processor.
+ * Called by recurring.ts and habits.ts to register their processing logic.
+ *
+ * @param type - Processor type identifier (e.g., "recurring", "habit")
+ * @param processor - The processing function
+ */
+export declare function registerProcessor(type: string, processor: TemplateProcessor): void;
+/**
+ * Clear all registered processors.
+ * Used in tests to reset state between runs.
+ */
+export declare function clearProcessors(): void;
+/**
+ * Get all registered processor types.
+ * Used in tests to verify registration.
+ */
+export declare function getRegisteredProcessors(): string[];
+/**
+ * Process all due templates and habits.
+ *
+ * Called during createTodu() initialization. Runs each registered
+ * processor in sequence. Each processor is responsible for:
+ * 1. Reading its items from the catalog
+ * 2. Checking which are due (nextDue <= today, not paused)
+ * 3. Performing the appropriate action (generate tasks, advance nextDue, etc.)
+ *
+ * This function is the single entry point — no daemon, no polling,
+ * no on-complete triggers. Just process on access.
+ */
+export declare function processTemplates(catalog: DocHandle<CatalogDocument>): Promise<void>;
+//# sourceMappingURL=scheduling.d.ts.map

package/dist/scheduling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../src/scheduling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;CACrC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAQhF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAElF;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBzF"}

package/dist/scheduling.js

@@ -0,0 +1,58 @@
+/**
+ * Registry of template processors.
+ * Each processor handles a specific type of schedulable item.
+ */
+const processors = new Map();
+/**
+ * Register a template processor.
+ * Called by recurring.ts and habits.ts to register their processing logic.
+ *
+ * @param type - Processor type identifier (e.g., "recurring", "habit")
+ * @param processor - The processing function
+ */
+export function registerProcessor(type, processor) {
+    processors.set(type, processor);
+}
+/**
+ * Clear all registered processors.
+ * Used in tests to reset state between runs.
+ */
+export function clearProcessors() {
+    processors.clear();
+}
+/**
+ * Get all registered processor types.
+ * Used in tests to verify registration.
+ */
+export function getRegisteredProcessors() {
+    return Array.from(processors.keys());
+}
+/**
+ * Process all due templates and habits.
+ *
+ * Called during createTodu() initialization. Runs each registered
+ * processor in sequence. Each processor is responsible for:
+ * 1. Reading its items from the catalog
+ * 2. Checking which are due (nextDue <= today, not paused)
+ * 3. Performing the appropriate action (generate tasks, advance nextDue, etc.)
+ *
+ * This function is the single entry point — no daemon, no polling,
+ * no on-complete triggers. Just process on access.
+ */
+export async function processTemplates(catalog) {
+    if (processors.size === 0)
+        return;
+    for (const [type, processor] of processors) {
+        try {
+            const context = {
+                catalog,
+            };
+            await processor(context);
+        }
+        catch (e) {
+            // Log but don't fail — one processor failing shouldn't block others
+            console.error(`[scheduling] processor "${type}" failed:`, e instanceof Error ? e.message : String(e));
+        }
+    }
+}
+//# sourceMappingURL=scheduling.js.map

package/dist/scheduling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.js","sourceRoot":"","sources":["../src/scheduling.ts"],"names":[],"mappings":"AAsCA;;;GAGG;AACH,MAAM,UAAU,GAAmC,IAAI,GAAG,EAAE,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,SAA4B,EAAQ;IAClF,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAAA,CACjC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,GAAS;IACtC,UAAU,CAAC,KAAK,EAAE,CAAC;AAAA,CACpB;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,GAAa;IAClD,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;AAAA,CACtC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAmC,EAAiB;IACzF,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IAElC,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,OAAO,GAAsB;gBACjC,OAAO;aACR,CAAC;YACF,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,sEAAoE;YACpE,OAAO,CAAC,KAAK,CACX,2BAA2B,IAAI,WAAW,EAC1C,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAC3C,CAAC;QACJ,CAAC;IACH,CAAC;AAAA,CACF"}

package/dist/storage.d.ts

@@ -0,0 +1,34 @@
+import type { DocHandle } from "@automerge/automerge-repo";
+import { Repo } from "@automerge/automerge-repo";
+import { type CatalogDocument } from "@todu/core";
+export interface Storage {
+    /** The Automerge repo instance */
+    repo: Repo;
+    /** The catalog document handle */
+    catalog: DocHandle<CatalogDocument>;
+    /** Whether this storage is ephemeral (in-memory, no persistence) */
+    ephemeral: boolean;
+    /** Shut down the repo */
+    close(): Promise<void>;
+}
+/**
+ * Initialize storage: create data directory, set up Automerge repo,
+ * and load or create the catalog document.
+ */
+export declare function initStorage(storagePath: string): Promise<Storage>;
+/**
+ * Initialize ephemeral storage with no filesystem persistence.
+ * Used by CLI when syncing with a running Electron instance.
+ *
+ * Creates an in-memory Automerge repo and reads the catalog document ID
+ * from the marker file (written by the persistent owner).
+ *
+ * IMPORTANT: The caller must connect a sync adapter to the repo BEFORE
+ * calling `findCatalog()`. The ephemeral repo has no local data — it
+ * needs a sync peer to provide the document contents.
+ */
+export declare function initEphemeralStorage(storagePath: string): Promise<Omit<Storage, "catalog"> & {
+    /** Find the catalog document via sync. Call AFTER connecting a sync adapter. */
+    findCatalog(): Promise<Storage>;
+}>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAEjD,OAAO,EAEL,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAC;AAwCpB,MAAM,WAAW,OAAO;IACtB,kCAAkC;IAClC,IAAI,EAAE,IAAI,CAAC;IAEX,kCAAkC;IAClC,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IAEpC,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;IAEnB,yBAAyB;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBvE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CACtE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG;IACzB,gFAAgF;IAChF,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,CACF,CAwDA"}