@omnitron-dev/omnitron 0.1.1

package/dist/monitoring/log-manager.js

@@ -0,0 +1,353 @@
+/**
+ * LogManager — Project-scoped log routing, error log separation, per-app rotation
+ *
+ * Directory layout:
+ *   ~/.omnitron/logs/omnitron.log          — daemon all-level log
+ *   ~/.omnitron/logs/omnitron.error.log    — daemon error+fatal only
+ *   ~/.omnitron/projects/{project}/{stack}/logs/{app}/app.log
+ *   ~/.omnitron/projects/{project}/{stack}/logs/{app}/error.log
+ *   ~/.omnitron/logs/{app}/app.log         — standalone (no project context)
+ *   ~/.omnitron/logs/{app}/error.log
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createGzip } from 'node:zlib';
+import { createReadStream, createWriteStream } from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+// ---------------------------------------------------------------------------
+// LogManager
+// ---------------------------------------------------------------------------
+export class LogManager {
+    orchestrator;
+    baseDir;
+    defaults;
+    perApp;
+    rotationCheckTimer = null;
+    constructor(config, orchestrator) {
+        this.orchestrator = orchestrator;
+        // Support both new and legacy config shapes
+        if ('baseDir' in config) {
+            this.baseDir = config.baseDir.replace('~', process.env['HOME'] ?? '');
+            this.defaults = config.defaults;
+            this.perApp = config.perApp ?? new Map();
+        }
+        else {
+            // Legacy compat: directory pointed to ~/.omnitron/logs
+            this.baseDir = config.directory.replace('~', process.env['HOME'] ?? '').replace(/\/logs\/?$/, '');
+            this.defaults = { maxSize: config.maxSize, maxFiles: config.maxFiles, compress: config.compress };
+            this.perApp = new Map();
+        }
+        // Ensure base log dir exists
+        fs.mkdirSync(path.join(this.baseDir, 'logs'), { recursive: true });
+        // Periodic rotation check for daemon's own log files (every 60s)
+        this.rotationCheckTimer = setInterval(() => {
+            this.checkRotation('omnitron', 'app');
+            this.checkRotation('omnitron', 'error');
+        }, 60_000);
+        this.rotationCheckTimer.unref();
+    }
+    dispose() {
+        if (this.rotationCheckTimer) {
+            clearInterval(this.rotationCheckTimer);
+            this.rotationCheckTimer = null;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Path resolution — project-scoped directories
+    // -------------------------------------------------------------------------
+    /**
+     * Resolve the log directory for an app.
+     *
+     * - `"omnitron"` → `~/.omnitron/logs/`
+     * - `"project/stack/app"` → `~/.omnitron/projects/{project}/{stack}/logs/{app}/`
+     * - `"app"` (standalone) → `~/.omnitron/logs/{app}/`
+     */
+    getLogDir(appName) {
+        if (appName === 'omnitron') {
+            return path.join(this.baseDir, 'logs');
+        }
+        const parts = appName.split('/');
+        if (parts.length >= 3) {
+            const [project, stack, ...rest] = parts;
+            const app = rest.join('/');
+            return path.join(this.baseDir, 'projects', project, stack, 'logs', app);
+        }
+        // Standalone app
+        return path.join(this.baseDir, 'logs', appName);
+    }
+    /**
+     * Full file path for a log type.
+     *
+     * - Daemon: `omnitron.log` / `omnitron.error.log`
+     * - Apps: `app.log` / `error.log`
+     */
+    getLogFilePath(appName, type = 'app') {
+        const dir = this.getLogDir(appName);
+        fs.mkdirSync(dir, { recursive: true });
+        if (appName === 'omnitron') {
+            return path.join(dir, type === 'error' ? 'omnitron.error.log' : 'omnitron.log');
+        }
+        return path.join(dir, type === 'error' ? 'error.log' : 'app.log');
+    }
+    // -------------------------------------------------------------------------
+    // Per-app rotation config
+    // -------------------------------------------------------------------------
+    getRotationConfig(appName) {
+        const shortName = appName.includes('/') ? appName.split('/').pop() : appName;
+        const override = this.perApp.get(shortName) ?? this.perApp.get(appName);
+        return {
+            maxSize: override?.maxSize ?? this.defaults.maxSize,
+            maxFiles: override?.maxFiles ?? this.defaults.maxFiles,
+            compress: override?.compress ?? this.defaults.compress,
+        };
+    }
+    getMaxSizeBytes(appName) {
+        return this.parseSize(this.getRotationConfig(appName).maxSize);
+    }
+    // -------------------------------------------------------------------------
+    // Write + dual-file routing
+    // -------------------------------------------------------------------------
+    /**
+     * Append a log line to the app's log files.
+     *
+     * - Always writes to `app.log` (all levels).
+     * - If the line is error or fatal, also writes to `error.log`.
+     */
+    appendToFile(appName, line) {
+        // All levels → app.log
+        const appPath = this.getLogFilePath(appName, 'app');
+        fs.appendFileSync(appPath, line + '\n', 'utf-8');
+        this.checkAndRotate(appName, 'app', appPath);
+        // error + fatal → error.log
+        if (this.isErrorOrFatal(line)) {
+            const errorPath = this.getLogFilePath(appName, 'error');
+            fs.appendFileSync(errorPath, line + '\n', 'utf-8');
+            this.checkAndRotate(appName, 'error', errorPath);
+        }
+    }
+    /**
+     * Fast level extraction from pino JSON without full parse.
+     * Pino levels: 50=error, 60=fatal.
+     */
+    isErrorOrFatal(line) {
+        // Fast path: look for "level":50 or "level":60 in raw JSON
+        const idx = line.indexOf('"level":');
+        if (idx === -1)
+            return false;
+        const numStart = idx + 8;
+        // Skip whitespace
+        let i = numStart;
+        while (i < line.length && line[i] === ' ')
+            i++;
+        const num = parseInt(line.slice(i), 10);
+        return num >= 50;
+    }
+    // -------------------------------------------------------------------------
+    // Rotation
+    // -------------------------------------------------------------------------
+    checkRotation(appName, type = 'app') {
+        const filePath = this.getLogFilePath(appName, type);
+        const maxBytes = this.getMaxSizeBytes(appName);
+        try {
+            const stat = fs.statSync(filePath);
+            if (stat.size >= maxBytes) {
+                this.rotateLog(appName, type);
+            }
+        }
+        catch {
+            // File doesn't exist yet
+        }
+    }
+    checkAndRotate(appName, type, filePath) {
+        const maxBytes = this.getMaxSizeBytes(appName);
+        try {
+            const stat = fs.statSync(filePath);
+            if (stat.size >= maxBytes) {
+                this.rotateLog(appName, type);
+            }
+        }
+        catch {
+            // File may not exist yet
+        }
+    }
+    /** Callbacks invoked after a log file is rotated — used to reopen pino streams */
+    onRotateCallbacks = [];
+    onRotate(callback) {
+        this.onRotateCallbacks.push(callback);
+    }
+    /**
+     * Rotate log file: rename current → .1, .1 → .2, etc.
+     * Remove files beyond maxFiles. Compress rotated files when enabled.
+     */
+    rotateLog(appName, type = 'app') {
+        const basePath = this.getLogFilePath(appName, type);
+        const config = this.getRotationConfig(appName);
+        const ext = config.compress ? '.gz' : '';
+        // Shift rotated files: .{maxFiles-1} removed, .{i-1} → .{i}
+        for (let i = config.maxFiles - 1; i >= 1; i--) {
+            const from = i === 1 ? basePath : `${basePath}.${i - 1}${ext}`;
+            const to = `${basePath}.${i}${ext}`;
+            try {
+                if (i === config.maxFiles - 1) {
+                    try {
+                        fs.unlinkSync(to);
+                    }
+                    catch { /* doesn't exist */ }
+                }
+                fs.renameSync(from, to);
+            }
+            catch {
+                // Source doesn't exist — skip
+            }
+        }
+        // Rename current → .1
+        try {
+            fs.renameSync(basePath, `${basePath}.1`);
+        }
+        catch { /* no current file */ }
+        // Create fresh empty log file
+        try {
+            fs.writeFileSync(basePath, '', 'utf-8');
+        }
+        catch { /* non-critical */ }
+        // Notify listeners (pino stream reopening)
+        for (const cb of this.onRotateCallbacks) {
+            try {
+                cb(appName, basePath);
+            }
+            catch { /* non-critical */ }
+        }
+        // Compress the .1 file asynchronously
+        if (config.compress) {
+            const rotatedPath = `${basePath}.1`;
+            if (fs.existsSync(rotatedPath)) {
+                this.compressFile(rotatedPath).catch(() => {
+                    // Compression failed — rotated file remains uncompressed
+                });
+            }
+        }
+    }
+    async compressFile(filePath) {
+        const gzPath = filePath + '.gz';
+        await pipeline(createReadStream(filePath), createGzip(), createWriteStream(gzPath));
+        fs.unlinkSync(filePath);
+    }
+    // -------------------------------------------------------------------------
+    // Query helpers (from ring buffer via orchestrator)
+    // -------------------------------------------------------------------------
+    getLogs(appName, lines = 100) {
+        const rawLogs = this.orchestrator.getLogs(appName, lines);
+        const entries = [];
+        for (const { app, lines: logLines } of rawLogs) {
+            for (const line of logLines) {
+                entries.push(this.parseLine(app, line));
+            }
+        }
+        entries.sort((a, b) => a.timestamp - b.timestamp);
+        return entries.slice(-lines);
+    }
+    // -------------------------------------------------------------------------
+    // File listing
+    // -------------------------------------------------------------------------
+    getRotatedFiles(appName, type = 'app') {
+        const basePath = this.getLogFilePath(appName, type);
+        const config = this.getRotationConfig(appName);
+        const files = [];
+        if (fs.existsSync(basePath))
+            files.push(basePath);
+        for (let i = 1; i < config.maxFiles; i++) {
+            const rotatedGz = `${basePath}.${i}.gz`;
+            const rotated = `${basePath}.${i}`;
+            if (fs.existsSync(rotatedGz)) {
+                files.push(rotatedGz);
+            }
+            else if (fs.existsSync(rotated)) {
+                files.push(rotated);
+            }
+        }
+        return files;
+    }
+    listLogApps() {
+        const apps = [];
+        // Check flat logs dir (daemon + standalone apps)
+        const logsDir = path.join(this.baseDir, 'logs');
+        try {
+            for (const entry of fs.readdirSync(logsDir, { withFileTypes: true })) {
+                if (entry.isDirectory()) {
+                    // Standalone app directories
+                    const appLog = path.join(logsDir, entry.name, 'app.log');
+                    if (fs.existsSync(appLog))
+                        apps.push(entry.name);
+                }
+                else if (entry.name === 'omnitron.log') {
+                    apps.push('omnitron');
+                }
+            }
+        }
+        catch { /* dir may not exist */ }
+        // Check project-scoped dirs
+        const projectsDir = path.join(this.baseDir, 'projects');
+        try {
+            for (const project of fs.readdirSync(projectsDir)) {
+                const projectPath = path.join(projectsDir, project);
+                if (!fs.statSync(projectPath).isDirectory())
+                    continue;
+                for (const stack of fs.readdirSync(projectPath)) {
+                    const logsPath = path.join(projectPath, stack, 'logs');
+                    if (!fs.existsSync(logsPath))
+                        continue;
+                    for (const app of fs.readdirSync(logsPath)) {
+                        const appLog = path.join(logsPath, app, 'app.log');
+                        if (fs.existsSync(appLog))
+                            apps.push(`${project}/${stack}/${app}`);
+                    }
+                }
+            }
+        }
+        catch { /* dir may not exist */ }
+        return apps;
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    parseSize(size) {
+        const match = size.match(/^(\d+(?:\.\d+)?)\s*(b|kb|mb|gb|tb)$/i);
+        if (!match)
+            return 10 * 1024 * 1024;
+        const value = parseFloat(match[1]);
+        const unit = match[2].toLowerCase();
+        const multipliers = {
+            b: 1, kb: 1024, mb: 1024 * 1024, gb: 1024 * 1024 * 1024, tb: 1024 * 1024 * 1024 * 1024,
+        };
+        return Math.floor(value * (multipliers[unit] ?? 1024 * 1024));
+    }
+    parseLine(app, line) {
+        try {
+            const parsed = JSON.parse(line);
+            return {
+                timestamp: parsed.time ? new Date(parsed.time).getTime() : Date.now(),
+                app,
+                level: this.pinoLevelToString(parsed.level ?? 30),
+                message: parsed.msg ?? line,
+                data: parsed,
+            };
+        }
+        catch {
+            return { timestamp: Date.now(), app, level: 'info', message: line };
+        }
+    }
+    pinoLevelToString(level) {
+        if (level <= 10)
+            return 'trace';
+        if (level <= 20)
+            return 'debug';
+        if (level <= 30)
+            return 'info';
+        if (level <= 40)
+            return 'warn';
+        if (level <= 50)
+            return 'error';
+        return 'fatal';
+    }
+}
+//# sourceMappingURL=log-manager.js.map

