@moldea.ai/core 7.0.4 → 8.0.0

package/dist/chunks/{core-FyfprJqa.js → core-BCMf-ig9.js}

@@ -1,7 +1,7 @@
-import { E as parseDecisionIdFromPath, O as trimRepositoryFormatWhitespace, S as isRuntimeGuidancePath, T as isVariableId, a as escapeJsonPointerSegment, c as freezeRecursively, d as hasNonWhitespace, g as isContextPath, i as createCoreDiagnosticCollector, l as compareExactStrings, n as normalizeCoreOptions, o as normalizeDiagnostics, r as countDiagnosticsBySeverity, s as createNullPrototypeRecord, t as createCoreOperationOptionsSnapshot, u as countUnicodeScalars } from "./options-AMqX7rx_.js";
+import { E as parseDecisionIdFromPath, O as trimRepositoryFormatWhitespace, S as isRuntimeGuidancePath, T as isVariableId, a as escapeJsonPointerSegment, c as freezeRecursively, d as hasNonWhitespace, g as isContextPath, i as createCoreDiagnosticCollector, l as compareExactStrings, n as normalizeCoreOptions, o as normalizeDiagnostics, r as countDiagnosticsBySeverity, s as createNullPrototypeRecord, t as createCoreOperationOptionsSnapshot, u as countUnicodeScalars } from "./options-l3kVfA-K.js";
 import { n as CoreOperationException } from "./exceptions-CYf1pCKf.js";
