@cleocode/core 2026.3.42 → 2026.3.44

package/dist/lifecycle/stages.d.ts

@@ -0,0 +1,323 @@
+/**
+ * Pipeline Stage Definitions and Transitions
+ *
+ * Defines the 9-stage RCASD-IVTR pipeline with stage metadata,
+ * transition rules, and prerequisite mappings.
+ *
+ * Stages (in order):
+ *   1. Research              - Information gathering and exploration
+ *   2. Consensus             - Multi-agent decisions and validation
+ *   3. Architecture Decision - Architecture Decision Records
+ *   4. Specification         - Specification and documentation
+ *   5. Decomposition         - Task breakdown and planning
+ *   6. Implementation        - Code execution and building
+ *   7. Validation            - Static analysis, type checking, quality gates
+ *   8. Testing               - Test execution and coverage
+ *   9. Release               - Version management and publishing
+ *
+ * @task T4800 - Implement Canonical SQLite Pipeline State Machine
+ * @epic T4798 - Lifecycle persistence improvements
+ * @audit T4799 - Unified stage names (replaces scattered definitions)
+ *
+ * NOTE: This file provides the canonical stage definitions. All other
+ * stage definitions in the codebase should reference these.
+ * Stage names MUST match the DB CHECK constraint in lifecycle_stages.stage_name.
+ */
+/**
+ * Canonical pipeline stages in execution order.
+ *
+ * This is the single source of truth for stage names across CLEO.
+ * All other stage arrays should be derived from this.
+ * Names match the SQLite CHECK constraint on lifecycle_stages.stage_name.
+ *
+ * @task T4800
+ * @audit T4799 - Consolidates: RCASD_STAGES, EXECUTION_STAGES, ENGINE_LIFECYCLE_STAGES
+ */
+import type { StageStatus } from '@cleocode/contracts';
+export declare const PIPELINE_STAGES: readonly ["research", "consensus", "architecture_decision", "specification", "decomposition", "implementation", "validation", "testing", "release"];
+/**
+ * Cross-cutting contribution stage.
+ * Not part of the pipeline execution order, but tracked in the schema
+ * for attribution and provenance recording.
+ *
+ * @task T4800
+ */
+export declare const CONTRIBUTION_STAGE: "contribution";
+/**
+ * Stage type derived from canonical stage list.
+ *
+ * @task T4800
+ */
+export type Stage = (typeof PIPELINE_STAGES)[number];
+/**
+ * Stage status values.
+ *
+ * @task T4800
+ * @audit T4799 - Unifies: StageStatus, EngineStageStatus
+ */
+export type { StageStatus };
+/**
+ * Stage category for grouping related stages.
+ *
+ * @task T4800
+ */
+export type StageCategory = 'planning' | 'decision' | 'execution' | 'validation' | 'delivery';
+/**
+ * Stage metadata with descriptive information.
+ *
+ * @task T4800
+ */
+export interface StageDefinition {
+    /** Stage identifier */
+    stage: Stage;
+    /** Display name for the stage */
+    name: string;
+    /** Detailed description of what happens in this stage */
+    description: string;
+    /** Execution order (1-based) */
+    order: number;
+    /** Category for grouping */
+    category: StageCategory;
+    /** Whether this stage can be skipped */
+    skippable: boolean;
+    /** Default timeout in hours (null = no timeout) */
+    defaultTimeoutHours: number | null;
+    /** Required gate checks before completing this stage */
+    requiredGates: string[];
+    /** Expected artifacts produced by this stage */
+    expectedArtifacts: string[];
+}
+/**
+ * Canonical stage definitions with complete metadata.
+ *
+ * @task T4800
+ * @audit T4799 - Replaces legacy STAGE_DEFINITIONS from index.ts
+ */
+export declare const STAGE_DEFINITIONS: Record<Stage, StageDefinition>;
+/**
+ * Stage order mapping for quick lookups.
+ *
+ * @task T4800
+ */
+export declare const STAGE_ORDER: Record<Stage, number>;
+/**
+ * Get the order/index of a stage (1-based).
+ *
+ * @param stage - The stage to look up
+ * @returns The stage order (1-9)
+ *
+ * @task T4800
+ */
+export declare function getStageOrder(stage: Stage): number;
+/**
+ * Check if stage A comes before stage B in the pipeline.
+ *
+ * @param stageA - First stage to compare
+ * @param stageB - Second stage to compare
+ * @returns True if stageA comes before stageB
+ *
+ * @task T4800
+ */
+export declare function isStageBefore(stageA: Stage, stageB: Stage): boolean;
+/**
+ * Check if stage A comes after stage B in the pipeline.
+ *
+ * @param stageA - First stage to compare
+ * @param stageB - Second stage to compare
+ * @returns True if stageA comes after stageB
+ *
+ * @task T4800
+ */
+export declare function isStageAfter(stageA: Stage, stageB: Stage): boolean;
+/**
+ * Get the next stage in the pipeline.
+ *
+ * @param stage - Current stage
+ * @returns The next stage, or null if at the end
+ *
+ * @task T4800
+ */
+export declare function getNextStage(stage: Stage): Stage | null;
+/**
+ * Get the previous stage in the pipeline.
+ *
+ * @param stage - Current stage
+ * @returns The previous stage, or null if at the start
+ *
+ * @task T4800
+ */
+export declare function getPreviousStage(stage: Stage): Stage | null;
+/**
+ * Get all stages between two stages (inclusive).
+ *
+ * @param from - Starting stage
+ * @param to - Ending stage
+ * @returns Array of stages between from and to
+ *
+ * @task T4800
+ */
+export declare function getStagesBetween(from: Stage, to: Stage): Stage[];
+/**
+ * Prerequisites for each stage - which stages must be completed before entering.
+ *
+ * @task T4800
+ * @audit T4799 - Canonical prerequisite map
+ */
+export declare const STAGE_PREREQUISITES: Record<Stage, Stage[]>;
+/**
+ * Get prerequisites for a stage.
+ *
+ * @param stage - The stage to get prerequisites for
+ * @returns Array of prerequisite stages
+ *
+ * @task T4800
+ */
+export declare function getPrerequisites(stage: Stage): Stage[];
+/**
+ * Check if one stage is a prerequisite of another.
+ *
+ * @param potentialPrereq - Stage that might be a prerequisite
+ * @param stage - Stage to check against
+ * @returns True if potentialPrereq is required before stage
+ *
+ * @task T4800
+ */
+export declare function isPrerequisite(potentialPrereq: Stage, stage: Stage): boolean;
+/**
+ * Get all stages that depend on a given stage.
+ *
+ * @param stage - The stage to find dependents for
+ * @returns Array of stages that require this stage
+ *
+ * @task T4800
+ */
+export declare function getDependents(stage: Stage): Stage[];
+/**
+ * Check if a stage name is valid.
+ *
+ * @param stage - Stage name to validate
+ * @returns True if valid stage name
+ *
+ * @task T4800
+ */
+export declare function isValidStage(stage: string): stage is Stage;
+/**
+ * Validate a stage name and throw if invalid.
+ *
+ * @param stage - Stage name to validate
+ * @throws {Error} If stage is invalid
+ * @returns The validated Stage
+ *
+ * @task T4800
+ */
+export declare function validateStage(stage: string): Stage;
+/**
+ * Check if a stage status is valid.
+ *
+ * @param status - Status to validate
+ * @returns True if valid status
+ *
+ * @task T4800
+ */
+export declare function isValidStageStatus(status: string): status is StageStatus;
+/**
+ * Get stages by category.
+ *
+ * @param category - Category to filter by
+ * @returns Array of stages in that category
+ *
+ * @task T4800
+ */
+export declare function getStagesByCategory(category: StageCategory): Stage[];
+/**
+ * Get skippable stages.
+ *
+ * @returns Array of stages that can be skipped
+ *
+ * @task T4800
+ */
+export declare function getSkippableStages(): Stage[];
+/**
+ * Transition rule - defines if a transition is allowed.
+ *
+ * @task T4800
+ */
+export interface TransitionRule {
+    from: Stage | 'any';
+    to: Stage | 'any';
+    allowed: boolean;
+    requiresForce?: boolean;
+    reason?: string;
+}
+/**
+ * Allowed transitions between stages.
+ *
+ * By default, stages progress linearly. These rules define exceptions.
+ *
+ * @task T4800
+ */
+export declare const TRANSITION_RULES: TransitionRule[];
+/**
+ * Check if a transition is allowed.
+ *
+ * @param from - Source stage
+ * @param to - Target stage
+ * @param force - Whether to allow forced transitions
+ * @returns Object with allowed flag and reason
+ *
+ * @task T4800
+ */
+export declare function checkTransition(from: Stage, to: Stage, force?: boolean): {
+    allowed: boolean;
+    requiresForce: boolean;
+    reason?: string;
+};
+/**
+ * Total number of stages in the pipeline.
+ *
+ * @task T4800
+ */
+export declare const STAGE_COUNT: 9;
+/**
+ * First stage in the pipeline.
+ *
+ * @task T4800
+ */
+export declare const FIRST_STAGE: Stage;
+/**
+ * Last stage in the pipeline.
+ *
+ * @task T4800
+ */
+export declare const LAST_STAGE: Stage;
+/**
+ * Planning stages.
+ *
+ * @task T4800
+ */
+export declare const PLANNING_STAGES: Stage[];
+/**
+ * Decision stages.
+ *
+ * @task T4800
+ */
+export declare const DECISION_STAGES: Stage[];
+/**
+ * Execution stages (canonical).
+ *
+ * @task T4800
+ */
+export declare const EXECUTION_STAGES: Stage[];
+/**
+ * Validation stages.
+ *
+ * @task T4800
+ */
+export declare const VALIDATION_STAGES: Stage[];
+/**
+ * Delivery stages.
+ *
+ * @task T4800
+ */
+export declare const DELIVERY_STAGES: Stage[];
+//# sourceMappingURL=stages.d.ts.map

