opentasks 0.0.1 → 0.0.2

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,SAAS,EACT,UAAU,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAG3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAE,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAGnE,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAG5E,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,YAAY,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EACL,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,iBAAiB,GAClB,MAAM,WAAW,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,29 @@
+/**
+ * OpenTasks Providers Module
+ *
+ * Provider system for connecting OpenTasks with external task/issue systems.
+ *
+ * @packageDocumentation
+ */
+export { ProviderError, DEFAULT_MATERIALIZATION_CONFIG } from './types.js';
+// Registry
+export { createProviderRegistry } from './registry.js';
+// Native Provider
+export { createNativeProvider } from './native.js';
+// Beads Provider
+export { createBeadsProvider } from './beads.js';
+// Claude Tasks Provider
+export { createClaudeTasksProvider, createInMemoryTaskStore, } from './claude-tasks.js';
+// Sudocode Provider
+export { createSudocodeProvider } from './sudocode.js';
+// Entire Provider
+export { createEntireProvider, createInMemoryEntireStore, createEntireCliStore, } from './entire.js';
+// Materialization
+export { createMaterializationManager, } from './materialization.js';
+export { isRelationshipQueryable, filterEdgesByType, filterEdgesByDirection, getNeighborFromEdge, } from './traits/index.js';
+export { isWatchable } from './traits/index.js';
+export { isTaskManageable } from './traits/index.js';
+// Config-based Provider Factory
+export { createProvidersFromConfig, } from './from-config.js';
+export { isSyncableProvider, calculateContentHash, compareVersions, hasConflict, suggestResolution, } from './sync.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,OAAO,EAAE,aAAa,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE3E,WAAW;AACX,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAA6B,MAAM,aAAa,CAAC;AAE9E,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAoB,MAAM,YAAY,CAAC;AAEnE,wBAAwB;AACxB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GAIxB,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAuB,MAAM,eAAe,CAAC;AAE5E,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GAMrB,MAAM,aAAa,CAAC;AAErB,kBAAkB;AAClB,OAAO,EACL,4BAA4B,GAG7B,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAa3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,gCAAgC;AAChC,OAAO,EACL,yBAAyB,GAG1B,MAAM,kBAAkB,CAAC;AAqB1B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,iBAAiB,GAClB,MAAM,WAAW,CAAC"}

package/dist/providers/location.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Location-as-Provider for OpenTasks (Phase 3)
+ *
+ * Creates a Provider from a connected OpenTasks location,
+ * enabling cross-location queries via the existing ProviderRegistry.
+ */
+import type { Database as DatabaseType } from 'better-sqlite3';
+import type { Connection } from '../core/connections.js';
+import type { Provider, ProviderNode } from './types.js';
+/**
+ * Extended provider with ready() support and cleanup
+ */
+export interface LocationProvider extends Provider {
+    /** Get ready issues from this location */
+    ready(): Promise<ProviderNode[]>;
+    /** Close the database connection */
+    close(): void;
+}
+/**
+ * Create a Provider for a connected OpenTasks location
+ *
+ * @param connection - The connection to create a provider for
+ * @param db - Optional pre-opened database (for daemon in-process use)
+ * @returns A LocationProvider instance
+ */
+/**
+ * Options for creating a LocationProvider
+ */
+export interface LocationProviderOptions {
+    /** Pre-opened database (for daemon in-process use) */
+    db?: DatabaseType;
+    /** Query result limit (default: 1000) */
+    queryLimit?: number;
+}
+export declare function createLocationProvider(connection: Connection, dbOrOptions?: DatabaseType | LocationProviderOptions): LocationProvider;
+/**
+ * Initialize location providers for all reachable connections
+ *
+ * @param connections - Available connections
+ * @param basePath - Base path for resolving relative connection paths
+ * @returns Array of created providers (caller should close when done)
+ */
+export declare function initializeLocationProviders(connections: Connection[], basePath?: string): LocationProvider[];
+//# sourceMappingURL=location.d.ts.map

