@farming-labs/docs 0.2.81 → 0.2.83

package/dist/{agent-DEjfHgU-.d.mts → agent-WS4GXGh6.d.mts}

@@ -1,5 +1,5 @@
-import { $n as LlmsTxtMaxCharsMode, At as DocsConfig, Dn as DocsSearchFilterField, En as DocsSearchFacetsResponse, F as DocsAgentContentChangesConfig, Fn as DocsSearchSourcePage, It as DocsContentChangesResponse, K as DocsAgentFeedbackData, Lt as DocsContentSnapshot, Mr as TypesenseDocsSearchConfig, Nn as DocsSearchResult, On as DocsSearchFilterInput, Qn as LlmsTxtMaxCharsConfig, Rn as DocsSitemapConfig, Sn as DocsSearchDocument, Sr as ResolvedDocsRelatedLink, Vt as DocsI18nConfig, Zn as LlmsTxtConfig, bn as DocsSearchChunkingConfig, er as LlmsTxtSectionConfig, f as CustomDocsSearchConfig, gn as DocsSearchAdapter, gt as DocsAskAIMcpConfig, in as DocsPaginatedSearchResponse, jn as DocsSearchRequest, kn as DocsSearchFilters, mn as DocsRobotsConfig, mr as PageAgentFrontmatter, qn as FeedbackConfig, qt as DocsMcpConfig, r as AlgoliaDocsSearchConfig, tr as McpDocsSearchConfig, vn as DocsSearchAdapterFactory, xn as DocsSearchConfig } from "./types-CoohpxFz.mjs";
-import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-BWz35hS6.mjs";
+import { $n as LlmsTxtConfig, An as DocsSearchFilterInput, Bn as DocsSitemapConfig, Cn as DocsSearchConfig, F as DocsAgentContentChangesConfig, Fn as DocsSearchResult, K as DocsAgentFeedbackData, Ln as DocsSearchSourcePage, Mt as DocsConfig, Nn as DocsSearchRequest, On as DocsSearchFacetsResponse, Pr as TypesenseDocsSearchConfig, Rt as DocsContentChangesResponse, Sn as DocsSearchChunkingConfig, Ut as DocsI18nConfig, Yn as FeedbackConfig, Yt as DocsMcpConfig, bn as DocsSearchAdapterFactory, er as LlmsTxtMaxCharsConfig, f as CustomDocsSearchConfig, gn as DocsRobotsConfig, gr as PageAgentFrontmatter, jn as DocsSearchFilters, kn as DocsSearchFilterField, nr as LlmsTxtSectionConfig, on as DocsPaginatedSearchResponse, r as AlgoliaDocsSearchConfig, rr as McpDocsSearchConfig, tr as LlmsTxtMaxCharsMode, vn as DocsSearchAdapter, vt as DocsAskAIMcpConfig, wn as DocsSearchDocument, wr as ResolvedDocsRelatedLink, zt as DocsContentSnapshot } from "./types-lGEHcx_6.mjs";
+import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-DPUEcUmb.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/i18n.d.ts

package/dist/{agent-evals-CGOA7jJ0.mjs → agent-evals-Burrzyam.mjs}

@@ -1,7 +1,8 @@
 import { An as normalizeAgentFramework, Dn as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentScopeValues, Nn as normalizeAgentVersion, On as agentVersionConstraintMatches, Zt as buildDocsAskAIContext, bn as resolveSearchRequestConfig, dn as performDocsSearch, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, un as normalizeDocsSearchFilters } from "./agent-Dze2Cy5B.mjs";
 import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.mjs";
+import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-D5qYU19g.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
-import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
+import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-0wjOsqdJ.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { createJiti } from "jiti";
@@ -27,7 +28,8 @@ const DEFAULT_REVIEW_RULES = {
 	relatedCoverage: "suggestion",
 	configConfidence: "warn",
 	agentSurfaceDrift: "error",
-	goldenTasks: "warn"
+	goldenTasks: "warn",
+	agentSkills: "warn"
 };
 const DEFAULT_REVIEW_WEIGHTS = {
 	error: 20,
@@ -228,10 +230,23 @@ function buildDocsReviewWorkflowPathFilters(options) {
 		prefixPath(projectPrefix, "src/content/docs/**"),
 		prefixPath(projectPrefix, "src/lib/docs.config.*"),
 		DEFAULT_DOCS_REVIEW_WORKFLOW_PATH,
-		DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW_PATH
+		DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW_PATH,
+		...buildAgentSkillPathFilters({
+			rootDir: options.rootDir,
+			repoRoot,
+			skills: options.config?.agent?.skills
+		})
 	];
 	return Array.from(new Set(candidates.filter((candidate) => Boolean(candidate))));
 }
