@cleocode/core 2026.3.56 → 2026.3.58

package/dist/tasks/plan.js

@@ -0,0 +1,268 @@
+/**
+ * Composite planning view - aggregates multiple task queries for planning.
+ * @task T4914
+ * @epic T4454
+ */
+import { getAccessor } from '../store/data-accessor.js';
+import { depsReady } from './deps-ready.js';
+const PRIORITY_SCORE = {
+    critical: 100,
+    high: 75,
+    medium: 50,
+    low: 25,
+};
+async function loadAllTasks(projectRoot) {
+    const accessor = await getAccessor(projectRoot);
+    const { tasks } = await accessor.queryTasks({});
+    return tasks;
+}
+/**
+ * Calculate leverage score for a task based on how many other tasks depend on it.
+ */
+function calculateLeverage(taskId, taskMap) {
+    let leverage = 0;
+    for (const task of taskMap.values()) {
+        if (task.depends?.includes(taskId)) {
+            leverage++;
+        }
+    }
+    return leverage;
+}
+/**
+ * Find the epic ID for a task (parent epic, not immediate parent).
+ */
+function findEpicId(task, taskMap) {
+    let current = task;
+    const visited = new Set();
+    while (current?.parentId && !visited.has(current.id)) {
+        visited.add(current.id);
+        const parent = taskMap.get(current.parentId);
+        if (!parent)
+            break;
+        if (parent.type === 'epic') {
+            return parent.id;
+        }
+        current = parent;
+    }
+    // If task itself is an epic
+    if (task.type === 'epic') {
+        return task.id;
+    }
+    // Return parentId as fallback, or task's own id
+    return task.parentId ?? task.id;
+}
+/**
+ * Get current phase from tasks.
+ */
+async function getCurrentPhase(projectRoot) {
+    const accessor = await getAccessor(projectRoot);
+    const meta = await accessor.getMetaValue('project_meta');
+    return meta?.currentPhase ?? null;
+}
+/**
+ * Calculate completion percentage for an epic.
+ */
+function calculateEpicCompletion(epicId, taskMap) {
+    let totalTasks = 0;
+    let completedTasks = 0;
+    let activeTasks = 0;
+    // Count direct children and their descendants
+    const collectTasks = (parentId) => {
+        for (const task of taskMap.values()) {
+            if (task.parentId === parentId) {
+                totalTasks++;
+                if (task.status === 'done' || task.status === 'cancelled') {
+                    completedTasks++;
+                }
+                if (task.status === 'active') {
+                    activeTasks++;
+                }
+                // Recursively count descendants
+                collectTasks(task.id);
+            }
+        }
+    };
+    collectTasks(epicId);
+    const completionPercent = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+    return { activeTasks, completionPercent };
+}
+/**
+ * Build composite planning view.
+ * @task T4914
+ */
+export async function coreTaskPlan(projectRoot) {
+    const allTasks = await loadAllTasks(projectRoot);
+    const taskMap = new Map(allTasks.map((t) => [t.id, t]));
+    const currentPhase = await getCurrentPhase(projectRoot);
+    // ========================================================================
+    // 1. In-Progress Epics (epics with active status)
+    // ========================================================================
+    const inProgressEpics = [];
+    for (const task of allTasks) {
+        if (task.type === 'epic' && task.status === 'active') {
+            const { activeTasks, completionPercent } = calculateEpicCompletion(task.id, taskMap);
+            inProgressEpics.push({
+                epicId: task.id,
+                epicTitle: task.title,
+                activeTasks,
+                completionPercent,
+            });
+        }
+    }
+    // ========================================================================
+    // 2. Ready Tasks (pending tasks with deps satisfied)
+    // ========================================================================
+    const readyTasks = [];
+    const pendingTasks = allTasks.filter((t) => t.status === 'pending');
+    for (const task of pendingTasks) {
+        if (depsReady(task.depends, taskMap)) {
+            const leverage = calculateLeverage(task.id, taskMap);
+            const epicId = findEpicId(task, taskMap);
+            // Calculate score using same logic as tasks.next
+            const reasons = [];
+            let score = 0;
+            score += PRIORITY_SCORE[task.priority] ?? 50;
+            reasons.push(`priority: ${task.priority} (+${PRIORITY_SCORE[task.priority] ?? 50})`);
+            if (currentPhase && task.phase === currentPhase) {
+                score += 20;
+                reasons.push(`phase alignment: ${currentPhase} (+20)`);
+            }
+            score += 10;
+            reasons.push('all dependencies satisfied (+10)');
+            if (task.createdAt) {
+                const ageMs = Date.now() - new Date(task.createdAt).getTime();
+                const ageDays = ageMs / (1000 * 60 * 60 * 24);
+                if (ageDays > 7) {
+                    const ageBonus = Math.min(15, Math.floor(ageDays / 7));
+                    score += ageBonus;
+                    reasons.push(`age: ${Math.floor(ageDays)} days (+${ageBonus})`);
+                }
+            }
+            // Add leverage bonus to score
+            if (leverage > 0) {
+                score += leverage * 5;
+                reasons.push(`leverage: unblocks ${leverage} task(s) (+${leverage * 5})`);
+            }
+            readyTasks.push({
+                id: task.id,
+                title: task.title,
+                priority: task.priority,
+                epicId,
+                leverage,
+                score,
+                reasons,
+            });
+        }
+    }
+    // Sort by score descending
+    readyTasks.sort((a, b) => b.score - a.score);
+    // ========================================================================
+    // 3. Blocked Tasks
+    // ========================================================================
+    const blockedTasks = [];
+    // Tasks with blocked status
+    for (const task of allTasks) {
+        if (task.status === 'blocked') {
+            const blockedBy = [];
+            if (task.blockedBy) {
+                blockedBy.push(task.blockedBy);
+            }
+            if (task.depends) {
+                for (const depId of task.depends) {
+                    const dep = taskMap.get(depId);
+                    if (dep && dep.status !== 'done' && dep.status !== 'cancelled') {
+                        blockedBy.push(depId);
+                    }
+                }
+            }
+            // Calculate how many tasks this blocks
+            let blocksCount = 0;
+            for (const t of allTasks) {
+                if (t.depends?.includes(task.id)) {
+                    blocksCount++;
+                }
+            }
+            blockedTasks.push({
+                id: task.id,
+                title: task.title,
+                blockedBy,
+                blocksCount,
+            });
+        }
+    }
+    // Tasks with unresolved dependencies (pending + has incomplete deps)
+    for (const task of allTasks) {
+        if (task.status === 'pending' && task.depends && task.depends.length > 0) {
+            const hasUnresolvedDeps = task.depends.some((depId) => {
+                const dep = taskMap.get(depId);
+                return dep && dep.status !== 'done' && dep.status !== 'cancelled';
+            });
+            if (hasUnresolvedDeps && !blockedTasks.some((b) => b.id === task.id)) {
+                const blockedBy = task.depends.filter((depId) => {
+                    const dep = taskMap.get(depId);
+                    return dep && dep.status !== 'done' && dep.status !== 'cancelled';
+                });
+                // Calculate how many tasks this blocks
+                let blocksCount = 0;
+                for (const t of allTasks) {
+                    if (t.depends?.includes(task.id)) {
+                        blocksCount++;
+                    }
+                }
+                blockedTasks.push({
+                    id: task.id,
+                    title: task.title,
+                    blockedBy,
+                    blocksCount,
+                });
+            }
+        }
+    }
+    // ========================================================================
+    // 4. Open Bugs (origin:bug-report OR label:bug)
+    // ========================================================================
+    const openBugs = [];
+    for (const task of allTasks) {
+        const isBug = task.origin === 'bug-report' || task.labels?.includes('bug');
+        const isOpen = task.status !== 'done' && task.status !== 'cancelled';
+        if (isBug && isOpen) {
+            const epicId = findEpicId(task, taskMap);
+            openBugs.push({
+                id: task.id,
+                title: task.title,
+                priority: task.priority,
+                epicId,
+            });
+        }
+    }
+    // ========================================================================
+    // 5. Metrics
+    // ========================================================================
+    const epics = allTasks.filter((t) => t.type === 'epic');
+    const activeEpics = epics.filter((t) => t.status === 'active').length;
+    const actionable = allTasks.filter((t) => (t.status === 'pending' || t.status === 'active') && !blockedTasks.some((b) => b.id === t.id)).length;
+    const blocked = blockedTasks.length;
+    // Calculate average leverage across all tasks
+    let totalLeverage = 0;
+    for (const task of allTasks) {
+        totalLeverage += calculateLeverage(task.id, taskMap);
+    }
+    const avgLeverage = allTasks.length > 0 ? Math.round((totalLeverage / allTasks.length) * 100) / 100 : 0;
+    const metrics = {
+        totalEpics: epics.length,
+        activeEpics,
+        totalTasks: allTasks.length,
+        actionable,
+        blocked,
+        openBugs: openBugs.length,
+        avgLeverage,
+    };
+    return {
+        inProgress: inProgressEpics,
+        ready: readyTasks,
+        blocked: blockedTasks,
+        openBugs,
+        metrics,
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/tasks/plan.js.map

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

package/dist/tasks/relates.js

@@ -0,0 +1,89 @@
+/**
+ * Task relationship management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getAccessor } from '../store/data-accessor.js';
+/** Suggest related tasks based on shared attributes. */
+export async function suggestRelated(taskId, opts, accessor) {
+    const acc = accessor ?? (await getAccessor(opts.cwd));
+    const { tasks: allTasks } = await acc.queryTasks({});
+    const task = allTasks.find((t) => t.id === taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found`);
+    }
+    const suggestions = [];
+    for (const other of allTasks) {
+        if (other.id === taskId)
+            continue;
+        let score = 0;
+        const reasons = [];
+        // Shared labels
+        const sharedLabels = (task.labels ?? []).filter((l) => (other.labels ?? []).includes(l));
+        if (sharedLabels.length > 0) {
+            score += sharedLabels.length * 20;
+            reasons.push(`Shared labels: ${sharedLabels.join(', ')}`);
+        }
+        // Same phase
+        if (task.phase && task.phase === other.phase) {
+            score += 15;
+            reasons.push(`Same phase: ${task.phase}`);
+        }
+        // Same parent
+        if (task.parentId && task.parentId === other.parentId) {
+            score += 25;
+            reasons.push('Same parent');
+        }
+        const threshold = opts.threshold ?? 50;
+        if (score >= threshold) {
+            suggestions.push({
+                id: other.id,
+                title: other.title,
+                score: Math.min(score, 100),
+                reason: reasons.join('; '),
+            });
+        }
+    }
+    return {
+        taskId,
+        suggestions: suggestions.sort((a, b) => b.score - a.score).slice(0, 10),
+        count: suggestions.length,
+    };
+}
+/** Add a relation between tasks. */
+export async function addRelation(from, to, type, reason, cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const fromExists = await acc.taskExists(from);
+    if (!fromExists) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${from} not found`);
+    }
+    const toExists = await acc.taskExists(to);
+    if (!toExists) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${to} not found`);
+    }
+    // Persist to task_relations table via accessor (T5168 fix)
+    await acc.addRelation(from, to, type, reason);
+    return { from, to, type, reason, added: true };
+}
+/** Discover related tasks using various methods. */
+export async function discoverRelated(taskId, cwd, accessor) {
+    return suggestRelated(taskId, { threshold: 30, cwd }, accessor);
+}
+/** List existing relations for a task. */
+export async function listRelations(taskId, cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const task = await acc.loadSingleTask(taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found`);
+    }
+    // task.relates is populated from task_relations table by loadSingleTask
+    const relates = task.relates ?? [];
+    return {
+        taskId,
+        relations: relates,
+        count: relates.length,
+    };
+}
+//# sourceMappingURL=relates.js.map