package/dist/monitoring/log-manager.js.map

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

package/dist/monitoring/metrics.service.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MetricsService — Aggregates process metrics from PM module
+ *
+ * Delegates to OrchestratorService.getMetrics() which fetches live data
+ * from PM for bootstrap-mode apps and returns cached data for classic-mode.
+ */
+import type { AggregatedMetricsDto } from '../config/types.js';
+import type { OrchestratorService } from '../orchestrator/orchestrator.service.js';
+export declare class MetricsService {
+    private readonly orchestrator;
+    constructor(orchestrator: OrchestratorService);
+    getMetrics(appName?: string): Promise<AggregatedMetricsDto>;
+}
+//# sourceMappingURL=metrics.service.d.ts.map

package/dist/monitoring/metrics.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.service.d.ts","sourceRoot":"","sources":["../../src/monitoring/metrics.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEnF,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,mBAAmB;IAExD,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA2BlE"}

package/dist/monitoring/metrics.service.js

@@ -0,0 +1,40 @@
+/**
+ * MetricsService — Aggregates process metrics from PM module
+ *
+ * Delegates to OrchestratorService.getMetrics() which fetches live data
+ * from PM for bootstrap-mode apps and returns cached data for classic-mode.
+ */
+export class MetricsService {
+    orchestrator;
+    constructor(orchestrator) {
+        this.orchestrator = orchestrator;
+    }
+    async getMetrics(appName) {
+        const raw = await this.orchestrator.getMetrics(appName);
+        const apps = {};
+        let totalCpu = 0;
+        let totalMemory = 0;
+        for (const [name, metrics] of Object.entries(raw)) {
+            const m = metrics ?? { cpu: 0, memory: 0 };
+            const entry = {
+                cpu: m.cpu,
+                memory: m.memory,
+            };
+            if (m.requests != null)
+                entry.requests = m.requests;
+            if (m.errors != null)
+                entry.errors = m.errors;
+            if (m.latency)
+                entry.latency = { p50: m.latency.p50, p95: m.latency.p95, p99: m.latency.p99, mean: m.latency.mean };
+            apps[name] = entry;
+            totalCpu += m.cpu;
+            totalMemory += m.memory;
+        }
+        return {
+            timestamp: Date.now(),
+            apps,
+            totals: { cpu: totalCpu, memory: totalMemory },
+        };
+    }
+}
+//# sourceMappingURL=metrics.service.js.map

