@cleocode/cleo 2026.2.5

package/dist/store/provider.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Store provider abstraction layer.
+ *
+ * Defines the StoreProvider interface that both JSON and SQLite stores implement.
+ * CLI and MCP engine use StoreProvider — switchable via config.
+ *
+ * Config flag: storage.engine: "json" | "sqlite" in .cleo/config.json
+ * Default: "sqlite" for new projects, "json" for existing (until migrated).
+ *
+ * @epic T4454
+ * @task W1-T6
+ */
+import type { Task, TaskStatus, TaskType } from '../types/task.js';
+import type { Session } from '../types/session.js';
+import type { AddTaskOptions, AddTaskResult } from '../core/tasks/add.js';
+import type { CompleteTaskOptions, CompleteTaskResult } from '../core/tasks/complete.js';
+import type { UpdateTaskOptions, UpdateTaskResult } from '../core/tasks/update.js';
+import type { DeleteTaskOptions, DeleteTaskResult } from '../core/tasks/delete.js';
+import type { FindTasksOptions, FindTasksResult } from '../core/tasks/find.js';
+import type { ListTasksOptions, ListTasksResult } from '../core/tasks/list.js';
+import type { ArchiveTasksOptions, ArchiveTasksResult } from '../core/tasks/archive.js';
+import type { TaskCurrentResult, TaskStartResult, TaskWorkHistoryEntry } from '../core/task-work/index.js';
+export type FocusShowResult = TaskCurrentResult;
+export type FocusSetResult = TaskStartResult;
+export type FocusHistoryEntry = TaskWorkHistoryEntry;
+import type { AnalysisResult } from '../core/tasks/analyze.js';
+export type { AddTaskOptions, AddTaskResult, CompleteTaskOptions, CompleteTaskResult, UpdateTaskOptions, UpdateTaskResult, DeleteTaskOptions, DeleteTaskResult, FindTasksOptions, FindTasksResult, ListTasksOptions, ListTasksResult, ArchiveTasksOptions, ArchiveTasksResult, TaskCurrentResult, TaskStartResult, TaskWorkHistoryEntry, AnalysisResult, };
+/**
+ * Store engine type.
+ * 'dual' writes to both JSON and SQLite, reads from SQLite with JSON fallback.
+ * @task T4647
+ */
+export type StoreEngine = 'json' | 'sqlite' | 'dual';
+/** Common task filter options. */
+export interface TaskFilters {
+    status?: TaskStatus;
+    parentId?: string | null;
+    type?: TaskType;
+    phase?: string;
+    limit?: number;
+}
+/** Common session filter options. */
+export interface SessionFilters {
+    active?: boolean;
+    limit?: number;
+}
+/**
+ * Store provider interface.
+ * Both JSON and SQLite stores implement this contract.
+ */
+export interface StoreProvider {
+    readonly engine: StoreEngine;
+    createTask(task: Task): Promise<Task>;
+    getTask(taskId: string): Promise<Task | null>;
+    updateTask(taskId: string, updates: Partial<Task>): Promise<Task | null>;
+    deleteTask(taskId: string): Promise<boolean>;
+    listTasks(filters?: TaskFilters): Promise<Task[]>;
+    findTasks(query: string, limit?: number): Promise<Task[]>;
+    archiveTask(taskId: string, reason?: string): Promise<boolean>;
+    createSession(session: Session): Promise<Session>;
+    getSession(sessionId: string): Promise<Session | null>;
+    updateSession(sessionId: string, updates: Partial<Session>): Promise<Session | null>;
+    listSessions(filters?: SessionFilters): Promise<Session[]>;
+    endSession(sessionId: string, note?: string): Promise<Session | null>;
+    startTaskOnSession(sessionId: string, taskId: string): Promise<void>;
+    getCurrentTaskForSession(sessionId: string): Promise<{
+        taskId: string | null;
+        since: string | null;
+    }>;
+    stopTaskOnSession(sessionId: string): Promise<void>;
+    close(): Promise<void>;
+    /** Add a task with full validation, ID generation, and logging. */
+    addTask(options: AddTaskOptions): Promise<AddTaskResult>;
+    /** Complete a task with dependency checks and optional auto-completion. */
+    completeTask(options: CompleteTaskOptions): Promise<CompleteTaskResult>;
+    /** Update a task with rich options (addLabels, removeDepends, etc.). */
+    richUpdateTask(options: UpdateTaskOptions): Promise<UpdateTaskResult>;
+    /** Show a task by ID (throws CleoError if not found). */
+    showTask(taskId: string): Promise<Task>;
+    /** Delete a task with force/cascade options. */
+    richDeleteTask(options: DeleteTaskOptions): Promise<DeleteTaskResult>;
+    /** Find tasks with fuzzy/ID/exact search and filtering. */
+    richFindTasks(options: FindTasksOptions): Promise<FindTasksResult>;
+    /** List tasks with full filtering and pagination. */
+    richListTasks(options: ListTasksOptions): Promise<ListTasksResult>;
+    /** Archive tasks in batch with filtering options. */
+    richArchiveTasks(options: ArchiveTasksOptions): Promise<ArchiveTasksResult>;
+    /** Start a new session with scope, auto-start, etc. */
+    startSession(options: {
+        name: string;
+        scope: string;
+        autoStart?: boolean;
+        startTask?: string;
+        agent?: string;
+    }): Promise<Session>;
+    /** End a session, optionally by ID with a note. */
+    richEndSession(options?: {
+        sessionId?: string;
+        note?: string;
+    }): Promise<Session>;
+    /** Get the current active session status. */
+    sessionStatus(): Promise<Session | null>;
+    /** Resume a previously ended session. */
+    resumeSession(sessionId: string): Promise<Session>;
+    /** List sessions with status/limit filters. */
+    richListSessions(options?: {
+        status?: string;
+        limit?: number;
+    }): Promise<Session[]>;
+    /** Garbage collect old sessions. */
+    gcSessions(maxAgeHours?: number): Promise<{
+        orphaned: string[];
+        removed: string[];
+    }>;
+    /** Show current task work state. */
+    currentTask(): Promise<TaskCurrentResult>;
+    /** Start working on a task by ID. */
+    startTask(taskId: string): Promise<TaskStartResult>;
+    /** Stop working on the current task. */
+    stopTask(): Promise<{
+        previousTask: string | null;
+    }>;
+    /** Get task work history. */
+    getWorkHistory(): Promise<TaskWorkHistoryEntry[]>;
+    /** List all labels with task counts. */
+    listLabels(): Promise<Array<{
+        label: string;
+        count: number;
+        statuses: Record<string, number>;
+    }>>;
+    /** Show tasks with a specific label. */
+    showLabelTasks(label: string): Promise<Record<string, unknown>>;
+    /** Get detailed label statistics. */
+    getLabelStats(): Promise<Record<string, unknown>>;
+    /** Suggest related tasks based on shared attributes. */
+    suggestRelated(taskId: string, opts?: {
+        threshold?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Add a relationship between two tasks. */
+    addRelation(from: string, to: string, type: string, reason: string): Promise<Record<string, unknown>>;
+    /** Discover related tasks using various methods. */
+    discoverRelated(taskId: string): Promise<Record<string, unknown>>;
+    /** List existing relations for a task. */
+    listRelations(taskId: string): Promise<Record<string, unknown>>;
+    /** Analyze task priority with leverage scoring. */
+    analyzeTaskPriority(opts?: {
+        autoStart?: boolean;
+    }): Promise<AnalysisResult>;
+}
+/**
+ * Detect the configured storage engine from .cleo/config.json.
+ * Falls back to 'sqlite' for new projects (CLEO V2 default).
+ * Auto-detects 'json' for existing projects with todo.json but no tasks.db.
+ * @task T4647
+ */
+export declare function detectStoreEngine(cwd?: string): StoreEngine;
+/**
+ * Create a store provider based on engine type.
+ * @task T4647
+ */
+export declare function createStoreProvider(engine?: StoreEngine, cwd?: string): Promise<StoreProvider>;
+//# sourceMappingURL=provider.d.ts.map

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

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

package/dist/store/provider.js

@@ -0,0 +1,319 @@
+/**
+ * Store provider abstraction layer.
+ *
+ * Defines the StoreProvider interface that both JSON and SQLite stores implement.
+ * CLI and MCP engine use StoreProvider — switchable via config.
+ *
+ * Config flag: storage.engine: "json" | "sqlite" in .cleo/config.json
+ * Default: "sqlite" for new projects, "json" for existing (until migrated).
+ *
+ * @epic T4454
+ * @task W1-T6
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCleoDirAbsolute } from '../core/paths.js';
+import { getAccessor } from './data-accessor.js';
+/**
+ * Create high-level domain operation methods that delegate to core modules.
+ * An accessor is created once and passed to every core call, ensuring that
+ * the configured storage engine (JSON, SQLite, dual) is actually used.
+ *
+ * @task T4656
+ * @epic T4654
+ */
+async function createDomainOps(cwd, accessor) {
+    const { addTask } = await import('../core/tasks/add.js');
+    const { completeTask } = await import('../core/tasks/complete.js');
+    const { updateTask } = await import('../core/tasks/update.js');
+    const { showTask } = await import('../core/tasks/show.js');
+    const { deleteTask } = await import('../core/tasks/delete.js');
+    const { findTasks } = await import('../core/tasks/find.js');
+    const { listTasks } = await import('../core/tasks/list.js');
+    const { archiveTasks } = await import('../core/tasks/archive.js');
+    const labels = await import('../core/tasks/labels.js');
+    const relates = await import('../core/tasks/relates.js');
+    const { analyzeTaskPriority } = await import('../core/tasks/analyze.js');
+    const sessions = await import('../core/sessions/index.js');
+    const taskWork = await import('../core/task-work/index.js');
+    // Resolve accessor once; all domain ops share the same instance.
+    // If not provided, auto-detect from config (getAccessor).
+    const acc = accessor ?? await getAccessor(cwd);
+    return {
+        addTask: (options) => addTask(options, cwd, acc),
+        completeTask: (options) => completeTask(options, cwd, acc),
+        richUpdateTask: (options) => updateTask(options, cwd, acc),
+        showTask: (taskId) => showTask(taskId, cwd, acc),
+        richDeleteTask: (options) => deleteTask(options, cwd, acc),
+        richFindTasks: (options) => findTasks(options, cwd, acc),
+        richListTasks: (options) => listTasks(options, cwd, acc),
+        richArchiveTasks: (options) => archiveTasks(options, cwd, acc),
+        listLabels: () => labels.listLabels(cwd, acc),
+        showLabelTasks: (label) => labels.showLabelTasks(label, cwd, acc),
+        getLabelStats: () => labels.getLabelStats(cwd, acc),
+        suggestRelated: (taskId, opts) => relates.suggestRelated(taskId, { ...opts, cwd }, acc),
+        addRelation: (from, to, type, reason) => relates.addRelation(from, to, type, reason, cwd, acc),
+        discoverRelated: (taskId) => relates.discoverRelated(taskId, cwd, acc),
+        listRelations: (taskId) => relates.listRelations(taskId, cwd, acc),
+        analyzeTaskPriority: (opts) => analyzeTaskPriority({ ...opts, cwd }, acc),
+        startSession: (options) => sessions.startSession(options, cwd, acc),
+        richEndSession: (options) => sessions.endSession(options, cwd, acc),
+        sessionStatus: () => sessions.sessionStatus(cwd, acc),
+        resumeSession: (sessionId) => sessions.resumeSession(sessionId, cwd, acc),
+        richListSessions: (options) => sessions.listSessions(options, cwd, acc),
+        gcSessions: (maxAgeHours) => sessions.gcSessions(maxAgeHours, cwd, acc),
+        currentTask: () => taskWork.currentTask(cwd, acc),
+        startTask: (taskId) => taskWork.startTask(taskId, cwd, acc),
+        stopTask: () => taskWork.stopTask(cwd, acc),
+        getWorkHistory: () => taskWork.getWorkHistory(cwd, acc),
+    };
+}
+/**
+ * Detect the configured storage engine from .cleo/config.json.
+ * Falls back to 'sqlite' for new projects (CLEO V2 default).
+ * Auto-detects 'json' for existing projects with todo.json but no tasks.db.
+ * @task T4647
+ */
+export function detectStoreEngine(cwd) {
+    const cleoDir = getCleoDirAbsolute(cwd);
+    // Check config for explicit setting
+    const configPath = join(cleoDir, 'config.json');
+    if (existsSync(configPath)) {
+        try {
+            const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            const engine = config?.storage?.engine;
+            if (engine === 'sqlite' || engine === 'json' || engine === 'dual')
+                return engine;
+        }
+        catch {
+            // Fall through to auto-detection
+        }
+    }
+    // Auto-detect: if tasks.db exists, use sqlite
+    const dbPath = join(cleoDir, 'tasks.db');
+    if (existsSync(dbPath))
+        return 'sqlite';
+    // Backward compat: if todo.json exists (but no tasks.db), keep json
+    const todoPath = join(cleoDir, 'todo.json');
+    if (existsSync(todoPath))
+        return 'json';
+    // Default: sqlite (CLEO V2 default for new projects)
+    return 'sqlite';
+}
+/**
+ * Create a store provider based on engine type.
+ * @task T4647
+ */
+export async function createStoreProvider(engine, cwd) {
+    const resolvedEngine = engine ?? detectStoreEngine(cwd);
+    if (resolvedEngine === 'sqlite') {
+        return createSqliteProvider(cwd);
+    }
+    if (resolvedEngine === 'dual') {
+        return createDualWriteProvider(cwd);
+    }
+    // JSON store - delegates to existing core module functions
+    const { createJsonStoreProvider } = await import('./json-provider.js');
+    return createJsonStoreProvider(cwd);
+}
+/**
+ * Create a pure SQLite store provider.
+ * @task T4647
+ */
+async function createSqliteProvider(cwd) {
+    const sqliteStore = await import('./task-store.js');
+    const sessionStore = await import('./session-store.js');
+    const { closeDb } = await import('./sqlite.js');
+    const domainOps = await createDomainOps(cwd);
+    return {
+        engine: 'sqlite',
+        createTask: (task) => sqliteStore.createTask(task, cwd),
+        getTask: (taskId) => sqliteStore.getTask(taskId, cwd),
+        updateTask: (taskId, updates) => sqliteStore.updateTask(taskId, updates, cwd),
+        deleteTask: (taskId) => sqliteStore.deleteTask(taskId, cwd),
+        listTasks: (filters) => sqliteStore.listTasks(filters, cwd),
+        findTasks: (query, limit) => sqliteStore.findTasks(query, limit, cwd),
+        archiveTask: (taskId, reason) => sqliteStore.archiveTask(taskId, reason, cwd),
+        createSession: (session) => sessionStore.createSession(session, cwd),
+        getSession: (sessionId) => sessionStore.getSession(sessionId, cwd),
+        updateSession: (sessionId, updates) => sessionStore.updateSession(sessionId, updates, cwd),
+        listSessions: (filters) => sessionStore.listSessions(filters, cwd),
+        endSession: (sessionId, note) => sessionStore.endSession(sessionId, note, cwd),
+        startTaskOnSession: (sessionId, taskId) => sessionStore.startTask(sessionId, taskId, cwd),
+        getCurrentTaskForSession: (sessionId) => sessionStore.getCurrentTask(sessionId, cwd),
+        stopTaskOnSession: (sessionId) => sessionStore.stopTask(sessionId, cwd),
+        close: async () => closeDb(),
+        ...domainOps,
+    };
+}
+/**
+ * Create a dual-write store provider.
+ *
+ * Writes to BOTH JSON and SQLite stores. Reads from SQLite, falling
+ * back to JSON if the SQLite read fails. Logs discrepancies to stderr.
+ *
+ * @task T4647
+ * @epic T4638
+ */
+async function createDualWriteProvider(cwd) {
+    const { createJsonStoreProvider } = await import('./json-provider.js');
+    const jsonProvider = createJsonStoreProvider(cwd);
+    const sqliteProvider = await createSqliteProvider(cwd);
+    const domainOps = await createDomainOps(cwd);
+    /** Log dual-write discrepancy to stderr. */
+    function logDiscrepancy(op, detail) {
+        process.stderr.write(`[dual-write] ${op}: ${detail}\n`);
+    }
+    return {
+        engine: 'dual',
+        // --- Task CRUD: write to both, read from SQLite with JSON fallback ---
+        createTask: async (task) => {
+            const [sqliteResult] = await Promise.allSettled([
+                sqliteProvider.createTask(task),
+                jsonProvider.createTask(task),
+            ]);
+            if (sqliteResult.status === 'fulfilled')
+                return sqliteResult.value;
+            logDiscrepancy('createTask', `SQLite write failed: ${String(sqliteResult.reason)}`);
+            return jsonProvider.createTask(task);
+        },
+        getTask: async (taskId) => {
+            try {
+                return await sqliteProvider.getTask(taskId);
+            }
+            catch {
+                logDiscrepancy('getTask', `SQLite read failed for ${taskId}, falling back to JSON`);
+                return jsonProvider.getTask(taskId);
+            }
+        },
+        updateTask: async (taskId, updates) => {
+            const [sqliteResult] = await Promise.allSettled([
+                sqliteProvider.updateTask(taskId, updates),
+                jsonProvider.updateTask(taskId, updates),
+            ]);
+            if (sqliteResult.status === 'fulfilled')
+                return sqliteResult.value;
+            logDiscrepancy('updateTask', `SQLite write failed for ${taskId}`);
+            return jsonProvider.updateTask(taskId, updates);
+        },
+        deleteTask: async (taskId) => {
+            const [sqliteResult] = await Promise.allSettled([
+                sqliteProvider.deleteTask(taskId),
+                jsonProvider.deleteTask(taskId),
+            ]);
+            if (sqliteResult.status === 'fulfilled')
+                return sqliteResult.value;
+            logDiscrepancy('deleteTask', `SQLite write failed for ${taskId}`);
+            return jsonProvider.deleteTask(taskId);
+        },
+        listTasks: async (filters) => {
+            try {
+                return await sqliteProvider.listTasks(filters);
+            }
+            catch {
+                logDiscrepancy('listTasks', 'SQLite read failed, falling back to JSON');
+                return jsonProvider.listTasks(filters);
+            }
+        },
+        findTasks: async (query, limit) => {
+            try {
+                return await sqliteProvider.findTasks(query, limit);
+            }
+            catch {
+                logDiscrepancy('findTasks', 'SQLite read failed, falling back to JSON');
+                return jsonProvider.findTasks(query, limit);
+            }
+        },
+        archiveTask: async (taskId, reason) => {
+            const [sqliteResult] = await Promise.allSettled([
+                sqliteProvider.archiveTask(taskId, reason),
+                jsonProvider.archiveTask(taskId, reason),
+            ]);
+            if (sqliteResult.status === 'fulfilled')
+                return sqliteResult.value;
+            logDiscrepancy('archiveTask', `SQLite write failed for ${taskId}`);
+            return jsonProvider.archiveTask(taskId, reason);
+        },
+        // --- Session CRUD: write to both, read from SQLite with JSON fallback ---
+        createSession: async (session) => {
+            const [sqliteResult] = await Promise.allSettled([
+                sqliteProvider.createSession(session),
+                jsonProvider.createSession(session),
+            ]);
+            if (sqliteResult.status === 'fulfilled')
+                return sqliteResult.value;
+            logDiscrepancy('createSession', 'SQLite write failed');
+            return jsonProvider.createSession(session);
+        },
+        getSession: async (sessionId) => {
+            try {
+                return await sqliteProvider.getSession(sessionId);
+            }
+            catch {
+                logDiscrepancy('getSession', `SQLite read failed for ${sessionId}, falling back to JSON`);
+                return jsonProvider.getSession(sessionId);
+            }
+        },
+        updateSession: async (sessionId, updates) => {
+            const [sqliteResult] = await Promise.allSettled([
+                sqliteProvider.updateSession(sessionId, updates),
+                jsonProvider.updateSession(sessionId, updates),
+            ]);
+            if (sqliteResult.status === 'fulfilled')
+                return sqliteResult.value;
+            logDiscrepancy('updateSession', `SQLite write failed for ${sessionId}`);
+            return jsonProvider.updateSession(sessionId, updates);
+        },
+        listSessions: async (filters) => {
+            try {
+                return await sqliteProvider.listSessions(filters);
+            }
+            catch {
+                logDiscrepancy('listSessions', 'SQLite read failed, falling back to JSON');
+                return jsonProvider.listSessions(filters);
+            }
+        },
+        endSession: async (sessionId, note) => {
+            const [sqliteResult] = await Promise.allSettled([
+                sqliteProvider.endSession(sessionId, note),
+                jsonProvider.endSession(sessionId, note),
+            ]);
+            if (sqliteResult.status === 'fulfilled')
+                return sqliteResult.value;
+            logDiscrepancy('endSession', `SQLite write failed for ${sessionId}`);
+            return jsonProvider.endSession(sessionId, note);
+        },
+        // --- Task work: write to both, read from SQLite with JSON fallback ---
+        startTaskOnSession: async (sessionId, taskId) => {
+            await Promise.allSettled([
+                sqliteProvider.startTaskOnSession(sessionId, taskId),
+                jsonProvider.startTaskOnSession(sessionId, taskId),
+            ]);
+        },
+        getCurrentTaskForSession: async (sessionId) => {
+            try {
+                return await sqliteProvider.getCurrentTaskForSession(sessionId);
+            }
+            catch {
+                logDiscrepancy('getCurrentTaskForSession', `SQLite read failed for ${sessionId}`);
+                return jsonProvider.getCurrentTaskForSession(sessionId);
+            }
+        },
+        stopTaskOnSession: async (sessionId) => {
+            await Promise.allSettled([
+                sqliteProvider.stopTaskOnSession(sessionId),
+                jsonProvider.stopTaskOnSession(sessionId),
+            ]);
+        },
+        // --- Lifecycle ---
+        close: async () => {
+            await Promise.allSettled([
+                sqliteProvider.close(),
+                jsonProvider.close(),
+            ]);
+        },
+        // --- High-level domain operations (delegate to core modules) ---
+        ...domainOps,
+    };
+}
+//# sourceMappingURL=provider.js.map

package/dist/store/provider.js.map

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

package/dist/store/safety-data-accessor.d.ts

@@ -0,0 +1,99 @@
+/**
+ * SafetyDataAccessor - Factory-level safety wrapper for ALL data accessors.
+ *
+ * This wrapper ensures that ALL data operations are safety-enabled by default.
+ * No code path can bypass safety - this is the architectural guarantee.
+ *
+ * Key features:
+ * - Sequence validation before writes
+ * - Write verification (read-back validation)
+ * - Automatic git checkpointing
+ * - Emergency disable via CLEO_DISABLE_SAFETY env var
+ *
+ * @task T4745
+ * @epic T4732
+ */
+import type { DataAccessor, ArchiveFile, SessionsFile } from './data-accessor.js';
+import type { TaskFile } from '../types/task.js';
+/** Safety configuration for the wrapper. */
+interface WrapperSafetyConfig {
+    /** Enable all safety checks (default: true) */
+    enabled: boolean;
+    /** Log safety operations (default: false) */
+    verbose: boolean;
+}
+/**
+ * Safety-enabled DataAccessor wrapper.
+ *
+ * Wraps any DataAccessor implementation and automatically applies
+ * safety checks to all write operations. Read operations pass through.
+ *
+ * This class CANNOT be bypassed - it's the only way to get a DataAccessor
+ * from the factory (unless emergency disable is active).
+ */
+export declare class SafetyDataAccessor implements DataAccessor {
+    /** The underlying accessor being wrapped. */
+    private inner;
+    /** Working directory for operations. */
+    private cwd?;
+    /** Safety configuration. */
+    private config;
+    /**
+     * Create a SafetyDataAccessor wrapper.
+     *
+     * @param inner - The DataAccessor to wrap
+     * @param cwd - Working directory for path resolution
+     * @param config - Optional safety configuration overrides
+     */
+    constructor(inner: DataAccessor, cwd?: string, config?: Partial<WrapperSafetyConfig>);
+    /** The storage engine backing this accessor. */
+    get engine(): 'json' | 'sqlite' | 'dual';
+    /**
+     * Log safety operation if verbose mode is enabled.
+     */
+    private log;
+    /**
+     * Get safety options for data-safety-central operations.
+     */
+    private getSafetyOptions;
+    loadTaskFile(): Promise<TaskFile>;
+    loadArchive(): Promise<ArchiveFile | null>;
+    loadSessions(): Promise<SessionsFile>;
+    /** @deprecated Use loadTaskFile() instead. */
+    loadTodoFile(): Promise<TaskFile>;
+    saveTaskFile(data: TaskFile): Promise<void>;
+    /** @deprecated Use saveTaskFile() instead. */
+    saveTodoFile(data: TaskFile): Promise<void>;
+    saveSessions(data: SessionsFile): Promise<void>;
+    saveArchive(data: ArchiveFile): Promise<void>;
+    appendLog(entry: Record<string, unknown>): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Wrap a DataAccessor with safety.
+ *
+ * This is the internal factory helper that wraps any accessor
+ * with the SafetyDataAccessor wrapper.
+ *
+ * @param accessor - The accessor to wrap
+ * @param cwd - Working directory
+ * @returns SafetyDataAccessor wrapping the input
+ */
+export declare function wrapWithSafety(accessor: DataAccessor, cwd?: string): DataAccessor;
+/**
+ * Check if safety is currently enabled.
+ *
+ * @returns true if safety checks are active
+ */
+export declare function isSafetyEnabled(): boolean;
+/**
+ * Get safety status information.
+ *
+ * @returns Object with safety status details
+ */
+export declare function getSafetyStatus(): {
+    enabled: boolean;
+    reason?: string;
+};
+export {};
+//# sourceMappingURL=safety-data-accessor.d.ts.map

package/dist/store/safety-data-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-data-accessor.d.ts","sourceRoot":"","sources":["../../src/store/safety-data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AASjD,4CAA4C;AAC5C,UAAU,mBAAmB;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;CAClB;AAOD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,6CAA6C;IAC7C,OAAO,CAAC,KAAK,CAAe;IAE5B,wCAAwC;IACxC,OAAO,CAAC,GAAG,CAAC,CAAS;IAErB,4BAA4B;IAC5B,OAAO,CAAC,MAAM,CAAsB;IAEpC;;;;;;OAMG;gBAED,KAAK,EAAE,YAAY,EACnB,GAAG,CAAC,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAevC,gDAAgD;IAChD,IAAI,MAAM,IAAI,MAAM,GAAG,QAAQ,GAAG,MAAM,CAEvC;IAED;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWlB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC;IAMjC,WAAW,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK1C,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAK3C,8CAA8C;IACxC,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC;IAMjC,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,8CAA8C;IACxC,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,EACtB,GAAG,CAAC,EAAE,MAAM,GACX,YAAY,CASd;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAWA"}