@farming-labs/docs 0.2.120 → 0.2.122

package/dist/cli/dev-banner.mjs

@@ -0,0 +1,58 @@
+import os from "node:os";
+import pc from "picocolors";
+
+//#region src/cli/dev-banner.ts
+function createDevLogger() {
+	return {
+		info(msg) {
+			if (msg.includes("VITE") || msg.includes("vite") || msg.includes("ready in") || msg.includes("Local:") || msg.includes("Network:") || msg.includes("➜") || msg.includes("Port") || msg.includes("trying another")) return;
+			console.log(msg);
+		},
+		warn(msg) {
+			console.warn(pc.yellow(msg));
+		},
+		warnOnce(msg) {
+			console.warn(pc.yellow(msg));
+		},
+		error(msg) {
+			console.error(pc.red(msg));
+		},
+		clearScreen() {},
+		hasErrorLogged() {
+			return false;
+		},
+		hasWarned: false
+	};
+}
+function resolveLocalUrl(protocol, port, localUrl) {
+	const resolved = localUrl ?? `${protocol}://localhost:${port}/`;
+	return resolved.endsWith("/") ? resolved : `${resolved}/`;
+}
+function resolveNetworkUrl(options) {
+	if (!(options.host === true || options.host === "0.0.0.0" || typeof options.host === "string" && options.host !== "localhost" && options.host !== "127.0.0.1")) return null;
+	if (options.networkUrl) return options.networkUrl.endsWith("/") ? options.networkUrl : `${options.networkUrl}/`;
+	const interfaces = os.networkInterfaces();
+	for (const entries of Object.values(interfaces)) for (const iface of entries ?? []) if (iface.family === "IPv4" && !iface.internal) return `${options.protocol}://${iface.address}:${options.port}/`;
+	return "";
+}
+function printDevBanner({ name = "@farming-labs/docs", version = "v0.0.0", port, host, protocol = "http", startTime, localUrl, networkUrl }) {
+	const elapsed = Date.now() - startTime;
+	const resolvedLocalUrl = resolveLocalUrl(protocol, port, localUrl);
+	const resolvedNetworkUrl = resolveNetworkUrl({
+		protocol,
+		port,
+		host,
+		networkUrl
+	});
+	console.log("");
+	console.log(`  ${pc.bold(pc.green(name))} ${pc.dim(version)} ${pc.dim(`ready in ${elapsed}ms`)}`);
+	console.log("");
+	console.log(`  ${pc.dim("➜")}  ${pc.bold("Local:")}   ${pc.cyan(resolvedLocalUrl)}`);
+	if (resolvedNetworkUrl === null) console.log(`  ${pc.dim("➜")}  ${pc.bold("Network:")} ${pc.dim("use --host to expose")}`);
+	else if (resolvedNetworkUrl === "") console.log(`  ${pc.dim("➜")}  ${pc.bold("Network:")} ${pc.dim("no external interface found")}`);
+	else console.log(`  ${pc.dim("➜")}  ${pc.bold("Network:")} ${pc.cyan(resolvedNetworkUrl)}`);
+	console.log("");
+}
+
+//#endregion
+export { createDevLogger, printDevBanner };

package/dist/{dev-Bnn-NUNa.mjs → cli/dev.mjs}

@@ -1,67 +1,13 @@
-import { i as detectPackageManagerFromProject } from "./utils-C7KDrPpA.mjs";
-import { $ as postcssConfigTemplate, C as globalCssTemplate, g as docsLayoutTemplate, kt as tsconfigTemplate, tt as rootLayoutTemplate } from "./templates-BuQ8YsGv.mjs";
+import { detectPackageManagerFromProject } from "./utils.mjs";
+import { createDevLogger, printDevBanner } from "./dev-banner.mjs";
+import { docsLayoutTemplate, globalCssTemplate, postcssConfigTemplate, rootLayoutTemplate, tsconfigTemplate } from "./templates.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
 import { z } from "zod";
-import os from "node:os";
 import pc from "picocolors";
 
