@moldea.ai/core 7.0.3 → 7.1.0

package/dist/integration-validation/inspection.d.ts

@@ -1,8 +1,14 @@
 import type { ICoreResourceLimits } from '../contracts/index.js';
 import type { ICoreDiagnostic } from '../diagnostics/index.js';
-import type { IRepositoryInspectionReader } from '../repository-inspection-session/index.js';
+import type { IRepositoryInspectionReader, IRepositoryInstructionView } from '../repository-inspection-session/index.js';
 /**
- * Checks the root integration against its installed asset with at most two reads and two lookups.
+ * Checks the coding-agent integration: root AGENTS.md and the Claude Code instruction files
+ * through the instruction view, and the referenced skill installation through the repository
+ * reader, with at most six entry lookups, four link resolutions, and five bounded reads.
+ * @param reader The repository inspection reader for skill files and the managed asset.
+ * @param instructions The instruction view for the coding-agent instruction paths.
+ * @param limits The immutable resource limits for the inspection.
+ * @param signal Optional cancellation for repository lookups.
  * @returns Completed content-free integration warnings, never an execution or runtime-wiring claim.
  * @throws
  * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
@@ -14,5 +20,5 @@ import type { IRepositoryInspectionReader } from '../repository-inspection-sessi
  * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
  * - INVALID_SOURCE_DATA: The repository source returned invalid data.
  */
-export declare const inspectCodingAgentIntegration: (reader: IRepositoryInspectionReader, limits: ICoreResourceLimits, signal?: AbortSignal) => Promise<readonly ICoreDiagnostic[]>;
+export declare const inspectCodingAgentIntegration: (reader: IRepositoryInspectionReader, instructions: IRepositoryInstructionView, limits: ICoreResourceLimits, signal?: AbortSignal) => Promise<readonly ICoreDiagnostic[]>;
 //# sourceMappingURL=inspection.d.ts.map

package/dist/integration-validation/inspection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/integration-validation/inspection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,yBAAyB,CAAC;AACjF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAyD7F;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,6BAA6B,GACxC,QAAQ,2BAA2B,EACnC,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,OAAO,CAAC,SAAS,eAAe,EAAE,CAgGpC,CAAC"}
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/integration-validation/inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,2CAA2C,CAAC;AAOnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B,GACxC,QAAQ,2BAA2B,EACnC,cAAc,0BAA0B,EACxC,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,OAAO,CAAC,SAAS,eAAe,EAAE,CAqBpC,CAAC"}

package/dist/integration-validation/parser.d.ts

@@ -6,4 +6,12 @@ export declare const parseManagedIntegrationRegion: (text: string) => IManagedIn
  * @returns The safe installation path or the reason it could not be obtained.
  */
 export declare const parseIntegrationBlock: (text: string) => IIntegrationBlockResult;
+/**
+ * Reports whether Claude Code instruction text imports the root AGENTS.md on a line of its own.
+ * Lines inside fenced code blocks and imports embedded in other text do not count.
+ * @param text The decoded instruction text.
+ * @param isNested Whether the text belongs to `/.claude/CLAUDE.md` rather than a root file.
+ * @returns `true` when one unfenced line, trimmed of spaces and tabs, is an AGENTS.md import.
+ */
+export declare const hasAgentsImport: (text: string, isNested: boolean) => boolean;
 //# sourceMappingURL=parser.d.ts.map

package/dist/integration-validation/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/integration-validation/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAKrF,qGAAqG;AACrG,eAAO,MAAM,6BAA6B,GAAI,MAAM,MAAM,KAAG,yBAAyB,GAAG,IAwBxF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,uBAwBpD,CAAC"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/integration-validation/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAKrF,qGAAqG;AACrG,eAAO,MAAM,6BAA6B,GAAI,MAAM,MAAM,KAAG,yBAAyB,GAAG,IAwBxF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,uBAwBpD,CAAC;AAMF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,UAAU,OAAO,KAAG,OAmBjE,CAAC"}

