@omnitron-dev/omnitron 0.1.1

package/dist/workers/health-monitor.service.js

@@ -0,0 +1,402 @@
+/**
+ * Health Monitor Worker Service
+ *
+ * DI-managed service that periodically checks all nodes (ping/SSH/omnitron),
+ * writes results to PG, and sends IPC status batches to the master daemon
+ * for cache updates.
+ *
+ * Replaces the old bare @Process HealthMonitorProcess with proper Titan module integration.
+ * The IPC communication pattern is preserved — the service sends messages to parent
+ * via parentPort.postMessage() or process.send().
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Injectable, Inject } from '@omnitron-dev/titan/decorators';
+import { Service } from '@omnitron-dev/titan/decorators';
+import { LOGGER_SERVICE_TOKEN } from '@omnitron-dev/titan/module/logger';
+import { readFileSync } from 'node:fs';
+import os from 'node:os';
+import { Kysely, PostgresDialect } from 'kysely';
+import pg from 'pg';
+import { RemoteOpsService } from '../services/remote-ops.service.js';
+let HealthMonitorService = class HealthMonitorService {
+    config;
+    nodes = new Map();
+    statusCache = new Map();
+    db = null;
+    remoteOps;
+    checkTimer = null;
+    isRunning = false;
+    lastCleanup = 0;
+    logger;
+    constructor(loggerModule) {
+        this.logger = loggerModule.logger;
+    }
+    /**
+     * Initialize the worker. Called by master process via RPC with config/nodes.
+     */
+    async init(configJson, nodesJson) {
+        this.config = JSON.parse(configJson);
+        const nodesList = JSON.parse(nodesJson);
+        for (const node of nodesList) {
+            this.nodes.set(node.id, node);
+        }
+        this.remoteOps = new RemoteOpsService(this.logger);
+        // Connect to PG
+        try {
+            const pool = new pg.Pool({ connectionString: this.config.dbUrl });
+            this.db = new Kysely({ dialect: new PostgresDialect({ pool }) });
+            this.logger.info({}, 'Connected to PG for health check persistence');
+        }
+        catch (err) {
+            this.logger.warn({ error: err.message }, 'Failed to connect to PG — running without persistence');
+        }
+        // Start periodic checks
+        this.startCheckLoop();
+        // Notify master we're ready
+        this.sendIpc({ type: 'health:ready' });
+        this.logger.info({ nodeCount: this.nodes.size, intervalMs: this.config.intervalMs }, 'Health monitor worker initialized');
+        // Run initial check immediately
+        void this.runAllChecks();
+    }
+    /** Master calls this when nodes are added/updated/removed */
+    updateNodes(nodesJson) {
+        const nodesList = JSON.parse(nodesJson);
+        this.nodes.clear();
+        for (const node of nodesList) {
+            this.nodes.set(node.id, node);
+        }
+        this.logger.info({ nodeCount: this.nodes.size }, 'Node list updated');
+    }
+    /** On-demand check for a specific node or all nodes */
+    async triggerCheck(nodeId) {
+        if (nodeId) {
+            const node = this.nodes.get(nodeId);
+            if (!node)
+                throw new Error(`Node not found: ${nodeId}`);
+            const result = await this.checkNode(node);
+            const summary = this.deriveSummary(node, result);
+            this.statusCache.set(nodeId, summary);
+            await this.persistResults([result]);
+            this.broadcastSummaries();
+            return [summary];
+        }
+        await this.runAllChecks();
+        return this.getStatusSummaries();
+    }
+    /** Get current in-memory status summaries */
+    getStatusSummaries() {
+        return Array.from(this.statusCache.values());
+    }
+    /** Get check history from PG */
+    async getCheckHistory(nodeId, limit = 50) {
+        if (!this.db)
+            return [];
+        const rows = await this.db
+            .selectFrom('node_health_checks')
+            .selectAll()
+            .where('nodeId', '=', nodeId)
+            .orderBy('checkedAt', 'desc')
+            .limit(limit)
+            .execute();
+        return rows;
+    }
+    /** Update config at runtime */
+    updateConfig(configJson) {
+        const newConfig = JSON.parse(configJson);
+        this.config = newConfig;
+        this.startCheckLoop(); // Restart timer with new interval
+        this.logger.info({ intervalMs: newConfig.intervalMs }, 'Config updated');
+    }
+    /** Health check for PM */
+    async checkHealth() {
+        return {
+            status: this.isRunning ? 'degraded' : 'healthy',
+            timestamp: Date.now(),
+        };
+    }
+    async shutdown() {
+        this.stopCheckLoop();
+        if (this.db) {
+            await this.db.destroy();
+            this.db = null;
+        }
+        await this.remoteOps.dispose();
+        this.logger.info({}, 'Health monitor worker shut down');
+    }
+    // ===========================================================================
+    // Check Loop
+    // ===========================================================================
+    startCheckLoop() {
+        this.stopCheckLoop();
+        this.checkTimer = setInterval(() => void this.runAllChecks(), this.config.intervalMs);
+        this.checkTimer.unref();
+    }
+    stopCheckLoop() {
+        if (this.checkTimer) {
+            clearInterval(this.checkTimer);
+            this.checkTimer = null;
+        }
+    }
+    async runAllChecks() {
+        if (this.isRunning)
+            return; // No overlap
+        this.isRunning = true;
+        try {
+            const nodeList = Array.from(this.nodes.values());
+            if (nodeList.length === 0)
+                return;
+            const results = [];
+            // Process in batches of config.concurrency
+            for (let i = 0; i < nodeList.length; i += this.config.concurrency) {
+                const batch = nodeList.slice(i, i + this.config.concurrency);
+                const batchResults = await Promise.allSettled(batch.map((node) => this.checkNode(node)));
+                for (const r of batchResults) {
+                    if (r.status === 'fulfilled') {
+                        results.push(r.value);
+                    }
+                }
+            }
+            // Update in-memory cache
+            for (const result of results) {
+                const node = this.nodes.get(result.nodeId);
+                if (node) {
+                    this.statusCache.set(result.nodeId, this.deriveSummary(node, result));
+                }
+            }
+            // Persist to PG
+            await this.persistResults(results);
+            // Broadcast to master via IPC
+            this.broadcastSummaries();
+            // Periodic cleanup — once per hour, not every cycle
+            const now = Date.now();
+            if (now - this.lastCleanup > 3_600_000) {
+                this.lastCleanup = now;
+                await this.cleanupOldRows();
+            }
+        }
+        catch (err) {
+            this.logger.error({ error: err.message }, 'Error during health check round');
+        }
+        finally {
+            this.isRunning = false;
+        }
+    }
+    // ===========================================================================
+    // Individual Node Check
+    // ===========================================================================
+    async checkNode(node) {
+        const start = Date.now();
+        const result = {
+            nodeId: node.id,
+            checkedAt: new Date().toISOString(),
+            checkDurationMs: 0,
+            pingReachable: false,
+            pingLatencyMs: null,
+            pingError: null,
+            sshConnected: false,
+            sshLatencyMs: null,
+            sshError: null,
+            omnitronConnected: false,
+            omnitronVersion: null,
+            omnitronPid: null,
+            omnitronUptime: null,
+            omnitronRole: null,
+            omnitronError: null,
+            os: null,
+        };
+        if (node.isLocal) {
+            result.pingReachable = true;
+            result.pingLatencyMs = 0;
+            result.sshConnected = true;
+            result.sshLatencyMs = 0;
+            result.omnitronConnected = true;
+            result.omnitronPid = process.ppid; // Parent is the daemon
+            result.omnitronUptime = process.uptime() * 1000;
+            result.omnitronRole = 'master';
+            result.os = {
+                platform: os.platform(),
+                arch: os.arch(),
+                hostname: os.hostname(),
+                release: os.release(),
+            };
+            result.checkDurationMs = Date.now() - start;
+            return result;
+        }
+        // 1. Ping
+        if (this.config.pingEnabled) {
+            const ping = await this.remoteOps.ping(node.host, this.config.pingTimeout);
+            result.pingReachable = ping.reachable;
+            result.pingLatencyMs = ping.latencyMs;
+            if (ping.error)
+                result.pingError = ping.error;
+        }
+        else {
+            result.pingReachable = true;
+        }
+        // 2. SSH — always attempt
+        const sshTarget = {
+            host: node.host,
+            port: node.sshPort,
+            username: node.sshUser,
+            ...(node.sshPrivateKey && { privateKey: readKeyContent(node.sshPrivateKey) }),
+            ...(node.sshPassphrase && { passphrase: node.sshPassphrase }),
+        };
+        const ssh = await this.remoteOps.checkSsh(sshTarget, this.config.sshTimeout);
+        result.sshConnected = ssh.connected;
+        result.sshLatencyMs = ssh.latencyMs;
+        if (ssh.error)
+            result.sshError = ssh.error;
+        if (ssh.os)
+            result.os = { ...ssh.os, release: '' };
+        // 3. Omnitron (only if SSH connected)
+        if (result.sshConnected) {
+            const omn = await this.remoteOps.checkRemoteOmnitron(sshTarget, this.config.omnitronCheckTimeout);
+            result.omnitronConnected = omn.connected;
+            if (omn.version)
+                result.omnitronVersion = omn.version;
+            if (omn.pid)
+                result.omnitronPid = omn.pid;
+            if (omn.uptime)
+                result.omnitronUptime = omn.uptime;
+            if (omn.role)
+                result.omnitronRole = omn.role;
+            if (omn.os)
+                result.os = omn.os;
+        }
+        result.checkDurationMs = Date.now() - start;
+        return result;
+    }
+    // ===========================================================================
+    // Status Derivation
+    // ===========================================================================
+    deriveSummary(node, result) {
+        const previous = this.statusCache.get(node.id);
+        const isReachable = result.sshConnected || result.pingReachable;
+        let status;
+        if (result.sshConnected || (node.isLocal && result.omnitronConnected)) {
+            status = result.omnitronConnected ? 'online' : 'degraded';
+        }
+        else {
+            // Not reachable — check offline timeout
+            const offlineTimeout = node.offlineTimeout ?? this.config.offlineTimeoutMs;
+            const lastSeen = previous?.lastSeenOnline;
+            if (lastSeen && (Date.now() - new Date(lastSeen).getTime()) < offlineTimeout) {
+                status = 'degraded';
+            }
+            else {
+                status = 'offline';
+            }
+        }
+        const consecutiveFailures = isReachable
+            ? 0
+            : (previous?.consecutiveFailures ?? 0) + 1;
+        const lastSeenOnline = isReachable
+            ? result.checkedAt
+            : (previous?.lastSeenOnline ?? null);
+        return {
+            nodeId: node.id,
+            status,
+            lastCheck: result,
+            lastSeenOnline,
+            consecutiveFailures,
+        };
+    }
+    // ===========================================================================
+    // Persistence
+    // ===========================================================================
+    async persistResults(results) {
+        if (!this.db || results.length === 0)
+            return;
+        try {
+            const rows = results.map((r) => ({
+                nodeId: r.nodeId,
+                checkedAt: r.checkedAt,
+                checkDurationMs: r.checkDurationMs,
+                pingReachable: r.pingReachable,
+                pingLatencyMs: r.pingLatencyMs,
+                pingError: r.pingError,
+                sshConnected: r.sshConnected,
+                sshLatencyMs: r.sshLatencyMs,
+                sshError: r.sshError,
+                omnitronConnected: r.omnitronConnected,
+                omnitronVersion: r.omnitronVersion,
+                omnitronPid: r.omnitronPid,
+                omnitronUptime: r.omnitronUptime,
+                omnitronRole: r.omnitronRole,
+                omnitronError: r.omnitronError,
+                os: r.os ? JSON.stringify(r.os) : null,
+            }));
+            await this.db.insertInto('node_health_checks').values(rows).execute();
+        }
+        catch (err) {
+            this.logger.warn({ error: err.message }, 'Failed to persist health check results');
+        }
+    }
+    async cleanupOldRows() {
+        if (!this.db)
+            return;
+        try {
+            const cutoff = new Date(Date.now() - this.config.retentionDays * 24 * 60 * 60 * 1000).toISOString();
+            const { sql } = await import('kysely');
+            await sql `
+        DELETE FROM node_health_checks
+        WHERE id IN (
+          SELECT id FROM node_health_checks
+          WHERE "checkedAt" < ${cutoff}
+          LIMIT 10000
+        )
+      `.execute(this.db);
+        }
+        catch {
+            // Non-critical — cleanup will retry next hour
+        }
+    }
+    // ===========================================================================
+    // IPC
+    // ===========================================================================
+    sendIpc(message) {
+        const parentPort = globalThis.parentPort;
+        if (parentPort?.postMessage) {
+            parentPort.postMessage(message);
+        }
+        else if (typeof process.send === 'function') {
+            process.send(message);
+        }
+    }
+    broadcastSummaries() {
+        this.sendIpc({
+            type: 'health:status_batch',
+            summaries: Array.from(this.statusCache.values()),
+        });
+    }
+};
+HealthMonitorService = __decorate([
+    Injectable(),
+    Service({ name: 'HealthMonitor' }),
+    __param(0, Inject(LOGGER_SERVICE_TOKEN)),
+    __metadata("design:paramtypes", [Object])
+], HealthMonitorService);
+export { HealthMonitorService };
+/** Read SSH key: if path -> read file, if already content -> return as-is */
+function readKeyContent(pathOrContent) {
+    if (pathOrContent.startsWith('-----'))
+        return pathOrContent;
+    try {
+        return readFileSync(pathOrContent, 'utf-8');
+    }
+    catch {
+        return pathOrContent;
+    }
+}
+//# sourceMappingURL=health-monitor.service.js.map

