@cleocode/core 2026.3.42 → 2026.3.44

package/dist/lifecycle/pipeline.d.ts

@@ -0,0 +1,335 @@
+/**
+ * Canonical SQLite Pipeline State Machine
+ *
+ * Main pipeline operations for the unified RCASD-IVTR+C lifecycle.
+ * Replaces the scattered _manifest.json approach with a transactional
+ * Drizzle ORM implementation using tasks.db.
+ *
+ * Pipeline Stages (9 stages):
+ *   Research → Consensus → ADR → Spec → Decompose → Implement → Verify → Test → Release
+ *
+ * @task T4800 - Implement Canonical SQLite Pipeline State Machine
+ * @epic T4798 - Lifecycle persistence improvements
+ * @audit T4799 - Three incompatible implementations unified
+ * @depends T4801 - Schema design (lifecycle_pipelines, pipeline_stages tables)
+ * @task T4912 - Pipeline Validation & Tests (SQLite wiring implementation)
+ */
+import type { PipelineStatus } from '@cleocode/contracts';
+import type { Stage, StageStatus } from './stages.js';
+/**
+ * Pipeline entity representing a task's lifecycle state.
+ *
+ * @task T4800
+ * @audit T4799 - Unified pipeline structure replaces scattered manifests
+ */
+export interface Pipeline {
+    /** Unique identifier (task ID format: T####) */
+    id: string;
+    /** Current stage in the pipeline */
+    currentStage: Stage;
+    /** When the pipeline was created */
+    createdAt: Date;
+    /** When the pipeline was last updated */
+    updatedAt: Date;
+    /** Overall pipeline status */
+    status: PipelineStatus;
+    /** Whether the pipeline is currently active (not completed/cancelled) */
+    isActive: boolean;
+    /** When the pipeline completed (if applicable) */
+    completedAt?: Date;
+    /** Cancellation reason (if cancelled) */
+    cancelledReason?: string;
+    /** Number of stage transitions made */
+    transitionCount: number;
+    /** Version for optimistic locking */
+    version: number;
+}
+export type { PipelineStatus };
+/**
+ * Pipeline stage record linking pipeline to individual stages.
+ *
+ * @task T4800
+ * @depends T4801 - Requires pipeline_stages table
+ */
+export interface PipelineStageRecord {
+    /** Unique identifier */
+    id?: string;
+    /** Reference to the pipeline */
+    pipelineId: string;
+    /** Stage name */
+    stage: Stage;
+    /** Stage status */
+    status: StageStatus;
+    /** When the stage was started */
+    startedAt?: Date;
+    /** When the stage was completed */
+    completedAt?: Date;
+    /** Stage duration in milliseconds (computed) */
+    durationMs?: number;
+    /** Assigned agent for this stage */
+    assignedAgent?: string;
+    /** Stage-specific metadata/notes */
+    notes?: string;
+    /** Stage order in pipeline */
+    order: number;
+}
+/**
+ * Pipeline transition record for audit trail.
+ *
+ * @task T4800
+ * @depends T4801 - Requires pipeline_transitions table
+ */
+export interface PipelineTransition {
+    /** Unique identifier */
+    id?: string;
+    /** Pipeline reference */
+    pipelineId: string;
+    /** From stage */
+    fromStage: Stage;
+    /** To stage */
+    toStage: Stage;
+    /** When the transition occurred */
+    transitionedAt: Date;
+    /** Agent/user who initiated the transition */
+    transitionedBy: string;
+    /** Reason for the transition */
+    reason?: string;
+    /** Whether prerequisites were checked */
+    prerequisitesChecked: boolean;
+    /** Any validation errors that occurred */
+    validationErrors?: string[];
+}
+/**
+ * Options for initializing a pipeline.
+ *
+ * @task T4800
+ */
+export interface InitializePipelineOptions {
+    /** Starting stage (defaults to 'research') */
+    startStage?: Stage;
+    /** Initial status (defaults to 'active') */
+    initialStatus?: PipelineStatus;
+    /** Assigning agent */
+    assignedAgent?: string;
+}
+/**
+ * Options for advancing pipeline stage.
+ *
+ * @task T4800
+ */
+export interface AdvanceStageOptions {
+    /** Target stage to advance to */
+    toStage: Stage;
+    /** Reason for the advancement */
+    reason?: string;
+    /** Agent/user initiating the transition */
+    initiatedBy: string;
+    /** Whether to skip prerequisite check (emergency only) */
+    skipPrerequisites?: boolean;
+    /** Whether to force transition even if blocked */
+    force?: boolean;
+}
+/**
+ * Pipeline query options.
+ *
+ * @task T4800
+ */
+export interface PipelineQueryOptions {
+    /** Filter by status */
+    status?: PipelineStatus;
+    /** Filter by current stage */
+    currentStage?: Stage;
+    /** Filter by active state */
+    isActive?: boolean;
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Order by (default: createdAt desc) */
+    orderBy?: 'createdAt' | 'updatedAt' | 'currentStage';
+    /** Order direction */
+    order?: 'asc' | 'desc';
+}
+/**
+ * Initialize a new pipeline for a task.
+ *
+ * Creates a new pipeline record in the database with all 9 stages initialized
+ * to 'not_started' status. The pipeline starts at the research stage by default.
+ *
+ * @param taskId - The task ID (e.g., 'T4800')
+ * @param options - Optional configuration
+ * @throws {CleoError} If pipeline already exists or database operation fails
+ * @returns Promise resolving to the created Pipeline
+ *
+ * @example
+ * ```typescript
+ * const pipeline = await initializePipeline('T4800', {
+ *   startStage: 'research',
+ *   assignedAgent: 'agent-001'
+ * });
+ * console.log(`Pipeline initialized: ${pipeline.id}`);
+ * ```
+ *
+ * @task T4800
+ * @audit T4799 - Replaces scattered _manifest.json creation
+ * @task T4912 - Implemented SQLite wiring
+ */
+export declare function initializePipeline(taskId: string, options?: InitializePipelineOptions): Promise<Pipeline>;
+/**
+ * Retrieve a pipeline by task ID.
+ *
+ * Returns the complete pipeline state including current stage and status.
+ * Returns null if no pipeline exists for the given task ID.
+ *
+ * @param taskId - The task ID (e.g., 'T4800')
+ * @throws {CleoError} If database query fails
+ * @returns Promise resolving to Pipeline or null
+ *
+ * @example
+ * ```typescript
+ * const pipeline = await getPipeline('T4800');
+ * if (pipeline) {
+ *   console.log(`Current stage: ${pipeline.currentStage}`);
+ * }
+ * ```
+ *
+ * @task T4800
+ * @audit T4799 - Replaces JSON manifest reading
+ * @task T4912 - Implemented SQLite wiring
+ */
+export declare function getPipeline(taskId: string): Promise<Pipeline | null>;
+/**
+ * Advance a pipeline to the next stage.
+ *
+ * Performs atomic stage transition with prerequisite checking and audit logging.
+ * Validates the transition is allowed, updates stage statuses, and records
+ * the transition in the audit trail.
+ *
+ * @param taskId - The task ID
+ * @param options - Advance options including target stage and reason
+ * @throws {CleoError} If transition is invalid or prerequisites not met
+ * @returns Promise resolving when transition is complete
+ *
+ * @example
+ * ```typescript
+ * await advanceStage('T4800', {
+ *   toStage: 'consensus',
+ *   reason: 'Research completed, moving to consensus',
+ *   initiatedBy: 'agent-001'
+ * });
+ * ```
+ *
+ * @task T4800
+ * @audit T4799 - Replaces manual manifest updates with transactional approach
+ * @task T4912 - Implemented SQLite wiring
+ */
+export declare function advanceStage(taskId: string, options: AdvanceStageOptions): Promise<void>;
+/**
+ * Get the current stage of a pipeline.
+ *
+ * Convenience method to quickly check which stage a task is currently in.
+ *
+ * @param taskId - The task ID
+ * @throws {CleoError} If database query fails
+ * @returns Promise resolving to the current Stage
+ *
+ * @example
+ * ```typescript
+ * const currentStage = await getCurrentStage('T4800');
+ * if (currentStage === 'validation') {
+ *   console.log('Task is in verification');
+ * }
+ * ```
+ *
+ * @task T4800
+ * @audit T4799 - Replaces JSON manifest stage lookup
+ * @task T4912 - Implemented SQLite wiring
+ */
+export declare function getCurrentStage(taskId: string): Promise<Stage>;
+/**
+ * List pipelines with optional filtering.
+ *
+ * @param options - Query options for filtering and pagination
+ * @throws {CleoError} If database query fails
+ * @returns Promise resolving to array of Pipelines
+ *
+ * @example
+ * ```typescript
+ * const activePipelines = await listPipelines({
+ *   status: 'active',
+ *   limit: 10
+ * });
+ * ```
+ *
+ * @task T4800
+ * @task T4912 - Implemented SQLite wiring
+ */
+export declare function listPipelines(options?: PipelineQueryOptions): Promise<Pipeline[]>;
+/**
+ * Complete a pipeline (mark all stages done).
+ *
+ * Marks the pipeline as completed and sets the completion timestamp.
+ * Only valid when the pipeline is in the 'release' stage.
+ *
+ * @param taskId - The task ID
+ * @param reason - Optional completion reason, stored in the final stage's notes
+ * @throws {CleoError} If pipeline not found or not in releasable state
+ * @returns Promise resolving when complete
+ *
+ * @task T4800
+ * @task T4912 - Implemented SQLite wiring
+ */
+export declare function completePipeline(taskId: string, reason?: string): Promise<void>;
+/**
+ * Cancel a pipeline before completion.
+ *
+ * Marks the pipeline as cancelled (user-initiated). Once cancelled,
+ * the pipeline cannot be resumed (a new one must be created).
+ * Use this for deliberate user decisions to abandon a pipeline.
+ * System-forced terminations should use the 'aborted' status directly.
+ *
+ * @param taskId - The task ID
+ * @param reason - Reason for cancellation
+ * @throws {CleoError} If pipeline not found or already completed
+ * @returns Promise resolving when cancelled
+ *
+ * @task T4800
+ * @task T4912 - Implemented SQLite wiring
+ */
+export declare function cancelPipeline(taskId: string, reason: string): Promise<void>;
+/**
+ * Check if a pipeline exists for a task.
+ *
+ * @param taskId - The task ID
+ * @returns Promise resolving to boolean
+ *
+ * @task T4800
+ * @task T4912 - Implemented SQLite wiring
+ */
+export declare function pipelineExists(taskId: string): Promise<boolean>;
+/**
+ * Get pipeline statistics.
+ *
+ * Returns aggregate counts of pipelines by status and stage.
+ *
+ * @throws {CleoError} If database query fails
+ * @returns Promise resolving to statistics object
+ *
+ * @task T4800
+ * @task T4912 - Implemented SQLite wiring
+ */
+export declare function getPipelineStatistics(): Promise<{
+    total: number;
+    byStatus: Record<PipelineStatus, number>;
+    byStage: Partial<Record<Stage, number>>;
+}>;
+/**
+ * Get all stages for a pipeline.
+ *
+ * @param taskId - The task ID
+ * @returns Promise resolving to array of stage records
+ *
+ * @task T4912
+ */
+export declare function getPipelineStages(taskId: string): Promise<PipelineStageRecord[]>;
+//# sourceMappingURL=pipeline.d.ts.map

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

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