+function buildAgentSkillPathFilters(options) {
+	return getDocsAgentSkillsConfiguredPaths(options.skills).map((configuredPath) => {
+		const absolutePath = isAbsolute(configuredPath) ? configuredPath : join(options.rootDir, configuredPath);
+		const repoRelative = toPosixPath(relative(options.repoRoot, absolutePath));
+		if (!repoRelative || repoRelative.startsWith("../")) return void 0;
+		return repoRelative.endsWith("/SKILL.md") || repoRelative === "SKILL.md" ? repoRelative : `${repoRelative.replace(/\/+$/u, "")}/**`;
+	}).filter((candidate) => Boolean(candidate));
+}
 function normalizeRules(rules) {
 	if (!rules) return {};
 	const knownRules = new Set(Object.keys(DEFAULT_REVIEW_RULES));

package/dist/{agent-export-BYWO6fES.mjs → agent-export-whKAZQUI.mjs}

@@ -5,17 +5,17 @@ import "./content-change-hydration-DpQ0KdAD.mjs";
 import { t as resolveDocsI18n } from "./i18n-hHVWcflJ.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-D96X6eVX.mjs";
 import "./sitemap-server-BefXEox6.mjs";
-import "./agent-evals-CGOA7jJ0.mjs";
+import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-D5qYU19g.mjs";
+import "./agent-evals-Burrzyam.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.mjs";
+import "./code-blocks-0wjOsqdJ.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
-import { execFileSync } from "node:child_process";
 import { createHash, randomUUID } from "node:crypto";
+import { execFileSync } from "node:child_process";
 import pc from "picocolors";
 
 //#region src/cli/agent-export.ts

package/dist/agent-skills-bundle.d.mts

@@ -1,4 +1,4 @@
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-BWz35hS6.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-DPUEcUmb.mjs";
 
 //#region src/agent-skills-bundle.d.ts
 /**

package/dist/{agent-skills-server-B2EXn2QD.mjs → agent-skills-server-D5qYU19g.mjs}

@@ -47,7 +47,7 @@ async function findWorkspaceRootAsync(rootDir) {
 		current = parent;
 	}
 }
-function normalizeConfiguredPaths(input) {
+function getDocsAgentSkillsConfiguredPaths(input) {
 	if (!input) return [];
 	const value = typeof input === "string" || Array.isArray(input) ? input : input.paths;
 	return (typeof value === "string" ? [value] : [...value]).map((candidate) => candidate.trim()).filter(Boolean);
@@ -390,9 +390,14 @@ function validateAndSortSkills(published) {
 	}
 	return published.sort((left, right) => left.name.localeCompare(right.name));
 }
-/** Resolve and safely package all project skills configured through `agent.skills` synchronously. */
-function resolveConfiguredAgentSkillsSync(input, options = {}) {
-	const configuredPaths = normalizeConfiguredPaths(input);
+/**
+* Resolve configured SKILL.md files without parsing or packaging their contents.
+*
+* Diagnostics use this path-only form so broken references and invalid frontmatter
+* can be reported independently instead of publication failing at the first skill.
+*/
+function resolveConfiguredAgentSkillPathsSync(input, options = {}) {
+	const configuredPaths = getDocsAgentSkillsConfiguredPaths(input);
 	if (configuredPaths.length === 0) return [];
 	const rootDir = realpathSync(options.rootDir ?? process.cwd());
 	const workspaceRoot = realpathSync(options.workspaceRoot ?? findWorkspaceRoot(rootDir));
@@ -400,11 +405,15 @@ function resolveConfiguredAgentSkillsSync(input, options = {}) {
 	const documents = /* @__PURE__ */ new Set();
 	const visited = /* @__PURE__ */ new Set();
 	for (const configuredPath of configuredPaths) collectSkillDocuments(resolveSafeConfiguredPath(configuredPath, rootDir, workspaceRoot), workspaceRoot, documents, visited);
-	return validateAndSortSkills([...documents].sort().map(publishSkillDocumentSync));
+	return [...documents].sort();
+}
+/** Resolve and safely package all project skills configured through `agent.skills` synchronously. */
+function resolveConfiguredAgentSkillsSync(input, options = {}) {
+	return validateAndSortSkills(resolveConfiguredAgentSkillPathsSync(input, options).map(publishSkillDocumentSync));
 }
 /** Resolve and package configured skills without blocking runtime filesystem or compression work. */
 async function resolveConfiguredAgentSkills(input, options = {}) {
-	const configuredPaths = normalizeConfiguredPaths(input);
+	const configuredPaths = getDocsAgentSkillsConfiguredPaths(input);
 	if (configuredPaths.length === 0) return [];
 	const rootDir = await realpath(options.rootDir ?? process.cwd());
 	const workspaceRoot = options.workspaceRoot === void 0 ? await findWorkspaceRootAsync(rootDir) : await realpath(options.workspaceRoot);
@@ -416,4 +425,4 @@ async function resolveConfiguredAgentSkills(input, options = {}) {
 }
 
 //#endregion
-export { resolveConfiguredAgentSkillsSync as n, resolveConfiguredAgentSkills as t };
+export { resolveConfiguredAgentSkillsSync as i, resolveConfiguredAgentSkillPathsSync as n, resolveConfiguredAgentSkills as r, getDocsAgentSkillsConfiguredPaths as t };

package/dist/{agent-skills-server-CclBBz1M.d.mts → agent-skills-server-q4B9kRGg.d.mts}

@@ -1,5 +1,5 @@
-import { et as DocsAgentSkillsInput } from "./types-CoohpxFz.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-BWz35hS6.mjs";
+import { tt as DocsAgentSkillsInput } from "./types-lGEHcx_6.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-DPUEcUmb.mjs";
 
 //#region src/agent-skills-server.d.ts
 interface ResolveConfiguredAgentSkillsOptions {

package/dist/agent-skills-vite.d.mts

@@ -1,6 +1,6 @@
-import { et as DocsAgentSkillsInput } from "./types-CoohpxFz.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-BWz35hS6.mjs";
-import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CclBBz1M.mjs";
+import { tt as DocsAgentSkillsInput } from "./types-lGEHcx_6.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-DPUEcUmb.mjs";
+import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-q4B9kRGg.mjs";
 
 //#region src/agent-skills-vite.d.ts
 declare const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";

package/dist/agent-skills-vite.mjs

@@ -1,5 +1,5 @@
 import "./standards-discovery-BKlEnK_H.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.mjs";
+import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-D5qYU19g.mjs";
 
 //#region src/agent-skills-vite.ts
 const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";

package/dist/{agents-CDs7ZFdb.mjs → agents-B_980VCs.mjs}

@@ -3,10 +3,10 @@ import "./markdown-sections-7OoA7ylx.mjs";
 import "./standards-discovery-BKlEnK_H.mjs";
 import "./content-change-hydration-DpQ0KdAD.mjs";
 import { C as resolveApiReferenceOpenApiDiscovery } from "./sitemap-server-BefXEox6.mjs";
-import "./agent-evals-CGOA7jJ0.mjs";
+import "./agent-skills-server-D5qYU19g.mjs";
+import "./agent-evals-Burrzyam.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-B2EXn2QD.mjs";
+import "./code-blocks-0wjOsqdJ.mjs";
 import "./server.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";

package/dist/cli/index.mjs

@@ -141,7 +141,7 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-DUxk8lGS.mjs");
+		const { runMcp } = await import("../mcp-bhIsgqxy.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
 		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-Biyd8A98.mjs").then((n) => n.t);
@@ -152,7 +152,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-BYWO6fES.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-whKAZQUI.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -163,12 +163,12 @@ async function main() {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
 		const { printAgentCompactHelp } = await import("../agent-Biyd8A98.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-BYWO6fES.mjs");
+		const { printAgentExportHelp } = await import("../agent-export-whKAZQUI.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-CDs7ZFdb.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-B_980VCs.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -178,11 +178,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-CDs7ZFdb.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-B_980VCs.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CALb10jP.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-WjuyRWYT.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -190,7 +190,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-CaDaE4Pq.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-2e4TXoGS.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -198,7 +198,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-CFuurVIH.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-CPA6Ae5r.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -208,11 +208,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-CFuurVIH.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-CPA6Ae5r.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-D7s_gagx.mjs");
+		const { syncSearch } = await import("../search-DfB3LQ4s.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -220,7 +220,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BMRfmpEp.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-AcwP8jIo.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -230,7 +230,7 @@ async function main() {
 	} else if (parsedCommand.command === "sitemap") {
 		console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSitemapGenerateHelp } = await import("../sitemap-BMRfmpEp.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-AcwP8jIo.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {

package/dist/client/react.d.mts

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

package/dist/{cloud-ask-ai-AUhHTMe6.d.mts → cloud-ask-ai-BQAeHkpZ.d.mts}

@@ -1,4 +1,4 @@
-import { it as DocsAnalyticsConfig, t as AIConfig, vt as DocsCloudConfig } from "./types-CoohpxFz.mjs";
+import { bt as DocsCloudConfig, ot as DocsAnalyticsConfig, t as AIConfig } from "./types-lGEHcx_6.mjs";
 
 //#region src/cloud-ask-ai.d.ts
 interface DocsCloudAskAIConfig {

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

@@ -1,4 +1,4 @@
-import { a as validateCodeBlocks, r as resolveDocsCodeBlocksValidateConfig } from "./code-blocks-DnNVNK2M.mjs";
+import { a as validateCodeBlocks, r as resolveDocsCodeBlocksValidateConfig } from "./code-blocks-0wjOsqdJ.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/docs-cloud-server.d.mts

@@ -1,5 +1,5 @@
-import { at as DocsAnalyticsEvent, it as DocsAnalyticsConfig, ot as DocsAnalyticsEventInput } from "./types-CoohpxFz.mjs";
-import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-AUhHTMe6.mjs";
+import { ct as DocsAnalyticsEventInput, ot as DocsAnalyticsConfig, st as DocsAnalyticsEvent } from "./types-lGEHcx_6.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-BQAeHkpZ.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-sbpjOR2K.mjs";
+import { t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-BRBK4RBG.mjs";
 
 //#region src/docs-cloud-server.ts
 const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";

package/dist/{doctor-CALb10jP.mjs → doctor-WjuyRWYT.mjs}

@@ -8,19 +8,19 @@ import "./content-change-hydration-DpQ0KdAD.mjs";
 import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-D96X6eVX.mjs";
 import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
 import "./sitemap-server-BefXEox6.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-CGOA7jJ0.mjs";
+import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-D5qYU19g.mjs";
+import { t as runDocsGoldenTasks } from "./agent-evals-Burrzyam.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.mjs";
+import "./code-blocks-0wjOsqdJ.mjs";
 import "./server.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-I9yRlYJy.mjs";
+import { a as createAgentUsefulnessPagesFromMcp, i as analyzeAgentUsefulness, n as analyzeConfiguredAgentSkillsProgressiveDisclosure, r as analyzeAgentSurfaceDrift, t as resolveGoldenEvaluationInput } from "./golden-evaluations-B2GHnoFa.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
-import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/server";
 import { createHash } from "node:crypto";
 import { gunzipSync } from "node:zlib";
+import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/server";
 import pc from "picocolors";
 
 //#region src/cli/doctor.ts
@@ -606,6 +606,7 @@ function navigationScore(navigationCoverage) {
 const AGENT_OPTIMIZATION_BLOCKING_CHECKS = new Set([
 	"surface-drift",
 	"agent-skills-frontmatter",
+	"agent-skills-progressive-disclosure",
 	"agent-context-quality",
 	"agent-task-completeness",
 	"agent-applicability",
@@ -1680,11 +1681,20 @@ async function inspectAgentReadiness(options = {}) {
 	const config = configLoad.status === "evaluated" ? configLoad.config : void 0;
 	let configuredAgentSkillNames;
 	let configuredAgentSkillsError;
+	let configuredAgentSkillsDisclosure;
+	let configuredAgentSkillsDisclosureError;
 	const configuredAgentSkills = config?.agent?.skills;
-	if (configuredAgentSkills) try {
-		configuredAgentSkillNames = (await resolveConfiguredAgentSkills(configuredAgentSkills, { rootDir })).map((skill) => skill.name);
-	} catch (error) {
-		configuredAgentSkillsError = error instanceof Error ? error.message : String(error);
+	if (configuredAgentSkills) {
+		try {
+			configuredAgentSkillNames = (await resolveConfiguredAgentSkills(configuredAgentSkills, { rootDir })).map((skill) => skill.name);
+		} catch (error) {
+			configuredAgentSkillsError = error instanceof Error ? error.message : String(error);
+		}
+		try {
+			configuredAgentSkillsDisclosure = analyzeConfiguredAgentSkillsProgressiveDisclosure(configuredAgentSkills, { rootDir });
+		} catch (error) {
+			configuredAgentSkillsDisclosureError = error instanceof Error ? error.message : String(error);
+		}
 	}
 	const entry = config?.entry ?? readTopLevelStringProperty(configContent, "entry") ?? "docs";
 	const contentDir = config?.contentDir ?? resolveDocsContentDir(rootDir, configContent, entry);
@@ -1812,6 +1822,13 @@ async function inspectAgentReadiness(options = {}) {
 	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."));
 	checks.push(makeCheck("agent-skills-frontmatter", "Configured Agent Skills frontmatter", configLoad.status !== "evaluated" ? "warn" : configuredAgentSkillsError ? "fail" : "pass", configLoad.status === "evaluated" && !configuredAgentSkillsError ? 1 : 0, 1, configLoad.status !== "evaluated" ? "Not verified because docs.config could not be evaluated." : configuredAgentSkillsError ? configuredAgentSkillsError : configuredAgentSkillNames ? `${configuredAgentSkillNames.length} configured Agent Skill${configuredAgentSkillNames.length === 1 ? "" : "s"} passed full frontmatter validation: ${configuredAgentSkillNames.join(", ")}.` : "No configured Agent Skills require validation.", configuredAgentSkillsError ? "Fix every configured SKILL.md field reported here before building or publishing the docs site." : void 0));
+	const skillDisclosureIssues = configuredAgentSkillsDisclosure?.issues ?? [];
+	const skillDisclosureHasErrors = skillDisclosureIssues.some((issue) => issue.severity === "error");
+	const skillDisclosureStatus = configLoad.status !== "evaluated" ? "warn" : configuredAgentSkillsDisclosureError ? "fail" : skillDisclosureHasErrors ? "fail" : skillDisclosureIssues.length > 0 ? "warn" : "pass";
+	const skillDisclosureDetail = configLoad.status !== "evaluated" ? "Not verified because docs.config could not be evaluated." : configuredAgentSkillsDisclosureError ? configuredAgentSkillsDisclosureError : configuredAgentSkillsDisclosure ? skillDisclosureIssues.length === 0 ? `${configuredAgentSkillsDisclosure.skills.length} configured Agent Skill${configuredAgentSkillsDisclosure.skills.length === 1 ? "" : "s"} stay within line/token budgets, use resolvable shallow references, declare required compatibility, and document bundled scripts.` : `${skillDisclosureIssues.length} progressive-disclosure issue${skillDisclosureIssues.length === 1 ? "" : "s"} across ${configuredAgentSkillsDisclosure.skills.length} configured skill${configuredAgentSkillsDisclosure.skills.length === 1 ? "" : "s"}: ${skillDisclosureIssues.slice(0, 4).map((issue) => {
+		return `${path.relative(rootDir, issue.filePath).replace(/\\/g, "/")}${issue.line ? `:${issue.line}` : ""} ${issue.message}`;
+	}).join(" ")}${skillDisclosureIssues.length > 4 ? ` (+${skillDisclosureIssues.length - 4} more)` : ""}` : "No configured Agent Skills require progressive-disclosure analysis.";
+	checks.push(makeCheck("agent-skills-progressive-disclosure", "Agent Skills progressive disclosure", skillDisclosureStatus, skillDisclosureStatus === "pass" ? 5 : skillDisclosureStatus === "warn" ? 2 : 0, 5, skillDisclosureDetail, skillDisclosureStatus === "pass" ? void 0 : "Keep SKILL.md under its configured line and instruction-token budgets, repair local references, keep reference chains shallow, declare compatibility requirements, and document script dependencies and validation."));
 	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 (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);