@cleocode/core 2026.3.41 → 2026.3.43

package/dist/tasks/list.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Task listing with filters.
+ * @task T4460
+ * @epic T4454
+ */
+import type { Task, TaskPriority, TaskStatus, TaskType } from '@cleocode/contracts';
+import type { LAFSPage } from '@cleocode/lafs-protocol';
+import type { DataAccessor } from '../store/data-accessor.js';
+/** Compact task representation — minimal fields for MCP list responses. */
+export interface CompactTask {
+    id: string;
+    title: string;
+    status: string;
+    priority: string;
+    type?: string;
+    parentId?: string | null;
+}
+/** Convert a full Task to compact representation. */
+export declare function toCompact(task: Task): CompactTask;
+/** Filter options for listing tasks. */
+export interface ListTasksOptions {
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    type?: TaskType;
+    parentId?: string;
+    phase?: string;
+    label?: string;
+    children?: boolean;
+    limit?: number;
+    offset?: number;
+}
+/** Result of listing tasks. */
+export interface ListTasksResult {
+    tasks: Task[];
+    total: number;
+    filtered: number;
+    page: LAFSPage;
+    pagination?: {
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
+}
+/**
+ * List tasks with optional filtering and pagination.
+ * @task T4460
+ */
+export declare function listTasks(options?: ListTasksOptions, cwd?: string, accessor?: DataAccessor): Promise<ListTasksResult>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tasks/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,2BAA2B,CAAC;AAIhF,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CASjD;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,OAAO,GAAE,gBAAqB,EAC9B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,eAAe,CAAC,CA+C1B"}

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

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

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

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

package/dist/tasks/plan.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Composite planning view - aggregates multiple task queries for planning.
+ * @task T4914
+ * @epic T4454
+ */
+import type { Task } from '@cleocode/contracts';
+/** In-progress epic entry. */
+export interface InProgressEpic {
+    epicId: string;
+    epicTitle: string;
+    activeTasks: number;
+    completionPercent: number;
+}
+/** Ready task entry with leverage analysis. */
+export interface ReadyTask extends Pick<Task, 'id' | 'title' | 'priority'> {
+    epicId: string;
+    leverage: number;
+    score: number;
+    reasons: string[];
+}
+/** Blocked task entry. */
+export interface BlockedTask extends Pick<Task, 'id' | 'title'> {
+    blockedBy: string[];
+    blocksCount: number;
+}
+/** Open bug entry. */
+export interface OpenBug extends Pick<Task, 'id' | 'title' | 'priority'> {
+    epicId: string;
+}
+/** Planning metrics. */
+export interface PlanMetrics {
+    totalEpics: number;
+    activeEpics: number;
+    totalTasks: number;
+    actionable: number;
+    blocked: number;
+    openBugs: number;
+    avgLeverage: number;
+}
+/** Composite planning view result. */
+export interface PlanResult {
+    inProgress: InProgressEpic[];
+    ready: ReadyTask[];
+    blocked: BlockedTask[];
+    openBugs: OpenBug[];
+    metrics: PlanMetrics;
+}
+/**
+ * Build composite planning view.
+ * @task T4914
+ */
+export declare function coreTaskPlan(projectRoot: string): Promise<PlanResult>;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/tasks/plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAe,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAM7D,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,+CAA+C;AAC/C,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,GAAG,UAAU,CAAC;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,0BAA0B;AAC1B,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sBAAsB;AACtB,MAAM,WAAW,OAAQ,SAAQ,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,GAAG,UAAU,CAAC;IACtE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAwB;AACxB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;CACtB;AAkGD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA8M3E"}

package/dist/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/tasks/relates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relates.d.ts","sourceRoot":"","sources":["../../src/tasks/relates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,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,CAkDlC;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,CAiBlC;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,CAclC"}

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.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Show full task details by ID.
+ * @task T4460
+ * @epic T4454
+ */
+import type { Task, TaskRef } from '@cleocode/contracts';
+import type { DataAccessor } from '../store/data-accessor.js';
+/** 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,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,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/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/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"}