@farming-labs/docs 0.2.120 → 0.2.121

package/dist/review.mjs

@@ -0,0 +1,562 @@
+import { getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server.mjs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, join, relative } from "node:path";
+
+//#region src/review.ts
+const DEFAULT_DOCS_REVIEW_WORKFLOW_PATH = ".github/workflows/docs-review.yml";
+const DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW_PATH = ".github/workflows/docs-review-reusable.yml";
+const DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW = "farming-labs/docs/.github/workflows/docs-review-reusable.yml@main";
+const LOCAL_DOCS_REVIEW_REUSABLE_WORKFLOW = "./.github/workflows/docs-review-reusable.yml";
+const DEFAULT_DOCS_REVIEW_PNPM_VERSION = "10";
+const DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD = 80;
+const DEFAULT_DOCS_REVIEW_CI_NAME = "docs-review";
+const DEFAULT_REVIEW_RULES = {
+	brokenLinks: "error",
+	frontmatter: "error",
+	duplicateSlugs: "error",
+	invalidMdx: "error",
+	configExamples: "warn",
+	codeFenceMetadata: "warn",
+	runnableMetadata: "warn",
+	agentContext: "warn",
+	commandHealth: "warn",
+	relatedCoverage: "suggestion",
+	configConfidence: "warn",
+	agentSurfaceDrift: "error",
+	goldenTasks: "warn",
+	agentSkills: "warn"
+};
+const DEFAULT_REVIEW_WEIGHTS = {
+	error: 20,
+	warn: 8,
+	suggestion: 2
+};
+const REVIEW_SEVERITIES = new Set([
+	"off",
+	"suggestion",
+	"warn",
+	"error"
+]);
+const REVIEW_CI_MODES = new Set([
+	"off",
+	"warn",
+	"block"
+]);
+const FILE_EXTS = [
+	"tsx",
+	"ts",
+	"jsx",
+	"js"
+];
+function resolveDocsReviewConfig(review) {
+	if (review === false) return {
+		enabled: false,
+		ci: {
+			enabled: false,
+			name: DEFAULT_DOCS_REVIEW_CI_NAME,
+			mode: "off",
+			annotations: false,
+			comment: false
+		},
+		score: {
+			threshold: DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD,
+			weights: DEFAULT_REVIEW_WEIGHTS
+		},
+		rules: DEFAULT_REVIEW_RULES
+	};
+	const objectConfig = review && typeof review === "object" ? review : {};
+	const ciConfig = objectConfig.ci;
+	const ciObject = ciConfig && typeof ciConfig === "object" ? ciConfig : {};
+	const configuredMode = ciObject.mode;
+	const mode = configuredMode && REVIEW_CI_MODES.has(configuredMode) ? configuredMode : "warn";
+	const enabled = objectConfig.enabled !== false;
+	const ciEnabled = enabled && ciConfig !== false && ciObject.enabled !== false && mode !== "off";
+	return {
+		enabled,
+		ci: {
+			enabled: ciEnabled,
+			name: normalizeCiName(ciObject.name),
+			mode: ciEnabled ? mode : "off",
+			annotations: ciObject.annotations !== false,
+			comment: ciObject.comment !== false
+		},
+		score: {
+			threshold: clampScoreThreshold(objectConfig.score?.threshold),
+			weights: {
+				error: normalizeWeight(objectConfig.score?.weights?.error, DEFAULT_REVIEW_WEIGHTS.error),
+				warn: normalizeWeight(objectConfig.score?.weights?.warn, DEFAULT_REVIEW_WEIGHTS.warn),
+				suggestion: normalizeWeight(objectConfig.score?.weights?.suggestion, DEFAULT_REVIEW_WEIGHTS.suggestion)
+			}
+		},
+		rules: {
+			...DEFAULT_REVIEW_RULES,
+			...normalizeRules(objectConfig.rules)
+		}
+	};
+}
+function buildDocsReviewWorkflow(options = {}) {
+	const packageManager = options.packageManager ?? "npm";
+	const ciName = normalizeCiName(options.ciName);
+	const projectDir = normalizeProjectDir(options.projectDir);
+	const configPath = options.configPath ?? "docs.config.ts";
+	const reusableWorkflow = options.reusableWorkflow ?? DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW;
+	const filters = normalizePathFilters(options.pathFilters);
+	const workflowInputs = [
+		["check-name", ciName],
+		["config", configPath],
+		["working-directory", projectDir],
+		["package-manager", packageManager],
+		options.pnpmVersion ? ["pnpm-version", options.pnpmVersion] : void 0,
+		options.buildCommand ? ["build-command", options.buildCommand] : void 0,
+		options.reviewCommand ? ["review-command", options.reviewCommand] : void 0
+	].filter((input) => Boolean(input)).map(([key, value]) => `      ${key}: ${JSON.stringify(value)}`).join("\n");
+	return `# Generated by @farming-labs/docs. You can edit this file.
+name: Docs Review
+
+on:
+  pull_request:
+    paths:
+${filters.map((filter) => `      - ${JSON.stringify(filter)}`).join("\n")}
+
+permissions:
+  contents: read
+  checks: write
+  pull-requests: write
+
+jobs:
+  docs-review:
+    name: ${JSON.stringify(ciName)}
+    uses: ${reusableWorkflow}
+    with:
+${workflowInputs}
+    permissions:
+      contents: read
+      checks: write
+      pull-requests: write
+`;
+}
+function ensureDocsReviewWorkflow(options) {
+	const rootDir = options.rootDir;
+	const repoRoot = findGitRoot(rootDir) ?? rootDir;
+	const workflowRelativePath = options.workflowPath ?? DEFAULT_DOCS_REVIEW_WORKFLOW_PATH;
+	const workflowPath = isAbsolute(workflowRelativePath) ? workflowRelativePath : join(repoRoot, workflowRelativePath);
+	const resultRelativePath = toPosixPath(relative(repoRoot, workflowPath));
+	const review = resolveDocsReviewConfig(options.config?.review ?? readDocsReviewConfigFromSource(options.configContent ?? readConfig(rootDir)));
+	if (!review.enabled || !review.ci.enabled) return {
+		status: "disabled",
+		path: workflowPath,
+		relativePath: resultRelativePath
+	};
+	if (existsSync(workflowPath)) return {
+		status: "exists",
+		path: workflowPath,
+		relativePath: resultRelativePath
+	};
+	const configPath = options.configPath ?? findDocsConfigPath(rootDir);
+	const configContent = options.configContent ?? readConfig(rootDir, configPath);
+	const projectDir = toPosixPath(relative(repoRoot, rootDir)) || ".";
+	const packageManager = detectPackageManager(repoRoot);
+	const workflow = buildDocsReviewWorkflow({
+		packageManager,
+		ciName: review.ci.name,
+		reusableWorkflow: hasLocalDocsWorkspacePackage(repoRoot) ? LOCAL_DOCS_REVIEW_REUSABLE_WORKFLOW : DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW,
+		pnpmVersion: detectPnpmVersionFallback(repoRoot, packageManager),
+		projectDir,
+		configPath,
+		buildCommand: detectLocalDocsCliBuildCommand(repoRoot, packageManager),
+		reviewCommand: detectLocalDocsCliReviewCommand(repoRoot, rootDir),
+		pathFilters: buildDocsReviewWorkflowPathFilters({
+			rootDir,
+			repoRoot,
+			config: options.config,
+			configPath,
+			configContent
+		})
+	});
+	mkdirSync(dirname(workflowPath), { recursive: true });
+	writeFileSync(workflowPath, workflow, "utf-8");
+	options.log?.(`[docs] Created ${resultRelativePath} for Docs Review CI.`);
+	return {
+		status: "created",
+		path: workflowPath,
+		relativePath: resultRelativePath
+	};
+}
+function readDocsReviewConfigFromSource(content) {
+	if (!content) return void 0;
+	const rootObject = extractRootObjectLiteral(content) ?? content;
+	const reviewCursor = findTopLevelPropertyValueIndex(rootObject, "review");
+	if (reviewCursor === void 0) return void 0;
+	if (rootObject.startsWith("true", reviewCursor)) return true;
+	if (rootObject.startsWith("false", reviewCursor)) return false;
+	if (rootObject[reviewCursor] !== "{") return void 0;
+	const reviewEnd = findMatchingObjectEnd(rootObject, reviewCursor);
+	if (reviewEnd === void 0) return void 0;
+	const reviewBlock = rootObject.slice(reviewCursor + 1, reviewEnd);
+	const scoreBlock = extractTopLevelObjectLiteral(reviewBlock, "score");
+	const ciCursor = findTopLevelPropertyValueIndex(reviewBlock, "ci");
+	const rulesBlock = extractTopLevelObjectLiteral(reviewBlock, "rules");
+	const ci = ciCursor === void 0 ? void 0 : reviewBlock.startsWith("true", ciCursor) ? true : reviewBlock.startsWith("false", ciCursor) ? false : reviewBlock[ciCursor] === "{" ? readReviewCiObject(reviewBlock, ciCursor) : void 0;
+	return {
+		enabled: readTopLevelBoolean(reviewBlock, "enabled"),
+		score: scoreBlock ? {
+			threshold: readTopLevelNumber(scoreBlock, "threshold"),
+			weights: readReviewWeights(scoreBlock)
+		} : void 0,
+		ci,
+		rules: rulesBlock ? readReviewRules(rulesBlock) : void 0
+	};
+}
+function buildDocsReviewWorkflowPathFilters(options) {
+	const repoRoot = options.repoRoot ?? findGitRoot(options.rootDir) ?? options.rootDir;
+	const configPath = options.configPath ?? findDocsConfigPath(options.rootDir);
+	const configContent = options.configContent ?? readConfig(options.rootDir, configPath);
+	const entry = options.config?.entry ?? readTopLevelString(configContent, "entry") ?? "docs";
+	const contentDir = options.config?.contentDir ?? readTopLevelString(configContent, "contentDir");
+	const projectDir = toPosixPath(relative(repoRoot, options.rootDir));
+	const projectPrefix = projectDir && projectDir !== "." ? `${projectDir}/` : "";
+	const candidates = [
+		prefixPath(projectPrefix, configPath),
+		prefixPath(projectPrefix, `${entry}/**`),
+		prefixPath(projectPrefix, `app/${entry}/**`),
+		prefixPath(projectPrefix, `src/app/${entry}/**`),
+		contentDir ? prefixPath(projectPrefix, `${trimSlashes(contentDir)}/**`) : void 0,
+		prefixPath(projectPrefix, "content/docs/**"),
+		prefixPath(projectPrefix, "src/content/docs/**"),
+		prefixPath(projectPrefix, "src/lib/docs.config.*"),
+		DEFAULT_DOCS_REVIEW_WORKFLOW_PATH,
+		DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW_PATH,
+		...buildAgentSkillPathFilters({
+			rootDir: options.rootDir,
+			repoRoot,
+			skills: options.config?.agent?.skills
+		})
+	];
+	return Array.from(new Set(candidates.filter((candidate) => Boolean(candidate))));
+}
+function buildAgentSkillPathFilters(options) {
+	return getDocsAgentSkillsConfiguredPaths(options.skills).map((configuredPath) => {
+		const absolutePath = isAbsolute(configuredPath) ? configuredPath : join(options.rootDir, configuredPath);
+		const repoRelative = toPosixPath(relative(options.repoRoot, absolutePath));
+		if (!repoRelative || repoRelative.startsWith("../")) return void 0;
+		return repoRelative.endsWith("/SKILL.md") || repoRelative === "SKILL.md" ? repoRelative : `${repoRelative.replace(/\/+$/u, "")}/**`;
+	}).filter((candidate) => Boolean(candidate));
+}
+function normalizeRules(rules) {
+	if (!rules) return {};
+	const knownRules = new Set(Object.keys(DEFAULT_REVIEW_RULES));
+	return Object.fromEntries(Object.entries(rules).filter((entry) => knownRules.has(entry[0]) && REVIEW_SEVERITIES.has(entry[1])));
+}
+function normalizeWeight(value, fallback) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : fallback;
+}
+function normalizeCiName(value) {
+	return value?.trim() || DEFAULT_DOCS_REVIEW_CI_NAME;
+}
+function clampScoreThreshold(value) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD;
+	return Math.min(100, Math.max(0, Math.round(value)));
+}
+function readReviewCiObject(source, cursor) {
+	const end = findMatchingObjectEnd(source, cursor);
+	if (end === void 0) return void 0;
+	const block = source.slice(cursor + 1, end);
+	const mode = readTopLevelString(block, "mode");
+	return {
+		enabled: readTopLevelBoolean(block, "enabled"),
+		name: readTopLevelString(block, "name"),
+		mode: mode && REVIEW_CI_MODES.has(mode) ? mode : void 0,
+		annotations: readTopLevelBoolean(block, "annotations"),
+		comment: readTopLevelBoolean(block, "comment")
+	};
+}
+function readReviewRules(block) {
+	const rules = {};
+	for (const key of Object.keys(DEFAULT_REVIEW_RULES)) {
+		const value = readTopLevelString(block, key);
+		if (value && REVIEW_SEVERITIES.has(value)) rules[key] = value;
+	}
+	return rules;
+}
+function readReviewWeights(block) {
+	const weightsBlock = extractTopLevelObjectLiteral(block, "weights");
+	if (!weightsBlock) return void 0;
+	return {
+		error: readTopLevelNumber(weightsBlock, "error"),
+		warn: readTopLevelNumber(weightsBlock, "warn"),
+		suggestion: readTopLevelNumber(weightsBlock, "suggestion")
+	};
+}
+function detectPackageManager(rootDir) {
+	if (existsSync(join(rootDir, "pnpm-lock.yaml"))) return "pnpm";
+	if (existsSync(join(rootDir, "yarn.lock"))) return "yarn";
+	if (existsSync(join(rootDir, "bun.lock")) || existsSync(join(rootDir, "bun.lockb"))) return "bun";
+	return "npm";
+}
+function detectLocalDocsCliBuildCommand(repoRoot, packageManager) {
+	if (!hasLocalDocsWorkspacePackage(repoRoot)) return void 0;
+	if (packageManager === "pnpm") return "pnpm --filter @farming-labs/docs run build";
+	if (packageManager === "yarn") return "yarn workspace @farming-labs/docs build";
+	if (packageManager === "bun") return "bun run --filter @farming-labs/docs build";
+	return "npm run build --workspace=@farming-labs/docs";
+}
+function detectPnpmVersionFallback(repoRoot, packageManager) {
+	if (packageManager !== "pnpm") return void 0;
+	try {
+		if (JSON.parse(readFileSync(join(repoRoot, "package.json"), "utf-8")).packageManager?.startsWith("pnpm@")) return void 0;
+	} catch {}
+	return DEFAULT_DOCS_REVIEW_PNPM_VERSION;
+}
+function detectLocalDocsCliReviewCommand(repoRoot, rootDir) {
+	if (!hasLocalDocsWorkspacePackage(repoRoot)) return void 0;
+	return `node ${shellQuote(toPosixPath(relative(rootDir, join(repoRoot, "packages", "docs", "dist", "cli", "index.mjs"))) || "./packages/docs/dist/cli/index.mjs")}`;
+}
+function hasLocalDocsWorkspacePackage(repoRoot) {
+	const packageJsonPath = join(repoRoot, "packages", "docs", "package.json");
+	if (!existsSync(packageJsonPath)) return false;
+	try {
+		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+		return packageJson.name === "@farming-labs/docs" && Boolean(packageJson.scripts?.build);
+	} catch {
+		return false;
+	}
+}
+function shellQuote(value) {
+	if (/^[A-Za-z0-9_./:-]+$/.test(value)) return value;
+	return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function normalizeProjectDir(value) {
+	if (!value || value === "") return ".";
+	return toPosixPath(value).replace(/\/+$/, "") || ".";
+}
+function normalizePathFilters(filters) {
+	const normalized = (filters && filters.length > 0 ? filters : ["docs.config.*", "app/docs/**"]).map((filter) => toPosixPath(filter).replace(/^\.\/+/, "")).filter(Boolean);
+	return Array.from(new Set(normalized));
+}
+function findGitRoot(start) {
+	let current = start;
+	while (true) {
+		if (existsSync(join(current, ".git"))) return current;
+		const parent = dirname(current);
+		if (parent === current) return void 0;
+		current = parent;
+	}
+}
+function findDocsConfigPath(rootDir) {
+	for (const ext of FILE_EXTS) {
+		const path = `docs.config.${ext}`;
+		if (existsSync(join(rootDir, path))) return path;
+	}
+	return "docs.config.ts";
+}
+function readConfig(rootDir, configPath = findDocsConfigPath(rootDir)) {
+	const fullPath = join(rootDir, configPath);
+	if (!existsSync(fullPath)) return void 0;
+	try {
+		return readFileSync(fullPath, "utf-8");
+	} catch {
+		return;
+	}
+}
+function prefixPath(prefix, value) {
+	return `${prefix}${toPosixPath(value).replace(/^\.\/+/, "")}`;
+}
+function trimSlashes(value) {
+	return toPosixPath(value).replace(/^\/+|\/+$/g, "");
+}
+function toPosixPath(value) {
+	return value.replaceAll("\\", "/");
+}
+function extractRootObjectLiteral(content) {
+	const candidateIndexes = [content.search(/\bdefineDocs\s*\(/), content.search(/\bexport\s+default\b/)].filter((value) => value !== -1);
+	for (const startIndex of candidateIndexes) {
+		const braceStart = content.indexOf("{", startIndex);
+		if (braceStart === -1) continue;
+		const braceEnd = findMatchingObjectEnd(content, braceStart);
+		if (braceEnd !== void 0) return content.slice(braceStart + 1, braceEnd);
+	}
+}
+function extractTopLevelObjectLiteral(content, key) {
+	const cursor = findTopLevelPropertyValueIndex(content, key);
+	if (cursor === void 0 || content[cursor] !== "{") return void 0;
+	const end = findMatchingObjectEnd(content, cursor);
+	return end === void 0 ? void 0 : content.slice(cursor + 1, end);
+}
+function readTopLevelBoolean(content, key) {
+	const cursor = findTopLevelPropertyValueIndex(content, key);
+	if (cursor === void 0) return void 0;
+	if (content.startsWith("true", cursor)) return true;
+	if (content.startsWith("false", cursor)) return false;
+}
+function readTopLevelNumber(content, key) {
+	const cursor = findTopLevelPropertyValueIndex(content, key);
+	if (cursor === void 0) return void 0;
+	const match = content.slice(cursor).match(/^-?\d+(?:\.\d+)?/);
+	if (!match) return void 0;
+	const value = Number(match[0]);
+	return Number.isFinite(value) ? value : void 0;
+}
+function readTopLevelString(content, key) {
+	if (!content) return void 0;
+	const cursor = findTopLevelPropertyValueIndex(content, key);
+	if (cursor === void 0) return void 0;
+	const quote = content[cursor];
+	if (quote !== "\"" && quote !== "'") return void 0;
+	let value = "";
+	for (let index = cursor + 1; index < content.length; index += 1) {
+		const char = content[index];
+		if (char === "\\") {
+			const escaped = content[index + 1];
+			if (escaped) {
+				value += escaped;
+				index += 1;
+			}
+			continue;
+		}
+		if (char === quote) return value;
+		value += char;
+	}
+}
+function findTopLevelPropertyValueIndex(block, key) {
+	let objectDepth = 0;
+	let arrayDepth = 0;
+	let parenDepth = 0;
+	let inString = null;
+	let inLineComment = false;
+	let inBlockComment = false;
+	let escaped = false;
+	for (let index = 0; index < block.length; index += 1) {
+		const char = block[index];
+		const next = block[index + 1];
+		if (inLineComment) {
+			if (char === "\n") inLineComment = false;
+			continue;
+		}
+		if (inBlockComment) {
+			if (char === "*" && next === "/") {
+				inBlockComment = false;
+				index += 1;
+			}
+			continue;
+		}
+		if (inString) {
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === inString) inString = null;
+			continue;
+		}
+		if (char === "/" && next === "/") {
+			inLineComment = true;
+			index += 1;
+			continue;
+		}
+		if (char === "/" && next === "*") {
+			inBlockComment = true;
+			index += 1;
+			continue;
+		}
+		if (char === "\"" || char === "'" || char === "`") {
+			inString = char;
+			continue;
+		}
+		if (char === "{") {
+			objectDepth += 1;
+			continue;
+		}
+		if (char === "}") {
+			objectDepth = Math.max(0, objectDepth - 1);
+			continue;
+		}
+		if (char === "[") {
+			arrayDepth += 1;
+			continue;
+		}
+		if (char === "]") {
+			arrayDepth = Math.max(0, arrayDepth - 1);
+			continue;
+		}
+		if (char === "(") {
+			parenDepth += 1;
+			continue;
+		}
+		if (char === ")") {
+			parenDepth = Math.max(0, parenDepth - 1);
+			continue;
+		}
+		if (objectDepth !== 0 || arrayDepth !== 0 || parenDepth !== 0) continue;
+		if (!block.startsWith(key, index)) continue;
+		const before = block[index - 1] ?? "";
+		const after = block[index + key.length] ?? "";
+		if (/[A-Za-z0-9_$]/.test(before) || /[A-Za-z0-9_$]/.test(after)) continue;
+		let cursor = index + key.length;
+		while (/\s/.test(block[cursor] ?? "")) cursor += 1;
+		if (block[cursor] !== ":") continue;
+		cursor += 1;
+		while (/\s/.test(block[cursor] ?? "")) cursor += 1;
+		return cursor;
+	}
+}
+function findMatchingObjectEnd(block, start) {
+	let depth = 0;
+	let inString = null;
+	let inLineComment = false;
+	let inBlockComment = false;
+	let escaped = false;
+	for (let index = start; index < block.length; index += 1) {
+		const char = block[index];
+		const next = block[index + 1];
+		if (inLineComment) {
+			if (char === "\n") inLineComment = false;
+			continue;
+		}
+		if (inBlockComment) {
+			if (char === "*" && next === "/") {
+				inBlockComment = false;
+				index += 1;
+			}
+			continue;
+		}
+		if (inString) {
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === inString) inString = null;
+			continue;
+		}
+		if (char === "/" && next === "/") {
+			inLineComment = true;
+			index += 1;
+			continue;
+		}
+		if (char === "/" && next === "*") {
+			inBlockComment = true;
+			index += 1;
+			continue;
+		}
+		if (char === "\"" || char === "'" || char === "`") {
+			inString = char;
+			continue;
+		}
+		if (char === "{") {
+			depth += 1;
+			continue;
+		}
+		if (char !== "}") continue;
+		depth -= 1;
+		if (depth === 0) return index;
+	}
+}
+
+//#endregion
+export { DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, ensureDocsReviewWorkflow, readDocsReviewConfigFromSource, resolveDocsReviewConfig };

