@cleocode/core 2026.3.66 → 2026.3.67

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

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

package/dist/tasks/pipeline-stage.js

@@ -0,0 +1,248 @@
+/**
+ * Pipeline stage binding for tasks (RCASD-IVTR+C).
+ *
+ * Implements auto-assignment of pipeline stages on task creation and
+ * forward-only stage transition validation on task update.
+ *
+ * Stages (in order):
+ *   1. research
+ *   2. consensus
+ *   3. architecture_decision
+ *   4. specification
+ *   5. decomposition
+ *   6. implementation
+ *   7. validation
+ *   8. testing
+ *   9. release
+ *  10. contribution  (cross-cutting, treated as terminal)
+ *
+ * @task T060
+ * @epic T056
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/**
+ * Ordered pipeline stages (RCASD-IVTR+C).
+ * This matches lifecycle/stages.ts PIPELINE_STAGES but is kept local to avoid
+ * a circular dependency — tasks/ must not import from lifecycle/.
+ *
+ * @task T060
+ */
+export const TASK_PIPELINE_STAGES = [
+    'research',
+    'consensus',
+    'architecture_decision',
+    'specification',
+    'decomposition',
+    'implementation',
+    'validation',
+    'testing',
+    'release',
+    'contribution',
+];
+/** Order map for fast index lookups (1-based). */
+const STAGE_ORDER = {
+    research: 1,
+    consensus: 2,
+    architecture_decision: 3,
+    specification: 4,
+    decomposition: 5,
+    implementation: 6,
+    validation: 7,
+    testing: 8,
+    release: 9,
+    contribution: 10,
+};
+// =============================================================================
+// VALIDATION
+// =============================================================================
+/**
+ * Check whether a string is a valid pipeline stage name.
+ *
+ * @remarks
+ * Uses a type-narrowing signature so callers can safely use the value
+ * as {@link TaskPipelineStage} after a truthy check.
+ *
+ * @param stage - Raw string to test
+ * @returns True if it is a valid stage name
+ *
+ * @example
+ * ```ts
+ * isValidPipelineStage('research');       // => true
+ * isValidPipelineStage('not_a_stage');    // => false
+ * ```
+ *
+ * @task T060
+ */
+export function isValidPipelineStage(stage) {
+    return TASK_PIPELINE_STAGES.includes(stage);
+}
+/**
+ * Validate a pipeline stage name and throw a CleoError on failure.
+ *
+ * @remarks
+ * Uses an assertion signature — after a successful call the compiler
+ * narrows `stage` to {@link TaskPipelineStage}.
+ *
+ * @param stage - Stage name to validate
+ * @returns void (assertion function — narrows type on success)
+ * @throws CleoError(VALIDATION_ERROR) if invalid
+ *
+ * @example
+ * ```ts
+ * validatePipelineStage('implementation'); // passes
+ * validatePipelineStage('invalid');        // throws CleoError
+ * ```
+ *
+ * @task T060
+ */
+export function validatePipelineStage(stage) {
+    if (!isValidPipelineStage(stage)) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid pipeline stage: "${stage}". Valid stages: ${TASK_PIPELINE_STAGES.join(', ')}`, { fix: `Use one of: ${TASK_PIPELINE_STAGES.join(', ')}` });
+    }
+}
+// =============================================================================
+// AUTO-ASSIGNMENT
+// =============================================================================
+/**
+ * Determine the default pipeline stage for a new task.
+ *
+ * Rules (in priority order):
+ * 1. If an explicit stage is provided and valid, use it.
+ * 2. If the task has a parent, inherit the parent's pipelineStage.
+ * 3. If the task type is 'epic', default to 'research'.
+ * 4. Otherwise default to 'implementation'.
+ *
+ * @remarks
+ * Priority order ensures explicit caller intent wins, then parent
+ * inheritance, then type-based defaults. This avoids surprising
+ * overrides when parent stages differ from the default.
+ *
+ * @param options - Resolution inputs
+ * @param options.explicitStage - Stage explicitly provided by the caller
+ * @param options.taskType      - Type of the task being created
+ * @param options.parentTask    - Parent task (if any), for inheritance
+ * @returns The resolved pipeline stage name
+ *
+ * @example
+ * ```ts
+ * resolveDefaultPipelineStage({ taskType: 'epic' });
+ * // => 'research'
+ *
+ * resolveDefaultPipelineStage({ taskType: 'task' });
+ * // => 'implementation'
+ * ```
+ *
+ * @task T060
+ */
+export function resolveDefaultPipelineStage(options) {
+    const { explicitStage, taskType, parentTask } = options;
+    // 1. Caller-supplied explicit stage (validated upstream)
+    if (explicitStage && isValidPipelineStage(explicitStage)) {
+        return explicitStage;
+    }
+    // 2. Inherit from parent
+    if (parentTask?.pipelineStage && isValidPipelineStage(parentTask.pipelineStage)) {
+        return parentTask.pipelineStage;
+    }
+    // 3. Epic → research
+    if (taskType === 'epic') {
+        return 'research';
+    }
+    // 4. Default
+    return 'implementation';
+}
+// =============================================================================
+// TRANSITION VALIDATION
+// =============================================================================
+/**
+ * Get the numeric order of a pipeline stage (1-based).
+ *
+ * @remarks
+ * Returns -1 for unrecognised stage names so callers can distinguish
+ * "unknown" from a valid low-order stage.
+ *
+ * @param stage - Stage name (must be valid)
+ * @returns Numeric order (1–10), or -1 if not found
+ *
+ * @example
+ * ```ts
+ * getPipelineStageOrder('research');       // => 1
+ * getPipelineStageOrder('implementation'); // => 6
+ * getPipelineStageOrder('unknown');        // => -1
+ * ```
+ *
+ * @task T060
+ */
+export function getPipelineStageOrder(stage) {
+    return isValidPipelineStage(stage) ? STAGE_ORDER[stage] : -1;
+}
+/**
+ * Check whether transitioning from `currentStage` to `newStage` is forward-only.
+ *
+ * "Forward" means the new stage's order is greater than or equal to the current
+ * stage's order (same stage is a no-op and is considered valid).
+ *
+ * @remarks
+ * Unknown stages are treated as valid to avoid blocking tasks with
+ * legacy or custom stage names that predate the standard set.
+ *
+ * @param currentStage - The task's current pipeline stage
+ * @param newStage     - The requested new pipeline stage
+ * @returns True if the transition is allowed (forward or same)
+ *
+ * @example
+ * ```ts
+ * isPipelineTransitionForward('research', 'implementation'); // => true
+ * isPipelineTransitionForward('testing', 'research');        // => false
+ * ```
+ *
+ * @task T060
+ */
+export function isPipelineTransitionForward(currentStage, newStage) {
+    const currentOrder = getPipelineStageOrder(currentStage);
+    const newOrder = getPipelineStageOrder(newStage);
+    if (currentOrder === -1 || newOrder === -1)
+        return true; // unknown stages: allow
+    return newOrder >= currentOrder;
+}
+/**
+ * Validate a pipeline stage transition and throw if it would move backward.
+ *
+ * @remarks
+ * Validates the new stage name first via {@link validatePipelineStage},
+ * then checks directionality. A null/undefined current stage accepts any
+ * valid new stage (first assignment).
+ *
+ * @param currentStage - The task's current pipeline stage (may be null/undefined)
+ * @param newStage     - The new stage being requested
+ * @throws CleoError(VALIDATION_ERROR) if the transition is backward
+ *
+ * @example
+ * ```ts
+ * validatePipelineTransition(null, 'research');              // passes (first assignment)
+ * validatePipelineTransition('research', 'implementation');   // passes (forward)
+ * validatePipelineTransition('testing', 'research');          // throws (backward)
+ * ```
+ *
+ * @task T060
+ */
+export function validatePipelineTransition(currentStage, newStage) {
+    // Validate the new stage name first
+    validatePipelineStage(newStage);
+    if (!currentStage) {
+        // No current stage — any valid stage is allowed
+        return;
+    }
+    if (!isPipelineTransitionForward(currentStage, newStage)) {
+        const currentOrder = getPipelineStageOrder(currentStage);
+        const newOrder = getPipelineStageOrder(newStage);
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Pipeline stage transition rejected: cannot move backward from "${currentStage}" (order ${currentOrder}) to "${newStage}" (order ${newOrder}). Tasks can only move forward through pipeline stages.`, {
+            fix: `Specify a stage at or after "${currentStage}". Valid forward stages: ${TASK_PIPELINE_STAGES.filter((s) => STAGE_ORDER[s] >= currentOrder).join(', ')}`,
+        });
+    }
+}
+//# sourceMappingURL=pipeline-stage.js.map

