@openweave/weave-graph 0.2.0

package/dist/edge.js

@@ -0,0 +1,79 @@
+import { EdgeType } from "./types";
+import { randomUUID } from "crypto";
+/**
+ * EdgeBuilder utility for creating and managing graph edges
+ */
+export class EdgeBuilder {
+    /**
+     * Create a new edge between two nodes
+     */
+    static create(sourceId, targetId, type, weight, metadata) {
+        return {
+            id: randomUUID(),
+            sourceId,
+            targetId,
+            type,
+            weight: weight ?? 1.0,
+            metadata: metadata ?? {},
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+    }
+    /**
+     * Create a RELATES edge
+     */
+    static relates(sourceId, targetId, weight) {
+        return this.create(sourceId, targetId, EdgeType.RELATES, weight);
+    }
+    /**
+     * Create a CAUSES edge
+     */
+    static causes(sourceId, targetId, weight) {
+        return this.create(sourceId, targetId, EdgeType.CAUSES, weight);
+    }
+    /**
+     * Create a CORRECTS edge (links CORRECTION to ERROR)
+     */
+    static corrects(correctionId, errorId, weight) {
+        return this.create(correctionId, errorId, EdgeType.CORRECTS, weight);
+    }
+    /**
+     * Create an IMPLEMENTS edge (code → decision)
+     */
+    static implements(codeEntityId, decisionId, weight) {
+        return this.create(codeEntityId, decisionId, EdgeType.IMPLEMENTS, weight);
+    }
+    /**
+     * Create a DEPENDS_ON edge
+     */
+    static dependsOn(sourceId, targetId, weight) {
+        return this.create(sourceId, targetId, EdgeType.DEPENDS_ON, weight);
+    }
+    /**
+     * Create a BLOCKS edge
+     */
+    static blocks(blockerId, blockedId, weight) {
+        return this.create(blockerId, blockedId, EdgeType.BLOCKS, weight);
+    }
+    /**
+     * Clone an edge with updated values
+     */
+    static clone(edge, updates) {
+        return {
+            ...edge,
+            updatedAt: new Date(),
+            ...updates,
+        };
+    }
+    /**
+     * Increase the weight (confidence) of an edge
+     */
+    static reinforceWeight(edge, factor = 1.1) {
+        return {
+            ...edge,
+            weight: (edge.weight ?? 1.0) * factor,
+            updatedAt: new Date(),
+        };
+    }
+}
+//# sourceMappingURL=edge.js.map

package/dist/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../src/edge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,QAAQ,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,QAAgB,EAChB,QAAgB,EAChB,IAAc,EACd,MAAe,EACf,QAAkC;QAElC,OAAO;YACL,EAAE,EAAE,UAAU,EAAE;YAChB,QAAQ;YACR,QAAQ;YACR,IAAI;YACJ,MAAM,EAAE,MAAM,IAAI,GAAG;YACrB,QAAQ,EAAE,QAAQ,IAAI,EAAE;YACxB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CACZ,QAAgB,EAChB,QAAgB,EAChB,MAAe;QAEf,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,QAAgB,EAChB,QAAgB,EAChB,MAAe;QAEf,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,YAAoB,EACpB,OAAe,EACf,MAAe;QAEf,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,YAAoB,EACpB,UAAkB,EAClB,MAAe;QAEf,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,QAAgB,EAChB,QAAgB,EAChB,MAAe;QAEf,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,SAAiB,EACjB,SAAiB,EACjB,MAAe;QAEf,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CACV,IAAU,EACV,OAAuB;QAEvB,OAAO;YACL,GAAG,IAAI;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,IAAU,EAAE,SAAiB,GAAG;QACrD,OAAO;YACL,GAAG,IAAI;YACP,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM;YACrC,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,159 @@
+import { Node, Edge, NodeType, EdgeType, GraphSnapshot } from "./types";
+/**
+ * ContextGraphManager
+ * Main interface for managing the WeaveGraph
+ * Handles node/edge operations, queries, and persistence metadata
+ */
+export declare class ContextGraphManager {
+    private nodes;
+    private edges;
+    private edgesBySource;
+    private edgesByTarget;
+    private nodesByLabel;
+    private chatId;
+    private compressionThreshold;
+    private version;
+    private createdAt;
+    private updatedAt;
+    constructor(chatId: string, compressionThreshold?: number);
+    /**
+     * Add a node to the graph
+     */
+    addNode(node: Node): Node;
+    /**
+     * Get a node by ID
+     */
+    getNode(nodeId: string): Node | undefined;
+    /**
+     * Update an existing node
+     */
+    updateNode(nodeId: string, updates: Partial<Node>): Node | undefined;
+    /**
+     * Delete a node (and all related edges)
+     */
+    deleteNode(nodeId: string): boolean;
+    /**
+     * Add an edge to the graph
+     */
+    addEdge(edge: Edge): Edge;
+    /**
+     * Get an edge by ID
+     */
+    getEdge(edgeId: string): Edge | undefined;
+    /**
+     * Update an existing edge
+     */
+    updateEdge(edgeId: string, updates: Partial<Edge>): Edge | undefined;
+    /**
+     * Delete an edge
+     */
+    deleteEdge(edgeId: string): boolean;
+    /**
+     * Get all edges from a source node
+     */
+    getEdgesFromNode(nodeId: string): Edge[];
+    /**
+     * Get all edges to a target node
+     */
+    getEdgesToNode(nodeId: string): Edge[];
+    /**
+     * Query nodes by label (keyword search)
+     * Returns nodes where the label contains the query string
+     */
+    queryNodesByLabel(query: string): Node[];
+    /**
+     * Query nodes by type
+     */
+    queryNodesByType(type: NodeType): Node[];
+    /**
+     * Query edges by type
+     */
+    queryEdgesByType(type: EdgeType): Edge[];
+    /**
+     * Get graph statistics
+     */
+    getStats(): {
+        totalNodes: number;
+        totalEdges: number;
+        nodesByType: {
+            [k: string]: number;
+        };
+        edgesByType: {
+            [k: string]: number;
+        };
+        chatId: string;
+        createdAt: Date;
+        updatedAt: Date;
+    };
+    /**
+     * Snapshot the graph for serialization
+     */
+    snapshot(): GraphSnapshot;
+    /**
+     * Restore graph from snapshot
+     */
+    static fromSnapshot(snapshot: GraphSnapshot): ContextGraphManager;
+    /**
+     * Get the current window size percentage
+     * Calculates actual context window usage based on node and edge sizes
+     */
+    getContextWindowUsage(): number;
+    /**
+     * Get estimated context size in bytes
+     */
+    getContextSize(): number;
+    /**
+     * Check if compression threshold has been reached
+     */
+    shouldCompress(): boolean;
+    /**
+     * Compress the graph by archiving low-frequency nodes
+     * Returns compression statistics
+     */
+    compress(targetReductionPercentage?: number): {
+        archivedNodeCount: number;
+        archiveStats: {
+            archivedNodeCount: number;
+            archivedEdgeCount: number;
+        };
+        newContextSize: number;
+        contextUsagePercentage: number;
+    };
+    /**
+     * Suppress an error node and create a correction
+     */
+    suppressError(errorNodeId: string, correctionLabel: string, correctionDescription?: string): {
+        correctionNode: Node;
+        correctionEdge: Edge;
+    };
+    /**
+     * Get all error nodes that have been corrected
+     */
+    getCorrectedErrors(): Map<string, {
+        error: Node;
+        corrections: Node[];
+    }>;
+    /**
+     * Get all error nodes that haven't been corrected yet
+     */
+    getUncorrectedErrors(): Node[];
+    /**
+     * Get all nodes
+     */
+    getAllNodes(): Node[];
+    /**
+     * Get all edges
+     */
+    getAllEdges(): Edge[];
+    /**
+     * Clear the entire graph
+     */
+    clear(): void;
+}
+export type { Node, Edge, NodeType, EdgeType, GraphSnapshot, QueryResult } from "./types";
+export { PersistenceManager } from "./persistence";
+export { NodeBuilder } from "./node";
+export { EdgeBuilder } from "./edge";
+export { CompressionManager, ErrorSuppression } from "./compression";
+export type { CompressionStats } from "./compression";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKxE;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,oBAAoB,CAAgB;IAC5C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,SAAS,CAAO;gBAEZ,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,MAAM;IAczD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAczB;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIzC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS;IAUpE;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IA8BnC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAkBzB;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIzC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS;IAUpE;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAYnC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE;IAOxC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE;IAOtC;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE;IAgBxC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE;IAIxC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE;IAIxC;;OAEG;IACH,QAAQ;;;;;;;;;;;;;IAuBR;;OAEG;IACH,QAAQ,IAAI,aAAa;IAczB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,mBAAmB;IAoBjE;;;OAGG;IACH,qBAAqB,IAAI,MAAM;IAQ/B;;OAEG;IACH,cAAc,IAAI,MAAM;IAOxB;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;;OAGG;IACH,QAAQ,CAAC,yBAAyB,GAAE,MAAY;;;;;;;;;IAuBhD;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,qBAAqB,CAAC,EAAE,MAAM;;;;IAuB1F;;OAEG;IACH,kBAAkB;;;;IAIlB;;OAEG;IACH,oBAAoB,IAAI,IAAI,EAAE;IAI9B;;OAEG;IACH,WAAW,IAAI,IAAI,EAAE;IAIrB;;OAEG;IACH,WAAW,IAAI,IAAI,EAAE;IAIrB;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd;AAGD,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,339 @@
+import { NodeType } from "./types";
+import { NodeBuilder } from "./node";
+import { EdgeBuilder } from "./edge";
+import { CompressionManager, ErrorSuppression } from "./compression";
+/**
+ * ContextGraphManager
+ * Main interface for managing the WeaveGraph
+ * Handles node/edge operations, queries, and persistence metadata
+ */
+export class ContextGraphManager {
+    nodes;
+    edges;
+    edgesBySource; // sourceId -> Set<edgeId>
+    edgesByTarget; // targetId -> Set<edgeId>
+    nodesByLabel; // label (lowercased) -> Set<nodeId>
+    chatId;
+    compressionThreshold = 0.75;
+    version = "0.1.0";
+    createdAt;
+    updatedAt;
+    constructor(chatId, compressionThreshold) {
+        this.chatId = chatId;
+        this.nodes = new Map();
+        this.edges = new Map();
+        this.edgesBySource = new Map();
+        this.edgesByTarget = new Map();
+        this.nodesByLabel = new Map();
+        this.createdAt = new Date();
+        this.updatedAt = new Date();
+        if (compressionThreshold !== undefined) {
+            this.compressionThreshold = compressionThreshold;
+        }
+    }
+    /**
+     * Add a node to the graph
+     */
+    addNode(node) {
+        this.nodes.set(node.id, node);
+        // Index by label for keyword search
+        const labelKey = node.label.toLowerCase();
+        if (!this.nodesByLabel.has(labelKey)) {
+            this.nodesByLabel.set(labelKey, new Set());
+        }
+        this.nodesByLabel.get(labelKey).add(node.id);
+        this.updatedAt = new Date();
+        return node;
+    }
+    /**
+     * Get a node by ID
+     */
+    getNode(nodeId) {
+        return this.nodes.get(nodeId);
+    }
+    /**
+     * Update an existing node
+     */
+    updateNode(nodeId, updates) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return undefined;
+        const updated = NodeBuilder.clone(node, updates);
+        this.nodes.set(nodeId, updated);
+        this.updatedAt = new Date();
+        return updated;
+    }
+    /**
+     * Delete a node (and all related edges)
+     */
+    deleteNode(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return false;
+        // Remove label index
+        const labelKey = node.label.toLowerCase();
+        const labelSet = this.nodesByLabel.get(labelKey);
+        if (labelSet) {
+            labelSet.delete(nodeId);
+            if (labelSet.size === 0) {
+                this.nodesByLabel.delete(labelKey);
+            }
+        }
+        // Remove all connected edges
+        const sourceEdges = this.edgesBySource.get(nodeId) || new Set();
+        const targetEdges = this.edgesByTarget.get(nodeId) || new Set();
+        [...sourceEdges, ...targetEdges].forEach((edgeId) => {
+            this.edges.delete(edgeId);
+        });
+        this.edgesBySource.delete(nodeId);
+        this.edgesByTarget.delete(nodeId);
+        this.nodes.delete(nodeId);
+        this.updatedAt = new Date();
+        return true;
+    }
+    /**
+     * Add an edge to the graph
+     */
+    addEdge(edge) {
+        this.edges.set(edge.id, edge);
+        // Index by source and target
+        if (!this.edgesBySource.has(edge.sourceId)) {
+            this.edgesBySource.set(edge.sourceId, new Set());
+        }
+        this.edgesBySource.get(edge.sourceId).add(edge.id);
+        if (!this.edgesByTarget.has(edge.targetId)) {
+            this.edgesByTarget.set(edge.targetId, new Set());
+        }
+        this.edgesByTarget.get(edge.targetId).add(edge.id);
+        this.updatedAt = new Date();
+        return edge;
+    }
+    /**
+     * Get an edge by ID
+     */
+    getEdge(edgeId) {
+        return this.edges.get(edgeId);
+    }
+    /**
+     * Update an existing edge
+     */
+    updateEdge(edgeId, updates) {
+        const edge = this.edges.get(edgeId);
+        if (!edge)
+            return undefined;
+        const updated = EdgeBuilder.clone(edge, updates);
+        this.edges.set(edgeId, updated);
+        this.updatedAt = new Date();
+        return updated;
+    }
+    /**
+     * Delete an edge
+     */
+    deleteEdge(edgeId) {
+        const edge = this.edges.get(edgeId);
+        if (!edge)
+            return false;
+        this.edgesBySource.get(edge.sourceId)?.delete(edgeId);
+        this.edgesByTarget.get(edge.targetId)?.delete(edgeId);
+        this.edges.delete(edgeId);
+        this.updatedAt = new Date();
+        return true;
+    }
+    /**
+     * Get all edges from a source node
+     */
+    getEdgesFromNode(nodeId) {
+        const edgeIds = this.edgesBySource.get(nodeId) || new Set();
+        return Array.from(edgeIds)
+            .map((id) => this.edges.get(id))
+            .filter((edge) => edge !== undefined);
+    }
+    /**
+     * Get all edges to a target node
+     */
+    getEdgesToNode(nodeId) {
+        const edgeIds = this.edgesByTarget.get(nodeId) || new Set();
+        return Array.from(edgeIds)
+            .map((id) => this.edges.get(id))
+            .filter((edge) => edge !== undefined);
+    }
+    /**
+     * Query nodes by label (keyword search)
+     * Returns nodes where the label contains the query string
+     */
+    queryNodesByLabel(query) {
+        const lowerQuery = query.toLowerCase();
+        const results = [];
+        for (const [label, nodeIds] of this.nodesByLabel.entries()) {
+            if (label.includes(lowerQuery)) {
+                nodeIds.forEach((nodeId) => {
+                    const node = this.nodes.get(nodeId);
+                    if (node)
+                        results.push(node);
+                });
+            }
+        }
+        return results.sort((a, b) => (b.frequency ?? 0) - (a.frequency ?? 0));
+    }
+    /**
+     * Query nodes by type
+     */
+    queryNodesByType(type) {
+        return Array.from(this.nodes.values()).filter((node) => node.type === type);
+    }
+    /**
+     * Query edges by type
+     */
+    queryEdgesByType(type) {
+        return Array.from(this.edges.values()).filter((edge) => edge.type === type);
+    }
+    /**
+     * Get graph statistics
+     */
+    getStats() {
+        const nodesByType = new Map();
+        const edgesByType = new Map();
+        for (const node of this.nodes.values()) {
+            nodesByType.set(node.type, (nodesByType.get(node.type) ?? 0) + 1);
+        }
+        for (const edge of this.edges.values()) {
+            edgesByType.set(edge.type, (edgesByType.get(edge.type) ?? 0) + 1);
+        }
+        return {
+            totalNodes: this.nodes.size,
+            totalEdges: this.edges.size,
+            nodesByType: Object.fromEntries(nodesByType),
+            edgesByType: Object.fromEntries(edgesByType),
+            chatId: this.chatId,
+            createdAt: this.createdAt,
+            updatedAt: this.updatedAt,
+        };
+    }
+    /**
+     * Snapshot the graph for serialization
+     */
+    snapshot() {
+        return {
+            nodes: Object.fromEntries(this.nodes),
+            edges: Object.fromEntries(this.edges),
+            metadata: {
+                chatId: this.chatId,
+                version: this.version,
+                createdAt: this.createdAt,
+                updatedAt: this.updatedAt,
+                compressionThreshold: this.compressionThreshold,
+            },
+        };
+    }
+    /**
+     * Restore graph from snapshot
+     */
+    static fromSnapshot(snapshot) {
+        const manager = new ContextGraphManager(snapshot.metadata.chatId, snapshot.metadata.compressionThreshold);
+        Object.values(snapshot.nodes).forEach((node) => {
+            manager.addNode(node);
+        });
+        Object.values(snapshot.edges).forEach((edge) => {
+            manager.addEdge(edge);
+        });
+        manager.createdAt = snapshot.metadata.createdAt;
+        manager.updatedAt = snapshot.metadata.updatedAt;
+        return manager;
+    }
+    /**
+     * Get the current window size percentage
+     * Calculates actual context window usage based on node and edge sizes
+     */
+    getContextWindowUsage() {
+        const contextSize = CompressionManager.calculateContextSize(this.getAllNodes(), this.getAllEdges());
+        return CompressionManager.calculateContextUsagePercentage(contextSize);
+    }
+    /**
+     * Get estimated context size in bytes
+     */
+    getContextSize() {
+        return CompressionManager.calculateContextSize(this.getAllNodes(), this.getAllEdges());
+    }
+    /**
+     * Check if compression threshold has been reached
+     */
+    shouldCompress() {
+        return this.getContextWindowUsage() >= this.compressionThreshold;
+    }
+    /**
+     * Compress the graph by archiving low-frequency nodes
+     * Returns compression statistics
+     */
+    compress(targetReductionPercentage = 0.3) {
+        const archiveCandidates = CompressionManager.identifyArchiveCandidates(this.getAllNodes(), this.getAllEdges(), targetReductionPercentage);
+        const compressionMgr = new CompressionManager();
+        compressionMgr.archiveNodes(archiveCandidates, this.nodes, this.edges);
+        // Remove archived nodes from active graph
+        for (const nodeId of archiveCandidates) {
+            this.deleteNode(nodeId);
+        }
+        return {
+            archivedNodeCount: archiveCandidates.length,
+            archiveStats: compressionMgr.getArchiveStats(),
+            newContextSize: this.getContextSize(),
+            contextUsagePercentage: this.getContextWindowUsage(),
+        };
+    }
+    /**
+     * Suppress an error node and create a correction
+     */
+    suppressError(errorNodeId, correctionLabel, correctionDescription) {
+        const errorNode = this.getNode(errorNodeId);
+        if (!errorNode || errorNode.type !== NodeType.ERROR) {
+            throw new Error("Node must be an ERROR type to suppress it");
+        }
+        // Mark error as suppressed
+        const suppressedError = ErrorSuppression.suppressNode(errorNode);
+        this.updateNode(errorNodeId, suppressedError);
+        // Create correction node and link it
+        const { correctionNode, correctionEdge } = ErrorSuppression.createCorrection(errorNodeId, correctionLabel, correctionDescription);
+        this.addNode(correctionNode);
+        this.addEdge(correctionEdge);
+        return { correctionNode, correctionEdge };
+    }
+    /**
+     * Get all error nodes that have been corrected
+     */
+    getCorrectedErrors() {
+        return ErrorSuppression.findCorrectedErrors(this.nodes, this.edges);
+    }
+    /**
+     * Get all error nodes that haven't been corrected yet
+     */
+    getUncorrectedErrors() {
+        return ErrorSuppression.findUncorrectedErrors(this.nodes, this.edges);
+    }
+    /**
+     * Get all nodes
+     */
+    getAllNodes() {
+        return Array.from(this.nodes.values());
+    }
+    /**
+     * Get all edges
+     */
+    getAllEdges() {
+        return Array.from(this.edges.values());
+    }
+    /**
+     * Clear the entire graph
+     */
+    clear() {
+        this.nodes.clear();
+        this.edges.clear();
+        this.edgesBySource.clear();
+        this.edgesByTarget.clear();
+        this.nodesByLabel.clear();
+        this.updatedAt = new Date();
+    }
+}
+export { PersistenceManager } from "./persistence";
+export { NodeBuilder } from "./node";
+export { EdgeBuilder } from "./edge";
+export { CompressionManager, ErrorSuppression } from "./compression";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/node.d.ts

