@cleocode/core 2026.3.42 → 2026.3.44

package/dist/store/nexus-validation-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-validation-schemas.d.ts","sourceRoot":"","sources":["../../src/store/nexus-validation-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAc3B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBACvB,CAAC,CAAC,SAAS;qBACT,CAAC,CAAC,SAAS;qBACX,CAAC,CAAC,SAAS;cAClB,CAAC,CAAC,SAAS;2CACrB,CAAC;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAAsC,CAAC;AAI/E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAC5B,CAAC,CAAC,SAAS;gBACP,CAAC,CAAC,SAAS;2CACvB,CAAC;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAAoC,CAAC;AAI3E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAAsC,CAAC;AAC/E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAAsC,CAAC;AAI/E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/store/parsers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared JSON parsing helpers for SQLite store modules.
+ *
+ * Eliminates duplication across sqlite-data-accessor.ts, task-store.ts,
+ * and session-store.ts.
+ */
+/**
+ * Parse a JSON string, returning undefined on null/undefined input or parse error.
+ */
+export declare function safeParseJson<T>(str: string | null | undefined): T | undefined;
+/**
+ * Parse a JSON string expected to contain an array.
+ * Returns undefined for null/undefined input, empty arrays, or parse errors.
+ */
+export declare function safeParseJsonArray<T = string>(str: string | null | undefined): T[] | undefined;
+//# sourceMappingURL=parsers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/store/parsers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAO9E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,EAAE,GAAG,SAAS,CAS9F"}

package/dist/store/project-detect.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Project type detection and configuration.
+ * Produces schema-compliant ProjectContext for project-context.json.
+ *
+ * @epic T4454
+ * @task T4530
+ */
+/** Detected project type. */
+export type ProjectType = 'node' | 'python' | 'rust' | 'go' | 'ruby' | 'java' | 'dotnet' | 'bash' | 'elixir' | 'php' | 'deno' | 'bun' | 'unknown';
+/** Test framework. */
+export type TestFramework = 'jest' | 'vitest' | 'mocha' | 'pytest' | 'bats' | 'cargo' | 'go' | 'rspec' | 'junit' | 'playwright' | 'cypress' | 'ava' | 'uvu' | 'tap' | 'node:test' | 'deno' | 'bun' | 'custom' | 'unknown';
+export type FileNamingConvention = 'kebab-case' | 'snake_case' | 'camelCase' | 'PascalCase';
+export type ImportStyle = 'esm' | 'commonjs' | 'mixed';
+/** Schema-compliant project context for LLM agent consumption. */
+export interface ProjectContext {
+    schemaVersion: string;
+    detectedAt: string;
+    projectTypes: ProjectType[];
+    primaryType?: ProjectType;
+    monorepo: boolean;
+    testing?: {
+        framework?: TestFramework;
+        command?: string;
+        testFilePatterns?: string[];
+        directories?: {
+            unit?: string;
+            integration?: string;
+        };
+    };
+    build?: {
+        command?: string;
+        outputDir?: string;
+    };
+    directories?: {
+        source?: string;
+        tests?: string;
+        docs?: string;
+    };
+    conventions?: {
+        fileNaming?: FileNamingConvention;
+        importStyle?: ImportStyle;
+        typeSystem?: string;
+    };
+    llmHints?: {
+        preferredTestStyle?: string;
+        typeSystem?: string;
+        commonPatterns?: string[];
+        avoidPatterns?: string[];
+    };
+}
+/**
+ * Detect project type from directory contents.
+ * Returns a schema-compliant ProjectContext object.
+ */
+export declare function detectProjectType(projectDir: string): ProjectContext;
+//# sourceMappingURL=project-detect.d.ts.map

package/dist/store/project-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detect.d.ts","sourceRoot":"","sources":["../../src/store/project-detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,IAAI,GACJ,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,KAAK,GACL,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,sBAAsB;AACtB,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,IAAI,GACJ,OAAO,GACP,OAAO,GACP,YAAY,GACZ,SAAS,GACT,KAAK,GACL,KAAK,GACL,KAAK,GACL,WAAW,GACX,MAAM,GACN,KAAK,GACL,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAC5F,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvD,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,aAAa,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,WAAW,CAAC,EAAE;YACZ,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,oBAAoB,CAAC;QAClC,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAsKpE"}

