@moldea.ai/core 2.0.2 → 3.0.0

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" | "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.
@@ -28,5 +28,5 @@ export declare const inspectManifestDocument: (input: ITextDocumentInput, option
  * - INVALID_ARGUMENT: The Core operation received an invalid argument.
  * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
  */
-export declare const parseManifestDocument: (input: ITextDocumentInput, options: ICoreOptionsSnapshot) => Promise<IManifestParseResult>;
+export declare const parseManifestDocument: (input: ITextDocumentInput, options: ICoreOptionsSnapshot, operation?: Extract<ICoreOperation, "parse-manifest" | "match-manifest-scope">) => Promise<IManifestParseResult>;
 //# sourceMappingURL=index.d.ts.map

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,CAAC,cAAc,EAAE,gBAAgB,GAAG,iBAAiB,CAAoB,KAC1F,OAAO,CAAC,iCAAiC,CA8D3C,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,kBAAkB,EACzB,SAAS,oBAAoB,KAC5B,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/dist/scope-matching/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scope-matching/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iCAAiC,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAG5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/scope-matching/matching.d.ts

@@ -0,0 +1,20 @@
+import type { IRepositoryPath } from '@moldea.ai/repository';
+import type { IContentDigest, ICoreResourceLimits } from '../contracts/index.js';
+import type { IMoldeaManifestV1 } from '../format/index.js';
+import type { IManifestScopeCounts, IManifestScopeMatch } from './types.js';
+/** Creates the canonical digest of the sorted unique changed-path set. */
+export declare const calculateManifestScopeInputDigest: (paths: readonly IRepositoryPath[]) => Promise<IContentDigest>;
+/**
+ * Matches normalized changed paths against one valid version 1 manifest.
+ * @param manifest The parsed and validated manifest value.
+ * @param paths Sorted unique repository-logical changed paths.
+ * @param limits The immutable Core operation limits.
+ * @returns Frozen content-free matches and stable aggregate counts.
+ * @throws
+ * - RESOURCE_LIMIT_EXCEEDED: The declaration or match count exceeded `maxEntries`.
+ */
+export declare const matchParsedManifestScope: (manifest: IMoldeaManifestV1, paths: readonly IRepositoryPath[], limits: ICoreResourceLimits) => {
+    readonly counts: IManifestScopeCounts;
+    readonly matches: readonly IManifestScopeMatch[];
+};
+//# sourceMappingURL=matching.d.ts.map

package/dist/scope-matching/matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.d.ts","sourceRoot":"","sources":["../../src/scope-matching/matching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIjF,OAAO,KAAK,EAEV,iBAAiB,EAKlB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EACV,oBAAoB,EAEpB,mBAAmB,EAGpB,MAAM,YAAY,CAAC;AAqfpB,0EAA0E;AAC1E,eAAO,MAAM,iCAAiC,GAC5C,OAAO,SAAS,eAAe,EAAE,KAChC,OAAO,CAAC,cAAc,CAQxB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,EAC3B,OAAO,SAAS,eAAe,EAAE,EACjC,QAAQ,mBAAmB,KAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAA;CAmC3F,CAAC"}

package/dist/scope-matching/scope.d.ts

@@ -0,0 +1,14 @@
+import type { ICoreOptionsSnapshot } from '../options/index.js';
+import type { IManifestScopeInput, IManifestScopeResult } from './types.js';
+/**
+ * Parses a manifest and matches its repository relationships against changed logical paths.
+ * @param input The canonical manifest document and untrusted changed-path collection.
+ * @param options The immutable Core operation options.
+ * @returns A promise resolving to frozen content-free scope metadata and matches.
+ * @throws
+ * - INVALID_REPOSITORY_PATH: The manifest path or a changed repository path is invalid.
+ * - INVALID_ARGUMENT: The scope operation received an invalid argument.
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ */
+export declare const matchManifestScope: (input: IManifestScopeInput, options: ICoreOptionsSnapshot) => Promise<IManifestScopeResult>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope-matching/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/scope-matching/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAKhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG5E;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,mBAAmB,EAC1B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,oBAAoB,CAkC9B,CAAC"}

package/dist/scope-matching/types.d.ts

@@ -0,0 +1,48 @@
+import type { IRepositoryPath } from '@moldea.ai/repository';
+import type { IContentDigest, ITextDocumentInput } from '../contracts/index.js';
+import type { ICoreDiagnostic } from '../diagnostics/index.js';
+export type IManifestScopeOwnerKind = 'agent' | 'context' | 'decision' | 'skill' | 'tool' | 'unresolved';
+export type IManifestScopeRelationshipField = 'affectedBy' | 'bindings' | 'implementation' | 'inputSchema' | 'instructionLoader' | 'mirrors' | 'outputSchema' | 'registration' | 'related' | 'runtimeAgent' | 'variableProvider';
+export interface IManifestScopeOwner {
+    readonly kind: IManifestScopeOwnerKind;
+    readonly id: string;
+    readonly agentId: string | null;
+}
+export interface IExactManifestScopeDeclaration {
+    readonly kind: 'exact';
+    readonly path: IRepositoryPath;
+    readonly symbol: string | null;
+}
+export interface IGlobManifestScopeDeclaration {
+    readonly kind: 'glob';
+    readonly pattern: string;
+}
+export type IManifestScopeDeclaration = IExactManifestScopeDeclaration | IGlobManifestScopeDeclaration;
+export interface IManifestScopeMatch {
+    readonly inputPath: IRepositoryPath;
+    readonly owner: IManifestScopeOwner;
+    readonly field: IManifestScopeRelationshipField;
+    readonly pointer: string;
+    readonly declaration: IManifestScopeDeclaration;
+}
+export interface IManifestScopeCounts {
+    readonly declarations: number;
+    readonly inputPaths: number;
+    readonly matchedOwners: number;
+    readonly matchedPaths: number;
+    readonly matches: number;
+}
+export interface IManifestScopeInput {
+    readonly manifest: ITextDocumentInput;
+    readonly paths: readonly string[];
+}
+export interface IManifestScopeResult {
+    readonly valid: boolean;
+    readonly relevant: boolean;
+    readonly manifestDigest: IContentDigest | null;
+    readonly inputDigest: IContentDigest;
+    readonly counts: IManifestScopeCounts;
+    readonly matches: readonly IManifestScopeMatch[];
+    readonly diagnostics: readonly ICoreDiagnostic[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scope-matching/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scope-matching/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D,MAAM,MAAM,uBAAuB,GACjC,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;AAGrE,MAAM,MAAM,+BAA+B,GACvC,YAAY,GACZ,UAAU,GACV,gBAAgB,GAChB,aAAa,GACb,mBAAmB,GACnB,SAAS,GACT,cAAc,GACd,cAAc,GACd,SAAS,GACT,cAAc,GACd,kBAAkB,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,yBAAyB,GACnC,8BAA8B,GAAG,6BAA6B,CAAC;AAGjE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;CACjD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD"}

package/dist/scope-matching/validations.d.ts

@@ -0,0 +1,21 @@
+import { type IRepositoryPath } from '@moldea.ai/repository';
+import type { ICoreResourceLimits, ITextDocumentInput } from '../contracts/index.js';
+import type { IManifestScopeInput } from './types.js';
+/** Measures scalar UTF-8 bytes without allocating an encoded copy. */
+export declare const measureUtf8ByteLength: (value: string) => number;
+export interface INormalizedManifestScopeInput {
+    readonly manifest: ITextDocumentInput;
+    readonly paths: readonly IRepositoryPath[];
+}
+/**
+ * Validates and snapshots one public manifest-scope input.
+ * @param input The untrusted manifest document and changed logical paths.
+ * @param limits The immutable Core resource limits.
+ * @returns The detached manifest input and sorted unique repository paths.
+ * @throws
+ * - INVALID_REPOSITORY_PATH: A changed repository path is invalid.
+ * - INVALID_ARGUMENT: The scope operation received an invalid argument.
+ * - RESOURCE_LIMIT_EXCEEDED: The changed-path count or byte budget was exceeded.
+ */
+export declare const normalizeManifestScopeInput: (input: IManifestScopeInput, limits: ICoreResourceLimits) => INormalizedManifestScopeInput;
+//# sourceMappingURL=validations.d.ts.map

package/dist/scope-matching/validations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validations.d.ts","sourceRoot":"","sources":["../../src/scope-matching/validations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIlF,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAuBtD,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,MASrD,CAAC;AAEF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CAC5C;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,mBAAmB,EAC1B,QAAQ,mBAAmB,KAC1B,6BAsCF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moldea.ai/core",
-  "version": "2.0.2",
+  "version": "3.0.0",
   "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"}