@todu/engine 0.1.0

package/dist/storage.js

@@ -0,0 +1,204 @@
+import fs from "node:fs";
+import path from "node:path";
+import { Repo } from "@automerge/automerge-repo";
+import { NodeFSStorageAdapter } from "@automerge/automerge-repo-storage-nodefs";
+import { CATALOG_DOC_KEY, createEmptyCatalog, SCHEMA_VERSION, } from "@todu/core";
+// ============================================================================
+// Storage layer — Automerge repo + document management
+// ============================================================================
+/** Sync message throttle interval in Automerge (see helpers/throttle.js) */
+const SYNC_THROTTLE_MS = 100;
+/** Extra time after sync message generation for WebSocket delivery */
+const SYNC_DELIVERY_MS = 20;
+/**
+ * Wait for pending sync messages to be generated and delivered.
+ *
+ * Automerge batches sync messages on a ~100ms throttle. After a mutation,
+ * we wait for the "generate-sync-message" event (confirming the change was
+ * packaged for sending), then yield briefly for the WebSocket to deliver
+ * the bytes. If no sync message arrives within the throttle window,
+ * there's nothing pending — return immediately.
+ */
+async function waitForSyncFlush(repo, documentId) {
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            repo.off("doc-metrics", onMetrics);
+            resolve();
+        }, SYNC_THROTTLE_MS + SYNC_DELIVERY_MS);
+        function onMetrics(m) {
+            if (m.type === "generate-sync-message" && m.documentId === documentId) {
+                repo.off("doc-metrics", onMetrics);
+                clearTimeout(timeout);
+                // Yield for WebSocket to deliver the bytes
+                setTimeout(resolve, SYNC_DELIVERY_MS);
+            }
+        }
+        repo.on("doc-metrics", onMetrics);
+    });
+}
+/**
+ * Initialize storage: create data directory, set up Automerge repo,
+ * and load or create the catalog document.
+ */
+export async function initStorage(storagePath) {
+    // Ensure data directory exists
+    fs.mkdirSync(storagePath, { recursive: true });
+    // Create Automerge repo with filesystem storage
+    const repo = new Repo({
+        storage: new NodeFSStorageAdapter(storagePath),
+    });
+    // Load or create catalog document
+    const catalog = await loadOrCreateCatalog(repo, storagePath);
+    return {
+        repo,
+        catalog,
+        ephemeral: false,
+        async close() {
+            await repo.flush();
+            await repo.shutdown();
+        },
+    };
+}
+/**
+ * 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 async function initEphemeralStorage(storagePath) {
+    // Read the catalog document ID from the marker file
+    const markerPath = path.join(storagePath, `${CATALOG_DOC_KEY}.id`);
+    if (!fs.existsSync(markerPath)) {
+        throw new Error("No catalog marker found. Run the Electron app or CLI standalone first to create data.");
+    }
+    const docId = fs.readFileSync(markerPath, "utf-8").trim();
+    // Create repo with no storage — purely in-memory
+    const repo = new Repo({});
+    return {
+        repo,
+        ephemeral: true,
+        async close() {
+            try {
+                await repo.shutdown();
+            }
+            catch {
+                // Safe to ignore — adapters may already be disconnected
+            }
+        },
+        async findCatalog() {
+            // Now that sync is connected, find the catalog document.
+            // Allow "requesting" state so find() doesn't fail while waiting
+            // for the sync peer to deliver the document data.
+            const catalog = await repo.find(docId, {
+                allowableStates: ["ready", "requesting", "loading"],
+            });
+            // Wait for the document to actually be ready (populated via sync)
+            await catalog.whenReady();
+            return {
+                repo,
+                catalog,
+                ephemeral: true,
+                async close() {
+                    // Wait for any pending mutations to be synced to the server.
+                    // Automerge throttles sync messages (~100ms batches), so after
+                    // a change() call the sync message won't be sent immediately.
+                    // We listen for the "generate-sync-message" event to know the
+                    // message was queued, then yield briefly for the WebSocket to
+                    // deliver the bytes before shutting down.
+                    await waitForSyncFlush(repo, docId);
+                    try {
+                        await repo.shutdown();
+                    }
+                    catch {
+                        // Safe to ignore — adapters may already be disconnected
+                    }
+                },
+            };
+        },
+    };
+}
+/**
+ * Load existing catalog document or create a new one.
+ * Uses a marker file to store the document ID between sessions.
+ */
+async function loadOrCreateCatalog(repo, storagePath) {
+    const markerPath = path.join(storagePath, `${CATALOG_DOC_KEY}.id`);
+    // Try to load existing catalog
+    if (fs.existsSync(markerPath)) {
+        const docId = fs.readFileSync(markerPath, "utf-8").trim();
+        const handle = await repo.find(docId);
+        migrateCatalog(handle);
+        return handle;
+    }
+    // Create new catalog
+    const handle = repo.create();
+    handle.change((doc) => {
+        const empty = createEmptyCatalog();
+        doc.version = empty.version;
+        doc.projects = empty.projects;
+        doc.labels = empty.labels;
+        doc.recurringTemplates = empty.recurringTemplates;
+        doc.habits = empty.habits;
+        doc.habitLogDocIds = empty.habitLogDocIds;
+        doc.taskListDocIds = empty.taskListDocIds;
+        doc.settings = empty.settings;
+    });
+    // Save document ID for next session
+    fs.writeFileSync(markerPath, handle.documentId, "utf-8");
+    return handle;
+}
+/**
+ * Migrate an existing catalog document to the current schema.
+ * Backfills any missing fields that were added in later versions.
+ * This ensures engine code can always assume catalog fields exist.
+ */
+function migrateCatalog(handle) {
+    const doc = handle.doc();
+    if (!doc)
+        return;
+    const defaults = createEmptyCatalog();
+    let needsMigration = false;
+    // Check for missing fields
+    if (!Array.isArray(doc.projects))
+        needsMigration = true;
+    if (!Array.isArray(doc.labels))
+        needsMigration = true;
+    if (!Array.isArray(doc.recurringTemplates))
+        needsMigration = true;
+    if (!Array.isArray(doc.habits))
+        needsMigration = true;
+    if (doc.taskListDocIds === undefined || doc.taskListDocIds === null)
+        needsMigration = true;
+    if (doc.habitLogDocIds === undefined || doc.habitLogDocIds === null)
+        needsMigration = true;
+    if (doc.settings === undefined || doc.settings === null)
+        needsMigration = true;
+    if (doc.version === undefined || doc.version === null)
+        needsMigration = true;
+    if (!needsMigration)
+        return;
+    handle.change((d) => {
+        if (!Array.isArray(d.projects))
+            d.projects = defaults.projects;
+        if (!Array.isArray(d.labels))
+            d.labels = defaults.labels;
+        if (!Array.isArray(d.recurringTemplates))
+            d.recurringTemplates = defaults.recurringTemplates;
+        if (!Array.isArray(d.habits))
+            d.habits = defaults.habits;
+        if (d.taskListDocIds === undefined || d.taskListDocIds === null)
+            d.taskListDocIds = defaults.taskListDocIds;
+        if (d.habitLogDocIds === undefined || d.habitLogDocIds === null)
+            d.habitLogDocIds = defaults.habitLogDocIds;
+        if (d.settings === undefined || d.settings === null)
+            d.settings = defaults.settings;
+        if (d.version === undefined || d.version === null)
+            d.version = SCHEMA_VERSION;
+    });
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/sync-client.d.ts

@@ -0,0 +1,16 @@
+import type { Repo } from "@automerge/automerge-repo";
+export declare const DEFAULT_SYNC_URL = "ws://127.0.0.1:24377";
+/**
+ * Add a sync client adapter to a Repo, connecting to a remote sync server.
+ * Waits for the adapter to be ready before returning.
+ * Returns a disconnect function.
+ *
+ * @param retryInterval - Retry interval in ms if connection fails (default: 500ms for local)
+ */
+export declare function connectSyncClient(repo: Repo, url?: string, retryInterval?: number): Promise<() => void>;
+/**
+ * Check if a sync server is reachable at the given URL.
+ * Returns true if the connection succeeds within the timeout.
+ */
+export declare function isSyncServerAvailable(url?: string, timeoutMs?: number): Promise<boolean>;
+//# sourceMappingURL=sync-client.d.ts.map

package/dist/sync-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-client.d.ts","sourceRoot":"","sources":["../src/sync-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAGtD,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,EACV,GAAG,GAAE,MAAyB,EAC9B,aAAa,SAAM,GAClB,OAAO,CAAC,MAAM,IAAI,CAAC,CAcrB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,GAAE,MAAyB,EAC9B,SAAS,SAAM,GACd,OAAO,CAAC,OAAO,CAAC,CA2BlB"}

package/dist/sync-client.js

@@ -0,0 +1,54 @@
+import { WebSocketClientAdapter } from "@automerge/automerge-repo-network-websocket";
+export const DEFAULT_SYNC_URL = "ws://127.0.0.1:24377";
+/**
+ * Add a sync client adapter to a Repo, connecting to a remote sync server.
+ * Waits for the adapter to be ready before returning.
+ * Returns a disconnect function.
+ *
+ * @param retryInterval - Retry interval in ms if connection fails (default: 500ms for local)
+ */
+export async function connectSyncClient(repo, url = DEFAULT_SYNC_URL, retryInterval = 500) {
+    const adapter = new WebSocketClientAdapter(url, retryInterval);
+    repo.networkSubsystem.addNetworkAdapter(adapter);
+    // Wait for the WebSocket connection to establish
+    await adapter.whenReady();
+    return () => {
+        try {
+            adapter.disconnect();
+        }
+        catch {
+            // WebSocket may already be closed — safe to ignore
+        }
+    };
+}
+/**
+ * Check if a sync server is reachable at the given URL.
+ * Returns true if the connection succeeds within the timeout.
+ */
+export async function isSyncServerAvailable(url = DEFAULT_SYNC_URL, timeoutMs = 200) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            resolve(false);
+        }, timeoutMs);
+        try {
+            // Use dynamic import for ws since it's CJS
+            import("ws").then(({ default: WebSocket }) => {
+                const ws = new WebSocket(url);
+                ws.onopen = () => {
+                    clearTimeout(timer);
+                    ws.close();
+                    resolve(true);
+                };
+                ws.onerror = () => {
+                    clearTimeout(timer);
+                    resolve(false);
+                };
+            });
+        }
+        catch {
+            clearTimeout(timer);
+            resolve(false);
+        }
+    });
+}
+//# sourceMappingURL=sync-client.js.map

