@weavelogic/knowledge-graph-agent 0.2.0 → 0.3.0

package/dist/services/index.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Services Module
+ *
+ * Provides service management, lifecycle control, and file watching capabilities.
+ */
+/**
+ * Status of a service
+ */
+export type ServiceStatus = 'stopped' | 'starting' | 'running' | 'stopping' | 'error';
+/**
+ * Type of service
+ */
+export type ServiceType = 'watcher' | 'sync' | 'health' | 'cache' | 'background';
+/**
+ * Service configuration
+ */
+export interface ServiceConfig {
+    /** Service identifier */
+    id: string;
+    /** Service type */
+    type: ServiceType;
+    /** Whether service should auto-start */
+    autoStart?: boolean;
+    /** Restart on failure */
+    restartOnFailure?: boolean;
+    /** Maximum restart attempts */
+    maxRestarts?: number;
+    /** Restart delay in milliseconds */
+    restartDelay?: number;
+}
+/**
+ * Service state
+ */
+export interface ServiceState {
+    /** Current status */
+    status: ServiceStatus;
+    /** Start time */
+    startedAt?: Date;
+    /** Last error */
+    lastError?: Error;
+    /** Restart count */
+    restartCount: number;
+}
+/**
+ * Service metrics
+ */
+export interface ServiceMetrics {
+    /** Total uptime in milliseconds */
+    uptime: number;
+    /** Number of operations performed */
+    operationCount: number;
+    /** Number of errors */
+    errorCount: number;
+    /** Last operation time */
+    lastOperationAt?: Date;
+}
+/**
+ * Service handler interface
+ */
+export interface ServiceHandler {
+    /** Start the service */
+    start(): Promise<void>;
+    /** Stop the service */
+    stop(): Promise<void>;
+    /** Get service status */
+    getStatus(): ServiceStatus;
+    /** Get service metrics */
+    getMetrics(): ServiceMetrics;
+}
+/**
+ * Service Manager for managing multiple services
+ */
+export declare class ServiceManager {
+    private services;
+    private configs;
+    private states;
+    /**
+     * Register a service
+     */
+    register(config: ServiceConfig, handler: ServiceHandler): void;
+    /**
+     * Start a service
+     */
+    start(id: string): Promise<void>;
+    /**
+     * Stop a service
+     */
+    stop(id: string): Promise<void>;
+    /**
+     * Start all services
+     */
+    startAll(): Promise<void>;
+    /**
+     * Stop all services
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Get service state
+     */
+    getState(id: string): ServiceState | undefined;
+    /**
+     * Get all service states
+     */
+    getAllStates(): Map<string, ServiceState>;
+    /**
+     * Get service metrics
+     */
+    getMetrics(id: string): ServiceMetrics | undefined;
+}
+/**
+ * Create a new ServiceManager instance
+ */
+export declare function createServiceManager(): ServiceManager;
+/**
+ * File watcher service for monitoring file changes
+ */
+export declare class FileWatcherService implements ServiceHandler {
+    private watchPaths;
+    private onChange?;
+    private status;
+    private metrics;
+    private startTime?;
+    private watcher;
+    constructor(watchPaths: string[], onChange?: ((path: string, event: string) => void) | undefined);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): ServiceStatus;
+    getMetrics(): ServiceMetrics;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/services/index.js

