@cleocode/core 2026.3.56 → 2026.3.58

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

@@ -0,0 +1,22 @@
+import { ExitCode, type Task } from '@cleocode/contracts';
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    fix?: string;
+    exitCode?: ExitCode;
+}
+export interface AddTaskEnforcementOptions {
+    acceptance?: string[];
+    priority?: string;
+}
+export interface UpdateTaskEnforcementOptions {
+    acceptance?: string[];
+}
+export interface AcceptanceEnforcement {
+    validateCreation(options: AddTaskEnforcementOptions): ValidationResult;
+    validateUpdate(task: Task, updates: UpdateTaskEnforcementOptions): ValidationResult;
+    validateCompletion(task: Task): ValidationResult;
+    checkMinimumCriteria(criteria: string[], minCriteria: number): boolean;
+}
+export declare function createAcceptanceEnforcement(cwd?: string): Promise<AcceptanceEnforcement>;
+//# sourceMappingURL=enforcement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enforcement.d.ts","sourceRoot":"","sources":["../../src/tasks/enforcement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,OAAO,EAAE,yBAAyB,GAAG,gBAAgB,CAAC;IACvE,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,4BAA4B,GAAG,gBAAgB,CAAC;IACpF,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAAC;IACjD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CACxE;AAMD,wBAAsB,2BAA2B,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA6F9F"}

package/dist/tasks/enforcement.js