package/dist/monitoring/metrics.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.service.js","sourceRoot":"","sources":["../../src/monitoring/metrics.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,YAAiC;QAAjC,iBAAY,GAAZ,YAAY,CAAqB;IAAG,CAAC;IAElE,KAAK,CAAC,UAAU,CAAC,OAAgB;QAC/B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,IAAI,GAAiC,EAAE,CAAC;QAC9C,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,CAAC,GAAG,OAAO,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAyC;gBAClD,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,MAAM,EAAE,CAAC,CAAC,MAAM;aACjB,CAAC;YACF,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI;gBAAE,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;YACpD,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI;gBAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;YAC9C,IAAI,CAAC,CAAC,OAAO;gBACX,KAAK,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACvG,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YACnB,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;YAClB,WAAW,IAAI,CAAC,CAAC,MAAM,CAAC;QAC1B,CAAC;QAED,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI;YACJ,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;SAC/C,CAAC;IACJ,CAAC;CACF"}

package/dist/orchestrator/app-handle.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AppHandle — Runtime handle for a managed application process
+ *
+ * Stores the PM supervisor (bootstrap mode) or raw ChildProcess (classic mode)
+ * along with app-level metadata.
+ */
+import type { ChildProcess } from 'node:child_process';
+import type { IProcessMetrics, IHealthStatus } from '@omnitron-dev/titan-pm';
+import type { ProcessSupervisor } from '@omnitron-dev/titan-pm';
+import type { AppStatus, IEcosystemAppEntry, IProcessEntry } from '../config/types.js';
+import type { ServiceRouter } from './service-router.js';
+export declare class AppHandle {
+    readonly entry: IEcosystemAppEntry;
+    readonly mode: 'classic' | 'bootstrap';
+    pid: number | null;
+    status: AppStatus;
+    startedAt: number;
+    restarts: number;
+    port: number | null;
+    lastMetrics: IProcessMetrics | null;
+    lastHealth: IHealthStatus | null;
+    /** PM supervisor managing this app's processes (bootstrap mode) */
+    supervisor: ProcessSupervisor | null;
+    /** The raw child_process.ChildProcess (classic mode only) */
+    childProcess: ChildProcess | null;
+    /** Instance count for scaling */
+    instanceCount: number;
+    /** Netron-native service router for topology */
+    serviceRouter: ServiceRouter | null;
+    /** Process topology entries from defineSystem() */
+    topologyProcesses: IProcessEntry[] | null;
+    /** Timer for classic-mode crash restart backoff (cleared on explicit stop) */
+    crashRestartTimer: ReturnType<typeof setTimeout> | null;
+    /** Stdout/stderr log buffer (ring buffer) */
+    private logBuffer;
+    private readonly maxLogLines;
+    constructor(entry: IEcosystemAppEntry, mode: 'classic' | 'bootstrap');
+    get name(): string;
+    get uptime(): number;
+    get cpu(): number;
+    get memory(): number;
+    appendLog(line: string): void;
+    getLogs(lines?: number): string[];
+    markStarting(): void;
+    markOnline(pid: number): void;
+    markStopping(): void;
+    markStopped(): void;
+    markErrored(): void;
+    markCrashed(): void;
+}
+//# sourceMappingURL=app-handle.d.ts.map

