0agent 1.0.0

package/packages/core/dist/graph/SubGraph.js

@@ -0,0 +1,86 @@
+export class SubGraph {
+    id;
+    rootEntityId;
+    nodes;
+    edges;
+    constructor(id, rootEntityId) {
+        this.id = id;
+        this.rootEntityId = rootEntityId;
+        this.nodes = new Map();
+        this.edges = new Map();
+    }
+    addNode(node) {
+        this.nodes.set(node.id, node);
+    }
+    addEdge(edge) {
+        this.edges.set(edge.id, edge);
+    }
+    getNode(id) {
+        return this.nodes.get(id);
+    }
+    getEdge(id) {
+        return this.edges.get(id);
+    }
+    /** Remove a node and all edges connected to it. */
+    removeNode(id) {
+        this.nodes.delete(id);
+        for (const [edgeId, edge] of this.edges) {
+            if (edge.from_node === id || edge.to_node === id) {
+                this.edges.delete(edgeId);
+            }
+        }
+    }
+    removeEdge(id) {
+        this.edges.delete(id);
+    }
+    getNodes() {
+        return Array.from(this.nodes.values());
+    }
+    getEdges() {
+        return Array.from(this.edges.values());
+    }
+    getEdgesFrom(nodeId) {
+        const result = [];
+        for (const edge of this.edges.values()) {
+            if (edge.from_node === nodeId) {
+                result.push(edge);
+            }
+        }
+        return result;
+    }
+    getEdgesTo(nodeId) {
+        const result = [];
+        for (const edge of this.edges.values()) {
+            if (edge.to_node === nodeId) {
+                result.push(edge);
+            }
+        }
+        return result;
+    }
+    get nodeCount() {
+        return this.nodes.size;
+    }
+    get edgeCount() {
+        return this.edges.size;
+    }
+    /** Serialize to a plain object for snapshot injection into subagents. */
+    toSnapshot() {
+        return {
+            id: this.id,
+            rootEntityId: this.rootEntityId,
+            nodes: this.getNodes(),
+            edges: this.getEdges(),
+        };
+    }
+    static fromSnapshot(snapshot) {
+        const sg = new SubGraph(snapshot.id, snapshot.rootEntityId);
+        for (const node of snapshot.nodes) {
+            sg.addNode(node);
+        }
+        for (const edge of snapshot.edges) {
+            sg.addEdge(edge);
+        }
+        return sg;
+    }
+}
+//# sourceMappingURL=SubGraph.js.map

package/packages/core/dist/graph/SubGraph.js.map

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

package/packages/core/dist/index.d.ts