package/dist/providers/location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../src/providers/location.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EAMb,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,0CAA0C;IAC1C,KAAK,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACjC,oCAAoC;IACpC,KAAK,IAAI,IAAI,CAAC;CACf;AAmBD;;;;;;GAMG;AACH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,EAAE,CAAC,EAAE,YAAY,CAAC;IAClB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,EACtB,WAAW,CAAC,EAAE,YAAY,GAAG,uBAAuB,GACnD,gBAAgB,CAuIlB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB,EAAE,CAmBpB"}

package/dist/providers/location.js

@@ -0,0 +1,157 @@
+/**
+ * Location-as-Provider for OpenTasks (Phase 3)
+ *
+ * Creates a Provider from a connected OpenTasks location,
+ * enabling cross-location queries via the existing ProviderRegistry.
+ */
+import Database from 'better-sqlite3';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ProviderError } from './types.js';
+/**
+ * Convert a SQLite row to a ProviderNode
+ */
+function toProviderNode(row, connection) {
+    return {
+        id: row.id,
+        uri: `opentasks://${connection.hash}/${row.id}`,
+        type: row.type === 'task' ? 'issue' : 'spec',
+        title: row.title,
+        content: row.content,
+        status: row.status,
+        priority: row.priority,
+        rawData: row,
+        fetchedAt: new Date().toISOString(),
+    };
+}
+export function createLocationProvider(connection, dbOrOptions) {
+    // Support both legacy signature (db) and new options object
+    const options = dbOrOptions != null && typeof dbOrOptions === 'object' && 'prepare' in dbOrOptions
+        ? { db: dbOrOptions }
+        : (dbOrOptions ?? {});
+    const db = options.db;
+    const queryLimit = options.queryLimit ?? 1000;
+    let ownedDb = null;
+    function getDb() {
+        if (db)
+            return db;
+        if (!ownedDb) {
+            const cachePath = path.join(connection.path, 'cache.db');
+            if (!fs.existsSync(cachePath)) {
+                throw new Error(`Cache database not found: ${cachePath}`);
+            }
+            ownedDb = new Database(cachePath, { readonly: true });
+            ownedDb.pragma('journal_mode = WAL');
+        }
+        return ownedDb;
+    }
+    const capabilities = {
+        read: true,
+        write: false,
+        search: true,
+        watch: false,
+        mount: false,
+        feedback: false,
+    };
+    return {
+        name: `opentasks-${connection.hash}`,
+        schemes: ['opentasks'],
+        capabilities,
+        parseUri(uri) {
+            const match = uri.match(/^opentasks:\/\/([a-z0-9]+)\/(.+)$/);
+            if (match && match[1] === connection.hash) {
+                return { scheme: 'opentasks', workspace: match[1], id: match[2], isRelative: false };
+            }
+            return null;
+        },
+        buildUri(id) {
+            return `opentasks://${connection.hash}/${id}`;
+        },
+        isValidUri(uri) {
+            return this.parseUri(uri) !== null;
+        },
+        async get(id) {
+            try {
+                const database = getDb();
+                const row = database.prepare('SELECT * FROM nodes WHERE id = ?').get(id);
+                return row ? toProviderNode(row, connection) : null;
+            }
+            catch {
+                return null;
+            }
+        },
+        async list(filter) {
+            try {
+                const database = getDb();
+                const conditions = ['1=1'];
+                const params = [];
+                if (filter?.status) {
+                    conditions.push('status = ?');
+                    params.push(filter.status);
+                }
+                if (filter?.type) {
+                    conditions.push('type = ?');
+                    params.push(filter.type);
+                }
+                const limit = filter?.limit ?? queryLimit;
+                const sql = `SELECT * FROM nodes WHERE ${conditions.join(' AND ')} ORDER BY updated_at DESC LIMIT ${limit}`;
+                const rows = database.prepare(sql).all(...params);
+                return rows.map((r) => toProviderNode(r, connection));
+            }
+            catch {
+                return [];
+            }
+        },
+        async create() {
+            throw new ProviderError('NOT_SUPPORTED', 'Location provider is read-only', `opentasks-${connection.hash}`);
+        },
+        async update() {
+            throw new ProviderError('NOT_SUPPORTED', 'Location provider is read-only', `opentasks-${connection.hash}`);
+        },
+        async delete() {
+            throw new ProviderError('NOT_SUPPORTED', 'Location provider is read-only', `opentasks-${connection.hash}`);
+        },
+        async ready() {
+            try {
+                const database = getDb();
+                const rows = database.prepare('SELECT * FROM ready_tasks').all();
+                return rows.map((r) => toProviderNode(r, connection));
+            }
+            catch {
+                return [];
+            }
+        },
+        close() {
+            if (ownedDb) {
+                ownedDb.close();
+                ownedDb = null;
+            }
+        },
+    };
+}
+/**
+ * Initialize location providers for all reachable connections
+ *
+ * @param connections - Available connections
+ * @param basePath - Base path for resolving relative connection paths
+ * @returns Array of created providers (caller should close when done)
+ */
+export function initializeLocationProviders(connections, basePath) {
+    const providers = [];
+    for (const conn of connections) {
+        const resolvedPath = basePath ? path.resolve(basePath, conn.path) : path.resolve(conn.path);
+        const cachePath = path.join(resolvedPath, 'cache.db');
+        if (!fs.existsSync(cachePath))
+            continue;
+        try {
+            const resolvedConn = { ...conn, path: resolvedPath };
+            const provider = createLocationProvider(resolvedConn);
+            providers.push(provider);
+        }
+        catch {
+            // Skip unreachable locations
+        }
+    }
+    return providers;
+}
+//# sourceMappingURL=location.js.map