package/dist/lifecycle/rcasd-index.d.ts

@@ -0,0 +1,168 @@
+/**
+ * RCASD-INDEX.json population and querying.
+ *
+ * Scans .cleo/rcasd/ and legacy .cleo/rcsd/ directories to build a master index of all RCASD
+ * pipeline artifacts. Provides lookup functions for task-anchored artifacts,
+ * specs, reports, and pipeline state.
+ *
+ * @task T4801
+ * @epic T4798
+ * @ref schemas/rcasd-index.schema.json (compat: rcsd-index.schema.json)
+ */
+/** RCASD-INDEX.json top-level structure. */
+export interface RcasdIndex {
+    $schema: string;
+    _meta: IndexMeta;
+    authorities: Record<string, string>;
+    taskAnchored: Record<string, TaskAnchor>;
+    specs: SpecEntry[];
+    reports: ReportEntry[];
+    pipeline?: PipelineState;
+    recentChanges?: ChangeEntry[];
+}
+/** Index metadata. */
+export interface IndexMeta {
+    version: string;
+    lastUpdated: string;
+    totals: IndexTotals;
+    checksum?: string;
+}
+/** Aggregate counts. */
+export interface IndexTotals {
+    tasks: number;
+    specs: number;
+    reports: number;
+    activeResearch: number;
+    pendingConsensus: number;
+}
+/** Task-anchored RCASD artifact reference. */
+export interface TaskAnchor {
+    shortName: string;
+    directory: string;
+    spec?: string;
+    report?: string;
+    status?: 'active' | 'paused' | 'completed' | 'failed' | 'archived';
+    pipelineStage: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** Specification entry. */
+export interface SpecEntry {
+    file: string;
+    version: string;
+    status: 'DRAFT' | 'APPROVED' | 'ACTIVE' | 'IMMUTABLE' | 'DEPRECATED';
+    domain: string;
+    taskId: string;
+    lastUpdated: string;
+    category?: string;
+    shortName?: string;
+    synopsis?: string;
+}
+/** Report entry. */
+export interface ReportEntry {
+    file: string;
+    relatedSpec: string;
+    taskId: string;
+    progress: string;
+    lastUpdated: string;
+    phase?: string;
+    notes?: string;
+}
+/** Pipeline state. */
+export interface PipelineState {
+    activeOperations: PipelineOperation[];
+    queuedTasks: string[];
+    lastCompleted?: {
+        taskId: string;
+        stage: string;
+        completedAt: string;
+    };
+}
+/** Active pipeline operation. */
+export interface PipelineOperation {
+    operationId: string;
+    taskId: string;
+    stage: string;
+    startedAt: string;
+    progress?: number;
+    message?: string;
+}
+/** Change entry. */
+export interface ChangeEntry {
+    timestamp: string;
+    taskId: string;
+    changeType: string;
+    stage?: string;
+    description: string;
+}
+/**
+ * Scan .cleo/rcasd/ and legacy .cleo/rcsd/ directories and build the RCASD index.
+ *
+ * Reads all _manifest.json files and any spec/report markdown files to
+ * produce a complete index.
+ *
+ * @param cwd - Working directory
+ * @returns Populated RcasdIndex
+ * @task T4801
+ */
+export declare function buildIndex(cwd?: string): RcasdIndex;
+/**
+ * Write RCASD-INDEX.json to disk.
+ *
+ * @param index - The index to write
+ * @param cwd - Working directory
+ * @task T4801
+ */
+export declare function writeIndex(index: RcasdIndex, cwd?: string): void;
+/**
+ * Read RCASD-INDEX.json from disk.
+ *
+ * @param cwd - Working directory
+ * @returns The index or null if not found
+ * @task T4801
+ */
+export declare function readIndex(cwd?: string): RcasdIndex | null;
+/**
+ * Rebuild and write the index from current disk state.
+ *
+ * @param cwd - Working directory
+ * @returns The rebuilt index
+ * @task T4801
+ */
+export declare function rebuildIndex(cwd?: string): RcasdIndex;
+/**
+ * Get task anchor by task ID.
+ *
+ * @param taskId - The task ID to look up
+ * @param cwd - Working directory
+ * @returns TaskAnchor or null
+ * @task T4801
+ */
+export declare function getTaskAnchor(taskId: string, cwd?: string): TaskAnchor | null;
+/**
+ * Find tasks by pipeline stage.
+ *
+ * @param stage - The pipeline stage to filter by
+ * @param cwd - Working directory
+ * @returns Array of [taskId, anchor] pairs
+ * @task T4801
+ */
+export declare function findByStage(stage: string, cwd?: string): Array<[string, TaskAnchor]>;
+/**
+ * Find tasks by status.
+ *
+ * @param status - The status to filter by
+ * @param cwd - Working directory
+ * @returns Array of [taskId, anchor] pairs
+ * @task T4801
+ */
+export declare function findByStatus(status: 'active' | 'paused' | 'completed' | 'failed' | 'archived', cwd?: string): Array<[string, TaskAnchor]>;
+/**
+ * Get index summary statistics.
+ *
+ * @param cwd - Working directory
+ * @returns Index totals or null
+ * @task T4801
+ */
+export declare function getIndexTotals(cwd?: string): IndexTotals | null;
+//# sourceMappingURL=rcasd-index.d.ts.map

package/dist/lifecycle/rcasd-index.d.ts.map

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

package/dist/lifecycle/rcasd-paths.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Canonical RCASD path helpers for provenance file management.
+ *
+ * All provenance artifacts live under `.cleo/rcasd/{epicId}/` with
+ * stage subdirectories created on-demand.
+ *
+ * @task T5200
+ * @epic T4798
+ */
+/**
+ * Strip suffixes from epic directory names.
+ * E.g. `T4881_install-channels` -> `T4881`
+ *
+ * @param dirName - Directory name that may contain a suffix
+ * @returns The normalized T#### epic ID
+ */
+export declare function normalizeEpicId(dirName: string): string;
+/**
+ * Get the absolute path to the `.cleo/rcasd/` base directory.
+ *
+ * @param cwd - Optional working directory override
+ * @returns Absolute path to the rcasd base directory
+ */
+export declare function getRcasdBaseDir(cwd?: string): string;
+/**
+ * Get the absolute path to `.cleo/rcasd/{epicId}/`.
+ * Uses the normalized epic ID (without suffixes).
+ *
+ * @param epicId - Epic identifier (e.g. `T4881`)
+ * @param cwd - Optional working directory override
+ * @returns Absolute path to the epic directory
+ */
+export declare function getEpicDir(epicId: string, cwd?: string): string;
+/**
+ * Search both `rcasd/` and legacy `rcsd/` for an existing epic directory.
+ * Also checks suffixed directory names (e.g. `T4881_install-channels`
+ * matches `T4881`).
+ *
+ * @param epicId - Epic identifier to search for
+ * @param cwd - Optional working directory override
+ * @returns Absolute path to the found directory, or null
+ */
+export declare function findEpicDir(epicId: string, cwd?: string): string | null;
+/**
+ * Get the stage subdirectory path for an epic.
+ * Uses STAGE_SUBDIRS mapping, falling back to the raw stage name.
+ *
+ * @param epicId - Epic identifier
+ * @param stage - Canonical stage name (e.g. `research`, `contribution`)
+ * @param cwd - Optional working directory override
+ * @returns Absolute path to the stage subdirectory
+ */
+export declare function getStagePath(epicId: string, stage: string, cwd?: string): string;
+/**
+ * Get the stage subdirectory path, creating it if it does not exist.
+ *
+ * @param epicId - Epic identifier
+ * @param stage - Canonical stage name
+ * @param cwd - Optional working directory override
+ * @returns Absolute path to the (now existing) stage subdirectory
+ */
+export declare function ensureStagePath(epicId: string, stage: string, cwd?: string): string;
+/**
+ * Get the manifest path for an epic under the default rcasd directory.
+ *
+ * @param epicId - Epic identifier
+ * @param cwd - Optional working directory override
+ * @returns Absolute path to `.cleo/rcasd/{epicId}/_manifest.json`
+ */
+export declare function getManifestPath(epicId: string, cwd?: string): string;
+/**
+ * Search both `rcasd/` and `rcsd/` for an existing manifest file.
+ * Checks suffixed directory names as well.
+ *
+ * @param epicId - Epic identifier
+ * @param cwd - Optional working directory override
+ * @returns Absolute path to the found manifest, or null
+ */
+export declare function findManifestPath(epicId: string, cwd?: string): string | null;
+/**
+ * Scan the rcasd root directory for loose `T####_*.md` files that are
+ * not inside subdirectories.
+ *
+ * @param cwd - Optional working directory override
+ * @returns Array of file info with extracted epic ID
+ */
+export declare function getLooseResearchFiles(cwd?: string): Array<{
+    file: string;
+    epicId: string;
+    fullPath: string;
+}>;
+/**
+ * List all epic directories across `rcasd/` and `rcsd/`.
+ *
+ * @param cwd - Optional working directory override
+ * @returns Array of epic info with normalized IDs and original directory names
+ */
+export declare function listEpicDirs(cwd?: string): Array<{
+    epicId: string;
+    dirName: string;
+    fullPath: string;
+}>;
+//# sourceMappingURL=rcasd-paths.d.ts.map

package/dist/lifecycle/rcasd-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rcasd-paths.d.ts","sourceRoot":"","sources":["../../src/lifecycle/rcasd-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0BvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMnF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM5E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,CAAC,EAAE,MAAM,GACX,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,CAAC,EAAE,MAAM,GACX,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiC9D"}