@cleocode/core 2026.3.38 → 2026.3.40

package/dist/lifecycle/index.d.ts

@@ -1,228 +0,0 @@
-/**
- * RCASD-IVTR pipeline lifecycle - stage transitions and gate enforcement.
- *
- * CANONICAL EXPORTS: `stages.ts` is the single source of truth for stage
- * definitions, ordering, prerequisites, and transition rules. This file
- * re-exports canonical types and provides SQLite-native lifecycle operations
- * backed by `lifecycle_pipelines`, `lifecycle_stages`, and
- * `lifecycle_gate_results` tables.
- *
- * @task T4467
- * @task T4800 - Unified lifecycle barrel export
- * @task T4798 - RCASD rename (Phase 1: code-only, no disk paths)
- * @epic T4454
- */
-import { LIFECYCLE_STAGE_STATUSES } from '../store/tasks-schema.js';
-export { CONTRIBUTION_STAGE, checkTransition, DECISION_STAGES, DELIVERY_STAGES, EXECUTION_STAGES, FIRST_STAGE, getDependents, getNextStage, getPrerequisites, getPreviousStage, getSkippableStages, getStageOrder, getStagesBetween, getStagesByCategory, isPrerequisite, isStageAfter, isStageBefore, isValidStage, isValidStageStatus, LAST_STAGE, PIPELINE_STAGES, PLANNING_STAGES, STAGE_COUNT, STAGE_DEFINITIONS as CANONICAL_STAGE_DEFINITIONS, STAGE_ORDER, STAGE_PREREQUISITES as CANONICAL_PREREQUISITES, type Stage, type StageCategory, type StageDefinition, type StageStatus, VALIDATION_STAGES, validateStage, } from './stages.js';
-import type { Stage } from './stages.js';
-/** Lifecycle enforcement modes. */
-export type EnforcementMode = 'strict' | 'advisory' | 'off';
-/** Gate data within a stage. */
-export interface GateData {
-    status: 'passed' | 'failed' | 'pending';
-    agent?: string;
-    notes?: string;
-    reason?: string;
-    timestamp?: string;
-}
-/** Stage data in an on-disk manifest. */
-export interface ManifestStageData {
-    status: (typeof LIFECYCLE_STAGE_STATUSES)[number];
-    completedAt?: string;
-    skippedAt?: string;
-    skippedReason?: string;
-    artifacts?: string[];
-    notes?: string;
-    gates?: Record<string, GateData>;
-}
-/**
- * Canonical RCASD manifest-shaped interface for compatibility payloads.
- * Lifecycle persistence is SQLite-native; this shape is used for API
- * responses that present stage+gate state in a manifest-like structure.
- *
- * Stage keys use full canonical names matching the DB CHECK constraint:
- * research, consensus, architecture_decision, specification, decomposition,
- * implementation, validation, testing, release.
- *
- * @task T4798
- */
-export interface RcasdManifest {
-    epicId: string;
-    title?: string;
-    stages: Record<string, ManifestStageData>;
-}
-/** Gate check result. */
-export interface GateCheckResult {
-    allowed: boolean;
-    mode: EnforcementMode;
-    missingPrerequisites: string[];
-    currentStage: string;
-    message: string;
-}
-/** Stage transition result. */
-export interface StageTransitionResult {
-    epicId: string;
-    stage: string;
-    previousStatus: string;
-    newStatus: string;
-    timestamp: string;
-}
-/**
- * Get the current lifecycle state for an epic.
- * @task T4467
- */
-export declare function getLifecycleState(epicId: string, cwd?: string): Promise<RcasdManifest>;
-/**
- * Start a lifecycle stage.
- * @task T4467
- */
-export declare function startStage(epicId: string, stage: string, cwd?: string): Promise<StageTransitionResult>;
-/**
- * Complete a lifecycle stage.
- * @task T4467
- */
-export declare function completeStage(epicId: string, stage: string, artifacts?: string[], cwd?: string): Promise<StageTransitionResult>;
-/**
- * Skip a lifecycle stage.
- * @task T4467
- */
-export declare function skipStage(epicId: string, stage: string, reason: string, cwd?: string): Promise<StageTransitionResult>;
-/**
- * Check lifecycle gate before starting a stage.
- * @task T4467
- */
-export declare function checkGate(epicId: string, targetStage: string, cwd?: string): Promise<GateCheckResult>;
-/**
- * Get lifecycle status for an epic from SQLite.
- * Returns stage progress, current/next stage, and blockers.
- * @task T4801 - SQLite-native implementation
- */
-export declare function getLifecycleStatus(epicId: string, cwd?: string): Promise<{
-    epicId: string;
-    title?: string;
-    currentStage: Stage | null;
-    stages: Array<{
-        stage: string;
-        status: string;
-        completedAt?: string;
-        notes?: string;
-        outputFile?: string;
-        provenanceChain?: Record<string, unknown>;
-    }>;
-    nextStage: Stage | null;
-    blockedOn: string[];
-    initialized: boolean;
-}>;
-/** History entry for stage transitions. */
-export interface LifecycleHistoryEntry {
-    stage: string;
-    action: string;
-    timestamp: string;
-    notes?: string;
-}
-/**
- * Get lifecycle history for an epic.
- * Returns stage transitions and gate events sorted by timestamp.
- * SQLite-native implementation - queries lifecycle_stages and lifecycle_gate_results tables.
- * @task T4785
- * @task T4801
- */
-export declare function getLifecycleHistory(epicId: string, cwd?: string): Promise<{
-    epicId: string;
-    history: LifecycleHistoryEntry[];
-}>;
-/**
- * Get all gate statuses for an epic.
- * @task T4785
- */
-export declare function getLifecycleGates(epicId: string, cwd?: string): Promise<Record<string, Record<string, GateData>>>;
-/**
- * Get prerequisites for a target stage.
- * Pure data function, no I/O.
- * @task T4785
- */
-export declare function getStagePrerequisites(targetStage: string): {
-    prerequisites: string[];
-    stageInfo: {
-        stage: string;
-        name: string;
-        description: string;
-        order: number;
-    } | undefined;
-};
-/**
- * Check if a stage's prerequisites are met for an epic.
- * @task T4785
- */
-export declare function checkStagePrerequisites(epicId: string, targetStage: string, cwd?: string): Promise<{
-    epicId: string;
-    targetStage: string;
-    valid: boolean;
-    canProgress: boolean;
-    missingPrerequisites: string[];
-    issues: Array<{
-        stage: string;
-        severity: string;
-        message: string;
-    }>;
-}>;
-/**
- * Record a stage status transition (progress/record).
- * SQLite-native implementation - T4801
- * @task T4785
- * @task T4801
- */
-export declare function recordStageProgress(epicId: string, stage: string, status: string, notes?: string, cwd?: string): Promise<{
-    epicId: string;
-    stage: string;
-    status: string;
-    timestamp: string;
-}>;
-/**
- * Skip a stage with a reason (engine-compatible).
- * @task T4785
- */
-export declare function skipStageWithReason(epicId: string, stage: string, reason: string, cwd?: string): Promise<{
-    epicId: string;
-    stage: string;
-    reason: string;
-    timestamp: string;
-}>;
-/**
- * Reset a stage to pending (emergency).
- * @task T4785
- */
-export declare function resetStage(epicId: string, stage: string, reason: string, cwd?: string): Promise<{
-    epicId: string;
-    stage: string;
-    reason: string;
-}>;
-/**
- * Mark a gate as passed.
- * SQLite-native implementation - T4801
- * @task T4785
- * @task T4801
- */
-export declare function passGate(epicId: string, gateName: string, agent?: string, notes?: string, cwd?: string): Promise<{
-    epicId: string;
-    gateName: string;
-    timestamp: string;
-}>;
-/**
- * Mark a gate as failed.
- * SQLite-native implementation - T4801
- * @task T4785
- * @task T4801
- */
-export declare function failGate(epicId: string, gateName: string, reason?: string, cwd?: string): Promise<{
-    epicId: string;
-    gateName: string;
-    reason?: string;
-    timestamp: string;
-}>;
-/**
- * List all epic IDs that have lifecycle data.
- * @task T4785
- */
-export declare function listEpicsWithLifecycle(cwd?: string): Promise<string[]>;
-//# sourceMappingURL=index.d.ts.map

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

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