@farming-labs/docs 0.2.58 → 0.2.60

package/dist/{agent-BFtIbSyJ.mjs → agent-DlxriaTs.mjs}

@@ -1,5 +1,5 @@
-import { $t as stripGeneratedPageAgentContractMarkdown, Xt as normalizePageAgentFrontmatter, it as renderDocsMarkdownDocument, z as findDocsMarkdownPage } from "./agent-CxDzPqtl.mjs";
-import { _ as hashGeneratedAgentContent, b as serializeGeneratedAgentDocument, g as GENERATED_AGENT_PROVENANCE_VERSION, y as parseGeneratedAgentDocument } from "./search-Bo9ubPVO.mjs";
+import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument, vn as normalizePageAgentFrontmatter, xn as stripGeneratedPageAgentContractMarkdown } from "./agent-BFqyqEnC.mjs";
+import { _ as hashGeneratedAgentContent, b as serializeGeneratedAgentDocument, g as GENERATED_AGENT_PROVENANCE_VERSION, y as parseGeneratedAgentDocument } from "./search-D57JXQLj.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import { c as readEnvReferenceProperty, d as readStringProperty, h as resolveDocsContentDir, i as loadDocsConfigModule, l as readNavTitle, m as resolveDocsConfigPath, o as loadProjectEnv, p as readTopLevelStringProperty, s as readBooleanProperty, t as extractNestedObjectLiteral, u as readNumberProperty } from "./config-DASewQ0x.mjs";
 import { createRequire } from "node:module";

package/dist/{agent-evals-BW0vEc-F.mjs → agent-evals-kJs2Y9xR.mjs}

