@moldea.ai/core 5.0.1 → 7.0.0

package/dist/node.js

@@ -0,0 +1,335 @@
+import { c as freezeRecursively, n as normalizeCoreOptions } from "./chunks/options-5x9gu2Qb.js";
+import { n as CoreOperationException } from "./chunks/exceptions-IXsorE8t.js";
+import { c as NODE_INSPECTION_PROFILE, d as NODE_INSPECTION_TRANSPORT_BYTES, i as decodeInspectionMessage, n as serializeInspectionFailure, r as createInspectionProcessFailure, s as NODE_INSPECTION_LIFETIME_MS, t as deserializeInspectionFailure } from "./chunks/errors-BE4DS3Ak.js";
+import { n as createInspectionSender, r as superviseInspectionChild, t as createInspectionEnvironment } from "./chunks/lifecycle-D_RvxhDC.js";
+import { t as executeRepositoryRpc } from "./chunks/repository-rpc-B_y0Kspf.js";
+import { RepositorySourceException } from "@moldea.ai/repository";
+import { fork } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { fileURLToPath } from "node:url";
+//#region src/node-inspection/client.ts
+var isInspectionActive = false;
+/** Stores one completion without an unhandled rejection before its owner begins awaiting it. */
+var createCompletion = () => {
+	let resolve;
+	let reject;
+	const promise = new Promise((resolveResult, rejectResult) => {
+		resolve = resolveResult;
+		reject = rejectResult;
+	});
+	promise.catch(() => {});
+	return {
+		promise,
+		resolve,
+		reject
+	};
+};
+var aborted = (cause) => new CoreOperationException({
+	code: "ABORTED",
+	operation: "create-project-inspection",
+	...cause === void 0 ? {} : { cause }
+});
+/**
+* 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.
+* - ABORTED: The Core operation was aborted.
+* - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+* - 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.
+*/
+var createNodeProjectInspection = async (input) => {
+	if (input === null || typeof input !== "object" || input.repository === null || typeof input.repository !== "object" || typeof input.repository.getEntry !== "function" || typeof input.repository.listEntriesPage !== "function" || typeof input.repository.readFilePage !== "function" || input.repository.snapshot === null || typeof input.repository.snapshot !== "object" || typeof input.repository.snapshot.id !== "string" || input.repository.snapshot.id.length === 0 || typeof input.repository.snapshot.sourceKind !== "string" || input.repository.snapshot.sourceKind.length === 0) throw new CoreOperationException({
+		code: "INVALID_ARGUMENT",
+		operation: "create-project-inspection"
+	});
+	let repository = input.repository;
+	const snapshot = {
+		id: repository.snapshot.id,
+		sourceKind: repository.snapshot.sourceKind
+	};
+	const signal = input.signal;
+	if (signal !== void 0 && (signal === null || typeof signal !== "object" || typeof signal.aborted !== "boolean" || typeof signal.addEventListener !== "function" || typeof signal.removeEventListener !== "function")) throw new CoreOperationException({
+		code: "INVALID_ARGUMENT",
+		operation: "create-project-inspection"
+	});
+	const { limits } = normalizeCoreOptions({ ...input.limits === void 0 ? {} : { limits: input.limits } });
+	if (input.deadline !== void 0 && (!Number.isSafeInteger(input.deadline) || input.deadline < 0)) throw new CoreOperationException({
+		code: "INVALID_ARGUMENT",
+		operation: "create-project-inspection"
+	});
+	if (signal?.aborted === true) throw aborted(signal.reason);
+	if (isInspectionActive) throw new CoreOperationException({
+		code: "INSPECTION_BUSY",
+		operation: "create-project-inspection"
+	});
+	if (limits.maxRetainedBytes <= 50331648) throw new CoreOperationException({
+		code: "RESOURCE_LIMIT_EXCEEDED",
+		operation: "create-project-inspection",
+		limit: "maxRetainedBytes",
+		limitMaximum: limits.maxRetainedBytes,
+		observedUsage: NODE_INSPECTION_TRANSPORT_BYTES,
+		nextAction: "reduce-input-or-increase-limit"
+	});
+	const deadline = Math.min(Date.now() + NODE_INSPECTION_LIFETIME_MS, input.deadline ?? Infinity);
+	if (deadline <= Date.now()) throw new CoreOperationException({
+		code: "INSPECTION_TIMEOUT",
+		operation: "create-project-inspection"
+	});
+	isInspectionActive = true;
+	const controller = new AbortController();
+	const attemptId = randomBytes(16).toString("hex");
+	const prepared = createCompletion();
+	let pendingPage;
+	let pageRequestId = 0;
+	let lastReaderRequestId = -1;
+	let hasAcknowledgedHeap = false;
+	let heapMaximum;
+	let hasPrepared = false;
+	let isClosing = false;
+	let failure;
+	let cleanupPromise;
+	const readerWork = /* @__PURE__ */ new Set();
+	const relayWork = /* @__PURE__ */ new Set();
+	const child = (() => {
+		try {
+			return fork(fileURLToPath(import.meta.resolve("#moldea-core-runner")), [], {
+				execPath: process.execPath,
+				execArgv: [],
+				env: createInspectionEnvironment(),
+				serialization: "advanced",
+				stdio: [
+					"ignore",
+					"ignore",
+					"pipe",
+					"ipc"
+				]
+			});
+		} catch (cause) {
+			isInspectionActive = false;
+			throw createInspectionProcessFailure(cause);
+		}
+	})();
+	const send = createInspectionSender((frame, callback) => {
+		if (!child.connected) throw createInspectionProcessFailure();
+		child.send(frame, callback);
+	});
+	const supervision = superviseInspectionChild(child, () => {
+		send({
+			attemptId,
+			kind: "dispose"
+		}).catch(() => {
+			child.kill("SIGKILL");
+		});
+	});
+	/** Keeps admission until child closure and every real reader promise has settled. */
+	const cleanup = () => {
+		cleanupPromise ??= (async () => {
+			isClosing = true;
+			controller.abort(failure?.cause);
+			supervision.terminate();
+			await supervision.closed;
+			await Promise.allSettled([...readerWork, ...relayWork]);
+			repository = void 0;
+			clearTimeout(timer);
+			if (failure === void 0 && Date.now() >= deadline) fail(new CoreOperationException({
+				code: "INSPECTION_TIMEOUT",
+				operation: "create-project-inspection"
+			}));
+			signal?.removeEventListener("abort", handleAbort);
+			child.removeAllListeners("message");
+			child.removeAllListeners("error");
+			child.stderr?.removeAllListeners("data");
+			isInspectionActive = false;
+		})();
+		return cleanupPromise;
+	};
+	const fail = (cause) => {
+		if (failure === void 0) failure = { cause: cause instanceof Error ? cause : createInspectionProcessFailure(cause) };
+		prepared.reject(failure.cause);
+		pendingPage?.reject(failure.cause);
+		cleanup();
+	};
+	const getFailureCause = () => failure?.cause;
+	const handleAbort = () => {
+		fail(aborted(signal?.reason));
+	};
+	const timer = setTimeout(() => {
+		fail(new CoreOperationException({
+			code: "INSPECTION_TIMEOUT",
+			operation: "create-project-inspection"
+		}));
+	}, Math.max(1, deadline - Date.now()));
+	signal?.addEventListener("abort", handleAbort, { once: true });
+	const isCallerAborted = () => signal?.aborted === true;
+	if (isCallerAborted()) handleAbort();
+	child.once("error", (cause) => {
+		fail(createInspectionProcessFailure(cause));
+	});
+	supervision.closed.then(() => {
+		if (!isClosing) fail(createInspectionProcessFailure());
+	});
+	let stderrBytes = 0;
+	child.stderr?.on("data", (chunk) => {
+		stderrBytes += chunk.byteLength;
+		if (stderrBytes > 32768) fail(createInspectionProcessFailure());
+	});
+	child.on("message", (frame) => {
+		if (isClosing) return;
+		try {
+			const message = decodeInspectionMessage(frame);
+			if (message.attemptId !== attemptId) throw createInspectionProcessFailure();
+			if (message.kind === "ready") {
+				if (hasAcknowledgedHeap) throw createInspectionProcessFailure();
+				heapMaximum = message.maxAnalysisHeapBytes;
+				hasAcknowledgedHeap = true;
+				send({
+					attemptId,
+					kind: "run"
+				}).catch(fail);
+			} else if (message.kind === "prepared") {
+				if (!hasAcknowledgedHeap || hasPrepared || message.inspection.maxAnalysisHeapBytes !== heapMaximum || message.inspection.source.id !== snapshot.id || message.inspection.source.sourceKind !== snapshot.sourceKind) throw createInspectionProcessFailure();
+				hasPrepared = true;
+				prepared.resolve(freezeRecursively(message.inspection));
+			} else if (message.kind === "reader-request") {
+				if (!hasAcknowledgedHeap || hasPrepared || message.requestId !== lastReaderRequestId + 1 || readerWork.size >= 4) throw createInspectionProcessFailure();
+				lastReaderRequestId = message.requestId;
+				if (repository === void 0) throw createInspectionProcessFailure();
+				const work = executeRepositoryRpc(repository, message.request, controller.signal);
+				readerWork.add(work);
+				const relay = (async () => {
+					try {
+						const result = await work;
+						readerWork.delete(work);
+						if (!isClosing) await send({
+							attemptId,
+							kind: "reader-response",
+							requestId: message.requestId,
+							result
+						});
+					} catch (cause) {
+						if (cause instanceof RepositorySourceException && [
+							"ENTRY_NOT_FOUND",
+							"ENTRY_NOT_FILE",
+							"RESOURCE_LIMIT_EXCEEDED"
+						].includes(cause.code)) try {
+							if (!isClosing) await send({
+								attemptId,
+								kind: "reader-failure",
+								requestId: message.requestId,
+								failure: serializeInspectionFailure(cause)
+							});
+						} catch (transportFailure) {
+							fail(transportFailure);
+						}
+						else fail(cause);
+					} finally {
+						readerWork.delete(work);
+					}
+				})();
+				relayWork.add(relay);
+				relay.finally(() => relayWork.delete(relay));
+			} else if (message.kind === "page") {
+				if (!hasPrepared || pendingPage === void 0 || message.requestId !== pageRequestId) throw createInspectionProcessFailure();
+				const completion = pendingPage;
+				pendingPage = void 0;
+				completion.resolve(freezeRecursively(message.result));
+			} else if (message.kind === "failure") {
+				if (message.failure.options["nextAction"] === "review-inspection-capacity" && (heapMaximum === void 0 || message.failure.options["limitMaximum"] !== heapMaximum)) throw createInspectionProcessFailure();
+				fail(deserializeInspectionFailure(message.failure));
+			} else throw createInspectionProcessFailure();
+		} catch (cause) {
+			fail(cause);
+		}
+	});
+	try {
+		await send({
+			attemptId,
+			kind: "start",
+			snapshot,
+			limits,
+			deadline
+		});
+		const metadata = await prepared.promise;
+		if (Date.now() >= deadline) throw new CoreOperationException({
+			code: "INSPECTION_TIMEOUT",
+			operation: "create-project-inspection"
+		});
+		return Object.freeze({
+			...metadata,
+			readPage: async (pageInput) => {
+				if (failure !== void 0 || isClosing) throw failure?.cause ?? aborted();
+				if (pendingPage !== void 0 || pageInput === null || typeof pageInput !== "object" || Reflect.ownKeys(pageInput).some((key) => key !== "cursor" && key !== "maxItems" && key !== "view") || !Number.isSafeInteger(pageInput.maxItems) || pageInput.maxItems < 1 || pageInput.maxItems > limits.maxEntries || ![
+					"all",
+					"diagnostics",
+					"coverage",
+					"metadata"
+				].includes(pageInput.view) || pageInput.cursor !== void 0 && typeof pageInput.cursor !== "string") throw new CoreOperationException({
+					code: "INVALID_ARGUMENT",
+					operation: "create-project-inspection"
+				});
+				const completion = createCompletion();
+				pendingPage = completion;
+				pageRequestId++;
+				try {
+					if (Date.now() >= deadline) throw new CoreOperationException({
+						code: "INSPECTION_TIMEOUT",
+						operation: "create-project-inspection"
+					});
+					await send({
+						attemptId,
+						kind: "read-page",
+						requestId: pageRequestId,
+						input: {
+							maxItems: pageInput.maxItems,
+							view: pageInput.view,
+							...pageInput.cursor === void 0 ? {} : { cursor: pageInput.cursor }
+						}
+					});
+					const result = await completion.promise;
+					if (Date.now() >= deadline) throw new CoreOperationException({
+						code: "INSPECTION_TIMEOUT",
+						operation: "create-project-inspection"
+					});
+					return result;
+				} catch (cause) {
+					fail(cause);
+					await cleanup();
+					throw getFailureCause() ?? createInspectionProcessFailure(cause);
+				} finally {
+					if (pendingPage === completion) pendingPage = void 0;
+				}
+			},
+			dispose: async () => {
+				pendingPage?.reject(failure?.cause ?? aborted());
+				await cleanup();
+				const cause = getFailureCause();
+				if (cause !== void 0) throw cause;
+			}
+		});
+	} catch (cause) {
+		fail(cause);
+		await cleanup();
+		throw getFailureCause() ?? createInspectionProcessFailure(cause);
+	}
+};
+//#endregion
+export { NODE_INSPECTION_PROFILE, createNodeProjectInspection };
+
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","names":[],"sources":["../src/node-inspection/client.ts"],"sourcesContent":["import { fork } from 'node:child_process';\nimport { randomBytes } from 'node:crypto';\nimport { fileURLToPath } from 'node:url';\n\nimport { RepositorySourceException } from '@moldea.ai/repository';\n\nimport { CoreOperationException } from '../exceptions/index.js';\nimport { freezeRecursively } from '../immutable/index.js';\nimport { normalizeCoreOptions } from '../options/index.js';\n\nimport {\n  NODE_INSPECTION_LIFETIME_MS,\n  NODE_INSPECTION_MAX_REQUESTS,\n  NODE_INSPECTION_STDIO_BYTES,\n  NODE_INSPECTION_TRANSPORT_BYTES,\n} from './constants.js';\nimport { deserializeInspectionFailure, serializeInspectionFailure } from './errors.js';\nimport {\n  createInspectionEnvironment,\n  createInspectionSender,\n  superviseInspectionChild,\n} from './lifecycle.js';\nimport { createInspectionProcessFailure, decodeInspectionMessage } from './protocol.js';\nimport { executeRepositoryRpc } from './repository-rpc.js';\nimport type {\n  INodeInspectionMetadata,\n  INodeProjectInspection,\n  INodeProjectInspectionInput,\n} from './types.js';\nimport type { IProjectInspectionPageResult } from '../contracts/index.js';\n\nlet isInspectionActive = false;\n\n/** Stores one completion without an unhandled rejection before its owner begins awaiting it. */\nconst createCompletion = <T>(): {\n  promise: Promise<T>;\n  resolve: (result: T) => void;\n  reject: (cause: unknown) => void;\n} => {\n  let resolve!: (result: T) => void;\n  let reject!: (cause: unknown) => void;\n  const promise = new Promise<T>((resolveResult, rejectResult) => {\n    resolve = resolveResult;\n    reject = rejectResult;\n  });\n  void promise.catch(() => {});\n  return { promise, resolve, reject };\n};\n\nconst aborted = (cause?: unknown): CoreOperationException =>\n  new CoreOperationException({\n    code: 'ABORTED',\n    operation: 'create-project-inspection',\n    ...(cause === undefined ? {} : { cause }),\n  });\n\n/**\n * Prepares content-free inspection inside one supervised subprocess and one analysis worker.\n * The caller owns actual reader work and must dispose the returned handle before publishing success.\n * @returns An async paging handle after the worker reports its actual heap and prepares inspection.\n * @throws\n * - INVALID_ARGUMENT: The Core operation received an invalid argument.\n * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.\n * - ABORTED: The Core operation was aborted.\n * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.\n * - INSPECTION_BUSY: Project inspection capacity is busy. Try again shortly.\n * - INSPECTION_TIMEOUT: The isolated project inspection timed out.\n * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.\n * - INVALID_REPOSITORY_PATH: The repository path is invalid.\n * - ENTRY_NOT_FOUND: The requested repository entry was not found.\n * - ENTRY_NOT_FILE: The requested repository entry is not a file.\n * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.\n * - INVALID_PAGE_REQUEST: The repository page request is invalid.\n * - ACCESS_DENIED: Access to the repository source was denied.\n * - SOURCE_UNAVAILABLE: The repository source is unavailable.\n * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.\n * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.\n * - INVALID_SOURCE_DATA: The repository source returned invalid data.\n * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.\n * - ABORTED: The repository operation was aborted.\n */\nexport const createNodeProjectInspection = async (\n  input: INodeProjectInspectionInput,\n): Promise<INodeProjectInspection> => {\n  if (\n    input === null ||\n    typeof input !== 'object' ||\n    input.repository === null ||\n    typeof input.repository !== 'object' ||\n    typeof input.repository.getEntry !== 'function' ||\n    typeof input.repository.listEntriesPage !== 'function' ||\n    typeof input.repository.readFilePage !== 'function' ||\n    input.repository.snapshot === null ||\n    typeof input.repository.snapshot !== 'object' ||\n    typeof input.repository.snapshot.id !== 'string' ||\n    input.repository.snapshot.id.length === 0 ||\n    typeof input.repository.snapshot.sourceKind !== 'string' ||\n    input.repository.snapshot.sourceKind.length === 0\n  ) {\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  }\n  let repository: INodeProjectInspectionInput['repository'] | undefined = input.repository;\n  const snapshot = { id: repository.snapshot.id, sourceKind: repository.snapshot.sourceKind };\n  const signal = input.signal;\n  if (\n    signal !== undefined &&\n    (signal === null ||\n      typeof signal !== 'object' ||\n      typeof signal.aborted !== 'boolean' ||\n      typeof signal.addEventListener !== 'function' ||\n      typeof signal.removeEventListener !== 'function')\n  ) {\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  }\n  const { limits } = normalizeCoreOptions({\n    ...(input.limits === undefined ? {} : { limits: input.limits }),\n  });\n  if (input.deadline !== undefined && (!Number.isSafeInteger(input.deadline) || input.deadline < 0))\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  if (signal?.aborted === true) throw aborted(signal.reason);\n  if (isInspectionActive)\n    throw new CoreOperationException({\n      code: 'INSPECTION_BUSY',\n      operation: 'create-project-inspection',\n    });\n  if (limits.maxRetainedBytes <= NODE_INSPECTION_TRANSPORT_BYTES)\n    throw new CoreOperationException({\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n      operation: 'create-project-inspection',\n      limit: 'maxRetainedBytes',\n      limitMaximum: limits.maxRetainedBytes,\n      observedUsage: NODE_INSPECTION_TRANSPORT_BYTES,\n      nextAction: 'reduce-input-or-increase-limit',\n    });\n  const deadline = Math.min(Date.now() + NODE_INSPECTION_LIFETIME_MS, input.deadline ?? Infinity);\n  if (deadline <= Date.now())\n    throw new CoreOperationException({\n      code: 'INSPECTION_TIMEOUT',\n      operation: 'create-project-inspection',\n    });\n  isInspectionActive = true;\n  const controller = new AbortController();\n  const attemptId = randomBytes(16).toString('hex');\n  const prepared = createCompletion<INodeInspectionMetadata>();\n  let pendingPage: ReturnType<typeof createCompletion<IProjectInspectionPageResult>> | undefined;\n  let pageRequestId = 0;\n  let lastReaderRequestId = -1;\n  let hasAcknowledgedHeap = false;\n  let heapMaximum: number | undefined;\n  let hasPrepared = false;\n  let isClosing = false;\n  let failure: { cause: Error } | undefined;\n  let cleanupPromise: Promise<void> | undefined;\n  const readerWork = new Set<Promise<unknown>>();\n  const relayWork = new Set<Promise<void>>();\n  const child = (() => {\n    try {\n      return fork(fileURLToPath(import.meta.resolve('#moldea-core-runner')), [], {\n        execPath: process.execPath,\n        execArgv: [],\n        env: createInspectionEnvironment(),\n        serialization: 'advanced',\n        stdio: ['ignore', 'ignore', 'pipe', 'ipc'],\n      });\n    } catch (cause) {\n      isInspectionActive = false;\n      throw createInspectionProcessFailure(cause);\n    }\n  })();\n  const send = createInspectionSender((frame, callback) => {\n    if (!child.connected) throw createInspectionProcessFailure();\n    child.send(frame, callback);\n  });\n  const supervision = superviseInspectionChild(child, () => {\n    void send({ attemptId, kind: 'dispose' }).catch(() => {\n      child.kill('SIGKILL');\n    });\n  });\n\n  /** Keeps admission until child closure and every real reader promise has settled. */\n  const cleanup = (): Promise<void> => {\n    cleanupPromise ??= (async () => {\n      isClosing = true;\n      controller.abort(failure?.cause);\n      supervision.terminate();\n      await supervision.closed;\n      await Promise.allSettled([...readerWork, ...relayWork]);\n      repository = undefined;\n      clearTimeout(timer);\n      if (failure === undefined && Date.now() >= deadline) {\n        fail(\n          new CoreOperationException({\n            code: 'INSPECTION_TIMEOUT',\n            operation: 'create-project-inspection',\n          }),\n        );\n      }\n      signal?.removeEventListener('abort', handleAbort);\n      child.removeAllListeners('message');\n      child.removeAllListeners('error');\n      child.stderr?.removeAllListeners('data');\n      isInspectionActive = false;\n    })();\n    return cleanupPromise;\n  };\n  const fail = (cause: unknown): void => {\n    if (failure === undefined)\n      failure = { cause: cause instanceof Error ? cause : createInspectionProcessFailure(cause) };\n    prepared.reject(failure.cause);\n    pendingPage?.reject(failure.cause);\n    void cleanup();\n  };\n  const getFailureCause = (): Error | undefined => failure?.cause;\n  const handleAbort = (): void => {\n    fail(aborted(signal?.reason));\n  };\n  const timer = setTimeout(\n    () => {\n      fail(\n        new CoreOperationException({\n          code: 'INSPECTION_TIMEOUT',\n          operation: 'create-project-inspection',\n        }),\n      );\n    },\n    Math.max(1, deadline - Date.now()),\n  );\n  signal?.addEventListener('abort', handleAbort, { once: true });\n  // Re-read through a function because cancellation can change during listener registration.\n  const isCallerAborted = (): boolean => signal?.aborted === true;\n  if (isCallerAborted()) handleAbort();\n  child.once('error', (cause: unknown) => {\n    fail(createInspectionProcessFailure(cause));\n  });\n  void supervision.closed.then(() => {\n    if (!isClosing) fail(createInspectionProcessFailure());\n  });\n  let stderrBytes = 0;\n  child.stderr?.on('data', (chunk: Buffer) => {\n    stderrBytes += chunk.byteLength;\n    if (stderrBytes > NODE_INSPECTION_STDIO_BYTES) fail(createInspectionProcessFailure());\n  });\n  child.on('message', (frame: unknown) => {\n    if (isClosing) return;\n    try {\n      const message = decodeInspectionMessage(frame);\n      if (message.attemptId !== attemptId) throw createInspectionProcessFailure();\n      if (message.kind === 'ready') {\n        if (hasAcknowledgedHeap) throw createInspectionProcessFailure();\n        heapMaximum = message.maxAnalysisHeapBytes;\n        hasAcknowledgedHeap = true;\n        void send({ attemptId, kind: 'run' }).catch(fail);\n      } else if (message.kind === 'prepared') {\n        if (\n          !hasAcknowledgedHeap ||\n          hasPrepared ||\n          message.inspection.maxAnalysisHeapBytes !== heapMaximum ||\n          message.inspection.source.id !== snapshot.id ||\n          message.inspection.source.sourceKind !== snapshot.sourceKind\n        )\n          throw createInspectionProcessFailure();\n        hasPrepared = true;\n        prepared.resolve(freezeRecursively(message.inspection));\n      } else if (message.kind === 'reader-request') {\n        if (\n          !hasAcknowledgedHeap ||\n          hasPrepared ||\n          message.requestId !== lastReaderRequestId + 1 ||\n          readerWork.size >= NODE_INSPECTION_MAX_REQUESTS\n        )\n          throw createInspectionProcessFailure();\n        lastReaderRequestId = message.requestId;\n        if (repository === undefined) throw createInspectionProcessFailure();\n        const work = executeRepositoryRpc(repository, message.request, controller.signal);\n        readerWork.add(work);\n        const relay = (async () => {\n          try {\n            const result = await work;\n            readerWork.delete(work);\n            if (!isClosing)\n              await send({\n                attemptId,\n                kind: 'reader-response',\n                requestId: message.requestId,\n                result,\n              });\n          } catch (cause) {\n            // Core decides whether absence or a reader resource refusal is recoverable at this check.\n            if (\n              cause instanceof RepositorySourceException &&\n              ['ENTRY_NOT_FOUND', 'ENTRY_NOT_FILE', 'RESOURCE_LIMIT_EXCEEDED'].includes(cause.code)\n            ) {\n              try {\n                if (!isClosing)\n                  await send({\n                    attemptId,\n                    kind: 'reader-failure',\n                    requestId: message.requestId,\n                    failure: serializeInspectionFailure(cause),\n                  });\n              } catch (transportFailure) {\n                fail(transportFailure);\n              }\n            } else fail(cause);\n          } finally {\n            readerWork.delete(work);\n          }\n        })();\n        relayWork.add(relay);\n        void relay.finally(() => relayWork.delete(relay));\n      } else if (message.kind === 'page') {\n        if (!hasPrepared || pendingPage === undefined || message.requestId !== pageRequestId)\n          throw createInspectionProcessFailure();\n        const completion = pendingPage;\n        pendingPage = undefined;\n        completion.resolve(freezeRecursively(message.result));\n      } else if (message.kind === 'failure') {\n        if (\n          message.failure.options['nextAction'] === 'review-inspection-capacity' &&\n          (heapMaximum === undefined || message.failure.options['limitMaximum'] !== heapMaximum)\n        )\n          throw createInspectionProcessFailure();\n        fail(deserializeInspectionFailure(message.failure));\n      } else throw createInspectionProcessFailure();\n    } catch (cause) {\n      fail(cause);\n    }\n  });\n  try {\n    await send({\n      attemptId,\n      kind: 'start',\n      snapshot,\n      limits,\n      deadline,\n    });\n    const metadata = await prepared.promise;\n    if (Date.now() >= deadline)\n      throw new CoreOperationException({\n        code: 'INSPECTION_TIMEOUT',\n        operation: 'create-project-inspection',\n      });\n    return Object.freeze({\n      ...metadata,\n      readPage: async (pageInput): Promise<IProjectInspectionPageResult> => {\n        if (failure !== undefined || isClosing) throw failure?.cause ?? aborted();\n        if (\n          pendingPage !== undefined ||\n          pageInput === null ||\n          typeof pageInput !== 'object' ||\n          Reflect.ownKeys(pageInput).some(\n            (key) => key !== 'cursor' && key !== 'maxItems' && key !== 'view',\n          ) ||\n          !Number.isSafeInteger(pageInput.maxItems) ||\n          pageInput.maxItems < 1 ||\n          pageInput.maxItems > limits.maxEntries ||\n          !['all', 'diagnostics', 'coverage', 'metadata'].includes(pageInput.view) ||\n          (pageInput.cursor !== undefined && typeof pageInput.cursor !== 'string')\n        )\n          throw new CoreOperationException({\n            code: 'INVALID_ARGUMENT',\n            operation: 'create-project-inspection',\n          });\n        const completion = createCompletion<IProjectInspectionPageResult>();\n        pendingPage = completion;\n        pageRequestId++;\n        try {\n          if (Date.now() >= deadline)\n            throw new CoreOperationException({\n              code: 'INSPECTION_TIMEOUT',\n              operation: 'create-project-inspection',\n            });\n          await send({\n            attemptId,\n            kind: 'read-page',\n            requestId: pageRequestId,\n            input: {\n              maxItems: pageInput.maxItems,\n              view: pageInput.view,\n              ...(pageInput.cursor === undefined ? {} : { cursor: pageInput.cursor }),\n            },\n          });\n          const result = await completion.promise;\n          if (Date.now() >= deadline)\n            throw new CoreOperationException({\n              code: 'INSPECTION_TIMEOUT',\n              operation: 'create-project-inspection',\n            });\n          return result;\n        } catch (cause) {\n          fail(cause);\n          await cleanup();\n          throw getFailureCause() ?? createInspectionProcessFailure(cause);\n        } finally {\n          if (pendingPage === completion) pendingPage = undefined;\n        }\n      },\n      dispose: async (): Promise<void> => {\n        pendingPage?.reject(failure?.cause ?? aborted());\n        await cleanup();\n        const cause = getFailureCause();\n        if (cause !== undefined) throw cause;\n      },\n    } satisfies INodeProjectInspection);\n  } catch (cause) {\n    fail(cause);\n    await cleanup();\n    throw getFailureCause() ?? createInspectionProcessFailure(cause);\n  }\n};\n"],"mappings":"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"}

package/dist/options/index.d.ts

@@ -1,25 +1,13 @@
-import type { IRuntimeAdapterContext, IRuntimeAdapterResult } from '../adapter/index.js';
 import type { ICoreOptions, ICoreResourceLimits } from '../contracts/index.js';
-import type { IRepositoryFormatVersion } from '../format/index.js';
-export interface IRuntimeAdapterSnapshot {
-    readonly id: string;
-    readonly supportedRepositoryFormatVersions: readonly IRepositoryFormatVersion[];
-    readonly inspect: (context: IRuntimeAdapterContext) => Promise<IRuntimeAdapterResult>;
-}
 export interface ICoreOptionsSnapshot {
-    readonly adapters: readonly IRuntimeAdapterSnapshot[];
     readonly limits: ICoreResourceLimits;
 }
 /** Creates an operation-local options view with one shared raw-diagnostic budget. */
 export declare const createCoreOperationOptionsSnapshot: (options: ICoreOptionsSnapshot) => ICoreOptionsSnapshot;
 /**
- * Validates and snapshots caller-owned Core construction options.
- * @param options The optional adapters and resource-limit overrides.
- * @returns A deeply frozen, deterministically ordered configuration snapshot.
+ * Validates and snapshots caller-owned Core resource limits.
+ * @returns A deeply frozen configuration snapshot.
  * @throws
- * - 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.
  * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.
  */
 export declare const normalizeCoreOptions: (options: ICoreOptions | undefined) => ICoreOptionsSnapshot;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/options/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAInE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,iCAAiC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAChF,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACvF;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC;AAED,qFAAqF;AACrF,eAAO,MAAM,kCAAkC,GAC7C,SAAS,oBAAoB,KAC5B,oBAKF,CAAC;AAkMF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,YAAY,GAAG,SAAS,KAAG,oBASxE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/options/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC;AAED,qFAAqF;AACrF,eAAO,MAAM,kCAAkC,GAC7C,SAAS,oBAAoB,KAC5B,oBAIF,CAAC;AAqEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,YAAY,GAAG,SAAS,KAAG,oBAWxE,CAAC"}

package/dist/project-inspection/index.d.ts

@@ -1,5 +1,25 @@
 import type { IProjectInspection, IProjectInspectionInput } from '../contracts/index.js';
 import type { ICoreOptionsSnapshot } from '../options/index.js';
-/** Prepares one immutable content-free inspection for synchronous bounded page reads. */
+/**
+ * Prepares one immutable content-free inspection for synchronous bounded page reads.
+ * @param input The source-neutral reader and optional cancellation signal.
+ * @param options The immutable operation limits.
+ * @returns A promise resolving to the complete prepared inspection.
+ * @throws
+ * - INVALID_ARGUMENT: The Core operation received an invalid argument.
+ * - 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.
+ * - 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.
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ * - ABORTED: The repository operation was aborted.
+ * - ABORTED: The Core operation was aborted.
+ */
 export declare const createProjectInspection: (input: IProjectInspectionInput, options: ICoreOptionsSnapshot) => Promise<IProjectInspection>;
 //# sourceMappingURL=index.d.ts.map

package/dist/project-inspection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-inspection/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EAOxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAmchE,yFAAyF;AACzF,eAAO,MAAM,uBAAuB,GAClC,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,kBAAkB,CAiC5B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-inspection/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EAOxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAsdhE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,kBAAkB,CAmC5B,CAAC"}

package/dist/project-validation/index.d.ts

@@ -7,25 +7,47 @@ export interface IProjectValidationState {
     readonly result: IProjectValidationResult;
 }
 /**
- * Inspects one coherent repository snapshot through universal and adapter validation.
+ * Inspects one coherent repository snapshot through universal file and export validation.
  * @param input The untrusted source-neutral reader and optional cancellation signal.
  * @param options The immutable Core configuration snapshot.
  * @returns A promise resolving to the frozen all-or-nothing project inspection result.
  * @throws
  * - INVALID_ARGUMENT: The Core operation received an invalid argument.
- * - INVALID_REPOSITORY_PATH: A repository path is invalid.
- * - ENTRY_NOT_FOUND: A discovered file disappeared from the reader snapshot.
- * - ENTRY_NOT_FILE: A discovered file changed type during inspection.
- * - ENTRY_NOT_DIRECTORY: A discovered directory changed type during inspection.
+ * - 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.
  * - ACCESS_DENIED: Access to the repository source was denied.
  * - SOURCE_UNAVAILABLE: The repository source is unavailable.
- * - SNAPSHOT_CHANGED: The repository snapshot changed during inspection.
- * - INVALID_SOURCE_DATA: The repository reader returned invalid contract data.
- * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
- * - ABORTED: Project inspection or a repository operation was aborted.
- * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed or returned an invalid result.
+ * - 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.
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ * - ABORTED: The repository operation was aborted.
+ * - ABORTED: The Core operation was aborted.
  */
 export declare const validateProjectState: (input: IProjectValidationInput, options: ICoreOptionsSnapshot) => Promise<IProjectValidationState>;
-/** Validates one project without returning canonical document bodies. */
+/**
+ * Validates one project without returning canonical document bodies.
+ * @param input The source-neutral reader and optional cancellation signal.
+ * @param options The immutable operation limits.
+ * @returns A promise resolving to the complete validation result.
+ * @throws
+ * - INVALID_ARGUMENT: The Core operation received an invalid argument.
+ * - 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.
+ * - 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.
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ * - ABORTED: The repository operation was aborted.
+ * - ABORTED: The Core operation was aborted.
+ */
 export declare const validateProject: (input: IProjectValidationInput, options: ICoreOptionsSnapshot) => Promise<IProjectValidationResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/project-validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-validation/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAwEpG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,kCAAkC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,uBAAuB,CAkFjC,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,eAAe,GAC1B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,wBAAwB,CAAwD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-validation/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAwEpG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,kCAAkC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,uBAAuB,CAgCjC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,wBAAwB,CAAwD,CAAC"}

package/dist/repository-inspection-session/index.d.ts

@@ -1,6 +1,5 @@
 import { type IRepositoryEntry, type IRepositoryOperationOptions, type IRepositoryPath, type IRepositoryReader } from '@moldea.ai/repository';
 import type { ICoreResourceLimits } from '../contracts/index.js';
-import type { IRuntimeAdapterRepository } from '../adapter/index.js';
 export interface IRepositoryInspectionListOptions extends IRepositoryOperationOptions {
     readonly prefix?: IRepositoryPath;
 }
@@ -10,14 +9,13 @@ export interface IRepositoryInspectionReader {
     readCompleteFile(path: IRepositoryPath, options?: IRepositoryOperationOptions): Promise<Uint8Array>;
 }
 export interface IRepositoryInspectionSession {
-    readonly adapterRepository: IRuntimeAdapterRepository;
     readonly reader: IRepositoryInspectionReader;
     /** Returns deterministic logical resource usage for the current validation state. */
     getResourceUsage(): IRepositoryInspectionResourceUsage;
     /**
      * Stops work at an inspection boundary when cancellation was requested.
      * @throws
-     * - ABORTED: Repository inspection was aborted.
+     * - ABORTED: The Core operation was aborted.
      */
     throwIfAborted(): void;
 }
@@ -34,7 +32,7 @@ export interface IRepositoryInspectionResourceUsage {
  * @param signal Optional cancellation shared by every inspection operation.
  * @returns A session that pages source metadata and range-reads bounded canonical files.
  * @throws
- * - ABORTED: Repository inspection was aborted before the session was created.
+ * - ABORTED: The Core operation was aborted.
  */
 export declare const createRepositoryInspectionSession: (repository: IRepositoryReader, limits: ICoreResourceLimits, signal?: AbortSignal) => IRepositoryInspectionSession;
 //# sourceMappingURL=index.d.ts.map

package/dist/repository-inspection-session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-inspection-session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EAErB,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAcrE,MAAM,WAAW,gCAAiC,SAAQ,2BAA2B;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAGD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CACN,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpC,cAAc,CAAC,OAAO,CAAC,EAAE,gCAAgC,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC5F,gBAAgB,CACd,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB;AAGD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE7C,qFAAqF;IACrF,gBAAgB,IAAI,kCAAkC,CAAC;IAEvD;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAAC;CACxB;AAGD,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAmGD;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAC5C,YAAY,iBAAiB,EAC7B,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,4BAufF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-inspection-session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EAErB,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAcjE,MAAM,WAAW,gCAAiC,SAAQ,2BAA2B;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAGD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CACN,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpC,cAAc,CAAC,OAAO,CAAC,EAAE,gCAAgC,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC5F,gBAAgB,CACd,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB;AAGD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE7C,qFAAqF;IACrF,gBAAgB,IAAI,kCAAkC,CAAC;IAEvD;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAAC;CACxB;AAGD,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAmGD;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAC5C,YAAY,iBAAiB,EAC7B,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,4BAgYF,CAAC"}

package/dist/repository-reference-validation/index.d.ts

@@ -1,4 +1,5 @@
 import { type IRepositoryPath } from '@moldea.ai/repository';
+import type { IBindingCoverage } from '../binding-coverage/index.js';
 import type { ICanonicalDiscoveryResult } from '../canonical-discovery/index.js';
 import type { ICoreResourceLimits } from '../contracts/index.js';
 import type { ICoreDiagnostic } from '../diagnostics/index.js';
@@ -12,15 +13,20 @@ import type { IRepositoryInspectionReader } from '../repository-inspection-sessi
  * @param discovery Canonical discovery state used to suppress dependent path diagnostics.
  * @param limits The resource limits applied to emitted diagnostics.
  * @param signal Optional cancellation forwarded to exact repository lookups.
+ * @param coverage Operation-owned binding coverage populated only for regular files.
  * @returns Deeply immutable deterministic repository-reference diagnostics.
  * @throws
- * - INVALID_REPOSITORY_PATH: A repository path is invalid.
+ * - 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.
  * - ACCESS_DENIED: Access to the repository source was denied.
  * - SOURCE_UNAVAILABLE: The repository source is unavailable.
- * - SNAPSHOT_CHANGED: The repository snapshot changed during validation.
- * - INVALID_SOURCE_DATA: The repository reader returned invalid contract data.
- * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
- * - ABORTED: Repository inspection or a repository lookup was aborted.
+ * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+ * - INVALID_SOURCE_DATA: The repository source returned invalid data.
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+ * - ABORTED: The Core operation was aborted.
+ * - ABORTED: The repository operation was aborted.
  */
-export declare const validateRepositoryReferences: (repository: IRepositoryInspectionReader, manifestPath: IRepositoryPath, manifest: IMoldeaManifestV1, discovery: ICanonicalDiscoveryResult, limits: ICoreResourceLimits, signal?: AbortSignal) => Promise<readonly ICoreDiagnostic[]>;
+export declare const validateRepositoryReferences: (repository: IRepositoryInspectionReader, manifestPath: IRepositoryPath, manifest: IMoldeaManifestV1, discovery: ICanonicalDiscoveryResult, limits: ICoreResourceLimits, signal?: AbortSignal, coverage?: IBindingCoverage[]) => Promise<readonly ICoreDiagnostic[]>;
 //# sourceMappingURL=index.d.ts.map

package/dist/repository-reference-validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-reference-validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMjE,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAEV,iBAAiB,EAMlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAqX7F;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,4BAA4B,GACvC,YAAY,2BAA2B,EACvC,cAAc,eAAe,EAC7B,UAAU,iBAAiB,EAC3B,WAAW,yBAAyB,EACpC,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,OAAO,CAAC,SAAS,eAAe,EAAE,CA2BpC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-reference-validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,8BAA8B,CAAC;AAI3F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMjE,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAEV,iBAAiB,EAMlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AA6Y7F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,4BAA4B,GACvC,YAAY,2BAA2B,EACvC,cAAc,eAAe,EAC7B,UAAU,iBAAiB,EAC3B,WAAW,yBAAyB,EACpC,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,EACpB,WAAU,gBAAgB,EAAO,KAChC,OAAO,CAAC,SAAS,eAAe,EAAE,CAkFpC,CAAC"}

package/dist/retained-memory/index.d.ts

@@ -0,0 +1,18 @@
+import type { IRepositoryPath } from '@moldea.ai/repository';
+import type { IRepositoryInspectionReader } from '../repository-inspection-session/index.js';
+export interface IRetainedMemory {
+    reserve(bytes: number): void;
+    tryReserve(bytes: number): boolean;
+    release(bytes: number): void;
+    readSourceFile(path: IRepositoryPath): Promise<{
+        bytes: Uint8Array;
+        release: () => void;
+    }>;
+}
+/** Registers the sole memory owner for one internal reader. */
+export declare const registerRetainedMemory: (reader: IRepositoryInspectionReader, ledger: IRetainedMemory) => void;
+/** Returns the ledger shared by all phases of a repository inspection. */
+export declare const getRetainedMemory: (reader: IRepositoryInspectionReader) => IRetainedMemory;
+/** Reserves retained coverage in production sessions and leaves standalone file-check readers untracked. */
+export declare const reserveRetainedBytesIfTracked: (reader: IRepositoryInspectionReader, bytes: number) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/retained-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retained-memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAG7F,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC;CAC5F;AAID,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,GACjC,QAAQ,2BAA2B,EACnC,QAAQ,eAAe,KACtB,IAGF,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,GAAI,QAAQ,2BAA2B,KAAG,eAKvE,CAAC;AAEF,4GAA4G;AAC5G,eAAO,MAAM,6BAA6B,GACxC,QAAQ,2BAA2B,EACnC,OAAO,MAAM,KACZ,IAEF,CAAC"}

package/dist/scope/index.d.ts

@@ -0,0 +1,3 @@
+export type { IManifestScopeInput, IManifestScopeResult, IManifestScopeCounts, IManifestScopeDeclaration, IManifestScopeMatch, IManifestScopeOwner, IManifestScopeOwnerKind, IManifestScopeRelationshipField, IExactManifestScopeDeclaration, IGlobManifestScopeDeclaration, } from '../scope-matching/index.js';
+export { matchManifestScope } from './scope.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scope/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,+BAA+B,EAC/B,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}