@farming-labs/docs 0.2.120 → 0.2.122

package/dist/authoring-mcp.d.mts

@@ -0,0 +1,44 @@
+import { McpServer } from "@modelcontextprotocol/server";
+
+//#region src/authoring-mcp.d.ts
+interface DocsAuthoringMcpOptions {
+  rootDir: string;
+  /** Project-relative or absolute docs content directory. @default entry */
+  contentDir?: string;
+  /** Public docs entry and default content directory. @default "docs" */
+  entry?: string;
+  name?: string;
+  version?: string;
+  /** Branches created by the server must use this prefix. @default "docs/" */
+  branchPrefix?: string;
+  /** Pull request base branch. @default repository default resolved by gh */
+  baseBranch?: string;
+  /** Command argv used by authoring_run_doctor. The first item is the executable. */
+  doctorCommand?: readonly [string, ...string[]];
+  /** Register the external draft-PR publishing tool. Never enabled implicitly. */
+  allowPublish?: boolean;
+  maxFileBytes?: number;
+}
+interface DocsAuthoringFileState {
+  path: string;
+  sha256: string;
+  bytes: number;
+  content: string;
+}
+declare function readDocsAuthoringFile(options: DocsAuthoringMcpOptions, filePath: string): DocsAuthoringFileState;
+declare function writeDocsAuthoringFile(options: DocsAuthoringMcpOptions, input: {
+  path: string;
+  content: string;
+  expectedSha256?: string;
+}): DocsAuthoringFileState;
+/**
+ * Create a protected authoring-only MCP server.
+ *
+ * This server is intentionally separate from createDocsMcpServer and is never wired into public
+ * framework adapters. Use stdio locally or place the returned server behind an authenticated,
+ * authoring-scoped transport.
+ */
+declare function createDocsAuthoringMcpServer(options: DocsAuthoringMcpOptions): Promise<McpServer>;
+declare function runDocsAuthoringMcpStdio(options: DocsAuthoringMcpOptions): Promise<void>;
+//#endregion
+export { DocsAuthoringFileState, DocsAuthoringMcpOptions, createDocsAuthoringMcpServer, readDocsAuthoringFile, runDocsAuthoringMcpStdio, writeDocsAuthoringFile };

package/dist/{authoring-mcp-CiCUQe3o.mjs → authoring-mcp.mjs}

@@ -1,6 +1,6 @@
-import { ot as renderDocsMarkdownDocument } from "./agent-DkAidqtV.mjs";
+import { renderDocsMarkdownDocument } from "./agent.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import { n as analyzeDocsAgentFeedback, r as readDocsAgentFeedbackFile } from "./agent-feedback-loop-CcZL_sb1.mjs";
+import { analyzeDocsAgentFeedback, readDocsAgentFeedbackFile } from "./agent-feedback-loop.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -377,4 +377,4 @@ async function runDocsAuthoringMcpStdio(options) {
 }
 
 //#endregion
-export { writeDocsAuthoringFile as i, readDocsAuthoringFile as n, runDocsAuthoringMcpStdio as r, createDocsAuthoringMcpServer as t };
+export { createDocsAuthoringMcpServer, readDocsAuthoringFile, runDocsAuthoringMcpStdio, writeDocsAuthoringFile };

package/dist/browser.d.mts

@@ -1,4 +1,6 @@
-import { c as emitDocsAnalyticsEvent, d as resolveDocsAnalyticsConfig } from "./analytics-w3FDOksr.mjs";
-import { c as DocsTelemetryPageViewContext, p as emitDocsTelemetryPageViewEvent, t as applySidebarFolderIndexBehavior } from "./sidebar-CMPbVfGP.mjs";
-import { n as resolveDocsAudienceExposure, t as DocsContentAudience } from "./audience-exposure-DBrFWULA.mjs";
-export { type DocsContentAudience, type DocsTelemetryPageViewContext, applySidebarFolderIndexBehavior, emitDocsAnalyticsEvent, emitDocsTelemetryPageViewEvent, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure };
+import { emitDocsAnalyticsEvent, resolveDocsAnalyticsConfig } from "./analytics.mjs";
+import { DocsTelemetryPageViewContext, emitDocsTelemetryPageViewEvent } from "./telemetry-runtime.mjs";
+import { applySidebarFolderIndexBehavior } from "./sidebar.mjs";
+import { buildDocsPageStructuredData } from "./metadata.mjs";
+import { DocsContentAudience, resolveDocsAudienceExposure } from "./audience-exposure.mjs";
+export { type DocsContentAudience, type DocsTelemetryPageViewContext, applySidebarFolderIndexBehavior, buildDocsPageStructuredData, emitDocsAnalyticsEvent, emitDocsTelemetryPageViewEvent, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure };

