@omnitron-dev/omnitron 0.1.1

package/dist/daemon/daemon.rpc-service.js

@@ -0,0 +1,452 @@
+/**
+ * DaemonRpcService — Netron RPC service exposed by the daemon
+ *
+ * Implements IDaemonService interface. CLI communicates with daemon
+ * exclusively through this Netron service:
+ * - Local: Unix socket transport (CLI on same host)
+ * - Remote: TCP transport (fleet operations across servers)
+ *
+ * RBAC roles:
+ *   - Public (anonymous): ping
+ *   - Viewer (admin+operator+viewer): list, status, getApp, getMetrics, getHealth, getLogs, inspect, getEnv, getWatchStatus
+ *   - Operator (admin+operator): startApp, stopApp, restartApp, reloadApp, startAll, stopAll, restartAll, scale, enableWatch, disableWatch
+ *   - Admin (admin only): shutdown, reloadConfig, exec
+ */
+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);
+};
+import { Service, Public } from '@omnitron-dev/titan/decorators';
+import { CLI_VERSION, DAEMON_SERVICE_ID } from '../config/defaults.js';
+import { loadEcosystemConfig } from '../config/loader.js';
+import { VIEWER_ROLES, OPERATOR_ROLES, ADMIN_ROLES } from '../shared/roles.js';
+let DaemonRpcService = class DaemonRpcService {
+    orchestrator;
+    titanHealth;
+    logManager;
+    config;
+    daemon;
+    startedAt = Date.now();
+    constructor(orchestrator, titanHealth, logManager, config, daemon) {
+        this.orchestrator = orchestrator;
+        this.titanHealth = titanHealth;
+        this.logManager = logManager;
+        this.config = config;
+        this.daemon = daemon;
+    }
+    // ============================================================================
+    // Process Management (Operator: admin + operator)
+    // ============================================================================
+    async startApp(data) {
+        const entry = this.config.apps.find((a) => a.name === data.name);
+        if (!entry)
+            throw new Error(`Unknown app: ${data.name}`);
+        await this.orchestrator.startApp(entry);
+        return this.orchestrator.getApp(data.name);
+    }
+    async startAll() {
+        await this.orchestrator.startAll(this.config);
+        return this.orchestrator.list();
+    }
+    async stopApp(data) {
+        await this.orchestrator.stopApp(data.name, data.force, data.timeout);
+        return { success: true };
+    }
+    async stopAll(data) {
+        const count = await this.orchestrator.stopAll(data.force);
+        return { count };
+    }
+    async restartApp(data) {
+        await this.orchestrator.restartApp(data.name);
+        return this.orchestrator.getApp(data.name);
+    }
+    async restartAll() {
+        const entries = this.config.apps;
+        for (const entry of entries) {
+            await this.orchestrator.restartApp(entry.name);
+        }
+        return this.orchestrator.list();
+    }
+    async reloadApp(data) {
+        await this.orchestrator.reloadApp(data.name);
+        return this.orchestrator.getApp(data.name);
+    }
+    // ============================================================================
+    // Information (Viewer: admin + operator + viewer)
+    // ============================================================================
+    async list() {
+        return this.orchestrator.list();
+    }
+    async getApp(data) {
+        const info = this.orchestrator.getApp(data.name);
+        if (!info)
+            throw new Error(`Unknown app: ${data.name}`);
+        return info;
+    }
+    async status() {
+        const apps = this.orchestrator.list();
+        const totalCpu = apps.reduce((sum, a) => sum + a.cpu, 0);
+        const totalMemory = apps.reduce((sum, a) => sum + a.memory, 0) + process.memoryUsage.rss();
+        return {
+            version: CLI_VERSION,
+            pid: process.pid,
+            uptime: Date.now() - this.startedAt,
+            apps,
+            totalCpu,
+            totalMemory,
+        };
+    }
+    // ============================================================================
+    // Monitoring (Viewer: admin + operator + viewer)
+    // ============================================================================
+    async getMetrics(data) {
+        const raw = await this.orchestrator.getMetrics(data.name);
+        const apps = {};
+        let totalCpu = 0;
+        let totalMemory = 0;
+        for (const [name, m] of Object.entries(raw)) {
+            apps[name] = {
+                cpu: m?.cpu ?? 0,
+                memory: m?.memory ?? 0,
+                requests: m?.requests ?? 0,
+                errors: m?.errors ?? 0,
+            };
+            totalCpu += m?.cpu ?? 0;
+            totalMemory += m?.memory ?? 0;
+        }
+        return { timestamp: Date.now(), apps, totals: { cpu: totalCpu, memory: totalMemory } };
+    }
+    async getHealth(_data) {
+        const result = await this.titanHealth.check();
+        // Map TitanHealth indicators to AggregatedHealthDto
+        const apps = {};
+        for (const [name, indicator] of Object.entries(result.indicators)) {
+            const check = {
+                name,
+                status: indicator.status === 'healthy' ? 'pass' : indicator.status === 'degraded' ? 'warn' : 'fail',
+            };
+            if (indicator.message)
+                check.message = indicator.message;
+            apps[name] = { status: indicator.status, checks: [check] };
+        }
+        return {
+            timestamp: Date.now(),
+            overall: result.status,
+            apps,
+        };
+    }
+    async getLogs(data) {
+        return this.logManager.getLogs(data.name, data.lines);
+    }
+    // ============================================================================
+    // Scaling (Operator: admin + operator)
+    // ============================================================================
+    async scale(data) {
+        await this.orchestrator.scaleApp(data.name, data.instances);
+        return this.orchestrator.getApp(data.name);
+    }
+    // ============================================================================
+    // Lifecycle (Mixed: ping is public, shutdown/reloadConfig are admin)
+    // ============================================================================
+    async ping() {
+        return {
+            uptime: Date.now() - this.startedAt,
+            version: CLI_VERSION,
+            pid: process.pid,
+        };
+    }
+    async shutdown(_data) {
+        // Defer shutdown to allow RPC response to be sent first.
+        // Application's shutdown system handles process.exit() automatically.
+        setTimeout(() => {
+            this.daemon.stop().catch(() => process.exit(1));
+        }, 100);
+        return { success: true };
+    }
+    async reloadConfig() {
+        const newConfig = await loadEcosystemConfig();
+        this.config = newConfig;
+        return { success: true };
+    }
+    async setMetricsEnabled(data) {
+        await this.orchestrator.setMetricsEnabled(data.name, data.enabled);
+        return { success: true };
+    }
+    // ============================================================================
+    // Diagnostics (inspect is viewer, exec is admin)
+    // ============================================================================
+    async inspect(data) {
+        const handle = this.orchestrator.getHandle(data.name);
+        if (!handle)
+            throw new Error(`Unknown app: ${data.name}`);
+        const metricsMap = await this.orchestrator.getMetrics(data.name);
+        const appMetrics = metricsMap[data.name];
+        const memory = { heapUsed: 0, heapTotal: 0, external: 0, arrayBuffers: 0, rss: 0 };
+        if (handle.pid && handle.status === 'online') {
+            try {
+                const { execSync } = await import('node:child_process');
+                const psOutput = execSync(`ps -p ${handle.pid} -o rss=`, { encoding: 'utf-8' }).trim();
+                const rssKb = parseInt(psOutput, 10);
+                if (!isNaN(rssKb)) {
+                    memory.rss = rssKb * 1024;
+                }
+            }
+            catch {
+                /* process may have exited */
+            }
+        }
+        if (memory.rss === 0 && appMetrics?.memory) {
+            memory.rss = appMetrics.memory;
+        }
+        const services = [];
+        if (handle.mode === 'bootstrap' && handle.supervisor) {
+            const childNames = handle.supervisor.getChildNames();
+            for (const childName of childNames) {
+                const processId = handle.supervisor.getChildProcessId(childName);
+                if (processId) {
+                    const workerHandle = this.orchestrator.getWorkerHandle(processId);
+                    if (workerHandle?.serviceName) {
+                        services.push(`${workerHandle.serviceName}@${workerHandle.serviceVersion}`);
+                    }
+                }
+            }
+        }
+        const appConfig = {};
+        const entry = this.config?.apps?.find((a) => a.name === data.name);
+        if (entry) {
+            appConfig['mode'] = handle.mode;
+            appConfig['instances'] = handle.instanceCount ?? 1;
+            appConfig['critical'] = entry.critical ?? false;
+            if (handle.port)
+                appConfig['port'] = handle.port;
+            if (entry.bootstrap)
+                appConfig['bootstrap'] = entry.bootstrap;
+        }
+        return {
+            name: handle.name,
+            pid: handle.pid,
+            status: handle.status,
+            memory,
+            uptime: handle.uptime,
+            restarts: handle.restarts,
+            services,
+            config: appConfig,
+        };
+    }
+    async exec(data) {
+        const handle = this.orchestrator.getHandle(data.name);
+        if (!handle)
+            throw new Error(`Unknown app: ${data.name}`);
+        if (handle.status !== 'online')
+            throw new Error(`App '${data.name}' is not online`);
+        if (handle.mode === 'bootstrap' && handle.supervisor) {
+            const childNames = handle.supervisor.getChildNames();
+            if (childNames.length === 0)
+                throw new Error(`No running children for app '${data.name}'`);
+            const proxy = await handle.supervisor.getChildProxy(childNames[0]);
+            if (!proxy)
+                throw new Error(`Cannot get proxy for app '${data.name}'`);
+            const service = proxy[data.service];
+            if (!service)
+                throw new Error(`Service '${data.service}' not found on app '${data.name}'`);
+            const fn = service[data.method];
+            if (typeof fn !== 'function')
+                throw new Error(`Method '${data.method}' not found on service '${data.service}'`);
+            return fn.call(service, ...data.args);
+        }
+        if (!handle.port)
+            throw new Error(`App '${data.name}' has no port configured`);
+        const { HttpConnection } = await import('@omnitron-dev/titan/netron/transport/http');
+        const connection = new HttpConnection(`http://127.0.0.1:${handle.port}`, { timeout: 30_000 });
+        try {
+            const service = await connection.queryInterface(data.service);
+            const fn = service[data.method];
+            if (typeof fn !== 'function')
+                throw new Error(`Method '${data.method}' not found on service '${data.service}'`);
+            return await fn.call(service, ...data.args);
+        }
+        finally {
+            try {
+                await connection.close();
+            }
+            catch {
+                // connection cleanup is best-effort
+            }
+        }
+    }
+    async getEnv(data) {
+        const handle = this.orchestrator.getHandle(data.name);
+        if (!handle)
+            throw new Error(`Unknown app: ${data.name}`);
+        return handle.entry.env ?? {};
+    }
+    // ============================================================================
+    // Watch Mode (Operator: admin + operator)
+    // ============================================================================
+    async enableWatch(data) {
+        const watching = await this.daemon.enableWatch(data.apps);
+        return { watching };
+    }
+    async disableWatch() {
+        this.daemon.disableWatch();
+        return { success: true };
+    }
+    async getWatchStatus() {
+        return this.daemon.getWatchStatus();
+    }
+};
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "startApp", null);
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "startAll", null);
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "stopApp", null);
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "stopAll", null);
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "restartApp", null);
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "restartAll", null);
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "reloadApp", null);
+__decorate([
+    Public({ auth: { roles: VIEWER_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "list", null);
+__decorate([
+    Public({ auth: { roles: VIEWER_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "getApp", null);
+__decorate([
+    Public({ auth: { roles: VIEWER_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "status", null);
+__decorate([
+    Public({ auth: { roles: VIEWER_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "getMetrics", null);
+__decorate([
+    Public({ auth: { roles: VIEWER_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "getHealth", null);
+__decorate([
+    Public({ auth: { roles: VIEWER_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "getLogs", null);
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "scale", null);
+__decorate([
+    Public({ auth: { allowAnonymous: true } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "ping", null);
+__decorate([
+    Public({ auth: { roles: ADMIN_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "shutdown", null);
+__decorate([
+    Public({ auth: { roles: ADMIN_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "reloadConfig", null);
+__decorate([
+    Public({ auth: { roles: ADMIN_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "setMetricsEnabled", null);
+__decorate([
+    Public({ auth: { roles: VIEWER_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "inspect", null);
+__decorate([
+    Public({ auth: { roles: ADMIN_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "exec", null);
+__decorate([
+    Public({ auth: { roles: VIEWER_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "getEnv", null);
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "enableWatch", null);
+__decorate([
+    Public({ auth: { roles: OPERATOR_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "disableWatch", null);
+__decorate([
+    Public({ auth: { roles: VIEWER_ROLES } }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DaemonRpcService.prototype, "getWatchStatus", null);
+DaemonRpcService = __decorate([
+    Service({ name: DAEMON_SERVICE_ID }),
+    __metadata("design:paramtypes", [Function, Object, Function, Object, Function])
+], DaemonRpcService);
+export { DaemonRpcService };
+//# sourceMappingURL=daemon.rpc-service.js.map

package/dist/daemon/daemon.rpc-service.js.map

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

package/dist/daemon/pid-manager.d.ts

@@ -0,0 +1,43 @@
+/**
+ * PID File Management
+ *
+ * Prevents duplicate daemons and enables daemon discovery.
+ * Also handles stale PID/socket cleanup for robust restart.
+ */
+export declare class PidManager {
+    private readonly pidFile;
+    constructor(pidFile: string);
+    /**
+     * Check if another daemon is already running.
+     * Uses process.kill(pid, 0) to verify liveness.
+     */
+    isRunning(): boolean;
+    /**
+     * Get the PID of the running daemon (only if alive).
+     */
+    getPid(): number | null;
+    /**
+     * Get the raw PID from file (even if process is dead).
+     * Useful for stale cleanup diagnostics.
+     */
+    readPid(): number | null;
+    /**
+     * Write current process PID
+     */
+    write(): void;
+    /**
+     * Remove PID file
+     */
+    remove(): void;
+    /**
+     * Clean up stale PID file and optionally a socket file.
+     * Called when PID file exists but process is dead.
+     * Returns true if stale state was found and cleaned.
+     */
+    cleanupStale(socketPath?: string): boolean;
+    /**
+     * Check if a process with given PID is alive.
+     */
+    static isProcessAlive(pid: number): boolean;
+}
+//# sourceMappingURL=pid-manager.d.ts.map

package/dist/daemon/pid-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid-manager.d.ts","sourceRoot":"","sources":["../../src/daemon/pid-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE5C;;;OAGG;IACH,SAAS,IAAI,OAAO;IAMpB;;OAEG;IACH,MAAM,IAAI,MAAM,GAAG,IAAI;IAMvB;;;OAGG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI;IAUxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;;;OAIG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;IAqB1C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAQ5C"}

package/dist/daemon/pid-manager.js

@@ -0,0 +1,103 @@
+/**
+ * PID File Management
+ *
+ * Prevents duplicate daemons and enables daemon discovery.
+ * Also handles stale PID/socket cleanup for robust restart.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export class PidManager {
+    pidFile;
+    constructor(pidFile) {
+        this.pidFile = pidFile;
+    }
+    /**
+     * Check if another daemon is already running.
+     * Uses process.kill(pid, 0) to verify liveness.
+     */
+    isRunning() {
+        const pid = this.readPid();
+        if (pid === null)
+            return false;
+        return PidManager.isProcessAlive(pid);
+    }
+    /**
+     * Get the PID of the running daemon (only if alive).
+     */
+    getPid() {
+        const pid = this.readPid();
+        if (pid === null)
+            return null;
+        return PidManager.isProcessAlive(pid) ? pid : null;
+    }
+    /**
+     * Get the raw PID from file (even if process is dead).
+     * Useful for stale cleanup diagnostics.
+     */
+    readPid() {
+        try {
+            const pidStr = fs.readFileSync(this.pidFile, 'utf-8').trim();
+            const pid = parseInt(pidStr, 10);
+            return isNaN(pid) ? null : pid;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Write current process PID
+     */
+    write() {
+        const dir = path.dirname(this.pidFile);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(this.pidFile, String(process.pid), 'utf-8');
+    }
+    /**
+     * Remove PID file
+     */
+    remove() {
+        try {
+            fs.unlinkSync(this.pidFile);
+        }
+        catch {
+            // File may not exist
+        }
+    }
+    /**
+     * Clean up stale PID file and optionally a socket file.
+     * Called when PID file exists but process is dead.
+     * Returns true if stale state was found and cleaned.
+     */
+    cleanupStale(socketPath) {
+        const rawPid = this.readPid();
+        if (rawPid === null)
+            return false;
+        // If process is still alive, not stale
+        if (PidManager.isProcessAlive(rawPid))
+            return false;
+        // Process is dead — clean up stale files
+        this.remove();
+        if (socketPath) {
+            try {
+                fs.unlinkSync(socketPath);
+            }
+            catch {
+                // Socket may not exist
+            }
+        }
+        return true;
+    }
+    /**
+     * Check if a process with given PID is alive.
+     */
+    static isProcessAlive(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=pid-manager.js.map

package/dist/daemon/pid-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid-manager.js","sourceRoot":"","sources":["../../src/daemon/pid-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEhD;;;OAGG;IACH,SAAS;QACP,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC/B,OAAO,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,OAAO,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7D,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,UAAmB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAElC,uCAAuC;QACvC,IAAI,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QAEpD,yCAAyC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,GAAW;QAC/B,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/daemon/state-store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * State Store — Persist/recover process state across daemon restarts
+ */
+import type { AppStatus } from '../config/types.js';
+export interface PersistedAppState {
+    name: string;
+    pid: number | null;
+    status: AppStatus;
+    mode: 'classic' | 'bootstrap';
+    startedAt: number;
+    restarts: number;
+    port: number | null;
+}
+export interface PersistedState {
+    version: string;
+    updatedAt: number;
+    apps: PersistedAppState[];
+}
+export declare class StateStore {
+    private readonly stateFile;
+    constructor(stateFile: string);
+    save(state: PersistedState): void;
+    load(): PersistedState | null;
+    clear(): void;
+}
+//# sourceMappingURL=state-store.d.ts.map

package/dist/daemon/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/daemon/state-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,iBAAiB,EAAE,CAAC;CAC3B;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAE9C,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAMjC,IAAI,IAAI,cAAc,GAAG,IAAI;IAS7B,KAAK,IAAI,IAAI;CAOd"}