@farming-labs/docs 0.2.57 → 0.2.59

package/dist/{doctor-svA9Flsx.mjs → doctor-CO1VMcF_.mjs}

@@ -1,20 +1,22 @@
-import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-v6R0V3lm.mjs";
-import "./reading-time-W_Id2ayC.mjs";
-import { At as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, I as buildDocsMcpEndpointCandidates, Lt as resolveDocsSitemapConfig, M as buildDocsAgentDiscoverySpec, O as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, P as buildDocsConfigMap, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Wt as PAGE_AGENT_CONTRACT_FIELDS, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_XML_ROUTE, kt as DEFAULT_SITEMAP_MD_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, u as DEFAULT_DOCS_API_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE } from "./agent-CxDzPqtl.mjs";
-import "./search-OHp36znm.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-DRpoiYAV.mjs";
-import "./sitemap-server-zFYctvCa.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-BD17jOqL.mjs";
+import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-DlxriaTs.mjs";
+import { l as httpLinkHeaderHasTargetRelation } from "./reading-time-BkEft6SD.mjs";
+import { Gt as API_CATALOG_PROFILE_URI, I as buildDocsMcpEndpointCandidates, Jt as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, Kt as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, M as buildDocsAgentDiscoverySpec, Mt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Nt as DEFAULT_SITEMAP_XML_ROUTE, O as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, P as buildDocsConfigMap, Qt as DEFAULT_API_CATALOG_ROUTE, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Ut as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, Wt as API_CATALOG_MEDIA_TYPE, Xt as DEFAULT_AGENT_SKILL_FORMAT, Zt as DEFAULT_API_CATALOG_FORMAT, an as resolveDocsDiscoveryApiRoute, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, fn as PAGE_AGENT_CONTRACT_FIELDS, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_MD_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, qt as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, zt as resolveDocsSitemapConfig } from "./agent-BFqyqEnC.mjs";
+import { d as resolveAskAISearchRequestConfig } from "./search-D57JXQLj.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-ltltiLJF.mjs";
+import { a as resolveDocsMetadataBaseUrl } from "./metadata-BDuewuzq.mjs";
+import "./sitemap-server-C1ibVKOy.mjs";
+import { t as runDocsGoldenTasks } from "./agent-evals-kJs2Y9xR.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-C9awWzEQ.mjs";
+import "./code-blocks-qe0T8-xe.mjs";
 import "./server.mjs";
-import { a as loadDocsConfigModuleResultWithProjectEnv, h as resolveDocsContentDir, l as readNavTitle, m as resolveDocsConfigPath, p as readTopLevelStringProperty, r as extractTopLevelConfigObject, s as readBooleanProperty, t as extractNestedObjectLiteral } from "./config-DZbZiYEa.mjs";
-import { t as detectFramework } from "./utils-DBCCkkJS.mjs";
-import { n as analyzeAgentUsefulness, r as createAgentUsefulnessPagesFromMcp, t as analyzeAgentSurfaceDrift } from "./agent-surface-drift-rGFS38Ak.mjs";
+import { a as loadDocsConfigModuleResultWithProjectEnv, h as resolveDocsContentDir, l as readNavTitle, m as resolveDocsConfigPath, p as readTopLevelStringProperty, r as extractTopLevelConfigObject, s as readBooleanProperty, t as extractNestedObjectLiteral } from "./config-DASewQ0x.mjs";
+import { t as detectFramework } from "./utils-6UCLxv4B.mjs";
+import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-BN9u2wxw.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";
 import pc from "picocolors";
+import { createHash } from "node:crypto";
 
 //#region src/cli/doctor.ts
 const NEXT_CONFIG_PATTERN = /^next\.config\.(?:[cm]?js|[cm]?ts)$/;