package/dist/integration-validation/types.d.ts

@@ -1,3 +1,7 @@
+import type { IRepositoryLinkResolution, IRepositoryPath } from '@moldea.ai/repository';
+import type { ICoreWarningCode } from '../diagnostics/index.js';
+import type { IRepositoryInspectionReader, IRepositoryInstructionView } from '../repository-inspection-session/index.js';
+import type { IRetainedMemory } from '../retained-memory/index.js';
 export interface IManagedIntegrationRegion {
     start: number;
     end: number;
@@ -10,4 +14,18 @@ export type IIntegrationBlockResult = {
     kind: 'missing';
     reason: 'block-missing' | 'block-invalid' | 'skill-path-missing' | 'skill-path-invalid';
 };
+export type IInstructionLinkState = 'broken' | 'denied' | 'directory' | 'loop' | 'not-file' | 'not-link' | 'other' | 'unavailable' | 'unsafe';
+export interface IIntegrationInspectionContext {
+    readonly instructions: IRepositoryInstructionView;
+    readonly ledger: IRetainedMemory;
+    readonly reader: IRepositoryInspectionReader;
+    readonly report: (code: ICoreWarningCode, subject: IRepositoryPath, details: Record<string, string>) => void;
+    readonly signal?: AbortSignal;
+}
+export type IAgentsInstructionTarget = {
+    readonly kind: 'directory' | 'file' | 'missing';
+} | {
+    readonly kind: 'link';
+    readonly resolution: IRepositoryLinkResolution | null;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/integration-validation/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/integration-validation/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,IAAI,GAAG,MAAM,CAAC;CAC3B;AAGD,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpC;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,eAAe,GAAG,eAAe,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;CACzF,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/integration-validation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnE,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,IAAI,GAAG,MAAM,CAAC;CAC3B;AAGD,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpC;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,eAAe,GAAG,eAAe,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;CACzF,CAAC;AAGN,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,MAAM,GACN,UAAU,GACV,UAAU,GACV,OAAO,GACP,aAAa,GACb,QAAQ,CAAC;AAGb,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,CACf,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5B,IAAI,CAAC;IACV,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAGD,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,CAAA;CAAE,CAAC"}

package/dist/integration-validation/utilities.d.ts

@@ -0,0 +1,33 @@
+import { type IRepositoryLinkResolution } from '@moldea.ai/repository';
+import type { IRetainedMemory, IRetainedSource } from '../retained-memory/index.js';
+import type { IInstructionLinkState } from './types.js';
+/**
+ * Reads bounded untrusted text with a reservation for decoding and temporary string copies.
+ * @param ledger The session ledger that owns the reservation.
+ * @param load Loads the complete bounded source buffer.
+ * @returns Decoded text or null for invalid UTF-8, with its reservation-release operation.
+ * @throws
+ * - ENTRY_NOT_FOUND: The requested repository entry was not found.
+ * - ENTRY_NOT_FILE: The requested repository entry is not a file.
+ * - 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.
+ * - 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.
+ * - INVALID_SOURCE_DATA: The repository source returned invalid data.
+ */
+export declare const readRetainedText: (ledger: IRetainedMemory, load: () => Promise<IRetainedSource>) => Promise<{
+    text: string | null;
+    release: () => void;
+}>;
+/** Distinguishes missing and non-regular files without an extra entry lookup or following symlinks. */
+export declare const getAbsentKind: (error: unknown) => "missing" | "non-regular" | null;
+/**
+ * Explains why a linked instruction file cannot be read, or returns null for a readable link.
+ * @param resolution The resolver's classification, or null when no resolver is available.
+ * @returns The content-free link state, or null when the final target is a regular file.
+ */
+export declare const getUnreadableLinkState: (resolution: IRepositoryLinkResolution | null) => IInstructionLinkState | null;
+//# sourceMappingURL=utilities.d.ts.map

package/dist/integration-validation/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/integration-validation/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElG,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,eAAe,EACvB,MAAM,MAAM,OAAO,CAAC,eAAe,CAAC,KACnC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAoBtD,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,SAAS,GAAG,aAAa,GAAG,IAOjE,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,yBAAyB,GAAG,IAAI,KAC3C,qBAAqB,GAAG,IAU1B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/node-inspection/client.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAEV,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AA4BpB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,2BAA2B,KACjC,OAAO,CAAC,sBAAsB,CA+UhC,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/node-inspection/client.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAGV,sBAAsB,EACtB,2BAA2B,EAE5B,MAAM,YAAY,CAAC;AAuEpB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,2BAA2B,KACjC,OAAO,CAAC,sBAAsB,CA4VhC,CAAC"}

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

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

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

@@ -1,14 +1,16 @@
-import { type IRepositoryEntry, type IRepositoryEntryPage, type IRepositoryFilePage, type IRepositoryReader } from '@moldea.ai/repository';
-import type { INodeReaderRequest } from './types.js';
+import { type IRepositoryEntry, type IRepositoryEntryPage, type IRepositoryFilePage, type IRepositoryLinkResolution } from '@moldea.ai/repository';
+import type { INodeReaderRequest, INodeReaderSources } from './types.js';
 /** Converts one validated metadata-only repository entry. */
 export declare const parseRpcEntry: (input: unknown) => IRepositoryEntry | null;
 /** Converts a bounded listing page while retaining snapshot and continuation contracts. */
 export declare const parseRpcEntryPage: (input: unknown) => IRepositoryEntryPage;
+/** Converts one content-free link resolution without admitting fields outside the closed union. */
+export declare const parseRpcLinkResolution: (input: unknown) => IRepositoryLinkResolution;
 /** Decodes only an admitted 64 KiB binary page, never a complete repository file. */
 export declare const parseRpcFilePage: (input: unknown) => IRepositoryFilePage;
 /**
- * Calls the real reader with inspection cancellation and returns a bounded transport value.
- * Reader failures propagate unchanged to the parent inspection owner.
+ * Calls the real reader or link resolver with inspection cancellation and returns a bounded
+ * transport value. Reader failures propagate unchanged to the parent inspection owner.
  * @returns A metadata value or encoded byte page after actual reader settlement.
  * @throws
  * - INVALID_REPOSITORY_PATH: The repository path is invalid.
@@ -24,5 +26,5 @@ export declare const parseRpcFilePage: (input: unknown) => IRepositoryFilePage;
  * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
  * - ABORTED: The repository operation was aborted.
  */
-export declare const executeRepositoryRpc: (reader: IRepositoryReader, request: INodeReaderRequest, signal: AbortSignal) => Promise<unknown>;
+export declare const executeRepositoryRpc: (sources: INodeReaderSources, request: INodeReaderRequest, signal: AbortSignal) => Promise<unknown>;
 //# sourceMappingURL=repository-rpc.d.ts.map

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

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

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

@@ -1,7 +1,8 @@
 import type { IRepositoryReader, IRepositorySnapshot } from '@moldea.ai/repository';
-import type { ICoreResourceLimits, IProjectInspection, IProjectInspectionPageInput, IProjectInspectionPageResult } from '../contracts/index.js';
+import type { ICoreResourceLimits, IProjectInspection, IProjectInspectionPageInput, IProjectInspectionPageResult, IProjectInstructionSource } from '../contracts/index.js';
 export interface INodeProjectInspectionInput {
     repository: IRepositoryReader;
+    instructions?: IProjectInstructionSource;
     limits?: Partial<ICoreResourceLimits>;
     signal?: AbortSignal;
     deadline?: number;
@@ -33,9 +34,19 @@ export interface INodeProjectInspection extends INodeInspectionMetadata {
      */
     dispose(): Promise<void>;
 }
+export type INodeReaderSource = 'instructions' | 'repository';
+export interface INodeReaderSources {
+    readonly instructions?: IProjectInstructionSource;
+    readonly repository: IRepositoryReader;
+}
+export interface INodeInstructionSourceMetadata {
+    hasLinkResolver: boolean;
+    snapshot: IRepositorySnapshot;
+}
 export type INodeReaderRequest = {
     method: 'getEntry';
     path: string;
+    source: INodeReaderSource;
 } | {
     method: 'listEntriesPage';
     maxEntries: number;
@@ -46,6 +57,15 @@ export type INodeReaderRequest = {
     path: string;
     maxBytes: number;
     offset: number;
+    source: INodeReaderSource;
+} | {
+    method: 'resolveLink';
+    path: string;
+} | {
+    method: 'readLinkTargetPage';
+    path: string;
+    maxBytes: number;
+    offset: number;
 };
 export interface INodeInspectionFailure {
     family: 'configuration' | 'operation' | 'repository' | 'path';
@@ -56,6 +76,7 @@ export type INodeInspectionMessage = {
 } & ({
     kind: 'start';
     snapshot: IRepositorySnapshot;
+    instructions: INodeInstructionSourceMetadata | null;
     limits: ICoreResourceLimits;
     deadline: number;
 } | {

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/node-inspection/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAAG;IAC3E,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC,CAAC;AAEF,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAEpF;;;;;;;;;OASG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAGD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACnF;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,sBAAsB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,CACzD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,uBAAuB,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,2BAA2B,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CACtB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/node-inspection/types.ts"],"names":[],"mappings":"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"}

package/dist/node-runner.js

@@ -1,6 +1,6 @@
 import { n as CoreOperationException } from "./chunks/exceptions-CYf1pCKf.js";
-import { a as encodeInspectionMessage, i as decodeInspectionMessage, n as serializeInspectionFailure, r as createInspectionProcessFailure, s as NODE_INSPECTION_LIFETIME_MS } from "./chunks/errors-Dw1ahMS1.js";
-import { n as createInspectionSender } from "./chunks/lifecycle-h3DWn5vl.js";
+import { a as encodeInspectionMessage, i as decodeInspectionMessage, n as serializeInspectionFailure, r as createInspectionProcessFailure, s as NODE_INSPECTION_LIFETIME_MS } from "./chunks/errors-BhiLG9F0.js";
+import { n as createInspectionSender } from "./chunks/lifecycle-Bdi_ydtH.js";
 import process from "node:process";
 import { Worker } from "node:worker_threads";
 //#region src/node-inspection/runner.ts

package/dist/node.js

@@ -1,8 +1,8 @@
-import { c as freezeRecursively, n as normalizeCoreOptions } from "./chunks/options-AMqX7rx_.js";
+import { c as freezeRecursively, n as normalizeCoreOptions } from "./chunks/options-BVF3DQHm.js";
 import { n as CoreOperationException } from "./chunks/exceptions-CYf1pCKf.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-Dw1ahMS1.js";
-import { n as createInspectionSender, r as superviseInspectionChild, t as createInspectionEnvironment } from "./chunks/lifecycle-h3DWn5vl.js";
-import { t as executeRepositoryRpc } from "./chunks/repository-rpc-ClAIx3-c.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-BhiLG9F0.js";
+import { n as createInspectionSender, r as superviseInspectionChild, t as createInspectionEnvironment } from "./chunks/lifecycle-Bdi_ydtH.js";
+import { t as executeRepositoryRpc } from "./chunks/repository-rpc-CiKFu86B.js";
 import { RepositorySourceException } from "@moldea.ai/repository";
 import { fork } from "node:child_process";
 import { randomBytes } from "node:crypto";
@@ -24,6 +24,24 @@ var createCompletion = () => {
 		reject
 	};
 };
+var isRecord = (input) => input !== null && typeof input === "object";
+var isSnapshot = (input) => isRecord(input) && typeof input["id"] === "string" && input["id"].length > 0 && typeof input["sourceKind"] === "string" && input["sourceKind"].length > 0;
+/** Describes a supplied instruction source for the worker, or rejects one Core could not use. */
+var describeInstructions = (instructions) => {
+	if (instructions === void 0) return null;
+	if (!isRecord(instructions) || Reflect.ownKeys(instructions).some((key) => key !== "reader" && key !== "linkResolver")) return void 0;
+	const reader = instructions["reader"];
+	const linkResolver = instructions["linkResolver"];
+	if (!isRecord(reader) || typeof reader["getEntry"] !== "function" || typeof reader["readFilePage"] !== "function" || !isSnapshot(reader["snapshot"])) return void 0;
+	if (linkResolver !== void 0 && (!isRecord(linkResolver) || typeof linkResolver["resolveLink"] !== "function" || typeof linkResolver["readLinkTargetPage"] !== "function" || !isSnapshot(linkResolver["snapshot"]) || linkResolver["snapshot"].id !== reader["snapshot"].id)) return void 0;
+	return {
+		hasLinkResolver: linkResolver !== void 0,
+		snapshot: {
+			id: reader["snapshot"].id,
+			sourceKind: reader["snapshot"].sourceKind
+		}
+	};
+};
 var aborted = (cause) => new CoreOperationException({
 	code: "ABORTED",
 	operation: "create-project-inspection",
@@ -59,10 +77,18 @@ var createNodeProjectInspection = async (input) => {
 		code: "INVALID_ARGUMENT",
 		operation: "create-project-inspection"
 	});
-	let repository = input.repository;
+	const instructions = describeInstructions(input.instructions);
+	if (instructions === void 0) throw new CoreOperationException({
+		code: "INVALID_ARGUMENT",
+		operation: "create-project-inspection"
+	});
+	let sources = {
+		repository: input.repository,
+		...input.instructions === void 0 ? {} : { instructions: input.instructions }
+	};
 	const snapshot = {
-		id: repository.snapshot.id,
-		sourceKind: repository.snapshot.sourceKind
+		id: input.repository.snapshot.id,
+		sourceKind: input.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({
@@ -146,7 +172,7 @@ var createNodeProjectInspection = async (input) => {
 			supervision.terminate();
 			await supervision.closed;
 			await Promise.allSettled([...readerWork, ...relayWork]);
-			repository = void 0;
+			sources = void 0;
 			clearTimeout(timer);
 			if (failure === void 0 && Date.now() >= deadline) fail(new CoreOperationException({
 				code: "INSPECTION_TIMEOUT",
@@ -210,8 +236,8 @@ var createNodeProjectInspection = async (input) => {
 			} 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);
+				if (sources === void 0) throw createInspectionProcessFailure();
+				const work = executeRepositoryRpc(sources, message.request, controller.signal);
 				readerWork.add(work);
 				const relay = (async () => {
 					try {
@@ -263,6 +289,7 @@ var createNodeProjectInspection = async (input) => {
 			attemptId,
 			kind: "start",
 			snapshot,
+			instructions,
 			limits,
 			deadline
 		});

package/dist/node.js.map

@@ -1 +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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"}
+{"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  INodeInstructionSourceMetadata,\n  INodeProjectInspection,\n  INodeProjectInspectionInput,\n  INodeReaderSources,\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 isRecord = (input: unknown): input is Record<string, unknown> =>\n  input !== null && typeof input === 'object';\nconst isSnapshot = (input: unknown): input is { id: string; sourceKind: string } =>\n  isRecord(input) &&\n  typeof input['id'] === 'string' &&\n  input['id'].length > 0 &&\n  typeof input['sourceKind'] === 'string' &&\n  input['sourceKind'].length > 0;\n\n/** Describes a supplied instruction source for the worker, or rejects one Core could not use. */\nconst describeInstructions = (\n  instructions: unknown,\n): INodeInstructionSourceMetadata | null | undefined => {\n  if (instructions === undefined) return null;\n  if (\n    !isRecord(instructions) ||\n    Reflect.ownKeys(instructions).some((key) => key !== 'reader' && key !== 'linkResolver')\n  )\n    return undefined;\n  const reader = instructions['reader'];\n  const linkResolver = instructions['linkResolver'];\n  if (\n    !isRecord(reader) ||\n    typeof reader['getEntry'] !== 'function' ||\n    typeof reader['readFilePage'] !== 'function' ||\n    !isSnapshot(reader['snapshot'])\n  )\n    return undefined;\n  if (\n    linkResolver !== undefined &&\n    (!isRecord(linkResolver) ||\n      typeof linkResolver['resolveLink'] !== 'function' ||\n      typeof linkResolver['readLinkTargetPage'] !== 'function' ||\n      !isSnapshot(linkResolver['snapshot']) ||\n      linkResolver['snapshot'].id !== reader['snapshot'].id)\n  )\n    return undefined;\n  return {\n    hasLinkResolver: linkResolver !== undefined,\n    snapshot: { id: reader['snapshot'].id, sourceKind: reader['snapshot'].sourceKind },\n  };\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  const instructions = describeInstructions(input.instructions);\n  if (instructions === undefined)\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  let sources: INodeReaderSources | undefined = {\n    repository: input.repository,\n    ...(input.instructions === undefined ? {} : { instructions: input.instructions }),\n  };\n  const snapshot = {\n    id: input.repository.snapshot.id,\n    sourceKind: input.repository.snapshot.sourceKind,\n  };\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      sources = 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 (sources === undefined) throw createInspectionProcessFailure();\n        const work = executeRepositoryRpc(sources, 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      instructions,\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/project-validation/index.d.ts

@@ -8,7 +8,7 @@ export interface IProjectValidationState {
 }
 /**
  * Inspects one coherent repository snapshot through universal file and export validation.
- * @param input The untrusted source-neutral reader and optional cancellation signal.
+ * @param input The untrusted source-neutral reader, optional instruction source, and signal.
  * @param options The immutable Core configuration snapshot.
  * @returns A promise resolving to the frozen all-or-nothing project inspection result.
  * @throws

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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-validation/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EAEnB,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;AAmHpG,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,CAiCjC,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,5 +1,6 @@
-import { type IRepositoryEntry, type IRepositoryOperationOptions, type IRepositoryPath, type IRepositoryReader } from '@moldea.ai/repository';
-import type { ICoreResourceLimits } from '../contracts/index.js';
+import { type IRepositoryEntry, type IRepositoryLinkResolution, type IRepositoryOperationOptions, type IRepositoryPath, type IRepositoryReader } from '@moldea.ai/repository';
+import type { ICoreResourceLimits, IProjectInstructionSource } from '../contracts/index.js';
+import { type IRetainedSource } from '../retained-memory/index.js';
 export interface IRepositoryInspectionListOptions extends IRepositoryOperationOptions {
     readonly prefix?: IRepositoryPath;
 }
@@ -8,7 +9,14 @@ export interface IRepositoryInspectionReader {
     iterateEntries(options?: IRepositoryInspectionListOptions): AsyncIterable<IRepositoryEntry>;
     readCompleteFile(path: IRepositoryPath, options?: IRepositoryOperationOptions): Promise<Uint8Array>;
 }
+export interface IRepositoryInstructionView {
+    getEntry(path: IRepositoryPath): Promise<IRepositoryEntry | null>;
+    readLinkedSourceFile(path: IRepositoryPath): Promise<IRetainedSource>;
+    readSourceFile(path: IRepositoryPath): Promise<IRetainedSource>;
+    resolveLink(path: IRepositoryPath): Promise<IRepositoryLinkResolution | null>;
+}
 export interface IRepositoryInspectionSession {
+    readonly instructions: IRepositoryInstructionView;
     readonly reader: IRepositoryInspectionReader;
     /** Returns deterministic logical resource usage for the current validation state. */
     getResourceUsage(): IRepositoryInspectionResourceUsage;
@@ -30,9 +38,10 @@ export interface IRepositoryInspectionResourceUsage {
  * @param repository The source-neutral reader bound to one coherent snapshot.
  * @param limits The immutable resource limits for the inspection.
  * @param signal Optional cancellation shared by every inspection operation.
+ * @param instructions Optional instruction source read only through the instruction view.
  * @returns A session that pages source metadata and range-reads bounded canonical files.
  * @throws
  * - ABORTED: The Core operation was aborted.
  */
-export declare const createRepositoryInspectionSession: (repository: IRepositoryReader, limits: ICoreResourceLimits, signal?: AbortSignal) => IRepositoryInspectionSession;
+export declare const createRepositoryInspectionSession: (repository: IRepositoryReader, limits: ICoreResourceLimits, signal?: AbortSignal, instructions?: IProjectInstructionSource) => 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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-inspection-session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EAGrB,KAAK,yBAAyB,EAE9B,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAmB3F,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;AAOD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAClE,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChE,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;CAC/E;AAGD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAC;IAClD,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;AA+JD;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC,GAC5C,YAAY,iBAAiB,EAC7B,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,EACpB,eAAe,yBAAyB,KACvC,4BAgcF,CAAC"}

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

@@ -1,13 +1,14 @@
 import type { IRepositoryPath } from '@moldea.ai/repository';
 import type { IRepositoryInspectionReader } from '../repository-inspection-session/index.js';
+export interface IRetainedSource {
+    bytes: Uint8Array;
+    release: () => void;
+}
 export interface IRetainedMemory {
     reserve(bytes: number): void;
     tryReserve(bytes: number): boolean;
     release(bytes: number): void;
-    readSourceFile(path: IRepositoryPath): Promise<{
-        bytes: Uint8Array;
-        release: () => void;
-    }>;
+    readSourceFile(path: IRepositoryPath): Promise<IRetainedSource>;
 }
 /** Registers the sole memory owner for one internal reader. */
 export declare const registerRetainedMemory: (reader: IRepositoryInspectionReader, ledger: IRetainedMemory) => void;

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

@@ -1 +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"}
+{"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,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAGD,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,eAAe,CAAC,CAAC;CACjE;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.js

@@ -1,5 +1,5 @@
-import { n as normalizeCoreOptions, t as createCoreOperationOptionsSnapshot } from "./chunks/options-AMqX7rx_.js";
-import { t as matchManifestScope$1 } from "./chunks/scope-DxhC1hq2.js";
+import { n as normalizeCoreOptions, t as createCoreOperationOptionsSnapshot } from "./chunks/options-BVF3DQHm.js";
+import { t as matchManifestScope$1 } from "./chunks/scope-DoNl6LhC.js";
 //#region src/scope/scope.ts
 /**
 * Matches only the supplied manifest and changed paths, without inspecting source files.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/universal-project-inspection/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAQnE,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAS9F,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,aAAa,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAGD,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,kCAAkC,EAC3C,SAAS,oBAAoB,KAC5B,OAAO,CAAC,iCAAiC,CAgL3C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/universal-project-inspection/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAQnE,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAS9F,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,aAAa,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAGD,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,kCAAkC,EAC3C,SAAS,oBAAoB,KAC5B,OAAO,CAAC,iCAAiC,CAuL3C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moldea.ai/core",
-  "version": "7.0.3",
+  "version": "7.1.0",
   "description": "Source-neutral, deterministic interpretation and indexing of moldea repositories.",
   "homepage": "https://github.com/moldea-ai/packages/tree/main/projects/core#readme",
   "bugs": {
@@ -46,7 +46,7 @@
   },
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@moldea.ai/repository": "^2.0.0",
+    "@moldea.ai/repository": "^2.1.0",
     "error-message-utils": "1.2.11",
     "yaml": "2.9.0",
     "typescript": "6.0.3"