@cleocode/core 2026.4.0 → 2026.4.2

package/dist/store/sqlite-data-accessor.js

@@ -1,784 +0,0 @@
-/**
- * SQLite-based implementation of the DataAccessor interface.
- *
- * Materializes TaskFile/ArchiveFile/SessionsFile from SQLite tables,
- * allowing core modules to continue using whole-file data structures
- * while storage is backed by the relational database.
- *
- * Uses existing sqlite.ts engine (node:sqlite / drizzle-orm) and
- * task-store.ts / session-store.ts for row-level operations.
- *
- * @epic T4454
- */
-import { and, eq, inArray, isNull, like, ne, notInArray, or, sql } from 'drizzle-orm';
-import { archivedTaskToRow, rowToSession, rowToTask, taskToRow } from './converters.js';
-import { batchUpdateDependencies, loadDependenciesForTasks, loadRelationsForTasks, updateDependencies, upsertSession, upsertTask, } from './db-helpers.js';
-import { closeDb, getDb, getNativeTasksDb } from './sqlite.js';
-import { TERMINAL_TASK_STATUSES } from './status-registry.js';
-import * as schema from './tasks-schema.js';
-/**
- * Generate a unique audit log entry ID.
- * @task T4837
- */
-function generateAuditLogId() {
-    const epoch = Math.floor(Date.now() / 1000);
-    const rand = Math.random().toString(36).slice(2, 8);
-    return `log-${epoch}-${rand}`;
-}
-// ---- Schema meta helpers ----
-/** Read a JSON blob from the schema_meta table by key. */
-async function getMetaValue(cwd, key) {
-    const db = await getDb(cwd);
-    const rows = await db
-        .select()
-        .from(schema.schemaMeta)
-        .where(eq(schema.schemaMeta.key, key))
-        .all();
-    if (rows.length === 0 || !rows[0])
-        return null;
-    try {
-        return JSON.parse(rows[0].value);
-    }
-    catch {
-        return null;
-    }
-}
-/** Write a JSON blob to the schema_meta table by key. */
-export async function setMetaValue(cwd, key, value) {
-    const db = await getDb(cwd);
-    const json = JSON.stringify(value);
-    await db
-        .insert(schema.schemaMeta)
-        .values({ key, value: json })
-        .onConflictDoUpdate({
-        target: schema.schemaMeta.key,
-        set: { value: json },
-    })
-        .run();
-}
-// ---- Accessor factory ----
-/**
- * Create a SQLite-backed DataAccessor.
- *
- * Opens (or creates) the SQLite database at `.cleo/tasks.db` and returns
- * a DataAccessor that materializes/dematerializes whole-file structures
- * from the relational tables.
- *
- * @param cwd - Working directory for path resolution (defaults to process.cwd())
- */
-export async function createSqliteDataAccessor(cwd) {
-    // Eagerly initialize the database to ensure tables exist
-    await getDb(cwd);
-    /** Load all task IDs for cross-task dependency validation. */
-    async function getAllTaskIds() {
-        const db = await getDb(cwd);
-        const rows = await db.select({ id: schema.tasks.id }).from(schema.tasks).all();
-        return new Set(rows.map((r) => r.id));
-    }
-    const accessor = {
-        engine: 'sqlite',
-        // ---- loadArchive ----
-        async loadArchive() {
-            const db = await getDb(cwd);
-            // Query tasks where status = 'archived'
-            const archivedRows = await db
-                .select()
-                .from(schema.tasks)
-                .where(eq(schema.tasks.status, 'archived'))
-                .all();
-            if (archivedRows.length === 0)
-                return null;
-            const archivedTasks = archivedRows.map((row) => {
-                const task = rowToTask(row);
-                // Restore the original terminal status for the archive representation
-                // but keep the archived metadata accessible
-                return {
-                    ...task,
-                    // In archive files, tasks retain their pre-archive status if available,
-                    // but since we store as 'archived' in DB, use the archived info
-                    archivedAt: row.archivedAt ?? undefined,
-                    archiveReason: row.archiveReason ?? undefined,
-                    cycleTimeDays: row.cycleTimeDays ?? undefined,
-                };
-            });
-            // Load dependencies and relations for archived tasks, filtering orphaned refs
-            if (archivedTasks.length > 0) {
-                // Also load all active task IDs so we can validate cross-references
-                const activeRows = await db
-                    .select({ id: schema.tasks.id })
-                    .from(schema.tasks)
-                    .where(ne(schema.tasks.status, 'archived'))
-                    .all();
-                const allKnownIds = new Set([
-                    ...archivedTasks.map((t) => t.id),
-                    ...activeRows.map((r) => r.id),
-                ]);
-                await loadDependenciesForTasks(db, archivedTasks, allKnownIds);
-                await loadRelationsForTasks(db, archivedTasks);
-            }
-            return {
-                archivedTasks,
-                version: '1.0.0',
-            };
-        },
-        // ---- saveArchive ----
-        async saveArchive(data) {
-            const db = await getDb(cwd);
-            // Pre-compute archive IDs + active task IDs for dependency validation
-            const archiveIds = new Set(data.archivedTasks.map((t) => t.id));
-            const activeRows = await db
-                .select({ id: schema.tasks.id })
-                .from(schema.tasks)
-                .where(ne(schema.tasks.status, 'archived'))
-                .all();
-            const validDepIds = new Set([...archiveIds, ...activeRows.map((r) => r.id)]);
-            // Wrap all upserts + dependency updates in a single transaction
-            const nativeDb = getNativeTasksDb();
-            if (!nativeDb) {
-                throw new Error('Native database not initialized');
-            }
-            nativeDb.prepare('BEGIN IMMEDIATE').run();
-            try {
-                // Collect dependency data for batch update
-                const depBatch = [];
-                for (const task of data.archivedTasks) {
-                    const row = archivedTaskToRow(task);
-                    // Extract archive-specific fields if they exist on the task object
-                    const taskAny = task;
-                    const archiveFields = {
-                        archivedAt: taskAny.archivedAt ?? row.completedAt ?? new Date().toISOString(),
-                        archiveReason: taskAny.archiveReason ?? 'completed',
-                        cycleTimeDays: taskAny.cycleTimeDays ?? null,
-                    };
-                    await upsertTask(db, row, archiveFields);
-                    depBatch.push({ taskId: task.id, deps: task.depends ?? [] });
-                }
-                // Single batch operation for all dependency updates
-                await batchUpdateDependencies(db, depBatch, validDepIds);
-                nativeDb.prepare('COMMIT').run();
-            }
-            catch (err) {
-                nativeDb.prepare('ROLLBACK').run();
-                throw err;
-            }
-        },
-        // ---- loadSessions ----
-        async loadSessions() {
-            const db = await getDb(cwd);
-            const sessionRows = await db.select().from(schema.sessions).all();
-            return sessionRows.map(rowToSession);
-        },
-        // ---- saveSessions ----
-        async saveSessions(sessions) {
-            const db = await getDb(cwd);
-            // Get existing session IDs
-            const existingRows = await db.select({ id: schema.sessions.id }).from(schema.sessions).all();
-            const existingIds = new Set(existingRows.map((r) => r.id));
-            const incomingIds = new Set(sessions.map((s) => s.id));
-            // Delete sessions that are no longer in the data
-            for (const eid of existingIds) {
-                if (!incomingIds.has(eid)) {
-                    await db.delete(schema.sessions).where(eq(schema.sessions.id, eid)).run();
-                }
-            }
-            // Upsert all sessions
-            for (const session of sessions) {
-                await upsertSession(db, session);
-            }
-        },
-        // ---- appendLog ----
-        async appendLog(entry) {
-            const db = await getDb(cwd);
-            await db
-                .insert(schema.auditLog)
-                .values({
-                id: entry.id ?? generateAuditLogId(),
-                timestamp: entry.timestamp ?? new Date().toISOString(),
-                action: entry.action ?? entry.operation ?? 'unknown',
-                taskId: entry.taskId ?? 'unknown',
-                actor: entry.actor ?? 'system',
-                detailsJson: entry.details ? JSON.stringify(entry.details) : '{}',
-                beforeJson: entry.before ? JSON.stringify(entry.before) : null,
-                afterJson: entry.after ? JSON.stringify(entry.after) : null,
-            })
-                .run();
-        },
-        // ---- Fine-grained task operations (T5034) ----
-        async upsertSingleTask(task) {
-            const db = await getDb(cwd);
-            const row = taskToRow(task);
-            await upsertTask(db, row);
-            await updateDependencies(db, task.id, task.depends ?? []);
-        },
-        async addRelation(taskId, relatedTo, relationType, reason) {
-            const db = await getDb(cwd);
-            // Validate relation type - throw on invalid (T5168)
-            const validTypes = [
-                'related',
-                'blocks',
-                'duplicates',
-                'absorbs',
-                'fixes',
-                'extends',
-                'supersedes',
-            ];
-            if (!validTypes.includes(relationType)) {
-                throw new Error(`Invalid relation type: ${relationType}. Valid types: ${validTypes.join(', ')}`);
-            }
-            await db
-                .insert(schema.taskRelations)
-                .values({
-                taskId,
-                relatedTo,
-                relationType: relationType,
-                reason: reason ?? null,
-            })
-                .onConflictDoNothing()
-                .run();
-        },
-        async archiveSingleTask(taskId, fields) {
-            const db = await getDb(cwd);
-            // Verify the task exists before archiving
-            const rows = await db
-                .select({ id: schema.tasks.id })
-                .from(schema.tasks)
-                .where(eq(schema.tasks.id, taskId))
-                .all();
-            if (rows.length === 0)
-                return;
-            await db
-                .update(schema.tasks)
-                .set({
-                status: 'archived',
-                archivedAt: fields.archivedAt ?? new Date().toISOString(),
-                archiveReason: fields.archiveReason ?? 'completed',
-                cycleTimeDays: fields.cycleTimeDays ?? null,
-                updatedAt: new Date().toISOString(),
-            })
-                .where(eq(schema.tasks.id, taskId))
-                .run();
-        },
-        async removeSingleTask(taskId) {
-            const db = await getDb(cwd);
-            // Delete dependencies first (both directions)
-            await db
-                .delete(schema.taskDependencies)
-                .where(eq(schema.taskDependencies.taskId, taskId))
-                .run();
-            await db
-                .delete(schema.taskDependencies)
-                .where(eq(schema.taskDependencies.dependsOn, taskId))
-                .run();
-            // Delete the task itself
-            await db.delete(schema.tasks).where(eq(schema.tasks.id, taskId)).run();
-        },
-        async loadSingleTask(taskId) {
-            const db = await getDb(cwd);
-            const rows = await db
-                .select()
-                .from(schema.tasks)
-                .where(eq(schema.tasks.id, taskId))
-                .limit(1)
-                .all();
-            if (rows.length === 0 || !rows[0])
-                return null;
-            const task = rowToTask(rows[0]);
-            // Load all task IDs so dependency validation doesn't filter out cross-task refs
-            const allIdRows = await db.select({ id: schema.tasks.id }).from(schema.tasks).all();
-            const allIds = new Set(allIdRows.map((r) => r.id));
-            await loadDependenciesForTasks(db, [task], allIds);
-            await loadRelationsForTasks(db, [task]);
-            return task;
-        },
-        async getActiveSession() {
-            const db = await getDb(cwd);
-            const rows = await db
-                .select()
-                .from(schema.sessions)
-                .where(eq(schema.sessions.status, 'active'))
-                .orderBy(sql `${schema.sessions.startedAt} DESC`)
-                .limit(1)
-                .all();
-            if (rows.length === 0 || !rows[0])
-                return null;
-            return rowToSession(rows[0]);
-        },
-        async upsertSingleSession(session) {
-            const db = await getDb(cwd);
-            await upsertSession(db, session);
-        },
-        async removeSingleSession(sessionId) {
-            const db = await getDb(cwd);
-            await db.delete(schema.sessions).where(eq(schema.sessions.id, sessionId)).run();
-        },
-        // ---- Targeted query methods (Phase 2 modernization) ----
-        async queryTasks(filters) {
-            const db = await getDb(cwd);
-            const conditions = [];
-            // Exclude archived by default unless explicitly requested
-            if (filters.status) {
-                const statuses = Array.isArray(filters.status) ? filters.status : [filters.status];
-                if (!statuses.includes('archived')) {
-                    conditions.push(ne(schema.tasks.status, 'archived'));
-                }
-                conditions.push(inArray(schema.tasks.status, statuses));
-            }
-            else if (filters.excludeStatus) {
-                const excluded = Array.isArray(filters.excludeStatus)
-                    ? filters.excludeStatus
-                    : [filters.excludeStatus];
-                for (const s of excluded) {
-                    conditions.push(ne(schema.tasks.status, s));
-                }
-            }
-            else {
-                conditions.push(ne(schema.tasks.status, 'archived'));
-            }
-            if (filters.priority)
-                conditions.push(eq(schema.tasks.priority, filters.priority));
-            if (filters.type)
-                conditions.push(eq(schema.tasks.type, filters.type));
-            if (filters.phase)
-                conditions.push(eq(schema.tasks.phase, filters.phase));
-            if (filters.parentId !== undefined) {
-                if (filters.parentId === null) {
-                    conditions.push(isNull(schema.tasks.parentId));
-                }
-                else {
-                    conditions.push(eq(schema.tasks.parentId, filters.parentId));
-                }
-            }
-            if (filters.search) {
-                const pattern = `%${filters.search}%`;
-                conditions.push(or(like(schema.tasks.title, pattern), like(schema.tasks.description, pattern), like(schema.tasks.id, pattern)));
-            }
-            if (filters.label) {
-                // label stored in JSON array — use LIKE on the serialized column
-                conditions.push(like(schema.tasks.labelsJson, `%${JSON.stringify(filters.label)}%`));
-            }
-            const where = conditions.length > 0 ? and(...conditions) : undefined;
-            // Count total matching rows (before pagination)
-            const countResult = await db
-                .select({ count: sql `count(*)` })
-                .from(schema.tasks)
-                .where(where)
-                .get();
-            const total = countResult?.count ?? 0;
-            // Build ordered query
-            let orderClause;
-            switch (filters.orderBy) {
-                case 'createdAt':
-                    orderClause = sql `${schema.tasks.createdAt} ASC`;
-                    break;
-                case 'updatedAt':
-                    orderClause = sql `${schema.tasks.updatedAt} DESC NULLS LAST`;
-                    break;
-                case 'priority': {
-                    // Map priority to numeric sort: critical=0, high=1, medium=2, low=3
-                    orderClause = sql `CASE ${schema.tasks.priority}
-            WHEN 'critical' THEN 0 WHEN 'high' THEN 1
-            WHEN 'medium' THEN 2 WHEN 'low' THEN 3 ELSE 4 END ASC`;
-                    break;
-                }
-                default:
-                    // position ASC, createdAt ASC (default)
-                    orderClause = sql `${schema.tasks.position} ASC, ${schema.tasks.createdAt} ASC`;
-            }
-            let query = db.select().from(schema.tasks).where(where).orderBy(orderClause);
-            if (filters.limit !== undefined) {
-                query = query.limit(filters.limit);
-            }
-            if (filters.offset !== undefined) {
-                query = query.offset(filters.offset);
-            }
-            const rows = await query.all();
-            const tasks = rows.map(rowToTask);
-            // Load dependencies and relations with full ID set for cross-task refs
-            if (tasks.length > 0) {
-                const allIds = await getAllTaskIds();
-                await loadDependenciesForTasks(db, tasks, allIds);
-                await loadRelationsForTasks(db, tasks);
-            }
-            return { tasks, total };
-        },
-        async countTasks(filters) {
-            const db = await getDb(cwd);
-            const conditions = [];
-            if (filters?.status) {
-                const statuses = Array.isArray(filters.status) ? filters.status : [filters.status];
-                conditions.push(inArray(schema.tasks.status, statuses));
-            }
-            else {
-                conditions.push(ne(schema.tasks.status, 'archived'));
-            }
-            if (filters?.parentId) {
-                conditions.push(eq(schema.tasks.parentId, filters.parentId));
-            }
-            const where = conditions.length > 0 ? and(...conditions) : undefined;
-            const result = await db
-                .select({ count: sql `count(*)` })
-                .from(schema.tasks)
-                .where(where)
-                .get();
-            return result?.count ?? 0;
-        },
-        async getChildren(parentId) {
-            const db = await getDb(cwd);
-            const rows = await db
-                .select()
-                .from(schema.tasks)
-                .where(and(eq(schema.tasks.parentId, parentId), ne(schema.tasks.status, 'archived')))
-                .orderBy(sql `${schema.tasks.position} ASC, ${schema.tasks.createdAt} ASC`)
-                .all();
-            const tasks = rows.map(rowToTask);
-            if (tasks.length > 0) {
-                const allIds = await getAllTaskIds();
-                await loadDependenciesForTasks(db, tasks, allIds);
-                await loadRelationsForTasks(db, tasks);
-            }
-            return tasks;
-        },
-        async countChildren(parentId) {
-            const db = await getDb(cwd);
-            const result = await db
-                .select({ count: sql `count(*)` })
-                .from(schema.tasks)
-                .where(and(eq(schema.tasks.parentId, parentId), ne(schema.tasks.status, 'archived')))
-                .get();
-            return result?.count ?? 0;
-        },
-        async countActiveChildren(parentId) {
-            const db = await getDb(cwd);
-            const result = await db
-                .select({ count: sql `count(*)` })
-                .from(schema.tasks)
-                .where(and(eq(schema.tasks.parentId, parentId), notInArray(schema.tasks.status, [...TERMINAL_TASK_STATUSES])))
-                .get();
-            return result?.count ?? 0;
-        },
-        async getAncestorChain(taskId) {
-            const nativeDb = getNativeTasksDb();
-            if (!nativeDb)
-                return [];
-            const idRows = nativeDb
-                .prepare(`WITH RECURSIVE ancestor_ids(id, depth) AS (
-            SELECT parent_id, 0 FROM tasks WHERE id = ? AND parent_id IS NOT NULL
-            UNION ALL
-            SELECT t.parent_id, a.depth + 1 FROM tasks t
-            JOIN ancestor_ids a ON t.id = a.id
-            WHERE t.parent_id IS NOT NULL
-          )
-          SELECT id FROM ancestor_ids ORDER BY depth DESC`)
-                .all(taskId);
-            if (idRows.length === 0)
-                return [];
-            const db = await getDb(cwd);
-            const ids = idRows.map((r) => r.id);
-            const taskRows = await db
-                .select()
-                .from(schema.tasks)
-                .where(inArray(schema.tasks.id, ids))
-                .all();
-            const tasks = taskRows.map(rowToTask);
-            if (tasks.length > 0) {
-                const allIds = await getAllTaskIds();
-                await loadDependenciesForTasks(db, tasks, allIds);
-                await loadRelationsForTasks(db, tasks);
-            }
-            // Preserve depth order (ancestors from root down)
-            const orderMap = new Map(ids.map((id, i) => [id, i]));
-            tasks.sort((a, b) => (orderMap.get(a.id) ?? 0) - (orderMap.get(b.id) ?? 0));
-            return tasks;
-        },
-        async getSubtree(rootId) {
-            const nativeDb = getNativeTasksDb();
-            if (!nativeDb)
-                return [];
-            // Get IDs from the CTE, then load via Drizzle for proper conversion
-            const idRows = nativeDb
-                .prepare(`WITH RECURSIVE subtree AS (
-            SELECT id FROM tasks WHERE id = ?
-            UNION ALL
-            SELECT t.id FROM tasks t
-            JOIN subtree s ON t.parent_id = s.id
-          )
-          SELECT id FROM subtree`)
-                .all(rootId);
-            if (idRows.length === 0)
-                return [];
-            const db = await getDb(cwd);
-            const ids = idRows.map((r) => r.id);
-            const rows = await db.select().from(schema.tasks).where(inArray(schema.tasks.id, ids)).all();
-            const tasks = rows.map(rowToTask);
-            if (tasks.length > 0) {
-                const allIds = await getAllTaskIds();
-                await loadDependenciesForTasks(db, tasks, allIds);
-                await loadRelationsForTasks(db, tasks);
-            }
-            return tasks;
-        },
-        async getDependents(taskId) {
-            const db = await getDb(cwd);
-            // Find tasks whose depends list includes taskId (reverse lookup)
-            const depRows = await db
-                .select()
-                .from(schema.taskDependencies)
-                .where(eq(schema.taskDependencies.dependsOn, taskId))
-                .all();
-            if (depRows.length === 0)
-                return [];
-            const dependentIds = depRows.map((r) => r.taskId);
-            const rows = await db
-                .select()
-                .from(schema.tasks)
-                .where(inArray(schema.tasks.id, dependentIds))
-                .all();
-            const tasks = rows.map(rowToTask);
-            if (tasks.length > 0) {
-                const allIds = await getAllTaskIds();
-                await loadDependenciesForTasks(db, tasks, allIds);
-                await loadRelationsForTasks(db, tasks);
-            }
-            return tasks;
-        },
-        async getDependencyChain(taskId) {
-            const nativeDb = getNativeTasksDb();
-            if (!nativeDb)
-                return [];
-            const rows = nativeDb
-                .prepare(`WITH RECURSIVE dep_chain(id) AS (
-            SELECT depends_on FROM task_dependencies WHERE task_id = ?
-            UNION
-            SELECT td.depends_on FROM task_dependencies td
-            JOIN dep_chain dc ON td.task_id = dc.id
-          )
-          SELECT id FROM dep_chain`)
-                .all(taskId);
-            return rows.map((r) => r.id);
-        },
-        async taskExists(taskId) {
-            const db = await getDb(cwd);
-            const result = await db
-                .select({ id: schema.tasks.id })
-                .from(schema.tasks)
-                .where(eq(schema.tasks.id, taskId))
-                .limit(1)
-                .get();
-            return !!result;
-        },
-        async loadTasks(taskIds) {
-            if (taskIds.length === 0)
-                return [];
-            const db = await getDb(cwd);
-            const rows = await db
-                .select()
-                .from(schema.tasks)
-                .where(inArray(schema.tasks.id, taskIds))
-                .all();
-            const tasks = rows.map(rowToTask);
-            if (tasks.length > 0) {
-                const allIds = await getAllTaskIds();
-                await loadDependenciesForTasks(db, tasks, allIds);
-                await loadRelationsForTasks(db, tasks);
-            }
-            return tasks;
-        },
-        // ---- Position helpers (T024/T025) ----
-        async getNextPosition(parentId) {
-            const nativeDb = getNativeTasksDb();
-            if (!nativeDb) {
-                throw new Error('Native database not initialized');
-            }
-            const row = parentId === null
-                ? nativeDb
-                    .prepare(`SELECT COALESCE(MAX(position), 0) + 1 AS next_pos FROM tasks WHERE parent_id IS NULL AND status != 'archived'`)
-                    .get()
-                : nativeDb
-                    .prepare(`SELECT COALESCE(MAX(position), 0) + 1 AS next_pos FROM tasks WHERE parent_id = ? AND status != 'archived'`)
-                    .get(parentId);
-            return row?.next_pos ?? 1;
-        },
-        async shiftPositions(parentId, fromPosition, delta) {
-            const nativeDb = getNativeTasksDb();
-            if (!nativeDb) {
-                throw new Error('Native database not initialized');
-            }
-            if (parentId === null) {
-                nativeDb
-                    .prepare(`UPDATE tasks SET position = position + ?, position_version = position_version + 1, updated_at = ? WHERE parent_id IS NULL AND position >= ? AND status != 'archived'`)
-                    .run(delta, new Date().toISOString(), fromPosition);
-            }
-            else {
-                nativeDb
-                    .prepare(`UPDATE tasks SET position = position + ?, position_version = position_version + 1, updated_at = ? WHERE parent_id = ? AND position >= ? AND status != 'archived'`)
-                    .run(delta, new Date().toISOString(), parentId, fromPosition);
-            }
-        },
-        // ---- Targeted write methods ----
-        async updateTaskFields(taskId, fields) {
-            const db = await getDb(cwd);
-            const updateRow = {
-                updatedAt: fields.updatedAt ?? new Date().toISOString(),
-            };
-            // Copy only provided fields
-            const fieldMap = [
-                ['title', 'title'],
-                ['description', 'description'],
-                ['status', 'status'],
-                ['priority', 'priority'],
-                ['type', 'type'],
-                ['parentId', 'parentId'],
-                ['phase', 'phase'],
-                ['size', 'size'],
-                ['position', 'position'],
-                ['positionVersion', 'positionVersion'],
-                ['labelsJson', 'labelsJson'],
-                ['notesJson', 'notesJson'],
-                ['acceptanceJson', 'acceptanceJson'],
-                ['filesJson', 'filesJson'],
-                ['origin', 'origin'],
-                ['blockedBy', 'blockedBy'],
-                ['epicLifecycle', 'epicLifecycle'],
-                ['noAutoComplete', 'noAutoComplete'],
-                ['completedAt', 'completedAt'],
-                ['cancelledAt', 'cancelledAt'],
-                ['cancellationReason', 'cancellationReason'],
-                ['verificationJson', 'verificationJson'],
-                ['createdBy', 'createdBy'],
-                ['modifiedBy', 'modifiedBy'],
-                ['sessionId', 'sessionId'],
-                ['assignee', 'assignee'],
-            ];
-            for (const [key, col] of fieldMap) {
-                if (fields[key] !== undefined) {
-                    updateRow[col] = fields[key];
-                }
-            }
-            await db.update(schema.tasks).set(updateRow).where(eq(schema.tasks.id, taskId)).run();
-        },
-        async transaction(fn) {
-            const nativeDb = getNativeTasksDb();
-            if (!nativeDb) {
-                throw new Error('Native database not initialized');
-            }
-            const db = await getDb(cwd);
-            nativeDb.prepare('BEGIN IMMEDIATE').run();
-            try {
-                const tx = {
-                    async upsertSingleTask(task) {
-                        const row = taskToRow(task);
-                        await upsertTask(db, row);
-                        await updateDependencies(db, task.id, task.depends ?? []);
-                    },
-                    async archiveSingleTask(taskId, fields) {
-                        await db
-                            .update(schema.tasks)
-                            .set({
-                            status: 'archived',
-                            archivedAt: fields.archivedAt ?? new Date().toISOString(),
-                            archiveReason: fields.archiveReason ?? 'completed',
-                            cycleTimeDays: fields.cycleTimeDays ?? null,
-                            updatedAt: new Date().toISOString(),
-                        })
-                            .where(eq(schema.tasks.id, taskId))
-                            .run();
-                    },
-                    async removeSingleTask(taskId) {
-                        await db
-                            .delete(schema.taskDependencies)
-                            .where(eq(schema.taskDependencies.taskId, taskId))
-                            .run();
-                        await db
-                            .delete(schema.taskDependencies)
-                            .where(eq(schema.taskDependencies.dependsOn, taskId))
-                            .run();
-                        await db.delete(schema.tasks).where(eq(schema.tasks.id, taskId)).run();
-                    },
-                    async setMetaValue(key, value) {
-                        await setMetaValue(cwd, key, value);
-                    },
-                    async updateTaskFields(taskId, flds) {
-                        // Delegate to the outer accessor's implementation
-                        await accessor.updateTaskFields(taskId, flds);
-                    },
-                    async appendLog(entry) {
-                        await accessor.appendLog(entry);
-                    },
-                };
-                const result = await fn(tx);
-                nativeDb.prepare('COMMIT').run();
-                return result;
-            }
-            catch (err) {
-                nativeDb.prepare('ROLLBACK').run();
-                throw err;
-            }
-        },
-        // ---- close ----
-        async close() {
-            closeDb();
-        },
-        // ---- Metadata ----
-        async getMetaValue(key) {
-            return getMetaValue(cwd, key);
-        },
-        async setMetaValue(key, value) {
-            return setMetaValue(cwd, key, value);
-        },
-        async getSchemaVersion() {
-            const meta = await getMetaValue(cwd, 'file_meta');
-            return meta?.schemaVersion ?? null;
-        },
-        // ---- Agent instances ----
-        async listAgentInstances(filters) {
-            const { listAgentInstances: listAgents } = await import('../agents/registry.js');
-            // Cast generic string filters to the specific union types expected by the agents module
-            return listAgents(filters, cwd);
-        },
-        async getAgentInstance(agentId) {
-            const { getAgentInstance: getAgent } = await import('../agents/registry.js');
-            return getAgent(agentId, cwd);
-        },
-        // ---- Agent task claiming ----
-        async claimTask(taskId, agentId) {
-            const nativeDb = getNativeTasksDb();
-            if (!nativeDb) {
-                throw new Error('Native database not initialized');
-            }
-            // Verify the task exists first
-            const existsRow = nativeDb.prepare('SELECT assignee FROM tasks WHERE id = ?').get(taskId);
-            if (!existsRow) {
-                throw new Error(`Task not found: ${taskId}`);
-            }
-            // Atomic claim: only succeeds if assignee IS NULL or already claimed by this agent.
-            // This prevents race conditions between concurrent agents.
-            const result = nativeDb
-                .prepare('UPDATE tasks SET assignee = ?, updated_at = ? WHERE id = ? AND (assignee IS NULL OR assignee = ?)')
-                .run(agentId, new Date().toISOString(), taskId, agentId);
-            if (result.changes === 0) {
-                // Row was not updated — task is claimed by a different agent
-                const currentRow = nativeDb
-                    .prepare('SELECT assignee FROM tasks WHERE id = ?')
-                    .get(taskId);
-                throw new Error(`Task ${taskId} is already claimed by agent: ${currentRow?.assignee ?? 'unknown'}`);
-            }
-        },
-        async unclaimTask(taskId) {
-            const nativeDb = getNativeTasksDb();
-            if (!nativeDb) {
-                throw new Error('Native database not initialized');
-            }
-            // Verify the task exists
-            const existsRow = nativeDb.prepare('SELECT id FROM tasks WHERE id = ?').get(taskId);
-            if (!existsRow) {
-                throw new Error(`Task not found: ${taskId}`);
-            }
-            // Clear the assignee — no-op if already null
-            nativeDb
-                .prepare('UPDATE tasks SET assignee = NULL, updated_at = ? WHERE id = ?')
-                .run(new Date().toISOString(), taskId);
-        },
-    };
-    return accessor;
-}
-//# sourceMappingURL=sqlite-data-accessor.js.map