@@ -0,0 +1,54 @@
+export { NodeType, ContentType, type NodeContent, type GraphNode, createNode, } from './graph/GraphNode.js';
+export { EdgeType, type GraphEdge, createEdge, } from './graph/GraphEdge.js';
+export { SubGraph } from './graph/SubGraph.js';
+export { GraphQuery, type QueryResult, type StructuralQueryOpts, type SemanticQueryOpts, type MergedQueryOpts, } from './graph/GraphQuery.js';
+export { KnowledgeGraph } from './graph/KnowledgeGraph.js';
+export { SQLiteAdapter, type SQLiteAdapterOptions, type WeightEvent, type TraceRecord, type AliasRecord, } from './storage/adapters/SQLiteAdapter.js';
+export { TraceStore } from './storage/TraceStore.js';
+export { WeightEventLog } from './storage/WeightEventLog.js';
+export { ObjectStore } from './storage/ObjectStore.js';
+export { WeightPropagation, type StepLedger, type OutcomeSignal, type PropagationResult, type PropagationConfig, } from './engine/WeightPropagation.js';
+export { DecayScheduler, type DecayConfig, type DecayReport, } from './engine/DecayScheduler.js';
+export { SelectionPolicy, type SelectionConfig, type SelectionResult, } from './engine/SelectionPolicy.js';
+export { InferenceEngine, type IInferenceEngine, type InferencePlan, type InferenceRequest, type InferenceResult, type ResolvedEntity, type SelectedEdge, } from './engine/InferenceEngine.js';
+export { CreditAttribution, type DAGNode, type AttributionConfig, } from './engine/CreditAttribution.js';
+export { WorkflowSuggestionEngine } from './engine/WorkflowSuggestionEngine.js';
+export { type OutcomeTrace, type AttributionResult, } from './trace/OutcomeTrace.js';
+export { TraversalLedger, type TraversalEntry, } from './trace/TraversalLedger.js';
+export { DeferredTraceStore, type DeferredTraceEntry, type RetroOutput, type RetroStep, } from './trace/DeferredTrace.js';
+export { TraceReplay, type ReplayResult } from './trace/TraceReplay.js';
+export { SkillTraceDecorator } from './trace/SkillTraceDecorator.js';
+export { EntityResolutionPipeline, type IEntityExtractor, type ExtractionResult, type PipelineResult, } from './entity/EntityResolutionPipeline.js';
+export { ContextActivator, type ActivationConfig, type ActivationScore, } from './entity/ContextActivator.js';
+export { MCPEnrichedResolver } from './entity/MCPEnrichedResolver.js';
+export { WorkingMemory, type WorkingMemoryConfig } from './memory/WorkingMemory.js';
+export { BlinkingMemory, type SessionSummary } from './memory/BlinkingMemory.js';
+export { ArchivalMemory, type ArchivalEntry } from './memory/ArchivalMemory.js';
+export { EdgeWeightUpdater } from './concurrency/EdgeWeightUpdater.js';
+export { type EmbeddingAdapter } from './embedding/adapters/OllamaAdapter.js';
+export { OllamaAdapter } from './embedding/adapters/OllamaAdapter.js';
+export { NomicAdapter } from './embedding/adapters/NomicAdapter.js';
+export { OpenAIAdapter } from './embedding/adapters/OpenAIAdapter.js';
+export { HNSWIndex, type HNSWSearchResult, type HNSWConfig } from './embedding/HNSWIndex.js';
+export { MultimodalEmbedder } from './embedding/MultimodalEmbedder.js';
+export { AliasIndex } from './entity/AliasIndex.js';
+export { PersonalityProfileStore, type PersonalityProfile, PERSONALITY_NODE_LABEL, } from './entity/PersonalityProfile.js';
+export { EntityHierarchy, type EntityContext, type VisibilityPolicy, DEFAULT_VISIBILITY_POLICY, } from './entity/EntityHierarchy.js';
+export { PersonalityAccumulator, type InteractionSignal, } from './entity/PersonalityAccumulator.js';
+export { NodeResolutionService, type ResolutionResult, type ResolutionConfig, } from './entity/NodeResolutionService.js';
+export { StagedMutationStore, type StagedMutation, } from './bootstrap/StagedMutations.js';
+export { HypothesisManager, type HypothesisRecord, } from './bootstrap/HypothesisManager.js';
+export { GraphConstructor, type ILLMClient, type BootstrapProposal, } from './bootstrap/GraphConstructor.js';
+export { BootstrapProtocol } from './bootstrap/BootstrapProtocol.js';
+export { type SkillDefinition, type SkillCategory, type SkillArg, type SkillSubagentProfile, type SkillGraphScope, type SkillSandboxConfig, type SkillWorkflow, type SkillOutput, type SkillOutcome, type SkillVerifier, } from './types/SkillDefinition.js';
+export { type ImprovementPlan, type SelfImprovementConfig, type AutoApplyPolicy, type SkillGap, type WorkflowChange, type GraphHealth, type ToolUtilization, type SkillRefinement, type PriorityAction, type ImprovementRecord, DEFAULT_SELF_IMPROVEMENT_CONFIG, } from './types/SelfImprovement.js';
+export { SelfImprovementEngine } from './engine/SelfImprovementEngine.js';
+export { SELF_IMPROVEMENT_PROMPT } from './engine/SelfImprovementPrompt.js';
+export { EdgePruner, type PruneConfig, type PruneResult, } from './maintenance/EdgePruner.js';
+export { NodeDeduplicator, type DeduplicationConfig, type MergeCandidate, type DeduplicationResult, } from './maintenance/NodeDeduplicator.js';
+export { SubgraphArchiver, type ArchivalConfig, type ArchivalResult, } from './maintenance/SubgraphArchiver.js';
+export { CompactionOrchestrator, type CompactionSchedule, } from './maintenance/CompactionOrchestrator.js';
+export { GraphCheckpointManager, type Checkpoint, type CheckpointSnapshot, } from './maintenance/GraphCheckpoint.js';
+export { GraphRollback, type RollbackMode, type RollbackResult, } from './maintenance/GraphRollback.js';
+export { SessionSnapshotManager, type SnapshotEntry, type SessionSnapshotData, type MergeResult, } from './concurrency/SessionSnapshot.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/index.d.ts.map

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