package/dist/workers/health-monitor.service.js.map

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

package/dist/workers/system-worker-manager.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SystemWorkerManager — Registry for daemon-internal background workers
+ *
+ * Manages system-level PM workers (health-monitor, future: log-rotator, etc.)
+ * Separate from OrchestratorService which manages user application processes.
+ * All system workers are prefixed with "system:" in PM to avoid name collisions.
+ */
+import type { ProcessManager, ServiceProxy } from '@omnitron-dev/titan-pm';
+import type { ILogger } from '@omnitron-dev/titan/module/logger';
+export interface SystemWorkerInfo {
+    name: string;
+    /** PM-internal process ID (UUID) for getWorkerHandle() */
+    processId: string;
+    startedAt: number;
+}
+export declare class SystemWorkerManager {
+    private readonly pm;
+    private readonly logger;
+    private readonly workers;
+    constructor(pm: ProcessManager, logger: ILogger);
+    /**
+     * Spawn a system worker process.
+     *
+     * @param name - Logical name (e.g., 'health-monitor')
+     * @param processPath - Absolute path to the @Process file
+     * @param dependencies - Dependencies passed to process init()
+     * @param options - PM spawn options (execArgv, etc.)
+     */
+    spawn<T>(name: string, processPath: string, dependencies: Record<string, any>, options?: {
+        execArgv?: string[];
+        startupTimeout?: number;
+    }): Promise<ServiceProxy<T>>;
+    /** Get a running worker's proxy */
+    get<T>(name: string): ServiceProxy<T> | null;
+    /**
+     * Register an IPC message handler on a worker using PM's public API.
+     * Uses pm.getWorkerHandle(processId).onMessage() — no internal access.
+     */
+    onMessage(name: string, handler: (data: any) => void): boolean;
+    /** Stop a specific worker */
+    stop(name: string): Promise<void>;
+    /** Stop all system workers */
+    stopAll(): Promise<void>;
+    /** List running workers */
+    list(): SystemWorkerInfo[];
+}
+//# sourceMappingURL=system-worker-manager.d.ts.map

