@cleocode/core 2026.4.9 → 2026.4.12

package/dist/phases/index.js

@@ -0,0 +1,349 @@
+/**
+ * Phase lifecycle management - CRUD, transitions, and querying.
+ * @task T4464
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { logOperation } from '../tasks/add.js';
+/**
+ * List all phases with status summaries.
+ * @task T4464
+ */
+export async function listPhases(_cwd, accessor) {
+    const meta = await accessor.getMetaValue('project_meta');
+    const phases = meta?.phases ?? {};
+    const currentPhase = meta?.currentPhase ?? null;
+    const entries = Object.entries(phases)
+        .map(([slug, phase]) => ({
+        slug,
+        name: phase.name,
+        order: phase.order,
+        status: phase.status,
+        startedAt: phase.startedAt ?? null,
+        completedAt: phase.completedAt ?? null,
+        isCurrent: slug === currentPhase,
+    }))
+        .sort((a, b) => a.order - b.order);
+    return {
+        currentPhase,
+        phases: entries,
+        summary: {
+            total: entries.length,
+            pending: entries.filter((p) => p.status === 'pending').length,
+            active: entries.filter((p) => p.status === 'active').length,
+            completed: entries.filter((p) => p.status === 'completed').length,
+        },
+    };
+}
+/**
+ * Show the current phase details.
+ * @task T4464
+ */
+export async function showPhase(slug, _cwd, accessor) {
+    const meta = await accessor.getMetaValue('project_meta');
+    const targetSlug = slug ?? meta?.currentPhase ?? null;
+    if (!targetSlug) {
+        throw new CleoError(ExitCode.NOT_FOUND, 'No current phase set');
+    }
+    const phase = meta?.phases?.[targetSlug];
+    if (!phase) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Phase '${targetSlug}' not found`);
+    }
+    const { tasks: phaseTasks } = await accessor.queryTasks({ phase: targetSlug });
+    const completedTasks = phaseTasks.filter((t) => t.status === 'done');
+    return {
+        slug: targetSlug,
+        name: phase.name,
+        status: phase.status,
+        order: phase.order,
+        startedAt: phase.startedAt ?? null,
+        completedAt: phase.completedAt ?? null,
+        taskCount: phaseTasks.length,
+        completedTaskCount: completedTasks.length,
+    };
+}
+/**
+ * Set the current project phase.
+ * @task T4464
+ */
+export async function setPhase(options, _cwd, accessor) {
+    const meta = await accessor.getMetaValue('project_meta');
+    const phases = meta?.phases ?? {};
+    // Validate phase exists
+    if (!phases[options.slug]) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Phase '${options.slug}' does not exist`);
+    }
+    const oldPhase = meta?.currentPhase ?? null;
+    let isRollback = false;
+    let isSkip = false;
+    let skippedPhases = 0;
+    if (oldPhase && phases[oldPhase]) {
+        const oldOrder = phases[oldPhase].order;
+        const newOrder = phases[options.slug].order;
+        if (newOrder < oldOrder) {
+            isRollback = true;
+            if (!options.rollback) {
+                throw new CleoError(ExitCode.VALIDATION_ERROR, `Rolling back from '${oldPhase}' (order ${oldOrder}) to '${options.slug}' (order ${newOrder}) requires --rollback flag`);
+            }
+            if (!options.force) {
+                throw new CleoError(ExitCode.VALIDATION_ERROR, 'Rollback requires --force flag in non-interactive mode');
+            }
+        }
+        else if (newOrder > oldOrder + 1) {
+            isSkip = true;
+            skippedPhases = newOrder - oldOrder - 1;
+        }
+    }
+    if (options.dryRun) {
+        return {
+            previousPhase: oldPhase,
+            currentPhase: options.slug,
+            isRollback,
+            isSkip,
+            ...(isSkip && { skippedPhases }),
+            dryRun: true,
+        };
+    }
+    // Update current phase in project metadata
+    const updatedMeta = meta ?? { name: '', phases: {} };
+    updatedMeta.currentPhase = options.slug;
+    // Add phase history entry for rollback
+    if (isRollback && oldPhase) {
+        const taskCount = await accessor.countTasks({ status: undefined });
+        addPhaseHistoryEntryToMeta(updatedMeta, options.slug, 'rollback', oldPhase, `Rollback from ${oldPhase}`, taskCount);
+    }
+    await accessor.setMetaValue('project_meta', updatedMeta);
+    await logOperation('phase_set', options.slug, {
+        previousPhase: oldPhase,
+        isRollback,
+    }, accessor);
+    return {
+        previousPhase: oldPhase,
+        currentPhase: options.slug,
+        isRollback,
+        isSkip,
+        ...(isSkip && {
+            skippedPhases,
+            warning: `Skipped ${skippedPhases} intermediate phase(s)`,
+        }),
+    };
+}
+/**
+ * Start a phase (pending -> active).
+ * @task T4464
+ */
+export async function startPhase(slug, _cwd, accessor) {
+    const meta = await accessor.getMetaValue('project_meta');
+    const phase = meta?.phases?.[slug];
+    if (!phase) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Phase '${slug}' does not exist`);
+    }
+    if (phase.status !== 'pending') {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Can only start pending phases. Phase '${slug}' has status '${phase.status}'`);
+    }
+    const now = new Date().toISOString();
+    phase.status = 'active';
+    phase.startedAt = now;
+    const updatedMeta = meta;
+    const { tasks: phaseTasks } = await accessor.queryTasks({ phase: slug });
+    addPhaseHistoryEntryToMeta(updatedMeta, slug, 'started', null, 'Phase started', phaseTasks.length);
+    await accessor.setMetaValue('project_meta', updatedMeta);
+    await logOperation('phase_started', slug, {}, accessor);
+    return { phase: slug, startedAt: now };
+}
+/**
+ * Complete a phase (active -> completed).
+ * @task T4464
+ */
+export async function completePhase(slug, _cwd, accessor) {
+    const meta = await accessor.getMetaValue('project_meta');
+    const phase = meta?.phases?.[slug];
+    if (!phase) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Phase '${slug}' does not exist`);
+    }
+    if (phase.status !== 'active') {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Can only complete active phases. Phase '${slug}' has status '${phase.status}'`);
+    }
+    // Check for incomplete tasks
+    const { tasks: phaseTasks } = await accessor.queryTasks({ phase: slug });
+    const incompleteTasks = phaseTasks.filter((t) => t.status !== 'done');
+    if (incompleteTasks.length > 0) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Cannot complete phase '${slug}' - ${incompleteTasks.length} incomplete task(s) pending`);
+    }
+    const now = new Date().toISOString();
+    phase.status = 'completed';
+    phase.completedAt = now;
+    const updatedMeta = meta;
+    addPhaseHistoryEntryToMeta(updatedMeta, slug, 'completed', null, 'Phase completed', phaseTasks.length);
+    await accessor.setMetaValue('project_meta', updatedMeta);
+    await logOperation('phase_completed', slug, {}, accessor);
+    return { phase: slug, completedAt: now };
+}
+/**
+ * Advance to the next phase.
+ * @task T4464
+ */
+export async function advancePhase(force = false, _cwd, accessor) {
+    const meta = await accessor.getMetaValue('project_meta');
+    const currentSlug = meta?.currentPhase ?? null;
+    if (!currentSlug) {
+        throw new CleoError(ExitCode.NOT_FOUND, 'No current phase set');
+    }
+    const phases = meta?.phases ?? {};
+    const currentPhase = phases[currentSlug];
+    if (!currentPhase) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Current phase '${currentSlug}' not found`);
+    }
+    // Find next phase by order
+    const sortedEntries = Object.entries(phases).sort(([, a], [, b]) => a.order - b.order);
+    const currentIndex = sortedEntries.findIndex(([slug]) => slug === currentSlug);
+    if (currentIndex === -1 || currentIndex >= sortedEntries.length - 1) {
+        throw new CleoError(ExitCode.NO_DATA, `No more phases after '${currentSlug}'`);
+    }
+    const [nextSlug] = sortedEntries[currentIndex + 1];
+    // Check incomplete tasks
+    const { tasks: phaseTasks } = await accessor.queryTasks({ phase: currentSlug });
+    const incompleteTasks = phaseTasks.filter((t) => t.status !== 'done');
+    if (incompleteTasks.length > 0) {
+        // Check critical tasks
+        const criticalTasks = incompleteTasks.filter((t) => t.priority === 'critical');
+        if (criticalTasks.length > 0) {
+            throw new CleoError(ExitCode.VALIDATION_ERROR, `Cannot advance - ${criticalTasks.length} critical task(s) remain in phase '${currentSlug}'`);
+        }
+        // Check completion threshold
+        const totalTasks = phaseTasks.length;
+        const completionPercent = totalTasks > 0 ? Math.floor(((totalTasks - incompleteTasks.length) * 100) / totalTasks) : 0;
+        const threshold = 90;
+        if (completionPercent < threshold && !force) {
+            throw new CleoError(ExitCode.VALIDATION_ERROR, `Cannot advance - ${incompleteTasks.length} incomplete task(s) in phase '${currentSlug}' (${completionPercent}% complete, threshold: ${threshold}%)`, { fix: 'Use --force to override' });
+        }
+    }
+    // Complete current phase
+    const now = new Date().toISOString();
+    currentPhase.status = 'completed';
+    currentPhase.completedAt = now;
+    // Start next phase
+    const nextPhase = phases[nextSlug];
+    nextPhase.status = 'active';
+    nextPhase.startedAt = now;
+    // Update current phase pointer
+    const updatedMeta = meta;
+    updatedMeta.currentPhase = nextSlug;
+    const currentPhaseTaskCount = phaseTasks.length;
+    const { tasks: nextPhaseTasks } = await accessor.queryTasks({ phase: nextSlug });
+    const nextPhaseTaskCount = nextPhaseTasks.length;
+    addPhaseHistoryEntryToMeta(updatedMeta, currentSlug, 'completed', null, 'Phase completed via advance', currentPhaseTaskCount);
+    addPhaseHistoryEntryToMeta(updatedMeta, nextSlug, 'started', currentSlug, `Phase started via advance from ${currentSlug}`, nextPhaseTaskCount);
+    await accessor.setMetaValue('project_meta', updatedMeta);
+    return {
+        previousPhase: currentSlug,
+        currentPhase: nextSlug,
+        forced: force,
+    };
+}
+/**
+ * Rename a phase and update all task references.
+ * @task T4464
+ */
+export async function renamePhase(oldName, newName, _cwd, accessor) {
+    const meta = await accessor.getMetaValue('project_meta');
+    const phases = meta?.phases ?? {};
+    if (!phases[oldName]) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Phase '${oldName}' does not exist`);
+    }
+    if (phases[newName]) {
+        throw new CleoError(ExitCode.ALREADY_EXISTS, `Phase '${newName}' already exists`);
+    }
+    if (!/^[a-z][a-z0-9-]*$/.test(newName)) {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Invalid phase name '${newName}'`);
+    }
+    // Copy phase definition
+    phases[newName] = phases[oldName];
+    delete phases[oldName];
+    // Update task references
+    const { tasks: oldPhaseTasks } = await accessor.queryTasks({ phase: oldName });
+    let tasksUpdated = 0;
+    for (const task of oldPhaseTasks) {
+        task.phase = newName;
+        await accessor.upsertSingleTask(task);
+        tasksUpdated++;
+    }
+    // Update current phase reference
+    const updatedMeta = meta;
+    let currentPhaseUpdated = false;
+    if (updatedMeta.currentPhase === oldName) {
+        updatedMeta.currentPhase = newName;
+        currentPhaseUpdated = true;
+    }
+    await accessor.setMetaValue('project_meta', updatedMeta);
+    // Update focus if needed
+    const focus = await accessor.getMetaValue('focus_state');
+    if (focus?.currentPhase === oldName) {
+        focus.currentPhase = newName;
+        await accessor.setMetaValue('focus_state', focus);
+    }
+    return { oldName, newName, tasksUpdated, currentPhaseUpdated };
+}
+/**
+ * Delete a phase with optional task reassignment.
+ * @task T4464
+ */
+export async function deletePhase(slug, options = {}, _cwd, accessor) {
+    const meta = await accessor.getMetaValue('project_meta');
+    const phases = meta?.phases ?? {};
+    if (!phases[slug]) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Phase '${slug}' does not exist`);
+    }
+    if (meta?.currentPhase === slug) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Cannot delete current project phase '${slug}'. Use 'phase set' to change phase first`);
+    }
+    const { tasks: phaseTasks } = await accessor.queryTasks({ phase: slug });
+    if (phaseTasks.length > 0 && !options.reassignTo) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Cannot delete '${slug}': ${phaseTasks.length} tasks would be orphaned. Use --reassign-to <phase>`);
+    }
+    if (!options.force) {
+        throw new CleoError(ExitCode.INVALID_INPUT, 'Phase deletion requires --force flag for safety');
+    }
+    // Validate reassignment target
+    if (options.reassignTo) {
+        if (!phases[options.reassignTo]) {
+            throw new CleoError(ExitCode.NOT_FOUND, `Reassignment target phase '${options.reassignTo}' does not exist`);
+        }
+    }
+    // Reassign tasks
+    let tasksReassigned = 0;
+    if (options.reassignTo) {
+        for (const task of phaseTasks) {
+            task.phase = options.reassignTo;
+            await accessor.upsertSingleTask(task);
+            tasksReassigned++;
+        }
+    }
+    // Delete phase
+    delete phases[slug];
+    await accessor.setMetaValue('project_meta', meta);
+    return {
+        deletedPhase: slug,
+        tasksReassigned,
+        reassignedTo: options.reassignTo ?? null,
+    };
+}
+/**
+ * Add a phase history entry to a ProjectMeta object (in-memory mutation).
+ * @task T4464
+ */
+function addPhaseHistoryEntryToMeta(meta, phase, transitionType, fromPhase, reason, taskCount) {
+    if (!meta.phaseHistory) {
+        meta.phaseHistory = [];
+    }
+    meta.phaseHistory.push({
+        phase,
+        transitionType,
+        timestamp: new Date().toISOString(),
+        taskCount,
+        fromPhase,
+        reason,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/phases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/phases/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA2E/C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAa,EACb,QAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,QAAS,CAAC,YAAY,CAAc,cAAc,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;IAEhD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;QACtC,SAAS,EAAE,IAAI,KAAK,YAAY;KACjC,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO;QACL,YAAY;QACZ,MAAM,EAAE,OAAO;QACf,OAAO,EAAE;YACP,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;YAC7D,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;YAC3D,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;SAClE;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAa,EACb,IAAa,EACb,QAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,QAAS,CAAC,YAAY,CAAc,cAAc,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,IAAI,IAAI,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;IAEtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,UAAU,aAAa,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,QAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAChF,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAErE,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;QACtC,SAAS,EAAE,UAAU,CAAC,MAAM;QAC5B,kBAAkB,EAAE,cAAc,CAAC,MAAM;KAC1C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAwB,EACxB,IAAa,EACb,QAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,QAAS,CAAC,YAAY,CAAc,cAAc,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;IAElC,wBAAwB;IACxB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,OAAO,CAAC,IAAI,kBAAkB,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;IAC5C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,IAAI,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAE,CAAC,KAAK,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAE,CAAC,KAAK,CAAC;QAE7C,IAAI,QAAQ,GAAG,QAAQ,EAAE,CAAC;YACxB,UAAU,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACtB,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,sBAAsB,QAAQ,YAAY,QAAQ,SAAS,OAAO,CAAC,IAAI,YAAY,QAAQ,4BAA4B,CACxH,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnB,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,wDAAwD,CACzD,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,QAAQ,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,GAAG,IAAI,CAAC;YACd,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO;YACL,aAAa,EAAE,QAAQ;YACvB,YAAY,EAAE,OAAO,CAAC,IAAI;YAC1B,UAAU;YACV,MAAM;YACN,GAAG,CAAC,MAAM,IAAI,EAAE,aAAa,EAAE,CAAC;YAChC,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,WAAW,GAAgB,IAAI,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAClE,WAAW,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAExC,uCAAuC;IACvC,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,QAAS,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACpE,0BAA0B,CACxB,WAAW,EACX,OAAO,CAAC,IAAI,EACZ,UAAU,EACV,QAAQ,EACR,iBAAiB,QAAQ,EAAE,EAC3B,SAAS,CACV,CAAC;IACJ,CAAC;IAED,MAAM,QAAS,CAAC,YAAY,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC1D,MAAM,YAAY,CAChB,WAAW,EACX,OAAO,CAAC,IAAI,EACZ;QACE,aAAa,EAAE,QAAQ;QACvB,UAAU;KACX,EACD,QAAQ,CACT,CAAC;IAEF,OAAO;QACL,aAAa,EAAE,QAAQ;QACvB,YAAY,EAAE,OAAO,CAAC,IAAI;QAC1B,UAAU;QACV,MAAM;QACN,GAAG,CAAC,MAAM,IAAI;YACZ,aAAa;YACb,OAAO,EAAE,WAAW,aAAa,wBAAwB;SAC1D,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,IAAa,EACb,QAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,QAAS,CAAC,YAAY,CAAc,cAAc,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,IAAI,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,aAAa,EACtB,yCAAyC,IAAI,iBAAiB,KAAK,CAAC,MAAM,GAAG,CAC9E,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;IACxB,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC;IAEtB,MAAM,WAAW,GAAG,IAAK,CAAC;IAC1B,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,QAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,0BAA0B,CACxB,WAAW,EACX,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,eAAe,EACf,UAAU,CAAC,MAAM,CAClB,CAAC;IAEF,MAAM,QAAS,CAAC,YAAY,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC1D,MAAM,YAAY,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IAExD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,IAAa,EACb,QAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,QAAS,CAAC,YAAY,CAAc,cAAc,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,IAAI,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,aAAa,EACtB,2CAA2C,IAAI,iBAAiB,KAAK,CAAC,MAAM,GAAG,CAChF,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,QAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtE,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,0BAA0B,IAAI,OAAO,eAAe,CAAC,MAAM,6BAA6B,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;IAC3B,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC;IAExB,MAAM,WAAW,GAAG,IAAK,CAAC;IAC1B,0BAA0B,CACxB,WAAW,EACX,IAAI,EACJ,WAAW,EACX,IAAI,EACJ,iBAAiB,EACjB,UAAU,CAAC,MAAM,CAClB,CAAC;IAEF,MAAM,QAAS,CAAC,YAAY,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC1D,MAAM,YAAY,CAAC,iBAAiB,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE1D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAiB,KAAK,EACtB,IAAa,EACb,QAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,QAAS,CAAC,YAAY,CAAc,cAAc,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;IAE/C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,WAAW,aAAa,CAAC,CAAC;IACtF,CAAC;IAED,2BAA2B;IAC3B,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAEvF,MAAM,YAAY,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAC/E,IAAI,YAAY,KAAK,CAAC,CAAC,IAAI,YAAY,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,WAAW,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,YAAY,GAAG,CAAC,CAAE,CAAC;IAEpD,yBAAyB;IACzB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,QAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IACjF,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtE,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,uBAAuB;QACvB,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;QAC/E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,oBAAoB,aAAa,CAAC,MAAM,sCAAsC,WAAW,GAAG,CAC7F,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;QACrC,MAAM,iBAAiB,GACrB,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,SAAS,GAAG,EAAE,CAAC;QAErB,IAAI,iBAAiB,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5C,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,oBAAoB,eAAe,CAAC,MAAM,iCAAiC,WAAW,MAAM,iBAAiB,0BAA0B,SAAS,IAAI,EACpJ,EAAE,GAAG,EAAE,yBAAyB,EAAE,CACnC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,YAAY,CAAC,MAAM,GAAG,WAAW,CAAC;IAClC,YAAY,CAAC,WAAW,GAAG,GAAG,CAAC;IAE/B,mBAAmB;IACnB,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAE,CAAC;IACpC,SAAS,CAAC,MAAM,GAAG,QAAQ,CAAC;IAC5B,SAAS,CAAC,SAAS,GAAG,GAAG,CAAC;IAE1B,+BAA+B;IAC/B,MAAM,WAAW,GAAG,IAAK,CAAC;IAC1B,WAAW,CAAC,YAAY,GAAG,QAAQ,CAAC;IAEpC,MAAM,qBAAqB,GAAG,UAAU,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,QAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClF,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC;IAEjD,0BAA0B,CACxB,WAAW,EACX,WAAW,EACX,WAAW,EACX,IAAI,EACJ,6BAA6B,EAC7B,qBAAqB,CACtB,CAAC;IACF,0BAA0B,CACxB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,kCAAkC,WAAW,EAAE,EAC/C,kBAAkB,CACnB,CAAC;IAEF,MAAM,QAAS,CAAC,YAAY,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAE1D,OAAO;QACL,aAAa,EAAE,WAAW;QAC1B,YAAY,EAAE,QAAQ;QACtB,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,OAAe,EACf,IAAa,EACb,QAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,QAAS,CAAC,YAAY,CAAc,cAAc,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;IAElC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,OAAO,kBAAkB,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,UAAU,OAAO,kBAAkB,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,uBAAuB,OAAO,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,wBAAwB;IACxB,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAE,CAAC;IACnC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvB,yBAAyB;IACzB,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,QAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAChF,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;QACrB,MAAM,QAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvC,YAAY,EAAE,CAAC;IACjB,CAAC;IAED,iCAAiC;IACjC,MAAM,WAAW,GAAG,IAAK,CAAC;IAC1B,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,IAAI,WAAW,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;QACzC,WAAW,CAAC,YAAY,GAAG,OAAO,CAAC;QACnC,mBAAmB,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,MAAM,QAAS,CAAC,YAAY,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAE1D,yBAAyB;IACzB,MAAM,KAAK,GAAG,MAAM,QAAS,CAAC,YAAY,CAAgB,aAAa,CAAC,CAAC;IACzE,IAAI,KAAK,EAAE,YAAY,KAAK,OAAO,EAAE,CAAC;QACpC,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC;QAC7B,MAAM,QAAS,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,UAAoD,EAAE,EACtD,IAAa,EACb,QAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,QAAS,CAAC,YAAY,CAAc,cAAc,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;IAElC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,IAAI,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,IAAI,EAAE,YAAY,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,wCAAwC,IAAI,0CAA0C,CACvF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,QAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACjD,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,kBAAkB,IAAI,MAAM,UAAU,CAAC,MAAM,qDAAqD,CACnG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,iDAAiD,CAAC,CAAC;IACjG,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,SAAS,EAClB,8BAA8B,OAAO,CAAC,UAAU,kBAAkB,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;YAChC,MAAM,QAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACvC,eAAe,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,eAAe;IACf,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,MAAM,QAAS,CAAC,YAAY,CAAC,cAAc,EAAE,IAAK,CAAC,CAAC;IAEpD,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,eAAe;QACf,YAAY,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;KACzC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,0BAA0B,CACjC,IAAiB,EACjB,KAAa,EACb,cAAiD,EACjD,SAAwB,EACxB,MAAc,EACd,SAAiB;IAEjB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;QACrB,KAAK;QACL,cAAc;QACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS;QACT,SAAS;QACT,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/pipeline/index.js

@@ -0,0 +1,10 @@
+/**
+ * Pipeline core module — barrel export.
+ *
+ * Re-exports pipeline phase operations from the core layer.
+ *
+ * @task T5709
+ * @epic T5701
+ */
+export { listPhases, showPhase } from './phase.js';
+//# sourceMappingURL=index.js.map

package/dist/pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/pipeline/phase.js

@@ -0,0 +1,45 @@
+/**
+ * Pipeline Phase Operations
+ *
+ * Core functions for phase management used by dispatch layer.
+ * Thin wrappers around src/core/phases for dispatch compatibility.
+ *
+ * @task T5326
+ * @epic T5323
+ */
+import { listPhases as coreListPhases, showPhase as coreShowPhase, } from '../phases/index.js';
+/**
+ * List all phases with status summaries.
+ * @task T5326
+ */
+export async function listPhases(projectRoot, accessor) {
+    try {
+        const result = await coreListPhases(projectRoot, accessor);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            error: { code: 'E_PHASE_LIST_FAILED', message },
+        };
+    }
+}
+/**
+ * Show phase details by slug or current phase.
+ * @task T5326
+ */
+export async function showPhase(projectRoot, phaseId, accessor) {
+    try {
+        const result = await coreShowPhase(phaseId, projectRoot, accessor);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            error: { code: 'E_PHASE_SHOW_FAILED', message },
+        };
+    }
+}
+//# sourceMappingURL=phase.js.map

package/dist/pipeline/phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.js","sourceRoot":"","sources":["../../src/pipeline/phase.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,IAAI,cAAc,EAC5B,SAAS,IAAI,aAAa,GAG3B,MAAM,oBAAoB,CAAC;AAG5B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,QAAuB;IAMvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE;SAChD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,OAAgB,EAChB,QAAuB;IAMvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QACnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE;SAChD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/platform.js

@@ -0,0 +1,211 @@
+/**
+ * Platform compatibility layer.
+ *
+ * Detects the runtime platform and provides cross-platform utilities
+ * for timestamps, checksums, temp files, and tool detection.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { execFileSync } from 'node:child_process';
+import { createHash, randomBytes } from 'node:crypto';
+import { existsSync, statSync } from 'node:fs';
+import { freemem, homedir, hostname, release as osRelease, type as osType, tmpdir, totalmem, } from 'node:os';
+import { join } from 'node:path';
+/** Detect the current platform. */
+export function detectPlatform() {
+    switch (process.platform) {
+        case 'linux':
+            return 'linux';
+        case 'darwin':
+            return 'macos';
+        case 'win32':
+            return 'windows';
+        default:
+            return 'unknown';
+    }
+}
+/** Cached platform value. */
+export const PLATFORM = detectPlatform();
+/** Check if a command exists on PATH. */
+export function commandExists(command) {
+    try {
+        execFileSync('which', [command], { stdio: ['pipe', 'pipe', 'pipe'] });
+        return true;
+    }
+    catch {
+        // On Windows, 'which' may not exist
+        if (PLATFORM === 'windows') {
+            try {
+                execFileSync('where', [command], { stdio: ['pipe', 'pipe', 'pipe'] });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        return false;
+    }
+}
+/** Require a tool to be available, returning an error message if missing. */
+export function requireTool(tool, installHint) {
+    if (commandExists(tool)) {
+        return { available: true };
+    }
+    let error = `Required tool not found: ${tool}`;
+    if (installHint)
+        error += `. Install with: ${installHint}`;
+    return { available: false, error };
+}
+/** Check all required tools. */
+export function checkRequiredTools(tools) {
+    const missing = [];
+    for (const tool of tools) {
+        if (!commandExists(tool.name)) {
+            missing.push(tool.name);
+        }
+    }
+    return { allAvailable: missing.length === 0, missing };
+}
+/** Get ISO 8601 UTC timestamp. */
+export function getIsoTimestamp() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/** Convert ISO timestamp to epoch seconds. */
+export function isoToEpoch(isoTimestamp) {
+    return Math.floor(new Date(isoTimestamp).getTime() / 1000);
+}
+/** Get ISO date for N days ago. */
+export function dateDaysAgo(days) {
+    const d = new Date();
+    d.setDate(d.getDate() - days);
+    return d.toISOString();
+}
+/** Get file size in bytes. */
+export function getFileSize(filePath) {
+    if (!existsSync(filePath))
+        return 0;
+    return statSync(filePath).size;
+}
+/** Get file modification time as ISO string. */
+export function getFileMtime(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    return statSync(filePath).mtime.toISOString();
+}
+/** Generate N random hex characters. */
+export function generateRandomHex(bytes = 6) {
+    return randomBytes(bytes).toString('hex');
+}
+/** Compute SHA-256 checksum of a string. */
+export function sha256(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+/** Create a temporary file path. */
+export function createTempFilePath(prefix = 'cleo-', suffix = '.tmp') {
+    const random = generateRandomHex(8);
+    return join(tmpdir(), `${prefix}${random}${suffix}`);
+}
+/** Minimum required Node.js major version. */
+export const MINIMUM_NODE_MAJOR = 24;
+/** Get Node.js version info. */
+export function getNodeVersionInfo() {
+    const version = process.version.replace('v', '');
+    const [major = 0, minor = 0, patch = 0] = version.split('.').map(Number);
+    return {
+        version,
+        major,
+        minor,
+        patch,
+        meetsMinimum: major >= MINIMUM_NODE_MAJOR,
+    };
+}
+/**
+ * Get platform-specific Node.js upgrade instructions.
+ * Returns actionable install/upgrade guidance based on OS and available tools.
+ */
+export function getNodeUpgradeInstructions() {
+    const platform = detectPlatform();
+    const arch = process.arch;
+    const instructions = [];
+    // Check for version managers first
+    const hasFnm = commandExists('fnm');
+    const hasNvm = commandExists('nvm') || commandExists('nvm.sh');
+    const hasVolta = commandExists('volta');
+    if (hasFnm) {
+        instructions.push(`fnm install ${MINIMUM_NODE_MAJOR} && fnm use ${MINIMUM_NODE_MAJOR}`);
+    }
+    if (hasNvm) {
+        instructions.push(`nvm install ${MINIMUM_NODE_MAJOR} && nvm use ${MINIMUM_NODE_MAJOR}`);
+    }
+    if (hasVolta) {
+        instructions.push(`volta install node@${MINIMUM_NODE_MAJOR}`);
+    }
+    // Platform-specific fallbacks
+    switch (platform) {
+        case 'linux':
+            if (commandExists('dnf')) {
+                instructions.push(`sudo dnf module enable nodejs:${MINIMUM_NODE_MAJOR} && sudo dnf install nodejs`);
+            }
+            else if (commandExists('apt')) {
+                instructions.push(`curl -fsSL https://deb.nodesource.com/setup_${MINIMUM_NODE_MAJOR}.x | sudo -E bash - && sudo apt install -y nodejs`);
+            }
+            else if (commandExists('pacman')) {
+                instructions.push(`sudo pacman -S nodejs`);
+            }
+            else if (commandExists('apk')) {
+                instructions.push(`apk add nodejs npm`);
+            }
+            break;
+        case 'macos':
+            if (commandExists('brew')) {
+                instructions.push(`brew install node@${MINIMUM_NODE_MAJOR}`);
+            }
+            break;
+        case 'windows':
+            instructions.push(`winget install OpenJS.NodeJS.LTS`);
+            break;
+    }
+    // Universal fallback
+    if (!hasFnm && !hasNvm && !hasVolta) {
+        instructions.push(`curl -fsSL https://fnm.vercel.app/install | bash && fnm install ${MINIMUM_NODE_MAJOR}`);
+    }
+    instructions.push(`https://nodejs.org/en/download/`);
+    const recommended = instructions[0] ?? `https://nodejs.org/en/download/`;
+    return { platform, arch, instructions, recommended };
+}
+/**
+ * Gather a snapshot of the host system.
+ *
+ * This is the SSoT for system information. Use this instead of
+ * scattering `process.platform` / `os.type()` calls throughout
+ * the codebase.
+ *
+ * Use cases:
+ *   - Logger base context (every log entry carries platform info)
+ *   - Error reports and issue submission
+ *   - Doctor diagnostics
+ *   - Startup health check results
+ */
+export function getSystemInfo() {
+    return {
+        platform: process.platform,
+        arch: process.arch,
+        osType: osType(),
+        osRelease: osRelease(),
+        nodeVersion: process.version.replace('v', ''),
+        totalMemory: totalmem(),
+        freeMemory: freemem(),
+        hostname: hostname(),
+        homeDir: homedir(),
+    };
+}
+// =============================================================================
+// File I/O re-exports
+//
+// dispatch/engines/ must import from core/, not store/ directly (ADR-008).
+// These re-exports make store/file-utils available to the engine layer via
+// the core boundary without creating inverted dependencies.
+// =============================================================================
+export { getDataPath, readJsonFile, resolveProjectRoot, writeJsonFileAtomic, } from './store/file-utils.js';
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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