@omnitron-dev/omnitron 0.3.0 → 0.3.1

package/dist/orchestrator/http-routes.js

@@ -0,0 +1,19 @@
+/** Adapt declared methods and pathnames to Titan's ordered, null-fallthrough handlers. */
+export function compileCustomRoutes(routes) {
+    return routes.map((route) => {
+        // Titan accepts fall-through handlers, while defineSystem declares routes.
+        // Preserve the method and pathname boundary when adapting between them.
+        const pattern = new RegExp('^' +
+            route.pattern
+                .split('*')
+                .map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
+                .join('.*') +
+            '$');
+        return async (request) => {
+            if (request.method !== route.method || !pattern.test(new URL(request.url).pathname))
+                return null;
+            return route.handler(request);
+        };
+    });
+}
+//# sourceMappingURL=http-routes.js.map

package/dist/orchestrator/http-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-routes.js","sourceRoot":"","sources":["../../src/orchestrator/http-routes.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,UAAU,mBAAmB,CACjC,MAAkD;IAElD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,2EAA2E;QAC3E,wEAAwE;QACxE,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,GAAG;YACD,KAAK,CAAC,OAAO;iBACV,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;iBAC1D,IAAI,CAAC,IAAI,CAAC;YACb,GAAG,CACN,CAAC;QACF,OAAO,KAAK,EAAE,OAAgB,EAAE,EAAE;YAChC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YACjG,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -108,6 +108,19 @@ export declare class OrchestratorService extends EventEmitter {
     devMode: boolean;
     /** esbuild bundling pipeline — pre-bundles TS entry points for child processes */
     private buildService;
+    private watchDisabled;
+    private watchSelection;
+    private readonly bootstrapSources;
+    private allowsWatch;
+    /** One policy for both fs.watch and esbuild; disabling does not stop apps. */
+    setWatchMode(enabled: boolean, apps?: string[]): Promise<void>;
+    getBuildWatchedApps(): Array<{
+        name: string;
+        directory: string;
+    }>;
+    private syncBootstrapWatch;
+    /** Automatic triggers remain revocable while queued; manual restart is independent. */
+    restartAfterChange(name: string): Promise<AppHandle | undefined>;
     /** Cached build results per app name */
     private readonly buildResults;
     /**
@@ -297,7 +310,7 @@ export declare class OrchestratorService extends EventEmitter {
      * `topologyPools` — so `supervisor.stop()` never reached them, and nothing
      * in the orchestrator destroyed a pool: only the daemon's own shutdown did.
      * Every restart of an app with `instances > 1` left the previous workers
-     * running. On daos/test (2026-09-25): priceverse's `ohlcv-aggregator` and
+     * running. On sample/test (2026-09-25): quotes's `ohlcv-aggregator` and
      * storage's `transform` in three generations at once.
      *
      * The pools go even when the supervisor's stop throws: a stop that failed
@@ -321,7 +334,7 @@ export declare class OrchestratorService extends EventEmitter {
      * `restartApp` starts from this. `false` when nothing by that name runs
      * here. See `AppHandle.redefine`.
      */
-    redefineApp(name: string, entry: IEcosystemAppEntry): boolean;
+    redefineApp(name: string, entry: IEcosystemAppEntry): Promise<boolean>;
     /**
      * Restart an app, coalescing concurrent triggers.
      *
@@ -463,7 +476,7 @@ export declare class OrchestratorService extends EventEmitter {
     } | null>;
     /**
      * `name` is resolved like every other per-app question (`main` finds
-     * `daos/dev/main`); it was compared verbatim, so `omnitron metrics main`
+     * `sample/dev/main`); it was compared verbatim, so `omnitron metrics main`
      * printed «(no data)». An unknown name answers `{}`, and the caller says so.
      */
     getMetrics(name?: string): Promise<Record<string, IProcessMetrics | null>>;
@@ -472,7 +485,7 @@ export declare class OrchestratorService extends EventEmitter {
      * children and its worker pools — and combined (`app-health.ts`).
      *
      * `name` is resolved like every other per-app question: `main` finds
-     * `daos/dev/main`. It was compared verbatim, so `omnitron health main`
+     * `sample/dev/main`. It was compared verbatim, so `omnitron health main`
      * matched nothing and the answer was empty. An unknown name answers `{}`,
      * and the caller says so.
      */
@@ -513,6 +526,7 @@ export declare class OrchestratorService extends EventEmitter {
      * Otherwise, creates a single bootstrap-process as before.
      */
     private launchBootstrapMode;
+    private prepareBootstrapBuild;
     /**
      * Launch app with process topology — multiple children managed by Omnitron.
      *

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

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

package/dist/orchestrator/orchestrator.service.js

@@ -229,6 +229,56 @@ export class OrchestratorService extends EventEmitter {
     devMode = false;
     /** esbuild bundling pipeline — pre-bundles TS entry points for child processes */
     buildService = null;
+    watchDisabled = false;
+    watchSelection = null;
+    bootstrapSources = new Map();
+    allowsWatch(entry) {
+        return this.devMode && !this.watchDisabled && entry.watch !== false &&
+            (!this.watchSelection || this.watchSelection.has(entry.name));
+    }
+    /** One policy for both fs.watch and esbuild; disabling does not stop apps. */
+    async setWatchMode(enabled, apps) {
+        this.watchDisabled = !enabled;
+        this.watchSelection = apps ? new Set(apps.map((name) => this.resolveAppName(name) ?? name)) : null;
+        for (const [name, state] of this.restartCoalescer) {
+            if (!enabled || !this.handles.get(name) || !this.allowsWatch(this.handles.get(name).entry))
+                state.watchSerial = 0;
+        }
+        await Promise.all([...this.bootstrapSources.keys()].map((name) => this.syncBootstrapWatch(name)));
+    }
+    getBuildWatchedApps() {
+        return [...this.bootstrapSources].filter(([name]) => this.buildService?.isWatching(name))
+            .map(([name, source]) => ({ name, directory: path.dirname(source.path) }));
+    }
+    async syncBootstrapWatch(name) {
+        const source = this.bootstrapSources.get(name);
+        const entry = this.handles.get(name)?.entry;
+        if (!this.buildService || !source)
+            return;
+        if (!entry || !this.allowsWatch(entry) || !entry.bootstrap ||
+            path.resolve(entry.cwd ?? this.cwd, entry.bootstrap) !== source.path) {
+            const state = this.restartCoalescer.get(name);
+            if (state)
+                state.watchSerial = 0;
+            await this.buildService.unwatchApp(name);
+            return;
+        }
+        if (this.buildService.isWatching(name))
+            return;
+        await this.buildService.watchApp(name, source.path, source.definition, () => {
+            void this.restartAfterChange(name).catch((error) => {
+                this.logger.error({ app: name, error: error.message }, 'Restart after source change failed');
+            });
+        });
+    }
+    /** Automatic triggers remain revocable while queued; manual restart is independent. */
+    async restartAfterChange(name) {
+        const canonical = this.resolveAppName(name) ?? name;
+        const handle = this.handles.get(canonical);
+        if (!handle || !this.allowsWatch(handle.entry))
+            return handle;
+        return this.restartAppCoalesced(canonical, true, 'watch');
+    }
     /** Cached build results per app name */
     buildResults = new Map();
     /**
@@ -686,7 +736,8 @@ export class OrchestratorService extends EventEmitter {
         //   - exact key already exists, online   → return it (idempotent)
         //   - exact key already exists, not online → fall through and re-launch
         //     under the same key
-        //   - DIFFERENT key with the same effective short name:
+        //   - different fully qualified keys are distinct apps and coexist
+        //   - bare/qualified keys with the same effective short name:
         //       - new is MORE specific (namespaced) and existing is bare → stop
         //         the bare one and re-launch under the namespaced key. Without
         //         this, a boot-race where bare-name auto-start beats the
@@ -696,13 +747,19 @@ export class OrchestratorService extends EventEmitter {
         //         restart by canonical name, not register an alias.
         const effective = effectiveAppName(entry.name);
         const newIsNamespaced = entry.name.includes('/');
+        if (!newIsNamespaced && [...this.handles.keys()].filter(key => key.includes('/') && effectiveAppName(key) === effective).length > 1) {
+            throw new Error(`Ambiguous app name '${entry.name}'; use its full project/stack/app identity`);
+        }
         for (const [key, h] of this.handles) {
             if (key === entry.name)
                 continue;
             if (effectiveAppName(key) !== effective)
                 continue;
             const existingIsNamespaced = key.includes('/');
-            // Same effective app under a different key.
+            // Qualified identities are separate deployments, even when their basename matches.
+            if (newIsNamespaced && existingIsNamespaced)
+                continue;
+            // A bare alias may still refer to the one qualified deployment.
             if (h.status === 'online') {
                 if (newIsNamespaced && !existingIsNamespaced) {
                     this.logger.info({ stale: key, replacing_with: entry.name, effective }, 'Stopping bare-name handle to re-register under namespaced key');
@@ -746,7 +803,7 @@ export class OrchestratorService extends EventEmitter {
         // crashing leaves its siblings — the server among them — up; and its pools
         // were never any supervisor's to stop. Stopped before the new handle
         // starts, or the new one finds its own predecessor on its port: on
-        // daos/test (2026-09-25) paysys's crash restarts failed five times on
+        // sample/test (2026-09-25) payments's crash restarts failed five times on
         // `EADDRINUSE :3004`, «held by … a child this daemon still accounts for».
         if (existing) {
             await this.releaseExposedServices(existing);
@@ -827,7 +884,7 @@ export class OrchestratorService extends EventEmitter {
      * `topologyPools` — so `supervisor.stop()` never reached them, and nothing
      * in the orchestrator destroyed a pool: only the daemon's own shutdown did.
      * Every restart of an app with `instances > 1` left the previous workers
-     * running. On daos/test (2026-09-25): priceverse's `ohlcv-aggregator` and
+     * running. On sample/test (2026-09-25): quotes's `ohlcv-aggregator` and
      * storage's `transform` in three generations at once.
      *
      * The pools go even when the supervisor's stop throws: a stop that failed
@@ -892,8 +949,6 @@ export class OrchestratorService extends EventEmitter {
         });
     }
     async stopAll(force = false) {
-        if (!this.config)
-            return 0;
         if (this.metricsTimer) {
             clearInterval(this.metricsTimer);
             this.metricsTimer = null;
@@ -906,7 +961,34 @@ export class OrchestratorService extends EventEmitter {
         let count = 0;
         // When force=true (daemon shutdown), use short timeout per app (3s SIGTERM, then SIGKILL)
         const perAppTimeout = force ? 3_000 : 10_000;
-        for (const batch of resolveShutdownOrder(this.config.apps)) {
+        // Registered projects need not belong to the daemon's root ecosystem.
+        // Ownership is defined by handles, not by whichever config booted first.
+        // Drain admitted starts before taking the shutdown graph snapshot.
+        await Promise.allSettled([...this.startingApps.values()]);
+        const entries = [...this.handles.values()].map((handle) => handle.entry);
+        const names = new Set(entries.map((entry) => entry.name));
+        const graph = entries.map((entry) => {
+            const scope = entry.name.slice(0, entry.name.lastIndexOf('/') + 1);
+            return {
+                ...entry,
+                dependsOn: (entry.dependsOn ?? []).flatMap((dependency) => {
+                    const name = !dependency.includes('/') && names.has(scope + dependency)
+                        ? scope + dependency : dependency;
+                    // A dependency never started here has no owned process to stop.
+                    return names.has(name) ? [name] : [];
+                }),
+            };
+        });
+        let batches;
+        try {
+            batches = resolveShutdownOrder(graph);
+        }
+        catch (error) {
+            // Invalid reconfiguration must not turn shutdown into leaked children.
+            this.logger.error({ error: error.message }, 'Invalid shutdown graph; stopping every owned app');
+            batches = [entries];
+        }
+        for (const batch of batches) {
             await Promise.all(batch.map(async (entry) => {
                 try {
                     await this.stopApp(entry.name, force, perAppTimeout);
@@ -932,6 +1014,7 @@ export class OrchestratorService extends EventEmitter {
             this.buildService = null;
         }
         this.buildResults.clear();
+        this.bootstrapSources.clear();
         return count;
     }
     /**
@@ -940,11 +1023,17 @@ export class OrchestratorService extends EventEmitter {
      * `restartApp` starts from this. `false` when nothing by that name runs
      * here. See `AppHandle.redefine`.
      */
-    redefineApp(name, entry) {
+    async redefineApp(name, entry) {
         const handle = this.handles.get(this.resolveAppName(name) ?? name);
         if (!handle)
             return false;
         handle.redefine(entry);
+        if (!this.allowsWatch(entry)) {
+            const state = this.restartCoalescer.get(handle.name);
+            if (state)
+                state.watchSerial = 0;
+        }
+        await this.syncBootstrapWatch(handle.name);
         return true;
     }
     /**
@@ -980,7 +1069,7 @@ export class OrchestratorService extends EventEmitter {
      * triggers, just continuations — they must not bump or the trailing
      * coalesced restart would re-fire forever.
      */
-    async restartAppCoalesced(name, fromExternal) {
+    async restartAppCoalesced(name, fromExternal, cause = 'manual') {
         const canonical = this.resolveAppName(name) ?? name;
         const handle = this.handles.get(canonical);
         if (!handle) {
@@ -1037,9 +1126,19 @@ export class OrchestratorService extends EventEmitter {
         }
         name = canonical;
         const state = this.getCoalescerState(name);
-        if (fromExternal)
+        if (fromExternal) {
             state.triggerSerial += 1;
-        const observedSerial = state.triggerSerial;
+            if (cause === 'watch')
+                state.watchSerial = state.triggerSerial;
+            else
+                state.manualSerial = state.triggerSerial;
+        }
+        if (!this.allowsWatch(handle.entry) || ['errored', 'crashed', 'stopped', 'stopping'].includes(handle.status)) {
+            state.watchSerial = 0;
+        }
+        const observedSerial = Math.max(state.manualSerial, state.watchSerial);
+        if (observedSerial <= state.firedSerial)
+            return handle;
         // Cooldown: the app reported online recently. Wait it out, then
         // proceed as a non-external continuation (we already counted this
         // trigger when we first arrived).
@@ -1068,7 +1167,7 @@ export class OrchestratorService extends EventEmitter {
         }
         // Take the slot. Capture which serial this run is consuming —
         // anything bumped after this is the next run's problem.
-        const consumedSerial = state.triggerSerial;
+        const consumedSerial = observedSerial;
         const promise = this.restartAppNow(name);
         state.inFlight = promise;
         try {
@@ -1084,7 +1183,7 @@ export class OrchestratorService extends EventEmitter {
             // trigger arrived between when we claimed the slot and now.
             // Two coalescer arms colliding can no longer cause this branch
             // to fire because they don't bump triggerSerial.
-            if (state.triggerSerial > consumedSerial) {
+            if (Math.max(state.manualSerial, state.watchSerial) > consumedSerial) {
                 this.restartAppCoalesced(name, /* fromExternal */ false).catch((err) => {
                     this.logger.error({ app: name, error: err.message }, 'Trailing coalesced restart failed');
                 });
@@ -1140,7 +1239,7 @@ export class OrchestratorService extends EventEmitter {
     getCoalescerState(name) {
         let state = this.restartCoalescer.get(name);
         if (!state) {
-            state = { inFlight: null, triggerSerial: 0, firedSerial: 0, cooldownUntil: 0 };
+            state = { inFlight: null, triggerSerial: 0, firedSerial: 0, manualSerial: 0, watchSerial: 0, cooldownUntil: 0 };
             this.restartCoalescer.set(name, state);
         }
         return state;
@@ -1179,7 +1278,7 @@ export class OrchestratorService extends EventEmitter {
         // is the one with that address. Falling through to the short-name match
         // answered a question about one deployment with another's data:
         //
-        //     omnitron logs daos/deployed/main   →  daos/dev/main
+        //     omnitron logs sample/deployed/main   →  sample/dev/main
         //
         // — the node's app asked for, this laptop's app printed, with nothing
         // said. `startApp` already refuses this for the same reason ("a
@@ -1379,7 +1478,7 @@ export class OrchestratorService extends EventEmitter {
     }
     /**
      * `name` is resolved like every other per-app question (`main` finds
-     * `daos/dev/main`); it was compared verbatim, so `omnitron metrics main`
+     * `sample/dev/main`); it was compared verbatim, so `omnitron metrics main`
      * printed «(no data)». An unknown name answers `{}`, and the caller says so.
      */
     async getMetrics(name) {
@@ -1409,7 +1508,7 @@ export class OrchestratorService extends EventEmitter {
      * children and its worker pools — and combined (`app-health.ts`).
      *
      * `name` is resolved like every other per-app question: `main` finds
-     * `daos/dev/main`. It was compared verbatim, so `omnitron health main`
+     * `sample/dev/main`. It was compared verbatim, so `omnitron health main`
      * matched nothing and the answer was empty. An unknown name answers `{}`,
      * and the caller says so.
      */
@@ -1569,7 +1668,7 @@ export class OrchestratorService extends EventEmitter {
             // Refused, with the reason. This fell back to «single-process mode» at
             // warn — but every definition declares its topology (IAppDefinition:
             // `processes` is required), so the fallback started the app in a shape
-            // it was never written for. Measured 2026-09-23 on the master: paysys
+            // it was never written for. Measured 2026-09-23 on the master: payments
             // and messaging, whose definitions failed to load («Parameter
             // decorators only work when experimental decorators are enabled»), were
             // started that way and died on «Dependency 'AuthModule:JWTService' not
@@ -1631,96 +1730,8 @@ export class OrchestratorService extends EventEmitter {
         }
         // Build all entry points via esbuild (dev mode bundles from source .ts)
         //
-        // On a *restart* (as opposed to a first start), buildResults already
-        // has a fresh entry — esbuild's watcher just produced the bundle
-        // that triggered us. Reusing it skips a redundant cold rebuild
-        // (which was costing ~500ms per restart and racing against the
-        // watcher's own incremental output). The watch context is also
-        // preserved (we never unwatched), so we don't re-arm it either.
-        if (definition && this.devMode) {
-            try {
-                if (!this.buildService) {
-                    this.buildService = new BuildService(/* isDev */ true, {
-                        onEsbuildReset: (info) => this.metricsBridge?.recordResilientHandleReset(info),
-                        onBuildResult: ({ app, kind, durationMs, ok }) => this.metricsBridge?.recordEsbuildBuild(app, kind, durationMs, ok),
-                    });
-                }
-                const existing = this.buildResults.get(entry.name);
-                const existingWatch = this.buildService.isWatching?.(entry.name);
-                // Bundle on-disk presence check. A restart can race against
-                // the user (or a script) removing `.omnitron-build/` between
-                // builds — without this stat the orchestrator hands the
-                // worker a path that no longer exists and the child dies
-                // with `ERR_MODULE_NOT_FOUND` before the supervisor can
-                // recover. Cheap stat, big DX win.
-                const bundlePresent = existing
-                    ? fs.existsSync(existing.bootstrapPath)
-                    : false;
-                if (existing && existingWatch && bundlePresent) {
-                    // Restart path — keep the already-built bundle and live watch.
-                    this.logger.debug({ app: entry.name, modules: existing.modulePaths.size }, 'Reusing existing esbuild bundle + watch (restart path)');
-                }
-                else {
-                    if (existing && existingWatch && !bundlePresent) {
-                        // Bundle was deleted out from under us. Clear the watch
-                        // and the cached BuildResult so the next call rebuilds
-                        // from cold and re-arms the watcher cleanly.
-                        this.logger.warn({ app: entry.name, bootstrapPath: existing.bootstrapPath }, 'Cached bundle missing on disk — forcing rebuild');
-                        try {
-                            await this.buildService.unwatchApp?.(entry.name);
-                        }
-                        catch (err) {
-                            this.logger.debug({ err, app: entry.name }, 'unwatchApp failed (non-fatal)');
-                        }
-                        this.buildResults.delete(entry.name);
-                    }
-                    // First-start path — build everything from cold and arm the watcher.
-                    const buildResult = await this.buildService.buildApp(entry.name, bootstrapAbsPath, definition);
-                    this.buildResults.set(entry.name, buildResult);
-                    this.logger.info({ app: entry.name, modules: buildResult.modulePaths.size }, 'Built entry points via esbuild');
-                    // Start esbuild watch for incremental rebuilds on source changes.
-                    // On rebuild → fire a restart trigger; the coalescer takes it
-                    // from there.
-                    await this.buildService.watchApp(entry.name, bootstrapAbsPath, definition, () => {
-                        // Gate: skip if the app is in a non-running state — repeated
-                        // restarts of an escalated/errored process just churn forever
-                        // without forward progress (Fix #248).
-                        // Skip restart when the app is in a terminal non-running
-                        // state. Includes 'crashed' (supervisor escalated after
-                        // exceeding its restart budget) and 'errored' (start
-                        // failed). 'stopped' means operator explicitly stopped it.
-                        // In all three cases, restarting just churns a known-broken
-                        // process; the operator must fix the underlying issue and
-                        // call `omnitron start <app>` to clear the state.
-                        const status = this.getAppStatus(entry.name);
-                        if (status === 'errored' || status === 'crashed' || status === 'stopped') {
-                            this.logger.warn({ app: entry.name, status }, 'esbuild rebuild detected but app is not running — skipping restart');
-                            return;
-                        }
-                        this.logger.info({ app: entry.name }, 'esbuild rebuild detected — restarting');
-                        this.metricsBridge?.recordEsbuildBuild(entry.name, 'rebuild', 0, true);
-                        this.restartApp(entry.name).catch((err) => {
-                            this.logger.error({ app: entry.name, error: err.message }, 'Restart after esbuild rebuild failed');
-                        });
-                    });
-                }
-            }
-            catch (err) {
-                // The "fall back to tsx" wording was misleading — the orchestrator
-                // does not inject a tsx loader into spawned children, so without
-                // a build the bootstrap-process will try to `import` the source
-                // .ts file (referenced as `./app.module.js` in the topology) and
-                // fail with a cryptic "Cannot find module" downstream. Surface
-                // the build error directly so the operator sees the actual
-                // problem on `omnitron start/restart`.
-                // esbuild's error carries an `errors[]` with file, line and column.
-                // `.message` is the summary; the locations are what an operator needs
-                // to fix the build, and they exist only on the original.
-                this.logger.error({ app: entry.name, error: err }, 'esbuild build failed — app cannot start without bundled output');
-                throw new Error(`Cannot launch '${entry.name}' in dev mode: esbuild build failed (${err.message}). ` +
-                    `Fix the build error and retry, or run with bundled output present in apps/${entry.name}/.omnitron-build/.`, { cause: err });
-            }
-        }
+        if (definition)
+            await this.prepareBootstrapBuild(entry, bootstrapAbsPath, definition);
         const buildResult = this.buildResults.get(entry.name);
         // Use bundled bootstrap path for topology import when available
         const effectiveBootstrapPath = buildResult?.bootstrapPath ?? bootstrapAbsPath;
@@ -1731,6 +1742,36 @@ export class OrchestratorService extends EventEmitter {
             await this.launchSingleProcess(entry, handle, config, effectiveBootstrapPath, buildResult);
         }
     }
+    async prepareBootstrapBuild(entry, bootstrapAbsPath, definition) {
+        const sourceTopology = /\.(?:[cm]?ts|tsx)$/.test(bootstrapAbsPath) ||
+            definition.processes.some((process) => /\.(?:[cm]?ts|tsx)$/.test(process.module));
+        if (!this.devMode && !sourceTopology)
+            return;
+        try {
+            this.buildService ??= new BuildService(this.devMode, {
+                onEsbuildReset: (info) => this.metricsBridge?.recordResilientHandleReset(info),
+                onBuildResult: ({ app, kind, durationMs, ok }) => this.metricsBridge?.recordEsbuildBuild(app, kind, durationMs, ok),
+            });
+            const existing = this.buildResults.get(entry.name);
+            const current = this.handles.get(entry.name)?.entry ?? entry;
+            const reusable = existing && this.allowsWatch(current) && this.buildService.isWatching(entry.name) &&
+                this.buildService.canReuseBuild(existing, bootstrapAbsPath, definition);
+            if (!reusable) {
+                // A manual restart with watch:false deliberately compiles the current
+                // sources. It must not reuse an artifact that stopped being maintained.
+                await this.buildService.unwatchApp(entry.name);
+                this.buildResults.delete(entry.name);
+                this.buildResults.set(entry.name, await this.buildService.buildApp(entry.name, bootstrapAbsPath, definition));
+                this.logger.info({ app: entry.name }, 'Built entry points via esbuild');
+            }
+            this.bootstrapSources.set(entry.name, { path: bootstrapAbsPath, definition });
+            await this.syncBootstrapWatch(entry.name);
+        }
+        catch (error) {
+            this.logger.error({ app: entry.name, error }, 'esbuild build failed — app cannot start without bundled output');
+            throw new Error(`Cannot launch '${entry.name}': esbuild build failed (${error.message}). Fix the build error and retry.`, { cause: error });
+        }
+    }
     /**
      * Launch app with process topology — multiple children managed by Omnitron.
      *
@@ -1969,7 +2010,7 @@ export class OrchestratorService extends EventEmitter {
         // This was a pool-only feature, ignored in silence everywhere else: a
         // process declaring `expose: true` got no registration and no warning,
         // and every consumer naming it in `topology.access` started without a
-        // proxy. Measured on priceverse, whose `collector` is a single process
+        // proxy. Measured on quotes, whose `collector` is a single process
         // holding the only objects that know whether the exchange WebSockets are
         // up — the server process could not ask, and answered `ready: down —
         // exchanges unavailable` while three were connected.
@@ -1977,7 +2018,7 @@ export class OrchestratorService extends EventEmitter {
         // After `supervisor.start()` because there is no child to ask before it.
         // A consumer among these children may therefore start before the service
         // is registered; consumers re-resolve their proxy on use for exactly that
-        // reason (see priceverse's `OhlcvSchedulerService`).
+        // reason (see quotes's `OhlcvSchedulerService`).
         await this.exposeChildTopologyServices(entry, supervisor, serviceRouter, singleEntries);
     }
     /**