@cleocode/core 2026.4.13 → 2026.4.15

package/dist/store/converters.js

@@ -1,124 +0,0 @@
-/**
- * Shared row <-> domain conversion functions for SQLite store modules.
- *
- * Eliminates duplication across sqlite-data-accessor.ts, task-store.ts,
- * and session-store.ts.
- */
-import { safeParseJson, safeParseJsonArray } from './parsers.js';
-/** Convert a database TaskRow to a domain Task object. */
-export function rowToTask(row) {
-    return {
-        id: row.id,
-        title: row.title,
-        status: row.status,
-        priority: row.priority,
-        type: row.type ?? undefined,
-        parentId: row.parentId ?? undefined,
-        phase: row.phase ?? undefined,
-        size: row.size ?? undefined,
-        position: row.position ?? undefined,
-        positionVersion: row.positionVersion ?? undefined,
-        description: row.description ?? '',
-        labels: safeParseJsonArray(row.labelsJson),
-        notes: safeParseJsonArray(row.notesJson),
-        acceptance: safeParseJsonArray(row.acceptanceJson),
-        files: safeParseJsonArray(row.filesJson),
-        depends: undefined, // Populated separately from task_dependencies
-        origin: row.origin ?? undefined,
-        blockedBy: row.blockedBy ?? undefined,
-        epicLifecycle: row.epicLifecycle ?? undefined,
-        noAutoComplete: row.noAutoComplete ?? undefined,
-        createdAt: row.createdAt,
-        updatedAt: row.updatedAt ?? undefined,
-        completedAt: row.completedAt ?? undefined,
-        cancelledAt: row.cancelledAt ?? undefined,
-        cancellationReason: row.cancellationReason ?? undefined,
-        verification: row.verificationJson ? safeParseJson(row.verificationJson) : undefined,
-        provenance: row.createdBy || row.modifiedBy || row.sessionId
-            ? {
-                createdBy: row.createdBy ?? null,
-                modifiedBy: row.modifiedBy ?? null,
-                sessionId: row.sessionId ?? null,
-            }
-            : undefined,
-        pipelineStage: row.pipelineStage ?? undefined,
-        assignee: row.assignee ?? undefined,
-    };
-}
-/** Convert a domain Task to a database row for insert/upsert. */
-export function taskToRow(task) {
-    return {
-        id: task.id,
-        title: task.title ?? '',
-        description: task.description ?? null,
-        status: task.status ?? 'pending',
-        priority: task.priority ?? 'medium',
-        type: task.type ?? null,
-        parentId: task.parentId ?? null,
-        phase: task.phase ?? null,
-        size: task.size ?? null,
-        position: task.position ?? null,
-        positionVersion: task.positionVersion ?? 0,
-        labelsJson: task.labels ? JSON.stringify(task.labels) : '[]',
-        notesJson: task.notes ? JSON.stringify(task.notes) : '[]',
-        acceptanceJson: task.acceptance ? JSON.stringify(task.acceptance) : '[]',
-        filesJson: task.files ? JSON.stringify(task.files) : '[]',
-        origin: task.origin ?? null,
-        blockedBy: task.blockedBy ?? null,
-        epicLifecycle: task.epicLifecycle ?? null,
-        noAutoComplete: task.noAutoComplete ?? null,
-        createdAt: task.createdAt ?? new Date().toISOString(),
-        updatedAt: task.updatedAt ?? null,
-        completedAt: task.completedAt ?? null,
-        cancelledAt: task.cancelledAt ?? null,
-        cancellationReason: task.cancellationReason ?? null,
-        verificationJson: task.verification ? JSON.stringify(task.verification) : null,
-        createdBy: task.provenance?.createdBy ?? null,
-        modifiedBy: task.provenance?.modifiedBy ?? null,
-        sessionId: task.provenance?.sessionId ?? null,
-        pipelineStage: task.pipelineStage ?? null,
-        assignee: task.assignee ?? null,
-    };
-}
-/** Convert a domain Task to a row suitable for archived tasks. */
-export function archivedTaskToRow(task) {
-    const row = taskToRow(task);
-    row.status = 'archived';
-    if (!row['archivedAt']) {
-        row['archivedAt'] = task.completedAt ?? new Date().toISOString();
-    }
-    return row;
-}
-/** Convert a SessionRow to a domain Session. */
-export function rowToSession(row) {
-    const taskWork = {
-        taskId: row.currentTask ?? null,
-        setAt: row.taskStartedAt ?? null,
-    };
-    return {
-        id: row.id,
-        name: row.name,
-        status: row.status,
-        scope: (safeParseJson(row.scopeJson) ?? { type: 'global' }),
-        taskWork,
-        startedAt: row.startedAt,
-        endedAt: row.endedAt ?? undefined,
-        agent: row.agent ?? undefined,
-        notes: safeParseJsonArray(row.notesJson),
-        tasksCompleted: safeParseJsonArray(row.tasksCompletedJson),
-        tasksCreated: safeParseJsonArray(row.tasksCreatedJson),
-        handoffJson: row.handoffJson ?? null,
-        // Session chain fields (T4959)
-        previousSessionId: row.previousSessionId ?? null,
-        nextSessionId: row.nextSessionId ?? null,
-        agentIdentifier: row.agentIdentifier ?? null,
-        handoffConsumedAt: row.handoffConsumedAt ?? null,
-        handoffConsumedBy: row.handoffConsumedBy ?? null,
-        debriefJson: row.debriefJson ?? null,
-        // Session stats fields
-        stats: row.statsJson ? safeParseJson(row.statsJson) : undefined,
-        resumeCount: row.resumeCount ?? undefined,
-        gradeMode: row.gradeMode ? Boolean(row.gradeMode) : undefined,
-    };
-}
-//# sourceMappingURL=converters.js.map

