opentasks 0.0.1 → 0.0.3

package/dist/client/client.d.ts

@@ -0,0 +1,228 @@
+/**
+ * OpenTasks Client
+ *
+ * Client library for interacting with the OpenTasks daemon.
+ * Provides a typed wrapper around the 3-tool interface.
+ */
+import type { LinkParams, LinkResult, QueryParams, QueryResult, AnnotateParams, AnnotateResult, TaskParams, TaskResult, NodeSummary, FeedbackSummary, ReadyOptions, BlockerOptions, FeedbackOptions } from '../tools/types.js';
+import type { CreateNodeInput, UpdateNodeInput, DeleteOptions } from '../graph/types.js';
+/**
+ * Options for creating an OpenTasks client
+ */
+export interface ClientOptions {
+    /** Path to the daemon socket file */
+    socketPath?: string;
+    /** Auto-connect on first request (default: true) */
+    autoConnect?: boolean;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Error thrown when client operations fail
+ */
+export declare class ClientError extends Error {
+    readonly code: 'NOT_CONNECTED' | 'CONNECTION_FAILED' | 'REQUEST_FAILED' | 'SOCKET_NOT_FOUND';
+    constructor(message: string, code: 'NOT_CONNECTED' | 'CONNECTION_FAILED' | 'REQUEST_FAILED' | 'SOCKET_NOT_FOUND');
+}
+/**
+ * Client for interacting with the OpenTasks daemon
+ *
+ * Provides typed access to the 3-tool interface (link, query, annotate)
+ * plus convenience methods for common operations.
+ *
+ * @example
+ * ```typescript
+ * const client = new OpenTasksClient()
+ *
+ * // Find ready work
+ * const ready = await client.ready()
+ *
+ * // Create a relationship
+ * await client.link({
+ *   from_id: 'i-abc1',
+ *   to_id: 's-def2',
+ *   type: 'implements'
+ * })
+ *
+ * // Add feedback
+ * await client.annotate({
+ *   target_id: 's-def2',
+ *   create: { content: 'Implementation complete' }
+ * })
+ *
+ * client.disconnect()
+ * ```
+ */
+export declare class OpenTasksClient {
+    private client;
+    private readonly options;
+    private socketPath;
+    constructor(options?: ClientOptions);
+    /**
+     * Connect to the daemon
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the daemon
+     */
+    disconnect(): void;
+    /**
+     * Check if connected to the daemon
+     */
+    get connected(): boolean;
+    /**
+     * Ensure connection before making a request
+     */
+    private ensureConnected;
+    /**
+     * Create or remove an edge between nodes
+     *
+     * @param params - Link parameters
+     * @returns Link result with success status
+     */
+    link(params: LinkParams): Promise<LinkResult>;
+    /**
+     * Query the graph
+     *
+     * @param params - Query parameters
+     * @returns Query result with items and pagination info
+     */
+    query(params: QueryParams): Promise<QueryResult>;
+    /**
+     * Manage feedback lifecycle
+     *
+     * @param params - Annotate parameters
+     * @returns Annotate result with success status
+     */
+    annotate(params: AnnotateParams): Promise<AnnotateResult>;
+    /**
+     * Task lifecycle operations
+     *
+     * @param params - Task parameters (transition, ready, assign, or validActions)
+     * @returns Task result with operation-specific data
+     */
+    task(params: TaskParams): Promise<TaskResult>;
+    /**
+     * Get issues ready to work on (no active blockers)
+     *
+     * @param options - Ready query options
+     * @returns Array of ready issue summaries
+     */
+    ready(options?: ReadyOptions): Promise<NodeSummary[]>;
+    /**
+     * Get nodes blocking a specific node
+     *
+     * @param nodeId - Node to find blockers for
+     * @param options - Blocker query options
+     * @returns Array of blocking node summaries
+     */
+    blockers(nodeId: string, options?: Omit<BlockerOptions, 'nodeId'>): Promise<NodeSummary[]>;
+    /**
+     * Get nodes blocked by a specific node
+     *
+     * @param nodeId - Node to find blocked nodes for
+     * @param options - Blocker query options
+     * @returns Array of blocked node summaries
+     */
+    blocking(nodeId: string, options?: Omit<BlockerOptions, 'nodeId'>): Promise<NodeSummary[]>;
+    /**
+     * Get feedback on a specific node
+     *
+     * @param nodeId - Node to get feedback for
+     * @param options - Feedback query options
+     * @returns Array of feedback summaries
+     */
+    feedback(nodeId: string, options?: Omit<FeedbackOptions, 'nodeId'>): Promise<FeedbackSummary[]>;
+    /**
+     * Transition a task's status using a semantic action
+     *
+     * @param id - Task ID or provider URI
+     * @param action - Semantic action ('start', 'complete', 'block', 'reopen', 'close')
+     * @returns Task result with updated node
+     */
+    taskTransition(id: string, action: 'start' | 'complete' | 'block' | 'reopen' | 'close'): Promise<TaskResult>;
+    /**
+     * Get tasks ready to work on across all task-capable providers
+     *
+     * @param options - Ready task query options
+     * @returns Task result with ready items
+     */
+    taskReady(options?: {
+        providers?: string[];
+        limit?: number;
+        tags?: string[];
+    }): Promise<TaskResult>;
+    /**
+     * Assign a task to an owner
+     *
+     * @param id - Task ID or provider URI
+     * @param assignee - Assignee identifier
+     * @returns Task result with updated node
+     */
+    taskAssign(id: string, assignee: string): Promise<TaskResult>;
+    /**
+     * Get valid next actions for a task in its current state
+     *
+     * @param id - Task ID or provider URI
+     * @returns Task result with valid actions
+     */
+    taskValidActions(id: string): Promise<TaskResult>;
+    /**
+     * Create a node.
+     * When `scheme` is provided, routes creation to that provider.
+     * Otherwise uses the configured defaultProvider.
+     *
+     * @param params - Node creation parameters
+     * @param options - Optional provider routing options
+     * @returns The created node (materialized locally if via external provider)
+     */
+    createNode(params: CreateNodeInput, options?: {
+        scheme?: string;
+    }): Promise<unknown>;
+    /**
+     * Get a node by local ID or provider URI.
+     * For external/materialized nodes, refreshes if stale.
+     *
+     * @param idOrUri - Local node ID (e.g., 'i-abc1') or provider URI (e.g., 'sudocode://proj/i-456')
+     */
+    getNode(idOrUri: string): Promise<unknown>;
+    /**
+     * Update a node by local ID or provider URI.
+     * For external/materialized nodes, routes update to the owning provider.
+     *
+     * @param idOrUri - Local node ID or provider URI
+     * @param updates - Fields to update
+     */
+    updateNode(idOrUri: string, updates: UpdateNodeInput): Promise<unknown>;
+    /**
+     * Delete a node by local ID or provider URI.
+     * For external/materialized nodes, deletes in the owning provider
+     * and removes the local materialized copy.
+     *
+     * @param idOrUri - Local node ID or provider URI
+     * @param options - Delete options (hard vs soft)
+     */
+    deleteNode(idOrUri: string, options?: DeleteOptions): Promise<void>;
+    /**
+     * List all registered providers and their capabilities
+     */
+    listProviders(): Promise<unknown>;
+    /**
+     * Get info about a specific provider
+     *
+     * @param name - Provider name
+     */
+    getProvider(name: string): Promise<unknown>;
+    /**
+     * Call any daemon method by name
+     */
+    call<R = unknown>(method: string, params?: unknown): Promise<R>;
+}
+/**
+ * Create a new OpenTasks client
+ *
+ * @param options - Client options
+ * @returns OpenTasks client instance
+ */
+export declare function createClient(options?: ClientOptions): OpenTasksClient;
+//# sourceMappingURL=client.d.ts.map

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

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

package/dist/client/client.js

@@ -0,0 +1,393 @@
+/**
+ * OpenTasks Client
+ *
+ * Client library for interacting with the OpenTasks daemon.
+ * Provides a typed wrapper around the 3-tool interface.
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { createIPCClient } from '../daemon/ipc.js';
+import { getGitCommonDir } from '../core/worktree.js';
+/**
+ * Error thrown when client operations fail
+ */
+export class ClientError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'ClientError';
+    }
+}
+// ============================================================================
+// Socket Path Discovery
+// ============================================================================
+/**
+ * Find the multi-location daemon socket at .git/opentasks/daemon.sock
+ */
+function findGitDaemonSocket(startDir = process.cwd()) {
+    const gitCommonDir = getGitCommonDir(startDir);
+    if (!gitCommonDir)
+        return null;
+    const socketPath = path.join(gitCommonDir, 'opentasks', 'daemon.sock');
+    if (fs.existsSync(socketPath)) {
+        return socketPath;
+    }
+    return null;
+}
+/**
+ * Find the .opentasks directory starting from cwd and walking up
+ */
+function findOpenTasksDir(startDir = process.cwd()) {
+    let currentDir = startDir;
+    while (true) {
+        const candidate = path.join(currentDir, '.opentasks');
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+            return candidate;
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            // Reached root
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
+/**
+ * Get the default socket path.
+ * Prefers .git/opentasks/daemon.sock (multi-location) then falls back
+ * to walking up for .opentasks/daemon.sock (single-location).
+ */
+function getDefaultSocketPath() {
+    // 1. Check for multi-location daemon socket first
+    const gitSocket = findGitDaemonSocket();
+    if (gitSocket) {
+        return gitSocket;
+    }
+    // 2. Fallback to single-location .opentasks/daemon.sock
+    const openTasksDir = findOpenTasksDir();
+    if (!openTasksDir) {
+        throw new ClientError('Could not find daemon socket. Is the daemon running?', 'SOCKET_NOT_FOUND');
+    }
+    return path.join(openTasksDir, 'daemon.sock');
+}
+// ============================================================================
+// Client Implementation
+// ============================================================================
+/**
+ * Client for interacting with the OpenTasks daemon
+ *
+ * Provides typed access to the 3-tool interface (link, query, annotate)
+ * plus convenience methods for common operations.
+ *
+ * @example
+ * ```typescript
+ * const client = new OpenTasksClient()
+ *
+ * // Find ready work
+ * const ready = await client.ready()
+ *
+ * // Create a relationship
+ * await client.link({
+ *   from_id: 'i-abc1',
+ *   to_id: 's-def2',
+ *   type: 'implements'
+ * })
+ *
+ * // Add feedback
+ * await client.annotate({
+ *   target_id: 's-def2',
+ *   create: { content: 'Implementation complete' }
+ * })
+ *
+ * client.disconnect()
+ * ```
+ */
+export class OpenTasksClient {
+    client = null;
+    options;
+    socketPath = null;
+    constructor(options) {
+        this.options = {
+            socketPath: options?.socketPath ?? '',
+            autoConnect: options?.autoConnect ?? true,
+            timeout: options?.timeout ?? 30000,
+        };
+        // If socket path provided, resolve it immediately
+        if (options?.socketPath) {
+            this.socketPath = options.socketPath;
+        }
+    }
+    // ==========================================================================
+    // Connection Lifecycle
+    // ==========================================================================
+    /**
+     * Connect to the daemon
+     */
+    async connect() {
+        if (this.client?.connected) {
+            return;
+        }
+        // Resolve socket path if not already done
+        if (!this.socketPath) {
+            this.socketPath = getDefaultSocketPath();
+        }
+        this.client = createIPCClient(this.socketPath);
+        try {
+            await this.client.connect();
+        }
+        catch (error) {
+            this.client = null;
+            throw new ClientError(`Failed to connect to daemon: ${error instanceof Error ? error.message : 'Unknown error'}`, 'CONNECTION_FAILED');
+        }
+    }
+    /**
+     * Disconnect from the daemon
+     */
+    disconnect() {
+        if (this.client) {
+            this.client.disconnect();
+            this.client = null;
+        }
+    }
+    /**
+     * Check if connected to the daemon
+     */
+    get connected() {
+        return this.client?.connected ?? false;
+    }
+    /**
+     * Ensure connection before making a request
+     */
+    async ensureConnected() {
+        if (this.connected) {
+            return;
+        }
+        if (this.options.autoConnect) {
+            await this.connect();
+            return;
+        }
+        throw new ClientError('Not connected to daemon. Call connect() first or enable autoConnect.', 'NOT_CONNECTED');
+    }
+    // ==========================================================================
+    // Core Tools
+    // ==========================================================================
+    /**
+     * Create or remove an edge between nodes
+     *
+     * @param params - Link parameters
+     * @returns Link result with success status
+     */
+    async link(params) {
+        await this.ensureConnected();
+        return this.client.request('tools.link', params);
+    }
+    /**
+     * Query the graph
+     *
+     * @param params - Query parameters
+     * @returns Query result with items and pagination info
+     */
+    async query(params) {
+        await this.ensureConnected();
+        return this.client.request('tools.query', params);
+    }
+    /**
+     * Manage feedback lifecycle
+     *
+     * @param params - Annotate parameters
+     * @returns Annotate result with success status
+     */
+    async annotate(params) {
+        await this.ensureConnected();
+        return this.client.request('tools.annotate', params);
+    }
+    /**
+     * Task lifecycle operations
+     *
+     * @param params - Task parameters (transition, ready, assign, or validActions)
+     * @returns Task result with operation-specific data
+     */
+    async task(params) {
+        await this.ensureConnected();
+        return this.client.request('tools.task', params);
+    }
+    // ==========================================================================
+    // Convenience Methods
+    // ==========================================================================
+    /**
+     * Get issues ready to work on (no active blockers)
+     *
+     * @param options - Ready query options
+     * @returns Array of ready issue summaries
+     */
+    async ready(options) {
+        const result = await this.query({ ready: options || {} });
+        return result.items;
+    }
+    /**
+     * Get nodes blocking a specific node
+     *
+     * @param nodeId - Node to find blockers for
+     * @param options - Blocker query options
+     * @returns Array of blocking node summaries
+     */
+    async blockers(nodeId, options) {
+        const result = await this.query({
+            blockers: { nodeId, ...options },
+        });
+        return result.items;
+    }
+    /**
+     * Get nodes blocked by a specific node
+     *
+     * @param nodeId - Node to find blocked nodes for
+     * @param options - Blocker query options
+     * @returns Array of blocked node summaries
+     */
+    async blocking(nodeId, options) {
+        const result = await this.query({
+            blocking: { nodeId, ...options },
+        });
+        return result.items;
+    }
+    /**
+     * Get feedback on a specific node
+     *
+     * @param nodeId - Node to get feedback for
+     * @param options - Feedback query options
+     * @returns Array of feedback summaries
+     */
+    async feedback(nodeId, options) {
+        const result = await this.query({
+            feedback: { nodeId, ...options },
+        });
+        return result.items;
+    }
+    /**
+     * Transition a task's status using a semantic action
+     *
+     * @param id - Task ID or provider URI
+     * @param action - Semantic action ('start', 'complete', 'block', 'reopen', 'close')
+     * @returns Task result with updated node
+     */
+    async taskTransition(id, action) {
+        return this.task({ transition: { id, action } });
+    }
+    /**
+     * Get tasks ready to work on across all task-capable providers
+     *
+     * @param options - Ready task query options
+     * @returns Task result with ready items
+     */
+    async taskReady(options) {
+        return this.task({ ready: options || {} });
+    }
+    /**
+     * Assign a task to an owner
+     *
+     * @param id - Task ID or provider URI
+     * @param assignee - Assignee identifier
+     * @returns Task result with updated node
+     */
+    async taskAssign(id, assignee) {
+        return this.task({ assign: { id, assignee } });
+    }
+    /**
+     * Get valid next actions for a task in its current state
+     *
+     * @param id - Task ID or provider URI
+     * @returns Task result with valid actions
+     */
+    async taskValidActions(id) {
+        return this.task({ validActions: { id } });
+    }
+    // ==========================================================================
+    // Graph CRUD (with unified provider dispatch)
+    // ==========================================================================
+    /**
+     * Create a node.
+     * When `scheme` is provided, routes creation to that provider.
+     * Otherwise uses the configured defaultProvider.
+     *
+     * @param params - Node creation parameters
+     * @param options - Optional provider routing options
+     * @returns The created node (materialized locally if via external provider)
+     */
+    async createNode(params, options) {
+        await this.ensureConnected();
+        return this.client.request('graph.create', { ...params, scheme: options?.scheme });
+    }
+    /**
+     * Get a node by local ID or provider URI.
+     * For external/materialized nodes, refreshes if stale.
+     *
+     * @param idOrUri - Local node ID (e.g., 'i-abc1') or provider URI (e.g., 'sudocode://proj/i-456')
+     */
+    async getNode(idOrUri) {
+        await this.ensureConnected();
+        return this.client.request('graph.get', { id: idOrUri });
+    }
+    /**
+     * Update a node by local ID or provider URI.
+     * For external/materialized nodes, routes update to the owning provider.
+     *
+     * @param idOrUri - Local node ID or provider URI
+     * @param updates - Fields to update
+     */
+    async updateNode(idOrUri, updates) {
+        await this.ensureConnected();
+        return this.client.request('graph.update', { id: idOrUri, ...updates });
+    }
+    /**
+     * Delete a node by local ID or provider URI.
+     * For external/materialized nodes, deletes in the owning provider
+     * and removes the local materialized copy.
+     *
+     * @param idOrUri - Local node ID or provider URI
+     * @param options - Delete options (hard vs soft)
+     */
+    async deleteNode(idOrUri, options) {
+        await this.ensureConnected();
+        await this.client.request('graph.delete', { id: idOrUri, options });
+    }
+    // ==========================================================================
+    // Provider Introspection
+    // ==========================================================================
+    /**
+     * List all registered providers and their capabilities
+     */
+    async listProviders() {
+        await this.ensureConnected();
+        return this.client.request('provider.list', {});
+    }
+    /**
+     * Get info about a specific provider
+     *
+     * @param name - Provider name
+     */
+    async getProvider(name) {
+        await this.ensureConnected();
+        return this.client.request('provider.info', { name });
+    }
+    // ==========================================================================
+    // Generic RPC
+    // ==========================================================================
+    /**
+     * Call any daemon method by name
+     */
+    async call(method, params) {
+        await this.ensureConnected();
+        return this.client.request(method, params);
+    }
+}
+/**
+ * Create a new OpenTasks client
+ *
+ * @param options - Client options
+ * @returns OpenTasks client instance
+ */
+export function createClient(options) {
+    return new OpenTasksClient(options);
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * OpenTasks Client Module
+ *
+ * Client library for interacting with the OpenTasks daemon.
+ *
+ * @packageDocumentation
+ */
+export type { ClientOptions } from './client.js';
+export { OpenTasksClient, ClientError, createClient } from './client.js';
+export type { LinkParams, LinkResult, QueryParams, QueryResult, AnnotateParams, AnnotateResult, NodeSummary, EdgeSummary, FeedbackSummary, BlockerQueryParams, FeedbackQueryParams, CreateFeedbackParams, FeedbackAnchor, FeedbackType, ReadyOptions, BlockerOptions, FeedbackOptions, } from '../tools/types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzE,YAAY,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,9 @@
+/**
+ * OpenTasks Client Module
+ *
+ * Client library for interacting with the OpenTasks daemon.
+ *
+ * @packageDocumentation
+ */
+export { OpenTasksClient, ClientError, createClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/__tests__/defaults.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defaults.test.d.ts.map

package/dist/config/__tests__/defaults.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.test.d.ts","sourceRoot":"","sources":["../../../src/config/__tests__/defaults.test.ts"],"names":[],"mappings":""}