@farming-labs/docs 0.2.59 → 0.2.61

package/dist/agent-skills-vite.mjs

@@ -0,0 +1,70 @@
+import "./standards-discovery-C54V_aJH.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-CIeBszxp.mjs";
+
+//#region src/agent-skills-vite.ts
+const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";
+const RESOLVED_BUNDLE_MODULE = "\0farming-labs:agent-skills-bundle";
+function isBundleModuleId(id) {
+	if (id === RESOLVED_BUNDLE_MODULE) return true;
+	const cleanId = id.split("?", 1)[0].replaceAll("\\", "/");
+	return /(?:^|\/)agent-skills-bundle\.(?:[cm]?js|ts)$/.test(cleanId);
+}
+function serializeContent(content) {
+	return typeof content === "string" ? { text: content } : { base64: Buffer.from(content).toString("base64") };
+}
+function serializeSkill(skill) {
+	return {
+		...skill,
+		content: serializeContent(skill.content),
+		files: skill.files.map((file) => ({
+			...file,
+			content: serializeContent(file.content)
+		}))
+	};
+}
+/** Render a self-contained virtual module without relying on Node at runtime. */
+function renderDocsAgentSkillsBundle(skills) {
+	return `const snapshot = ${JSON.stringify(skills.map(serializeSkill)).replaceAll("\u2028", "\\u2028").replaceAll("\u2029", "\\u2029")};
+function decodeBase64(value) {
+  const binary = globalThis.atob(value);
+  const bytes = new Uint8Array(binary.length);
+  for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+  return bytes;
+}
+function hydrateContent(content) {
+  return typeof content.text === "string" ? content.text : decodeBase64(content.base64);
+}
+export const bundledAgentSkills = snapshot.map((skill) => ({
+  ...skill,
+  content: hydrateContent(skill.content),
+  files: skill.files.map((file) => ({ ...file, content: hydrateContent(file.content) })),
+}));
+`;
+}
+/**
+* Snapshot configured Agent Skills into the server bundle.
+*
+* The same plugin object works in Vite, Astro/Svelte/TanStack, and Nitro's
+* Rollup build. Paths remain relative to the project root unless overridden.
+*/
+function docsAgentSkills(config, options = {}) {
+	let source;
+	return {
+		name: "farming-labs-agent-skills",
+		enforce: "pre",
+		resolveId(id) {
+			return id === DOCS_AGENT_SKILLS_BUNDLE_MODULE ? RESOLVED_BUNDLE_MODULE : void 0;
+		},
+		async load(id) {
+			if (!isBundleModuleId(id)) return void 0;
+			source ??= resolveConfiguredAgentSkills(config.agent?.skills, {
+				rootDir: options.rootDir ?? config.rootDir ?? process.cwd(),
+				workspaceRoot: options.workspaceRoot
+			}).then(renderDocsAgentSkillsBundle);
+			return source;
+		}
+	};
+}
+
+//#endregion
+export { DOCS_AGENT_SKILLS_BUNDLE_MODULE, docsAgentSkills, renderDocsAgentSkillsBundle };

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

