@weavelogic/knowledge-graph-agent 0.3.0 → 0.6.0

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

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

package/dist/plugins/types.js

@@ -0,0 +1,43 @@
+function isAnalyzerPlugin(plugin) {
+  return plugin.type === "analyzer" && "analyze" in plugin && typeof plugin.analyze === "function" && "supportedContentTypes" in plugin && Array.isArray(plugin.supportedContentTypes);
+}
+function isPluginManifest(obj) {
+  if (typeof obj !== "object" || obj === null) {
+    return false;
+  }
+  const manifest = obj;
+  return typeof manifest.name === "string" && typeof manifest.version === "string" && typeof manifest["kg-plugin"] === "object" && manifest["kg-plugin"] !== null && typeof manifest["kg-plugin"].type === "string" && typeof manifest["kg-plugin"].main === "string";
+}
+function isAnalysisResult(obj) {
+  if (typeof obj !== "object" || obj === null) {
+    return false;
+  }
+  const result = obj;
+  return typeof result.success === "boolean" && typeof result.analysisType === "string";
+}
+function createPluginId(name) {
+  return `plugin_${name}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+function isValidSemver(version) {
+  const semverRegex = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+  return semverRegex.test(version);
+}
+function createDefaultPluginMetadata(name, version, type) {
+  return {
+    name,
+    version,
+    type,
+    status: "unloaded",
+    hooks: [],
+    capabilities: []
+  };
+}
+export {
+  createDefaultPluginMetadata,
+  createPluginId,
+  isAnalysisResult,
+  isAnalyzerPlugin,
+  isPluginManifest,
+  isValidSemver
+};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../src/plugins/types.ts"],"sourcesContent":["/**\n * Plugin System Types\n *\n * Complete type definitions for the knowledge-graph-agent plugin system.\n * Supports plugin discovery, loading, lifecycle management, and custom analyzers.\n *\n * @module plugins/types\n */\n\nimport type { EventEmitter } from 'events';\nimport type { KnowledgeGraphManager } from '../core/graph.js';\nimport type { KGConfiguration } from '../config/types.js';\nimport type { Logger } from '../utils/logger.js';\n\n// ============================================================================\n// Plugin Manifest Types (package.json extension)\n// ============================================================================\n\n/**\n * Plugin type classification\n */\nexport type PluginType =\n  | 'analyzer'     // Custom content analyzers\n  | 'transformer'  // Content transformation plugins\n  | 'exporter'     // Export format plugins\n  | 'importer'     // Import format plugins\n  | 'integration'  // External service integrations\n  | 'visualization' // Graph visualization plugins\n  | 'storage'      // Custom storage backends\n  | 'agent'        // Custom agent types\n  | 'hook'         // Lifecycle hook plugins\n  | 'generic';     // General purpose plugins\n\n/**\n * Plugin lifecycle hook names\n */\nexport type PluginHook =\n  | 'onGraphLoad'\n  | 'onGraphSave'\n  | 'onNodeAdd'\n  | 'onNodeUpdate'\n  | 'onNodeRemove'\n  | 'onEdgeAdd'\n  | 'onEdgeRemove'\n  | 'onAnalysisStart'\n  | 'onAnalysisComplete'\n  | 'onAgentTaskStart'\n  | 'onAgentTaskComplete'\n  | 'onFileChange'\n  | 'onShutdown';\n\n/**\n * Plugin capability declaration\n */\nexport interface PluginCapability {\n  /** Capability identifier */\n  name: string;\n\n  /** Human-readable description */\n  description?: string;\n\n  /** Capability version */\n  version?: string;\n\n  /** Whether this capability is optional */\n  optional?: boolean;\n}\n\n/**\n * Plugin dependency specification\n */\nexport interface PluginDependency {\n  /** Plugin package name */\n  name: string;\n\n  /** Semver version range */\n  version: string;\n\n  /** Whether the dependency is optional */\n  optional?: boolean;\n}\n\n/**\n * Plugin configuration schema definition\n */\nexport interface PluginConfigSchema {\n  /** Schema type (JSON Schema compatible) */\n  type: 'object' | 'array' | 'string' | 'number' | 'boolean';\n\n  /** Schema properties for object types */\n  properties?: Record<string, {\n    type: string;\n    description?: string;\n    default?: unknown;\n    required?: boolean;\n    enum?: unknown[];\n  }>;\n\n  /** Required property names */\n  required?: string[];\n\n  /** Default configuration values */\n  defaults?: Record<string, unknown>;\n}\n\n/**\n * Plugin manifest - extends package.json with kg-plugin field\n *\n * @example\n * ```json\n * {\n *   \"name\": \"@kg-plugins/markdown-analyzer\",\n *   \"version\": \"1.0.0\",\n *   \"description\": \"Advanced markdown analysis for knowledge graphs\",\n *   \"kg-plugin\": {\n *     \"type\": \"analyzer\",\n *     \"main\": \"./dist/index.js\",\n *     \"hooks\": [\"onNodeAdd\", \"onAnalysisComplete\"],\n *     \"capabilities\": [\n *       { \"name\": \"markdown-parsing\", \"description\": \"Parse markdown content\" }\n *     ],\n *     \"configSchema\": {\n *       \"type\": \"object\",\n *       \"properties\": {\n *         \"enableGFM\": { \"type\": \"boolean\", \"default\": true }\n *       }\n *     }\n *   }\n * }\n * ```\n */\nexport interface KGPluginManifest {\n  /** Plugin package name (from package.json) */\n  name: string;\n\n  /** Plugin version (semver) */\n  version: string;\n\n  /** Plugin description */\n  description?: string;\n\n  /** Plugin author */\n  author?: string | { name: string; email?: string; url?: string };\n\n  /** Plugin license */\n  license?: string;\n\n  /** Plugin repository */\n  repository?: string | { type: string; url: string };\n\n  /** Plugin keywords for discovery */\n  keywords?: string[];\n\n  /** Knowledge graph plugin configuration */\n  'kg-plugin': {\n    /** Plugin type classification */\n    type: PluginType;\n\n    /** Path to main entry point (relative to package root) */\n    main: string;\n\n    /** Plugin display name */\n    displayName?: string;\n\n    /** Minimum knowledge-graph-agent version required */\n    minVersion?: string;\n\n    /** Maximum knowledge-graph-agent version supported */\n    maxVersion?: string;\n\n    /** Lifecycle hooks this plugin subscribes to */\n    hooks?: PluginHook[];\n\n    /** Plugin capabilities */\n    capabilities?: PluginCapability[];\n\n    /** Plugin dependencies on other plugins */\n    pluginDependencies?: PluginDependency[];\n\n    /** Configuration schema */\n    configSchema?: PluginConfigSchema;\n\n    /** Whether the plugin supports hot reload */\n    hotReload?: boolean;\n\n    /** Priority for hook execution (lower = earlier, default: 100) */\n    priority?: number;\n\n    /** Tags for categorization */\n    tags?: string[];\n  };\n\n  /** Standard package.json fields */\n  main?: string;\n  types?: string;\n  exports?: Record<string, unknown>;\n  dependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n}\n\n// ============================================================================\n// Plugin Context Types\n// ============================================================================\n\n/**\n * Database interface for plugin context\n */\nexport interface KnowledgeGraphDatabase {\n  /** Execute a query and return results */\n  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n\n  /** Execute a query and return first result */\n  queryOne<T = unknown>(sql: string, params?: unknown[]): Promise<T | null>;\n\n  /** Execute a mutation (insert, update, delete) */\n  execute(sql: string, params?: unknown[]): Promise<{ changes: number; lastInsertRowid?: number | bigint }>;\n\n  /** Begin a transaction */\n  beginTransaction(): Promise<void>;\n\n  /** Commit a transaction */\n  commit(): Promise<void>;\n\n  /** Rollback a transaction */\n  rollback(): Promise<void>;\n\n  /** Check if the database is connected */\n  isConnected(): boolean;\n}\n\n/**\n * Shadow cache interface for plugin context\n */\nexport interface ShadowCache {\n  /** Get a cached value */\n  get<T>(key: string): Promise<T | undefined>;\n\n  /** Set a cached value */\n  set<T>(key: string, value: T, options?: { ttl?: number; tags?: string[] }): Promise<void>;\n\n  /** Delete a cached value */\n  delete(key: string): Promise<boolean>;\n\n  /** Delete all values with a specific tag */\n  deleteByTag(tag: string): Promise<number>;\n\n  /** Clear all cached values */\n  clear(): Promise<void>;\n\n  /** Check if a key exists */\n  has(key: string): Promise<boolean>;\n\n  /** Get cache statistics */\n  getStats(): Promise<{\n    entries: number;\n    size: number;\n    hits: number;\n    misses: number;\n    hitRate: number;\n  }>;\n}\n\n/**\n * Plugin event emitter for inter-plugin communication\n */\nexport interface PluginEventEmitter extends EventEmitter {\n  /** Emit an event to all registered listeners */\n  emit(event: string, ...args: unknown[]): boolean;\n\n  /** Subscribe to an event */\n  on(event: string, listener: (...args: unknown[]) => void): this;\n\n  /** Subscribe to an event once */\n  once(event: string, listener: (...args: unknown[]) => void): this;\n\n  /** Unsubscribe from an event */\n  off(event: string, listener: (...args: unknown[]) => void): this;\n\n  /** Get all registered event names */\n  eventNames(): (string | symbol)[];\n}\n\n/**\n * Plugin API for interacting with the knowledge graph system\n */\nexport interface PluginAPI {\n  /** Get plugin by name */\n  getPlugin<T extends KGPlugin = KGPlugin>(name: string): T | undefined;\n\n  /** Get all plugins of a specific type */\n  getPluginsByType(type: PluginType): KGPlugin[];\n\n  /** Get all analyzer plugins */\n  getAnalyzers(): AnalyzerPlugin[];\n\n  /** Register a custom command */\n  registerCommand(command: PluginCommand): void;\n\n  /** Unregister a custom command */\n  unregisterCommand(name: string): void;\n\n  /** Get the current knowledge graph agent version */\n  getVersion(): string;\n\n  /** Check if a capability is available */\n  hasCapability(name: string): boolean;\n}\n\n/**\n * Plugin command registration\n */\nexport interface PluginCommand {\n  /** Command name (used in CLI) */\n  name: string;\n\n  /** Command description */\n  description: string;\n\n  /** Command aliases */\n  aliases?: string[];\n\n  /** Command options */\n  options?: Array<{\n    name: string;\n    description: string;\n    type: 'string' | 'number' | 'boolean';\n    required?: boolean;\n    default?: unknown;\n  }>;\n\n  /** Command handler */\n  handler: (args: Record<string, unknown>, context: PluginContext) => Promise<void>;\n}\n\n/**\n * Plugin context provided during initialization and execution\n */\nexport interface PluginContext {\n  /** Database instance for persistent storage */\n  database: KnowledgeGraphDatabase;\n\n  /** Knowledge graph manager instance */\n  graph: KnowledgeGraphManager;\n\n  /** Shadow cache for temporary storage */\n  cache: ShadowCache;\n\n  /** Logger instance scoped to the plugin */\n  logger: Logger;\n\n  /** Current configuration */\n  config: KGConfiguration;\n\n  /** Plugin configuration (from user config or defaults) */\n  pluginConfig: Record<string, unknown>;\n\n  /** Event emitter for plugin communication */\n  events: PluginEventEmitter;\n\n  /** Plugin API for system interaction */\n  api: PluginAPI;\n\n  /** Root path of the project */\n  projectRoot: string;\n\n  /** Path to the plugin's package directory */\n  pluginRoot: string;\n\n  /** Abort signal for graceful shutdown */\n  abortSignal?: AbortSignal;\n}\n\n// ============================================================================\n// Base Plugin Interface\n// ============================================================================\n\n/**\n * Plugin status\n */\nexport type PluginStatus =\n  | 'unloaded'\n  | 'loading'\n  | 'initialized'\n  | 'active'\n  | 'error'\n  | 'disabled';\n\n/**\n * Plugin metadata at runtime\n */\nexport interface PluginMetadata {\n  /** Plugin name */\n  name: string;\n\n  /** Plugin version */\n  version: string;\n\n  /** Plugin type */\n  type: PluginType;\n\n  /** Plugin status */\n  status: PluginStatus;\n\n  /** Load time in milliseconds */\n  loadTime?: number;\n\n  /** Initialize time in milliseconds */\n  initTime?: number;\n\n  /** Last error if status is 'error' */\n  lastError?: string;\n\n  /** Registered hooks */\n  hooks: PluginHook[];\n\n  /** Available capabilities */\n  capabilities: string[];\n}\n\n/**\n * Base plugin interface that all plugins must implement\n */\nexport interface KGPlugin {\n  /** Plugin name (must match manifest) */\n  readonly name: string;\n\n  /** Plugin version (must match manifest) */\n  readonly version: string;\n\n  /** Plugin type */\n  readonly type: PluginType;\n\n  /**\n   * Initialize the plugin\n   *\n   * Called once when the plugin is loaded. Use this to set up resources,\n   * register event listeners, and validate configuration.\n   *\n   * @param context - Plugin context with system access\n   * @throws Error if initialization fails\n   */\n  initialize(context: PluginContext): Promise<void>;\n\n  /**\n   * Destroy the plugin (optional)\n   *\n   * Called when the plugin is being unloaded. Use this to clean up resources,\n   * close connections, and remove event listeners.\n   */\n  destroy?(): Promise<void>;\n\n  /**\n   * Get plugin health status (optional)\n   *\n   * @returns Health status information\n   */\n  healthCheck?(): Promise<{\n    healthy: boolean;\n    message?: string;\n    details?: Record<string, unknown>;\n  }>;\n\n  /**\n   * Get plugin statistics (optional)\n   *\n   * @returns Plugin-specific statistics\n   */\n  getStats?(): Promise<Record<string, unknown>>;\n\n  // ========================================================================\n  // Lifecycle Hooks (optional)\n  // ========================================================================\n\n  /** Called when the knowledge graph is loaded */\n  onGraphLoad?(graph: KnowledgeGraphManager): Promise<void>;\n\n  /** Called before the knowledge graph is saved */\n  onGraphSave?(graph: KnowledgeGraphManager): Promise<void>;\n\n  /** Called when a node is added to the graph */\n  onNodeAdd?(nodeId: string, nodeData: unknown): Promise<void>;\n\n  /** Called when a node is updated */\n  onNodeUpdate?(nodeId: string, changes: unknown): Promise<void>;\n\n  /** Called when a node is removed */\n  onNodeRemove?(nodeId: string): Promise<void>;\n\n  /** Called when an edge is added */\n  onEdgeAdd?(sourceId: string, targetId: string, edgeData: unknown): Promise<void>;\n\n  /** Called when an edge is removed */\n  onEdgeRemove?(sourceId: string, targetId: string): Promise<void>;\n\n  /** Called when analysis starts */\n  onAnalysisStart?(analysisType: string): Promise<void>;\n\n  /** Called when analysis completes */\n  onAnalysisComplete?(analysisType: string, results: unknown): Promise<void>;\n\n  /** Called when an agent task starts */\n  onAgentTaskStart?(agentId: string, taskId: string, taskData: unknown): Promise<void>;\n\n  /** Called when an agent task completes */\n  onAgentTaskComplete?(agentId: string, taskId: string, result: unknown): Promise<void>;\n\n  /** Called when a file changes */\n  onFileChange?(filePath: string, changeType: 'add' | 'change' | 'unlink'): Promise<void>;\n\n  /** Called during shutdown */\n  onShutdown?(): Promise<void>;\n}\n\n// ============================================================================\n// Analyzer Plugin Interface\n// ============================================================================\n\n/**\n * Analysis input data\n */\nexport interface AnalysisInput {\n  /** Unique identifier for this analysis */\n  id: string;\n\n  /** Content to analyze */\n  content: string;\n\n  /** Content type (e.g., 'markdown', 'typescript', 'json') */\n  contentType: string;\n\n  /** Source file path (if applicable) */\n  filePath?: string;\n\n  /** Related node IDs for context */\n  relatedNodes?: string[];\n\n  /** Additional metadata */\n  metadata?: Record<string, unknown>;\n\n  /** Analysis options */\n  options?: Record<string, unknown>;\n}\n\n/**\n * Analysis result structure\n */\nexport interface AnalysisResult {\n  /** Whether analysis was successful */\n  success: boolean;\n\n  /** Analysis type identifier */\n  analysisType: string;\n\n  /** Extracted entities */\n  entities?: Array<{\n    id: string;\n    type: string;\n    value: string;\n    confidence: number;\n    position?: { start: number; end: number };\n    metadata?: Record<string, unknown>;\n  }>;\n\n  /** Extracted relationships */\n  relationships?: Array<{\n    sourceId: string;\n    targetId: string;\n    type: string;\n    confidence: number;\n    metadata?: Record<string, unknown>;\n  }>;\n\n  /** Extracted tags/keywords */\n  tags?: Array<{\n    value: string;\n    confidence: number;\n    category?: string;\n  }>;\n\n  /** Content summary */\n  summary?: string;\n\n  /** Quality score (0-1) */\n  qualityScore?: number;\n\n  /** Analysis metrics */\n  metrics?: {\n    durationMs: number;\n    tokensProcessed?: number;\n    entitiesFound?: number;\n    relationshipsFound?: number;\n  };\n\n  /** Suggestions for improvement */\n  suggestions?: Array<{\n    type: 'add_link' | 'add_tag' | 'fix_format' | 'add_content' | 'other';\n    message: string;\n    confidence: number;\n    action?: Record<string, unknown>;\n  }>;\n\n  /** Raw analysis data for debugging */\n  raw?: unknown;\n\n  /** Error information if analysis failed */\n  error?: {\n    code: string;\n    message: string;\n    details?: Record<string, unknown>;\n  };\n}\n\n/**\n * Stream chunk for streaming analysis\n */\nexport interface AnalysisStreamChunk {\n  /** Chunk type */\n  type: 'entity' | 'relationship' | 'tag' | 'progress' | 'error' | 'complete';\n\n  /** Chunk data */\n  data: unknown;\n\n  /** Progress percentage (0-100) for progress chunks */\n  progress?: number;\n\n  /** Timestamp */\n  timestamp: Date;\n}\n\n/**\n * Analyzer plugin interface for custom content analysis\n */\nexport interface AnalyzerPlugin extends KGPlugin {\n  readonly type: 'analyzer';\n\n  /**\n   * Supported content types for this analyzer\n   */\n  readonly supportedContentTypes: string[];\n\n  /**\n   * Analyze content and return structured results\n   *\n   * @param input - Analysis input data\n   * @returns Analysis results\n   */\n  analyze(input: AnalysisInput): Promise<AnalysisResult>;\n\n  /**\n   * Stream analysis results (optional)\n   *\n   * For large content, streaming provides incremental results.\n   *\n   * @param input - Analysis input data\n   * @returns Async iterable of analysis chunks\n   */\n  analyzeStream?(input: AnalysisInput): AsyncIterable<AnalysisStreamChunk>;\n\n  /**\n   * Check if this analyzer can handle the given content\n   *\n   * @param contentType - Content type to check\n   * @returns Whether this analyzer supports the content type\n   */\n  canAnalyze(contentType: string): boolean;\n\n  /**\n   * Get analyzer-specific configuration options\n   *\n   * @returns Configuration options with descriptions\n   */\n  getConfigOptions?(): Record<string, {\n    type: 'string' | 'number' | 'boolean' | 'array' | 'object';\n    description: string;\n    default?: unknown;\n    required?: boolean;\n  }>;\n}\n\n// ============================================================================\n// Plugin Loader Interface\n// ============================================================================\n\n/**\n * Plugin discovery result\n */\nexport interface DiscoveredPlugin {\n  /** Plugin manifest */\n  manifest: KGPluginManifest;\n\n  /** Absolute path to the plugin package */\n  path: string;\n\n  /** Whether the plugin is locally installed */\n  isLocal: boolean;\n\n  /** Whether the plugin is valid */\n  valid: boolean;\n\n  /** Validation errors if not valid */\n  errors?: string[];\n}\n\n/**\n * Plugin load options\n */\nexport interface PluginLoadOptions {\n  /** Plugin configuration to pass */\n  config?: Record<string, unknown>;\n\n  /** Force reload even if already loaded */\n  force?: boolean;\n\n  /** Validate plugin before loading */\n  validate?: boolean;\n\n  /** Timeout for initialization in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Plugin load result\n */\nexport interface PluginLoadResult {\n  /** Whether loading was successful */\n  success: boolean;\n\n  /** Loaded plugin instance (if successful) */\n  plugin?: KGPlugin;\n\n  /** Plugin metadata */\n  metadata?: PluginMetadata;\n\n  /** Error message (if failed) */\n  error?: string;\n\n  /** Load duration in milliseconds */\n  loadTime: number;\n}\n\n/**\n * Plugin loader interface for discovering and loading plugins\n */\nexport interface PluginLoader {\n  /**\n   * Discover available plugins\n   *\n   * Searches configured paths for valid plugin packages.\n   *\n   * @returns Array of discovered plugin manifests\n   */\n  discover(): Promise<DiscoveredPlugin[]>;\n\n  /**\n   * Load a plugin by name\n   *\n   * @param name - Plugin package name\n   * @param options - Load options\n   * @returns Load result\n   */\n  load(name: string, options?: PluginLoadOptions): Promise<PluginLoadResult>;\n\n  /**\n   * Load a plugin from a specific path\n   *\n   * @param path - Absolute path to plugin package\n   * @param options - Load options\n   * @returns Load result\n   */\n  loadFromPath(path: string, options?: PluginLoadOptions): Promise<PluginLoadResult>;\n\n  /**\n   * Unload a plugin by name\n   *\n   * @param name - Plugin package name\n   * @returns Whether unload was successful\n   */\n  unload(name: string): Promise<boolean>;\n\n  /**\n   * Reload a plugin\n   *\n   * @param name - Plugin package name\n   * @returns Load result\n   */\n  reload(name: string): Promise<PluginLoadResult>;\n\n  /**\n   * Get a loaded plugin by name\n   *\n   * @param name - Plugin package name\n   * @returns Plugin instance or undefined\n   */\n  get(name: string): KGPlugin | undefined;\n\n  /**\n   * Check if a plugin is loaded\n   *\n   * @param name - Plugin package name\n   * @returns Whether the plugin is loaded\n   */\n  isLoaded(name: string): boolean;\n\n  /**\n   * Get all loaded plugins\n   *\n   * @returns Array of loaded plugin instances\n   */\n  getAll(): KGPlugin[];\n\n  /**\n   * Validate a plugin manifest\n   *\n   * @param manifest - Plugin manifest to validate\n   * @returns Validation result\n   */\n  validateManifest(manifest: KGPluginManifest): {\n    valid: boolean;\n    errors: string[];\n    warnings: string[];\n  };\n\n  /**\n   * Set plugin search paths\n   *\n   * @param paths - Array of paths to search for plugins\n   */\n  setSearchPaths(paths: string[]): void;\n\n  /**\n   * Get current plugin search paths\n   *\n   * @returns Array of search paths\n   */\n  getSearchPaths(): string[];\n}\n\n// ============================================================================\n// Plugin Registry Interface\n// ============================================================================\n\n/**\n * Plugin registry events\n */\nexport interface PluginRegistryEvents {\n  /** Emitted when a plugin is registered */\n  registered: { plugin: KGPlugin; metadata: PluginMetadata };\n\n  /** Emitted when a plugin is unregistered */\n  unregistered: { name: string };\n\n  /** Emitted when a plugin is enabled */\n  enabled: { name: string };\n\n  /** Emitted when a plugin is disabled */\n  disabled: { name: string };\n\n  /** Emitted when a plugin encounters an error */\n  error: { name: string; error: Error };\n\n  /** Emitted when a hook is executed */\n  hookExecuted: { hook: PluginHook; plugins: string[]; duration: number };\n}\n\n/**\n * Plugin registry for managing loaded plugins\n */\nexport interface PluginRegistry {\n  /**\n   * Register a plugin\n   *\n   * @param plugin - Plugin instance to register\n   * @param manifest - Plugin manifest\n   */\n  register(plugin: KGPlugin, manifest: KGPluginManifest): void;\n\n  /**\n   * Unregister a plugin\n   *\n   * @param name - Plugin name to unregister\n   * @returns Whether the plugin was found and unregistered\n   */\n  unregister(name: string): boolean;\n\n  /**\n   * Get a plugin by name\n   *\n   * @param name - Plugin name\n   * @returns Plugin instance or undefined\n   */\n  get<T extends KGPlugin = KGPlugin>(name: string): T | undefined;\n\n  /**\n   * Get all registered plugins\n   *\n   * @returns Array of all registered plugins\n   */\n  getAll(): KGPlugin[];\n\n  /**\n   * Get plugins by type\n   *\n   * @param type - Plugin type to filter\n   * @returns Array of plugins of the specified type\n   */\n  getByType<T extends KGPlugin = KGPlugin>(type: PluginType): T[];\n\n  /**\n   * Get all analyzer plugins\n   *\n   * @returns Array of analyzer plugins\n   */\n  getAnalyzers(): AnalyzerPlugin[];\n\n  /**\n   * Check if a plugin is registered\n   *\n   * @param name - Plugin name\n   * @returns Whether the plugin is registered\n   */\n  has(name: string): boolean;\n\n  /**\n   * Get plugin metadata\n   *\n   * @param name - Plugin name\n   * @returns Plugin metadata or undefined\n   */\n  getMetadata(name: string): PluginMetadata | undefined;\n\n  /**\n   * Enable a plugin\n   *\n   * @param name - Plugin name\n   * @returns Whether the plugin was enabled\n   */\n  enable(name: string): Promise<boolean>;\n\n  /**\n   * Disable a plugin\n   *\n   * @param name - Plugin name\n   * @returns Whether the plugin was disabled\n   */\n  disable(name: string): Promise<boolean>;\n\n  /**\n   * Execute a lifecycle hook on all applicable plugins\n   *\n   * @param hook - Hook name to execute\n   * @param args - Arguments to pass to the hook\n   * @returns Results from each plugin\n   */\n  executeHook<T = void>(\n    hook: PluginHook,\n    ...args: unknown[]\n  ): Promise<Map<string, T | Error>>;\n\n  /**\n   * Get plugins that subscribe to a specific hook\n   *\n   * @param hook - Hook name\n   * @returns Array of plugin names\n   */\n  getHookSubscribers(hook: PluginHook): string[];\n\n  /**\n   * Get registry statistics\n   *\n   * @returns Registry statistics\n   */\n  getStats(): {\n    totalPlugins: number;\n    activePlugins: number;\n    disabledPlugins: number;\n    errorPlugins: number;\n    pluginsByType: Record<PluginType, number>;\n    hookSubscriptions: Record<PluginHook, number>;\n  };\n\n  /**\n   * Subscribe to registry events\n   *\n   * @param event - Event name\n   * @param listener - Event listener\n   */\n  on<K extends keyof PluginRegistryEvents>(\n    event: K,\n    listener: (data: PluginRegistryEvents[K]) => void\n  ): void;\n\n  /**\n   * Unsubscribe from registry events\n   *\n   * @param event - Event name\n   * @param listener - Event listener\n   */\n  off<K extends keyof PluginRegistryEvents>(\n    event: K,\n    listener: (data: PluginRegistryEvents[K]) => void\n  ): void;\n\n  /**\n   * Clear all registered plugins\n   */\n  clear(): Promise<void>;\n}\n\n// ============================================================================\n// Plugin Manager Interface\n// ============================================================================\n\n/**\n * Plugin manager configuration\n */\nexport interface PluginManagerConfig {\n  /** Paths to search for plugins */\n  searchPaths: string[];\n\n  /** Plugins to auto-load on initialization */\n  autoLoad?: string[];\n\n  /** Whether to enable hot reload */\n  hotReload?: boolean;\n\n  /** Default plugin configuration */\n  defaultConfig?: Record<string, Record<string, unknown>>;\n\n  /** Logger instance */\n  logger?: Logger;\n\n  /** Maximum plugin load concurrency */\n  maxConcurrency?: number;\n\n  /** Plugin load timeout in milliseconds */\n  loadTimeout?: number;\n}\n\n/**\n * Plugin manager for high-level plugin operations\n */\nexport interface PluginManager {\n  /** Plugin loader instance */\n  readonly loader: PluginLoader;\n\n  /** Plugin registry instance */\n  readonly registry: PluginRegistry;\n\n  /**\n   * Initialize the plugin manager\n   *\n   * Discovers and loads configured plugins.\n   */\n  initialize(): Promise<void>;\n\n  /**\n   * Install a plugin from npm or local path\n   *\n   * @param source - npm package name or local path\n   * @returns Installation result\n   */\n  install(source: string): Promise<{\n    success: boolean;\n    name?: string;\n    version?: string;\n    error?: string;\n  }>;\n\n  /**\n   * Uninstall a plugin\n   *\n   * @param name - Plugin name to uninstall\n   * @returns Whether uninstallation was successful\n   */\n  uninstall(name: string): Promise<boolean>;\n\n  /**\n   * Update a plugin to the latest version\n   *\n   * @param name - Plugin name to update\n   * @returns Update result\n   */\n  update(name: string): Promise<{\n    success: boolean;\n    previousVersion?: string;\n    newVersion?: string;\n    error?: string;\n  }>;\n\n  /**\n   * Check for plugin updates\n   *\n   * @returns Available updates\n   */\n  checkUpdates(): Promise<Array<{\n    name: string;\n    currentVersion: string;\n    latestVersion: string;\n  }>>;\n\n  /**\n   * Get plugin configuration\n   *\n   * @param name - Plugin name\n   * @returns Plugin configuration\n   */\n  getConfig(name: string): Record<string, unknown> | undefined;\n\n  /**\n   * Set plugin configuration\n   *\n   * @param name - Plugin name\n   * @param config - Configuration to set\n   */\n  setConfig(name: string, config: Record<string, unknown>): Promise<void>;\n\n  /**\n   * Shutdown the plugin manager\n   *\n   * Destroys all loaded plugins and cleans up resources.\n   */\n  shutdown(): Promise<void>;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Type guard for checking if a plugin is an AnalyzerPlugin\n */\nexport function isAnalyzerPlugin(plugin: KGPlugin): plugin is AnalyzerPlugin {\n  return (\n    plugin.type === 'analyzer' &&\n    'analyze' in plugin &&\n    typeof (plugin as AnalyzerPlugin).analyze === 'function' &&\n    'supportedContentTypes' in plugin &&\n    Array.isArray((plugin as AnalyzerPlugin).supportedContentTypes)\n  );\n}\n\n/**\n * Type guard for checking if an object is a valid plugin manifest\n */\nexport function isPluginManifest(obj: unknown): obj is KGPluginManifest {\n  if (typeof obj !== 'object' || obj === null) {\n    return false;\n  }\n\n  const manifest = obj as Record<string, unknown>;\n\n  return (\n    typeof manifest.name === 'string' &&\n    typeof manifest.version === 'string' &&\n    typeof manifest['kg-plugin'] === 'object' &&\n    manifest['kg-plugin'] !== null &&\n    typeof (manifest['kg-plugin'] as Record<string, unknown>).type === 'string' &&\n    typeof (manifest['kg-plugin'] as Record<string, unknown>).main === 'string'\n  );\n}\n\n/**\n * Type guard for checking if an object is an AnalysisResult\n */\nexport function isAnalysisResult(obj: unknown): obj is AnalysisResult {\n  if (typeof obj !== 'object' || obj === null) {\n    return false;\n  }\n\n  const result = obj as Record<string, unknown>;\n\n  return (\n    typeof result.success === 'boolean' &&\n    typeof result.analysisType === 'string'\n  );\n}\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Extract the configuration type from a plugin manifest\n */\nexport type PluginConfigType<T extends KGPluginManifest> =\n  T['kg-plugin']['configSchema'] extends PluginConfigSchema\n    ? Record<string, unknown>\n    : Record<string, unknown>;\n\n/**\n * Plugin factory function type\n */\nexport type PluginFactory = () => KGPlugin | Promise<KGPlugin>;\n\n/**\n * Plugin constructor type\n */\nexport interface PluginConstructor {\n  new (): KGPlugin;\n}\n\n/**\n * Plugin module default export types\n */\nexport type PluginModuleExport = KGPlugin | PluginFactory | PluginConstructor;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Create a unique plugin instance ID\n */\nexport function createPluginId(name: string): string {\n  return `plugin_${name}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n}\n\n/**\n * Validate semver version string\n */\nexport function isValidSemver(version: string): boolean {\n  const semverRegex = /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$/;\n  return semverRegex.test(version);\n}\n\n/**\n * Get default plugin metadata\n */\nexport function createDefaultPluginMetadata(\n  name: string,\n  version: string,\n  type: PluginType\n): PluginMetadata {\n  return {\n    name,\n    version,\n    type,\n    status: 'unloaded',\n    hooks: [],\n    capabilities: [],\n  };\n}\n"],"names":[],"mappings":"AA2mCO,SAAS,iBAAiB,QAA4C;AAC3E,SACE,OAAO,SAAS,cAChB,aAAa,UACb,OAAQ,OAA0B,YAAY,cAC9C,2BAA2B,UAC3B,MAAM,QAAS,OAA0B,qBAAqB;AAElE;AAKO,SAAS,iBAAiB,KAAuC;AACtE,MAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM;AAC3C,WAAO;AAAA,EACT;AAEA,QAAM,WAAW;AAEjB,SACE,OAAO,SAAS,SAAS,YACzB,OAAO,SAAS,YAAY,YAC5B,OAAO,SAAS,WAAW,MAAM,YACjC,SAAS,WAAW,MAAM,QAC1B,OAAQ,SAAS,WAAW,EAA8B,SAAS,YACnE,OAAQ,SAAS,WAAW,EAA8B,SAAS;AAEvE;AAKO,SAAS,iBAAiB,KAAqC;AACpE,MAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM;AAC3C,WAAO;AAAA,EACT;AAEA,QAAM,SAAS;AAEf,SACE,OAAO,OAAO,YAAY,aAC1B,OAAO,OAAO,iBAAiB;AAEnC;AAsCO,SAAS,eAAe,MAAsB;AACnD,SAAO,UAAU,IAAI,IAAI,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,UAAU,GAAG,CAAC,CAAC;AACnF;AAKO,SAAS,cAAc,SAA0B;AACtD,QAAM,cAAc;AACpB,SAAO,YAAY,KAAK,OAAO;AACjC;AAKO,SAAS,4BACd,MACA,SACA,MACgB;AAChB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,OAAO,CAAA;AAAA,IACP,cAAc,CAAA;AAAA,EAAC;AAEnB;"}