@@ -0,0 +1,43 @@
+import { Node, NodeType } from "./types";
+/**
+ * NodeBuilder utility for creating and managing graph nodes
+ */
+export declare class NodeBuilder {
+    /**
+     * Create a new node with the given type and label
+     */
+    static create(type: NodeType, label: string, description?: string, metadata?: Record<string, unknown>): Node;
+    /**
+     * Create a CONCEPT node
+     */
+    static concept(label: string, description?: string): Node;
+    /**
+     * Create a DECISION node
+     */
+    static decision(label: string, description?: string): Node;
+    /**
+     * Create a MILESTONE node
+     */
+    static milestone(label: string, description?: string): Node;
+    /**
+     * Create an ERROR node
+     */
+    static error(label: string, description?: string): Node;
+    /**
+     * Create a CORRECTION node
+     */
+    static correction(label: string, description?: string): Node;
+    /**
+     * Create a CODE_ENTITY node
+     */
+    static codeEntity(label: string, description?: string): Node;
+    /**
+     * Clone a node with updated values
+     */
+    static clone(node: Node, updates?: Partial<Node>): Node;
+    /**
+     * Increment frequency counter for a node
+     */
+    static incrementFrequency(node: Node): Node;
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGzC;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAaP;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAIzD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3D;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5D;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5D;;OAEG;IACH,MAAM,CAAC,KAAK,CACV,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACtB,IAAI;IAQP;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAO5C"}