@weavelogic/knowledge-graph-agent 0.2.0 → 0.3.0

package/dist/health/monitor.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Health Monitor - System health monitoring
+ *
+ * Provides centralized health monitoring for all system components,
+ * with support for automatic checks, alerting, and history tracking.
+ *
+ * @module health/monitor
+ */
+import { EventEmitter } from 'events';
+import type { SystemHealth, ComponentHealth, HealthCheck, HealthMonitorConfig } from './types.js';
+/**
+ * Health Monitor
+ *
+ * Monitors the health of system components and aggregates status.
+ *
+ * @example
+ * ```typescript
+ * const monitor = createHealthMonitor({ checkInterval: 30000 });
+ *
+ * // Register health checks
+ * monitor.registerCheck(createMemoryCheck(85));
+ * monitor.registerCheck(createDatabaseCheck('/path/to/db'));
+ *
+ * // Listen for events
+ * monitor.on('alert', (alert) => {
+ *   console.error(`Health alert: ${alert.message}`);
+ * });
+ *
+ * // Start monitoring
+ * monitor.start();
+ *
+ * // Get current health
+ * const health = await monitor.runAllChecks();
+ * console.log(`System status: ${health.status}`);
+ * ```
+ */
+export declare class HealthMonitor extends EventEmitter {
+    private checks;
+    private results;
+    private failureCounts;
+    private history;
+    private timer?;
+    private startTime;
+    private config;
+    private lastStatus;
+    private requestCount;
+    private errorCount;
+    private latencySum;
+    private cacheHits;
+    private cacheMisses;
+    private lastResetTime;
+    constructor(config?: Partial<HealthMonitorConfig>);
+    /**
+     * Register a health check
+     */
+    registerCheck(check: HealthCheck): void;
+    /**
+     * Unregister a health check
+     */
+    unregisterCheck(name: string): void;
+    /**
+     * Get all registered check names
+     */
+    getRegisteredChecks(): string[];
+    /**
+     * Run a specific health check by name
+     */
+    runCheck(name: string): Promise<ComponentHealth>;
+    /**
+     * Run all registered health checks
+     */
+    runAllChecks(): Promise<SystemHealth>;
+    /**
+     * Get current system health without running checks
+     */
+    getSystemHealth(): SystemHealth;
+    /**
+     * Get the last known health for a component
+     */
+    getComponentHealth(name: string): ComponentHealth | undefined;
+    /**
+     * Calculate overall system status from component statuses
+     */
+    private calculateOverallStatus;
+    /**
+     * Get current memory metrics
+     */
+    private getMemoryMetrics;
+    /**
+     * Get current performance metrics
+     */
+    private getPerformanceMetrics;
+    /**
+     * Record a request for performance tracking
+     */
+    recordRequest(latency: number, error?: boolean): void;
+    /**
+     * Record a cache access for performance tracking
+     */
+    recordCacheAccess(hit: boolean): void;
+    /**
+     * Reset performance metrics
+     */
+    resetPerformanceMetrics(): void;
+    /**
+     * Trigger a health alert
+     */
+    private triggerAlert;
+    /**
+     * Add health snapshot to history
+     */
+    private addToHistory;
+    /**
+     * Get health history
+     */
+    getHistory(limit?: number): SystemHealth[];
+    /**
+     * Get failure count for a component
+     */
+    getFailureCount(name: string): number;
+    /**
+     * Start automatic health monitoring
+     */
+    start(): void;
+    /**
+     * Stop automatic health monitoring
+     */
+    stop(): void;
+    /**
+     * Check if monitor is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get monitor uptime in milliseconds
+     */
+    getUptime(): number;
+    /**
+     * Get current configuration
+     */
+    getConfig(): HealthMonitorConfig;
+}
+/**
+ * Create a new health monitor instance
+ */
+export declare function createHealthMonitor(config?: Partial<HealthMonitorConfig>): HealthMonitor;
+//# sourceMappingURL=monitor.d.ts.map

package/dist/health/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/health/monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAEf,WAAW,EACX,mBAAmB,EAIpB,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,KAAK,CAAC,CAAiC;IAC/C,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAA2B;IAG7C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAUjD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IASvC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOnC;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAoEtD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAS3C;;OAEG;IACH,eAAe,IAAI,YAAY;IA2B/B;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI7D;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsC9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,IAAI;IAQnD;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAQrC;;OAEG;IACH,uBAAuB,IAAI,IAAI;IAU/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAK1C;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAwBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,IAAI,mBAAmB;CAGjC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,aAAa,CAExF"}