package/dist/sync-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-client.js","sourceRoot":"","sources":["../src/sync-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAErF,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAU,EACV,GAAG,GAAW,gBAAgB,EAC9B,aAAa,GAAG,GAAG,EACE;IACrB,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC/D,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEjD,iDAAiD;IACjD,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;IAE1B,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,CAAC;YACH,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,qDAAmD;QACrD,CAAC;IAAA,CACF,CAAC;AAAA,CACH;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAG,GAAW,gBAAgB,EAC9B,SAAS,GAAG,GAAG,EACG;IAClB,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,CAAC;QAAA,CAChB,EAAE,SAAS,CAAC,CAAC;QAEd,IAAI,CAAC;YACH,2CAA2C;YAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;gBAC5C,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;gBAE9B,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBAChB,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,EAAE,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,CAAC,IAAI,CAAC,CAAC;gBAAA,CACf,CAAC;gBAEF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;oBACjB,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,OAAO,CAAC,KAAK,CAAC,CAAC;gBAAA,CAChB,CAAC;YAAA,CACH,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IAAA,CACF,CAAC,CAAC;AAAA,CACJ"}

package/dist/sync-server.d.ts

@@ -0,0 +1,12 @@
+import type { Repo } from "@automerge/automerge-repo";
+export declare const DEFAULT_SYNC_PORT = 24377;
+export interface SyncServer {
+    port: number;
+    close(): Promise<void>;
+}
+/**
+ * Start a WebSocket sync server and attach it to an Automerge Repo.
+ * Other Repo instances (CLI, other devices) can connect and sync documents.
+ */
+export declare function startSyncServer(repo: Repo, port?: number): SyncServer;
+//# sourceMappingURL=sync-server.d.ts.map