@@ -0,0 +1,82 @@
+import { ExitCode } from '@cleocode/contracts';
+import { getRawConfigValue } from '../config.js';
+function checkMin(criteria, min) {
+    return Array.isArray(criteria) && criteria.length >= min;
+}
+export async function createAcceptanceEnforcement(cwd) {
+    const modeRaw = await getRawConfigValue('enforcement.acceptance.mode', cwd);
+    const prioritiesRaw = await getRawConfigValue('enforcement.acceptance.requiredForPriorities', cwd);
+    const minCriteriaRaw = await getRawConfigValue('enforcement.acceptance.minimumCriteria', cwd);
+    const defaultPriorityRaw = await getRawConfigValue('defaults.priority', cwd);
+    const mode = modeRaw === 'off' || modeRaw === 'warn' || modeRaw === 'block' ? modeRaw : 'block';
+    const requiredForPriorities = Array.isArray(prioritiesRaw)
+        ? prioritiesRaw.filter((p) => typeof p === 'string')
+        : ['critical', 'high', 'medium', 'low'];
+    const minCriteria = typeof minCriteriaRaw === 'number' && Number.isInteger(minCriteriaRaw) ? minCriteriaRaw : 3;
+    const defaultPriority = typeof defaultPriorityRaw === 'string' ? defaultPriorityRaw : '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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"}

package/dist/tasks/epic-enforcement.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Epic lifecycle pipeline enforcement (RCASD-IVTR+C).
+ *
+ * Enforces three constraints specific to tasks of type "epic":
+ *
+ * 1. **Creation requirements** (strict mode only):
+ *    - Minimum 5 acceptance criteria (vs. 3 for regular tasks).
+ *    - Completion criteria must be defined (non-empty description field).
+ *    - Initial pipeline stage defaults to "research" (inherited from
+ *      pipeline-stage.ts, not re-asserted here).
+ *
+ * 2. **Child stage ceiling**: A child task's pipeline stage cannot advance
+ *    past the epic's current pipeline stage.  This is checked on child task
+ *    update (pipelineStage change) and on child task creation.
+ *
+ * 3. **Epic stage advancement gate**: An epic cannot advance its pipeline
+ *    stage while it has children whose status is not "done" AND whose
+ *    pipeline stage equals the epic's current stage.  In other words, all
+ *    in-flight children at the current stage must be completed before the
+ *    epic may move forward.
+ *
+ * Enforcement is conditional on `lifecycle.mode`:
+ *   - "strict"   → block (throw CleoError on violation)
+ *   - "advisory" → warn (return error string but do not throw)
+ *   - "off"      → skip (all checks are no-ops)
+ *
+ * @task T062
+ * @epic T056
+ */
+import type { DataAccessor, Task } from '@cleocode/contracts';
+/** Minimum acceptance criteria count required for epic creation in strict mode. */
+export declare const EPIC_MIN_AC = 5;
+/** Minimum acceptance criteria count for regular tasks. */
+export declare const TASK_MIN_AC = 3;
+/** The resolved enforcement mode (from lifecycle.mode config key). */
+export type LifecycleMode = 'strict' | 'advisory' | 'off';
+/** Result of an enforcement check.  `warning` is populated in advisory mode. */
+export interface EpicEnforcementResult {
+    /** True unless a hard block was raised. */
+    valid: boolean;
+    /** Advisory message (non-blocking) or error message (blocked). */
+    warning?: string;
+}
+/**
+ * Read `lifecycle.mode` from config.  Falls back to "strict" when unset
+ * (matches the DEFAULTS in config.ts).
+ *
+ * @task T062
+ */
+export declare function getLifecycleMode(cwd?: string): Promise<LifecycleMode>;
+/**
+ * Validate that a new epic satisfies creation requirements.
+ *
+ * In **strict** mode:
+ *   - At least {@link EPIC_MIN_AC} acceptance criteria must be provided.
+ *   - `description` must be non-empty (treated as completion criteria).
+ *
+ * In **advisory** mode the same checks are run but violations do not block —
+ * they are returned as `warning` text for the caller to surface.
+ *
+ * In **off** mode this function is a no-op.
+ *
+ * @param options.acceptance  - Acceptance criteria array supplied by the caller.
+ * @param options.description - Task description (used as completion criteria proxy).
+ * @param cwd                 - Working directory for config resolution.
+ * @returns EpicEnforcementResult — `valid: false` only in strict mode on error.
+ * @throws CleoError(VALIDATION_ERROR) in strict mode when constraints are violated.
+ *
+ * @task T062
+ */
+export declare function validateEpicCreation(options: {
+    acceptance?: string[];
+    description?: string;
+}, cwd?: string): Promise<EpicEnforcementResult>;
+/**
+ * Validate that a child task's pipeline stage does not exceed its epic's stage.
+ *
+ * Call this when:
+ *   - A child task is **created** under an epic parent.
+ *   - A child task's `pipelineStage` is **updated** and it has an epic ancestor.
+ *
+ * The check walks the task's ancestor chain to find the nearest epic ancestor.
+ * If none exists, the check is skipped.
+ *
+ * @param options.childStage  - The proposed pipeline stage for the child.
+ * @param options.epicId      - ID of the epic ancestor to check against.
+ * @param accessor            - DataAccessor for task lookups.
+ * @param cwd                 - Working directory for config resolution.
+ * @returns EpicEnforcementResult
+ * @throws CleoError(VALIDATION_ERROR) in strict mode when the child stage exceeds the epic.
+ *
+ * @task T062
+ */
+export declare function validateChildStageCeiling(options: {
+    childStage: string;
+    epicId: string;
+}, accessor: DataAccessor, cwd?: string): Promise<EpicEnforcementResult>;
+/**
+ * Find the nearest epic ancestor for a given task.
+ *
+ * Walks the ancestor chain (root-first) and returns the first task whose
+ * type is "epic", or null if no epic ancestor exists.
+ *
+ * @param taskId   - ID of the task whose ancestors to inspect.
+ * @param accessor - DataAccessor for the ancestor chain query.
+ * @returns The nearest epic ancestor, or null.
+ *
+ * @task T062
+ */
+export declare function findEpicAncestor(taskId: string, accessor: DataAccessor): Promise<Task | null>;
+/**
+ * Validate that an epic can advance its pipeline stage.
+ *
+ * An epic is **blocked** from advancing to a later stage when it has at least
+ * one child that:
+ *   - Has a pipeline stage **equal to the epic's current stage**, AND
+ *   - Has a status that is **not** "done" (i.e., is still in-flight).
+ *
+ * Rationale: the epic stage represents the stage the team is actively working
+ * in.  Moving the epic forward while children are unfinished at the current
+ * stage violates the pipeline discipline.
+ *
+ * @param options.epicId       - ID of the epic being advanced.
+ * @param options.currentStage - Epic's current pipeline stage (before the update).
+ * @param options.newStage     - Proposed new pipeline stage.
+ * @param accessor             - DataAccessor for children lookup.
+ * @param cwd                  - Working directory for config resolution.
+ * @returns EpicEnforcementResult
+ * @throws CleoError(VALIDATION_ERROR) in strict mode when incomplete children exist.
+ *
+ * @task T062
+ */
+export declare function validateEpicStageAdvancement(options: {
+    epicId: string;
+    currentStage: string;
+    newStage: string;
+}, accessor: DataAccessor, cwd?: string): Promise<EpicEnforcementResult>;
+//# sourceMappingURL=epic-enforcement.d.ts.map

package/dist/tasks/epic-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-enforcement.d.ts","sourceRoot":"","sources":["../../src/tasks/epic-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAU9D,mFAAmF;AACnF,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,2DAA2D;AAC3D,eAAO,MAAM,WAAW,IAAI,CAAC;AAM7B,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;AAE1D,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAI3E;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE;IACP,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,qBAAqB,CAAC,CA8BhC;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,EACD,QAAQ,EAAE,YAAY,EACtB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,qBAAqB,CAAC,CA6BhC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAStB;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE;IACP,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,EACD,QAAQ,EAAE,YAAY,EACtB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,qBAAqB,CAAC,CA0ChC"}