package/dist/health/types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Health Monitoring Types
+ *
+ * Type definitions for the health monitoring system.
+ *
+ * @module health/types
+ */
+/**
+ * Health status levels for components and systems
+ */
+export type HealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
+/**
+ * Health information for a single component
+ */
+export interface ComponentHealth {
+    /** Component name/identifier */
+    name: string;
+    /** Current health status */
+    status: HealthStatus;
+    /** Optional status message */
+    message?: string;
+    /** Timestamp of last health check */
+    lastCheck: Date;
+    /** Optional component-specific metrics */
+    metrics?: Record<string, number>;
+}
+/**
+ * Overall system health information
+ */
+export interface SystemHealth {
+    /** Aggregate health status */
+    status: HealthStatus;
+    /** Health status of individual components */
+    components: ComponentHealth[];
+    /** Timestamp of this health snapshot */
+    timestamp: Date;
+    /** System uptime in milliseconds */
+    uptime: number;
+    /** Memory usage metrics */
+    memory: MemoryMetrics;
+    /** Performance metrics */
+    performance: PerformanceMetrics;
+}
+/**
+ * Memory usage metrics from Node.js process
+ */
+export interface MemoryMetrics {
+    /** Heap memory used in bytes */
+    heapUsed: number;
+    /** Total heap memory allocated in bytes */
+    heapTotal: number;
+    /** Memory used by C++ objects bound to JS in bytes */
+    external: number;
+    /** Resident Set Size in bytes */
+    rss: number;
+    /** Percentage of heap used (heapUsed / heapTotal * 100) */
+    usagePercent: number;
+}
+/**
+ * Performance metrics for request handling
+ */
+export interface PerformanceMetrics {
+    /** Number of requests processed per minute */
+    requestsPerMinute: number;
+    /** Average request latency in milliseconds */
+    averageLatency: number;
+    /** Percentage of requests that resulted in errors */
+    errorRate: number;
+    /** Cache hit rate as a percentage */
+    cacheHitRate: number;
+}
+/**
+ * Health check definition
+ */
+export interface HealthCheck {
+    /** Unique name for this health check */
+    name: string;
+    /** Function that performs the health check */
+    check: () => Promise<ComponentHealth>;
+    /** Interval between automatic checks in milliseconds */
+    interval: number;
+    /** Whether this check is critical for overall system health */
+    critical?: boolean;
+}
+/**
+ * Configuration for the health monitor
+ */
+export interface HealthMonitorConfig {
+    /** Interval between automatic health checks in milliseconds */
+    checkInterval: number;
+    /** Maximum number of health history entries to retain */
+    historySize: number;
+    /** Number of consecutive failures before alerting */
+    alertThreshold: number;
+}
+/**
+ * Health check result with timing information
+ */
+export interface HealthCheckResult {
+    /** The component health result */
+    health: ComponentHealth;
+    /** Duration of the check in milliseconds */
+    duration: number;
+    /** Whether the check timed out */
+    timedOut: boolean;
+}
+/**
+ * Alert triggered by health monitor
+ */
+export interface HealthAlert {
+    /** Component that triggered the alert */
+    component: string;
+    /** Alert severity level */
+    severity: 'warning' | 'critical';
+    /** Alert message */
+    message: string;
+    /** Timestamp when alert was triggered */
+    timestamp: Date;
+    /** Number of consecutive failures */
+    failureCount: number;
+}
+/**
+ * Health monitor events
+ */
+export interface HealthMonitorEvents {
+    /** Emitted when a health check completes */
+    checkComplete: (result: ComponentHealth) => void;
+    /** Emitted when a health check fails */
+    checkFailed: (result: ComponentHealth) => void;
+    /** Emitted when system health status changes */
+    statusChange: (oldStatus: HealthStatus, newStatus: HealthStatus) => void;
+    /** Emitted when an alert is triggered */
+    alert: (alert: HealthAlert) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/health/types.d.ts.map

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

package/dist/index.d.ts

@@ -7,6 +7,8 @@
  */
 export { KnowledgeGraphManager, createKnowledgeGraph, } from './core/graph.js';
 export { KnowledgeGraphDatabase, createDatabase, } from './core/database.js';
+export { ShadowCache, createShadowCache, loadShadowCache, } from './core/cache.js';
+export type { FileMetadata, FileType, ChangeType, FileChange, CacheStats, ShadowCacheOptions, } from './core/cache.js';
 export type { NodeType, NodeStatus, NodeLink, NodeFrontmatter, KnowledgeNode, GraphEdge, GraphMetadata, GraphStats, KnowledgeGraph, KGConfig, ConfigSchema, GeneratorOptions, GeneratedDocument, DocsInitOptions, DocsInitResult, MemoryEntry, SyncResult, ClaudeMdSection, ClaudeMdTemplate, ClaudeMdGeneratorOptions, } from './core/types.js';
 export { generateGraph, generateAndSave, updateGraph, } from './generators/graph-generator.js';
 export { initDocs, docsExist, getDocsPath, } from './generators/docs-init.js';
@@ -17,6 +19,34 @@ export { analyzeDocs, } from './generators/docs-analyzer.js';
 export type { AnalyzerOptions, AnalyzedDoc, AnalyzerResult, } from './generators/docs-analyzer.js';
 export { ClaudeFlowIntegration, createClaudeFlowIntegration, generateMcpConfig, } from './integrations/claude-flow.js';
 export { createCLI } from './cli/index.js';
+export { AgentType, AgentStatus, TaskPriority, MessageType, createMessageId, createTaskId, createAgentId, AgentRegistry, getRegistry, createRegistry, setDefaultRegistry, registerDefaultAgents, BaseAgent, createTask, isAgentResult, isAgentError, ResearcherAgent, CoderAgent, TesterAgent, AnalystAgent, ArchitectAgent, RulesEngine, createRulesEngine, createRule, createConditionalRule, createFileChangeLogRule, createGraphUpdateNotificationRule, createAgentCompletionRule, } from './agents/index.js';
+export type { AgentConfig, ResearcherAgentConfig, CoderAgentConfig, TesterAgentConfig, AnalystAgentConfig, ArchitectAgentConfig, SpecializedAgentConfig, TaskInput, AgentTask, AgentResult as AgentSystemResult, AgentError, ExecutionMetrics, ResultArtifact, AgentMessage, TaskRequestMessage, TaskResponseMessage, StatusMessage, ErrorMessage, CoordinationMessage, AgentMessageUnion, AgentState, AgentFactory, AgentInstance, AgentCapability, AgentHealthCheck, RegistryOptions, SpawnOptions, RuleTrigger, RulePriority, RuleExecutionStatus, RuleContext, RuleCondition, RuleAction, AgentRule, RuleExecutionLog, RuleStatistics, EngineStatistics, RulesEngineConfig, } from './agents/index.js';
+export { SeedGenerator, analyzeSeed, initPrimitives, DeepAnalyzer, createDeepAnalyzer, analyzeDeep, } from './cultivation/index.js';
+export type { VaultContext, Ecosystem, DependencyType, ServiceType, DependencyInfo, ServiceInfo, SeedAnalysis, DocumentMetadata as CultivationDocumentMetadata, GeneratedDocument as CultivationGeneratedDocument, CultivationReport, CultivationOptions, GapAnalysis as CultivationGapAnalysis, InitPrimitivesResult, DeepAnalyzerOptions, AgentResult, DeepAnalysisResult, } from './cultivation/index.js';
+export { SOPCategory, ComplianceStatus, SOPPriority, IRBStatus, GraphLayer, getSOPById, getSOPsByCategory, getSOPsRequiringIRB, searchSOPs, getAllSOPs, getSopCount, getCategories, checkCompliance, checkSOPCompliance, meetsMinimumCompliance, analyzeGaps, getGapsForSOP, getQuickWins, calculateProgress, createMultiLayerGraph, addProjectLayer, addComplianceOverlay, filterByLayer, filterByComplianceStatus, getComplianceSummary, getGapNodes, toggleLayerVisibility, exportToVisualizationFormat, createSOPFocusedSubgraph, } from './sops/index.js';
+export type { SOPRequirement, SOPCheckpoint, SOPDefinition, SOPAssessment, ComplianceGap, LayerDefinition, LayerNode, LayerEdge, MultiLayerGraph, ComplianceReport, SOPFrontmatter, SOPConfig, ComplianceCheckOptions, ComplianceCheckResult, EvidenceItem, GapAnalysisOptions, GapAnalysisResult, GapSummary, RemediationRoadmap, RemediationPhase, GapDependency, OverlayManagerOptions, NodeStyleConfig, } from './sops/index.js';
+export { WorkflowStatus, WorkflowRegistry, createWorkflowRegistry, } from './workflows/index.js';
+export type { StepContext, StepHandler, RollbackHandler, WorkflowStep, WorkflowDefinition, StepExecution, WorkflowExecution, WorkflowResult, WorkflowExecutionStats, WorkflowRegistryOptions, WorkflowListOptions, ExecutionHistoryOptions, WorkflowEventType, WorkflowEvent, WorkflowEventListener, } from './workflows/index.js';
+export { VaultMemorySync, createVaultMemorySync, } from './memory/index.js';
+export type { SyncDirection, ConflictStrategy, SyncStatus, MemoryNode, SyncConflict, VaultSyncOptions, SyncOperationResult, FullSyncResult, } from './memory/index.js';
+export { ErrorCategory, ErrorSeverity, classifyError, isRetryableError, isTransientError, isRateLimitError, isPermanentError, KnowledgeGraphError, createValidationError, createConfigurationError, createResourceError, withRetry, retry, withFallback, withCircuitBreaker, retryable, calculateBackoff, sleep, CircuitBreaker, CircuitState, RetriesExhaustedError, CircuitOpenError, Logger, LogLevel, getLogger, createLogger, setDefaultLogger, parseLogLevel, createProgressLogger, } from './utils/index.js';
+export type { ClassifiedError, RetryOptions, RetryResult, FallbackOptions, CircuitBreakerOptions, LoggerOptions, LogEntry, ProgressLogger, } from './utils/index.js';
+export { KnowledgeGraphMCPServer, createMCPServer, runServer, initializeTools, registerTool, getToolHandler, getToolDefinition, getToolDefinitions, getToolCategories, handleToolCall, handleError, createErrorResult, createSuccessResult, } from './mcp-server/index.js';
+export type { MCPServerConfig, ServerHealth, ToolCategory, ToolHandler, ToolHandlerEntry, ToolResult, ToolContext, ToolInputSchema, ToolDefinition, GraphQueryParams, GraphNodeResult, AgentInvokeParams, AgentResult as MCPAgentResult, WorkflowParams, WorkflowResult as MCPWorkflowResult, MemoryParams, MemoryResult, } from './mcp-server/index.js';
+export { ServiceManager, createServiceManager, FileWatcherService, } from './services/index.js';
+export type { ServiceStatus, ServiceType as ManagerServiceType, ServiceConfig, ServiceState, ServiceMetrics, ServiceHandler, } from './services/index.js';
+export { ConfigManager, createConfigManager, getDefaultConfig, } from './config/index.js';
+export type { KGConfiguration, DatabaseConfig, CacheConfig, AgentConfig as ConfigAgentConfig, ServicesConfig, LoggingConfig, ConfigMigration, } from './config/index.js';
+export { HealthMonitor, createHealthMonitor, createDatabaseCheck, createCacheCheck, createMemoryCheck, createDiskCheck, } from './health/index.js';
+export type { HealthStatus, ComponentHealth, SystemHealth, MemoryMetrics, PerformanceMetrics, HealthCheck, HealthMonitorConfig, } from './health/index.js';
+export { Chunker, createChunker, chunkDocument, } from './chunking/index.js';
+export type { ChunkStrategy, ChunkOptions, Chunk, ChunkMetadata, ChunkResult, } from './chunking/index.js';
+export { BackupManager, createBackupManager, IntegrityChecker, createIntegrityChecker, checkDatabaseIntegrity, } from './recovery/index.js';
+export type { BackupConfig, BackupInfo, RestoreResult, RecoveryOptions, IntegrityCheckResult, TableIntegrity, } from './recovery/index.js';
+export { AdvancedCache, createAdvancedCache, } from './caching/index.js';
+export type { EvictionPolicy, CacheEntry, CacheConfig as AdvancedCacheConfig, CacheStats as AdvancedCacheStats, } from './caching/index.js';
+export { DecisionTracker, createDecisionTracker, getDecisionTracker, } from './reasoning/index.js';
+export type { DecisionType, ConfidenceLevel, Decision, DecisionContext, Alternative, DecisionOutcome, ReasoningChain, } from './reasoning/index.js';
 /**
  * Quick start function for programmatic usage
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAEV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,eAAe,EACf,aAAa,EAGb,SAAS,EACT,aAAa,EACb,UAAU,EACV,cAAc,EAGd,QAAQ,EACR,YAAY,EAGZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EAGd,WAAW,EACX,UAAU,EAGV,eAAe,EACf,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,GACZ,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,WAAW,EACX,cAAc,EACd,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,WAAW,GACZ,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,eAAe,EACf,WAAW,EACX,cAAc,GACf,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAgFD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -7,10 +7,44 @@ import { generateGraph, updateGraph } from "./generators/graph-generator.js";
 import { updateClaudeMd } from "./generators/claude-md.js";
 import { addSection, generateClaudeMd, getSectionTemplate, listSectionTemplates } from "./generators/claude-md.js";
 import { KnowledgeGraphManager, createKnowledgeGraph } from "./core/graph.js";
+import { ShadowCache, createShadowCache, loadShadowCache } from "./core/cache.js";
 import { addFrontmatter, convertDocs, validateFrontmatter } from "./generators/docs-convert.js";
 import { analyzeDocs } from "./generators/docs-analyzer.js";
 import { ClaudeFlowIntegration, createClaudeFlowIntegration, generateMcpConfig } from "./integrations/claude-flow.js";
 import { createCLI } from "./cli/index.js";
+import { AgentStatus, AgentType, MessageType, TaskPriority, createAgentId, createMessageId, createTaskId } from "./agents/types.js";
+import { AgentRegistry, createRegistry, getRegistry, registerDefaultAgents, setDefaultRegistry } from "./agents/registry.js";
+import { BaseAgent, createTask, isAgentError, isAgentResult } from "./agents/base-agent.js";
+import { RulesEngine, createAgentCompletionRule, createConditionalRule, createFileChangeLogRule, createGraphUpdateNotificationRule, createRule, createRulesEngine } from "./agents/rules-engine.js";
+import { ResearcherAgent } from "./agents/researcher-agent.js";
+import { CoderAgent } from "./agents/coder-agent.js";
+import { TesterAgent } from "./agents/tester-agent.js";
+import { AnalystAgent } from "./agents/analyst-agent.js";
+import { ArchitectAgent } from "./agents/architect-agent.js";
+import { SeedGenerator, analyzeSeed, initPrimitives } from "./cultivation/seed-generator.js";
+import { DeepAnalyzer, analyzeDeep, createDeepAnalyzer } from "./cultivation/deep-analyzer.js";
+import { ComplianceStatus, GraphLayer, IRBStatus, SOPCategory, SOPPriority } from "./sops/types.js";
+import { getAllSOPs, getCategories, getSOPById, getSOPsByCategory, getSOPsRequiringIRB, getSopCount, searchSOPs } from "./sops/registry.js";
+import { checkCompliance, checkSOPCompliance, meetsMinimumCompliance } from "./sops/compliance-checker.js";
+import { analyzeGaps, calculateProgress, getGapsForSOP, getQuickWins } from "./sops/gap-analyzer.js";
+import { addComplianceOverlay, addProjectLayer, createMultiLayerGraph, createSOPFocusedSubgraph, exportToVisualizationFormat, filterByComplianceStatus, filterByLayer, getComplianceSummary, getGapNodes, toggleLayerVisibility } from "./sops/overlay-manager.js";
+import { WorkflowStatus } from "./workflows/types.js";
+import { WorkflowRegistry, createWorkflowRegistry } from "./workflows/registry.js";
+import { VaultMemorySync, createVaultMemorySync } from "./memory/vault-sync.js";
+import { ErrorCategory, ErrorSeverity, KnowledgeGraphError, classifyError, createConfigurationError, createResourceError, createValidationError, isPermanentError, isRateLimitError, isRetryableError, isTransientError } from "./utils/error-taxonomy.js";
+import { CircuitBreaker, CircuitOpenError, CircuitState, RetriesExhaustedError, calculateBackoff, retry, retryable, sleep, withCircuitBreaker, withFallback, withRetry } from "./utils/error-recovery.js";
+import { LogLevel, Logger, createLogger, createProgressLogger, getLogger, parseLogLevel, setDefaultLogger } from "./utils/logger.js";
+import { KnowledgeGraphMCPServer, createMCPServer, runServer } from "./mcp-server/server.js";
+import { getToolCategories, getToolDefinition, getToolDefinitions, getToolHandler, initializeTools, registerTool } from "./mcp-server/tools/registry.js";
+import "path";
+import { createErrorResult, createSuccessResult, handleError, handleToolCall } from "./mcp-server/handlers/index.js";
+import { FileWatcherService, ServiceManager, createServiceManager } from "./services/index.js";
+import { ConfigManager, createConfigManager, getDefaultConfig } from "./config/index.js";
+import { HealthMonitor, createCacheCheck, createDatabaseCheck, createDiskCheck, createHealthMonitor, createMemoryCheck } from "./health/index.js";
+import { Chunker, chunkDocument, createChunker } from "./chunking/index.js";
+import { BackupManager, IntegrityChecker, checkDatabaseIntegrity, createBackupManager, createIntegrityChecker } from "./recovery/index.js";
+import { AdvancedCache, createAdvancedCache } from "./caching/index.js";
+import { DecisionTracker, createDecisionTracker, getDecisionTracker } from "./reasoning/index.js";
 async function quickInit(options) {
   const {
     projectRoot,
@@ -77,29 +111,167 @@ async function quickInit(options) {
   return result;
 }
 export {
+  AdvancedCache,
+  AgentRegistry,
+  AgentStatus,
+  AgentType,
+  AnalystAgent,
+  ArchitectAgent,
+  BackupManager,
+  BaseAgent,
+  Chunker,
+  CircuitBreaker,
+  CircuitOpenError,
+  CircuitState,
   ClaudeFlowIntegration,
+  CoderAgent,
+  ComplianceStatus,
+  ConfigManager,
+  DecisionTracker,
+  DeepAnalyzer,
+  ErrorCategory,
+  ErrorSeverity,
+  FileWatcherService,
+  GraphLayer,
+  HealthMonitor,
+  IRBStatus,
+  IntegrityChecker,
   KnowledgeGraphDatabase,
+  KnowledgeGraphError,
+  KnowledgeGraphMCPServer,
   KnowledgeGraphManager,
+  LogLevel,
+  Logger,
+  MessageType,
+  ResearcherAgent,
+  RetriesExhaustedError,
+  RulesEngine,
+  SOPCategory,
+  SOPPriority,
+  SeedGenerator,
+  ServiceManager,
+  ShadowCache,
+  TaskPriority,
+  TesterAgent,
+  VaultMemorySync,
+  WorkflowRegistry,
+  WorkflowStatus,
+  addComplianceOverlay,
   addFrontmatter,
+  addProjectLayer,
   addSection,
+  analyzeDeep,
   analyzeDocs,
+  analyzeGaps,
+  analyzeSeed,
+  calculateBackoff,
+  calculateProgress,
+  checkCompliance,
+  checkDatabaseIntegrity,
+  checkSOPCompliance,
+  chunkDocument,
+  classifyError,
   convertDocs,
+  createAdvancedCache,
+  createAgentCompletionRule,
+  createAgentId,
+  createBackupManager,
   createCLI,
+  createCacheCheck,
+  createChunker,
   createClaudeFlowIntegration,
+  createConditionalRule,
+  createConfigManager,
+  createConfigurationError,
   createDatabase,
+  createDatabaseCheck,
+  createDecisionTracker,
+  createDeepAnalyzer,
+  createDiskCheck,
+  createErrorResult,
+  createFileChangeLogRule,
+  createGraphUpdateNotificationRule,
+  createHealthMonitor,
+  createIntegrityChecker,
   createKnowledgeGraph,
+  createLogger,
+  createMCPServer,
+  createMemoryCheck,
+  createMessageId,
+  createMultiLayerGraph,
+  createProgressLogger,
+  createRegistry,
+  createResourceError,
+  createRule,
+  createRulesEngine,
+  createSOPFocusedSubgraph,
+  createServiceManager,
+  createShadowCache,
+  createSuccessResult,
+  createTask,
+  createTaskId,
+  createValidationError,
+  createVaultMemorySync,
+  createWorkflowRegistry,
   docsExist,
+  exportToVisualizationFormat,
+  filterByComplianceStatus,
+  filterByLayer,
   generateAndSave,
   generateClaudeMd,
   generateGraph,
   generateMcpConfig,
+  getAllSOPs,
+  getCategories,
+  getComplianceSummary,
+  getDecisionTracker,
+  getDefaultConfig,
   getDocsPath,
+  getGapNodes,
+  getGapsForSOP,
+  getLogger,
+  getQuickWins,
+  getRegistry,
+  getSOPById,
+  getSOPsByCategory,
+  getSOPsRequiringIRB,
   getSectionTemplate,
+  getSopCount,
+  getToolCategories,
+  getToolDefinition,
+  getToolDefinitions,
+  getToolHandler,
+  handleError,
+  handleToolCall,
   initDocs,
+  initPrimitives,
+  initializeTools,
+  isAgentError,
+  isAgentResult,
+  isPermanentError,
+  isRateLimitError,
+  isRetryableError,
+  isTransientError,
   listSectionTemplates,
+  loadShadowCache,
+  meetsMinimumCompliance,
+  parseLogLevel,
   quickInit,
+  registerDefaultAgents,
+  registerTool,
+  retry,
+  retryable,
+  runServer,
+  searchSOPs,
+  setDefaultLogger,
+  setDefaultRegistry,
+  sleep,
+  toggleLayerVisibility,
   updateClaudeMd,
   updateGraph,
-  validateFrontmatter
+  validateFrontmatter,
+  withCircuitBreaker,
+  withFallback,
+  withRetry
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent\n *\n * NPM library for creating and managing knowledge graphs for Claude Code.\n *\n * @packageDocumentation\n */\n\n// Internal imports for quickInit\nimport { createDatabase as _createDatabase } from './core/database.js';\nimport { initDocs as _initDocs, docsExist as _docsExist } from './generators/docs-init.js';\nimport { generateAndSave as _generateAndSave } from './generators/graph-generator.js';\nimport { updateClaudeMd as _updateClaudeMd } from './generators/claude-md.js';\n\n// Core exports\nexport {\n  KnowledgeGraphManager,\n  createKnowledgeGraph,\n} from './core/graph.js';\n\nexport {\n  KnowledgeGraphDatabase,\n  createDatabase,\n} from './core/database.js';\n\nexport type {\n  // Node types\n  NodeType,\n  NodeStatus,\n  NodeLink,\n  NodeFrontmatter,\n  KnowledgeNode,\n\n  // Graph types\n  GraphEdge,\n  GraphMetadata,\n  GraphStats,\n  KnowledgeGraph,\n\n  // Configuration\n  KGConfig,\n  ConfigSchema,\n\n  // Generator types\n  GeneratorOptions,\n  GeneratedDocument,\n  DocsInitOptions,\n  DocsInitResult,\n\n  // Integration types\n  MemoryEntry,\n  SyncResult,\n\n  // CLAUDE.md types\n  ClaudeMdSection,\n  ClaudeMdTemplate,\n  ClaudeMdGeneratorOptions,\n} from './core/types.js';\n\n// Generator exports\nexport {\n  generateGraph,\n  generateAndSave,\n  updateGraph,\n} from './generators/graph-generator.js';\n\nexport {\n  initDocs,\n  docsExist,\n  getDocsPath,\n} from './generators/docs-init.js';\n\nexport {\n  generateClaudeMd,\n  updateClaudeMd,\n  addSection,\n  getSectionTemplate,\n  listSectionTemplates,\n} from './generators/claude-md.js';\n\n// Conversion exports\nexport {\n  convertDocs,\n  addFrontmatter,\n  validateFrontmatter,\n} from './generators/docs-convert.js';\n\nexport type {\n  ConvertOptions,\n  ConvertResult,\n  FrontmatterOptions,\n  FrontmatterResult,\n} from './generators/docs-convert.js';\n\n// Analyzer exports\nexport {\n  analyzeDocs,\n} from './generators/docs-analyzer.js';\n\nexport type {\n  AnalyzerOptions,\n  AnalyzedDoc,\n  AnalyzerResult,\n} from './generators/docs-analyzer.js';\n\n// Integration exports\nexport {\n  ClaudeFlowIntegration,\n  createClaudeFlowIntegration,\n  generateMcpConfig,\n} from './integrations/claude-flow.js';\n\n// CLI export\nexport { createCLI } from './cli/index.js';\n\n/**\n * Quick start function for programmatic usage\n *\n * @example\n * ```typescript\n * import { quickInit } from '@weave-nn/knowledge-graph-agent';\n *\n * await quickInit({\n *   projectRoot: '/path/to/project',\n *   docsPath: 'docs',\n * });\n * ```\n */\nexport async function quickInit(options: {\n  projectRoot: string;\n  docsPath?: string;\n  generateGraph?: boolean;\n  updateClaudeMd?: boolean;\n}): Promise<{\n  success: boolean;\n  docsCreated: boolean;\n  graphGenerated: boolean;\n  claudeMdUpdated: boolean;\n  errors: string[];\n}> {\n  const {\n    projectRoot,\n    docsPath = 'docs',\n    generateGraph: genGraph = true,\n    updateClaudeMd: updateClaude = true,\n  } = options;\n\n  const result = {\n    success: true,\n    docsCreated: false,\n    graphGenerated: false,\n    claudeMdUpdated: false,\n    errors: [] as string[],\n  };\n\n  try {\n    // Initialize docs if needed\n    const { existsSync, mkdirSync, writeFileSync } = await import('fs');\n    const { join } = await import('path');\n\n    // Create .kg directory\n    const kgDir = join(projectRoot, '.kg');\n    if (!existsSync(kgDir)) {\n      mkdirSync(kgDir, { recursive: true });\n    }\n\n    // Initialize database\n    const dbPath = join(kgDir, 'knowledge.db');\n    const db = _createDatabase(dbPath);\n    db.setMetadata('initialized', new Date().toISOString());\n\n    // Initialize docs\n    if (!_docsExist(projectRoot, docsPath)) {\n      const docsResult = await _initDocs({\n        projectRoot,\n        docsPath,\n        includeExamples: true,\n        detectFramework: true,\n      });\n      result.docsCreated = docsResult.success;\n      if (!docsResult.success) {\n        result.errors.push(...docsResult.errors);\n      }\n    }\n\n    // Generate graph\n    if (genGraph && _docsExist(projectRoot, docsPath)) {\n      const graphResult = await _generateAndSave(\n        {\n          projectRoot,\n          outputPath: join(projectRoot, docsPath),\n        },\n        dbPath\n      );\n      result.graphGenerated = graphResult.success;\n      if (!graphResult.success) {\n        result.errors.push(...graphResult.stats.errors);\n      }\n    }\n\n    // Update CLAUDE.md\n    if (updateClaude) {\n      const claudeResult = await _updateClaudeMd({\n        projectRoot,\n        includeKnowledgeGraph: true,\n        includeClaudeFlow: true,\n      });\n      result.claudeMdUpdated = claudeResult.created || claudeResult.updated;\n    }\n\n    db.close();\n    result.success = result.errors.length === 0;\n\n  } catch (error) {\n    result.success = false;\n    result.errors.push(String(error));\n  }\n\n  return result;\n}\n"],"names":["_createDatabase","_docsExist","_initDocs","_generateAndSave","_updateClaudeMd"],"mappings":";;;;;;;;;;;;;AAgIA,eAAsB,UAAU,SAW7B;AACD,QAAM;AAAA,IACJ;AAAA,IACA,WAAW;AAAA,IACX,eAAe,WAAW;AAAA,IAC1B,gBAAgB,eAAe;AAAA,EAAA,IAC7B;AAEJ,QAAM,SAAS;AAAA,IACb,SAAS;AAAA,IACT,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,IACjB,QAAQ,CAAA;AAAA,EAAC;AAGX,MAAI;AAEF,UAAM,EAAE,YAAY,WAAW,kBAAkB,MAAM,OAAO,IAAI;AAClE,UAAM,EAAE,KAAA,IAAS,MAAM,OAAO,MAAM;AAGpC,UAAM,QAAQ,KAAK,aAAa,KAAK;AACrC,QAAI,CAAC,WAAW,KAAK,GAAG;AACtB,gBAAU,OAAO,EAAE,WAAW,KAAA,CAAM;AAAA,IACtC;AAGA,UAAM,SAAS,KAAK,OAAO,cAAc;AACzC,UAAM,KAAKA,eAAgB,MAAM;AACjC,OAAG,YAAY,gBAAe,oBAAI,KAAA,GAAO,aAAa;AAGtD,QAAI,CAACC,UAAW,aAAa,QAAQ,GAAG;AACtC,YAAM,aAAa,MAAMC,SAAU;AAAA,QACjC;AAAA,QACA;AAAA,QACA,iBAAiB;AAAA,QACjB,iBAAiB;AAAA,MAAA,CAClB;AACD,aAAO,cAAc,WAAW;AAChC,UAAI,CAAC,WAAW,SAAS;AACvB,eAAO,OAAO,KAAK,GAAG,WAAW,MAAM;AAAA,MACzC;AAAA,IACF;AAGA,QAAI,YAAYD,UAAW,aAAa,QAAQ,GAAG;AACjD,YAAM,cAAc,MAAME;AAAAA,QACxB;AAAA,UACE;AAAA,UACA,YAAY,KAAK,aAAa,QAAQ;AAAA,QAAA;AAAA,QAExC;AAAA,MAAA;AAEF,aAAO,iBAAiB,YAAY;AACpC,UAAI,CAAC,YAAY,SAAS;AACxB,eAAO,OAAO,KAAK,GAAG,YAAY,MAAM,MAAM;AAAA,MAChD;AAAA,IACF;AAGA,QAAI,cAAc;AAChB,YAAM,eAAe,MAAMC,eAAgB;AAAA,QACzC;AAAA,QACA,uBAAuB;AAAA,QACvB,mBAAmB;AAAA,MAAA,CACpB;AACD,aAAO,kBAAkB,aAAa,WAAW,aAAa;AAAA,IAChE;AAEA,OAAG,MAAA;AACH,WAAO,UAAU,OAAO,OAAO,WAAW;AAAA,EAE5C,SAAS,OAAO;AACd,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA,EAClC;AAEA,SAAO;AACT;"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent\n *\n * NPM library for creating and managing knowledge graphs for Claude Code.\n *\n * @packageDocumentation\n */\n\n// Internal imports for quickInit\nimport { createDatabase as _createDatabase } from './core/database.js';\nimport { initDocs as _initDocs, docsExist as _docsExist } from './generators/docs-init.js';\nimport { generateAndSave as _generateAndSave } from './generators/graph-generator.js';\nimport { updateClaudeMd as _updateClaudeMd } from './generators/claude-md.js';\n\n// Core exports\nexport {\n  KnowledgeGraphManager,\n  createKnowledgeGraph,\n} from './core/graph.js';\n\nexport {\n  KnowledgeGraphDatabase,\n  createDatabase,\n} from './core/database.js';\n\n// Cache exports\nexport {\n  ShadowCache,\n  createShadowCache,\n  loadShadowCache,\n} from './core/cache.js';\n\nexport type {\n  FileMetadata,\n  FileType,\n  ChangeType,\n  FileChange,\n  CacheStats,\n  ShadowCacheOptions,\n} from './core/cache.js';\n\nexport type {\n  // Node types\n  NodeType,\n  NodeStatus,\n  NodeLink,\n  NodeFrontmatter,\n  KnowledgeNode,\n\n  // Graph types\n  GraphEdge,\n  GraphMetadata,\n  GraphStats,\n  KnowledgeGraph,\n\n  // Configuration\n  KGConfig,\n  ConfigSchema,\n\n  // Generator types\n  GeneratorOptions,\n  GeneratedDocument,\n  DocsInitOptions,\n  DocsInitResult,\n\n  // Integration types\n  MemoryEntry,\n  SyncResult,\n\n  // CLAUDE.md types\n  ClaudeMdSection,\n  ClaudeMdTemplate,\n  ClaudeMdGeneratorOptions,\n} from './core/types.js';\n\n// Generator exports\nexport {\n  generateGraph,\n  generateAndSave,\n  updateGraph,\n} from './generators/graph-generator.js';\n\nexport {\n  initDocs,\n  docsExist,\n  getDocsPath,\n} from './generators/docs-init.js';\n\nexport {\n  generateClaudeMd,\n  updateClaudeMd,\n  addSection,\n  getSectionTemplate,\n  listSectionTemplates,\n} from './generators/claude-md.js';\n\n// Conversion exports\nexport {\n  convertDocs,\n  addFrontmatter,\n  validateFrontmatter,\n} from './generators/docs-convert.js';\n\nexport type {\n  ConvertOptions,\n  ConvertResult,\n  FrontmatterOptions,\n  FrontmatterResult,\n} from './generators/docs-convert.js';\n\n// Analyzer exports\nexport {\n  analyzeDocs,\n} from './generators/docs-analyzer.js';\n\nexport type {\n  AnalyzerOptions,\n  AnalyzedDoc,\n  AnalyzerResult,\n} from './generators/docs-analyzer.js';\n\n// Integration exports\nexport {\n  ClaudeFlowIntegration,\n  createClaudeFlowIntegration,\n  generateMcpConfig,\n} from './integrations/claude-flow.js';\n\n// CLI export\nexport { createCLI } from './cli/index.js';\n\n// Agents exports\nexport {\n  // Agent system core\n  AgentType,\n  AgentStatus,\n  TaskPriority,\n  MessageType,\n  createMessageId,\n  createTaskId,\n  createAgentId,\n\n  // Registry\n  AgentRegistry,\n  getRegistry,\n  createRegistry,\n  setDefaultRegistry,\n  registerDefaultAgents,\n\n  // Base Agent\n  BaseAgent,\n  createTask,\n  isAgentResult,\n  isAgentError,\n\n  // Specialized Agents\n  ResearcherAgent,\n  CoderAgent,\n  TesterAgent,\n  AnalystAgent,\n  ArchitectAgent,\n\n  // Rules Engine\n  RulesEngine,\n  createRulesEngine,\n  createRule,\n  createConditionalRule,\n  createFileChangeLogRule,\n  createGraphUpdateNotificationRule,\n  createAgentCompletionRule,\n} from './agents/index.js';\n\nexport type {\n  // Agent types\n  AgentConfig,\n  ResearcherAgentConfig,\n  CoderAgentConfig,\n  TesterAgentConfig,\n  AnalystAgentConfig,\n  ArchitectAgentConfig,\n  SpecializedAgentConfig,\n  TaskInput,\n  AgentTask,\n  AgentResult as AgentSystemResult,\n  AgentError,\n  ExecutionMetrics,\n  ResultArtifact,\n  AgentMessage,\n  TaskRequestMessage,\n  TaskResponseMessage,\n  StatusMessage,\n  ErrorMessage,\n  CoordinationMessage,\n  AgentMessageUnion,\n  AgentState,\n  AgentFactory,\n  AgentInstance,\n  AgentCapability,\n  AgentHealthCheck,\n  RegistryOptions,\n  SpawnOptions,\n\n  // Rules Engine types\n  RuleTrigger,\n  RulePriority,\n  RuleExecutionStatus,\n  RuleContext,\n  RuleCondition,\n  RuleAction,\n  AgentRule,\n  RuleExecutionLog,\n  RuleStatistics,\n  EngineStatistics,\n  RulesEngineConfig,\n} from './agents/index.js';\n\n// Cultivation exports\nexport {\n  SeedGenerator,\n  analyzeSeed,\n  initPrimitives,\n  DeepAnalyzer,\n  createDeepAnalyzer,\n  analyzeDeep,\n} from './cultivation/index.js';\n\nexport type {\n  VaultContext,\n  Ecosystem,\n  DependencyType,\n  ServiceType,\n  DependencyInfo,\n  ServiceInfo,\n  SeedAnalysis,\n  DocumentMetadata as CultivationDocumentMetadata,\n  GeneratedDocument as CultivationGeneratedDocument,\n  CultivationReport,\n  CultivationOptions,\n  GapAnalysis as CultivationGapAnalysis,\n  InitPrimitivesResult,\n  DeepAnalyzerOptions,\n  AgentResult,\n  DeepAnalysisResult,\n} from './cultivation/index.js';\n\n// SOP exports\nexport {\n  // Enums\n  SOPCategory,\n  ComplianceStatus,\n  SOPPriority,\n  IRBStatus,\n  GraphLayer,\n  // Registry\n  getSOPById,\n  getSOPsByCategory,\n  getSOPsRequiringIRB,\n  searchSOPs,\n  getAllSOPs,\n  getSopCount,\n  getCategories,\n  // Compliance\n  checkCompliance,\n  checkSOPCompliance,\n  meetsMinimumCompliance,\n  // Gap Analysis\n  analyzeGaps,\n  getGapsForSOP,\n  getQuickWins,\n  calculateProgress,\n  // Overlay Management\n  createMultiLayerGraph,\n  addProjectLayer,\n  addComplianceOverlay,\n  filterByLayer,\n  filterByComplianceStatus,\n  getComplianceSummary,\n  getGapNodes,\n  toggleLayerVisibility,\n  exportToVisualizationFormat,\n  createSOPFocusedSubgraph,\n} from './sops/index.js';\n\nexport type {\n  // SOP types\n  SOPRequirement,\n  SOPCheckpoint,\n  SOPDefinition,\n  SOPAssessment,\n  ComplianceGap,\n  LayerDefinition,\n  LayerNode,\n  LayerEdge,\n  MultiLayerGraph,\n  ComplianceReport,\n  SOPFrontmatter,\n  SOPConfig,\n  // Compliance types\n  ComplianceCheckOptions,\n  ComplianceCheckResult,\n  EvidenceItem,\n  // Gap types\n  GapAnalysisOptions,\n  GapAnalysisResult,\n  GapSummary,\n  RemediationRoadmap,\n  RemediationPhase,\n  GapDependency,\n  // Overlay types\n  OverlayManagerOptions,\n  NodeStyleConfig,\n} from './sops/index.js';\n\n// Workflows exports\nexport {\n  WorkflowStatus,\n  WorkflowRegistry,\n  createWorkflowRegistry,\n} from './workflows/index.js';\n\nexport type {\n  StepContext,\n  StepHandler,\n  RollbackHandler,\n  WorkflowStep,\n  WorkflowDefinition,\n  StepExecution,\n  WorkflowExecution,\n  WorkflowResult,\n  WorkflowExecutionStats,\n  WorkflowRegistryOptions,\n  WorkflowListOptions,\n  ExecutionHistoryOptions,\n  WorkflowEventType,\n  WorkflowEvent,\n  WorkflowEventListener,\n} from './workflows/index.js';\n\n// Memory exports\nexport {\n  VaultMemorySync,\n  createVaultMemorySync,\n} from './memory/index.js';\n\nexport type {\n  SyncDirection,\n  ConflictStrategy,\n  SyncStatus,\n  MemoryNode,\n  SyncConflict,\n  VaultSyncOptions,\n  SyncOperationResult,\n  FullSyncResult,\n} from './memory/index.js';\n\n// Utils exports\nexport {\n  // Error Taxonomy\n  ErrorCategory,\n  ErrorSeverity,\n  classifyError,\n  isRetryableError,\n  isTransientError,\n  isRateLimitError,\n  isPermanentError,\n  KnowledgeGraphError,\n  createValidationError,\n  createConfigurationError,\n  createResourceError,\n  // Error Recovery\n  withRetry,\n  retry,\n  withFallback,\n  withCircuitBreaker,\n  retryable,\n  calculateBackoff,\n  sleep,\n  CircuitBreaker,\n  CircuitState,\n  RetriesExhaustedError,\n  CircuitOpenError,\n  // Logger\n  Logger,\n  LogLevel,\n  getLogger,\n  createLogger,\n  setDefaultLogger,\n  parseLogLevel,\n  createProgressLogger,\n} from './utils/index.js';\n\nexport type {\n  ClassifiedError,\n  RetryOptions,\n  RetryResult,\n  FallbackOptions,\n  CircuitBreakerOptions,\n  LoggerOptions,\n  LogEntry,\n  ProgressLogger,\n} from './utils/index.js';\n\n// MCP Server exports\nexport {\n  KnowledgeGraphMCPServer,\n  createMCPServer,\n  runServer,\n  initializeTools,\n  registerTool,\n  getToolHandler,\n  getToolDefinition,\n  getToolDefinitions,\n  getToolCategories,\n  handleToolCall,\n  handleError,\n  createErrorResult,\n  createSuccessResult,\n} from './mcp-server/index.js';\n\nexport type {\n  MCPServerConfig,\n  ServerHealth,\n  ToolCategory,\n  ToolHandler,\n  ToolHandlerEntry,\n  ToolResult,\n  ToolContext,\n  ToolInputSchema,\n  ToolDefinition,\n  GraphQueryParams,\n  GraphNodeResult,\n  AgentInvokeParams,\n  AgentResult as MCPAgentResult,\n  WorkflowParams,\n  WorkflowResult as MCPWorkflowResult,\n  MemoryParams,\n  MemoryResult,\n} from './mcp-server/index.js';\n\n// Services exports\nexport {\n  ServiceManager,\n  createServiceManager,\n  FileWatcherService,\n} from './services/index.js';\n\nexport type {\n  ServiceStatus,\n  ServiceType as ManagerServiceType,\n  ServiceConfig,\n  ServiceState,\n  ServiceMetrics,\n  ServiceHandler,\n} from './services/index.js';\n\n// Config exports\nexport {\n  ConfigManager,\n  createConfigManager,\n  getDefaultConfig,\n} from './config/index.js';\n\nexport type {\n  KGConfiguration,\n  DatabaseConfig,\n  CacheConfig,\n  AgentConfig as ConfigAgentConfig,\n  ServicesConfig,\n  LoggingConfig,\n  ConfigMigration,\n} from './config/index.js';\n\n// Health exports\nexport {\n  HealthMonitor,\n  createHealthMonitor,\n  createDatabaseCheck,\n  createCacheCheck,\n  createMemoryCheck,\n  createDiskCheck,\n} from './health/index.js';\n\nexport type {\n  HealthStatus,\n  ComponentHealth,\n  SystemHealth,\n  MemoryMetrics,\n  PerformanceMetrics,\n  HealthCheck,\n  HealthMonitorConfig,\n} from './health/index.js';\n\n// Chunking exports\nexport {\n  Chunker,\n  createChunker,\n  chunkDocument,\n} from './chunking/index.js';\n\nexport type {\n  ChunkStrategy,\n  ChunkOptions,\n  Chunk,\n  ChunkMetadata,\n  ChunkResult,\n} from './chunking/index.js';\n\n// Recovery exports\nexport {\n  BackupManager,\n  createBackupManager,\n  IntegrityChecker,\n  createIntegrityChecker,\n  checkDatabaseIntegrity,\n} from './recovery/index.js';\n\nexport type {\n  BackupConfig,\n  BackupInfo,\n  RestoreResult,\n  RecoveryOptions,\n  IntegrityCheckResult,\n  TableIntegrity,\n} from './recovery/index.js';\n\n// Advanced Caching exports\nexport {\n  AdvancedCache,\n  createAdvancedCache,\n} from './caching/index.js';\n\nexport type {\n  EvictionPolicy,\n  CacheEntry,\n  CacheConfig as AdvancedCacheConfig,\n  CacheStats as AdvancedCacheStats,\n} from './caching/index.js';\n\n// Reasoning exports\nexport {\n  DecisionTracker,\n  createDecisionTracker,\n  getDecisionTracker,\n} from './reasoning/index.js';\n\nexport type {\n  DecisionType,\n  ConfidenceLevel,\n  Decision,\n  DecisionContext,\n  Alternative,\n  DecisionOutcome,\n  ReasoningChain,\n} from './reasoning/index.js';\n\n/**\n * Quick start function for programmatic usage\n *\n * @example\n * ```typescript\n * import { quickInit } from '@weave-nn/knowledge-graph-agent';\n *\n * await quickInit({\n *   projectRoot: '/path/to/project',\n *   docsPath: 'docs',\n * });\n * ```\n */\nexport async function quickInit(options: {\n  projectRoot: string;\n  docsPath?: string;\n  generateGraph?: boolean;\n  updateClaudeMd?: boolean;\n}): Promise<{\n  success: boolean;\n  docsCreated: boolean;\n  graphGenerated: boolean;\n  claudeMdUpdated: boolean;\n  errors: string[];\n}> {\n  const {\n    projectRoot,\n    docsPath = 'docs',\n    generateGraph: genGraph = true,\n    updateClaudeMd: updateClaude = true,\n  } = options;\n\n  const result = {\n    success: true,\n    docsCreated: false,\n    graphGenerated: false,\n    claudeMdUpdated: false,\n    errors: [] as string[],\n  };\n\n  try {\n    // Initialize docs if needed\n    const { existsSync, mkdirSync, writeFileSync } = await import('fs');\n    const { join } = await import('path');\n\n    // Create .kg directory\n    const kgDir = join(projectRoot, '.kg');\n    if (!existsSync(kgDir)) {\n      mkdirSync(kgDir, { recursive: true });\n    }\n\n    // Initialize database\n    const dbPath = join(kgDir, 'knowledge.db');\n    const db = _createDatabase(dbPath);\n    db.setMetadata('initialized', new Date().toISOString());\n\n    // Initialize docs\n    if (!_docsExist(projectRoot, docsPath)) {\n      const docsResult = await _initDocs({\n        projectRoot,\n        docsPath,\n        includeExamples: true,\n        detectFramework: true,\n      });\n      result.docsCreated = docsResult.success;\n      if (!docsResult.success) {\n        result.errors.push(...docsResult.errors);\n      }\n    }\n\n    // Generate graph\n    if (genGraph && _docsExist(projectRoot, docsPath)) {\n      const graphResult = await _generateAndSave(\n        {\n          projectRoot,\n          outputPath: join(projectRoot, docsPath),\n        },\n        dbPath\n      );\n      result.graphGenerated = graphResult.success;\n      if (!graphResult.success) {\n        result.errors.push(...graphResult.stats.errors);\n      }\n    }\n\n    // Update CLAUDE.md\n    if (updateClaude) {\n      const claudeResult = await _updateClaudeMd({\n        projectRoot,\n        includeKnowledgeGraph: true,\n        includeClaudeFlow: true,\n      });\n      result.claudeMdUpdated = claudeResult.created || claudeResult.updated;\n    }\n\n    db.close();\n    result.success = result.errors.length === 0;\n\n  } catch (error) {\n    result.success = false;\n    result.errors.push(String(error));\n  }\n\n  return result;\n}\n"],"names":["_createDatabase","_docsExist","_initDocs","_generateAndSave","_updateClaudeMd"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwjBA,eAAsB,UAAU,SAW7B;AACD,QAAM;AAAA,IACJ;AAAA,IACA,WAAW;AAAA,IACX,eAAe,WAAW;AAAA,IAC1B,gBAAgB,eAAe;AAAA,EAAA,IAC7B;AAEJ,QAAM,SAAS;AAAA,IACb,SAAS;AAAA,IACT,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,IACjB,QAAQ,CAAA;AAAA,EAAC;AAGX,MAAI;AAEF,UAAM,EAAE,YAAY,WAAW,kBAAkB,MAAM,OAAO,IAAI;AAClE,UAAM,EAAE,KAAA,IAAS,MAAM,OAAO,MAAM;AAGpC,UAAM,QAAQ,KAAK,aAAa,KAAK;AACrC,QAAI,CAAC,WAAW,KAAK,GAAG;AACtB,gBAAU,OAAO,EAAE,WAAW,KAAA,CAAM;AAAA,IACtC;AAGA,UAAM,SAAS,KAAK,OAAO,cAAc;AACzC,UAAM,KAAKA,eAAgB,MAAM;AACjC,OAAG,YAAY,gBAAe,oBAAI,KAAA,GAAO,aAAa;AAGtD,QAAI,CAACC,UAAW,aAAa,QAAQ,GAAG;AACtC,YAAM,aAAa,MAAMC,SAAU;AAAA,QACjC;AAAA,QACA;AAAA,QACA,iBAAiB;AAAA,QACjB,iBAAiB;AAAA,MAAA,CAClB;AACD,aAAO,cAAc,WAAW;AAChC,UAAI,CAAC,WAAW,SAAS;AACvB,eAAO,OAAO,KAAK,GAAG,WAAW,MAAM;AAAA,MACzC;AAAA,IACF;AAGA,QAAI,YAAYD,UAAW,aAAa,QAAQ,GAAG;AACjD,YAAM,cAAc,MAAME;AAAAA,QACxB;AAAA,UACE;AAAA,UACA,YAAY,KAAK,aAAa,QAAQ;AAAA,QAAA;AAAA,QAExC;AAAA,MAAA;AAEF,aAAO,iBAAiB,YAAY;AACpC,UAAI,CAAC,YAAY,SAAS;AACxB,eAAO,OAAO,KAAK,GAAG,YAAY,MAAM,MAAM;AAAA,MAChD;AAAA,IACF;AAGA,QAAI,cAAc;AAChB,YAAM,eAAe,MAAMC,eAAgB;AAAA,QACzC;AAAA,QACA,uBAAuB;AAAA,QACvB,mBAAmB;AAAA,MAAA,CACpB;AACD,aAAO,kBAAkB,aAAa,WAAW,aAAa;AAAA,IAChE;AAEA,OAAG,MAAA;AACH,WAAO,UAAU,OAAO,OAAO,WAAW;AAAA,EAE5C,SAAS,OAAO;AACd,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA,EAClC;AAEA,SAAO;AACT;"}