@cleocode/core 2026.4.31 → 2026.4.35

package/dist/store/lifecycle-store.js

@@ -0,0 +1,249 @@
+/**
+ * SQLite-backed lifecycle store operations.
+ *
+ * Query and mutation functions for lifecycle pipeline tables:
+ * lifecycle_pipelines, lifecycle_stages, lifecycle_gate_results,
+ * lifecycle_evidence, lifecycle_transitions.
+ *
+ * Used by src/core/lifecycle/resume.ts to avoid direct store-layer imports.
+ *
+ * @task T4832
+ * @epic T4454
+ */
+import { and, asc, desc, eq, inArray, sql } from 'drizzle-orm';
+import { getDb } from './sqlite.js';
+import * as schema from './tasks-schema.js';
+// =============================================================================
+// PIPELINE QUERIES
+// =============================================================================
+/**
+ * Find active pipelines joined with their stages and tasks.
+ * Optionally filters by specific task IDs.
+ *
+ * @param taskIds - Optional list of task IDs to filter by
+ * @param cwd - Working directory for database
+ * @returns Rows with pipeline, stage, and task data
+ */
+export async function findActivePipelinesWithStagesAndTasks(taskIds, cwd) {
+    const db = await getDb(cwd);
+    const conditions = [eq(schema.lifecyclePipelines.status, 'active')];
+    if (taskIds && taskIds.length > 0) {
+        conditions.push(inArray(schema.lifecyclePipelines.taskId, taskIds));
+    }
+    return db
+        .select({
+        pipeline: schema.lifecyclePipelines,
+        stage: schema.lifecycleStages,
+        task: schema.tasks,
+    })
+        .from(schema.lifecyclePipelines)
+        .innerJoin(schema.lifecycleStages, eq(schema.lifecycleStages.pipelineId, schema.lifecyclePipelines.id))
+        .innerJoin(schema.tasks, eq(schema.tasks.id, schema.lifecyclePipelines.taskId))
+        .where(and(...conditions))
+        .orderBy(asc(schema.tasks.priority), desc(schema.lifecyclePipelines.startedAt))
+        .all();
+}
+/**
+ * Find a pipeline with its current stage and task by taskId.
+ * Matches stages where stageName equals the pipeline's currentStageId.
+ *
+ * @param taskId - Task ID to look up
+ * @param cwd - Working directory for database
+ * @returns Matching rows (typically 0 or 1)
+ */
+export async function findPipelineWithCurrentStageAndTask(taskId, cwd) {
+    const db = await getDb(cwd);
+    return db
+        .select({
+        pipeline: schema.lifecyclePipelines,
+        stage: schema.lifecycleStages,
+        task: schema.tasks,
+    })
+        .from(schema.lifecyclePipelines)
+        .innerJoin(schema.lifecycleStages, eq(schema.lifecycleStages.pipelineId, schema.lifecyclePipelines.id))
+        .innerJoin(schema.tasks, eq(schema.tasks.id, schema.lifecyclePipelines.taskId))
+        .where(and(eq(schema.lifecyclePipelines.taskId, taskId), eq(schema.lifecycleStages.stageName, sql `${schema.lifecyclePipelines.currentStageId}`)))
+        .limit(1)
+        .all();
+}
+/**
+ * Find a pipeline and a specific stage by taskId and stageName.
+ *
+ * @param taskId - Task ID
+ * @param stageName - Stage name to match
+ * @param cwd - Working directory for database
+ * @returns Matching rows (typically 0 or 1)
+ */
+export async function findPipelineWithStage(taskId, stageName, cwd) {
+    const db = await getDb(cwd);
+    return db
+        .select({
+        pipeline: schema.lifecyclePipelines,
+        stageRecord: schema.lifecycleStages,
+    })
+        .from(schema.lifecyclePipelines)
+        .innerJoin(schema.lifecycleStages, and(eq(schema.lifecycleStages.pipelineId, schema.lifecyclePipelines.id), eq(schema.lifecycleStages.stageName, stageName)))
+        .where(eq(schema.lifecyclePipelines.taskId, taskId))
+        .limit(1)
+        .all();
+}
+/**
+ * Update pipeline's currentStageId.
+ *
+ * @param pipelineId - Pipeline ID to update
+ * @param currentStageId - New current stage identifier
+ * @param cwd - Working directory for database
+ */
+export async function updatePipelineCurrentStage(pipelineId, currentStageId, cwd) {
+    const db = await getDb(cwd);
+    await db
+        .update(schema.lifecyclePipelines)
+        .set({ currentStageId })
+        .where(eq(schema.lifecyclePipelines.id, pipelineId))
+        .run();
+}
+// =============================================================================
+// STAGE QUERIES
+// =============================================================================
+/**
+ * Get all stages for a pipeline, ordered by sequence.
+ *
+ * @param pipelineId - Pipeline ID
+ * @param cwd - Working directory for database
+ * @returns All stage rows for the pipeline
+ */
+export async function getStagesByPipelineId(pipelineId, cwd) {
+    const db = await getDb(cwd);
+    return db
+        .select()
+        .from(schema.lifecycleStages)
+        .where(eq(schema.lifecycleStages.pipelineId, pipelineId))
+        .orderBy(asc(schema.lifecycleStages.sequence))
+        .all();
+}
+/**
+ * Update a stage's status to 'in_progress' and clear block fields.
+ *
+ * @param stageId - Stage ID to update
+ * @param startedAt - ISO timestamp for when the stage started
+ * @param cwd - Working directory for database
+ */
+export async function activateStage(stageId, startedAt, cwd) {
+    const db = await getDb(cwd);
+    await db
+        .update(schema.lifecycleStages)
+        .set({
+        status: 'in_progress',
+        startedAt,
+        blockedAt: null,
+        blockReason: null,
+    })
+        .where(eq(schema.lifecycleStages.id, stageId))
+        .run();
+}
+/**
+ * Find pipeline with current stage (no task join) by taskId.
+ * Used by checkBlockedStageDetails.
+ *
+ * @param taskId - Task ID
+ * @param cwd - Working directory for database
+ * @returns Matching rows
+ */
+export async function findPipelineWithCurrentStage(taskId, cwd) {
+    const db = await getDb(cwd);
+    return db
+        .select({
+        pipeline: schema.lifecyclePipelines,
+        stageRecord: schema.lifecycleStages,
+    })
+        .from(schema.lifecyclePipelines)
+        .innerJoin(schema.lifecycleStages, eq(schema.lifecycleStages.pipelineId, schema.lifecyclePipelines.id))
+        .where(and(eq(schema.lifecyclePipelines.taskId, taskId), eq(schema.lifecycleStages.stageName, sql `${schema.lifecyclePipelines.currentStageId}`)))
+        .limit(1)
+        .all();
+}
+// =============================================================================
+// GATE RESULT QUERIES
+// =============================================================================
+/**
+ * Get gate results for a stage, ordered by checkedAt descending.
+ *
+ * @param stageId - Stage ID
+ * @param cwd - Working directory for database
+ * @returns Gate result rows
+ */
+export async function getGateResultsByStageId(stageId, cwd) {
+    const db = await getDb(cwd);
+    return db
+        .select()
+        .from(schema.lifecycleGateResults)
+        .where(eq(schema.lifecycleGateResults.stageId, stageId))
+        .orderBy(desc(schema.lifecycleGateResults.checkedAt))
+        .all();
+}
+/**
+ * Get gate results for a stage without ordering (for simple checks).
+ *
+ * @param stageId - Stage ID
+ * @param cwd - Working directory for database
+ * @returns Gate result rows
+ */
+export async function getGateResultsByStageIdUnordered(stageId, cwd) {
+    const db = await getDb(cwd);
+    return db
+        .select()
+        .from(schema.lifecycleGateResults)
+        .where(eq(schema.lifecycleGateResults.stageId, stageId))
+        .all();
+}
+// =============================================================================
+// EVIDENCE QUERIES
+// =============================================================================
+/**
+ * Get evidence for a stage, ordered by recordedAt descending.
+ *
+ * @param stageId - Stage ID
+ * @param cwd - Working directory for database
+ * @returns Evidence rows
+ */
+export async function getEvidenceByStageId(stageId, cwd) {
+    const db = await getDb(cwd);
+    return db
+        .select()
+        .from(schema.lifecycleEvidence)
+        .where(eq(schema.lifecycleEvidence.stageId, stageId))
+        .orderBy(desc(schema.lifecycleEvidence.recordedAt))
+        .all();
+}
+// =============================================================================
+// TRANSITION QUERIES & MUTATIONS
+// =============================================================================
+/**
+ * Get recent transitions for a pipeline, ordered by createdAt descending.
+ *
+ * @param pipelineId - Pipeline ID
+ * @param limit - Max rows to return (default: 10)
+ * @param cwd - Working directory for database
+ * @returns Transition rows
+ */
+export async function getRecentTransitions(pipelineId, limit = 10, cwd) {
+    const db = await getDb(cwd);
+    return db
+        .select()
+        .from(schema.lifecycleTransitions)
+        .where(eq(schema.lifecycleTransitions.pipelineId, pipelineId))
+        .orderBy(desc(schema.lifecycleTransitions.createdAt))
+        .limit(limit)
+        .all();
+}
+/**
+ * Insert a new transition record.
+ *
+ * @param transition - Transition data to insert
+ * @param cwd - Working directory for database
+ */
+export async function insertTransition(transition, cwd) {
+    const db = await getDb(cwd);
+    await db.insert(schema.lifecycleTransitions).values(transition).run();
+}
+//# sourceMappingURL=lifecycle-store.js.map

