@cleocode/core 2026.3.42 → 2026.3.43

package/dist/memory/brain-row-types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Typed row interfaces for raw SQLite queries against brain.db.
+ *
+ * These replace inline `as Array<{ ... }>` casts throughout the brain/memory modules,
+ * giving each raw-SQL result shape a named, reusable type.
+ *
+ * @task T5800
+ */
+/** Row returned by FTS content_hash duplicate check. */
+export interface BrainFtsRow {
+    id: string;
+    type: string;
+    created_at: string;
+}
+/** Row returned by narrative backfill query (missing embeddings). */
+export interface BrainNarrativeRow {
+    id: string;
+    narrative: string;
+    title: string;
+}
+/** Flattened FTS hit used in hybrid search scoring. */
+export interface BrainSearchHit {
+    id: string;
+    type: string;
+    title: string;
+    text: string;
+}
+/** Row returned by KNN vector similarity query. */
+export interface BrainKnnRow {
+    id: string;
+    distance: number;
+}
+/** Decision node attached to a blocker in causal traces. */
+export interface BrainDecisionNode {
+    id: string;
+    title: string;
+    rationale?: string;
+}
+/** Anchor entry in a timeline result. */
+export interface BrainAnchor {
+    id: string;
+    type: string;
+    data: unknown;
+}
+//# sourceMappingURL=brain-row-types.d.ts.map

package/dist/memory/brain-row-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-row-types.d.ts","sourceRoot":"","sources":["../../src/memory/brain-row-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/memory/brain-search.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Full-text search across BRAIN memory using SQLite FTS5.
+ * Uses raw SQL via nativeDb because drizzle doesn't support FTS5 virtual tables.
+ *
+ * Falls back to LIKE queries if FTS5 is not available (some SQLite builds lack it).
+ *
+ * @task T5130
+ * @epic T5149
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { BrainDecisionRow, BrainLearningRow, BrainObservationRow, BrainPatternRow } from '../store/brain-schema.js';
+/** Search result with BM25 rank. */
+export interface BrainSearchResult {
+    decisions: BrainDecisionRow[];
+    patterns: BrainPatternRow[];
+    learnings: BrainLearningRow[];
+    observations: BrainObservationRow[];
+}
+/** Search options. */
+export interface BrainSearchOptions {
+    /** Max results per table. Default 10. */
+    limit?: number;
+    /** Which tables to search. Default: all four. */
+    tables?: Array<'decisions' | 'patterns' | 'learnings' | 'observations'>;
+}
+/**
+ * Create FTS5 virtual tables and content-sync triggers if they don't exist.
+ *
+ * Uses content= to sync from main tables, so inserts to main tables
+ * auto-populate FTS. UPDATE/DELETE require triggers.
+ *
+ * @task T5130
+ */
+export declare function ensureFts5Tables(nativeDb: DatabaseSync): boolean;
+/**
+ * Rebuild FTS5 indexes from the content tables.
+ * Useful after bulk inserts that bypass triggers.
+ *
+ * @task T5130
+ */
+export declare function rebuildFts5Index(nativeDb: DatabaseSync): void;
+/**
+ * Unified search across all BRAIN memory tables.
+ *
+ * Uses FTS5 MATCH for full-text search with BM25 ranking when available,
+ * falls back to LIKE queries otherwise.
+ *
+ * @task T5130
+ */
+export declare function searchBrain(projectRoot: string, query: string, options?: BrainSearchOptions): Promise<BrainSearchResult>;
+/**
+ * Reset the cached FTS5 availability flag.
+ * Used in tests to force re-detection.
+ */
+export declare function resetFts5Cache(): void;
+/** Result from hybridSearch combining multiple search signals. */
+export interface HybridResult {
+    id: string;
+    score: number;
+    type: string;
+    title: string;
+    text: string;
+    sources: Array<'fts' | 'vec' | 'graph'>;
+}
+/** Options for hybridSearch weighting and limits. */
+export interface HybridSearchOptions {
+    ftsWeight?: number;
+    vecWeight?: number;
+    graphWeight?: number;
+    limit?: number;
+}
+/**
+ * Hybrid search across FTS5, vector similarity, and graph neighbors.
+ *
+ * 1. Runs FTS5 search via existing searchBrain.
+ * 2. Runs vector similarity via searchSimilar (if available).
+ * 3. Runs graph neighbor expansion via getNeighbors (if query matches a node).
+ * 4. Normalizes scores to 0-1 using min-max normalization.
+ * 5. Combines with configurable weights.
+ * 6. Deduplicates by ID, keeping highest combined score.
+ * 7. Returns top-N sorted by score descending.
+ *
+ * Graceful fallback: if vec unavailable, redistributes weight to FTS5.
+ *
+ * @param query - Search query text
+ * @param projectRoot - Project root directory
+ * @param options - Weight and limit configuration
+ * @returns Array of hybrid results ranked by combined score
+ */
+export declare function hybridSearch(query: string, projectRoot: string, options?: HybridSearchOptions): Promise<HybridResult[]>;
+//# sourceMappingURL=brain-search.d.ts.map

