@farming-labs/docs 0.2.87 → 0.2.89

package/dist/{golden-evaluations-CNDwoUOe.mjs → golden-evaluations-DyeYD50F.mjs}

@@ -1,6 +1,7 @@
 import { An as normalizeAgentFramework, Cn as findDocsAudienceMdxTags, En as resolveDocsAudienceMdxContent, Nn as normalizeAgentVersion, kn as agentVersionConstraintsOverlap } from "./agent-CTOUI2BK.mjs";
 import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
 import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-0wjOsqdJ.mjs";
+import { isMap, isScalar, isSeq, parseDocument } from "yaml";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 
@@ -39,6 +40,7 @@ const DEFAULT_DOCS_COMMANDS = [
 	"cloud deploy",
 	"cloud preview",
 	"mcp",
+	"skills scaffold",
 	"agent compact",
 	"agent export",
 	"agents generate",
@@ -519,7 +521,7 @@ function analyzePage(page) {
 		sourcePath: page.sourcePath,
 		route: page.route
 	});
-	const shellCommands = collectPageCommands(page, agent, projectedSource);
+	const shellCommands = collectPageCommands(page, agent);
 	return {
 		page,
 		agent,
@@ -698,7 +700,8 @@ function analyzeCommand(options) {
 		findings.push(commandFinding(options, {
 			code: "command-cwd-outside-root",
 			severity: "error",
-			message: `Command working directory resolves outside the project root: ${commandCwd}`
+			message: `Command working directory resolves outside the project root: ${commandCwd}`,
+			proposedCorrection: `Set cwd to an existing project-relative directory inside the docs project instead of ${JSON.stringify(commandCwd)}.`
 		}));
 		return commandAnalysis(findings);
 	}
@@ -706,7 +709,8 @@ function analyzeCommand(options) {
 		findings.push(commandFinding(options, {
 			code: "command-cwd-missing",
 			severity: "error",
-			message: `Command working directory does not exist: ${commandCwd}`
+			message: `Command working directory does not exist: ${commandCwd}`,
+			proposedCorrection: `Create ${JSON.stringify(commandCwd)} or change cwd to an existing project-relative directory.`
 		}));
 		return commandAnalysis(findings);
 	}
@@ -714,7 +718,8 @@ function analyzeCommand(options) {
 		findings.push(commandFinding(options, {
 			code: "command-unverified",
 			severity: "suggestion",
-			message: "Compound commands, redirections, and shell expansions are not executed or inferred; this command is unverified."
+			message: "Compound commands, redirections, and shell expansions are not executed or inferred; this command is unverified.",
+			proposedCorrection: "Split the shell expression into one independently verifiable command per line and document any redirection or expansion as a separate step."
 		}));
 		return commandAnalysis(findings);
 	}
@@ -724,7 +729,8 @@ function analyzeCommand(options) {
 	if (commandPackageManager && expectedPackageManager && commandPackageManager !== expectedPackageManager) findings.push(commandFinding(options, {
 		code: "command-package-manager-mismatch",
 		severity: "warning",
-		message: `Command uses ${commandPackageManager}, but ${expectedPackageManager} is expected for this project or code block.`
+		message: `Command uses ${commandPackageManager}, but ${expectedPackageManager} is expected for this project or code block.`,
+		proposedCorrection: `Rewrite this command using ${expectedPackageManager}, or explicitly mark the example as a ${commandPackageManager} alternative when that is intentional.`
 	}));
 	const workspaceSelection = readWorkspaceSelection(tokens, commandPackageManager);
 	const workspaceResolution = resolveWorkspaceSelection(workspaceSelection, options.packageManifests, options.rootDir, options.workspaceRoot);
@@ -733,7 +739,8 @@ function analyzeCommand(options) {
 		findings.push(commandFinding(options, {
 			code: "command-unverified",
 			severity: "suggestion",
-			message: `Workspace selector could not be resolved statically (${selectors}); this command is unverified.`
+			message: `Workspace selector could not be resolved statically (${selectors}); this command is unverified.`,
+			proposedCorrection: "Replace the selector with an exact workspace package name or path declared by the nearest workspace manifest."
 		}));
 	}
 	const script = readPackageScript(tokens);
@@ -742,13 +749,15 @@ function analyzeCommand(options) {
 		if (workspaceResolution.status === "none" && packageJsons.length === 0) findings.push(commandFinding(options, {
 			code: "command-unverified",
 			severity: "suggestion",
-			message: `No package.json could be found for package script "${script}"; this command is unverified.`
+			message: `No package.json could be found for package script "${script}"; this command is unverified.`,
+			proposedCorrection: "Set cwd to the package that owns this script, or add a package.json with the documented script."
 		}));
 		for (const packageJson of packageJsons) if (packageJson.scripts.has(script)) verificationEstablished = true;
 		else findings.push(commandFinding(options, {
 			code: "command-script-missing",
 			severity: "error",
-			message: `Command references package script "${script}", but that script is not defined in ${packageJson.relativePath}.`
+			message: `Command references package script "${script}", but that script is not defined in ${packageJson.relativePath}.`,
+			proposedCorrection: `Add a ${JSON.stringify(script)} script to ${packageJson.relativePath}, or replace the command with an existing script from that file.`
 		}));
 	}
 	const docsCommand = readDocsCommand(tokens);
@@ -756,13 +765,15 @@ function analyzeCommand(options) {
 	else findings.push(commandFinding(options, {
 		code: "command-cli-unknown",
 		severity: "error",
-		message: `Command references an unknown docs CLI command: docs ${docsCommand}`
+		message: `Command references an unknown docs CLI command: docs ${docsCommand}`,
+		proposedCorrection: `Replace "docs ${docsCommand}" with the intended supported command listed by "docs --help".`
 	}));
 	if (isStaticallyKnownPackageManagerCommand(tokens) || isVersionProbe(tokens) || isStaticallyValidCurlCommand(tokens) || isStaticallyValidShellBuiltin(tokens, resolvedCwd, options.rootDir) || isStaticallyValidAgentToolCommand(tokens)) verificationEstablished = true;
 	if (!verificationEstablished && findings.length === 0) findings.push(commandFinding(options, {
 		code: "command-unverified",
 		severity: "suggestion",
-		message: "Command form could not be verified statically; this command is unverified."
+		message: "Command form could not be verified statically; this command is unverified.",
+		proposedCorrection: "Use a documented package-manager or docs CLI command, or configure explicit executable-example validation for this command."
 	}));
 	return commandAnalysis(findings);
 }
@@ -780,16 +791,97 @@ function commandAnalysis(findings) {
 		status: "healthy"
 	};
 }
-function collectPageCommands(page, agent, projectedSource) {
+function collectContractCommandLocations(source) {
+	const empty = () => ({
+		commands: [],
+		verification: []
+	});
+	const opening = source.match(/^---[^\S\r\n]*\r?\n/);
+	if (!opening) return empty();
+	const frontmatterOffset = opening[0].length;
+	const remainder = source.slice(frontmatterOffset);
+	const closing = /(?:^|\r?\n)---[^\S\r\n]*(?:\r?\n|$)/.exec(remainder);
+	if (!closing) return empty();
+	try {
+		const document = parseDocument(remainder.slice(0, closing.index), { uniqueKeys: true });
+		if (document.errors.length > 0 || !isMap(document.contents)) return empty();
+		const agent = document.contents.get("agent", true);
+		if (!isMap(agent)) return empty();
+		return {
+			commands: collectContractSequenceLocations(agent.get("commands", true), source, frontmatterOffset),
+			verification: collectContractSequenceLocations(agent.get("verification", true), source, frontmatterOffset)
+		};
+	} catch {
+		return empty();
+	}
+}
+function collectContractSequenceLocations(value, source, frontmatterOffset) {
+	if (!isSeq(value)) return [];
+	const locations = [];
+	for (const item of value.items) {
+		const run = isScalar(item) ? item : isMap(item) ? item.get("run", true) : void 0;
+		if (!isScalar(run) || typeof run.value !== "string") continue;
+		const location = contractScalarLocation(run, source, frontmatterOffset);
+		if (location) locations.push(location);
+	}
+	return locations;
+}
+function contractScalarLocation(scalar, source, frontmatterOffset) {
+	const relativeOffset = scalar.range?.[0];
+	if (typeof scalar.value !== "string" || relativeOffset === void 0) return void 0;
+	const absoluteOffset = frontmatterOffset + relativeOffset;
+	return {
+		run: scalar.value,
+		line: source.slice(0, absoluteOffset).split(/\r?\n/).length
+	};
+}
+function claimContractCommandLine(locations, command, claimedLines) {
+	const location = locations.find((candidate) => candidate.run === command && !claimedLines.has(candidate.line));
+	if (!location) return void 0;
+	claimedLines.add(location.line);
+	return location.line;
+}
+function preserveLineBreaksOnly(value) {
+	return value.replace(/[^\r\n]/g, " ");
+}
+/** Agent projection used for command discovery that keeps original source line numbers stable. */
+function projectAgentCommandSource(source) {
+	const tags = findDocsAudienceMdxTags(source);
+	if (tags.length === 0) return source;
+	const scopes = [];
+	let output = "";
+	let cursor = 0;
+	const visible = () => scopes.every((scope) => scope.only !== "human");
+	for (const tag of tags) {
+		const activeScope = scopes.at(-1);
+		if (tag.closing && activeScope?.name !== tag.name) continue;
+		const content = source.slice(cursor, tag.index);
+		output += visible() ? content : preserveLineBreaksOnly(content);
+		output += preserveLineBreaksOnly(source.slice(tag.index, tag.end));
+		cursor = tag.end;
+		if (tag.closing) scopes.pop();
+		else if (!tag.selfClosing) scopes.push({
+			name: tag.name,
+			only: tag.only
+		});
+	}
+	const remaining = source.slice(cursor);
+	output += visible() ? remaining : preserveLineBreaksOnly(remaining);
+	return output;
+}
+function collectPageCommands(page, agent) {
 	const commands = [];
-	for (const command of agent?.commands ?? []) commands.push(normalizeAgentCommand(command, page.sourcePath));
+	const contractLocations = collectContractCommandLocations(page.source);
+	const claimedContractLines = /* @__PURE__ */ new Set();
+	for (const command of agent?.commands ?? []) commands.push(normalizeAgentCommand(command, page.sourcePath, claimContractCommandLine(contractLocations.commands, typeof command === "string" ? command : command.run, claimedContractLines)));
 	for (const verification of agent?.verification ?? []) if (typeof verification !== "string" && verification.run) commands.push({
 		run: verification.run,
+		line: claimContractCommandLine(contractLocations.verification, verification.run, claimedContractLines),
 		sourcePath: page.sourcePath,
 		source: "contract"
 	});
-	collectMarkdownCommands(commands, projectedSource, page.sourcePath);
-	if (page.agentSource) collectMarkdownCommands(commands, page.agentSource, page.agentSourcePath ?? page.sourcePath);
+	collectMarkdownCommands(commands, projectAgentCommandSource(page.source), page.sourcePath);
+	if (page.agentSource) collectMarkdownCommands(commands, projectAgentCommandSource(page.agentSource), page.agentSourcePath ?? page.sourcePath);
 	return dedupeCommands(commands);
 }
 function collectMarkdownCommands(commands, source, sourcePath) {
@@ -801,30 +893,54 @@ function collectMarkdownCommands(commands, source, sourcePath) {
 	for (const block of blocks) {
 		if (!/^(?:bash|console|sh|shell|zsh)$/i.test(block.language ?? "")) continue;
 		for (const command of shellLines(block.code, block.language)) commands.push({
-			run: command,
-			line: block.lineStart,
+			run: command.run,
+			line: block.lineStart + 1 + command.lineOffset,
 			sourcePath,
 			packageManagerHint: block.packageManager,
 			source: "fence"
 		});
 	}
 }
-function normalizeAgentCommand(command, sourcePath) {
+function normalizeAgentCommand(command, sourcePath, line) {
+	const run = typeof command === "string" ? command : command.run;
 	return typeof command === "string" ? {
-		run: command,
+		run,
+		line,
 		sourcePath,
 		source: "contract"
 	} : {
-		run: command.run,
+		run,
 		cwd: command.cwd,
+		line,
 		sourcePath,
 		source: "contract"
 	};
 }
 function shellLines(code, language) {
-	const lines = code.replace(/\\\s*\r?\n\s*/g, " ").split(/\r?\n/);
-	const promptedConsole = language?.toLowerCase() === "console" && lines.some((line) => /^(?:\$|>)\s+/.test(line.trim()));
-	return lines.map((line) => line.trim()).filter((line) => !promptedConsole || /^(?:\$|>)\s+/.test(line)).map((line) => line.replace(/^(?:\$|>)\s+/, "")).filter((line) => Boolean(line) && !line.startsWith("#") && !/^\w+=\S+$/.test(line));
+	const logicalLines = [];
+	let pending;
+	for (const [lineOffset, physicalLine] of code.split(/\r?\n/).entries()) {
+		const trimmed = physicalLine.trim();
+		if (!pending) pending = {
+			run: "",
+			lineOffset
+		};
+		const continued = /\\\s*$/.test(trimmed);
+		const segment = continued ? trimmed.replace(/\\\s*$/, "").trimEnd() : trimmed;
+		pending.run = `${pending.run}${pending.run && segment ? " " : ""}${segment}`;
+		if (continued) continue;
+		logicalLines.push(pending);
+		pending = void 0;
+	}
+	if (pending) logicalLines.push(pending);
+	const promptedConsole = language?.toLowerCase() === "console" && logicalLines.some((line) => /^(?:\$|>)\s+/.test(line.run.trim()));
+	return logicalLines.map((line) => ({
+		...line,
+		run: line.run.trim()
+	})).filter((line) => !promptedConsole || /^(?:\$|>)\s+/.test(line.run)).map((line) => ({
+		...line,
+		run: line.run.replace(/^(?:\$|>)\s+/, "")
+	})).filter((line) => Boolean(line.run) && !line.run.startsWith("#") && !/^\w+=\S+$/.test(line.run));
 }
 function dedupeCommands(commands) {
 	const seen = /* @__PURE__ */ new Set();

package/dist/{init-D0GcUKJ0.mjs → init-CuLodGjP.mjs}

@@ -1,5 +1,5 @@
 import { a as devInstallCommand, c as fileExists, d as readFileSafe, f as spawnAndWaitFor, i as detectPackageManagerFromProject, l as formatPackageManagerDetection, n as detectGlobalCssFiles, o as exec, p as writeFileSafe, r as detectNextAppDir, t as detectFramework, u as installCommand } from "./utils-DpiIioYb.mjs";
-import { $ as svelteDocsLayoutServerTemplate, A as injectTanstackVitePlugins, B as nuxtGlobalCssTemplate, C as injectDocsAgentSkillsVitePlugin, Ct as tsconfigTemplate, D as injectSvelteCssImport, E as injectRootProviderIntoLayout, F as nextLocaleDocPageTemplate, G as nuxtServerDocsPublicMiddlewareTemplate, H as nuxtQuickstartPageTemplate, I as nextLocalizedPageTemplate, J as quickstartPageTemplate, K as nuxtWelcomePageTemplate, L as nuxtConfigTemplate, M as nextApiReferencePageTemplate, N as nextConfigMergedTemplate, O as injectSvelteDocsPublicHook, P as nextConfigTemplate, Q as svelteDocsConfigTemplate, R as nuxtDocsConfigTemplate, S as injectCssImport, St as tanstackWelcomePageTemplate, T as injectNuxtCssImport, U as nuxtServerApiDocsRouteTemplate, V as nuxtInstallationPageTemplate, W as nuxtServerApiReferenceRouteTemplate, X as svelteApiReferenceRouteTemplate, Y as rootLayoutTemplate, Z as svelteDocsApiRouteTemplate, _ as getAstroAdapterPkg, _t as tanstackDocsServerTemplate, a as astroDocsIndexTemplate, at as svelteInstallationPageTemplate, b as injectAstroCssImport, bt as tanstackRootRouteTemplate, c as astroDocsServerTemplate, ct as svelteViteConfigTemplate, d as astroQuickstartPageTemplate, dt as tanstackApiReferenceRouteTemplate, et as svelteDocsLayoutTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsCatchAllRouteTemplate, g as docsLayoutTemplate, gt as tanstackDocsPublicRouteTemplate, h as docsConfigTemplate, ht as tanstackDocsIndexRouteTemplate, i as astroDocsConfigTemplate, it as svelteGlobalCssTemplate, j as installationPageTemplate, k as injectTanstackRootProviderIntoRoute, l as astroGlobalCssTemplate, lt as svelteWelcomePageTemplate, m as customThemeTsTemplate, mt as tanstackDocsFunctionsTemplate, n as astroApiRouteTemplate, nt as svelteDocsPublicHookTemplate, o as astroDocsMiddlewareTemplate, ot as svelteQuickstartPageTemplate, p as customThemeCssTemplate, pt as tanstackDocsConfigTemplate, q as postcssConfigTemplate, r as astroConfigTemplate, rt as svelteDocsServerTemplate, s as astroDocsPageTemplate, st as svelteRootLayoutTemplate, t as astroApiReferenceRouteTemplate, tt as svelteDocsPageTemplate, u as astroInstallationPageTemplate, ut as tanstackApiDocsRouteTemplate, v as globalCssTemplate, vt as tanstackInstallationPageTemplate, w as injectNuxtAgentSkillsPlugin, wt as welcomePageTemplate, x as injectAstroDocsMiddleware, xt as tanstackViteConfigTemplate, y as injectAstroAgentSkillsPlugin, yt as tanstackQuickstartPageTemplate, z as nuxtDocsPageTemplate } from "./templates-C6avM0U3.mjs";
+import { $ as svelteDocsLayoutServerTemplate, A as injectTanstackVitePlugins, B as nuxtGlobalCssTemplate, C as injectDocsAgentSkillsVitePlugin, Ct as tsconfigTemplate, D as injectSvelteCssImport, E as injectRootProviderIntoLayout, F as nextLocaleDocPageTemplate, G as nuxtServerDocsPublicMiddlewareTemplate, H as nuxtQuickstartPageTemplate, I as nextLocalizedPageTemplate, J as quickstartPageTemplate, K as nuxtWelcomePageTemplate, L as nuxtConfigTemplate, M as nextApiReferencePageTemplate, N as nextConfigMergedTemplate, O as injectSvelteDocsPublicHook, P as nextConfigTemplate, Q as svelteDocsConfigTemplate, R as nuxtDocsConfigTemplate, S as injectCssImport, St as tanstackWelcomePageTemplate, T as injectNuxtCssImport, U as nuxtServerApiDocsRouteTemplate, V as nuxtInstallationPageTemplate, W as nuxtServerApiReferenceRouteTemplate, X as svelteApiReferenceRouteTemplate, Y as rootLayoutTemplate, Z as svelteDocsApiRouteTemplate, _ as getAstroAdapterPkg, _t as tanstackDocsServerTemplate, a as astroDocsIndexTemplate, at as svelteInstallationPageTemplate, b as injectAstroCssImport, bt as tanstackRootRouteTemplate, c as astroDocsServerTemplate, ct as svelteViteConfigTemplate, d as astroQuickstartPageTemplate, dt as tanstackApiReferenceRouteTemplate, et as svelteDocsLayoutTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsCatchAllRouteTemplate, g as docsLayoutTemplate, gt as tanstackDocsPublicRouteTemplate, h as docsConfigTemplate, ht as tanstackDocsIndexRouteTemplate, i as astroDocsConfigTemplate, it as svelteGlobalCssTemplate, j as installationPageTemplate, k as injectTanstackRootProviderIntoRoute, l as astroGlobalCssTemplate, lt as svelteWelcomePageTemplate, m as customThemeTsTemplate, mt as tanstackDocsFunctionsTemplate, n as astroApiRouteTemplate, nt as svelteDocsPublicHookTemplate, o as astroDocsMiddlewareTemplate, ot as svelteQuickstartPageTemplate, p as customThemeCssTemplate, pt as tanstackDocsConfigTemplate, q as postcssConfigTemplate, r as astroConfigTemplate, rt as svelteDocsServerTemplate, s as astroDocsPageTemplate, st as svelteRootLayoutTemplate, t as astroApiReferenceRouteTemplate, tt as svelteDocsPageTemplate, u as astroInstallationPageTemplate, ut as tanstackApiDocsRouteTemplate, v as globalCssTemplate, vt as tanstackInstallationPageTemplate, w as injectNuxtAgentSkillsPlugin, wt as welcomePageTemplate, x as injectAstroDocsMiddleware, xt as tanstackViteConfigTemplate, y as injectAstroAgentSkillsPlugin, yt as tanstackQuickstartPageTemplate, z as nuxtDocsPageTemplate } from "./templates-Co7I_Okv.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
@@ -188,7 +188,7 @@ async function configureDocsCloudOnboarding(options) {
 		enabled = cloudAnswer;
 	}
 	if (!enabled) return;
-	const { initCloudConfig } = await import("./cloud-pdNC-tyj.mjs");
+	const { initCloudConfig } = await import("./cloud-DwhH_b_q.mjs");
 	printDocsCloudOnboardingInstructions(await initCloudConfig({
 		rootDir: options.rootDir,
 		configPath: getDocsCloudConfigPathForFramework(options.framework)
@@ -443,6 +443,11 @@ async function init(options = {}) {
 			label: "Ledger",
 			hint: "Stripe Docs-inspired product docs shell with navy code panels"
 		},
+		{
+			value: "shadcn",
+			label: "Shadcn Docs",
+			hint: "Compact neutral shell inspired by the shadcn/ui documentation"
+		},
 		{
 			value: "greentree",
 			label: "GreenTree",
@@ -1117,6 +1122,7 @@ function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written)
 		darkbold: "darkbold",
 		shiny: "shiny",
 		ledger: "ledger",
+		shadcn: "shadcn",
 		greentree: "greentree",
 		concrete: "concrete",
 		"command-grid": "command-grid",
@@ -1184,6 +1190,7 @@ function scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written) {
 		darkbold: "darkbold",
 		shiny: "shiny",
 		ledger: "ledger",
+		shadcn: "shadcn",
 		greentree: "greentree",
 		concrete: "concrete",
 		"command-grid": "command-grid",
@@ -1238,6 +1245,7 @@ function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
 		darkbold: "darkbold",
 		shiny: "shiny",
 		ledger: "ledger",
+		shadcn: "shadcn",
 		greentree: "greentree",
 		concrete: "concrete",
 		"command-grid": "command-grid",

package/dist/{mcp-7bvRe9Da.mjs → mcp-D8Hw2blN.mjs}

@@ -9,7 +9,7 @@ import "./agent-evals-DCptRrdP.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import "./code-blocks-0wjOsqdJ.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, i as hasTopLevelProperty, l as readBooleanProperty, n as extractObjectLiteral, o as loadDocsConfigModuleResult, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, i as hasTopLevelProperty, l as readBooleanProperty, n as extractObjectLiteral, o as loadDocsConfigModuleResult, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BtxaQTPP.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/mcp.mjs

@@ -13,6 +13,9 @@ import * as z from "zod/v4";
 //#region src/mcp.ts
 const DEFAULT_MCP_VERSION = "0.0.0";
 const DEFAULT_MCP_NAME = "@farming-labs/docs";
+const DOCS_MCP_DISCOVERY_CACHE_TTL_MS = 300 * 1e3;
+const DOCS_MCP_LIST_CACHE_TTL_MS = 300 * 1e3;
+const DOCS_MCP_RESOURCE_CACHE_TTL_MS = 60 * 1e3;
 const DEFAULT_MCP_CONTEXT_TOKEN_BUDGET = 4e3;
 const MIN_MCP_CONTEXT_TOKEN_BUDGET = 256;
 const MAX_MCP_CONTEXT_TOKEN_BUDGET = 32e3;
@@ -2625,7 +2628,7 @@ function durationMs(startedAt) {
 }
 function createDocsMcpContentChangeMonitor(options) {
 	let context;
-	let generation;
+	let state;
 	let timer;
 	let running = false;
 	let closed = false;
@@ -2636,11 +2639,14 @@ function createDocsMcpContentChangeMonitor(options) {
 			if (closed || context === void 0 || options.isActive?.() === false) return;
 			running = true;
 			try {
-				const nextGeneration = await options.readGeneration(context);
-				if (generation && nextGeneration !== generation) {
-					generation = nextGeneration;
-					await options.notify();
-				} else generation = nextGeneration;
+				const nextState = await options.readState(context);
+				const previousState = state;
+				state = nextState;
+				if (previousState && nextState.indexGeneration !== previousState.indexGeneration) await options.notify({
+					context,
+					previous: previousState,
+					current: nextState
+				});
 			} catch {} finally {
 				running = false;
 				schedule();
@@ -2657,9 +2663,9 @@ function createDocsMcpContentChangeMonitor(options) {
 				timer = void 0;
 			}
 			try {
-				generation = await options.readGeneration(nextContext);
+				state = await options.readState(nextContext);
 			} catch {
-				generation = void 0;
+				state = void 0;
 			}
 			schedule();
 		},
@@ -2817,10 +2823,36 @@ async function createDocsMcpServer(options) {
 	});
 	const contentChangesEnabled = resolveDocsContentChangesConfig(options.contentChanges).enabled && resolved.tools.listContentChanges !== false;
 	const contentChangeHydrationEnabled = contentChangesEnabled && resolved.tools.hydrateContentChanges !== false;
+	const cacheScope = options.requestContext?.auth ? "private" : "public";
 	const server = new McpServer({
 		name: resolved.name,
 		version: resolved.version
-	});
+	}, { cacheHints: {
+		"server/discover": {
+			ttlMs: DOCS_MCP_DISCOVERY_CACHE_TTL_MS,
+			cacheScope
+		},
+		"tools/list": {
+			ttlMs: DOCS_MCP_LIST_CACHE_TTL_MS,
+			cacheScope
+		},
+		"prompts/list": {
+			ttlMs: DOCS_MCP_LIST_CACHE_TTL_MS,
+			cacheScope
+		},
+		"resources/list": {
+			ttlMs: DOCS_MCP_LIST_CACHE_TTL_MS,
+			cacheScope
+		},
+		"resources/templates/list": {
+			ttlMs: DOCS_MCP_LIST_CACHE_TTL_MS,
+			cacheScope
+		},
+		"resources/read": {
+			ttlMs: DOCS_MCP_RESOURCE_CACHE_TTL_MS,
+			cacheScope
+		}
+	} });
 	installDocsMcpSdkRegistrationPagination(server, protocolScope);
 	if (contentChangesEnabled) server.server.registerCapabilities({ resources: { subscribe: true } });
 	const registerResource = (name, uri, metadata, callback) => {
@@ -4511,22 +4543,35 @@ function createDocsMcpHttpHandler(options) {
 	});
 	const configuredPollInterval = options.contentChangePollIntervalMs;
 	const contentChangePollIntervalMs = typeof configuredPollInterval === "number" && Number.isFinite(configuredPollInterval) && configuredPollInterval >= 10 ? Math.floor(configuredPollInterval) : DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS;
-	async function readMonitoredGeneration(context) {
+	async function readMonitoredState(context) {
 		const locale = options.source.resolveLocale?.(void 0, context);
 		const pages = dedupePages(await options.source.getPages(locale, context));
-		return (await contentChangeFeed.resolve({
+		const result = await contentChangeFeed.resolve({
 			pages: toSearchSourcePages(pages),
 			search: options.search,
 			audience: "agent",
 			locale,
 			baseUrl: options.source.baseUrl ?? (context.request ? new URL(context.request.url).origin : void 0),
 			...context.request ? { request: context.request.clone() } : {}
-		})).indexGeneration;
+		});
+		return {
+			indexGeneration: result.indexGeneration,
+			resourceUris: [
+				"docs://navigation",
+				DOCS_MCP_CONTENT_CHANGES_CURRENT_URI,
+				`docs://changes/${result.indexGeneration}`,
+				...pages.map((page) => toPageResourceUri(page.url))
+			]
+		};
 	}
 	const contentChangeMonitor = createDocsMcpContentChangeMonitor({
 		pollIntervalMs: contentChangePollIntervalMs,
-		readGeneration: readMonitoredGeneration,
-		notify: () => mcpHandler.notify.resourceUpdated(DOCS_MCP_CONTENT_CHANGES_CURRENT_URI),
+		readState: readMonitoredState,
+		notify: ({ previous, current }) => {
+			mcpHandler.notify.resourcesChanged();
+			const affectedUris = new Set([...previous.resourceUris, ...current.resourceUris]);
+			for (const uri of affectedUris) mcpHandler.notify.resourceUpdated(uri);
+		},
 		isActive: () => eventBus.listenerCount > 0,
 		unrefTimer: true
 	});
@@ -4659,21 +4704,34 @@ async function runDocsMcpStdio(options) {
 			requestContext
 		});
 		if (!contentChangesEnabled) return server;
-		const readGeneration = async () => {
+		const readState = async () => {
 			const locale = options.source.resolveLocale?.(void 0, requestContext);
 			const pages = dedupePages(await options.source.getPages(locale, requestContext));
-			return (await contentChangeFeed.resolve({
+			const result = await contentChangeFeed.resolve({
 				pages: toSearchSourcePages(pages),
 				search: options.search,
 				audience: "agent",
 				locale,
 				baseUrl: options.source.baseUrl
-			})).indexGeneration;
+			});
+			return {
+				indexGeneration: result.indexGeneration,
+				resourceUris: [
+					"docs://navigation",
+					DOCS_MCP_CONTENT_CHANGES_CURRENT_URI,
+					`docs://changes/${result.indexGeneration}`,
+					...pages.map((page) => toPageResourceUri(page.url))
+				]
+			};
 		};
 		const monitor = createDocsMcpContentChangeMonitor({
 			pollIntervalMs,
-			readGeneration: () => readGeneration(),
-			notify: () => server.server.sendResourceUpdated({ uri: DOCS_MCP_CONTENT_CHANGES_CURRENT_URI })
+			readState: () => readState(),
+			notify: async ({ previous, current }) => {
+				await server.server.sendResourceListChanged();
+				const affectedUris = new Set([...previous.resourceUris, ...current.resourceUris]);
+				for (const uri of affectedUris) await server.server.sendResourceUpdated({ uri });
+			}
 		});
 		await monitor.start(requestContext);
 		const closeServer = server.close.bind(server);

package/dist/{review-DEnzotkg.mjs → review-R39cQsvi.mjs}

@@ -7,9 +7,9 @@ import "./agent-skills-server-CwmzAzf_.mjs";
 import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-DCptRrdP.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-0wjOsqdJ.mjs";
-import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
+import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-BtxaQTPP.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
-import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CNDwoUOe.mjs";
+import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-DyeYD50F.mjs";
 import { t as analyzeConfiguredAgentSkillsProgressiveDisclosure } from "./agent-skills-progressive-disclosure-BVvj7nM8.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";

package/dist/{robots-DXy1xW3D.mjs → robots-C-Nh0xH6.mjs}

@@ -2,7 +2,7 @@ import "./agent-CTOUI2BK.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
 import "./standards-discovery-Ckx0tN7B.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-DaU38DZw.mjs";
-import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BtxaQTPP.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/{search-DznddPqw.mjs → search-3TUBKtz5.mjs}

@@ -10,7 +10,7 @@ import "./agent-evals-DCptRrdP.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./code-blocks-0wjOsqdJ.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
+import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-BtxaQTPP.mjs";
 import { readFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{sitemap-DCsrVSPf.mjs → sitemap-DrILEtYo.mjs}

@@ -8,7 +8,7 @@ import "./agent-evals-DCptRrdP.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.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, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BtxaQTPP.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/{skills-CPDwsMq4.mjs → skills-35ecRZtd.mjs}

@@ -9,7 +9,7 @@ import "./agent-evals-DCptRrdP.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./code-blocks-0wjOsqdJ.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BtxaQTPP.mjs";
 import { n as estimateAgentSkillInstructionTokens, r as resolveDocsAgentSkillsProgressiveDisclosureConfig } from "./agent-skills-progressive-disclosure-BVvj7nM8.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/{templates-C6avM0U3.mjs → templates-Co7I_Okv.mjs}

@@ -58,6 +58,14 @@ const THEME_INFO = {
 		nuxtImport: "@farming-labs/nuxt-theme/ledger",
 		nextCssImport: "ledger"
 	},
+	shadcn: {
+		factory: "shadcn",
+		nextImport: "@farming-labs/theme/shadcn",
+		svelteImport: "@farming-labs/svelte-theme/shadcn",
+		astroImport: "@farming-labs/astro-theme/shadcn",
+		nuxtImport: "@farming-labs/nuxt-theme/shadcn",
+		nextCssImport: "shadcn"
+	},
 	greentree: {
 		factory: "greentree",
 		nextImport: "@farming-labs/theme/greentree",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.87",
+  "version": "0.2.89",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -16,7 +16,8 @@
     "docs": "./dist/cli/index.mjs"
   },
   "files": [
-    "dist"
+    "dist",
+    "styles"
   ],
   "type": "module",
   "main": "./dist/index.mjs",
@@ -67,7 +68,8 @@
       "types": "./dist/mcp.d.mts",
       "import": "./dist/mcp.mjs",
       "default": "./dist/mcp.mjs"
-    }
+    },
+    "./styles/themes/shadcn.css": "./styles/themes/shadcn.css"
   },
   "dependencies": {
     "@clack/prompts": "^0.9.1",