@farming-labs/docs 0.2.55 → 0.2.57

package/dist/{agent-export-BYznnYed.mjs → agent-export-CZR20g0e.mjs}

@@ -1,13 +1,13 @@
-import { M as buildDocsAgentDiscoverySpec, Mt as renderDocsSitemapXml, Nt as resolveDocsSitemapConfig, Ot as buildDocsSitemapManifest, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsAgentFeedbackConfig, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsMarkdownDocument, jt as renderDocsSitemapMarkdown, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsSkillDocument, rt as renderDocsLlmsTxt, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, xt as toDocsMarkdownUrl, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-DXkXi-pS.mjs";
-import "./search-CEg1omHv.mjs";
+import { Ft as renderDocsSitemapMarkdown, It as renderDocsSitemapXml, Lt as resolveDocsSitemapConfig, M as buildDocsAgentDiscoverySpec, Mt as buildDocsSitemapManifest, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, bt as toDocsMarkdownUrl, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsAgentFeedbackConfig, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsMarkdownDocument, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsSkillDocument, rt as renderDocsLlmsTxt, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-CxDzPqtl.mjs";
+import "./search-OHp36znm.mjs";
 import { t as resolveDocsI18n } from "./i18n-CAlj1ADU.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DAptQnkx.mjs";
-import "./sitemap-server-wsNLyVkb.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DRpoiYAV.mjs";
+import "./sitemap-server-zFYctvCa.mjs";
 import "./agent-evals-BD17jOqL.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-C9awWzEQ.mjs";
 import "./server.mjs";
-import { d as readStringProperty, f as readTopLevelBooleanProperty, h as resolveDocsContentDir, i as loadDocsConfigModule, l as readNavTitle, m as resolveDocsConfigPath, p as readTopLevelStringProperty, r as extractTopLevelConfigObject, s as readBooleanProperty, t as extractNestedObjectLiteral } from "./config-CydaZ5PB.mjs";
+import { d as readStringProperty, f as readTopLevelBooleanProperty, h as resolveDocsContentDir, i as loadDocsConfigModule, l as readNavTitle, m as resolveDocsConfigPath, p as readTopLevelStringProperty, r as extractTopLevelConfigObject, s as readBooleanProperty, t as extractNestedObjectLiteral } from "./config-DZbZiYEa.mjs";
 import { t as detectFramework } from "./utils-DBCCkkJS.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
@@ -693,7 +693,12 @@ async function exportAgentBundle(options = {}) {
 			markdownUrl: staticMarkdownRoute(page, sourceEntry, routeEntry),
 			title: page.title,
 			description: page.description,
-			content: page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent ?? page.content
+			content: page.content,
+			rawContent: page.rawContent,
+			agentContent: page.agentContent,
+			agentRawContent: page.agentRawContent,
+			agentFallbackContent: page.agentFallbackContent,
+			agentFallbackRawContent: page.agentFallbackRawContent
 		})), llms);
 		for (const route of [DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "llms", "text/plain", llmsContent.llmsTxt);
 		for (const route of [DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "llms", "text/plain", llmsContent.llmsFullTxt);

package/dist/{agent-surface-drift-LS8zQgbq.mjs → agent-surface-drift-rGFS38Ak.mjs}

@@ -1,4 +1,4 @@
-import { Gt as hasStructuredPageAgentContract, Kt as normalizePageAgentFrontmatter } from "./agent-DXkXi-pS.mjs";
+import { Ct as findDocsAudienceMdxTags, Et as resolveDocsAudienceMdxContent, Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract } from "./agent-CxDzPqtl.mjs";
 import { n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework } from "./agent-scope-B8lptqCd.mjs";
 import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-C9awWzEQ.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
@@ -210,67 +210,63 @@ const PACKAGE_MANAGER_OPTIONS_WITH_VALUES = new Set([
 	"-F",
 	"-w"
 ]);
-/** Extract actual `<Agent>` blocks while ignoring examples inside fenced code blocks. */
+function isAgentContextVisible(scopes) {
+	return scopes.every((scope) => scope.only === void 0 || scope.only === "agent");
+}
+/**
+* Extract actual agent-only context while ignoring examples in fenced and inline code.
+*
+* `<Agent>` is agent-only shorthand. `<Audience>` counts only when `only` is the
+* static value `"agent"`; human-only and dynamic/invalid audience declarations do
+* not contribute to agent-context usefulness metrics.
+*/
 function extractAgentBlocks(source, options = {}) {
 	const sourcePath = options.sourcePath ?? "unknown";
-	const lines = source.split(/\r?\n/);
+	const tags = findDocsAudienceMdxTags(source);
 	const blocks = [];
-	let fence;
+	const scopes = [];
+	let nextScopeId = 1;
+	let cursor = 0;
 	let active;
-	for (let index = 0; index < lines.length; index += 1) {
-		const line = lines[index] ?? "";
-		const trimmed = line.trim();
-		const nextFence = advanceFence(trimmed, fence);
-		if (active) {
-			if (fence || nextFence) {
-				active.content.push(line);
-				fence = nextFence;
-				continue;
-			}
-			if (/^<Agent(?:\s[^>]*)?>\s*$/.test(trimmed)) {
-				active.depth += 1;
-				continue;
-			}
-			const closeWithContent = /^(.*?)<\/Agent>\s*$/.exec(line);
-			if (closeWithContent) {
-				if (closeWithContent[1]) active.content.push(closeWithContent[1]);
-				active.depth -= 1;
-				if (active.depth === 0) {
-					blocks.push({
-						sourcePath,
-						route: options.route,
-						line: active.line,
-						content: active.content.join("\n").trim()
-					});
-					active = void 0;
-				}
-				continue;
-			}
-			active.content.push(line);
-			continue;
-		}
-		if (fence || nextFence) {
-			fence = nextFence;
-			continue;
-		}
-		if (/^<Agent(?:\s[^>]*)?\s*\/>$/.test(trimmed)) continue;
-		const singleLine = /^<Agent(?:\s[^>]*)?>(.*?)<\/Agent>\s*$/.exec(trimmed);
-		if (singleLine) {
-			blocks.push({
-				sourcePath,
-				route: options.route,
-				line: index + 1,
-				content: (singleLine[1] ?? "").trim()
-			});
+	const appendVisibleContent = (content) => {
+		if (active && isAgentContextVisible(scopes)) active.content.push(content);
+	};
+	const finishActiveBlock = () => {
+		if (!active) return;
+		blocks.push({
+			sourcePath,
+			route: options.route,
+			line: active.line,
+			content: active.content.join("").trim()
+		});
+		active = void 0;
+	};
+	for (const tag of tags) {
+		const activeScope = scopes.at(-1);
+		if (tag.closing && activeScope?.name !== tag.name) continue;
+		appendVisibleContent(source.slice(cursor, tag.index));
+		cursor = tag.end;
+		if (tag.closing) {
+			const closedScope = scopes.pop();
+			if (active && closedScope?.id === active.scopeId) finishActiveBlock();
 			continue;
 		}
-		const opening = /^<Agent(?:\s[^>]*)?>(.*)$/.exec(trimmed);
-		if (opening) active = {
-			line: index + 1,
-			depth: 1,
-			content: opening[1] ? [opening[1]] : []
+		if (tag.selfClosing) continue;
+		const scope = {
+			id: nextScopeId,
+			name: tag.name,
+			only: tag.only
+		};
+		nextScopeId += 1;
+		scopes.push(scope);
+		const isAgentOnly = tag.name === "Agent" || tag.name === "Audience" && tag.only === "agent";
+		if (!active && isAgentOnly && isAgentContextVisible(scopes)) active = {
+			line: source.slice(0, tag.index).split(/\r?\n/).length,
+			scopeId: scope.id,
+			content: []
 		};
 	}
+	appendVisibleContent(source.slice(cursor));
 	return blocks;
 }
 /** Analyze page-level context quality without executing documented commands. */
@@ -298,10 +294,10 @@ function analyzeAgentUsefulness(options) {
 	let brokenRelatedLinks = 0;
 	const knownRoutes = new Set(options.pages.map((page) => normalizeRoute(page.route)));
 	for (const analysis of pages) {
-		const { page, agent, actionable } = analysis;
+		const { page, agent, actionable, projectedSource } = analysis;
 		if (actionable) {
 			const guidance = [
-				stripFencedContent(page.source),
+				stripFencedContent(projectedSource),
 				page.agentSource ? stripFencedContent(page.agentSource) : void 0,
 				...analysis.blocks.map((block) => stripFencedContent(block.content))
 			].filter((value) => Boolean(value)).join("\n\n");
@@ -428,15 +424,17 @@ function analyzeAgentUsefulness(options) {
 }
 function analyzePage(page) {
 	const agent = normalizePageAgentFrontmatter(page.agent);
+	const projectedSource = resolveDocsAudienceMdxContent(page.source, "agent");
 	const blocks = extractAgentBlocks(page.source, {
 		sourcePath: page.sourcePath,
 		route: page.route
 	});
-	const shellCommands = collectPageCommands(page, agent);
+	const shellCommands = collectPageCommands(page, agent, projectedSource);
 	return {
 		page,
 		agent,
 		blocks,
+		projectedSource,
 		shellCommands,
 		actionable: page.actionable ?? (hasStructuredPageAgentContract(agent) || shellCommands.length > 0 || blocks.some((block) => ACTIONABLE_PATTERN.test(block.content)) || ACTIONABLE_PATTERN.test(page.agentSource ?? ""))
 	};
@@ -489,7 +487,7 @@ function analyzeBlockQuality(pages, config) {
 				category: "context",
 				line: item.block.line,
 				relatedFiles: relatedFiles.filter((file) => file !== item.block.sourcePath),
-				message: `Agent block duplicates context used on ${group.length - 1} other page${group.length === 2 ? "" : "s"}.`
+				message: `Agent-only block duplicates context used on ${group.length - 1} other page${group.length === 2 ? "" : "s"}.`
 			}));
 		}
 	}
@@ -507,7 +505,7 @@ function analyzeBlockQuality(pages, config) {
 				severity: "warning",
 				category: "context",
 				line: item.block.line,
-				message: `${Math.round(ratio * 100)}% of this Agent block repeats sentences used across the docs corpus.`
+				message: `${Math.round(ratio * 100)}% of this agent-only block repeats sentences used across the docs corpus.`
 			}));
 		}
 		if (isGenericAgentBlock(item.block.content, sentences)) {
@@ -518,7 +516,7 @@ function analyzeBlockQuality(pages, config) {
 				severity: "suggestion",
 				category: "context",
 				line: item.block.line,
-				message: "Agent block is generic and lacks a concrete command, path, identifier, version, or task-specific constraint."
+				message: "Agent-only block is generic and lacks a concrete command, path, identifier, version, or task-specific constraint."
 			}));
 		}
 	}
