@moldea.ai/core 2.0.2 → 2.1.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" | "inspect-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,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"}

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": "2.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": {