-import { a as createSourceLocator, c as calculateContentDigest, i as parseStrictYaml, l as calculateNormalizedTextDigest, n as inspectManifestDocument, o as collectManifestScopeDeclarations, r as parseManifestDocument, s as matchesRepositoryGlob, t as matchManifestScope, u as normalizeTextDocument } from "./scope-e3-w9N7D.js";
-import { REPOSITORY_ROOT, RepositorySourceException, compareRepositoryPaths, createRepositoryIdentity, isRepositoryPath, parseRepositoryPath } from "@moldea.ai/repository";
+import { a as createSourceLocator, c as calculateContentDigest, i as parseStrictYaml, l as calculateNormalizedTextDigest, n as inspectManifestDocument, o as collectManifestScopeDeclarations, r as parseManifestDocument, s as matchesRepositoryGlob, t as matchManifestScope, u as normalizeTextDocument } from "./scope-D9BYchNI.js";
+import { REPOSITORY_LINK_TEXT_MAX_BYTES, REPOSITORY_ROOT, RepositorySourceException, compareRepositoryPaths, createRepositoryIdentity, isRepositoryPath, parseRepositoryPath, resolveRepositoryLink } from "@moldea.ai/repository";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -495,6 +495,12 @@ var reserveRetainedBytesIfTracked = (reader, bytes) => {
 //#endregion
 //#region src/repository-inspection-session/index.ts
 var MANIFEST_PATH$3 = parseRepositoryPath("/moldea/moldea.yaml");
+var INSTRUCTION_PATHS = new Set([
+	"/AGENTS.md",
+	"/CLAUDE.md",
+	"/.claude/CLAUDE.md",
+	"/CLAUDE.local.md"
+].map((path) => parseRepositoryPath(path)));
 var SOURCE_PAGE_ENTRIES = 256;
 var SOURCE_PAGE_BYTES = 65536;
 var CANONICAL_BYTE_RETENTION_MULTIPLIER = 4;
@@ -552,11 +558,12 @@ var createSourceOptions = (sessionSignal, operationSignal) => {
 * @param repository The source-neutral reader bound to one coherent snapshot.
 * @param limits The immutable resource limits for the inspection.
 * @param signal Optional cancellation shared by every inspection operation.
+* @param instructions Optional reader of the four instruction paths, used only by the instruction view.
 * @returns A session that pages source metadata and range-reads bounded canonical files.
 * @throws
 * - ABORTED: The Core operation was aborted.
 */
-var createRepositoryInspectionSession = (repository, limits, signal) => {
+var createRepositoryInspectionSession = (repository, limits, signal, instructions) => {
 	const seenPaths = /* @__PURE__ */ new Set();
 	let canonicalBytes = 0;
 	let peakRetainedBytes = 0;
@@ -593,14 +600,19 @@ var createRepositoryInspectionSession = (repository, limits, signal) => {
 		if (byteLength > limits.maxTotalBytesRead - totalBytesRead) return throwResourceLimitExceeded("maxTotalBytesRead", limits.maxTotalBytesRead, totalBytesRead + byteLength);
 		totalBytesRead += byteLength;
 	};
-	const getEntry = async (path, options) => {
+	const repositoryPages = {
+		readPage: (path, options) => repository.readFilePage(path, options),
+		snapshotId: repository.snapshot.id
+	};
+	const getEntryFrom = async (source, path, options) => {
 		const parsedPath = parseRepositoryPath(path);
 		throwIfSignalAborted(options?.signal);
 		registerPath(parsedPath);
-		const candidate = await repository.getEntry(parsedPath, createSourceOptions(signal, options?.signal));
+		const candidate = await source.getEntry(parsedPath, createSourceOptions(signal, options?.signal));
 		throwIfSignalAborted(options?.signal);
 		return candidate === null ? null : copyReaderEntry$1(candidate, "get-entry", parsedPath, parsedPath);
 	};
+	const getEntry = (path, options) => getEntryFrom(repository, path, options);
 	const iterateEntries = (options) => {
 		const prefix = options?.prefix === void 0 ? REPOSITORY_ROOT : parseRepositoryPath(options.prefix);
 		return { async *[Symbol.asyncIterator]() {
@@ -635,20 +647,20 @@ var createRepositoryInspectionSession = (repository, limits, signal) => {
 			} while (true);
 		} };
 	};
-	const loadFile = async (path, operationSignal, isSource = false) => {
+	const loadFile = async (path, operationSignal, isSource = false, pages = repositoryPages) => {
 		const multiplier = isSource ? 1 : CANONICAL_BYTE_RETENTION_MULTIPLIER;
 		const fileLimit = path === MANIFEST_PATH$3 ? "maxManifestBytes" : "maxFileBytes";
 		const availableRetainedBytes = limits.maxRetainedBytes - retainedBytes;
 		if (availableRetainedBytes < 1) return throwResourceLimitExceeded("maxRetainedBytes", limits.maxRetainedBytes, retainedBytes + 1);
 		const firstPageMaximumBytes = Math.min(SOURCE_PAGE_BYTES, Math.max(1, limits[fileLimit]), availableRetainedBytes);
 		observeTransientBytes(firstPageMaximumBytes);
-		const firstPage = await repository.readFilePage(path, {
+		const firstPage = await pages.readPage(path, {
 			maxBytes: firstPageMaximumBytes,
 			offset: 0,
 			...createSourceOptions(signal, operationSignal) ?? {}
 		});
 		throwIfSignalAborted(operationSignal);
-		if (firstPage.snapshot.id !== repository.snapshot.id || firstPage.offset !== 0 || !(firstPage.bytes instanceof Uint8Array) || !Number.isSafeInteger(firstPage.totalBytes) || firstPage.totalBytes < 0 || firstPage.bytes.byteLength > SOURCE_PAGE_BYTES || firstPage.bytes.byteLength > firstPage.totalBytes || firstPage.bytes.byteLength === 0 && !firstPage.isComplete) return invalidSourceData$3("read-file-page", path);
+		if (firstPage.snapshot.id !== pages.snapshotId || firstPage.offset !== 0 || !(firstPage.bytes instanceof Uint8Array) || !Number.isSafeInteger(firstPage.totalBytes) || firstPage.totalBytes < 0 || firstPage.bytes.byteLength > SOURCE_PAGE_BYTES || firstPage.bytes.byteLength > firstPage.totalBytes || firstPage.bytes.byteLength === 0 && !firstPage.isComplete) return invalidSourceData$3("read-file-page", path);
 		if (firstPage.totalBytes > limits[fileLimit]) return throwResourceLimitExceeded(fileLimit, limits[fileLimit], firstPage.totalBytes);
 		const firstPageBytes = firstPage.bytes.byteLength;
 		const retainedBytesAvailableForCanonicalContent = limits.maxRetainedBytes - retainedBytes - firstPageBytes;
@@ -667,7 +679,7 @@ var createRepositoryInspectionSession = (repository, limits, signal) => {
 		let isFirstPage = true;
 		while (isFirstPage || offset < content.byteLength) {
 			isFirstPage = false;
-			if (page.snapshot.id !== repository.snapshot.id || page.offset !== offset || page.totalBytes !== content.byteLength || !(page.bytes instanceof Uint8Array) || page.bytes.byteLength > SOURCE_PAGE_BYTES || page.bytes.byteLength > content.byteLength - offset || page.bytes.byteLength === 0 && !page.isComplete) return invalidSourceData$3("read-file-page", path);
+			if (page.snapshot.id !== pages.snapshotId || page.offset !== offset || page.totalBytes !== content.byteLength || !(page.bytes instanceof Uint8Array) || page.bytes.byteLength > SOURCE_PAGE_BYTES || page.bytes.byteLength > content.byteLength - offset || page.bytes.byteLength === 0 && !page.isComplete) return invalidSourceData$3("read-file-page", path);
 			content.set(page.bytes, offset);
 			offset += page.bytes.byteLength;
 			if (page.isComplete) {
@@ -675,7 +687,7 @@ var createRepositoryInspectionSession = (repository, limits, signal) => {
 				break;
 			}
 			if (page.nextOffset !== offset) return invalidSourceData$3("read-file-page", path);
-			page = await repository.readFilePage(path, {
+			page = await pages.readPage(path, {
 				maxBytes: Math.min(SOURCE_PAGE_BYTES, Math.max(1, content.byteLength - offset)),
 				offset,
 				...createSourceOptions(signal, operationSignal) ?? {}
@@ -718,6 +730,50 @@ var createRepositoryInspectionSession = (repository, limits, signal) => {
 		throwIfSignalAborted(options?.signal);
 		return content.slice();
 	};
+	/** Loads one complete temporary source buffer whose reservation the caller releases. */
+	const readRetainedSource = async (path, pages) => {
+		throwIfSignalAborted();
+		registerPath(path);
+		const bytes = await awaitWithCancellation(loadFile(path, void 0, true, pages));
+		throwIfSignalAborted();
+		let isReleased = false;
+		return {
+			bytes,
+			release: () => {
+				if (!isReleased) retainedBytes -= bytes.byteLength;
+				isReleased = true;
+			}
+		};
+	};
+	const readerFor = (path) => instructions !== void 0 && INSTRUCTION_PATHS.has(path) ? instructions : repository;
+	const pagesFor = (path) => {
+		const source = readerFor(path);
+		return source === repository ? repositoryPages : {
+			readPage: (pagePath, options) => source.readFilePage(pagePath, options),
+			snapshotId: source.snapshot.id
+		};
+	};
+	/** Reads one link's stored text from the routed source, rejecting text past the shared limit. */
+	const readLinkText = async (path, options) => {
+		const parsedPath = parseRepositoryPath(path);
+		throwIfSignalAborted(options?.signal);
+		registerPath(parsedPath);
+		const text = await awaitWithCancellation(readerFor(parsedPath).readLinkText(parsedPath, createSourceOptions(signal, options?.signal)), options?.signal);
+		throwIfSignalAborted(options?.signal);
+		if (text !== null && (typeof text !== "string" || encoder$1.encode(text).byteLength > REPOSITORY_LINK_TEXT_MAX_BYTES)) return invalidSourceData$3("read-link-text", parsedPath);
+		return text;
+	};
+	const instructionView = Object.freeze({
+		getEntry: (path, options) => {
+			const parsedPath = parseRepositoryPath(path);
+			return getEntryFrom(readerFor(parsedPath), parsedPath, options);
+		},
+		readLinkText,
+		readSourceFile: (path) => {
+			const parsedPath = parseRepositoryPath(path);
+			return readRetainedSource(parsedPath, pagesFor(parsedPath));
+		}
+	});
 	const reader = Object.freeze({
 		getEntry,
 		iterateEntries,
@@ -734,20 +790,7 @@ var createRepositoryInspectionSession = (repository, limits, signal) => {
 			if (!Number.isSafeInteger(bytes) || bytes < 0 || bytes > retainedBytes) throw new TypeError("The retained-memory release is invalid.");
 			retainedBytes -= bytes;
 		},
-		readSourceFile: async (path) => {
-			throwIfSignalAborted();
-			registerPath(path);
-			const bytes = await awaitWithCancellation(loadFile(path, void 0, true));
-			throwIfSignalAborted();
-			let isReleased = false;
-			return {
-				bytes,
-				release: () => {
-					if (!isReleased) retainedBytes -= bytes.byteLength;
-					isReleased = true;
-				}
-			};
-		}
+		readSourceFile: (path) => readRetainedSource(path, repositoryPages)
 	});
 	return Object.freeze({
 		getResourceUsage: () => Object.freeze({
@@ -756,6 +799,7 @@ var createRepositoryInspectionSession = (repository, limits, signal) => {
 			retainedBytes,
 			totalBytesRead
 		}),
+		instructions: instructionView,
 		reader,
 		throwIfAborted: throwIfSignalAborted
 	});
@@ -1879,11 +1923,34 @@ var parseIntegrationBlock = (text) => {
 		skillPath
 	};
 };
+var ROOT_AGENTS_IMPORTS = /* @__PURE__ */ new Set(["@AGENTS.md", "@./AGENTS.md"]);
+var NESTED_AGENTS_IMPORTS = /* @__PURE__ */ new Set(["@../AGENTS.md"]);
+/**
+* Reports whether Claude Code instruction text imports the root AGENTS.md on a line of its own.
+* Lines inside fenced code blocks and imports embedded in other text do not count.
+* @param text The decoded instruction text.
+* @param isNested Whether the text belongs to `/.claude/CLAUDE.md` rather than a root file.
+* @returns `true` when one unfenced line, trimmed of spaces and tabs, is an AGENTS.md import.
+*/
+var hasAgentsImport = (text, isNested) => {
+	const imports = isNested ? NESTED_AGENTS_IMPORTS : ROOT_AGENTS_IMPORTS;
+	let fence = null;
+	for (const rawLine of text.replace(/^\uFEFF/u, "").split(/\r\n|\n|\r/u)) {
+		const line = rawLine.replace(/^[ \t]+|[ \t]+$/gu, "");
+		const marker = /^(`{3,}|~{3,})/u.exec(line)?.[1];
+		if (fence !== null) {
+			if (marker !== void 0 && marker[0] === fence[0] && marker.length >= fence.length) fence = null;
+		} else if (marker !== void 0) fence = marker;
+		else if (imports.has(line)) return true;
+	}
+	return false;
+};
 //#endregion
-//#region src/integration-validation/inspection.ts
-var AGENTS_PATH = parseRepositoryPath("/AGENTS.md");
+//#region src/integration-validation/utilities.ts
 /**
 * Reads bounded untrusted text with a reservation for decoding and temporary string copies.
+* @param ledger The session ledger that owns the reservation.
+* @param load Loads the complete bounded source buffer.
 * @returns Decoded text or null for invalid UTF-8, with its reservation-release operation.
 * @throws
 * - ENTRY_NOT_FOUND: The requested repository entry was not found.
@@ -1897,8 +1964,8 @@ var AGENTS_PATH = parseRepositoryPath("/AGENTS.md");
 * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
 * - INVALID_SOURCE_DATA: The repository source returned invalid data.
 */
-var readText = async (ledger, path) => {
-	const source = await ledger.readSourceFile(path);
+var readRetainedText = async (ledger, load) => {
+	const source = await load();
 	const reservation = source.bytes.byteLength * 8;
 	let isReserved = false;
 	try {
@@ -1923,9 +1990,17 @@ var readText = async (ledger, path) => {
 };
 /** Distinguishes missing and non-regular files without an extra entry lookup or following symlinks. */
 var getAbsentKind = (error) => error instanceof RepositorySourceException ? error.code === "ENTRY_NOT_FOUND" ? "missing" : error.code === "ENTRY_NOT_FILE" ? "non-regular" : null : null;
+//#endregion
+//#region src/integration-validation/agents-inspection.ts
+var AGENTS_PATH$1 = parseRepositoryPath("/AGENTS.md");
+/** Reports an AGENTS.md link that doesn't lead to a file, with its reason as the qualifier. */
+var reportUnresolvedLink = (report, reason) => report("MOLDEA_INTEGRATION_LINK_UNRESOLVED", {
+	entryKind: "symlink",
+	reason
+}, reason);
 /**
-* Checks the root integration against its installed asset with at most two reads and two lookups.
-* @returns Completed content-free integration warnings, never an execution or runtime-wiring claim.
+* Checks one readable AGENTS.md text against its referenced skill installation.
+* @returns A promise that settles after at most one integration warning was recorded.
 * @throws
 * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
 * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
@@ -1936,52 +2011,40 @@ var getAbsentKind = (error) => error instanceof RepositorySourceException ? erro
 * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
 * - INVALID_SOURCE_DATA: The repository source returned invalid data.
 */
-var inspectCodingAgentIntegration = async (reader, limits, signal) => {
-	const ledger = getRetainedMemory(reader);
-	const collector = createCoreDiagnosticCollector(limits, "validate-project");
-	const report = (code, details) => {
-		collector.add({
-			code,
-			path: AGENTS_PATH,
-			subject: AGENTS_PATH,
-			qualifier: null,
-			entity: { integrationPath: AGENTS_PATH },
-			details
-		});
-		return collector.finalize();
-	};
+var checkAgentsDocument = async (context, report, load, entryDetails) => {
+	const { ledger, reader, signal } = context;
 	let document;
 	try {
-		document = await readText(ledger, AGENTS_PATH);
+		document = await readRetainedText(ledger, load);
 	} catch (error) {
-		const entryKind = getAbsentKind(error);
-		if (entryKind !== null) return report("MOLDEA_INTEGRATION_BLOCK_MISSING", { entryKind });
-		throw error;
+		const absentKind = getAbsentKind(error);
+		if (absentKind === null) throw error;
+		return entryDetails["entryKind"] === "symlink" ? reportUnresolvedLink(report, absentKind === "missing" ? "missing" : "not-file") : report("MOLDEA_INTEGRATION_BLOCK_MISSING", { entryKind: absentKind });
 	}
 	try {
 		if (document.text === null) return report("MOLDEA_INTEGRATION_BLOCK_MISSING", {
-			entryKind: "file",
+			...entryDetails,
 			reason: "invalid-utf8"
 		});
 		const parsed = parseIntegrationBlock(document.text);
 		if (parsed.kind === "missing") return report(parsed.reason.startsWith("block-") ? "MOLDEA_INTEGRATION_BLOCK_MISSING" : "MOLDEA_INTEGRATION_SKILL_MISSING", {
-			entryKind: "file",
+			...entryDetails,
 			reason: parsed.reason
 		});
 		const { skillPath } = parsed;
 		for (const file of ["SKILL.md", "scripts/relevance-gate.mjs"]) {
 			const path = parseRepositoryPath(`/${skillPath}/${file}`);
-			const entry = await reader.getEntry(path, signal === void 0 ? void 0 : { signal });
-			if (entry?.type !== "file") return report("MOLDEA_INTEGRATION_SKILL_MISSING", {
+			const skillEntry = await reader.getEntry(path, signal === void 0 ? void 0 : { signal });
+			if (skillEntry?.type !== "file") return report("MOLDEA_INTEGRATION_SKILL_MISSING", {
 				referencedPath: `/${skillPath}`,
 				missingFile: path,
-				entryKind: entry?.type ?? "missing"
+				entryKind: skillEntry?.type ?? "missing"
 			});
 		}
 		const assetPath = parseRepositoryPath(`/${skillPath}/assets/managed-agents-block.md`);
 		let asset;
 		try {
-			asset = await readText(ledger, assetPath);
+			asset = await readRetainedText(ledger, () => ledger.readSourceFile(assetPath));
 		} catch (error) {
 			const entryKind = getAbsentKind(error);
 			if (entryKind !== null) return report("MOLDEA_INTEGRATION_SKILL_MISSING", {
@@ -2011,7 +2074,6 @@ var inspectCodingAgentIntegration = async (reader, limits, signal) => {
 			} finally {
 				ledger.release(renderedReservation);
 			}
-			return collector.finalize();
 		} finally {
 			asset.release();
 		}
@@ -2019,6 +2081,214 @@ var inspectCodingAgentIntegration = async (reader, limits, signal) => {
 		document.release();
 	}
 };
+/**
+* Checks root AGENTS.md against its referenced skill installation. A symlinked AGENTS.md that
+* leads to a regular file in the repository is checked on that file's text; any other link is
+* reported with its reason, without reading anything outside the repository.
+* @param context The instruction view, repository reader, ledger, and warning recorder.
+* @returns What AGENTS.md is, including its link resolution, for the Claude Code check.
+* @throws
+* - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+* - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+* - ABORTED: The Core operation was aborted.
+* - ABORTED: The repository operation was aborted.
+* - ACCESS_DENIED: Access to the repository source was denied.
+* - SOURCE_UNAVAILABLE: The repository source is unavailable.
+* - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+* - INVALID_SOURCE_DATA: The repository source returned invalid data.
+*/
+var inspectAgentsIntegration = async (context) => {
+	const { instructions } = context;
+	const report = (code, details, qualifier) => context.report(code, AGENTS_PATH$1, details, qualifier);
+	const entry = await instructions.getEntry(AGENTS_PATH$1);
+	if (entry === null) {
+		report("MOLDEA_INTEGRATION_BLOCK_MISSING", { entryKind: "missing" });
+		return { kind: "missing" };
+	}
+	if (entry.type === "directory") {
+		report("MOLDEA_INTEGRATION_BLOCK_MISSING", { entryKind: "directory" });
+		return { kind: "directory" };
+	}
+	if (entry.type === "file") {
+		await checkAgentsDocument(context, report, () => instructions.readSourceFile(AGENTS_PATH$1), { entryKind: "file" });
+		return { kind: "file" };
+	}
+	const resolution = await resolveRepositoryLink(instructions, AGENTS_PATH$1);
+	if (resolution.state === "file") {
+		const { targetPath } = resolution;
+		await checkAgentsDocument(context, report, () => instructions.readSourceFile(targetPath), { entryKind: "symlink" });
+	} else reportUnresolvedLink(report, resolution.state);
+	return {
+		kind: "link",
+		resolution
+	};
+};
+//#endregion
+//#region src/integration-validation/claude-inspection.ts
+var AGENTS_PATH = parseRepositoryPath("/AGENTS.md");
+var CLAUDE_PATH = parseRepositoryPath("/CLAUDE.md");
+var NESTED_CLAUDE_PATH = parseRepositoryPath("/.claude/CLAUDE.md");
+var LOCAL_CLAUDE_PATH = parseRepositoryPath("/CLAUDE.local.md");
+/** Returns the regular file AGENTS.md leads to, or null when it leads to none. */
+var getAgentsTargetPath = (agents) => {
+	if (agents.kind === "file") return AGENTS_PATH;
+	return agents.kind === "link" && agents.resolution.state === "file" ? agents.resolution.targetPath : null;
+};
+/** Recognizes a link between a Claude file and AGENTS.md by final target path, without reading. */
+var isLinkedToAgents = (path, resolution, agents) => {
+	const agentsTargetPath = getAgentsTargetPath(agents);
+	if (agents.kind === "link" && agentsTargetPath === path) return true;
+	return resolution?.state === "file" && resolution.targetPath === agentsTargetPath;
+};
+/**
+* Determines whether one Claude Code file loads AGENTS.md through an import line, a link to the
+* same final target, or AGENTS.md linking to it. A linked Claude file with a regular-file target
+* is checked for an import line as if the file were at the link's own location.
+* @returns The assessment, reading at most the file or its link target once.
+* @throws
+* - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+* - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+* - ABORTED: The Core operation was aborted.
+* - ABORTED: The repository operation was aborted.
+* - ACCESS_DENIED: Access to the repository source was denied.
+* - SOURCE_UNAVAILABLE: The repository source is unavailable.
+* - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+* - INVALID_SOURCE_DATA: The repository source returned invalid data.
+*/
+var assessClaudeFile = async (context, path, agents) => {
+	const { instructions, ledger } = context;
+	const entry = await instructions.getEntry(path);
+	if (entry === null) return { kind: "absent" };
+	if (isLinkedToAgents(path, null, agents)) return { kind: "loads" };
+	if (entry.type === "directory") return {
+		entryKind: "directory",
+		kind: "not-loading"
+	};
+	let load = () => instructions.readSourceFile(path);
+	if (entry.type === "symlink") {
+		const resolution = await resolveRepositoryLink(instructions, path);
+		if (isLinkedToAgents(path, resolution, agents)) return { kind: "loads" };
+		if (resolution.state !== "file") return {
+			kind: "unresolved",
+			reason: resolution.state
+		};
+		const { targetPath } = resolution;
+		load = () => instructions.readSourceFile(targetPath);
+	}
+	let document;
+	try {
+		document = await readRetainedText(ledger, load);
+	} catch (error) {
+		const absentKind = getAbsentKind(error);
+		if (absentKind === null) throw error;
+		if (entry.type !== "symlink") return { kind: "absent" };
+		return {
+			kind: "unresolved",
+			reason: absentKind === "missing" ? "missing" : "not-file"
+		};
+	}
+	try {
+		return document.text !== null && hasAgentsImport(document.text, path === NESTED_CLAUDE_PATH) ? { kind: "loads" } : {
+			entryKind: entry.type,
+			kind: "not-loading"
+		};
+	} finally {
+		document.release();
+	}
+};
+/**
+* Checks whether Claude Code loads AGENTS.md. When `/CLAUDE.md` or `/.claude/CLAUDE.md` exists,
+* only those shared files count; `/CLAUDE.local.md` counts only when neither exists. At most one
+* Claude warning is recorded: an unresolved link for the first counted file whose link doesn't
+* lead to a file in the repository when none loads AGENTS.md, otherwise a missing import for the
+* governing file.
+* @param context The instruction view, ledger, and warning recorder.
+* @param agents What root AGENTS.md is, as the AGENTS.md check observed it.
+* @returns A promise that settles after at most one Claude warning was recorded.
+* @throws
+* - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+* - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+* - ABORTED: The Core operation was aborted.
+* - ABORTED: The repository operation was aborted.
+* - ACCESS_DENIED: Access to the repository source was denied.
+* - SOURCE_UNAVAILABLE: The repository source is unavailable.
+* - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+* - INVALID_SOURCE_DATA: The repository source returned invalid data.
+*/
+var inspectClaudeIntegration = async (context, agents) => {
+	const counted = [];
+	for (const path of [CLAUDE_PATH, NESTED_CLAUDE_PATH]) {
+		const assessment = await assessClaudeFile(context, path, agents);
+		if (assessment.kind === "loads") return;
+		if (assessment.kind !== "absent") counted.push({
+			assessment,
+			path
+		});
+	}
+	if (counted.length === 0) {
+		const assessment = await assessClaudeFile(context, LOCAL_CLAUDE_PATH, agents);
+		if (assessment.kind === "absent" || assessment.kind === "loads") return;
+		counted.push({
+			assessment,
+			path: LOCAL_CLAUDE_PATH
+		});
+	}
+	const unresolved = counted.find(({ assessment }) => assessment.kind === "unresolved");
+	if (unresolved?.assessment.kind === "unresolved") {
+		const { reason } = unresolved.assessment;
+		context.report("MOLDEA_INTEGRATION_LINK_UNRESOLVED", unresolved.path, {
+			entryKind: "symlink",
+			reason
+		}, reason);
+		return;
+	}
+	const governing = counted[0];
+	if (governing?.assessment.kind === "not-loading") context.report("MOLDEA_INTEGRATION_CLAUDE_IMPORT_MISSING", governing.path, { entryKind: governing.assessment.entryKind });
+};
+//#endregion
+//#region src/integration-validation/inspection.ts
+/**
+* Checks the coding-agent integration: root AGENTS.md and the Claude Code instruction files
+* through the instruction view, and the referenced skill installation through the repository
+* reader. It reads at most four instruction files, follows at most 32 links for each with one
+* lookup and one link-text read per link, and makes at most five bounded reads, all inside the
+* repository.
+* @param reader The repository inspection reader for skill files and the managed asset.
+* @param instructions The instruction view that routes the four instruction paths and links.
+* @param limits The immutable resource limits for the inspection.
+* @param signal Optional cancellation for repository lookups.
+* @returns Completed content-free integration warnings, never an execution or runtime-wiring claim.
+* @throws
+* - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+* - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+* - ABORTED: The Core operation was aborted.
+* - ABORTED: The repository operation was aborted.
+* - ACCESS_DENIED: Access to the repository source was denied.
+* - SOURCE_UNAVAILABLE: The repository source is unavailable.
+* - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+* - INVALID_SOURCE_DATA: The repository source returned invalid data.
+*/
+var inspectCodingAgentIntegration = async (reader, instructions, limits, signal) => {
+	const collector = createCoreDiagnosticCollector(limits, "validate-project");
+	const context = {
+		instructions,
+		ledger: getRetainedMemory(reader),
+		reader,
+		report: (code, subject, details, qualifier) => {
+			collector.add({
+				code,
+				path: subject,
+				subject,
+				qualifier: qualifier ?? null,
+				entity: { integrationPath: subject },
+				details
+			});
+		},
+		...signal === void 0 ? {} : { signal }
+	};
+	await inspectClaudeIntegration(context, await inspectAgentsIntegration(context));
+	return collector.finalize();
+};
 //#endregion
 //#region src/impact-pattern-validation/inspection.ts
 /** Identifies the canonical document owning an impact relationship. */
@@ -2899,7 +3169,7 @@ var inspectUniversalProject = async (context, options) => {
 		addDiagnostics(collector, mirrorInspection.diagnostics);
 	}
 	session.throwIfAborted();
-	addDiagnostics(collector, await inspectCodingAgentIntegration(session.reader, options.limits, signal));
+	addDiagnostics(collector, await inspectCodingAgentIntegration(session.reader, session.instructions, options.limits, signal));
 	const patterns = indexedManifest === null ? {
 		completed: false,
 		diagnostics: []
@@ -2909,7 +3179,9 @@ var inspectUniversalProject = async (context, options) => {
 	const diagnostics = applyWarningAcceptances(collector.finalize(), indexedManifest?.value.acceptedWarnings ?? [], /* @__PURE__ */ new Set([...[
 		"MOLDEA_INTEGRATION_BLOCK_MISSING",
 		"MOLDEA_INTEGRATION_SKILL_MISSING",
-		"MOLDEA_INTEGRATION_BLOCK_STALE"
+		"MOLDEA_INTEGRATION_BLOCK_STALE",
+		"MOLDEA_INTEGRATION_LINK_UNRESOLVED",
+		"MOLDEA_INTEGRATION_CLAUDE_IMPORT_MISSING"
 	], ...patterns.completed ? ["MOLDEA_IMPACT_PATTERN_UNMATCHED"] : []]), options.limits);
 	const project = !diagnostics.some((diagnostic) => diagnostic.severity === "error") && indexedManifest !== null && projectAssets.project !== null ? createProjectIndex({
 		agentMirrors,
@@ -2939,7 +3211,7 @@ var invalidArgument$1 = () => {
 	});
 };
 var isRepositoryReader = (candidate) => {
-	return isRecord(candidate) && isRecord(candidate["snapshot"]) && typeof candidate["snapshot"]["id"] === "string" && typeof candidate["snapshot"]["sourceKind"] === "string" && typeof candidate["compare"] === "function" && typeof candidate["getEntry"] === "function" && typeof candidate["listEntriesPage"] === "function" && typeof candidate["readFilePage"] === "function";
+	return isRecord(candidate) && isRecord(candidate["snapshot"]) && typeof candidate["snapshot"]["id"] === "string" && typeof candidate["snapshot"]["sourceKind"] === "string" && typeof candidate["compare"] === "function" && typeof candidate["getEntry"] === "function" && typeof candidate["listEntriesPage"] === "function" && typeof candidate["readFilePage"] === "function" && typeof candidate["readLinkText"] === "function";
 };
 var isAbortSignal = (candidate) => {
 	return isRecord(candidate) && typeof candidate["aborted"] === "boolean" && typeof candidate["addEventListener"] === "function" && typeof candidate["removeEventListener"] === "function";
@@ -2948,9 +3220,11 @@ var validateInput = (candidate) => {
 	try {
 		if (!isRecord(candidate)) return invalidArgument$1();
 		const repository = candidate["repository"];
+		const instructions = candidate["instructions"];
 		const signal = candidate["signal"];
-		if (Reflect.ownKeys(candidate).some((key) => key !== "repository" && key !== "signal") || !isRepositoryReader(repository) || signal !== void 0 && !isAbortSignal(signal)) return invalidArgument$1();
+		if (Reflect.ownKeys(candidate).some((key) => key !== "repository" && key !== "instructions" && key !== "signal") || !isRepositoryReader(repository) || instructions !== void 0 && !isRepositoryReader(instructions) || signal !== void 0 && !isAbortSignal(signal)) return invalidArgument$1();
 		return {
+			...instructions === void 0 ? {} : { instructions },
 			repository,
 			...signal === void 0 ? {} : { signal }
 		};
@@ -2961,7 +3235,7 @@ var validateInput = (candidate) => {
 };
 /**
 * Inspects one coherent repository snapshot through universal file and export validation.
-* @param input The untrusted source-neutral reader and optional cancellation signal.
+* @param input The untrusted source-neutral reader, optional instruction reader, and signal.
 * @param options The immutable Core configuration snapshot.
 * @returns A promise resolving to the frozen all-or-nothing project inspection result.
 * @throws
@@ -2983,7 +3257,7 @@ var validateInput = (candidate) => {
 var validateProjectState = async (input, options) => {
 	const validatedInput = validateInput(input);
 	const operationOptions = createCoreOperationOptionsSnapshot(options);
-	const session = createRepositoryInspectionSession(validatedInput.repository, operationOptions.limits, validatedInput.signal);
+	const session = createRepositoryInspectionSession(validatedInput.repository, operationOptions.limits, validatedInput.signal, validatedInput.instructions);
 	const universal = await inspectUniversalProject({
 		session,
 		...validatedInput.signal === void 0 ? {} : { signal: validatedInput.signal }
@@ -3363,4 +3637,4 @@ var createCore = (options) => {
 //#endregion
 export { createCore as n, parseIntegrationBlock as r, core_exports as t };
 
-//# sourceMappingURL=core-FyfprJqa.js.map
+//# sourceMappingURL=core-BCMf-ig9.js.map