@omnitron-dev/omnitron 0.3.1 → 0.3.2

package/dist/orchestrator/application-runtime-resolution.js

@@ -0,0 +1,62 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+/** Shared policy for fresh readers and the one-shot remote installer.
+ * Only resolves entries; never executes application code or runs in a resident owner. */
+export function resolveApplicationBootstrapRuntime(bootstrap, fallback, allowSdklessBootstrap = false) {
+    if (!path.isAbsolute(bootstrap) || !path.isAbsolute(fallback)) {
+        throw new Error('Application runtime resolution requires absolute entry paths');
+    }
+    const request = createRequire(bootstrap);
+    function installed(name) {
+        try {
+            return request.resolve(name);
+        }
+        catch (error) {
+            if (error.code === 'MODULE_NOT_FOUND' &&
+                !request.resolve.paths(name)?.some(directory => fs.lstatSync(path.join(directory, name), { throwIfNoEntry: false })))
+                return undefined;
+            throw new Error('The installed application package ' + name + ' cannot be resolved; repair its dependency installation', { cause: error });
+        }
+    }
+    const entry = installed('@omnitron-dev/omnitron');
+    const application = installed('@omnitron-dev/titan');
+    // A directly supervising daemon also accepts plain bootstrap files. A missing
+    // dependency declared by the application is an installation error.
+    if (!entry && !application && allowSdklessBootstrap) {
+        let directory = path.dirname(bootstrap);
+        while (true) {
+            const manifest = path.join(directory, 'package.json');
+            if (fs.existsSync(manifest)) {
+                const pkg = JSON.parse(fs.readFileSync(manifest, 'utf8'));
+                const sections = [pkg.dependencies, pkg.peerDependencies, pkg.optionalDependencies, pkg.devDependencies];
+                if (sections.some(deps => deps && (Object.hasOwn(deps, '@omnitron-dev/omnitron') || Object.hasOwn(deps, '@omnitron-dev/titan'))))
+                    throw new Error('The application declares a missing Omnitron or Titan package; install its dependencies');
+                break;
+            }
+            const parent = path.dirname(directory);
+            if (directory === parent)
+                break;
+            directory = parent;
+        }
+        return fallback;
+    }
+    if (!application)
+        throw new Error('The application Titan runtime cannot be resolved; install the application dependencies');
+    if (!entry) {
+        const owner = createRequire(fallback).resolve('@omnitron-dev/titan');
+        if (fs.realpathSync(owner) === fs.realpathSync(application))
+            return fallback;
+        throw new Error('The application uses a different Titan runtime. Install an aligned @omnitron-dev/omnitron adapter with the application before starting it.');
+    }
+    const adapter = path.join(path.dirname(entry), 'orchestrator/bootstrap-process.js');
+    if (!fs.statSync(adapter, { throwIfNoEntry: false })?.isFile()) {
+        throw new Error('The application Omnitron package has no compiled bootstrap adapter');
+    }
+    const actual = createRequire(adapter).resolve('@omnitron-dev/titan');
+    if (fs.realpathSync(application) !== fs.realpathSync(actual)) {
+        throw new Error('The application and its Omnitron adapter resolve different Titan instances; align their installed dependencies');
+    }
+    return adapter;
+}
+//# sourceMappingURL=application-runtime-resolution.js.map

package/dist/orchestrator/application-runtime-resolution.js.map

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

package/dist/orchestrator/application-runtime.d.ts

@@ -0,0 +1,3 @@
+/** Keep an application's Titan/DI identity independent of the controller's release. */
+export declare function applicationBootstrapRuntime(bootstrap: string, fallback: string, allowSdklessBootstrap?: boolean): Promise<string>;
+//# sourceMappingURL=application-runtime.d.ts.map

package/dist/orchestrator/application-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime.d.ts","sourceRoot":"","sources":["../../src/orchestrator/application-runtime.ts"],"names":[],"mappings":"AAGA,uFAAuF;AACvF,wBAAsB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAerI"}

package/dist/orchestrator/application-runtime.js