package/dist/store/provider.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Store provider abstraction layer.
+ *
+ * Defines the StoreProvider interface backed by SQLite (ADR-006).
+ * CLI and MCP engine use StoreProvider for all data access.
+ *
+ * @epic T4454
+ * @task W1-T6
+ */
+import type { Session, Task, TaskStatus, TaskType } from '@cleocode/contracts';
+import type { TaskCurrentResult, TaskStartResult, TaskWorkHistoryEntry } from '../task-work/index.js';
+import type { AddTaskOptions, AddTaskResult } from '../tasks/add.js';
+import type { AnalysisResult } from '../tasks/analyze.js';
+import type { ArchiveTasksOptions, ArchiveTasksResult } from '../tasks/archive.js';
+import type { CompleteTaskOptions, CompleteTaskResult } from '../tasks/complete.js';
+import type { DeleteTaskOptions, DeleteTaskResult } from '../tasks/delete.js';
+import type { FindTasksOptions, FindTasksResult } from '../tasks/find.js';
+import type { ListTasksOptions, ListTasksResult } from '../tasks/list.js';
+import type { UpdateTaskOptions, UpdateTaskResult } from '../tasks/update.js';
+export type { AddTaskOptions, AddTaskResult, AnalysisResult, ArchiveTasksOptions, ArchiveTasksResult, CompleteTaskOptions, CompleteTaskResult, DeleteTaskOptions, DeleteTaskResult, FindTasksOptions, FindTasksResult, ListTasksOptions, ListTasksResult, TaskCurrentResult, TaskStartResult, TaskWorkHistoryEntry, UpdateTaskOptions, UpdateTaskResult, };
+/**
+ * Store engine type. SQLite is the only supported engine (ADR-006).
+ * @task T4647
+ */
+export type StoreEngine = 'sqlite';
+/** 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.
+ * Backed by SQLite (ADR-006 canonical storage).
+ */
+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>;
+}
+/**
+ * Create a store provider. Always creates SQLite provider (ADR-006).
+ * @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/safety-data-accessor.d.ts

@@ -0,0 +1,123 @@
+/**
+ * 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 { Session, Task, TaskStatus } from '@cleocode/contracts';
+import type { ArchiveFile, DataAccessor, QueryTasksResult, TaskFieldUpdates, TaskQueryFilters, TransactionAccessor } from './data-accessor.js';
+import type { ArchiveFields } from './db-helpers.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(): 'sqlite';
+    /**
+     * Log safety operation if verbose mode is enabled.
+     */
+    private logVerbose;
+    /**
+     * Get safety options for data-safety-central operations.
+     */
+    private getSafetyOptions;
+    loadArchive(): Promise<ArchiveFile | null>;
+    loadSessions(): Promise<Session[]>;
+    saveSessions(data: Session[]): Promise<void>;
+    saveArchive(data: ArchiveFile): Promise<void>;
+    appendLog(entry: Record<string, unknown>): Promise<void>;
+    upsertSingleTask(task: Task): Promise<void>;
+    archiveSingleTask(taskId: string, fields: ArchiveFields): Promise<void>;
+    removeSingleTask(taskId: string): Promise<void>;
+    loadSingleTask(taskId: string): Promise<Task | null>;
+    addRelation(taskId: string, relatedTo: string, relationType: string, reason?: string): Promise<void>;
+    getMetaValue<T>(key: string): Promise<T | null>;
+    setMetaValue(key: string, value: unknown): Promise<void>;
+    getSchemaVersion(): Promise<string | null>;
+    queryTasks(filters: TaskQueryFilters): Promise<QueryTasksResult>;
+    countTasks(filters?: {
+        status?: TaskStatus | TaskStatus[];
+        parentId?: string;
+    }): Promise<number>;
+    getChildren(parentId: string): Promise<Task[]>;
+    countChildren(parentId: string): Promise<number>;
+    countActiveChildren(parentId: string): Promise<number>;
+    getAncestorChain(taskId: string): Promise<Task[]>;
+    getSubtree(rootId: string): Promise<Task[]>;
+    getDependents(taskId: string): Promise<Task[]>;
+    getDependencyChain(taskId: string): Promise<string[]>;
+    taskExists(taskId: string): Promise<boolean>;
+    loadTasks(taskIds: string[]): Promise<Task[]>;
+    updateTaskFields(taskId: string, fields: TaskFieldUpdates): Promise<void>;
+    getNextPosition(parentId: string | null): Promise<number>;
+    shiftPositions(parentId: string | null, fromPosition: number, delta: number): Promise<void>;
+    transaction<T>(fn: (tx: TransactionAccessor) => Promise<T>): Promise<T>;
+    getActiveSession(): Promise<Session | null>;
+    upsertSingleSession(session: import('@cleocode/contracts').Session): Promise<void>;
+    removeSingleSession(sessionId: string): 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":"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"}

