@cleocode/core 2.0.0

package/dist/tasks/relates.js

@@ -0,0 +1,89 @@
+/**
+ * Task relationship management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { getAccessor } from '../store/data-accessor.js';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.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;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,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/reparent.js

@@ -0,0 +1,90 @@
+/**
+ * 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 { ExitCode } from '@cleocode/contracts';
+import { loadConfig } from '../config.js';
+import { CleoError } from '../errors.js';
+import { getDepth, wouldCreateCircle } from './hierarchy.js';
+import { resolveHierarchyPolicy, validateHierarchyPlacement } from './hierarchy-policy.js';
+/**
+ * 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 async function reparentTask(data, opts) {
+    const { taskId, newParentId } = opts;
+    const task = data.tasks.find((t) => t.id === taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task not found: ${taskId}`, {
+            fix: `Use 'cleo find "${taskId}"' to search`,
+        });
+    }
+    const oldParent = task.parentId ?? null;
+    const effectiveNewParent = newParentId || null;
+    // Promote to root
+    if (!effectiveNewParent) {
+        task.parentId = null;
+        if (task.type === 'subtask') {
+            task.type = 'task';
+        }
+        task.updatedAt = new Date().toISOString();
+        data.lastUpdated = new Date().toISOString();
+        return {
+            oldParent,
+            newParent: null,
+            newType: task.type ?? 'task',
+        };
+    }
+    // Validate target parent exists and hierarchy constraints (depth + sibling limits)
+    const effectivePolicy = opts.policy ?? resolveHierarchyPolicy(await loadConfig());
+    const validation = validateHierarchyPlacement(effectiveNewParent, data.tasks, effectivePolicy);
+    if (!validation.valid) {
+        const code = validation.error?.code === 'E_PARENT_NOT_FOUND'
+            ? ExitCode.PARENT_NOT_FOUND
+            : validation.error?.code === 'E_DEPTH_EXCEEDED'
+                ? ExitCode.DEPTH_EXCEEDED
+                : validation.error?.code === 'E_SIBLING_LIMIT'
+                    ? ExitCode.SIBLING_LIMIT
+                    : ExitCode.INVALID_INPUT;
+        throw new CleoError(code, validation.error?.message ?? `Cannot reparent under ${effectiveNewParent}`, { fix: `Check hierarchy constraints with 'cleo show ${effectiveNewParent}'` });
+    }
+    const newParentTask = data.tasks.find((t) => t.id === effectiveNewParent);
+    // Cannot parent under a subtask
+    if (newParentTask?.type === 'subtask') {
+        throw new CleoError(ExitCode.INVALID_PARENT_TYPE, `Cannot parent under subtask '${effectiveNewParent}'`, { fix: `Choose a task or epic as the parent instead` });
+    }
+    // Check circular reference
+    if (wouldCreateCircle(taskId, effectiveNewParent, data.tasks)) {
+        throw new CleoError(ExitCode.CIRCULAR_REFERENCE, `Moving '${taskId}' under '${effectiveNewParent}' would create a circular reference`, { fix: `The target parent is a descendant of the task being moved` });
+    }
+    // Apply the reparent
+    task.parentId = effectiveNewParent;
+    // Update type based on new depth in the hierarchy
+    const newDepth = getDepth(taskId, data.tasks);
+    if (newDepth === 1) {
+        task.type = 'task';
+    }
+    else if (newDepth >= 2) {
+        task.type = 'subtask';
+    }
+    task.updatedAt = new Date().toISOString();
+    data.lastUpdated = new Date().toISOString();
+    return {
+        oldParent,
+        newParent: effectiveNewParent,
+        newType: task.type ?? 'task',
+    };
+}
+//# sourceMappingURL=reparent.js.map

package/dist/tasks/reparent.js.map

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

package/dist/tasks/show.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Show full task details by ID.
+ * @task T4460
+ * @epic T4454
+ */
+import type { DataAccessor } from '../store/data-accessor.js';
+import type { Task, TaskRef } from '@cleocode/contracts';
+/** Enriched task with hierarchy info. */
+export interface TaskDetail extends Task {
+    children?: string[];
+    dependencyStatus?: TaskRef[];
+    unresolvedDeps?: TaskRef[];
+    dependents?: 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/tasks/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../src/tasks/show.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGzD,yCAAyC;AACzC,MAAM,WAAW,UAAW,SAAQ,IAAI;IACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,UAAU,CAAC,CA4ErB"}

package/dist/tasks/show.js

@@ -0,0 +1,78 @@
+/**
+ * Show full task details by ID.
+ * @task T4460
+ * @epic T4454
+ */
+import { getAccessor } from '../store/data-accessor.js';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.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.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, TaskPriority, TaskSize } from '@cleocode/contracts';
+/**
+ * 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/tasks/size-weighting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-weighting.d.ts","sourceRoot":"","sources":["../../src/tasks/size-weighting.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,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/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":"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/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 '@cleocode/contracts';
+/** 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/tasks/staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.d.ts","sourceRoot":"","sources":["../../src/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,CAQlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,EACV,UAAU,GAAE,mBAAwC,GACnD,cAAc,CAWhB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAQ5F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,CAAC,EAAE,mBAAmB,GAAG,aAAa,EAAE,CAM/F;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,CAiBlB"}

package/dist/tasks/staleness.js

@@ -0,0 +1,86 @@
+/**
+ * Task staleness detection - identify tasks that haven't been updated.
+ * Ported from lib/tasks/staleness.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+/** Default thresholds. */
+export const DEFAULT_THRESHOLDS = {
+    stale: 7,
+    critical: 14,
+    abandoned: 30,
+};
+/**
+ * Calculate days since a date string (ISO format).
+ */
+function daysSince(dateStr) {
+    const date = new Date(dateStr);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+}
+/**
+ * Get the most recent activity timestamp for a task.
+ */
+export function getLastActivity(task) {
+    const dates = [task.updatedAt, task.createdAt, task.completedAt, task.cancelledAt].filter((d) => d != null && d !== '');
+    if (dates.length === 0)
+        return task.createdAt;
+    return dates.reduce((latest, d) => (new Date(d) > new Date(latest) ? d : latest));
+}
+/**
+ * Classify staleness level for a task.
+ */
+export function classifyStaleness(task, thresholds = DEFAULT_THRESHOLDS) {
+    // Completed/cancelled tasks are never stale
+    if (task.status === 'done' || task.status === 'cancelled')
+        return 'fresh';
+    const lastActivity = getLastActivity(task);
+    const days = daysSince(lastActivity);
+    if (days >= thresholds.abandoned)
+        return 'abandoned';
+    if (days >= thresholds.critical)
+        return 'critical';
+    if (days >= thresholds.stale)
+        return 'stale';
+    return 'fresh';
+}
+/**
+ * Get staleness info for a single task.
+ */
+export function getStalenessInfo(task, thresholds) {
+    const lastActivity = getLastActivity(task);
+    return {
+        taskId: task.id,
+        level: classifyStaleness(task, thresholds),
+        daysSinceUpdate: daysSince(lastActivity),
+        lastActivity,
+    };
+}
+/**
+ * Find all stale tasks (stale, critical, or abandoned).
+ */
+export function findStaleTasks(tasks, thresholds) {
+    return tasks
+        .filter((t) => t.status !== 'done' && t.status !== 'cancelled')
+        .map((t) => getStalenessInfo(t, thresholds))
+        .filter((info) => info.level !== 'fresh')
+        .sort((a, b) => b.daysSinceUpdate - a.daysSinceUpdate);
+}
+export function getStalenessSummary(tasks, thresholds) {
+    const activeTasks = tasks.filter((t) => t.status !== 'done' && t.status !== 'cancelled');
+    const summary = {
+        total: activeTasks.length,
+        fresh: 0,
+        stale: 0,
+        critical: 0,
+        abandoned: 0,
+    };
+    for (const task of activeTasks) {
+        const level = classifyStaleness(task, thresholds);
+        summary[level]++;
+    }
+    return summary;
+}
+//# sourceMappingURL=staleness.js.map

package/dist/tasks/staleness.js.map

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