package/dist/tasks/relates.js.map

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

package/dist/tasks/reparent.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Canonical reparent logic — move a task to a different parent in the hierarchy.
+ * Both CLI (reparent command) and core (updateTask) delegate here.
+ *
+ * This module operates on an in-memory TaskFile. The caller is responsible
+ * for loading and saving the data (via DataAccessor or direct JSON I/O).
+ *
+ * @task T4807
+ * @epic T4454
+ */
+import type { TaskFile } from '@cleocode/contracts';
+import type { HierarchyPolicy } from './hierarchy-policy.js';
+/** Options for reparenting a task. */
+export interface ReparentOptions {
+    taskId: string;
+    /** New parent ID, or null to promote to root. */
+    newParentId: string | null;
+    /** Optional resolved hierarchy policy. If not provided, uses llm-agent-first defaults. */
+    policy?: HierarchyPolicy;
+}
+/** Result of a reparent operation. */
+export interface ReparentResult {
+    oldParent: string | null;
+    newParent: string | null;
+    newType: string;
+}
+/**
+ * Reparent a task within a TaskFile.
+ *
+ * Mutates the task in-place within `data.tasks`. Updates `parentId`, `type`,
+ * and `updatedAt` on the target task, and `lastUpdated` on the TaskFile.
+ *
+ * @param data  The loaded TaskFile (mutated in place)
+ * @param opts  Reparent options (taskId, newParentId)
+ * @returns     Result with old/new parent and new type
+ */
+export declare function reparentTask(data: TaskFile, opts: ReparentOptions): Promise<ReparentResult>;
+//# sourceMappingURL=reparent.d.ts.map