package/dist/sync-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-server.d.ts","sourceRoot":"","sources":["../src/sync-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAKtD,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,GAAE,MAA0B,GAAG,UAAU,CAaxF"}

package/dist/sync-server.js

@@ -0,0 +1,21 @@
+import { WebSocketServerAdapter } from "@automerge/automerge-repo-network-websocket";
+import { WebSocketServer } from "ws";
+export const DEFAULT_SYNC_PORT = 24377;
+/**
+ * Start a WebSocket sync server and attach it to an Automerge Repo.
+ * Other Repo instances (CLI, other devices) can connect and sync documents.
+ */
+export function startSyncServer(repo, port = DEFAULT_SYNC_PORT) {
+    const wss = new WebSocketServer({ host: "127.0.0.1", port });
+    const adapter = new WebSocketServerAdapter(wss);
+    repo.networkSubsystem.addNetworkAdapter(adapter);
+    return {
+        port,
+        close() {
+            return new Promise((resolve) => {
+                wss.close(() => resolve());
+            });
+        },
+    };
+}
+//# sourceMappingURL=sync-server.js.map

package/dist/sync-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-server.js","sourceRoot":"","sources":["../src/sync-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAOvC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAU,EAAE,IAAI,GAAW,iBAAiB,EAAc;IACxF,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC,GAAoC,CAAC,CAAC;IACjF,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEjD,OAAO;QACL,IAAI;QACJ,KAAK,GAAG;YACN,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBACpC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAAA,CAC5B,CAAC,CAAC;QAAA,CACJ;KACF,CAAC;AAAA,CACH"}