package/dist/providers/location.js.map

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

package/dist/providers/materialization.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Materialization Manager
+ *
+ * Handles materialization strategies for external nodes.
+ * Controls when and how external provider data is cached in the local graph.
+ */
+import type { GraphStore } from '../graph/index.js';
+import type { ExternalNode } from '../schema/index.js';
+import type { Provider, ProviderNode, ProviderRegistry, ProviderOperationContext, MaterializationStrategy, MaterializationConfig } from './types.js';
+/**
+ * Context for materialization decisions
+ */
+export interface MaterializationContext {
+    /** How the node is being accessed */
+    accessType: 'resolve' | 'edge-create' | 'query';
+    /** Explicit request to materialize */
+    explicit?: boolean;
+}
+/**
+ * Manager for materializing external nodes
+ */
+export interface MaterializationManager {
+    /** Get materialization config */
+    readonly config: MaterializationConfig;
+    /** Check if a node should be materialized */
+    shouldMaterialize(uri: string, context: MaterializationContext): boolean;
+    /** Get the materialization strategy for a URI */
+    getStrategyFor(uri: string): MaterializationStrategy;
+    /** Materialize an external node */
+    materialize(uri: string, providerNode: ProviderNode, store: GraphStore): Promise<ExternalNode>;
+    /** Check if a materialized node is stale */
+    isStale(node: ExternalNode): boolean;
+    /** Refresh a stale node */
+    refresh(node: ExternalNode, provider: Provider, store: GraphStore, context?: ProviderOperationContext): Promise<ExternalNode | null>;
+    /** Start background sync */
+    startBackgroundSync(store: GraphStore, registry: ProviderRegistry): void;
+    /** Stop background sync */
+    stopBackgroundSync(): void;
+    /** Check if background sync is running */
+    isBackgroundSyncRunning(): boolean;
+}
+/**
+ * Create a materialization manager
+ */
+export declare function createMaterializationManager(partialConfig?: Partial<MaterializationConfig>): MaterializationManager;
+//# sourceMappingURL=materialization.d.ts.map

package/dist/providers/materialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialization.d.ts","sourceRoot":"","sources":["../../src/providers/materialization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,UAAU,EAAE,SAAS,GAAG,aAAa,GAAG,OAAO,CAAC;IAEhD,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAEvC,6CAA6C;IAC7C,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAEzE,iDAAiD;IACjD,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAAC;IAErD,mCAAmC;IACnC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/F,4CAA4C;IAC5C,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;IAErC,2BAA2B;IAC3B,OAAO,CACL,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAEhC,4BAA4B;IAC5B,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEzE,2BAA2B;IAC3B,kBAAkB,IAAI,IAAI,CAAC;IAE3B,0CAA0C;IAC1C,uBAAuB,IAAI,OAAO,CAAC;CACpC;AAqCD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAC7C,sBAAsB,CA0OxB"}

