@cleocode/core 2.0.0

package/dist/store/cache.js

@@ -0,0 +1,168 @@
+/**
+ * Index caching for O(1) label/phase/hierarchy lookups.
+ * Ported from lib/data/cache.sh
+ *
+ * @epic T4454
+ * @task T4530
+ */
+/**
+ * In-memory cache for task indices with checksum-based staleness detection.
+ */
+export class TaskCache {
+    labelIndex = new Map();
+    phaseIndex = new Map();
+    parentIndex = new Map();
+    childrenIndex = new Map();
+    depthIndex = new Map();
+    checksum = '';
+    initialized = false;
+    /**
+     * Compute a checksum from task data for staleness detection.
+     */
+    computeChecksum(tasks) {
+        return tasks
+            .map((t) => `${t.id}:${t.status}:${t.parentId ?? ''}:${t.phase ?? ''}:${(t.labels ?? []).join(',')}`)
+            .sort()
+            .join('|');
+    }
+    /**
+     * Initialize or rebuild cache from tasks.
+     * Returns true if cache was rebuilt, false if already valid.
+     */
+    init(tasks) {
+        const newChecksum = this.computeChecksum(tasks);
+        if (this.initialized && newChecksum === this.checksum) {
+            return false;
+        }
+        this.buildLabelIndex(tasks);
+        this.buildPhaseIndex(tasks);
+        this.buildHierarchyIndex(tasks);
+        this.checksum = newChecksum;
+        this.initialized = true;
+        return true;
+    }
+    buildLabelIndex(tasks) {
+        this.labelIndex.clear();
+        for (const task of tasks) {
+            if (!task.labels?.length)
+                continue;
+            for (const label of task.labels) {
+                const existing = this.labelIndex.get(label) ?? [];
+                existing.push(task.id);
+                this.labelIndex.set(label, existing);
+            }
+        }
+    }
+    buildPhaseIndex(tasks) {
+        this.phaseIndex.clear();
+        for (const task of tasks) {
+            if (!task.phase)
+                continue;
+            const existing = this.phaseIndex.get(task.phase) ?? [];
+            existing.push(task.id);
+            this.phaseIndex.set(task.phase, existing);
+        }
+    }
+    buildHierarchyIndex(tasks) {
+        this.parentIndex.clear();
+        this.childrenIndex.clear();
+        this.depthIndex.clear();
+        const taskMap = new Map(tasks.map((t) => [t.id, t]));
+        for (const task of tasks) {
+            this.parentIndex.set(task.id, task.parentId ?? null);
+            if (task.parentId) {
+                const siblings = this.childrenIndex.get(task.parentId) ?? [];
+                siblings.push(task.id);
+                this.childrenIndex.set(task.parentId, siblings);
+            }
+        }
+        // Compute depths
+        for (const task of tasks) {
+            let depth = 0;
+            let current = task;
+            const visited = new Set();
+            while (current.parentId && !visited.has(current.parentId)) {
+                visited.add(current.parentId);
+                const parent = taskMap.get(current.parentId);
+                if (!parent)
+                    break;
+                depth++;
+                current = parent;
+            }
+            this.depthIndex.set(task.id, depth);
+        }
+    }
+    /** Get task IDs by label. */
+    getTasksByLabel(label) {
+        return this.labelIndex.get(label) ?? [];
+    }
+    /** Get task IDs by phase. */
+    getTasksByPhase(phase) {
+        return this.phaseIndex.get(phase) ?? [];
+    }
+    /** Get all labels. */
+    getAllLabels() {
+        return [...this.labelIndex.keys()];
+    }
+    /** Get all phases. */
+    getAllPhases() {
+        return [...this.phaseIndex.keys()];
+    }
+    /** Get label count for a specific label. */
+    getLabelCount(label) {
+        return this.getTasksByLabel(label).length;
+    }
+    /** Get parent ID for a task. */
+    getParent(taskId) {
+        return this.parentIndex.get(taskId) ?? null;
+    }
+    /** Get children IDs for a task. */
+    getChildren(taskId) {
+        return this.childrenIndex.get(taskId) ?? [];
+    }
+    /** Get depth for a task. */
+    getDepth(taskId) {
+        return this.depthIndex.get(taskId) ?? 0;
+    }
+    /** Get child count. */
+    getChildCount(taskId) {
+        return this.getChildren(taskId).length;
+    }
+    /** Get root tasks (no parent). */
+    getRootTasks() {
+        return [...this.parentIndex.entries()]
+            .filter(([, parent]) => parent === null)
+            .map(([id]) => id);
+    }
+    /** Get leaf tasks (no children). */
+    getLeafTasks() {
+        const parentSet = new Set(this.childrenIndex.keys());
+        return [...this.parentIndex.keys()].filter((id) => !parentSet.has(id) || this.getChildCount(id) === 0);
+    }
+    /** Force invalidation and rebuild. */
+    invalidate() {
+        this.labelIndex.clear();
+        this.phaseIndex.clear();
+        this.parentIndex.clear();
+        this.childrenIndex.clear();
+        this.depthIndex.clear();
+        this.checksum = '';
+        this.initialized = false;
+    }
+    /** Get cache statistics. */
+    getStats() {
+        let maxDepth = 0;
+        for (const d of this.depthIndex.values()) {
+            if (d > maxDepth)
+                maxDepth = d;
+        }
+        return {
+            initialized: this.initialized,
+            labelCount: this.labelIndex.size,
+            phaseCount: this.phaseIndex.size,
+            taskCount: this.parentIndex.size,
+            maxDepth,
+        };
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/store/cache.js.map

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

package/dist/store/chain-schema.d.ts

@@ -0,0 +1,319 @@
+/**
+ * Drizzle ORM schema for WarpChain storage in tasks.db.
+ *
+ * Tables: warp_chains, warp_chain_instances
+ * Stores chain definitions and runtime instances bound to epics.
+ *
+ * @task T5403
+ */
+/** Chain instance status values. */
+export declare const WARP_CHAIN_INSTANCE_STATUSES: readonly ["pending", "active", "completed", "failed", "cancelled"];
+/** Stored WarpChain definitions (serialized as JSON). */
+export declare const warpChains: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "warp_chains";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chains";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chains";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        version: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chains";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        description: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chains";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        definition: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chains";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        validated: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chains";
+            dataType: "boolean";
+            data: boolean;
+            driverParam: number;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chains";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chains";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: "sqlite";
+}>;
+/** Runtime chain instances bound to epics. */
+export declare const warpChainInstances: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "warp_chain_instances";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        chainId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        epicId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        variables: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        stageToTask: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        currentStage: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        gateResults: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "warp_chain_instances";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: "sqlite";
+}>;
+export type WarpChainRow = typeof warpChains.$inferSelect;
+export type NewWarpChainRow = typeof warpChains.$inferInsert;
+export type WarpChainInstanceRow = typeof warpChainInstances.$inferSelect;
+export type NewWarpChainInstanceRow = typeof warpChainInstances.$inferInsert;
+//# sourceMappingURL=chain-schema.d.ts.map