package/dist/browser.mjs

@@ -1,8 +1,7 @@
-import "./http-body-DkAPk6D5.mjs";
-import "./markdown-sections-9Oxr33b-.mjs";
-import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig } from "./analytics-p8Vhhu2P.mjs";
-import { On as resolveDocsAudienceExposure } from "./agent-DkAidqtV.mjs";
-import "./standards-discovery-sSEojU80.mjs";
-import { c as emitDocsTelemetryPageViewEvent, t as applySidebarFolderIndexBehavior } from "./sidebar-CFHBj29f.mjs";
+import { emitDocsAnalyticsEvent, resolveDocsAnalyticsConfig } from "./analytics.mjs";
+import { resolveDocsAudienceExposure } from "./audience-exposure.mjs";
+import { emitDocsTelemetryPageViewEvent } from "./telemetry-runtime.mjs";
+import { buildDocsPageStructuredData } from "./metadata.mjs";
+import { applySidebarFolderIndexBehavior } from "./sidebar.mjs";
 
-export { applySidebarFolderIndexBehavior, emitDocsAnalyticsEvent, emitDocsTelemetryPageViewEvent, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure };
+export { applySidebarFolderIndexBehavior, buildDocsPageStructuredData, emitDocsAnalyticsEvent, emitDocsTelemetryPageViewEvent, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure };

package/dist/build.d.mts

@@ -0,0 +1,8 @@
+import { DocsConfig } from "./types.mjs";
+import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery.mjs";
+import { resolveConfiguredAgentSkillsSync } from "./agent-skills-server.mjs";
+import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
+import { DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN } from "./agent-detection.mjs";
+import { ensureDocsReviewWorkflow } from "./review.mjs";
+import { loadDocsConfigModule } from "./cli/config.mjs";
+export { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsConfig, ensureDocsReviewWorkflow, loadDocsConfigModule, renderDocsAgentSkillsBundle, resolveConfiguredAgentSkillsSync };

package/dist/build.mjs

@@ -0,0 +1,8 @@
+import { DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN } from "./agent-detection.mjs";
+import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery.mjs";
+import { resolveConfiguredAgentSkillsSync } from "./agent-skills-server.mjs";
+import { ensureDocsReviewWorkflow } from "./review.mjs";
+import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
+import { loadDocsConfigModule } from "./cli/config.mjs";
+
+export { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, ensureDocsReviewWorkflow, loadDocsConfigModule, renderDocsAgentSkillsBundle, resolveConfiguredAgentSkillsSync };

package/dist/changelog.d.mts

@@ -0,0 +1,20 @@
+import { ChangelogFrontmatter, DocsConfig } from "./types.mjs";
+
+//#region src/changelog.d.ts
+interface ResolvedChangelogConfig {
+  enabled: boolean;
+  path: string;
+  contentDir: string;
+  title: string;
+  description?: string;
+  search: boolean;
+  actionsComponent?: unknown;
+}
+interface ChangelogEntrySummary extends ChangelogFrontmatter {
+  slug: string;
+  date: string;
+  url: string;
+}
+declare function resolveChangelogConfig(value: DocsConfig["changelog"]): ResolvedChangelogConfig;
+//#endregion
+export { ChangelogEntrySummary, ResolvedChangelogConfig, resolveChangelogConfig };

package/dist/changelog.mjs

