opentasks 0.0.5 → 0.0.7

package/dist/providers/map.js

@@ -0,0 +1,381 @@
+/**
+ * MAP (Multi-Agent Protocol) Provider
+ *
+ * Provider that bridges MAP task operations with OpenTasks.
+ * Handles map:// URI scheme for tasks managed via MAP.
+ *
+ * Supports three scenarios:
+ * 1. Same OpenTasks repo — MAP used for real-time coordination, native provider resolves tasks
+ * 2. Cross-system — tasks on a remote system accessed via MAP task methods
+ * 3. Mixed — local tasks with MAP-based assignment to external agents
+ *
+ * The provider depends on a MAPTaskClient interface, which can be satisfied by:
+ * - A MAP SDK ClientConnection (hub topology)
+ * - A MAP SDK BaseConnection wrapper (peer topology)
+ * - A local adapter (same-repo coordination, no network)
+ */
+import { ProviderError } from './types.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Pattern for map:// URIs: map://[systemId/]taskId */
+const MAP_URI_PATTERN = /^map:\/\/(?:([^/]+)\/)?(.+)$/i;
+// ============================================================================
+// Status Mapping
+// ============================================================================
+/**
+ * Map MAP task status to OpenTasks normalized status
+ */
+function mapStatusToOpenTasks(status) {
+    switch (status) {
+        case 'open': return 'open';
+        case 'in_progress': return 'in_progress';
+        case 'blocked': return 'blocked';
+        case 'completed': return 'closed';
+        case 'failed': return 'closed';
+        default: return 'open';
+    }
+}
+/**
+ * Map OpenTasks status to MAP task status
+ */
+function mapStatusToMAP(status) {
+    switch (status?.toLowerCase()) {
+        case 'open': return 'open';
+        case 'in_progress': return 'in_progress';
+        case 'blocked': return 'blocked';
+        case 'closed': return 'completed';
+        case 'completed': return 'completed';
+        case 'failed': return 'failed';
+        default: return 'open';
+    }
+}
+/**
+ * Map semantic task action to MAP status
+ */
+function actionToMAPStatus(action) {
+    switch (action) {
+        case 'start': return 'in_progress';
+        case 'complete': return 'completed';
+        case 'block': return 'blocked';
+        case 'reopen': return 'open';
+        case 'close': return 'completed';
+    }
+}
+// ============================================================================
+// Type Conversion
+// ============================================================================
+/**
+ * Convert MAP task to ProviderNode
+ */
+function taskToProviderNode(task, systemId) {
+    return {
+        id: task.id,
+        uri: `map://${systemId}/${task.id}`,
+        type: 'task',
+        title: task.title ?? '',
+        content: task.description,
+        status: mapStatusToOpenTasks(task.status),
+        priority: task.meta?.priority ?? 2,
+        rawData: {
+            assignee: task.assignee,
+            status: task.status,
+            meta: task.meta,
+        },
+        fetchedAt: new Date().toISOString(),
+    };
+}
+// ============================================================================
+// MAP Provider Implementation
+// ============================================================================
+/**
+ * Create a MAP provider
+ *
+ * @param config - Provider configuration including the MAPTaskClient
+ * @returns A Provider that implements TaskManageable and optionally Watchable
+ */
+export function createMAPProvider(config) {
+    const { client, systemId = 'default', timeout = 30000 } = config;
+    const hasEvents = typeof client.onTaskEvent === 'function';
+    let watchCallback = null;
+    let unsubscribeEvents = null;
+    const capabilities = {
+        read: true,
+        write: true,
+        search: false,
+        watch: hasEvents,
+        mount: true,
+        feedback: false,
+    };
+    const taskCapabilities = {
+        actions: ['start', 'complete', 'block', 'reopen', 'close'],
+        supportsAssignment: true,
+        supportsReadyQuery: true,
+        statusModel: ['open', 'in_progress', 'blocked', 'completed', 'failed'],
+    };
+    const watchGranularity = {
+        reportsChangedFields: false,
+        reportsPreviousValues: true,
+        reportsEdgeChanges: false,
+        mechanism: 'stream',
+    };
+    const provider = {
+        name: 'map',
+        schemes: ['map'],
+        capabilities,
+        description: 'Multi-Agent Protocol (MAP) provider. Surfaces remote MAP tasks as map:// nodes. All operations are direct RPC calls with no local cache.',
+        metadataSchema: {
+            fields: {},
+            description: 'Metadata is passed through as MAP task meta. Priority is stored in meta.priority. Assignee is a top-level field handled via task assignment, not metadata.',
+        },
+        // =========================================================================
+        // URI Operations
+        // =========================================================================
+        parseUri(uri) {
+            const match = uri.match(MAP_URI_PATTERN);
+            if (match) {
+                return {
+                    scheme: 'map',
+                    workspace: match[1] || systemId,
+                    id: match[2],
+                    isRelative: !match[1] || match[1] === systemId,
+                };
+            }
+            return null;
+        },
+        buildUri(id, options) {
+            const ws = options?.workspace ?? systemId;
+            return `map://${ws}/${id}`;
+        },
+        isValidUri(uri) {
+            return this.parseUri(uri) !== null;
+        },
+        // =========================================================================
+        // CRUD Operations
+        // =========================================================================
+        async get(id, _context) {
+            const parsed = this.parseUri(id);
+            const taskId = parsed?.id ?? id;
+            try {
+                const { tasks } = await client.listTasks({
+                    limit: 100,
+                });
+                const task = tasks.find((t) => t.id === taskId);
+                return task ? taskToProviderNode(task, systemId) : null;
+            }
+            catch (error) {
+                throw new ProviderError('OPERATION_FAILED', `Failed to get MAP task: ${error instanceof Error ? error.message : String(error)}`, 'map', error instanceof Error ? error : undefined);
+            }
+        },
+        async list(filter, _context) {
+            try {
+                const mapFilter = {};
+                if (filter?.status) {
+                    mapFilter.status = mapStatusToMAP(filter.status);
+                }
+                const { tasks } = await client.listTasks({
+                    filter: Object.keys(mapFilter).length > 0 ? mapFilter : undefined,
+                    limit: filter?.limit,
+                });
+                return tasks.map((task) => taskToProviderNode(task, systemId));
+            }
+            catch (error) {
+                throw new ProviderError('OPERATION_FAILED', `Failed to list MAP tasks: ${error instanceof Error ? error.message : String(error)}`, 'map', error instanceof Error ? error : undefined);
+            }
+        },
+        async create(input, _context) {
+            try {
+                const { task } = await client.createTask({
+                    task: {
+                        title: input.title,
+                        description: input.content,
+                        status: input.status ? mapStatusToMAP(input.status) : 'open',
+                        meta: {
+                            ...input.metadata,
+                            ...input.extensions,
+                            provider: 'opentasks',
+                            priority: input.priority,
+                        },
+                    },
+                });
+                return taskToProviderNode(task, systemId);
+            }
+            catch (error) {
+                throw new ProviderError('OPERATION_FAILED', `Failed to create MAP task: ${error instanceof Error ? error.message : String(error)}`, 'map', error instanceof Error ? error : undefined);
+            }
+        },
+        async update(id, updates, _context) {
+            const parsed = this.parseUri(id);
+            const taskId = parsed?.id ?? id;
+            try {
+                const { task } = await client.updateTask({
+                    taskId,
+                    ...(updates.title !== undefined && { title: updates.title }),
+                    ...(updates.content !== undefined && { description: updates.content }),
+                    ...(updates.status !== undefined && { status: mapStatusToMAP(updates.status) }),
+                    ...(updates.metadata !== undefined && { meta: updates.metadata }),
+                });
+                return taskToProviderNode(task, systemId);
+            }
+            catch (error) {
+                throw new ProviderError('OPERATION_FAILED', `Failed to update MAP task: ${error instanceof Error ? error.message : String(error)}`, 'map', error instanceof Error ? error : undefined);
+            }
+        },
+        async delete(id, _context) {
+            // MAP doesn't have a delete method — mark as failed/completed instead
+            const parsed = this.parseUri(id);
+            const taskId = parsed?.id ?? id;
+            try {
+                await client.updateTask({
+                    taskId,
+                    status: 'failed',
+                    meta: { deleted: true, deletedAt: new Date().toISOString() },
+                });
+            }
+            catch (error) {
+                throw new ProviderError('OPERATION_FAILED', `Failed to delete MAP task: ${error instanceof Error ? error.message : String(error)}`, 'map', error instanceof Error ? error : undefined);
+            }
+        },
+        // =========================================================================
+        // TaskManageable Trait
+        // =========================================================================
+        taskCapabilities,
+        async transitionTask(id, action, _context) {
+            const parsed = this.parseUri(id);
+            const taskId = parsed?.id ?? id;
+            try {
+                const { task } = await client.updateTask({
+                    taskId,
+                    status: actionToMAPStatus(action),
+                });
+                return taskToProviderNode(task, systemId);
+            }
+            catch (error) {
+                throw new ProviderError('OPERATION_FAILED', `Failed to transition MAP task: ${error instanceof Error ? error.message : String(error)}`, 'map', error instanceof Error ? error : undefined);
+            }
+        },
+        async readyTasks(options, _context) {
+            try {
+                const { tasks } = await client.listTasks({
+                    filter: {
+                        status: 'open',
+                        ...(options?.assignee && { assignee: options.assignee }),
+                    },
+                    limit: options?.limit,
+                });
+                let result = tasks.map((task) => taskToProviderNode(task, systemId));
+                // Filter by priority if specified (MAP doesn't have native priority filtering)
+                if (options?.priority !== undefined) {
+                    result = result.filter((node) => (node.priority ?? 0) >= options.priority);
+                }
+                return result;
+            }
+            catch (error) {
+                throw new ProviderError('OPERATION_FAILED', `Failed to query ready MAP tasks: ${error instanceof Error ? error.message : String(error)}`, 'map', error instanceof Error ? error : undefined);
+            }
+        },
+        async assignTask(id, assignee, _context) {
+            const parsed = this.parseUri(id);
+            const taskId = parsed?.id ?? id;
+            try {
+                const { task } = await client.assignTask(taskId, assignee);
+                return taskToProviderNode(task, systemId);
+            }
+            catch (error) {
+                throw new ProviderError('OPERATION_FAILED', `Failed to assign MAP task: ${error instanceof Error ? error.message : String(error)}`, 'map', error instanceof Error ? error : undefined);
+            }
+        },
+        async validActions(id, _context) {
+            const node = await this.get(id);
+            if (!node)
+                return [];
+            const status = node.rawData?.status;
+            switch (status) {
+                case 'open': return ['start', 'block', 'close'];
+                case 'in_progress': return ['complete', 'block'];
+                case 'blocked': return ['reopen', 'close'];
+                case 'completed': return ['reopen'];
+                case 'failed': return ['reopen'];
+                default: return ['start', 'complete', 'block', 'reopen', 'close'];
+            }
+        },
+    };
+    // =========================================================================
+    // Watchable Trait (conditional — only if client supports events)
+    // =========================================================================
+    if (hasEvents) {
+        Object.assign(provider, {
+            watchGranularity,
+            startWatching(callback) {
+                watchCallback = callback;
+                unsubscribeEvents = client.onTaskEvent((event) => {
+                    const { type, data } = event;
+                    switch (type) {
+                        case 'task.created': {
+                            const task = data.task;
+                            if (task) {
+                                callback({
+                                    kind: 'node',
+                                    event: {
+                                        type: 'created',
+                                        nodeId: task.id,
+                                        uri: `map://${systemId}/${task.id}`,
+                                        node: taskToProviderNode(task, systemId),
+                                        timestamp: new Date().toISOString(),
+                                    },
+                                });
+                            }
+                            break;
+                        }
+                        case 'task.assigned':
+                        case 'task.status': {
+                            const taskId = data.taskId;
+                            if (taskId) {
+                                callback({
+                                    kind: 'node',
+                                    event: {
+                                        type: 'updated',
+                                        nodeId: taskId,
+                                        uri: `map://${systemId}/${taskId}`,
+                                        previousValues: type === 'task.status' ? { status: data.previous } : undefined,
+                                        timestamp: new Date().toISOString(),
+                                    },
+                                });
+                            }
+                            break;
+                        }
+                        case 'task.completed': {
+                            const taskId = data.taskId;
+                            if (taskId) {
+                                callback({
+                                    kind: 'node',
+                                    event: {
+                                        type: 'updated',
+                                        nodeId: taskId,
+                                        uri: `map://${systemId}/${taskId}`,
+                                        changedFields: ['status'],
+                                        previousValues: { status: 'in_progress' },
+                                        timestamp: new Date().toISOString(),
+                                    },
+                                });
+                            }
+                            break;
+                        }
+                    }
+                });
+            },
+            stopWatching() {
+                if (unsubscribeEvents) {
+                    unsubscribeEvents();
+                    unsubscribeEvents = null;
+                }
+                watchCallback = null;
+            },
+            get isWatching() {
+                return watchCallback !== null;
+            },
+        });
+    }
+    return provider;
+}
+//# sourceMappingURL=map.js.map