package/dist/store/chain-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-schema.d.ts","sourceRoot":"","sources":["../../src/store/chain-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,oCAAoC;AACpC,eAAO,MAAM,4BAA4B,oEAM/B,CAAC;AAIX,yDAAyD;AACzD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAatB,CAAC;AAIF,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB9B,CAAC;AAIF,MAAM,MAAM,YAAY,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC;AAC7D,MAAM,MAAM,oBAAoB,GAAG,OAAO,kBAAkB,CAAC,YAAY,CAAC;AAC1E,MAAM,MAAM,uBAAuB,GAAG,OAAO,kBAAkB,CAAC,YAAY,CAAC"}

package/dist/store/chain-schema.js

@@ -0,0 +1,51 @@
+/**
+ * Drizzle ORM schema for WarpChain storage in tasks.db.
+ *
+ * Tables: warp_chains, warp_chain_instances
+ * Stores chain definitions and runtime instances bound to epics.
+ *
+ * @task T5403
+ */
+import { sql } from 'drizzle-orm';
+import { index, integer, sqliteTable, text } from 'drizzle-orm/sqlite-core';
+/** Chain instance status values. */
+export const WARP_CHAIN_INSTANCE_STATUSES = [
+    'pending',
+    'active',
+    'completed',
+    'failed',
+    'cancelled',
+];
+// === WARP_CHAINS TABLE ===
+/** Stored WarpChain definitions (serialized as JSON). */
+export const warpChains = sqliteTable('warp_chains', {
+    id: text('id').primaryKey(),
+    name: text('name').notNull(),
+    version: text('version').notNull(),
+    description: text('description'),
+    definition: text('definition').notNull(), // JSON-serialized WarpChain
+    validated: integer('validated', { mode: 'boolean' }).default(false),
+    createdAt: text('created_at').default(sql `(datetime('now'))`),
+    updatedAt: text('updated_at').default(sql `(datetime('now'))`),
+}, (table) => [index('idx_warp_chains_name').on(table.name)]);
+// === WARP_CHAIN_INSTANCES TABLE ===
+/** Runtime chain instances bound to epics. */
+export const warpChainInstances = sqliteTable('warp_chain_instances', {
+    id: text('id').primaryKey(),
+    chainId: text('chain_id')
+        .notNull()
+        .references(() => warpChains.id),
+    epicId: text('epic_id').notNull(),
+    variables: text('variables'), // JSON
+    stageToTask: text('stage_to_task'), // JSON
+    status: text('status').notNull().default('pending'),
+    currentStage: text('current_stage'),
+    gateResults: text('gate_results'), // JSON array of GateResult
+    createdAt: text('created_at').default(sql `(datetime('now'))`),
+    updatedAt: text('updated_at').default(sql `(datetime('now'))`),
+}, (table) => [
+    index('idx_warp_instances_chain').on(table.chainId),
+    index('idx_warp_instances_epic').on(table.epicId),
+    index('idx_warp_instances_status').on(table.status),
+]);
+//# sourceMappingURL=chain-schema.js.map

