@cleocode/core 2026.3.76 → 2026.4.0

package/dist/tasks/dependency-check.js

@@ -0,0 +1,278 @@
+/**
+ * Dependency checking - validate task dependency graphs.
+ * Ported from lib/tasks/dependency-check.sh
+ *
+ * @epic T4454
+ * @task T4529
+ */
+/**
+ * Detect circular dependencies using DFS.
+ * Returns the cycle path if found, empty array otherwise.
+ */
+export function detectCircularDeps(taskId, tasks) {
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    const visited = new Set();
+    const recursionStack = new Set();
+    const path = [];
+    function dfs(id) {
+        visited.add(id);
+        recursionStack.add(id);
+        path.push(id);
+        const task = taskMap.get(id);
+        if (task?.depends) {
+            for (const depId of task.depends) {
+                if (!visited.has(depId)) {
+                    const cycle = dfs(depId);
+                    if (cycle.length > 0)
+                        return cycle;
+                }
+                else if (recursionStack.has(depId)) {
+                    // Found cycle - return path from depId to current + depId
+                    const cycleStart = path.indexOf(depId);
+                    return [...path.slice(cycleStart), depId];
+                }
+            }
+        }
+        path.pop();
+        recursionStack.delete(id);
+        return [];
+    }
+    return dfs(taskId);
+}
+/**
+ * Check if adding a dependency would create a cycle.
+ */
+export function wouldCreateCycle(fromId, toId, tasks) {
+    // Temporarily add the dependency and check
+    const modified = tasks.map((t) => {
+        if (t.id === fromId) {
+            return { ...t, depends: [...(t.depends ?? []), toId] };
+        }
+        return t;
+    });
+    return detectCircularDeps(fromId, modified).length > 0;
+}
+/**
+ * Get tasks that are blocked (have unmet dependencies).
+ */
+export function getBlockedTasks(tasks) {
+    const completedIds = new Set(tasks.filter((t) => t.status === 'done' || t.status === 'cancelled').map((t) => t.id));
+    return tasks.filter((t) => {
+        if (!t.depends?.length)
+            return false;
+        if (t.status === 'done' || t.status === 'cancelled')
+            return false;
+        return t.depends.some((depId) => !completedIds.has(depId));
+    });
+}
+/**
+ * Get tasks that are ready (all dependencies met).
+ */
+export function getReadyTasks(tasks) {
+    const completedIds = new Set(tasks.filter((t) => t.status === 'done' || t.status === 'cancelled').map((t) => t.id));
+    return tasks.filter((t) => {
+        if (t.status === 'done' || t.status === 'cancelled')
+            return false;
+        if (!t.depends?.length)
+            return true;
+        return t.depends.every((depId) => completedIds.has(depId));
+    });
+}
+/**
+ * Get tasks that depend on a given task.
+ */
+export function getDependents(taskId, tasks) {
+    return tasks.filter((t) => t.depends?.includes(taskId));
+}
+/**
+ * Get dependent IDs.
+ */
+export function getDependentIds(taskId, tasks) {
+    return getDependents(taskId, tasks).map((t) => t.id);
+}
+/**
+ * Get unresolved dependencies for a task (deps that are not done/cancelled).
+ */
+export function getUnresolvedDeps(taskId, tasks) {
+    const task = tasks.find((t) => t.id === taskId);
+    if (!task?.depends?.length)
+        return [];
+    const completedIds = new Set(tasks.filter((t) => t.status === 'done' || t.status === 'cancelled').map((t) => t.id));
+    return task.depends.filter((depId) => !completedIds.has(depId));
+}
+/**
+ * Validate dependencies for missing references.
+ */
+export function validateDependencyRefs(tasks) {
+    const taskIds = new Set(tasks.map((t) => t.id));
+    const errors = [];
+    for (const task of tasks) {
+        if (!task.depends?.length)
+            continue;
+        for (const depId of task.depends) {
+            if (!taskIds.has(depId)) {
+                errors.push({
+                    code: 'E_DEP_NOT_FOUND',
+                    taskId: task.id,
+                    message: `Task ${task.id} depends on ${depId}, which does not exist`,
+                    relatedIds: [depId],
+                });
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Full dependency graph validation.
+ */
+export function validateDependencies(tasks) {
+    const errors = [];
+    const warnings = [];
+    // Check for missing references
+    errors.push(...validateDependencyRefs(tasks));
+    // Check for circular dependencies
+    const visited = new Set();
+    for (const task of tasks) {
+        if (visited.has(task.id))
+            continue;
+        if (!task.depends?.length)
+            continue;
+        const cycle = detectCircularDeps(task.id, tasks);
+        if (cycle.length > 0) {
+            errors.push({
+                code: 'E_CIRCULAR_DEP',
+                taskId: task.id,
+                message: `Circular dependency detected: ${cycle.join(' -> ')}`,
+                relatedIds: cycle,
+            });
+            // Mark all in cycle as visited to avoid duplicate reports
+            for (const id of cycle) {
+                visited.add(id);
+            }
+        }
+    }
+    // Check for self-dependencies
+    for (const task of tasks) {
+        if (task.depends?.includes(task.id)) {
+            errors.push({
+                code: 'E_SELF_DEP',
+                taskId: task.id,
+                message: `Task ${task.id} depends on itself`,
+            });
+        }
+    }
+    // Warn about completed tasks with unmet dependencies
+    for (const task of tasks) {
+        if (task.status === 'done' && task.depends?.length) {
+            const unresolved = getUnresolvedDeps(task.id, tasks);
+            if (unresolved.length > 0) {
+                warnings.push({
+                    code: 'W_COMPLETED_WITH_UNMET_DEPS',
+                    taskId: task.id,
+                    message: `Completed task ${task.id} has unmet dependencies: ${unresolved.join(', ')}`,
+                });
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Topological sort of tasks by dependencies.
+ * Returns sorted task IDs or null if cycle detected.
+ */
+export function topologicalSort(tasks) {
+    const inDegree = new Map();
+    const adjList = new Map();
+    // Initialize
+    for (const task of tasks) {
+        inDegree.set(task.id, 0);
+        adjList.set(task.id, []);
+    }
+    // Build adjacency list (dependency -> dependent)
+    for (const task of tasks) {
+        if (!task.depends?.length)
+            continue;
+        for (const depId of task.depends) {
+            if (adjList.has(depId)) {
+                adjList.get(depId).push(task.id);
+                inDegree.set(task.id, (inDegree.get(task.id) ?? 0) + 1);
+            }
+        }
+    }
+    // Kahn's algorithm
+    const queue = [];
+    for (const [id, degree] of inDegree) {
+        if (degree === 0)
+            queue.push(id);
+    }
+    const sorted = [];
+    while (queue.length > 0) {
+        const id = queue.shift();
+        sorted.push(id);
+        for (const dependent of adjList.get(id) ?? []) {
+            const newDegree = (inDegree.get(dependent) ?? 1) - 1;
+            inDegree.set(dependent, newDegree);
+            if (newDegree === 0)
+                queue.push(dependent);
+        }
+    }
+    // If not all tasks sorted, there's a cycle
+    if (sorted.length !== tasks.length)
+        return null;
+    return sorted;
+}
+/**
+ * Walk upstream recursively through a task's dependency chain.
+ * Returns all non-done/non-cancelled dependency IDs (deduplicated).
+ * Uses a visited set for cycle protection.
+ */
+export function getTransitiveBlockers(taskId, tasks) {
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    const task = taskMap.get(taskId);
+    if (!task?.depends?.length)
+        return [];
+    const blockers = new Set();
+    const visited = new Set();
+    function walk(id) {
+        if (visited.has(id))
+            return;
+        visited.add(id);
+        const t = taskMap.get(id);
+        if (!t?.depends?.length)
+            return;
+        for (const depId of t.depends) {
+            const dep = taskMap.get(depId);
+            if (!dep)
+                continue;
+            if (dep.status === 'done' || dep.status === 'cancelled')
+                continue;
+            blockers.add(depId);
+            walk(depId);
+        }
+    }
+    walk(taskId);
+    return [...blockers];
+}
+/**
+ * From the transitive blockers, return only "leaf" blockers — those whose
+ * own dependencies are all resolved (done/cancelled) or that have no
+ * dependencies at all. These are the root-cause tasks that need action first.
+ */
+export function getLeafBlockers(taskId, tasks) {
+    const blockerIds = getTransitiveBlockers(taskId, tasks);
+    if (blockerIds.length === 0)
+        return [];
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    const completedIds = new Set(tasks.filter((t) => t.status === 'done' || t.status === 'cancelled').map((t) => t.id));
+    return blockerIds.filter((id) => {
+        const t = taskMap.get(id);
+        if (!t?.depends?.length)
+            return true;
+        return t.depends.every((depId) => completedIds.has(depId));
+    });
+}
+//# sourceMappingURL=dependency-check.js.map

package/dist/tasks/dependency-check.js.map

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

package/dist/tasks/deps-ready.js

@@ -0,0 +1,32 @@
+/**
+ * Shared dependency-readiness check.
+ *
+ * Used by plan, task-ops, and briefing modules to determine
+ * if a task's dependencies are all satisfied.
+ *
+ * Accepts a loosely-typed map (including Map<string, unknown>) so all
+ * consumers can use it without unsafe casts.
+ *
+ * @epic T4454
+ */
+/** Completed/cancelled statuses that satisfy dependencies. */
+const SATISFIED_STATUSES = new Set(['done', 'cancelled']);
+/**
+ * Check if all dependencies of a task are satisfied.
+ *
+ * @param depends - Array of dependency task IDs (may be undefined/empty)
+ * @param taskLookup - Map from task ID to a task-like object with at least { status: string }
+ * @returns true if all dependencies are done/cancelled, or if no dependencies exist
+ */
+export function depsReady(depends, taskLookup) {
+    if (!depends || depends.length === 0)
+        return true;
+    return depends.every((depId) => {
+        const dep = taskLookup.get(depId);
+        if (dep === undefined || dep === null || typeof dep !== 'object')
+            return false;
+        const status = dep.status;
+        return typeof status === 'string' && SATISFIED_STATUSES.has(status);
+    });
+}
+//# sourceMappingURL=deps-ready.js.map

package/dist/tasks/deps-ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps-ready.js","sourceRoot":"","sources":["../../src/tasks/deps-ready.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8DAA8D;AAC9D,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,OAA6B,EAC7B,UAA8D;IAE9D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC/E,MAAM,MAAM,GAAI,GAA2B,CAAC,MAAM,CAAC;QACnD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tasks/enforcement.js

@@ -0,0 +1,86 @@
+import { ExitCode } from '@cleocode/contracts';
+import { loadConfig } from '../config.js';
+function checkMin(criteria, min) {
+    return Array.isArray(criteria) && criteria.length >= min;
+}
+export async function createAcceptanceEnforcement(cwd) {
+    // In VITEST, default to 'off' when config is absent. Tests that need
+    // enforcement active write their own config, which overrides the default.
+    const isTest = !!process.env.VITEST;
+    const config = await loadConfig(cwd);
+    const acceptance = config.enforcement?.acceptance;
+    const mode = acceptance?.mode ?? (isTest ? 'off' : 'block');
+    const requiredForPriorities = acceptance?.requiredForPriorities ?? [
+        'critical',
+        'high',
+        'medium',
+        'low',
+    ];
+    const minCriteria = acceptance?.minimumCriteria ?? 3;
+    const defaultPriority = 'medium';
+    return {
+        checkMinimumCriteria: checkMin,
+        validateCreation(options) {
+            const priority = options.priority ?? defaultPriority;
+            if (mode === 'off')
+                return { valid: true };
+            if (requiredForPriorities.includes(priority)) {
+                const hasEnough = checkMin(options.acceptance ?? [], minCriteria);
+                if (!hasEnough) {
+                    const msg = `Task requires at least ${minCriteria} acceptance criteria (priority: ${priority})`;
+                    if (mode === 'block') {
+                        return {
+                            valid: false,
+                            error: msg,
+                            fix: `Add --acceptance "criterion 1" --acceptance "criterion 2" --acceptance "criterion 3"`,
+                            exitCode: ExitCode.VALIDATION_ERROR,
+                        };
+                    }
+                    else if (mode === 'warn') {
+                        return { valid: true, error: msg };
+                    }
+                }
+            }
+            return { valid: true };
+        },
+        validateUpdate(task, updates) {
+            if (mode === 'off')
+                return { valid: true };
+            if (updates.acceptance !== undefined) {
+                if (mode === 'block' && requiredForPriorities.includes(task.priority)) {
+                    if (!checkMin(updates.acceptance, minCriteria)) {
+                        return {
+                            valid: false,
+                            error: `Task requires at least ${minCriteria} acceptance criteria`,
+                            fix: `Provide at least ${minCriteria} criteria when updating acceptance`,
+                            exitCode: ExitCode.VALIDATION_ERROR,
+                        };
+                    }
+                }
+            }
+            return { valid: true };
+        },
+        validateCompletion(task) {
+            if (mode === 'off')
+                return { valid: true };
+            if (requiredForPriorities.includes(task.priority)) {
+                if (!checkMin(task.acceptance ?? [], minCriteria)) {
+                    const msg = `Task ${task.id} requires at least ${minCriteria} acceptance criteria before completion`;
+                    if (mode === 'block') {
+                        return {
+                            valid: false,
+                            error: msg,
+                            fix: `Add criteria: cleo update ${task.id} --acceptance "criterion 1" --acceptance "criterion 2"`,
+                            exitCode: ExitCode.VALIDATION_ERROR,
+                        };
+                    }
+                    else if (mode === 'warn') {
+                        return { valid: true, error: msg };
+                    }
+                }
+            }
+            return { valid: true };
+        },
+    };
+}
+//# sourceMappingURL=enforcement.js.map

package/dist/tasks/enforcement.js.map

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