package/packages/core/dist/index.js

@@ -0,0 +1,62 @@
+// ─── Graph Types ────────────────────────────────────
+export { NodeType, ContentType, createNode, } from './graph/GraphNode.js';
+export { EdgeType, createEdge, } from './graph/GraphEdge.js';
+export { SubGraph } from './graph/SubGraph.js';
+export { GraphQuery, } from './graph/GraphQuery.js';
+export { KnowledgeGraph } from './graph/KnowledgeGraph.js';
+// ─── Storage ────────────────────────────────────────
+export { SQLiteAdapter, } from './storage/adapters/SQLiteAdapter.js';
+export { TraceStore } from './storage/TraceStore.js';
+export { WeightEventLog } from './storage/WeightEventLog.js';
+export { ObjectStore } from './storage/ObjectStore.js';
+// ─── Engine ─────────────────────────────────────────
+export { WeightPropagation, } from './engine/WeightPropagation.js';
+export { DecayScheduler, } from './engine/DecayScheduler.js';
+export { SelectionPolicy, } from './engine/SelectionPolicy.js';
+export { InferenceEngine, } from './engine/InferenceEngine.js';
+export { CreditAttribution, } from './engine/CreditAttribution.js';
+export { WorkflowSuggestionEngine } from './engine/WorkflowSuggestionEngine.js';
+export { TraversalLedger, } from './trace/TraversalLedger.js';
+export { DeferredTraceStore, } from './trace/DeferredTrace.js';
+export { TraceReplay } from './trace/TraceReplay.js';
+export { SkillTraceDecorator } from './trace/SkillTraceDecorator.js';
+// ─── Entity Resolution (Phase 4) ───────────────────
+export { EntityResolutionPipeline, } from './entity/EntityResolutionPipeline.js';
+export { ContextActivator, } from './entity/ContextActivator.js';
+export { MCPEnrichedResolver } from './entity/MCPEnrichedResolver.js';
+// ─── Memory ─────────────────────────────────────────
+export { WorkingMemory } from './memory/WorkingMemory.js';
+export { BlinkingMemory } from './memory/BlinkingMemory.js';
+export { ArchivalMemory } from './memory/ArchivalMemory.js';
+// ─── Concurrency ────────────────────────────────────
+export { EdgeWeightUpdater } from './concurrency/EdgeWeightUpdater.js';
+export { OllamaAdapter } from './embedding/adapters/OllamaAdapter.js';
+export { NomicAdapter } from './embedding/adapters/NomicAdapter.js';
+export { OpenAIAdapter } from './embedding/adapters/OpenAIAdapter.js';
+export { HNSWIndex } from './embedding/HNSWIndex.js';
+export { MultimodalEmbedder } from './embedding/MultimodalEmbedder.js';
+// ─── Entity Resolution ─────────────────────────────
+export { AliasIndex } from './entity/AliasIndex.js';
+// ─── Entity Nesting (personality + hierarchy) ──────
+export { PersonalityProfileStore, PERSONALITY_NODE_LABEL, } from './entity/PersonalityProfile.js';
+export { EntityHierarchy, DEFAULT_VISIBILITY_POLICY, } from './entity/EntityHierarchy.js';
+export { PersonalityAccumulator, } from './entity/PersonalityAccumulator.js';
+export { NodeResolutionService, } from './entity/NodeResolutionService.js';
+// ─── Bootstrap ──────────────────────────────────────
+export { StagedMutationStore, } from './bootstrap/StagedMutations.js';
+export { HypothesisManager, } from './bootstrap/HypothesisManager.js';
+export { GraphConstructor, } from './bootstrap/GraphConstructor.js';
+export { BootstrapProtocol } from './bootstrap/BootstrapProtocol.js';
+export { DEFAULT_SELF_IMPROVEMENT_CONFIG, } from './types/SelfImprovement.js';
+export { SelfImprovementEngine } from './engine/SelfImprovementEngine.js';
+export { SELF_IMPROVEMENT_PROMPT } from './engine/SelfImprovementPrompt.js';
+// ─── Maintenance (Phase 5) ─────────────────────────
+export { EdgePruner, } from './maintenance/EdgePruner.js';
+export { NodeDeduplicator, } from './maintenance/NodeDeduplicator.js';
+export { SubgraphArchiver, } from './maintenance/SubgraphArchiver.js';
+export { CompactionOrchestrator, } from './maintenance/CompactionOrchestrator.js';
+export { GraphCheckpointManager, } from './maintenance/GraphCheckpoint.js';
+export { GraphRollback, } from './maintenance/GraphRollback.js';
+// ─── Concurrency (Phase 5) ─────────────────────────
+export { SessionSnapshotManager, } from './concurrency/SessionSnapshot.js';
+//# sourceMappingURL=index.js.map