package/dist/orchestrator/app-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-handle.d.ts","sourceRoot":"","sources":["../../src/orchestrator/app-handle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,SAAS;aAgCF,KAAK,EAAE,kBAAkB;aACzB,IAAI,EAAE,SAAS,GAAG,WAAW;IAhCxC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1B,MAAM,EAAE,SAAS,CAAa;IAC9B,SAAS,EAAE,MAAM,CAAK;IACtB,QAAQ,EAAE,MAAM,CAAK;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC3B,WAAW,EAAE,eAAe,GAAG,IAAI,CAAQ;IAC3C,UAAU,EAAE,aAAa,GAAG,IAAI,CAAQ;IAE/C,mEAAmE;IAC5D,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAEnD,6DAA6D;IACtD,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEhD,iCAAiC;IAC1B,aAAa,EAAE,MAAM,CAAK;IAEjC,gDAAgD;IACzC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAElD,mDAAmD;IAC5C,iBAAiB,EAAE,aAAa,EAAE,GAAG,IAAI,CAAQ;IAExD,8EAA8E;IACvE,iBAAiB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAQ;IAEtE,6CAA6C;IAC7C,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAGlB,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,SAAS,GAAG,WAAW;IAG/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO7B,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAKjC,YAAY,IAAI,IAAI;IAKpB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7B,YAAY,IAAI,IAAI;IAIpB,WAAW,IAAI,IAAI;IAWnB,WAAW,IAAI,IAAI;IAInB,WAAW,IAAI,IAAI;CAIpB"}

