@moldea.ai/core 5.0.0 → 6.0.0

package/dist/node/index.d.ts

@@ -0,0 +1,4 @@
+export type { INodeInspectionAdapter, INodeProjectInspection, INodeProjectInspectionInput, } from '../node-inspection/types.js';
+export { createNodeProjectInspection } from '../node-inspection/client.js';
+export { NODE_INSPECTION_PROFILE } from '../node-inspection/constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAG3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/node-inspection/analysis-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analysis-worker.d.ts.map

package/dist/node-inspection/analysis-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-worker.d.ts","sourceRoot":"","sources":["../../src/node-inspection/analysis-worker.ts"],"names":[],"mappings":""}

package/dist/node-inspection/client.d.ts

@@ -0,0 +1,32 @@
+import type { INodeProjectInspection, INodeProjectInspectionInput } from './types.js';
+/**
+ * Prepares content-free inspection inside one supervised subprocess and one analysis worker.
+ * The caller owns actual reader work and must dispose the returned handle before publishing success.
+ * @returns An async paging handle after the worker reports its actual heap and prepares inspection.
+ * @throws
+ * - INVALID_ARGUMENT: The Core operation received an invalid argument.
+ * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.
+ * - DUPLICATE_ADAPTER_ID: A runtime adapter ID is registered more than once.
+ * - RESERVED_ADAPTER_ID: A reserved runtime adapter ID was supplied.
+ * - INVALID_ADAPTER_DEFINITION: A runtime adapter definition is invalid.
+ * - ABORTED: The Core operation was aborted.
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed during inspection.
+ * - INSPECTION_BUSY: Project inspection capacity is busy. Try again shortly.
+ * - INSPECTION_TIMEOUT: The isolated project inspection timed out.
+ * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
+ * - INVALID_REPOSITORY_PATH: The repository path is invalid.
+ * - ENTRY_NOT_FOUND: The requested repository entry was not found.
+ * - ENTRY_NOT_FILE: The requested repository entry is not a file.
+ * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.
+ * - INVALID_PAGE_REQUEST: The repository page request is invalid.
+ * - ACCESS_DENIED: Access to the repository source was denied.
+ * - SOURCE_UNAVAILABLE: The repository source is unavailable.
+ * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+ * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
+ * - INVALID_SOURCE_DATA: The repository source returned invalid data.
+ * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+ * - ABORTED: The repository operation was aborted.
+ */
+export declare const createNodeProjectInspection: (input: INodeProjectInspectionInput) => Promise<INodeProjectInspection>;
+//# sourceMappingURL=client.d.ts.map

package/dist/node-inspection/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/node-inspection/client.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAEV,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AA4BpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,2BAA2B,KACjC,OAAO,CAAC,sBAAsB,CAsUhC,CAAC"}

package/dist/node-inspection/constants.d.ts

@@ -0,0 +1,21 @@
+export declare const NODE_INSPECTION_LIFETIME_MS = 120000;
+export declare const NODE_INSPECTION_TERMINATION_GRACE_MS = 1000;
+export declare const NODE_INSPECTION_MAX_REQUESTS = 4;
+export declare const NODE_INSPECTION_FILE_PAGE_BYTES = 65536;
+export declare const NODE_INSPECTION_MESSAGE_BYTES = 1048576;
+export declare const NODE_INSPECTION_STDIO_BYTES = 32768;
+export declare const NODE_INSPECTION_TRANSPORT_BYTES: number;
+export declare const NODE_INSPECTION_OLD_GENERATION_MIB = 512;
+export declare const NODE_INSPECTION_YOUNG_GENERATION_MIB = 24;
+export declare const NODE_INSPECTION_PROFILE: Readonly<{
+    lifetimeMs: 120000;
+    terminationGraceMs: 1000;
+    maxReaderRequests: 4;
+    maxFilePageBytes: 65536;
+    maxMessageBytes: 1048576;
+    maxStdioBytes: 32768;
+    transportBytes: number;
+    oldGenerationMiB: 512;
+    youngGenerationMiB: 24;
+}>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/node-inspection/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/node-inspection/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,2BAA2B,SAAU,CAAC;AACnD,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAC1D,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,+BAA+B,QAAS,CAAC;AACtD,eAAO,MAAM,6BAA6B,UAAY,CAAC;AACvD,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAGlD,eAAO,MAAM,+BAA+B,QAC8B,CAAC;AAG3E,eAAO,MAAM,kCAAkC,MAAM,CAAC;AACtD,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAGvD,eAAO,MAAM,uBAAuB;;;;;;;;;;EAUlC,CAAC"}

