octie-cli 1.0.0

package/dist/types/index.js

@@ -0,0 +1,182 @@
+/**
+ * Core type definitions for Octie task management system
+ *
+ * This module defines all TypeScript interfaces and types used throughout the system.
+ * @module types
+ */
+/**
+ * Error code to HTTP status code mapping
+ * Used by API error handler to return appropriate status codes
+ */
+export const ERROR_STATUS_MAP = {
+    // Client errors (4xx)
+    TASK_NOT_FOUND: 404,
+    PROJECT_NOT_FOUND: 404,
+    VALIDATION_ERROR: 400,
+    ATOMIC_TASK_VIOLATION: 400,
+    INVALID_ARGUMENT: 400,
+    INVALID_TASK_ID: 400,
+    CIRCULAR_DEPENDENCY: 400,
+    DUPLICATE_TASK: 409,
+    // Server errors (5xx)
+    FILE_OPERATION_ERROR: 500,
+    STORAGE_ERROR: 500,
+    INTERNAL_ERROR: 500,
+};
+/**
+ * Error code to suggestion mapping
+ * Provides actionable recovery steps for each error type
+ */
+export const ERROR_SUGGESTIONS = {
+    TASK_NOT_FOUND: 'Use `octie list` to see all available tasks and their IDs.',
+    PROJECT_NOT_FOUND: 'Run `octie init` to create a new project or use `--project <path>` to specify the project directory.',
+    VALIDATION_ERROR: 'Check the input format and ensure all required fields are provided.',
+    ATOMIC_TASK_VIOLATION: 'Split the task into smaller, focused tasks with specific deliverables.',
+    INVALID_ARGUMENT: 'Check the command syntax with `octie <command> --help`.',
+    INVALID_TASK_ID: 'Task IDs must be valid UUIDs. Use `octie list` to find the correct task ID.',
+    CIRCULAR_DEPENDENCY: 'Remove one of the edges in the cycle using `octie update <id> --unblock <blocker_id>`.',
+    DUPLICATE_TASK: 'Use `octie list --search <query>` to find existing similar tasks.',
+    FILE_OPERATION_ERROR: 'Check file permissions and ensure the .octie directory is writable.',
+    STORAGE_ERROR: 'Try restoring from backup with `octie import --file .octie/project.json.bak`.',
+    INTERNAL_ERROR: 'Run with --verbose flag for more details or check the logs.',
+};
+/**
+ * Custom error base class
+ * All Octie-specific errors extend this class
+ */
+export class OctieError extends Error {
+    code;
+    /** Optional suggestion for how to resolve the error */
+    suggestion;
+    /** HTTP status code for API responses */
+    statusCode;
+    constructor(message, code, suggestion) {
+        super(message);
+        this.code = code;
+        this.name = 'OctieError';
+        this.suggestion = suggestion ?? ERROR_SUGGESTIONS[code];
+        this.statusCode = ERROR_STATUS_MAP[code] ?? 500;
+    }
+}
+/**
+ * Error thrown when a task is not found
+ */
+export class TaskNotFoundError extends OctieError {
+    constructor(taskId) {
+        super(`Task with ID '${taskId}' not found`, 'TASK_NOT_FOUND', `Use \`octie list\` to see all available tasks. The ID '${taskId}' may be incorrect or the task may have been deleted.`);
+        this.name = 'TaskNotFoundError';
+    }
+}
+/**
+ * Error thrown when a short UUID prefix matches multiple tasks
+ */
+export class AmbiguousIdError extends OctieError {
+    constructor(prefix, matchingIds) {
+        super(`ID prefix '${prefix}' matches multiple tasks: ${matchingIds.map(id => id.substring(0, 7)).join(', ')}. Please provide more characters.`, 'AMBIGUOUS_ID', `The ID prefix '${prefix}' is too short and matches ${matchingIds.length} tasks. Provide more characters (up to the full UUID) to uniquely identify a task.`);
+        this.name = 'AmbiguousIdError';
+    }
+}
+/**
+ * Error thrown when a project is not found
+ */
+export class ProjectNotFoundError extends OctieError {
+    constructor(path) {
+        super(path ? `No Octie project found at '${path}'` : 'No Octie project found', 'PROJECT_NOT_FOUND', 'Run `octie init` to create a new project in the current directory, or use `--project <path>` to specify a different project directory.');
+        this.name = 'ProjectNotFoundError';
+    }
+}
+/**
+ * Error thrown when a circular dependency is detected
+ */
+export class CircularDependencyError extends OctieError {
+    cycleNodes;
+    constructor(cycleNodes) {
+        super(`Circular dependency detected: ${cycleNodes.join(' -> ')}`, 'CIRCULAR_DEPENDENCY', `Break the cycle by removing one of the dependencies. Use \`octie update ${cycleNodes[0]} --unblock ${cycleNodes[cycleNodes.length - 1]}\` or restructure your task graph.`);
+        this.cycleNodes = cycleNodes;
+        this.name = 'CircularDependencyError';
+    }
+}
+/**
+ * Error thrown when file operations fail
+ */
+export class FileOperationError extends OctieError {
+    filePath;
+    constructor(message, filePath) {
+        super(`${message}: ${filePath}`, 'FILE_OPERATION_ERROR', `Check file permissions and ensure the path is correct. If the file is corrupted, try restoring from backup: \`octie import --file .octie/project.json.bak\``);
+        this.filePath = filePath;
+        this.name = 'FileOperationError';
+    }
+}
+/**
+ * Error thrown when validation fails
+ */
+export class ValidationError extends OctieError {
+    field;
+    constructor(message, field) {
+        super(message, 'VALIDATION_ERROR', field ? `Check the '${field}' field and ensure it meets the requirements.` : 'Check the input format and ensure all required fields are provided.');
+        this.field = field;
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Error thrown when atomic task validation fails
+ */
+export class AtomicTaskViolationError extends ValidationError {
+    violations;
+    constructor(message, violations) {
+        super(message, 'ATOMIC_TASK_VIOLATION');
+        this.violations = violations;
+        this.name = 'AtomicTaskViolationError';
+        // Override suggestion with specific violations
+        this.suggestion = `Task violates atomic task requirements:\n${violations.map(v => `  • ${v}`).join('\n')}\n\nSplit into smaller tasks or make the task more specific.`;
+    }
+}
+/**
+ * Error thrown when an invalid argument is provided
+ */
+export class InvalidArgumentError extends OctieError {
+    constructor(message, suggestion) {
+        super(message, 'INVALID_ARGUMENT', suggestion ?? 'Check the command syntax with `octie <command> --help`.');
+        this.name = 'InvalidArgumentError';
+    }
+}
+/**
+ * Error thrown when a duplicate is detected
+ */
+export class DuplicateTaskError extends OctieError {
+    constructor(identifier) {
+        super(`Task already exists: ${identifier}`, 'DUPLICATE_TASK', 'Use `octie list --search <query>` to find the existing task, or use a different identifier.');
+        this.name = 'DuplicateTaskError';
+    }
+}
+/**
+ * Error thrown when storage operations fail
+ */
+export class StorageError extends OctieError {
+    constructor(message, suggestion) {
+        super(message, 'STORAGE_ERROR', suggestion ?? 'Try restoring from backup or re-initialize the project.');
+        this.name = 'StorageError';
+    }
+}
+/**
+ * Immutability violation error
+ * Thrown when attempting to modify completed items that are immutable
+ *
+ * Per the status refactor spec:
+ * - success_criteria items: Cannot be unchecked or deleted once completed
+ * - deliverables items: Cannot be unchecked or deleted once completed
+ * - need_fix items: Cannot be deleted or unmarked once completed
+ */
+export class ImmutabilityViolationError extends ValidationError {
+    /** ID of the item that cannot be modified */
+    itemId;
+    /** Type of the item (success_criterion, deliverable, need_fix) */
+    itemType;
+    constructor(message, itemId, itemType) {
+        super(message, itemType);
+        this.name = 'ImmutabilityViolationError';
+        this.itemId = itemId;
+        this.itemType = itemType;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/web/routes/graph.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Graph Routes - Graph analysis and validation endpoints
+ *
+ * Provides endpoints for graph structure analysis, topological sorting,
+ * cycle detection, critical path analysis, and project statistics.
+ *
+ * @module web/routes/graph
+ */
+import type { Router } from 'express';
+import type { TaskGraphStore } from '../../core/graph/index.js';
+/**
+ * Register graph routes
+ * @param router - Express Router instance
+ * @param getGraph - Function to get the current graph instance
+ */
+export declare function registerGraphRoutes(router: Router, getGraph: () => TaskGraphStore | null): void;
+//# sourceMappingURL=graph.d.ts.map

package/dist/web/routes/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/web/routes/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAmDhE;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,cAAc,GAAG,IAAI,GACpC,IAAI,CAoQN"}

package/dist/web/routes/graph.js

@@ -0,0 +1,277 @@
+/**
+ * Graph Routes - Graph analysis and validation endpoints
+ *
+ * Provides endpoints for graph structure analysis, topological sorting,
+ * cycle detection, critical path analysis, and project statistics.
+ *
+ * @module web/routes/graph
+ */
+import { topologicalSort, findCriticalPath, isValidDAG } from '../../core/graph/sort.js';
+import { detectCycle, hasCycle, getCycleStatistics } from '../../core/graph/cycle.js';
+import { TaskStorage } from '../../core/storage/file-store.js';
+import { ERROR_SUGGESTIONS } from '../../types/index.js';
+/**
+ * Async error handler wrapper
+ * Catches async errors and passes them to Express error handling
+ */
+function asyncHandler(fn) {
+    return (req, res, next) => {
+        Promise.resolve(fn(req, res)).catch(next);
+    };
+}
+/**
+ * Send successful API response
+ */
+function sendSuccess(res, data, status = 200) {
+    res.status(status).json({
+        success: true,
+        data,
+        timestamp: new Date().toISOString(),
+    });
+}
+/**
+ * Send error API response
+ */
+function sendError(res, code, message, status = 400, details, suggestion) {
+    res.status(status).json({
+        success: false,
+        error: {
+            code,
+            message,
+            suggestion: suggestion ?? ERROR_SUGGESTIONS[code],
+            details,
+        },
+        timestamp: new Date().toISOString(),
+    });
+}
+/**
+ * Register graph routes
+ * @param router - Express Router instance
+ * @param getGraph - Function to get the current graph instance
+ */
+export function registerGraphRoutes(router, getGraph) {
+    // Cache for loaded project graphs
+    const graphCache = new Map();
+    /**
+     * Get graph for a specific project path, using cache when possible
+     */
+    async function getProjectGraph(projectPath) {
+        if (!projectPath) {
+            return getGraph();
+        }
+        // Check cache first
+        const cached = graphCache.get(projectPath);
+        if (cached) {
+            return cached;
+        }
+        // Load the project
+        try {
+            const storage = new TaskStorage({ projectDir: projectPath });
+            const graph = await storage.load();
+            graphCache.set(projectPath, graph);
+            return graph;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Extract project path from query params
+     */
+    function getProjectPath(req) {
+        const project = req.query.project;
+        return typeof project === 'string' ? project : undefined;
+    }
+    /**
+     * GET /api/graph
+     * Get full graph structure including all tasks and edges
+     */
+    router.get('/api/graph', asyncHandler(async (req, res) => {
+        const projectPath = getProjectPath(req);
+        const graph = await getProjectGraph(projectPath);
+        if (!graph) {
+            return sendError(res, 'GRAPH_NOT_LOADED', projectPath ? `Project not found: ${projectPath}` : 'Graph not loaded', 500);
+        }
+        // Serialize graph to JSON format
+        const graphData = graph.toJSON();
+        // Convert nodes from object (keyed by ID) to array for frontend
+        const nodesArray = Object.values(graphData.nodes);
+        // Get valid node IDs
+        const validNodeIds = new Set(nodesArray.map(n => n.id));
+        // Filter edges to only include valid node references
+        const filterEdges = (edges) => {
+            const filtered = {};
+            for (const [sourceId, targetIds] of Object.entries(edges)) {
+                // Skip if source is invalid
+                if (!sourceId || sourceId === 'null' || sourceId === 'undefined' || !validNodeIds.has(sourceId)) {
+                    continue;
+                }
+                // Filter targets to only valid nodes
+                const validTargets = (targetIds || []).filter(targetId => targetId && targetId !== 'null' && targetId !== 'undefined' && validNodeIds.has(targetId));
+                if (validTargets.length > 0) {
+                    filtered[sourceId] = validTargets;
+                }
+            }
+            return filtered;
+        };
+        return sendSuccess(res, {
+            metadata: graphData.metadata,
+            nodes: nodesArray,
+            outgoingEdges: filterEdges(graphData.outgoingEdges),
+            incomingEdges: filterEdges(graphData.incomingEdges),
+        });
+    }));
+    /**
+     * GET /api/graph/topology
+     * Get topological order of tasks
+     */
+    router.get('/api/graph/topology', asyncHandler(async (req, res) => {
+        const projectPath = getProjectPath(req);
+        const graph = await getProjectGraph(projectPath);
+        if (!graph) {
+            return sendError(res, 'GRAPH_NOT_LOADED', projectPath ? `Project not found: ${projectPath}` : 'Graph not loaded', 500);
+        }
+        const result = topologicalSort(graph);
+        if (result.hasCycle) {
+            return sendSuccess(res, {
+                hasCycle: true,
+                cycleNodes: result.cycleNodes,
+                message: 'Graph contains cycles, topological sort is not valid for cyclic graphs',
+            });
+        }
+        return sendSuccess(res, {
+            hasCycle: false,
+            sorted: result.sorted,
+            taskCount: result.sorted.length,
+        });
+    }));
+    /**
+     * POST /api/graph/validate
+     * Validate graph structure and check for cycles
+     */
+    router.post('/api/graph/validate', asyncHandler(async (req, res) => {
+        const projectPath = getProjectPath(req);
+        const graph = await getProjectGraph(projectPath);
+        if (!graph) {
+            return sendError(res, 'GRAPH_NOT_LOADED', projectPath ? `Project not found: ${projectPath}` : 'Graph not loaded', 500);
+        }
+        // Check if graph is valid (acyclic)
+        const isValid = isValidDAG(graph);
+        // Get cycle statistics if graph has cycles
+        let cycleStats = null;
+        if (!isValid) {
+            cycleStats = getCycleStatistics(graph);
+        }
+        return sendSuccess(res, {
+            isValid,
+            hasCycle: !isValid,
+            cycleStats,
+            message: isValid
+                ? 'Graph structure is valid (acyclic)'
+                : 'Graph contains cycles and is not a valid DAG',
+        });
+    }));
+    /**
+     * GET /api/graph/cycles
+     * Detect and return all cycles in the graph
+     */
+    router.get('/api/graph/cycles', asyncHandler(async (req, res) => {
+        const projectPath = getProjectPath(req);
+        const graph = await getProjectGraph(projectPath);
+        if (!graph) {
+            return sendError(res, 'GRAPH_NOT_LOADED', projectPath ? `Project not found: ${projectPath}` : 'Graph not loaded', 500);
+        }
+        const result = detectCycle(graph);
+        if (!result.hasCycle) {
+            return sendSuccess(res, {
+                hasCycle: false,
+                cycles: [],
+                message: 'No cycles detected in graph',
+            });
+        }
+        return sendSuccess(res, {
+            hasCycle: true,
+            cycles: result.cycles,
+            cycleCount: result.cycles.length,
+            message: `Found ${result.cycles.length} cycle(s) in graph`,
+        });
+    }));
+    /**
+     * GET /api/graph/critical-path
+     * Get the critical path (longest path) through the graph
+     */
+    router.get('/api/graph/critical-path', asyncHandler(async (req, res) => {
+        const projectPath = getProjectPath(req);
+        const graph = await getProjectGraph(projectPath);
+        if (!graph) {
+            return sendError(res, 'GRAPH_NOT_LOADED', projectPath ? `Project not found: ${projectPath}` : 'Graph not loaded', 500);
+        }
+        // First check if graph has cycles
+        if (hasCycle(graph)) {
+            return sendError(res, 'GRAPH_HAS_CYCLE', 'Cannot calculate critical path for cyclic graph', 400);
+        }
+        const result = findCriticalPath(graph);
+        return sendSuccess(res, {
+            path: result.path,
+            duration: result.duration,
+            taskCount: result.path.length,
+        });
+    }));
+    /**
+     * GET /api/stats
+     * Get project statistics
+     */
+    router.get('/api/stats', asyncHandler(async (req, res) => {
+        const projectPath = getProjectPath(req);
+        const graph = await getProjectGraph(projectPath);
+        if (!graph) {
+            return sendError(res, 'GRAPH_NOT_LOADED', projectPath ? `Project not found: ${projectPath}` : 'Graph not loaded', 500);
+        }
+        // Get basic graph stats
+        const totalTasks = graph.size;
+        const rootTasks = graph.getRootTasks();
+        const orphanTasks = graph.getOrphanTasks();
+        // Calculate status and priority counts by iterating through tasks
+        const statusCounts = new Map();
+        statusCounts.set('ready', 0);
+        statusCounts.set('in_progress', 0);
+        statusCounts.set('in_review', 0);
+        statusCounts.set('completed', 0);
+        statusCounts.set('blocked', 0);
+        const priorityCounts = new Map();
+        priorityCounts.set('top', 0);
+        priorityCounts.set('second', 0);
+        priorityCounts.set('later', 0);
+        for (const task of graph.getAllTasks()) {
+            const currentStatus = statusCounts.get(task.status) ?? 0;
+            statusCounts.set(task.status, currentStatus + 1);
+            const currentPriority = priorityCounts.get(task.priority) ?? 0;
+            priorityCounts.set(task.priority, currentPriority + 1);
+        }
+        // Convert Maps to plain objects for JSON response
+        const statusCountsObj = {};
+        statusCounts.forEach((value, key) => { statusCountsObj[key] = value; });
+        const priorityCountsObj = {};
+        priorityCounts.forEach((value, key) => { priorityCountsObj[key] = value; });
+        // Build response
+        const stats = {
+            project: {
+                name: graph.metadata.project_name,
+                version: graph.metadata.version,
+                created: graph.metadata.created_at,
+                updated: graph.metadata.updated_at,
+            },
+            tasks: {
+                total: totalTasks,
+                root: rootTasks.length,
+                orphan: orphanTasks.length,
+                rootTaskIds: rootTasks,
+                orphanTaskIds: orphanTasks,
+                statusCounts: statusCountsObj,
+                priorityCounts: priorityCountsObj,
+            },
+        };
+        return sendSuccess(res, stats);
+    }));
+}
+//# sourceMappingURL=graph.js.map

package/dist/web/routes/graph.js.map

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

package/dist/web/routes/projects.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Projects Routes - Global project registry endpoints
+ *
+ * Provides endpoints for listing and managing registered Octie projects.
+ *
+ * @module web/routes/projects
+ */
+import type { Router } from 'express';
+/**
+ * Register project routes
+ * @param router - Express Router instance
+ */
+export declare function registerProjectsRoutes(router: Router): void;
+//# sourceMappingURL=projects.d.ts.map

package/dist/web/routes/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../src/web/routes/projects.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAC;AA6DzD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAgE3D"}

package/dist/web/routes/projects.js

@@ -0,0 +1,102 @@
+/**
+ * Projects Routes - Global project registry endpoints
+ *
+ * Provides endpoints for listing and managing registered Octie projects.
+ *
+ * @module web/routes/projects
+ */
+import { getAllProjects, verifyProjectExists, loadRegistry, saveRegistry, } from '../../core/registry/index.js';
+import { ERROR_SUGGESTIONS } from '../../types/index.js';
+/**
+ * Async error handler wrapper
+ */
+function asyncHandler(fn) {
+    return (req, res, next) => {
+        Promise.resolve(fn(req, res)).catch(next);
+    };
+}
+/**
+ * Send successful API response
+ */
+function sendSuccess(res, data, status = 200) {
+    res.status(status).json({
+        success: true,
+        data,
+        timestamp: new Date().toISOString(),
+    });
+}
+/**
+ * Send error API response
+ */
+function sendError(res, code, message, status = 400, details, suggestion) {
+    res.status(status).json({
+        success: false,
+        error: {
+            code,
+            message,
+            suggestion: suggestion ?? ERROR_SUGGESTIONS[code],
+            details,
+        },
+        timestamp: new Date().toISOString(),
+    });
+}
+/**
+ * Register project routes
+ * @param router - Express Router instance
+ */
+export function registerProjectsRoutes(router) {
+    /**
+     * GET /api/projects
+     * List all registered projects with existence status
+     */
+    router.get('/api/projects', asyncHandler(async (_req, res) => {
+        const projects = getAllProjects();
+        // Add existence status to each project
+        const projectsWithStatus = projects.map(project => ({
+            ...project,
+            exists: verifyProjectExists(project),
+        }));
+        return sendSuccess(res, {
+            projects: projectsWithStatus,
+            count: projectsWithStatus.length,
+        });
+    }));
+    /**
+     * DELETE /api/projects/:path
+     * Remove a project from the registry (by encoded path)
+     */
+    router.delete('/api/projects/*', asyncHandler(async (req, res) => {
+        // Decode the path from URL
+        const encodedPath = req.params[0] ?? '';
+        const projectPath = decodeURIComponent(encodedPath);
+        const registry = loadRegistry();
+        let found = false;
+        for (const [key, project] of Object.entries(registry.projects)) {
+            if (project.path === projectPath) {
+                delete registry.projects[key];
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            return sendError(res, 'PROJECT_NOT_FOUND', 'Project not found in registry', 404);
+        }
+        saveRegistry(registry);
+        return sendSuccess(res, {
+            removed: true,
+            path: projectPath,
+        });
+    }));
+    /**
+     * GET /api/registry/path
+     * Get the global registry file path
+     */
+    router.get('/api/registry/path', asyncHandler(async (_req, res) => {
+        const { getGlobalRegistryPath } = await import('../../core/registry/index.js');
+        const registryPath = getGlobalRegistryPath();
+        return sendSuccess(res, {
+            path: registryPath,
+        });
+    }));
+}
+//# sourceMappingURL=projects.js.map

package/dist/web/routes/projects.js.map

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

package/dist/web/routes/tasks.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Task Routes - RESTful CRUD endpoints for task management
+ *
+ * Provides complete CRUD operations for tasks via REST API.
+ * All endpoints use Zod validation and proper HTTP status codes.
+ *
+ * @module web/routes/tasks
+ */
+import type { Router } from 'express';
+import type { TaskGraphStore } from '../../core/graph/index.js';
+/**
+ * Register task routes
+ * @param router - Express Router instance
+ * @param getGraph - Function to get the current graph instance
+ */
+export declare function registerTaskRoutes(router: Router, getGraph: () => TaskGraphStore | null): void;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/web/routes/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/web/routes/tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAwIhE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,cAAc,GAAG,IAAI,GACpC,IAAI,CAwcN"}