@cleocode/cleo 2026.2.5

package/dist/core/tasks/graph-rag.js.map

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

package/dist/core/tasks/hierarchy.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Task hierarchy operations - parent/child tree traversal and validation.
+ * Ported from lib/tasks/hierarchy.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+import type { Task } from '../../types/task.js';
+/**
+ * Get direct children of a task.
+ */
+export declare function getChildren(taskId: string, tasks: Task[]): Task[];
+/**
+ * Get direct child IDs.
+ */
+export declare function getChildIds(taskId: string, tasks: Task[]): string[];
+/**
+ * Get all descendants of a task (recursive).
+ */
+export declare function getDescendants(taskId: string, tasks: Task[]): Task[];
+/**
+ * Get all descendant IDs (flat list).
+ */
+export declare function getDescendantIds(taskId: string, tasks: Task[]): string[];
+/**
+ * Get the parent chain (ancestors) from a task up to the root.
+ * Returns ordered from immediate parent to root.
+ */
+export declare function getParentChain(taskId: string, tasks: Task[]): Task[];
+/**
+ * Get the parent chain as IDs.
+ */
+export declare function getParentChainIds(taskId: string, tasks: Task[]): string[];
+/**
+ * Calculate depth of a task in the hierarchy (0-based).
+ * Root tasks have depth 0, their children depth 1, etc.
+ */
+export declare function getDepth(taskId: string, tasks: Task[]): number;
+/**
+ * Get the root ancestor of a task.
+ */
+export declare function getRootAncestor(taskId: string, tasks: Task[]): Task | null;
+/**
+ * Check if a task is an ancestor of another.
+ */
+export declare function isAncestorOf(ancestorId: string, descendantId: string, tasks: Task[]): boolean;
+/**
+ * Check if a task is a descendant of another.
+ */
+export declare function isDescendantOf(descendantId: string, ancestorId: string, tasks: Task[]): boolean;
+/**
+ * Get sibling tasks (same parent).
+ */
+export declare function getSiblings(taskId: string, tasks: Task[]): Task[];
+/**
+ * Validate that adding a child to a parent would not violate constraints.
+ */
+export interface HierarchyValidation {
+    valid: boolean;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export declare function validateHierarchy(parentId: string | null, tasks: Task[]): HierarchyValidation;
+/**
+ * Detect circular reference if parentId were set.
+ */
+export declare function wouldCreateCircle(taskId: string, newParentId: string, tasks: Task[]): boolean;
+/**
+ * Build a tree structure from flat task list.
+ */
+export interface TaskTreeNode {
+    task: Task;
+    children: TaskTreeNode[];
+}
+export declare function buildTree(tasks: Task[]): TaskTreeNode[];
+/**
+ * Flatten a tree back to a list (depth-first).
+ */
+export declare function flattenTree(nodes: TaskTreeNode[]): Task[];
+//# sourceMappingURL=hierarchy.d.ts.map

package/dist/core/tasks/hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAQhD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAEjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAEnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAkBpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAExE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAgBpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAEzE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAG1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CASjE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,KAAK,EAAE,IAAI,EAAE,GACZ,mBAAmB,CAsCrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,CAIT;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAkBvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,CAOzD"}

package/dist/core/tasks/hierarchy.js

@@ -0,0 +1,188 @@
+/**
+ * Task hierarchy operations - parent/child tree traversal and validation.
+ * Ported from lib/tasks/hierarchy.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+/** Maximum nesting depth (epic -> task -> subtask). */
+const MAX_DEPTH = 3;
+/** Maximum siblings per parent. */
+const MAX_SIBLINGS = 7;
+/**
+ * Get direct children of a task.
+ */
+export function getChildren(taskId, tasks) {
+    return tasks.filter((t) => t.parentId === taskId);
+}
+/**
+ * Get direct child IDs.
+ */
+export function getChildIds(taskId, tasks) {
+    return getChildren(taskId, tasks).map((t) => t.id);
+}
+/**
+ * Get all descendants of a task (recursive).
+ */
+export function getDescendants(taskId, tasks) {
+    const result = [];
+    const queue = [taskId];
+    const visited = new Set();
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (visited.has(current))
+            continue;
+        visited.add(current);
+        const children = getChildren(current, tasks);
+        for (const child of children) {
+            result.push(child);
+            queue.push(child.id);
+        }
+    }
+    return result;
+}
+/**
+ * Get all descendant IDs (flat list).
+ */
+export function getDescendantIds(taskId, tasks) {
+    return getDescendants(taskId, tasks).map((t) => t.id);
+}
+/**
+ * Get the parent chain (ancestors) from a task up to the root.
+ * Returns ordered from immediate parent to root.
+ */
+export function getParentChain(taskId, tasks) {
+    const chain = [];
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    let current = taskMap.get(taskId);
+    const visited = new Set();
+    while (current?.parentId) {
+        if (visited.has(current.parentId))
+            break; // circular reference guard
+        visited.add(current.parentId);
+        const parent = taskMap.get(current.parentId);
+        if (!parent)
+            break;
+        chain.push(parent);
+        current = parent;
+    }
+    return chain;
+}
+/**
+ * Get the parent chain as IDs.
+ */
+export function getParentChainIds(taskId, tasks) {
+    return getParentChain(taskId, tasks).map((t) => t.id);
+}
+/**
+ * Calculate depth of a task in the hierarchy (0-based).
+ * Root tasks have depth 0, their children depth 1, etc.
+ */
+export function getDepth(taskId, tasks) {
+    return getParentChain(taskId, tasks).length;
+}
+/**
+ * Get the root ancestor of a task.
+ */
+export function getRootAncestor(taskId, tasks) {
+    const chain = getParentChain(taskId, tasks);
+    return chain.length > 0 ? chain[chain.length - 1] : null;
+}
+/**
+ * Check if a task is an ancestor of another.
+ */
+export function isAncestorOf(ancestorId, descendantId, tasks) {
+    const chain = getParentChainIds(descendantId, tasks);
+    return chain.includes(ancestorId);
+}
+/**
+ * Check if a task is a descendant of another.
+ */
+export function isDescendantOf(descendantId, ancestorId, tasks) {
+    return isAncestorOf(ancestorId, descendantId, tasks);
+}
+/**
+ * Get sibling tasks (same parent).
+ */
+export function getSiblings(taskId, tasks) {
+    const task = tasks.find((t) => t.id === taskId);
+    if (!task)
+        return [];
+    if (task.parentId) {
+        return tasks.filter((t) => t.parentId === task.parentId && t.id !== taskId);
+    }
+    // Root-level siblings: tasks with no parent, excluding self
+    return tasks.filter((t) => !t.parentId && t.id !== taskId);
+}
+export function validateHierarchy(parentId, tasks) {
+    if (!parentId) {
+        return { valid: true };
+    }
+    const parent = tasks.find((t) => t.id === parentId);
+    if (!parent) {
+        return {
+            valid: false,
+            error: { code: 'E_PARENT_NOT_FOUND', message: `Parent task ${parentId} not found` },
+        };
+    }
+    // Check depth
+    const parentDepth = getDepth(parentId, tasks);
+    if (parentDepth + 1 >= MAX_DEPTH) {
+        return {
+            valid: false,
+            error: {
+                code: 'E_DEPTH_EXCEEDED',
+                message: `Maximum nesting depth ${MAX_DEPTH} would be exceeded`,
+            },
+        };
+    }
+    // Check sibling limit
+    const existingChildren = getChildren(parentId, tasks);
+    if (existingChildren.length >= MAX_SIBLINGS) {
+        return {
+            valid: false,
+            error: {
+                code: 'E_SIBLING_LIMIT',
+                message: `Parent ${parentId} already has ${MAX_SIBLINGS} children (max)`,
+            },
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Detect circular reference if parentId were set.
+ */
+export function wouldCreateCircle(taskId, newParentId, tasks) {
+    if (taskId === newParentId)
+        return true;
+    const descendants = getDescendantIds(taskId, tasks);
+    return descendants.includes(newParentId);
+}
+export function buildTree(tasks) {
+    const childrenMap = new Map();
+    for (const task of tasks) {
+        const parentKey = task.parentId ?? null;
+        if (!childrenMap.has(parentKey)) {
+            childrenMap.set(parentKey, []);
+        }
+        childrenMap.get(parentKey).push(task);
+    }
+    function buildNode(task) {
+        const children = (childrenMap.get(task.id) ?? []).map(buildNode);
+        return { task, children };
+    }
+    const roots = childrenMap.get(null) ?? [];
+    return roots.map(buildNode);
+}
+/**
+ * Flatten a tree back to a list (depth-first).
+ */
+export function flattenTree(nodes) {
+    const result = [];
+    for (const node of nodes) {
+        result.push(node.task);
+        result.push(...flattenTree(node.children));
+    }
+    return result;
+}
+//# sourceMappingURL=hierarchy.js.map

package/dist/core/tasks/hierarchy.js.map

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

package/dist/core/tasks/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Task operations barrel export.
+ * @task T4460
+ * @epic T4454
+ */
+export { addTask, type AddTaskOptions, type AddTaskResult } from './add.js';
+export { validateTitle, validateStatus, validatePriority, normalizePriority, VALID_PRIORITIES, validateTaskType, validateSize, validateLabels, validatePhaseFormat, validateDepends, validateParent, generateTaskId, getTaskDepth, inferTaskType, getNextPosition, findRecentDuplicate, logOperation, } from './add.js';
+export { listTasks, type ListTasksOptions, type ListTasksResult } from './list.js';
+export { showTask, type TaskDetail } from './show.js';
+export { findTasks, fuzzyScore, type FindTasksOptions, type FindTasksResult, type FindResult } from './find.js';
+export { completeTask, type CompleteTaskOptions, type CompleteTaskResult } from './complete.js';
+export { updateTask, type UpdateTaskOptions, type UpdateTaskResult } from './update.js';
+export { deleteTask, type DeleteTaskOptions, type DeleteTaskResult } from './delete.js';
+export { archiveTasks, type ArchiveTasksOptions, type ArchiveTasksResult } from './archive.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/tasks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAChH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/tasks/index.js

@@ -0,0 +1,15 @@
+/**
+ * Task operations barrel export.
+ * @task T4460
+ * @epic T4454
+ */
+export { addTask } from './add.js';
+export { validateTitle, validateStatus, validatePriority, normalizePriority, VALID_PRIORITIES, validateTaskType, validateSize, validateLabels, validatePhaseFormat, validateDepends, validateParent, generateTaskId, getTaskDepth, inferTaskType, getNextPosition, findRecentDuplicate, logOperation, } from './add.js';
+export { listTasks } from './list.js';
+export { showTask } from './show.js';
+export { findTasks, fuzzyScore } from './find.js';
+export { completeTask } from './complete.js';
+export { updateTask } from './update.js';
+export { deleteTask } from './delete.js';
+export { archiveTasks } from './archive.js';
+//# sourceMappingURL=index.js.map

package/dist/core/tasks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/tasks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAA2C,MAAM,UAAU,CAAC;AAC5E,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAA+C,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAmB,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAgE,MAAM,WAAW,CAAC;AAChH,OAAO,EAAE,YAAY,EAAqD,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,UAAU,EAAiD,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,UAAU,EAAiD,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,YAAY,EAAqD,MAAM,cAAc,CAAC"}

package/dist/core/tasks/labels.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Label management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import type { DataAccessor } from '../../store/data-accessor.js';
+interface LabelInfo {
+    label: string;
+    count: number;
+    statuses: Record<string, number>;
+}
+/** List all labels with task counts. */
+export declare function listLabels(cwd?: string, accessor?: DataAccessor): Promise<LabelInfo[]>;
+/** Show tasks with a specific label. */
+export declare function showLabelTasks(label: string, cwd?: string, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+/** Get detailed label statistics. */
+export declare function getLabelStats(cwd?: string, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=labels.d.ts.map

package/dist/core/tasks/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/labels.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wCAAwC;AACxC,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAkB5F;AAED,wCAAwC;AACxC,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAelC;AAED,qCAAqC;AACrC,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAY3G"}

package/dist/core/tasks/labels.js

@@ -0,0 +1,56 @@
+/**
+ * Label management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { readJsonRequired } from '../../store/json.js';
+import { getTodoPath } from '../paths.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+/** List all labels with task counts. */
+export async function listLabels(cwd, accessor) {
+    const data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJsonRequired(getTodoPath(cwd));
+    const labelMap = {};
+    for (const task of data.tasks) {
+        for (const label of task.labels ?? []) {
+            if (!labelMap[label]) {
+                labelMap[label] = { label, count: 0, statuses: {} };
+            }
+            const info = labelMap[label];
+            info.count++;
+            info.statuses[task.status] = (info.statuses[task.status] ?? 0) + 1;
+        }
+    }
+    return Object.values(labelMap).sort((a, b) => b.count - a.count);
+}
+/** Show tasks with a specific label. */
+export async function showLabelTasks(label, cwd, accessor) {
+    const data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJsonRequired(getTodoPath(cwd));
+    const tasks = data.tasks.filter(t => (t.labels ?? []).includes(label));
+    if (tasks.length === 0) {
+        throw new CleoError(ExitCode.NOT_FOUND, `No tasks found with label '${label}'`);
+    }
+    return {
+        label,
+        tasks: tasks.map(t => ({ id: t.id, title: t.title, status: t.status, priority: t.priority })),
+        count: tasks.length,
+    };
+}
+/** Get detailed label statistics. */
+export async function getLabelStats(cwd, accessor) {
+    const labels = await listLabels(cwd, accessor);
+    const totalLabels = labels.length;
+    const totalUsages = labels.reduce((sum, l) => sum + l.count, 0);
+    const avgPerLabel = totalLabels > 0 ? Math.round((totalUsages / totalLabels) * 100) / 100 : 0;
+    return {
+        labels,
+        totalLabels,
+        totalUsages,
+        avgPerLabel,
+    };
+}
+//# sourceMappingURL=labels.js.map

package/dist/core/tasks/labels.js.map

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

package/dist/core/tasks/list.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Task listing with filters.
+ * @task T4460
+ * @epic T4454
+ */
+import type { Task, TaskStatus, TaskPriority, TaskType } from '../../types/task.js';
+import type { DataAccessor } from '../../store/data-accessor.js';
+/** Filter options for listing tasks. */
+export interface ListTasksOptions {
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    type?: TaskType;
+    parentId?: string;
+    phase?: string;
+    label?: string;
+    children?: boolean;
+    limit?: number;
+    offset?: number;
+}
+/** Result of listing tasks. */
+export interface ListTasksResult {
+    tasks: Task[];
+    total: number;
+    filtered: number;
+    pagination?: {
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
+}
+/**
+ * List tasks with optional filtering and pagination.
+ * @task T4460
+ */
+export declare function listTasks(options?: ListTasksOptions, cwd?: string, accessor?: DataAccessor): Promise<ListTasksResult>;
+//# sourceMappingURL=list.d.ts.map

package/dist/core/tasks/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAY,MAAM,qBAAqB,CAAC;AAE9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,gBAAqB,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAuE/H"}

package/dist/core/tasks/list.js

@@ -0,0 +1,72 @@
+/**
+ * Task listing with filters.
+ * @task T4460
+ * @epic T4454
+ */
+import { readJsonRequired } from '../../store/json.js';
+import { getTodoPath } from '../paths.js';
+/**
+ * List tasks with optional filtering and pagination.
+ * @task T4460
+ */
+export async function listTasks(options = {}, cwd, accessor) {
+    const todoPath = getTodoPath(cwd);
+    const data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJsonRequired(todoPath);
+    let filtered = data.tasks;
+    // Apply filters
+    if (options.status) {
+        filtered = filtered.filter(t => t.status === options.status);
+    }
+    if (options.priority) {
+        filtered = filtered.filter(t => t.priority === options.priority);
+    }
+    if (options.type) {
+        filtered = filtered.filter(t => t.type === options.type);
+    }
+    if (options.parentId) {
+        if (options.children) {
+            // Show direct children of the parent
+            filtered = filtered.filter(t => t.parentId === options.parentId);
+        }
+        else {
+            filtered = filtered.filter(t => t.parentId === options.parentId);
+        }
+    }
+    if (options.phase) {
+        filtered = filtered.filter(t => t.phase === options.phase);
+    }
+    if (options.label) {
+        filtered = filtered.filter(t => t.labels?.includes(options.label));
+    }
+    const total = data.tasks.length;
+    const filteredCount = filtered.length;
+    // Sort by position within parent groups
+    filtered.sort((a, b) => (a.position ?? 0) - (b.position ?? 0));
+    // Apply pagination
+    const limit = options.limit ?? 0;
+    const offset = options.offset ?? 0;
+    if (limit > 0) {
+        const paginated = filtered.slice(offset, offset + limit);
+        return {
+            tasks: paginated,
+            total,
+            filtered: filteredCount,
+            pagination: {
+                limit,
+                offset,
+                hasMore: offset + limit < filteredCount,
+            },
+        };
+    }
+    if (offset > 0) {
+        filtered = filtered.slice(offset);
+    }
+    return {
+        tasks: filtered,
+        total,
+        filtered: filteredCount,
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/core/tasks/list.js.map

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

package/dist/core/tasks/phase-tracking.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Phase tracking - manage project phases and task-phase relationships.
+ * Ported from lib/tasks/phase-tracking.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+import type { Task, Phase, PhaseStatus, PhaseTransition, ProjectMeta } from '../../types/task.js';
+/** Phase progress information. */
+export interface PhaseProgress {
+    name: string;
+    status: PhaseStatus;
+    total: number;
+    done: number;
+    active: number;
+    pending: number;
+    blocked: number;
+    percentComplete: number;
+}
+/**
+ * Get the current active phase from project metadata.
+ */
+export declare function getCurrentPhase(project: ProjectMeta): Phase | null;
+/**
+ * Get tasks belonging to a specific phase.
+ */
+export declare function getTasksByPhase(phaseName: string, tasks: Task[]): Task[];
+/**
+ * Calculate progress for a phase.
+ */
+export declare function calculatePhaseProgress(phaseName: string, tasks: Task[]): PhaseProgress;
+/**
+ * Get progress for all phases.
+ */
+export declare function getAllPhaseProgress(phases: Record<string, Phase>, tasks: Task[]): PhaseProgress[];
+/**
+ * Validate a phase transition.
+ */
+export interface PhaseTransitionValidation {
+    valid: boolean;
+    error?: string;
+}
+export declare function validatePhaseTransition(fromPhase: string | null, toPhase: string, phases: Record<string, Phase>): PhaseTransitionValidation;
+/**
+ * Create a phase transition record.
+ */
+export declare function createPhaseTransition(phase: string, transitionType: PhaseTransition['transitionType'], taskCount: number, fromPhase?: string | null, reason?: string): PhaseTransition;
+/**
+ * Apply a phase transition to project metadata.
+ * Returns updated project data.
+ */
+export declare function applyPhaseTransition(project: ProjectMeta, toPhase: string, transitionType: PhaseTransition['transitionType'], taskCount: number, reason?: string): ProjectMeta;
+/**
+ * Get the next phase in order.
+ */
+export declare function getNextPhase(currentPhaseName: string | null, phases: Record<string, Phase>): string | null;
+/**
+ * Check if all phases are complete.
+ */
+export declare function allPhasesComplete(phases: Record<string, Phase>): boolean;
+//# sourceMappingURL=phase-tracking.d.ts.map

package/dist/core/tasks/phase-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-tracking.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/phase-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,IAAI,EACJ,KAAK,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAE7B,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,KAAK,GAAG,IAAI,CAGlE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAExE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,IAAI,EAAE,GACZ,aAAa,CAmBf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC7B,KAAK,EAAE,IAAI,EAAE,GACZ,aAAa,EAAE,CAIjB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAC5B,yBAAyB,CAqB3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,eAAe,CAAC,gBAAgB,CAAC,EACjD,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CASjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,eAAe,CAAC,gBAAgB,CAAC,EACjD,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,CAqCb;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAC5B,MAAM,GAAG,IAAI,CAUf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,OAAO,CAExE"}