@@ -1,4 +1,4 @@
-import { f as resolveSearchRequestConfig, p as findDocsMarkdownSection, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-Bo9ubPVO.mjs";
+import { f as resolveSearchRequestConfig, p as findDocsMarkdownSection, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-D57JXQLj.mjs";
 import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-CCaIY1aK.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
 import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-qe0T8-xe.mjs";

package/dist/{agent-export-vsdq0Huq.mjs → agent-export-BgUaiW8f.mjs}

@@ -1,9 +1,9 @@
-import { Ft as renderDocsSitemapMarkdown, It as renderDocsSitemapXml, Lt as resolveDocsSitemapConfig, M as buildDocsAgentDiscoverySpec, Mt as buildDocsSitemapManifest, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, bt as toDocsMarkdownUrl, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsAgentFeedbackConfig, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsMarkdownDocument, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsSkillDocument, rt as renderDocsLlmsTxt, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-CxDzPqtl.mjs";
-import "./search-Bo9ubPVO.mjs";
+import { Lt as renderDocsSitemapMarkdown, M as buildDocsAgentDiscoverySpec, Pt as buildDocsSitemapManifest, Rt as renderDocsSitemapXml, St as toDocsMarkdownUrl, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, en as buildDocsAgentSkillsIndex, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, on as resolveDocsPublishedAgentSkill, qt as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, zt as resolveDocsSitemapConfig } from "./agent-BFqyqEnC.mjs";
+import "./search-D57JXQLj.mjs";
 import { t as resolveDocsI18n } from "./i18n-CAlj1ADU.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DRpoiYAV.mjs";
-import "./sitemap-server-BYwE0zXs.mjs";
-import "./agent-evals-BW0vEc-F.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-ltltiLJF.mjs";
+import "./sitemap-server-C1ibVKOy.mjs";
+import "./agent-evals-kJs2Y9xR.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-qe0T8-xe.mjs";
 import "./server.mjs";
@@ -448,6 +448,7 @@ function resolveRobotsOutput(publicDir, entry, sitemap, robots) {
 	const existing = readExisting(absolutePath);
 	const generatedBlock = renderDocsRobotsGeneratedBlock({
 		entry,
+		apiCatalog: false,
 		sitemap,
 		baseUrl: robots.baseUrl,
 		robots
@@ -617,8 +618,8 @@ async function exportAgentBundle(options = {}) {
 	const siteDescription = llmsConfig?.siteDescription ?? metadataDescription;
 	const resolvedSiteTitle = llmsConfig?.siteTitle ?? siteTitle;
 	const sitemapInput = config?.sitemap ?? readStaticSitemapConfig(configContent) ?? true;
-	const baseUrl = llmsConfig?.baseUrl ?? (typeof sitemapInput === "object" ? sitemapInput.baseUrl : void 0);
 	const robotsInput = config?.robots ?? readStaticRobotsConfig(configContent) ?? true;
+	const baseUrl = llmsConfig?.baseUrl ?? (typeof sitemapInput === "object" ? sitemapInput.baseUrl : void 0) ?? (typeof robotsInput === "object" ? robotsInput.baseUrl : void 0);
 	const i18n = resolveDocsI18n(config?.i18n ?? readStaticI18nConfig(configContent));
 	const publicDirectory = detectFramework(rootDir) === "sveltekit" ? "static" : "public";
 	const publicDir = resolveContainedPath(rootDir, publicDirectory);
@@ -658,6 +659,7 @@ async function exportAgentBundle(options = {}) {
 	const openapi = { enabled: false };
 	const llms = {
 		enabled: llmsEnabled,
+		apiCatalog: false,
 		baseUrl,
 		siteTitle: resolvedSiteTitle,
 		siteDescription,
@@ -668,6 +670,8 @@ async function exportAgentBundle(options = {}) {
 	const documentOptions = {
 		origin: baseUrl ?? "/",
 		entry: routeEntry || "docs",
+		apiRoute: config?.cloud?.apiRoute,
+		apiCatalog: false,
 		search: false,
 		mcp,
 		feedback,
@@ -784,13 +788,19 @@ async function exportAgentBundle(options = {}) {
 		}
 	}
 	if (robots.enabled) outputs.push(resolveRobotsOutput(publicDir, routeEntry || "docs", sitemapInput, robots));
+	outputs = resolveUserOwnedOverrides(outputs, previous);
+	const publishedAgentSkill = await resolveDocsPublishedAgentSkill({
+		preferredDocument: outputs.find((output) => output.route === DEFAULT_SKILL_MD_ROUTE)?.content ?? normalizeContent(publicSkill),
+		fallbackDocument: normalizeContent(generatedSkill)
+	});
+	addOutput(outputs, publicDir, publishedAgentSkill.url, "skill", "text/markdown", publishedAgentSkill.content);
+	addOutput(outputs, publicDir, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, "discovery", "application/json", JSON.stringify(buildDocsAgentSkillsIndex(publishedAgentSkill), null, 2));
 	assertOutputPathsDoNotCollide({
 		outputs,
 		internalOutputs,
 		publicManifestPath,
 		internalManifestPath
 	});
-	outputs = resolveUserOwnedOverrides(outputs, previous);
 	outputs.sort((left, right) => left.publicPath.localeCompare(right.publicPath));
 	const stalePaths = staleManagedPaths(publicDir, previous, outputs);
 	const staleInternal = staleInternalPaths(rootDir, previous, internalOutputs);

package/dist/{agents-ChKj-VYw.mjs → agents-Djh-HXih.mjs}

@@ -1,7 +1,7 @@
-import { C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, ct as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-CxDzPqtl.mjs";
-import "./search-Bo9ubPVO.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-BYwE0zXs.mjs";
-import "./agent-evals-BW0vEc-F.mjs";
+import { C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-BFqyqEnC.mjs";
+import "./search-D57JXQLj.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-C1ibVKOy.mjs";
+import "./agent-evals-kJs2Y9xR.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-qe0T8-xe.mjs";
 import "./server.mjs";
@@ -84,6 +84,11 @@ function readSitemapBaseUrlFromConfig(content, config) {
 	const block = extractNestedObjectLiteral(content, ["sitemap"]);
 	return block ? readStringProperty(block, "baseUrl") : void 0;
 }
+function readCloudApiRouteFromConfig(content, config) {
+	if (typeof config?.cloud?.apiRoute === "string") return config.cloud.apiRoute;
+	const block = extractNestedObjectLiteral(content, ["cloud"]);
+	return block ? readStringProperty(block, "apiRoute") : void 0;
+}
 function readRobotsConfigFromStatic(content) {
 	const topLevelBoolean = readTopLevelBooleanProperty(content, "robots");
 	if (typeof topLevelBoolean === "boolean") return topLevelBoolean;
@@ -126,6 +131,7 @@ function resolveOpenApiDiscovery(config) {
 	return {
 		enabled: true,
 		url: DEFAULT_OPENAPI_SCHEMA_ROUTE,
+		urlSource: "default",
 		source: apiReference.specUrl ? "configured" : "generated",
 		specUrl: apiReference.specUrl,
 		apiReferencePath: `/${apiReference.path}`
@@ -140,6 +146,7 @@ async function generateAgents(options = {}) {
 	const siteTitle = typeof config?.nav?.title === "string" ? config.nav.title : readNavTitle(configContent) ?? "Documentation";
 	const siteDescription = typeof config?.metadata?.description === "string" ? config.metadata.description : void 0;
 	const baseUrl = readLlmsBaseUrlFromConfig(configContent, config) ?? readSitemapBaseUrlFromConfig(configContent, config);
+	const apiRoute = readCloudApiRouteFromConfig(configContent, config);
 	const llmsTxt = config?.llmsTxt;
 	const llmsEnabled = llmsTxt === false ? false : typeof llmsTxt === "object" ? llmsTxt.enabled ?? true : true;
 	const llmsConfig = typeof llmsTxt === "object" ? llmsTxt : void 0;
@@ -148,6 +155,7 @@ async function generateAgents(options = {}) {
 	const generatedContent = normalizeGeneratedContent(renderDocsAgentsDocument({
 		origin: baseUrl ?? "http://localhost",
 		entry,
+		apiRoute,
 		search: config?.search,
 		mcp: resolveDocsMcpConfig(config?.mcp),
 		feedback: resolveDocsAgentFeedbackConfig(config?.feedback),

package/dist/cli/index.mjs

@@ -67,6 +67,7 @@ async function main() {
 		setup: subcommand === "setup",
 		deploymentId: typeof flags.deployment === "string" ? flags.deployment : void 0,
 		apiBaseUrl: typeof flags["api-base-url"] === "string" ? flags["api-base-url"] : typeof flags.url === "string" ? flags.url : void 0,
+		client: typeof flags.client === "string" ? flags.client : void 0,
 		json: typeof flags.json === "boolean" ? flags.json : void 0
 	};
 	const devOptions = {
@@ -105,10 +106,10 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-B_9ENq8Z.mjs");
+		const { init } = await import("../init-Bd_k06bR.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-CAQlbguk.mjs");
+		const { dev } = await import("../dev-DgY5xGl9.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
 		const { runCloudDeploy } = await import("../cloud-BH_sHX64.mjs");
@@ -138,10 +139,10 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-CiNww-Wu.mjs");
+		const { runMcp } = await import("../mcp-B_yXL5G5.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BFtIbSyJ.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DlxriaTs.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -149,7 +150,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-vsdq0Huq.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-BgUaiW8f.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -159,13 +160,13 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-BFtIbSyJ.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-vsdq0Huq.mjs");
+		const { printAgentCompactHelp } = await import("../agent-DlxriaTs.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-BgUaiW8f.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-ChKj-VYw.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-Djh-HXih.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -175,11 +176,11 @@ async function main() {
 	} else if (parsedCommand.command === "agents") {
 		console.error(pc.red(`Unknown agents subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentsGenerateHelp } = await import("../agents-ChKj-VYw.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-Djh-HXih.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-H8gilyTg.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CO1VMcF_.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -187,7 +188,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-BEgX7ey7.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-NC-sOdXn.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -209,7 +210,7 @@ async function main() {
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-CoajN9X1.mjs");
+		const { syncSearch } = await import("../search-o4Ud6OXv.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -217,7 +218,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-D_aXWPdJ.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-Cq-Yj_iA.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -227,11 +228,11 @@ async function main() {
 	} else if (parsedCommand.command === "sitemap") {
 		console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSitemapGenerateHelp } = await import("../sitemap-D_aXWPdJ.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-Cq-Yj_iA.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-CFlsfYdA.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DskPvGPw.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -241,7 +242,7 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-CFlsfYdA.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-DskPvGPw.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
@@ -316,7 +317,8 @@ ${pc.dim("Options for mcp:")}
   ${pc.cyan("--config <path>")}     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
   ${pc.cyan("mcp setup --deployment <id>")} Print Docs Cloud hosted MCP setup for a deployment id
   ${pc.cyan("--api-base-url <url>")} Override the hosted Docs Cloud API base URL for ${pc.cyan("mcp setup")}
-  ${pc.cyan("--json")}              Print MCP client JSON only for ${pc.cyan("mcp setup")}
+  ${pc.cyan("--client <name>")}     Emit native config for ${pc.dim("claude-code")}, ${pc.dim("cursor")}, or ${pc.dim("vscode")}
+  ${pc.cyan("--json")}              Print the selected MCP client JSON only for ${pc.cyan("mcp setup")}
 
 ${pc.dim("Options for dev:")}
   ${pc.cyan("--port <number>")}     Run the frameworkless preview on a custom port

package/dist/client/react.d.mts

@@ -1,4 +1,4 @@
-import { F as DocsAnalyticsConfig } from "../types-C1nPRXqo.mjs";
+import { F as DocsAnalyticsConfig } from "../types-XHABMh_f.mjs";
 import { ReactNode } from "react";
 
 //#region src/docs-cloud-client.d.ts

package/dist/{cloud-ask-ai-a5Juvlvh.d.mts → cloud-ask-ai-B2WnG4fF.d.mts}

@@ -1,4 +1,4 @@
-import { F as DocsAnalyticsConfig, Y as DocsCloudConfig, t as AIConfig } from "./types-C1nPRXqo.mjs";
+import { F as DocsAnalyticsConfig, Y as DocsCloudConfig, t as AIConfig } from "./types-XHABMh_f.mjs";
 
 //#region src/cloud-ask-ai.d.ts
 interface DocsCloudAskAIConfig {

package/dist/{dev-CAQlbguk.mjs → dev-DgY5xGl9.mjs}

@@ -1,5 +1,5 @@
 import { i as detectPackageManagerFromProject } from "./utils-6UCLxv4B.mjs";
-import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-CfQjpDWW.mjs";
+import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-DNw15P-x.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";

package/dist/docs-cloud-server.d.mts

@@ -1,5 +1,5 @@
-import { F as DocsAnalyticsConfig, I as DocsAnalyticsEvent, L as DocsAnalyticsEventInput } from "./types-C1nPRXqo.mjs";
-import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-a5Juvlvh.mjs";
+import { F as DocsAnalyticsConfig, I as DocsAnalyticsEvent, L as DocsAnalyticsEventInput } from "./types-XHABMh_f.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-B2WnG4fF.mjs";
 
 //#region src/docs-cloud-server.d.ts
 type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);

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

@@ -1,21 +1,22 @@
-import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-BFtIbSyJ.mjs";
-import "./reading-time-EaVom2cl.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 { d as resolveAskAISearchRequestConfig } from "./search-Bo9ubPVO.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-DRpoiYAV.mjs";
-import { a as resolveDocsMetadataBaseUrl } from "./metadata-3ljRN9MM.mjs";
-import "./sitemap-server-BYwE0zXs.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-BW0vEc-F.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-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-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-BiUg5Xe_.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)$/;
@@ -1081,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;
@@ -1237,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."));
@@ -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,

package/dist/{golden-evaluations-BiUg5Xe_.mjs → golden-evaluations-BN9u2wxw.mjs}

@@ -1,4 +1,4 @@
-import { Ct as findDocsAudienceMdxTags, Et as resolveDocsAudienceMdxContent, Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract } from "./agent-CxDzPqtl.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";