package/dist/memory/brain-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-search.d.ts","sourceRoot":"","sources":["../../src/memory/brain-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAKlC,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,YAAY,EAAE,mBAAmB,EAAE,CAAC;CACrC;AAED,sBAAsB;AACtB,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,MAAM,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC,CAAC;CACzE;AAgCD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAsKhE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAiB7D;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA8B5B;AA+MD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAMD,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC,CAAC;CACzC;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,YAAY,EAAE,CAAC,CAkKzB"}

package/dist/memory/brain-similarity.d.ts

@@ -0,0 +1,33 @@
+/**
+ * BRAIN Vector Similarity Search
+ *
+ * Provides vector-based KNN search against brain_embeddings vec0 table.
+ * Falls back gracefully when no embedding provider is registered or
+ * sqlite-vec is unavailable.
+ *
+ * @task T5388
+ * @epic T5149
+ */
+export interface SimilarityResult {
+    id: string;
+    distance: number;
+    type: string;
+    title: string;
+    text: string;
+}
+/**
+ * Search for entries similar to a query string using vector similarity.
+ *
+ * 1. Embeds the query text via the registered embedding provider.
+ * 2. Runs KNN query against brain_embeddings vec0 table.
+ * 3. Joins with observation/decision/pattern/learning tables for full entries.
+ *
+ * Returns empty array when embedding is unavailable (graceful fallback).
+ *
+ * @param query - Text to find similar entries for
+ * @param projectRoot - Project root directory
+ * @param limit - Maximum results to return (default 10)
+ * @returns Array of similar entries ranked by distance (ascending)
+ */
+export declare function searchSimilar(query: string, projectRoot: string, limit?: number): Promise<SimilarityResult[]>;
+//# sourceMappingURL=brain-similarity.d.ts.map

package/dist/memory/brain-similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-similarity.d.ts","sourceRoot":"","sources":["../../src/memory/brain-similarity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA4G7B"}

package/dist/memory/claude-mem-migration.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Claude-mem to brain.db migration.
+ * Imports observations from ~/.claude-mem/claude-mem.db into brain_observations.
+ * Also creates brain_decisions from decision-typed observations and
+ * brain_learnings from session_summaries with learned fields.
+ *
+ * @epic T5149
+ * @task T5143
+ */
+/** Result from a claude-mem migration run. */
+export interface ClaudeMemMigrationResult {
+    observationsImported: number;
+    observationsSkipped: number;
+    learningsImported: number;
+    decisionsImported: number;
+    errors: string[];
+    dryRun: boolean;
+}
+/** Options for the claude-mem migration. */
+export interface ClaudeMemMigrationOptions {
+    /** Path to claude-mem.db. Default: ~/.claude-mem/claude-mem.db */
+    sourcePath?: string;
+    /** Project tag for imported entries. */
+    project?: string;
+    /** If true, count what would be imported without inserting. */
+    dryRun?: boolean;
+    /** Number of rows to insert per transaction batch. Default: 100. */
+    batchSize?: number;
+}
+/**
+ * Migrate observations from claude-mem's SQLite database into CLEO brain.db.
+ *
+ * Reads from ~/.claude-mem/claude-mem.db (or a custom path) and inserts into:
+ * - brain_observations (all observations, prefixed CM-)
+ * - brain_decisions (decision-typed observations, prefixed CMD-)
+ * - brain_learnings (session summaries with learned field, prefixed CML-)
+ *
+ * Idempotent: skips rows whose ID already exists in brain.db.
+ * After all inserts, rebuilds FTS5 indexes.
+ *
+ * @param projectRoot - The CLEO project root (for brain.db resolution)
+ * @param options - Migration options
+ */
+export declare function migrateClaudeMem(projectRoot: string, options?: ClaudeMemMigrationOptions): Promise<ClaudeMemMigrationResult>;
+//# sourceMappingURL=claude-mem-migration.d.ts.map

