opentasks 0.0.1 → 0.0.3

package/dist/storage/jsonl.js

@@ -0,0 +1,218 @@
+/**
+ * JSONL Persister for OpenTasks
+ *
+ * Git-friendly JSONL storage as source of truth.
+ * Each line is a JSON object (node or edge).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { atomicWrite, appendToFile, fileExists, readFileOrEmpty } from './atomic-write.js';
+/**
+ * Determine if a parsed JSON object is an edge
+ *
+ * Edges have from_id and to_id fields, or id starting with 'x-'
+ */
+function isEdge(obj) {
+    return (('from_id' in obj && 'to_id' in obj) || (typeof obj.id === 'string' && obj.id.startsWith('x-')));
+}
+/**
+ * JSONL Persister
+ *
+ * Handles reading/writing graph data to JSONL files.
+ * Source of truth for OpenTasks data.
+ */
+export class JSONLPersister {
+    config;
+    watcher = null;
+    constructor(config) {
+        this.config = {
+            path: config.path,
+            tombstonesPath: config.tombstonesPath || config.path.replace('.jsonl', '.tombstones.jsonl'),
+            atomicWrite: config.atomicWrite ?? true,
+        };
+    }
+    /**
+     * Get the file path
+     */
+    get filePath() {
+        return this.config.path;
+    }
+    /**
+     * Check if the JSONL file exists
+     */
+    async exists() {
+        return fileExists(this.config.path);
+    }
+    /**
+     * Load the entire graph from JSONL
+     *
+     * Parses each line as JSON and separates nodes from edges.
+     * Invalid lines are skipped with a warning.
+     *
+     * @returns Object with nodes and edges arrays
+     */
+    async load() {
+        const content = await readFileOrEmpty(this.config.path);
+        if (!content.trim()) {
+            return { nodes: [], edges: [] };
+        }
+        const nodes = [];
+        const edges = [];
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (!line)
+                continue;
+            try {
+                const obj = JSON.parse(line);
+                if (isEdge(obj)) {
+                    edges.push(obj);
+                }
+                else {
+                    nodes.push(obj);
+                }
+            }
+            catch (error) {
+                console.warn(`Invalid JSON at line ${i + 1}: ${line.slice(0, 50)}...`);
+            }
+        }
+        return { nodes, edges };
+    }
+    /**
+     * Save the entire graph to JSONL
+     *
+     * Overwrites the file with all nodes and edges.
+     * Uses atomic write by default (temp file + rename).
+     *
+     * @param nodes - All nodes to save
+     * @param edges - All edges to save
+     */
+    async save(nodes, edges) {
+        const lines = [];
+        // Nodes first
+        for (const node of nodes) {
+            lines.push(JSON.stringify(node));
+        }
+        // Then edges
+        for (const edge of edges) {
+            lines.push(JSON.stringify(edge));
+        }
+        const content = lines.join('\n') + (lines.length > 0 ? '\n' : '');
+        if (this.config.atomicWrite) {
+            await atomicWrite(this.config.path, content);
+        }
+        else {
+            const dir = path.dirname(this.config.path);
+            await fs.promises.mkdir(dir, { recursive: true });
+            await fs.promises.writeFile(this.config.path, content, 'utf-8');
+        }
+    }
+    /**
+     * Append a single entry to the JSONL file
+     *
+     * Useful for incremental writes without rewriting the entire file.
+     * Note: This can lead to duplicate entries; use save() for clean state.
+     *
+     * @param entry - Node or edge to append
+     */
+    async append(entry) {
+        const line = JSON.stringify(entry) + '\n';
+        await appendToFile(this.config.path, line);
+    }
+    /**
+     * Append multiple entries to the JSONL file
+     *
+     * @param entries - Nodes or edges to append
+     */
+    async appendMany(entries) {
+        if (entries.length === 0)
+            return;
+        const lines = entries.map((e) => JSON.stringify(e)).join('\n') + '\n';
+        await appendToFile(this.config.path, lines);
+    }
+    /**
+     * Watch the JSONL file for external changes
+     *
+     * Calls the callback when the file is modified.
+     * Uses debouncing to avoid multiple calls for rapid changes.
+     *
+     * @param callback - Function to call on file change
+     * @returns Unsubscribe function
+     */
+    watch(callback) {
+        if (this.watcher) {
+            this.watcher.close();
+        }
+        let debounceTimer = null;
+        const debouncedCallback = () => {
+            if (debounceTimer) {
+                clearTimeout(debounceTimer);
+            }
+            debounceTimer = setTimeout(() => {
+                callback();
+                debounceTimer = null;
+            }, 100);
+        };
+        try {
+            this.watcher = fs.watch(this.config.path, (eventType) => {
+                if (eventType === 'change') {
+                    debouncedCallback();
+                }
+            });
+            this.watcher.on('error', (error) => {
+                console.warn('File watcher error:', error);
+            });
+        }
+        catch (error) {
+            // File might not exist yet - that's OK
+            console.warn('Could not watch file:', this.config.path);
+        }
+        return () => {
+            if (debounceTimer) {
+                clearTimeout(debounceTimer);
+            }
+            if (this.watcher) {
+                this.watcher.close();
+                this.watcher = null;
+            }
+        };
+    }
+    /**
+     * Stop watching the file
+     */
+    stopWatching() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+    }
+    /**
+     * Delete the JSONL file
+     *
+     * Use with caution - this removes all data.
+     */
+    async delete() {
+        try {
+            await fs.promises.unlink(this.config.path);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+    }
+}
+/**
+ * Create a JSONL persister with default configuration
+ *
+ * @param basePath - Base directory (e.g., ".opentasks")
+ * @returns Configured JSONLPersister
+ */
+export function createJSONLPersister(basePath) {
+    return new JSONLPersister({
+        path: path.join(basePath, 'graph.jsonl'),
+        tombstonesPath: path.join(basePath, 'tombstones.jsonl'),
+        atomicWrite: true,
+    });
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/storage/jsonl.js.map

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

package/dist/storage/locked-writer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Locked JSONL Writer for OpenTasks (Phase 2)
+ *
+ * Wraps JSONL append operations with advisory file locking
+ * for safe concurrent access across multiple processes.
+ */
+import type { StoredNode, StoredEdge } from '../schema/storage.js';
+import { JSONLPersister } from './jsonl.js';
+/**
+ * Configuration for the locked writer
+ */
+export interface LockedWriterConfig {
+    /** Path to the .opentasks directory */
+    basePath: string;
+    /** Lock acquisition timeout (ms) */
+    lockTimeout?: number;
+}
+/**
+ * Locked JSONL writer
+ *
+ * All write operations acquire an advisory file lock before
+ * appending to graph.jsonl. Reads do NOT require the lock
+ * (SQLite WAL handles concurrent reads).
+ */
+export declare class LockedJsonlWriter {
+    private readonly persister;
+    private readonly lockPath;
+    private readonly lockTimeout;
+    constructor(config: LockedWriterConfig);
+    /**
+     * Append a single entry while holding the write lock
+     */
+    appendLocked(entry: StoredNode | StoredEdge): Promise<void>;
+    /**
+     * Append multiple entries while holding the write lock
+     */
+    appendManyLocked(entries: Array<StoredNode | StoredEdge>): Promise<void>;
+    /**
+     * Save (overwrite) the entire file while holding the write lock
+     */
+    saveLocked(nodes: StoredNode[], edges: StoredEdge[]): Promise<void>;
+    /**
+     * Load from JSONL (no lock needed — reads are safe)
+     */
+    load(): Promise<import("./jsonl.js").LoadResult>;
+    /**
+     * Get the underlying persister for non-locked operations
+     */
+    get underlying(): JSONLPersister;
+}
+/**
+ * Deduplicate JSONL entries by keeping the latest updated_at per ID
+ *
+ * Used during cache rebuild to resolve append-only duplicates.
+ *
+ * @param nodes - All node entries (may include duplicates)
+ * @returns Deduplicated nodes
+ */
+export declare function deduplicateNodes(nodes: StoredNode[]): StoredNode[];
+/**
+ * Deduplicate edge entries by keeping the latest per ID
+ *
+ * @param edges - All edge entries (may include duplicates)
+ * @returns Deduplicated edges
+ */
+export declare function deduplicateEdges(edges: StoredEdge[]): StoredEdge[];
+//# sourceMappingURL=locked-writer.d.ts.map

package/dist/storage/locked-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locked-writer.d.ts","sourceRoot":"","sources":["../../src/storage/locked-writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,EAAE,kBAAkB;IAQtC;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjE;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9E;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzE;;OAEG;IACG,IAAI;IAIV;;OAEG;IACH,IAAI,UAAU,IAAI,cAAc,CAE/B;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAWlE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAclE"}

package/dist/storage/locked-writer.js

@@ -0,0 +1,105 @@
+/**
+ * Locked JSONL Writer for OpenTasks (Phase 2)
+ *
+ * Wraps JSONL append operations with advisory file locking
+ * for safe concurrent access across multiple processes.
+ */
+import * as path from 'node:path';
+import { JSONLPersister } from './jsonl.js';
+import { withFileLock } from './file-lock.js';
+/**
+ * Locked JSONL writer
+ *
+ * All write operations acquire an advisory file lock before
+ * appending to graph.jsonl. Reads do NOT require the lock
+ * (SQLite WAL handles concurrent reads).
+ */
+export class LockedJsonlWriter {
+    persister;
+    lockPath;
+    lockTimeout;
+    constructor(config) {
+        this.persister = new JSONLPersister({
+            path: path.join(config.basePath, 'graph.jsonl'),
+        });
+        this.lockPath = path.join(config.basePath, 'write.lock');
+        this.lockTimeout = config.lockTimeout ?? 5000;
+    }
+    /**
+     * Append a single entry while holding the write lock
+     */
+    async appendLocked(entry) {
+        await withFileLock(this.lockPath, async () => {
+            await this.persister.append(entry);
+        }, this.lockTimeout);
+    }
+    /**
+     * Append multiple entries while holding the write lock
+     */
+    async appendManyLocked(entries) {
+        if (entries.length === 0)
+            return;
+        await withFileLock(this.lockPath, async () => {
+            await this.persister.appendMany(entries);
+        }, this.lockTimeout);
+    }
+    /**
+     * Save (overwrite) the entire file while holding the write lock
+     */
+    async saveLocked(nodes, edges) {
+        await withFileLock(this.lockPath, async () => {
+            await this.persister.save(nodes, edges);
+        }, this.lockTimeout);
+    }
+    /**
+     * Load from JSONL (no lock needed — reads are safe)
+     */
+    async load() {
+        return this.persister.load();
+    }
+    /**
+     * Get the underlying persister for non-locked operations
+     */
+    get underlying() {
+        return this.persister;
+    }
+}
+/**
+ * Deduplicate JSONL entries by keeping the latest updated_at per ID
+ *
+ * Used during cache rebuild to resolve append-only duplicates.
+ *
+ * @param nodes - All node entries (may include duplicates)
+ * @returns Deduplicated nodes
+ */
+export function deduplicateNodes(nodes) {
+    const map = new Map();
+    for (const node of nodes) {
+        const existing = map.get(node.id);
+        if (!existing || node.updated_at > existing.updated_at) {
+            map.set(node.id, node);
+        }
+    }
+    return Array.from(map.values());
+}
+/**
+ * Deduplicate edge entries by keeping the latest per ID
+ *
+ * @param edges - All edge entries (may include duplicates)
+ * @returns Deduplicated edges
+ */
+export function deduplicateEdges(edges) {
+    const map = new Map();
+    for (const edge of edges) {
+        const existing = map.get(edge.id);
+        if (!existing) {
+            map.set(edge.id, edge);
+        }
+        else if (edge.created_at > existing.created_at) {
+            // Both have created_at (required field) — keep the newer one
+            map.set(edge.id, edge);
+        }
+    }
+    return Array.from(map.values());
+}
+//# sourceMappingURL=locked-writer.js.map

package/dist/storage/locked-writer.js.map

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

package/dist/storage/sqlite-schema.d.ts

@@ -0,0 +1,48 @@
+/**
+ * SQLite schema definitions for OpenTasks
+ */
+/**
+ * Create nodes table
+ */
+export declare const CREATE_NODES_TABLE = "\nCREATE TABLE IF NOT EXISTS nodes (\n  id TEXT PRIMARY KEY,\n  uuid TEXT UNIQUE NOT NULL,\n  type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  content TEXT,\n  content_hash TEXT,\n  status TEXT,\n  priority INTEGER,\n  assignee TEXT,\n  parent_id TEXT,\n  source TEXT,\n  archived INTEGER DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n\n  -- Feedback fields\n  target_id TEXT,\n  feedback_type TEXT,\n  thread_id TEXT,\n  reply_to_id TEXT,\n  resolved INTEGER,\n  dismissed INTEGER,\n\n  -- External fields\n  uri TEXT,\n  materialized INTEGER,\n  cached_at TEXT,\n  stale INTEGER,\n  external_status TEXT,\n\n  -- Coordination\n  claimed_by TEXT,\n  claimed_at TEXT,\n  lock_until TEXT,\n\n  -- Context\n  location TEXT,\n  branch TEXT,\n\n  FOREIGN KEY (parent_id) REFERENCES nodes(id)\n)\n";
+/**
+ * Create tags join table
+ */
+export declare const CREATE_NODE_TAGS_TABLE = "\nCREATE TABLE IF NOT EXISTS node_tags (\n  node_id TEXT NOT NULL,\n  tag TEXT NOT NULL,\n  PRIMARY KEY (node_id, tag),\n  FOREIGN KEY (node_id) REFERENCES nodes(id) ON DELETE CASCADE\n)\n";
+/**
+ * Create edges table
+ */
+export declare const CREATE_EDGES_TABLE = "\nCREATE TABLE IF NOT EXISTS edges (\n  id TEXT PRIMARY KEY,\n  uuid TEXT UNIQUE NOT NULL,\n  from_id TEXT NOT NULL,\n  to_id TEXT NOT NULL,\n  type TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  created_by TEXT,\n  source TEXT,\n  metadata TEXT,\n  cached_at TEXT\n)\n";
+/**
+ * Create dirty tracking table
+ */
+export declare const CREATE_DIRTY_NODES_TABLE = "\nCREATE TABLE IF NOT EXISTS dirty_nodes (\n  node_id TEXT PRIMARY KEY,\n  marked_at TEXT NOT NULL\n)\n";
+/**
+ * Create export hashes table
+ */
+export declare const CREATE_EXPORT_HASHES_TABLE = "\nCREATE TABLE IF NOT EXISTS export_hashes (\n  node_id TEXT PRIMARY KEY,\n  content_hash TEXT NOT NULL\n)\n";
+/**
+ * Create indexes
+ */
+export declare const CREATE_INDEXES: string[];
+/**
+ * Create ready_tasks view
+ * Shows tasks that are open, not archived, and have no open blockers
+ */
+export declare const CREATE_READY_VIEW = "\nCREATE VIEW IF NOT EXISTS ready_tasks AS\nSELECT n.* FROM nodes n\nWHERE n.type = 'task'\n  AND n.status = 'open'\n  AND n.archived = 0\n  AND NOT EXISTS (\n    SELECT 1 FROM edges e\n    JOIN nodes blocker ON e.from_id = blocker.id\n    WHERE e.to_id = n.id\n      AND e.type = 'blocks'\n      AND blocker.status != 'closed'\n      AND blocker.archived = 0\n  )\n";
+/**
+ * Migration statements for existing databases
+ * These are idempotent (safe to run multiple times)
+ */
+export declare const MIGRATIONS: string[];
+/**
+ * Apply migrations safely (ignores "duplicate column" errors)
+ */
+export declare function applyMigrations(db: {
+    exec: (sql: string) => void;
+}): void;
+/**
+ * All schema creation statements in order
+ */
+export declare const ALL_SCHEMA: string[];
+//# sourceMappingURL=sqlite-schema.d.ts.map

package/dist/storage/sqlite-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-schema.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,mzBA2C9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,iMAOlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,kRAa9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,4GAKpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,iHAKtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,UAW1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,mXAc7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,UAItB,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAAG,IAAI,CAYzE;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,UAQtB,CAAC"}

package/dist/storage/sqlite-schema.js

@@ -0,0 +1,169 @@
+/**
+ * SQLite schema definitions for OpenTasks
+ */
+/**
+ * Create nodes table
+ */
+export const CREATE_NODES_TABLE = `
+CREATE TABLE IF NOT EXISTS nodes (
+  id TEXT PRIMARY KEY,
+  uuid TEXT UNIQUE NOT NULL,
+  type TEXT NOT NULL,
+  title TEXT NOT NULL,
+  content TEXT,
+  content_hash TEXT,
+  status TEXT,
+  priority INTEGER,
+  assignee TEXT,
+  parent_id TEXT,
+  source TEXT,
+  archived INTEGER DEFAULT 0,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+
+  -- Feedback fields
+  target_id TEXT,
+  feedback_type TEXT,
+  thread_id TEXT,
+  reply_to_id TEXT,
+  resolved INTEGER,
+  dismissed INTEGER,
+
+  -- External fields
+  uri TEXT,
+  materialized INTEGER,
+  cached_at TEXT,
+  stale INTEGER,
+  external_status TEXT,
+
+  -- Coordination
+  claimed_by TEXT,
+  claimed_at TEXT,
+  lock_until TEXT,
+
+  -- Context
+  location TEXT,
+  branch TEXT,
+
+  FOREIGN KEY (parent_id) REFERENCES nodes(id)
+)
+`;
+/**
+ * Create tags join table
+ */
+export const CREATE_NODE_TAGS_TABLE = `
+CREATE TABLE IF NOT EXISTS node_tags (
+  node_id TEXT NOT NULL,
+  tag TEXT NOT NULL,
+  PRIMARY KEY (node_id, tag),
+  FOREIGN KEY (node_id) REFERENCES nodes(id) ON DELETE CASCADE
+)
+`;
+/**
+ * Create edges table
+ */
+export const CREATE_EDGES_TABLE = `
+CREATE TABLE IF NOT EXISTS edges (
+  id TEXT PRIMARY KEY,
+  uuid TEXT UNIQUE NOT NULL,
+  from_id TEXT NOT NULL,
+  to_id TEXT NOT NULL,
+  type TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  created_by TEXT,
+  source TEXT,
+  metadata TEXT,
+  cached_at TEXT
+)
+`;
+/**
+ * Create dirty tracking table
+ */
+export const CREATE_DIRTY_NODES_TABLE = `
+CREATE TABLE IF NOT EXISTS dirty_nodes (
+  node_id TEXT PRIMARY KEY,
+  marked_at TEXT NOT NULL
+)
+`;
+/**
+ * Create export hashes table
+ */
+export const CREATE_EXPORT_HASHES_TABLE = `
+CREATE TABLE IF NOT EXISTS export_hashes (
+  node_id TEXT PRIMARY KEY,
+  content_hash TEXT NOT NULL
+)
+`;
+/**
+ * Create indexes
+ */
+export const CREATE_INDEXES = [
+    'CREATE INDEX IF NOT EXISTS idx_nodes_type ON nodes(type)',
+    'CREATE INDEX IF NOT EXISTS idx_nodes_status ON nodes(status)',
+    'CREATE INDEX IF NOT EXISTS idx_nodes_parent ON nodes(parent_id)',
+    'CREATE INDEX IF NOT EXISTS idx_nodes_archived ON nodes(archived)',
+    'CREATE INDEX IF NOT EXISTS idx_node_tags_tag ON node_tags(tag)',
+    'CREATE INDEX IF NOT EXISTS idx_edges_from ON edges(from_id)',
+    'CREATE INDEX IF NOT EXISTS idx_edges_to ON edges(to_id)',
+    'CREATE INDEX IF NOT EXISTS idx_edges_type ON edges(type)',
+    'CREATE INDEX IF NOT EXISTS idx_edges_source ON edges(source)',
+    'CREATE INDEX IF NOT EXISTS idx_edges_cached_at ON edges(cached_at)',
+];
+/**
+ * Create ready_tasks view
+ * Shows tasks that are open, not archived, and have no open blockers
+ */
+export const CREATE_READY_VIEW = `
+CREATE VIEW IF NOT EXISTS ready_tasks AS
+SELECT n.* FROM nodes n
+WHERE n.type = 'task'
+  AND n.status = 'open'
+  AND n.archived = 0
+  AND NOT EXISTS (
+    SELECT 1 FROM edges e
+    JOIN nodes blocker ON e.from_id = blocker.id
+    WHERE e.to_id = n.id
+      AND e.type = 'blocks'
+      AND blocker.status != 'closed'
+      AND blocker.archived = 0
+  )
+`;
+/**
+ * Migration statements for existing databases
+ * These are idempotent (safe to run multiple times)
+ */
+export const MIGRATIONS = [
+    // Add metadata and cached_at columns to edges table (v1.1.0)
+    `ALTER TABLE edges ADD COLUMN metadata TEXT`,
+    `ALTER TABLE edges ADD COLUMN cached_at TEXT`,
+];
+/**
+ * Apply migrations safely (ignores "duplicate column" errors)
+ */
+export function applyMigrations(db) {
+    for (const migration of MIGRATIONS) {
+        try {
+            db.exec(migration);
+        }
+        catch (error) {
+            // Ignore "duplicate column name" errors (migration already applied)
+            const message = error instanceof Error ? error.message : String(error);
+            if (!message.includes('duplicate column name')) {
+                throw error;
+            }
+        }
+    }
+}
+/**
+ * All schema creation statements in order
+ */
+export const ALL_SCHEMA = [
+    CREATE_NODES_TABLE,
+    CREATE_NODE_TAGS_TABLE,
+    CREATE_EDGES_TABLE,
+    CREATE_DIRTY_NODES_TABLE,
+    CREATE_EXPORT_HASHES_TABLE,
+    ...CREATE_INDEXES,
+    CREATE_READY_VIEW,
+];
+//# sourceMappingURL=sqlite-schema.js.map

package/dist/storage/sqlite-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-schema.js","sourceRoot":"","sources":["../../src/storage/sqlite-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CjC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;CAOrC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;CAajC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;CAKvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;CAKzC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,0DAA0D;IAC1D,8DAA8D;IAC9D,iEAAiE;IACjE,kEAAkE;IAClE,gEAAgE;IAChE,6DAA6D;IAC7D,yDAAyD;IACzD,0DAA0D;IAC1D,8DAA8D;IAC9D,oEAAoE;CACrE,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;CAchC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,6DAA6D;IAC7D,4CAA4C;IAC5C,6CAA6C;CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,EAAmC;IACjE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oEAAoE;YACpE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;gBAC/C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,kBAAkB;IAClB,sBAAsB;IACtB,kBAAkB;IAClB,wBAAwB;IACxB,0BAA0B;IAC1B,GAAG,cAAc;IACjB,iBAAiB;CAClB,CAAC"}