@@ -1,12 +1,14 @@
-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 { $ as renderDocsAgentsDocument, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-Fl0pjVNF.mjs";
+import "./standards-discovery-C54V_aJH.mjs";
+import "./search-9OnMGMvt.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-D_0Kzanj.mjs";
+import "./agent-evals-f4_OL10T.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
+import "./code-blocks-DnNVNK2M.mjs";
+import "./agent-skills-server-CIeBszxp.mjs";
 import "./server.mjs";
-import { d as readStringProperty, i as loadDocsConfigModule, l as readNavTitle, m as resolveDocsConfigPath, p as readTopLevelStringProperty, s as readBooleanProperty, t as extractNestedObjectLiteral } from "./config-DASewQ0x.mjs";
-import { t as detectFramework } from "./utils-6UCLxv4B.mjs";
+import { a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { t as detectFramework } from "./utils-DpiIioYb.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-CVqZ3kOO.mjs";
+import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-DbOhkE1h.mjs";
 import pc from "picocolors";
 
 //#region src/cli/index.ts
@@ -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,43 +106,43 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-B_9ENq8Z.mjs");
+		const { init } = await import("../init-CQY0Woe3.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-CAQlbguk.mjs");
+		const { dev } = await import("../dev-Cmy6DtdF.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-BH_sHX64.mjs");
+		const { runCloudDeploy } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-BH_sHX64.mjs");
+		const { runCloudPreview } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-BH_sHX64.mjs");
+		const { runCloudDeploy } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-BH_sHX64.mjs");
+		const { runCloudPreview } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-BH_sHX64.mjs");
+		const { runCloudInit } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-BH_sHX64.mjs");
+		const { syncCloudConfig } = await import("../cloud-pdNC-tyj.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-BH_sHX64.mjs");
+		const { runCloudCheck } = await import("../cloud-pdNC-tyj.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-BH_sHX64.mjs");
+		const { printCloudHelp } = await import("../cloud-pdNC-tyj.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-BAJr3wC2.mjs");
+		const { runMcp } = await import("../mcp-DyPcoLwm.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DlxriaTs.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DFHlw_JC.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-BgUaiW8f.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-D0zQhasD.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-DlxriaTs.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-BgUaiW8f.mjs");
+		const { printAgentCompactHelp } = await import("../agent-DFHlw_JC.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-D0zQhasD.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-Djh-HXih.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-ibnXrWyp.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-Djh-HXih.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-ibnXrWyp.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CO1VMcF_.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CXostbsI.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-NC-sOdXn.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-D2UBrxFq.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -195,7 +196,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-Bq67u32v.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-CFuurVIH.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -205,11 +206,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-Bq67u32v.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-CFuurVIH.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-o4Ud6OXv.mjs");
+		const { syncSearch } = await import("../search-CNsRpz90.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-Cq-Yj_iA.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BpYnSsfJ.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-Cq-Yj_iA.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-BpYnSsfJ.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DskPvGPw.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-5Yqz9mz7.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -241,11 +242,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-DskPvGPw.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-5Yqz9mz7.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-BZs86NVr.mjs");
+		const { downgrade } = await import("../downgrade-w7e6Se0L.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({
@@ -254,7 +255,7 @@ async function main() {
 			dryRun: flags["dry-run"] === true
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-BCJTCW3O.mjs");
+		const { upgrade } = await import("../upgrade-oz-GChgt.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;
@@ -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-XHABMh_f.mjs";
+import { R as DocsAnalyticsConfig } from "../types-EhFhYGfr.mjs";
 import { ReactNode } from "react";
 
 //#region src/docs-cloud-client.d.ts

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

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

package/dist/{cloud-BH_sHX64.mjs → cloud-pdNC-tyj.mjs}

@@ -1,6 +1,6 @@
-import { n as markCliErrorReported } from "./errors-CVqZ3kOO.mjs";
-import { d as readStringProperty, f as readTopLevelBooleanProperty, h as resolveDocsContentDir, i as loadDocsConfigModule, l as readNavTitle, m as resolveDocsConfigPath, o as loadProjectEnv, p as readTopLevelStringProperty, t as extractNestedObjectLiteral } from "./config-DASewQ0x.mjs";
-import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-6UCLxv4B.mjs";
+import { n as markCliErrorReported } from "./errors-DbOhkE1h.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-DpiIioYb.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";

package/dist/{codeblocks-Bq67u32v.mjs → codeblocks-CFuurVIH.mjs}

@@ -1,5 +1,5 @@
-import { a as validateCodeBlocks, r as resolveDocsCodeBlocksValidateConfig } from "./code-blocks-qe0T8-xe.mjs";
-import { d as readStringProperty, h as resolveDocsContentDir, i as loadDocsConfigModule, m as resolveDocsConfigPath, p as readTopLevelStringProperty, s as readBooleanProperty, t as extractNestedObjectLiteral, u as readNumberProperty } from "./config-DASewQ0x.mjs";
+import { a as validateCodeBlocks, r as resolveDocsCodeBlocksValidateConfig } from "./code-blocks-DnNVNK2M.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/{config-DASewQ0x.mjs → config-Wcdj-D0a.mjs}

@@ -143,6 +143,12 @@ function extractTopLevelObjectLiteral(content, key) {
 		return braceEnd === -1 ? void 0 : normalizedProperty.slice(braceStart + 1, braceEnd);
 	}
 }
+/** Return whether an object-literal body declares a direct property with this name. */
+function hasTopLevelProperty(content, key) {
+	const escaped = escapeRegExp(key);
+	const propertyPattern = new RegExp(`^(?:${escaped}|["']${escaped}["'])\\s*:`);
+	return splitTopLevelProperties(content).some((property) => propertyPattern.test(stripLeadingPropertyTrivia(property)));
+}
 function extractTopLevelConfigObject(content) {
 	for (const marker of ["defineDocs(", "export default"]) {
 		const markerIndex = content.indexOf(marker);
@@ -360,4 +366,4 @@ async function loadDocsConfigModuleResultWithProjectEnv(rootDir, explicitPath, o
 }
 
 //#endregion
-export { loadDocsConfigModuleResultWithProjectEnv as a, readEnvReferenceProperty as c, readStringProperty as d, readTopLevelBooleanProperty as f, resolveDocsContentDir as h, loadDocsConfigModule as i, readNavTitle as l, resolveDocsConfigPath as m, extractObjectLiteral as n, loadProjectEnv as o, readTopLevelStringProperty as p, extractTopLevelConfigObject as r, readBooleanProperty as s, extractNestedObjectLiteral as t, readNumberProperty as u };
+export { resolveDocsContentDir as _, loadDocsConfigModule as a, loadProjectEnv as c, readNavTitle as d, readNumberProperty as f, resolveDocsConfigPath as g, readTopLevelStringProperty as h, hasTopLevelProperty as i, readBooleanProperty as l, readTopLevelBooleanProperty as m, extractObjectLiteral as n, loadDocsConfigModuleResult as o, readStringProperty as p, extractTopLevelConfigObject as r, loadDocsConfigModuleResultWithProjectEnv as s, extractNestedObjectLiteral as t, readEnvReferenceProperty as u };

package/dist/{dev-CAQlbguk.mjs → dev-Cmy6DtdF.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 { i as detectPackageManagerFromProject } from "./utils-DpiIioYb.mjs";
+import { Ct as tsconfigTemplate, Y as rootLayoutTemplate, g as docsLayoutTemplate, q as postcssConfigTemplate, v as globalCssTemplate } from "./templates-Bq_P7ctv.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-XHABMh_f.mjs";
-import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-B2WnG4fF.mjs";
+import { B as DocsAnalyticsEventInput, R as DocsAnalyticsConfig, z as DocsAnalyticsEvent } from "./types-EhFhYGfr.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-D7ZgF47y.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-CSyFE6SS.mjs";
-import { t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-hnJfj8-X.mjs";
+import { t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-sbpjOR2K.mjs";
 
 //#region src/docs-cloud-server.ts
 const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";

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

@@ -1,22 +1,24 @@
-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 { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-DFHlw_JC.mjs";
+import { l as httpLinkHeaderHasTargetRelation } from "./reading-time-C-SAhQT9.mjs";
+import { Dt as DEFAULT_SITEMAP_MD_ROUTE, Ft as resolveDocsSitemapConfig, Ht as PAGE_AGENT_CONTRACT_FIELDS, N as buildDocsMcpEndpointCandidates, Ot as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, dn as normalizeDocsMcpAuthorizationServerUrls, en as DEFAULT_MCP_PUBLIC_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, in as getDocsMcpProtectedResourceMetadataRoutes, j as buildDocsConfigMap, k as buildDocsAgentDiscoverySpec, kt as DEFAULT_SITEMAP_XML_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, sn as isDocsMcpOAuthScopeToken, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-Fl0pjVNF.mjs";
+import { O as resolveDocsDiscoveryApiRoute, c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, g as DEFAULT_API_CATALOG_ROUTE, h as DEFAULT_API_CATALOG_FORMAT, l as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, n as API_CATALOG_MEDIA_TYPE, p as DEFAULT_AGENT_SKILL_FORMAT, r as API_CATALOG_PROFILE_URI, s as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-C54V_aJH.mjs";
+import { d as resolveAskAISearchRequestConfig } from "./search-9OnMGMvt.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-C08kDLsz.mjs";
+import { a as resolveDocsMetadataBaseUrl } from "./metadata-Dv1ah0Aj.mjs";
+import "./sitemap-server-D_0Kzanj.mjs";
+import { t as runDocsGoldenTasks } from "./agent-evals-f4_OL10T.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
+import "./code-blocks-DnNVNK2M.mjs";
+import "./agent-skills-server-CIeBszxp.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-BN9u2wxw.mjs";
+import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, r as extractTopLevelConfigObject, s as loadDocsConfigModuleResultWithProjectEnv, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { t as detectFramework } from "./utils-DpiIioYb.mjs";
+import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CBZ_JZjf.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";
+import pc from "picocolors";
 
 //#region src/cli/doctor.ts
 const NEXT_CONFIG_PATTERN = /^next\.config\.(?:[cm]?js|[cm]?ts)$/;
@@ -1006,6 +1008,7 @@ async function probeMcpRoute(baseUrl, route, expectedTools) {
 				}
 			}
 		});
+		if (initializeResponse.status === 401) return await probeProtectedMcpDiscovery(baseUrl, route, initializeResponse);
 		const initializePayload = await parseMcpResponse(initializeResponse);
 		if (!initializeResponse.ok || initializePayload.error) return {
 			ok: false,
@@ -1053,6 +1056,125 @@ async function probeMcpRoute(baseUrl, route, expectedTools) {
 		};
 	}
 }
+async function probeProtectedMcpDiscovery(baseUrl, route, response) {
+	const bearerChallenge = findBearerChallenge(response.headers.get("www-authenticate") ?? "");
+	const rawMetadataUrl = bearerChallenge ? readHttpAuthQuotedParameter(bearerChallenge, "resource_metadata") : void 0;
+	if (!bearerChallenge || !rawMetadataUrl) return {
+		ok: false,
+		detail: `${route} requires authentication but did not return a Bearer resource_metadata challenge.`
+	};
+	const resourceUrl = new URL(joinDoctorUrl(baseUrl, route));
+	let metadataUrl;
+	try {
+		metadataUrl = new URL(rawMetadataUrl);
+	} catch {
+		return {
+			ok: false,
+			detail: `${route} returned an invalid resource_metadata URL.`
+		};
+	}
+	if (metadataUrl.origin !== resourceUrl.origin) return {
+		ok: false,
+		detail: `${route} returned cross-origin protected-resource metadata; the hosted doctor will not fetch it.`
+	};
+	let metadataResponse;
+	try {
+		metadataResponse = await fetchWithTimeout(metadataUrl.href, {
+			headers: { Accept: "application/json" },
+			redirect: "manual"
+		});
+	} catch (error) {
+		return {
+			ok: false,
+			detail: `${route} protected-resource metadata failed: ${error instanceof Error ? error.message : String(error)}.`
+		};
+	}
+	if (metadataResponse.status !== 200) return {
+		ok: false,
+		detail: `${route} protected-resource metadata returned HTTP ${metadataResponse.status}.`
+	};
+	if (responseMediaType(metadataResponse.headers.get("content-type")) !== "application/json") return {
+		ok: false,
+		detail: `${route} protected-resource metadata did not return application/json.`
+	};
+	let metadata;
+	try {
+		const metadataRecord = asRecord(await metadataResponse.json());
+		if (!metadataRecord) return {
+			ok: false,
+			detail: `${route} protected-resource metadata must be a JSON object.`
+		};
+		metadata = metadataRecord;
+	} catch {
+		return {
+			ok: false,
+			detail: `${route} protected-resource metadata is not valid JSON.`
+		};
+	}
+	if (metadata.resource !== resourceUrl.href) return {
+		ok: false,
+		detail: `${route} protected-resource metadata identifies ${String(metadata.resource ?? "no resource")} instead of ${resourceUrl.href}.`
+	};
+	const authorizationServers = metadata.authorization_servers;
+	if (!Array.isArray(authorizationServers) || authorizationServers.length === 0 || normalizeDocsMcpAuthorizationServerUrls(authorizationServers.filter((issuer) => typeof issuer === "string")).length !== authorizationServers.length) return {
+		ok: false,
+		detail: `${route} protected-resource metadata is missing valid authorization_servers.`
+	};
+	const scopesSupported = metadata.scopes_supported;
+	if (scopesSupported !== void 0 && (!Array.isArray(scopesSupported) || scopesSupported.some((scope) => !isDocsMcpOAuthScopeToken(scope)))) return {
+		ok: false,
+		detail: `${route} protected-resource metadata has invalid scopes_supported.`
+	};
+	const challengeScope = readHttpAuthQuotedParameter(bearerChallenge, "scope");
+	if (challengeScope !== void 0 && challengeScope.split(" ").some((scope) => !isDocsMcpOAuthScopeToken(scope))) return {
+		ok: false,
+		detail: `${route} returned an invalid Bearer scope challenge.`
+	};
+	return {
+		ok: true,
+		detail: `${route} is protected and exposes valid RFC 9728 metadata at ${metadataUrl.pathname}.`
+	};
+}
+function findBearerChallenge(header) {
+	let first = 0;
+	while (first < header.length && /\s/u.test(header[first] ?? "")) first += 1;
+	const starts = [first];
+	let quoted = false;
+	let escaped = false;
+	for (let index = 0; index < header.length; index += 1) {
+		const character = header[index];
+		if (escaped) {
+			escaped = false;
+			continue;
+		}
+		if (quoted && character === "\\") {
+			escaped = true;
+			continue;
+		}
+		if (character === "\"") {
+			quoted = !quoted;
+			continue;
+		}
+		if (quoted || character !== ",") continue;
+		let candidate = index + 1;
+		while (candidate < header.length && /\s/u.test(header[candidate] ?? "")) candidate += 1;
+		const tokenStart = candidate;
+		while (candidate < header.length && /[!#$%&'*+\-.^_`|~0-9A-Za-z]/u.test(header[candidate] ?? "")) candidate += 1;
+		if (candidate === tokenStart) continue;
+		let afterToken = candidate;
+		while (afterToken < header.length && /\s/u.test(header[afterToken] ?? "")) afterToken += 1;
+		if (header[afterToken] !== "=") starts.push(tokenStart);
+	}
+	for (let index = 0; index < starts.length; index += 1) {
+		const start = starts[index] ?? 0;
+		if ((/^[!#$%&'*+\-.^_`|~0-9A-Za-z]+/u.exec(header.slice(start))?.[0])?.toLowerCase() !== "bearer") continue;
+		const end = starts[index + 1] ?? header.length;
+		return header.slice(start, end).replace(/,\s*$/u, "").trim();
+	}
+}
+function readHttpAuthQuotedParameter(header, name) {
+	return (new RegExp(`(?:^|[,\\s])${name}\\s*=\\s*"((?:\\\\.|[^"\\\\])*)"`, "i").exec(header)?.[1])?.replace(/\\(.)/g, "$1");
+}
 async function probeMcpRouteCandidates(baseUrl, routes, expectedTools) {
 	const candidates = buildDocsMcpEndpointCandidates(baseUrl, routes);
 	const probes = await Promise.all(candidates.map(async (candidate) => {
@@ -1156,7 +1278,7 @@ async function probeApiCatalogRoute(baseUrl) {
 }
 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));
+	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" || entry.type === "archive") && 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;
@@ -1196,7 +1318,8 @@ async function probeAgentSkillsDiscovery(baseUrl) {
 				failures.push(`${skill.name} has an invalid artifact URL`);
 				continue;
 			}
-			const expectedPath = DEFAULT_AGENT_SKILLS_ROUTE_PATTERN.replace("{name}", skill.name);
+			const expectedPath = skill.type === "archive" ? `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${skill.name}.tar.gz` : DEFAULT_AGENT_SKILLS_ROUTE_PATTERN.replace("{name}", skill.name);
+			const expectedMediaType = skill.type === "archive" ? "application/gzip" : "text/markdown";
 			if (artifactUrl.origin !== baseOrigin) {
 				failures.push(`${skill.name} artifact is not same-origin`);
 				continue;
@@ -1206,16 +1329,16 @@ async function probeAgentSkillsDiscovery(baseUrl) {
 				continue;
 			}
 			try {
-				const [artifactResponse, artifactHeadResponse] = await Promise.all([fetchWithTimeout(artifactUrl.toString(), { headers: { Accept: "text/markdown" } }), fetchWithTimeout(artifactUrl.toString(), {
+				const [artifactResponse, artifactHeadResponse] = await Promise.all([fetchWithTimeout(artifactUrl.toString(), { headers: { Accept: expectedMediaType } }), fetchWithTimeout(artifactUrl.toString(), {
 					method: "HEAD",
-					headers: { Accept: "text/markdown" }
+					headers: { Accept: expectedMediaType }
 				})]);
 				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 (responseMediaType(artifactResponse.headers.get("content-type")) !== expectedMediaType) failures.push(`${skill.name} artifact Content-Type is not ${expectedMediaType}`);
+				else if (responseMediaType(artifactHeadResponse.headers.get("content-type")) !== expectedMediaType) failures.push(`${skill.name} artifact HEAD Content-Type is not ${expectedMediaType}`);
 				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`);
@@ -1574,7 +1697,13 @@ async function inspectAgentReadiness(options = {}) {
 			schemaRoute: feedbackSchemaRoute
 		}
 	});
-	const configuredAgentReviewPaths = configLoad.status === "evaluated" ? Object.values(buildDocsConfigMap(configLoad.config).pointers).map((pointer) => pointer.path).filter((optionPath) => optionPath === "agent" || optionPath.startsWith("agent.") || optionPath === "review" || optionPath.startsWith("review.")) : [];
+	const configuredAgentReviewPaths = configLoad.status === "evaluated" ? Object.values(buildDocsConfigMap(configLoad.config).pointers).map((pointer) => pointer.path).filter((optionPath) => optionPath === "agent" || optionPath.startsWith("agent.") || optionPath === "mcp" || optionPath.startsWith("mcp.") || optionPath === "review" || optionPath.startsWith("review.")) : [];
+	const expectedMcpProtectedResource = mcpConfig.enabled && mcpConfig.security?.authenticate && mcpConfig.security.protectedResource ? {
+		metadataEndpoints: [...getDocsMcpProtectedResourceMetadataRoutes(mcpConfig.route)],
+		authorizationServers: mcpConfig.security.protectedResource.authorizationServers,
+		scopesSupported: mcpConfig.security.protectedResource.scopesSupported,
+		requiredScopes: mcpConfig.security.protectedResource.requiredScopes
+	} : null;
 	const surfaceDrift = analyzeAgentSurfaceDrift({
 		configOptionPaths: [...new Set([...DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, ...configuredAgentReviewPaths])],
 		schemaOptions: getDocsConfigSchema().options,
@@ -1589,7 +1718,8 @@ async function inspectAgentReadiness(options = {}) {
 			mcp: {
 				enabled: mcpConfig.enabled,
 				endpoint: mcpConfig.route,
-				tools: mcpConfig.tools
+				tools: mcpConfig.tools,
+				protectedResource: expectedMcpProtectedResource
 			},
 			routes: {
 				"api.docs": apiRoute,

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

@@ -1,5 +1,5 @@
-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 { c as fileExists, o as exec, s as execOutput } from "./utils-DpiIioYb.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-n5AFur8a.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";