@@ -1068,26 +1070,6 @@ async function probeMcpRouteCandidates(baseUrl, routes, expectedTools) {
 function asRecord(value) {
 	return value && typeof value === "object" ? value : void 0;
 }
-function isPlainRecord(value) {
-	return Boolean(asRecord(value)) && !Array.isArray(value);
-}
-function resolveGoldenEvaluationTasks(evaluationInput) {
-	if (evaluationInput === void 0 || typeof evaluationInput === "boolean") return void 0;
-	if (!isPlainRecord(evaluationInput)) return { evaluationConfig: evaluationInput };
-	if (evaluationInput.enabled === false) return void 0;
-	if ("enabled" in evaluationInput && typeof evaluationInput.enabled !== "boolean") return evaluationInput;
-	if (!("tasks" in evaluationInput)) return void 0;
-	const runtimeTasks = evaluationInput.tasks;
-	if (!Array.isArray(runtimeTasks)) return runtimeTasks;
-	return runtimeTasks.map((task) => {
-		if (!isPlainRecord(task)) return task;
-		return {
-			...task,
-			tokenBudget: task.tokenBudget ?? evaluationInput.tokenBudget,
-			topK: task.topK ?? evaluationInput.topK
-		};
-	});
-}
 function isNonEmptyString(value) {
 	return typeof value === "string" && value.trim().length > 0;
 }
@@ -1100,11 +1082,160 @@ function isHostedAgentDiscoveryManifest(value) {
 	const site = asRecord(root?.site);
 	const capabilities = asRecord(root?.capabilities);
 	const api = asRecord(root?.api);
+	const apiCatalog = asRecord(root?.apiCatalog);
 	const config = asRecord(root?.config);
 	const search = asRecord(root?.search);
+	const skillsDiscovery = asRecord(asRecord(root?.skills)?.discovery);
 	const mcp = asRecord(root?.mcp);
 	const agentContractFields = asRecord(asRecord(root?.agentContract)?.fields);
-	return Boolean(root && isNonEmptyString(root.version) && isNonEmptyString(root.name) && isNonEmptyString(root.baseUrl) && isNonEmptyString(site?.entry) && typeof capabilities?.search === "boolean" && typeof capabilities?.mcp === "boolean" && isNonEmptyString(api?.docs) && isNonEmptyString(api?.config) && isNonEmptyString(config?.endpoint) && typeof search?.enabled === "boolean" && isNonEmptyString(search?.endpoint) && typeof mcp?.enabled === "boolean" && isNonEmptyString(mcp?.endpoint) && isBooleanRecord(mcp?.tools) && agentContractFields && Object.keys(agentContractFields).length > 0);
+	const apiRoute = isNonEmptyString(api?.docs) ? resolveDocsDiscoveryApiRoute(api.docs) : void 0;
+	return Boolean(root && isNonEmptyString(root.version) && isNonEmptyString(root.name) && isNonEmptyString(root.baseUrl) && isNonEmptyString(site?.entry) && typeof capabilities?.search === "boolean" && typeof capabilities?.mcp === "boolean" && capabilities?.apiCatalog === true && capabilities?.agentSkillsDiscovery === true && apiRoute && api?.docs === apiRoute && api?.config === `${apiRoute}?format=config` && api?.apiCatalog === DEFAULT_API_CATALOG_ROUTE && api?.apiCatalogQuery === `${apiRoute}?format=${DEFAULT_API_CATALOG_FORMAT}` && api?.agentSkillsIndex === DEFAULT_AGENT_SKILLS_INDEX_ROUTE && apiCatalog?.enabled === true && apiCatalog?.route === DEFAULT_API_CATALOG_ROUTE && apiCatalog?.api === `${apiRoute}?format=${DEFAULT_API_CATALOG_FORMAT}` && apiCatalog?.mediaType === API_CATALOG_MEDIA_TYPE && apiCatalog?.profile === API_CATALOG_PROFILE_URI && skillsDiscovery?.schema === AGENT_SKILLS_DISCOVERY_SCHEMA_URI && skillsDiscovery?.index === DEFAULT_AGENT_SKILLS_INDEX_ROUTE && skillsDiscovery?.artifact === DEFAULT_AGENT_SKILLS_ROUTE_PATTERN && skillsDiscovery?.apiIndex === `${apiRoute}?format=${DEFAULT_AGENT_SKILLS_INDEX_FORMAT}` && skillsDiscovery?.apiArtifact === `${apiRoute}?format=${DEFAULT_AGENT_SKILL_FORMAT}&name={name}` && skillsDiscovery?.digest === "sha256" && config?.endpoint === `${apiRoute}?format=config` && typeof search?.enabled === "boolean" && isNonEmptyString(search?.endpoint) && typeof mcp?.enabled === "boolean" && isNonEmptyString(mcp?.endpoint) && isBooleanRecord(mcp?.tools) && agentContractFields && Object.keys(agentContractFields).length > 0);
+}
+function responseMediaType(contentType) {
+	return contentType?.split(";", 1)[0]?.trim().toLowerCase() ?? "";
+}
+function contentTypeParameter(contentType, name) {
+	if (!contentType) return void 0;
+	const parameterPattern = new RegExp(`(?:^|;)\\s*${name.replace(/[.*+?^${}()|[\\]\\]/g, "\\$&")}\\s*=\\s*(?:"([^"]*)"|([^;\\s]+))`, "i");
+	const match = contentType.match(parameterPattern);
+	return match?.[1] ?? match?.[2];
+}
+function isApiCatalogLinkset(value) {
+	const root = asRecord(value);
+	if (!Array.isArray(root?.linkset) || root.linkset.length === 0) return false;
+	let apiLinks = 0;
+	for (const rawContext of root.linkset) {
+		const context = asRecord(rawContext);
+		if (!isNonEmptyString(context?.anchor)) return false;
+		if (!Array.isArray(context.item)) continue;
+		for (const rawItem of context.item) {
+			if (!isNonEmptyString(asRecord(rawItem)?.href)) return false;
+			apiLinks += 1;
+		}
+	}
+	return apiLinks > 0;
+}
+async function probeApiCatalogRoute(baseUrl) {
+	const route = DEFAULT_API_CATALOG_ROUTE;
+	const url = joinDoctorUrl(baseUrl, route);
+	try {
+		const [getResponse, headResponse] = await Promise.all([fetchWithTimeout(url, { headers: { Accept: API_CATALOG_MEDIA_TYPE } }), fetchWithTimeout(url, {
+			method: "HEAD",
+			headers: { Accept: API_CATALOG_MEDIA_TYPE }
+		})]);
+		const text = await getResponse.text().catch(() => "");
+		let body;
+		try {
+			body = JSON.parse(text);
+		} catch {
+			body = void 0;
+		}
+		const failures = [];
+		if (!getResponse.ok) failures.push(`GET returned HTTP ${getResponse.status}`);
+		if (!headResponse.ok) failures.push(`HEAD returned HTTP ${headResponse.status}`);
+		for (const [method, response] of [["GET", getResponse], ["HEAD", headResponse]]) {
+			const contentType = response.headers.get("content-type");
+			if (responseMediaType(contentType) !== API_CATALOG_MEDIA_TYPE) failures.push(`${method} Content-Type is ${JSON.stringify(contentType ?? "<missing>")}`);
+			else if (contentTypeParameter(contentType, "profile") !== API_CATALOG_PROFILE_URI) failures.push(`${method} Content-Type is missing the RFC 9727 profile`);
+			if (!httpLinkHeaderHasTargetRelation(response.headers.get("link"), DEFAULT_API_CATALOG_ROUTE, "api-catalog", url)) failures.push(`${method} is missing an ${DEFAULT_API_CATALOG_ROUTE} rel="api-catalog" Link value`);
+		}
+		if (!isApiCatalogLinkset(body)) failures.push("GET did not return a JSON Linkset with at least one API item");
+		return failures.length === 0 ? {
+			ok: true,
+			detail: `${route} passed RFC 9727 GET and HEAD checks with a profiled JSON Linkset and api-catalog Link headers.`
+		} : {
+			ok: false,
+			detail: `${route} failed standards validation: ${failures.join("; ")}.`
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			detail: `${route} failed: ${error instanceof Error ? error.message : String(error)}.`
+		};
+	}
+}
+function isValidAgentSkillEntry(value) {
+	const entry = asRecord(value);
+	return Boolean(entry && typeof entry.name === "string" && /^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(entry.name) && entry.name.length <= 64 && entry.type === "skill-md" && isNonEmptyString(entry.description) && entry.description.length <= 1024 && isNonEmptyString(entry.url) && typeof entry.digest === "string" && /^sha256:[0-9a-f]{64}$/u.test(entry.digest));
+}
+async function probeAgentSkillsDiscovery(baseUrl) {
+	const route = DEFAULT_AGENT_SKILLS_INDEX_ROUTE;
+	const indexUrl = joinDoctorUrl(baseUrl, route);
+	try {
+		const [indexResponse, indexHeadResponse] = await Promise.all([fetchWithTimeout(indexUrl, { headers: { Accept: "application/json" } }), fetchWithTimeout(indexUrl, {
+			method: "HEAD",
+			headers: { Accept: "application/json" }
+		})]);
+		const text = await indexResponse.text().catch(() => "");
+		const failures = [];
+		let body;
+		try {
+			body = JSON.parse(text);
+		} catch {
+			body = void 0;
+		}
+		if (!indexResponse.ok) failures.push(`index returned HTTP ${indexResponse.status}`);
+		if (!indexHeadResponse.ok) failures.push(`index HEAD returned HTTP ${indexHeadResponse.status}`);
+		if (responseMediaType(indexResponse.headers.get("content-type")) !== "application/json") failures.push("index Content-Type is not application/json");
+		if (responseMediaType(indexHeadResponse.headers.get("content-type")) !== "application/json") failures.push("index HEAD Content-Type is not application/json");
+		const root = asRecord(body);
+		if (root?.$schema !== AGENT_SKILLS_DISCOVERY_SCHEMA_URI) failures.push("index $schema is not the Agent Skills discovery 0.2.0 schema");
+		const skills = Array.isArray(root?.skills) ? root.skills : [];
+		if (skills.length === 0) failures.push("index does not publish any skills");
+		if (skills.length > 100) failures.push("index publishes more than 100 skills");
+		const validSkills = skills.filter(isValidAgentSkillEntry);
+		if (validSkills.length !== skills.length) failures.push("one or more index entries have invalid name, type, description, URL, or digest fields");
+		if (new Set(validSkills.map((skill) => skill.name)).size !== validSkills.length) failures.push("index contains duplicate skill names");
+		const baseOrigin = new URL(baseUrl).origin;
+		const artifactDetails = [];
+		if (skills.length <= 100) for (const skill of validSkills) {
+			let artifactUrl;
+			try {
+				artifactUrl = new URL(skill.url, indexUrl);
+			} catch {
+				failures.push(`${skill.name} has an invalid artifact URL`);
+				continue;
+			}
+			const expectedPath = DEFAULT_AGENT_SKILLS_ROUTE_PATTERN.replace("{name}", skill.name);
+			if (artifactUrl.origin !== baseOrigin) {
+				failures.push(`${skill.name} artifact is not same-origin`);
+				continue;
+			}
+			if (!artifactUrl.pathname.endsWith(expectedPath)) {
+				failures.push(`${skill.name} artifact URL does not match ${expectedPath}`);
+				continue;
+			}
+			try {
+				const [artifactResponse, artifactHeadResponse] = await Promise.all([fetchWithTimeout(artifactUrl.toString(), { headers: { Accept: "text/markdown" } }), fetchWithTimeout(artifactUrl.toString(), {
+					method: "HEAD",
+					headers: { Accept: "text/markdown" }
+				})]);
+				const content = Buffer.from(await artifactResponse.arrayBuffer());
+				const computedDigest = `sha256:${createHash("sha256").update(content).digest("hex")}`;
+				if (!artifactResponse.ok) failures.push(`${skill.name} artifact returned HTTP ${artifactResponse.status}`);
+				else if (!artifactHeadResponse.ok) failures.push(`${skill.name} artifact HEAD returned HTTP ${artifactHeadResponse.status}`);
+				else if (responseMediaType(artifactResponse.headers.get("content-type")) !== "text/markdown") failures.push(`${skill.name} artifact Content-Type is not text/markdown`);
+				else if (responseMediaType(artifactHeadResponse.headers.get("content-type")) !== "text/markdown") failures.push(`${skill.name} artifact HEAD Content-Type is not text/markdown`);
+				else if (content.length === 0) failures.push(`${skill.name} artifact is empty`);
+				else if (computedDigest !== skill.digest) failures.push(`${skill.name} artifact digest does not match the index`);
+				else artifactDetails.push(`${skill.name} digest verified`);
+			} catch (error) {
+				failures.push(`${skill.name} artifact failed: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		}
+		return failures.length === 0 ? {
+			ok: true,
+			detail: `${route} returned a valid Agent Skills index; ${artifactDetails.join(", ")}.`
+		} : {
+			ok: false,
+			detail: `${route} failed standards validation: ${failures.join("; ")}.`
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			detail: `${route} failed: ${error instanceof Error ? error.message : String(error)}.`
+		};
+	}
 }
 function readDiscoveryRoute(value) {
 	return typeof value === "string" && value.startsWith("/") ? value : void 0;
@@ -1256,6 +1387,9 @@ async function buildHostedAgentChecks(url, pages) {
 	const discovery = await probeJsonRoute(baseUrl, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE);
 	const discoveryManifestValid = discovery.ok && isHostedAgentDiscoveryManifest(discovery.body);
 	checks.push(makeCheck("hosted-agent-discovery", "Hosted agent discovery", discoveryManifestValid ? "pass" : "fail", discoveryManifestValid ? 5 : 0, 5, `${baseUrl}: ${discovery.ok && !discoveryManifestValid ? `${discovery.detail} The payload is not a complete agent discovery manifest.` : discovery.detail}`, discoveryManifestValid ? void 0 : `Make sure ${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE} returns the complete agent discovery manifest from the shared docs API.`));
+	const [apiCatalog, agentSkills] = await Promise.all([probeApiCatalogRoute(baseUrl), probeAgentSkillsDiscovery(baseUrl)]);
+	checks.push(makeCheck("hosted-api-catalog", "Hosted RFC 9727 API catalog", apiCatalog.ok ? "pass" : "fail", apiCatalog.ok ? 5 : 0, 5, apiCatalog.detail, apiCatalog.ok ? void 0 : `Publish ${DEFAULT_API_CATALOG_ROUTE} with GET and HEAD support, the profiled ${API_CATALOG_MEDIA_TYPE} content type, a rel="api-catalog" Link header, and API links.`));
+	checks.push(makeCheck("hosted-agent-skills", "Hosted Agent Skills discovery", agentSkills.ok ? "pass" : "fail", agentSkills.ok ? 5 : 0, 5, agentSkills.detail, agentSkills.ok ? void 0 : `Publish ${DEFAULT_AGENT_SKILLS_INDEX_ROUTE} and make every indexed SKILL.md artifact match its declared SHA-256 digest.`));
 	const llms = await Promise.all([probeTextRoute(baseUrl, DEFAULT_LLMS_TXT_ROUTE), probeTextRoute(baseUrl, DEFAULT_LLMS_FULL_TXT_ROUTE)]);
 	const llmsPassed = llms.filter((result) => result.ok).length;
 	checks.push(makeCheck("hosted-llms", "Hosted llms.txt", llmsPassed === llms.length ? "pass" : llmsPassed > 0 ? "warn" : "fail", llmsPassed === llms.length ? 5 : llmsPassed > 0 ? 3 : 0, 5, llms.map((result) => result.detail).join(" "), llmsPassed === llms.length ? void 0 : "Verify deployed /llms.txt and /llms-full.txt routes return non-empty text."));
@@ -1388,7 +1522,26 @@ async function inspectAgentReadiness(options = {}) {
 		projectFramework: framework === "unknown" ? void 0 : framework
 	});
 	const evaluationInput = config?.agent?.evaluations;
-	const evaluations = await runDocsGoldenTasks(pages, resolveGoldenEvaluationTasks(evaluationInput));
+	const evaluation = resolveGoldenEvaluationInput(evaluationInput);
+	const evaluationBaseUrl = config ? resolveDocsMetadataBaseUrl(config) : void 0;
+	const evaluationMcp = resolveDocsMcpConfig(config?.mcp, { defaultName: siteTitle });
+	const askAISearch = resolveAskAISearchRequestConfig({
+		search: config?.search,
+		useMcp: config?.ai?.useMcp,
+		mcpEndpoint: evaluationMcp.route,
+		mcpEnabled: evaluationMcp.enabled,
+		mcpSearchEnabled: evaluationMcp.tools.searchDocs,
+		requestUrl: evaluationBaseUrl
+	});
+	const evaluations = await runDocsGoldenTasks(pages, evaluation.tasks, {
+		...evaluation.options,
+		search: config?.search,
+		askAISearch,
+		siteTitle,
+		baseUrl: evaluationBaseUrl,
+		rootDir,
+		codeBlocksValidate: config?.codeBlocks?.validate
+	});
 	const compactionCoverage = buildCompactionCoverage(rootDir, contentDir, entry, pages, config?.agent?.compact ?? {});
 	coverage.compaction = compactionCoverage;
 	const metadataCoverage = buildMetadataCoverage(pages);
@@ -1408,9 +1561,11 @@ async function inspectAgentReadiness(options = {}) {
 	const robotsPath = resolveRobotsFilePath(rootDir, framework, typeof robotsInput === "object" ? robotsInput : void 0);
 	const feedbackRoute = DEFAULT_AGENT_FEEDBACK_ROUTE;
 	const feedbackSchemaRoute = `${feedbackRoute}/schema`;
+	const apiRoute = resolveDocsDiscoveryApiRoute(config?.cloud?.apiRoute);
 	const discovery = buildDocsAgentDiscoverySpec({
 		origin: "http://localhost",
 		entry,
+		apiRoute,
 		search: searchEnabled,
 		mcp: mcpConfig,
 		feedback: {
@@ -1429,7 +1584,7 @@ async function inspectAgentReadiness(options = {}) {
 			entry,
 			search: {
 				enabled: searchEnabled,
-				endpoint: `${DEFAULT_DOCS_API_ROUTE}?query={query}`
+				endpoint: `${apiRoute}?query={query}`
 			},
 			mcp: {
 				enabled: mcpConfig.enabled,
@@ -1437,23 +1592,32 @@ async function inspectAgentReadiness(options = {}) {
 				tools: mcpConfig.tools
 			},
 			routes: {
-				"api.docs": DEFAULT_DOCS_API_ROUTE,
-				"api.config": DEFAULT_DOCS_CONFIG_ROUTE,
-				"config.endpoint": DEFAULT_DOCS_CONFIG_ROUTE
+				"api.docs": apiRoute,
+				"api.config": `${apiRoute}?format=config`,
+				"api.apiCatalog": DEFAULT_API_CATALOG_ROUTE,
+				"api.apiCatalogQuery": `${apiRoute}?format=${DEFAULT_API_CATALOG_FORMAT}`,
+				"api.agentSkillsIndex": DEFAULT_AGENT_SKILLS_INDEX_ROUTE,
+				"apiCatalog.route": DEFAULT_API_CATALOG_ROUTE,
+				"apiCatalog.api": `${apiRoute}?format=${DEFAULT_API_CATALOG_FORMAT}`,
+				"config.endpoint": `${apiRoute}?format=config`,
+				"skills.discovery.index": DEFAULT_AGENT_SKILLS_INDEX_ROUTE,
+				"skills.discovery.artifact": DEFAULT_AGENT_SKILLS_ROUTE_PATTERN,
+				"skills.discovery.apiIndex": `${apiRoute}?format=${DEFAULT_AGENT_SKILLS_INDEX_FORMAT}`,
+				"skills.discovery.apiArtifact": `${apiRoute}?format=${DEFAULT_AGENT_SKILL_FORMAT}&name={name}`
 			}
 		}
 	});
 	const checks = [];
 	checks.push(makeCheck("config", "Docs config", configLoad.status === "evaluated" ? "pass" : "warn", configLoad.status === "evaluated" ? 10 : 2, configCheckMax, configLoad.status === "evaluated" ? `Resolved ${path.relative(rootDir, configLoad.path).replace(/\\/g, "/")} and evaluated the config module.` : `Resolved ${path.relative(rootDir, configPath).replace(/\\/g, "/")} using static parsing fallback.`, configLoad.status === "evaluated" ? void 0 : "Fix docs.config module evaluation before relying on resolved diagnostic scores."));
 	const canScoreSurfaceDrift = configLoad.status === "evaluated";
-	checks.push(makeCheck("surface-drift", "Discovery/config/schema consistency", !canScoreSurfaceDrift ? "warn" : surfaceDrift.length === 0 ? "pass" : "fail", !canScoreSurfaceDrift ? 0 : surfaceDrift.length === 0 ? 10 : Math.max(0, 10 - surfaceDrift.length * 2), 10, !canScoreSurfaceDrift ? "Not scored because docs.config could not be evaluated; static parsing cannot prove discovery/config/schema consistency." : surfaceDrift.length === 0 ? "Resolved config, discovery metadata, MCP tool flags, config schema, and agent contract fields agree." : surfaceDrift.slice(0, 3).map((issue) => issue.message).join(" "), canScoreSurfaceDrift && surfaceDrift.length === 0 ? void 0 : canScoreSurfaceDrift ? "Align docs config, agent discovery, MCP tools, config schema, and the canonical page agent contract before publishing." : "Fix docs.config module evaluation so doctor can compare resolved config with discovery and schema surfaces."));
+	checks.push(makeCheck("surface-drift", "Discovery/config/schema consistency", !canScoreSurfaceDrift ? "warn" : surfaceDrift.length === 0 ? "pass" : "fail", !canScoreSurfaceDrift ? 0 : surfaceDrift.length === 0 ? 10 : Math.max(0, 10 - surfaceDrift.length * 2), 10, !canScoreSurfaceDrift ? "Not scored because docs.config could not be evaluated; static parsing cannot prove discovery/config/schema consistency." : surfaceDrift.length === 0 ? "Resolved config, discovery metadata, MCP tool flags, config schema, and agent contract fields agree." : surfaceDrift.slice(0, 3).map((issue) => issue.message).join(" "), canScoreSurfaceDrift && surfaceDrift.length === 0 ? void 0 : canScoreSurfaceDrift ? "Align docs config, agent discovery (including API catalog and Agent Skills routes), MCP tools, config schema, and the canonical page agent contract before publishing." : "Fix docs.config module evaluation so doctor can compare resolved config with discovery and schema surfaces."));
 	const dynamicStaticFallback = configLoad.status === "static-fallback" && /(?:\.\.\.|process\.env|import\.meta\.env|\[[^\]]+\]\s*:|:\s*[A-Za-z_$][\w$]*\s*[,}])/u.test(configContent);
 	checks.push(configLoad.status === "evaluated" ? makeCheck("config-confidence", "Config loading confidence", "pass", 5, 5, "High confidence: docs.config was evaluated with project-local environment values.") : makeCheck("config-confidence", "Config loading confidence", "warn", dynamicStaticFallback ? 1 : 2, 5, `${dynamicStaticFallback ? "Low" : "Partial"} confidence: only static config parsing succeeded. ${configLoad.error}`, "Fix docs.config module evaluation so doctor and review can inspect dynamic values, golden tasks, and resolved feature settings."));
 	const contentDirAbs = path.resolve(rootDir, contentDir);
 	checks.push(coverage.totalPages > 0 ? makeCheck("content", "Docs content", "pass", 10, 10, `Found ${coverage.totalPages} docs page${coverage.totalPages === 1 ? "" : "s"} in ${path.relative(rootDir, contentDirAbs).replace(/\\/g, "/")}.`) : makeCheck("content", "Docs content", "fail", 0, 10, `No folder-based docs pages were found in ${path.relative(rootDir, contentDirAbs).replace(/\\/g, "/")}.`, "Add index/page MDX files under the configured contentDir so the machine-readable surfaces have pages to serve."));
 	checks.push(makeCheck("api-route", "Docs API route", routeSurface.apiMounted ? "pass" : "fail", routeSurface.apiMounted ? 10 : 0, 10, routeSurface.apiDetail, routeSurface.apiMounted ? void 0 : "Wire the framework docs API route so /api/docs can serve markdown, llms.txt, sitemap, AGENTS.md, skill.md, and discovery responses."));
-	checks.push(makeCheck("public-routes", "Public agent routes", routeSurface.publicMounted ? "pass" : "fail", routeSurface.publicMounted ? 10 : 0, 10, routeSurface.publicDetail, routeSurface.publicMounted ? void 0 : "Add the framework public forwarder so /.well-known/*, /llms.txt, /sitemap.xml, /sitemap.md, /docs/sitemap.md, /AGENTS.md, /skill.md, /mcp, and .md routes resolve from the shared docs API."));
-	checks.push(makeCheck("agent-discovery", "Agent discovery spec", routeSurface.apiMounted && routeSurface.publicMounted ? "pass" : "fail", routeSurface.apiMounted && routeSurface.publicMounted ? 5 : 0, 5, routeSurface.apiMounted && routeSurface.publicMounted ? `Expected discovery endpoints are available through ${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}, ${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE}, and /api/docs?agent=spec.` : "Could not verify the shared agent discovery spec endpoints because docs API/public route wiring is incomplete.", routeSurface.apiMounted && routeSurface.publicMounted ? void 0 : "Make sure both the docs API handler and the public docs forwarder are mounted so agents can discover the site through the well-known agent spec."));
+	checks.push(makeCheck("public-routes", "Public agent routes", routeSurface.publicMounted ? "pass" : "fail", routeSurface.publicMounted ? 10 : 0, 10, routeSurface.publicDetail, routeSurface.publicMounted ? void 0 : "Add the framework public forwarder so /.well-known/api-catalog, /.well-known/agent-skills/*, the other /.well-known/* resources, /llms.txt, /sitemap.xml, /sitemap.md, /docs/sitemap.md, /AGENTS.md, /skill.md, /mcp, and .md routes resolve from the shared docs API."));
+	checks.push(makeCheck("agent-discovery", "Agent discovery spec", routeSurface.apiMounted && routeSurface.publicMounted ? "pass" : "fail", routeSurface.apiMounted && routeSurface.publicMounted ? 5 : 0, 5, routeSurface.apiMounted && routeSurface.publicMounted ? `Expected discovery endpoints are available through ${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}, ${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE}, ${DEFAULT_API_CATALOG_ROUTE}, ${DEFAULT_AGENT_SKILLS_INDEX_ROUTE}, and /api/docs?agent=spec.` : "Could not verify the shared agent discovery spec endpoints because docs API/public route wiring is incomplete.", routeSurface.apiMounted && routeSurface.publicMounted ? void 0 : "Make sure both the docs API handler and public docs forwarder expose the custom agent manifest, RFC 9727 API catalog, and Agent Skills discovery routes."));
 	checks.push(llmsEnabled ? makeCheck("llms", "llms.txt discovery", "pass", 5, 5, `Enabled via ${DEFAULT_LLMS_TXT_ROUTE} and ${DEFAULT_LLMS_FULL_TXT_ROUTE}.`) : makeCheck("llms", "llms.txt discovery", "warn", 0, 5, `${DEFAULT_LLMS_TXT_ROUTE} and ${DEFAULT_LLMS_FULL_TXT_ROUTE} are disabled in docs config.`, "Enable llmsTxt so agents and GEO crawlers can discover the docs index and full context surfaces."));
 	checks.push(sitemapConfig.enabled ? makeCheck("sitemap", "Sitemap discovery", "pass", 5, 5, `Enabled via ${[
 		sitemapConfig.xml.route,
@@ -1721,9 +1885,12 @@ async function runDoctor(options = {}) {
 	let fixes;
 	if (options.fix) {
 		fixes = await runAgentDoctorFixes(report, options);
-		report = {
+		report = fixes.some((fix) => fix.status === "applied") ? {
 			...await inspectAgentReadiness(options),
 			fixes
+		} : {
+			...report,
+			fixes
 		};
 	}
 	applyDoctorExitCode(report, options);

package/dist/{downgrade-BStNhyCc.mjs → downgrade-BZs86NVr.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec, s as execOutput } from "./utils-DBCCkkJS.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-DRIc08EU.mjs";
+import { c as fileExists, o as exec, s as execOutput } from "./utils-6UCLxv4B.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-qik_4J6C.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{agent-surface-drift-rGFS38Ak.mjs → golden-evaluations-BN9u2wxw.mjs}

@@ -1,6 +1,6 @@
-import { Ct as findDocsAudienceMdxTags, Et as resolveDocsAudienceMdxContent, Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract } from "./agent-CxDzPqtl.mjs";
-import { n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework } from "./agent-scope-B8lptqCd.mjs";
-import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-C9awWzEQ.mjs";
+import { Ot as resolveDocsAudienceMdxContent, Tt as findDocsAudienceMdxTags, _n as hasStructuredPageAgentContract, vn as normalizePageAgentFrontmatter } from "./agent-BFqyqEnC.mjs";
+import { n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework } from "./agent-scope-CCaIY1aK.mjs";
+import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-qe0T8-xe.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 
@@ -1282,6 +1282,11 @@ function collectSchemaPaths(options) {
 function schemaCoversConfigPath(schemaPaths, configPath) {
 	if (schemaPaths.has(configPath)) return true;
 	if (configPath.endsWith("[]") && schemaPaths.has(configPath.slice(0, -2))) return true;
+	for (const schemaPath of schemaPaths) {
+		if (!schemaPath.endsWith(".*")) continue;
+		const prefix = schemaPath.slice(0, -1);
+		if (configPath.startsWith(prefix) && configPath.length > prefix.length) return true;
+	}
 	return false;
 }
 function readPath(root, dotPath) {
@@ -1424,4 +1429,55 @@ function analyzeAgentSurfaceDrift(options) {
 }
 
 //#endregion
-export { extractAgentBlocks as i, analyzeAgentUsefulness as n, createAgentUsefulnessPagesFromMcp as r, analyzeAgentSurfaceDrift as t };
+//#region src/cli/golden-evaluations.ts
+function isPlainRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Normalize the runtime docs.config evaluation shape shared by doctor and review. */
+function resolveGoldenEvaluationInput(evaluationInput) {
+	if (evaluationInput === void 0 || typeof evaluationInput === "boolean") return {
+		tasks: void 0,
+		options: {}
+	};
+	if (!isPlainRecord(evaluationInput)) return {
+		tasks: { evaluationConfig: evaluationInput },
+		options: {}
+	};
+	const options = {
+		surface: evaluationInput.surface,
+		allowNetwork: evaluationInput.allowNetwork,
+		searchTimeoutMs: evaluationInput.searchTimeoutMs,
+		answer: evaluationInput.answer
+	};
+	if (evaluationInput.enabled === false) return {
+		tasks: void 0,
+		options
+	};
+	if ("enabled" in evaluationInput && typeof evaluationInput.enabled !== "boolean") return {
+		tasks: evaluationInput,
+		options
+	};
+	if (!("tasks" in evaluationInput)) return {
+		tasks: void 0,
+		options
+	};
+	const runtimeTasks = evaluationInput.tasks;
+	if (!Array.isArray(runtimeTasks)) return {
+		tasks: runtimeTasks,
+		options
+	};
+	return {
+		tasks: runtimeTasks.map((task) => {
+			if (!isPlainRecord(task)) return task;
+			return {
+				...task,
+				tokenBudget: task.tokenBudget ?? evaluationInput.tokenBudget,
+				topK: task.topK ?? evaluationInput.topK
+			};
+		}),
+		options
+	};
+}
+
+//#endregion
+export { extractAgentBlocks as a, createAgentUsefulnessPagesFromMcp as i, analyzeAgentSurfaceDrift as n, analyzeAgentUsefulness as r, resolveGoldenEvaluationInput as t };