package/dist/tasks/pipeline-stage.js.map

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

package/dist/tasks/plan.js

@@ -0,0 +1,268 @@
+/**
+ * Composite planning view - aggregates multiple task queries for planning.
+ * @task T4914
+ * @epic T4454
+ */
+import { getAccessor } from '../store/data-accessor.js';
+import { depsReady } from './deps-ready.js';
+const PRIORITY_SCORE = {
+    critical: 100,
+    high: 75,
+    medium: 50,
+    low: 25,
+};
+async function loadAllTasks(projectRoot) {
+    const accessor = await getAccessor(projectRoot);
+    const { tasks } = await accessor.queryTasks({});
+    return tasks;
+}
+/**
+ * Calculate leverage score for a task based on how many other tasks depend on it.
+ */
+function calculateLeverage(taskId, taskMap) {
+    let leverage = 0;
+    for (const task of taskMap.values()) {
+        if (task.depends?.includes(taskId)) {
+            leverage++;
+        }
+    }
+    return leverage;
+}
+/**
+ * Find the epic ID for a task (parent epic, not immediate parent).
+ */
+function findEpicId(task, taskMap) {
+    let current = task;
+    const visited = new Set();
+    while (current?.parentId && !visited.has(current.id)) {
+        visited.add(current.id);
+        const parent = taskMap.get(current.parentId);
+        if (!parent)
+            break;
+        if (parent.type === 'epic') {
+            return parent.id;
+        }
+        current = parent;
+    }
+    // If task itself is an epic
+    if (task.type === 'epic') {
+        return task.id;
+    }
+    // Return parentId as fallback, or task's own id
+    return task.parentId ?? task.id;
+}
+/**
+ * Get current phase from tasks.
+ */
+async function getCurrentPhase(projectRoot) {
+    const accessor = await getAccessor(projectRoot);
+    const meta = await accessor.getMetaValue('project_meta');
+    return meta?.currentPhase ?? null;
+}
+/**
+ * Calculate completion percentage for an epic.
+ */
+function calculateEpicCompletion(epicId, taskMap) {
+    let totalTasks = 0;
+    let completedTasks = 0;
+    let activeTasks = 0;
+    // Count direct children and their descendants
+    const collectTasks = (parentId) => {
+        for (const task of taskMap.values()) {
+            if (task.parentId === parentId) {
+                totalTasks++;
+                if (task.status === 'done' || task.status === 'cancelled') {
+                    completedTasks++;
+                }
+                if (task.status === 'active') {
+                    activeTasks++;
+                }
+                // Recursively count descendants
+                collectTasks(task.id);
+            }
+        }
+    };
+    collectTasks(epicId);
+    const completionPercent = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+    return { activeTasks, completionPercent };
+}
+/**
+ * Build composite planning view.
+ * @task T4914
+ */
+export async function coreTaskPlan(projectRoot) {
+    const allTasks = await loadAllTasks(projectRoot);
+    const taskMap = new Map(allTasks.map((t) => [t.id, t]));
+    const currentPhase = await getCurrentPhase(projectRoot);
+    // ========================================================================
+    // 1. In-Progress Epics (epics with active status)
+    // ========================================================================
+    const inProgressEpics = [];
+    for (const task of allTasks) {
+        if (task.type === 'epic' && task.status === 'active') {
+            const { activeTasks, completionPercent } = calculateEpicCompletion(task.id, taskMap);
+            inProgressEpics.push({
+                epicId: task.id,
+                epicTitle: task.title,
+                activeTasks,
+                completionPercent,
+            });
+        }
+    }
+    // ========================================================================
+    // 2. Ready Tasks (pending tasks with deps satisfied)
+    // ========================================================================
+    const readyTasks = [];
+    const pendingTasks = allTasks.filter((t) => t.status === 'pending');
+    for (const task of pendingTasks) {
+        if (depsReady(task.depends, taskMap)) {
+            const leverage = calculateLeverage(task.id, taskMap);
+            const epicId = findEpicId(task, taskMap);
+            // Calculate score using same logic as tasks.next
+            const reasons = [];
+            let score = 0;
+            score += PRIORITY_SCORE[task.priority] ?? 50;
+            reasons.push(`priority: ${task.priority} (+${PRIORITY_SCORE[task.priority] ?? 50})`);
+            if (currentPhase && task.phase === currentPhase) {
+                score += 20;
+                reasons.push(`phase alignment: ${currentPhase} (+20)`);
+            }
+            score += 10;
+            reasons.push('all dependencies satisfied (+10)');
+            if (task.createdAt) {
+                const ageMs = Date.now() - new Date(task.createdAt).getTime();
+                const ageDays = ageMs / (1000 * 60 * 60 * 24);
+                if (ageDays > 7) {
+                    const ageBonus = Math.min(15, Math.floor(ageDays / 7));
+                    score += ageBonus;
+                    reasons.push(`age: ${Math.floor(ageDays)} days (+${ageBonus})`);
+                }
+            }
+            // Add leverage bonus to score
+            if (leverage > 0) {
+                score += leverage * 5;
+                reasons.push(`leverage: unblocks ${leverage} task(s) (+${leverage * 5})`);
+            }
+            readyTasks.push({
+                id: task.id,
+                title: task.title,
+                priority: task.priority,
+                epicId,
+                leverage,
+                score,
+                reasons,
+            });
+        }
+    }
+    // Sort by score descending
+    readyTasks.sort((a, b) => b.score - a.score);
+    // ========================================================================
+    // 3. Blocked Tasks
+    // ========================================================================
+    const blockedTasks = [];
+    // Tasks with blocked status
+    for (const task of allTasks) {
+        if (task.status === 'blocked') {
+            const blockedBy = [];
+            if (task.blockedBy) {
+                blockedBy.push(task.blockedBy);
+            }
+            if (task.depends) {
+                for (const depId of task.depends) {
+                    const dep = taskMap.get(depId);
+                    if (dep && dep.status !== 'done' && dep.status !== 'cancelled') {
+                        blockedBy.push(depId);
+                    }
+                }
+            }
+            // Calculate how many tasks this blocks
+            let blocksCount = 0;
+            for (const t of allTasks) {
+                if (t.depends?.includes(task.id)) {
+                    blocksCount++;
+                }
+            }
+            blockedTasks.push({
+                id: task.id,
+                title: task.title,
+                blockedBy,
+                blocksCount,
+            });
+        }
+    }
+    // Tasks with unresolved dependencies (pending + has incomplete deps)
+    for (const task of allTasks) {
+        if (task.status === 'pending' && task.depends && task.depends.length > 0) {
+            const hasUnresolvedDeps = task.depends.some((depId) => {
+                const dep = taskMap.get(depId);
+                return dep && dep.status !== 'done' && dep.status !== 'cancelled';
+            });
+            if (hasUnresolvedDeps && !blockedTasks.some((b) => b.id === task.id)) {
+                const blockedBy = task.depends.filter((depId) => {
+                    const dep = taskMap.get(depId);
+                    return dep && dep.status !== 'done' && dep.status !== 'cancelled';
+                });
+                // Calculate how many tasks this blocks
+                let blocksCount = 0;
+                for (const t of allTasks) {
+                    if (t.depends?.includes(task.id)) {
+                        blocksCount++;
+                    }
+                }
+                blockedTasks.push({
+                    id: task.id,
+                    title: task.title,
+                    blockedBy,
+                    blocksCount,
+                });
+            }
+        }
+    }
+    // ========================================================================
+    // 4. Open Bugs (origin:bug-report OR label:bug)
+    // ========================================================================
+    const openBugs = [];
+    for (const task of allTasks) {
+        const isBug = task.origin === 'bug-report' || task.labels?.includes('bug');
+        const isOpen = task.status !== 'done' && task.status !== 'cancelled';
+        if (isBug && isOpen) {
+            const epicId = findEpicId(task, taskMap);
+            openBugs.push({
+                id: task.id,
+                title: task.title,
+                priority: task.priority,
+                epicId,
+            });
+        }
+    }
+    // ========================================================================
+    // 5. Metrics
+    // ========================================================================
+    const epics = allTasks.filter((t) => t.type === 'epic');
+    const activeEpics = epics.filter((t) => t.status === 'active').length;
+    const actionable = allTasks.filter((t) => (t.status === 'pending' || t.status === 'active') && !blockedTasks.some((b) => b.id === t.id)).length;
+    const blocked = blockedTasks.length;
+    // Calculate average leverage across all tasks
+    let totalLeverage = 0;
+    for (const task of allTasks) {
+        totalLeverage += calculateLeverage(task.id, taskMap);
+    }
+    const avgLeverage = allTasks.length > 0 ? Math.round((totalLeverage / allTasks.length) * 100) / 100 : 0;
+    const metrics = {
+        totalEpics: epics.length,
+        activeEpics,
+        totalTasks: allTasks.length,
+        actionable,
+        blocked,
+        openBugs: openBugs.length,
+        avgLeverage,
+    };
+    return {
+        inProgress: inProgressEpics,
+        ready: readyTasks,
+        blocked: blockedTasks,
+        openBugs,
+        metrics,
+    };
+}
+//# sourceMappingURL=plan.js.map