package/dist/store/schema.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Backward-compatible tasks.db schema barrel.
+ *
+ * Canonical implementation lives in `tasks-schema.ts`.
+ */
+export * from './tasks-schema.js';
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/store/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC"}

package/dist/store/session-store.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SQLite-backed session store operations.
+ *
+ * CRUD operations for sessions and task work tracking backed by tasks.db.
+ *
+ * @epic T4454
+ * @task W1-T4
+ */
+import type { Session } from '@cleocode/contracts';
+/** Create a new session. */
+export declare function createSession(session: Session, cwd?: string): Promise<Session>;
+/** Get a session by ID. */
+export declare function getSession(sessionId: string, cwd?: string): Promise<Session | null>;
+/** Update a session. */
+export declare function updateSession(sessionId: string, updates: Partial<Session>, cwd?: string): Promise<Session | null>;
+/** List sessions with optional filters. */
+export declare function listSessions(filters?: {
+    active?: boolean;
+    limit?: number;
+}, cwd?: string): Promise<Session[]>;
+/** End a session. */
+export declare function endSession(sessionId: string, note?: string, cwd?: string): Promise<Session | null>;
+/** Start working on a task within a session. */
+export declare function startTask(sessionId: string, taskId: string, cwd?: string): Promise<void>;
+/** Get current task for a session. */
+export declare function getCurrentTask(sessionId: string, cwd?: string): Promise<{
+    taskId: string | null;
+    since: string | null;
+}>;
+/** Stop working on the current task for a session. */
+export declare function stopTask(sessionId: string, cwd?: string): Promise<void>;
+/** Get work history for a session. */
+export declare function workHistory(sessionId: string, limit?: number, cwd?: string): Promise<Array<{
+    taskId: string;
+    setAt: string;
+    clearedAt: string | null;
+}>>;
+/** Garbage collect old sessions (mark ended sessions as orphaned after threshold). */
+export declare function gcSessions(maxAgeDays?: number, cwd?: string): Promise<number>;
+/** Get the currently active session (if any). */
+export declare function getActiveSession(cwd?: string): Promise<Session | null>;
+//# sourceMappingURL=session-store.d.ts.map

package/dist/store/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/store/session-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQnD,4BAA4B;AAC5B,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBpF;AAED,2BAA2B;AAC3B,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAUzF;AAED,wBAAwB;AACxB,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAgCzB;AAED,2CAA2C;AAC3C,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,EAAE,CAAC,CAgBpB;AAED,qBAAqB;AACrB,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAgBzB;AAID,gDAAgD;AAChD,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9F;AAED,sCAAsC;AACtC,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAa1D;AAED,sDAAsD;AACtD,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7E;AAED,sCAAsC;AACtC,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAW,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAe7E;AAID,sFAAsF;AACtF,wBAAsB,UAAU,CAAC,UAAU,GAAE,MAAW,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBvF;AAED,iDAAiD;AACjD,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAY5E"}

