@moldea.ai/core 2.1.0 → 3.0.1

package/dist/manifest/index.d.ts

@@ -17,7 +17,7 @@ export interface IManifestDocumentInspectionResult extends IManifestParseResult
  * - INVALID_ARGUMENT: The Core operation received an invalid argument.
  * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
  */
-export declare const inspectManifestDocument: (input: ITextDocumentInput, options: ICoreOptionsSnapshot, operation?: Extract<ICoreOperation, "parse-manifest" | "match-manifest-scope" | "inspect-project">) => Promise<IManifestDocumentInspectionResult>;
+export declare const inspectManifestDocument: (input: ITextDocumentInput, options: ICoreOptionsSnapshot, operation?: Extract<ICoreOperation, "parse-manifest" | "match-manifest-scope" | "validate-project">) => Promise<IManifestDocumentInspectionResult>;
 /**
  * Parses and validates one complete version 1 manifest document.
  * @param input The canonical logical path and exact manifest text or bytes.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAEV,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAMzC,MAAM,WAAW,iCAAkC,SAAQ,oBAAoB;IAC7E,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAChE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,kBAAkB,EACzB,SAAS,oBAAoB,EAC7B,YAAW,OAAO,CAChB,cAAc,EACd,gBAAgB,GAAG,sBAAsB,GAAG,iBAAiB,CAC3C,KACnB,OAAO,CAAC,iCAAiC,CA8D3C,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,kBAAkB,EACzB,SAAS,oBAAoB,EAC7B,YAAW,OAAO,CAAC,cAAc,EAAE,gBAAgB,GAAG,sBAAsB,CAAoB,KAC/F,OAAO,CAAC,oBAAoB,CAS9B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAEV,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAMzC,MAAM,WAAW,iCAAkC,SAAQ,oBAAoB;IAC7E,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAChE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,kBAAkB,EACzB,SAAS,oBAAoB,EAC7B,YAAW,OAAO,CAChB,cAAc,EACd,gBAAgB,GAAG,sBAAsB,GAAG,kBAAkB,CAC5C,KACnB,OAAO,CAAC,iCAAiC,CA8D3C,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,kBAAkB,EACzB,SAAS,oBAAoB,EAC7B,YAAW,OAAO,CAAC,cAAc,EAAE,gBAAgB,GAAG,sBAAsB,CAAoB,KAC/F,OAAO,CAAC,oBAAoB,CAS9B,CAAC"}

package/dist/mirrors/index.d.ts

@@ -1,8 +1,9 @@
-import type { IRepositoryPath, IRepositoryReader } from '@moldea.ai/repository';
+import type { IRepositoryPath } from '@moldea.ai/repository';
 import type { IInspectedAgentAssets } from '../agent-assets/index.js';
 import type { IIndexedMirror } from '../contracts/index.js';
 import type { ICoreDiagnostic } from '../diagnostics/index.js';
 import { type ICoreOptionsSnapshot } from '../options/index.js';
+import type { IRepositoryInspectionReader } from '../repository-inspection-session/index.js';
 export interface IAgentMirrorInspection {
     readonly id: string;
     readonly mirrors: readonly IIndexedMirror[];
@@ -31,5 +32,5 @@ export interface IMirrorInspectionResult {
  * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
  * - ABORTED: Mirror inspection or a repository operation was aborted.
  */
-export declare const inspectMirrors: (repository: IRepositoryReader, manifestPath: IRepositoryPath, agents: readonly IInspectedAgentAssets[], options: ICoreOptionsSnapshot, signal?: AbortSignal) => Promise<IMirrorInspectionResult>;
+export declare const inspectMirrors: (repository: IRepositoryInspectionReader, manifestPath: IRepositoryPath, agents: readonly IInspectedAgentAssets[], options: ICoreOptionsSnapshot, signal?: AbortSignal) => Promise<IMirrorInspectionResult>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mirrors/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EACf,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,uBAAuB,CAAC;AAM/E,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,yBAAyB,CAAC;AAGpF,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIpG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAqHD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,iBAAiB,EAC7B,cAAc,eAAe,EAC7B,QAAQ,SAAS,qBAAqB,EAAE,EACxC,SAAS,oBAAoB,EAC7B,SAAS,WAAW,KACnB,OAAO,CAAC,uBAAuB,CA2CjC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mirrors/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,uBAAuB,CAAC;AAM/E,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,yBAAyB,CAAC;AAGpF,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAI7F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAuHD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,2BAA2B,EACvC,cAAc,eAAe,EAC7B,QAAQ,SAAS,qBAAqB,EAAE,EACxC,SAAS,oBAAoB,EAC7B,SAAS,WAAW,KACnB,OAAO,CAAC,uBAAuB,CA2CjC,CAAC"}

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

