cognitive-core 0.1.0 → 0.2.0

package/dist/memory/knowledge-graph.js

@@ -0,0 +1,273 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { DEFAULT_GRAPH_CONFIG } from '../types/knowledge-graph.js';
+import { SemanticGraphLayer, TemporalGraphLayer, CausalGraphLayer, EntityGraphLayer, } from './graph-layers/index.js';
+/**
+ * KnowledgeGraphManager
+ *
+ * Manages a multi-layer graph overlay over the knowledge note filesystem.
+ * All layers share the same node set. Each layer maintains its own edges.
+ * The graph is a derived index — it can be rebuilt from frontmatter.
+ */
+export class KnowledgeGraphManager {
+    nodes = new Map();
+    layers = new Map();
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_GRAPH_CONFIG, ...config };
+        this.initLayers();
+    }
+    initLayers() {
+        const enabled = new Set(this.config.enabledLayers);
+        this.layers.set('semantic', new SemanticGraphLayer(enabled.has('semantic')));
+        this.layers.set('temporal', new TemporalGraphLayer(enabled.has('temporal')));
+        this.layers.set('causal', new CausalGraphLayer(enabled.has('causal')));
+        this.layers.set('entity', new EntityGraphLayer(enabled.has('entity')));
+    }
+    // === Layer Access ===
+    getLayer(name) {
+        const layer = this.layers.get(name);
+        if (!layer || !layer.enabled)
+            return null;
+        return layer;
+    }
+    // === Node Management ===
+    addNode(node) {
+        this.nodes.set(node.id, node);
+    }
+    removeNode(nodeId) {
+        this.nodes.delete(nodeId);
+        // Remove edges from all layers
+        for (const layer of this.layers.values()) {
+            const edges = layer.getEdges(nodeId, 'both');
+            for (const edge of edges) {
+                layer.removeEdge(edge.from, edge.to, edge.relation);
+            }
+        }
+    }
+    getNode(nodeId) {
+        return this.nodes.get(nodeId);
+    }
+    getAllNodes() {
+        return Array.from(this.nodes.values());
+    }
+    // === Cross-Layer Queries ===
+    neighbors(nodeId, options) {
+        const depth = options?.depth ?? 1;
+        const minWeight = options?.minWeight ?? 0;
+        const targetLayers = options?.layers ?? this.config.enabledLayers;
+        const visited = new Set();
+        const queue = [{ id: nodeId, d: 0 }];
+        visited.add(nodeId);
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (current.d >= depth)
+                continue;
+            for (const layerName of targetLayers) {
+                const layer = this.layers.get(layerName);
+                if (!layer || !layer.enabled)
+                    continue;
+                const edges = layer.getEdges(current.id, 'both');
+                for (const edge of edges) {
+                    if (edge.weight < minWeight)
+                        continue;
+                    const neighborId = edge.from === current.id ? edge.to : edge.from;
+                    if (!visited.has(neighborId)) {
+                        visited.add(neighborId);
+                        queue.push({ id: neighborId, d: current.d + 1 });
+                    }
+                }
+            }
+        }
+        visited.delete(nodeId);
+        // Resolve node IDs to GraphNode objects
+        const result = [];
+        for (const id of visited) {
+            const node = this.nodes.get(id);
+            if (node)
+                result.push(node);
+        }
+        return result;
+    }
+    pathBetween(fromId, toId, options) {
+        if (fromId === toId) {
+            const node = this.nodes.get(fromId);
+            if (!node)
+                return null;
+            return [];
+        }
+        const targetLayers = options?.layers ?? this.config.enabledLayers;
+        const visited = new Set();
+        const parent = new Map();
+        const queue = [fromId];
+        visited.add(fromId);
+        while (queue.length > 0) {
+            const current = queue.shift();
+            for (const layerName of targetLayers) {
+                const layer = this.layers.get(layerName);
+                if (!layer || !layer.enabled)
+                    continue;
+                const edges = layer.getEdges(current, 'both');
+                for (const edge of edges) {
+                    const neighborId = edge.from === current ? edge.to : edge.from;
+                    if (!visited.has(neighborId)) {
+                        visited.add(neighborId);
+                        parent.set(neighborId, {
+                            from: current,
+                            edge,
+                            layer: layerName,
+                        });
+                        if (neighborId === toId) {
+                            // Reconstruct path
+                            const path = [];
+                            let node = toId;
+                            while (parent.has(node)) {
+                                const p = parent.get(node);
+                                const graphNode = this.nodes.get(node);
+                                if (graphNode) {
+                                    path.unshift({
+                                        node: graphNode,
+                                        edge: p.edge,
+                                        layer: p.layer,
+                                    });
+                                }
+                                node = p.from;
+                            }
+                            return path;
+                        }
+                        queue.push(neighborId);
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    filterNodes(filter) {
+        const results = [];
+        for (const node of this.nodes.values()) {
+            if (filter.type && node.type !== filter.type)
+                continue;
+            if (filter.minConfidence !== undefined &&
+                node.confidence < filter.minConfidence)
+                continue;
+            if (filter.domains &&
+                !filter.domains.some((d) => node.domains.includes(d)))
+                continue;
+            if (filter.entities &&
+                !filter.entities.some((e) => node.entities.includes(e)))
+                continue;
+            if (filter.tags && !filter.tags.some((t) => node.tags.includes(t)))
+                continue;
+            results.push(node);
+        }
+        return results;
+    }
+    crossSystemLinks(nodeId) {
+        const result = [];
+        for (const layer of this.layers.values()) {
+            if (!layer.enabled)
+                continue;
+            const edges = layer.getEdges(nodeId, 'both');
+            for (const edge of edges) {
+                if (edge.crossSystem)
+                    result.push(edge);
+            }
+        }
+        return result;
+    }
+    // === Rebuild ===
+    rebuildAll(notes) {
+        // Rebuild node registry
+        this.nodes.clear();
+        for (const note of notes) {
+            this.addNode(this.noteToGraphNode(note));
+        }
+        // Rebuild each enabled layer
+        for (const layer of this.layers.values()) {
+            if (layer.enabled) {
+                layer.rebuild(notes);
+            }
+        }
+    }
+    noteToGraphNode(note) {
+        return {
+            id: note.frontmatter.id,
+            file: note.filePath,
+            type: note.frontmatter.type,
+            domains: note.frontmatter.domain,
+            entities: note.frontmatter.entities,
+            tags: note.frontmatter.tags,
+            confidence: note.frontmatter.confidence,
+            updated: note.frontmatter.updated,
+        };
+    }
+    // === Persistence ===
+    async loadFromDisk(dir) {
+        try {
+            // Load nodes
+            const nodesPath = join(dir, 'nodes.json');
+            const nodesData = await readFile(nodesPath, 'utf-8');
+            const nodesObj = JSON.parse(nodesData);
+            this.nodes.clear();
+            for (const [id, node] of Object.entries(nodesObj)) {
+                this.nodes.set(id, node);
+            }
+            // Load each enabled layer
+            const layersDir = join(dir, 'layers');
+            for (const [name, layer] of this.layers.entries()) {
+                if (!layer.enabled)
+                    continue;
+                try {
+                    const layerPath = join(layersDir, `${name}.json`);
+                    const layerData = await readFile(layerPath, 'utf-8');
+                    const edges = JSON.parse(layerData);
+                    layer.clear();
+                    for (const edge of edges) {
+                        layer.addEdge(edge);
+                    }
+                }
+                catch {
+                    // Layer file doesn't exist yet — that's fine
+                }
+            }
+        }
+        catch {
+            // No graph data on disk yet — start fresh
+        }
+    }
+    async saveToDisk(dir) {
+        await mkdir(dir, { recursive: true });
+        const layersDir = join(dir, 'layers');
+        await mkdir(layersDir, { recursive: true });
+        // Save nodes
+        const nodesObj = {};
+        for (const [id, node] of this.nodes.entries()) {
+            nodesObj[id] = node;
+        }
+        await writeFile(join(dir, 'nodes.json'), JSON.stringify(nodesObj, null, 2));
+        // Save each enabled layer
+        for (const [name, layer] of this.layers.entries()) {
+            if (!layer.enabled)
+                continue;
+            const edges = layer.getAllEdges();
+            await writeFile(join(layersDir, `${name}.json`), JSON.stringify(edges, null, 2));
+        }
+    }
+    // === Stats ===
+    getStats() {
+        const edgeCountByLayer = {};
+        const enabledLayers = [];
+        for (const [name, layer] of this.layers.entries()) {
+            if (layer.enabled) {
+                enabledLayers.push(name);
+                edgeCountByLayer[name] = layer.edgeCount();
+            }
+        }
+        return {
+            nodeCount: this.nodes.size,
+            edgeCountByLayer,
+            enabledLayers,
+        };
+    }
+}
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/memory/knowledge-graph.js.map

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

package/dist/memory/meta.d.ts

@@ -2,8 +2,11 @@
  * Meta Memory - Learning about learning
  * Tracks routing decisions, memory effectiveness, and execution patterns
  * to improve future learning and routing decisions
+ *
+ * Backed by SqlitePersistence for unified database storage.
  */
 import type { MetaObservation, MetaStrategy, RoutingAnalysis, RetrievalAnalysis, MetaStats, MetaContext, RoutingDecisionType } from '../types/index.js';
+import type { SqlitePersistence } from '../persistence/index.js';
 /**
  * Filter options for querying observations
  */
@@ -18,10 +21,9 @@ export interface ObservationFilter {
  * Meta Memory - Store for meta-learning observations and strategies
  */
 export declare class MetaMemory {
-    private observations;
-    private strategies;
+    private persistence;
     private initialized;
-    constructor(baseDir: string);
+    constructor(persistence: SqlitePersistence);
     init(): Promise<void>;
     /**
      * Record a meta-observation after task completion
@@ -37,17 +39,14 @@ export declare class MetaMemory {
     getByTrajectoryId(trajectoryId: string): Promise<MetaObservation | undefined>;
     /**
      * Analyze routing effectiveness
-     * Returns: which routing decisions lead to success in which contexts
      */
     analyzeRoutingEffectiveness(): Promise<RoutingAnalysis>;
     /**
      * Analyze memory retrieval quality
-     * Returns: which retrieval patterns help vs mislead
      */
     analyzeRetrievalQuality(): Promise<RetrievalAnalysis>;
     /**
      * Generate meta-strategies from observations
-     * Called periodically to distill learning patterns
      */
     generateMetaStrategies(): Promise<MetaStrategy[]>;
     /**
@@ -79,12 +78,12 @@ export declare class MetaMemory {
      */
     pruneOldObservations(maxAge?: number): Promise<number>;
     /**
-     * Close the stores
+     * Close the stores (no-op — SqlitePersistence lifecycle is managed externally)
      */
     close(): Promise<void>;
 }
 /**
  * Create a meta memory store
  */
-export declare function createMetaMemory(baseDir: string): MetaMemory;
+export declare function createMetaMemory(persistence: SqlitePersistence): MetaMemory;
 //# sourceMappingURL=meta.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/memory/meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAI3B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,MAAM;IAerB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACG,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE;;OAEG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAwC7E;;OAEG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IASvC;;;OAGG;IACG,2BAA2B,IAAI,OAAO,CAAC,eAAe,CAAC;IAuC7D;;;OAGG;IACG,uBAAuB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA4C3D;;;OAGG;IACG,sBAAsB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA2GvD;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgC1E;;OAEG;IACG,yBAAyB,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAiBhB;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAKhE;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKjD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IA2DpC;;OAEG;IACG,oBAAoB,CAAC,MAAM,GAAE,MAAiC,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBtF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAE5D"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/memory/meta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,iBAAiB,EAAuC,MAAM,yBAAyB,CAAC;AAGtG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkCD;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,iBAAiB;IAIpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;IACG,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE;;OAEG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAmC7E;;OAEG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IASvC;;OAEG;IACG,2BAA2B,IAAI,OAAO,CAAC,eAAe,CAAC;IAkC7D;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA4C3D;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAqGvD;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgC1E;;OAEG;IACG,yBAAyB,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAiBhB;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAMhE;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKjD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IAiDpC;;OAEG;IACG,oBAAoB,CAAC,MAAM,GAAE,MAAiC,GAAG,OAAO,CAAC,MAAM,CAAC;IAMtF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,GAAG,UAAU,CAE3E"}