package/dist/server/container.d.ts

@@ -0,0 +1,263 @@
+/**
+ * Service Container - Singleton Pattern for Concurrent Server Execution
+ *
+ * Provides a centralized container for managing all shared services across
+ * MCP, GraphQL, and Dashboard servers. Implements lazy initialization,
+ * dependency injection, and coordinated lifecycle management.
+ *
+ * @module server/container
+ */
+import { KnowledgeGraphDatabase } from '../core/database.js';
+import { AdvancedCache } from '../caching/index.js';
+import { ConfigManager } from '../config/manager.js';
+import { HealthMonitor } from '../health/index.js';
+import { AgentRegistry } from '../agents/registry.js';
+import { WorkflowRegistry } from '../workflows/registry.js';
+import { ServiceManager } from '../services/manager.js';
+import { TypedEventBus } from './event-bus.js';
+import type { HealthStatus } from './types.js';
+import type { CacheConfig } from '../caching/index.js';
+import type { PluginManager } from '../plugins/types.js';
+/**
+ * Service initialization state
+ */
+export type ServiceInitState = 'uninitialized' | 'initializing' | 'initialized' | 'failed';
+/**
+ * Service dependency graph - defines initialization order
+ */
+export interface ServiceDependency {
+    name: string;
+    dependsOn: string[];
+    priority: number;
+}
+/**
+ * Container configuration options
+ */
+export interface ContainerConfig {
+    /** Project root directory */
+    projectRoot: string;
+    /** Database path (relative to projectRoot) */
+    databasePath?: string;
+    /** Enable WAL mode for SQLite */
+    walMode?: boolean;
+    /** Cache configuration */
+    cache?: Partial<CacheConfig>;
+    /** Enable health monitoring */
+    enableHealthMonitoring?: boolean;
+    /** Health check interval in ms */
+    healthCheckInterval?: number;
+    /** Max agents per type */
+    maxAgentsPerType?: number;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Container event types
+ */
+export type ContainerEventType = 'service:initializing' | 'service:initialized' | 'service:failed' | 'service:shutting-down' | 'container:ready' | 'container:shutdown';
+/**
+ * ServiceContainer - Singleton for shared service management
+ *
+ * Manages the lifecycle of all shared services across concurrent server
+ * instances. Provides lazy initialization, dependency injection, and
+ * coordinated shutdown.
+ *
+ * @example
+ * ```typescript
+ * // Get or create the singleton instance
+ * const container = ServiceContainer.getInstance({
+ *   projectRoot: '/path/to/project',
+ * });
+ *
+ * // Initialize all services
+ * await container.initialize();
+ *
+ * // Access services
+ * const db = container.getDatabase();
+ * const cache = container.getCache();
+ *
+ * // Graceful shutdown
+ * await container.shutdown();
+ * ```
+ */
+export declare class ServiceContainer {
+    private static instance;
+    private static instanceLock;
+    private _database;
+    private _cache;
+    private _configManager;
+    private _healthMonitor;
+    private _agentRegistry;
+    private _workflowRegistry;
+    private _pluginManager;
+    private _eventBus;
+    private _serviceManager;
+    private _config;
+    private _initState;
+    private _initPromise;
+    private _startTime;
+    private _shutdownInProgress;
+    private _serviceStates;
+    /**
+     * Private constructor - use getInstance() instead
+     */
+    private constructor();
+    /**
+     * Normalize and validate configuration
+     */
+    private normalizeConfig;
+    /**
+     * Initialize service state tracking
+     */
+    private initializeServiceStates;
+    /**
+     * Get the singleton instance, optionally creating it with config
+     *
+     * @param config - Configuration for new instance (required if no instance exists)
+     * @returns The singleton ServiceContainer instance
+     * @throws Error if no instance exists and no config provided
+     */
+    static getInstance(config?: ContainerConfig): ServiceContainer;
+    /**
+     * Check if an instance exists
+     */
+    static hasInstance(): boolean;
+    /**
+     * Reset the singleton instance (for testing)
+     */
+    static resetInstance(): Promise<void>;
+    /**
+     * Get the database instance
+     * @throws Error if container not initialized
+     */
+    getDatabase(): KnowledgeGraphDatabase;
+    /**
+     * Get the advanced cache instance
+     * @throws Error if container not initialized
+     */
+    getCache(): AdvancedCache;
+    /**
+     * Get the configuration manager
+     * @throws Error if container not initialized
+     */
+    getConfig(): ConfigManager;
+    /**
+     * Get the health monitor
+     * @throws Error if container not initialized
+     */
+    getHealthMonitor(): HealthMonitor;
+    /**
+     * Get the agent registry
+     * @throws Error if container not initialized
+     */
+    getAgentRegistry(): AgentRegistry;
+    /**
+     * Get the workflow registry
+     * @throws Error if container not initialized
+     */
+    getWorkflowRegistry(): WorkflowRegistry;
+    /**
+     * Get the plugin manager (if available)
+     */
+    getPluginManager(): PluginManager | null;
+    /**
+     * Get the typed event bus for cross-service communication
+     */
+    getEventBus(): TypedEventBus;
+    /**
+     * Get the service manager for background services
+     * @throws Error if container not initialized
+     */
+    getServiceManager(): ServiceManager;
+    /**
+     * Get the project root directory
+     */
+    getProjectRoot(): string;
+    /**
+     * Get the container configuration
+     */
+    getContainerConfig(): Readonly<ContainerConfig>;
+    /**
+     * Initialize all services in dependency order
+     */
+    initialize(): Promise<void>;
+    /**
+     * Internal initialization logic with dependency ordering
+     */
+    private _doInitialize;
+    /**
+     * Initialize a single service with state tracking
+     */
+    private initializeService;
+    /**
+     * Ensure required directories exist
+     */
+    private ensureDirectories;
+    private initConfigManager;
+    private initDatabase;
+    private initCache;
+    private initHealthMonitor;
+    private initServiceManager;
+    private initAgentRegistry;
+    private initWorkflowRegistry;
+    /**
+     * Gracefully shutdown all services in reverse dependency order
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Internal cleanup logic - shutdown services in reverse order
+     */
+    private _cleanup;
+    /**
+     * Shutdown a single service with error handling
+     */
+    private shutdownService;
+    /**
+     * Check if container is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get initialization state
+     */
+    getInitState(): ServiceInitState;
+    /**
+     * Get individual service states
+     */
+    getServiceStates(): Map<string, ServiceInitState>;
+    /**
+     * Get comprehensive health status
+     */
+    getHealth(): HealthStatus;
+    /**
+     * Get uptime in milliseconds
+     */
+    getUptime(): number;
+    /**
+     * Assert that the container is initialized
+     * @throws Error if not initialized
+     */
+    private assertInitialized;
+}
+/**
+ * Create and initialize a service container
+ *
+ * @param config - Container configuration
+ * @returns Initialized ServiceContainer
+ */
+export declare function createServiceContainer(config: ContainerConfig): Promise<ServiceContainer>;
+/**
+ * Get existing service container instance
+ *
+ * @returns ServiceContainer if initialized
+ * @throws Error if not initialized
+ */
+export declare function getServiceContainer(): ServiceContainer;
+/**
+ * Check if service container is available
+ */
+export declare function hasServiceContainer(): boolean;
+/**
+ * Shutdown and reset the service container
+ */
+export declare function shutdownServiceContainer(): Promise<void>;
+//# sourceMappingURL=container.d.ts.map

package/dist/server/container.d.ts.map

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