@omnitron-dev/omnitron 0.1.1

package/dist/orchestrator/module-worker-process.js

@@ -0,0 +1,187 @@
+/**
+ * Module Worker Process — @Process-compatible class for PM worker-runtime
+ *
+ * Generic entry point for module-based worker topology entries.
+ * Worker-runtime creates an instance, calls init(bootstrapPath, processName),
+ * and this class:
+ *   1. Loads the app definition from the bootstrap file (same as bootstrap-process)
+ *   2. Finds the matching topology entry by processName
+ *   3. Creates a Titan Application with the entry's module
+ *   4. Finds the @Service-decorated provider in the module
+ *   5. Dynamically exposes all service methods via Netron RPC
+ *
+ * This replaces the need for each worker to have its own @Process-decorated
+ * entry point file. All DI, config, Redis, DB connections are handled by
+ * the module's imports (ConfigModule, DatabaseModule, etc.).
+ */
+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 'reflect-metadata';
+import path from 'node:path';
+import { Application } from '@omnitron-dev/titan';
+import { loadBootstrapConfig } from './bootstrap-loader.js';
+// Inline PM decorator metadata — avoids importing the full PM module which
+// deadlocks when loaded from source (.ts) alongside the dist-loaded worker-runtime.
+const PROCESS_METADATA_KEY = Symbol.for('process:metadata');
+const PROCESS_METHOD_METADATA_KEY = Symbol.for('process:method:metadata');
+function Process(options = {}) {
+    return (target) => {
+        const metadata = { ...options, target, isProcess: true, methods: new Map() };
+        Reflect.defineMetadata(PROCESS_METADATA_KEY, metadata, target);
+        const prototype = target.prototype;
+        for (const prop of Object.getOwnPropertyNames(prototype)) {
+            if (prop === 'constructor')
+                continue;
+            const desc = Object.getOwnPropertyDescriptor(prototype, prop);
+            if (!desc || typeof desc.value !== 'function')
+                continue;
+            let m = Reflect.getMetadata(PROCESS_METHOD_METADATA_KEY, prototype, prop);
+            if (options.allMethodsPublic && !m) {
+                m = { public: true };
+                Reflect.defineMetadata(PROCESS_METHOD_METADATA_KEY, m, prototype, prop);
+            }
+            if (m) {
+                if (options.allMethodsPublic)
+                    m.public = true;
+                metadata.methods.set(prop, m);
+            }
+        }
+        return target;
+    };
+}
+function OnShutdown() {
+    return (target, propertyKey, _descriptor) => {
+        const m = Reflect.getMetadata(PROCESS_METHOD_METADATA_KEY, target, propertyKey) || {};
+        m.onShutdown = true;
+        m.public = true;
+        Reflect.defineMetadata(PROCESS_METHOD_METADATA_KEY, m, target, propertyKey);
+    };
+}
+// Netron service metadata key (used by @Service decorator)
+const SERVICE_METADATA_KEY = Symbol.for('titan:service:metadata');
+/**
+ * Find the @Service-decorated provider in a module's providers list.
+ * Walks the module metadata to find classes with @Service decoration.
+ */
+function findServiceProviders(ModuleClass) {
+    const moduleMetadata = Reflect.getMetadata(Symbol.for('titan:module:metadata'), ModuleClass);
+    if (!moduleMetadata)
+        return [];
+    const providers = moduleMetadata.providers ?? [];
+    const serviceProviders = [];
+    for (const provider of providers) {
+        // Handle class providers (direct class reference)
+        const target = typeof provider === 'function' ? provider : provider?.useClass;
+        if (target && Reflect.getMetadata(SERVICE_METADATA_KEY, target)) {
+            serviceProviders.push(target);
+        }
+    }
+    return serviceProviders;
+}
+let ModuleWorkerProcess = class ModuleWorkerProcess {
+    app = null;
+    service = null;
+    /**
+     * Initialize by loading the bootstrap config and creating a Titan Application
+     * with the topology entry's module.
+     *
+     * Called by worker-runtime with dependencies from spawnOptions:
+     *   init(deps)
+     *
+     * @param deps - Structured dependencies from orchestrator
+     */
+    async init(deps) {
+        const { bootstrapPath, processName } = deps;
+        // In dev mode (tsx loaded via --import), prefer source .ts over compiled dist/
+        const hasTsx = (process.execArgv ?? []).some((a) => a.includes('tsx'));
+        const definition = await loadBootstrapConfig(bootstrapPath, { devMode: hasTsx });
+        // Find the matching topology entry
+        const topologyEntry = definition.processes?.find((p) => p.name === processName);
+        if (!topologyEntry) {
+            throw new Error(`Topology entry '${processName}' not found in bootstrap: ${bootstrapPath}`);
+        }
+        if (!topologyEntry.module) {
+            throw new Error(`Topology entry '${processName}' has no module — use script-based process instead`);
+        }
+        // Import the module from the entry's file path (relative to bootstrap dir)
+        const modulePath = path.resolve(path.dirname(bootstrapPath), topologyEntry.module);
+        const moduleFile = await import(modulePath);
+        const ModuleClass = moduleFile.default ?? moduleFile;
+        // Create Titan Application with the worker module
+        this.app = await Application.create(ModuleClass, {
+            name: `${definition.name}/${processName}`,
+        });
+        // Find and resolve the @Service provider from the module
+        const serviceProviders = findServiceProviders(ModuleClass);
+        if (serviceProviders.length > 0) {
+            // Resolve the first @Service provider from the DI container
+            this.service = await this.app.container.resolveAsync(serviceProviders[0]);
+        }
+        else {
+            // Fallback: try to find any injectable class that isn't a built-in module
+            // This handles cases where the service isn't decorated with @Service
+            const moduleMetadata = Reflect.getMetadata(Symbol.for('titan:module:metadata'), ModuleClass);
+            const providers = moduleMetadata?.providers ?? [];
+            for (const provider of providers) {
+                const target = typeof provider === 'function' ? provider : null;
+                if (target) {
+                    try {
+                        this.service = await this.app.container.resolveAsync(target);
+                        break;
+                    }
+                    catch {
+                        // Not resolvable, skip
+                    }
+                }
+            }
+        }
+        if (!this.service) {
+            throw new Error(`No service provider found in module: ${ModuleClass.name}`);
+        }
+        // Dynamically expose all service methods on this process instance
+        const proto = Object.getPrototypeOf(this.service);
+        for (const prop of Object.getOwnPropertyNames(proto)) {
+            if (prop === 'constructor')
+                continue;
+            const desc = Object.getOwnPropertyDescriptor(proto, prop);
+            if (desc && typeof desc.value === 'function') {
+                if (!(prop in this)) {
+                    this[prop] = (...args) => this.service[prop](...args);
+                }
+            }
+        }
+    }
+    async shutdown() {
+        // Call service shutdown if available
+        if (this.service?.shutdown) {
+            try {
+                await this.service.shutdown();
+            }
+            catch {
+                // Best-effort
+            }
+        }
+        if (this.app) {
+            await this.app.stop();
+            this.app = null;
+        }
+    }
+};
+__decorate([
+    OnShutdown(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ModuleWorkerProcess.prototype, "shutdown", null);
+ModuleWorkerProcess = __decorate([
+    Process({ name: 'ModuleWorker', allMethodsPublic: true })
+], ModuleWorkerProcess);
+export default ModuleWorkerProcess;
+//# sourceMappingURL=module-worker-process.js.map

package/dist/orchestrator/module-worker-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-worker-process.js","sourceRoot":"","sources":["../../src/orchestrator/module-worker-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,2EAA2E;AAC3E,oFAAoF;AACpF,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAC5D,MAAM,2BAA2B,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAE1E,SAAS,OAAO,CAAC,UAAyD,EAAE;IAC1E,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;QAC7E,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,IAAI,IAAI,KAAK,aAAa;gBAAE,SAAS;YACrC,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU;gBAAE,SAAS;YACxD,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,2BAA2B,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YAC1E,IAAI,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC;gBACnC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACrB,OAAO,CAAC,cAAc,CAAC,2BAA2B,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,CAAC,EAAE,CAAC;gBACN,IAAI,OAAO,CAAC,gBAAgB;oBAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;gBAC9C,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,CAAC,MAAW,EAAE,WAA4B,EAAE,WAA+B,EAAE,EAAE;QACpF,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,2BAA2B,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QACtF,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;QAChB,OAAO,CAAC,cAAc,CAAC,2BAA2B,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9E,CAAC,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAElE;;;GAGG;AACH,SAAS,oBAAoB,CAAC,WAAgB;IAC5C,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,CAAC;IAC7F,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,CAAC;IAE/B,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,IAAI,EAAE,CAAC;IACjD,MAAM,gBAAgB,GAAU,EAAE,CAAC;IAEnC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,kDAAkD;QAClD,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC9E,IAAI,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,EAAE,CAAC;YAChE,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAGD,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IACf,GAAG,GAAuB,IAAI,CAAC;IAC/B,OAAO,GAAQ,IAAI,CAAC;IAE5B;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAC,IAAoD;QAC7D,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;QAC5C,+EAA+E;QAC/E,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEjF,mCAAmC;QACnC,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAChF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mBAAmB,WAAW,6BAA6B,aAAa,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,mBAAmB,WAAW,oDAAoD,CAAC,CAAC;QACtG,CAAC;QAED,2EAA2E;QAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC;QAErD,kDAAkD;QAClD,IAAI,CAAC,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE;YAC/C,IAAI,EAAE,GAAG,UAAU,CAAC,IAAI,IAAI,WAAW,EAAE;SAC1C,CAAC,CAAC;QAEH,yDAAyD;QACzD,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,4DAA4D;YAC5D,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,0EAA0E;YAC1E,qEAAqE;YACrE,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,CAAC;YAC7F,MAAM,SAAS,GAAG,cAAc,EAAE,SAAS,IAAI,EAAE,CAAC;YAClD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAChE,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC;wBACH,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;wBAC7D,MAAM;oBACR,CAAC;oBAAC,MAAM,CAAC;wBACP,uBAAuB;oBACzB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,wCAAwC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,kEAAkE;QAClE,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IAAI,IAAI,KAAK,aAAa;gBAAE,SAAS;YACrC,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC1D,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC7C,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;oBACnB,IAAY,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAGK,AAAN,KAAK,CAAC,QAAQ;QACZ,qCAAqC;QACrC,IAAI,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAA;AAdO;IADL,UAAU,EAAE;;;;mDAcZ;AA7FG,mBAAmB;IADxB,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;GACpD,mBAAmB,CA8FxB;AAED,eAAe,mBAAmB,CAAC"}

package/dist/orchestrator/orchestrator.service.d.ts

@@ -0,0 +1,170 @@
+/**
+ * OrchestratorService — Core orchestration logic
+ *
+ * Thin orchestration layer over Titan PM module's ProcessSupervisor:
+ *
+ * Bootstrap mode:
+ *   - Each app gets a ProcessSupervisor via pm.supervisor(config)
+ *   - Supervisor manages all child lifecycle: spawn, health, metrics, crash recovery, restart
+ *   - Single or multi-instance (pool) — configured via ISupervisorChildConfig
+ *   - Scaling delegates to supervisor.scaleChild()
+ *
+ * Classic mode:
+ *   - child_process.fork() with manual exit handling (legacy compat)
+ *   - Real CPU/memory metrics via pidusage
+ *
+ * Architecture:
+ *   pm.supervisor({ children: [{ process: bootstrap-process.js, ... }] })
+ *     → ProcessSupervisor.fromConfig() → pm.spawn() or pm.pool() per child
+ *     → fork-worker.js → worker-runtime.js → BootstrapProcess.init(...)
+ *     → Full Titan Application inside each worker
+ *     → Two Netron instances: PM management plane + app HTTP data plane
+ */
+import type { ILogger } from '@omnitron-dev/titan/module/logger';
+import { type ProcessManager, type IProcessMetrics, type IHealthStatus } from '@omnitron-dev/titan-pm';
+import { EventEmitter } from '@omnitron-dev/eventemitter';
+import type { MetricSample } from '@omnitron-dev/titan-metrics';
+import type { IEcosystemConfig, IEcosystemAppEntry, ProcessInfoDto, AppStatus } from '../config/types.js';
+import { AppHandle } from './app-handle.js';
+import type { StateStore } from '../daemon/state-store.js';
+import type { Netron } from '@omnitron-dev/titan/netron';
+export declare class OrchestratorService extends EventEmitter {
+    private readonly logger;
+    private readonly pm;
+    private readonly stateStore;
+    private readonly handles;
+    private config;
+    private readonly cwd;
+    private metricsTimer;
+    private readonly appLogHandlers;
+    /** Dev mode — when true, child processes are bundled from source .ts via esbuild */
+    devMode: boolean;
+    /** esbuild bundling pipeline — pre-bundles TS entry points for child processes */
+    private buildService;
+    /** Cached build results per app name */
+    private readonly buildResults;
+    /** Daemon's Netron instance for native service routing */
+    private daemonNetron;
+    /** Daemon Unix socket path for child-to-daemon Netron connections */
+    private daemonSocketPath;
+    constructor(logger: ILogger, pm: ProcessManager, stateStore: StateStore, cwd?: string);
+    /**
+     * Set the daemon Netron instance and socket path for native topology routing.
+     * Called by the daemon after start when Netron is available.
+     */
+    setDaemonNetron(netron: Netron, socketPath: string): void;
+    startAll(config: IEcosystemConfig): Promise<void>;
+    startApp(entry: IEcosystemAppEntry, config?: IEcosystemConfig): Promise<AppHandle>;
+    stopApp(name: string, force?: boolean, timeout?: number): Promise<void>;
+    stopAll(force?: boolean): Promise<number>;
+    restartApp(name: string): Promise<AppHandle>;
+    /**
+     * Resolve raw app name to its handle key.
+     * In stack mode, handles are namespaced (e.g., 'omni/dev/main' for app 'main').
+     * This finds the handle whose key ends with the raw app name.
+     */
+    resolveAppName(rawName: string): string | undefined;
+    /**
+     * Reload app with zero-downtime strategy:
+     *   1. Fork new process(es) with same config
+     *   2. Wait for new process to report 'ready'
+     *   3. Stop old process (drain in-flight requests)
+     *   4. If new process fails, keep old one and report error
+     *
+     * Falls back to regular restart for classic mode apps or when
+     * zero-downtime is not possible (single-process, no supervisor).
+     */
+    reloadApp(name: string): Promise<AppHandle>;
+    /**
+     * Wait for a child process to report healthy status within a timeout.
+     * Returns true if healthy, false if timeout exceeded.
+     */
+    private waitForChildHealth;
+    scaleApp(name: string, instances: number): Promise<AppHandle>;
+    list(filter?: {
+        prefix?: string;
+    }): ProcessInfoDto[];
+    getApp(name: string): ProcessInfoDto | null;
+    getHandle(name: string): AppHandle | undefined;
+    /**
+     * List all handle names matching a prefix.
+     * Used by ProjectService to find apps belonging to a specific stack.
+     */
+    listHandleNames(prefix?: string): string[];
+    getWorkerHandle(processId: string): import("@omnitron-dev/titan-pm").IWorkerHandle | undefined;
+    getMetrics(name?: string): Promise<Record<string, IProcessMetrics | null>>;
+    getHealth(name?: string): Promise<Record<string, IHealthStatus | null>>;
+    /**
+     * Drain pre-built MetricSample[] from all children.
+     * Each child runs its own MetricsCollector and buffers MetricSample[];
+     * this method pulls and clears those buffers via Netron RPC.
+     */
+    drainChildSamples(): Promise<Array<{
+        app: string;
+        samples: MetricSample[];
+    }>>;
+    /**
+     * Toggle RPC metrics collection on child processes at runtime.
+     * When disabled, the instrumented wrapper becomes a zero-overhead passthrough.
+     */
+    setMetricsEnabled(name: string | undefined, enabled: boolean): Promise<void>;
+    getLogs(name?: string, lines?: number): Array<{
+        app: string;
+        lines: string[];
+    }>;
+    /**
+     * Get app status (or undefined if not tracked).
+     */
+    getAppStatus(name: string): AppStatus | undefined;
+    /**
+     * Register a handler that receives every log line from managed apps.
+     * Used by LogManager to persist logs to disk with rotation.
+     */
+    onAppLog(handler: (appName: string, line: string) => void): void;
+    private launchClassicMode;
+    /**
+     * Launch bootstrap app via PM ProcessSupervisor.
+     *
+     * If the app's defineSystem() declares a `processes` topology, Omnitron creates
+     * all topology children (server + worker pools) and wires IPC relay between them.
+     * Otherwise, creates a single bootstrap-process as before.
+     */
+    private launchBootstrapMode;
+    /**
+     * Launch app with process topology — multiple children managed by Omnitron.
+     *
+     * All processes use BOOTSTRAP_PROCESS_PATH with { bootstrapPath, processName } dependencies.
+     * The BootstrapProcess finds its own entry, imports the module, and wires transports.
+     *
+     * Processes with `instances > 1` are launched as PM pools with load balancing.
+     * Processes with `topology.access` get Netron-native proxies via daemon socket.
+     * Processes with `topology.expose` auto-expose their @Service on daemon Netron.
+     *
+     * Service metadata is auto-discovered from pool workers — no manual `exports`
+     * config needed. The @Service decorator on the worker IS the source of truth.
+     */
+    private launchTopology;
+    /**
+     * Launch single-process bootstrap app (no topology — original behavior).
+     */
+    private launchSingleProcess;
+    /**
+     * Wire common supervisor events (crash, restart, escalate) and log capture.
+     */
+    private wireSupervisorEvents;
+    /**
+     * Attach log capture to a child process's WorkerHandle.
+     * Routes child stdout/stderr lines to AppHandle ring buffer for `getLogs()`.
+     */
+    private attachLogCapture;
+    private stopChildProcess;
+    private handleClassicCrash;
+    private calculateBackoff;
+    /** Sample CPU/memory for a single OS process via `ps` (async — does not block event loop) */
+    private sampleProcessMetrics;
+    /** Periodic metrics polling for classic mode processes */
+    private startMetricsPolling;
+    private toProcessInfo;
+    private persistState;
+}
+//# sourceMappingURL=orchestrator.service.d.ts.map

package/dist/orchestrator/orchestrator.service.d.ts.map

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