package/dist/node-inspection/errors.d.ts

@@ -0,0 +1,11 @@
+import type { INodeInspectionFailure } from './types.js';
+/** Serializes only documented exception fields, excluding native messages, causes and stacks. */
+export declare const serializeInspectionFailure: (error: unknown) => INodeInspectionFailure;
+/**
+ * Reconstructs a documented typed failure after checking its safe transport fields.
+ * @returns A package exception without a remote native cause or stack.
+ * @throws
+ * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
+ */
+export declare const deserializeInspectionFailure: (failure: INodeInspectionFailure) => Error;
+//# sourceMappingURL=errors.d.ts.map

package/dist/node-inspection/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/node-inspection/errors.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,iGAAiG;AACjG,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,sBA+C3D,CAAC;AAyBF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GAAI,SAAS,sBAAsB,KAAG,KA+I9E,CAAC"}

package/dist/node-inspection/lifecycle.d.ts

@@ -0,0 +1,15 @@
+import type { ChildProcess } from 'node:child_process';
+import type { INodeInspectionMessage } from './types.js';
+/** Serializes bounded IPC sends and waits for Node's send callback before admitting the next. */
+export declare const createInspectionSender: (send: (frame: string, callback: (error: Error | null) => void) => void) => ((message: INodeInspectionMessage) => Promise<void>);
+/** Keeps only operating-system bootstrap variables; no credentials or Node overrides cross. */
+export declare const createInspectionEnvironment: () => NodeJS.ProcessEnv;
+/**
+ * Supervises one owned child without PID polling, shell commands, or process-group killing.
+ * @returns Idempotent termination and actual close notification.
+ */
+export declare const superviseInspectionChild: (child: ChildProcess, requestStop: () => void) => {
+    closed: Promise<void>;
+    terminate: () => void;
+};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/node-inspection/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/node-inspection/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,GACjC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,KAAK,IAAI,KACrE,CAAC,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CA0BrD,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,2BAA2B,QAAO,MAAM,CAAC,UAKrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,YAAY,EACnB,aAAa,MAAM,IAAI,KACtB;IACD,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,EAAE,MAAM,IAAI,CAAC;CAsBvB,CAAC"}

package/dist/node-inspection/protocol.d.ts

@@ -0,0 +1,20 @@
+import { CoreOperationException } from '../exceptions/index.js';
+import type { INodeInspectionMessage } from './types.js';
+/** Creates the safe failure for an untrusted or inconsistent private protocol record. */
+export declare const createInspectionProcessFailure: (cause?: unknown) => CoreOperationException;
+/**
+ * Admits a complete bounded record before serialization; no record is truncated.
+ * @returns One private JSON frame.
+ * @throws
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
+ */
+export declare const encodeInspectionMessage: (message: INodeInspectionMessage) => string;
+/**
+ * Checks frame size before parsing and validates the closed message contract.
+ * @returns A validated private message.
+ * @throws
+ * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
+ */
+export declare const decodeInspectionMessage: (frame: unknown) => INodeInspectionMessage;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/node-inspection/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/node-inspection/protocol.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,yFAAyF;AACzF,eAAO,MAAM,8BAA8B,GAAI,QAAQ,OAAO,KAAG,sBAK7D,CAAC;AAsSL;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,sBAAsB,KAAG,MAazE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,sBAWxD,CAAC"}

package/dist/node-inspection/repository-rpc.d.ts