@@ -0,0 +1,20 @@
+import path from 'node:path';
+import { readInFreshProcess, moduleReaderEntry } from '../shared/fresh-module-reader.js';
+/** Keep an application's Titan/DI identity independent of the controller's release. */
+export async function applicationBootstrapRuntime(bootstrap, fallback, allowSdklessBootstrap = false) {
+    // createRequire() shares Node's resolution and realpath caches. Recreating
+    // the require function does not observe a replaced pnpm link or package.json
+    // in a resident owner. Use the same bounded reader as application metadata;
+    // never clear global loader internals or retain another module graph here.
+    const adapter = await readInFreshProcess({
+        entryPath: moduleReaderEntry(import.meta.url, 'application-runtime-child'),
+        args: allowSdklessBootstrap ? [bootstrap, fallback, '--allow-sdkless-bootstrap'] : [bootstrap, fallback],
+        timeoutMs: 10_000,
+        label: 'the current application runtime',
+    });
+    if (typeof adapter !== 'string' || !path.isAbsolute(adapter)) {
+        throw new Error('The application runtime reader returned an invalid adapter path');
+    }
+    return adapter;
+}
+//# sourceMappingURL=application-runtime.js.map

package/dist/orchestrator/application-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime.js","sourceRoot":"","sources":["../../src/orchestrator/application-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAEzF,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,SAAiB,EAAE,QAAgB,EAAE,qBAAqB,GAAG,KAAK;IAClH,2EAA2E;IAC3E,6EAA6E;IAC7E,4EAA4E;IAC5E,2EAA2E;IAC3E,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC;QACvC,SAAS,EAAE,iBAAiB,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,2BAA2B,CAAC;QAC1E,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC;QACxG,SAAS,EAAE,MAAM;QACjB,KAAK,EAAE,iCAAiC;KACzC,CAAC,CAAC;IACH,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/orchestrator/application-topology.d.ts

@@ -0,0 +1,20 @@
+import type { ILogger } from '@omnitron-dev/titan/module/logger';
+import { ServiceRouter } from './service-router.js';
+/** One application launch owns one native Netron service namespace and listener. */
+export declare class ApplicationTopology {
+    private readonly directory;
+    private readonly netron;
+    readonly router: ServiceRouter;
+    readonly url: string;
+    private closing;
+    private closingRequested;
+    private closed;
+    private constructor();
+    /** Allocate before starting so the application handle owns failed starts too. */
+    static allocate(parent: string, application: string, logger: ILogger): Promise<ApplicationTopology>;
+    start(): Promise<void>;
+    /** Retain ownership after a failed close; a later stop retries the same resources. */
+    close(): Promise<void>;
+    private release;
+}
+//# sourceMappingURL=application-topology.d.ts.map

package/dist/orchestrator/application-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-topology.d.ts","sourceRoot":"","sources":["../../src/orchestrator/application-topology.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,oFAAoF;AACpF,qBAAa,mBAAmB;IAQ5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,eAON;IAED,iFAAiF;IACjF,OAAa,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+BxG;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED,sFAAsF;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrB;YAEa,OAAO;CAStB"}

package/dist/orchestrator/application-topology.js