@@ -684,7 +682,7 @@ function commandAnalysis(findings) {
 		status: "healthy"
 	};
 }
-function collectPageCommands(page, agent) {
+function collectPageCommands(page, agent, projectedSource) {
 	const commands = [];
 	for (const command of agent?.commands ?? []) commands.push(normalizeAgentCommand(command, page.sourcePath));
 	for (const verification of agent?.verification ?? []) if (typeof verification !== "string" && verification.run) commands.push({
@@ -692,7 +690,7 @@ function collectPageCommands(page, agent) {
 		sourcePath: page.sourcePath,
 		source: "contract"
 	});
-	collectMarkdownCommands(commands, page.source, page.sourcePath);
+	collectMarkdownCommands(commands, projectedSource, page.sourcePath);
 	if (page.agentSource) collectMarkdownCommands(commands, page.agentSource, page.agentSourcePath ?? page.sourcePath);
 	return dedupeCommands(commands);
 }
@@ -1426,4 +1424,4 @@ function analyzeAgentSurfaceDrift(options) {
 }
 
 //#endregion
-export { analyzeAgentUsefulness as n, createAgentUsefulnessPagesFromMcp as r, analyzeAgentSurfaceDrift as t };
+export { extractAgentBlocks as i, analyzeAgentUsefulness as n, createAgentUsefulnessPagesFromMcp as r, analyzeAgentSurfaceDrift as t };

package/dist/{agent-BOOcHVDL.mjs → agent-v6R0V3lm.mjs}

@@ -1,7 +1,7 @@
-import { Kt as normalizePageAgentFrontmatter, Yt as stripGeneratedPageAgentContractMarkdown, it as renderDocsMarkdownDocument, z as findDocsMarkdownPage } from "./agent-DXkXi-pS.mjs";
-import { _ as hashGeneratedAgentContent, b as serializeGeneratedAgentDocument, g as GENERATED_AGENT_PROVENANCE_VERSION, y as parseGeneratedAgentDocument } from "./search-CEg1omHv.mjs";
+import { $t as stripGeneratedPageAgentContractMarkdown, Xt as normalizePageAgentFrontmatter, it as renderDocsMarkdownDocument, z as findDocsMarkdownPage } from "./agent-CxDzPqtl.mjs";
+import { _ as hashGeneratedAgentContent, b as serializeGeneratedAgentDocument, g as GENERATED_AGENT_PROVENANCE_VERSION, y as parseGeneratedAgentDocument } from "./search-OHp36znm.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import { c as readEnvReferenceProperty, d as readStringProperty, h as resolveDocsContentDir, i as loadDocsConfigModule, l as readNavTitle, m as resolveDocsConfigPath, o as loadProjectEnv, p as readTopLevelStringProperty, s as readBooleanProperty, t as extractNestedObjectLiteral, u as readNumberProperty } from "./config-CydaZ5PB.mjs";
+import { c as readEnvReferenceProperty, d as readStringProperty, h as resolveDocsContentDir, i as loadDocsConfigModule, l as readNavTitle, m as resolveDocsConfigPath, o as loadProjectEnv, p as readTopLevelStringProperty, s as readBooleanProperty, t as extractNestedObjectLiteral, u as readNumberProperty } from "./config-DZbZiYEa.mjs";
 import { createRequire } from "node:module";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
@@ -337,6 +337,7 @@ function buildPageOptions(defaults, pagePath) {
 function buildResolvedPageSourceDocument(page) {
 	return stripGeneratedPageAgentContractMarkdown(renderDocsMarkdownDocument({
 		...page,
+		agentContent: void 0,
 		agentRawContent: void 0
 	}));
 }

package/dist/{agents-BHzeeY45.mjs → agents-BPonjolo.mjs}

@@ -1,11 +1,11 @@
-import { C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, ct as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-DXkXi-pS.mjs";
-import "./search-CEg1omHv.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-wsNLyVkb.mjs";
+import { C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, ct as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-CxDzPqtl.mjs";
+import "./search-OHp36znm.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-zFYctvCa.mjs";
 import "./agent-evals-BD17jOqL.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-C9awWzEQ.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-CydaZ5PB.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-DZbZiYEa.mjs";
 import { t as detectFramework } from "./utils-DBCCkkJS.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/cli/index.mjs

@@ -105,43 +105,43 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-gnHQ_Pz9.mjs");
+		const { init } = await import("../init-Dm0yDz6v.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
 		const { dev } = await import("../dev-BA2kRuCn.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-HWFlbfLJ.mjs");
+		const { runCloudDeploy } = await import("../cloud-C45jpBtp.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-HWFlbfLJ.mjs");
+		const { runCloudPreview } = await import("../cloud-C45jpBtp.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-HWFlbfLJ.mjs");
+		const { runCloudDeploy } = await import("../cloud-C45jpBtp.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-HWFlbfLJ.mjs");
+		const { runCloudPreview } = await import("../cloud-C45jpBtp.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-HWFlbfLJ.mjs");
+		const { runCloudInit } = await import("../cloud-C45jpBtp.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-HWFlbfLJ.mjs");
+		const { syncCloudConfig } = await import("../cloud-C45jpBtp.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-HWFlbfLJ.mjs");
+		const { runCloudCheck } = await import("../cloud-C45jpBtp.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-HWFlbfLJ.mjs");
+		const { printCloudHelp } = await import("../cloud-C45jpBtp.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-F9zkBHrU.mjs");
+		const { runMcp } = await import("../mcp-BYIgKsPn.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BOOcHVDL.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-v6R0V3lm.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -149,7 +149,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-BYznnYed.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-CZR20g0e.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -159,13 +159,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-BOOcHVDL.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-BYznnYed.mjs");
+		const { printAgentCompactHelp } = await import("../agent-v6R0V3lm.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-CZR20g0e.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BHzeeY45.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BPonjolo.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -175,11 +175,11 @@ async function main() {
 	} else if (parsedCommand.command === "agents") {
 		console.error(pc.red(`Unknown agents subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentsGenerateHelp } = await import("../agents-BHzeeY45.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-BPonjolo.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CNIPJdxN.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-svA9Flsx.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -187,7 +187,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-Dlb8dRRx.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-DZ81wm7h.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -195,7 +195,7 @@ async function main() {
 		}
 		await runReview(reviewOptions);
 	} else if ((parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") && subcommand === "validate") {
-		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-BzfkREEC.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-CSqgqbg-.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -205,11 +205,11 @@ async function main() {
 	} else if (parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") {
 		console.error(pc.red(`Unknown codeblocks subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCodeBlocksValidateHelp } = await import("../codeblocks-BzfkREEC.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-CSqgqbg-.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-B8cF77_i.mjs");
+		const { syncSearch } = await import("../search-AMEoabYU.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -217,7 +217,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-D9ivTLm8.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-Cyc0Bbbn.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -227,11 +227,11 @@ async function main() {
 	} else if (parsedCommand.command === "sitemap") {
 		console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSitemapGenerateHelp } = await import("../sitemap-D9ivTLm8.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-Cyc0Bbbn.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-4BUJxlvV.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-mSc98PMp.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -241,7 +241,7 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-4BUJxlvV.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-mSc98PMp.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {

package/dist/{cloud-HWFlbfLJ.mjs → cloud-C45jpBtp.mjs}

@@ -1,5 +1,5 @@
 import { n as markCliErrorReported } from "./errors-BFUtdZfC.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-CydaZ5PB.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-DZbZiYEa.mjs";
 import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-DBCCkkJS.mjs";
 import fs from "node:fs";
 import path from "node:path";

package/dist/{codeblocks-BzfkREEC.mjs → codeblocks-CSqgqbg-.mjs}

@@ -1,5 +1,5 @@
 import { i as validateCodeBlocks, r as resolveDocsCodeBlocksValidateConfig } from "./code-blocks-C9awWzEQ.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-CydaZ5PB.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-DZbZiYEa.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/{config-CydaZ5PB.mjs → config-DZbZiYEa.mjs}

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { dirname, join, relative, resolve, sep } from "node:path";
 
 //#region src/cli/config.ts
 const FILE_EXTS = [
@@ -295,6 +295,20 @@ function isPlainDocsConfig(value) {
 	const prototype = Object.getPrototypeOf(value);
 	return prototype === Object.prototype || prototype === null;
 }
+function resolveDocsConfigTsconfigPath(rootDir, configPath) {
+	const projectRoot = resolve(rootDir);
+	let currentDir = dirname(configPath);
+	while (true) {
+		const tsconfigPath = join(currentDir, "tsconfig.json");
+		if (existsSync(tsconfigPath)) return tsconfigPath;
+		if (currentDir === projectRoot) return false;
+		const parentDir = dirname(currentDir);
+		if (parentDir === currentDir) return false;
+		const relativeParent = relative(projectRoot, parentDir);
+		if (relativeParent === ".." || relativeParent.startsWith(`..${sep}`)) return false;
+		currentDir = parentDir;
+	}
+}
 /**
 * Load docs.config with an explicit confidence signal for diagnostics.
 * Existing callers can keep using `loadDocsConfigModule`, which preserves the
@@ -307,7 +321,9 @@ async function loadDocsConfigModuleResult(rootDir, explicitPath, options = {}) {
 		const config = resolveDocsConfigModuleExport(await createJiti(import.meta.url, {
 			moduleCache: false,
 			fsCache: false,
-			interopDefault: false
+			interopDefault: false,
+			jsx: { runtime: "automatic" },
+			tsconfigPaths: resolveDocsConfigTsconfigPath(rootDir, configPath)
 		}).import(configPath));
 		if (!isPlainDocsConfig(config)) return {
 			status: "static-fallback",

package/dist/{doctor-CNIPJdxN.mjs → doctor-svA9Flsx.mjs}

@@ -1,16 +1,16 @@
-import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-BOOcHVDL.mjs";
-import "./reading-time-BrTd3DIh.mjs";
-import { Bt as PAGE_AGENT_CONTRACT_FIELDS, Dt as DEFAULT_SITEMAP_XML_ROUTE, Et as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, I as buildDocsMcpEndpointCandidates, M as buildDocsAgentDiscoverySpec, Nt as resolveDocsSitemapConfig, O as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, P as buildDocsConfigMap, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as DEFAULT_SITEMAP_MD_ROUTE, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, u as DEFAULT_DOCS_API_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE } from "./agent-DXkXi-pS.mjs";
-import "./search-CEg1omHv.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-DAptQnkx.mjs";
-import "./sitemap-server-wsNLyVkb.mjs";
+import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-v6R0V3lm.mjs";
+import "./reading-time-W_Id2ayC.mjs";
+import { At as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, I as buildDocsMcpEndpointCandidates, Lt as resolveDocsSitemapConfig, M as buildDocsAgentDiscoverySpec, O as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, P as buildDocsConfigMap, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Wt as PAGE_AGENT_CONTRACT_FIELDS, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_XML_ROUTE, kt as DEFAULT_SITEMAP_MD_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, u as DEFAULT_DOCS_API_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE } from "./agent-CxDzPqtl.mjs";
+import "./search-OHp36znm.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-DRpoiYAV.mjs";
+import "./sitemap-server-zFYctvCa.mjs";
 import { t as runDocsGoldenTasks } from "./agent-evals-BD17jOqL.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-C9awWzEQ.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-CydaZ5PB.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-DZbZiYEa.mjs";
 import { t as detectFramework } from "./utils-DBCCkkJS.mjs";
-import { n as analyzeAgentUsefulness, r as createAgentUsefulnessPagesFromMcp, t as analyzeAgentSurfaceDrift } from "./agent-surface-drift-LS8zQgbq.mjs";
+import { n as analyzeAgentUsefulness, r as createAgentUsefulnessPagesFromMcp, t as analyzeAgentSurfaceDrift } from "./agent-surface-drift-rGFS38Ak.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";
@@ -1483,8 +1483,8 @@ async function inspectAgentReadiness(options = {}) {
 	checks.push(agentFeedbackEnabled ? makeCheck("feedback", "Agent feedback", "pass", 5, 5, `Structured agent feedback is enabled at ${feedbackRoute} with schema ${feedbackSchemaRoute}.`) : makeCheck("feedback", "Agent feedback", "warn", 0, 5, "Structured agent feedback is not enabled.", "Enable feedback.agent if you want agents to discover and post feedback through the shared docs API."));
 	checks.push(makeCheck("metadata", "Page metadata", metadataResult.status, metadataResult.score, 5, coverage.totalPages > 0 ? `${metadataCoverage.describedPages}/${coverage.totalPages} pages include descriptions and ${metadataCoverage.relatedPages}/${coverage.totalPages} pages include related links (${metadataCoverage.descriptionCoverage}% described, ${metadataCoverage.relatedCoverage}% related).` : "No docs pages were available to score page metadata.", metadataCoverage.descriptionCoverage >= 75 ? void 0 : "Add page descriptions and related links to more docs pages so agent markdown output carries better context and navigation hints."));
 	const coverageResult = coverageScore(coverage.explicitCoverage);
-	checks.push(makeCheck("coverage", "Explicit page optimization", coverageResult.status, coverageResult.score, 10, coverage.totalPages > 0 ? `${coverage.explicitPages}/${coverage.totalPages} pages define explicit machine-only context (${coverage.pagesWithAgentFiles} agent.md, ${coverage.pagesWithAgentBlocks} Agent blocks, ${coverage.explicitCoverage}% of pages).` : "No docs pages were available to score explicit page optimization.", coverage.explicitCoverage >= 50 ? void 0 : "Add agent.md files or <Agent> blocks to more pages, or run docs agent compact to create page-level machine docs."));
-	checks.push(makeCheck("agent-context-quality", "Agent context usefulness", contextQualityResult.status, contextQualityResult.score, 15, usefulness.metrics.agentBlocks.total > 0 ? `${usefulness.metrics.agentBlocks.useful}/${usefulness.metrics.agentBlocks.total} Agent blocks are specific and non-repetitive (${usefulness.metrics.agentBlocks.duplicate} duplicate, ${usefulness.metrics.agentBlocks.boilerplate} boilerplate, ${usefulness.metrics.agentBlocks.generic} generic).` : "No embedded Agent blocks were present; page contracts and sibling agent.md files remain available as alternatives.", usefulness.metrics.agentBlocks.total > 0 && usefulness.metrics.agentBlocks.useful === usefulness.metrics.agentBlocks.total ? void 0 : "Replace repeated Agent boilerplate with page-specific constraints, commands, files, expected results, and recovery guidance."));
+	checks.push(makeCheck("coverage", "Audience-tailored page optimization", coverageResult.status, coverageResult.score, 10, coverage.totalPages > 0 ? `${coverage.explicitPages}/${coverage.totalPages} pages define audience-tailored context (${coverage.pagesWithAgentFiles} page${coverage.pagesWithAgentFiles === 1 ? "" : "s"} with agent.md, ${coverage.pagesWithAgentBlocks} page${coverage.pagesWithAgentBlocks === 1 ? "" : "s"} with embedded audience projections, ${coverage.explicitCoverage}% of pages).` : "No docs pages were available to score audience-tailored page optimization.", coverage.explicitCoverage >= 50 ? void 0 : "Add agent.md files or audience primitives such as <Agent>, <Human>, or <Audience only=\"agent\"> to more pages, or run docs agent compact to create page-level machine docs."));
+	checks.push(makeCheck("agent-context-quality", "Agent context usefulness", contextQualityResult.status, contextQualityResult.score, 15, usefulness.metrics.agentBlocks.total > 0 ? `${usefulness.metrics.agentBlocks.useful}/${usefulness.metrics.agentBlocks.total} agent-only blocks are specific and non-repetitive (${usefulness.metrics.agentBlocks.duplicate} duplicate, ${usefulness.metrics.agentBlocks.boilerplate} boilerplate, ${usefulness.metrics.agentBlocks.generic} generic).` : "No embedded agent-only blocks were present; page contracts and sibling agent.md files remain available as alternatives.", usefulness.metrics.agentBlocks.total > 0 && usefulness.metrics.agentBlocks.useful === usefulness.metrics.agentBlocks.total ? void 0 : "Replace repeated agent-only boilerplate with page-specific constraints, commands, files, expected results, and recovery guidance."));
 	checks.push(makeCheck("agent-task-completeness", "Agent task completeness", taskCompletenessResult.status, taskCompletenessResult.score, 15, `${usefulness.metrics.taskCompleteness.completePages}/${usefulness.metrics.actionablePages} actionable pages include prerequisites, an expected result, and recovery guidance (${usefulness.metrics.taskCompleteness.coverage}% complete).`, usefulness.metrics.actionablePages > 0 && usefulness.metrics.taskCompleteness.coverage >= 80 ? void 0 : "Add prerequisites, observable outcomes or verification expectations, and rollback or resolved failure modes to actionable pages."));
 	checks.push(makeCheck("agent-applicability", "Framework and version applicability", applicabilityResult.status, applicabilityResult.score, 10, `${usefulness.metrics.applicability.conflictingPages} conflicting, ${usefulness.metrics.applicability.ambiguousPages} ambiguous, and ${usefulness.metrics.applicability.mismatchedPages} project-mismatched actionable pages.`, usefulness.metrics.actionablePages > 0 && applicabilityIssueCount === 0 ? void 0 : "Declare consistent framework/version metadata in page frontmatter and agent.appliesTo so retrieval can select the right variant."));
 	checks.push(makeCheck("command-health", "Documented command health", commandHealthResult.status, commandHealthResult.score, 10, `${usefulness.metrics.commands.healthy}/${usefulness.metrics.commands.total} statically inspected commands are healthy; ${usefulness.metrics.commands.unhealthy} are unhealthy and ${usefulness.metrics.commands.unverified} could not be verified safely.`, usefulness.metrics.commands.total > 0 && usefulness.metrics.commands.unhealthy === 0 && usefulness.metrics.commands.unverified === 0 ? void 0 : "Update broken or stale commands and make workspace selectors resolvable so scripts, working directories, package managers, and docs CLI subcommands can be verified."));
@@ -1600,8 +1600,8 @@ function printAgentDoctorReport(report) {
 	console.log(`${pc.bold("Score:")} ${pc.cyan(`${report.score}%`)} ${pc.dim(`(${report.grade})`)}`);
 	console.log(`${pc.bold("Framework:")} ${report.framework} ${pc.dim("•")} ${pc.bold("Entry:")} ${report.entry ?? "docs"} ${pc.dim("•")} ${pc.bold("Content:")} ${report.contentDir ?? "-"}`);
 	if (report.url) console.log(`${pc.bold("Hosted URL:")} ${report.url}`);
-	console.log(`${pc.bold("Explicit agent-friendly pages:")} ${report.coverage.explicitPages}/${report.coverage.totalPages} pages ${pc.dim(`(${report.coverage.explicitCoverage}%)`)}`);
-	if (report.usefulness) console.log(`${pc.bold("Useful Agent blocks:")} ${report.usefulness.agentBlocks.useful}/${report.usefulness.agentBlocks.total} ${pc.dim(`• ${report.usefulness.taskCompleteness.completePages}/${report.usefulness.actionablePages} actionable pages task-complete`)}`);
+	console.log(`${pc.bold("Audience-tailored pages:")} ${report.coverage.explicitPages}/${report.coverage.totalPages} pages ${pc.dim(`(${report.coverage.explicitCoverage}%)`)}`);
+	if (report.usefulness) console.log(`${pc.bold("Useful agent-only blocks:")} ${report.usefulness.agentBlocks.useful}/${report.usefulness.agentBlocks.total} ${pc.dim(`• ${report.usefulness.taskCompleteness.completePages}/${report.usefulness.actionablePages} actionable pages task-complete`)}`);
 	if (report.evaluations) console.log(`${pc.bold("Golden tasks:")} ${report.evaluations.status === "unmeasured" ? "unmeasured" : `${report.evaluations.passedTaskCount}/${report.evaluations.taskCount} passed (${report.evaluations.score}/100)`}`);
 	console.log(`${pc.bold("Generated agent.md freshness:")} ${report.coverage.compaction.freshGeneratedPages} fresh ${pc.dim("•")} ${report.coverage.compaction.staleGeneratedPages} stale ${pc.dim("•")} ${report.coverage.compaction.modifiedGeneratedPages} modified ${pc.dim("•")} ${report.coverage.compaction.tokenBudgetMissingPages} token-budget missing`);
 	if (report.fixes && report.fixes.length > 0) console.log(`${pc.bold("Fixes:")} ${report.fixes.map((fix) => `${fix.status === "applied" ? "applied" : "skipped"} ${fix.title}`).join(pc.dim(" • "))}`);