@cleocode/core 2026.4.7 → 2026.4.11

package/dist/tasks/hierarchy-policy.js.map

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

package/dist/tasks/hierarchy.js

@@ -0,0 +1,185 @@
+/**
+ * Task hierarchy operations - parent/child tree traversal and validation.
+ * Ported from lib/tasks/hierarchy.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+/**
+ * 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, policy) {
+    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 >= (policy?.maxDepth ?? 3)) {
+        return {
+            valid: false,
+            error: {
+                code: 'E_DEPTH_EXCEEDED',
+                message: `Maximum nesting depth ${policy?.maxDepth ?? 3} would be exceeded`,
+            },
+        };
+    }
+    // Check sibling limit
+    const existingChildren = getChildren(parentId, tasks);
+    const maxSiblings = policy?.maxSiblings ?? 0;
+    if (maxSiblings > 0 && existingChildren.length >= maxSiblings) {
+        return {
+            valid: false,
+            error: {
+                code: 'E_SIBLING_LIMIT',
+                message: `Parent ${parentId} already has ${maxSiblings} 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/tasks/hierarchy.js.map

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

package/dist/tasks/id-generator.js

@@ -0,0 +1,65 @@
+/**
+ * Task ID Generator
+ *
+ * Generates unique task IDs in the T#### format used by CLEO.
+ * Ensures uniqueness across active and archived tasks.
+ */
+/**
+ * Task ID pattern: T followed by 3+ digits
+ */
+const TASK_ID_PATTERN = /^T(\d{3,})$/;
+/**
+ * Extract the numeric part from a task ID
+ */
+function extractNumber(id) {
+    const match = id.match(TASK_ID_PATTERN);
+    return match ? parseInt(match[1], 10) : 0;
+}
+/**
+ * Find the highest existing task ID number
+ */
+export function findHighestId(existingIds) {
+    let highest = 0;
+    for (const id of existingIds) {
+        const num = extractNumber(id);
+        if (num > highest) {
+            highest = num;
+        }
+    }
+    return highest;
+}
+/**
+ * Generate the next ID given an explicit set of existing IDs.
+ * Useful when caller has already loaded task data.
+ */
+export function generateNextIdFromSet(existingIds) {
+    const highest = findHighestId(existingIds);
+    const next = highest + 1;
+    const padded = next.toString().padStart(3, '0');
+    return `T${padded}`;
+}
+/**
+ * Validate that a task ID matches the expected format
+ */
+export function isValidTaskId(id) {
+    return TASK_ID_PATTERN.test(id);
+}
+/**
+ * Normalize a task ID input to canonical T#### format.
+ *
+ * Accepts various loose formats (lowercase prefix, bare digits,
+ * underscore-suffixed descriptors) and returns the canonical form,
+ * or null if the input cannot be parsed as a task ID.
+ */
+export function normalizeTaskId(input) {
+    if (typeof input !== 'string')
+        return null;
+    const trimmed = input.trim();
+    if (trimmed === '')
+        return null;
+    const match = trimmed.match(/^[Tt]?(\d+)(?:_.*)?$/);
+    if (!match)
+        return null;
+    return `T${match[1]}`;
+}
+//# sourceMappingURL=id-generator.js.map

package/dist/tasks/id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","sourceRoot":"","sources":["../../src/tasks/id-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,eAAe,GAAG,aAAa,CAAC;AAEtC;;GAEG;AACH,SAAS,aAAa,CAAC,EAAU;IAC/B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAwB;IACpD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,GAAG,GAAG,OAAO,EAAE,CAAC;YAClB,OAAO,GAAG,GAAG,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAwB;IAC5D,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,IAAI,MAAM,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACxB,CAAC"}

package/dist/tasks/index.js

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

package/dist/tasks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,OAAO,EACP,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAqD,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAqD,YAAY,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAiD,UAAU,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAIL,SAAS,EACT,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAA+C,SAAS,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAmB,MAAM,WAAW,CAAC;AACtD,OAAO,EAAiD,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/tasks/labels.js