@@ -1,9 +1,10 @@
-import type { IRepositoryPath, IRepositoryReader } from '@moldea.ai/repository';
+import type { IRepositoryPath } from '@moldea.ai/repository';
 import type { ICanonicalDiscoveryResult } from '../canonical-discovery/index.js';
 import type { IIndexedContextAsset, IIndexedTextAsset } from '../contracts/index.js';
 import type { ICoreDiagnostic } from '../diagnostics/index.js';
 import type { IMoldeaManifestV1 } from '../format/index.js';
 import { type ICoreOptionsSnapshot } from '../options/index.js';
+import type { IRepositoryInspectionReader } from '../repository-inspection-session/index.js';
 export interface IProjectAssetInspectionResult {
     readonly valid: boolean;
     readonly project: IIndexedTextAsset | null;
@@ -32,7 +33,7 @@ export interface IProjectFileInspectionResult {
  * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
  * - ABORTED: Project inspection or the repository read was aborted.
  */
-export declare const readProjectFile: (repository: IRepositoryReader, path: IRepositoryPath | null, options: ICoreOptionsSnapshot, signal?: AbortSignal) => Promise<IProjectFileInspectionResult>;
+export declare const readProjectFile: (repository: IRepositoryInspectionReader, path: IRepositoryPath | null, options: ICoreOptionsSnapshot, signal?: AbortSignal) => Promise<IProjectFileInspectionResult>;
 /**
  * Reads the project foundation and every discovered focused-context asset.
  * @param repository The coherent source-neutral reader for the active inspection session.
@@ -52,5 +53,5 @@ export declare const readProjectFile: (repository: IRepositoryReader, path: IRep
  * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
  * - ABORTED: Project asset inspection or a repository operation was aborted.
  */
-export declare const readProjectAssets: (repository: IRepositoryReader, manifest: IMoldeaManifestV1 | null, discovery: ICanonicalDiscoveryResult, options: ICoreOptionsSnapshot, signal?: AbortSignal, projectFile?: IProjectFileInspectionResult) => Promise<IProjectAssetInspectionResult>;
+export declare const readProjectAssets: (repository: IRepositoryInspectionReader, manifest: IMoldeaManifestV1 | null, discovery: ICanonicalDiscoveryResult, options: ICoreOptionsSnapshot, signal?: AbortSignal, projectFile?: IProjectFileInspectionResult) => Promise<IProjectAssetInspectionResult>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-assets/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAKrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIpG,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAGD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,iBAAiB,EAC7B,MAAM,eAAe,GAAG,IAAI,EAC5B,SAAS,oBAAoB,EAC7B,SAAS,WAAW,KACnB,OAAO,CAAC,4BAA4B,CAyBtC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,YAAY,iBAAiB,EAC7B,UAAU,iBAAiB,GAAG,IAAI,EAClC,WAAW,yBAAyB,EACpC,SAAS,oBAAoB,EAC7B,SAAS,WAAW,EACpB,cAAc,4BAA4B,KACzC,OAAO,CAAC,6BAA6B,CAoCvC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-assets/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAKrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAI7F,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAGD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,2BAA2B,EACvC,MAAM,eAAe,GAAG,IAAI,EAC5B,SAAS,oBAAoB,EAC7B,SAAS,WAAW,KACnB,OAAO,CAAC,4BAA4B,CAyBtC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,YAAY,2BAA2B,EACvC,UAAU,iBAAiB,GAAG,IAAI,EAClC,WAAW,yBAAyB,EACpC,SAAS,oBAAoB,EAC7B,SAAS,WAAW,EACpB,cAAc,4BAA4B,KACzC,OAAO,CAAC,6BAA6B,CAoCvC,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { IProjectInspectionPageInput, IProjectInspectionPageResult } from '../contracts/index.js';
+import type { ICoreOptionsSnapshot } from '../options/index.js';
+/** Returns one bounded content-free view over a completely validated project snapshot. */
+export declare const inspectProjectPage: (input: IProjectInspectionPageInput, options: ICoreOptionsSnapshot) => Promise<IProjectInspectionPageResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-inspection-page/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,2BAA2B,EAE3B,4BAA4B,EAE7B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AA+JhE,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,GAC7B,OAAO,2BAA2B,EAClC,SAAS,oBAAoB,KAC5B,OAAO,CAAC,4BAA4B,CA2FtC,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { IMoldeaProjectIndex, IProjectMetadataItem, IProjectValidationSummary } from '../contracts/index.js';
+/** Collects deterministic content-free asset metadata from one validated project. */
+export declare const collectProjectMetadata: (project: IMoldeaProjectIndex) => readonly IProjectMetadataItem[];
+/** Creates the content-free summary for one validated project snapshot. */
+export declare const createProjectSummary: (project: IMoldeaProjectIndex) => IProjectValidationSummary;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAwB/B,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,GACjC,SAAS,mBAAmB,KAC3B,SAAS,oBAAoB,EA2C/B,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,GAAI,SAAS,mBAAmB,KAAG,yBAc5B,CAAC"}

package/dist/{project-inspection → project-validation}/index.d.ts

@@ -1,5 +1,9 @@
-import type { IProjectInspectionInput, IProjectInspectionResult } from '../contracts/index.js';
+import type { IMoldeaProjectIndex, IProjectValidationInput, IProjectValidationResult } from '../contracts/index.js';
 import { type ICoreOptionsSnapshot } from '../options/index.js';
+export interface IProjectValidationState {
+    readonly project: IMoldeaProjectIndex | null;
+    readonly result: IProjectValidationResult;
+}
 /**
  * Inspects one coherent repository snapshot through universal and adapter validation.
  * @param input The untrusted source-neutral reader and optional cancellation signal.
@@ -19,5 +23,7 @@ import { type ICoreOptionsSnapshot } from '../options/index.js';
  * - ABORTED: Project inspection or a repository operation was aborted.
  * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed or returned an invalid result.
  */
-export declare const inspectProject: (input: IProjectInspectionInput, options: ICoreOptionsSnapshot) => Promise<IProjectInspectionResult>;
+export declare const validateProjectState: (input: IProjectValidationInput, options: ICoreOptionsSnapshot) => Promise<IProjectValidationState>;
+/** Validates one project without returning canonical document bodies. */
+export declare const validateProject: (input: IProjectValidationInput, options: ICoreOptionsSnapshot) => Promise<IProjectValidationResult>;
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1,7 +1,17 @@
-import { type IRepositoryReader } from '@moldea.ai/repository';
+import { type IRepositoryEntry, type IRepositoryOperationOptions, type IRepositoryPath, type IRepositoryReader } from '@moldea.ai/repository';
 import type { ICoreResourceLimits } from '../contracts/index.js';
+import type { IRuntimeAdapterRepository } from '../adapter/index.js';
+export interface IRepositoryInspectionListOptions extends IRepositoryOperationOptions {
+    readonly prefix?: IRepositoryPath;
+}
+export interface IRepositoryInspectionReader {
+    getEntry(path: IRepositoryPath, options?: IRepositoryOperationOptions): Promise<IRepositoryEntry | null>;
+    iterateEntries(options?: IRepositoryInspectionListOptions): AsyncIterable<IRepositoryEntry>;
+    readCompleteFile(path: IRepositoryPath, options?: IRepositoryOperationOptions): Promise<Uint8Array>;
+}
 export interface IRepositoryInspectionSession {
-    readonly reader: IRepositoryReader;
+    readonly adapterRepository: IRuntimeAdapterRepository;
+    readonly reader: IRepositoryInspectionReader;
     /**
      * Stops work at an inspection boundary when cancellation was requested.
      * @throws
@@ -14,7 +24,7 @@ export interface IRepositoryInspectionSession {
  * @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.
- * @returns A frozen session whose reader owns inspection-local budgets and byte caching.
+ * @returns A session that pages source metadata and range-reads bounded canonical files.
  * @throws
  * - ABORTED: Repository inspection was aborted before the session was created.
  */

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,EAUL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAQjE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAAC;CACxB;AAsED;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAC5C,YAAY,iBAAiB,EAC7B,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,4BAsLF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-inspection-session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EAErB,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AASrE,MAAM,WAAW,gCAAiC,SAAQ,2BAA2B;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAGD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CACN,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpC,cAAc,CAAC,OAAO,CAAC,EAAE,gCAAgC,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC5F,gBAAgB,CACd,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB;AAGD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE7C;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAAC;CACxB;AA4FD;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAC5C,YAAY,iBAAiB,EAC7B,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,4BAyZF,CAAC"}

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

@@ -1,8 +1,9 @@
-import { type IRepositoryPath, type IRepositoryReader } from '@moldea.ai/repository';
+import { type IRepositoryPath } from '@moldea.ai/repository';
 import type { ICanonicalDiscoveryResult } from '../canonical-discovery/index.js';
 import type { ICoreResourceLimits } from '../contracts/index.js';
 import type { ICoreDiagnostic } from '../diagnostics/index.js';
 import type { IMoldeaManifestV1 } from '../format/index.js';
+import type { IRepositoryInspectionReader } from '../repository-inspection-session/index.js';
 /**
  * Validates every manifest repository reference, binding, and exact impact path.
  * @param repository The budget-aware reader for the active inspection session.
@@ -21,5 +22,5 @@ import type { IMoldeaManifestV1 } from '../format/index.js';
  * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
  * - ABORTED: Repository inspection or a repository lookup was aborted.
  */
-export declare const validateRepositoryReferences: (repository: IRepositoryReader, manifestPath: IRepositoryPath, manifest: IMoldeaManifestV1, discovery: ICanonicalDiscoveryResult, limits: ICoreResourceLimits, signal?: AbortSignal) => Promise<readonly ICoreDiagnostic[]>;
+export declare const validateRepositoryReferences: (repository: IRepositoryInspectionReader, manifestPath: IRepositoryPath, manifest: IMoldeaManifestV1, discovery: ICanonicalDiscoveryResult, limits: ICoreResourceLimits, signal?: AbortSignal) => Promise<readonly ICoreDiagnostic[]>;
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/repository-text/index.d.ts

@@ -1,6 +1,7 @@
-import { type IRepositoryPath, type IRepositoryReader } from '@moldea.ai/repository';
+import { type IRepositoryPath } from '@moldea.ai/repository';
 import type { ICoreResourceLimits, IIndexedTextAsset } from '../contracts/index.js';
 import type { ICoreDiagnostic } from '../diagnostics/index.js';
+import type { IRepositoryInspectionReader } from '../repository-inspection-session/index.js';
 export interface IRepositoryTextResult {
     readonly valid: boolean;
     readonly asset: IIndexedTextAsset | null;
@@ -23,5 +24,5 @@ export interface IRepositoryTextResult {
  * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
  * - ABORTED: Repository inspection or the repository read was aborted.
  */
-export declare const readRepositoryTextAsset: (repository: IRepositoryReader, path: IRepositoryPath, limits: ICoreResourceLimits, signal?: AbortSignal) => Promise<IRepositoryTextResult>;
+export declare const readRepositoryTextAsset: (repository: IRepositoryInspectionReader, path: IRepositoryPath, limits: ICoreResourceLimits, signal?: AbortSignal) => Promise<IRepositoryTextResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/repository-text/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK/D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,iBAAiB,EAC7B,MAAM,eAAe,EACrB,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,OAAO,CAAC,qBAAqB,CA8B/B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExF,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAI7F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,2BAA2B,EACvC,MAAM,eAAe,EACrB,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,OAAO,CAAC,qBAAqB,CAiC/B,CAAC"}

package/dist/runtime-guidance/index.d.ts

@@ -1,9 +1,10 @@
-import type { IRepositoryPath, IRepositoryReader } from '@moldea.ai/repository';
+import type { IRepositoryPath } from '@moldea.ai/repository';
 import type { ICanonicalDiscoveryResult } from '../canonical-discovery/index.js';
 import type { IIndexedRuntimeGuidance } from '../contracts/index.js';
 import type { ICoreDiagnostic } from '../diagnostics/index.js';
 import type { IMoldeaManifestV1 } from '../format/index.js';
 import { type ICoreOptionsSnapshot } from '../options/index.js';
+import type { IRepositoryInspectionReader } from '../repository-inspection-session/index.js';
 export interface IRuntimeGuidanceResult {
     readonly valid: boolean;
     readonly runtimes: readonly IIndexedRuntimeGuidance[];
@@ -28,5 +29,5 @@ export interface IRuntimeGuidanceResult {
  * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
  * - ABORTED: Guidance inspection or a repository operation was aborted.
  */
-export declare const readRuntimeGuidance: (repository: IRepositoryReader, manifestPath: IRepositoryPath, manifest: IMoldeaManifestV1 | null, discovery: ICanonicalDiscoveryResult, options: ICoreOptionsSnapshot, signal?: AbortSignal) => Promise<IRuntimeGuidanceResult>;
+export declare const readRuntimeGuidance: (repository: IRepositoryInspectionReader, manifestPath: IRepositoryPath, manifest: IMoldeaManifestV1 | null, discovery: ICanonicalDiscoveryResult, options: ICoreOptionsSnapshot, signal?: AbortSignal) => Promise<IRuntimeGuidanceResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime-guidance/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime-guidance/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAMrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIpG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AA8BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,iBAAiB,EAC7B,cAAc,eAAe,EAC7B,UAAU,iBAAiB,GAAG,IAAI,EAClC,WAAW,yBAAyB,EACpC,SAAS,oBAAoB,EAC7B,SAAS,WAAW,KACnB,OAAO,CAAC,sBAAsB,CAsDhC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime-guidance/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAMrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAI7F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AA8BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,2BAA2B,EACvC,cAAc,eAAe,EAC7B,UAAU,iBAAiB,GAAG,IAAI,EAClC,WAAW,yBAAyB,EACpC,SAAS,oBAAoB,EAC7B,SAAS,WAAW,KACnB,OAAO,CAAC,sBAAsB,CAsDhC,CAAC"}

package/package.json

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-inspection/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAG/F,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAgEpG;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,wBAAwB,CAyDlC,CAAC"}