@@ -0,0 +1,39 @@
+//#region src/changelog.ts
+function normalizePathSegment(value, fallback) {
+	return (value ?? fallback).trim().replace(/^\/+|\/+$/g, "") || fallback;
+}
+function normalizeContentDir(value) {
+	const trimmed = value?.trim();
+	if (!trimmed) return "changelog";
+	return trimmed.replace(/\/+$/, "") || "changelog";
+}
+function resolveChangelogConfig(value) {
+	if (value === false || value === void 0) return {
+		enabled: false,
+		path: "changelog",
+		contentDir: "changelog",
+		title: "Changelog",
+		description: void 0,
+		search: true
+	};
+	if (value === true) return {
+		enabled: true,
+		path: "changelog",
+		contentDir: "changelog",
+		title: "Changelog",
+		description: void 0,
+		search: true
+	};
+	return {
+		enabled: value.enabled !== false,
+		path: normalizePathSegment(value.path, "changelog"),
+		contentDir: normalizeContentDir(value.contentDir),
+		title: value.title?.trim() || "Changelog",
+		description: value.description?.trim() || void 0,
+		search: value.search !== false,
+		actionsComponent: value.actionsComponent
+	};
+}
+
+//#endregion
+export { resolveChangelogConfig };

package/dist/{agent-export-CA6IUQ7T.mjs → cli/agent-export.mjs}