@@ -0,0 +1,28 @@
+import { type IRepositoryEntry, type IRepositoryEntryPage, type IRepositoryFilePage, type IRepositoryReader } from '@moldea.ai/repository';
+import type { INodeReaderRequest } from './types.js';
+/** Converts one validated metadata-only repository entry. */
+export declare const parseRpcEntry: (input: unknown) => IRepositoryEntry | null;
+/** Converts a bounded listing page while retaining snapshot and continuation contracts. */
+export declare const parseRpcEntryPage: (input: unknown) => IRepositoryEntryPage;
+/** Decodes only an admitted 64 KiB binary page, never a complete repository file. */
+export declare const parseRpcFilePage: (input: unknown) => IRepositoryFilePage;
+/**
+ * Calls the real reader with inspection cancellation and returns a bounded transport value.
+ * Reader failures propagate unchanged to the parent inspection owner.
+ * @returns A metadata value or encoded byte page after actual reader settlement.
+ * @throws
+ * - INVALID_REPOSITORY_PATH: The repository path is invalid.
+ * - ENTRY_NOT_FOUND: The requested repository entry was not found.
+ * - ENTRY_NOT_FILE: The requested repository entry is not a file.
+ * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.
+ * - INVALID_PAGE_REQUEST: The repository page request is invalid.
+ * - ACCESS_DENIED: Access to the repository source was denied.
+ * - SOURCE_UNAVAILABLE: The repository source is unavailable.
+ * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+ * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
+ * - INVALID_SOURCE_DATA: The repository source returned invalid data.
+ * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+ * - ABORTED: The repository operation was aborted.
+ */
+export declare const executeRepositoryRpc: (reader: IRepositoryReader, request: INodeReaderRequest, signal: AbortSignal) => Promise<unknown>;
+//# sourceMappingURL=repository-rpc.d.ts.map

package/dist/node-inspection/repository-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-rpc.d.ts","sourceRoot":"","sources":["../../src/node-inspection/repository-rpc.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA+BrD,6DAA6D;AAC7D,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,gBAAgB,GAAG,IAiBjE,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,oBAsBlD,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,mBA2BjD,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,iBAAiB,EACzB,SAAS,kBAAkB,EAC3B,QAAQ,WAAW,KAClB,OAAO,CAAC,OAAO,CA2BjB,CAAC"}

package/dist/node-inspection/runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/node-inspection/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/node-inspection/runner.ts"],"names":[],"mappings":""}

package/dist/node-inspection/types.d.ts

@@ -0,0 +1,99 @@
+import type { IRepositoryReader, IRepositorySnapshot } from '@moldea.ai/repository';
+import type { IRepositoryFormatVersion } from '../format/index.js';
+import type { ICoreResourceLimits, IProjectInspection, IProjectInspectionPageInput, IProjectInspectionPageResult } from '../contracts/index.js';
+export interface INodeInspectionAdapter {
+    readonly id: string;
+    readonly supportedRepositoryFormatVersions: readonly IRepositoryFormatVersion[];
+}
+export interface INodeProjectInspectionInput {
+    repository: IRepositoryReader;
+    adapterRegistryUrl: URL;
+    limits?: Partial<ICoreResourceLimits>;
+    signal?: AbortSignal;
+    deadline?: number;
+}
+export type INodeInspectionMetadata = Omit<IProjectInspection, 'readPage'> & {
+    readonly adapters: readonly INodeInspectionAdapter[];
+    readonly maxAnalysisHeapBytes: number;
+};
+export interface INodeProjectInspection extends INodeInspectionMetadata {
+    /**
+     * Reads one content-free page while this inspection owns process admission.
+     * @returns The bounded page from the existing prepared inspection.
+     * @throws
+     * - INVALID_ARGUMENT: The Core operation received an invalid argument.
+     * - ABORTED: The Core operation was aborted.
+     * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+     * - INSPECTION_TIMEOUT: The isolated project inspection timed out.
+     * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
+     */
+    readPage(input: IProjectInspectionPageInput): Promise<IProjectInspectionPageResult>;
+    /**
+     * Closes the child and settles actual reader work before releasing admission.
+     * @returns A promise resolving after idempotent ownership cleanup.
+     * @throws
+     * - INVALID_ARGUMENT: The Core operation received an invalid argument.
+     * - ABORTED: The Core operation was aborted.
+     * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+     * - INSPECTION_TIMEOUT: The isolated project inspection timed out.
+     * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
+     */
+    dispose(): Promise<void>;
+}
+export type INodeReaderRequest = {
+    method: 'getEntry';
+    path: string;
+} | {
+    method: 'listEntriesPage';
+    maxEntries: number;
+    cursor?: string;
+    prefix?: string;
+} | {
+    method: 'readFilePage';
+    path: string;
+    maxBytes: number;
+    offset: number;
+};
+export interface INodeInspectionFailure {
+    family: 'configuration' | 'operation' | 'repository' | 'path';
+    options: Record<string, unknown>;
+}
+export type INodeInspectionMessage = {
+    attemptId: string;
+} & ({
+    kind: 'start';
+    registryUrl: string;
+    snapshot: IRepositorySnapshot;
+    limits: ICoreResourceLimits;
+    deadline: number;
+} | {
+    kind: 'ready';
+    maxAnalysisHeapBytes: number;
+} | {
+    kind: 'run';
+} | {
+    kind: 'prepared';
+    inspection: INodeInspectionMetadata;
+} | {
+    kind: 'read-page';
+    requestId: number;
+    input: IProjectInspectionPageInput;
+} | {
+    kind: 'page';
+    requestId: number;
+    result: IProjectInspectionPageResult;
+} | {
+    kind: 'reader-request';
+    requestId: number;
+    request: INodeReaderRequest;
+} | {
+    kind: 'reader-response';
+    requestId: number;
+    result: unknown;
+} | {
+    kind: 'failure';
+    failure: INodeInspectionFailure;
+} | {
+    kind: 'dispose';
+});
+//# sourceMappingURL=types.d.ts.map