package/dist/lifecycle/stages.d.ts.map

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

package/dist/lifecycle/state-machine.d.ts

@@ -0,0 +1,327 @@
+/**
+ * Pipeline State Machine - Core Logic
+ *
+ * Implements the finite state machine for pipeline lifecycle management.
+ * Handles state transitions, prerequisite validation, and transition history.
+ *
+ * State Machine States:
+ *   not_started → in_progress → completed
+ *                        ↓
+ *                   blocked/failed
+ *                        ↓
+ *                    skipped
+ *
+ * @task T4800 - Implement Canonical SQLite Pipeline State Machine
+ * @epic T4798 - Lifecycle persistence improvements
+ * @audit T4799 - Unified state machine replaces scattered logic
+ * @depends T4801 - Schema design
+ * @depends stages.ts - Stage definitions and transition rules
+ */
+import type { Stage, StageStatus } from './stages.js';
+/**
+ * Prerequisite check result.
+ *
+ * @task T4800
+ */
+export interface PrereqCheck {
+    /** Whether all prerequisites are met */
+    met: boolean;
+    /** List of prerequisite stages */
+    prerequisites: Stage[];
+    /** Stages that are completed or skipped */
+    completed: Stage[];
+    /** Stages that are pending or blocked */
+    pending: Stage[];
+    /** Stages that failed */
+    failed: Stage[];
+    /** Blocking issues preventing progression */
+    blockers: Array<{
+        stage: Stage;
+        reason: string;
+        severity: 'error' | 'warning' | 'info';
+    }>;
+    /** Whether the check can be overridden with force */
+    canForce: boolean;
+    /** Human-readable summary */
+    summary: string;
+}
+/**
+ * Transition validation result.
+ *
+ * @task T4800
+ */
+export interface TransitionValidation {
+    /** Whether the transition is valid */
+    valid: boolean;
+    /** Source stage */
+    from: Stage;
+    /** Target stage */
+    to: Stage;
+    /** Whether prerequisites are met */
+    prerequisitesMet: boolean;
+    /** Whether the transition rule allows it */
+    ruleAllowed: boolean;
+    /** Whether force is required */
+    requiresForce: boolean;
+    /** List of validation errors */
+    errors: string[];
+    /** List of warnings */
+    warnings: string[];
+    /** Prerequisite check details */
+    prereqCheck?: PrereqCheck;
+}
+/**
+ * Stage state snapshot for state machine.
+ *
+ * @task T4800
+ */
+export interface StageState {
+    stage: Stage;
+    status: StageStatus;
+    startedAt?: Date;
+    completedAt?: Date;
+    assignedAgent?: string;
+    notes?: string;
+}
+/**
+ * State machine context for a pipeline.
+ *
+ * @task T4800
+ */
+export interface StateMachineContext {
+    pipelineId: string;
+    currentStage: Stage;
+    stages: Record<Stage, StageState>;
+    transitionCount: number;
+    version: number;
+}
+/**
+ * State transition request.
+ *
+ * @task T4800
+ */
+export interface StateTransition {
+    from: Stage;
+    to: Stage;
+    reason?: string;
+    initiatedBy: string;
+    force?: boolean;
+    skipValidation?: boolean;
+}
+/**
+ * State transition result.
+ *
+ * @task T4800
+ */
+export interface StateTransitionResult {
+    success: boolean;
+    transition: StateTransition;
+    previousState: StageState;
+    newState: StageState;
+    context: StateMachineContext;
+    timestamp: Date;
+    errors?: string[];
+}
+/**
+ * Check if prerequisites are met for a stage.
+ *
+ * Validates that all prerequisite stages are in an acceptable state
+ * (completed or skipped) for the target stage to proceed.
+ *
+ * @param targetStage - The stage to check prerequisites for
+ * @param currentStages - Current state of all stages
+ * @throws {CleoError} If validation fails
+ * @returns Promise resolving to PrereqCheck result
+ *
+ * @example
+ * ```typescript
+ * const check = await checkPrerequisites('implement', {
+ *   research: { status: 'completed' },
+ *   spec: { status: 'completed' },
+ *   decompose: { status: 'completed' },
+ *   // ... other stages
+ * });
+ * if (check.met) {
+ *   console.log('Ready to implement');
+ * }
+ * ```
+ *
+ * @task T4800
+ * @depends T4801 - Requires pipeline_stages table
+ */
+export declare function checkPrerequisites(targetStage: Stage, currentStages: Record<Stage, StageState>): Promise<PrereqCheck>;
+/**
+ * Validate a stage transition.
+ *
+ * Comprehensive validation that checks both transition rules and prerequisites.
+ * This is the core state machine validation logic.
+ *
+ * @param transition - The transition to validate
+ * @param context - Current state machine context
+ * @throws {CleoError} If validation fails unexpectedly
+ * @returns Promise resolving to TransitionValidation
+ *
+ * @example
+ * ```typescript
+ * const validation = await validateTransition(
+ *   { from: 'spec', to: 'implement', initiatedBy: 'agent-001' },
+ *   pipelineContext
+ * );
+ * if (!validation.valid) {
+ *   console.log(validation.errors);
+ * }
+ * ```
+ *
+ * @task T4800
+ */
+export declare function validateTransition(transition: StateTransition, context: StateMachineContext): Promise<TransitionValidation>;
+/**
+ * Execute a state transition.
+ *
+ * Applies the transition to the state machine context, updating stage statuses
+ * and returning the new state. This function does NOT persist to database -
+ * that is handled by the pipeline module.
+ *
+ * @param transition - The transition to execute
+ * @param context - Current state machine context
+ * @throws {CleoError} If transition is invalid
+ * @returns Promise resolving to StateTransitionResult
+ *
+ * @example
+ * ```typescript
+ * const result = await executeTransition(
+ *   { from: 'spec', to: 'implement', initiatedBy: 'agent-001' },
+ *   pipelineContext
+ * );
+ * if (result.success) {
+ *   console.log(`Transitioned to ${result.newState.stage}`);
+ * }
+ * ```
+ *
+ * @task T4800
+ */
+export declare function executeTransition(transition: StateTransition, context: StateMachineContext): Promise<StateTransitionResult>;
+/**
+ * Set the status of a stage.
+ *
+ * Updates stage status with validation of allowed state transitions.
+ *
+ * @param stage - The stage to update
+ * @param status - The new status
+ * @param context - Current state machine context
+ * @throws {CleoError} If status transition is invalid
+ * @returns Updated StageState
+ *
+ * @task T4800
+ */
+export declare function setStageStatus(stage: Stage, status: StageStatus, context: StateMachineContext): StageState;
+/**
+ * Get the status of a stage.
+ *
+ * @param stage - The stage to check
+ * @param context - Current state machine context
+ * @returns The stage status
+ *
+ * @task T4800
+ */
+export declare function getStageStatus(stage: Stage, context: StateMachineContext): StageStatus;
+/**
+ * Check if a status transition is valid.
+ *
+ * State transitions:
+ *   not_started → in_progress, skipped
+ *   in_progress → completed, blocked, failed
+ *   blocked     → in_progress
+ *   failed      → in_progress (retry)
+ *   completed   → (no transition - use force to override)
+ *   skipped     → (no transition)
+ *
+ * @param from - Current status
+ * @param to - Target status
+ * @returns Object with valid flag and reason
+ *
+ * @task T4800
+ */
+export declare function isValidStatusTransition(from: StageStatus, to: StageStatus): {
+    valid: boolean;
+    reason?: string;
+};
+/**
+ * Create initial state machine context for a pipeline.
+ *
+ * @param pipelineId - The pipeline/task ID
+ * @param assignedAgent - Optional agent to assign
+ * @returns Initial StateMachineContext
+ *
+ * @task T4800
+ */
+export declare function createInitialContext(pipelineId: string, assignedAgent?: string): StateMachineContext;
+/**
+ * Get stages that can be transitioned to from the current stage.
+ *
+ * @param context - Current state machine context
+ * @param includeForce - Whether to include transitions that require force
+ * @returns Array of valid next stages
+ *
+ * @task T4800
+ */
+export declare function getValidNextStages(context: StateMachineContext, includeForce?: boolean): Stage[];
+/**
+ * Get the current stage state.
+ *
+ * @param context - State machine context
+ * @returns Current StageState
+ *
+ * @task T4800
+ */
+export declare function getCurrentStageState(context: StateMachineContext): StageState;
+/**
+ * Check if the pipeline is in a terminal state.
+ *
+ * @param context - State machine context
+ * @returns True if in release stage and completed
+ *
+ * @task T4800
+ */
+export declare function isTerminalState(context: StateMachineContext): boolean;
+/**
+ * Check if the pipeline is blocked.
+ *
+ * @param context - State machine context
+ * @returns True if current stage is blocked
+ *
+ * @task T4800
+ */
+export declare function isBlocked(context: StateMachineContext): boolean;
+/**
+ * Validate multiple transitions.
+ *
+ * @param transitions - Array of transitions to validate
+ * @param context - State machine context
+ * @returns Array of validation results
+ *
+ * @task T4800
+ */
+export declare function validateTransitions(transitions: StateTransition[], context: StateMachineContext): Promise<TransitionValidation[]>;
+/**
+ * Check if a stage can be skipped.
+ *
+ * @param stage - The stage to check
+ * @returns True if stage is skippable
+ *
+ * @task T4800
+ */
+export declare function canSkipStage(stage: Stage): boolean;
+/**
+ * Skip a stage with validation.
+ *
+ * @param stage - The stage to skip
+ * @param reason - Reason for skipping
+ * @param context - State machine context
+ * @throws {CleoError} If stage cannot be skipped
+ * @returns Updated StageState
+ *
+ * @task T4800
+ */
+export declare function skipStage(stage: Stage, reason: string, context: StateMachineContext): StageState;
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/lifecycle/state-machine.d.ts.map

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