package/dist/workers/system-worker-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-worker-manager.d.ts","sourceRoot":"","sources":["../../src/workers/system-worker-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2E;gBAGhF,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,OAAO;IAGlC;;;;;;;OAOG;IACG,KAAK,CAAC,CAAC,EACX,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7D,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA8B3B,mCAAmC;IACnC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5C;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO;IAa9D,6BAA6B;IACvB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvC,8BAA8B;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,2BAA2B;IAC3B,IAAI,IAAI,gBAAgB,EAAE;CAG3B"}

package/dist/workers/system-worker-manager.js

@@ -0,0 +1,98 @@
+/**
+ * SystemWorkerManager — Registry for daemon-internal background workers
+ *
+ * Manages system-level PM workers (health-monitor, future: log-rotator, etc.)
+ * Separate from OrchestratorService which manages user application processes.
+ * All system workers are prefixed with "system:" in PM to avoid name collisions.
+ */
+export class SystemWorkerManager {
+    pm;
+    logger;
+    workers = new Map();
+    constructor(pm, logger) {
+        this.pm = pm;
+        this.logger = logger;
+    }
+    /**
+     * Spawn a system worker process.
+     *
+     * @param name - Logical name (e.g., 'health-monitor')
+     * @param processPath - Absolute path to the @Process file
+     * @param dependencies - Dependencies passed to process init()
+     * @param options - PM spawn options (execArgv, etc.)
+     */
+    async spawn(name, processPath, dependencies, options = {}) {
+        if (this.workers.has(name)) {
+            throw new Error(`System worker "${name}" is already running`);
+        }
+        const pmName = `system:${name}`;
+        this.logger.info({ worker: name, processPath }, 'Spawning system worker');
+        const spawnOpts = {
+            name: pmName,
+            allMethodsPublic: true,
+            dependencies,
+        };
+        if (options.execArgv)
+            spawnOpts['execArgv'] = options.execArgv;
+        if (options.startupTimeout != null)
+            spawnOpts['startupTimeout'] = options.startupTimeout;
+        const proxy = await this.pm.spawn(processPath, spawnOpts);
+        // Extract PM-internal processId from the proxy for IPC handle lookup
+        const processId = proxy.__processId;
+        this.workers.set(name, {
+            proxy,
+            info: { name, processId, startedAt: Date.now() },
+        });
+        this.logger.info({ worker: name, processId }, 'System worker started');
+        return proxy;
+    }
+    /** Get a running worker's proxy */
+    get(name) {
+        return this.workers.get(name)?.proxy ?? null;
+    }
+    /**
+     * Register an IPC message handler on a worker using PM's public API.
+     * Uses pm.getWorkerHandle(processId).onMessage() — no internal access.
+     */
+    onMessage(name, handler) {
+        const entry = this.workers.get(name);
+        if (!entry)
+            return false;
+        const handle = this.pm.getWorkerHandle(entry.info.processId);
+        if (handle?.onMessage) {
+            handle.onMessage(handler);
+            return true;
+        }
+        this.logger.warn({ worker: name }, 'Worker handle has no onMessage — IPC not available');
+        return false;
+    }
+    /** Stop a specific worker */
+    async stop(name) {
+        const entry = this.workers.get(name);
+        if (!entry)
+            return;
+        try {
+            // Use PM.kill() for clean process termination
+            await this.pm.kill(entry.info.processId);
+        }
+        catch {
+            // Fallback: destroy proxy
+            try {
+                await entry.proxy.__destroy?.();
+            }
+            catch { /* best-effort */ }
+        }
+        this.workers.delete(name);
+        this.logger.info({ worker: name }, 'System worker stopped');
+    }
+    /** Stop all system workers */
+    async stopAll() {
+        const names = Array.from(this.workers.keys());
+        await Promise.allSettled(names.map((n) => this.stop(n)));
+    }
+    /** List running workers */
+    list() {
+        return Array.from(this.workers.values()).map((w) => w.info);
+    }
+}
+//# sourceMappingURL=system-worker-manager.js.map

