digital-tasks 2.0.1

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * digital-tasks - Task management primitives for digital workers
+ *
+ * Task = Function + metadata (status, progress, assignment, dependencies)
+ *
+ * Every task wraps a function (code, generative, agentic, or human)
+ * with lifecycle management, worker assignment, and dependency tracking.
+ *
+ * ## Quick Start
+ *
+ * ```ts
+ * import { Task, createTask, taskQueue } from 'digital-tasks'
+ *
+ * // Create a task from a function
+ * const task = await createTask({
+ *   function: {
+ *     type: 'generative',
+ *     name: 'summarize',
+ *     args: { text: 'The text to summarize' },
+ *     output: 'string',
+ *     promptTemplate: 'Summarize: {{text}}',
+ *   },
+ *   input: { text: 'Long article...' },
+ *   priority: 'high',
+ * })
+ *
+ * // Start and complete
+ * await startTask(task.id, { type: 'agent', id: 'agent_1' })
+ * await completeTask(task.id, 'Summary of the article...')
+ * ```
+ *
+ * ## Projects with Parallel/Sequential Tasks
+ *
+ * ```ts
+ * import { createProject, task, parallel, sequential, toMarkdown } from 'digital-tasks'
+ *
+ * const project = createProject({
+ *   name: 'Launch Feature',
+ *   tasks: [
+ *     parallel(
+ *       task('Design mockups'),
+ *       task('Write tech spec'),
+ *     ),
+ *     sequential(
+ *       task('Implement backend'),
+ *       task('Implement frontend'),
+ *       task('Write tests'),
+ *     ),
+ *   ],
+ * })
+ *
+ * // Convert to markdown
+ * const md = toMarkdown(project)
+ * // # Launch Feature
+ * // - [ ] Design mockups
+ * // - [ ] Write tech spec
+ * // 1. [ ] Implement backend
+ * // 2. [ ] Implement frontend
+ * // 3. [ ] Write tests
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type * from './types.js';
+export type { Task, AnyTask, TaskStatus, TaskPriority, TaskQueue, TaskQueueOptions, TaskResult, WorkerRef, WorkerType, TaskDependency, DependencyType, TaskProgress, TaskEvent, CreateTaskOptions, UpdateTaskOptions, TaskQuery, TaskQueueStats, FunctionDefinition, CodeFunctionDefinition, GenerativeFunctionDefinition, AgenticFunctionDefinition, HumanFunctionDefinition, } from './types.js';
+export { taskQueue, createTaskQueue } from './queue.js';
+export { createTask, getTask, startTask, updateProgress, completeTask, failTask, cancelTask, addComment, createSubtask, getSubtasks, waitForTask, } from './task.js';
+export type { ExecutionMode, FunctionType, TaskNode, TaskDefinition, ParallelGroup, SequentialGroup, Project, ProjectStatus, CreateProjectOptions, } from './project.js';
+export { task, parallel, sequential, createProject, workflow, materializeProject, getDependants, getDependencies, getReadyTasks, hasCycles, sortTasks, } from './project.js';
+export type { SerializeOptions } from './markdown.js';
+export { parseMarkdown, toMarkdown, syncStatusFromMarkdown, } from './markdown.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAMH,mBAAmB,YAAY,CAAA;AAE/B,YAAY,EACV,IAAI,EACJ,OAAO,EACP,UAAU,EACV,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,UAAU,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,cAAc,EAEd,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AAMnB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAMvD,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,WAAW,CAAA;AAMlB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,aAAa,EACb,eAAe,EACf,OAAO,EACP,aAAa,EACb,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,EACb,SAAS,EACT,SAAS,GACV,MAAM,cAAc,CAAA;AAMrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErD,OAAO,EACL,aAAa,EACb,UAAU,EACV,sBAAsB,GACvB,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,74 @@
+/**
+ * digital-tasks - Task management primitives for digital workers
+ *
+ * Task = Function + metadata (status, progress, assignment, dependencies)
+ *
+ * Every task wraps a function (code, generative, agentic, or human)
+ * with lifecycle management, worker assignment, and dependency tracking.
+ *
+ * ## Quick Start
+ *
+ * ```ts
+ * import { Task, createTask, taskQueue } from 'digital-tasks'
+ *
+ * // Create a task from a function
+ * const task = await createTask({
+ *   function: {
+ *     type: 'generative',
+ *     name: 'summarize',
+ *     args: { text: 'The text to summarize' },
+ *     output: 'string',
+ *     promptTemplate: 'Summarize: {{text}}',
+ *   },
+ *   input: { text: 'Long article...' },
+ *   priority: 'high',
+ * })
+ *
+ * // Start and complete
+ * await startTask(task.id, { type: 'agent', id: 'agent_1' })
+ * await completeTask(task.id, 'Summary of the article...')
+ * ```
+ *
+ * ## Projects with Parallel/Sequential Tasks
+ *
+ * ```ts
+ * import { createProject, task, parallel, sequential, toMarkdown } from 'digital-tasks'
+ *
+ * const project = createProject({
+ *   name: 'Launch Feature',
+ *   tasks: [
+ *     parallel(
+ *       task('Design mockups'),
+ *       task('Write tech spec'),
+ *     ),
+ *     sequential(
+ *       task('Implement backend'),
+ *       task('Implement frontend'),
+ *       task('Write tests'),
+ *     ),
+ *   ],
+ * })
+ *
+ * // Convert to markdown
+ * const md = toMarkdown(project)
+ * // # Launch Feature
+ * // - [ ] Design mockups
+ * // - [ ] Write tech spec
+ * // 1. [ ] Implement backend
+ * // 2. [ ] Implement frontend
+ * // 3. [ ] Write tests
+ * ```
+ *
+ * @packageDocumentation
+ */
+// ============================================================================
+// Task Queue
+// ============================================================================
+export { taskQueue, createTaskQueue } from './queue.js';
+// ============================================================================
+// Task Management
+// ============================================================================
+export { createTask, getTask, startTask, updateProgress, completeTask, failTask, cancelTask, addComment, createSubtask, getSubtasks, waitForTask, } from './task.js';
+export { task, parallel, sequential, createProject, workflow, materializeProject, getDependants, getDependencies, getReadyTasks, hasCycles, sortTasks, } from './project.js';
+export { parseMarkdown, toMarkdown, syncStatusFromMarkdown, } from './markdown.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAkCH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEvD,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,WAAW,CAAA;AAkBlB,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,EACb,SAAS,EACT,SAAS,GACV,MAAM,cAAc,CAAA;AAQrB,OAAO,EACL,aAAa,EACb,UAAU,EACV,sBAAsB,GACvB,MAAM,eAAe,CAAA"}

package/dist/markdown.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Markdown Task List Parser and Serializer
+ *
+ * Bidirectional conversion between markdown task lists and Task objects.
+ *
+ * ## Syntax
+ *
+ * - `- [ ]` = Unordered/parallel tasks (can run simultaneously)
+ * - `1. [ ]` = Ordered/sequential tasks (must run in order)
+ * - `- [x]` or `1. [x]` = Completed task
+ * - `- [-]` = In progress task
+ * - `- [~]` = Blocked task
+ * - `- [!]` = Failed task
+ * - Indentation (2 spaces) = Subtasks
+ * - `# Heading` = Project name
+ * - `## Heading` = Task group/section
+ *
+ * ## Example
+ *
+ * ```markdown
+ * # Launch Feature
+ *
+ * ## Planning (parallel)
+ * - [ ] Design mockups
+ * - [ ] Write technical spec
+ * - [x] Create project board
+ *
+ * ## Implementation (sequential)
+ * 1. [ ] Implement backend API
+ * 2. [-] Implement frontend UI
+ *    - [ ] Create components
+ *    - [ ] Add state management
+ * 3. [ ] Write tests
+ *
+ * ## Deployment
+ * 1. [ ] Deploy to staging
+ * 2. [ ] QA testing
+ * 3. [ ] Deploy to production
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { Project } from './project.js';
+/**
+ * Parse a markdown string into a Project
+ *
+ * @example
+ * ```ts
+ * const markdown = `
+ * # My Project
+ *
+ * - [ ] Task 1
+ * - [ ] Task 2
+ *
+ * ## Sequential Work
+ * 1. [ ] Step 1
+ * 2. [ ] Step 2
+ * `
+ *
+ * const project = parseMarkdown(markdown)
+ * ```
+ */
+export declare function parseMarkdown(markdown: string): Project;
+/**
+ * Options for markdown serialization
+ */
+export interface SerializeOptions {
+    /** Include status markers (default: true) */
+    includeStatus?: boolean;
+    /** Include priority markers (default: false) */
+    includePriority?: boolean;
+    /** Indent size in spaces (default: 2) */
+    indentSize?: number;
+    /** Include section headings (default: true) */
+    includeSections?: boolean;
+}
+/**
+ * Serialize a Project to markdown
+ *
+ * @example
+ * ```ts
+ * const project = createProject({
+ *   name: 'My Project',
+ *   tasks: [
+ *     parallel(
+ *       task('Task 1'),
+ *       task('Task 2'),
+ *     ),
+ *     sequential(
+ *       task('Step 1'),
+ *       task('Step 2'),
+ *     ),
+ *   ],
+ * })
+ *
+ * const markdown = toMarkdown(project)
+ * // # My Project
+ * //
+ * // - [ ] Task 1
+ * // - [ ] Task 2
+ * //
+ * // 1. [ ] Step 1
+ * // 2. [ ] Step 2
+ * ```
+ */
+export declare function toMarkdown(project: Project, options?: SerializeOptions): string;
+/**
+ * Update task statuses in a project from markdown
+ * (Useful for syncing when markdown is edited externally)
+ */
+export declare function syncStatusFromMarkdown(project: Project, markdown: string): Project;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,OAAO,KAAK,EACV,OAAO,EAMR,MAAM,cAAc,CAAA;AAqPrB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAwFvD;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gDAAgD;IAChD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AA4ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAwBnF;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CA0DT"}