package/dist/memory/claude-mem-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-mem-migration.d.ts","sourceRoot":"","sources":["../../src/memory/claude-mem-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,yBAAyB;IACxC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC,CA4QnC"}

package/dist/memory/decisions.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Decision Memory module for CLEO BRAIN.
+ * Uses brain.db via BrainDataAccessor for persistent storage.
+ *
+ * Provides functions to store, recall, search, and update decisions
+ * with sequential ID generation (D001, D002, ...).
+ *
+ * @task T5155
+ * @epic T5149
+ */
+import type { BrainDecisionRow } from '../store/brain-schema.js';
+/** Parameters for storing a new decision. */
+export interface StoreDecisionParams {
+    type: BrainDecisionRow['type'];
+    decision: string;
+    rationale: string;
+    confidence: BrainDecisionRow['confidence'];
+    outcome?: BrainDecisionRow['outcome'];
+    alternatives?: string[];
+    contextEpicId?: string;
+    contextTaskId?: string;
+    contextPhase?: string;
+}
+/** Parameters for searching decisions. */
+export interface SearchDecisionParams {
+    type?: BrainDecisionRow['type'];
+    confidence?: BrainDecisionRow['confidence'];
+    outcome?: BrainDecisionRow['outcome'];
+    query?: string;
+    limit?: number;
+}
+/** Parameters for listing decisions. */
+export interface ListDecisionParams {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Store a new decision or update an existing one if a duplicate is found.
+ * Duplicate detection: same decision text (case-insensitive).
+ *
+ * @task T5155
+ */
+export declare function storeDecision(projectRoot: string, params: StoreDecisionParams): Promise<BrainDecisionRow>;
+/**
+ * Recall a specific decision by ID.
+ *
+ * @task T5155
+ */
+export declare function recallDecision(projectRoot: string, id: string): Promise<BrainDecisionRow | null>;
+/**
+ * Search decisions by type, confidence, outcome, and/or free-text query.
+ * Query searches across decision + rationale fields using LIKE.
+ *
+ * @task T5155
+ */
+export declare function searchDecisions(projectRoot: string, params?: SearchDecisionParams): Promise<BrainDecisionRow[]>;
+/**
+ * List decisions with pagination.
+ *
+ * @task T5155
+ */
+export declare function listDecisions(projectRoot: string, params?: ListDecisionParams): Promise<{
+    decisions: BrainDecisionRow[];
+    total: number;
+}>;
+/**
+ * Update the outcome of a decision after learning from results.
+ *
+ * @task T5155
+ */
+export declare function updateDecisionOutcome(projectRoot: string, id: string, outcome: BrainDecisionRow['outcome']): Promise<BrainDecisionRow>;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/memory/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/memory/decisions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,0BAA0B,CAAC;AAEtF,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6BD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAgD3B;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGlC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwB7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC;IAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAa3D;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/memory/engine-compat.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Memory Engine Compatibility Layer — Brain.db Cognitive Memory
+ *
+ * Async wrappers around brain.db cognitive memory functions that return
+ * EngineResult<T> format for consumption by the dispatch layer.
+ *
+ * After the memory domain cutover (T5241), this file contains ONLY
+ * brain.db-backed operations. Manifest operations moved to
+ * pipeline-manifest-compat.ts, and context injection moved to
+ * sessions/context-inject.ts.
+ *
+ * @task T5241
+ * @epic T5149
+ */
+import type { EngineResult } from '../engine-result.js';
+import { type SearchLearningParams, type StoreLearningParams } from './learnings.js';
+import { type SearchPatternParams, type StorePatternParams } from './patterns.js';
+/** memory.show - Look up a brain.db entry by ID */
+export declare function memoryShow(entryId: string, projectRoot?: string): Promise<EngineResult>;
+/** memory.stats - Aggregate stats from brain.db across all tables */
+export declare function memoryBrainStats(projectRoot?: string): Promise<EngineResult>;
+/** memory.decision.find - Search decisions in brain.db */
+export declare function memoryDecisionFind(params: {
+    query?: string;
+    taskId?: string;
+    limit?: number;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.decision.store - Store a decision to brain.db */
+export declare function memoryDecisionStore(params: {
+    decision: string;
+    rationale: string;
+    alternatives?: string[];
+    taskId?: string;
+    sessionId?: string;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.find - Token-efficient brain search */
+export declare function memoryFind(params: {
+    query: string;
+    limit?: number;
+    tables?: string[];
+    dateStart?: string;
+    dateEnd?: string;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.timeline - Chronological context around anchor */
+export declare function memoryTimeline(params: {
+    anchor: string;
+    depthBefore?: number;
+    depthAfter?: number;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.fetch - Batch fetch brain entries by IDs */
+export declare function memoryFetch(params: {
+    ids: string[];
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.observe - Save observation to brain */
+export declare function memoryObserve(params: {
+    text: string;
+    title?: string;
+    type?: string;
+    project?: string;
+    sourceSessionId?: string;
+    sourceType?: string;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.pattern.store - Store a pattern to BRAIN memory */
+export declare function memoryPatternStore(params: StorePatternParams, projectRoot?: string): Promise<EngineResult>;
+/** memory.pattern.find - Search patterns in BRAIN memory */
+export declare function memoryPatternFind(params: SearchPatternParams, projectRoot?: string): Promise<EngineResult>;
+/** memory.pattern.stats - Get pattern memory statistics */
+export declare function memoryPatternStats(projectRoot?: string): Promise<EngineResult>;
+/** memory.learning.store - Store a learning to BRAIN memory */
+export declare function memoryLearningStore(params: StoreLearningParams, projectRoot?: string): Promise<EngineResult>;
+/** memory.learning.find - Search learnings in BRAIN memory */
+export declare function memoryLearningFind(params: SearchLearningParams, projectRoot?: string): Promise<EngineResult>;
+/** memory.learning.stats - Get learning memory statistics */
+export declare function memoryLearningStats(projectRoot?: string): Promise<EngineResult>;
+/** memory.contradictions - Find contradictory entries in brain.db */
+export declare function memoryContradictions(projectRoot?: string): Promise<EngineResult>;
+/** memory.superseded - Find superseded entries in brain.db
+ *
+ * Identifies entries that have been superseded by newer entries on the same topic.
+ * For brain.db, we group by:
+ * - Decisions: type + contextTaskId/contextEpicId
+ * - Patterns: type + context (first 100 chars for similarity)
+ * - Learnings: source + applicableTypes
+ * - Observations: type + project
+ */
+export declare function memorySuperseded(params?: {
+    type?: string;
+    project?: string;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.link - Link a brain entry to a task */
+export declare function memoryLink(params: {
+    taskId: string;
+    entryId: string;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.unlink - Remove a link between a brain entry and a task */
+export declare function memoryUnlink(params: {
+    taskId: string;
+    entryId: string;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.graph.add - Add a node or edge to the PageIndex graph */
+export declare function memoryGraphAdd(params: {
+    nodeId?: string;
+    nodeType?: string;
+    label?: string;
+    metadataJson?: string;
+    fromId?: string;
+    toId?: string;
+    edgeType?: string;
+    weight?: number;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.graph.show - Get a node and its edges from the PageIndex graph */
+export declare function memoryGraphShow(params: {
+    nodeId: string;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.graph.neighbors - Get neighbor nodes from the PageIndex graph */
+export declare function memoryGraphNeighbors(params: {
+    nodeId: string;
+    edgeType?: string;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.reason.why - Causal trace through task dependency chains */
+export declare function memoryReasonWhy(params: {
+    taskId: string;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.reason.similar - Find semantically similar entries */
+export declare function memoryReasonSimilar(params: {
+    entryId: string;
+    limit?: number;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.search.hybrid - Hybrid search across FTS5, vector, and graph */
+export declare function memorySearchHybrid(params: {
+    query: string;
+    ftsWeight?: number;
+    vecWeight?: number;
+    graphWeight?: number;
+    limit?: number;
+}, projectRoot?: string): Promise<EngineResult>;
+/** memory.graph.remove - Remove a node or edge from the PageIndex graph */
+export declare function memoryGraphRemove(params: {
+    nodeId?: string;
+    fromId?: string;
+    toId?: string;
+    edgeType?: string;
+}, projectRoot?: string): Promise<EngineResult>;
+//# sourceMappingURL=engine-compat.d.ts.map

package/dist/memory/engine-compat.d.ts.map

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