package/dist/store/converters.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"converters.js","sourceRoot":"","sources":["../../src/store/converters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIjE,0DAA0D;AAC1D,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAoB;QAChC,QAAQ,EAAE,GAAG,CAAC,QAAwB;QACtC,IAAI,EAAG,GAAG,CAAC,IAAiB,IAAI,SAAS;QACzC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;QACnC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;QAC7B,IAAI,EAAG,GAAG,CAAC,IAAiB,IAAI,SAAS;QACzC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;QACnC,eAAe,EAAE,GAAG,CAAC,eAAe,IAAI,SAAS;QACjD,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;QAClC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC;QAC1C,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC;QACxC,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC,cAAc,CAAC;QAClD,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC;QACxC,OAAO,EAAE,SAAS,EAAE,8CAA8C;QAClE,MAAM,EAAG,GAAG,CAAC,MAAyB,IAAI,SAAS;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;QACrC,aAAa,EAAG,GAAG,CAAC,aAAuC,IAAI,SAAS;QACxE,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,SAAS;QAC/C,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;QACrC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,SAAS;QACzC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,SAAS;QACzC,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,IAAI,SAAS;QACvD,YAAY,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS;QACpF,UAAU,EACR,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,SAAS;YAC9C,CAAC,CAAC;gBACE,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;gBAChC,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;gBAClC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;aACjC;YACH,CAAC,CAAC,SAAS;QACf,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,SAAS;QAC7C,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;KACpC,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,SAAS,CAAC,IAAoC;IAC5D,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACrC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;QAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;QACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,CAAC;QAC1C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;QAC5D,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QACzD,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;QACxE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QACzD,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;QACzC,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;QAC3C,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrD,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACrC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACrC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,IAAI;QACnD,gBAAgB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;QAC9E,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,IAAI,IAAI;QAC7C,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,IAAI,IAAI;QAC/C,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,IAAI,IAAI;QAC7C,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;QACzC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;KAChC,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,IAAU;IAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5B,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC;IACxB,IAAI,CAAE,GAA+B,CAAC,YAAY,CAAC,EAAE,CAAC;QACnD,GAA+B,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,GAAe;IAC1C,MAAM,QAAQ,GAAG;QACf,MAAM,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;QAC/B,KAAK,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;KACjC,CAAC;IACF,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAuB;QACnC,KAAK,EAAE,CAAC,aAAa,CAAe,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAiB;QACzF,QAAQ;QACR,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,SAAS;QACjC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;QAC7B,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC;QACxC,cAAc,EAAE,kBAAkB,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC1D,YAAY,EAAE,kBAAkB,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACtD,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;QACpC,+BAA+B;QAC/B,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,IAAI;QAChD,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;QACxC,eAAe,EAAE,GAAG,CAAC,eAAe,IAAI,IAAI;QAC5C,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,IAAI;QAChD,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,IAAI;QAChD,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;QACpC,uBAAuB;QACvB,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAe,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7E,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,SAAS;QACzC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9D,CAAC;AACJ,CAAC"}

package/dist/store/cross-db-cleanup.js