package/dist/providers/materialization.js

@@ -0,0 +1,237 @@
+/**
+ * Materialization Manager
+ *
+ * Handles materialization strategies for external nodes.
+ * Controls when and how external provider data is cached in the local graph.
+ */
+import { DEFAULT_MATERIALIZATION_CONFIG } from './types.js';
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Extract source/provider name from URI
+ */
+function extractSource(uri) {
+    const match = uri.match(/^([a-z][a-z0-9+.-]*):/i);
+    return match ? match[1].toLowerCase() : 'unknown';
+}
+/**
+ * Find existing external node by URI
+ */
+async function findByUri(uri, store) {
+    const nodes = await store.query.nodes({
+        type: 'external',
+        search: uri,
+    });
+    // Find exact URI match
+    for (const node of nodes) {
+        if (node.type === 'external' && node.uri === uri) {
+            return node;
+        }
+    }
+    return null;
+}
+// ============================================================================
+// Materialization Manager Implementation
+// ============================================================================
+/**
+ * Create a materialization manager
+ */
+export function createMaterializationManager(partialConfig) {
+    const config = {
+        ...DEFAULT_MATERIALIZATION_CONFIG,
+        ...partialConfig,
+    };
+    let syncInterval = null;
+    let isSyncing = false;
+    return {
+        config,
+        /**
+         * Get the materialization strategy for a URI
+         */
+        getStrategyFor(uri) {
+            // Check for provider-specific override
+            if (config.providers) {
+                const source = extractSource(uri);
+                if (config.providers[source]) {
+                    return config.providers[source];
+                }
+            }
+            return config.default;
+        },
+        /**
+         * Check if a node should be materialized based on strategy and context
+         */
+        shouldMaterialize(uri, context) {
+            const strategy = this.getStrategyFor(uri);
+            switch (strategy) {
+                case 'on-demand':
+                    // Only materialize when explicitly requested
+                    return context.explicit === true;
+                case 'lazy':
+                    // Materialize on resolve access or explicit request
+                    return context.accessType === 'resolve' || context.explicit === true;
+                case 'eager':
+                    // Always materialize
+                    return true;
+                case 'none':
+                    // Never materialize
+                    return false;
+                default:
+                    return false;
+            }
+        },
+        /**
+         * Materialize an external node from provider data
+         */
+        async materialize(uri, providerNode, store) {
+            const source = extractSource(uri);
+            const now = new Date().toISOString();
+            // Check if already exists
+            const existing = await findByUri(uri, store);
+            if (existing) {
+                // Update existing node
+                const updated = await store.updateNode(existing.id, {
+                    title: providerNode.title,
+                    content: providerNode.content,
+                    metadata: {
+                        ...existing.metadata,
+                        external_status: providerNode.status,
+                        external_data: providerNode.rawData,
+                        cached_at: now,
+                        stale: false,
+                        materialized: true,
+                    },
+                });
+                return updated;
+            }
+            // Create new ExternalNode
+            const node = await store.createNode({
+                type: 'external',
+                uri,
+                source,
+                title: providerNode.title,
+                content: providerNode.content,
+                metadata: {
+                    external_status: providerNode.status,
+                    external_data: providerNode.rawData,
+                    cached_at: now,
+                    materialized: true,
+                },
+            });
+            return node;
+        },
+        /**
+         * Check if a materialized node is stale
+         */
+        isStale(node) {
+            // Check explicit stale flag
+            if (node.stale) {
+                return true;
+            }
+            // Check cached_at against staleAfter
+            if (node.cached_at && config.staleAfter) {
+                const cachedTime = new Date(node.cached_at).getTime();
+                const now = Date.now();
+                return now - cachedTime > config.staleAfter;
+            }
+            // If no cached_at, consider it stale
+            return node.cached_at === undefined;
+        },
+        /**
+         * Refresh a stale node from provider
+         */
+        async refresh(node, provider, store, context) {
+            try {
+                // Fetch fresh data from provider
+                const providerNode = await provider.get(node.uri, context);
+                if (!providerNode) {
+                    // Node no longer exists in provider, mark as stale
+                    await store.updateNode(node.id, {
+                        metadata: {
+                            ...node.metadata,
+                            stale: true,
+                            last_refresh_error: 'Node not found in provider',
+                            last_refresh_at: new Date().toISOString(),
+                        },
+                    });
+                    return null;
+                }
+                // Update with fresh data
+                return this.materialize(node.uri, providerNode, store);
+            }
+            catch (error) {
+                // Mark as stale on error
+                await store.updateNode(node.id, {
+                    metadata: {
+                        ...node.metadata,
+                        stale: true,
+                        last_refresh_error: error instanceof Error ? error.message : String(error),
+                        last_refresh_at: new Date().toISOString(),
+                    },
+                });
+                return null;
+            }
+        },
+        /**
+         * Start background sync process
+         */
+        startBackgroundSync(store, registry) {
+            // Don't start if disabled or already running
+            if (!config.backgroundSyncInterval || config.backgroundSyncInterval <= 0) {
+                return;
+            }
+            if (syncInterval) {
+                return;
+            }
+            syncInterval = setInterval(async () => {
+                // Prevent overlapping sync operations
+                if (isSyncing) {
+                    return;
+                }
+                isSyncing = true;
+                try {
+                    // Find all external nodes that are materialized
+                    const externalNodes = await store.query.nodes({
+                        type: 'external',
+                    });
+                    // Filter to stale nodes
+                    const staleNodes = externalNodes.filter((node) => {
+                        const extNode = node;
+                        return extNode.materialized && this.isStale(extNode);
+                    });
+                    // Refresh each stale node
+                    for (const node of staleNodes) {
+                        const extNode = node;
+                        const provider = registry.resolveProvider(extNode.uri);
+                        if (provider) {
+                            await this.refresh(extNode, provider, store);
+                        }
+                    }
+                }
+                catch {
+                    // Log error but continue - background sync should be resilient
+                }
+                finally {
+                    isSyncing = false;
+                }
+            }, config.backgroundSyncInterval);
+        },
+        /**
+         * Stop background sync process
+         */
+        stopBackgroundSync() {
+            if (syncInterval) {
+                clearInterval(syncInterval);
+                syncInterval = null;
+            }
+        },
+        /**
+         * Check if background sync is running
+         */
+        isBackgroundSyncRunning() {
+            return syncInterval !== null;
+        },
+    };
+}
+//# sourceMappingURL=materialization.js.map