package/dist/store/chain-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-schema.js","sourceRoot":"","sources":["../../src/store/chain-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE5E,oCAAoC;AACpC,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,SAAS;IACT,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC;AAEX,4BAA4B;AAE5B,yDAAyD;AACzD,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CACnC,aAAa,EACb;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;IAChC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,EAAE,4BAA4B;IACtE,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACnE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;IAC7D,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;CAC9D,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAC1D,CAAC;AAEF,qCAAqC;AAErC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAC3C,sBAAsB,EACtB;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;SACtB,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;IAClC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IACjC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO;IACrC,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,OAAO;IAC3C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACnD,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC;IACnC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,2BAA2B;IAC9D,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;IAC7D,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;CAC9D,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IACnD,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;IACjD,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;CACpD,CACF,CAAC"}

package/dist/store/converters.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared row <-> domain conversion functions for SQLite store modules.
+ *
+ * Eliminates duplication across sqlite-data-accessor.ts, task-store.ts,
+ * and session-store.ts.
+ */
+import type { Task } from '@cleocode/contracts';
+import type { NewTaskRow, SessionRow, TaskRow } from './tasks-schema.js';
+import type { Session } from './validation-schemas.js';
+/** Convert a database TaskRow to a domain Task object. */
+export declare function rowToTask(row: TaskRow): Task;
+/** Convert a domain Task to a database row for insert/upsert. */
+export declare function taskToRow(task: Partial<Task> & {
+    id: string;
+}): NewTaskRow;
+/** Convert a domain Task to a row suitable for archived tasks. */
+export declare function archivedTaskToRow(task: Task): NewTaskRow;
+/** Convert a SessionRow to a domain Session. */
+export declare function rowToSession(row: SessionRow): Session;
+//# sourceMappingURL=converters.d.ts.map

package/dist/store/converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../src/store/converters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAgD,MAAM,qBAAqB,CAAC;AAG9F,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAA8B,MAAM,yBAAyB,CAAC;AAEnF,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAqC5C;AAED,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CA+B1E;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAOxD;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CA8BrD"}