package/dist/providers/map.js.map

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

package/dist/providers/materialization.d.ts

@@ -5,8 +5,26 @@
  * 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 { Node, ExternalNode } from '../schema/index.js';
 import type { Provider, ProviderNode, ProviderRegistry, ProviderOperationContext, MaterializationStrategy, MaterializationConfig } from './types.js';
+/**
+ * Options for the materialize() call
+ */
+export interface MaterializeOptions {
+    /**
+     * Whether the provider is local (always reachable, compatible status semantics).
+     * When true, materializes as native node type (task/context) with metadata.provider_uri.
+     * When false/undefined, materializes as type:'external' (current behavior).
+     */
+    local?: boolean;
+    /**
+     * Materialization mode for this node.
+     * - 'cached': Store full data (title, content, status) in the graph node.
+     * - 'pointer': Store only the provider_uri reference; data resolved on access.
+     * Default: 'cached'
+     */
+    materializeMode?: 'cached' | 'pointer';
+}
 /**
  * Context for materialization decisions
  */
@@ -26,12 +44,12 @@ export interface MaterializationManager {
     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 */
+    /** Materialize a provider node into the local graph */
+    materialize(uri: string, providerNode: ProviderNode, store: GraphStore, options?: MaterializeOptions): Promise<Node>;
+    /** Check if a materialized node is stale (only applies to remote/external nodes) */
     isStale(node: ExternalNode): boolean;
     /** Refresh a stale node */
-    refresh(node: ExternalNode, provider: Provider, store: GraphStore, context?: ProviderOperationContext): Promise<ExternalNode | null>;
+    refresh(node: ExternalNode, provider: Provider, store: GraphStore, context?: ProviderOperationContext): Promise<Node | null>;
     /** Start background sync */
     startBackgroundSync(store: GraphStore, registry: ProviderRegistry): void;
     /** Stop background sync */

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

@@ -1 +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"}
+{"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,IAAI,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACxC;AAED;;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,uDAAuD;IACvD,WAAW,CACT,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,oFAAoF;IACpF,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,IAAI,GAAG,IAAI,CAAC,CAAC;IAExB,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;AAqED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAC7C,sBAAsB,CA4SxB"}

package/dist/providers/materialization.js

@@ -31,6 +31,36 @@ async function findByUri(uri, store) {
     }
     return null;
 }