@@ -0,0 +1,52 @@
+/**
+ * Label management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getAccessor } from '../store/data-accessor.js';
+/** List all labels with task counts. */
+export async function listLabels(cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const { tasks } = await acc.queryTasks({});
+    const labelMap = {};
+    for (const task of 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 acc = accessor ?? (await getAccessor(cwd));
+    const { tasks } = await acc.queryTasks({ 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/tasks/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../src/tasks/labels.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAQxD,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAY,EAAE,QAAuB;IACpE,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAC,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YACtD,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa,EACb,GAAY,EACZ,QAAuB;IAEvB,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAC,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAElD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,8BAA8B,KAAK,GAAG,CAAC,CAAC;IAClF,CAAC;IAED,OAAO;QACL,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/F,KAAK,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAY,EACZ,QAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9F,OAAO;QACL,MAAM;QACN,WAAW;QACX,WAAW;QACX,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/tasks/list.js

@@ -0,0 +1,75 @@
+/**
+ * Task listing with filters.
+ * @task T4460
+ * @epic T4454
+ */
+import { taskListItemNext } from '../mvi-helpers.js';
+import { paginate } from '../pagination.js';
+const TASK_LIST_DEFAULT_LIMIT = 10;
+/** Convert a full Task to compact representation with _next directives. */
+export function toCompact(task) {
+    return {
+        id: task.id,
+        title: task.title,
+        status: task.status,
+        priority: task.priority,
+        type: task.type,
+        parentId: task.parentId,
+        _next: taskListItemNext(task.id),
+    };
+}
+/**
+ * List tasks with optional filtering and pagination.
+ * @task T4460
+ */
+export async function listTasks(options = {}, cwd, accessor) {
+    const dataAccessor = accessor ?? (await (await import('../store/data-accessor.js')).getAccessor(cwd));
+    // Build targeted query filters
+    const queryFilters = {
+        orderBy: 'position',
+    };
+    if (options.status)
+        queryFilters.status = options.status;
+    if (options.priority)
+        queryFilters.priority = options.priority;
+    if (options.type)
+        queryFilters.type = options.type;
+    if (options.parentId)
+        queryFilters.parentId = options.parentId;
+    if (options.phase)
+        queryFilters.phase = options.phase;
+    if (options.label)
+        queryFilters.label = options.label;
+    const queryResult = await dataAccessor.queryTasks(queryFilters);
+    const filtered = queryResult.tasks;
+    const filteredCount = queryResult.total;
+    // Get total count of all tasks (unfiltered) for the response
+    const total = await dataAccessor.countTasks();
+    const limit = options.limit === 0
+        ? undefined
+        : typeof options.limit === 'number' && options.limit > 0
+            ? options.limit
+            : TASK_LIST_DEFAULT_LIMIT;
+    const offset = typeof options.offset === 'number' && options.offset > 0 ? options.offset : undefined;
+    const { items: tasks, page } = paginate(filtered, limit, offset);
+    const pagination = page.mode === 'offset'
+        ? {
+            limit: page.limit,
+            offset: page.offset,
+            hasMore: page.hasMore,
+        }
+        : undefined;
+    // Enrich each task with _next progressive disclosure directives
+    const enrichedTasks = tasks.map((t) => ({
+        ...t,
+        _next: taskListItemNext(t.id),
+    }));
+    return {
+        tasks: enrichedTasks,
+        total,
+        filtered: filteredCount,
+        page,
+        pagination,
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/tasks/list.js.map

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

package/dist/tasks/phase-tracking.js

@@ -0,0 +1,133 @@
+/**
+ * Phase tracking - manage project phases and task-phase relationships.
+ * Ported from lib/tasks/phase-tracking.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+/**
+ * Get the current active phase from project metadata.
+ */
+export function getCurrentPhase(project) {
+    if (!project.currentPhase)
+        return null;
+    return project.phases[project.currentPhase] ?? null;
+}
+/**
+ * Get tasks belonging to a specific phase.
+ */
+export function getTasksByPhase(phaseName, tasks) {
+    return tasks.filter((t) => t.phase === phaseName);
+}
+/**
+ * Calculate progress for a phase.
+ */
+export function calculatePhaseProgress(phaseName, tasks) {
+    const phaseTasks = getTasksByPhase(phaseName, tasks);
+    const done = phaseTasks.filter((t) => t.status === 'done').length;
+    const active = phaseTasks.filter((t) => t.status === 'active').length;
+    const pending = phaseTasks.filter((t) => t.status === 'pending').length;
+    const blocked = phaseTasks.filter((t) => t.status === 'blocked').length;
+    const total = phaseTasks.length;
+    return {
+        name: phaseName,
+        status: total === 0 ? 'pending' : done === total ? 'completed' : active > 0 ? 'active' : 'pending',
+        total,
+        done,
+        active,
+        pending,
+        blocked,
+        percentComplete: total > 0 ? Math.round((done / total) * 100) : 0,
+    };
+}
+/**
+ * Get progress for all phases.
+ */
+export function getAllPhaseProgress(phases, tasks) {
+    return Object.keys(phases)
+        .sort((a, b) => (phases[a].order ?? 0) - (phases[b].order ?? 0))
+        .map((name) => calculatePhaseProgress(name, tasks));
+}
+export function validatePhaseTransition(fromPhase, toPhase, phases) {
+    // Target phase must exist
+    if (!phases[toPhase]) {
+        return { valid: false, error: `Phase "${toPhase}" does not exist` };
+    }
+    // If no current phase, any phase is valid
+    if (!fromPhase)
+        return { valid: true };
+    const from = phases[fromPhase];
+    const to = phases[toPhase];
+    if (!from) {
+        return { valid: false, error: `Current phase "${fromPhase}" does not exist` };
+    }
+    // Allow forward progression or same phase
+    if (to.order >= from.order)
+        return { valid: true };
+    // Allow rollback (but with warning via return value, caller decides)
+    return { valid: true };
+}
+/**
+ * Create a phase transition record.
+ */
+export function createPhaseTransition(phase, transitionType, taskCount, fromPhase, reason) {
+    return {
+        phase,
+        transitionType,
+        timestamp: new Date().toISOString(),
+        taskCount,
+        fromPhase: fromPhase ?? null,
+        reason,
+    };
+}
+/**
+ * Apply a phase transition to project metadata.
+ * Returns updated project data.
+ */
+export function applyPhaseTransition(project, toPhase, transitionType, taskCount, reason) {
+    const fromPhase = project.currentPhase ?? null;
+    const timestamp = new Date().toISOString();
+    const updatedPhases = { ...project.phases };
+    // Mark previous phase as completed if moving forward
+    if (fromPhase && transitionType === 'started') {
+        updatedPhases[fromPhase] = {
+            ...updatedPhases[fromPhase],
+            status: 'completed',
+            completedAt: timestamp,
+        };
+    }
+    // Update target phase
+    updatedPhases[toPhase] = {
+        ...updatedPhases[toPhase],
+        status: transitionType === 'completed' ? 'completed' : 'active',
+        startedAt: updatedPhases[toPhase].startedAt ?? timestamp,
+        ...(transitionType === 'completed' ? { completedAt: timestamp } : {}),
+    };
+    const transition = createPhaseTransition(toPhase, transitionType, taskCount, fromPhase, reason);
+    return {
+        ...project,
+        currentPhase: transitionType === 'completed' ? null : toPhase,
+        phases: updatedPhases,
+        phaseHistory: [...(project.phaseHistory ?? []), transition],
+    };
+}
+/**
+ * Get the next phase in order.
+ */
+export function getNextPhase(currentPhaseName, phases) {
+    const sorted = Object.entries(phases).sort(([, a], [, b]) => a.order - b.order);
+    if (!currentPhaseName) {
+        return sorted[0]?.[0] ?? null;
+    }
+    const currentIdx = sorted.findIndex(([name]) => name === currentPhaseName);
+    if (currentIdx < 0 || currentIdx >= sorted.length - 1)
+        return null;
+    return sorted[currentIdx + 1][0];
+}
+/**
+ * Check if all phases are complete.
+ */
+export function allPhasesComplete(phases) {
+    return Object.values(phases).every((p) => p.status === 'completed');
+}
+//# sourceMappingURL=phase-tracking.js.map

package/dist/tasks/phase-tracking.js.map

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