package/dist/robots.d.mts

@@ -0,0 +1,54 @@
+import { DocsRobotsConfig, DocsRobotsRule, DocsSitemapConfig } from "./types.mjs";
+
+//#region src/robots.d.ts
+declare const DEFAULT_ROBOTS_TXT_ROUTE = "/robots.txt";
+declare const DOCS_ROBOTS_GENERATED_BLOCK_START = "# BEGIN @farming-labs/docs robots";
+declare const DOCS_ROBOTS_GENERATED_BLOCK_END = "# END @farming-labs/docs robots";
+declare const DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS: readonly ["GPTBot", "ChatGPT-User", "OAI-SearchBot", "ClaudeBot", "Claude-User", "anthropic-ai", "CCBot", "Google-Extended"];
+interface DocsRobotsResolvedConfig {
+  enabled: boolean;
+  path?: string;
+  baseUrl?: string;
+  ai: "allow" | "disallow";
+  userAgents: string[];
+  extraRules: DocsRobotsRule[];
+}
+interface DocsRobotsRenderOptions {
+  entry?: string;
+  /** Include the RFC 9727 catalog route only when the deployment actually serves it. */
+  apiCatalog?: boolean;
+  /** Include an A2A Agent Card only when a real A2A service is configured. */
+  agentCard?: boolean;
+  sitemap?: boolean | DocsSitemapConfig;
+  baseUrl?: string;
+  robots?: boolean | DocsRobotsConfig;
+}
+interface DocsRobotsAnalysis {
+  blocksAgentRoutes: boolean;
+  blocksAiAgents: boolean;
+  hasAgentRoutes: boolean;
+  hasAiPolicy: boolean;
+  missingRoutes: string[];
+}
+interface DocsRobotsAnalysisOptions extends DocsRobotsRenderOptions {
+  /** Exact sitemap routes advertised by a fetched discovery manifest. */
+  sitemapRoutes?: readonly string[];
+}
+interface CreateDocsRobotsResponseOptions extends DocsRobotsRenderOptions {
+  request: Request;
+}
+declare function resolveDocsRobotsConfig(input: boolean | DocsRobotsConfig | undefined, options?: {
+  baseUrl?: string;
+}): DocsRobotsResolvedConfig;
+declare function getDocsRobotsAllowRoutes(options?: DocsRobotsRenderOptions): string[];
+declare function renderDocsRobotsTxt(options?: DocsRobotsRenderOptions): string;
+declare function resolveDocsRobotsRequest(url: URL, robots?: boolean | DocsRobotsConfig): "robots" | null;
+declare function createDocsRobotsResponse({
+  request,
+  ...options
+}: CreateDocsRobotsResponseOptions): Response | null;
+declare function renderDocsRobotsGeneratedBlock(options?: DocsRobotsRenderOptions): string;
+declare function upsertDocsRobotsGeneratedBlock(existing: string, block: string): string;
+declare function analyzeDocsRobotsTxt(content: string, options?: DocsRobotsAnalysisOptions): DocsRobotsAnalysis;
+//#endregion
+export { DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_ROBOTS_TXT_ROUTE, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DocsRobotsAnalysis, DocsRobotsAnalysisOptions, DocsRobotsRenderOptions, DocsRobotsResolvedConfig, analyzeDocsRobotsTxt, createDocsRobotsResponse, getDocsRobotsAllowRoutes, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, resolveDocsRobotsConfig, resolveDocsRobotsRequest, upsertDocsRobotsGeneratedBlock };