@@ -0,0 +1,90 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { Netron } from '@omnitron-dev/titan/netron';
+import { UnixSocketTransport } from '@omnitron-dev/titan/netron/transport/unix';
+import { AuthenticationManager, AuthorizationManager } from '@omnitron-dev/titan/netron/auth';
+import { ServiceRouter } from './service-router.js';
+/** One application launch owns one native Netron service namespace and listener. */
+export class ApplicationTopology {
+    directory;
+    netron;
+    router;
+    url;
+    closing = null;
+    closingRequested = false;
+    closed = false;
+    constructor(directory, netron, logger) {
+        this.directory = directory;
+        this.netron = netron;
+        this.router = new ServiceRouter(netron, logger);
+        this.url = `unix://${path.join(directory, 'rpc.sock')}`;
+    }
+    /** Allocate before starting so the application handle owns failed starts too. */
+    static async allocate(parent, application, logger) {
+        await fs.mkdir(parent, { recursive: true, mode: 0o700 });
+        const stat = await fs.lstat(parent);
+        if (!stat.isDirectory() || stat.isSymbolicLink() || (stat.mode & 0o077) !== 0 ||
+            (process.getuid && stat.uid !== process.getuid())) {
+            throw new Error('Application topology directory must be private and owned by this user');
+        }
+        const root = await fs.realpath(parent);
+        if (root.includes('?') || Buffer.byteLength(path.join(root, 't-XXXXXX', 'rpc.sock')) > 100) {
+            throw new Error('Application topology directory cannot contain ? and must fit a 100-byte Unix socket path');
+        }
+        const directory = await fs.mkdtemp(path.join(root, 't-'));
+        try {
+            const netron = new Netron(logger, { id: `topology-${path.basename(directory)}` });
+            netron.registerTransport('unix', () => new UnixSocketTransport());
+            netron.registerTransportServer('unix', { name: 'application-topology', options: {
+                    path: path.join(directory, 'rpc.sock'), force: false, mode: 0o600,
+                } });
+            netron.configureAuth(new AuthenticationManager(logger, {
+                authenticate: async () => { throw new Error('Application topology requires its private Unix socket'); },
+                validateToken: async () => { throw new Error('Application topology does not accept bearer tokens'); },
+                tokenCache: { enabled: false },
+            }), new AuthorizationManager(logger));
+            netron.setTransportAuthContext('unix', {
+                userId: application, roles: ['application-topology'], permissions: [],
+            });
+            return new ApplicationTopology(directory, netron, logger);
+        }
+        catch (error) {
+            await fs.rmdir(directory);
+            throw error;
+        }
+    }
+    async start() {
+        if (this.closingRequested)
+            throw new Error('Application topology is closing or closed');
+        await this.netron.start();
+    }
+    /** Retain ownership after a failed close; a later stop retries the same resources. */
+    close() {
+        this.closingRequested = true;
+        if (this.closed)
+            return Promise.resolve();
+        this.closing ??= this.release().finally(() => { this.closing = null; });
+        return this.closing;
+    }
+    async release() {
+        const failures = [];
+        try {
+            await this.router.releaseAll();
+        }
+        catch (error) {
+            failures.push(error);
+        }
+        try {
+            await this.netron.stop();
+        }
+        catch (error) {
+            failures.push(error);
+        }
+        if (failures.length)
+            throw new AggregateError(failures, 'Application topology shutdown incomplete');
+        // No recursive removal: an unexpected file is evidence, not disposable state.
+        await fs.rmdir(this.directory);
+        this.closed = true;
+    }
+}
+//# sourceMappingURL=application-topology.js.map

package/dist/orchestrator/application-topology.js.map

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

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

@@ -10,7 +10,7 @@
  * now.
  *
  * It reads the definition as the daemon would have in its own process: the
- * same loader code (`loadBootstrapConfig`, dev mode, in-process), the same Node
+ * same loader code (`loadBootstrapConfig`, selected mode, in-process), the same Node
  * flags (`--import tsx/esm` among them), working directory and environment.
  * Then it answers once over IPC and exits, whatever the definition left open —
  * a client, a timer — since nothing here will ever use it.

package/dist/orchestrator/bootstrap-loader-child.js

@@ -10,34 +10,25 @@
  * now.
  *
  * It reads the definition as the daemon would have in its own process: the
- * same loader code (`loadBootstrapConfig`, dev mode, in-process), the same Node
+ * same loader code (`loadBootstrapConfig`, selected mode, in-process), the same Node
  * flags (`--import tsx/esm` among them), working directory and environment.
  * Then it answers once over IPC and exits, whatever the definition left open —
  * a client, a timer — since nothing here will ever use it.
  */
