@moldea.ai/core 5.0.1 → 6.0.0

package/README.md

@@ -4,12 +4,12 @@
 
 Source-neutral, deterministic, content-safe interpretation of the `moldea` repository format.
 
-Version 5 accepts caller-supplied text and `@moldea.ai/repository` version 2 readers. It performs no filesystem, Git, or network access independently. Project validation returns content-free summaries, diagnostics, evidence, agent assignments, and metadata. Canonical document bodies are available only through an explicit path-scoped byte-range operation.
+Version 6 accepts caller-supplied text and `@moldea.ai/repository` version 2 readers. The main, format, and adapter entry points remain environment-neutral. Repository access belongs to the caller-supplied reader. Project validation returns content-free summaries, diagnostics, evidence, agent assignments, and metadata. Canonical document bodies are available only through an explicit path-scoped byte-range operation.
 
 ## Install
 
 ```bash
-pnpm add @moldea.ai/core@5 @moldea.ai/repository@2
+pnpm add @moldea.ai/core@6 @moldea.ai/repository@2
 ```
 
 ## Public entry points
@@ -17,6 +17,7 @@ pnpm add @moldea.ai/core@5 @moldea.ai/repository@2
 - `@moldea.ai/core` exposes Core construction, operations, results, diagnostics, limits, and exceptions.
 - `@moldea.ai/core/format` exposes repository-format contracts.
 - `@moldea.ai/core/adapter` exposes the per-agent runtime-adapter contract and bounded reader utilities.
+- `@moldea.ai/core/node` exposes supervised Node inspection with asynchronous paging and disposal. It imports only a caller-selected trusted installed adapter registry, never project application code. Its frozen `NODE_INSPECTION_PROFILE` reports the fixed heap, lifetime, bridge and transport settings for authenticated consumer state; it does not configure them. Each inspection handle separately reports the runtime's actual V8 heap limit.
 
 ## Text and document parsing
 