package/packages/core/dist/index.js.map

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

package/packages/core/dist/maintenance/CompactionOrchestrator.d.ts

@@ -0,0 +1,22 @@
+import type { KnowledgeGraph } from '../graph/KnowledgeGraph.js';
+import { EdgePruner } from './EdgePruner.js';
+import { SubgraphArchiver } from './SubgraphArchiver.js';
+import { NodeDeduplicator } from './NodeDeduplicator.js';
+export interface CompactionSchedule {
+    edge_pruning_interval_ms: number;
+    archival_trigger_nodes: number;
+    deduplication_interval_ms: number;
+}
+export declare class CompactionOrchestrator {
+    private edgePruner;
+    private archiver;
+    private deduplicator;
+    private graph;
+    private schedule;
+    private lastPruneAt;
+    private lastDedupAt;
+    constructor(edgePruner: EdgePruner, archiver: SubgraphArchiver, deduplicator: NodeDeduplicator, graph: KnowledgeGraph, schedule?: CompactionSchedule);
+    runCompaction(activeSessionCount?: number): Promise<void>;
+    shouldRun(now?: number): boolean;
+}
+//# sourceMappingURL=CompactionOrchestrator.d.ts.map

package/packages/core/dist/maintenance/CompactionOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompactionOrchestrator.d.ts","sourceRoot":"","sources":["../../src/maintenance/CompactionOrchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAQD,qBAAa,sBAAsB;IAK/B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IARlB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAAK;gBAGd,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,gBAAgB,EAC9B,KAAK,EAAE,cAAc,EACrB,QAAQ,GAAE,kBAAqC;IAGnD,aAAa,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6C/D,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;CASjC"}

package/packages/core/dist/maintenance/CompactionOrchestrator.js