-import { FRESH_GRAPH_ANSWER, definitionAsData, loadBootstrapConfig, } from './bootstrap-loader.js';
-// The parent is the only one this answer is for. Gone, it leaves nothing to do.
-process.once('disconnect', () => process.exit(3));
-function answer(message) {
-    const code = message.ok ? 0 : 1;
-    if (!process.send) {
-        process.stderr.write('bootstrap-loader-child: started without an IPC channel, so there is no one to answer\n');
-        process.exit(2);
-    }
-    process.send(message, undefined, {}, () => process.exit(code));
-}
+import { definitionAsData, loadBootstrapConfig } from './bootstrap-loader.js';
+import { initializeModuleReader, answerModuleRead } from '../shared/fresh-module-reader.js';
+initializeModuleReader();
 const bootstrapPath = process.argv[2];
 try {
     if (!bootstrapPath)
         throw new Error('no definition path was given');
-    const definition = await loadBootstrapConfig(bootstrapPath, { devMode: true });
+    const definition = await loadBootstrapConfig(bootstrapPath, { devMode: process.argv[3] !== 'production' });
     const data = definitionAsData(definition);
     if (data === undefined)
         throw new Error('the definition loaded, but could not be read as data');
-    answer({ type: FRESH_GRAPH_ANSWER, ok: true, definition: data });
+    answerModuleRead({ ok: true, value: data });
 }
 catch (err) {
-    const error = err instanceof Error ? err : new Error(String(err));
-    answer({ type: FRESH_GRAPH_ANSWER, ok: false, message: error.message, name: error.name, stack: error.stack });
+    answerModuleRead({ ok: false, error: err });
 }
 //# sourceMappingURL=bootstrap-loader-child.js.map