package/dist/store/sqlite-backup.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SQLite backup via VACUUM INTO with snapshot rotation.
+ *
+ * Produces self-contained, WAL-free copies of tasks.db into
+ * .cleo/backups/sqlite/ with a configurable rotation limit.
+ * All errors are swallowed -- backup failure must never interrupt
+ * normal operation.
+ *
+ * @task T4873
+ * @epic T4867
+ */
+export interface VacuumOptions {
+    cwd?: string;
+    force?: boolean;
+}
+/**
+ * Create a VACUUM INTO snapshot of the SQLite database.
+ *
+ * Debounced by default (30s). Pass `force: true` to bypass debounce.
+ * WAL checkpoint is run before the snapshot for consistency.
+ * Oldest snapshots are rotated out when MAX_SNAPSHOTS is reached.
+ *
+ * Non-fatal: all errors are swallowed.
+ */
+export declare function vacuumIntoBackup(opts?: VacuumOptions): Promise<void>;
+/**
+ * List existing SQLite backup snapshots, newest first.
+ */
+export declare function listSqliteBackups(cwd?: string): Array<{
+    name: string;
+    path: string;
+    mtimeMs: number;
+}>;
+//# sourceMappingURL=sqlite-backup.d.ts.map

package/dist/store/sqlite-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-backup.d.ts","sourceRoot":"","sources":["../../src/store/sqlite-backup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwCH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,CAAC,EAAE,MAAM,GACX,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBxD"}

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

@@ -0,0 +1,26 @@
+/**
+ * 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 type { DataAccessor } from './data-accessor.js';
+/** Write a JSON blob to the schema_meta table by key. */
+export declare function setMetaValue(cwd: string | undefined, key: string, value: unknown): Promise<void>;
+/**
+ * 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 declare function createSqliteDataAccessor(cwd?: string): Promise<DataAccessor>;
+//# sourceMappingURL=sqlite-data-accessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-data-accessor.d.ts","sourceRoot":"","sources":["../../src/store/sqlite-data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAEV,YAAY,EAKb,MAAM,oBAAoB,CAAC;AA0C5B,yDAAyD;AACzD,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAWf;AAID;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyxBlF"}

package/dist/store/sqlite.d.ts

@@ -0,0 +1,106 @@
+/**
+ * SQLite store via drizzle-orm/node-sqlite + node:sqlite (DatabaseSync).
+ *
+ * Zero native npm dependencies, 100% cross-platform (Windows/Linux/macOS).
+ * File-backed SQLite with WAL mode for multi-process concurrent access.
+ * Database stored at .cleo/tasks.db.
+ *
+ * Architecture: node:sqlite provides the synchronous file-backed SQLite engine,
+ * wrapped via drizzle-orm/node-sqlite for a fully synchronous interface. All
+ * writes go directly to disk through SQLite's native WAL mechanism -- no
+ * saveToFile() pattern needed.
+ *
+ * @epic T4454
+ * @task T4817 - node:sqlite engine migration (ADR-006, ADR-010)
+ * @task T4810 - Data loss prevention guards
+ */
+import type { DatabaseSync as _DatabaseSyncType } from 'node:sqlite';
+type DatabaseSync = _DatabaseSyncType;
+declare const DatabaseSync: new (path: import("fs").PathLike, options?: import("node:sqlite").DatabaseSyncOptions | undefined) => DatabaseSync;
+import type { NodeSQLiteDatabase } from 'drizzle-orm/node-sqlite';
+import * as schema from './tasks-schema.js';
+/**
+ * Open a node:sqlite DatabaseSync with CLEO standard pragmas.
+ *
+ * CRITICAL: WAL mode is verified, not just requested. If another process holds
+ * an EXCLUSIVE lock in DELETE mode, PRAGMA journal_mode=WAL silently returns
+ * 'delete'. This caused data loss (T5173) when concurrent MCP servers opened
+ * the same database — writes were silently dropped under lock contention.
+ */
+export declare function openNativeDatabase(path: string, options?: {
+    readonly?: boolean;
+    timeout?: number;
+    enableWal?: boolean;
+    allowExtension?: boolean;
+}): DatabaseSync;
+/** Schema version for newly created databases. Single source of truth. */
+export declare const SQLITE_SCHEMA_VERSION = "2.0.0";
+/**
+ * Get the path to the SQLite database file.
+ */
+export declare function getDbPath(cwd?: string): string;
+/**
+ * Initialize the SQLite database (lazy, singleton).
+ * Creates the database file and tables if they don't exist.
+ * Returns the drizzle ORM instance (node-sqlite driver).
+ *
+ * Uses a promise guard so concurrent callers wait for the same
+ * initialization to complete (migrations are async).
+ */
+export declare function getDb(cwd?: string): Promise<NodeSQLiteDatabase<typeof schema>>;
+/**
+ * Resolve the path to the drizzle migrations folder.
+ * Works from both src/ (dev via tsx) and dist/ (compiled).
+ */
+export declare function resolveMigrationsFolder(): string;
+/**
+ * Check if an error is a SQLite BUSY error (database locked by another process).
+ * node:sqlite throws native Error with message containing the SQLite error code.
+ * @task T5185
+ */
+export declare function isSqliteBusy(err: unknown): boolean;
+/**
+ * Close the database connection and release resources.
+ */
+export declare function closeDb(): void;
+/**
+ * Reset database singleton state without saving.
+ * Used during migrations when database file is deleted and recreated.
+ * Safe to call multiple times.
+ */
+export declare function resetDbState(): void;
+/**
+ * Get the schema version from the database.
+ */
+export declare function getSchemaVersion(cwd?: string): Promise<string | null>;
+/**
+ * Check if the database file exists.
+ */
+export declare function dbExists(cwd?: string): boolean;
+/**
+ * Get the underlying node:sqlite DatabaseSync instance.
+ * Useful for direct PRAGMA calls or raw SQL operations.
+ * Returns null if the database hasn't been initialized.
+ */
+export declare function getNativeDb(): DatabaseSync | null;
+/**
+ * Get the underlying node:sqlite DatabaseSync instance for tasks.db.
+ * Alias for getNativeDb() — mirrors getBrainNativeDb() naming convention.
+ */
+export declare function getNativeTasksDb(): DatabaseSync | null;
+export type { NodeSQLiteDatabase };
+/**
+ * Re-export schema for external use.
+ */
+export { schema };
+/**
+ * Close ALL database singletons (tasks.db, brain.db, nexus.db).
+ *
+ * Must be called before deleting temp directories on Windows, where
+ * SQLite holds exclusive file handles on .db, .db-wal, and .db-shm files.
+ * Safe to call even if some databases were never opened.
+ *
+ * @task T5508
+ */
+export declare function closeAllDatabases(): Promise<void>;
+//# sourceMappingURL=sqlite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/store/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrE,KAAK,YAAY,GAAG,iBAAiB,CAAC;AACtC,QAAA,MAAQ,YAAY,wGAC8D,YACjF,CAAC;AAMF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAMlE,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GACA,YAAY,CA6Dd;AAKD,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAY7C;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAyHD;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,OAAO,MAAM,CAAC,CAAC,CAoFpF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD;AAYD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIlD;AAmFD;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAa9B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAcnC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ3E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,YAAY,GAAG,IAAI,CAEjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAEtD;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACnC;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBvD"}