package/dist/tasks/reparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reparent.d.ts","sourceRoot":"","sources":["../../src/tasks/reparent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAwFjG"}

package/dist/tasks/show.js

@@ -0,0 +1,78 @@
+/**
+ * Show full task details by ID.
+ * @task T4460
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getAccessor } from '../store/data-accessor.js';
+/**
+ * Get a task by ID with enriched details.
+ * Checks active tasks first, then archive if not found.
+ * @task T4460
+ */
+export async function showTask(taskId, cwd, accessor) {
+    if (!taskId) {
+        throw new CleoError(ExitCode.INVALID_INPUT, 'Task ID is required');
+    }
+    const acc = accessor ?? (await getAccessor(cwd));
+    // First, try to find in active tasks via targeted query
+    let task = await acc.loadSingleTask(taskId);
+    let isArchived = false;
+    // If not found in active tasks, check the archive
+    if (!task) {
+        const archive = await acc.loadArchive();
+        if (archive) {
+            task = archive.archivedTasks.find((t) => t.id === taskId) ?? null;
+            if (task) {
+                isArchived = true;
+            }
+        }
+    }
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task not found: ${taskId}`, {
+            fix: `Use 'cleo find "${taskId}"' to search for similar IDs`,
+            alternatives: [
+                { action: 'Search for task', command: `cleo find "${taskId}"` },
+                { action: 'List all tasks', command: 'cleo list' },
+            ],
+        });
+    }
+    const detail = { ...task, isArchived };
+    // Add children (only check active tasks, archived tasks don't have active children)
+    if (!isArchived) {
+        const children = await acc.getChildren(taskId);
+        if (children.length > 0) {
+            detail.children = children.map((c) => c.id);
+        }
+        // Add dependency status
+        if (task.depends?.length) {
+            const depTasks = await acc.loadTasks(task.depends);
+            detail.dependencyStatus = task.depends.map((depId) => {
+                const dep = depTasks.find((t) => t.id === depId);
+                return {
+                    id: depId,
+                    status: dep?.status ?? 'unknown',
+                    title: dep?.title ?? 'Unknown task',
+                };
+            });
+            // Add unresolvedDeps: only unresolved dependencies (not done/cancelled)
+            const unresolved = detail.dependencyStatus.filter((d) => d.status !== 'done' && d.status !== 'cancelled');
+            if (unresolved.length > 0) {
+                detail.unresolvedDeps = unresolved;
+            }
+        }
+        // Add dependents: tasks that depend on this one
+        const dependentTasks = await acc.getDependents(taskId);
+        if (dependentTasks.length > 0) {
+            detail.dependents = dependentTasks.map((t) => t.id);
+        }
+        // Build hierarchy path via recursive ancestor chain (root-first, then append self)
+        const ancestors = await acc.getAncestorChain(taskId);
+        if (ancestors.length > 0) {
+            detail.hierarchyPath = [...ancestors.map((t) => t.id), taskId];
+        }
+    }
+    return detail;
+}
+//# sourceMappingURL=show.js.map

package/dist/tasks/show.js.map

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

package/dist/tasks/size-weighting.js

@@ -0,0 +1,86 @@
+/**
+ * Task size weighting and priority scoring.
+ * Ported from lib/tasks/size-weighting.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+/** Size weight multipliers. */
+const SIZE_WEIGHTS = {
+    small: 1,
+    medium: 3,
+    large: 8,
+};
+/** Priority weight multipliers. */
+const PRIORITY_WEIGHTS = {
+    critical: 10,
+    high: 5,
+    medium: 2,
+    low: 1,
+};
+/**
+ * Get weight for a task size.
+ */
+export function getSizeWeight(size) {
+    return SIZE_WEIGHTS[size ?? 'medium'] ?? SIZE_WEIGHTS.medium;
+}
+/**
+ * Get weight for a task priority.
+ */
+export function getPriorityWeight(priority) {
+    return PRIORITY_WEIGHTS[priority] ?? PRIORITY_WEIGHTS.medium;
+}
+/**
+ * Calculate a composite score for task ordering.
+ * Higher score = should be worked on first.
+ */
+export function calculateTaskScore(task) {
+    const sizeW = getSizeWeight(task.size);
+    const priorityW = getPriorityWeight(task.priority);
+    // Base score from priority (dominant factor)
+    let score = priorityW * 10;
+    // Bonus for smaller tasks (quick wins with same priority)
+    score += (8 - sizeW) * 2;
+    // Active status bonus
+    if (task.status === 'active')
+        score += 50;
+    // Blocked penalty
+    if (task.status === 'blocked')
+        score -= 20;
+    return score;
+}
+/**
+ * Sort tasks by weighted score (highest first).
+ */
+export function sortByWeight(tasks) {
+    return [...tasks].sort((a, b) => calculateTaskScore(b) - calculateTaskScore(a));
+}
+/**
+ * Calculate total weighted effort for a set of tasks.
+ */
+export function calculateTotalEffort(tasks) {
+    return tasks.reduce((total, t) => total + getSizeWeight(t.size), 0);
+}
+/**
+ * Calculate completion percentage by weight.
+ */
+export function calculateWeightedProgress(tasks) {
+    if (tasks.length === 0)
+        return 0;
+    const total = calculateTotalEffort(tasks);
+    if (total === 0)
+        return 0;
+    const completed = tasks
+        .filter((t) => t.status === 'done' || t.status === 'cancelled')
+        .reduce((sum, t) => sum + getSizeWeight(t.size), 0);
+    return Math.round((completed / total) * 100);
+}
+/**
+ * Estimate remaining effort (weighted sum of non-complete tasks).
+ */
+export function calculateRemainingEffort(tasks) {
+    return tasks
+        .filter((t) => t.status !== 'done' && t.status !== 'cancelled')
+        .reduce((sum, t) => sum + getSizeWeight(t.size), 0);
+}
+//# sourceMappingURL=size-weighting.js.map

package/dist/tasks/size-weighting.js.map

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