package/dist/node-inspection/types.d.ts.map

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

package/dist/node-runner.js

@@ -0,0 +1,149 @@
+import { n as CoreOperationException } from "./chunks/exceptions-lzD3buFw.js";
+import { a as encodeInspectionMessage, i as decodeInspectionMessage, n as serializeInspectionFailure, r as createInspectionProcessFailure, s as NODE_INSPECTION_LIFETIME_MS } from "./chunks/errors-BQI1DEqf.js";
+import { n as createInspectionSender } from "./chunks/lifecycle-4EkWgEHm.js";
+import process from "node:process";
+import { Worker } from "node:worker_threads";
+//#region src/node-inspection/runner.ts
+var worker;
+var attemptId;
+var heapMaximum;
+var deadlineTimer;
+var isClosing = false;
+var hasRun = false;
+var readerRequests = /* @__PURE__ */ new Set();
+var send = createInspectionSender((frame, callback) => {
+	if (process.send === void 0 || !process.connected) throw createInspectionProcessFailure();
+	process.send(frame, callback);
+});
+/** Closes the worker before disconnecting the supervisor's private IPC channel. */
+var close = async (failure) => {
+	if (isClosing) return;
+	isClosing = true;
+	clearTimeout(deadlineTimer);
+	const termination = worker?.terminate();
+	if (failure !== void 0 && attemptId !== void 0 && process.connected) try {
+		await send({
+			attemptId,
+			kind: "failure",
+			failure: serializeInspectionFailure(failure)
+		});
+	} catch {}
+	await termination;
+	readerRequests.clear();
+	process.removeListener("message", handleParentMessage);
+	process.removeListener("disconnect", handleDisconnect);
+	if (process.connected) process.disconnect();
+};
+var handleDisconnect = () => {
+	close();
+};
+var handleWorkerMessage = (frame) => {
+	try {
+		const message = decodeInspectionMessage(frame);
+		if (isClosing) return;
+		if (message.attemptId !== attemptId) throw createInspectionProcessFailure();
+		if (message.kind === "ready") {
+			if (heapMaximum !== void 0 || hasRun) throw createInspectionProcessFailure();
+			heapMaximum = message.maxAnalysisHeapBytes;
+		} else if (message.kind === "reader-request") {
+			if (!hasRun || readerRequests.has(message.requestId) || readerRequests.size >= 4) throw createInspectionProcessFailure();
+			readerRequests.add(message.requestId);
+		} else if (message.kind === "failure" && message.failure.options["limit"] === "maxAnalysisHeapBytes") throw createInspectionProcessFailure();
+		else if (![
+			"prepared",
+			"page",
+			"failure"
+		].includes(message.kind)) throw createInspectionProcessFailure();
+		send(message).catch((cause) => close(cause));
+	} catch (cause) {
+		close(cause);
+	}
+};
+/** Starts independent supervision before creating the sole analysis worker. */
+var start = (message) => {
+	if (attemptId !== void 0 || isClosing) throw createInspectionProcessFailure();
+	attemptId = message.attemptId;
+	clearTimeout(deadlineTimer);
+	const remaining = Math.min(NODE_INSPECTION_LIFETIME_MS, message.deadline - Date.now());
+	if (remaining <= 0) {
+		close(new CoreOperationException({
+			code: "INSPECTION_TIMEOUT",
+			operation: "create-project-inspection"
+		}));
+		return;
+	}
+	deadlineTimer = setTimeout(() => {
+		close(new CoreOperationException({
+			code: "INSPECTION_TIMEOUT",
+			operation: "create-project-inspection"
+		}));
+	}, remaining);
+	worker = new Worker(new URL(import.meta.resolve("#moldea-core-analysis-worker")), {
+		execArgv: [],
+		env: process.env,
+		stdout: true,
+		stderr: true,
+		resourceLimits: {
+			maxOldGenerationSizeMb: 512,
+			maxYoungGenerationSizeMb: 24
+		},
+		workerData: encodeInspectionMessage(message)
+	});
+	let stdioBytes = 0;
+	const consumeStdio = (chunk) => {
+		stdioBytes += chunk.byteLength;
+		if (stdioBytes > 32768) close(createInspectionProcessFailure());
+	};
+	worker.stdout.on("data", consumeStdio);
+	worker.stderr.on("data", consumeStdio);
+	worker.on("message", handleWorkerMessage);
+	worker.on("messageerror", (cause) => {
+		close(createInspectionProcessFailure(cause));
+	});
+	worker.once("error", (error) => {
+		close(error.code === "ERR_WORKER_OUT_OF_MEMORY" && heapMaximum !== void 0 ? new CoreOperationException({
+			code: "RESOURCE_LIMIT_EXCEEDED",
+			operation: "create-project-inspection",
+			limit: "maxAnalysisHeapBytes",
+			limitMaximum: heapMaximum,
+			observedUsage: null,
+			nextAction: "review-inspection-capacity"
+		}) : createInspectionProcessFailure(error));
+	});
+	worker.once("exit", () => {
+		if (!isClosing) close(createInspectionProcessFailure());
+	});
+};
+var handleParentMessage = (frame) => {
+	try {
+		const message = decodeInspectionMessage(frame);
+		if (isClosing) return;
+		if (message.kind === "start") {
+			start(message);
+			return;
+		}
+		if (message.attemptId !== attemptId || worker === void 0) throw createInspectionProcessFailure();
+		if (message.kind === "dispose") {
+			close();
+			return;
+		}
+		if (message.kind === "run") {
+			if (heapMaximum === void 0 || hasRun) throw createInspectionProcessFailure();
+			hasRun = true;
+		} else if (message.kind === "reader-response") {
+			if (!readerRequests.delete(message.requestId)) throw createInspectionProcessFailure();
+		} else if (message.kind !== "read-page" || !hasRun) throw createInspectionProcessFailure();
+		worker.postMessage(encodeInspectionMessage(message));
+	} catch (cause) {
+		close(cause);
+	}
+};
+process.on("disconnect", handleDisconnect);
+process.on("message", handleParentMessage);
+deadlineTimer = setTimeout(() => {
+	close();
+}, NODE_INSPECTION_LIFETIME_MS);
+if (process.send === void 0 || !process.connected) close();
+//#endregion
+
+//# sourceMappingURL=node-runner.js.map

