@cleocode/cleo 2026.2.5

package/dist/core/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/core/tasks/phase-tracking.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * Task relationship management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import type { DataAccessor } from '../../store/data-accessor.js';
+/** Suggest related tasks based on shared attributes. */
+export declare function suggestRelated(taskId: string, opts: {
+    threshold?: number;
+    cwd?: string;
+}, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+/** Add a relation between tasks. */
+export declare function addRelation(from: string, to: string, type: string, reason: string, cwd?: string, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+/** Discover related tasks using various methods. */
+export declare function discoverRelated(taskId: string, cwd?: string, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+/** List existing relations for a task. */
+export declare function listRelations(taskId: string, cwd?: string, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+//# sourceMappingURL=relates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relates.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/relates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAYjE,wDAAwD;AACxD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmDlC;AAED,oCAAoC;AACpC,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuClC;AAED,oDAAoD;AACpD,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAElC;AAED,0CAA0C;AAC1C,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgBlC"}

package/dist/core/tasks/relates.js

@@ -0,0 +1,115 @@
+/**
+ * Task relationship management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { readJsonRequired, saveJson, computeChecksum } from '../../store/json.js';
+import { getTaskPath, getBackupDir } from '../paths.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { safeSaveTaskFile, } from '../../store/data-safety-central.js';
+/** Suggest related tasks based on shared attributes. */
+export async function suggestRelated(taskId, opts, accessor) {
+    const data = accessor
+        ? await accessor.loadTaskFile()
+        : await readJsonRequired(getTaskPath(opts.cwd));
+    const task = data.tasks.find(t => t.id === taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found`);
+    }
+    const suggestions = [];
+    for (const other of data.tasks) {
+        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 todoPath = getTaskPath(cwd);
+    const data = accessor
+        ? await accessor.loadTaskFile()
+        : await readJsonRequired(todoPath);
+    const fromTask = data.tasks.find(t => t.id === from);
+    if (!fromTask) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${from} not found`);
+    }
+    const toTask = data.tasks.find(t => t.id === to);
+    if (!toTask) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${to} not found`);
+    }
+    // The 'relates' field is an extension not in the base Task type
+    const taskAny = fromTask;
+    if (!taskAny.relates) {
+        taskAny.relates = [];
+    }
+    const relates = taskAny.relates;
+    relates.push({
+        targetId: to,
+        type,
+        reason,
+        addedAt: new Date().toISOString(),
+    });
+    data.lastUpdated = new Date().toISOString();
+    data._meta.checksum = computeChecksum(data.tasks);
+    if (accessor) {
+        await safeSaveTaskFile(accessor, data, cwd);
+    }
+    else {
+        await saveJson(todoPath, data, { backupDir: getBackupDir(cwd) });
+    }
+    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 data = accessor
+        ? await accessor.loadTaskFile()
+        : await readJsonRequired(getTaskPath(cwd));
+    const task = data.tasks.find(t => t.id === taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found`);
+    }
+    const taskAny = task;
+    const relates = taskAny.relates ?? [];
+    return {
+        taskId,
+        relations: relates,
+        count: relates.length,
+    };
+}
+//# sourceMappingURL=relates.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relates.js","sourceRoot":"","sources":["../../../src/core/tasks/relates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,EACL,gBAAgB,GACjB,MAAM,oCAAoC,CAAC;AAS5C,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,IAA0C,EAC1C,QAAuB;IAEvB,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,gBAAgB,CAAW,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,MAAM,YAAY,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,WAAW,GAAwE,EAAE,CAAC;IAE5F,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM;YAAE,SAAS;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,gBAAgB;QAChB,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,IAAI,YAAY,CAAC,MAAM,GAAG,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,kBAAkB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,aAAa;QACb,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;YAC7C,KAAK,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,cAAc;QACd,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtD,KAAK,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;QACvC,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;YACvB,WAAW,CAAC,IAAI,CAAC;gBACf,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;gBAC3B,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM;QACN,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACvE,KAAK,EAAE,WAAW,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,EAAU,EACV,IAAY,EACZ,MAAc,EACd,GAAY,EACZ,QAAuB;IAEvB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,gBAAgB,CAAW,QAAQ,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,IAAI,YAAY,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAClE,CAAC;IAED,gEAAgE;IAChE,MAAM,OAAO,GAAG,QAA8C,CAAC;IAC/D,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAqB,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC;QACX,QAAQ,EAAE,EAAE;QACZ,IAAI;QACJ,MAAM;QACN,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAClC,CAAC,CAAC;IAEH,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,GAAY,EACZ,QAAuB;IAEvB,OAAO,cAAc,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,GAAY,EACZ,QAAuB;IAEvB,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,gBAAgB,CAAW,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,MAAM,YAAY,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,OAAO,GAAG,IAA0C,CAAC;IAC3D,MAAM,OAAO,GAAI,OAAO,CAAC,OAAsB,IAAI,EAAE,CAAC;IACtD,OAAO;QACL,MAAM;QACN,SAAS,EAAE,OAAO;QAClB,KAAK,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Show full task details by ID.
+ * @task T4460
+ * @epic T4454
+ */
+import type { Task } from '../../types/task.js';
+import type { DataAccessor } from '../../store/data-accessor.js';
+/** Enriched task with hierarchy info. */
+export interface TaskDetail extends Task {
+    children?: string[];
+    dependencyStatus?: Array<{
+        id: string;
+        status: string;
+        title: string;
+    }>;
+    hierarchyPath?: string[];
+    isArchived?: boolean;
+}
+/**
+ * Get a task by ID with enriched details.
+ * Checks active tasks first, then archive if not found.
+ * @task T4460
+ */
+export declare function showTask(taskId: string, cwd?: string, accessor?: DataAccessor): Promise<TaskDetail>;
+//# sourceMappingURL=show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/show.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,yCAAyC;AACzC,MAAM,WAAW,UAAW,SAAQ,IAAI;IACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CA4EzG"}

package/dist/core/tasks/show.js

@@ -0,0 +1,79 @@
+/**
+ * Show full task details by ID.
+ * @task T4460
+ * @epic T4454
+ */
+import { readJsonRequired } from '../../store/json.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getTaskPath } from '../paths.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 taskPath = getTaskPath(cwd);
+    const data = accessor
+        ? await accessor.loadTaskFile()
+        : await readJsonRequired(taskPath);
+    // First, try to find in active tasks
+    let task = data.tasks.find(t => t.id === taskId);
+    let isArchived = false;
+    // If not found in active tasks, check the archive
+    if (!task && accessor) {
+        const archive = await accessor.loadArchive();
+        if (archive) {
+            task = archive.archivedTasks.find(t => t.id === taskId);
+            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 = data.tasks.filter(t => t.parentId === taskId);
+        if (children.length > 0) {
+            detail.children = children.map(c => c.id);
+        }
+        // Add dependency status
+        if (task.depends?.length) {
+            detail.dependencyStatus = task.depends.map(depId => {
+                const dep = data.tasks.find(t => t.id === depId);
+                return {
+                    id: depId,
+                    status: dep?.status ?? 'unknown',
+                    title: dep?.title ?? 'Unknown task',
+                };
+            });
+        }
+        // Build hierarchy path
+        const path = [taskId];
+        let currentId = task.parentId;
+        const visited = new Set();
+        while (currentId && !visited.has(currentId)) {
+            visited.add(currentId);
+            path.unshift(currentId);
+            const parent = data.tasks.find(t => t.id === currentId);
+            currentId = parent?.parentId;
+        }
+        if (path.length > 1) {
+            detail.hierarchyPath = path;
+        }
+    }
+    return detail;
+}
+//# sourceMappingURL=show.js.map

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

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

package/dist/core/tasks/size-weighting.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Task size weighting and priority scoring.
+ * Ported from lib/tasks/size-weighting.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+import type { Task, TaskSize, TaskPriority } from '../../types/task.js';
+/**
+ * Get weight for a task size.
+ */
+export declare function getSizeWeight(size: TaskSize | null | undefined): number;
+/**
+ * Get weight for a task priority.
+ */
+export declare function getPriorityWeight(priority: TaskPriority): number;
+/**
+ * Calculate a composite score for task ordering.
+ * Higher score = should be worked on first.
+ */
+export declare function calculateTaskScore(task: Task): number;
+/**
+ * Sort tasks by weighted score (highest first).
+ */
+export declare function sortByWeight(tasks: Task[]): Task[];
+/**
+ * Calculate total weighted effort for a set of tasks.
+ */
+export declare function calculateTotalEffort(tasks: Task[]): number;
+/**
+ * Calculate completion percentage by weight.
+ */
+export declare function calculateWeightedProgress(tasks: Task[]): number;
+/**
+ * Estimate remaining effort (weighted sum of non-complete tasks).
+ */
+export declare function calculateRemainingEffort(tasks: Task[]): number;
+//# sourceMappingURL=size-weighting.d.ts.map

package/dist/core/tasks/size-weighting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-weighting.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/size-weighting.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiBxE;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAiBrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAElD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAW/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAI9D"}

package/dist/core/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/core/tasks/size-weighting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-weighting.js","sourceRoot":"","sources":["../../../src/core/tasks/size-weighting.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,+BAA+B;AAC/B,MAAM,YAAY,GAA6B;IAC7C,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,mCAAmC;AACnC,MAAM,gBAAgB,GAAiC;IACrD,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;CACP,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAiC;IAC7D,OAAO,YAAY,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAU;IAC3C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEnD,6CAA6C;IAC7C,IAAI,KAAK,GAAG,SAAS,GAAG,EAAE,CAAC;IAE3B,0DAA0D;IAC1D,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAEzB,sBAAsB;IACtB,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,KAAK,IAAI,EAAE,CAAC;IAE1C,kBAAkB;IAClB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,IAAI,EAAE,CAAC;IAE3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,KAAK;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;SAC9D,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;SAC9D,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * Task staleness detection - identify tasks that haven't been updated.
+ * Ported from lib/tasks/staleness.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+import type { Task } from '../../types/task.js';
+/** Staleness thresholds in days. */
+export interface StalenessThresholds {
+    /** Days before a task is considered stale. */
+    stale: number;
+    /** Days before a task is critically stale. */
+    critical: number;
+    /** Days before a task is considered abandoned. */
+    abandoned: number;
+}
+/** Default thresholds. */
+export declare const DEFAULT_THRESHOLDS: StalenessThresholds;
+/** Staleness classification. */
+export type StalenessLevel = 'fresh' | 'stale' | 'critical' | 'abandoned';
+/** Staleness assessment for a single task. */
+export interface StalenessInfo {
+    taskId: string;
+    level: StalenessLevel;
+    daysSinceUpdate: number;
+    lastActivity: string;
+}
+/**
+ * Get the most recent activity timestamp for a task.
+ */
+export declare function getLastActivity(task: Task): string;
+/**
+ * Classify staleness level for a task.
+ */
+export declare function classifyStaleness(task: Task, thresholds?: StalenessThresholds): StalenessLevel;
+/**
+ * Get staleness info for a single task.
+ */
+export declare function getStalenessInfo(task: Task, thresholds?: StalenessThresholds): StalenessInfo;
+/**
+ * Find all stale tasks (stale, critical, or abandoned).
+ */
+export declare function findStaleTasks(tasks: Task[], thresholds?: StalenessThresholds): StalenessInfo[];
+/**
+ * Get staleness summary statistics.
+ */
+export interface StalenessSummary {
+    total: number;
+    fresh: number;
+    stale: number;
+    critical: number;
+    abandoned: number;
+}
+export declare function getStalenessSummary(tasks: Task[], thresholds?: StalenessThresholds): StalenessSummary;
+//# sourceMappingURL=staleness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/staleness.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,oCAAoC;AACpC,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,EAAE,mBAIhC,CAAC;AAEF,gCAAgC;AAChC,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAE1E,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAalD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,EACV,UAAU,GAAE,mBAAwC,GACnD,cAAc,CAWhB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,UAAU,CAAC,EAAE,mBAAmB,GAC/B,aAAa,CAQf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,EAAE,EACb,UAAU,CAAC,EAAE,mBAAmB,GAC/B,aAAa,EAAE,CAMjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,EAAE,EACb,UAAU,CAAC,EAAE,mBAAmB,GAC/B,gBAAgB,CAmBlB"}