@@ -65,7 +66,9 @@ const repository = createMemoryRepositoryReader([
 const result = await core.validateProject({ repository });
 ```
 
-`validateProject` returns validity, format version, source identity, summary counts and digests, diagnostics, and runtime evidence. It never returns manifest, project, context, decision, runtime-guidance, mirror, description, or instruction bodies.
+`validateProject` returns validity, runtime-inspection status, format version, source identity, summary counts and digests, diagnostics, and runtime evidence. It never returns manifest, project, context, decision, runtime-guidance, mirror, description, or instruction bodies.
+
+`runtimeInspection` is `complete` when applicable runtime checks finish without unverified relationships, `incomplete` when any relationship remains unverified, and `not-run` when universal checks or adapter availability prevent runtime inspection. Validity remains based on errors. Warning-only results are valid, and projects without runtime relationships are complete. Every prepared inspection and page preserves the same aggregate status.
 
 `createProjectInspection` validates the snapshot once, prepares one immutable content-free record set, and returns synchronous bounded page reads for the `metadata`, `diagnostics`, `evidence`, and `all` views. The `metadata` and `all` views include one independently keyed `agent` record per canonical agent with exactly its `agentId` and manifest-declared `runtimeId`, distinct from asset metadata and adapter evidence. Each page uses a semantic continuation cursor tied to the complete inspection digest and view. Page reads perform no repository access, revalidation, sorting, digesting, or adapter execution.
 
@@ -73,7 +76,11 @@ The prepared inspection retains only its content-free records, summary, source i
 
 ## Per-agent runtime adapters
 
-Universal validation must succeed before adapters run. Core invokes a configured package adapter once for each matching agent, in deterministic adapter and agent order. Each invocation receives only that agent, a bounded reader, a shared cancellation signal, and an exact same-runtime `resolveAgent(reference)` function for bindings that genuinely require another agent. It never receives the complete agent collection.
+Universal validation must succeed before adapters run. Core invokes a configured package adapter once for each matching agent, in deterministic adapter and agent order. Each invocation receives only that agent, a bounded reader, a shared cancellation signal, the remaining operation-wide diagnostic/evidence allowance as `outputBudget`, and an exact same-runtime `resolveAgent(reference)` function for bindings that genuinely require another agent. It never receives the complete agent collection.
+
+Adapters use `createRuntimeAdapterResultCollector(context)` from `@moldea.ai/core/adapter`. Its `diagnostics.add(factory)` and `evidence.add(factory)` methods reserve raw admission before constructing records; `finalize()` returns the existing `{ evidence, diagnostics }` result. Earlier invocations consume the allowance before deduplication. Exhaustion raises `RESOURCE_LIMIT_EXCEEDED`, and Core still checks the complete raw result independently.
+
+For the reserved `custom` runtime, Core reports `CUSTOM_RUNTIME_RELATIONSHIP_UNVERIFIED` warnings for declared bindings, capabilities, schemas, and variable providers. Core registers no custom adapter and infers no SDK or native handoff graph.
 
 Adapter evidence and diagnostics are validated, normalized, deduplicated, sorted, and limited before exposure. An unexpected adapter failure or invalid output rejects the complete operation with `ADAPTER_EXECUTION_FAILED`.
 

package/dist/adapter/index.d.ts

@@ -1,5 +1,6 @@
 import type { IRepositoryEntry, IRepositoryEntryPage, IRepositoryEntryPageOptions, IRepositoryFilePage, IRepositoryFilePageOptions, IRepositoryOperationOptions, IRepositoryPath, IRepositorySnapshot } from '@moldea.ai/repository';
 import type { IIndexedAgent, IIndexedDescriptionAsset } from '../contracts/index.js';
+import type { IRuntimeAdapterOutputBudget } from '../adapter-result-collection/index.js';
 import type { IAdapterDiagnostic, IDiagnosticDetails } from '../diagnostics/index.js';
 import type { IRepositoryFormatVersion, IRepositoryReference } from '../format/index.js';
 export interface IRuntimeAdapter {
@@ -16,15 +17,19 @@ export interface IRuntimeAdapter {
      * - 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.
+     * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
      * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
      * - 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.
      */
     inspect(context: IRuntimeAdapterContext): Promise<IRuntimeAdapterResult>;
 }
 export interface IRuntimeAdapterContext {
     readonly agent: IIndexedAgent;
+    readonly outputBudget: IRuntimeAdapterOutputBudget;
     readonly repository: IRuntimeAdapterRepository;
     readonly signal?: AbortSignal;
     /**
@@ -61,10 +66,13 @@ export interface IRuntimeAdapterRepository {
      * - INVALID_REPOSITORY_PATH: The repository path 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 inspection.
-     * - INVALID_SOURCE_DATA: The repository reader returned invalid contract data.
-     * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
-     * - ABORTED: Adapter inspection or the repository operation was aborted.
+     * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
+     * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+     * - 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.
      */
     getEntry(path: IRepositoryPath, options?: IRepositoryOperationOptions): Promise<IRepositoryEntry | null>;
     /**
@@ -78,6 +86,7 @@ export interface IRuntimeAdapterRepository {
      * - 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.
+     * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
      * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
      * - INVALID_SOURCE_DATA: The repository source returned invalid data.
      * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
@@ -96,6 +105,7 @@ export interface IRuntimeAdapterRepository {
      * - 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.
+     * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
      * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
      * - INVALID_SOURCE_DATA: The repository source returned invalid data.
      * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
@@ -128,4 +138,6 @@ export interface IRuntimeAdapterResult {
 export type { IAdapterDiagnostic, IAdapterErrorDiagnostic, IAdapterWarningDiagnostic, IUnverifiedRelationship, IUnverifiedRelationshipDetails, } from '../diagnostics/index.js';
 export type { IIndexedAgent, IIndexedContextAsset, IIndexedDecision, IIndexedDescriptionAsset, IIndexedManifest, IIndexedMirror, IIndexedRuntimeGuidance, IIndexedTextAsset, } from '../contracts/index.js';
 export { iterateRuntimeAdapterEntries, readRuntimeAdapterFile, } from '../adapter-repository/index.js';
+export type { IRuntimeAdapterOutputBudget, IRuntimeAdapterRecordCollector, IRuntimeAdapterResultCollector, } from '../adapter-result-collection/index.js';
+export { createRuntimeAdapterResultCollector } from '../adapter-result-collection/index.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/adapter-execution/index.d.ts

@@ -15,17 +15,20 @@ export interface IRuntimeAdapterInspectionResult {
  * @param signal Optional cancellation shared by the complete inspection.
  * @returns A promise resolving to normalized evidence and adapter diagnostics.
  * @throws
- * - INVALID_REPOSITORY_PATH: An adapter repository path is invalid.
- * - ENTRY_NOT_FOUND: A requested repository entry is absent.
- * - ENTRY_NOT_FILE: A requested repository entry is not a regular file.
- * - ENTRY_NOT_DIRECTORY: A requested repository entry is not a directory.
+ * - 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 adapter inspection.
- * - INVALID_SOURCE_DATA: The repository reader returned invalid contract data.
- * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
- * - ABORTED: Adapter inspection or a repository operation was aborted.
- * - ADAPTER_EXECUTION_FAILED: An adapter failed or returned an invalid result.
+ * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
+ * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+ * - 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.
+ * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed during inspection.
  */
 export declare const inspectRuntimeAdapters: (project: IMoldeaProjectIndex, session: IRepositoryInspectionSession, options: ICoreOptionsSnapshot, signal?: AbortSignal) => Promise<IRuntimeAdapterInspectionResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/adapter-execution/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter-execution/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,uBAAuB,EAGxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAOhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,KAAK,EAAE,oBAAoB,EAA2B,MAAM,qBAAqB,CAAC;AAEzF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAG9F,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrD;AA0ID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,mBAAmB,EAC5B,SAAS,4BAA4B,EACrC,SAAS,oBAAoB,EAC7B,SAAS,WAAW,KACnB,OAAO,CAAC,+BAA+B,CAwCzC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter-execution/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,uBAAuB,EAGxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAQhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,OAAO,KAAK,EAAE,oBAAoB,EAA2B,MAAM,qBAAqB,CAAC;AAEzF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAG9F,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrD;AA2ID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,mBAAmB,EAC5B,SAAS,4BAA4B,EACrC,SAAS,oBAAoB,EAC7B,SAAS,WAAW,KACnB,OAAO,CAAC,+BAA+B,CA6CzC,CAAC"}

package/dist/adapter-result-collection/collection.d.ts

@@ -0,0 +1,13 @@
+import type { IRuntimeAdapterContext } from '../adapter/index.js';
+import type { IRuntimeAdapterOutputCounts } from '../adapter-validation/index.js';
+import type { ICoreResourceLimits } from '../contracts/index.js';
+import type { IRuntimeAdapterOutputBudget, IRuntimeAdapterResultCollector } from './types.js';
+/** Creates the immutable admission view from Core's authoritative raw counters. */
+export declare const createRuntimeAdapterOutputBudget: (counts: IRuntimeAdapterOutputCounts, limits: ICoreResourceLimits) => IRuntimeAdapterOutputBudget;
+/**
+ * Collects one adapter result without constructing records beyond its remaining allowance.
+ * @param context The trusted invocation agent, raw output budget, and operation signal.
+ * @returns Independent collectors and one final immutable adapter result.
+ */
+export declare const createRuntimeAdapterResultCollector: (context: Pick<IRuntimeAdapterContext, "agent" | "outputBudget" | "signal">) => IRuntimeAdapterResultCollector;
+//# sourceMappingURL=collection.d.ts.map

package/dist/adapter-result-collection/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/adapter-result-collection/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIjE,OAAO,KAAK,EACV,2BAA2B,EAE3B,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAEpB,mFAAmF;AACnF,eAAO,MAAM,gCAAgC,GAC3C,QAAQ,2BAA2B,EACnC,QAAQ,mBAAmB,KAC1B,2BAUC,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAC9C,SAAS,IAAI,CAAC,sBAAsB,EAAE,OAAO,GAAG,cAAc,GAAG,QAAQ,CAAC,KACzE,8BAkDF,CAAC"}

package/dist/adapter-result-collection/index.d.ts

@@ -0,0 +1,3 @@
+export type { IRuntimeAdapterOutputBudget, IRuntimeAdapterRecordCollector, IRuntimeAdapterResultCollector, } from './types.js';
+export { createRuntimeAdapterOutputBudget, createRuntimeAdapterResultCollector, } from './collection.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapter-result-collection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter-result-collection/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gCAAgC,EAChC,mCAAmC,GACpC,MAAM,iBAAiB,CAAC"}

package/dist/adapter-result-collection/types.d.ts

@@ -0,0 +1,31 @@
+import type { IAdapterDiagnostic } from '../diagnostics/index.js';
+import type { IRuntimeAdapterEvidence, IRuntimeAdapterResult } from '../adapter/index.js';
+export interface IRuntimeAdapterOutputBudget {
+    readonly diagnostics: {
+        readonly maximum: number;
+        readonly remaining: number;
+    };
+    readonly evidence: {
+        readonly maximum: number;
+        readonly remaining: number;
+    };
+}
+export interface IRuntimeAdapterRecordCollector<TRecord> {
+    /**
+     * Admits one record before executing its factory.
+     * @param factory Constructs the record only after admission succeeds.
+     * @throws
+     * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+     * - ABORTED: The Core operation was aborted.
+     */
+    add(factory: () => TRecord): void;
+    /** Checks admitted records without exposing or copying the result collection. */
+    some(predicate: (record: TRecord) => boolean): boolean;
+}
+export interface IRuntimeAdapterResultCollector {
+    readonly diagnostics: IRuntimeAdapterRecordCollector<IAdapterDiagnostic>;
+    readonly evidence: IRuntimeAdapterRecordCollector<IRuntimeAdapterEvidence>;
+    /** Returns the complete immutable result for Core's authoritative validation. */
+    finalize(): IRuntimeAdapterResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapter-result-collection/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapter-result-collection/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG1F,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAGD,MAAM,WAAW,8BAA8B,CAAC,OAAO;IACrD;;;;;;OAMG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IAClC,iFAAiF;IACjF,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC;CACxD;AAGD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,8BAA8B,CAAC,kBAAkB,CAAC,CAAC;IACzE,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC,uBAAuB,CAAC,CAAC;IAE3E,iFAAiF;IACjF,QAAQ,IAAI,qBAAqB,CAAC;CACnC"}

package/dist/adapter.js

@@ -1,4 +1,5 @@
-import { i as reserveRuntimeAdapterRetainedBytesIfTracked, n as CoreOperationException } from "./chunks/exceptions-HS9ofVy2.js";
+import { i as reserveRuntimeAdapterRetainedBytesIfTracked, n as createRuntimeAdapterResultCollector } from "./chunks/collection-CvbjjLf2.js";
+import { n as CoreOperationException } from "./chunks/exceptions-lzD3buFw.js";
 import { REPOSITORY_ROOT, RepositorySourceException, compareRepositoryPaths, parseRepositoryPath } from "@moldea.ai/repository";
 //#region src/adapter-repository/index.ts
 var invalidSourceData = (operation, path) => {
@@ -110,6 +111,6 @@ var iterateRuntimeAdapterEntries = (repository, options) => {
 	} };
 };
 //#endregion
-export { iterateRuntimeAdapterEntries, readRuntimeAdapterFile };
+export { createRuntimeAdapterResultCollector, iterateRuntimeAdapterEntries, readRuntimeAdapterFile };
 
 //# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","names":[],"sources":["../src/adapter-repository/index.ts"],"sourcesContent":["import {\n  REPOSITORY_ROOT,\n  RepositorySourceException,\n  compareRepositoryPaths,\n  parseRepositoryPath,\n  type IRepositoryEntry,\n  type IRepositoryOperationOptions,\n  type IRepositoryPath,\n} from '@moldea.ai/repository';\n\nimport type { IRuntimeAdapterRepository } from '../adapter/index.js';\nimport { reserveRuntimeAdapterRetainedBytesIfTracked } from '../adapter-retained-memory/index.js';\nimport { CoreOperationException } from '../exceptions/index.js';\n\nconst invalidSourceData = (\n  operation: 'list-entries-page' | 'read-file-page',\n  path: IRepositoryPath,\n): never => {\n  throw new RepositorySourceException({\n    code: 'INVALID_SOURCE_DATA',\n    operation,\n    path,\n    retryable: false,\n  });\n};\n\nconst throwResourceLimitExceeded = (\n  limit: 'maxEntries' | 'maxFileBytes' | 'maxTotalBytesRead',\n  limitMaximum: number,\n  observedUsage: number,\n): never => {\n  throw new CoreOperationException({\n    code: 'RESOURCE_LIMIT_EXCEEDED',\n    limit,\n    limitMaximum,\n    nextAction: 'reduce-input-or-increase-limit',\n    observedUsage,\n    operation: 'validate-project',\n  });\n};\n\n/**\n * Reads one complete adapter source file through bounded repository pages.\n * @param repository The Core-created repository for the current adapter invocation.\n * @param path The exact source file path.\n * @param options Optional cancellation controls.\n * @returns A promise resolving to one detached complete source buffer.\n * @throws\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 * - 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 * - 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 * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.\n */\nexport const readRuntimeAdapterFile = async (\n  repository: IRuntimeAdapterRepository,\n  path: IRepositoryPath,\n  options?: IRepositoryOperationOptions,\n): Promise<Uint8Array> => {\n  const parsedPath = parseRepositoryPath(path);\n  const entry = await repository.getEntry(parsedPath, options);\n\n  if (entry === null) {\n    throw new RepositorySourceException({\n      code: 'ENTRY_NOT_FOUND',\n      operation: 'read-file-page',\n      path: parsedPath,\n      retryable: false,\n    });\n  }\n\n  if (entry.type !== 'file' || entry.byteLength === null) {\n    throw new RepositorySourceException({\n      code: 'ENTRY_NOT_FILE',\n      operation: 'read-file-page',\n      path: parsedPath,\n      retryable: false,\n    });\n  }\n\n  if (entry.byteLength > repository.limits.maxFileBytes) {\n    return throwResourceLimitExceeded(\n      'maxFileBytes',\n      repository.limits.maxFileBytes,\n      entry.byteLength,\n    );\n  }\n\n  reserveRuntimeAdapterRetainedBytesIfTracked(repository, entry.byteLength);\n  const content = new Uint8Array(entry.byteLength);\n  let offset = 0;\n  let isFirstPage = true;\n\n  while (isFirstPage || offset < entry.byteLength) {\n    isFirstPage = false;\n    options?.signal?.throwIfAborted();\n    const page = await repository.readFilePage(parsedPath, {\n      maxBytes: Math.min(repository.limits.maxPageBytes, Math.max(1, entry.byteLength - offset)),\n      offset,\n      ...(options?.signal === undefined ? {} : { signal: options.signal }),\n    });\n\n    if (\n      page.snapshot.id !== repository.snapshot.id ||\n      page.offset !== offset ||\n      page.totalBytes !== entry.byteLength ||\n      !(page.bytes instanceof Uint8Array) ||\n      page.bytes.byteLength > repository.limits.maxPageBytes ||\n      page.bytes.byteLength > content.byteLength - offset ||\n      (page.bytes.byteLength === 0 && !page.isComplete)\n    ) {\n      return invalidSourceData('read-file-page', parsedPath);\n    }\n\n    content.set(page.bytes, offset);\n    offset += page.bytes.byteLength;\n\n    if (page.isComplete) {\n      if (page.nextOffset !== null || offset !== content.byteLength) {\n        return invalidSourceData('read-file-page', parsedPath);\n      }\n\n      return content;\n    }\n\n    if (page.nextOffset !== offset) {\n      return invalidSourceData('read-file-page', parsedPath);\n    }\n  }\n\n  return invalidSourceData('read-file-page', parsedPath);\n};\n\n/** Iterates one adapter-scoped descendant listing through bounded pages. */\nexport const iterateRuntimeAdapterEntries = (\n  repository: IRuntimeAdapterRepository,\n  options?: IRepositoryOperationOptions & { readonly prefix?: IRepositoryPath },\n): AsyncIterable<IRepositoryEntry> => {\n  const prefix =\n    options?.prefix === undefined ? REPOSITORY_ROOT : parseRepositoryPath(options.prefix);\n\n  return {\n    async *[Symbol.asyncIterator](): AsyncIterator<IRepositoryEntry> {\n      let cursor: string | undefined;\n      let entryCount = 0;\n      let previousPath: IRepositoryPath | null = null;\n\n      do {\n        options?.signal?.throwIfAborted();\n        const page = await repository.listEntriesPage({\n          ...(cursor === undefined ? {} : { cursor }),\n          maxEntries: repository.limits.maxPageEntries,\n          prefix,\n          ...(options?.signal === undefined ? {} : { signal: options.signal }),\n        });\n\n        if (\n          page.snapshot.id !== repository.snapshot.id ||\n          page.entries.length > repository.limits.maxPageEntries ||\n          (page.entries.length === 0 && !page.isComplete)\n        ) {\n          return invalidSourceData('list-entries-page', prefix);\n        }\n\n        for (const entry of page.entries) {\n          if (previousPath !== null && compareRepositoryPaths(previousPath, entry.path) >= 0) {\n            return invalidSourceData('list-entries-page', entry.path);\n          }\n\n          entryCount += 1;\n          if (entryCount > repository.limits.maxEntries) {\n            return throwResourceLimitExceeded(\n              'maxEntries',\n              repository.limits.maxEntries,\n              entryCount,\n            );\n          }\n\n          previousPath = entry.path;\n          yield entry;\n        }\n\n        if (page.isComplete) {\n          if (page.nextCursor !== null) {\n            return invalidSourceData('list-entries-page', prefix);\n          }\n\n          return;\n        }\n\n        if (page.nextCursor === null || page.nextCursor === cursor) {\n          return invalidSourceData('list-entries-page', prefix);\n        }\n\n        cursor = page.nextCursor;\n      } while (true);\n    },\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"adapter.js","names":[],"sources":["../src/adapter-repository/index.ts"],"sourcesContent":["import {\n  REPOSITORY_ROOT,\n  RepositorySourceException,\n  compareRepositoryPaths,\n  parseRepositoryPath,\n  type IRepositoryEntry,\n  type IRepositoryOperationOptions,\n  type IRepositoryPath,\n} from '@moldea.ai/repository';\n\nimport type { IRuntimeAdapterRepository } from '../adapter/index.js';\nimport { reserveRuntimeAdapterRetainedBytesIfTracked } from '../adapter-retained-memory/index.js';\nimport { CoreOperationException } from '../exceptions/index.js';\n\nconst invalidSourceData = (\n  operation: 'list-entries-page' | 'read-file-page',\n  path: IRepositoryPath,\n): never => {\n  throw new RepositorySourceException({\n    code: 'INVALID_SOURCE_DATA',\n    operation,\n    path,\n    retryable: false,\n  });\n};\n\nconst throwResourceLimitExceeded = (\n  limit: 'maxEntries' | 'maxFileBytes' | 'maxTotalBytesRead',\n  limitMaximum: number,\n  observedUsage: number,\n): never => {\n  throw new CoreOperationException({\n    code: 'RESOURCE_LIMIT_EXCEEDED',\n    limit,\n    limitMaximum,\n    nextAction: 'reduce-input-or-increase-limit',\n    observedUsage,\n    operation: 'validate-project',\n  });\n};\n\n/**\n * Reads one complete adapter source file through bounded repository pages.\n * @param repository The Core-created repository for the current adapter invocation.\n * @param path The exact source file path.\n * @param options Optional cancellation controls.\n * @returns A promise resolving to one detached complete source buffer.\n * @throws\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 * - 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 * - 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 * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.\n */\nexport const readRuntimeAdapterFile = async (\n  repository: IRuntimeAdapterRepository,\n  path: IRepositoryPath,\n  options?: IRepositoryOperationOptions,\n): Promise<Uint8Array> => {\n  const parsedPath = parseRepositoryPath(path);\n  const entry = await repository.getEntry(parsedPath, options);\n\n  if (entry === null) {\n    throw new RepositorySourceException({\n      code: 'ENTRY_NOT_FOUND',\n      operation: 'read-file-page',\n      path: parsedPath,\n      retryable: false,\n    });\n  }\n\n  if (entry.type !== 'file' || entry.byteLength === null) {\n    throw new RepositorySourceException({\n      code: 'ENTRY_NOT_FILE',\n      operation: 'read-file-page',\n      path: parsedPath,\n      retryable: false,\n    });\n  }\n\n  if (entry.byteLength > repository.limits.maxFileBytes) {\n    return throwResourceLimitExceeded(\n      'maxFileBytes',\n      repository.limits.maxFileBytes,\n      entry.byteLength,\n    );\n  }\n\n  reserveRuntimeAdapterRetainedBytesIfTracked(repository, entry.byteLength);\n  const content = new Uint8Array(entry.byteLength);\n  let offset = 0;\n  let isFirstPage = true;\n\n  while (isFirstPage || offset < entry.byteLength) {\n    isFirstPage = false;\n    options?.signal?.throwIfAborted();\n    const page = await repository.readFilePage(parsedPath, {\n      maxBytes: Math.min(repository.limits.maxPageBytes, Math.max(1, entry.byteLength - offset)),\n      offset,\n      ...(options?.signal === undefined ? {} : { signal: options.signal }),\n    });\n\n    if (\n      page.snapshot.id !== repository.snapshot.id ||\n      page.offset !== offset ||\n      page.totalBytes !== entry.byteLength ||\n      !(page.bytes instanceof Uint8Array) ||\n      page.bytes.byteLength > repository.limits.maxPageBytes ||\n      page.bytes.byteLength > content.byteLength - offset ||\n      (page.bytes.byteLength === 0 && !page.isComplete)\n    ) {\n      return invalidSourceData('read-file-page', parsedPath);\n    }\n\n    content.set(page.bytes, offset);\n    offset += page.bytes.byteLength;\n\n    if (page.isComplete) {\n      if (page.nextOffset !== null || offset !== content.byteLength) {\n        return invalidSourceData('read-file-page', parsedPath);\n      }\n\n      return content;\n    }\n\n    if (page.nextOffset !== offset) {\n      return invalidSourceData('read-file-page', parsedPath);\n    }\n  }\n\n  return invalidSourceData('read-file-page', parsedPath);\n};\n\n/** Iterates one adapter-scoped descendant listing through bounded pages. */\nexport const iterateRuntimeAdapterEntries = (\n  repository: IRuntimeAdapterRepository,\n  options?: IRepositoryOperationOptions & { readonly prefix?: IRepositoryPath },\n): AsyncIterable<IRepositoryEntry> => {\n  const prefix =\n    options?.prefix === undefined ? REPOSITORY_ROOT : parseRepositoryPath(options.prefix);\n\n  return {\n    async *[Symbol.asyncIterator](): AsyncIterator<IRepositoryEntry> {\n      let cursor: string | undefined;\n      let entryCount = 0;\n      let previousPath: IRepositoryPath | null = null;\n\n      do {\n        options?.signal?.throwIfAborted();\n        const page = await repository.listEntriesPage({\n          ...(cursor === undefined ? {} : { cursor }),\n          maxEntries: repository.limits.maxPageEntries,\n          prefix,\n          ...(options?.signal === undefined ? {} : { signal: options.signal }),\n        });\n\n        if (\n          page.snapshot.id !== repository.snapshot.id ||\n          page.entries.length > repository.limits.maxPageEntries ||\n          (page.entries.length === 0 && !page.isComplete)\n        ) {\n          return invalidSourceData('list-entries-page', prefix);\n        }\n\n        for (const entry of page.entries) {\n          if (previousPath !== null && compareRepositoryPaths(previousPath, entry.path) >= 0) {\n            return invalidSourceData('list-entries-page', entry.path);\n          }\n\n          entryCount += 1;\n          if (entryCount > repository.limits.maxEntries) {\n            return throwResourceLimitExceeded(\n              'maxEntries',\n              repository.limits.maxEntries,\n              entryCount,\n            );\n          }\n\n          previousPath = entry.path;\n          yield entry;\n        }\n\n        if (page.isComplete) {\n          if (page.nextCursor !== null) {\n            return invalidSourceData('list-entries-page', prefix);\n          }\n\n          return;\n        }\n\n        if (page.nextCursor === null || page.nextCursor === cursor) {\n          return invalidSourceData('list-entries-page', prefix);\n        }\n\n        cursor = page.nextCursor;\n      } while (true);\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/analysis-worker.js

@@ -0,0 +1,190 @@
+import { n as CoreOperationException } from "./chunks/exceptions-lzD3buFw.js";
+import { n as normalizeCoreOptions } from "./chunks/options-CxCT3dZU.js";
+import { a as encodeInspectionMessage, d as NODE_INSPECTION_TRANSPORT_BYTES, i as decodeInspectionMessage, n as serializeInspectionFailure, o as NODE_INSPECTION_FILE_PAGE_BYTES, r as createInspectionProcessFailure } from "./chunks/errors-BQI1DEqf.js";
+import { i as parseRpcFilePage, n as parseRpcEntry, r as parseRpcEntryPage } from "./chunks/repository-rpc-BWi6X1la.js";
+import { RepositorySourceException } from "@moldea.ai/repository";
+import { parentPort, workerData } from "node:worker_threads";
+import { getHeapStatistics } from "node:v8";
+//#region src/node-inspection/analysis-worker.ts
+var port = parentPort;
+if (port === null) throw createInspectionProcessFailure();
+var start = decodeInspectionMessage(workerData);
+if (start.kind !== "start") throw createInspectionProcessFailure();
+var attemptId = start.attemptId;
+var maxAnalysisHeapBytes = getHeapStatistics().heap_size_limit;
+var inspection;
+var hasRun = false;
+var isReadingPage = false;
+var nextRequestId = 0;
+var pending = /* @__PURE__ */ new Map();
+var send = (message) => {
+	port.postMessage(encodeInspectionMessage(message));
+};
+/** Admits at most four requests across both bridges; no unbounded transport wait queue exists. */
+var requestReader = (request) => {
+	if (pending.size >= 4) return Promise.reject(new CoreOperationException({
+		code: "RESOURCE_LIMIT_EXCEEDED",
+		operation: "create-project-inspection",
+		limit: "maxReaderRequests",
+		limitMaximum: 4,
+		observedUsage: pending.size + 1,
+		nextAction: null
+	}));
+	const requestId = nextRequestId++;
+	return new Promise((resolve, reject) => {
+		pending.set(requestId, {
+			resolve,
+			reject
+		});
+		try {
+			send({
+				attemptId,
+				kind: "reader-request",
+				requestId,
+				request
+			});
+		} catch (cause) {
+			pending.delete(requestId);
+			reject(cause instanceof Error ? cause : createInspectionProcessFailure(cause));
+		}
+	});
+};
+var repository = {
+	snapshot: start.snapshot,
+	getEntry: async (path) => parseRpcEntry(await requestReader({
+		method: "getEntry",
+		path
+	})),
+	listEntriesPage: async (options) => parseRpcEntryPage(await requestReader({
+		method: "listEntriesPage",
+		maxEntries: Math.min(128, options.maxEntries),
+		...options.cursor === void 0 ? {} : { cursor: options.cursor },
+		...options.prefix === void 0 ? {} : { prefix: options.prefix }
+	})),
+	readFilePage: async (path, options) => parseRpcFilePage(await requestReader({
+		method: "readFilePage",
+		path,
+		offset: options.offset,
+		maxBytes: Math.min(NODE_INSPECTION_FILE_PAGE_BYTES, options.maxBytes)
+	})),
+	compare: () => Promise.reject(new RepositorySourceException({
+		code: "SOURCE_UNAVAILABLE",
+		operation: "create-comparison",
+		path: null,
+		retryable: false
+	}))
+};
+/** Imports only the caller-selected installed registry, after the parent acknowledges the heap. */
+var prepare = async () => {
+	const registry = await import(start.registryUrl);
+	if (registry === null || typeof registry !== "object" || !("adapters" in registry) || !Array.isArray(registry.adapters)) throw createInspectionProcessFailure();
+	const adapters = registry.adapters;
+	const { createCore } = await import("./chunks/core-DchheNDz.js").then((n) => n.t);
+	const options = normalizeCoreOptions({
+		adapters,
+		limits: {
+			...start.limits,
+			maxRetainedBytes: start.limits.maxRetainedBytes - NODE_INSPECTION_TRANSPORT_BYTES
+		}
+	});
+	inspection = await createCore(options).createProjectInspection({ repository });
+	const metadata = {
+		source: inspection.source,
+		formatVersion: inspection.formatVersion,
+		valid: inspection.valid,
+		runtimeInspection: inspection.runtimeInspection,
+		counts: inspection.counts,
+		summary: inspection.summary,
+		resourceUsage: inspection.resourceUsage,
+		inspectionDigest: inspection.inspectionDigest
+	};
+	send({
+		attemptId,
+		kind: "prepared",
+		inspection: {
+			...metadata,
+			maxAnalysisHeapBytes,
+			adapters: options.adapters.map((adapter) => ({
+				id: adapter.id,
+				supportedRepositoryFormatVersions: [...adapter.supportedRepositoryFormatVersions]
+			})),
+			resourceUsage: {
+				...metadata.resourceUsage,
+				retainedBytes: metadata.resourceUsage.retainedBytes + NODE_INSPECTION_TRANSPORT_BYTES,
+				peakRetainedBytes: metadata.resourceUsage.peakRetainedBytes + NODE_INSPECTION_TRANSPORT_BYTES
+			}
+		}
+	});
+};
+/** Translates worker failures to safe package contracts while the supervisor stays responsive. */
+var fail = (cause) => {
+	try {
+		const failure = serializeInspectionFailure(cause);
+		if (cause instanceof CoreOperationException && cause.code === "RESOURCE_LIMIT_EXCEEDED" && cause.limit === "maxRetainedBytes" && cause.observedUsage !== null) {
+			failure.options["limitMaximum"] = start.limits.maxRetainedBytes;
+			failure.options["observedUsage"] = cause.observedUsage + NODE_INSPECTION_TRANSPORT_BYTES;
+		}
+		send({
+			attemptId,
+			kind: "failure",
+			failure
+		});
+	} catch {
+		port.close();
+	}
+};
+port.on("message", (frame) => {
+	try {
+		const message = decodeInspectionMessage(frame);
+		if (message.attemptId !== attemptId) throw createInspectionProcessFailure();
+		if (message.kind === "run") {
+			if (hasRun) throw createInspectionProcessFailure();
+			hasRun = true;
+			prepare().catch(fail);
+		} else if (message.kind === "reader-response") {
+			const request = pending.get(message.requestId);
+			if (request === void 0) throw createInspectionProcessFailure();
+			pending.delete(message.requestId);
+			request.resolve(message.result);
+		} else if (message.kind === "read-page") {
+			if (inspection === void 0 || isReadingPage) throw createInspectionProcessFailure();
+			isReadingPage = true;
+			try {
+				if (message.input.maxItems > start.limits.maxEntries) throw new CoreOperationException({
+					code: "INVALID_ARGUMENT",
+					operation: "create-project-inspection"
+				});
+				let maxItems = Math.min(256, message.input.maxItems);
+				while (true) try {
+					const frame = encodeInspectionMessage({
+						attemptId,
+						kind: "page",
+						requestId: message.requestId,
+						result: inspection.readPage({
+							...message.input,
+							maxItems
+						})
+					});
+					port.postMessage(frame);
+					break;
+				} catch (cause) {
+					if (!(cause instanceof CoreOperationException) || cause.code !== "RESOURCE_LIMIT_EXCEEDED" || cause.limit !== "maxInspectionMessageBytes" || maxItems === 1) throw cause;
+					maxItems = Math.max(1, Math.floor(maxItems / 2));
+				}
+			} finally {
+				isReadingPage = false;
+			}
+		} else throw createInspectionProcessFailure();
+	} catch (cause) {
+		fail(cause);
+	}
+});
+port.on("messageerror", fail);
+send({
+	attemptId,
+	kind: "ready",
+	maxAnalysisHeapBytes
+});
+//#endregion
+
+//# sourceMappingURL=analysis-worker.js.map

package/dist/analysis-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-worker.js","names":[],"sources":["../src/node-inspection/analysis-worker.ts"],"sourcesContent":["import { getHeapStatistics } from 'node:v8';\nimport { parentPort, workerData } from 'node:worker_threads';\n\nimport { RepositorySourceException, type IRepositoryReader } from '@moldea.ai/repository';\n\nimport type { IRuntimeAdapter } from '../adapter/index.js';\nimport type { IProjectInspection } from '../contracts/index.js';\nimport { CoreOperationException } from '../exceptions/index.js';\nimport { normalizeCoreOptions } from '../options/index.js';\n\nimport {\n  NODE_INSPECTION_FILE_PAGE_BYTES,\n  NODE_INSPECTION_MAX_REQUESTS,\n  NODE_INSPECTION_TRANSPORT_BYTES,\n} from './constants.js';\nimport { serializeInspectionFailure } from './errors.js';\nimport {\n  createInspectionProcessFailure,\n  decodeInspectionMessage,\n  encodeInspectionMessage,\n} from './protocol.js';\nimport { parseRpcEntry, parseRpcEntryPage, parseRpcFilePage } from './repository-rpc.js';\nimport type { INodeInspectionMessage, INodeReaderRequest } from './types.js';\n\nconst port = parentPort;\nif (port === null) throw createInspectionProcessFailure();\nconst start = decodeInspectionMessage(workerData);\nif (start.kind !== 'start') throw createInspectionProcessFailure();\nconst attemptId = start.attemptId;\nconst maxAnalysisHeapBytes = getHeapStatistics().heap_size_limit;\nlet inspection: IProjectInspection | undefined;\nlet hasRun = false;\nlet isReadingPage = false;\nlet nextRequestId = 0;\nconst pending = new Map<\n  number,\n  { resolve: (result: unknown) => void; reject: (cause: unknown) => void }\n>();\nconst send = (message: INodeInspectionMessage): void => {\n  port.postMessage(encodeInspectionMessage(message));\n};\n\n/** Admits at most four requests across both bridges; no unbounded transport wait queue exists. */\nconst requestReader = (request: INodeReaderRequest): Promise<unknown> => {\n  if (pending.size >= NODE_INSPECTION_MAX_REQUESTS)\n    return Promise.reject(\n      new CoreOperationException({\n        code: 'RESOURCE_LIMIT_EXCEEDED',\n        operation: 'create-project-inspection',\n        limit: 'maxReaderRequests',\n        limitMaximum: NODE_INSPECTION_MAX_REQUESTS,\n        observedUsage: pending.size + 1,\n        nextAction: null,\n      }),\n    );\n  const requestId = nextRequestId++;\n  return new Promise<unknown>((resolve, reject) => {\n    pending.set(requestId, { resolve, reject });\n    try {\n      send({ attemptId, kind: 'reader-request', requestId, request });\n    } catch (cause) {\n      pending.delete(requestId);\n      reject(cause instanceof Error ? cause : createInspectionProcessFailure(cause));\n    }\n  });\n};\n\nconst repository: IRepositoryReader = {\n  snapshot: start.snapshot,\n  getEntry: async (path) => parseRpcEntry(await requestReader({ method: 'getEntry', path })),\n  listEntriesPage: async (options) =>\n    parseRpcEntryPage(\n      await requestReader({\n        method: 'listEntriesPage',\n        maxEntries: Math.min(128, options.maxEntries),\n        ...(options.cursor === undefined ? {} : { cursor: options.cursor }),\n        ...(options.prefix === undefined ? {} : { prefix: options.prefix }),\n      }),\n    ),\n  readFilePage: async (path, options) =>\n    parseRpcFilePage(\n      await requestReader({\n        method: 'readFilePage',\n        path,\n        offset: options.offset,\n        maxBytes: Math.min(NODE_INSPECTION_FILE_PAGE_BYTES, options.maxBytes),\n      }),\n    ),\n  compare: () =>\n    Promise.reject(\n      new RepositorySourceException({\n        code: 'SOURCE_UNAVAILABLE',\n        operation: 'create-comparison',\n        path: null,\n        retryable: false,\n      }),\n    ),\n};\n\n/** Imports only the caller-selected installed registry, after the parent acknowledges the heap. */\nconst prepare = async (): Promise<void> => {\n  const registry: unknown = await import(start.registryUrl);\n  if (\n    registry === null ||\n    typeof registry !== 'object' ||\n    !('adapters' in registry) ||\n    !Array.isArray(registry.adapters)\n  )\n    throw createInspectionProcessFailure();\n  // Core remains the authoritative validator for every executable adapter definition.\n  const adapters = registry.adapters as IRuntimeAdapter[];\n  const { createCore } = await import('../core/index.js');\n  const options = normalizeCoreOptions({\n    adapters,\n    limits: {\n      ...start.limits,\n      maxRetainedBytes: start.limits.maxRetainedBytes - NODE_INSPECTION_TRANSPORT_BYTES,\n    },\n  });\n  const core = createCore(options);\n  inspection = await core.createProjectInspection({ repository });\n  const metadata = {\n    source: inspection.source,\n    formatVersion: inspection.formatVersion,\n    valid: inspection.valid,\n    runtimeInspection: inspection.runtimeInspection,\n    counts: inspection.counts,\n    summary: inspection.summary,\n    resourceUsage: inspection.resourceUsage,\n    inspectionDigest: inspection.inspectionDigest,\n  };\n  send({\n    attemptId,\n    kind: 'prepared',\n    inspection: {\n      ...metadata,\n      maxAnalysisHeapBytes,\n      adapters: options.adapters.map((adapter) => ({\n        id: adapter.id,\n        supportedRepositoryFormatVersions: [...adapter.supportedRepositoryFormatVersions],\n      })),\n      resourceUsage: {\n        ...metadata.resourceUsage,\n        retainedBytes: metadata.resourceUsage.retainedBytes + NODE_INSPECTION_TRANSPORT_BYTES,\n        peakRetainedBytes:\n          metadata.resourceUsage.peakRetainedBytes + NODE_INSPECTION_TRANSPORT_BYTES,\n      },\n    },\n  });\n};\n\n/** Translates worker failures to safe package contracts while the supervisor stays responsive. */\nconst fail = (cause: unknown): void => {\n  try {\n    const failure = serializeInspectionFailure(cause);\n    if (\n      cause instanceof CoreOperationException &&\n      cause.code === 'RESOURCE_LIMIT_EXCEEDED' &&\n      cause.limit === 'maxRetainedBytes' &&\n      cause.observedUsage !== null\n    ) {\n      failure.options['limitMaximum'] = start.limits.maxRetainedBytes;\n      failure.options['observedUsage'] = cause.observedUsage + NODE_INSPECTION_TRANSPORT_BYTES;\n    }\n    send({ attemptId, kind: 'failure', failure });\n  } catch {\n    port.close();\n  }\n};\n\nport.on('message', (frame: unknown) => {\n  try {\n    const message = decodeInspectionMessage(frame);\n    if (message.attemptId !== attemptId) throw createInspectionProcessFailure();\n    if (message.kind === 'run') {\n      if (hasRun) throw createInspectionProcessFailure();\n      hasRun = true;\n      void prepare().catch(fail);\n    } else if (message.kind === 'reader-response') {\n      const request = pending.get(message.requestId);\n      if (request === undefined) throw createInspectionProcessFailure();\n      pending.delete(message.requestId);\n      request.resolve(message.result);\n    } else if (message.kind === 'read-page') {\n      if (inspection === undefined || isReadingPage) throw createInspectionProcessFailure();\n      isReadingPage = true;\n      try {\n        if (message.input.maxItems > start.limits.maxEntries)\n          throw new CoreOperationException({\n            code: 'INVALID_ARGUMENT',\n            operation: 'create-project-inspection',\n          });\n        let maxItems = Math.min(256, message.input.maxItems);\n        while (true) {\n          try {\n            const frame = encodeInspectionMessage({\n              attemptId,\n              kind: 'page',\n              requestId: message.requestId,\n              result: inspection.readPage({ ...message.input, maxItems }),\n            });\n            port.postMessage(frame);\n            break;\n          } catch (cause) {\n            if (\n              !(cause instanceof CoreOperationException) ||\n              cause.code !== 'RESOURCE_LIMIT_EXCEEDED' ||\n              cause.limit !== 'maxInspectionMessageBytes' ||\n              maxItems === 1\n            )\n              throw cause;\n            maxItems = Math.max(1, Math.floor(maxItems / 2));\n          }\n        }\n      } finally {\n        isReadingPage = false;\n      }\n    } else throw createInspectionProcessFailure();\n  } catch (cause) {\n    fail(cause);\n  }\n});\nport.on('messageerror', fail);\nsend({ attemptId, kind: 'ready', maxAnalysisHeapBytes });\n"],"mappings":"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"}

package/dist/chunks/collection-CvbjjLf2.js

@@ -0,0 +1,73 @@
+import { n as CoreOperationException } from "./exceptions-lzD3buFw.js";
+//#region src/adapter-retained-memory/index.ts
+var retainedByteReservations = /* @__PURE__ */ new WeakMap();
+/** Registers the retained-memory reservation owned by one inspection session. */
+var registerRuntimeAdapterRetainedByteReservation = (repository, reserve) => {
+	if (retainedByteReservations.has(repository)) throw new TypeError("The runtime adapter repository is already registered.");
+	retainedByteReservations.set(repository, reserve);
+};
+/** Reserves a complete adapter-owned buffer when Core owns the repository session. */
+var reserveRuntimeAdapterRetainedBytesIfTracked = (repository, byteLength) => {
+	const reserve = retainedByteReservations.get(repository);
+	if (reserve !== void 0) reserve(byteLength);
+};
+//#endregion
+//#region src/adapter-result-collection/collection.ts
+/** Creates the immutable admission view from Core's authoritative raw counters. */
+var createRuntimeAdapterOutputBudget = (counts, limits) => Object.freeze({
+	diagnostics: Object.freeze({
+		maximum: limits.maxDiagnostics,
+		remaining: limits.maxDiagnostics - counts.diagnostics
+	}),
+	evidence: Object.freeze({
+		maximum: limits.maxEvidence,
+		remaining: limits.maxEvidence - counts.evidence
+	})
+});
+/**
+* Collects one adapter result without constructing records beyond its remaining allowance.
+* @param context The trusted invocation agent, raw output budget, and operation signal.
+* @returns Independent collectors and one final immutable adapter result.
+*/
+var createRuntimeAdapterResultCollector = (context) => {
+	const diagnostics = [];
+	const evidence = [];
+	const createCollector = (kind, records) => {
+		const { maximum, remaining } = context.outputBudget[kind];
+		let admitted = 0;
+		return Object.freeze({
+			some: (predicate) => records.some(predicate),
+			add: (factory) => {
+				if (context.signal?.aborted) throw new CoreOperationException({
+					adapterId: context.agent.declaration.runtime.id,
+					cause: context.signal.reason,
+					code: "ABORTED",
+					operation: "validate-adapter"
+				});
+				if (admitted >= remaining) throw new CoreOperationException({
+					adapterId: context.agent.declaration.runtime.id,
+					code: "RESOURCE_LIMIT_EXCEEDED",
+					limit: kind === "diagnostics" ? "maxDiagnostics" : "maxEvidence",
+					limitMaximum: maximum,
+					nextAction: "reduce-input-or-increase-limit",
+					observedUsage: maximum - remaining + admitted + 1,
+					operation: "validate-adapter"
+				});
+				admitted += 1;
+				records.push(factory());
+			}
+		});
+	};
+	return Object.freeze({
+		diagnostics: createCollector("diagnostics", diagnostics),
+		evidence: createCollector("evidence", evidence),
+		finalize: () => Object.freeze({
+			diagnostics: Object.freeze(diagnostics),
+			evidence: Object.freeze(evidence)
+		})
+	});
+};
+//#endregion
+export { reserveRuntimeAdapterRetainedBytesIfTracked as i, createRuntimeAdapterResultCollector as n, registerRuntimeAdapterRetainedByteReservation as r, createRuntimeAdapterOutputBudget as t };
+
+//# sourceMappingURL=collection-CvbjjLf2.js.map

package/dist/chunks/collection-CvbjjLf2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-CvbjjLf2.js","names":[],"sources":["../../src/adapter-retained-memory/index.ts","../../src/adapter-result-collection/collection.ts"],"sourcesContent":["import type { IRuntimeAdapterRepository } from '../adapter/index.js';\ntype IRetainedByteReservation = (byteLength: number) => void;\n\n// reservations belong to Core-created adapter repositories and remain private to the session\nconst retainedByteReservations = new WeakMap<IRuntimeAdapterRepository, IRetainedByteReservation>();\n\n/** Registers the retained-memory reservation owned by one inspection session. */\nexport const registerRuntimeAdapterRetainedByteReservation = (\n  repository: IRuntimeAdapterRepository,\n  reserve: IRetainedByteReservation,\n): void => {\n  if (retainedByteReservations.has(repository)) {\n    throw new TypeError('The runtime adapter repository is already registered.');\n  }\n\n  retainedByteReservations.set(repository, reserve);\n};\n\n/** Reserves a complete adapter-owned buffer when Core owns the repository session. */\nexport const reserveRuntimeAdapterRetainedBytesIfTracked = (\n  repository: IRuntimeAdapterRepository,\n  byteLength: number,\n): void => {\n  const reserve = retainedByteReservations.get(repository);\n\n  if (reserve !== undefined) {\n    reserve(byteLength);\n  }\n};\n","import type {\n  IRuntimeAdapterContext,\n  IRuntimeAdapterEvidence,\n  IRuntimeAdapterResult,\n} from '../adapter/index.js';\nimport type { IRuntimeAdapterOutputCounts } from '../adapter-validation/index.js';\nimport type { ICoreResourceLimits } from '../contracts/index.js';\nimport type { IAdapterDiagnostic } from '../diagnostics/index.js';\nimport { CoreOperationException } from '../exceptions/index.js';\n\nimport type {\n  IRuntimeAdapterOutputBudget,\n  IRuntimeAdapterRecordCollector,\n  IRuntimeAdapterResultCollector,\n} from './types.js';\n\n/** Creates the immutable admission view from Core's authoritative raw counters. */\nexport const createRuntimeAdapterOutputBudget = (\n  counts: IRuntimeAdapterOutputCounts,\n  limits: ICoreResourceLimits,\n): IRuntimeAdapterOutputBudget =>\n  Object.freeze({\n    diagnostics: Object.freeze({\n      maximum: limits.maxDiagnostics,\n      remaining: limits.maxDiagnostics - counts.diagnostics,\n    }),\n    evidence: Object.freeze({\n      maximum: limits.maxEvidence,\n      remaining: limits.maxEvidence - counts.evidence,\n    }),\n  });\n\n/**\n * Collects one adapter result without constructing records beyond its remaining allowance.\n * @param context The trusted invocation agent, raw output budget, and operation signal.\n * @returns Independent collectors and one final immutable adapter result.\n */\nexport const createRuntimeAdapterResultCollector = (\n  context: Pick<IRuntimeAdapterContext, 'agent' | 'outputBudget' | 'signal'>,\n): IRuntimeAdapterResultCollector => {\n  const diagnostics: IAdapterDiagnostic[] = [];\n  const evidence: IRuntimeAdapterEvidence[] = [];\n\n  const createCollector = <TRecord>(\n    kind: keyof IRuntimeAdapterOutputBudget,\n    records: TRecord[],\n  ): IRuntimeAdapterRecordCollector<TRecord> => {\n    const { maximum, remaining } = context.outputBudget[kind];\n    let admitted = 0;\n\n    return Object.freeze({\n      some: (predicate: (record: TRecord) => boolean): boolean => records.some(predicate),\n      add: (factory: () => TRecord): void => {\n        if (context.signal?.aborted) {\n          throw new CoreOperationException({\n            adapterId: context.agent.declaration.runtime.id,\n            cause: context.signal.reason,\n            code: 'ABORTED',\n            operation: 'validate-adapter',\n          });\n        }\n\n        if (admitted >= remaining) {\n          throw new CoreOperationException({\n            adapterId: context.agent.declaration.runtime.id,\n            code: 'RESOURCE_LIMIT_EXCEEDED',\n            limit: kind === 'diagnostics' ? 'maxDiagnostics' : 'maxEvidence',\n            limitMaximum: maximum,\n            nextAction: 'reduce-input-or-increase-limit',\n            observedUsage: maximum - remaining + admitted + 1,\n            operation: 'validate-adapter',\n          });\n        }\n\n        admitted += 1;\n        records.push(factory());\n      },\n    });\n  };\n\n  return Object.freeze({\n    diagnostics: createCollector('diagnostics', diagnostics),\n    evidence: createCollector('evidence', evidence),\n    finalize: (): IRuntimeAdapterResult =>\n      Object.freeze({\n        diagnostics: Object.freeze(diagnostics),\n        evidence: Object.freeze(evidence),\n      }),\n  });\n};\n"],"mappings":";;AAIA,IAAM,2CAA2B,IAAI,QAA6D;;AAGlG,IAAa,iDACX,YACA,YACS;CACT,IAAI,yBAAyB,IAAI,UAAU,GACzC,MAAM,IAAI,UAAU,uDAAuD;CAG7E,yBAAyB,IAAI,YAAY,OAAO;AAClD;;AAGA,IAAa,+CACX,YACA,eACS;CACT,MAAM,UAAU,yBAAyB,IAAI,UAAU;CAEvD,IAAI,YAAY,KAAA,GACd,QAAQ,UAAU;AAEtB;;;;ACXA,IAAa,oCACX,QACA,WAEA,OAAO,OAAO;CACZ,aAAa,OAAO,OAAO;EACzB,SAAS,OAAO;EAChB,WAAW,OAAO,iBAAiB,OAAO;CAC5C,CAAC;CACD,UAAU,OAAO,OAAO;EACtB,SAAS,OAAO;EAChB,WAAW,OAAO,cAAc,OAAO;CACzC,CAAC;AACH,CAAC;;;;;;AAOH,IAAa,uCACX,YACmC;CACnC,MAAM,cAAoC,CAAC;CAC3C,MAAM,WAAsC,CAAC;CAE7C,MAAM,mBACJ,MACA,YAC4C;EAC5C,MAAM,EAAE,SAAS,cAAc,QAAQ,aAAa;EACpD,IAAI,WAAW;EAEf,OAAO,OAAO,OAAO;GACnB,OAAO,cAAqD,QAAQ,KAAK,SAAS;GAClF,MAAM,YAAiC;IACrC,IAAI,QAAQ,QAAQ,SAClB,MAAM,IAAI,uBAAuB;KAC/B,WAAW,QAAQ,MAAM,YAAY,QAAQ;KAC7C,OAAO,QAAQ,OAAO;KACtB,MAAM;KACN,WAAW;IACb,CAAC;IAGH,IAAI,YAAY,WACd,MAAM,IAAI,uBAAuB;KAC/B,WAAW,QAAQ,MAAM,YAAY,QAAQ;KAC7C,MAAM;KACN,OAAO,SAAS,gBAAgB,mBAAmB;KACnD,cAAc;KACd,YAAY;KACZ,eAAe,UAAU,YAAY,WAAW;KAChD,WAAW;IACb,CAAC;IAGH,YAAY;IACZ,QAAQ,KAAK,QAAQ,CAAC;GACxB;EACF,CAAC;CACH;CAEA,OAAO,OAAO,OAAO;EACnB,aAAa,gBAAgB,eAAe,WAAW;EACvD,UAAU,gBAAgB,YAAY,QAAQ;EAC9C,gBACE,OAAO,OAAO;GACZ,aAAa,OAAO,OAAO,WAAW;GACtC,UAAU,OAAO,OAAO,QAAQ;EAClC,CAAC;CACL,CAAC;AACH"}