@@ -0,0 +1,62 @@
+const DEFAULT_SCHEDULE = {
+    edge_pruning_interval_ms: 24 * 60 * 60 * 1000, // 24 hours
+    archival_trigger_nodes: 5000,
+    deduplication_interval_ms: 7 * 24 * 60 * 60 * 1000, // 7 days
+};
+export class CompactionOrchestrator {
+    edgePruner;
+    archiver;
+    deduplicator;
+    graph;
+    schedule;
+    lastPruneAt = 0;
+    lastDedupAt = 0;
+    constructor(edgePruner, archiver, deduplicator, graph, schedule = DEFAULT_SCHEDULE) {
+        this.edgePruner = edgePruner;
+        this.archiver = archiver;
+        this.deduplicator = deduplicator;
+        this.graph = graph;
+        this.schedule = schedule;
+    }
+    async runCompaction(activeSessionCount) {
+        const now = Date.now();
+        // Safety: never run during active sessions
+        if (activeSessionCount && activeSessionCount > 0) {
+            console.log(`[Compaction] Deferring: ${activeSessionCount} active sessions`);
+            return;
+        }
+        // Level 1: Edge Pruning (daily)
+        if (now - this.lastPruneAt >= this.schedule.edge_pruning_interval_ms) {
+            console.log('[Compaction] Level 1: Running edge pruning...');
+            const pruneResult = this.edgePruner.prune();
+            console.log(`[Compaction] Level 1 complete: pruned ${pruneResult.pruned_count} edges ` +
+                `(locked=${pruneResult.skipped_locked}, hypothesis=${pruneResult.skipped_hypothesis}, ` +
+                `skill=${pruneResult.skipped_skill}, active=${pruneResult.skipped_active})`);
+            this.lastPruneAt = now;
+        }
+        // Level 2: Subgraph Archival (if node count exceeds threshold)
+        const nodeCount = this.graph.nodeCount();
+        if (nodeCount > this.schedule.archival_trigger_nodes) {
+            console.log(`[Compaction] Level 2: Running subgraph archival (${nodeCount} nodes)...`);
+            const archiveResult = await this.archiver.archiveCold();
+            console.log(`[Compaction] Level 2 complete: archived ${archiveResult.archived_count} subgraphs`);
+        }
+        // Level 3: Node Deduplication (weekly)
+        if (now - this.lastDedupAt >= this.schedule.deduplication_interval_ms) {
+            console.log('[Compaction] Level 3: Running node deduplication...');
+            const dedupResult = this.deduplicator.run();
+            console.log(`[Compaction] Level 3 complete: merged ${dedupResult.merged_count} nodes ` +
+                `(${dedupResult.candidates_found} candidates found)`);
+            this.lastDedupAt = now;
+        }
+        // Level 4: LRU eviction handled by WorkingMemory automatically
+    }
+    shouldRun(now) {
+        const ts = now ?? Date.now();
+        const pruningDue = ts - this.lastPruneAt >= this.schedule.edge_pruning_interval_ms;
+        const dedupDue = ts - this.lastDedupAt >= this.schedule.deduplication_interval_ms;
+        const nodeCountHigh = this.graph.nodeCount() > this.schedule.archival_trigger_nodes;
+        return pruningDue || dedupDue || nodeCountHigh;
+    }
+}
+//# sourceMappingURL=CompactionOrchestrator.js.map

package/packages/core/dist/maintenance/CompactionOrchestrator.js.map

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

package/packages/core/dist/maintenance/EdgePruner.d.ts

@@ -0,0 +1,20 @@
+import type { KnowledgeGraph } from '../graph/KnowledgeGraph.js';
+export interface PruneConfig {
+    weight_delta_threshold: number;
+    idle_days: number;
+    dry_run: boolean;
+}
+export interface PruneResult {
+    pruned_count: number;
+    skipped_locked: number;
+    skipped_hypothesis: number;
+    skipped_skill: number;
+    skipped_active: number;
+    pruned_edge_ids: string[];
+}
+export declare class EdgePruner {
+    private graph;
+    constructor(graph: KnowledgeGraph);
+    prune(config?: Partial<PruneConfig>): PruneResult;
+}
+//# sourceMappingURL=EdgePruner.d.ts.map

package/packages/core/dist/maintenance/EdgePruner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgePruner.d.ts","sourceRoot":"","sources":["../../src/maintenance/EdgePruner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIjE,MAAM,WAAW,WAAW;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAQD,qBAAa,UAAU;IACT,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,cAAc;IAEzC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW;CAmElD"}

package/packages/core/dist/maintenance/EdgePruner.js

