@farming-labs/docs 0.2.50 → 0.2.53

package/dist/{agents-DjhjZaNP.mjs → agents-CW-zTNKP.mjs}

@@ -1,10 +1,11 @@
-import { $ as renderDocsAgentsDocument, C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, it as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-CaOBIVFy.mjs";
-import "./search-BWuU70B0.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-xEHtDUDB.mjs";
+import "./agent-contract-b0akaPcg.mjs";
+import { C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, st as resolveDocsAgentFeedbackConfig, t as DEFAULT_AGENTS_MD_ROUTE, tt as renderDocsAgentsDocument } from "./agent-BMxMpEa0.mjs";
+import "./search-CJNLkdjX.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-DnilMEiZ.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-tiQCZ46q.mjs";
-import { t as detectFramework } from "./utils-D-xTRNuh.mjs";
+import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-DhIyFsy9.mjs";
+import { t as detectFramework } from "./utils-CMZTjRQT.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-CW1LnxaQ.mjs";
+import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-BxfYhp1L.mjs";
 import pc from "picocolors";
 
 //#region src/cli/index.ts
@@ -105,57 +105,67 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-Ch5On0zm.mjs");
+		const { init } = await import("../init-Cmz-oqnp.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-Tm9Ss4D6.mjs");
+		const { dev } = await import("../dev-DFeVU2Ui.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-C_Ok9rC5.mjs");
+		const { runCloudDeploy } = await import("../cloud-zs0qAnKJ.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-C_Ok9rC5.mjs");
+		const { runCloudPreview } = await import("../cloud-zs0qAnKJ.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-C_Ok9rC5.mjs");
+		const { runCloudDeploy } = await import("../cloud-zs0qAnKJ.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-C_Ok9rC5.mjs");
+		const { runCloudPreview } = await import("../cloud-zs0qAnKJ.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-C_Ok9rC5.mjs");
+		const { runCloudInit } = await import("../cloud-zs0qAnKJ.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-C_Ok9rC5.mjs");
+		const { syncCloudConfig } = await import("../cloud-zs0qAnKJ.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-C_Ok9rC5.mjs");
+		const { runCloudCheck } = await import("../cloud-zs0qAnKJ.mjs");
 		await runCloudCheck(cloudOptions);
 	} else if (parsedCommand.command === "cloud") {
 		console.error(pc.red(`Unknown cloud subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCloudHelp } = await import("../cloud-C_Ok9rC5.mjs");
+		const { printCloudHelp } = await import("../cloud-zs0qAnKJ.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-DuCPNHS-.mjs");
+		const { runMcp } = await import("../mcp-B4Q1PN93.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DXDOMJBw.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-2t4kZLGo.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
 			return;
 		}
 		await compactAgentDocs(agentCompactOptions);
+	} else if (parsedCommand.command === "agent" && subcommand === "export") {
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export--X9Go-wj.mjs");
+		const agentExportOptions = parseAgentExportArgs(args.slice(2));
+		if (agentExportOptions.help) {
+			printAgentExportHelp();
+			return;
+		}
+		await exportAgentBundle(agentExportOptions);
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-DXDOMJBw.mjs");
+		const { printAgentCompactHelp } = await import("../agent-2t4kZLGo.mjs");
+		const { printAgentExportHelp } = await import("../agent-export--X9Go-wj.mjs");
 		printAgentCompactHelp();
+		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-DjhjZaNP.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-CW-zTNKP.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -165,11 +175,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-DjhjZaNP.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-CW-zTNKP.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-O9o9kjN8.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CkM5tKdD.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -177,7 +187,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-lm3dt7yy.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-BEsbm0l2.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -185,7 +195,7 @@ async function main() {
 		}
 		await runReview(reviewOptions);
 	} else if ((parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") && subcommand === "validate") {
-		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-z9iT794h.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-DWM4IJPL.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -195,11 +205,11 @@ async function main() {
 	} else if (parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") {
 		console.error(pc.red(`Unknown codeblocks subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCodeBlocksValidateHelp } = await import("../codeblocks-z9iT794h.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-DWM4IJPL.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-B6nEkx86.mjs");
+		const { syncSearch } = await import("../search-CtAXkk_J.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -207,7 +217,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BEiKy4Iy.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-OPb8EdNe.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -217,11 +227,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-BEiKy4Iy.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-OPb8EdNe.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DV7u4Ire.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-BOwkq9du.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -231,11 +241,11 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-DV7u4Ire.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-BOwkq9du.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-CYEaOctn.mjs");
+		const { downgrade } = await import("../downgrade-Dj_KXV11.mjs");
 		const framework = (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0);
 		const hasVersionFlag = args.includes("--version") || args.some((arg) => arg.startsWith("--version="));
 		await downgrade({
@@ -244,7 +254,7 @@ async function main() {
 			dryRun: flags["dry-run"] === true
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-DzQtpgJM.mjs");
+		const { upgrade } = await import("../upgrade-BNdBB9tQ.mjs");
 		const framework = (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0);
 		const hasVersionFlag = args.includes("--version") || args.some((arg) => arg.startsWith("--version="));
 		const version = typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0;
@@ -276,7 +286,7 @@ ${pc.dim("Commands:")}
   ${pc.cyan("deploy")}   Sync cloud config and deploy hosted preview docs
   ${pc.cyan("preview")}  Alias for ${pc.cyan("deploy")}
   ${pc.cyan("cloud")}    Docs Cloud utilities (${pc.dim("init")}, ${pc.dim("check")}, ${pc.dim("deploy")}, ${pc.dim("preview")}, ${pc.dim("sync")})
-  ${pc.cyan("agent")}    Agent utilities (${pc.dim("compact")} to generate sibling agent.md files)
+  ${pc.cyan("agent")}    Agent utilities (${pc.dim("compact")} page context, ${pc.dim("export")} static bundles)
   ${pc.cyan("agents")}   AGENTS.md utilities (${pc.dim("generate")} for static agent instructions)
   ${pc.cyan("doctor")}   Inspect and score agent or reader-facing docs quality
   ${pc.cyan("review")}   Review changed docs files and wire Docs Review CI
@@ -346,6 +356,11 @@ ${pc.dim("Options for agent compact:")}
   ${pc.cyan("--aggressiveness <0-1>")}              Compression intensity for compacted output
   ${pc.cyan("--dry-run")}                           Resolve and compress pages without writing files
 
+${pc.dim("Options for agent export:")}
+  ${pc.cyan("agent export --public")}               Export page Markdown, llms.txt, discovery, skills, AGENTS, sitemaps, robots, and a SHA-256 manifest
+  ${pc.cyan("agent export --check")}                Fail when the static Agent Bundle is stale
+  ${pc.cyan("--config <path>")}                     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+
 ${pc.dim("Options for doctor:")}
   ${pc.cyan("doctor")}                              Score the current docs app for agent-readiness
   ${pc.cyan("doctor --agent")}                      Same as ${pc.cyan("doctor")}; explicit agent scoring mode

package/dist/client/react.d.mts

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

package/dist/{cloud-ask-ai-DcMe6xOf.d.mts → cloud-ask-ai-CMzYVzVX.d.mts}

@@ -1,4 +1,4 @@
-import { M as DocsCloudConfig, t as AIConfig, v as DocsAnalyticsConfig } from "./types-XqGLsmOD.mjs";
+import { M as DocsCloudConfig, t as AIConfig, v as DocsAnalyticsConfig } from "./types-CdKu8KmO.mjs";
 
 //#region src/cloud-ask-ai.d.ts
 interface DocsCloudAskAIConfig {

package/dist/{cloud-C_Ok9rC5.mjs → cloud-zs0qAnKJ.mjs}

@@ -1,6 +1,6 @@
-import { n as markCliErrorReported } from "./errors-CW1LnxaQ.mjs";
-import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelBooleanProperty, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-tiQCZ46q.mjs";
-import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-D-xTRNuh.mjs";
+import { n as markCliErrorReported } from "./errors-BxfYhp1L.mjs";
+import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelBooleanProperty, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-DhIyFsy9.mjs";
+import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-CMZTjRQT.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{codeblocks-z9iT794h.mjs → codeblocks-DWM4IJPL.mjs}

@@ -1,9 +1,10 @@
-import { I as findDocsMarkdownPage, tt as renderDocsMarkdownDocument } from "./agent-CaOBIVFy.mjs";
-import { _ as parseGeneratedAgentDocument, h as hashGeneratedAgentContent, m as GENERATED_AGENT_PROVENANCE_VERSION, v as serializeGeneratedAgentDocument } from "./search-BWuU70B0.mjs";
+import { a as normalizePageAgentFrontmatter, c as stripGeneratedPageAgentContractMarkdown } from "./agent-contract-b0akaPcg.mjs";
+import { R as findDocsMarkdownPage, rt as renderDocsMarkdownDocument } from "./agent-BMxMpEa0.mjs";
+import { _ as hashGeneratedAgentContent, b as serializeGeneratedAgentDocument, g as GENERATED_AGENT_PROVENANCE_VERSION, y as parseGeneratedAgentDocument } from "./search-CJNLkdjX.mjs";
 import "./index.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, l as readNumberProperty, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-tiQCZ46q.mjs";
+import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, l as readNumberProperty, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-DhIyFsy9.mjs";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
@@ -290,13 +291,9 @@ function mergeAgentCompactOptions(defaults, overrides) {
 		...Object.fromEntries(Object.entries(overrides).filter(([, value]) => value !== void 0))
 	};
 }
-function normalizeTokenBudget(value) {
-	if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
-	return Math.max(1, Math.ceil(value));
-}
 function readPageTokenBudget(pagePath) {
 	const { data } = matter(readFileSync(pagePath, "utf-8"));
-	return normalizeTokenBudget(data.agent?.tokenBudget);
+	return normalizePageAgentFrontmatter(data.agent)?.tokenBudget;
 }
 function buildCompactionSettingsHash(options) {
 	return hashGeneratedAgentContent(JSON.stringify({
@@ -317,14 +314,14 @@ function buildPageOptions(defaults, pagePath) {
 	};
 }
 function buildResolvedPageSourceDocument(page) {
-	return renderDocsMarkdownDocument({
+	return stripGeneratedPageAgentContractMarkdown(renderDocsMarkdownDocument({
 		...page,
 		agentRawContent: void 0
-	});
+	}));
 }
 function buildAgentSourceDocument(page) {
-	if (typeof page.agentRawContent === "string") return page.agentRawContent;
-	return renderDocsMarkdownDocument(page);
+	if (typeof page.agentRawContent === "string") return stripGeneratedPageAgentContractMarkdown(page.agentRawContent);
+	return stripGeneratedPageAgentContractMarkdown(renderDocsMarkdownDocument(page));
 }
 function readCurrentAgentDocument(target) {
 	if (!target.hasAgentFile || !existsSync(target.agentPath)) return void 0;

package/dist/{dev-Tm9Ss4D6.mjs → dev-DFeVU2Ui.mjs}

@@ -1,5 +1,5 @@
-import { i as detectPackageManagerFromProject } from "./utils-D-xTRNuh.mjs";
-import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-uaauJcTO.mjs";
+import { i as detectPackageManagerFromProject } from "./utils-CMZTjRQT.mjs";
+import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-Bty9M6lA.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

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

@@ -1,5 +1,5 @@
-import { b as DocsAnalyticsEventInput, v as DocsAnalyticsConfig, y as DocsAnalyticsEvent } from "./types-XqGLsmOD.mjs";
-import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-DcMe6xOf.mjs";
+import { b as DocsAnalyticsEventInput, v as DocsAnalyticsConfig, y as DocsAnalyticsEvent } from "./types-CdKu8KmO.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-CMzYVzVX.mjs";
 
 //#region src/docs-cloud-server.d.ts
 type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);

package/dist/docs-cloud-server.mjs

@@ -1,5 +1,5 @@
 import { n as sendDocsCloudAnalyticsEvent } from "./cloud-analytics-Dlk_byos.mjs";
-import { t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-Cl-xaV8j.mjs";
+import { t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-BFlx8VMO.mjs";
 
 //#region src/docs-cloud-server.ts
 const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";

package/dist/{doctor-O9o9kjN8.mjs → doctor-CkM5tKdD.mjs}

@@ -1,13 +1,14 @@
-import "./reading-time-CPAy1SWO.mjs";
-import { Ct as DEFAULT_SITEMAP_XML_ROUTE, P as buildDocsMcpEndpointCandidates, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, St as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, kt as resolveDocsSitemapConfig, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, xt as DEFAULT_SITEMAP_MD_ROUTE } from "./agent-CaOBIVFy.mjs";
-import "./search-BWuU70B0.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-XVPs9lVz.mjs";
-import "./sitemap-server-xEHtDUDB.mjs";
+import "./reading-time-BuK2YL23.mjs";
+import "./agent-contract-b0akaPcg.mjs";
+import { Et as DEFAULT_SITEMAP_XML_ROUTE, F as buildDocsMcpEndpointCandidates, Mt as resolveDocsSitemapConfig, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, wt as DEFAULT_SITEMAP_MD_ROUTE } from "./agent-BMxMpEa0.mjs";
+import "./search-CJNLkdjX.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-C6uQG-fS.mjs";
+import "./sitemap-server-DnilMEiZ.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-tiQCZ46q.mjs";
-import { t as detectFramework } from "./utils-D-xTRNuh.mjs";
-import { n as inspectAgentCompactionState, o as scanDocsPageTargets, t as compactAgentDocs } from "./codeblocks-z9iT794h.mjs";
+import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-DhIyFsy9.mjs";
+import { t as detectFramework } from "./utils-CMZTjRQT.mjs";
+import { n as inspectAgentCompactionState, o as scanDocsPageTargets, t as compactAgentDocs } from "./codeblocks-DWM4IJPL.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";
@@ -962,7 +963,7 @@ async function postMcpJson(baseUrl, route, body, sessionId) {
 		body: JSON.stringify(body)
 	});
 }
-async function probeMcpRoute(baseUrl, route) {
+async function probeMcpRoute(baseUrl, route, expectedTools) {
 	try {
 		const initializeResponse = await postMcpJson(baseUrl, route, {
 			jsonrpc: "2.0",
@@ -1008,15 +1009,7 @@ async function probeMcpRoute(baseUrl, route) {
 		};
 		const tools = toolsPayload.result?.tools;
 		const toolNames = Array.isArray(tools) ? tools.map((tool) => tool.name).filter((name) => typeof name === "string") : [];
-		const missingTools = [
-			"list_docs",
-			"list_pages",
-			"get_navigation",
-			"search_docs",
-			"read_page",
-			"get_code_examples",
-			"get_config_schema"
-		].filter((tool) => !toolNames.includes(tool));
+		const missingTools = expectedTools.filter((tool) => !toolNames.includes(tool));
 		if (missingTools.length > 0) return {
 			ok: false,
 			detail: `${route} connected but is missing tools: ${missingTools.join(", ")}.`
@@ -1032,10 +1025,10 @@ async function probeMcpRoute(baseUrl, route) {
 		};
 	}
 }
-async function probeMcpRouteCandidates(baseUrl, routes) {
+async function probeMcpRouteCandidates(baseUrl, routes, expectedTools) {
 	const candidates = buildDocsMcpEndpointCandidates(baseUrl, routes);
 	const probes = await Promise.all(candidates.map(async (candidate) => {
-		const probe = await probeMcpRoute(candidate.baseUrl, candidate.route);
+		const probe = await probeMcpRoute(candidate.baseUrl, candidate.route, expectedTools);
 		return {
 			...probe,
 			detail: `${candidate.label}: ${probe.detail}`
@@ -1085,6 +1078,22 @@ function hostedMcpRoutes(discoveryBody) {
 	if (declaredRoutes.length > 0) return Array.from(new Set(declaredRoutes));
 	return Array.from(new Set([readDiscoveryRoute(mcp?.publicEndpoint) ?? DEFAULT_MCP_PUBLIC_ROUTE, readDiscoveryRoute(mcp?.wellKnownEndpoint) ?? DEFAULT_MCP_WELL_KNOWN_ROUTE]));
 }
+const MCP_DISCOVERY_TOOL_NAMES = [
+	["listDocs", "list_docs"],
+	["listPages", "list_pages"],
+	["listTasks", "list_tasks"],
+	["readTask", "read_task"],
+	["getNavigation", "get_navigation"],
+	["searchDocs", "search_docs"],
+	["readPage", "read_page"],
+	["getCodeExamples", "get_code_examples"],
+	["getConfigSchema", "get_config_schema"],
+	["getContext", "get_context"]
+];
+function hostedMcpExpectedTools(discoveryBody) {
+	const tools = asRecord(asRecord(asRecord(discoveryBody)?.mcp)?.tools);
+	return MCP_DISCOVERY_TOOL_NAMES.filter(([flag]) => tools?.[flag] !== false).map(([, name]) => name);
+}
 function hostedCapability(discoveryBody, key) {
 	const root = asRecord(discoveryBody);
 	const capability = asRecord(root?.capabilities)?.[key];
@@ -1226,10 +1235,13 @@ async function buildHostedAgentChecks(url, pages) {
 	const markdownAlternateScore = hostedSurfaceScore(htmlPageProbes, (probe) => probe.hasMarkdownAlternate);
 	const markdownRoutesEnabled = hostedCapability(discovery.body, "markdownRoutes");
 	checks.push(makeCheck("hosted-markdown-alternate", "Hosted markdown alternate links", markdownRoutesEnabled === false ? "warn" : markdownAlternateScore.status, markdownRoutesEnabled === false ? 0 : markdownAlternateScore.score, 5, markdownRoutesEnabled === false ? "The hosted discovery spec reports markdown routes as disabled." : markdownAlternateScore.total > 0 ? `${markdownAlternateScore.passed}/${markdownAlternateScore.total} sampled hosted docs pages include <link rel="alternate" type="text/markdown"> pointing to .md routes.` : "No hosted docs pages were available to verify markdown alternate links.", markdownRoutesEnabled === false || markdownAlternateScore.status === "pass" ? void 0 : "Add a text/markdown alternate link in each docs page head, usually through `alternates.types['text/markdown']`, so agents can discover the page markdown URL from HTML."));
-	const mcp = await probeMcpRouteCandidates(baseUrl, hostedMcpRoutes(discovery.body));
-	const mcpPassed = mcp.probes.filter((result) => result.ok).length;
-	const mcpDetailProbes = mcpPassed > 0 ? mcp.probes.filter((result) => result.ok) : mcp.probes;
-	checks.push(makeCheck("hosted-mcp", "Hosted MCP handshake", mcpPassed > 0 ? "pass" : "fail", mcpPassed > 0 ? 10 : 0, 10, mcpDetailProbes.map((result) => result.detail).join(" "), mcpPassed > 0 ? void 0 : `Verify one of ${mcp.labels.join(" or ")} supports Streamable HTTP initialize and tools/list.`));
+	if (hostedCapability(discovery.body, "mcp") === false) checks.push(makeCheck("hosted-mcp", "Hosted MCP handshake", "warn", 0, 10, "The hosted discovery spec reports MCP as disabled.", "Enable MCP when agents should use structured list/search/read tools."));
+	else {
+		const mcp = await probeMcpRouteCandidates(baseUrl, hostedMcpRoutes(discovery.body), hostedMcpExpectedTools(discovery.body));
+		const mcpPassed = mcp.probes.filter((result) => result.ok).length;
+		const mcpDetailProbes = mcpPassed > 0 ? mcp.probes.filter((result) => result.ok) : mcp.probes;
+		checks.push(makeCheck("hosted-mcp", "Hosted MCP handshake", mcpPassed > 0 ? "pass" : "fail", mcpPassed > 0 ? 10 : 0, 10, mcpDetailProbes.map((result) => result.detail).join(" "), mcpPassed > 0 ? void 0 : `Verify one of ${mcp.labels.join(" or ")} supports Streamable HTTP initialize and tools/list.`));
+	}
 	return {
 		baseUrl,
 		checks

package/dist/{downgrade-CYEaOctn.mjs → downgrade-Dj_KXV11.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec, s as execOutput } from "./utils-D-xTRNuh.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-C8PigBZk.mjs";
+import { c as fileExists, o as exec, s as execOutput } from "./utils-CMZTjRQT.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-DxnTZH4m.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/i18n-CAlj1ADU.mjs

@@ -0,0 +1,40 @@
+//#region src/i18n.ts
+function normalizeSegment(value) {
+	return value.replace(/^\/+|\/+$/g, "");
+}
+function splitSegments(value) {
+	const cleaned = normalizeSegment(value);
+	return cleaned ? cleaned.split("/").filter(Boolean) : [];
+}
+function resolveDocsI18n(config) {
+	if (!config || !Array.isArray(config.locales)) return null;
+	const locales = Array.from(new Set(config.locales.map((l) => l.trim()).filter(Boolean)));
+	if (locales.length === 0) return null;
+	return {
+		locales,
+		defaultLocale: config.defaultLocale && locales.includes(config.defaultLocale) ? config.defaultLocale : locales[0]
+	};
+}
+function resolveDocsLocale(searchParams, i18n) {
+	if (!i18n) return void 0;
+	const raw = searchParams.get("lang") ?? searchParams.get("locale");
+	if (!raw) return void 0;
+	if (i18n.locales.includes(raw)) return raw;
+	return i18n.defaultLocale;
+}
+function resolveDocsPath(pathname, entry) {
+	const entryBase = normalizeSegment(entry || "docs") || "docs";
+	const entryParts = splitSegments(entryBase);
+	const pathParts = splitSegments(pathname);
+	let rest = pathParts;
+	if (entryParts.length > 0) {
+		if (pathParts.slice(0, entryParts.length).join("/") === entryParts.join("/")) rest = pathParts.slice(entryParts.length);
+	}
+	return {
+		slug: rest.join("/"),
+		entryPath: entryBase
+	};
+}
+
+//#endregion
+export { resolveDocsLocale as n, resolveDocsPath as r, resolveDocsI18n as t };