digital-tasks 2.0.1

package/dist/project.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Project Management - Task workflows, dependencies, and execution modes
+ *
+ * Provides project management primitives for organizing tasks:
+ * - Projects/TaskLists as containers
+ * - Parallel vs Sequential execution
+ * - Dependencies and dependants (bidirectional)
+ * - Subtasks with inheritance
+ *
+ * ## Execution Modes
+ *
+ * Tasks can be organized for parallel or sequential execution:
+ *
+ * ```ts
+ * // Parallel - all can run simultaneously
+ * parallel(
+ *   task('Design UI'),
+ *   task('Write API specs'),
+ *   task('Set up infrastructure'),
+ * )
+ *
+ * // Sequential - must run in order
+ * sequential(
+ *   task('Implement backend'),
+ *   task('Implement frontend'),
+ *   task('Integration testing'),
+ * )
+ * ```
+ *
+ * ## Markdown Syntax
+ *
+ * Tasks map to markdown checklists:
+ * - `- [ ]` = Parallel/unordered tasks
+ * - `1. [ ]` = Sequential/ordered tasks
+ *
+ * @packageDocumentation
+ */
+import type { AnyTask, TaskPriority, WorkerRef } from './types.js';
+/**
+ * How tasks should be executed relative to each other
+ */
+export type ExecutionMode = 'parallel' | 'sequential';
+/**
+ * Task node in a workflow - can be a single task or a group
+ */
+export type TaskNode = TaskDefinition | ParallelGroup | SequentialGroup;
+/**
+ * Function type for the DSL
+ */
+export type FunctionType = 'code' | 'generative' | 'agentic' | 'human';
+/**
+ * A single task definition
+ */
+export interface TaskDefinition {
+    __type: 'task';
+    title: string;
+    description?: string;
+    functionType?: FunctionType;
+    priority?: TaskPriority;
+    assignTo?: WorkerRef;
+    tags?: string[];
+    subtasks?: TaskNode[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A group of tasks that can run in parallel
+ */
+export interface ParallelGroup {
+    __type: 'parallel';
+    tasks: TaskNode[];
+}
+/**
+ * A group of tasks that must run sequentially
+ */
+export interface SequentialGroup {
+    __type: 'sequential';
+    tasks: TaskNode[];
+}
+/**
+ * Project status
+ */
+export type ProjectStatus = 'draft' | 'active' | 'paused' | 'completed' | 'cancelled';
+/**
+ * Project definition
+ */
+export interface Project {
+    /** Unique project ID */
+    id: string;
+    /** Project name */
+    name: string;
+    /** Project description */
+    description?: string;
+    /** Project status */
+    status: ProjectStatus;
+    /** Root task nodes */
+    tasks: TaskNode[];
+    /** Default execution mode for top-level tasks */
+    defaultMode?: ExecutionMode;
+    /** Project owner */
+    owner?: WorkerRef;
+    /** Project tags */
+    tags?: string[];
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt: Date;
+    /** Project metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for creating a project
+ */
+export interface CreateProjectOptions {
+    name: string;
+    description?: string;
+    tasks?: TaskNode[];
+    defaultMode?: ExecutionMode;
+    owner?: WorkerRef;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Create a task definition
+ *
+ * @example
+ * ```ts
+ * task('Implement feature')
+ * task('Review PR', { priority: 'high', assignTo: { type: 'human', id: 'user_123' } })
+ * task('Parent task', {
+ *   subtasks: [
+ *     task('Subtask 1'),
+ *     task('Subtask 2'),
+ *   ]
+ * })
+ * ```
+ */
+export declare function task(title: string, options?: Partial<Omit<TaskDefinition, '__type' | 'title'>>): TaskDefinition;
+/**
+ * Create a group of tasks that can run in parallel
+ *
+ * @example
+ * ```ts
+ * parallel(
+ *   task('Design UI'),
+ *   task('Write API specs'),
+ *   task('Set up infrastructure'),
+ * )
+ * ```
+ */
+export declare function parallel(...tasks: TaskNode[]): ParallelGroup;
+/**
+ * Create a group of tasks that must run sequentially
+ *
+ * @example
+ * ```ts
+ * sequential(
+ *   task('Implement backend'),
+ *   task('Implement frontend'),
+ *   task('Integration testing'),
+ * )
+ * ```
+ */
+export declare function sequential(...tasks: TaskNode[]): SequentialGroup;
+/**
+ * Create a new project
+ *
+ * @example
+ * ```ts
+ * const project = createProject({
+ *   name: 'Launch New Feature',
+ *   description: 'Ship the new dashboard feature',
+ *   tasks: [
+ *     parallel(
+ *       task('Design mockups'),
+ *       task('Write technical spec'),
+ *     ),
+ *     sequential(
+ *       task('Implement backend API'),
+ *       task('Implement frontend UI'),
+ *       task('Write tests'),
+ *       task('Deploy to staging'),
+ *     ),
+ *     task('QA testing'),
+ *     task('Deploy to production'),
+ *   ],
+ * })
+ * ```
+ */
+export declare function createProject(options: CreateProjectOptions): Project;
+/**
+ * Workflow builder for fluent task definition
+ *
+ * @example
+ * ```ts
+ * const workflow = workflow('Feature Launch')
+ *   .parallel(
+ *     task('Design'),
+ *     task('Spec'),
+ *   )
+ *   .then(task('Implement'))
+ *   .then(task('Test'))
+ *   .parallel(
+ *     task('Deploy staging'),
+ *     task('Update docs'),
+ *   )
+ *   .then(task('Deploy production'))
+ *   .build()
+ * ```
+ */
+export declare function workflow(name: string, description?: string): {
+    /**
+     * Add tasks that can run in parallel
+     */
+    parallel(...nodes: TaskNode[]): /*elided*/ any;
+    /**
+     * Add tasks that must run sequentially
+     */
+    sequential(...nodes: TaskNode[]): /*elided*/ any;
+    /**
+     * Add a single task (sequential with previous)
+     */
+    then(...nodes: TaskNode[]): /*elided*/ any;
+    /**
+     * Add a task (alias for then)
+     */
+    task(title: string, options?: Partial<Omit<TaskDefinition, "__type" | "title">>): /*elided*/ any;
+    /**
+     * Build the project
+     */
+    build(options?: Partial<Omit<CreateProjectOptions, "name" | "tasks">>): Project;
+};
+/**
+ * Flatten task nodes into actual Task objects with dependencies
+ */
+export declare function materializeProject(project: Project): Promise<{
+    project: Project;
+    tasks: AnyTask[];
+}>;
+/**
+ * Get all tasks that depend on a given task (dependants)
+ */
+export declare function getDependants(taskId: string, allTasks: AnyTask[]): AnyTask[];
+/**
+ * Get all tasks that a given task depends on (dependencies)
+ */
+export declare function getDependencies(task: AnyTask, allTasks: AnyTask[]): AnyTask[];
+/**
+ * Get tasks that are ready to execute (no unsatisfied dependencies)
+ */
+export declare function getReadyTasks(allTasks: AnyTask[]): AnyTask[];
+/**
+ * Check if a task graph has cycles
+ */
+export declare function hasCycles(allTasks: AnyTask[]): boolean;
+/**
+ * Sort tasks by their dependencies (tasks with no dependencies first)
+ */
+export declare function sortTasks(allTasks: AnyTask[]): AnyTask[];
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAEV,OAAO,EAEP,YAAY,EACZ,SAAS,EAGV,MAAM,YAAY,CAAA;AAOnB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,YAAY,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,cAAc,GACd,aAAa,GACb,eAAe,CAAA;AAEnB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;AAEtE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAMD;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,WAAW,CAAA;AAEf;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAA;IACrB,sBAAsB;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,iDAAiD;IACjD,WAAW,CAAC,EAAE,aAAa,CAAA;IAC3B,oBAAoB;IACpB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAA;IACf,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAA;IACf,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IAClB,WAAW,CAAC,EAAE,aAAa,CAAA;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,GAC1D,cAAc,CAMhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,aAAa,CAK5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,eAAe,CAKhE;AAaD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAepE;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAIvD;;OAEG;uBACgB,QAAQ,EAAE;IAK7B;;OAEG;yBACkB,QAAQ,EAAE;IAK/B;;OAEG;mBACY,QAAQ,EAAE;IASzB;;OAEG;gBACS,MAAM,YAAY,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC;IAK/E;;OAEG;oBACa,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,OAAO;EAWlF;AAMD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CA8FjD;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAI5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAQ7E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAU5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAgCtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CA0BxD"}

package/dist/project.js

@@ -0,0 +1,397 @@
+/**
+ * Project Management - Task workflows, dependencies, and execution modes
+ *
+ * Provides project management primitives for organizing tasks:
+ * - Projects/TaskLists as containers
+ * - Parallel vs Sequential execution
+ * - Dependencies and dependants (bidirectional)
+ * - Subtasks with inheritance
+ *
+ * ## Execution Modes
+ *
+ * Tasks can be organized for parallel or sequential execution:
+ *
+ * ```ts
+ * // Parallel - all can run simultaneously
+ * parallel(
+ *   task('Design UI'),
+ *   task('Write API specs'),
+ *   task('Set up infrastructure'),
+ * )
+ *
+ * // Sequential - must run in order
+ * sequential(
+ *   task('Implement backend'),
+ *   task('Implement frontend'),
+ *   task('Integration testing'),
+ * )
+ * ```
+ *
+ * ## Markdown Syntax
+ *
+ * Tasks map to markdown checklists:
+ * - `- [ ]` = Parallel/unordered tasks
+ * - `1. [ ]` = Sequential/ordered tasks
+ *
+ * @packageDocumentation
+ */
+import { createTask as createBaseTask } from './task.js';
+// ============================================================================
+// Task DSL Functions
+// ============================================================================
+/**
+ * Create a task definition
+ *
+ * @example
+ * ```ts
+ * task('Implement feature')
+ * task('Review PR', { priority: 'high', assignTo: { type: 'human', id: 'user_123' } })
+ * task('Parent task', {
+ *   subtasks: [
+ *     task('Subtask 1'),
+ *     task('Subtask 2'),
+ *   ]
+ * })
+ * ```
+ */
+export function task(title, options) {
+    return {
+        __type: 'task',
+        title,
+        ...options,
+    };
+}
+/**
+ * Create a group of tasks that can run in parallel
+ *
+ * @example
+ * ```ts
+ * parallel(
+ *   task('Design UI'),
+ *   task('Write API specs'),
+ *   task('Set up infrastructure'),
+ * )
+ * ```
+ */
+export function parallel(...tasks) {
+    return {
+        __type: 'parallel',
+        tasks,
+    };
+}
+/**
+ * Create a group of tasks that must run sequentially
+ *
+ * @example
+ * ```ts
+ * sequential(
+ *   task('Implement backend'),
+ *   task('Implement frontend'),
+ *   task('Integration testing'),
+ * )
+ * ```
+ */
+export function sequential(...tasks) {
+    return {
+        __type: 'sequential',
+        tasks,
+    };
+}
+// ============================================================================
+// Project DSL Functions
+// ============================================================================
+/**
+ * Generate a unique project ID
+ */
+function generateProjectId() {
+    return `proj_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+}
+/**
+ * Create a new project
+ *
+ * @example
+ * ```ts
+ * const project = createProject({
+ *   name: 'Launch New Feature',
+ *   description: 'Ship the new dashboard feature',
+ *   tasks: [
+ *     parallel(
+ *       task('Design mockups'),
+ *       task('Write technical spec'),
+ *     ),
+ *     sequential(
+ *       task('Implement backend API'),
+ *       task('Implement frontend UI'),
+ *       task('Write tests'),
+ *       task('Deploy to staging'),
+ *     ),
+ *     task('QA testing'),
+ *     task('Deploy to production'),
+ *   ],
+ * })
+ * ```
+ */
+export function createProject(options) {
+    const now = new Date();
+    return {
+        id: generateProjectId(),
+        name: options.name,
+        description: options.description,
+        status: 'draft',
+        tasks: options.tasks || [],
+        defaultMode: options.defaultMode || 'sequential',
+        owner: options.owner,
+        tags: options.tags,
+        createdAt: now,
+        updatedAt: now,
+        metadata: options.metadata,
+    };
+}
+// ============================================================================
+// Workflow Builder (Fluent API)
+// ============================================================================
+/**
+ * Workflow builder for fluent task definition
+ *
+ * @example
+ * ```ts
+ * const workflow = workflow('Feature Launch')
+ *   .parallel(
+ *     task('Design'),
+ *     task('Spec'),
+ *   )
+ *   .then(task('Implement'))
+ *   .then(task('Test'))
+ *   .parallel(
+ *     task('Deploy staging'),
+ *     task('Update docs'),
+ *   )
+ *   .then(task('Deploy production'))
+ *   .build()
+ * ```
+ */
+export function workflow(name, description) {
+    const tasks = [];
+    const builder = {
+        /**
+         * Add tasks that can run in parallel
+         */
+        parallel(...nodes) {
+            tasks.push(parallel(...nodes));
+            return builder;
+        },
+        /**
+         * Add tasks that must run sequentially
+         */
+        sequential(...nodes) {
+            tasks.push(sequential(...nodes));
+            return builder;
+        },
+        /**
+         * Add a single task (sequential with previous)
+         */
+        then(...nodes) {
+            if (nodes.length === 1) {
+                tasks.push(nodes[0]);
+            }
+            else {
+                tasks.push(sequential(...nodes));
+            }
+            return builder;
+        },
+        /**
+         * Add a task (alias for then)
+         */
+        task(title, options) {
+            tasks.push(task(title, options));
+            return builder;
+        },
+        /**
+         * Build the project
+         */
+        build(options) {
+            return createProject({
+                name,
+                description,
+                tasks,
+                ...options,
+            });
+        },
+    };
+    return builder;
+}
+// ============================================================================
+// Task Materialization
+// ============================================================================
+/**
+ * Flatten task nodes into actual Task objects with dependencies
+ */
+export async function materializeProject(project) {
+    const tasks = [];
+    let taskIndex = 0;
+    async function processNode(node, parentId, previousIds = [], mode = 'sequential') {
+        if (node.__type === 'task') {
+            const taskDef = node;
+            const taskId = `${project.id}_task_${taskIndex++}`;
+            // Create dependencies based on mode (as string array for CreateTaskOptions)
+            const dependencies = mode === 'sequential' && previousIds.length > 0
+                ? previousIds
+                : undefined;
+            // Create a FunctionDefinition from the task definition
+            // Default to generative function type for DSL tasks
+            const functionDef = {
+                type: taskDef.functionType || 'generative',
+                name: taskDef.title,
+                description: taskDef.description,
+                args: {},
+                output: 'string',
+            };
+            const newTask = await createBaseTask({
+                function: functionDef,
+                priority: taskDef.priority || 'normal',
+                assignTo: taskDef.assignTo,
+                tags: taskDef.tags,
+                parentId,
+                projectId: project.id,
+                dependencies,
+                metadata: {
+                    ...taskDef.metadata,
+                    _taskNodeIndex: taskIndex - 1,
+                },
+            });
+            newTask.id = taskId;
+            tasks.push(newTask);
+            // Process subtasks
+            if (taskDef.subtasks && taskDef.subtasks.length > 0) {
+                let subtaskPrevIds = [];
+                for (const subtask of taskDef.subtasks) {
+                    subtaskPrevIds = await processNode(subtask, taskId, subtaskPrevIds, 'sequential');
+                }
+            }
+            return [taskId];
+        }
+        if (node.__type === 'parallel') {
+            const group = node;
+            const allIds = [];
+            // All tasks in parallel group can start simultaneously
+            // They don't depend on each other, only on previousIds
+            for (const child of group.tasks) {
+                const childIds = await processNode(child, parentId, previousIds, 'parallel');
+                allIds.push(...childIds);
+            }
+            return allIds;
+        }
+        if (node.__type === 'sequential') {
+            const group = node;
+            let currentPrevIds = previousIds;
+            // Each task depends on the previous one
+            for (const child of group.tasks) {
+                currentPrevIds = await processNode(child, parentId, currentPrevIds, 'sequential');
+            }
+            return currentPrevIds;
+        }
+        return [];
+    }
+    // Process all root-level tasks
+    let previousIds = [];
+    for (const node of project.tasks) {
+        previousIds = await processNode(node, undefined, previousIds, project.defaultMode || 'sequential');
+    }
+    return { project, tasks };
+}
+// ============================================================================
+// Dependency Graph Utilities
+// ============================================================================
+/**
+ * Get all tasks that depend on a given task (dependants)
+ */
+export function getDependants(taskId, allTasks) {
+    return allTasks.filter(t => t.dependencies?.some(d => d.taskId === taskId && d.type === 'blocked_by'));
+}
+/**
+ * Get all tasks that a given task depends on (dependencies)
+ */
+export function getDependencies(task, allTasks) {
+    if (!task.dependencies)
+        return [];
+    const depIds = task.dependencies
+        .filter(d => d.type === 'blocked_by')
+        .map(d => d.taskId);
+    return allTasks.filter(t => depIds.includes(t.id));
+}
+/**
+ * Get tasks that are ready to execute (no unsatisfied dependencies)
+ */
+export function getReadyTasks(allTasks) {
+    return allTasks.filter(t => {
+        if (t.status !== 'queued' && t.status !== 'pending')
+            return false;
+        if (!t.dependencies || t.dependencies.length === 0)
+            return true;
+        return t.dependencies
+            .filter(d => d.type === 'blocked_by')
+            .every(d => d.satisfied);
+    });
+}
+/**
+ * Check if a task graph has cycles
+ */
+export function hasCycles(allTasks) {
+    const visited = new Set();
+    const recStack = new Set();
+    function dfs(taskId) {
+        visited.add(taskId);
+        recStack.add(taskId);
+        const task = allTasks.find(t => t.id === taskId);
+        if (task?.dependencies) {
+            for (const dep of task.dependencies) {
+                if (dep.type === 'blocked_by') {
+                    if (!visited.has(dep.taskId)) {
+                        if (dfs(dep.taskId))
+                            return true;
+                    }
+                    else if (recStack.has(dep.taskId)) {
+                        return true;
+                    }
+                }
+            }
+        }
+        recStack.delete(taskId);
+        return false;
+    }
+    for (const task of allTasks) {
+        if (!visited.has(task.id)) {
+            if (dfs(task.id))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Sort tasks by their dependencies (tasks with no dependencies first)
+ */
+export function sortTasks(allTasks) {
+    const result = [];
+    const visited = new Set();
+    function visit(task) {
+        if (visited.has(task.id))
+            return;
+        visited.add(task.id);
+        // Visit dependencies first
+        if (task.dependencies) {
+            for (const dep of task.dependencies) {
+                if (dep.type === 'blocked_by') {
+                    const depTask = allTasks.find(t => t.id === dep.taskId);
+                    if (depTask)
+                        visit(depTask);
+                }
+            }
+        }
+        result.push(task);
+    }
+    for (const task of allTasks) {
+        visit(task);
+    }
+    return result;
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/queue.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Task Queue - In-memory task queue implementation
+ *
+ * Provides task queuing, assignment, and execution management.
+ *
+ * @packageDocumentation
+ */
+import type { TaskQueue, TaskQueueOptions } from './types.js';
+/**
+ * Global task queue instance
+ */
+export declare const taskQueue: TaskQueue;
+/**
+ * Create a new task queue instance
+ */
+export declare function createTaskQueue(options?: TaskQueueOptions): TaskQueue;
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAEV,SAAS,EACT,gBAAgB,EASjB,MAAM,YAAY,CAAA;AAyYnB;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,SAAmC,CAAA;AAE3D;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAErE"}