package/dist/workers/system-worker-manager.js.map

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

package/dist/workers/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Health Monitor Worker — Shared Types
+ *
+ * Types shared between the health-monitor worker process and the daemon master.
+ * All types are serializable (no class instances, functions, or symbols).
+ */
+export interface IHealthCheckResult {
+    nodeId: string;
+    checkedAt: string;
+    checkDurationMs: number;
+    pingReachable: boolean;
+    pingLatencyMs: number | null;
+    pingError: string | null;
+    sshConnected: boolean;
+    sshLatencyMs: number | null;
+    sshError: string | null;
+    omnitronConnected: boolean;
+    omnitronVersion: string | null;
+    omnitronPid: number | null;
+    omnitronUptime: number | null;
+    omnitronRole: string | null;
+    omnitronError: string | null;
+    os: {
+        platform: string;
+        arch: string;
+        hostname: string;
+        release: string;
+    } | null;
+}
+export interface INodeCheckTarget {
+    id: string;
+    name: string;
+    host: string;
+    sshPort: number;
+    sshUser: string;
+    sshAuthMethod: 'password' | 'key';
+    sshPrivateKey?: string;
+    sshPassphrase?: string;
+    runtime: 'node' | 'bun';
+    daemonPort: number;
+    isLocal: boolean;
+    offlineTimeout: number | null;
+}
+export interface IHealthMonitorConfig {
+    /** Check interval in ms (default: 30_000) */
+    intervalMs: number;
+    /** Max concurrent node checks (default: 20) */
+    concurrency: number;
+    /** Offline timeout in ms — node considered offline after this (default: 90_000) */
+    offlineTimeoutMs: number;
+    /** Ping timeout per node (ms) */
+    pingTimeout: number;
+    /** SSH timeout per node (ms) */
+    sshTimeout: number;
+    /** Omnitron check timeout per node (ms) */
+    omnitronCheckTimeout: number;
+    /** Whether ping is enabled */
+    pingEnabled: boolean;
+    /** PG connection URL for writing check history */
+    dbUrl: string;
+    /** Retention in days for check history (default: 7) */
+    retentionDays: number;
+}
+export type NodeHealthStatus = 'online' | 'degraded' | 'offline' | 'unknown';
+export interface INodeHealthSummary {
+    nodeId: string;
+    status: NodeHealthStatus;
+    lastCheck: IHealthCheckResult | null;
+    lastSeenOnline: string | null;
+    consecutiveFailures: number;
+}
+export interface IHealthStatusBatchMessage {
+    type: 'health:status_batch';
+    summaries: INodeHealthSummary[];
+}
+export interface IHealthWorkerReadyMessage {
+    type: 'health:ready';
+}
+export type HealthWorkerMessage = IHealthStatusBatchMessage | IHealthWorkerReadyMessage;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IAExB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,EAAE,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAClF;AAMD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,UAAU,GAAG,KAAK,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAMD,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,gBAAgB,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8BAA8B;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,GAAG,yBAAyB,CAAC"}