package/dist/orchestrator/app-handle.js

@@ -0,0 +1,90 @@
+/**
+ * AppHandle — Runtime handle for a managed application process
+ *
+ * Stores the PM supervisor (bootstrap mode) or raw ChildProcess (classic mode)
+ * along with app-level metadata.
+ */
+export class AppHandle {
+    entry;
+    mode;
+    pid = null;
+    status = 'stopped';
+    startedAt = 0;
+    restarts = 0;
+    port = null;
+    lastMetrics = null;
+    lastHealth = null;
+    /** PM supervisor managing this app's processes (bootstrap mode) */
+    supervisor = null;
+    /** The raw child_process.ChildProcess (classic mode only) */
+    childProcess = null;
+    /** Instance count for scaling */
+    instanceCount = 1;
+    /** Netron-native service router for topology */
+    serviceRouter = null;
+    /** Process topology entries from defineSystem() */
+    topologyProcesses = null;
+    /** Timer for classic-mode crash restart backoff (cleared on explicit stop) */
+    crashRestartTimer = null;
+    /** Stdout/stderr log buffer (ring buffer) */
+    logBuffer = [];
+    maxLogLines = 1000;
+    constructor(entry, mode) {
+        this.entry = entry;
+        this.mode = mode;
+    }
+    get name() {
+        return this.entry.name;
+    }
+    get uptime() {
+        if (this.status !== 'online' || !this.startedAt)
+            return 0;
+        return Date.now() - this.startedAt;
+    }
+    get cpu() {
+        return this.lastMetrics?.cpu ?? 0;
+    }
+    get memory() {
+        return this.lastMetrics?.memory ?? 0;
+    }
+    appendLog(line) {
+        this.logBuffer.push(line);
+        if (this.logBuffer.length > this.maxLogLines) {
+            this.logBuffer.shift();
+        }
+    }
+    getLogs(lines) {
+        if (!lines)
+            return [...this.logBuffer];
+        return this.logBuffer.slice(-lines);
+    }
+    markStarting() {
+        this.status = 'starting';
+        this.startedAt = Date.now();
+    }
+    markOnline(pid) {
+        this.status = 'online';
+        this.pid = pid;
+    }
+    markStopping() {
+        this.status = 'stopping';
+    }
+    markStopped() {
+        this.status = 'stopped';
+        this.pid = null;
+        this.childProcess = null;
+        this.supervisor = null;
+        if (this.crashRestartTimer) {
+            clearTimeout(this.crashRestartTimer);
+            this.crashRestartTimer = null;
+        }
+    }
+    markErrored() {
+        this.status = 'errored';
+    }
+    markCrashed() {
+        this.status = 'crashed';
+        this.restarts++;
+    }
+}
+//# sourceMappingURL=app-handle.js.map