@@ -1,27 +1,20 @@
-import "./http-body-DkAPk6D5.mjs";
-import { w as isDocsAgentPageAccessible } from "./markdown-sections-9Oxr33b-.mjs";
-import { A as buildDocsAgentDiscoverySpec, It as renderDocsSitemapMarkdown, Lt as renderDocsSitemapXml, Nt as buildDocsSitemapManifest, Rt as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as toDocsMarkdownUrl, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsLlmsTxt, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as renderDocsSkillDocument, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsAgentsDocument, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lr as resolveDocsOkfConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsMarkdownDocument, sr as buildDocsOkfBundle, t as DEFAULT_AGENTS_MD_ROUTE, ut as resolveDocsAgentFeedbackConfig, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-DkAidqtV.mjs";
-import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, V as formatDocsContentDigest, W as resolveDocsHttpDate, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-sSEojU80.mjs";
-import "./sidebar-CFHBj29f.mjs";
-import { t as resolveDocsI18n } from "./i18n-B1gJ9EW0.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-BYJAVeI6.mjs";
-import "./openapi-mcp-BIOTLiA7.mjs";
-import "./prompt-utils-B5g-bv7o.mjs";
-import "./api-reference-BYee4zMo.mjs";
-import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-BC7md56k.mjs";
-import "./agent-evals-BLNLvXbG.mjs";
-import { createFilesystemDocsMcpSource, 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, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-BZnKAj_Y.mjs";
-import { t as detectFramework } from "./utils-C7KDrPpA.mjs";
+import { isDocsAgentPageAccessible } from "../access.mjs";
+import { toDocsMarkdownUrl } from "../urls.mjs";
+import { buildDocsOkfBundle, resolveDocsOkfConfig } from "../okf.mjs";
+import { formatDocsContentDigest, resolveDocsHttpDate } from "../http-cache.mjs";
+import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, buildDocsA2AAgentCard, buildDocsAgentSkillsIndex, buildDocsLegacySkillsIndex, resolveDocsPublishedAgentSkill } from "../standards-discovery.mjs";
+import { buildDocsSitemapManifest, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveDocsSitemapConfig } from "../sitemap.mjs";
+import { DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, buildDocsAgentDiscoverySpec, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsSkillDocument, resolveDocsAgentFeedbackConfig } from "../agent.mjs";
+import { resolveDocsI18n } from "../i18n.mjs";
+import { DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, renderDocsRobotsGeneratedBlock, resolveDocsRobotsConfig, upsertDocsRobotsGeneratedBlock } from "../robots.mjs";
+import { resolveConfiguredAgentSkills } from "../agent-skills-server.mjs";
+import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "../mcp.mjs";
+import { extractNestedObjectLiteral, extractTopLevelConfigObject, loadDocsConfigModule, readBooleanProperty, readNavTitle, readStringProperty, readTopLevelBooleanProperty, readTopLevelStringProperty, resolveDocsConfigPath, resolveDocsContentDir } from "./config.mjs";
+import { readGitLastModifiedDates } from "./git-dates.mjs";
+import { detectFramework } from "./utils.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
-import { execFileSync } from "node:child_process";
 import pc from "picocolors";
 
 //#region src/cli/agent-export.ts
@@ -345,27 +338,6 @@ function formatDateOnly(value) {
 	if (Number.isNaN(parsed.getTime())) return void 0;
 	return parsed.toISOString().slice(0, 10);
 }
-function pageGitLastmod(rootDir, page) {
-	if (page.sourcePath) try {
-		const output = execFileSync("git", [
-			"log",
-			"-1",
-			"--format=%cI",
-			"--",
-			page.sourcePath
-		], {
-			cwd: rootDir,
-			encoding: "utf-8",
-			stdio: [
-				"ignore",
-				"pipe",
-				"ignore"
-			]
-		}).trim();
-		const parsed = new Date(output);
-		if (!Number.isNaN(parsed.getTime())) return parsed.toISOString();
-	} catch {}
-}
 function deterministicSitemapManifest(options) {
 	const manifest = buildDocsSitemapManifest({
 		pages: options.pages,
@@ -672,15 +644,17 @@ async function exportAgentBundle(options = {}) {
 	if (!internalManifestPath) throw new Error(`Agent Bundle internal manifest must resolve inside the project root: ${AGENT_BUNDLE_INTERNAL_MANIFEST}`);
 	const publicManifestPath = publicFilePath(publicDir, AGENT_BUNDLE_MANIFEST_ROUTE);
 	const previous = readPreviousManifest(internalManifestPath);
-	const localizedPages = (await loadPages({
+	const scannedPages = await loadPages({
 		rootDir,
 		contentDir,
 		routeEntry,
 		siteTitle: resolvedSiteTitle,
 		ordering: config?.ordering,
 		i18n
-	})).map(({ page, locale }) => {
-		const gitLastmod = pageGitLastmod(rootDir, page);
+	});
+	const gitDates = await readGitLastModifiedDates(rootDir, scannedPages.map(({ page }) => page.sourcePath));
+	const localizedPages = scannedPages.map(({ page, locale }) => {
+		const gitLastmod = gitDates.get(page.sourcePath ?? "");
 		return {
 			locale,
 			page: {

package/dist/{agent-CYk2DxY7.mjs → cli/agent.mjs}

@@ -1,44 +1,15 @@
-import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-9Oxr33b-.mjs";
-import { V as findDocsMarkdownPage, ot as renderDocsMarkdownDocument } from "./agent-DkAidqtV.mjs";
-import { d as GENERATED_AGENT_PROVENANCE_VERSION, f as hashGeneratedAgentContent, h as serializeGeneratedAgentDocument, m as parseGeneratedAgentDocument } from "./openapi-mcp-BIOTLiA7.mjs";
-import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-BZnKAj_Y.mjs";
-import { createRequire } from "node:module";
+import { normalizePageAgentFrontmatter, stripGeneratedPageAgentContractMarkdown } from "../agent-contract.mjs";
+import { findDocsMarkdownPage, renderDocsMarkdownDocument } from "../agent.mjs";
+import { GENERATED_AGENT_PROVENANCE_VERSION, hashGeneratedAgentContent, parseGeneratedAgentDocument, serializeGeneratedAgentDocument } from "../agent-provenance.mjs";
+import { createFilesystemDocsMcpSource } from "../mcp.mjs";
+import { extractNestedObjectLiteral, loadDocsConfigModule, loadProjectEnv, readBooleanProperty, readEnvReferenceProperty, readNavTitle, readNumberProperty, readStringProperty, readTopLevelStringProperty, resolveDocsConfigPath, resolveDocsContentDir } from "./config.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";
 import pc from "picocolors";
 
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) {
-		__defProp(target, name, {
-			get: all[name],
-			enumerable: true
-		});
-	}
-	if (!no_symbols) {
-		__defProp(target, Symbol.toStringTag, { value: "Module" });
-	}
-	return target;
-};
-
-//#endregion
 //#region src/cli/agent.ts
-var agent_exports = /* @__PURE__ */ __exportAll({
-	AGENT_COMPACTION_REVIEW_MANIFEST_VERSION: () => AGENT_COMPACTION_REVIEW_MANIFEST_VERSION,
-	DEFAULT_AGENT_COMPACTION_REVIEW_MANIFEST_PATH: () => DEFAULT_AGENT_COMPACTION_REVIEW_MANIFEST_PATH,
-	compactAgentDocs: () => compactAgentDocs,
-	inspectAgentCompactionState: () => inspectAgentCompactionState,
-	loadAgentCompactionReviews: () => loadAgentCompactionReviews,
-	parseAgentCompactArgs: () => parseAgentCompactArgs,
-	printAgentCompactHelp: () => printAgentCompactHelp,
-	readPageTokenBudget: () => readPageTokenBudget,
-	scanDocsPageTargets: () => scanDocsPageTargets
-});
 const DEFAULT_COMPRESSION_BASE_URL = "https://api.farming-labs.dev";
 const DEFAULT_COMPRESSION_MODEL = "docs-cloud-compress-v1";
 const DEFAULT_COMPRESSION_AGGRESSIVENESS = .3;
@@ -818,4 +789,4 @@ ${pc.dim("Options:")}
 }
 
 //#endregion
-export { scanDocsPageTargets as a, loadAgentCompactionReviews as i, compactAgentDocs as n, inspectAgentCompactionState as r, agent_exports as t };
+export { compactAgentDocs, inspectAgentCompactionState, loadAgentCompactionReviews, parseAgentCompactArgs, printAgentCompactHelp, scanDocsPageTargets };

package/dist/{agents-BUiVmj8i.mjs → cli/agents.mjs}

@@ -1,21 +1,8 @@
-import "./http-body-DkAPk6D5.mjs";
-import "./markdown-sections-9Oxr33b-.mjs";
-import { a as DEFAULT_AGENT_MD_ROUTE, it as renderDocsAgentsDocument, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, ut as resolveDocsAgentFeedbackConfig } from "./agent-DkAidqtV.mjs";
-import "./standards-discovery-sSEojU80.mjs";
-import "./sidebar-CFHBj29f.mjs";
-import "./openapi-mcp-BIOTLiA7.mjs";
-import "./prompt-utils-B5g-bv7o.mjs";
-import { p as resolveApiReferenceOpenApiDiscovery } from "./api-reference-BYee4zMo.mjs";
-import "./agent-skills-server-BC7md56k.mjs";
-import "./agent-evals-BLNLvXbG.mjs";
-import { 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 { a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BZnKAj_Y.mjs";
-import { t as detectFramework } from "./utils-C7KDrPpA.mjs";
+import { DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, renderDocsAgentsDocument, resolveDocsAgentFeedbackConfig } from "../agent.mjs";
+import { resolveApiReferenceOpenApiDiscovery } from "../api-reference.mjs";
+import { resolveDocsMcpConfig } from "../mcp.mjs";
+import { extractNestedObjectLiteral, loadDocsConfigModule, readBooleanProperty, readNavTitle, readStringProperty, readTopLevelStringProperty, resolveDocsConfigPath } from "./config.mjs";
+import { detectFramework } from "./utils.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/cli/api-doctor.mjs

@@ -0,0 +1,206 @@
+import { buildNormalizedOpenApiModel } from "../openapi-operations.mjs";
+import { validateOpenApiContract } from "../openapi-contract.mjs";
+import { buildApiReferenceOperationPagesAsync, loadApiReferenceOpenApiDocumentAsync, resolveApiReferenceConfig, resolveApiReferenceRenderer } from "../api-reference.mjs";
+import { loadDocsConfigModuleResultWithProjectEnv, resolveDocsConfigPath, resolveDocsProjectRoot } from "./config.mjs";
+import { detectFramework } from "./utils.mjs";
+import path from "node:path";
+
+//#region src/cli/api-doctor.ts
+function makeCheck(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("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("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("config", "API reference config", "pass", `Evaluated ${relativeConfigPath}; API reference is enabled at /${apiReference.path}.`), makeCheck("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("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("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("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("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("renderer", "Renderer compatibility", "pass", `${renderer} is supported by ${framework}.`) : makeCheck("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("surface-parity", "Generated surface parity", "pass", `${pages.length} normalized operations produce ${pages.length} unique search, Ask AI, Markdown, and read-only MCP documents.`) : makeCheck("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("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("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
+export { inspectApiReferenceHealth };

package/dist/{authoring-C2ymvYWl.mjs → cli/authoring.mjs}

@@ -1,11 +1,5 @@
-import "./http-body-DkAPk6D5.mjs";
-import "./markdown-sections-9Oxr33b-.mjs";
-import "./agent-DkAidqtV.mjs";
-import "./standards-discovery-sSEojU80.mjs";
-import "./sidebar-CFHBj29f.mjs";
-import "./openapi-mcp-BIOTLiA7.mjs";
-import { r as runDocsAuthoringMcpStdio } from "./authoring-mcp-CiCUQe3o.mjs";
-import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, o as loadDocsConfigModuleResult, p as readStringProperty } from "./config-BZnKAj_Y.mjs";
+import { runDocsAuthoringMcpStdio } from "../authoring-mcp.mjs";
+import { loadDocsConfigModuleResult, readNavTitle, readStringProperty, resolveDocsConfigPath, resolveDocsContentDir } from "./config.mjs";
 import { readFileSync } from "node:fs";
 import path from "node:path";
 

package/dist/{cloud-6eKrlmKd.mjs → cli/cloud.mjs}

@@ -1,6 +1,6 @@
-import { n as markCliErrorReported } from "./errors-BtnVLhNF.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BZnKAj_Y.mjs";
-import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-C7KDrPpA.mjs";
+import { extractNestedObjectLiteral, loadDocsConfigModule, loadProjectEnv, readNavTitle, readStringProperty, readTopLevelBooleanProperty, readTopLevelStringProperty, resolveDocsConfigPath, resolveDocsContentDir } from "./config.mjs";
+import { markCliErrorReported } from "./errors.mjs";
+import { detectFramework, detectPackageManagerFromProject } from "./utils.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";

package/dist/{codeblocks-CHpgAwY-.mjs → cli/codeblocks.mjs}

@@ -1,5 +1,5 @@
-import { a as validateCodeBlocks, r as resolveDocsCodeBlocksValidateConfig } from "./code-blocks-GYdvS3BH.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BZnKAj_Y.mjs";
+import { resolveDocsCodeBlocksValidateConfig, validateCodeBlocks } from "../code-blocks.mjs";
+import { extractNestedObjectLiteral, loadDocsConfigModule, readBooleanProperty, readNumberProperty, readStringProperty, readTopLevelStringProperty, resolveDocsConfigPath, resolveDocsContentDir } from "./config.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/cli/config.d.mts

@@ -0,0 +1,11 @@
+import { DocsConfig } from "../types.mjs";
+
+//#region src/cli/config.d.ts
+declare function loadDocsConfigModule(rootDir: string, explicitPath?: string, options?: {
+  silent?: boolean;
+}): Promise<{
+  path: string;
+  config: DocsConfig;
+} | null>;
+//#endregion
+export { loadDocsConfigModule };

package/dist/{config-BZnKAj_Y.mjs → cli/config.mjs}

@@ -391,4 +391,4 @@ async function loadDocsConfigModuleResultWithProjectEnv(rootDir, explicitPath, o
 }
 
 //#endregion
-export { resolveDocsContentDir as _, loadDocsConfigModule as a, loadProjectEnv as c, readNavTitle as d, readNumberProperty as f, resolveDocsConfigPath as g, readTopLevelStringProperty as h, hasTopLevelProperty as i, readBooleanProperty as l, readTopLevelBooleanProperty as m, extractObjectLiteral as n, loadDocsConfigModuleResult as o, readStringProperty as p, extractTopLevelConfigObject as r, loadDocsConfigModuleResultWithProjectEnv as s, extractNestedObjectLiteral as t, readEnvReferenceProperty as u, resolveDocsProjectRoot as v };
+export { extractNestedObjectLiteral, extractObjectLiteral, extractTopLevelConfigObject, hasTopLevelProperty, loadDocsConfigModule, loadDocsConfigModuleResult, loadDocsConfigModuleResultWithProjectEnv, loadProjectEnv, readBooleanProperty, readEnvReferenceProperty, readNavTitle, readNumberProperty, readStringProperty, readTopLevelBooleanProperty, readTopLevelStringProperty, resolveDocsConfigPath, resolveDocsContentDir, resolveDocsProjectRoot };