@@ -1,319 +0,0 @@
-/**
- * Cross-database cleanup hooks for brain.db → tasks.db soft FK enforcement.
- *
- * SQLite does not support foreign key constraints across database connections.
- * This module provides application-layer guards that maintain referential
- * integrity between brain.db and tasks.db after destructive operations.
- *
- * Implements the recommendations from T030 audit (XFKB-001 through XFKB-005).
- *
- * @task T033
- * @epic T029
- */
-import { and, eq, isNotNull, or } from 'drizzle-orm';
-import * as brainSchema from './brain-schema.js';
-import { getBrainDb } from './brain-sqlite.js';
-/**
- * Clean up brain.db references after a task is deleted from tasks.db.
- *
- * Handles:
- * - XFKB-001/002: Nullify brain_decisions.context_epic_id / context_task_id
- * - XFKB-003: Delete brain_memory_links rows where task_id matches
- * - XFKB-005: Delete brain_page_nodes with id='task:<taskId>' and cascade brain_page_edges
- *
- * This is a best-effort cleanup — brain.db is a cognitive store and minor
- * staleness is preferable to failing task deletions due to brain.db errors.
- *
- * @remarks
- * Best-effort: failures in brain.db cleanup do not propagate to the caller.
- * A background reconciliation pass can clean up any residual stale refs.
- *
- * @param taskId - The ID of the task being deleted from tasks.db
- * @param cwd - Optional working directory
- *
- * @example
- * ```ts
- * await cleanupBrainRefsOnTaskDelete('T042');
- * ```
- */
-export async function cleanupBrainRefsOnTaskDelete(taskId, cwd) {
-    let brainDb = null;
-    try {
-        brainDb = await getBrainDb(cwd);
-    }
-    catch {
-        // brain.db may not be initialized — non-fatal
-        return;
-    }
-    const nodeId = `task:${taskId}`;
-    try {
-        // XFKB-001/002: Nullify context references in brain_decisions
-        await brainDb
-            .update(brainSchema.brainDecisions)
-            .set({ contextEpicId: null })
-            .where(eq(brainSchema.brainDecisions.contextEpicId, taskId));
-        await brainDb
-            .update(brainSchema.brainDecisions)
-            .set({ contextTaskId: null })
-            .where(eq(brainSchema.brainDecisions.contextTaskId, taskId));
-        // XFKB-003: Delete brain_memory_links rows referencing this task
-        await brainDb
-            .delete(brainSchema.brainMemoryLinks)
-            .where(eq(brainSchema.brainMemoryLinks.taskId, taskId));
-        // XFKB-005: Delete brain_page_edges first (FK cascade not available cross-DB),
-        //            then delete brain_page_nodes for this task
-        await brainDb
-            .delete(brainSchema.brainPageEdges)
-            .where(or(eq(brainSchema.brainPageEdges.fromId, nodeId), eq(brainSchema.brainPageEdges.toId, nodeId)));
-        await brainDb
-            .delete(brainSchema.brainPageNodes)
-            .where(eq(brainSchema.brainPageNodes.id, nodeId));
-    }
-    catch {
-        // Non-fatal: log silently. Brain.db cleanup is best-effort.
-        // A background reconciliation pass can clean up any residual stale refs.
-    }
-}
-/**
- * Clean up brain.db references after a session is deleted from tasks.db.
- *
- * Handles:
- * - XFKB-004: Nullify brain_observations.source_session_id where it matches
- *
- * @remarks
- * Best-effort: failures do not propagate. brain.db may not be initialised.
- *
- * @param sessionId - The ID of the session being deleted from tasks.db
- * @param cwd - Optional working directory
- *
- * @example
- * ```ts
- * await cleanupBrainRefsOnSessionDelete('ses_20260321_abc');
- * ```
- */
-export async function cleanupBrainRefsOnSessionDelete(sessionId, cwd) {
-    let brainDb = null;
-    try {
-        brainDb = await getBrainDb(cwd);
-    }
-    catch {
-        return;
-    }
-    try {
-        // XFKB-004: Nullify source_session_id in brain_observations
-        await brainDb
-            .update(brainSchema.brainObservations)
-            .set({ sourceSessionId: null })
-            .where(eq(brainSchema.brainObservations.sourceSessionId, sessionId));
-    }
-    catch {
-        // Non-fatal best-effort cleanup
-    }
-}
-/**
- * Verify a task ID exists in tasks.db before writing a cross-DB reference to brain.db.
- * Returns true if the task exists, false otherwise.
- *
- * Provides write-guard for XFKB-001/002/003 on brain.db insert.
- *
- * @remarks
- * Used as a write-guard before inserting cross-DB references into brain.db.
- *
- * @param taskId - Task ID to verify
- * @param tasksDb - The tasks.db drizzle instance
- * @returns True if the task exists in tasks.db
- *
- * @example
- * ```ts
- * if (await taskExistsInTasksDb('T042', db)) { /* safe to reference *\/ }
- * ```
- */
-export async function taskExistsInTasksDb(taskId, tasksDb) {
-    const { tasks } = await import('./tasks-schema.js');
-    const { eq: eqOp } = await import('drizzle-orm');
-    const result = await tasksDb
-        .select({ id: tasks.id })
-        .from(tasks)
-        .where(eqOp(tasks.id, taskId))
-        .all();
-    return result.length > 0;
-}
-/**
- * Verify a session ID exists in tasks.db before writing a cross-DB reference to brain.db.
- * Returns true if the session exists, false otherwise.
- *
- * Provides write-guard for XFKB-004 on brain.db insert.
- *
- * @remarks
- * Used as a write-guard before inserting cross-DB references into brain.db.
- *
- * @param sessionId - Session ID to verify
- * @param tasksDb - The tasks.db drizzle instance
- * @returns True if the session exists in tasks.db
- *
- * @example
- * ```ts
- * if (await sessionExistsInTasksDb('ses_abc', db)) { /* safe to reference *\/ }
- * ```
- */
-/**
- * Reconcile orphaned cross-DB references in brain.db.
- *
- * Scans brain.db for references to tasks/sessions that no longer exist in
- * tasks.db and cleans them up:
- * - brain_decisions with stale context_task_id or context_epic_id → nullify
- * - brain_observations with stale source_session_id → nullify
- * - brain_memory_links with stale task_id → delete row
- *
- * This is the background reconciliation pass mentioned in the module doc.
- * Safe to run at any frequency — idempotent.
- *
- * @param cwd - Optional working directory
- * @returns Counts of orphaned references cleaned up
- */
-export async function reconcileOrphanedRefs(cwd) {
-    let brainDb = null;
-    const result = { decisionsFixed: 0, observationsFixed: 0, linksRemoved: 0 };
-    try {
-        brainDb = await getBrainDb(cwd);
-    }
-    catch {
-        return result;
-    }
-    const { getDb } = await import('./sqlite.js');
-    let tasksDb;
-    try {
-        tasksDb = await getDb(cwd);
-    }
-    catch {
-        return result;
-    }
-    try {
-        // 1. Find decisions with stale context_task_id
-        const decisionsWithTaskRef = await brainDb
-            .select({
-            id: brainSchema.brainDecisions.id,
-            contextTaskId: brainSchema.brainDecisions.contextTaskId,
-            contextEpicId: brainSchema.brainDecisions.contextEpicId,
-        })
-            .from(brainSchema.brainDecisions)
-            .where(or(isNotNull(brainSchema.brainDecisions.contextTaskId), isNotNull(brainSchema.brainDecisions.contextEpicId)))
-            .all();
-        for (const d of decisionsWithTaskRef) {
-            if (d.contextTaskId) {
-                const exists = await taskExistsInTasksDb(d.contextTaskId, tasksDb);
-                if (!exists) {
-                    await brainDb
-                        .update(brainSchema.brainDecisions)
-                        .set({ contextTaskId: null })
-                        .where(eq(brainSchema.brainDecisions.id, d.id));
-                    result.decisionsFixed++;
-                }
-            }
-            if (d.contextEpicId) {
-                const exists = await taskExistsInTasksDb(d.contextEpicId, tasksDb);
-                if (!exists) {
-                    await brainDb
-                        .update(brainSchema.brainDecisions)
-                        .set({ contextEpicId: null })
-                        .where(eq(brainSchema.brainDecisions.id, d.id));
-                    result.decisionsFixed++;
-                }
-            }
-        }
-        // 2. Find observations with stale source_session_id
-        const obsWithSessionRef = await brainDb
-            .select({
-            id: brainSchema.brainObservations.id,
-            sourceSessionId: brainSchema.brainObservations.sourceSessionId,
-        })
-            .from(brainSchema.brainObservations)
-            .where(isNotNull(brainSchema.brainObservations.sourceSessionId))
-            .all();
-        for (const o of obsWithSessionRef) {
-            {
-                const exists = o.sourceSessionId
-                    ? await sessionExistsInTasksDb(o.sourceSessionId, tasksDb)
-                    : false;
-                if (!exists) {
-                    await brainDb
-                        .update(brainSchema.brainObservations)
-                        .set({ sourceSessionId: null })
-                        .where(eq(brainSchema.brainObservations.id, o.id));
-                    result.observationsFixed++;
-                }
-            }
-        }
-        // 3. Find memory links with stale task_id
-        const allLinks = await brainDb
-            .select({
-            memoryType: brainSchema.brainMemoryLinks.memoryType,
-            memoryId: brainSchema.brainMemoryLinks.memoryId,
-            taskId: brainSchema.brainMemoryLinks.taskId,
-            linkType: brainSchema.brainMemoryLinks.linkType,
-        })
-            .from(brainSchema.brainMemoryLinks)
-            .all();
-        for (const link of allLinks) {
-            const exists = await taskExistsInTasksDb(link.taskId, tasksDb);
-            if (!exists) {
-                await brainDb
-                    .delete(brainSchema.brainMemoryLinks)
-                    .where(and(eq(brainSchema.brainMemoryLinks.memoryType, link.memoryType), eq(brainSchema.brainMemoryLinks.memoryId, link.memoryId), eq(brainSchema.brainMemoryLinks.taskId, link.taskId), eq(brainSchema.brainMemoryLinks.linkType, link.linkType)));
-                result.linksRemoved++;
-            }
-        }
-    }
-    catch {
-        // Non-fatal best-effort reconciliation
-    }
-    return result;
-}
-export async function sessionExistsInTasksDb(sessionId, tasksDb) {
-    const { sessions } = await import('./tasks-schema.js');
-    const { eq: eqOp } = await import('drizzle-orm');
-    const result = await tasksDb
-        .select({ id: sessions.id })
-        .from(sessions)
-        .where(eqOp(sessions.id, sessionId))
-        .all();
-    return result.length > 0;
-}
-/**
- * Verify an agent exists in signaldock.db before creating cross-DB references.
- * Returns true if the agent_id exists in signaldock.db agents table.
- *
- * Provides write-guard for agent_instances and agent_error_log in tasks.db
- * that reference agents whose identity lives in signaldock.db.
- *
- * @param agentId - Agent slug (e.g. 'cleo-db-lead') to verify
- * @param cwd - Optional working directory
- * @returns True if the agent exists in signaldock.db
- *
- * @task T238
- */
-export async function agentExistsInSignaldockDb(agentId, cwd) {
-    try {
-        const { getSignaldockDbPath } = await import('./signaldock-sqlite.js');
-        const { existsSync } = await import('node:fs');
-        const dbPath = getSignaldockDbPath(cwd);
-        if (!existsSync(dbPath))
-            return false;
-        const { createRequire } = await import('node:module');
-        const _require = createRequire(import.meta.url);
-        const { DatabaseSync } = _require('node:sqlite');
-        const db = new DatabaseSync(dbPath);
-        try {
-            const row = db.prepare('SELECT id FROM agents WHERE agent_id = ?').get(agentId);
-            return !!row;
-        }
-        finally {
-            db.close();
-        }
-    }
-    catch {
-        // signaldock.db may not exist yet — non-fatal
-        return false;
-    }
-}
-//# sourceMappingURL=cross-db-cleanup.js.map

