@farming-labs/docs 0.1.123 → 0.1.125

package/dist/agents-B3kj54S3.mjs

@@ -1,795 +0,0 @@
-import { _ as parseGeneratedAgentDocument, h as hashGeneratedAgentContent, m as GENERATED_AGENT_PROVENANCE_VERSION, v as serializeGeneratedAgentDocument } from "./search-BL7o2rXk.mjs";
-import { E as findDocsMarkdownPage, K as resolveDocsAgentFeedbackConfig, U as renderDocsMarkdownDocument, V as renderDocsAgentsDocument, a as DEFAULT_AGENT_MD_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, y as DEFAULT_OPENAPI_SCHEMA_ROUTE } from "./agent-BS39vnhS.mjs";
-import "./index.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-BZHoJHqC.mjs";
-import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./server.mjs";
-import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, l as readNumberProperty, o as readBooleanProperty, p as resolveDocsContentDir, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-BHRL4R2v.mjs";
-import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
-import matter from "gray-matter";
-import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import pc from "picocolors";
-import { execFileSync } from "node:child_process";
-
-//#region src/cli/agent.ts
-const DEFAULT_TTC_BASE_URL = "https://api.thetokencompany.com";
-const DEFAULT_TTC_MODEL = "bear-1.2";
-const DEFAULT_TTC_AGGRESSIVENESS = .3;
-const INDEX_PAGE_BASENAMES = new Set([
-	"index",
-	"page",
-	"+page"
-]);
-function parseBooleanFlag(raw) {
-	if (raw === "true") return true;
-	if (raw === "false") return false;
-	throw new Error(`Invalid boolean value: ${raw}. Use true or false.`);
-}
-function parseIntegerFlag(raw, name) {
-	const parsed = Number.parseInt(raw, 10);
-	if (!Number.isFinite(parsed)) throw new Error(`Invalid ${name}: ${raw}.`);
-	return parsed;
-}
-function parseFloatFlag(raw, name) {
-	const parsed = Number.parseFloat(raw);
-	if (!Number.isFinite(parsed)) throw new Error(`Invalid ${name}: ${raw}.`);
-	return parsed;
-}
-function parseAgentCompactArgs(argv) {
-	const parsed = { pages: [] };
-	for (let index = 0; index < argv.length; index += 1) {
-		const arg = argv[index];
-		if (arg === "--help" || arg === "-h") {
-			parsed.help = true;
-			continue;
-		}
-		if (arg === "--all") {
-			parsed.all = true;
-			continue;
-		}
-		if (arg === "--dry-run") {
-			parsed.dryRun = true;
-			continue;
-		}
-		if (arg === "--changed") {
-			parsed.changed = true;
-			continue;
-		}
-		if (arg === "--stale") {
-			parsed.stale = true;
-			continue;
-		}
-		if (arg === "--include-missing") {
-			parsed.includeMissing = true;
-			continue;
-		}
-		if (arg === "--protect-json") {
-			const nextValue = argv[index + 1];
-			if (nextValue && !nextValue.startsWith("--")) {
-				parsed.protectJson = parseBooleanFlag(nextValue);
-				index += 1;
-			} else parsed.protectJson = true;
-			continue;
-		}
-		if (!arg.startsWith("--")) {
-			parsed.pages.push(arg);
-			continue;
-		}
-		const [rawKey, inlineValue] = arg.slice(2).split("=", 2);
-		const key = rawKey.trim();
-		const hasInlineValue = inlineValue !== void 0;
-		const nextValue = !hasInlineValue ? argv[index + 1] : void 0;
-		const consumeNextValue = () => {
-			if (!nextValue || nextValue.startsWith("--")) throw new Error(`Missing value for --${key}.`);
-			index += 1;
-			return nextValue;
-		};
-		const value = hasInlineValue ? inlineValue : consumeNextValue();
-		switch (key) {
-			case "page":
-				parsed.pages.push(value);
-				break;
-			case "config":
-				parsed.configPath = value;
-				break;
-			case "api-key":
-				parsed.apiKey = value;
-				break;
-			case "base-url":
-				parsed.baseUrl = value;
-				break;
-			case "api-key-env":
-				parsed.apiKeyEnv = value;
-				break;
-			case "model":
-				parsed.model = value;
-				break;
-			case "aggressiveness":
-				parsed.aggressiveness = parseFloatFlag(value, "aggressiveness");
-				break;
-			case "max-output-tokens":
-				parsed.maxOutputTokens = parseIntegerFlag(value, "max-output-tokens");
-				break;
-			case "min-output-tokens":
-				parsed.minOutputTokens = parseIntegerFlag(value, "min-output-tokens");
-				break;
-			case "protect-json":
-				parsed.protectJson = parseBooleanFlag(value);
-				break;
-			default: throw new Error(`Unknown agent compact flag: --${key}.`);
-		}
-	}
-	return parsed;
-}
-function normalizePathSegment(value) {
-	return value.replace(/^\/+|\/+$/g, "");
-}
-function normalizeUrlPath(value) {
-	const normalized = value.replace(/\/+/g, "/");
-	if (normalized === "/") return normalized;
-	return normalized.replace(/\/+$/, "");
-}
-function normalizeRequestedPage(entry, rawValue) {
-	const trimmed = rawValue.trim();
-	if (!trimmed || trimmed === ".") return `/${normalizePathSegment(entry) || "docs"}`;
-	if (/^https?:\/\//i.test(trimmed)) try {
-		return normalizeUrlPath(new URL(trimmed).pathname.replace(/\.md$/i, ""));
-	} catch {
-		return trimmed;
-	}
-	const withoutMarkdownSuffix = trimmed.replace(/\.md$/i, "");
-	const normalizedEntry = `/${normalizePathSegment(entry) || "docs"}`;
-	const normalized = normalizeUrlPath(withoutMarkdownSuffix.startsWith("/") ? withoutMarkdownSuffix : `/${withoutMarkdownSuffix}`);
-	if (normalized === normalizedEntry || normalized.startsWith(`${normalizedEntry}/`)) return normalized;
-	const slug = normalizePathSegment(withoutMarkdownSuffix);
-	return slug ? normalizeUrlPath(`${normalizedEntry}/${slug}`) : normalizedEntry;
-}
-function scanDocsPageTargets(rootDir, contentDir, entry) {
-	const contentDirAbs = path.resolve(rootDir, contentDir);
-	const targets = [];
-	const visit = (dir, slugParts) => {
-		if (!existsSync(dir)) return;
-		for (const name of readdirSync(dir).sort()) {
-			const fullPath = path.join(dir, name);
-			if (statSync(fullPath).isDirectory()) {
-				visit(fullPath, [...slugParts, name]);
-				continue;
-			}
-			if (name === "agent.md") continue;
-			if (!name.endsWith(".md") && !name.endsWith(".mdx") && !name.endsWith(".svx")) continue;
-			const baseName = name.replace(/\.(md|mdx|svx)$/i, "");
-			if (!INDEX_PAGE_BASENAMES.has(baseName)) continue;
-			const slug = slugParts.join("/");
-			const url = slug ? `/${normalizePathSegment(entry)}/${slug}` : `/${normalizePathSegment(entry)}`;
-			const agentPath = path.join(dir, "agent.md");
-			targets.push({
-				slug,
-				url,
-				pagePath: fullPath,
-				pageDir: dir,
-				agentPath,
-				hasAgentFile: existsSync(agentPath)
-			});
-		}
-	};
-	visit(contentDirAbs, []);
-	return targets;
-}
-function resolveCompressionEndpoint(rawBaseUrl) {
-	const baseUrl = rawBaseUrl ?? process.env.TOKEN_COMPANY_BASE_URL ?? process.env.THE_TOKEN_COMPANY_BASE_URL ?? DEFAULT_TTC_BASE_URL;
-	if (/\/v1\/compress\/?$/i.test(baseUrl)) return baseUrl.replace(/\/+$/, "");
-	return `${baseUrl.replace(/\/+$/, "")}/v1/compress`;
-}
-function runGitCommand(rootDir, args) {
-	return execFileSync("git", args, {
-		cwd: rootDir,
-		encoding: "utf-8"
-	}).trim();
-}
-function normalizeGitRelativePath(value) {
-	return value.replace(/\\/g, "/").replace(/^\.\/+/, "").replace(/^\/+/, "");
-}
-function listGitChangedFiles(rootDir, contentDir) {
-	let gitRoot;
-	try {
-		gitRoot = runGitCommand(rootDir, ["rev-parse", "--show-toplevel"]);
-	} catch {
-		throw new Error("Use --changed inside a git repository.");
-	}
-	const contentDirAbs = path.resolve(rootDir, contentDir);
-	const relativeContentDir = normalizeGitRelativePath(path.relative(gitRoot, contentDirAbs));
-	if (relativeContentDir.startsWith("../")) throw new Error("Configured contentDir must live inside the current git repository for --changed.");
-	const pathspec = relativeContentDir || ".";
-	const changedFiles = /* @__PURE__ */ new Set();
-	const commands = [
-		[
-			"diff",
-			"--name-only",
-			"--",
-			pathspec
-		],
-		[
-			"diff",
-			"--name-only",
-			"--cached",
-			"--",
-			pathspec
-		],
-		[
-			"ls-files",
-			"--others",
-			"--exclude-standard",
-			"--",
-			pathspec
-		]
-	];
-	for (const args of commands) {
-		const output = runGitCommand(gitRoot, args);
-		if (!output) continue;
-		for (const line of output.split("\n")) {
-			const normalized = normalizeGitRelativePath(line.trim());
-			if (!normalized) continue;
-			const absolutePath = path.resolve(gitRoot, normalized);
-			const relativeToRoot = normalizeGitRelativePath(path.relative(rootDir, absolutePath));
-			if (relativeToRoot && !relativeToRoot.startsWith("../")) changedFiles.add(relativeToRoot);
-		}
-	}
-	return changedFiles;
-}
-function resolveCompressionApiKey(explicitApiKey, explicitApiKeyEnv) {
-	const candidateKeys = [
-		explicitApiKeyEnv,
-		"TOKEN_COMPANY_API_KEY",
-		"THE_TOKEN_COMPANY_API_KEY",
-		"TTC_API_KEY"
-	].filter((value) => typeof value === "string" && value.length > 0);
-	const apiKey = explicitApiKey ?? candidateKeys.map((key) => process.env[key]).find(Boolean);
-	if (!apiKey) throw new Error("Missing Token Company API key. Pass --api-key, set agent.compact.apiKey/apiKeyEnv, or set TOKEN_COMPANY_API_KEY.");
-	return apiKey;
-}
-function readAgentCompactConfig(content) {
-	const compactBlock = extractNestedObjectLiteral(content, ["agent", "compact"]);
-	if (!compactBlock) return {};
-	const configuredApiKey = readStringProperty(compactBlock, "apiKey");
-	return {
-		apiKey: configuredApiKey,
-		apiKeyEnv: readStringProperty(compactBlock, "apiKeyEnv") ?? (!configuredApiKey ? readEnvReferenceProperty(compactBlock, "apiKey") : void 0),
-		baseUrl: readStringProperty(compactBlock, "baseUrl"),
-		model: readStringProperty(compactBlock, "model"),
-		aggressiveness: readNumberProperty(compactBlock, "aggressiveness"),
-		maxOutputTokens: readNumberProperty(compactBlock, "maxOutputTokens"),
-		minOutputTokens: readNumberProperty(compactBlock, "minOutputTokens"),
-		protectJson: readBooleanProperty(compactBlock, "protectJson")
-	};
-}
-function readAgentCompactConfigFromModule(config) {
-	const compact = config.agent?.compact;
-	if (!compact) return {};
-	return {
-		apiKey: compact.apiKey,
-		apiKeyEnv: compact.apiKeyEnv,
-		baseUrl: compact.baseUrl,
-		model: compact.model,
-		aggressiveness: compact.aggressiveness,
-		maxOutputTokens: compact.maxOutputTokens,
-		minOutputTokens: compact.minOutputTokens,
-		protectJson: compact.protectJson
-	};
-}
-function mergeAgentCompactOptions(defaults, overrides) {
-	return {
-		...defaults,
-		...Object.fromEntries(Object.entries(overrides).filter(([, value]) => value !== void 0))
-	};
-}
-function normalizeTokenBudget(value) {
-	if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
-	return Math.max(1, Math.ceil(value));
-}
-function readPageTokenBudget(pagePath) {
-	const { data } = matter(readFileSync(pagePath, "utf-8"));
-	return normalizeTokenBudget(data.agent?.tokenBudget);
-}
-function buildCompactionSettingsHash(options) {
-	return hashGeneratedAgentContent(JSON.stringify({
-		model: options.model ?? DEFAULT_TTC_MODEL,
-		aggressiveness: options.aggressiveness ?? DEFAULT_TTC_AGGRESSIVENESS,
-		maxOutputTokens: options.maxOutputTokens ?? null,
-		minOutputTokens: options.minOutputTokens ?? null,
-		protectJson: options.protectJson ?? null
-	}));
-}
-function buildPageOptions(defaults, pagePath) {
-	const tokenBudget = readPageTokenBudget(pagePath);
-	const pageOptions = mergeAgentCompactOptions(defaults, { maxOutputTokens: tokenBudget });
-	if (pageOptions.minOutputTokens !== void 0 && pageOptions.maxOutputTokens !== void 0 && pageOptions.minOutputTokens > pageOptions.maxOutputTokens) pageOptions.minOutputTokens = pageOptions.maxOutputTokens;
-	return {
-		pageOptions,
-		tokenBudget
-	};
-}
-function buildResolvedPageSourceDocument(page) {
-	return renderDocsMarkdownDocument({
-		...page,
-		agentRawContent: void 0
-	});
-}
-function buildAgentSourceDocument(page) {
-	if (typeof page.agentRawContent === "string") return page.agentRawContent;
-	return renderDocsMarkdownDocument(page);
-}
-function readCurrentAgentDocument(target) {
-	if (!target.hasAgentFile || !existsSync(target.agentPath)) return void 0;
-	return parseGeneratedAgentDocument(readFileSync(target.agentPath, "utf-8"));
-}
-function shouldCompactChangedAgentFile(target) {
-	const currentDocument = readCurrentAgentDocument(target);
-	if (!currentDocument) return false;
-	if (!currentDocument.provenance) return true;
-	if (currentDocument.provenance.sourceKind !== "agent-md") return false;
-	return hashGeneratedAgentContent(currentDocument.content) !== currentDocument.provenance.outputHash;
-}
-function resolveSourceKindForCompaction(target, currentDocument) {
-	if (!target.hasAgentFile) return "resolved-page";
-	if (currentDocument?.provenance?.sourceKind === "resolved-page") return "resolved-page";
-	return "agent-md";
-}
-function buildSourceDocumentForCompaction(page, sourceKind) {
-	return sourceKind === "resolved-page" ? buildResolvedPageSourceDocument(page) : buildAgentSourceDocument(page);
-}
-function buildGeneratedAgentProvenance(sourceKind, sourceDocument, output, pageOptions) {
-	return {
-		version: GENERATED_AGENT_PROVENANCE_VERSION,
-		sourceKind,
-		sourceHash: hashGeneratedAgentContent(sourceDocument),
-		settingsHash: buildCompactionSettingsHash(pageOptions),
-		outputHash: hashGeneratedAgentContent(output),
-		generatedAt: (/* @__PURE__ */ new Date()).toISOString()
-	};
-}
-function inspectAgentCompactionState(page, target, defaults) {
-	const { pageOptions, tokenBudget } = buildPageOptions(defaults, target.pagePath);
-	const currentDocument = readCurrentAgentDocument(target);
-	if (!currentDocument) return {
-		status: "missing",
-		sourceKind: "resolved-page",
-		pageOptions,
-		sourceDocument: buildResolvedPageSourceDocument(page),
-		tokenBudget
-	};
-	const sourceKind = resolveSourceKindForCompaction(target, currentDocument);
-	const sourceDocument = buildSourceDocumentForCompaction(page, sourceKind);
-	if (!currentDocument.provenance) return {
-		status: "unknown",
-		sourceKind,
-		pageOptions,
-		sourceDocument,
-		tokenBudget
-	};
-	const outputModified = hashGeneratedAgentContent(currentDocument.content) !== currentDocument.provenance.outputHash;
-	if (currentDocument.provenance.sourceKind === "agent-md") return {
-		status: outputModified ? "modified" : "unknown",
-		sourceKind,
-		pageOptions,
-		sourceDocument,
-		provenance: currentDocument.provenance,
-		tokenBudget
-	};
-	const sourceChanged = hashGeneratedAgentContent(sourceDocument) !== currentDocument.provenance.sourceHash;
-	const settingsChanged = buildCompactionSettingsHash(pageOptions) !== currentDocument.provenance.settingsHash;
-	return {
-		status: outputModified && (sourceChanged || settingsChanged) ? "stale-modified" : outputModified ? "modified" : sourceChanged || settingsChanged ? "stale" : "fresh",
-		sourceKind,
-		pageOptions,
-		sourceDocument,
-		provenance: currentDocument.provenance,
-		tokenBudget
-	};
-}
-function protectForCompression(input) {
-	const segments = [];
-	const stash = (value) => {
-		const token = `__TTC_SAFE_${segments.length}__`;
-		segments.push(value);
-		return token;
-	};
-	let result = input;
-	result = result.replace(/```[\s\S]*?```/g, stash);
-	result = result.replace(/\[[^\]]+\]\([^)]+\)/g, stash);
-	result = result.replace(/`[^`\n]+`/g, stash);
-	result = result.replace(/^(URL|Description|Related):[^\n]*$/gm, stash);
-	result = result.replace(/https?:\/\/[^\s)]+/g, stash);
-	for (let index = 0; index < segments.length; index += 1) result = result.replace(`__TTC_SAFE_${index}__`, `<ttc_safe>${segments[index]}</ttc_safe>`);
-	return result;
-}
-function sanitizeCompressedOutput(output) {
-	return output.replace(/<\/?ttc_safe>/g, "");
-}
-async function compressDocument(input, options) {
-	const apiKey = resolveCompressionApiKey(options.apiKey, options.apiKeyEnv);
-	const endpoint = resolveCompressionEndpoint(options.baseUrl);
-	const aggressiveness = options.aggressiveness ?? DEFAULT_TTC_AGGRESSIVENESS;
-	if (aggressiveness < 0 || aggressiveness > 1) throw new Error("Aggressiveness must be between 0.0 and 1.0.");
-	const payload = {
-		model: options.model ?? DEFAULT_TTC_MODEL,
-		input: protectForCompression(input),
-		compression_settings: {
-			aggressiveness,
-			...options.maxOutputTokens !== void 0 ? { max_output_tokens: options.maxOutputTokens } : {},
-			...options.minOutputTokens !== void 0 ? { min_output_tokens: options.minOutputTokens } : {},
-			...options.protectJson !== void 0 ? { protect_json: options.protectJson } : {}
-		}
-	};
-	const response = await fetch(endpoint, {
-		method: "POST",
-		headers: {
-			Authorization: `Bearer ${apiKey}`,
-			"Content-Type": "application/json"
-		},
-		body: JSON.stringify(payload)
-	});
-	if (!response.ok) {
-		const body = await response.text();
-		throw new Error(`Token Company request failed (${response.status}): ${body || response.statusText}`);
-	}
-	const result = await response.json();
-	const sanitizedOutput = typeof result.output === "string" ? sanitizeCompressedOutput(result.output) : result.output;
-	if (typeof sanitizedOutput !== "string" || sanitizedOutput.trim().length === 0) throw new Error("Token Company response did not include a compressed output.");
-	return {
-		...result,
-		output: sanitizedOutput
-	};
-}
-function resolveSelectedPages(pages, targets, entry, requested, includeAll) {
-	const compactableBySlug = new Map(targets.map((target) => [target.slug, target]));
-	if (includeAll) return targets.map((target) => {
-		const page = pages.find((candidate) => candidate.slug === target.slug);
-		return page ? {
-			page,
-			target
-		} : null;
-	}).filter((value) => value !== null);
-	const resolved = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const rawRequest of requested) {
-		const page = findDocsMarkdownPage(entry, pages, normalizeRequestedPage(entry, rawRequest));
-		if (!page) throw new Error(`Could not find a docs page for "${rawRequest}".`);
-		const target = compactableBySlug.get(page.slug);
-		if (!target) throw new Error(`Page "${rawRequest}" does not use a folder-based page file, so it cannot be written to a sibling agent.md automatically.`);
-		if (seen.has(target.slug)) continue;
-		seen.add(target.slug);
-		resolved.push({
-			page,
-			target
-		});
-	}
-	return resolved;
-}
-function filterChangedPages(rootDir, contentDir, selectedPages) {
-	const changedFiles = listGitChangedFiles(rootDir, contentDir);
-	return selectedPages.filter(({ target }) => {
-		const relativePagePath = normalizeGitRelativePath(path.relative(rootDir, target.pagePath));
-		if (changedFiles.has(relativePagePath)) return true;
-		const relativeAgentPath = normalizeGitRelativePath(path.relative(rootDir, target.agentPath));
-		return changedFiles.has(relativeAgentPath) && shouldCompactChangedAgentFile(target);
-	});
-}
-async function compactAgentDocs(options = {}) {
-	const rootDir = process.cwd();
-	const loadedEnv = loadProjectEnv(rootDir);
-	for (const [key, value] of Object.entries(loadedEnv)) if (process.env[key] === void 0) process.env[key] = value;
-	const loadedConfigModule = await loadDocsConfigModule(rootDir, options.configPath);
-	const configContent = readFileSync(loadedConfigModule?.path ?? resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
-	const resolvedOptions = mergeAgentCompactOptions(mergeAgentCompactOptions(readAgentCompactConfig(configContent), loadedConfigModule?.config ? readAgentCompactConfigFromModule(loadedConfigModule.config) : {}), options);
-	const entry = normalizePathSegment(loadedConfigModule?.config.entry ?? readTopLevelStringProperty(configContent, "entry") ?? "docs") || "docs";
-	const contentDir = typeof loadedConfigModule?.config.contentDir === "string" ? loadedConfigModule.config.contentDir : resolveDocsContentDir(rootDir, configContent, entry);
-	const siteTitle = typeof loadedConfigModule?.config.nav?.title === "string" ? loadedConfigModule.config.nav.title : readNavTitle(configContent) ?? "Documentation";
-	if (resolvedOptions.all && resolvedOptions.pages && resolvedOptions.pages.length > 0) throw new Error("Use either --all or specific page arguments, not both.");
-	if (resolvedOptions.includeMissing && !resolvedOptions.stale) throw new Error("Use --include-missing together with --stale.");
-	const requestedPages = resolvedOptions.pages?.filter((value) => value.trim().length > 0) ?? [];
-	if (!resolvedOptions.all && requestedPages.length === 0 && !resolvedOptions.stale && !resolvedOptions.changed) throw new Error("Pass --all, --changed, --stale, or at least one docs page slug/path to compact.");
-	const pages = await createFilesystemDocsMcpSource({
-		rootDir,
-		entry,
-		contentDir,
-		siteTitle
-	}).getPages();
-	if (pages.length === 0) throw new Error(`No docs content was found under ${contentDir}.`);
-	const selectedPages = resolveSelectedPages(pages, scanDocsPageTargets(rootDir, contentDir, entry), entry, requestedPages, resolvedOptions.all === true || resolvedOptions.stale === true && requestedPages.length === 0 || resolvedOptions.changed === true && requestedPages.length === 0);
-	const filteredPages = resolvedOptions.changed ? filterChangedPages(rootDir, contentDir, selectedPages) : selectedPages;
-	if (filteredPages.length === 0) {
-		if (resolvedOptions.changed) {
-			console.log(pc.green("No changed docs pages needed compaction."));
-			return;
-		}
-		throw new Error("No compactable docs pages matched the request.");
-	}
-	let created = 0;
-	let overwritten = 0;
-	let processed = 0;
-	let skippedFresh = 0;
-	let skippedModified = 0;
-	let skippedUnknown = 0;
-	let skippedMissing = 0;
-	const requestedExplicitPages = requestedPages.length > 0;
-	for (const { page, target } of filteredPages) {
-		const state = inspectAgentCompactionState(page, target, resolvedOptions);
-		if (resolvedOptions.stale) {
-			if (state.status === "fresh") {
-				skippedFresh += 1;
-				continue;
-			}
-			if (state.status === "modified" || state.status === "stale-modified") {
-				skippedModified += 1;
-				continue;
-			}
-			if (state.status === "unknown") {
-				skippedUnknown += 1;
-				continue;
-			}
-			if (state.status === "missing") {
-				if (!(resolvedOptions.includeMissing === true && (requestedExplicitPages || state.tokenBudget !== void 0))) {
-					skippedMissing += 1;
-					continue;
-				}
-			}
-		}
-		const compressed = await compressDocument(state.sourceDocument, state.pageOptions);
-		const nextContent = compressed.output.trimEnd();
-		const generatedDocument = serializeGeneratedAgentDocument(nextContent, buildGeneratedAgentProvenance(state.sourceKind, state.sourceDocument, nextContent, state.pageOptions));
-		console.log(pc.dim(`Compacting ${page.url} (${compressed.original_input_tokens ?? "?"} -> ${compressed.output_tokens ?? "?"} tokens)...`));
-		if (resolvedOptions.dryRun) continue;
-		mkdirSync(target.pageDir, { recursive: true });
-		writeFileSync(target.agentPath, generatedDocument, "utf-8");
-		if (target.hasAgentFile) overwritten += 1;
-		else created += 1;
-		processed += 1;
-	}
-	if (resolvedOptions.dryRun) processed = filteredPages.length - skippedFresh - skippedModified - skippedUnknown - skippedMissing;
-	if (resolvedOptions.stale && processed === 0) {
-		console.log(pc.green("No stale generated agent.md files needed updates."));
-		if (skippedFresh + skippedModified + skippedUnknown + skippedMissing > 0) console.log(pc.dim(`Skipped ${skippedFresh} fresh, ${skippedModified} modified, ${skippedUnknown} unknown, and ${skippedMissing} missing page${skippedFresh + skippedModified + skippedUnknown + skippedMissing === 1 ? "" : "s"}.`));
-		return;
-	}
-	const summaryPrefix = resolvedOptions.dryRun ? "Dry run complete" : "Compaction complete";
-	console.log(pc.green(`${summaryPrefix}: ${processed} page${processed === 1 ? "" : "s"} processed` + (resolvedOptions.dryRun ? "." : ` (${created} created, ${overwritten} overwritten).`)));
-	if (resolvedOptions.stale) console.log(pc.dim(`Skipped ${skippedFresh} fresh, ${skippedModified} modified, ${skippedUnknown} unknown, and ${skippedMissing} missing page${skippedFresh + skippedModified + skippedUnknown + skippedMissing === 1 ? "" : "s"}.`));
-}
-function printAgentCompactHelp() {
-	console.log(`
-${pc.bold("docs agent compact")} — Generate sibling ${pc.cyan("agent.md")} files by compacting resolved docs pages.
-
-${pc.dim("Usage:")}
-  npx @farming-labs/docs@latest ${pc.cyan("agent compact")} ${pc.dim("[page ...]")}
-
-${pc.dim("Examples:")}
-  ${pc.cyan("npx @farming-labs/docs@latest agent compact installation configuration")}
-  ${pc.cyan("npx @farming-labs/docs@latest agent compact /docs/installation")}
-  ${pc.cyan("npx @farming-labs/docs@latest agent compact --page installation --page configuration")}
-  ${pc.cyan("npx @farming-labs/docs@latest agent compact --all")}
-  ${pc.cyan("npx @farming-labs/docs@latest agent compact --changed")}
-  ${pc.cyan("npx @farming-labs/docs@latest agent compact --stale")}
-  ${pc.cyan("npx @farming-labs/docs@latest agent compact --stale --include-missing")}
-
-${pc.dim("Per-page override:")}
-  Add ${pc.cyan("agent.tokenBudget")} to a page frontmatter block to override the compact output target for that page.
-
-${pc.dim("Options:")}
-  ${pc.cyan("--all")}                    Compact every folder-based docs page under the configured contentDir
-  ${pc.cyan("--page <slug|path>")}       Add a page explicitly (repeatable); positional page args work too
-  ${pc.cyan("--changed")}                Compact only docs pages changed in the current git working tree
-  ${pc.cyan("--stale")}                  Re-compact only stale generated agent.md files
-  ${pc.cyan("--include-missing")}        With ${pc.cyan("--stale")}, also create missing agent.md files for explicit pages or pages that define ${pc.cyan("agent.tokenBudget")}
-  ${pc.cyan("--config <path>")}          Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
-  ${pc.cyan("--api-key <key>")}          Token Company API key (or set ${pc.dim("TOKEN_COMPANY_API_KEY")})
-  ${pc.cyan("--api-key-env <name>")}     Custom env var name for the Token Company API key
-  ${pc.cyan("--base-url <url>")}         Override the Token Company API base URL (useful for tests)
-  ${pc.cyan("--model <name>")}           Compression model (${pc.dim("bear-1.2")} by default)
-  ${pc.cyan("--aggressiveness <0-1>")}   Compression intensity (${pc.dim("0.3")} by default)
-  ${pc.cyan("--max-output-tokens <n>")}  Pass through to Token Company compression settings
-  ${pc.cyan("--min-output-tokens <n>")}  Pass through to Token Company compression settings
-  ${pc.cyan("--protect-json <bool>")}    Preserve JSON objects during compression
-  ${pc.cyan("--dry-run")}                Resolve pages and call the compressor without writing files
-`);
-}
-
-//#endregion
-//#region src/cli/agents.ts
-const AGENTS_GENERATED_MARKER = "<!-- Generated by @farming-labs/docs agents generate. -->";
-function parseInlineFlag(arg) {
-	const [rawKey, value] = arg.slice(2).split("=", 2);
-	return {
-		key: rawKey.trim(),
-		value
-	};
-}
-function parseAgentsGenerateArgs(argv) {
-	const parsed = {};
-	for (let index = 0; index < argv.length; index += 1) {
-		const arg = argv[index];
-		if (arg === "--help" || arg === "-h") {
-			parsed.help = true;
-			continue;
-		}
-		if (arg === "--force") {
-			parsed.force = true;
-			continue;
-		}
-		if (arg === "--check") {
-			parsed.check = true;
-			continue;
-		}
-		if (arg.startsWith("--config=")) {
-			const value = parseInlineFlag(arg).value;
-			if (!value) throw new Error("Missing value for --config.");
-			parsed.configPath = value;
-			continue;
-		}
-		if (arg === "--config") {
-			const value = argv[index + 1];
-			if (!value || value.startsWith("--")) throw new Error("Missing value for --config.");
-			parsed.configPath = value;
-			index += 1;
-			continue;
-		}
-		if (arg.startsWith("--path=")) {
-			const value = parseInlineFlag(arg).value;
-			if (!value) throw new Error("Missing value for --path.");
-			parsed.path = value;
-			continue;
-		}
-		if (arg === "--path") {
-			const value = argv[index + 1];
-			if (!value || value.startsWith("--")) throw new Error("Missing value for --path.");
-			parsed.path = value;
-			index += 1;
-			continue;
-		}
-		if (!arg.startsWith("--") && !parsed.path) {
-			parsed.path = arg;
-			continue;
-		}
-		throw new Error(`Unknown agents generate flag: ${arg}.`);
-	}
-	return parsed;
-}
-function readTopLevelBooleanProperty(content, key) {
-	const match = content.match(new RegExp(`\\b${key}\\b\\s*:\\s*(true|false)`));
-	return match ? match[1] === "true" : void 0;
-}
-function readLlmsBaseUrlFromConfig(content, config) {
-	if (config?.llmsTxt && typeof config.llmsTxt === "object") return config.llmsTxt.baseUrl;
-	const block = extractNestedObjectLiteral(content, ["llmsTxt"]);
-	return block ? readStringProperty(block, "baseUrl") : void 0;
-}
-function readSitemapBaseUrlFromConfig(content, config) {
-	if (config?.sitemap && typeof config.sitemap === "object") return config.sitemap.baseUrl;
-	const block = extractNestedObjectLiteral(content, ["sitemap"]);
-	return block ? readStringProperty(block, "baseUrl") : void 0;
-}
-function readRobotsConfigFromStatic(content) {
-	const topLevelBoolean = readTopLevelBooleanProperty(content, "robots");
-	if (typeof topLevelBoolean === "boolean") return topLevelBoolean;
-	const block = extractNestedObjectLiteral(content, ["robots"]);
-	if (!block) return void 0;
-	return { enabled: readBooleanProperty(block, "enabled") ?? true };
-}
-function resolvePublicDir(rootDir) {
-	if (detectFramework(rootDir) === "sveltekit") return path.join(rootDir, "static");
-	return path.join(rootDir, "public");
-}
-function resolveAgentsPath(rootDir, options) {
-	if (options.path) return path.isAbsolute(options.path) ? options.path : path.resolve(rootDir, options.path);
-	return path.join(rootDir, "AGENTS.md");
-}
-function publicFilePath(rootDir, route) {
-	return path.join(resolvePublicDir(rootDir), route.replace(/^\/+/, ""));
-}
-function normalizeGeneratedContent(content) {
-	return `${AGENTS_GENERATED_MARKER}\n${content.trimEnd()}\n`;
-}
-function normalizeCustomContent(content) {
-	return content.endsWith("\n") ? content : `${content}\n`;
-}
-function isManagedAgentsFile(content) {
-	return content.includes(AGENTS_GENERATED_MARKER);
-}
-function writeIfNeeded(filePath, content, options) {
-	const current = existsSync(filePath) ? readFileSync(filePath, "utf-8") : void 0;
-	if (current === content) return "current";
-	if (current !== void 0 && !options.force && !isManagedAgentsFile(current)) return "kept";
-	if (options.check) return "changed";
-	mkdirSync(path.dirname(filePath), { recursive: true });
-	writeFileSync(filePath, content, "utf-8");
-	return "changed";
-}
-function resolveOpenApiDiscovery(config) {
-	const apiReference = resolveApiReferenceConfig(config?.apiReference);
-	if (!apiReference.enabled) return { enabled: false };
-	return {
-		enabled: true,
-		url: DEFAULT_OPENAPI_SCHEMA_ROUTE,
-		source: apiReference.specUrl ? "configured" : "generated",
-		specUrl: apiReference.specUrl,
-		apiReferencePath: `/${apiReference.path}`
-	};
-}
-async function generateAgents(options = {}) {
-	const rootDir = process.cwd();
-	const loadedConfigModule = await loadDocsConfigModule(rootDir, options.configPath);
-	const configContent = readFileSync(loadedConfigModule?.path ?? resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
-	const config = loadedConfigModule?.config;
-	const entry = config?.entry ?? readTopLevelStringProperty(configContent, "entry") ?? "docs";
-	const siteTitle = typeof config?.nav?.title === "string" ? config.nav.title : readNavTitle(configContent) ?? "Documentation";
-	const siteDescription = typeof config?.metadata?.description === "string" ? config.metadata.description : void 0;
-	const baseUrl = readLlmsBaseUrlFromConfig(configContent, config) ?? readSitemapBaseUrlFromConfig(configContent, config);
-	const llmsTxt = config?.llmsTxt;
-	const llmsEnabled = llmsTxt === false ? false : typeof llmsTxt === "object" ? llmsTxt.enabled ?? true : true;
-	const llmsConfig = typeof llmsTxt === "object" ? llmsTxt : void 0;
-	const robotsInput = config?.robots ?? readRobotsConfigFromStatic(configContent) ?? true;
-	const rootAgentsPath = resolveAgentsPath(rootDir, options);
-	const generatedContent = normalizeGeneratedContent(renderDocsAgentsDocument({
-		origin: baseUrl ?? "http://localhost",
-		entry,
-		search: config?.search,
-		mcp: resolveDocsMcpConfig(config?.mcp),
-		feedback: resolveDocsAgentFeedbackConfig(config?.feedback),
-		llms: {
-			enabled: llmsEnabled,
-			baseUrl,
-			siteTitle,
-			siteDescription,
-			maxChars: llmsConfig?.maxChars,
-			sections: llmsConfig?.sections
-		},
-		sitemap: config?.sitemap,
-		robots: robotsInput,
-		openapi: resolveOpenApiDiscovery(config),
-		markdown: { acceptHeader: false }
-	}));
-	const existingRoot = existsSync(rootAgentsPath) ? readFileSync(rootAgentsPath, "utf-8") : null;
-	const sourceContent = existingRoot !== null && !options.force && !isManagedAgentsFile(existingRoot) ? normalizeCustomContent(existingRoot) : generatedContent;
-	const writes = [];
-	const kept = [];
-	const rootStatus = writeIfNeeded(rootAgentsPath, sourceContent, options);
-	if (rootStatus === "changed") writes.push(rootAgentsPath);
-	if (rootStatus === "kept") kept.push(rootAgentsPath);
-	for (const route of [
-		DEFAULT_AGENTS_MD_ROUTE,
-		DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE,
-		DEFAULT_AGENT_MD_ROUTE,
-		DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE
-	]) {
-		const filePath = publicFilePath(rootDir, route);
-		const status = writeIfNeeded(filePath, sourceContent, options);
-		if (status === "changed") writes.push(filePath);
-		if (status === "kept") kept.push(filePath);
-	}
-	if (options.check && writes.length > 0) throw new Error("AGENTS.md output is stale. Run `docs agents generate` to update it.");
-	const relativeRoot = path.relative(rootDir, rootAgentsPath).replace(/\\/g, "/");
-	console.log(writes.length > 0 ? pc.green(`Generated agent instructions at ${relativeRoot}.`) : pc.green(`Agent instructions are current at ${relativeRoot}.`));
-	for (const filePath of writes) {
-		if (filePath === rootAgentsPath) continue;
-		console.log(pc.dim(path.relative(rootDir, filePath).replace(/\\/g, "/")));
-	}
-	for (const filePath of kept) console.log(pc.yellow(`Kept user-owned ${path.relative(rootDir, filePath).replace(/\\/g, "/")}.`));
-}
-function printAgentsGenerateHelp() {
-	console.log(`
-${pc.bold("docs agents generate")} — Generate AGENTS.md instructions for coding agents.
-
-${pc.dim("Usage:")}
-  pnpm exec docs ${pc.cyan("agents generate")} ${pc.dim("[path]")}
-
-${pc.dim("Options:")}
-  ${pc.cyan("--path <path>")}       Write the root instructions file; defaults to ${pc.dim("AGENTS.md")}
-  ${pc.cyan("--force")}             Replace existing AGENTS.md/static files
-  ${pc.cyan("--check")}             Fail if generated output would change
-  ${pc.cyan("--config <path>")}     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
-  ${pc.cyan("-h, --help")}          Show this help message
-`);
-}
-
-//#endregion
-export { readPageTokenBudget as a, generateAgents, printAgentCompactHelp as i, inspectAgentCompactionState as n, scanDocsPageTargets as o, parseAgentsGenerateArgs, printAgentsGenerateHelp, parseAgentCompactArgs as r, compactAgentDocs as t };