package/dist/node-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-runner.js","names":[],"sources":["../src/node-inspection/runner.ts"],"sourcesContent":["import process from 'node:process';\nimport { Worker } from 'node:worker_threads';\n\nimport { CoreOperationException } from '../exceptions/index.js';\n\nimport {\n  NODE_INSPECTION_LIFETIME_MS,\n  NODE_INSPECTION_MAX_REQUESTS,\n  NODE_INSPECTION_OLD_GENERATION_MIB,\n  NODE_INSPECTION_STDIO_BYTES,\n  NODE_INSPECTION_YOUNG_GENERATION_MIB,\n} from './constants.js';\nimport { serializeInspectionFailure } from './errors.js';\nimport { createInspectionSender } from './lifecycle.js';\nimport {\n  createInspectionProcessFailure,\n  decodeInspectionMessage,\n  encodeInspectionMessage,\n} from './protocol.js';\nimport type { INodeInspectionMessage } from './types.js';\n\nlet worker: Worker | undefined;\nlet attemptId: string | undefined;\nlet heapMaximum: number | undefined;\nlet deadlineTimer: NodeJS.Timeout | undefined;\nlet isClosing = false;\nlet hasRun = false;\nconst readerRequests = new Set<number>();\nconst send = createInspectionSender((frame, callback) => {\n  if (process.send === undefined || !process.connected) throw createInspectionProcessFailure();\n  process.send(frame, callback);\n});\n\n/** Closes the worker before disconnecting the supervisor's private IPC channel. */\nconst close = async (failure?: unknown): Promise<void> => {\n  if (isClosing) return;\n  isClosing = true;\n  clearTimeout(deadlineTimer);\n  const termination = worker?.terminate();\n  if (failure !== undefined && attemptId !== undefined && process.connected) {\n    try {\n      await send({ attemptId, kind: 'failure', failure: serializeInspectionFailure(failure) });\n    } catch {\n      /* parent disconnect remains authoritative when a failure cannot be delivered */\n    }\n  }\n  await termination;\n  readerRequests.clear();\n  process.removeListener('message', handleParentMessage);\n  process.removeListener('disconnect', handleDisconnect);\n  if (process.connected) process.disconnect();\n};\n\nconst handleDisconnect = (): void => {\n  void close();\n};\nconst handleWorkerMessage = (frame: unknown): void => {\n  try {\n    const message = decodeInspectionMessage(frame);\n    if (isClosing) return;\n    if (message.attemptId !== attemptId) throw createInspectionProcessFailure();\n    if (message.kind === 'ready') {\n      if (heapMaximum !== undefined || hasRun) throw createInspectionProcessFailure();\n      heapMaximum = message.maxAnalysisHeapBytes;\n    } else if (message.kind === 'reader-request') {\n      if (\n        !hasRun ||\n        readerRequests.has(message.requestId) ||\n        readerRequests.size >= NODE_INSPECTION_MAX_REQUESTS\n      )\n        throw createInspectionProcessFailure();\n      readerRequests.add(message.requestId);\n    } else if (\n      message.kind === 'failure' &&\n      message.failure.options['limit'] === 'maxAnalysisHeapBytes'\n    )\n      throw createInspectionProcessFailure();\n    else if (!['prepared', 'page', 'failure'].includes(message.kind))\n      throw createInspectionProcessFailure();\n    void send(message).catch((cause: unknown) => close(cause));\n  } catch (cause) {\n    void close(cause);\n  }\n};\n\n/** Starts independent supervision before creating the sole analysis worker. */\nconst start = (message: Extract<INodeInspectionMessage, { kind: 'start' }>): void => {\n  if (attemptId !== undefined || isClosing) throw createInspectionProcessFailure();\n  attemptId = message.attemptId;\n  clearTimeout(deadlineTimer);\n  const remaining = Math.min(NODE_INSPECTION_LIFETIME_MS, message.deadline - Date.now());\n  if (remaining <= 0) {\n    void close(\n      new CoreOperationException({\n        code: 'INSPECTION_TIMEOUT',\n        operation: 'create-project-inspection',\n      }),\n    );\n    return;\n  }\n  deadlineTimer = setTimeout(() => {\n    void close(\n      new CoreOperationException({\n        code: 'INSPECTION_TIMEOUT',\n        operation: 'create-project-inspection',\n      }),\n    );\n  }, remaining);\n  worker = new Worker(new URL(import.meta.resolve('#moldea-core-analysis-worker')), {\n    execArgv: [],\n    env: process.env,\n    stdout: true,\n    stderr: true,\n    resourceLimits: {\n      maxOldGenerationSizeMb: NODE_INSPECTION_OLD_GENERATION_MIB,\n      maxYoungGenerationSizeMb: NODE_INSPECTION_YOUNG_GENERATION_MIB,\n    },\n    workerData: encodeInspectionMessage(message),\n  });\n  let stdioBytes = 0;\n  const consumeStdio = (chunk: Buffer): void => {\n    stdioBytes += chunk.byteLength;\n    if (stdioBytes > NODE_INSPECTION_STDIO_BYTES) void close(createInspectionProcessFailure());\n  };\n  worker.stdout.on('data', consumeStdio);\n  worker.stderr.on('data', consumeStdio);\n  worker.on('message', handleWorkerMessage);\n  worker.on('messageerror', (cause: unknown) => {\n    void close(createInspectionProcessFailure(cause));\n  });\n  worker.once('error', (error: Error & { code?: string }) => {\n    const failure =\n      error.code === 'ERR_WORKER_OUT_OF_MEMORY' && heapMaximum !== undefined\n        ? new CoreOperationException({\n            code: 'RESOURCE_LIMIT_EXCEEDED',\n            operation: 'create-project-inspection',\n            limit: 'maxAnalysisHeapBytes',\n            limitMaximum: heapMaximum,\n            observedUsage: null,\n            nextAction: 'review-inspection-capacity',\n          })\n        : createInspectionProcessFailure(error);\n    void close(failure);\n  });\n  worker.once('exit', () => {\n    if (!isClosing) void close(createInspectionProcessFailure());\n  });\n};\n\nconst handleParentMessage = (frame: unknown): void => {\n  try {\n    const message = decodeInspectionMessage(frame);\n    if (isClosing) return;\n    if (message.kind === 'start') {\n      start(message);\n      return;\n    }\n    if (message.attemptId !== attemptId || worker === undefined)\n      throw createInspectionProcessFailure();\n    if (message.kind === 'dispose') {\n      void close();\n      return;\n    }\n    if (message.kind === 'run') {\n      if (heapMaximum === undefined || hasRun) throw createInspectionProcessFailure();\n      hasRun = true;\n    } else if (message.kind === 'reader-response') {\n      if (!readerRequests.delete(message.requestId)) throw createInspectionProcessFailure();\n    } else if (message.kind !== 'read-page' || !hasRun) throw createInspectionProcessFailure();\n    worker.postMessage(encodeInspectionMessage(message));\n  } catch (cause) {\n    void close(cause);\n  }\n};\n\nprocess.on('disconnect', handleDisconnect);\nprocess.on('message', handleParentMessage);\ndeadlineTimer = setTimeout(() => {\n  void close();\n}, NODE_INSPECTION_LIFETIME_MS);\nif (process.send === undefined || !process.connected) void close();\n"],"mappings":";;;;;;AAqBA,IAAI;AACJ,IAAI;AACJ,IAAI;AACJ,IAAI;AACJ,IAAI,YAAY;AAChB,IAAI,SAAS;AACb,IAAM,iCAAiB,IAAI,IAAY;AACvC,IAAM,OAAO,wBAAwB,OAAO,aAAa;CACvD,IAAI,QAAQ,SAAS,KAAA,KAAa,CAAC,QAAQ,WAAW,MAAM,+BAA+B;CAC3F,QAAQ,KAAK,OAAO,QAAQ;AAC9B,CAAC;;AAGD,IAAM,QAAQ,OAAO,YAAqC;CACxD,IAAI,WAAW;CACf,YAAY;CACZ,aAAa,aAAa;CAC1B,MAAM,cAAc,QAAQ,UAAU;CACtC,IAAI,YAAY,KAAA,KAAa,cAAc,KAAA,KAAa,QAAQ,WAC9D,IAAI;EACF,MAAM,KAAK;GAAE;GAAW,MAAM;GAAW,SAAS,2BAA2B,OAAO;EAAE,CAAC;CACzF,QAAQ,CAER;CAEF,MAAM;CACN,eAAe,MAAM;CACrB,QAAQ,eAAe,WAAW,mBAAmB;CACrD,QAAQ,eAAe,cAAc,gBAAgB;CACrD,IAAI,QAAQ,WAAW,QAAQ,WAAW;AAC5C;AAEA,IAAM,yBAA+B;CACnC,MAAW;AACb;AACA,IAAM,uBAAuB,UAAyB;CACpD,IAAI;EACF,MAAM,UAAU,wBAAwB,KAAK;EAC7C,IAAI,WAAW;EACf,IAAI,QAAQ,cAAc,WAAW,MAAM,+BAA+B;EAC1E,IAAI,QAAQ,SAAS,SAAS;GAC5B,IAAI,gBAAgB,KAAA,KAAa,QAAQ,MAAM,+BAA+B;GAC9E,cAAc,QAAQ;EACxB,OAAO,IAAI,QAAQ,SAAS,kBAAkB;GAC5C,IACE,CAAC,UACD,eAAe,IAAI,QAAQ,SAAS,KACpC,eAAe,QAAA,GAEf,MAAM,+BAA+B;GACvC,eAAe,IAAI,QAAQ,SAAS;EACtC,OAAO,IACL,QAAQ,SAAS,aACjB,QAAQ,QAAQ,QAAQ,aAAa,wBAErC,MAAM,+BAA+B;OAClC,IAAI,CAAC;GAAC;GAAY;GAAQ;EAAS,CAAC,CAAC,SAAS,QAAQ,IAAI,GAC7D,MAAM,+BAA+B;EACvC,KAAU,OAAO,CAAC,CAAC,OAAO,UAAmB,MAAM,KAAK,CAAC;CAC3D,SAAS,OAAO;EACd,MAAW,KAAK;CAClB;AACF;;AAGA,IAAM,SAAS,YAAsE;CACnF,IAAI,cAAc,KAAA,KAAa,WAAW,MAAM,+BAA+B;CAC/E,YAAY,QAAQ;CACpB,aAAa,aAAa;CAC1B,MAAM,YAAY,KAAK,IAAI,6BAA6B,QAAQ,WAAW,KAAK,IAAI,CAAC;CACrF,IAAI,aAAa,GAAG;EAClB,MACE,IAAI,uBAAuB;GACzB,MAAM;GACN,WAAW;EACb,CAAC,CACH;EACA;CACF;CACA,gBAAgB,iBAAiB;EAC/B,MACE,IAAI,uBAAuB;GACzB,MAAM;GACN,WAAW;EACb,CAAC,CACH;CACF,GAAG,SAAS;CACZ,SAAS,IAAI,OAAO,IAAI,IAAI,YAAY,QAAQ,8BAA8B,CAAC,GAAG;EAChF,UAAU,CAAC;EACX,KAAK,QAAQ;EACb,QAAQ;EACR,QAAQ;EACR,gBAAgB;GACd,wBAAA;GACA,0BAAA;EACF;EACA,YAAY,wBAAwB,OAAO;CAC7C,CAAC;CACD,IAAI,aAAa;CACjB,MAAM,gBAAgB,UAAwB;EAC5C,cAAc,MAAM;EACpB,IAAI,aAAA,OAA0C,MAAW,+BAA+B,CAAC;CAC3F;CACA,OAAO,OAAO,GAAG,QAAQ,YAAY;CACrC,OAAO,OAAO,GAAG,QAAQ,YAAY;CACrC,OAAO,GAAG,WAAW,mBAAmB;CACxC,OAAO,GAAG,iBAAiB,UAAmB;EAC5C,MAAW,+BAA+B,KAAK,CAAC;CAClD,CAAC;CACD,OAAO,KAAK,UAAU,UAAqC;EAYzD,MAVE,MAAM,SAAS,8BAA8B,gBAAgB,KAAA,IACzD,IAAI,uBAAuB;GACzB,MAAM;GACN,WAAW;GACX,OAAO;GACP,cAAc;GACd,eAAe;GACf,YAAY;EACd,CAAC,IACD,+BAA+B,KAAK,CACxB;CACpB,CAAC;CACD,OAAO,KAAK,cAAc;EACxB,IAAI,CAAC,WAAW,MAAW,+BAA+B,CAAC;CAC7D,CAAC;AACH;AAEA,IAAM,uBAAuB,UAAyB;CACpD,IAAI;EACF,MAAM,UAAU,wBAAwB,KAAK;EAC7C,IAAI,WAAW;EACf,IAAI,QAAQ,SAAS,SAAS;GAC5B,MAAM,OAAO;GACb;EACF;EACA,IAAI,QAAQ,cAAc,aAAa,WAAW,KAAA,GAChD,MAAM,+BAA+B;EACvC,IAAI,QAAQ,SAAS,WAAW;GAC9B,MAAW;GACX;EACF;EACA,IAAI,QAAQ,SAAS,OAAO;GAC1B,IAAI,gBAAgB,KAAA,KAAa,QAAQ,MAAM,+BAA+B;GAC9E,SAAS;EACX,OAAO,IAAI,QAAQ,SAAS,mBACtB;OAAA,CAAC,eAAe,OAAO,QAAQ,SAAS,GAAG,MAAM,+BAA+B;EAAA,OAC/E,IAAI,QAAQ,SAAS,eAAe,CAAC,QAAQ,MAAM,+BAA+B;EACzF,OAAO,YAAY,wBAAwB,OAAO,CAAC;CACrD,SAAS,OAAO;EACd,MAAW,KAAK;CAClB;AACF;AAEA,QAAQ,GAAG,cAAc,gBAAgB;AACzC,QAAQ,GAAG,WAAW,mBAAmB;AACzC,gBAAgB,iBAAiB;CAC/B,MAAW;AACb,GAAG,2BAA2B;AAC9B,IAAI,QAAQ,SAAS,KAAA,KAAa,CAAC,QAAQ,WAAW,MAAW"}