@@ -0,0 +1,65 @@
+import { NodeType } from '../graph/GraphNode.js';
+const DEFAULT_CONFIG = {
+    weight_delta_threshold: 0.1,
+    idle_days: 14,
+    dry_run: false,
+};
+export class EdgePruner {
+    graph;
+    constructor(graph) {
+        this.graph = graph;
+    }
+    prune(config) {
+        const cfg = { ...DEFAULT_CONFIG, ...config };
+        const result = {
+            pruned_count: 0,
+            skipped_locked: 0,
+            skipped_hypothesis: 0,
+            skipped_skill: 0,
+            skipped_active: 0,
+            pruned_edge_ids: [],
+        };
+        const idleThresholdMs = cfg.idle_days * 24 * 60 * 60 * 1000;
+        const now = Date.now();
+        const edges = this.graph.getAllEdges();
+        for (const edge of edges) {
+            // Skip if weight is not neutral enough (too far from 0.5)
+            if (Math.abs(edge.weight - 0.5) >= cfg.weight_delta_threshold) {
+                continue;
+            }
+            // Skip if edge was recently traversed (still active)
+            const lastActivity = edge.last_traversed ?? edge.created_at;
+            if (now - lastActivity < idleThresholdMs) {
+                result.skipped_active++;
+                continue;
+            }
+            // Skip if locked
+            if (edge.locked) {
+                result.skipped_locked++;
+                continue;
+            }
+            // Skip if connected to a HYPOTHESIS node
+            const fromNode = this.graph.getNode(edge.from_node);
+            const toNode = this.graph.getNode(edge.to_node);
+            if ((fromNode && fromNode.type === NodeType.HYPOTHESIS) ||
+                (toNode && toNode.type === NodeType.HYPOTHESIS)) {
+                result.skipped_hypothesis++;
+                continue;
+            }
+            // Skip if connected to a node with metadata.is_skill === true
+            if ((fromNode && fromNode.metadata.is_skill === true) ||
+                (toNode && toNode.metadata.is_skill === true)) {
+                result.skipped_skill++;
+                continue;
+            }
+            // Edge qualifies for pruning
+            if (!cfg.dry_run) {
+                this.graph.deleteEdge(edge.id);
+            }
+            result.pruned_edge_ids.push(edge.id);
+            result.pruned_count++;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=EdgePruner.js.map

package/packages/core/dist/maintenance/EdgePruner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgePruner.js","sourceRoot":"","sources":["../../src/maintenance/EdgePruner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAiBjD,MAAM,cAAc,GAAgB;IAClC,sBAAsB,EAAE,GAAG;IAC3B,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,KAAK;CACf,CAAC;AAEF,MAAM,OAAO,UAAU;IACD;IAApB,YAAoB,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAE7C,KAAK,CAAC,MAA6B;QACjC,MAAM,GAAG,GAAgB,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAE1D,MAAM,MAAM,GAAgB;YAC1B,YAAY,EAAE,CAAC;YACf,cAAc,EAAE,CAAC;YACjB,kBAAkB,EAAE,CAAC;YACrB,aAAa,EAAE,CAAC;YAChB,cAAc,EAAE,CAAC;YACjB,eAAe,EAAE,EAAE;SACpB,CAAC;QAEF,MAAM,eAAe,GAAG,GAAG,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAgB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAEpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,0DAA0D;YAC1D,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;gBAC9D,SAAS;YACX,CAAC;YAED,qDAAqD;YACrD,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,UAAU,CAAC;YAC5D,IAAI,GAAG,GAAG,YAAY,GAAG,eAAe,EAAE,CAAC;gBACzC,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,iBAAiB;YACjB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,yCAAyC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEhD,IACE,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,UAAU,CAAC;gBACnD,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,UAAU,CAAC,EAC/C,CAAC;gBACD,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC5B,SAAS;YACX,CAAC;YAED,8DAA8D;YAC9D,IACE,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC;gBACjD,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,EAC7C,CAAC;gBACD,MAAM,CAAC,aAAa,EAAE,CAAC;gBACvB,SAAS;YACX,CAAC;YAED,6BAA6B;YAC7B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjC,CAAC;YAED,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/packages/core/dist/maintenance/GraphCheckpoint.d.ts

@@ -0,0 +1,51 @@
+import type { KnowledgeGraph } from '../graph/KnowledgeGraph.js';
+import type { ObjectStore } from '../storage/ObjectStore.js';
+import type { GraphNode } from '../graph/GraphNode.js';
+import type { GraphEdge } from '../graph/GraphEdge.js';
+export interface Checkpoint {
+    id: string;
+    name: string;
+    created_at: number;
+    node_count: number;
+    edge_count: number;
+    storage_ref: string;
+}
+export interface CheckpointSnapshot {
+    checkpoint_id: string;
+    created_at: number;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export declare class GraphCheckpointManager {
+    private graph;
+    private objectStore;
+    private checkpoints;
+    constructor(graph: KnowledgeGraph, objectStore: ObjectStore);
+    /**
+     * Create a named checkpoint by snapshotting all current nodes and edges
+     * into the ObjectStore.
+     */
+    create(name: string): Promise<Checkpoint>;
+    /**
+     * Load the full snapshot data for a checkpoint from the ObjectStore.
+     */
+    getSnapshot(checkpointId: string): Promise<CheckpointSnapshot | null>;
+    /**
+     * Get checkpoint metadata by id.
+     */
+    get(id: string): Checkpoint | null;
+    /**
+     * Find a checkpoint by its human-readable name.
+     */
+    getByName(name: string): Checkpoint | null;
+    /**
+     * List all checkpoints, newest first.
+     */
+    list(): Checkpoint[];
+    /**
+     * Remove a checkpoint from the in-memory registry.
+     * Does NOT delete the ObjectStore blob (call objectStore.delete separately if needed).
+     */
+    delete(id: string): void;
+}
+//# sourceMappingURL=GraphCheckpoint.d.ts.map

package/packages/core/dist/maintenance/GraphCheckpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphCheckpoint.d.ts","sourceRoot":"","sources":["../../src/maintenance/GraphCheckpoint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,qBAAa,sBAAsB;IAI/B,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,WAAW;IAJrB,OAAO,CAAC,WAAW,CAAsC;gBAG/C,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,WAAW;IAGlC;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiC/C;;OAEG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAQ3E;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAO1C;;OAEG;IACH,IAAI,IAAI,UAAU,EAAE;IAIpB;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGzB"}

package/packages/core/dist/maintenance/GraphCheckpoint.js

@@ -0,0 +1,81 @@
+import { randomUUID } from 'node:crypto';
+export class GraphCheckpointManager {
+    graph;
+    objectStore;
+    checkpoints = new Map();
+    constructor(graph, objectStore) {
+        this.graph = graph;
+        this.objectStore = objectStore;
+    }
+    /**
+     * Create a named checkpoint by snapshotting all current nodes and edges
+     * into the ObjectStore.
+     */
+    async create(name) {
+        const id = randomUUID();
+        const now = Date.now();
+        // Snapshot all nodes and edges from the graph
+        const nodes = this.graph.queryStructural({ limit: 100_000 }).map((r) => r.node);
+        const edges = this.graph.getAllEdges();
+        const snapshot = {
+            checkpoint_id: id,
+            created_at: now,
+            nodes,
+            edges,
+        };
+        const ref = await this.objectStore.put(JSON.stringify(snapshot), {
+            prefix: 'checkpoints',
+            extension: '.json',
+        });
+        const checkpoint = {
+            id,
+            name,
+            created_at: now,
+            node_count: nodes.length,
+            edge_count: edges.length,
+            storage_ref: ref,
+        };
+        this.checkpoints.set(id, checkpoint);
+        return checkpoint;
+    }
+    /**
+     * Load the full snapshot data for a checkpoint from the ObjectStore.
+     */
+    async getSnapshot(checkpointId) {
+        const cp = this.checkpoints.get(checkpointId);
+        if (!cp)
+            return null;
+        const data = await this.objectStore.get(cp.storage_ref);
+        return JSON.parse(data.toString());
+    }
+    /**
+     * Get checkpoint metadata by id.
+     */
+    get(id) {
+        return this.checkpoints.get(id) ?? null;
+    }
+    /**
+     * Find a checkpoint by its human-readable name.
+     */
+    getByName(name) {
+        for (const cp of this.checkpoints.values()) {
+            if (cp.name === name)
+                return cp;
+        }
+        return null;
+    }
+    /**
+     * List all checkpoints, newest first.
+     */
+    list() {
+        return [...this.checkpoints.values()].sort((a, b) => b.created_at - a.created_at);
+    }
+    /**
+     * Remove a checkpoint from the in-memory registry.
+     * Does NOT delete the ObjectStore blob (call objectStore.delete separately if needed).
+     */
+    delete(id) {
+        this.checkpoints.delete(id);
+    }
+}
+//# sourceMappingURL=GraphCheckpoint.js.map

package/packages/core/dist/maintenance/GraphCheckpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphCheckpoint.js","sourceRoot":"","sources":["../../src/maintenance/GraphCheckpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAsBzC,MAAM,OAAO,sBAAsB;IAIvB;IACA;IAJF,WAAW,GAA4B,IAAI,GAAG,EAAE,CAAC;IAEzD,YACU,KAAqB,EACrB,WAAwB;QADxB,UAAK,GAAL,KAAK,CAAgB;QACrB,gBAAW,GAAX,WAAW,CAAa;IAC/B,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,8CAA8C;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAEvC,MAAM,QAAQ,GAAuB;YACnC,aAAa,EAAE,EAAE;YACjB,UAAU,EAAE,GAAG;YACf,KAAK;YACL,KAAK;SACN,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;YAC/D,MAAM,EAAE,aAAa;YACrB,SAAS,EAAE,OAAO;SACnB,CAAC,CAAC;QAEH,MAAM,UAAU,GAAe;YAC7B,EAAE;YACF,IAAI;YACJ,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,WAAW,EAAE,GAAG;SACjB,CAAC;QAEF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,YAAoB;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAErB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAuB,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY;QACpB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IACpF,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/packages/core/dist/maintenance/GraphRollback.d.ts

@@ -0,0 +1,36 @@
+import type { KnowledgeGraph } from '../graph/KnowledgeGraph.js';
+import type { SQLiteAdapter } from '../storage/adapters/SQLiteAdapter.js';
+import type { GraphCheckpointManager } from './GraphCheckpoint.js';
+import type { WeightEventLog } from '../storage/WeightEventLog.js';
+export type RollbackMode = {
+    type: 'checkpoint';
+    checkpoint_id: string;
+} | {
+    type: 'trace';
+    trace_id: string;
+} | {
+    type: 'verifier';
+    verifier_name: string;
+};
+export interface RollbackResult {
+    mode: RollbackMode;
+    edges_reverted: number;
+    nodes_restored: number;
+    traces_undone: number;
+    weight_events_reversed: number;
+}
+export declare class GraphRollback {
+    private graph;
+    private adapter;
+    private weightLog;
+    private checkpointManager;
+    constructor(graph: KnowledgeGraph, adapter: SQLiteAdapter, weightLog: WeightEventLog, checkpointManager: GraphCheckpointManager);
+    /**
+     * Dispatch to the appropriate rollback strategy based on mode.
+     */
+    rollback(mode: RollbackMode): Promise<RollbackResult>;
+    private rollbackToCheckpoint;
+    private rollbackTrace;
+    private rollbackVerifier;
+}
+//# sourceMappingURL=GraphRollback.d.ts.map

package/packages/core/dist/maintenance/GraphRollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphRollback.d.ts","sourceRoot":"","sources":["../../src/maintenance/GraphRollback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E,OAAO,KAAK,EAAE,sBAAsB,EAAsB,MAAM,sBAAsB,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,aAAa;IAEtB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,iBAAiB;gBAHjB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,cAAc,EACzB,iBAAiB,EAAE,sBAAsB;IAGnD;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;YAkB7C,oBAAoB;YAgFpB,aAAa;YAoCb,gBAAgB;CAgC/B"}