package/dist/store/lifecycle-store.js.map

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

package/dist/store/lock.js

@@ -0,0 +1,70 @@
+/**
+ * File locking using proper-lockfile.
+ * Prevents concurrent modifications to CLEO data files.
+ * @epic T4454
+ * @task T4457
+ */
+import { ExitCode } from '@cleocode/contracts';
+import lockfile from 'proper-lockfile';
+import { CleoError } from '../errors.js';
+/** Default lock options. */
+const DEFAULT_LOCK_OPTIONS = {
+    retries: {
+        retries: 3,
+        minTimeout: 100,
+        maxTimeout: 1000,
+        factor: 2,
+    },
+    stale: 10_000,
+    realpath: false,
+};
+/**
+ * Acquire an exclusive lock on a file.
+ * Returns a release function that must be called when done.
+ */
+export async function acquireLock(filePath, options) {
+    try {
+        const release = await lockfile.lock(filePath, {
+            ...DEFAULT_LOCK_OPTIONS,
+            ...(options?.stale !== undefined && { stale: options.stale }),
+            ...(options?.retries !== undefined && {
+                retries: {
+                    ...DEFAULT_LOCK_OPTIONS.retries,
+                    retries: options.retries,
+                },
+            }),
+        });
+        return release;
+    }
+    catch (err) {
+        throw new CleoError(ExitCode.LOCK_TIMEOUT, `Failed to acquire lock: ${filePath}`, {
+            fix: `Another process may be writing to this file. Wait and retry.`,
+            cause: err,
+        });
+    }
+}
+/**
+ * Check if a file is currently locked.
+ */
+export async function isLocked(filePath) {
+    try {
+        return await lockfile.check(filePath, { realpath: false });
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Execute a function while holding an exclusive lock on a file.
+ * The lock is automatically released when the function completes (or throws).
+ */
+export async function withLock(filePath, fn, options) {
+    const release = await acquireLock(filePath, options);
+    try {
+        return await fn();
+    }
+    finally {
+        await release();
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/store/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/store/lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,4BAA4B;AAC5B,MAAM,oBAAoB,GAAG;IAC3B,OAAO,EAAE;QACP,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,CAAC;KACV;IACD,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,KAAK;CAChB,CAAC;AAKF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,OAA8C;IAE9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC5C,GAAG,oBAAoB;YACvB,GAAG,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7D,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,IAAI;gBACpC,OAAO,EAAE;oBACP,GAAG,oBAAoB,CAAC,OAAO;oBAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;iBACzB;aACF,CAAC;SACH,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,2BAA2B,QAAQ,EAAE,EAAE;YAChF,GAAG,EAAE,8DAA8D;YACnE,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAgB,EAChB,EAAoB,EACpB,OAA8C;IAE9C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}