package/dist/orchestrator/bootstrap-loader-child.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-loader-child.js","sourceRoot":"","sources":["../../src/orchestrator/bootstrap-loader-child.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAElD,SAAS,MAAM,CAAC,OAAyB;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wFAAwF,CAAC,CAAC;QAC/G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtC,IAAI,CAAC;IACH,IAAI,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAChG,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;AAChH,CAAC"}
+{"version":3,"file":"bootstrap-loader-child.js","sourceRoot":"","sources":["../../src/orchestrator/bootstrap-loader-child.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAE5F,sBAAsB,EAAE,CAAC;AAEzB,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtC,IAAI,CAAC;IACH,IAAI,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;IAC3G,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAChG,gBAAgB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,gBAAgB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAC9C,CAAC"}

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

@@ -11,7 +11,7 @@
  *   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.
  *
- * **Dev mode, read by the daemon (`freshModuleGraph`):**
+ * **Definitions read by the daemon (`freshModuleGraph`):**
  *   In a short-lived process of its own, which answers with the definition as
  *   data. The `?t=` below makes Node import the definition FILE again, but not
  *   the packages it imports: those stay in the importing process's module graph
@@ -32,6 +32,8 @@
  *   Child processes always get a fresh Node.js module graph (separate fork).
  */
 import type { IAppDefinition } from '../config/types.js';
+/** Read-only diagnostics must not import application code or compile its source. */
+export declare function getCachedBootstrapDefinition(bootstrapPath: string): IAppDefinition | undefined;
 /**
  * Clear all cached bootstrap definitions.
  * Called by orchestrator before restarting apps in dev mode so that
@@ -46,10 +48,10 @@ export interface LoadBootstrapOptions {
     /** Skip cache and prefer source .ts over compiled dist/ */
     devMode?: boolean;
     /**
-     * With `devMode`: read the definition in a short-lived process of its own —
+     * Read the definition in a short-lived process of its own —
      * a module graph that is new on every read — and get it back as data.
-     * Without `devMode` it changes nothing: a production load is cached for the
-     * life of the process by design.
+     * Production keeps its compiled-file preference; development reads source.
+     * Both modes avoid retaining an earlier package module graph in the daemon.
      *
      * For a long-lived READER of definitions, which is the daemon. What it reads
      * is data — the topology, `requires`, `config`, `omnitronConfig`,
@@ -67,23 +69,11 @@ export interface LoadBootstrapOptions {
         timeoutMs?: number;
     };
 }
+/** The same input selected by the definition loader, for declaration provenance. */
+export declare function bootstrapDefinitionSource(bootstrapPath: string, devMode?: boolean): string;
 export declare function loadBootstrapConfig(bootstrapPath: string, options?: LoadBootstrapOptions): Promise<IAppDefinition>;
 /** How long a definition may take to load in a process of its own. */
 export declare const FRESH_GRAPH_TIMEOUT_MS = 60000;
-/** Tags the one message the reading process sends, among any a package might. */
-export declare const FRESH_GRAPH_ANSWER = "omnitron:bootstrap-loader:answer";
-/** What the reading process (bootstrap-loader-child.ts) answers, once. */
-export type FreshGraphAnswer = {
-    type: typeof FRESH_GRAPH_ANSWER;
-    ok: true;
-    definition: unknown;
-} | {
-    type: typeof FRESH_GRAPH_ANSWER;
-    ok: false;
-    message: string;
-    name?: string | undefined;
-    stack?: string | undefined;
-};
 /**
  * A definition as the daemon reads it: data.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-loader.d.ts","sourceRoot":"","sources":["../../src/orchestrator/bootstrap-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAOH,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;IAClB;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAED,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAwFzB;AAeD,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,qCAAqC,CAAC;AAErE,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,OAAO,kBAAkB,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,OAAO,kBAAkB,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAY3H;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAE7D"}
+{"version":3,"file":"bootstrap-loader.d.ts","sourceRoot":"","sources":["../../src/orchestrator/bootstrap-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD,oFAAoF;AACpF,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE9F;AAED;;;;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;IAClB;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,MAAM,CAKxF;AAED,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA2FzB;AAeD,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAE7D"}

package/dist/orchestrator/bootstrap-loader.js

@@ -11,7 +11,7 @@
  *   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.
  *
- * **Dev mode, read by the daemon (`freshModuleGraph`):**
+ * **Definitions read by the daemon (`freshModuleGraph`):**
  *   In a short-lived process of its own, which answers with the definition as
  *   data. The `?t=` below makes Node import the definition FILE again, but not
  *   the packages it imports: those stay in the importing process's module graph
@@ -33,11 +33,15 @@
  */
 import path from 'node:path';
 import fs from 'node:fs';
-import { fork } from 'node:child_process';
-import { createRequire } from 'node:module';
-import { fileURLToPath, pathToFileURL } from 'node:url';
+import { pathToFileURL } from 'node:url';
+import { readInFreshProcess, moduleReaderEntry } from '../shared/fresh-module-reader.js';
+import { withClosureLibraryPath } from '../release/closure-library-path.js';
 // Module cache — cleared on dev-mode restarts via clearCache()
 const cache = new Map();
+/** Read-only diagnostics must not import application code or compile its source. */
+export function getCachedBootstrapDefinition(bootstrapPath) {
+    return cache.get(path.resolve(bootstrapPath));
+}
 /**
  * Clear all cached bootstrap definitions.
  * Called by orchestrator before restarting apps in dev mode so that
@@ -76,12 +80,23 @@ function canLoadTypeScript() {
     const execArgv = process.execArgv ?? [];
     return execArgv.some((arg) => arg.includes('tsx'));
 }
+/** The same input selected by the definition loader, for declaration provenance. */
+export function bootstrapDefinitionSource(bootstrapPath, devMode = false) {
+    const resolved = path.resolve(bootstrapPath);
+    if (devMode || canLoadTypeScript())
+        return resolved;
+    const compiled = toCompiledPath(resolved);
+    return compiled && fs.existsSync(compiled) ? compiled : resolved;
+}
 export async function loadBootstrapConfig(bootstrapPath, options) {
     const resolved = path.resolve(bootstrapPath);
-    if (options?.devMode && options.freshModuleGraph) {
+    if (options?.freshModuleGraph) {
         const timeoutMs = (typeof options.freshModuleGraph === 'object' ? options.freshModuleGraph.timeoutMs : undefined) ??
             FRESH_GRAPH_TIMEOUT_MS;
-        const definition = await readInFreshProcess(resolved, timeoutMs);
+        const env = withClosureLibraryPath(undefined, [resolved]);
+        const definition = await readInFreshProcess({ entryPath: moduleReaderEntry(import.meta.url, 'bootstrap-loader-child'),
+            args: [resolved, options.devMode ? 'development' : 'production'], timeoutMs, label: 'the definition',
+            ...(env && { env }) });
         assertDefinition(definition, bootstrapPath);
         // As every dev load has done: the cache is not read, and is left holding
         // the latest read for a production load of the same path.
@@ -177,16 +192,6 @@ function assertDefinition(definition, bootstrapPath) {
 // =============================================================================
 /** How long a definition may take to load in a process of its own. */
 export const FRESH_GRAPH_TIMEOUT_MS = 60_000;
-/** Tags the one message the reading process sends, among any a package might. */
-export const FRESH_GRAPH_ANSWER = 'omnitron:bootstrap-loader:answer';
-/**
- * Set in the reading process's environment. A reading process loads in its own
- * graph, never through another one; if the parent's program ever reached it
- * (see `childExecArgv`), this stops the chain at one link.
- */
-const READING_PROCESS_MARK = 'OMNITRON_BOOTSTRAP_LOADER_CHILD';
-/** How much of the reading process's stderr an error carries. */
-const STDERR_TAIL_CHARS = 4_000;
 /**
  * A definition as the daemon reads it: data.
  *
@@ -272,192 +277,4 @@ function fieldOf(holder, key) {
         return undefined;
     }
 }
-/** Flags `childExecArgv` drops that carry a value, inline or as the next argument. */
-const DROPPED_WITH_VALUE = new Set([
-    '-e', '--eval', '-p', '--print', '-pe', '--input-type', '--inspect-port', '--debug-port', '--watch-path',
-]);
-/**
- * This process's Node flags as the reading process should get them.
- *
- * Everything that shapes how modules resolve and load is kept, so the child
- * reads the definition exactly as this process would have — `--import
- * tsx/esm` first of all, which the daemon is started with (spawn-daemon.ts)
- * and `canLoadTypeScript` looks for. What goes is what would make the child a
- * different program than its entry: `-e`/`-p` and their code, which it would
- * run instead (node's own `fork` drops them for the same reason, but only
- * from an unmodified `process.execArgv`); `--input-type`, which node refuses
- * beside a file entry; an inspector flag, whose port is this process's and
- * whose `-brk` would wait for a debugger until the deadline; and watch mode,
- * which restarts where the child must exit.
- */
-function childExecArgv(parentArgv) {
-    const kept = [];
-    for (let i = 0; i < parentArgv.length; i++) {
-        const arg = parentArgv[i];
-        const flag = arg.split('=', 1)[0];
-        if (DROPPED_WITH_VALUE.has(flag)) {
-            // `--flag value` takes the next argument with it; `--flag=value` does not.
-            if (arg === flag)
-                i++;
-            continue;
-        }
-        if (flag.startsWith('--inspect') || flag.startsWith('--debug') || flag.startsWith('--watch'))
-            continue;
-        kept.push(arg);
-    }
-    return kept;
-}
-/**
- * The reading process's entry — `.ts` beside the source (tests, tsx), `.js`
- * beside the build — and the Node flags to start it with.
- */
-function readingProcessCommand() {
-    const here = fileURLToPath(import.meta.url);
-    const extension = path.extname(here);
-    const entryPath = path.join(path.dirname(here), `bootstrap-loader-child${extension}`);
-    const execArgv = childExecArgv(process.execArgv ?? []);
-    // A source entry needs a TypeScript loader to start at all. The daemon has
-    // one and it was kept above; a test runner may have none of its own.
-    if (extension === '.ts' && typeof globalThis.Bun === 'undefined' && !execArgv.some((arg) => arg.includes('tsx'))) {
-        execArgv.push('--import', pathToFileURL(createRequire(import.meta.url).resolve('tsx/esm')).href);
-    }
-    return { entryPath, execArgv };
-}
-function isAnswer(message) {
-    if (!message || typeof message !== 'object')
-        return false;
-    const m = message;
-    if (m['type'] !== FRESH_GRAPH_ANSWER)
-        return false;
-    return m['ok'] === true ? 'definition' in m : m['ok'] === false && typeof m['message'] === 'string';
-}
-/**
- * Read one definition in a process started for it, and wait until that
- * process is gone. Resolves with what it answered; rejects with its error's
- * message when it answered with one, and otherwise with how it ended and the
- * last of its stderr.
- */
-function readInFreshProcess(resolved, timeoutMs) {
-    if (process.env[READING_PROCESS_MARK]) {
-        return Promise.reject(new Error(`a process reading a definition does not start another (asked for ${resolved})`));
-    }
-    const { entryPath, execArgv } = readingProcessCommand();
-    if (!fs.existsSync(entryPath)) {
-        return Promise.reject(new Error(`the definition reader ${entryPath} is missing — is this build complete?`));
-    }
-    return new Promise((resolve, reject) => {
-        let child;
-        try {
-            child = fork(entryPath, [resolved], {
-                execArgv,
-                env: { ...process.env, [READING_PROCESS_MARK]: '1' },
-                // Output goes where this process's goes, as an in-process import's
-                // would have: stdout directly, stderr passed on below — with its tail
-                // kept, for when it is the only explanation there is.
-                stdio: ['ignore', 'inherit', 'pipe', 'ipc'],
-            });
-        }
-        catch (err) {
-            reject(new Error(`could not start a process to read the definition: ${err.message}`, { cause: err }));
-            return;
-        }
-        let answer;
-        let exit;
-        let channelClosed = false;
-        let timedOut = false;
-        let concluding = false;
-        let settled = false;
-        let stderrTail = '';
-        const timers = [];
-        const stderrClosed = new Promise((done) => {
-            if (!child.stderr) {
-                done();
-                return;
-            }
-            child.stderr.setEncoding('utf8');
-            child.stderr.on('data', (chunk) => {
-                stderrTail = (stderrTail + chunk).slice(-STDERR_TAIL_CHARS);
-                process.stderr.write(chunk);
-            });
-            child.stderr.once('close', () => done());
-        });
-        const settle = (outcome) => {
-            if (settled)
-                return;
-            settled = true;
-            for (const timer of timers)
-                clearTimeout(timer);
-            outcome();
-        };
-        // The answer, if one was sent, has been delivered once the process has
-        // exited AND its channel has closed — `exit` alone can come first.
-        const conclude = async () => {
-            if (concluding || settled || !exit || !channelClosed)
-                return;
-            concluding = true;
-            if (answer?.ok) {
-                const definition = answer.definition;
-                settle(() => resolve(definition));
-                return;
-            }
-            if (answer) {
-                const failure = answer;
-                settle(() => reject(errorFromAnswer(failure)));
-                return;
-            }
-            // No answer: what the process said on its way out is the explanation,
-            // and a moment lets the pipe deliver its last lines — never longer, as
-            // something the definition started may hold the pipe open.
-            const ended = exit;
-            await Promise.race([stderrClosed, new Promise((done) => timers.push(setTimeout(done, 500)))]);
-            const how = timedOut
-                ? `did not answer within ${timeoutMs / 1000} s and was killed`
-                : ended.signal
-                    ? `was ended by ${ended.signal} before answering`
-                    : `exited with code ${ended.code} before answering`;
-            const said = stderrTail.trim();
-            settle(() => reject(new Error(`the process reading the definition ${how}${said ? `:\n${said}` : ''}`)));
-        };
-        child.on('message', (message) => {
-            if (!answer && isAnswer(message))
-                answer = message;
-        });
-        child.once('disconnect', () => {
-            channelClosed = true;
-            void conclude();
-        });
-        child.once('exit', (code, signal) => {
-            exit = { code, signal };
-            // The channel closes right behind the process. Should it not, what
-            // arrived by then is all there is.
-            timers.push(setTimeout(() => {
-                channelClosed = true;
-                void conclude();
-            }, 1_000));
-            void conclude();
-        });
-        child.on('error', (err) => {
-            // Only a process that never started has no exit to wait for.
-            if (child.pid === undefined) {
-                settle(() => reject(new Error(`could not start a process to read the definition: ${err.message}`, { cause: err })));
-            }
-        });
-        timers.push(setTimeout(() => {
-            timedOut = true;
-            child.kill('SIGKILL');
-        }, timeoutMs));
-    });
-}
-function errorFromAnswer(answer) {
-    // The message is the definition's own, word for word — the caller puts it
-    // after «Could not load <app>'s definition from <path>:». The stack it was
-    // thrown with, in the reading process, rides along as the cause.
-    let cause;
-    if (answer.stack) {
-        cause = new Error(answer.message);
-        cause.name = answer.name ?? 'Error';
-        cause.stack = answer.stack;
-    }
-    return new Error(answer.message, cause ? { cause } : undefined);
-}
 //# sourceMappingURL=bootstrap-loader.js.map