package/dist/store/cross-db-cleanup.js.map

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

package/dist/store/data-accessor.js

@@ -1,26 +0,0 @@
-/**
- * DataAccessor re-export + factory functions.
- *
- * The DataAccessor interface is defined in @cleocode/contracts.
- * This module re-exports it and provides the concrete SQLite factory.
- *
- * @epic T4454
- */
-/**
- * Create a DataAccessor for the given working directory.
- * Always creates a SQLite accessor (ADR-006 canonical storage).
- *
- * ALL accessors returned are safety-enabled by default via SafetyDataAccessor wrapper.
- * Use CLEO_DISABLE_SAFETY=true to bypass (emergency only).
- */
-export async function createDataAccessor(_engine, cwd) {
-    const { createSqliteDataAccessor } = await import('./sqlite-data-accessor.js');
-    const inner = await createSqliteDataAccessor(cwd);
-    const { wrapWithSafety } = await import('./safety-data-accessor.js');
-    return wrapWithSafety(inner, cwd);
-}
-/** Convenience: get a DataAccessor with auto-detected engine. */
-export async function getAccessor(cwd) {
-    return createDataAccessor(undefined, cwd);
-}
-//# sourceMappingURL=data-accessor.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"data-accessor.js","sourceRoot":"","sources":["../../src/store/data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAkB,EAClB,GAAY;IAEZ,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,MAAM,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAElD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACrE,OAAO,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAY;IAEZ,OAAO,kBAAkB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC"}