-//#region src/cli/dev-banner.ts
-function createDevLogger() {
-	return {
-		info(msg) {
-			if (msg.includes("VITE") || msg.includes("vite") || msg.includes("ready in") || msg.includes("Local:") || msg.includes("Network:") || msg.includes("➜") || msg.includes("Port") || msg.includes("trying another")) return;
-			console.log(msg);
-		},
-		warn(msg) {
-			console.warn(pc.yellow(msg));
-		},
-		warnOnce(msg) {
-			console.warn(pc.yellow(msg));
-		},
-		error(msg) {
-			console.error(pc.red(msg));
-		},
-		clearScreen() {},
-		hasErrorLogged() {
-			return false;
-		},
-		hasWarned: false
-	};
-}
-function resolveLocalUrl(protocol, port, localUrl) {
-	const resolved = localUrl ?? `${protocol}://localhost:${port}/`;
-	return resolved.endsWith("/") ? resolved : `${resolved}/`;
-}
-function resolveNetworkUrl(options) {
-	if (!(options.host === true || options.host === "0.0.0.0" || typeof options.host === "string" && options.host !== "localhost" && options.host !== "127.0.0.1")) return null;
-	if (options.networkUrl) return options.networkUrl.endsWith("/") ? options.networkUrl : `${options.networkUrl}/`;
-	const interfaces = os.networkInterfaces();
-	for (const entries of Object.values(interfaces)) for (const iface of entries ?? []) if (iface.family === "IPv4" && !iface.internal) return `${options.protocol}://${iface.address}:${options.port}/`;
-	return "";
-}
-function printDevBanner({ name = "@farming-labs/docs", version = "v0.0.0", port, host, protocol = "http", startTime, localUrl, networkUrl }) {
-	const elapsed = Date.now() - startTime;
-	const resolvedLocalUrl = resolveLocalUrl(protocol, port, localUrl);
-	const resolvedNetworkUrl = resolveNetworkUrl({
-		protocol,
-		port,
-		host,
-		networkUrl
-	});
-	console.log("");
-	console.log(`  ${pc.bold(pc.green(name))} ${pc.dim(version)} ${pc.dim(`ready in ${elapsed}ms`)}`);
-	console.log("");
-	console.log(`  ${pc.dim("➜")}  ${pc.bold("Local:")}   ${pc.cyan(resolvedLocalUrl)}`);
-	if (resolvedNetworkUrl === null) console.log(`  ${pc.dim("➜")}  ${pc.bold("Network:")} ${pc.dim("use --host to expose")}`);
-	else if (resolvedNetworkUrl === "") console.log(`  ${pc.dim("➜")}  ${pc.bold("Network:")} ${pc.dim("no external interface found")}`);
-	else console.log(`  ${pc.dim("➜")}  ${pc.bold("Network:")} ${pc.cyan(resolvedNetworkUrl)}`);
-	console.log("");
-}
-
-//#endregion
 //#region src/cli/dev.ts
 const PRIMARY_MANAGED_CONFIG_FILE = "docs.json";
 const LEGACY_MANAGED_CONFIG_FILE = "docs.cloud.json";

package/dist/{doctor-Bfkrkzad.mjs → cli/doctor.mjs}

