@farming-labs/docs 0.2.24 → 0.2.26

package/dist/{agent-DpKOO7Ho.mjs → agent-BpPhLG_h.mjs}

@@ -1,8 +1,9 @@
-import "./reading-time-DzuY0IRX.mjs";
-import "./agent-B7T4gauS.mjs";
-import "./robots-CDdD2o-Q.mjs";
-import "./sitemap-server-CVSQQszk.mjs";
-import "./config-rHQQuz98.mjs";
-import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-BnwZNsYO.mjs";
+import "./reading-time-CPAy1SWO.mjs";
+import "./search-DiFxtL5t.mjs";
+import "./agent-DEr3FFdg.mjs";
+import "./robots-BcP7nSfi.mjs";
+import "./sitemap-server-RZG9eOJB.mjs";
+import "./config-De5z-2LK.mjs";
+import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-Dcn5tRbB.mjs";
 
 export { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp };

package/dist/{agent-B7T4gauS.mjs → agent-DEr3FFdg.mjs}

@@ -1,6 +1,303 @@
-import { n as renderDocsRelatedMarkdownLines } from "./related-BNj_NdHq.mjs";
-import { a as DEFAULT_SITEMAP_XML_ROUTE, d as resolveDocsSitemapConfig, i as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, n as DEFAULT_SITEMAP_MD_DOCS_ROUTE, p as resolveDocsSitemapRequest, r as DEFAULT_SITEMAP_MD_ROUTE } from "./sitemap-CMNj0Pt3.mjs";
+//#region src/related.ts
+function normalizeDocsRelated(value) {
+	if (!Array.isArray(value)) return [];
+	const seen = /* @__PURE__ */ new Set();
+	const links = [];
+	for (const item of value) {
+		const parsed = parseRelatedInput(item);
+		if (!parsed) continue;
+		const dedupeKey = normalizeRelatedLookupPath(parsed.href) ?? parsed.href;
+		if (seen.has(dedupeKey)) continue;
+		seen.add(dedupeKey);
+		links.push({ href: parsed.href });
+	}
+	return links;
+}
+function renderDocsRelatedMarkdownLines(related) {
+	if (!related?.length) return [];
+	return [`Related: ${related.map((link) => normalizeInlineText(link.href)).join(", ")}`];
+}
+function parseRelatedInput(value) {
+	if (typeof value === "string") {
+		const href = cleanString(value);
+		return href ? { href } : null;
+	}
+	return null;
+}
+function cleanString(value) {
+	if (typeof value !== "string") return void 0;
+	return value.trim() || void 0;
+}
+function normalizeRelatedLookupPath(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return null;
+	let pathname = trimmed;
+	try {
+		pathname = new URL(trimmed, "https://docs.local").pathname;
+	} catch {
+		pathname = trimmed.split(/[?#]/, 1)[0] ?? trimmed;
+	}
+	pathname = pathname.replace(/\/+/g, "/").replace(/\.md$/i, "");
+	if (!pathname.startsWith("/")) pathname = `/${pathname}`;
+	if (pathname !== "/") pathname = pathname.replace(/\/+$/, "");
+	return pathname;
+}
+function normalizeInlineText(value) {
+	return value.replace(/\s+/g, " ").trim();
+}
+
+//#endregion
+//#region src/sitemap.ts
+const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
+const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
+const DEFAULT_SITEMAP_MD_DOCS_ROUTE = "/docs/sitemap.md";
+const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
+const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
+function normalizeUrlPath(value) {
+	const normalized = value.replace(/\/+/g, "/");
+	if (normalized === "/") return normalized;
+	return normalized.replace(/\/+$/, "");
+}
+function normalizeRoutePrefix(value) {
+	if (!value) return "";
+	const normalized = normalizeUrlPath(`/${value.replace(/^\/+|\/+$/g, "")}`);
+	return normalized === "/" ? "" : normalized;
+}
+function joinRoute(prefix, route) {
+	return normalizeUrlPath(`${prefix}/${route.replace(/^\/+/, "")}`);
+}
+function normalizeDateOnly(value) {
+	if (!value) return void 0;
+	const trimmed = value.trim();
+	if (!trimmed) return void 0;
+	const dateOnly = trimmed.match(/^(\d{4}-\d{2}-\d{2})/);
+	if (dateOnly) return dateOnly[1];
+	const parsed = new Date(trimmed);
+	if (Number.isNaN(parsed.getTime())) return void 0;
+	return parsed.toISOString().slice(0, 10);
+}
+function normalizeBaseUrl(value) {
+	if (!value) return void 0;
+	return value.trim().replace(/\/+$/, "") || void 0;
+}
+function isEnabledObject(config) {
+	if (config === false) return false;
+	if (config === void 0) return true;
+	if (config === true) return true;
+	return config.enabled !== false;
+}
+function resolveDocsSitemapConfig(sitemap, defaults = {}) {
+	const objectConfig = sitemap && typeof sitemap === "object" ? sitemap : {};
+	const routePrefix = normalizeRoutePrefix(objectConfig.routePrefix);
+	const xmlConfig = objectConfig.xml;
+	const markdownConfig = objectConfig.markdown;
+	const xmlEnabled = xmlConfig === false ? false : typeof xmlConfig === "object" ? xmlConfig.enabled ?? true : true;
+	const markdownEnabled = markdownConfig === false ? false : typeof markdownConfig === "object" ? markdownConfig.enabled ?? true : true;
+	return {
+		enabled: isEnabledObject(sitemap),
+		routePrefix,
+		baseUrl: normalizeBaseUrl(objectConfig.baseUrl ?? defaults.baseUrl),
+		manifestPath: objectConfig.manifestPath ?? DEFAULT_SITEMAP_MANIFEST_PATH,
+		xml: {
+			enabled: xmlEnabled,
+			includeLastmod: typeof xmlConfig === "object" ? xmlConfig.includeLastmod ?? true : true,
+			route: joinRoute(routePrefix, DEFAULT_SITEMAP_XML_ROUTE)
+		},
+		markdown: {
+			enabled: markdownEnabled,
+			includeDescriptions: typeof markdownConfig === "object" ? markdownConfig.includeDescriptions ?? true : true,
+			includeLastmod: typeof markdownConfig === "object" ? markdownConfig.includeLastmod ?? true : true,
+			linkTarget: typeof markdownConfig === "object" ? markdownConfig.linkTarget ?? "both" : "both",
+			route: joinRoute(routePrefix, DEFAULT_SITEMAP_MD_ROUTE),
+			docsRoute: routePrefix ? void 0 : DEFAULT_SITEMAP_MD_DOCS_ROUTE,
+			wellKnownRoute: joinRoute(routePrefix, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE)
+		}
+	};
+}
+function resolveDocsSitemapRequest(url, sitemap) {
+	const pathname = normalizeUrlPath(url.pathname);
+	const format = url.searchParams.get("format")?.trim();
+	if (pathname === "/api/docs") {
+		if (format === "sitemap-xml") return "xml";
+		if (format === "sitemap-md" || format === "sitemap-markdown") return "markdown";
+	}
+	const resolved = resolveDocsSitemapConfig(sitemap);
+	if (!resolved.enabled) return null;
+	if (resolved.xml.enabled && pathname === resolved.xml.route) return "xml";
+	if (resolved.markdown.enabled && (pathname === resolved.markdown.route || pathname === resolved.markdown.docsRoute || pathname === resolved.markdown.wellKnownRoute)) return "markdown";
+	return null;
+}
+function toDocsSitemapMarkdownUrl(url) {
+	const normalized = normalizeUrlPath(url);
+	return normalized.endsWith(".md") ? normalized : `${normalized}.md`;
+}
+function absolutizeUrl(baseUrl, url) {
+	if (/^https?:\/\//i.test(url)) return url;
+	const base = normalizeBaseUrl(baseUrl);
+	return base ? `${base}${url.startsWith("/") ? url : `/${url}`}` : url;
+}
+function escapeXml(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function hashString(value) {
+	let hash = 14695981039346656037n;
+	const bytes = new TextEncoder().encode(value);
+	for (const byte of bytes) {
+		hash ^= BigInt(byte);
+		hash = BigInt.asUintN(64, hash * 1099511628211n);
+	}
+	return `"fnv1a64-${hash.toString(16).padStart(16, "0")}"`;
+}
+function newestLastmod(pages) {
+	let newest;
+	for (const page of pages) {
+		const date = normalizeDateOnly(page.lastmod);
+		if (!date) continue;
+		if (!newest || date > newest) newest = date;
+	}
+	return newest;
+}
+function titleize(value) {
+	return value.replace(/-/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
+}
+function sitemapSectionName(entry, pageUrl) {
+	const normalizedEntry = `/${entry.replace(/^\/+|\/+$/g, "") || "docs"}`;
+	const normalizedUrl = normalizeUrlPath(pageUrl);
+	if (normalizedUrl === normalizedEntry) return "Overview";
+	const firstSegment = (normalizedUrl.startsWith(`${normalizedEntry}/`) ? normalizedUrl.slice(normalizedEntry.length + 1) : normalizedUrl.replace(/^\/+/, "")).split("/").filter(Boolean)[0];
+	return firstSegment ? titleize(firstSegment) : "Pages";
+}
+function buildDocsSitemapManifest(options) {
+	const baseUrl = normalizeBaseUrl(options.baseUrl);
+	const seen = /* @__PURE__ */ new Set();
+	const pages = [];
+	for (const page of options.pages) {
+		const url = normalizeUrlPath(page.url);
+		if (seen.has(url)) continue;
+		seen.add(url);
+		const resolvedLastmod = options.resolveLastmod?.(page);
+		const fallbackLastmod = normalizeDateOnly(page.lastmod ?? page.lastModified);
+		const lastmod = normalizeDateOnly(resolvedLastmod?.lastmod) ?? fallbackLastmod;
+		pages.push({
+			url,
+			absoluteUrl: absolutizeUrl(baseUrl, url),
+			markdownUrl: toDocsSitemapMarkdownUrl(url),
+			title: page.title,
+			description: page.description,
+			sourcePath: page.sourcePath,
+			lastmod,
+			lastmodSource: resolvedLastmod?.lastmodSource ?? (lastmod ? "unknown" : void 0),
+			related: page.related?.map((link) => link.href)
+		});
+	}
+	pages.sort((left, right) => left.url.localeCompare(right.url));
+	return {
+		version: 1,
+		generatedAt: options.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		baseUrl,
+		entry: options.entry ?? "docs",
+		siteTitle: options.siteTitle,
+		pages
+	};
+}
+function renderDocsSitemapXml(manifest, options = {}) {
+	const baseUrl = normalizeBaseUrl(options.baseUrl ?? manifest.baseUrl);
+	const includeLastmod = options.includeLastmod ?? true;
+	const lines = ["<?xml version=\"1.0\" encoding=\"UTF-8\"?>", "<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">"];
+	for (const page of manifest.pages) {
+		lines.push("  <url>");
+		lines.push(`    <loc>${escapeXml(page.absoluteUrl ?? absolutizeUrl(baseUrl, page.url))}</loc>`);
+		const lastmod = normalizeDateOnly(page.lastmod);
+		if (includeLastmod && lastmod) lines.push(`    <lastmod>${lastmod}</lastmod>`);
+		lines.push("  </url>");
+	}
+	lines.push("</urlset>");
+	return `${lines.join("\n")}\n`;
+}
+function renderDocsSitemapMarkdown(manifest, options = {}) {
+	const siteTitle = manifest.siteTitle ?? "Documentation";
+	const includeDescriptions = options.includeDescriptions ?? true;
+	const includeLastmod = options.includeLastmod ?? true;
+	const linkTarget = options.linkTarget ?? "both";
+	const lines = [`# ${siteTitle} Sitemap`, ""];
+	const baseUrl = normalizeBaseUrl(options.baseUrl ?? manifest.baseUrl);
+	if (baseUrl) lines.push(`Base URL: ${baseUrl}`);
+	lines.push(`Docs entry: /${manifest.entry.replace(/^\/+|\/+$/g, "") || "docs"}`);
+	lines.push(`Generated: ${normalizeDateOnly(manifest.generatedAt) ?? manifest.generatedAt}`, "");
+	const groups = /* @__PURE__ */ new Map();
+	for (const page of manifest.pages) {
+		const sectionName = sitemapSectionName(manifest.entry, page.url);
+		groups.set(sectionName, [...groups.get(sectionName) ?? [], page]);
+	}
+	for (const [sectionName, pages] of groups) {
+		lines.push(`## ${sectionName}`, "");
+		for (const page of pages) {
+			const primaryHref = linkTarget === "markdown" ? page.markdownUrl : page.url;
+			lines.push(`- [${page.title}](${primaryHref})`);
+			if (linkTarget === "both" || linkTarget === "markdown") lines.push(`  Markdown: ${page.markdownUrl}`);
+			if (includeDescriptions && page.description) lines.push(`  Description: ${page.description}`);
+			const lastmod = normalizeDateOnly(page.lastmod);
+			if (includeLastmod && lastmod) lines.push(`  Last updated: ${lastmod}`);
+			if (page.related && page.related.length > 0) lines.push(`  Related: ${page.related.join(", ")}`);
+			lines.push("");
+		}
+	}
+	return lines.join("\n").replace(/\n{3,}/g, "\n\n");
+}
+function readDocsSitemapManifestFromContentMap(contentMap) {
+	if (!contentMap) return null;
+	const raw = contentMap[`/${DEFAULT_SITEMAP_MANIFEST_PATH}`] ?? contentMap[DEFAULT_SITEMAP_MANIFEST_PATH];
+	if (!raw) return null;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return null;
+	}
+}
+function resolveDocsSitemapPageLastmod(manifest, url) {
+	if (!manifest) return void 0;
+	const normalizedUrl = normalizeUrlPath(url);
+	return normalizeDateOnly(manifest.pages.find((entry) => normalizeUrlPath(entry.url) === normalizedUrl)?.lastmod);
+}
+function createDocsSitemapResponse({ request, sitemap, entry = "docs", siteTitle, baseUrl, pages, manifest }) {
+	const url = new URL(request.url);
+	const format = resolveDocsSitemapRequest(url, sitemap);
+	if (!format) return null;
+	const resolved = resolveDocsSitemapConfig(sitemap, { baseUrl });
+	if (!resolved.enabled) return null;
+	if (format === "xml" && !resolved.xml.enabled) return null;
+	if (format === "markdown" && !resolved.markdown.enabled) return null;
+	const nextManifest = manifest ?? buildDocsSitemapManifest({
+		pages,
+		entry,
+		siteTitle,
+		baseUrl: resolved.baseUrl ?? url.origin
+	});
+	const responseBaseUrl = resolved.baseUrl ?? nextManifest.baseUrl ?? url.origin;
+	const body = format === "xml" ? renderDocsSitemapXml(nextManifest, {
+		baseUrl: responseBaseUrl,
+		includeLastmod: resolved.xml.includeLastmod
+	}) : renderDocsSitemapMarkdown(nextManifest, {
+		baseUrl: responseBaseUrl,
+		includeDescriptions: resolved.markdown.includeDescriptions,
+		includeLastmod: resolved.markdown.includeLastmod,
+		linkTarget: resolved.markdown.linkTarget
+	});
+	const headers = new Headers({
+		"Content-Type": format === "xml" ? "application/xml; charset=utf-8" : "text/markdown; charset=utf-8",
+		"Cache-Control": "public, max-age=0, must-revalidate",
+		ETag: hashString(body)
+	});
+	const lastModified = newestLastmod(nextManifest.pages);
+	if (lastModified) headers.set("Last-Modified", (/* @__PURE__ */ new Date(`${lastModified}T00:00:00.000Z`)).toUTCString());
+	if (request.headers.get("if-none-match") === headers.get("ETag")) return new Response(null, {
+		status: 304,
+		headers
+	});
+	return new Response(body, { headers });
+}
 
+//#endregion
 //#region src/agent.ts
 const DEFAULT_DOCS_API_ROUTE = "/api/docs";
 const DEFAULT_OPENAPI_SCHEMA_ROUTE = `${DEFAULT_DOCS_API_ROUTE}?format=openapi`;
@@ -1434,4 +1731,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-export { resolveDocsAgentsFormat as $, findDocsMarkdownPage as A, isDocsSkillRequest as B, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as C, buildDocsAgentFeedbackSchema as D, buildDocsAgentDiscoverySpec as E, isDocsAgentDiscoveryRequest as F, renderDocsAgentsDocument as G, normalizeDocsPathSegment as H, isDocsAgentsRequest as I, renderDocsMarkdownNotFound as J, renderDocsLlmsTxt as K, isDocsLlmsTxtPublicRequest as L, getDocsMarkdownCanonicalLinkHeader as M, getDocsMarkdownVaryHeader as N, buildDocsMcpEndpointCandidates as O, hasDocsMarkdownSignatureAgent as P, resolveDocsAgentMdxContent as Q, isDocsMcpRequest as R, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as S, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as T, normalizeDocsUrlPath as U, matchesDocsLlmsTxtSection as V, parseDocsAgentFeedbackData as W, resolveDocsAgentFeedbackConfig as X, renderDocsSkillDocument as Y, resolveDocsAgentFeedbackRequest as Z, DEFAULT_MCP_ROUTE as _, DEFAULT_AGENT_MD_ROUTE as a, resolveDocsMarkdownRequest as at, DEFAULT_SKILL_MD_ROUTE as b, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, selectDocsLlmsTxtContent as ct, DEFAULT_LLMS_FULL_TXT_ROUTE as d, resolveDocsLlmsTxtFormat as et, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as f, DEFAULT_MCP_PUBLIC_ROUTE as g, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as h, DEFAULT_AGENT_FEEDBACK_ROUTE as i, resolveDocsMarkdownRecovery as it, getDocsLlmsTxtMaxCharsIssue as j, detectDocsMarkdownAgentRequest as k, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, toDocsMarkdownUrl as lt, DEFAULT_LLMS_TXT_ROUTE as m, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, resolveDocsLlmsTxtSections as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, resolveDocsOpenApiDiscoveryConfig as ot, DEFAULT_LLMS_TXT_MAX_CHARS as p, renderDocsMarkdownDocument as q, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, resolveDocsMarkdownCanonicalUrl as rt, DEFAULT_AGENT_SPEC_ROUTE as s, resolveDocsSkillFormat as st, DEFAULT_AGENTS_MD_ROUTE as t, resolveDocsLlmsTxtRequest as tt, DEFAULT_DOCS_API_ROUTE as u, validateDocsAgentFeedbackPayload as ut, DEFAULT_MCP_WELL_KNOWN_ROUTE as v, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as w, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as x, DEFAULT_OPENAPI_SCHEMA_ROUTE as y, isDocsPublicGetRequest as z };
+export { resolveDocsAgentsFormat as $, findDocsMarkdownPage as A, isDocsSkillRequest as B, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as C, resolveDocsSitemapRequest as Ct, buildDocsAgentFeedbackSchema as D, buildDocsAgentDiscoverySpec as E, renderDocsRelatedMarkdownLines as Et, isDocsAgentDiscoveryRequest as F, renderDocsAgentsDocument as G, normalizeDocsPathSegment as H, isDocsAgentsRequest as I, renderDocsMarkdownNotFound as J, renderDocsLlmsTxt as K, isDocsLlmsTxtPublicRequest as L, getDocsMarkdownCanonicalLinkHeader as M, getDocsMarkdownVaryHeader as N, buildDocsMcpEndpointCandidates as O, hasDocsMarkdownSignatureAgent as P, resolveDocsAgentMdxContent as Q, isDocsMcpRequest as R, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as S, resolveDocsSitemapPageLastmod as St, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as T, normalizeDocsRelated as Tt, normalizeDocsUrlPath as U, matchesDocsLlmsTxtSection as V, parseDocsAgentFeedbackData as W, resolveDocsAgentFeedbackConfig as X, renderDocsSkillDocument as Y, resolveDocsAgentFeedbackRequest as Z, DEFAULT_MCP_ROUTE as _, createDocsSitemapResponse as _t, DEFAULT_AGENT_MD_ROUTE as a, resolveDocsMarkdownRequest as at, DEFAULT_SKILL_MD_ROUTE as b, renderDocsSitemapXml as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, selectDocsLlmsTxtContent as ct, DEFAULT_LLMS_FULL_TXT_ROUTE as d, DEFAULT_SITEMAP_MANIFEST_PATH as dt, resolveDocsLlmsTxtFormat as et, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as f, DEFAULT_SITEMAP_MD_DOCS_ROUTE as ft, DEFAULT_MCP_PUBLIC_ROUTE as g, buildDocsSitemapManifest as gt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as h, DEFAULT_SITEMAP_XML_ROUTE as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, resolveDocsMarkdownRecovery as it, getDocsLlmsTxtMaxCharsIssue as j, detectDocsMarkdownAgentRequest as k, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, toDocsMarkdownUrl as lt, DEFAULT_LLMS_TXT_ROUTE as m, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, resolveDocsLlmsTxtSections as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, resolveDocsOpenApiDiscoveryConfig as ot, DEFAULT_LLMS_TXT_MAX_CHARS as p, DEFAULT_SITEMAP_MD_ROUTE as pt, renderDocsMarkdownDocument as q, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, resolveDocsMarkdownCanonicalUrl as rt, DEFAULT_AGENT_SPEC_ROUTE as s, resolveDocsSkillFormat as st, DEFAULT_AGENTS_MD_ROUTE as t, resolveDocsLlmsTxtRequest as tt, DEFAULT_DOCS_API_ROUTE as u, validateDocsAgentFeedbackPayload as ut, DEFAULT_MCP_WELL_KNOWN_ROUTE as v, readDocsSitemapManifestFromContentMap as vt, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as w, toDocsSitemapMarkdownUrl as wt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as x, resolveDocsSitemapConfig as xt, DEFAULT_OPENAPI_SCHEMA_ROUTE as y, renderDocsSitemapMarkdown as yt, isDocsPublicGetRequest as z };

package/dist/{agents-Bhloif3y.mjs → agents-spZpwT1w.mjs}

@@ -1,9 +1,10 @@
-import { G as renderDocsAgentsDocument, X as resolveDocsAgentFeedbackConfig, 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-B7T4gauS.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-CVSQQszk.mjs";
+import "./search-DiFxtL5t.mjs";
+import { G as renderDocsAgentsDocument, X as resolveDocsAgentFeedbackConfig, 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-DEr3FFdg.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-RZG9eOJB.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-rHQQuz98.mjs";
-import { t as detectFramework } from "./utils-CGlOADu1.mjs";
+import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-De5z-2LK.mjs";
+import { t as detectFramework } from "./utils-CoHZJ1i4.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-DqlZftq3.mjs";
+import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-Dw5gMhEZ.mjs";
 import pc from "picocolors";
 
 //#region src/cli/index.ts
@@ -98,43 +98,43 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-D-Ki2dWn.mjs");
+		const { init } = await import("../init-CRS-LZdr.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-C5rHIIpC.mjs");
+		const { dev } = await import("../dev-DxVevOP_.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-DLc03Z41.mjs");
+		const { runCloudDeploy } = await import("../cloud-B_bpA0Mh.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-DLc03Z41.mjs");
+		const { runCloudPreview } = await import("../cloud-B_bpA0Mh.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-DLc03Z41.mjs");
+		const { runCloudDeploy } = await import("../cloud-B_bpA0Mh.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-DLc03Z41.mjs");
+		const { runCloudPreview } = await import("../cloud-B_bpA0Mh.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-DLc03Z41.mjs");
+		const { runCloudInit } = await import("../cloud-B_bpA0Mh.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-DLc03Z41.mjs");
+		const { syncCloudConfig } = await import("../cloud-B_bpA0Mh.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-DLc03Z41.mjs");
+		const { runCloudCheck } = await import("../cloud-B_bpA0Mh.mjs");
 		await runCloudCheck(cloudOptions);
 	} else if (parsedCommand.command === "cloud") {
 		console.error(pc.red(`Unknown cloud subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCloudHelp } = await import("../cloud-DLc03Z41.mjs");
+		const { printCloudHelp } = await import("../cloud-B_bpA0Mh.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-Dvy_EkRx.mjs");
+		const { runMcp } = await import("../mcp-DVipSdBh.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DpKOO7Ho.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BpPhLG_h.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -144,11 +144,11 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-DpKOO7Ho.mjs");
+		const { printAgentCompactHelp } = await import("../agent-BpPhLG_h.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-Bhloif3y.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-spZpwT1w.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -158,11 +158,11 @@ async function main() {
 	} else if (parsedCommand.command === "agents") {
 		console.error(pc.red(`Unknown agents subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentsGenerateHelp } = await import("../agents-Bhloif3y.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-spZpwT1w.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-kYJcYbcT.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-Qe_2T86D.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -170,7 +170,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-DI_Ht3VO.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-Bnd4NH9y.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -178,7 +178,7 @@ async function main() {
 		}
 		await runReview(reviewOptions);
 	} else if ((parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") && subcommand === "validate") {
-		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-BnwZNsYO.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-Dcn5tRbB.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -188,11 +188,11 @@ async function main() {
 	} else if (parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") {
 		console.error(pc.red(`Unknown codeblocks subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCodeBlocksValidateHelp } = await import("../codeblocks-BnwZNsYO.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-Dcn5tRbB.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-BXupn-c-.mjs");
+		const { syncSearch } = await import("../search-CSJNTYNX.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -200,7 +200,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BfViRvLP.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-vHpdCag9.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -210,11 +210,11 @@ async function main() {
 	} else if (parsedCommand.command === "sitemap") {
 		console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSitemapGenerateHelp } = await import("../sitemap-BfViRvLP.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-vHpdCag9.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DHQosx37.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-BzO2bi0d.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -224,11 +224,11 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-DHQosx37.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-BzO2bi0d.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-D45M-NvV.mjs");
+		const { downgrade } = await import("../downgrade-D7zavP20.mjs");
 		const framework = (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0);
 		const hasVersionFlag = args.includes("--version") || args.some((arg) => arg.startsWith("--version="));
 		await downgrade({
@@ -236,7 +236,7 @@ async function main() {
 			version: typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-C1nInojy.mjs");
+		const { upgrade } = await import("../upgrade-Dzej61y4.mjs");
 		const framework = (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0);
 		const hasVersionFlag = args.includes("--version") || args.some((arg) => arg.startsWith("--version="));
 		const version = typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0;

package/dist/{cloud-DLc03Z41.mjs → cloud-B_bpA0Mh.mjs}

@@ -1,6 +1,6 @@
-import { n as markCliErrorReported } from "./errors-DqlZftq3.mjs";
-import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelBooleanProperty, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-rHQQuz98.mjs";
-import { t as detectFramework } from "./utils-CGlOADu1.mjs";
+import { n as markCliErrorReported } from "./errors-Dw5gMhEZ.mjs";
+import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelBooleanProperty, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-De5z-2LK.mjs";
+import { t as detectFramework } from "./utils-CoHZJ1i4.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{codeblocks-BnwZNsYO.mjs → codeblocks-Dcn5tRbB.mjs}

@@ -1,9 +1,9 @@
-import { _ as parseGeneratedAgentDocument, h as hashGeneratedAgentContent, m as GENERATED_AGENT_PROVENANCE_VERSION, v as serializeGeneratedAgentDocument } from "./search-B3JYx2zk.mjs";
-import { A as findDocsMarkdownPage, q as renderDocsMarkdownDocument } from "./agent-B7T4gauS.mjs";
+import { _ as parseGeneratedAgentDocument, h as hashGeneratedAgentContent, m as GENERATED_AGENT_PROVENANCE_VERSION, v as serializeGeneratedAgentDocument } from "./search-DiFxtL5t.mjs";
+import { A as findDocsMarkdownPage, q as renderDocsMarkdownDocument } from "./agent-DEr3FFdg.mjs";
 import "./index.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, l as readNumberProperty, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-rHQQuz98.mjs";
+import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, l as readNumberProperty, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-De5z-2LK.mjs";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/{dev-C5rHIIpC.mjs → dev-DxVevOP_.mjs}

@@ -1,5 +1,5 @@
-import { i as detectPackageManagerFromLockfile } from "./utils-CGlOADu1.mjs";
-import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-CMcXQ0Gk.mjs";
+import { i as detectPackageManagerFromProject } from "./utils-CoHZJ1i4.mjs";
+import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-BOoV0cIR.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
@@ -441,14 +441,7 @@ function findLocalFrameworkRoot(startDir) {
 	}
 }
 function detectNearestPackageManager(startDir) {
-	let current = path.resolve(startDir);
-	while (true) {
-		const detected = detectPackageManagerFromLockfile(current);
-		if (detected) return detected;
-		const parent = path.dirname(current);
-		if (parent === current) return "npm";
-		current = parent;
-	}
+	return detectPackageManagerFromProject(startDir)?.packageManager ?? "npm";
 }
 function resolveManagedConfigPath(projectRoot) {
 	const primaryPath = path.join(projectRoot, PRIMARY_MANAGED_CONFIG_FILE);

package/dist/{doctor-kYJcYbcT.mjs → doctor-Qe_2T86D.mjs}

@@ -1,13 +1,13 @@
-import "./reading-time-DzuY0IRX.mjs";
-import { a as DEFAULT_SITEMAP_XML_ROUTE, d as resolveDocsSitemapConfig, i as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, r as DEFAULT_SITEMAP_MD_ROUTE } from "./sitemap-CMNj0Pt3.mjs";
-import { O as buildDocsMcpEndpointCandidates, b as DEFAULT_SKILL_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, d as DEFAULT_LLMS_FULL_TXT_ROUTE, g as DEFAULT_MCP_PUBLIC_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, m as DEFAULT_LLMS_TXT_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_MCP_WELL_KNOWN_ROUTE, x as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE } from "./agent-B7T4gauS.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-CDdD2o-Q.mjs";
-import "./sitemap-server-CVSQQszk.mjs";
+import "./reading-time-CPAy1SWO.mjs";
+import "./search-DiFxtL5t.mjs";
+import { O as buildDocsMcpEndpointCandidates, b as DEFAULT_SKILL_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, d as DEFAULT_LLMS_FULL_TXT_ROUTE, g as DEFAULT_MCP_PUBLIC_ROUTE, ht as DEFAULT_SITEMAP_XML_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, m as DEFAULT_LLMS_TXT_ROUTE, mt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, pt as DEFAULT_SITEMAP_MD_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_MCP_WELL_KNOWN_ROUTE, x as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, xt as resolveDocsSitemapConfig } from "./agent-DEr3FFdg.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-BcP7nSfi.mjs";
+import "./sitemap-server-RZG9eOJB.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-rHQQuz98.mjs";
-import { t as detectFramework } from "./utils-CGlOADu1.mjs";
-import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./codeblocks-BnwZNsYO.mjs";
+import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-De5z-2LK.mjs";
+import { t as detectFramework } from "./utils-CoHZJ1i4.mjs";
+import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./codeblocks-Dcn5tRbB.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";

package/dist/{downgrade-D45M-NvV.mjs → downgrade-D7zavP20.mjs}

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