@claude-flow/hooks 3.0.0-alpha.1

package/dist/workers/index.d.ts

@@ -0,0 +1,232 @@
+/**
+ * V3 Workers System - Cross-Platform Background Workers
+ *
+ * Optimizes Claude Flow with non-blocking, scheduled workers.
+ * Works on Linux, macOS, and Windows.
+ */
+import { EventEmitter } from 'events';
+export interface WorkerConfig {
+    name: string;
+    description: string;
+    interval: number;
+    enabled: boolean;
+    priority: WorkerPriority;
+    timeout: number;
+    platforms?: ('linux' | 'darwin' | 'win32')[];
+}
+export declare enum WorkerPriority {
+    Critical = 0,
+    High = 1,
+    Normal = 2,
+    Low = 3,
+    Background = 4
+}
+export interface WorkerResult {
+    worker: string;
+    success: boolean;
+    duration: number;
+    data?: Record<string, unknown>;
+    error?: string;
+    alerts?: WorkerAlert[];
+    timestamp: Date;
+}
+export interface WorkerMetrics {
+    name: string;
+    status: 'running' | 'idle' | 'error' | 'disabled';
+    lastRun?: Date;
+    lastDuration?: number;
+    runCount: number;
+    errorCount: number;
+    avgDuration: number;
+    lastResult?: Record<string, unknown>;
+}
+export interface WorkerManagerStatus {
+    running: boolean;
+    platform: string;
+    workers: WorkerMetrics[];
+    uptime: number;
+    totalRuns: number;
+    lastUpdate: Date;
+}
+export type WorkerHandler = () => Promise<WorkerResult>;
+export declare enum AlertSeverity {
+    Info = "info",
+    Warning = "warning",
+    Critical = "critical"
+}
+export interface WorkerAlert {
+    worker: string;
+    severity: AlertSeverity;
+    message: string;
+    metric?: string;
+    value?: number;
+    threshold?: number;
+    timestamp: Date;
+}
+export interface AlertThreshold {
+    metric: string;
+    warning: number;
+    critical: number;
+    comparison: 'gt' | 'lt' | 'eq';
+}
+export declare const DEFAULT_THRESHOLDS: Record<string, AlertThreshold[]>;
+export interface PersistedWorkerState {
+    version: string;
+    lastSaved: string;
+    workers: Record<string, {
+        lastRun?: string;
+        lastResult?: Record<string, unknown>;
+        runCount: number;
+        errorCount: number;
+        avgDuration: number;
+    }>;
+    history: HistoricalMetric[];
+}
+export interface HistoricalMetric {
+    timestamp: string;
+    worker: string;
+    metrics: Record<string, number>;
+}
+export interface StatuslineData {
+    workers: {
+        active: number;
+        total: number;
+        errors: number;
+    };
+    health: {
+        status: 'healthy' | 'warning' | 'critical';
+        memory: number;
+        disk: number;
+    };
+    security: {
+        status: 'clean' | 'warning' | 'critical';
+        issues: number;
+    };
+    adr: {
+        compliance: number;
+    };
+    ddd: {
+        progress: number;
+    };
+    performance: {
+        speedup: string;
+    };
+    alerts: WorkerAlert[];
+    lastUpdate: string;
+}
+export declare const WORKER_CONFIGS: Record<string, WorkerConfig>;
+export declare class WorkerManager extends EventEmitter {
+    private workers;
+    private metrics;
+    private timers;
+    private running;
+    private startTime?;
+    private projectRoot;
+    private metricsDir;
+    private persistPath;
+    private statuslinePath;
+    private alerts;
+    private history;
+    private thresholds;
+    private statuslineTimer?;
+    private autoSaveTimer?;
+    private initialized;
+    constructor(projectRoot?: string);
+    private initializeMetrics;
+    /**
+     * Load persisted state from disk
+     */
+    loadState(): Promise<boolean>;
+    /**
+     * Save current state to disk
+     */
+    saveState(): Promise<void>;
+    /**
+     * Check result against thresholds and generate alerts
+     */
+    private checkAlerts;
+    private getNestedValue;
+    /**
+     * Set custom alert thresholds
+     */
+    setThresholds(worker: string, thresholds: AlertThreshold[]): void;
+    /**
+     * Get recent alerts
+     */
+    getAlerts(limit?: number): WorkerAlert[];
+    /**
+     * Clear alerts
+     */
+    clearAlerts(): void;
+    /**
+     * Record metrics to history
+     */
+    private recordHistory;
+    /**
+     * Get historical metrics for a worker
+     */
+    getHistory(worker?: string, limit?: number): HistoricalMetric[];
+    /**
+     * Generate statusline data
+     */
+    getStatuslineData(): StatuslineData;
+    /**
+     * Export statusline data to file (for shell consumption)
+     */
+    exportStatusline(): Promise<void>;
+    /**
+     * Generate shell-compatible statusline string
+     */
+    getStatuslineString(): string;
+    /**
+     * Register a worker handler
+     * Optionally pass config; if not provided, a default config is used for dynamically registered workers
+     */
+    register(name: string, handler: WorkerHandler, config?: Partial<WorkerConfig>): void;
+    /**
+     * Initialize and start workers (loads persisted state)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start all workers with scheduling
+     */
+    start(options?: {
+        autoSave?: boolean;
+        statuslineUpdate?: boolean;
+    }): Promise<void>;
+    /**
+     * Stop all workers and save state
+     */
+    stop(): Promise<void>;
+    /**
+     * Run a specific worker immediately
+     */
+    runWorker(name: string): Promise<WorkerResult>;
+    /**
+     * Run all workers (non-blocking with concurrency limit)
+     */
+    runAll(concurrency?: number): Promise<WorkerResult[]>;
+    /**
+     * Get worker status
+     */
+    getStatus(): WorkerManagerStatus;
+    /**
+     * Get statusline-friendly metrics
+     */
+    getStatuslineMetrics(): Record<string, unknown>;
+    private scheduleWorker;
+    private ensureMetricsDir;
+}
+export declare function createPerformanceWorker(projectRoot: string): WorkerHandler;
+export declare function createHealthWorker(projectRoot: string): WorkerHandler;
+export declare function createSwarmWorker(projectRoot: string): WorkerHandler;
+export declare function createGitWorker(projectRoot: string): WorkerHandler;
+export declare function createLearningWorker(projectRoot: string): WorkerHandler;
+export declare function createADRWorker(projectRoot: string): WorkerHandler;
+export declare function createDDDWorker(projectRoot: string): WorkerHandler;
+export declare function createSecurityWorker(projectRoot: string): WorkerHandler;
+export declare function createPatternsWorker(projectRoot: string): WorkerHandler;
+export declare function createCacheWorker(projectRoot: string): WorkerHandler;
+export declare function createWorkerManager(projectRoot?: string): WorkerManager;
+export declare const workerManager: WorkerManager;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAiLtC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,CAAC,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC;CAC9C;AAED,oBAAY,cAAc;IACxB,QAAQ,IAAI;IACZ,IAAI,IAAI;IACR,MAAM,IAAI;IACV,GAAG,IAAI;IACP,UAAU,IAAI;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAClD,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;AAMxD,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAe/D,CAAC;AAMF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAMD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;QAC3C,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,GAAG,EAAE;QACH,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,GAAG,EAAE;QACH,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAiFvD,CAAC;AAUF,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAO;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAS;IAG/B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAA+D;IACjF,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,CAAC,EAAE,MAAM;IAShC,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAmCnC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAgChC;;OAEG;IACH,OAAO,CAAC,WAAW;IA+CnB,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI;IAIjE;;OAEG;IACH,SAAS,CAAC,KAAK,SAAK,GAAG,WAAW,EAAE;IAIpC;;OAEG;IACH,WAAW,IAAI,IAAI;IASnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,gBAAgB,EAAE;IAY5D;;OAEG;IACH,iBAAiB,IAAI,cAAc;IA0CnC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUvC;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAiC7B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IA6BpF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCxF;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgEpD;;OAEG;IACG,MAAM,CAAC,WAAW,SAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgBpE;;OAEG;IACH,SAAS,IAAI,mBAAmB;IAWhC;;OAEG;IACH,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkB/C,OAAO,CAAC,cAAc;YAgBR,gBAAgB;CAO/B;AAMD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA6C1E;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA2CrE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAsCpE;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAwClE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA+CvE;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAoHlE;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA0FlE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAiFvE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA6DvE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAmEpE;AA0JD,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CAiBvE;AAGD,eAAO,MAAM,aAAa,eAAwB,CAAC"}