@@ -0,0 +1,134 @@
+class ServiceManager {
+  services = /* @__PURE__ */ new Map();
+  configs = /* @__PURE__ */ new Map();
+  states = /* @__PURE__ */ new Map();
+  /**
+   * Register a service
+   */
+  register(config, handler) {
+    this.services.set(config.id, handler);
+    this.configs.set(config.id, config);
+    this.states.set(config.id, {
+      status: "stopped",
+      restartCount: 0
+    });
+  }
+  /**
+   * Start a service
+   */
+  async start(id) {
+    const handler = this.services.get(id);
+    const state = this.states.get(id);
+    if (!handler || !state) {
+      throw new Error(`Service not found: ${id}`);
+    }
+    state.status = "starting";
+    try {
+      await handler.start();
+      state.status = "running";
+      state.startedAt = /* @__PURE__ */ new Date();
+    } catch (error) {
+      state.status = "error";
+      state.lastError = error instanceof Error ? error : new Error(String(error));
+      throw error;
+    }
+  }
+  /**
+   * Stop a service
+   */
+  async stop(id) {
+    const handler = this.services.get(id);
+    const state = this.states.get(id);
+    if (!handler || !state) {
+      throw new Error(`Service not found: ${id}`);
+    }
+    state.status = "stopping";
+    try {
+      await handler.stop();
+      state.status = "stopped";
+    } catch (error) {
+      state.status = "error";
+      state.lastError = error instanceof Error ? error : new Error(String(error));
+      throw error;
+    }
+  }
+  /**
+   * Start all services
+   */
+  async startAll() {
+    for (const [id, config] of this.configs) {
+      if (config.autoStart !== false) {
+        await this.start(id);
+      }
+    }
+  }
+  /**
+   * Stop all services
+   */
+  async stopAll() {
+    for (const id of this.services.keys()) {
+      const state = this.states.get(id);
+      if (state?.status === "running") {
+        await this.stop(id);
+      }
+    }
+  }
+  /**
+   * Get service state
+   */
+  getState(id) {
+    return this.states.get(id);
+  }
+  /**
+   * Get all service states
+   */
+  getAllStates() {
+    return new Map(this.states);
+  }
+  /**
+   * Get service metrics
+   */
+  getMetrics(id) {
+    return this.services.get(id)?.getMetrics();
+  }
+}
+function createServiceManager() {
+  return new ServiceManager();
+}
+class FileWatcherService {
+  constructor(watchPaths, onChange) {
+    this.watchPaths = watchPaths;
+    this.onChange = onChange;
+  }
+  status = "stopped";
+  metrics = {
+    uptime: 0,
+    operationCount: 0,
+    errorCount: 0
+  };
+  startTime;
+  watcher = null;
+  async start() {
+    this.status = "running";
+    this.startTime = /* @__PURE__ */ new Date();
+  }
+  async stop() {
+    this.status = "stopped";
+    this.watcher = null;
+  }
+  getStatus() {
+    return this.status;
+  }
+  getMetrics() {
+    if (this.startTime && this.status === "running") {
+      this.metrics.uptime = Date.now() - this.startTime.getTime();
+    }
+    return { ...this.metrics };
+  }
+}
+export {
+  FileWatcherService,
+  ServiceManager,
+  createServiceManager
+};
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/services/index.ts"],"sourcesContent":["/**\n * Services Module\n *\n * Provides service management, lifecycle control, and file watching capabilities.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Status of a service\n */\nexport type ServiceStatus = 'stopped' | 'starting' | 'running' | 'stopping' | 'error';\n\n/**\n * Type of service\n */\nexport type ServiceType = 'watcher' | 'sync' | 'health' | 'cache' | 'background';\n\n/**\n * Service configuration\n */\nexport interface ServiceConfig {\n  /** Service identifier */\n  id: string;\n  /** Service type */\n  type: ServiceType;\n  /** Whether service should auto-start */\n  autoStart?: boolean;\n  /** Restart on failure */\n  restartOnFailure?: boolean;\n  /** Maximum restart attempts */\n  maxRestarts?: number;\n  /** Restart delay in milliseconds */\n  restartDelay?: number;\n}\n\n/**\n * Service state\n */\nexport interface ServiceState {\n  /** Current status */\n  status: ServiceStatus;\n  /** Start time */\n  startedAt?: Date;\n  /** Last error */\n  lastError?: Error;\n  /** Restart count */\n  restartCount: number;\n}\n\n/**\n * Service metrics\n */\nexport interface ServiceMetrics {\n  /** Total uptime in milliseconds */\n  uptime: number;\n  /** Number of operations performed */\n  operationCount: number;\n  /** Number of errors */\n  errorCount: number;\n  /** Last operation time */\n  lastOperationAt?: Date;\n}\n\n/**\n * Service handler interface\n */\nexport interface ServiceHandler {\n  /** Start the service */\n  start(): Promise<void>;\n  /** Stop the service */\n  stop(): Promise<void>;\n  /** Get service status */\n  getStatus(): ServiceStatus;\n  /** Get service metrics */\n  getMetrics(): ServiceMetrics;\n}\n\n// ============================================================================\n// Service Manager\n// ============================================================================\n\n/**\n * Service Manager for managing multiple services\n */\nexport class ServiceManager {\n  private services: Map<string, ServiceHandler> = new Map();\n  private configs: Map<string, ServiceConfig> = new Map();\n  private states: Map<string, ServiceState> = new Map();\n\n  /**\n   * Register a service\n   */\n  register(config: ServiceConfig, handler: ServiceHandler): void {\n    this.services.set(config.id, handler);\n    this.configs.set(config.id, config);\n    this.states.set(config.id, {\n      status: 'stopped',\n      restartCount: 0,\n    });\n  }\n\n  /**\n   * Start a service\n   */\n  async start(id: string): Promise<void> {\n    const handler = this.services.get(id);\n    const state = this.states.get(id);\n    if (!handler || !state) {\n      throw new Error(`Service not found: ${id}`);\n    }\n\n    state.status = 'starting';\n    try {\n      await handler.start();\n      state.status = 'running';\n      state.startedAt = new Date();\n    } catch (error) {\n      state.status = 'error';\n      state.lastError = error instanceof Error ? error : new Error(String(error));\n      throw error;\n    }\n  }\n\n  /**\n   * Stop a service\n   */\n  async stop(id: string): Promise<void> {\n    const handler = this.services.get(id);\n    const state = this.states.get(id);\n    if (!handler || !state) {\n      throw new Error(`Service not found: ${id}`);\n    }\n\n    state.status = 'stopping';\n    try {\n      await handler.stop();\n      state.status = 'stopped';\n    } catch (error) {\n      state.status = 'error';\n      state.lastError = error instanceof Error ? error : new Error(String(error));\n      throw error;\n    }\n  }\n\n  /**\n   * Start all services\n   */\n  async startAll(): Promise<void> {\n    for (const [id, config] of this.configs) {\n      if (config.autoStart !== false) {\n        await this.start(id);\n      }\n    }\n  }\n\n  /**\n   * Stop all services\n   */\n  async stopAll(): Promise<void> {\n    for (const id of this.services.keys()) {\n      const state = this.states.get(id);\n      if (state?.status === 'running') {\n        await this.stop(id);\n      }\n    }\n  }\n\n  /**\n   * Get service state\n   */\n  getState(id: string): ServiceState | undefined {\n    return this.states.get(id);\n  }\n\n  /**\n   * Get all service states\n   */\n  getAllStates(): Map<string, ServiceState> {\n    return new Map(this.states);\n  }\n\n  /**\n   * Get service metrics\n   */\n  getMetrics(id: string): ServiceMetrics | undefined {\n    return this.services.get(id)?.getMetrics();\n  }\n}\n\n/**\n * Create a new ServiceManager instance\n */\nexport function createServiceManager(): ServiceManager {\n  return new ServiceManager();\n}\n\n// ============================================================================\n// File Watcher Service\n// ============================================================================\n\n/**\n * File watcher service for monitoring file changes\n */\nexport class FileWatcherService implements ServiceHandler {\n  private status: ServiceStatus = 'stopped';\n  private metrics: ServiceMetrics = {\n    uptime: 0,\n    operationCount: 0,\n    errorCount: 0,\n  };\n  private startTime?: Date;\n  private watcher: unknown = null;\n\n  constructor(\n    private watchPaths: string[],\n    private onChange?: (path: string, event: string) => void\n  ) {}\n\n  async start(): Promise<void> {\n    this.status = 'running';\n    this.startTime = new Date();\n    // File watcher implementation would go here\n    // Using chokidar or fs.watch\n  }\n\n  async stop(): Promise<void> {\n    this.status = 'stopped';\n    this.watcher = null;\n  }\n\n  getStatus(): ServiceStatus {\n    return this.status;\n  }\n\n  getMetrics(): ServiceMetrics {\n    if (this.startTime && this.status === 'running') {\n      this.metrics.uptime = Date.now() - this.startTime.getTime();\n    }\n    return { ...this.metrics };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/services/manager.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Service Manager - Background process management
+ *
+ * Provides centralized management for background services including:
+ * - Service registration and lifecycle management
+ * - Health monitoring with configurable intervals
+ * - Automatic restart on failure
+ * - Graceful shutdown coordination
+ *
+ * @module services/manager
+ */
+import { EventEmitter } from 'events';
+import type { ServiceConfig, ServiceState, ServiceHandler } from './types.js';
+/**
+ * Manages background services with lifecycle control and health monitoring.
+ *
+ * @example
+ * ```typescript
+ * const manager = createServiceManager();
+ *
+ * await manager.register(
+ *   { id: 'watcher', name: 'File Watcher', type: 'watcher', autoStart: true },
+ *   new FileWatcherService(['/path/to/watch'])
+ * );
+ *
+ * manager.on('started', (state) => console.log(`${state.name} started`));
+ *
+ * // Graceful shutdown
+ * process.on('SIGTERM', () => manager.shutdown());
+ * ```
+ */
+export declare class ServiceManager extends EventEmitter {
+    private services;
+    private handlers;
+    private configs;
+    private healthCheckTimers;
+    private isShuttingDown;
+    constructor();
+    /**
+     * Register a new service with the manager.
+     *
+     * @param config - Service configuration
+     * @param handler - Service implementation
+     * @throws Error if service ID is already registered
+     */
+    register(config: ServiceConfig, handler: ServiceHandler): Promise<void>;
+    /**
+     * Start a registered service.
+     *
+     * @param id - Service identifier
+     * @throws Error if service is not found
+     */
+    start(id: string): Promise<void>;
+    /**
+     * Stop a running service.
+     *
+     * @param id - Service identifier
+     * @throws Error if service is not found
+     */
+    stop(id: string): Promise<void>;
+    /**
+     * Restart a service.
+     *
+     * @param id - Service identifier
+     * @throws Error if service is not found
+     */
+    restart(id: string): Promise<void>;
+    /**
+     * Handle service failure with optional auto-restart.
+     */
+    private handleFailure;
+    /**
+     * Get the current state of a service.
+     *
+     * @param id - Service identifier
+     * @returns Service state or undefined if not found
+     */
+    getStatus(id: string): ServiceState | undefined;
+    /**
+     * List all registered services.
+     *
+     * @returns Array of service states
+     */
+    listServices(): ServiceState[];
+    /**
+     * Get services by type.
+     *
+     * @param type - Service type to filter by
+     * @returns Array of matching service states
+     */
+    getServicesByType(type: string): ServiceState[];
+    /**
+     * Get services by status.
+     *
+     * @param status - Service status to filter by
+     * @returns Array of matching service states
+     */
+    getServicesByStatus(status: string): ServiceState[];
+    /**
+     * Start periodic health checks for a service.
+     */
+    private startHealthCheck;
+    /**
+     * Stop health checks for a service.
+     */
+    private stopHealthCheck;
+    /**
+     * Unregister a service.
+     *
+     * @param id - Service identifier
+     */
+    unregister(id: string): Promise<void>;
+    /**
+     * Check if manager is shutting down.
+     */
+    get shuttingDown(): boolean;
+    /**
+     * Gracefully shutdown all services.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get aggregate metrics for all services.
+     */
+    getAggregateMetrics(): {
+        totalServices: number;
+        running: number;
+        stopped: number;
+        failed: number;
+        totalRequests: number;
+        totalErrors: number;
+        healthyCount: number;
+    };
+}
+/**
+ * Create a new ServiceManager instance.
+ *
+ * @returns Configured ServiceManager
+ */
+export declare function createServiceManager(): ServiceManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/services/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/services/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EAEf,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,cAAc,CAAS;;IAO/B;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC7E;;;;;OAKG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCtC;;;;;OAKG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCrC;;;;;OAKG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAexC;;OAEG;YACW,aAAa;IAyB3B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAc/C;;;;OAIG;IACH,YAAY,IAAI,YAAY,EAAE;IAI9B;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE;IAI/C;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAInD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;OAIG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3C;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC/B;;OAEG;IACH,mBAAmB,IAAI;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB;CAaF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/services/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Service Manager Types
+ *
+ * Defines types for background service management including
+ * configuration, state, metrics, and handlers.
+ *
+ * @module services/types
+ */
+/**
+ * Current operational status of a service.
+ */
+export type ServiceStatus = 'stopped' | 'starting' | 'running' | 'stopping' | 'failed';
+/**
+ * Classification of service functionality.
+ */
+export type ServiceType = 'watcher' | 'scheduler' | 'sync' | 'analyzer' | 'server';
+/**
+ * Configuration options for registering a service.
+ */
+export interface ServiceConfig {
+    /** Unique identifier for the service */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Type of service for categorization */
+    type: ServiceType;
+    /** Whether to start automatically on registration */
+    autoStart?: boolean;
+    /** Whether to restart on failure */
+    restartOnFailure?: boolean;
+    /** Maximum number of restart attempts */
+    maxRestarts?: number;
+    /** Delay in milliseconds between restart attempts */
+    restartDelay?: number;
+    /** Interval in milliseconds for health checks */
+    healthCheckInterval?: number;
+}
+/**
+ * Runtime state of a registered service.
+ */
+export interface ServiceState {
+    /** Unique identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Service type */
+    type: ServiceType;
+    /** Current operational status */
+    status: ServiceStatus;
+    /** Process ID if applicable */
+    pid?: number;
+    /** When the service was started */
+    startTime?: Date;
+    /** Number of times the service has been restarted */
+    restarts: number;
+    /** Last error message if status is 'failed' */
+    lastError?: string;
+    /** Performance and health metrics */
+    metrics: ServiceMetrics;
+}
+/**
+ * Performance and health metrics for a service.
+ */
+export interface ServiceMetrics {
+    /** Total uptime in milliseconds */
+    uptime: number;
+    /** Number of requests/events processed */
+    requests: number;
+    /** Number of errors encountered */
+    errors: number;
+    /** Last health check timestamp */
+    lastHealthCheck?: Date;
+    /** Current health status */
+    healthStatus: 'healthy' | 'degraded' | 'unhealthy';
+}
+/**
+ * Interface that service implementations must fulfill.
+ */
+export interface ServiceHandler {
+    /** Start the service */
+    start(): Promise<void>;
+    /** Stop the service gracefully */
+    stop(): Promise<void>;
+    /** Check if the service is healthy */
+    healthCheck(): Promise<boolean>;
+    /** Get current metrics */
+    getMetrics(): ServiceMetrics;
+}
+/**
+ * Event types emitted by the service manager.
+ */
+export interface ServiceManagerEvents {
+    registered: ServiceState;
+    starting: ServiceState;
+    started: ServiceState;
+    stopping: ServiceState;
+    stopped: ServiceState;
+    failed: ServiceState;
+    restarted: ServiceState;
+    healthCheck: {
+        id: string;
+        healthy: boolean;
+    };
+    shutdown: void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/services/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,iCAAiC;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,4BAA4B;IAC5B,YAAY,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,kCAAkC;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,sCAAsC;IACtC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,0BAA0B;IAC1B,UAAU,IAAI,cAAc,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,YAAY,CAAC;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,YAAY,CAAC;IACxB,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9C,QAAQ,EAAE,IAAI,CAAC;CAChB"}

package/dist/services/watchers.d.ts

@@ -0,0 +1,95 @@
+/**
+ * File Watcher Service
+ *
+ * Provides file system watching capabilities using chokidar.
+ * Monitors files and directories for changes and emits events.
+ *
+ * @module services/watchers
+ */
+import { EventEmitter } from 'events';
+import type { ServiceHandler, ServiceMetrics } from './types.js';
+/**
+ * Configuration options for the file watcher.
+ */
+export interface FileWatcherOptions {
+    /** Paths to watch (files or directories) */
+    paths: string[];
+    /** File patterns to ignore */
+    ignored?: string | RegExp | (string | RegExp)[];
+    /** Whether to emit events for initial files */
+    ignoreInitial?: boolean;
+    /** Stability threshold in ms before emitting file change */
+    stabilityThreshold?: number;
+    /** Poll interval for write finish detection */
+    pollInterval?: number;
+    /** Use polling instead of native events */
+    usePolling?: boolean;
+    /** Depth to traverse directories */
+    depth?: number;
+}
+/**
+ * File watcher service that monitors file system changes.
+ *
+ * @example
+ * ```typescript
+ * const watcher = new FileWatcherService({
+ *   paths: ['/path/to/watch'],
+ *   ignored: /node_modules/,
+ *   ignoreInitial: true,
+ * });
+ *
+ * watcher.on('change', (path) => console.log(`Changed: ${path}`));
+ * watcher.on('add', (path) => console.log(`Added: ${path}`));
+ * watcher.on('unlink', (path) => console.log(`Removed: ${path}`));
+ *
+ * await watcher.start();
+ * ```
+ */
+export declare class FileWatcherService extends EventEmitter implements ServiceHandler {
+    private watcher?;
+    private options;
+    private metrics;
+    private startTime?;
+    private isRunning;
+    constructor(options: FileWatcherOptions | string[]);
+    /**
+     * Start watching for file changes.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop watching for file changes.
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the watcher is healthy.
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Get current metrics.
+     */
+    getMetrics(): ServiceMetrics;
+    /**
+     * Add paths to watch.
+     *
+     * @param paths - Paths to add
+     */
+    add(paths: string | string[]): void;
+    /**
+     * Remove paths from watching.
+     *
+     * @param paths - Paths to unwatch
+     */
+    unwatch(paths: string | string[]): void;
+    /**
+     * Get list of watched paths.
+     */
+    getWatched(): Record<string, string[]>;
+}
+/**
+ * Create a file watcher service.
+ *
+ * @param options - Watcher options or array of paths
+ * @returns Configured FileWatcherService
+ */
+export declare function createFileWatcher(options: FileWatcherOptions | string[]): FileWatcherService;
+//# sourceMappingURL=watchers.d.ts.map

package/dist/services/watchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchers.d.ts","sourceRoot":"","sources":["../../src/services/watchers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmBjE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAChD,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,cAAc;IAC5E,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAKb;IACF,OAAO,CAAC,SAAS,CAAC,CAAO;IACzB,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE;IAUlD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgF5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACH,UAAU,IAAI,cAAc;IAW5B;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAOnC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAOvC;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAMvC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE,GAAG,kBAAkB,CAE5F"}