@cleocode/core 2026.4.58 → 2026.4.59

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

@@ -0,0 +1,788 @@
+/**
+ * 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 { cleanupBrainRefsOnSessionDelete } from './cross-db-cleanup.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,
+                    };
+                    // allowOrphanParent=true: bulk archive writes tolerate missing parents (T5034)
+                    await upsertTask(db, row, archiveFields, true);
+                    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();
+            // Best-effort cross-db cleanup: nullify brain.db references to this session
+            void cleanupBrainRefsOnSessionDelete(sessionId, cwd);
+        },
+        // ---- 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