@moldea.ai/core 7.1.0 → 9.0.0

package/dist/chunks/{options-BVF3DQHm.js → options-C5360E_N.js}

@@ -1,12 +1,12 @@
-import { n as CoreOperationException, t as CoreConfigurationException } from "./exceptions-CYf1pCKf.js";
-import { isRepositoryPath, parseRepositoryPath } from "@moldea.ai/repository";
+import { n as CoreOperationException, t as CoreConfigurationException } from "./exceptions-AT654xUL.js";
+import { compareCodePoints, deepFreeze, isObjectValid } from "jg-utilities";
 //#region src/constants/index.ts
 var ACCEPTABLE_WARNING_CODES = Object.freeze([
 	"MOLDEA_IMPACT_PATTERN_UNMATCHED",
 	"MOLDEA_INTEGRATION_BLOCK_MISSING",
 	"MOLDEA_INTEGRATION_SKILL_MISSING",
 	"MOLDEA_INTEGRATION_BLOCK_STALE",
-	"MOLDEA_INTEGRATION_UNVERIFIED",
+	"MOLDEA_INTEGRATION_LINK_UNRESOLVED",
 	"MOLDEA_INTEGRATION_CLAUDE_IMPORT_MISSING"
 ]);
 var RECOGNIZED_RUNTIME_IDS = Object.freeze([
@@ -59,158 +59,8 @@ var DEFAULT_CORE_RESOURCE_LIMITS = Object.freeze({
 	maxTotalBytesRead: 134217728
 });
 //#endregion
-//#region src/format-validation/index.ts
-var STABLE_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
-var VARIABLE_ID_PATTERN = /^[A-Z][A-Z0-9_]*$/u;
-var WINDOWS_RESERVED_ID_PATTERN = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])$/u;
-var LINE_BREAK_CHARACTERS = [
-	"\n",
-	"\r",
-	"…",
-	"\u2028",
-	"\u2029"
-];
-var UNSUPPORTED_GLOB_PATTERN = /[!?[\]{}]/u;
-var hasLineBreak = (value) => {
-	return LINE_BREAK_CHARACTERS.some((lineBreak) => value.includes(lineBreak));
-};
-/** Determines whether a code point belongs to the Repository Format version 1 whitespace set. */
-var isRepositoryFormatWhitespace = (codePoint) => {
-	return codePoint >= 9 && codePoint <= 13 || codePoint === 32 || codePoint === 133 || codePoint === 160 || codePoint === 5760 || codePoint >= 8192 && codePoint <= 8202 || codePoint === 8232 || codePoint === 8233 || codePoint === 8239 || codePoint === 8287 || codePoint === 12288;
-};
-/** Compares strings by exact Unicode code-point order without locale behavior. */
-var compareExactStrings = (left, right) => {
-	const leftScalars = left[Symbol.iterator]();
-	const rightScalars = right[Symbol.iterator]();
-	while (true) {
-		const leftScalar = leftScalars.next();
-		const rightScalar = rightScalars.next();
-		if (leftScalar.done === true) return rightScalar.done === true ? 0 : -1;
-		if (rightScalar.done === true) return 1;
-		const leftCodePoint = leftScalar.value.codePointAt(0) ?? 0;
-		const rightCodePoint = rightScalar.value.codePointAt(0) ?? 0;
-		if (leftCodePoint !== rightCodePoint) return leftCodePoint < rightCodePoint ? -1 : 1;
-	}
-};
-/** Counts Unicode scalar values in valid JavaScript text. */
-var countUnicodeScalars = (value) => {
-	const scalars = value[Symbol.iterator]();
-	let count = 0;
-	while (scalars.next().done !== true) count += 1;
-	return count;
-};
-/** Determines whether a value contains at least one non-whitespace scalar. */
-var hasNonWhitespace = (value) => {
-	for (const scalar of value) if (!isRepositoryFormatWhitespace(scalar.codePointAt(0) ?? 0)) return true;
-	return false;
-};
-/** Determines whether a value begins or ends with version 1 whitespace. */
-var hasSurroundingWhitespace = (value) => {
-	const firstCodePoint = value.codePointAt(0);
-	const lastCodePoint = value.codePointAt(value.length - 1);
-	return firstCodePoint !== void 0 && isRepositoryFormatWhitespace(firstCodePoint) || lastCodePoint !== void 0 && isRepositoryFormatWhitespace(lastCodePoint);
-};
-/** Removes only Repository Format version 1 whitespace from both edges. */
-var trimRepositoryFormatWhitespace = (value) => {
-	let start = 0;
-	let end = value.length;
-	while (start < end) {
-		const codePoint = value.codePointAt(start);
-		if (codePoint === void 0 || !isRepositoryFormatWhitespace(codePoint)) break;
-		start += codePoint > 65535 ? 2 : 1;
-	}
-	while (end > start) {
-		const codePoint = value.codePointAt(end - 1);
-		if (codePoint === void 0 || !isRepositoryFormatWhitespace(codePoint)) break;
-		end -= 1;
-	}
-	return value.slice(start, end);
-};
-/** Determines whether a string is non-empty and contains no line break. */
-var isNonEmptySingleLine = (value) => {
-	return value.length > 0 && !hasLineBreak(value);
-};
-/** Determines whether a value satisfies stable moldea ID syntax. */
-var isStableId = (value) => {
-	return value.length <= 64 && STABLE_ID_PATTERN.test(value);
-};
-/** Determines whether an otherwise valid stable ID is filesystem-reserved. */
-var isReservedId = (value) => WINDOWS_RESERVED_ID_PATTERN.test(value);
-/** Determines whether a value satisfies runtime-variable ID syntax. */
-var isVariableId = (value) => {
-	return value.length <= 64 && VARIABLE_ID_PATTERN.test(value);
-};
-/** Determines whether a parsed capability description satisfies version 1 limits. */
-var isCapabilityDescription = (value) => {
-	const scalarLength = countUnicodeScalars(value);
-	return scalarLength >= 1 && scalarLength <= 1e3 && !hasSurroundingWhitespace(value) && !hasLineBreak(value) && !value.includes("\0") && !value.includes("{{") && !value.includes("}}");
-};
-/** Parses a non-root repository-format logical path without throwing. */
-var parseManifestPath = (value) => {
-	return value !== "/" && isRepositoryPath(value) ? parseRepositoryPath(value) : null;
-};
-/** Determines whether a path is the canonical manifest path. */
-var isCanonicalManifestPath = (path) => {
-	return path === "/moldea/moldea.yaml";
-};
-/** Extracts the stable millisecond ID from one canonical immediate decision path. */
-var parseDecisionIdFromPath = (path) => {
-	const match = /^\/moldea\/decisions\/(\d{13})-([a-z0-9]+(?:-[a-z0-9]+)*)\.md$/u.exec(path);
-	const id = match?.[1];
-	const slug = match?.[2];
-	return id !== void 0 && slug !== void 0 && isStableId(slug) ? id : null;
-};
-/** Determines whether a path is an allowed focused-context relationship key. */
-var isContextPath = (path, allowProject) => {
-	if (allowProject && path === "/moldea/project.md") return true;
-	return path.startsWith("/moldea/context/") && path.endsWith(".md");
-};
-/** Determines whether a path has the canonical immediate decision filename shape. */
-var isDecisionPath = (path) => {
-	return parseDecisionIdFromPath(path) !== null;
-};
-/** Determines whether a path is canonical runtime guidance. */
-var isRuntimeGuidancePath = (path) => {
-	return path.startsWith("/moldea/runtimes/") && path.endsWith(".md");
-};
-/** Determines whether a mirror path is outside canonical moldea content. */
-var isMirrorPath = (path) => {
-	return path !== "/moldea" && !path.startsWith("/moldea/");
-};
-/** Determines whether an impact path contains prohibited glob metacharacters. */
-var hasUnsupportedGlobMetacharacter = (value) => {
-	return UNSUPPORTED_GLOB_PATTERN.test(value);
-};
-/** Determines whether a string satisfies the version 1 simple-glob grammar. */
-var isSimpleGlob = (value) => {
-	if (hasUnsupportedGlobMetacharacter(value) || value.includes("***")) return false;
-	if (value.slice(1).split("/").some((segment) => segment.includes("**") && segment !== "**")) return false;
-	return value.includes("*") && isRepositoryPath(value.replaceAll("*", "x"));
-};
-/** Determines whether a repository-reference symbol has the common safe shape. */
-var isRepositorySymbol = (value) => {
-	return isNonEmptySingleLine(value) && !value.includes("\0");
-};
-/** Determines whether a canonical moldea reference incorrectly carries a symbol. */
-var isCanonicalMoldeaPath = (path) => {
-	return path === "/moldea" || path.startsWith("/moldea/");
-};
-//#endregion
 //#region src/immutable/index.ts
 /**
-* Recursively freezes a Core-owned value without cloning it.
-* @param value The detached acyclic value whose already-frozen objects are deeply frozen.
-* @returns The same value with every mutable reachable object frozen.
-*/
-var freezeRecursively = (value) => {
-	if (typeof value !== "object" || value === null || Object.isFrozen(value)) return value;
-	for (const key of Reflect.ownKeys(value)) {
-		const child = value[key];
-		freezeRecursively(child);
-	}
-	return Object.freeze(value);
-};
-/**
 * Creates a record that cannot collide with prototype-chain properties.
 * @param entries The own string-keyed entries to assign.
 * @returns A mutable null-prototype record for later normalization and freezing.
@@ -284,7 +134,7 @@ var CORE_DIAGNOSTIC_MESSAGES = {
 	MOLDEA_INTEGRATION_BLOCK_MISSING: "The AGENTS.md moldea block is missing.",
 	MOLDEA_INTEGRATION_SKILL_MISSING: "The skill installation referenced by the AGENTS.md moldea block was not found.",
 	MOLDEA_INTEGRATION_BLOCK_STALE: "The AGENTS.md moldea block differs from its skill installation.",
-	MOLDEA_INTEGRATION_UNVERIFIED: "The instruction file's moldea integration cannot be verified.",
+	MOLDEA_INTEGRATION_LINK_UNRESOLVED: "This instruction file's link doesn't lead to a file in the repository.",
 	MOLDEA_INTEGRATION_CLAUDE_IMPORT_MISSING: "Claude Code instructions do not load AGENTS.md.",
 	MOLDEA_IMPACT_PATTERN_UNMATCHED: "The impact pattern matches no files.",
 	MOLDEA_ACCEPTANCE_UNMATCHED: "The warning acceptance matches no reported warning.",
@@ -347,7 +197,7 @@ var registerCoreDiagnosticCandidates = (limits, amount, operation, fallbackCount
 };
 var compareNullableStrings = (left, right) => {
 	if (left === null) return right === null ? 0 : -1;
-	return right === null ? 1 : compareExactStrings(left, right);
+	return right === null ? 1 : compareCodePoints(left, right);
 };
 /**
 * Normalizes trusted JSON-scalar diagnostic metadata.
@@ -355,7 +205,8 @@ var compareNullableStrings = (left, right) => {
 * @returns A frozen null-prototype record with canonical key order.
 */
 var normalizeDiagnosticDetails = (details) => {
-	return freezeRecursively(createNullPrototypeRecord(Object.entries(details ?? {}).sort(([left], [right]) => compareExactStrings(left, right)).map(([key, value]) => [key, typeof value === "number" && Object.is(value, -0) ? 0 : value])));
+	const entries = Object.entries(details ?? {}).sort(([left], [right]) => compareCodePoints(left, right)).map(([key, value]) => [key, typeof value === "number" && Object.is(value, -0) ? 0 : value]);
+	return deepFreeze(createNullPrototypeRecord(entries));
 };
 /**
 * Normalizes a trusted diagnostic entity into canonical key order.
@@ -364,14 +215,15 @@ var normalizeDiagnosticDetails = (details) => {
 */
 var normalizeDiagnosticEntity = (entity) => {
 	if (entity === void 0 || entity === null) return null;
-	return freezeRecursively(createNullPrototypeRecord(ENTITY_KEYS.flatMap((key) => {
+	const entries = ENTITY_KEYS.flatMap((key) => {
 		const value = entity[key];
 		return value === void 0 ? [] : [[key, value]];
-	})));
+	});
+	return deepFreeze(createNullPrototypeRecord(entries));
 };
 /** Serializes unordered diagnostic details with explicit exact-code-point key ordering. */
 var serializeDiagnosticDetails = (details) => {
-	const entries = Object.entries(details).sort(([left], [right]) => compareExactStrings(left, right));
+	const entries = Object.entries(details).sort(([left], [right]) => compareCodePoints(left, right));
 	return JSON.stringify(entries);
 };
 var serializeDiagnostic = (diagnostic) => {
@@ -411,7 +263,7 @@ var readEntityValue = (entity, key) => {
 	return entity?.[key] ?? "";
 };
 var compareDiagnostics = (left, right) => {
-	return compareNullableStrings(left.path, right.path) || compareRanges(left.range, right.range) || compareNullableStrings(left.pointer, right.pointer) || compareExactStrings(left.source, right.source) || compareExactStrings(left.code, right.code) || compareExactStrings(left.severity, right.severity) || compareExactStrings(left.severity === "warning" ? JSON.stringify([
+	return compareNullableStrings(left.path, right.path) || compareRanges(left.range, right.range) || compareNullableStrings(left.pointer, right.pointer) || compareCodePoints(left.source, right.source) || compareCodePoints(left.code, right.code) || compareCodePoints(left.severity, right.severity) || compareCodePoints(left.severity === "warning" ? JSON.stringify([
 		left.subject,
 		left.qualifier,
 		left.accepted ?? false,
@@ -421,7 +273,7 @@ var compareDiagnostics = (left, right) => {
 		right.qualifier,
 		right.accepted ?? false,
 		right.reason ?? null
-	]) : "") || compareExactStrings(readEntityValue(left.entity, "agentId"), readEntityValue(right.entity, "agentId")) || compareExactStrings(readEntityValue(left.entity, "capabilityKind"), readEntityValue(right.entity, "capabilityKind")) || compareExactStrings(readEntityValue(left.entity, "capabilityId"), readEntityValue(right.entity, "capabilityId")) || compareExactStrings(readEntityValue(left.entity, "decisionId"), readEntityValue(right.entity, "decisionId")) || compareExactStrings(readEntityValue(left.entity, "variableId"), readEntityValue(right.entity, "variableId")) || compareExactStrings(readEntityValue(left.entity, "contextPath"), readEntityValue(right.entity, "contextPath")) || compareExactStrings(readEntityValue(left.entity, "integrationPath"), readEntityValue(right.entity, "integrationPath")) || compareExactStrings(serializeDiagnosticDetails(left.details), serializeDiagnosticDetails(right.details)) || compareExactStrings(left.message, right.message);
+	]) : "") || compareCodePoints(readEntityValue(left.entity, "agentId"), readEntityValue(right.entity, "agentId")) || compareCodePoints(readEntityValue(left.entity, "capabilityKind"), readEntityValue(right.entity, "capabilityKind")) || compareCodePoints(readEntityValue(left.entity, "capabilityId"), readEntityValue(right.entity, "capabilityId")) || compareCodePoints(readEntityValue(left.entity, "decisionId"), readEntityValue(right.entity, "decisionId")) || compareCodePoints(readEntityValue(left.entity, "variableId"), readEntityValue(right.entity, "variableId")) || compareCodePoints(readEntityValue(left.entity, "contextPath"), readEntityValue(right.entity, "contextPath")) || compareCodePoints(readEntityValue(left.entity, "integrationPath"), readEntityValue(right.entity, "integrationPath")) || compareCodePoints(serializeDiagnosticDetails(left.details), serializeDiagnosticDetails(right.details)) || compareCodePoints(left.message, right.message);
 };
 /** Classifies every catalog code by its documented validation responsibility. */
 var getDiagnosticGroup = (code) => {
@@ -452,9 +304,9 @@ var createCoreDiagnostic = (input) => {
 		group: getDiagnosticGroup(input.code),
 		source: "core"
 	};
-	if (input.code === "MOLDEA_IMPACT_PATTERN_UNMATCHED" || input.code === "MOLDEA_ACCEPTANCE_UNMATCHED" || input.code === "MOLDEA_INTEGRATION_BLOCK_MISSING" || input.code === "MOLDEA_INTEGRATION_SKILL_MISSING" || input.code === "MOLDEA_INTEGRATION_BLOCK_STALE" || input.code === "MOLDEA_INTEGRATION_UNVERIFIED" || input.code === "MOLDEA_INTEGRATION_CLAUDE_IMPORT_MISSING") {
+	if (input.code === "MOLDEA_IMPACT_PATTERN_UNMATCHED" || input.code === "MOLDEA_ACCEPTANCE_UNMATCHED" || input.code === "MOLDEA_INTEGRATION_BLOCK_MISSING" || input.code === "MOLDEA_INTEGRATION_SKILL_MISSING" || input.code === "MOLDEA_INTEGRATION_BLOCK_STALE" || input.code === "MOLDEA_INTEGRATION_LINK_UNRESOLVED" || input.code === "MOLDEA_INTEGRATION_CLAUDE_IMPORT_MISSING") {
 		if (input.subject === void 0) throw new TypeError("A warning subject is required.");
-		return freezeRecursively({
+		return deepFreeze({
 			...base,
 			code: input.code,
 			severity: "warning",
@@ -463,7 +315,7 @@ var createCoreDiagnostic = (input) => {
 			acceptable: ACCEPTABLE_WARNING_CODES.some((code) => code === input.code)
 		});
 	}
-	return freezeRecursively({
+	return deepFreeze({
 		...base,
 		code: input.code,
 		severity: "error"
@@ -481,7 +333,7 @@ var normalizeDiagnostics = (candidates) => {
 		if (diagnostics.has(key)) continue;
 		diagnostics.set(key, diagnostic);
 	}
-	return freezeRecursively([...diagnostics.values()].sort(compareDiagnostics));
+	return deepFreeze([...diagnostics.values()].sort(compareDiagnostics));
 };
 /** Counts the complete normalized diagnostic result by severity once. */
 var countDiagnosticsBySeverity = (diagnostics) => {
@@ -550,9 +402,6 @@ var RESOURCE_LIMIT_KEYS = [
 	"maxCoverage",
 	"maxAcceptedWarnings"
 ];
-var isRecord = (value) => {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-};
 /**
 * Validates, copies, fills, and freezes all configured resource limits.
 * @param candidate The untrusted optional limit overrides.
@@ -562,7 +411,7 @@ var isRecord = (value) => {
 */
 var normalizeLimits = (candidate) => {
 	if (candidate === void 0) return DEFAULT_CORE_RESOURCE_LIMITS;
-	if (!isRecord(candidate)) throw new CoreConfigurationException({
+	if (!isObjectValid(candidate, true)) throw new CoreConfigurationException({
 		code: "INVALID_RESOURCE_LIMIT",
 		operation: "create-core"
 	});
@@ -581,7 +430,7 @@ var normalizeLimits = (candidate) => {
 		});
 		normalized[key] = value;
 	}
-	return freezeRecursively(normalized);
+	return deepFreeze(normalized);
 };
 /**
 * Validates and snapshots caller-owned Core resource limits.
@@ -590,13 +439,13 @@ var normalizeLimits = (candidate) => {
 * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.
 */
 var normalizeCoreOptions = (options) => {
-	if (options !== void 0 && (!isRecord(options) || Reflect.ownKeys(options).some((key) => key !== "limits"))) throw new CoreConfigurationException({
+	if (options !== void 0 && (!isObjectValid(options, true) || Reflect.ownKeys(options).some((key) => key !== "limits"))) throw new CoreConfigurationException({
 		code: "INVALID_RESOURCE_LIMIT",
 		operation: "create-core"
 	});
-	return freezeRecursively({ limits: normalizeLimits(options?.["limits"]) });
+	return deepFreeze({ limits: normalizeLimits(options?.["limits"]) });
 };
 //#endregion
-export { DEFAULT_CORE_RESOURCE_LIMITS as A, isSimpleGlob as C, parseManifestPath as D, parseDecisionIdFromPath as E, SUPPORTED_REPOSITORY_FORMAT_VERSIONS as M, trimRepositoryFormatWhitespace as O, isRuntimeGuidancePath as S, isVariableId as T, isDecisionPath as _, escapeJsonPointerSegment as a, isRepositorySymbol as b, freezeRecursively as c, hasNonWhitespace as d, hasUnsupportedGlobMetacharacter as f, isContextPath as g, isCapabilityDescription as h, createCoreDiagnosticCollector as i, RECOGNIZED_RUNTIME_IDS as j, ACCEPTABLE_WARNING_CODES as k, compareExactStrings as l, isCanonicalMoldeaPath as m, normalizeCoreOptions as n, normalizeDiagnostics as o, isCanonicalManifestPath as p, countDiagnosticsBySeverity as r, createNullPrototypeRecord as s, createCoreOperationOptionsSnapshot as t, countUnicodeScalars as u, isMirrorPath as v, isStableId as w, isReservedId as x, isNonEmptySingleLine as y };
+export { escapeJsonPointerSegment as a, ACCEPTABLE_WARNING_CODES as c, SUPPORTED_REPOSITORY_FORMAT_VERSIONS as d, createCoreDiagnosticCollector as i, DEFAULT_CORE_RESOURCE_LIMITS as l, normalizeCoreOptions as n, normalizeDiagnostics as o, countDiagnosticsBySeverity as r, createNullPrototypeRecord as s, createCoreOperationOptionsSnapshot as t, RECOGNIZED_RUNTIME_IDS as u };
 
-//# sourceMappingURL=options-BVF3DQHm.js.map
+//# sourceMappingURL=options-C5360E_N.js.map

package/dist/chunks/options-C5360E_N.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-C5360E_N.js","names":[],"sources":["../../src/constants/index.ts","../../src/immutable/index.ts","../../src/diagnostic-utilities/index.ts","../../src/options/index.ts"],"sourcesContent":["import type { ICoreResourceLimits } from '../contracts/index.js';\nimport type { IRepositoryFormatVersion } from '../format/index.js';\n\n// warning codes whose findings may be explicitly accepted in the manifest\nexport const ACCEPTABLE_WARNING_CODES = Object.freeze([\n  'MOLDEA_IMPACT_PATTERN_UNMATCHED',\n  'MOLDEA_INTEGRATION_BLOCK_MISSING',\n  'MOLDEA_INTEGRATION_SKILL_MISSING',\n  'MOLDEA_INTEGRATION_BLOCK_STALE',\n  'MOLDEA_INTEGRATION_LINK_UNRESOLVED',\n  'MOLDEA_INTEGRATION_CLAUDE_IMPORT_MISSING',\n] as const);\n\n// runtime labels selecting guidance without asserting SDK compatibility\nexport const RECOGNIZED_RUNTIME_IDS = Object.freeze([\n  'amazon-bedrock',\n  'anthropic',\n  'cerebras',\n  'claude-agent-sdk',\n  'cloudflare-agents',\n  'cohere',\n  'convex-agent',\n  'cursor-sdk',\n  'custom',\n  'deep-agents',\n  'eve',\n  'genkit',\n  'github-copilot-sdk',\n  'google-adk',\n  'google-genai',\n  'groq',\n  'hugging-face',\n  'ibm-watsonx-ai',\n  'langchain',\n  'langgraph',\n  'livekit-agents',\n  'mastra',\n  'microsoft-foundry',\n  'mistral',\n  'node-llama-cpp',\n  'ollama',\n  'openai',\n  'openai-agents-sdk',\n  'openai-codex',\n  'opencode-sdk',\n  'openrouter',\n  'pi-agent',\n  'strands-agents',\n  'tanstack-ai',\n  'vercel-ai-sdk',\n  'voltagent',\n] as const);\n\n// repository-format major versions interpreted by this Core release\nexport const SUPPORTED_REPOSITORY_FORMAT_VERSIONS: readonly IRepositoryFormatVersion[] =\n  Object.freeze([1]);\n\n// default safety budgets applied independently to each Core operation\nexport const DEFAULT_CORE_RESOURCE_LIMITS: ICoreResourceLimits = Object.freeze({\n  maxDiagnostics: 10_000,\n  maxEntries: 100_000,\n  maxCoverage: 10_000,\n  maxAcceptedWarnings: 256,\n  maxFileBytes: 8_388_608,\n  maxManifestBytes: 2_097_152,\n  maxRetainedBytes: 536_870_912,\n  maxTotalBytesRead: 134_217_728,\n});\n","/**\n * Creates a record that cannot collide with prototype-chain properties.\n * @param entries The own string-keyed entries to assign.\n * @returns A mutable null-prototype record for later normalization and freezing.\n */\nexport const createNullPrototypeRecord = <Value>(\n  entries: Iterable<readonly [string, Value]>,\n): Record<string, Value> => {\n  const record = Object.create(null) as Record<string, Value>;\n\n  for (const [key, value] of entries) {\n    record[key] = value;\n  }\n\n  return record;\n};\n","import { compareCodePoints, deepFreeze } from 'jg-utilities';\n\nimport type { IRepositoryPath } from '@moldea.ai/repository';\n\nimport { ACCEPTABLE_WARNING_CODES } from '../constants/index.js';\nimport type { ICoreResourceLimits } from '../contracts/index.js';\nimport type {\n  ICoreDiagnostic,\n  ICoreDiagnosticCode,\n  IDiagnostic,\n  IDiagnosticDetails,\n  IDiagnosticEntity,\n  ISourceRange,\n} from '../diagnostics/index.js';\nimport { CoreOperationException, type ICoreOperation } from '../exceptions/index.js';\nimport { createNullPrototypeRecord } from '../immutable/index.js';\n\nconst CORE_DIAGNOSTIC_MESSAGES: Record<ICoreDiagnosticCode, string> = {\n  MOLDEA_AGENT_DESCRIPTION_INVALID: 'The agent description is invalid.',\n  MOLDEA_AGENT_DESCRIPTION_MISSING: 'The agent description is missing.',\n  MOLDEA_AGENT_DIRECTORY_MISSING: 'The registered agent directory is missing.',\n  MOLDEA_AGENT_DIRECTORY_UNREGISTERED: 'The agent directory is not registered.',\n  MOLDEA_AGENT_HANDOFF_DESCRIPTION_INVALID: 'The agent handoff description is invalid.',\n  MOLDEA_AGENT_IDENTITY_INVALID: 'The agent instruction identity is invalid.',\n  MOLDEA_AGENT_INSTRUCTION_EMPTY: 'The agent instruction is empty.',\n  MOLDEA_AGENT_INSTRUCTION_MISSING: 'The agent instruction is missing.',\n  MOLDEA_CANONICAL_ASSET_SYMLINK: 'The canonical asset is a symlink.',\n  MOLDEA_CANONICAL_PATH_UNRECOGNIZED: 'The canonical path is unrecognized.',\n  MOLDEA_CAPABILITY_DESCRIPTION_INVALID: 'The capability description is invalid.',\n  MOLDEA_CAPABILITY_DESCRIPTION_MISSING: 'The capability description is missing.',\n  MOLDEA_CONTEXT_FILE_EMPTY: 'The focused context file is empty.',\n  MOLDEA_CONTEXT_PATH_INVALID: 'The context relationship path is invalid.',\n  MOLDEA_CONTEXT_RELATIONSHIP_EMPTY: 'The declared relationship has no bindings or impact paths.',\n  MOLDEA_DECISION_BODY_EMPTY: 'The decision Markdown body is empty.',\n  MOLDEA_DECISION_CREATED_AT_INVALID: 'The decision createdAt value is invalid.',\n  MOLDEA_DECISION_FILENAME_INVALID: 'The decision path or filename is invalid.',\n  MOLDEA_DECISION_FRONTMATTER_INVALID: 'The decision frontmatter is invalid.',\n  MOLDEA_DECISION_FRONTMATTER_MISSING: 'The decision frontmatter or its delimiters are missing.',\n  MOLDEA_DECISION_ID_DUPLICATE: 'The decision ID is duplicated.',\n  MOLDEA_DECISION_PROPERTY_UNKNOWN: 'The decision frontmatter contains an unknown property.',\n  MOLDEA_DECISION_REFERENCE_MISSING: 'The referenced decision does not exist.',\n  MOLDEA_DECISION_RELATIONSHIP_INACTIVE: 'The referenced decision is not accepted.',\n  MOLDEA_DECISION_SELF_SUPERSESSION: 'The decision supersedes itself.',\n  MOLDEA_DECISION_STATUS_INVALID: 'The decision status is invalid.',\n  MOLDEA_DECISION_SUPERSEDED_ORPHAN:\n    'The superseded decision has no active supersession relationship.',\n  MOLDEA_DECISION_SUPERSESSION_CYCLE: 'The decision supersession graph contains a cycle.',\n  MOLDEA_DECISION_SUPERSESSION_STATUS_INVALID:\n    'The decision supersession relationship has inconsistent statuses.',\n  MOLDEA_DECISION_TIMESTAMP_MISMATCH:\n    'The decision filename timestamp and createdAt value do not match.',\n  MOLDEA_ENTRY_TYPE_INVALID: 'The repository entry type is invalid.',\n  MOLDEA_RUNTIME_ID_INVALID: 'The runtime ID is invalid.',\n  MOLDEA_GLOB_INVALID: 'The impact pattern is invalid.',\n  MOLDEA_ID_DUPLICATE: 'An ID is duplicated within its required scope.',\n  MOLDEA_ID_INVALID: 'The ID is invalid.',\n  MOLDEA_ID_RESERVED: 'The ID uses a reserved filesystem name.',\n  MOLDEA_IMPACT_PATH_MISSING: 'The exact impact path does not exist.',\n  MOLDEA_IMPACT_PATH_NOT_FILE: 'The exact impact path is not a regular file.',\n  MOLDEA_MANIFEST_MISSING: 'The project manifest is missing.',\n  MOLDEA_MANIFEST_PATH_INVALID: 'The manifest path is not the canonical manifest path.',\n  MOLDEA_MANIFEST_PROPERTY_UNKNOWN: 'The manifest contains an unknown property.',\n  MOLDEA_MANIFEST_ROOT_INVALID: 'The manifest root is not a mapping.',\n  MOLDEA_MANIFEST_VALUE_INVALID: 'The manifest value is invalid.',\n  MOLDEA_MANIFEST_VERSION_INVALID: 'The manifest version is not a valid integer major version.',\n  MOLDEA_MANIFEST_VERSION_MISSING: 'The manifest version is missing.',\n  MOLDEA_MANIFEST_VERSION_UNSUPPORTED: 'The manifest version is unsupported.',\n  MOLDEA_MIRROR_PATH_DUPLICATE: 'The mirror path is assigned more than once.',\n  MOLDEA_MIRROR_PATH_INSIDE_MOLDEA: 'The mirror path is inside /moldea.',\n  MOLDEA_MIRROR_PATH_INVALID: 'The mirror path is invalid.',\n  MOLDEA_MIRROR_MISSING: 'The declared mirror does not exist.',\n  MOLDEA_MIRROR_NOT_FILE: 'The declared mirror is not a regular file.',\n  MOLDEA_MIRROR_STALE: 'The declared mirror differs from its canonical instruction.',\n  MOLDEA_MIRROR_SYMLINK: 'The declared mirror is a symlink.',\n  MOLDEA_PATH_DUPLICATE: 'The path is duplicated.',\n  MOLDEA_PATH_INVALID: 'The manifest logical path is invalid.',\n  MOLDEA_PATTERN_DUPLICATE: 'The impact pattern is duplicated.',\n  MOLDEA_PROJECT_FILE_EMPTY: 'The project file is empty.',\n  MOLDEA_PROJECT_FILE_MISSING: 'The project file is missing.',\n  MOLDEA_INTEGRATION_BLOCK_MISSING: 'The AGENTS.md moldea block is missing.',\n  MOLDEA_INTEGRATION_SKILL_MISSING:\n    'The skill installation referenced by the AGENTS.md moldea block was not found.',\n  MOLDEA_INTEGRATION_BLOCK_STALE: 'The AGENTS.md moldea block differs from its skill installation.',\n  MOLDEA_INTEGRATION_LINK_UNRESOLVED:\n    \"This instruction file's link doesn't lead to a file in the repository.\",\n  MOLDEA_INTEGRATION_CLAUDE_IMPORT_MISSING: 'Claude Code instructions do not load AGENTS.md.',\n  MOLDEA_IMPACT_PATTERN_UNMATCHED: 'The impact pattern matches no files.',\n  MOLDEA_ACCEPTANCE_UNMATCHED: 'The warning acceptance matches no reported warning.',\n  MOLDEA_REFERENCE_EXPORT_MISSING: 'The referenced export is missing.',\n  MOLDEA_REFERENCE_MISSING: 'The referenced repository path does not exist.',\n  MOLDEA_REFERENCE_NOT_FILE: 'The referenced repository path is not a regular file.',\n  MOLDEA_REFERENCE_SYMLINK: 'The referenced repository path is a symlink.',\n  MOLDEA_RUNTIME_GUIDANCE_EMPTY: 'The runtime guidance is empty.',\n  MOLDEA_RUNTIME_GUIDANCE_MISSING: 'The referenced runtime guidance does not exist.',\n  MOLDEA_SKILL_IMPLEMENTATION_MISSING: 'The registered skill implementation is missing.',\n  MOLDEA_SYMBOL_FORBIDDEN: 'A canonical moldea reference must not include a symbol.',\n  MOLDEA_SYMBOL_INVALID: 'The repository-reference symbol is invalid.',\n  MOLDEA_TEXT_EMPTY: 'The required text document is empty.',\n  MOLDEA_TEXT_INVALID_UNICODE:\n    'The text document contains an invalid Unicode scalar representation.',\n  MOLDEA_TEXT_INVALID_UTF8: 'The text document is not valid UTF-8.',\n  MOLDEA_TEXT_NUL_FORBIDDEN: 'The text document contains a forbidden NUL character.',\n  MOLDEA_TOOL_IMPLEMENTATION_MISSING: 'The registered tool implementation is missing.',\n  MOLDEA_VARIABLE_ID_INVALID: 'The runtime-variable ID is invalid.',\n  MOLDEA_VARIABLE_PLACEHOLDER_MALFORMED:\n    'The agent instruction contains a malformed runtime-variable placeholder.',\n  MOLDEA_VARIABLE_PROVIDER_UNDECLARED:\n    'A variable-provider binding exists for an undeclared variable.',\n  MOLDEA_VARIABLE_UNDECLARED: 'The agent instruction references an undeclared runtime variable.',\n  MOLDEA_VARIABLE_UNUSED: 'The declared runtime variable is unused by the agent instruction.',\n  MOLDEA_YAML_DUPLICATE_KEY: 'The YAML document contains a duplicate mapping key.',\n  MOLDEA_YAML_FEATURE_UNSUPPORTED: 'The YAML document uses an unsupported feature.',\n  MOLDEA_YAML_MALFORMED: 'The YAML document is malformed.',\n  MOLDEA_YAML_MULTIPLE_DOCUMENTS: 'The YAML stream contains more than one document.',\n};\n\nconst ENTITY_KEYS = [\n  'agentId',\n  'capabilityKind',\n  'capabilityId',\n  'decisionId',\n  'variableId',\n  'contextPath',\n  'integrationPath',\n] as const satisfies readonly (keyof IDiagnosticEntity)[];\n\n// private normalized diagnostic construction contracts\nexport interface ICoreDiagnosticInput {\n  readonly code: ICoreDiagnosticCode;\n  readonly details?: Readonly<Record<string, string | number | boolean | null>>;\n  readonly entity?: IDiagnosticEntity | null;\n  readonly path: IRepositoryPath | null;\n  readonly pointer?: string | null;\n  readonly range?: ISourceRange | null;\n  readonly subject?: IRepositoryPath;\n  readonly qualifier?: string | null;\n}\n\nexport interface ICoreDiagnosticCollector {\n  add(input: ICoreDiagnosticInput): void;\n  merge(input: ICoreDiagnosticInput): void;\n  finalize(): readonly ICoreDiagnostic[];\n  readonly size: number;\n}\n\ninterface ICoreDiagnosticBudget {\n  count: number;\n}\n\nconst CORE_DIAGNOSTIC_BUDGET = Symbol('core-diagnostic-budget');\n\ntype ICoreOperationResourceLimits = ICoreResourceLimits & {\n  readonly [CORE_DIAGNOSTIC_BUDGET]?: ICoreDiagnosticBudget;\n};\n\n/** Creates a detached limits view with one diagnostic budget for a complete Core operation. */\nexport const createCoreOperationResourceLimits = (\n  limits: ICoreResourceLimits,\n): ICoreResourceLimits => {\n  const operationLimits = limits as ICoreOperationResourceLimits;\n\n  if (operationLimits[CORE_DIAGNOSTIC_BUDGET] !== undefined) {\n    return limits;\n  }\n\n  return Object.freeze({\n    ...limits,\n    [CORE_DIAGNOSTIC_BUDGET]: { count: 0 },\n  });\n};\n\n/** Registers raw diagnostics against the shared operation budget before normalization. */\nexport const registerCoreDiagnosticCandidates = (\n  limits: ICoreResourceLimits,\n  amount: number,\n  operation: ICoreOperation,\n  fallbackCount = 0,\n): number => {\n  const budget = (limits as ICoreOperationResourceLimits)[CORE_DIAGNOSTIC_BUDGET];\n  const currentCount = budget?.count ?? fallbackCount;\n\n  if (amount > limits.maxDiagnostics - currentCount) {\n    throw new CoreOperationException({\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n      limit: 'maxDiagnostics',\n      limitMaximum: limits.maxDiagnostics,\n      nextAction: 'reduce-input-or-increase-limit',\n      observedUsage: currentCount + amount,\n      operation,\n    });\n  }\n\n  if (budget !== undefined) {\n    budget.count += amount;\n  }\n\n  return fallbackCount + amount;\n};\n\nconst compareNullableStrings = (left: string | null, right: string | null): number => {\n  if (left === null) {\n    return right === null ? 0 : -1;\n  }\n\n  return right === null ? 1 : compareCodePoints(left, right);\n};\n\n/**\n * Normalizes trusted JSON-scalar diagnostic metadata.\n * @param details The optional detached metadata record.\n * @returns A frozen null-prototype record with canonical key order.\n */\nexport const normalizeDiagnosticDetails = (\n  details: Readonly<Record<string, string | number | boolean | null>> | undefined,\n): IDiagnosticDetails => {\n  const entries = Object.entries(details ?? {})\n    .sort(([left], [right]) => compareCodePoints(left, right))\n    .map(\n      ([key, value]) =>\n        [key, typeof value === 'number' && Object.is(value, -0) ? 0 : value] as const,\n    );\n\n  return deepFreeze(createNullPrototypeRecord(entries));\n};\n\n/**\n * Normalizes a trusted diagnostic entity into canonical key order.\n * @param entity The optional diagnostic entity.\n * @returns The frozen normalized entity or `null`.\n */\nexport const normalizeDiagnosticEntity = (\n  entity: IDiagnosticEntity | null | undefined,\n): IDiagnosticEntity | null => {\n  if (entity === undefined || entity === null) {\n    return null;\n  }\n\n  const entries = ENTITY_KEYS.flatMap((key) => {\n    const value = entity[key];\n    return value === undefined ? [] : ([[key, value]] as const);\n  });\n\n  return deepFreeze(createNullPrototypeRecord(entries) as IDiagnosticEntity);\n};\n\n/** Serializes unordered diagnostic details with explicit exact-code-point key ordering. */\nexport const serializeDiagnosticDetails = (details: IDiagnosticDetails): string => {\n  const entries = Object.entries(details).sort(([left], [right]) => compareCodePoints(left, right));\n\n  return JSON.stringify(entries);\n};\n\nconst serializeDiagnostic = (diagnostic: IDiagnostic): string => {\n  const entity =\n    diagnostic.entity === null\n      ? null\n      : ENTITY_KEYS.map((key) => [key, diagnostic.entity?.[key] ?? null]);\n  const range =\n    diagnostic.range === null\n      ? null\n      : [\n          diagnostic.range.start.line,\n          diagnostic.range.start.column,\n          diagnostic.range.start.offset,\n          diagnostic.range.end.line,\n          diagnostic.range.end.column,\n          diagnostic.range.end.offset,\n        ];\n\n  return JSON.stringify([\n    diagnostic.code,\n    diagnostic.severity,\n    diagnostic.severity === 'warning'\n      ? [\n          diagnostic.subject,\n          diagnostic.qualifier,\n          diagnostic.accepted ?? false,\n          diagnostic.reason ?? null,\n        ]\n      : null,\n    serializeDiagnosticDetails(diagnostic.details),\n    entity,\n    diagnostic.message,\n    diagnostic.path,\n    diagnostic.pointer,\n    range,\n    diagnostic.source,\n  ]);\n};\n\nconst compareRanges = (left: ISourceRange | null, right: ISourceRange | null): number => {\n  if (left === null) {\n    return right === null ? 0 : -1;\n  }\n\n  if (right === null) {\n    return 1;\n  }\n\n  return (\n    left.start.line - right.start.line ||\n    left.start.column - right.start.column ||\n    left.start.offset - right.start.offset ||\n    left.end.line - right.end.line ||\n    left.end.column - right.end.column ||\n    left.end.offset - right.end.offset\n  );\n};\n\nconst readEntityValue = (\n  entity: IDiagnosticEntity | null,\n  key: keyof IDiagnosticEntity,\n): string => {\n  return entity?.[key] ?? '';\n};\n\nconst compareDiagnostics = (left: IDiagnostic, right: IDiagnostic): number => {\n  return (\n    compareNullableStrings(left.path, right.path) ||\n    compareRanges(left.range, right.range) ||\n    compareNullableStrings(left.pointer, right.pointer) ||\n    compareCodePoints(left.source, right.source) ||\n    compareCodePoints(left.code, right.code) ||\n    compareCodePoints(left.severity, right.severity) ||\n    compareCodePoints(\n      left.severity === 'warning'\n        ? JSON.stringify([\n            left.subject,\n            left.qualifier,\n            left.accepted ?? false,\n            left.reason ?? null,\n          ])\n        : '',\n      right.severity === 'warning'\n        ? JSON.stringify([\n            right.subject,\n            right.qualifier,\n            right.accepted ?? false,\n            right.reason ?? null,\n          ])\n        : '',\n    ) ||\n    compareCodePoints(\n      readEntityValue(left.entity, 'agentId'),\n      readEntityValue(right.entity, 'agentId'),\n    ) ||\n    compareCodePoints(\n      readEntityValue(left.entity, 'capabilityKind'),\n      readEntityValue(right.entity, 'capabilityKind'),\n    ) ||\n    compareCodePoints(\n      readEntityValue(left.entity, 'capabilityId'),\n      readEntityValue(right.entity, 'capabilityId'),\n    ) ||\n    compareCodePoints(\n      readEntityValue(left.entity, 'decisionId'),\n      readEntityValue(right.entity, 'decisionId'),\n    ) ||\n    compareCodePoints(\n      readEntityValue(left.entity, 'variableId'),\n      readEntityValue(right.entity, 'variableId'),\n    ) ||\n    compareCodePoints(\n      readEntityValue(left.entity, 'contextPath'),\n      readEntityValue(right.entity, 'contextPath'),\n    ) ||\n    compareCodePoints(\n      readEntityValue(left.entity, 'integrationPath'),\n      readEntityValue(right.entity, 'integrationPath'),\n    ) ||\n    compareCodePoints(\n      serializeDiagnosticDetails(left.details),\n      serializeDiagnosticDetails(right.details),\n    ) ||\n    compareCodePoints(left.message, right.message)\n  );\n};\n\n/** Classifies every catalog code by its documented validation responsibility. */\nconst getDiagnosticGroup = (code: ICoreDiagnosticCode): ICoreDiagnostic['group'] => {\n  if (code.startsWith('MOLDEA_INTEGRATION_')) return 'integration';\n  if (code.startsWith('MOLDEA_MIRROR_')) return 'mirrors';\n  if (/^MOLDEA_(REFERENCE|IMPACT|SYMBOL|CONTEXT|DECISION|RUNTIME_GUIDANCE)_/.test(code))\n    return 'references';\n  if (code === 'MOLDEA_VARIABLE_ID_INVALID') return 'manifest';\n  if (/^MOLDEA_(AGENT|VARIABLE|CAPABILITY|TOOL|SKILL|RUNTIME)_/.test(code)) return 'agents';\n  if (/^MOLDEA_(MANIFEST_MISSING|PROJECT_FILE|ENTRY_TYPE|CANONICAL|TEXT)_/.test(code))\n    return 'discovery';\n  return 'manifest';\n};\n\n/**\n * Creates one normalized, immutable Core diagnostic.\n * @param input The trusted Core-owned diagnostic fields to normalize.\n * @returns A deeply immutable public diagnostic value.\n */\nexport const createCoreDiagnostic = (input: ICoreDiagnosticInput): ICoreDiagnostic => {\n  const message = CORE_DIAGNOSTIC_MESSAGES[input.code];\n\n  if (message === undefined) {\n    throw new TypeError('The requested Core diagnostic is not implemented.');\n  }\n\n  const base = {\n    code: input.code,\n    details: normalizeDiagnosticDetails(input.details),\n    entity: normalizeDiagnosticEntity(input.entity),\n    message,\n    path: input.path,\n    pointer: input.pointer ?? null,\n    range: input.range ?? null,\n    group: getDiagnosticGroup(input.code),\n    source: 'core' as const,\n  };\n  if (\n    input.code === 'MOLDEA_IMPACT_PATTERN_UNMATCHED' ||\n    input.code === 'MOLDEA_ACCEPTANCE_UNMATCHED' ||\n    input.code === 'MOLDEA_INTEGRATION_BLOCK_MISSING' ||\n    input.code === 'MOLDEA_INTEGRATION_SKILL_MISSING' ||\n    input.code === 'MOLDEA_INTEGRATION_BLOCK_STALE' ||\n    input.code === 'MOLDEA_INTEGRATION_LINK_UNRESOLVED' ||\n    input.code === 'MOLDEA_INTEGRATION_CLAUDE_IMPORT_MISSING'\n  ) {\n    if (input.subject === undefined) throw new TypeError('A warning subject is required.');\n    return deepFreeze({\n      ...base,\n      code: input.code,\n      severity: 'warning' as const,\n      subject: input.subject,\n      qualifier: input.qualifier ?? null,\n      acceptable: ACCEPTABLE_WARNING_CODES.some((code) => code === input.code),\n    });\n  }\n  return deepFreeze({ ...base, code: input.code, severity: 'error' as const });\n};\n\n/**\n * Deduplicates and sorts already-normalized Core diagnostics.\n * @param candidates The immutable diagnostics to combine.\n * @returns A frozen deterministic diagnostic collection.\n */\nexport const normalizeDiagnostics = (\n  candidates: readonly IDiagnostic[],\n): readonly IDiagnostic[] => {\n  const diagnostics = new Map<string, IDiagnostic>();\n\n  for (const diagnostic of candidates) {\n    const key = serializeDiagnostic(diagnostic);\n\n    if (diagnostics.has(key)) {\n      continue;\n    }\n\n    diagnostics.set(key, diagnostic);\n  }\n\n  return deepFreeze([...diagnostics.values()].sort(compareDiagnostics));\n};\n\n/** Counts the complete normalized diagnostic result by severity once. */\nexport const countDiagnosticsBySeverity = (\n  diagnostics: readonly IDiagnostic[],\n): {\n  readonly errorCount: number;\n  readonly warningCount: number;\n  readonly acceptedWarningCount: number;\n  readonly diagnosticCount: number;\n} => {\n  let errorCount = 0;\n  let warningCount = 0;\n  let acceptedWarningCount = 0;\n\n  for (const diagnostic of diagnostics) {\n    if (diagnostic.severity === 'error') {\n      errorCount += 1;\n    } else if (diagnostic.accepted === true) {\n      acceptedWarningCount += 1;\n    } else {\n      warningCount += 1;\n    }\n  }\n\n  return { errorCount, warningCount, acceptedWarningCount, diagnosticCount: diagnostics.length };\n};\n\n/**\n * Creates a deterministic, deduplicating diagnostic collector for one operation.\n * @param limits The Core resource limits governing diagnostic output.\n * @param operation The operation reported by resource failures.\n * @returns A collector that freezes and sorts its final diagnostic array.\n */\nexport const createCoreDiagnosticCollector = (\n  limits: ICoreResourceLimits,\n  operation: ICoreOperation,\n): ICoreDiagnosticCollector => {\n  const diagnostics = new Map<string, ICoreDiagnostic>();\n  let proposalCount = 0;\n  let fallbackRawCount = 0;\n\n  const retain = (input: ICoreDiagnosticInput): void => {\n    const diagnostic = createCoreDiagnostic(input);\n    const key = serializeDiagnostic(diagnostic);\n\n    proposalCount += 1;\n\n    if (!diagnostics.has(key)) {\n      diagnostics.set(key, diagnostic);\n    }\n  };\n\n  return {\n    add: (input): void => {\n      fallbackRawCount = registerCoreDiagnosticCandidates(limits, 1, operation, fallbackRawCount);\n      retain(input);\n    },\n    merge: retain,\n    finalize: (): readonly ICoreDiagnostic[] => normalizeDiagnostics([...diagnostics.values()]),\n    get size(): number {\n      return proposalCount;\n    },\n  };\n};\n\n/**\n * Escapes one JSON Pointer reference token.\n * @param value The decoded mapping key or array index token.\n * @returns The RFC 6901 escaped token.\n */\nexport const escapeJsonPointerSegment = (value: string): string => {\n  return value.replaceAll('~', '~0').replaceAll('/', '~1');\n};\n","import { deepFreeze, isObjectValid } from 'jg-utilities';\n\nimport { DEFAULT_CORE_RESOURCE_LIMITS } from '../constants/index.js';\nimport type { ICoreOptions, ICoreResourceLimits } from '../contracts/index.js';\nimport { createCoreOperationResourceLimits } from '../diagnostic-utilities/index.js';\nimport { CoreConfigurationException } from '../exceptions/index.js';\n\n// complete immutable Core configuration\nexport interface ICoreOptionsSnapshot {\n  readonly limits: ICoreResourceLimits;\n}\n\n/** Creates an operation-local options view with one shared raw-diagnostic budget. */\nexport const createCoreOperationOptionsSnapshot = (\n  options: ICoreOptionsSnapshot,\n): ICoreOptionsSnapshot => {\n  return Object.freeze({\n    limits: createCoreOperationResourceLimits(options.limits),\n  });\n};\n\nconst RESOURCE_LIMIT_KEYS = [\n  'maxEntries',\n  'maxTotalBytesRead',\n  'maxFileBytes',\n  'maxManifestBytes',\n  'maxRetainedBytes',\n  'maxDiagnostics',\n  'maxCoverage',\n  'maxAcceptedWarnings',\n] as const satisfies readonly (keyof ICoreResourceLimits)[];\n\n/**\n * Validates, copies, fills, and freezes all configured resource limits.\n * @param candidate The untrusted optional limit overrides.\n * @returns The complete frozen resource limits.\n * @throws\n * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.\n */\nconst normalizeLimits = (candidate: unknown): ICoreResourceLimits => {\n  if (candidate === undefined) {\n    return DEFAULT_CORE_RESOURCE_LIMITS;\n  }\n\n  if (!isObjectValid(candidate, true)) {\n    throw new CoreConfigurationException({\n      code: 'INVALID_RESOURCE_LIMIT',\n      operation: 'create-core',\n    });\n  }\n\n  const knownKeys = new Set<string>(RESOURCE_LIMIT_KEYS);\n\n  if (Object.keys(candidate).some((key) => !knownKeys.has(key))) {\n    throw new CoreConfigurationException({\n      code: 'INVALID_RESOURCE_LIMIT',\n      operation: 'create-core',\n    });\n  }\n\n  const normalized: ICoreResourceLimits = {\n    ...DEFAULT_CORE_RESOURCE_LIMITS,\n  };\n\n  for (const key of RESOURCE_LIMIT_KEYS) {\n    const value: unknown = candidate[key];\n\n    if (value === undefined) {\n      continue;\n    }\n\n    if (!Number.isSafeInteger(value) || (value as number) <= 0) {\n      throw new CoreConfigurationException({\n        code: 'INVALID_RESOURCE_LIMIT',\n        operation: 'create-core',\n      });\n    }\n\n    (normalized as Record<keyof ICoreResourceLimits, number>)[key] = value as number;\n  }\n\n  return deepFreeze(normalized);\n};\n\n/**\n * Validates and snapshots caller-owned Core resource limits.\n * @returns A deeply frozen configuration snapshot.\n * @throws\n * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.\n */\nexport const normalizeCoreOptions = (options: ICoreOptions | undefined): ICoreOptionsSnapshot => {\n  if (\n    options !== undefined &&\n    (!isObjectValid(options, true) || Reflect.ownKeys(options).some((key) => key !== 'limits'))\n  ) {\n    throw new CoreConfigurationException({\n      code: 'INVALID_RESOURCE_LIMIT',\n      operation: 'create-core',\n    });\n  }\n  return deepFreeze({ limits: normalizeLimits(options?.['limits']) });\n};\n"],"mappings":"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"}

package/dist/chunks/repository-rpc-B9YaeLba.js

@@ -0,0 +1,143 @@
+import "./errors-Uvb-9X1u.js";
+import { isObjectValid } from "jg-utilities";
+import { REPOSITORY_LINK_TEXT_MAX_BYTES, RepositorySourceException, isRepositoryPath, parseRepositoryPath } from "@moldea.ai/repository";
+import { Buffer } from "node:buffer";
+//#region src/node-inspection/repository-rpc.ts
+var invalidSource = () => {
+	throw new RepositorySourceException({
+		code: "INVALID_SOURCE_DATA",
+		operation: "create-reader",
+		path: null,
+		retryable: false
+	});
+};
+var isInteger = (input) => typeof input === "number" && Number.isSafeInteger(input) && input >= 0;
+var keysMatch = (input, keys) => Object.keys(input).length === keys.length && keys.every((key) => Object.hasOwn(input, key));
+/** Validates the immutable source identity without coercing unknown boundary fields. */
+var parseSnapshot = (input) => {
+	if (!isObjectValid(input, true) || !keysMatch(input, ["id", "sourceKind"]) || typeof input["id"] !== "string" || input["id"].length === 0 || typeof input["sourceKind"] !== "string" || input["sourceKind"].length === 0) return invalidSource();
+	return {
+		id: input["id"],
+		sourceKind: input["sourceKind"]
+	};
+};
+/** Converts one validated metadata-only repository entry. */
+var parseRpcEntry = (input) => {
+	if (input === null) return null;
+	if (!isObjectValid(input, true)) return invalidSource();
+	const entry = input;
+	if (!keysMatch(entry, [
+		"path",
+		"type",
+		"byteLength",
+		"contentIdentity"
+	]) || !isRepositoryPath(entry["path"]) || entry["type"] !== "file" && entry["type"] !== "directory" && entry["type"] !== "symlink" || entry["byteLength"] !== null && !isInteger(entry["byteLength"]) || entry["contentIdentity"] !== null && typeof entry["contentIdentity"] !== "string") return invalidSource();
+	return {
+		path: entry["path"],
+		type: entry["type"],
+		byteLength: entry["byteLength"],
+		contentIdentity: entry["contentIdentity"]
+	};
+};
+/** Converts a bounded listing page while retaining snapshot and continuation contracts. */
+var parseRpcEntryPage = (input) => {
+	if (!isObjectValid(input, true)) return invalidSource();
+	const page = input;
+	if (!keysMatch(page, [
+		"entries",
+		"isComplete",
+		"nextCursor",
+		"snapshot"
+	]) || !Array.isArray(page["entries"]) || page["entries"].length > 128 || typeof page["isComplete"] !== "boolean" || page["nextCursor"] !== null && typeof page["nextCursor"] !== "string") return invalidSource();
+	const entries = [];
+	for (const candidate of page["entries"]) {
+		const entry = parseRpcEntry(candidate);
+		if (entry === null) return invalidSource();
+		entries.push(entry);
+	}
+	return {
+		entries,
+		isComplete: page["isComplete"],
+		nextCursor: page["nextCursor"],
+		snapshot: parseSnapshot(page["snapshot"])
+	};
+};
+/** Converts one link's stored text, admitting only text within the shared byte limit. */
+var parseRpcLinkText = (input) => {
+	if (input === null) return null;
+	if (typeof input !== "string" || Buffer.byteLength(input, "utf8") > REPOSITORY_LINK_TEXT_MAX_BYTES) return invalidSource();
+	return input;
+};
+/** Decodes only an admitted 64 KiB binary page, never a complete repository file. */
+var parseRpcFilePage = (input) => {
+	if (!isObjectValid(input, true)) return invalidSource();
+	const filePage = input;
+	if (!keysMatch(filePage, [
+		"bytes",
+		"isComplete",
+		"nextOffset",
+		"offset",
+		"snapshot",
+		"totalBytes"
+	]) || typeof filePage["bytes"] !== "string" || filePage["bytes"].length > Math.ceil(65536 / 3) * 4 || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(filePage["bytes"]) || typeof filePage["isComplete"] !== "boolean" || !isInteger(filePage["offset"]) || !isInteger(filePage["totalBytes"]) || filePage["nextOffset"] !== null && !isInteger(filePage["nextOffset"])) return invalidSource();
+	const bytes = Buffer.from(filePage["bytes"], "base64");
+	if (bytes.byteLength > 65536 || bytes.toString("base64") !== filePage["bytes"]) return invalidSource();
+	return {
+		bytes,
+		isComplete: filePage["isComplete"],
+		nextOffset: filePage["nextOffset"],
+		offset: filePage["offset"],
+		snapshot: parseSnapshot(filePage["snapshot"]),
+		totalBytes: filePage["totalBytes"]
+	};
+};
+/** Encodes one bounded byte page after confirming it respects the requested bound. */
+var encodeFilePage = (page, maxBytes) => {
+	if (!(page.bytes instanceof Uint8Array) || page.bytes.byteLength > maxBytes) return invalidSource();
+	const result = {
+		...page,
+		bytes: Buffer.from(page.bytes.buffer, page.bytes.byteOffset, page.bytes.byteLength).toString("base64")
+	};
+	parseRpcFilePage(result);
+	return result;
+};
+/**
+* Calls the real reader with inspection cancellation and returns a bounded transport value.
+* Reader failures propagate unchanged to the parent inspection owner.
+* @returns A metadata value, link text, or encoded byte page after actual reader settlement.
+* @throws
+* - INVALID_REPOSITORY_PATH: The repository path is invalid.
+* - ENTRY_NOT_FOUND: The requested repository entry was not found.
+* - ENTRY_NOT_FILE: The requested repository entry is not a file.
+* - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.
+* - ENTRY_NOT_LINK: The requested repository entry is not a symlink.
+* - INVALID_PAGE_REQUEST: The repository page request is invalid.
+* - ACCESS_DENIED: Access to the repository source was denied.
+* - SOURCE_UNAVAILABLE: The repository source is unavailable.
+* - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+* - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
+* - INVALID_SOURCE_DATA: The repository source returned invalid data.
+* - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+* - ABORTED: The repository operation was aborted.
+*/
+var executeRepositoryRpc = async (sources, request, signal) => {
+	const getReader = (source) => source === "repository" ? sources.repository : sources.instructions ?? invalidSource();
+	if (request.method === "readLinkText") return parseRpcLinkText(await getReader(request.source).readLinkText(parseRepositoryPath(request.path), { signal }));
+	if (request.method === "getEntry") return parseRpcEntry(await getReader(request.source).getEntry(parseRepositoryPath(request.path), { signal }));
+	const reader = sources.repository;
+	if (request.method === "listEntriesPage") return parseRpcEntryPage(await reader.listEntriesPage({
+		maxEntries: request.maxEntries,
+		signal,
+		...request.prefix === void 0 ? {} : { prefix: parseRepositoryPath(request.prefix) },
+		...request.cursor === void 0 ? {} : { cursor: request.cursor }
+	}));
+	return encodeFilePage(await getReader(request.source).readFilePage(parseRepositoryPath(request.path), {
+		maxBytes: request.maxBytes,
+		offset: request.offset,
+		signal
+	}), request.maxBytes);
+};
+//#endregion
+export { parseRpcLinkText as a, parseRpcFilePage as i, parseRpcEntry as n, parseRpcEntryPage as r, executeRepositoryRpc as t };
+
+//# sourceMappingURL=repository-rpc-B9YaeLba.js.map

package/dist/chunks/repository-rpc-B9YaeLba.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-rpc-B9YaeLba.js","names":[],"sources":["../../src/node-inspection/repository-rpc.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\nimport { isObjectValid } from 'jg-utilities';\n\nimport {\n  REPOSITORY_LINK_TEXT_MAX_BYTES,\n  isRepositoryPath,\n  parseRepositoryPath,\n  RepositorySourceException,\n  type IRepositoryEntry,\n  type IRepositoryEntryPage,\n  type IRepositoryFilePage,\n  type IRepositoryReader,\n  type IRepositorySnapshot,\n} from '@moldea.ai/repository';\n\nimport { NODE_INSPECTION_FILE_PAGE_BYTES } from './constants.js';\nimport type { INodeReaderRequest, INodeReaderSources } from './types.js';\n\nconst invalidSource = (): never => {\n  throw new RepositorySourceException({\n    code: 'INVALID_SOURCE_DATA',\n    operation: 'create-reader',\n    path: null,\n    retryable: false,\n  });\n};\nconst isInteger = (input: unknown): input is number =>\n  typeof input === 'number' && Number.isSafeInteger(input) && input >= 0;\nconst keysMatch = (input: Readonly<Record<string, unknown>>, keys: string[]): boolean =>\n  Object.keys(input).length === keys.length && keys.every((key) => Object.hasOwn(input, key));\n\n/** Validates the immutable source identity without coercing unknown boundary fields. */\nconst parseSnapshot = (input: unknown): IRepositorySnapshot => {\n  if (\n    !isObjectValid(input, true) ||\n    !keysMatch(input, ['id', 'sourceKind']) ||\n    typeof input['id'] !== 'string' ||\n    input['id'].length === 0 ||\n    typeof input['sourceKind'] !== 'string' ||\n    input['sourceKind'].length === 0\n  )\n    return invalidSource();\n  return { id: input['id'], sourceKind: input['sourceKind'] };\n};\n\n/** Converts one validated metadata-only repository entry. */\nexport const parseRpcEntry = (input: unknown): IRepositoryEntry | null => {\n  if (input === null) return null;\n  if (!isObjectValid(input, true)) return invalidSource();\n  const entry: Readonly<Record<string, unknown>> = input;\n  if (\n    !keysMatch(entry, ['path', 'type', 'byteLength', 'contentIdentity']) ||\n    !isRepositoryPath(entry['path']) ||\n    (entry['type'] !== 'file' && entry['type'] !== 'directory' && entry['type'] !== 'symlink') ||\n    (entry['byteLength'] !== null && !isInteger(entry['byteLength'])) ||\n    (entry['contentIdentity'] !== null && typeof entry['contentIdentity'] !== 'string')\n  )\n    return invalidSource();\n  return {\n    path: entry['path'],\n    type: entry['type'],\n    byteLength: entry['byteLength'],\n    contentIdentity: entry['contentIdentity'],\n  };\n};\n\n/** Converts a bounded listing page while retaining snapshot and continuation contracts. */\nexport const parseRpcEntryPage = (input: unknown): IRepositoryEntryPage => {\n  if (!isObjectValid(input, true)) return invalidSource();\n  const page: Readonly<Record<string, unknown>> = input;\n  if (\n    !keysMatch(page, ['entries', 'isComplete', 'nextCursor', 'snapshot']) ||\n    !Array.isArray(page['entries']) ||\n    page['entries'].length > 128 ||\n    typeof page['isComplete'] !== 'boolean' ||\n    (page['nextCursor'] !== null && typeof page['nextCursor'] !== 'string')\n  )\n    return invalidSource();\n  const entries: IRepositoryEntry[] = [];\n  for (const candidate of page['entries']) {\n    const entry = parseRpcEntry(candidate);\n    if (entry === null) return invalidSource();\n    entries.push(entry);\n  }\n  return {\n    entries,\n    isComplete: page['isComplete'],\n    nextCursor: page['nextCursor'],\n    snapshot: parseSnapshot(page['snapshot']),\n  };\n};\n\n/** Converts one link's stored text, admitting only text within the shared byte limit. */\nexport const parseRpcLinkText = (input: unknown): string | null => {\n  if (input === null) return null;\n  if (\n    typeof input !== 'string' ||\n    Buffer.byteLength(input, 'utf8') > REPOSITORY_LINK_TEXT_MAX_BYTES\n  )\n    return invalidSource();\n  return input;\n};\n\n/** Decodes only an admitted 64 KiB binary page, never a complete repository file. */\nexport const parseRpcFilePage = (input: unknown): IRepositoryFilePage => {\n  if (!isObjectValid(input, true)) return invalidSource();\n  const filePage: Readonly<Record<string, unknown>> = input;\n  if (\n    !keysMatch(filePage, [\n      'bytes',\n      'isComplete',\n      'nextOffset',\n      'offset',\n      'snapshot',\n      'totalBytes',\n    ]) ||\n    typeof filePage['bytes'] !== 'string' ||\n    filePage['bytes'].length > Math.ceil(NODE_INSPECTION_FILE_PAGE_BYTES / 3) * 4 ||\n    !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(filePage['bytes']) ||\n    typeof filePage['isComplete'] !== 'boolean' ||\n    !isInteger(filePage['offset']) ||\n    !isInteger(filePage['totalBytes']) ||\n    (filePage['nextOffset'] !== null && !isInteger(filePage['nextOffset']))\n  )\n    return invalidSource();\n  const bytes = Buffer.from(filePage['bytes'], 'base64');\n  if (\n    bytes.byteLength > NODE_INSPECTION_FILE_PAGE_BYTES ||\n    bytes.toString('base64') !== filePage['bytes']\n  )\n    return invalidSource();\n  return {\n    bytes,\n    isComplete: filePage['isComplete'],\n    nextOffset: filePage['nextOffset'],\n    offset: filePage['offset'],\n    snapshot: parseSnapshot(filePage['snapshot']),\n    totalBytes: filePage['totalBytes'],\n  };\n};\n\n/** Encodes one bounded byte page after confirming it respects the requested bound. */\nconst encodeFilePage = (page: IRepositoryFilePage, maxBytes: number): unknown => {\n  if (!(page.bytes instanceof Uint8Array) || page.bytes.byteLength > maxBytes)\n    return invalidSource();\n  const result = {\n    ...page,\n    bytes: Buffer.from(page.bytes.buffer, page.bytes.byteOffset, page.bytes.byteLength).toString(\n      'base64',\n    ),\n  };\n  parseRpcFilePage(result);\n  return result;\n};\n\n/**\n * Calls the real reader with inspection cancellation and returns a bounded transport value.\n * Reader failures propagate unchanged to the parent inspection owner.\n * @returns A metadata value, link text, or encoded byte page after actual reader settlement.\n * @throws\n * - INVALID_REPOSITORY_PATH: The repository path is invalid.\n * - ENTRY_NOT_FOUND: The requested repository entry was not found.\n * - ENTRY_NOT_FILE: The requested repository entry is not a file.\n * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.\n * - ENTRY_NOT_LINK: The requested repository entry is not a symlink.\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 executeRepositoryRpc = async (\n  sources: INodeReaderSources,\n  request: INodeReaderRequest,\n  signal: AbortSignal,\n): Promise<unknown> => {\n  const getReader = (source: 'instructions' | 'repository'): IRepositoryReader =>\n    source === 'repository' ? sources.repository : (sources.instructions ?? invalidSource());\n  if (request.method === 'readLinkText')\n    return parseRpcLinkText(\n      await getReader(request.source).readLinkText(parseRepositoryPath(request.path), { signal }),\n    );\n  if (request.method === 'getEntry')\n    return parseRpcEntry(\n      await getReader(request.source).getEntry(parseRepositoryPath(request.path), { signal }),\n    );\n  const reader = sources.repository;\n  if (request.method === 'listEntriesPage')\n    return parseRpcEntryPage(\n      await reader.listEntriesPage({\n        maxEntries: request.maxEntries,\n        signal,\n        ...(request.prefix === undefined ? {} : { prefix: parseRepositoryPath(request.prefix) }),\n        ...(request.cursor === undefined ? {} : { cursor: request.cursor }),\n      }),\n    );\n  return encodeFilePage(\n    await getReader(request.source).readFilePage(parseRepositoryPath(request.path), {\n      maxBytes: request.maxBytes,\n      offset: request.offset,\n      signal,\n    }),\n    request.maxBytes,\n  );\n};\n"],"mappings":"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"}