package/dist/orchestrator/app-handle.js.map

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

package/dist/orchestrator/bootstrap-loader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Bootstrap Loader — Load defineSystem() config from a bootstrap file
+ *
+ * Resolution strategy depends on context:
+ *
+ * **Production / daemon process:**
+ *   1. Prefer compiled dist/bootstrap.js (no tsx/decorator issues, faster import)
+ *   2. Fall back to source .ts if dist/ doesn't exist (Bun, or tsx loaded)
+ *
+ * **Dev mode (child processes with tsx):**
+ *   Always load from source .ts so that code changes are picked up immediately
+ *   without requiring a separate build step. tsx handles transpilation on the fly.
+ *
+ * **Cache:**
+ *   Topology definitions are cached in the daemon process since they don't change
+ *   at runtime. The cache is explicitly cleared before each dev-mode restart via
+ *   `clearCache()` so that topology changes (adding processes, etc.) are picked up.
+ *   Child processes always get a fresh Node.js module graph (separate fork).
+ */
+import type { IAppDefinition } from '../config/types.js';
+/**
+ * Clear all cached bootstrap definitions.
+ * Called by orchestrator before restarting apps in dev mode so that
+ * topology changes (new processes, removed workers, etc.) are detected.
+ */
+export declare function clearCache(): void;
+/**
+ * Clear cached bootstrap definition for a specific app.
+ */
+export declare function clearCacheFor(bootstrapPath: string): void;
+export interface LoadBootstrapOptions {
+    /** Skip cache and prefer source .ts over compiled dist/ */
+    devMode?: boolean;
+}
+export declare function loadBootstrapConfig(bootstrapPath: string, options?: LoadBootstrapOptions): Promise<IAppDefinition>;
+//# sourceMappingURL=bootstrap-loader.d.ts.map

package/dist/orchestrator/bootstrap-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-loader.d.ts","sourceRoot":"","sources":["../../src/orchestrator/bootstrap-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAEzD;AA6BD,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAyDzB"}