package/dist/{robots-BYJAVeI6.mjs → robots.mjs}

@@ -1,5 +1,7 @@
-import { Gn as DEFAULT_MCP_WELL_KNOWN_ROUTE, Rt as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Un as DEFAULT_MCP_PUBLIC_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, tt as normalizeDocsPathSegment, 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 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, v as DEFAULT_API_CATALOG_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-sSEojU80.mjs";
+import { DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE } from "./mcp-auth.mjs";
+import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery.mjs";
+import { 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, normalizeDocsPathSegment } from "./agent.mjs";
 
 //#region src/robots.ts
 const DEFAULT_ROBOTS_TXT_ROUTE = "/robots.txt";
@@ -266,4 +268,4 @@ function analyzeDocsRobotsTxt(content, options = {}) {
 }
 
 //#endregion
-export { analyzeDocsRobotsTxt as a, renderDocsRobotsGeneratedBlock as c, resolveDocsRobotsRequest as d, upsertDocsRobotsGeneratedBlock as f, DOCS_ROBOTS_GENERATED_BLOCK_START as i, renderDocsRobotsTxt as l, DEFAULT_ROBOTS_TXT_ROUTE as n, createDocsRobotsResponse as o, DOCS_ROBOTS_GENERATED_BLOCK_END as r, getDocsRobotsAllowRoutes as s, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS as t, resolveDocsRobotsConfig as u };
+export { DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_ROBOTS_TXT_ROUTE, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, analyzeDocsRobotsTxt, createDocsRobotsResponse, getDocsRobotsAllowRoutes, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, resolveDocsRobotsConfig, resolveDocsRobotsRequest, upsertDocsRobotsGeneratedBlock };

package/dist/runtime.d.mts

@@ -1,5 +1,5 @@
-import { n as resolveConfiguredAgentSkills } from "./agent-skills-server-D5IuvwM7.mjs";
-import "./content-change-hydration-wqXIZHp6.mjs";
+import { resolveConfiguredAgentSkills } from "./agent-skills-server.mjs";
 import { DocsMcpPage, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import { C as resolveApiReferenceRenderer, S as resolveApiReferenceOpenApiDiscovery, T as resolveApiReferenceVersionFromPathname, _ as buildApiReferencePageTitle, g as buildApiReferenceOperationPagesAsync, h as buildApiReferenceOpenApiDocumentAsync, p as buildApiReferenceHtmlDocumentAsync, t as readDocsSitemapManifest, v as buildApiReferenceScalarCss, w as resolveApiReferenceVersion, x as resolveApiReferenceConfig, y as createApiReferenceOperationMarkdownResponse } from "./sitemap-server-BUdPBcGs.mjs";
+import { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname } from "./api-reference.mjs";
+import { readDocsSitemapManifest } from "./sitemap-server.mjs";
 export { type DocsMcpPage, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname, resolveConfiguredAgentSkills, resolveDocsMcpConfig };

package/dist/runtime.mjs

@@ -1,12 +1,6 @@
-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 { a as buildApiReferenceOpenApiDocumentAsync, c as buildApiReferenceScalarCss, f as resolveApiReferenceConfig, g as resolveApiReferenceVersionFromPathname, h as resolveApiReferenceVersion, l as createApiReferenceOperationMarkdownResponse, m as resolveApiReferenceRenderer, o as buildApiReferenceOperationPagesAsync, p as resolveApiReferenceOpenApiDiscovery, r as buildApiReferenceHtmlDocumentAsync, s as buildApiReferencePageTitle } from "./api-reference-BYee4zMo.mjs";
-import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-BC7md56k.mjs";
+import { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname } from "./api-reference.mjs";
+import { resolveConfiguredAgentSkills } from "./agent-skills-server.mjs";
 import { createDocsMcpHttpHandler, createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import { t as readDocsSitemapManifest } from "./sitemap-server-Lg3YhUx4.mjs";
+import { readDocsSitemapManifest } from "./sitemap-server.mjs";
 
 export { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname, resolveConfiguredAgentSkills, resolveDocsMcpConfig };