package/dist/tasks.d.ts

@@ -0,0 +1,18 @@
+import type { DocHandle, Repo } from "@automerge/automerge-repo";
+import { type CatalogDocument, type CreateTaskInput, type Result, type TaskId, type TaskWithDetail } from "@todu/core";
+import type { TaskNamespace } from "./todu.js";
+/**
+ * Extended task namespace with internal methods for use by recurring templates.
+ * The public TaskNamespace is a subset of this.
+ */
+export interface InternalTaskNamespace extends TaskNamespace {
+    /**
+     * Create a task with a specific ID and optional templateId.
+     * Used by recurring template task generation.
+     */
+    create(input: CreateTaskInput, taskId?: TaskId, templateId?: string): Promise<Result<TaskWithDetail>>;
+    /** Expose repo for recurring template task lookup */
+    _repo: Repo;
+}
+export declare function createTaskNamespace(catalog: DocHandle<CatalogDocument>, repo: Repo): InternalTaskNamespace;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAc,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EAQpB,KAAK,MAAM,EAIX,KAAK,MAAM,EAIX,KAAK,cAAc,EAKpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAM/C;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D;;;OAGG;IACH,MAAM,CACJ,KAAK,EAAE,eAAe,EACtB,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;IAEnC,qDAAqD;IACrD,KAAK,EAAE,IAAI,CAAC;CACb;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC,EACnC,IAAI,EAAE,IAAI,GACT,qBAAqB,CAsYvB"}