opentasks 0.0.1 → 0.0.3

package/dist/tools/query.js

@@ -0,0 +1,342 @@
+/**
+ * Query Tool
+ *
+ * Unified query interface for graph traversal.
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_LIMIT = 50;
+const DEFAULT_OFFSET = 0;
+const CONTENT_PREVIEW_LENGTH = 100;
+// ============================================================================
+// Summary Converters
+// ============================================================================
+/**
+ * Convert a Node to NodeSummary (reduced representation)
+ */
+function toNodeSummary(node) {
+    return {
+        id: node.id,
+        type: node.type,
+        title: node.title,
+        status: 'status' in node ? node.status : undefined,
+        priority: node.priority,
+        archived: node.archived ?? false,
+    };
+}
+/**
+ * Convert an Edge to EdgeSummary (reduced representation)
+ */
+function toEdgeSummary(edge) {
+    return {
+        id: edge.id,
+        fromId: edge.from_id,
+        toId: edge.to_id,
+        type: edge.type,
+    };
+}
+/**
+ * Convert a Feedback node to FeedbackSummary (reduced representation)
+ */
+function toFeedbackSummary(feedback) {
+    const content = feedback.content || '';
+    const preview = content.length > CONTENT_PREVIEW_LENGTH
+        ? content.substring(0, CONTENT_PREVIEW_LENGTH) + '...'
+        : content;
+    return {
+        id: feedback.id,
+        targetId: feedback.target_id,
+        feedbackType: feedback.feedback_type,
+        resolved: feedback.resolved ?? false,
+        dismissed: feedback.dismissed ?? false,
+        contentPreview: preview,
+    };
+}
+// ============================================================================
+// Query Type Detection
+// ============================================================================
+/**
+ * Count how many query types are specified
+ */
+function countQueryTypes(params) {
+    let count = 0;
+    if (params.nodes !== undefined)
+        count++;
+    if (params.edges !== undefined)
+        count++;
+    if (params.ready !== undefined)
+        count++;
+    if (params.blockers !== undefined)
+        count++;
+    if (params.blocking !== undefined)
+        count++;
+    if (params.feedback !== undefined)
+        count++;
+    if (params.unresolvedFeedback !== undefined)
+        count++;
+    if (params.tasks !== undefined)
+        count++;
+    if (params.context !== undefined)
+        count++;
+    return count;
+}
+/**
+ * Get the active query type name
+ */
+function getQueryTypeName(params) {
+    if (params.nodes !== undefined)
+        return 'nodes';
+    if (params.edges !== undefined)
+        return 'edges';
+    if (params.ready !== undefined)
+        return 'ready';
+    if (params.blockers !== undefined)
+        return 'blockers';
+    if (params.blocking !== undefined)
+        return 'blocking';
+    if (params.feedback !== undefined)
+        return 'feedback';
+    if (params.unresolvedFeedback !== undefined)
+        return 'unresolvedFeedback';
+    if (params.tasks !== undefined)
+        return 'tasks';
+    if (params.context !== undefined)
+        return 'context';
+    return 'unknown';
+}
+// ============================================================================
+// Pagination Helpers
+// ============================================================================
+/**
+ * Apply pagination to results
+ */
+function paginate(items, limit, offset) {
+    const start = offset;
+    const end = offset + limit;
+    const paginated = items.slice(start, end);
+    const hasMore = items.length > end;
+    return { items: paginated, hasMore };
+}
+// ============================================================================
+// Query Tool Implementation
+// ============================================================================
+/**
+ * Query the graph with unified interface
+ *
+ * @param store - Graph store for data operations
+ * @param params - Query parameters
+ * @param _context - Optional operation context (unused but kept for API consistency)
+ * @returns Query result with items and pagination info
+ */
+export async function query(store, params, _context) {
+    // Validate exactly one query type
+    const queryTypeCount = countQueryTypes(params);
+    if (queryTypeCount === 0) {
+        throw new Error('No query type specified. Provide one of: nodes, edges, ready, blockers, blocking, feedback, unresolvedFeedback, tasks, context');
+    }
+    if (queryTypeCount > 1) {
+        throw new Error('Multiple query types specified. Provide exactly one of: nodes, edges, ready, blockers, blocking, feedback, unresolvedFeedback, tasks, context');
+    }
+    const limit = params.limit ?? DEFAULT_LIMIT;
+    const offset = params.offset ?? DEFAULT_OFFSET;
+    const verbose = params.verbose ?? false;
+    // Dispatch to appropriate query handler
+    if (params.nodes !== undefined) {
+        return queryNodes(store, params.nodes, limit, offset, verbose);
+    }
+    if (params.edges !== undefined) {
+        return queryEdges(store, params.edges, limit, offset, verbose);
+    }
+    if (params.ready !== undefined) {
+        return queryReady(store, params.ready, limit, offset, verbose);
+    }
+    if (params.blockers !== undefined) {
+        return queryBlockers(store, params.blockers, limit, offset, verbose);
+    }
+    if (params.blocking !== undefined) {
+        return queryBlocking(store, params.blocking, limit, offset, verbose);
+    }
+    if (params.feedback !== undefined) {
+        return queryFeedback(store, params.feedback, limit, offset, verbose);
+    }
+    if (params.unresolvedFeedback !== undefined) {
+        return queryUnresolvedFeedback(store, params.unresolvedFeedback, limit, offset, verbose);
+    }
+    if (params.tasks !== undefined) {
+        return queryTasks(store, params.tasks, limit, offset, verbose);
+    }
+    if (params.context !== undefined) {
+        return queryContext(store, params.context, limit, offset, verbose);
+    }
+    // Should never reach here
+    throw new Error('Unknown query type');
+}
+// ============================================================================
+// Query Handlers
+// ============================================================================
+async function queryNodes(store, filter, limit, offset, verbose) {
+    // Query without limit/offset first to get total
+    const allNodes = await store.query.nodes({ ...filter, limit: undefined, offset: undefined });
+    const { items: paginatedNodes, hasMore } = paginate(allNodes, limit, offset);
+    if (verbose) {
+        return {
+            items: paginatedNodes,
+            total: allNodes.length,
+            hasMore,
+        };
+    }
+    return {
+        items: paginatedNodes.map(toNodeSummary),
+        total: allNodes.length,
+        hasMore,
+    };
+}
+async function queryEdges(store, filter, limit, offset, verbose) {
+    // Query without limit/offset first to get total
+    const allEdges = await store.query.edges({ ...filter, limit: undefined, offset: undefined });
+    const { items: paginatedEdges, hasMore } = paginate(allEdges, limit, offset);
+    if (verbose) {
+        return {
+            items: paginatedEdges,
+            total: allEdges.length,
+            hasMore,
+        };
+    }
+    return {
+        items: paginatedEdges.map(toEdgeSummary),
+        total: allEdges.length,
+        hasMore,
+    };
+}
+async function queryReady(store, options, limit, offset, verbose) {
+    // Query without limit first to get total
+    const allReady = await store.query.ready({ ...options, limit: undefined });
+    const { items: paginatedReady, hasMore } = paginate(allReady, limit, offset);
+    if (verbose) {
+        return {
+            items: paginatedReady,
+            total: allReady.length,
+            hasMore,
+        };
+    }
+    return {
+        items: paginatedReady.map(toNodeSummary),
+        total: allReady.length,
+        hasMore,
+    };
+}
+async function queryBlockers(store, params, limit, offset, verbose) {
+    const { nodeId, transitive, activeOnly } = params;
+    const allBlockers = await store.query.blockers(nodeId, {
+        transitive,
+        activeOnly,
+    });
+    const { items: paginatedBlockers, hasMore } = paginate(allBlockers, limit, offset);
+    if (verbose) {
+        return {
+            items: paginatedBlockers,
+            total: allBlockers.length,
+            hasMore,
+        };
+    }
+    return {
+        items: paginatedBlockers.map(toNodeSummary),
+        total: allBlockers.length,
+        hasMore,
+    };
+}
+async function queryBlocking(store, params, limit, offset, verbose) {
+    const { nodeId, transitive, activeOnly } = params;
+    const allBlocking = await store.query.blocking(nodeId, {
+        transitive,
+        activeOnly,
+    });
+    const { items: paginatedBlocking, hasMore } = paginate(allBlocking, limit, offset);
+    if (verbose) {
+        return {
+            items: paginatedBlocking,
+            total: allBlocking.length,
+            hasMore,
+        };
+    }
+    return {
+        items: paginatedBlocking.map(toNodeSummary),
+        total: allBlocking.length,
+        hasMore,
+    };
+}
+async function queryFeedback(store, params, limit, offset, verbose) {
+    const { nodeId, type, resolved, includeDismissed } = params;
+    const allFeedback = await store.query.feedback(nodeId, {
+        type,
+        resolved,
+        includeDismissed,
+    });
+    const { items: paginatedFeedback, hasMore } = paginate(allFeedback, limit, offset);
+    if (verbose) {
+        return {
+            items: paginatedFeedback,
+            total: allFeedback.length,
+            hasMore,
+        };
+    }
+    return {
+        items: paginatedFeedback.map(toFeedbackSummary),
+        total: allFeedback.length,
+        hasMore,
+    };
+}
+async function queryUnresolvedFeedback(store, params, limit, offset, verbose) {
+    const { targetId } = params;
+    // Get all unresolved feedback (optionally filtered by target)
+    const allUnresolved = await store.query.unresolvedFeedback(targetId);
+    const { items: paginatedFeedback, hasMore } = paginate(allUnresolved, limit, offset);
+    if (verbose) {
+        return {
+            items: paginatedFeedback,
+            total: allUnresolved.length,
+            hasMore,
+        };
+    }
+    return {
+        items: paginatedFeedback.map(toFeedbackSummary),
+        total: allUnresolved.length,
+        hasMore,
+    };
+}
+async function queryTasks(store, params, limit, offset, verbose) {
+    const { contextId } = params;
+    const allTasks = await store.query.tasks(contextId);
+    const { items: paginatedTasks, hasMore } = paginate(allTasks, limit, offset);
+    if (verbose) {
+        return {
+            items: paginatedTasks,
+            total: allTasks.length,
+            hasMore,
+        };
+    }
+    return {
+        items: paginatedTasks.map(toNodeSummary),
+        total: allTasks.length,
+        hasMore,
+    };
+}
+async function queryContext(store, params, limit, offset, verbose) {
+    const { taskId } = params;
+    const allContext = await store.query.context(taskId);
+    const { items: paginatedContext, hasMore } = paginate(allContext, limit, offset);
+    if (verbose) {
+        return {
+            items: paginatedContext,
+            total: allContext.length,
+            hasMore,
+        };
+    }
+    return {
+        items: paginatedContext.map(toNodeSummary),
+        total: allContext.length,
+        hasMore,
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/tools/query.js.map

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

package/dist/tools/task.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Task Tool
+ *
+ * Specialized task lifecycle interface for providers that support
+ * semantic task operations (start, complete, block, etc.).
+ *
+ * Operates on the ProviderAwareStore's task methods, which delegate
+ * to TaskManageable providers.
+ */
+import type { ProviderAwareStore } from '../graph/provider-store.js';
+import type { TaskParams, TaskResult } from './types.js';
+/**
+ * Execute a task lifecycle operation
+ *
+ * @param store - Provider-aware store with task methods
+ * @param params - Task operation parameters
+ * @returns Task result
+ */
+export declare function task(store: ProviderAwareStore, params: TaskParams): Promise<TaskResult>;
+//# sourceMappingURL=task.d.ts.map

package/dist/tools/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EAMX,MAAM,YAAY,CAAC;AAwCpB;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA2C7F"}

package/dist/tools/task.js

@@ -0,0 +1,161 @@
+/**
+ * Task Tool
+ *
+ * Specialized task lifecycle interface for providers that support
+ * semantic task operations (start, complete, block, etc.).
+ *
+ * Operates on the ProviderAwareStore's task methods, which delegate
+ * to TaskManageable providers.
+ */
+// ============================================================================
+// Summary Converter
+// ============================================================================
+/**
+ * Convert a Node to NodeSummary (reduced representation)
+ */
+function toNodeSummary(node) {
+    return {
+        id: node.id,
+        type: node.type,
+        title: node.title,
+        status: 'status' in node ? node.status : undefined,
+        priority: node.priority,
+        archived: node.archived ?? false,
+    };
+}
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Count how many operations are specified
+ */
+function countOperations(params) {
+    let count = 0;
+    if (params.transition !== undefined)
+        count++;
+    if (params.ready !== undefined)
+        count++;
+    if (params.assign !== undefined)
+        count++;
+    if (params.validActions !== undefined)
+        count++;
+    return count;
+}
+// ============================================================================
+// Task Tool Implementation
+// ============================================================================
+/**
+ * Execute a task lifecycle operation
+ *
+ * @param store - Provider-aware store with task methods
+ * @param params - Task operation parameters
+ * @returns Task result
+ */
+export async function task(store, params) {
+    // Validate exactly one operation
+    const opCount = countOperations(params);
+    if (opCount === 0) {
+        return {
+            success: false,
+            error: 'No operation specified. Provide one of: transition, ready, assign, validActions',
+        };
+    }
+    if (opCount > 1) {
+        return {
+            success: false,
+            error: 'Multiple operations specified. Provide exactly one of: transition, ready, assign, validActions',
+        };
+    }
+    try {
+        if (params.transition) {
+            return await handleTransition(store, params.transition);
+        }
+        if (params.ready) {
+            return await handleReady(store, params.ready);
+        }
+        if (params.assign) {
+            return await handleAssign(store, params.assign);
+        }
+        if (params.validActions) {
+            return await handleValidActions(store, params.validActions);
+        }
+        return { success: false, error: 'Unknown operation' };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+// ============================================================================
+// Operation Handlers
+// ============================================================================
+async function handleTransition(store, params) {
+    const { id, action } = params;
+    if (!id) {
+        return { success: false, error: 'Missing required parameter: id' };
+    }
+    if (!action) {
+        return { success: false, error: 'Missing required parameter: action' };
+    }
+    const validActions = ['start', 'complete', 'block', 'reopen', 'close'];
+    if (!validActions.includes(action)) {
+        return {
+            success: false,
+            error: `Invalid action: ${action}. Must be one of: ${validActions.join(', ')}`,
+        };
+    }
+    const result = await store.taskTransition(id, action);
+    const data = {
+        type: 'transition',
+        node: toNodeSummary(result.node),
+        provider: result.provider,
+        action: result.action,
+    };
+    return { success: true, data };
+}
+async function handleReady(store, params) {
+    const nodes = await store.taskReady({
+        providers: params.providers,
+        limit: params.limit,
+        tags: params.tags,
+        priority: params.priority,
+        assignee: params.assignee,
+    });
+    const data = {
+        type: 'ready',
+        items: nodes.map(toNodeSummary),
+        total: nodes.length,
+    };
+    return { success: true, data };
+}
+async function handleAssign(store, params) {
+    const { id, assignee } = params;
+    if (!id) {
+        return { success: false, error: 'Missing required parameter: id' };
+    }
+    if (!assignee) {
+        return { success: false, error: 'Missing required parameter: assignee' };
+    }
+    const node = await store.taskAssign(id, assignee);
+    const data = {
+        type: 'assign',
+        node: toNodeSummary(node),
+        provider: 'unknown', // TODO: store could return this
+    };
+    return { success: true, data };
+}
+async function handleValidActions(store, params) {
+    const { id } = params;
+    if (!id) {
+        return { success: false, error: 'Missing required parameter: id' };
+    }
+    const actions = await store.taskValidActions(id);
+    const data = {
+        type: 'validActions',
+        actions,
+    };
+    return { success: true, data };
+}
+//# sourceMappingURL=task.js.map

package/dist/tools/task.js.map

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