package/dist/store/status-registry.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Status Registry — re-exports from @cleocode/contracts.
+ *
+ * The canonical status definitions now live in @cleocode/contracts.
+ * This file exists for backward compatibility within the store layer.
+ */
+export type { AdrStatus, EntityType, GateStatus, ManifestStatus, PipelineStatus, SessionStatus, StageStatus, TaskStatus, } from '@cleocode/contracts';
+export { ADR_STATUSES, GATE_STATUSES, isValidStatus, LIFECYCLE_PIPELINE_STATUSES, LIFECYCLE_STAGE_STATUSES, MANIFEST_STATUSES, PIPELINE_STATUS_ICONS, SESSION_STATUSES, STAGE_STATUS_ICONS, STATUS_REGISTRY, TASK_STATUS_SYMBOLS_ASCII, TASK_STATUS_SYMBOLS_UNICODE, TASK_STATUSES, TERMINAL_PIPELINE_STATUSES, TERMINAL_STAGE_STATUSES, TERMINAL_TASK_STATUSES, } from '@cleocode/contracts';
+//# sourceMappingURL=status-registry.d.ts.map

package/dist/store/status-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-registry.d.ts","sourceRoot":"","sources":["../../src/store/status-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EACzB,2BAA2B,EAC3B,aAAa,EACb,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}