package/dist/providers/materialization.js.map

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

package/dist/providers/native.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Native Provider
+ *
+ * Provider that wraps existing GraphStore node operations.
+ * Handles native:// and opentasks:// URI schemes.
+ */
+import type { GraphStore } from '../graph/index.js';
+import type { Provider } from './types.js';
+import type { RelationshipQueryable } from './traits/RelationshipQueryable.js';
+import type { Watchable } from './traits/Watchable.js';
+import type { TaskManageable } from './traits/TaskManageable.js';
+/**
+ * Configuration for the native provider
+ */
+export interface NativeProviderConfig {
+    /**
+     * Path to the JSONL file to watch for external changes.
+     * When set, enables the Watchable trait. The provider will
+     * use fs.watch to detect modifications and diff node hashes.
+     *
+     * Typically set to the `graph.jsonl` path inside `.opentasks/`.
+     */
+    watchPath?: string;
+    /** Debounce delay for file watching in ms (default: 150) */
+    watchDebounceMs?: number;
+}
+/**
+ * Create a native provider wrapping a GraphStore with relationship querying support
+ * and optional file-watching via the Watchable trait.
+ */
+export declare function createNativeProvider(store: GraphStore, config?: NativeProviderConfig): Provider & RelationshipQueryable & Partial<Watchable> & TaskManageable;
+//# sourceMappingURL=native.d.ts.map

package/dist/providers/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/providers/native.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAiC,MAAM,mBAAmB,CAAC;AAEnF,OAAO,KAAK,EACV,QAAQ,EAWT,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,KAAK,EAAE,SAAS,EAAyC,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,4BAA4B,CAAC;AA4HpC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,oBAAoB,GAC5B,QAAQ,GAAG,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,cAAc,CAwhBxE"}