cognitive-core 0.1.0 → 0.2.0

package/dist/memory/graph-layers/base.js

@@ -0,0 +1,143 @@
+import { inferLayerFromRelation } from '../../types/knowledge.js';
+/**
+ * Base implementation for a graph layer.
+ *
+ * Uses an in-memory adjacency list for O(1) edge lookups.
+ * Subclasses only override the set of valid relation types for their layer.
+ */
+export class BaseGraphLayer {
+    enabled;
+    /** Outgoing edges: nodeId → edges[] */
+    outgoing = new Map();
+    /** Incoming edges: nodeId → edges[] */
+    incoming = new Map();
+    constructor(enabled = true) {
+        this.enabled = enabled;
+    }
+    getEdges(nodeId, direction = 'both') {
+        const result = [];
+        if (direction === 'outgoing' || direction === 'both') {
+            result.push(...(this.outgoing.get(nodeId) ?? []));
+        }
+        if (direction === 'incoming' || direction === 'both') {
+            result.push(...(this.incoming.get(nodeId) ?? []));
+        }
+        return result;
+    }
+    neighbors(nodeId, depth = 1) {
+        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;
+            const edges = this.getEdges(current.id, 'both');
+            for (const edge of edges) {
+                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);
+        return Array.from(visited);
+    }
+    pathBetween(fromId, toId) {
+        if (fromId === toId)
+            return [fromId];
+        const visited = new Set();
+        const parent = new Map();
+        const queue = [fromId];
+        visited.add(fromId);
+        while (queue.length > 0) {
+            const current = queue.shift();
+            const edges = this.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, current);
+                    if (neighborId === toId) {
+                        // Reconstruct path
+                        const path = [toId];
+                        let node = toId;
+                        while (parent.has(node)) {
+                            node = parent.get(node);
+                            path.unshift(node);
+                        }
+                        return path;
+                    }
+                    queue.push(neighborId);
+                }
+            }
+        }
+        return null;
+    }
+    addEdge(edge) {
+        // Add to outgoing
+        if (!this.outgoing.has(edge.from)) {
+            this.outgoing.set(edge.from, []);
+        }
+        this.outgoing.get(edge.from).push(edge);
+        // Add to incoming
+        if (!this.incoming.has(edge.to)) {
+            this.incoming.set(edge.to, []);
+        }
+        this.incoming.get(edge.to).push(edge);
+    }
+    removeEdge(fromId, toId, relation) {
+        const outEdges = this.outgoing.get(fromId);
+        if (outEdges) {
+            const idx = outEdges.findIndex((e) => e.to === toId && e.relation === relation);
+            if (idx !== -1)
+                outEdges.splice(idx, 1);
+        }
+        const inEdges = this.incoming.get(toId);
+        if (inEdges) {
+            const idx = inEdges.findIndex((e) => e.from === fromId && e.relation === relation);
+            if (idx !== -1)
+                inEdges.splice(idx, 1);
+        }
+    }
+    getAllEdges() {
+        const edges = [];
+        for (const edgeList of this.outgoing.values()) {
+            edges.push(...edgeList);
+        }
+        return edges;
+    }
+    edgeCount() {
+        let count = 0;
+        for (const edgeList of this.outgoing.values()) {
+            count += edgeList.length;
+        }
+        return count;
+    }
+    rebuild(notes) {
+        this.clear();
+        for (const note of notes) {
+            for (const link of note.frontmatter.links) {
+                // Determine if this link belongs to this layer
+                const explicitLayer = link.layer;
+                const inferredLayer = inferLayerFromRelation(link.relation);
+                const belongsToLayer = explicitLayer === this.name || (!explicitLayer && inferredLayer === this.name);
+                if (belongsToLayer) {
+                    this.addEdge({
+                        from: note.frontmatter.id,
+                        to: link.target,
+                        relation: link.relation,
+                        weight: 1.0,
+                        created: note.frontmatter.updated,
+                    });
+                }
+            }
+        }
+    }
+    clear() {
+        this.outgoing.clear();
+        this.incoming.clear();
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/memory/graph-layers/base.js.map

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

package/dist/memory/graph-layers/causal.d.ts

@@ -0,0 +1,14 @@
+import type { LinkRelation } from '../../types/knowledge.js';
+import { BaseGraphLayer } from './base.js';
+/**
+ * Causal graph layer — captures cause-effect chains between facts.
+ *
+ * Relations: caused-by, led-to, broke, enabled, prevented
+ *
+ * Disabled by default.
+ */
+export declare class CausalGraphLayer extends BaseGraphLayer {
+    readonly name: "causal";
+    protected readonly validRelations: readonly LinkRelation[];
+}
+//# sourceMappingURL=causal.d.ts.map

package/dist/memory/graph-layers/causal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"causal.d.ts","sourceRoot":"","sources":["../../../src/memory/graph-layers/causal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,SAAS,YAAY,EAAE,CACvC;CACpB"}

package/dist/memory/graph-layers/causal.js

@@ -0,0 +1,14 @@
+import { CAUSAL_RELATIONS } from '../../types/knowledge-graph.js';
+import { BaseGraphLayer } from './base.js';
+/**
+ * Causal graph layer — captures cause-effect chains between facts.
+ *
+ * Relations: caused-by, led-to, broke, enabled, prevented
+ *
+ * Disabled by default.
+ */
+export class CausalGraphLayer extends BaseGraphLayer {
+    name = 'causal';
+    validRelations = CAUSAL_RELATIONS;
+}
+//# sourceMappingURL=causal.js.map

package/dist/memory/graph-layers/causal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"causal.js","sourceRoot":"","sources":["../../../src/memory/graph-layers/causal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IACzC,IAAI,GAAG,QAAiB,CAAC;IACf,cAAc,GAC/B,gBAAgB,CAAC;CACpB"}

package/dist/memory/graph-layers/entity.d.ts

@@ -0,0 +1,14 @@
+import type { LinkRelation } from '../../types/knowledge.js';
+import { BaseGraphLayer } from './base.js';
+/**
+ * Entity graph layer — captures relationships between tools/libs/components.
+ *
+ * Relations: uses, part-of, interacts-with, contradicts, created-by
+ *
+ * Disabled by default.
+ */
+export declare class EntityGraphLayer extends BaseGraphLayer {
+    readonly name: "entity";
+    protected readonly validRelations: readonly LinkRelation[];
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/memory/graph-layers/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/memory/graph-layers/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,SAAS,YAAY,EAAE,CACvC;CACpB"}

package/dist/memory/graph-layers/entity.js

@@ -0,0 +1,14 @@
+import { ENTITY_RELATIONS } from '../../types/knowledge-graph.js';
+import { BaseGraphLayer } from './base.js';
+/**
+ * Entity graph layer — captures relationships between tools/libs/components.
+ *
+ * Relations: uses, part-of, interacts-with, contradicts, created-by
+ *
+ * Disabled by default.
+ */
+export class EntityGraphLayer extends BaseGraphLayer {
+    name = 'entity';
+    validRelations = ENTITY_RELATIONS;
+}
+//# sourceMappingURL=entity.js.map

package/dist/memory/graph-layers/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/memory/graph-layers/entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IACzC,IAAI,GAAG,QAAiB,CAAC;IACf,cAAc,GAC/B,gBAAgB,CAAC;CACpB"}

package/dist/memory/graph-layers/index.d.ts

@@ -0,0 +1,6 @@
+export { BaseGraphLayer } from './base.js';
+export { SemanticGraphLayer } from './semantic.js';
+export { TemporalGraphLayer } from './temporal.js';
+export { CausalGraphLayer } from './causal.js';
+export { EntityGraphLayer } from './entity.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/graph-layers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/graph-layers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/memory/graph-layers/index.js

@@ -0,0 +1,6 @@
+export { BaseGraphLayer } from './base.js';
+export { SemanticGraphLayer } from './semantic.js';
+export { TemporalGraphLayer } from './temporal.js';
+export { CausalGraphLayer } from './causal.js';
+export { EntityGraphLayer } from './entity.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/graph-layers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/graph-layers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/memory/graph-layers/semantic.d.ts

@@ -0,0 +1,14 @@
+import type { LinkRelation } from '../../types/knowledge.js';
+import { BaseGraphLayer } from './base.js';
+/**
+ * Semantic graph layer — captures conceptual relationships.
+ *
+ * Relations: related-to, depends-on, specializes, generalizes, supports
+ *
+ * Always enabled by default.
+ */
+export declare class SemanticGraphLayer extends BaseGraphLayer {
+    readonly name: "semantic";
+    protected readonly validRelations: readonly LinkRelation[];
+}
+//# sourceMappingURL=semantic.d.ts.map

package/dist/memory/graph-layers/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../src/memory/graph-layers/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,SAAS,YAAY,EAAE,CACrC;CACtB"}

package/dist/memory/graph-layers/semantic.js

@@ -0,0 +1,14 @@
+import { SEMANTIC_RELATIONS } from '../../types/knowledge-graph.js';
+import { BaseGraphLayer } from './base.js';
+/**
+ * Semantic graph layer — captures conceptual relationships.
+ *
+ * Relations: related-to, depends-on, specializes, generalizes, supports
+ *
+ * Always enabled by default.
+ */
+export class SemanticGraphLayer extends BaseGraphLayer {
+    name = 'semantic';
+    validRelations = SEMANTIC_RELATIONS;
+}
+//# sourceMappingURL=semantic.js.map

package/dist/memory/graph-layers/semantic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.js","sourceRoot":"","sources":["../../../src/memory/graph-layers/semantic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IAC3C,IAAI,GAAG,UAAmB,CAAC;IACjB,cAAc,GAC/B,kBAAkB,CAAC;CACtB"}

package/dist/memory/graph-layers/temporal.d.ts

@@ -0,0 +1,14 @@
+import type { LinkRelation } from '../../types/knowledge.js';
+import { BaseGraphLayer } from './base.js';
+/**
+ * Temporal graph layer — captures when knowledge was learned and how it evolved.
+ *
+ * Relations: observed-before, observed-after, co-occurred, supersedes
+ *
+ * Disabled by default.
+ */
+export declare class TemporalGraphLayer extends BaseGraphLayer {
+    readonly name: "temporal";
+    protected readonly validRelations: readonly LinkRelation[];
+}
+//# sourceMappingURL=temporal.d.ts.map

package/dist/memory/graph-layers/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../../src/memory/graph-layers/temporal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,SAAS,YAAY,EAAE,CACrC;CACtB"}

package/dist/memory/graph-layers/temporal.js

@@ -0,0 +1,14 @@
+import { TEMPORAL_RELATIONS } from '../../types/knowledge-graph.js';
+import { BaseGraphLayer } from './base.js';
+/**
+ * Temporal graph layer — captures when knowledge was learned and how it evolved.
+ *
+ * Relations: observed-before, observed-after, co-occurred, supersedes
+ *
+ * Disabled by default.
+ */
+export class TemporalGraphLayer extends BaseGraphLayer {
+    name = 'temporal';
+    validRelations = TEMPORAL_RELATIONS;
+}
+//# sourceMappingURL=temporal.js.map

package/dist/memory/graph-layers/temporal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.js","sourceRoot":"","sources":["../../../src/memory/graph-layers/temporal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IAC3C,IAAI,GAAG,UAAmB,CAAC;IACjB,cAAc,GAC/B,kBAAkB,CAAC;CACtB"}

package/dist/memory/index.d.ts

@@ -2,5 +2,20 @@ export { ExperienceMemory, type PruneResult } from './experience.js';
 export { MemorySystem, createMemorySystem, type MemoryQueryResult, type MemoryQueryResultV2, } from './system.js';
 export { PlaybookLibrary, createPlaybookLibrary, type PlaybookMatch, } from './playbook.js';
 export { MetaMemory, createMetaMemory, } from './meta.js';
+export { TeamExperienceMemory, createTeamExperienceMemory, type TeamExperience, type TeamAnalysisResult, type AgentCredit, type InteractionCredit, type CoordinationAssessment, type RoleLessonEntry, type TeamLessonEntry, type CompositionLessonCategory, type CoordinationLessonCategory, type TeamMetaObservationEntry, } from './team-experience.js';
+export { ReflexionMemory, createReflexionMemory, type ReflexionQueryOptions, } from './reflexion.js';
+export { CoherenceChecker, createCoherenceChecker, type CoherenceResult, type CoherenceCheckerConfig, } from './coherence.js';
+export { ReasoningBank, createReasoningBank, type ExperienceCluster, type ClusterStats, type ReasoningBankConfig, } from './reasoning-bank.js';
+export { CausalStore, createCausalStore, type CausalEdge, } from './causal-store.js';
+export { TemporalCompressor, createTemporalCompressor, type TemporalCompressorConfig, type CompressionResult, } from './temporal-compressor.js';
+export { KnowledgeBank } from './knowledge-bank.js';
+export { KnowledgeGraphManager } from './knowledge-graph.js';
+export { KnowledgeDefragmenter } from './knowledge-defrag.js';
+export type { SearchProvider, SearchProviderResult } from './search-provider.js';
+export { TextSimilaritySearchProvider, MinimemSearchProvider, type MinimemSearchClient, } from './search-providers/index.js';
+export { BaseGraphLayer, SemanticGraphLayer, TemporalGraphLayer, CausalGraphLayer, EntityGraphLayer, } from './graph-layers/index.js';
+export { SqlitePersistence, createSqlitePersistence } from '../persistence/index.js';
+export type { SqlitePersistenceConfig } from '../persistence/index.js';
 export { loadCuratedPlaybooks, type CuratedPlaybookFile, type CuratedLoadResult, } from './curated-loader.js';
+export { compilePlaybookToSkill, exportPlaybooksAsSkills, exportPlaybookAsSkill, type SkillExportFilter, type SkillExportOptions, type SkillExportResult, type ExportedSkill, } from './skill-exporter.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,UAAU,EACV,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,UAAU,EACV,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACrF,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGvE,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/memory/index.js

@@ -4,6 +4,28 @@ export { MemorySystem, createMemorySystem, } from './system.js';
 export { PlaybookLibrary, createPlaybookLibrary, } from './playbook.js';
 // Meta-learning memory
 export { MetaMemory, createMetaMemory, } from './meta.js';
+// Team experience memory
+export { TeamExperienceMemory, createTeamExperienceMemory, } from './team-experience.js';
+// Reflexion episodes
+export { ReflexionMemory, createReflexionMemory, } from './reflexion.js';
+// Coherence checking
+export { CoherenceChecker, createCoherenceChecker, } from './coherence.js';
+// Reasoning bank (clustered experience retrieval)
+export { ReasoningBank, createReasoningBank, } from './reasoning-bank.js';
+// Causal edge store
+export { CausalStore, createCausalStore, } from './causal-store.js';
+// Temporal compression
+export { TemporalCompressor, createTemporalCompressor, } from './temporal-compressor.js';
+// Knowledge bank (semantic memory)
+export { KnowledgeBank } from './knowledge-bank.js';
+export { KnowledgeGraphManager } from './knowledge-graph.js';
+export { KnowledgeDefragmenter } from './knowledge-defrag.js';
+export { TextSimilaritySearchProvider, MinimemSearchProvider, } from './search-providers/index.js';
+export { BaseGraphLayer, SemanticGraphLayer, TemporalGraphLayer, CausalGraphLayer, EntityGraphLayer, } from './graph-layers/index.js';
+// Re-export persistence module
+export { SqlitePersistence, createSqlitePersistence } from '../persistence/index.js';
 // Curated playbook loading
 export { loadCuratedPlaybooks, } from './curated-loader.js';
+// Skill export (compile playbooks → Open Agent Skills format)
+export { compilePlaybookToSkill, exportPlaybooksAsSkills, exportPlaybookAsSkill, } from './skill-exporter.js';
 //# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAoB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAErB,wBAAwB;AACxB,OAAO,EACL,eAAe,EACf,qBAAqB,GAEtB,MAAM,eAAe,CAAC;AAEvB,uBAAuB;AACvB,OAAO,EACL,UAAU,EACV,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,2BAA2B;AAC3B,OAAO,EACL,oBAAoB,GAGrB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAoB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAErB,wBAAwB;AACxB,OAAO,EACL,eAAe,EACf,qBAAqB,GAEtB,MAAM,eAAe,CAAC;AAEvB,uBAAuB;AACvB,OAAO,EACL,UAAU,EACV,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,yBAAyB;AACzB,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAW3B,MAAM,sBAAsB,CAAC;AAE9B,qBAAqB;AACrB,OAAO,EACL,eAAe,EACf,qBAAqB,GAEtB,MAAM,gBAAgB,CAAC;AAExB,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GAGvB,MAAM,gBAAgB,CAAC;AAExB,kDAAkD;AAClD,OAAO,EACL,aAAa,EACb,mBAAmB,GAIpB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAE3B,uBAAuB;AACvB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAGzB,MAAM,0BAA0B,CAAC;AAElC,mCAAmC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,+BAA+B;AAC/B,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGrF,2BAA2B;AAC3B,OAAO,EACL,oBAAoB,GAGrB,MAAM,qBAAqB,CAAC;AAE7B,8DAA8D;AAC9D,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GAKtB,MAAM,qBAAqB,CAAC"}

package/dist/memory/knowledge-bank.d.ts

@@ -0,0 +1,234 @@
+import type { KnowledgeNote, KnowledgeMatch, KnowledgeStats, EntityUpdate, Contradiction, ExtractedKnowledge, InboxResult, DefragResult, DecayResult, GraphLayerName, PlaybookLink } from '../types/knowledge.js';
+import type { Trajectory } from '../types/index.js';
+import type { TrajectorySource } from '../types/trajectory-source.js';
+import type { KnowledgeBankConfig } from '../types/config.js';
+import type { AgenticTaskRunner } from '../workspace/runner.js';
+import type { TrajectoryAnalyzer, AnalysisResult } from '../learning/analyzer.js';
+import { KnowledgeGraphManager } from './knowledge-graph.js';
+import { CoherenceChecker } from './coherence.js';
+import type { SearchProvider } from './search-provider.js';
+/**
+ * KnowledgeBank — Semantic memory store for facts, concepts, and relationships.
+ *
+ * Uses the filesystem as the universal primary index (minimem-compatible).
+ * Maintains a multi-layer graph overlay as a derived index for relationship queries.
+ *
+ * Directory structure:
+ *   {memoryDir}/
+ *     knowledge/
+ *       observations/   — atomic facts (k-*.md)
+ *       entities/       — living entity docs ({entity}.md)
+ *       domains/        — domain summaries ({domain}.md)
+ *     inbox/            — unorganized agent-authored notes
+ *     .knowledge/       — derived index files (graph, manifest)
+ */
+export declare class KnowledgeBank {
+    readonly graph: KnowledgeGraphManager;
+    private memoryDir;
+    private readonly bankConfig;
+    private initialized;
+    private searchProvider;
+    private coherenceChecker;
+    private observationsDir;
+    private entitiesDir;
+    private domainsDir;
+    private inboxDir;
+    private indexDir;
+    constructor(memoryDir: string, config: KnowledgeBankConfig);
+    init(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Create a new knowledge note and write it to disk.
+     * Runs coherence checking against existing notes — contradictions are flagged
+     * via metadata but the note is still stored.
+     * Updates the graph overlay in memory.
+     */
+    addObservation(note: KnowledgeNote): Promise<string>;
+    /**
+     * Get the last coherence result from the most recent addObservation call.
+     * Useful for downstream consumers to react to contradictions.
+     */
+    getCoherenceChecker(): CoherenceChecker;
+    /**
+     * Update an existing entity note by appending a section.
+     */
+    updateEntity(entityId: string, update: EntityUpdate): Promise<void>;
+    /**
+     * Get a note by ID. Scans all directories.
+     */
+    getNote(id: string): Promise<KnowledgeNote | null>;
+    /**
+     * Get an entity note by entity name.
+     */
+    getEntity(entityName: string): Promise<KnowledgeNote | null>;
+    /**
+     * Get a domain summary by domain name.
+     */
+    getDomainSummary(domain: string): Promise<KnowledgeNote | null>;
+    /**
+     * List all known entity names (from entity note filenames).
+     */
+    listEntities(): Promise<string[]>;
+    /**
+     * List all known domain names (from domain summary filenames).
+     */
+    listDomains(): Promise<string[]>;
+    /**
+     * Get all notes across all directories.
+     */
+    getAllNotes(): Promise<KnowledgeNote[]>;
+    /**
+     * Get related notes via multi-layer graph traversal.
+     */
+    getRelated(noteId: string, options?: {
+        depth?: number;
+        layers?: GraphLayerName[];
+        minWeight?: number;
+    }): Promise<KnowledgeMatch[]>;
+    /**
+     * Get cross-system links to playbooks.
+     */
+    getPlaybookLinks(noteId: string): Promise<PlaybookLink[]>;
+    getStats(): Promise<KnowledgeStats>;
+    /**
+     * Search knowledge notes by text similarity.
+     * Scores against note ID + body using Jaccard + n-gram similarity.
+     */
+    search(query: string, options?: {
+        domains?: string[];
+        maxResults?: number;
+    }): Promise<KnowledgeMatch[]>;
+    /**
+     * Get relevant knowledge for a task using 3-tier retrieval:
+     * 1. Domain summary match
+     * 2. Entity name match in task description
+     * 3. Semantic text similarity search
+     */
+    getRelevantKnowledge(task: {
+        description: string;
+        domain?: string;
+    }, options?: {
+        maxNotes?: number;
+        maxTokens?: number;
+        layers?: GraphLayerName[];
+    }): Promise<KnowledgeMatch[]>;
+    /**
+     * Process inbox files: classify, move to correct directory, add to graph.
+     * Files with valid frontmatter are classified by type field.
+     * Files without valid frontmatter get heuristic classification as observations.
+     */
+    processInbox(): Promise<InboxResult>;
+    /**
+     * Run the full 7-step defragmentation cycle via KnowledgeDefragmenter.
+     */
+    defragment(): Promise<DefragResult>;
+    applyExtraction(extraction: ExtractedKnowledge): Promise<void>;
+    /**
+     * Reinforce a knowledge note with new evidence from a trajectory.
+     * Uses EMA to increase confidence: newConf = (1 - alpha) * oldConf + alpha * 1.0
+     */
+    reinforce(noteId: string, trajectoryId: string): Promise<void>;
+    recordContradiction(contradiction: Contradiction): Promise<void>;
+    /**
+     * Apply time-based confidence decay to all knowledge notes.
+     * Skips domain summaries, notes already tagged stale, and notes within the grace period.
+     */
+    applyDecay(): Promise<DecayResult>;
+    /**
+     * Extract knowledge from a trajectory source.
+     * Iterates all trajectories, runs extraction (agent or heuristic), and applies results.
+     */
+    extractFrom(source: TrajectorySource, options?: {
+        taskRunner?: AgenticTaskRunner;
+        analyzer?: TrajectoryAnalyzer;
+    }): Promise<ExtractedKnowledge[]>;
+    /**
+     * Extract knowledge from a single trajectory.
+     * Uses the workspace template if a taskRunner is provided, otherwise falls back to heuristic.
+     * Applies the extraction to the knowledge bank.
+     */
+    extractFromTrajectory(trajectory: Trajectory, analysis?: AnalysisResult, taskRunner?: AgenticTaskRunner): Promise<ExtractedKnowledge>;
+    /**
+     * Format knowledge notes as a markdown section for agent prompt injection.
+     * Groups by type: domain summaries → entities → observations.
+     */
+    formatKnowledgeForPrompt(notes: KnowledgeMatch[], options?: {
+        maxTokens?: number;
+        includeEvidence?: boolean;
+        includeLinks?: boolean;
+    }): string;
+    /**
+     * Get the name of the active search provider.
+     */
+    getSearchProviderName(): string;
+    /**
+     * Replace the active search provider (strategy pattern).
+     */
+    setSearchProvider(provider: SearchProvider): void;
+    /**
+     * Detect whether minimem is available and set up the MinimemSearchProvider.
+     *
+     * Detection checks (in order):
+     * 1. Look for a `.minimem/` directory under memoryDir
+     * 2. Look for a `MEMORY.md` file under memoryDir
+     * 3. Create a Minimem instance and wire MinimemSearchProvider
+     *
+     * Falls back to TextSimilaritySearchProvider on any failure.
+     */
+    private detectMinimem;
+    /**
+     * Get the index directory path (for defragmenter).
+     */
+    getIndexDir(): string;
+    /**
+     * Check if defragmentation should be triggered.
+     */
+    shouldDefragment(): Promise<boolean>;
+    /**
+     * Resolve a note's file path and write it to disk.
+     */
+    private writeNote;
+    /**
+     * Scan a directory for .md files and parse them as KnowledgeNotes.
+     * Skips files with invalid/missing frontmatter.
+     */
+    private scanDirectory;
+    /**
+     * Count .md files in a directory.
+     */
+    private countFiles;
+    /**
+     * Resolve the relative path for a note based on its type and filename.
+     * When minimemAware, paths are nested under memory/knowledge/ instead of knowledge/.
+     */
+    private resolveNotePath;
+    /**
+     * Move an inbox note to the correct directory based on its type.
+     * Updates the note's filePath accordingly.
+     */
+    private moveInboxNote;
+    /**
+     * Create a KnowledgeNote from a raw inbox file with no valid frontmatter.
+     * Applies heuristic: observation type, agent-authored origin, agentAuthoredInitial confidence.
+     */
+    private processRawInboxFile;
+    /**
+     * Convert a KnowledgeNote to a GraphNode.
+     */
+    /**
+     * Enforce a token budget on a list of matches.
+     * Always includes at least one match.
+     */
+    private enforceTokenBudget;
+    /**
+     * Format a single knowledge note for prompt injection.
+     */
+    private formatSingleNote;
+    /**
+     * Get notes related to the given note by entity or domain overlap.
+     * Used for coherence checking before insertion.
+     */
+    private getRelatedNotes;
+    private noteToGraphNode;
+}
+//# sourceMappingURL=knowledge-bank.d.ts.map

package/dist/memory/knowledge-bank.d.ts.map

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