+/**
+ * Find existing node by provider_uri in metadata (for local-provider nodes)
+ */
+async function findByProviderUri(uri, store) {
+    // Scan task and context nodes for a metadata.provider_uri match.
+    // Note: search only checks title/content, not metadata, so we scan by type.
+    for (const type of ['task', 'context']) {
+        const nodes = await store.query.nodes({ type });
+        for (const node of nodes) {
+            if (node.metadata?.provider_uri === uri) {
+                return node;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Map provider node type to local graph node type
+ */
+function mapProviderTypeToNodeType(providerType) {
+    switch (providerType) {
+        case 'spec':
+            return 'context';
+        case 'issue':
+        case 'task':
+        case 'feedback':
+        default:
+            return 'task';
+    }
+}
 // ============================================================================
 // Materialization Manager Implementation
 // ============================================================================
@@ -82,18 +112,76 @@ export function createMaterializationManager(partialConfig) {
             }
         },
         /**
-         * Materialize an external node from provider data
+         * Materialize a provider node into the local graph.
+         *
+         * When options.local is true, creates a native node (task/context) with
+         * metadata.provider_uri and metadata.provider_source as back-references.
+         * When false/undefined, creates a type:'external' node (remote behavior).
          */
-        async materialize(uri, providerNode, store) {
+        async materialize(uri, providerNode, store, options) {
             const source = extractSource(uri);
             const now = new Date().toISOString();
+            // ── Local provider path ──────────────────────────────────────────
+            if (options?.local) {
+                const nodeType = mapProviderTypeToNodeType(providerNode.type);
+                const isPointer = options.materializeMode === 'pointer';
+                // Check for existing node by provider_uri
+                const existing = await findByProviderUri(uri, store);
+                if (existing) {
+                    const updated = await store.updateNode(existing.id, {
+                        // Pointer-only mode: don't cache data fields
+                        ...(isPointer
+                            ? {}
+                            : {
+                                title: providerNode.title,
+                                content: providerNode.content,
+                                status: providerNode.status,
+                                priority: providerNode.priority,
+                            }),
+                        metadata: {
+                            ...existing.metadata,
+                            provider_uri: uri,
+                            provider_source: source,
+                            provider_cached_at: isPointer ? undefined : now,
+                            provider_authoritative: true,
+                            provider_content_hash: providerNode.contentHash ?? existing.metadata?.provider_content_hash,
+                            ...(isPointer ? { provider_pointer_only: true } : {}),
+                        },
+                    });
+                    return updated;
+                }
+                // Create new native node with provider back-reference
+                const node = await store.createNode({
+                    type: nodeType,
+                    // Pointer-only mode: minimal stub
+                    title: isPointer ? '(pending)' : providerNode.title,
+                    content: isPointer ? undefined : providerNode.content,
+                    status: isPointer ? (providerNode.status ?? 'open') : (providerNode.status ?? 'open'),
+                    priority: isPointer ? undefined : providerNode.priority,
+                    metadata: {
+                        provider_uri: uri,
+                        provider_source: source,
+                        provider_cached_at: isPointer ? undefined : now,
+                        provider_authoritative: true,
+                        provider_content_hash: providerNode.contentHash ?? undefined,
+                        ...(isPointer ? { provider_pointer_only: true } : {}),
+                    },
+                });
+                return node;
+            }
+            // ── Remote provider path (existing behavior) ─────────────────────
             // Check if already exists
             const existing = await findByUri(uri, store);
             if (existing) {
-                // Update existing node
+                // Update existing node — sync top-level ExternalNode fields + metadata
                 const updated = await store.updateNode(existing.id, {
                     title: providerNode.title,
                     content: providerNode.content,
+                    external_status: providerNode.status,
+                    external_data: providerNode.rawData,
+                    cached_at: now,
+                    stale: false,
+                    materialized: true,
                     metadata: {
                         ...existing.metadata,
                         external_status: providerNode.status,
@@ -105,7 +193,7 @@ export function createMaterializationManager(partialConfig) {
                 });
                 return updated;
             }
-            // Create new ExternalNode
+            // Create new ExternalNode — set top-level fields per schema + metadata
             const node = await store.createNode({
                 type: 'external',
                 uri,
@@ -113,6 +201,9 @@ export function createMaterializationManager(partialConfig) {
                 title: providerNode.title,
                 content: providerNode.content,
                 materialized: true,
+                external_status: providerNode.status,
+                external_data: providerNode.rawData,
+                cached_at: now,
                 metadata: {
                     external_status: providerNode.status,
                     external_data: providerNode.rawData,

package/dist/providers/materialization.js.map

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

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

@@ -1 +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"}
+{"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,CA6hBxE"}

package/dist/providers/native.js

@@ -249,6 +249,11 @@ export function createNativeProvider(store, config) {
         name: 'native',
         schemes: ['native', 'opentasks'],
         capabilities,
+        description: 'Built-in graph store. Stores tasks as nodes in the local JSONL graph. Tags, assignee, parent_id, and priority are top-level task fields. The metadata bag accepts arbitrary key/value pairs.',
+        metadataSchema: {
+            fields: {},
+            description: 'Accepts arbitrary metadata key/value pairs. Note: tags, assignee, parent_id, and priority are top-level fields on create_task/update_task — do not put them in metadata.',
+        },
         // =========================================================================
         // URI Operations
         // =========================================================================