@@ -1,29 +1,26 @@
-import { a as scanDocsPageTargets, i as loadAgentCompactionReviews, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-CYk2DxY7.mjs";
-import "./http-body-DkAPk6D5.mjs";
-import { f as PAGE_AGENT_CONTRACT_FIELDS } from "./markdown-sections-9Oxr33b-.mjs";
-import { d as httpLinkHeaderHasTargetRelation, f as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, p as readAgentSkillDocumentFromTar } from "./prompt-references-DMgbu_dz.mjs";
-import { A as buildDocsAgentDiscoverySpec, At as DEFAULT_SITEMAP_MD_ROUTE, F as buildDocsMcpEndpointCandidates, Gn as DEFAULT_MCP_WELL_KNOWN_ROUTE, M as buildDocsConfigMap, Mt as DEFAULT_SITEMAP_XML_ROUTE, Rt as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Un as DEFAULT_MCP_PUBLIC_ROUTE, Xn as isDocsMcpOAuthScopeToken, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, er as normalizeDocsMcpAuthorizationServerUrls, h as DEFAULT_LLMS_FULL_TXT_ROUTE, hn as resolveAskAISearchRequestConfig, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lr as resolveDocsOkfConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, qn as getDocsMcpProtectedResourceMetadataRoutes, t as DEFAULT_AGENTS_MD_ROUTE, ur as resolveDocsOkfTrustMetadata, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-DkAidqtV.mjs";
-import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-sSEojU80.mjs";
-import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
-import "./sidebar-CFHBj29f.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-BYJAVeI6.mjs";
-import { a as resolveDocsMetadataBaseUrl } from "./metadata-BOHn0Y5K.mjs";
-import "./openapi-mcp-BIOTLiA7.mjs";
-import { n as buildNormalizedOpenApiModel } from "./openapi-operations-DFpaqOqA.mjs";
-import "./prompt-utils-B5g-bv7o.mjs";
-import { _ as validateOpenApiContract, d as loadApiReferenceOpenApiDocumentAsync, f as resolveApiReferenceConfig, m as resolveApiReferenceRenderer, o as buildApiReferenceOperationPagesAsync } from "./api-reference-BYee4zMo.mjs";
-import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-BC7md56k.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-BLNLvXbG.mjs";
-import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./authoring-mcp-CiCUQe3o.mjs";
-import "./cloud-ask-ai-BqKhjpS5.mjs";
-import "./code-blocks-GYdvS3BH.mjs";
-import "./sitemap-server-Lg3YhUx4.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, v as resolveDocsProjectRoot } from "./config-BZnKAj_Y.mjs";
-import { t as detectFramework } from "./utils-C7KDrPpA.mjs";
-import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CLUViycJ.mjs";
-import { t as analyzeConfiguredAgentSkillsProgressiveDisclosure } from "./agent-skills-progressive-disclosure-PjPtTYL-.mjs";
+import { resolveDocsOkfConfig, resolveDocsOkfTrustMetadata } from "../okf.mjs";
+import { DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, getDocsMcpProtectedResourceMetadataRoutes, isDocsMcpOAuthScopeToken, normalizeDocsMcpAuthorizationServerUrls } from "../mcp-auth.mjs";
+import { PAGE_AGENT_CONTRACT_FIELDS } from "../agent-contract.mjs";
+import { resolveAskAISearchRequestConfig } from "../search.mjs";
+import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "../agent-skills-spec.mjs";
+import { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, API_CATALOG_MEDIA_TYPE, API_CATALOG_PROFILE_URI, DEFAULT_AGENT_SKILLS_INDEX_FORMAT, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_FORMAT, DEFAULT_API_CATALOG_FORMAT, DEFAULT_API_CATALOG_ROUTE, resolveDocsDiscoveryApiRoute } from "../standards-discovery.mjs";
+import { DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, resolveDocsSitemapConfig } from "../sitemap.mjs";
+import { DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, buildDocsAgentDiscoverySpec, buildDocsConfigMap, buildDocsMcpEndpointCandidates } from "../agent.mjs";
+import { AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, readAgentSkillDocumentFromTar } from "../agent-skills-archive.mjs";
+import { httpLinkHeaderHasTargetRelation } from "../http-link.mjs";
+import { DEFAULT_ROBOTS_TXT_ROUTE, analyzeDocsRobotsTxt, resolveDocsRobotsConfig } from "../robots.mjs";
+import { resolveDocsMetadataBaseUrl } from "../metadata.mjs";
+import { resolveConfiguredAgentSkills } from "../agent-skills-server.mjs";
+import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "../mcp.mjs";
+import { runDocsGoldenTasks } from "../agent-evals.mjs";
+import { extractNestedObjectLiteral, extractTopLevelConfigObject, loadDocsConfigModuleResultWithProjectEnv, readBooleanProperty, readNavTitle, readTopLevelStringProperty, resolveDocsConfigPath, resolveDocsContentDir, resolveDocsProjectRoot } from "./config.mjs";
+import { detectFramework } from "./utils.mjs";
+import { compactAgentDocs, inspectAgentCompactionState, loadAgentCompactionReviews, scanDocsPageTargets } from "./agent.mjs";
+import { analyzeAgentUsefulness, createAgentUsefulnessPagesFromMcp } from "../agent-usefulness.mjs";
+import { analyzeAgentSurfaceDrift } from "../agent-surface-drift.mjs";
+import { analyzeConfiguredAgentSkillsProgressiveDisclosure } from "../agent-skills-progressive-disclosure.mjs";
+import { resolveGoldenEvaluationInput } from "./golden-evaluations.mjs";
+import { inspectApiReferenceHealth } from "./api-doctor.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";
@@ -32,209 +29,12 @@ import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/server";
 import pc from "picocolors";
 import { AsyncLocalStorage } from "node:async_hooks";
 
-//#region src/cli/api-doctor.ts
-function makeCheck$1(id, title, status, detail, recommendation) {
-	return {
-		id,
-		title,
-		status,
-		detail,
-		recommendation
-	};
-}
-function toApiReferenceFramework(framework) {
-	return framework === "nextjs" ? "next" : framework;
-}
-function sourceType(source) {
-	if (!source) return "generated";
-	if (/^https?:/i.test(source) || source.startsWith("/")) return "remote";
-	return "local";
-}
-function displaySource(source, routeRoot) {
-	if (!source) return `generated:${routeRoot}`;
-	if (source.startsWith("/")) return source.split(/[?#]/, 1)[0] || "/";
-	if (!/^https?:/i.test(source)) return source;
-	try {
-		const url = new URL(source);
-		url.username = url.username ? "redacted" : "";
-		url.password = url.password ? "redacted" : "";
-		url.search = "";
-		url.hash = "";
-		return url.href;
-	} catch {
-		return "configured remote source";
-	}
-}
-function unique(values) {
-	return new Set(values).size === values.length;
-}
-function failedReport(framework, detail, recommendation) {
-	return {
-		mode: "api",
-		framework,
-		enabled: false,
-		sourceCount: 0,
-		operationCount: 0,
-		checks: [makeCheck$1("config", "API reference config", "fail", detail, recommendation)],
-		sources: [],
-		recommendations: [recommendation]
-	};
-}
-async function inspectApiReferenceHealth(options = {}) {
-	const invocationRoot = process.cwd();
-	let configPath;
-	let rootDir;
-	let framework = "unknown";
-	try {
-		configPath = resolveDocsConfigPath(invocationRoot, options.configPath);
-		rootDir = resolveDocsProjectRoot(invocationRoot, configPath);
-		framework = detectFramework(rootDir) ?? "unknown";
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		framework = detectFramework(invocationRoot) ?? "unknown";
-		return failedReport(framework, message, "Add docs.config.ts[x] or pass --config so the API doctor can inspect the contract.");
-	}
-	const configLoad = await loadDocsConfigModuleResultWithProjectEnv(rootDir, configPath);
-	if (configLoad.status !== "evaluated") return {
-		...failedReport(framework, `Could not evaluate ${path.relative(rootDir, configPath).replace(/\\/g, "/")}. ${configLoad.error}`, "Fix docs.config module evaluation so API sources, versions, overlays, and renderer settings can be validated."),
-		configPath: path.relative(rootDir, configPath).replace(/\\/g, "/")
-	};
-	const config = configLoad.config;
-	let apiReference;
-	try {
-		apiReference = resolveApiReferenceConfig(config.apiReference);
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		return {
-			...failedReport(framework, message, "Correct the apiReference configuration, then rerun docs doctor --api."),
-			configPath: path.relative(rootDir, configPath).replace(/\\/g, "/")
-		};
-	}
-	const relativeConfigPath = path.relative(rootDir, configPath).replace(/\\/g, "/");
-	if (!apiReference.enabled) {
-		const recommendation = "Enable apiReference when this project should publish an OpenAPI contract and generated operation documentation.";
-		return {
-			mode: "api",
-			framework,
-			configPath: relativeConfigPath,
-			enabled: false,
-			sourceCount: 0,
-			operationCount: 0,
-			checks: [makeCheck$1("config", "API reference config", "warn", "apiReference is disabled; there is no API contract to inspect.", recommendation)],
-			sources: [],
-			recommendations: [recommendation]
-		};
-	}
-	if (framework === "unknown") return {
-		...failedReport(framework, "Could not detect a supported framework from package.json.", "Install or declare Next.js, TanStack Start, Farm.js, SvelteKit, Astro, or Nuxt in the docs app package."),
-		configPath: relativeConfigPath,
-		enabled: true
-	};
-	const apiFramework = toApiReferenceFramework(framework);
-	const renderer = resolveApiReferenceRenderer(config.apiReference, apiFramework);
-	const configuredSources = apiReference.versions.length > 0 ? apiReference.versions.map((version) => ({
-		id: version.id,
-		label: version.label,
-		default: version.default,
-		specUrl: version.specUrl,
-		overlays: version.overlays
-	})) : [{
-		id: "default",
-		label: "Default",
-		default: true,
-		specUrl: apiReference.specUrl,
-		overlays: apiReference.overlays
-	}];
-	const loadedSources = await Promise.all(configuredSources.map(async (source) => {
-		const baseReport = {
-			id: source.id,
-			label: source.label,
-			default: source.default,
-			source: displaySource(source.specUrl, apiReference.routeRoot),
-			sourceType: sourceType(source.specUrl),
-			overlays: source.overlays.length,
-			status: "fail",
-			operationCount: 0
-		};
-		try {
-			const document = await loadApiReferenceOpenApiDocumentAsync(config, {
-				framework: apiFramework,
-				rootDir,
-				baseUrl: options.baseUrl,
-				version: apiReference.versions.length > 0 ? source.id : void 0
-			});
-			const validation = validateOpenApiContract(document);
-			if (!validation.valid) {
-				const first = validation.diagnostics[0];
-				throw new Error(first ? `${first.path}: ${first.message}` : "The resolved OpenAPI document is invalid.");
-			}
-			const model = buildNormalizedOpenApiModel(document);
-			return {
-				report: {
-					...baseReport,
-					status: "pass",
-					specificationVersion: model.specificationVersion,
-					operationCount: model.operationCount
-				},
-				operationIds: model.operations.map((operation) => operation.operationId),
-				operationSlugs: model.operations.map((operation) => operation.slug)
-			};
-		} catch (error) {
-			return {
-				report: {
-					...baseReport,
-					diagnostic: error instanceof Error ? error.message : String(error)
-				},
-				operationIds: [],
-				operationSlugs: []
-			};
-		}
-	}));
-	const sources = loadedSources.map((source) => source.report);
-	const failedSources = sources.filter((source) => source.status === "fail");
-	const operationCount = sources.reduce((total, source) => total + source.operationCount, 0);
-	const checks = [makeCheck$1("config", "API reference config", "pass", `Evaluated ${relativeConfigPath}; API reference is enabled at /${apiReference.path}.`), makeCheck$1("versions", "Versions and default", "pass", apiReference.versions.length > 0 ? `Resolved ${apiReference.versions.length} named versions with ${apiReference.defaultVersion} as the explicit default.` : "Resolved one unversioned API contract.")];
-	checks.push(failedSources.length === 0 ? makeCheck$1("sources", "Sources, references, and overlays", "pass", `Loaded ${sources.length} ${sources.length === 1 ? "contract" : "contracts"}, resolved references, and applied ${sources.reduce((total, source) => total + source.overlays, 0)} configured overlays.`) : makeCheck$1("sources", "Sources, references, and overlays", "fail", failedSources.map((source) => `${source.label}: ${source.diagnostic ?? "unknown error"}`).join(" "), "Fix the reported source, parsing, reference, validation, or overlay error and rerun docs doctor --api."));
-	const identityFailure = loadedSources.find((source) => !unique(source.operationIds) || !unique(source.operationSlugs));
-	checks.push(identityFailure ? makeCheck$1("operation-identities", "Operation IDs and slugs", "fail", `${identityFailure.report.label} produced duplicate normalized operation IDs or slugs.`, "Give every operation a stable, unique operationId and remove normalized slug collisions.") : makeCheck$1("operation-identities", "Operation IDs and slugs", failedSources.length > 0 ? "warn" : "pass", failedSources.length > 0 ? "Operation identities could only be checked for contracts that loaded successfully." : `Validated ${operationCount} unique normalized operation identities across ${sources.length} ${sources.length === 1 ? "contract" : "contracts"}.`));
-	const rendererCompatible = renderer !== "fumadocs" || framework === "nextjs";
-	checks.push(rendererCompatible ? makeCheck$1("renderer", "Renderer compatibility", "pass", `${renderer} is supported by ${framework}.`) : makeCheck$1("renderer", "Renderer compatibility", "fail", `The fumadocs renderer is only available for Next.js; ${framework} supports the Farming Labs and Scalar renderers.`, "Set apiReference.renderer to \"farming-labs\" or \"scalar\" for this framework."));
-	if (failedSources.length === 0 && !identityFailure) try {
-		const pages = await buildApiReferenceOperationPagesAsync(config, {
-			framework: apiFramework,
-			rootDir,
-			baseUrl: options.baseUrl
-		});
-		const pageUrls = pages.map((page) => page.url);
-		const completePages = pages.every((page) => page.type === "api" && page.canonicalUrl === page.url && Boolean(page.content));
-		const parity = pages.length === operationCount && unique(pageUrls) && completePages;
-		checks.push(parity ? makeCheck$1("surface-parity", "Generated surface parity", "pass", `${pages.length} normalized operations produce ${pages.length} unique search, Ask AI, Markdown, and read-only MCP documents.`) : makeCheck$1("surface-parity", "Generated surface parity", "fail", `Normalized contracts contain ${operationCount} operations, but generated projections contain ${pages.length} complete unique documents.`, "Regenerate operation projections from the normalized model and make their URLs and canonical metadata unique."));
-	} catch (error) {
-		checks.push(makeCheck$1("surface-parity", "Generated surface parity", "fail", error instanceof Error ? error.message : String(error), "Fix operation projection generation and rerun docs doctor --api."));
-	}
-	else checks.push(makeCheck$1("surface-parity", "Generated surface parity", "warn", "Generated projections were not checked because one or more contracts failed validation."));
-	const recommendations = checks.map((check) => check.recommendation).filter((recommendation) => Boolean(recommendation));
-	return {
-		mode: "api",
-		framework,
-		configPath: relativeConfigPath,
-		enabled: true,
-		renderer,
-		defaultVersion: apiReference.defaultVersion,
-		sourceCount: sources.length,
-		operationCount,
-		checks,
-		sources,
-		recommendations
-	};
-}
-
-//#endregion
 //#region src/cli/doctor.ts
 const DEFAULT_HOSTED_TIMEOUT_MS = 15e3;
 const DEFAULT_HOSTED_RETRIES = 1;
 const hostedProbeOptions = new AsyncLocalStorage();
 const NEXT_CONFIG_PATTERN = /^next\.config\.(?:[cm]?js|[cm]?ts)$/;
+const FARM_CONFIG_PATTERN = /^farm\.config\.(?:[cm]?js|[cm]?ts)$/;
 const ASTRO_CONFIG_PATTERN = /^astro\.config\.(?:[cm]?js|[cm]?ts)$/;
 const CODE_FILE_PATTERN = /\.(?:[cm]?js|[cm]?ts|jsx|tsx)$/;
 const IGNORED_DIRS = new Set([
@@ -655,12 +455,12 @@ function hasGithubIntegration(config, content) {
 function hasReadingTimeSurface(config, content) {
 	const current = config?.readingTime;
 	if (current === true) return true;
-	if (current && typeof current === "object") return current.enabled !== false;
+	if (current && typeof current === "object") return current.enabled === true;
 	const topLevelBoolean = readTopLevelBooleanProperty(content, "readingTime");
 	if (typeof topLevelBoolean === "boolean") return topLevelBoolean;
 	const block = extractNestedObjectLiteral(content, ["readingTime"]);
 	if (!block) return false;
-	return readBooleanProperty(block, "enabled") ?? true;
+	return readBooleanProperty(block, "enabled") === true;
 }
 function hasAgentCompactDefaults(config, content) {
 	if (config?.agent?.compact) return true;
@@ -705,6 +505,7 @@ function findCodeFiles(files, predicate) {
 }
 function detectFrameworkFromFiles(files) {
 	if (files.some((file) => NEXT_CONFIG_PATTERN.test(path.basename(file)))) return "nextjs";
+	if (files.some((file) => FARM_CONFIG_PATTERN.test(file))) return "farmjs";
 	if (files.some((file) => file.startsWith("src/routes/") && file.includes("api.docs"))) return "tanstack-start";
 	if (files.some((file) => file === "src/hooks.server.js" || file === "src/hooks.server.ts")) return "sveltekit";
 	if (files.some((file) => ASTRO_CONFIG_PATTERN.test(path.basename(file)))) return "astro";
@@ -729,6 +530,20 @@ function detectRouteSurface(rootDir, framework, staticExport, files) {
 			publicDetail: withDocsConfigs.length > 0 ? `Found withDocs() in ${formatPathList(withDocsConfigs)}.` : "Could not find withDocs() in next.config.*, so public docs rewrites are not verified."
 		};
 	}
+	if (framework === "farmjs") {
+		const withDocsConfigs = files.filter((file) => {
+			if (!FARM_CONFIG_PATTERN.test(file)) return false;
+			const source = read(file);
+			return source.includes("withDocs(") && source.includes("@farming-labs/farmjs");
+		});
+		const found = `Found withDocs() from @farming-labs/farmjs in ${formatPathList(withDocsConfigs)}`;
+		return {
+			apiMounted: withDocsConfigs.length > 0,
+			apiDetail: withDocsConfigs.length > 0 ? `${found}; the adapter serves /api/docs.` : "Could not find withDocs() from @farming-labs/farmjs in farm.config.*.",
+			publicMounted: withDocsConfigs.length > 0,
+			publicDetail: withDocsConfigs.length > 0 ? `${found}; the adapter serves the public docs routes.` : "Could not find withDocs() from @farming-labs/farmjs in farm.config.*, so public docs routes are not verified."
+		};
+	}
 	if (framework === "tanstack-start") {
 		const apiRoutes = findCodeFiles(files, (file) => file.startsWith("src/routes/") && read(file).includes("docsServer.GET") && /createFileRoute\((["'])\/api/.test(read(file)));
 		const publicHandlers = findCodeFiles(files, (file) => file.startsWith("src/routes/") && read(file).includes("isDocsPublicGetRequest(") && read(file).includes("isDocsMcpRequest("));

package/dist/{downgrade-CHMta85e.mjs → cli/downgrade.mjs}

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

package/dist/cli/errors.d.mts

@@ -0,0 +1,4 @@
+//#region src/cli/errors.d.ts
+declare function formatCliError(error: unknown): string;
+//#endregion
+export { formatCliError };

package/dist/{errors-BtnVLhNF.mjs → cli/errors.mjs}

@@ -17,4 +17,4 @@ function shouldPrintStackTrace(env = process.env) {
 }
 
 //#endregion
-export { wasCliErrorReported as i, markCliErrorReported as n, shouldPrintStackTrace as r, formatCliError as t };
+export { formatCliError, markCliErrorReported, shouldPrintStackTrace, wasCliErrorReported };

package/dist/{feedback-evals-DMilg9pY.mjs → cli/feedback-evals.mjs}

@@ -1,42 +1,9 @@
-import { a as compareDocsAgentFeedbackEvaluationBaseline, i as buildDocsAgentFeedbackEvaluationCandidates, o as createDocsAgentFeedbackEvaluationBaseline, t as DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT } from "./agent-feedback-evaluations-CcMGlgsO.mjs";
-import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { buildDocsAgentFeedbackEvaluationCandidates, compareDocsAgentFeedbackEvaluationBaseline, createDocsAgentFeedbackEvaluationBaseline } from "../agent-feedback-evaluations.mjs";
+import { readDocsAgentEvaluationTasksFile, readDocsAgentFeedbackEvaluationBaseline, readDocsAgentFeedbackImprovementReport, readDocsGoldenTasksReportFile } from "../agent-feedback-evaluations-node.mjs";
+import { mkdirSync, renameSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
 
-//#region src/agent-feedback-evaluations-node.ts
-function isRecord(value) {
-	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function readJsonFile(filePath) {
-	return JSON.parse(readFileSync(filePath, "utf8"));
-}
-function readDocsAgentFeedbackImprovementReport(filePath) {
-	const value = readJsonFile(filePath);
-	if (!isRecord(value) || value.format !== "farming-labs-agent-feedback-improvements.v1" || !Array.isArray(value.clusters) || typeof value.feedbackCount !== "number" || typeof value.recurringClusterCount !== "number") throw new Error("Input is not a supported agent feedback improvement report.");
-	return value;
-}
-function readDocsAgentEvaluationTasksFile(filePath) {
-	const value = readJsonFile(filePath);
-	if (Array.isArray(value)) return value;
-	if (!isRecord(value)) throw new Error("Existing evaluation tasks must be a JSON object or array.");
-	if (Array.isArray(value.candidates)) return value.candidates.flatMap((candidate) => isRecord(candidate) && isRecord(candidate.task) ? [candidate.task] : []);
-	if (Array.isArray(value.tasks)) return value.tasks;
-	if (isRecord(value.agent) && isRecord(value.agent.evaluations) && Array.isArray(value.agent.evaluations.tasks)) return value.agent.evaluations.tasks;
-	throw new Error("Could not find evaluation tasks in the existing JSON file.");
-}
-function readDocsGoldenTasksReportFile(filePath) {
-	const value = readJsonFile(filePath);
-	const report = isRecord(value) && isRecord(value.evaluations) ? value.evaluations : value;
-	if (!isRecord(report) || !Array.isArray(report.tasks) || typeof report.taskCount !== "number" || !(typeof report.score === "number" || report.score === null)) throw new Error("Input does not contain a golden-task evaluation report.");
-	return report;
-}
-function readDocsAgentFeedbackEvaluationBaseline(filePath) {
-	const value = readJsonFile(filePath);
-	if (!isRecord(value) || value.format !== DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT || typeof value.score !== "number" || !Array.isArray(value.tasks)) throw new Error("Evaluation baseline format is not supported.");
-	return value;
-}
-
-//#endregion
 //#region src/cli/feedback-evals.ts
 function parseAgentFeedbackEvaluationsArgs(argv) {
 	const options = { existing: [] };

package/dist/{feedback-DL4T5oIO.mjs → cli/feedback.mjs}

@@ -1,4 +1,4 @@
-import { n as analyzeDocsAgentFeedback, r as readDocsAgentFeedbackFile } from "./agent-feedback-loop-CcZL_sb1.mjs";
+import { analyzeDocsAgentFeedback, readDocsAgentFeedbackFile } from "../agent-feedback-loop.mjs";
 import { mkdirSync, renameSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/cli/git-dates.mjs

@@ -0,0 +1,35 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+//#region src/cli/git-dates.ts
+const execFileAsync = promisify(execFile);
+/** Preserve per-path Git history semantics while bounding build-time subprocesses. */
+async function readGitLastModifiedDates(rootDir, sourcePaths) {
+	const paths = [...new Set([...sourcePaths].filter((value) => Boolean(value)))];
+	const dates = /* @__PURE__ */ new Map();
+	let next = 0;
+	const worker = async () => {
+		while (next < paths.length) {
+			const sourcePath = paths[next++];
+			try {
+				const { stdout } = await execFileAsync("git", [
+					"log",
+					"-1",
+					"--format=%cI",
+					"--",
+					sourcePath
+				], {
+					cwd: rootDir,
+					encoding: "utf-8"
+				});
+				const parsed = new Date(stdout.trim());
+				if (!Number.isNaN(parsed.getTime())) dates.set(sourcePath, parsed.toISOString());
+			} catch {}
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(4, paths.length) }, worker));
+	return dates;
+}
+
+//#endregion
+export { readGitLastModifiedDates };

package/dist/cli/golden-evaluations.mjs

@@ -0,0 +1,52 @@
+//#region src/cli/golden-evaluations.ts
+function isPlainRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Normalize the runtime docs.config evaluation shape shared by doctor and review. */
+function resolveGoldenEvaluationInput(evaluationInput) {
+	if (evaluationInput === void 0 || typeof evaluationInput === "boolean") return {
+		tasks: void 0,
+		options: {}
+	};
+	if (!isPlainRecord(evaluationInput)) return {
+		tasks: { evaluationConfig: evaluationInput },
+		options: {}
+	};
+	const options = {
+		surface: evaluationInput.surface,
+		allowNetwork: evaluationInput.allowNetwork,
+		searchTimeoutMs: evaluationInput.searchTimeoutMs,
+		answer: evaluationInput.answer
+	};
+	if (evaluationInput.enabled === false) return {
+		tasks: void 0,
+		options
+	};
+	if ("enabled" in evaluationInput && typeof evaluationInput.enabled !== "boolean") return {
+		tasks: evaluationInput,
+		options
+	};
+	if (!("tasks" in evaluationInput)) return {
+		tasks: void 0,
+		options
+	};
+	const runtimeTasks = evaluationInput.tasks;
+	if (!Array.isArray(runtimeTasks)) return {
+		tasks: runtimeTasks,
+		options
+	};
+	return {
+		tasks: runtimeTasks.map((task) => {
+			if (!isPlainRecord(task)) return task;
+			return {
+				...task,
+				tokenBudget: task.tokenBudget ?? evaluationInput.tokenBudget,
+				topK: task.topK ?? evaluationInput.topK
+			};
+		}),
+		options
+	};
+}
+
+//#endregion
+export { resolveGoldenEvaluationInput };

package/dist/cli/index.d.mts

@@ -1,6 +1,5 @@
-//#region src/cli/errors.d.ts
-declare function formatCliError(error: unknown): string;
-//#endregion
+import { formatCliError } from "./errors.mjs";
+
 //#region src/cli/index.d.ts
 declare const UPGRADE_TAGS: readonly ["latest", "beta"];
 type UpgradeTag = (typeof UPGRADE_TAGS)[number];