@farming-labs/docs 0.2.72 → 0.2.74

package/dist/{agent-DbDfIqhe.mjs → agent-D0LEY2Vy.mjs}

@@ -1,7 +1,8 @@
-import { B as findDocsMarkdownPage, an as stripGeneratedPageAgentContractMarkdown, at as renderDocsMarkdownDocument, nn as normalizePageAgentFrontmatter } from "./agent-pS2nNQS3.mjs";
-import { E as hashGeneratedAgentContent, O as parseGeneratedAgentDocument, T as GENERATED_AGENT_PROVENANCE_VERSION, k as serializeGeneratedAgentDocument } from "./search-BbArHODP.mjs";
+import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-BJ0KXN-A.mjs";
+import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
+import { F as serializeGeneratedAgentDocument, M as hashGeneratedAgentContent, P as parseGeneratedAgentDocument, j as GENERATED_AGENT_PROVENANCE_VERSION } from "./search-DIyIl-tE.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-z7_R0f86.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-Wcdj-D0a.mjs";
 import { createRequire } from "node:module";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";

package/dist/{agent-evals-CjYzCQMZ.mjs → agent-evals-LIScgQVm.mjs}

@@ -1,7 +1,7 @@
-import { Gt as findDocsMarkdownSection } from "./agent-pS2nNQS3.mjs";
-import { C as normalizeAgentVersion, S as normalizeAgentScopeValues, _ as resolveSearchRequestConfig, b as normalizeAgentFramework, d as performDocsSearch, t as buildDocsAskAIContext, u as normalizeDocsSearchFilters, v as agentVersionConstraintMatches, x as normalizeAgentLocale, y as agentVersionConstraintsOverlap } from "./search-BbArHODP.mjs";
+import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.mjs";
+import { C as agentVersionConstraintsOverlap, D as normalizeAgentVersion, E as normalizeAgentScopeValues, S as agentVersionConstraintMatches, T as normalizeAgentLocale, b as resolveSearchRequestConfig, f as normalizeDocsSearchFilters, p as performDocsSearch, t as buildDocsAskAIContext, w as normalizeAgentFramework, x as agentVersionConstraintGroupsOverlap } from "./search-DIyIl-tE.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
-import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-qe0T8-xe.mjs";
+import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { createJiti } from "jiti";
@@ -813,6 +813,7 @@ function safeDecode(value) {
 function canonicalizeSource(value, baseUrl) {
 	const rawValue = value.trim();
 	let pathname;
+	let search;
 	let hash;
 	let origin = "";
 	try {
@@ -824,27 +825,38 @@ function canonicalizeSource(value, baseUrl) {
 		const base = configuredBase ?? new URL("https://docs.local");
 		const parsed = new URL(rawValue, base);
 		pathname = parsed.pathname;
+		search = parsed.search;
 		hash = parsed.hash;
 		const explicitlySchemed = /^[a-z][a-z\d+.-]*:/iu.test(rawValue);
 		if ((explicitlySchemed && (parsed.protocol === "http:" || parsed.protocol === "https:") || /^[\\/]{2}/u.test(rawValue)) && (!configuredBase || parsed.origin !== configuredBase.origin)) origin = parsed.origin;
 		if (explicitlySchemed && parsed.protocol !== "http:" && parsed.protocol !== "https:") origin = `${parsed.protocol}//${parsed.host}`;
 	} catch {
-		const [pathAndQuery = "/", fragment = ""] = rawValue.split("#", 2);
-		pathname = pathAndQuery.split("?", 1)[0] || "/";
+		const hashIndex = rawValue.indexOf("#");
+		const pathAndQuery = hashIndex >= 0 ? rawValue.slice(0, hashIndex) : rawValue || "/";
+		const fragment = hashIndex >= 0 ? rawValue.slice(hashIndex + 1) : "";
+		const queryIndex = pathAndQuery.indexOf("?");
+		pathname = (queryIndex >= 0 ? pathAndQuery.slice(0, queryIndex) : pathAndQuery) || "/";
+		search = queryIndex >= 0 ? pathAndQuery.slice(queryIndex) : "";
 		hash = fragment ? `#${fragment}` : "";
 	}
 	pathname = pathname.replace(/\/{2,}/gu, "/").replace(/\.md$/iu, "");
 	if (pathname !== "/") pathname = pathname.replace(/\/+$/gu, "");
 	if (!pathname.startsWith("/")) pathname = `/${pathname}`;
-	const normalizedHash = hash ? `#${safeDecode(hash.slice(1)).trim().replace(/^#+/u, "").toLowerCase()}` : "";
-	return `${origin}${pathname || "/"}${normalizedHash === "#" ? "" : normalizedHash}`;
+	const decodedHash = hash ? safeDecode(hash.slice(1)).trim() : "";
+	const normalizedHash = decodedHash ? `#${encodeURIComponent(decodedHash)}` : "";
+	return `${origin}${pathname || "/"}${search}${normalizedHash === "#" ? "" : normalizedHash}`;
 }
 function sourcePage(value) {
 	return canonicalizeSource(value).split("#", 1)[0] ?? "/";
 }
 function sourceMatches(actual, expected, baseUrl) {
-	const canonicalActual = canonicalizeSource(actual, baseUrl);
+	let canonicalActual = canonicalizeSource(actual, baseUrl);
 	const canonicalExpected = canonicalizeSource(expected, baseUrl);
+	if (!(canonicalExpected.split("#", 1)[0] ?? canonicalExpected).includes("?")) {
+		const hashIndex = canonicalActual.indexOf("#");
+		const hash = hashIndex >= 0 ? canonicalActual.slice(hashIndex) : "";
+		canonicalActual = `${(hashIndex >= 0 ? canonicalActual.slice(0, hashIndex) : canonicalActual).split("?", 1)[0]}${hash}`;
+	}
 	return canonicalExpected.includes("#") ? canonicalActual === canonicalExpected : sourcePage(canonicalActual) === sourcePage(canonicalExpected);
 }
 function uniqueCanonicalSources(values, baseUrl) {
@@ -864,11 +876,14 @@ function getPageScope(page) {
 	return {
 		framework: Array.from(new Set([...topFramework, ...contractFramework])),
 		version: Array.from(new Set([...topVersion, ...contractVersion])),
+		versionGroups: [topVersion, contractVersion].filter((group) => group.length > 0),
 		package: packageValues,
 		tags,
 		locale,
 		frameworkAmbiguous: topFramework.length > 0 && contractFramework.length > 0 && !valuesOverlap(topFramework, contractFramework, (left, right) => left === right),
-		versionAmbiguous: topVersion.length > 0 && contractVersion.length > 0 && !valuesOverlap(topVersion, contractVersion, agentVersionConstraintsOverlap)
+		versionAmbiguous: topVersion.length > 0 && contractVersion.length > 0 && !valuesOverlap(topVersion, contractVersion, agentVersionConstraintsOverlap),
+		packageAmbiguous: false,
+		tagsAmbiguous: false
 	};
 }
 function compareCodePoints(left, right) {
@@ -891,7 +906,7 @@ function toGoldenSources(sources, relevantSources, baseUrl) {
 }
 function toContextCandidates(sources, pagesByUrl) {
 	return sources.flatMap((source) => {
-		const page = pagesByUrl.get(sourcePage(source.pageUrl));
+		const page = findPageForSource(pagesByUrl, source.pageUrl);
 		if (!page) return [];
 		return [{
 			page,
@@ -934,23 +949,40 @@ function extractRenderedCitations(context, sources) {
 		blockUtf8Bytes
 	};
 }
+function getPageAgentSectionMarkdown(page) {
+	return upsertPageAgentContractMarkdown(page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content, page.agent);
+}
+function cleanPageAgentContractMarkers(markdown, sourceMarkdown, startLine) {
+	return sourceMarkdown && startLine ? stripDocsGeneratedAgentContractMarkers(markdown, {
+		sourceMarkdown,
+		startLine
+	}) : stripDocsGeneratedAgentContractMarkers(markdown);
+}
 function getPageAgentMarkdown(page) {
-	return page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content;
+	return cleanPageAgentContractMarkers(getPageAgentSectionMarkdown(page));
 }
 function findPageForSource(pagesByUrl, value) {
-	return pagesByUrl.get(sourcePage(value));
+	const canonicalPage = sourcePage(value);
+	return pagesByUrl.get(canonicalPage) ?? pagesByUrl.get(canonicalPage.split("?", 1)[0] ?? "/");
 }
 function getResultAnchor(value) {
-	return canonicalizeSource(value).split("#", 2)[1] || void 0;
-}
-function hydrateSearchSource(result, index, pagesByUrl, contentMode, baseUrl) {
-	const normalizedResultUrl = canonicalizeSource(result.url, baseUrl);
-	const page = findPageForSource(pagesByUrl, normalizedResultUrl);
-	const anchor = getResultAnchor(result.url);
+	const canonical = canonicalizeSource(value);
+	const hashIndex = canonical.indexOf("#");
+	return (hashIndex >= 0 ? canonical.slice(hashIndex + 1) : "") || void 0;
+}
+/** @internal */
+function hydrateDocsEvaluationSearchSource(result, index, pagesByUrl, contentMode, baseUrl) {
+	const normalizedTransportUrl = canonicalizeSource(result.url, baseUrl);
+	const normalizedResultUrl = canonicalizeSource(result.source?.canonicalUrl ?? result.url, baseUrl);
+	const page = findPageForSource(pagesByUrl, normalizedResultUrl) ?? findPageForSource(pagesByUrl, normalizedTransportUrl);
+	const anchor = getResultAnchor(result.source?.canonicalUrl ?? result.url);
 	const section = anchor ?? result.section;
-	const pageSection = page && section ? findDocsMarkdownSection(getPageAgentMarkdown(page), section) : void 0;
-	const content = contentMode === "page-section" && page ? (pageSection?.content ?? getPageAgentMarkdown(page)).trim() : [result.content, result.description].filter(Boolean).join("\n\n").trim();
+	const sectionMarkdown = page ? getPageAgentSectionMarkdown(page) : void 0;
+	const pageSection = sectionMarkdown && section ? findDocsMarkdownSection(sectionMarkdown, section) : void 0;
+	if (contentMode === "page-section" && page && section && !pageSection) return void 0;
+	const content = contentMode === "page-section" && page ? cleanPageAgentContractMarkers(pageSection?.content ?? getPageAgentMarkdown(page), pageSection ? sectionMarkdown : void 0, pageSection?.startLine).trim() : [result.content, result.description].filter(Boolean).join("\n\n").trim();
 	const scope = page ? getPageScope(page) : void 0;
+	const provenanceScope = result.source?.scope;
 	const url = normalizedResultUrl;
 	return {
 		id: result.id || `evaluation-result-${index + 1}`,
@@ -960,12 +992,13 @@ function hydrateSearchSource(result, index, pagesByUrl, contentMode, baseUrl) {
 		section: pageSection?.title ?? result.section,
 		anchor: pageSection?.anchor ?? anchor,
 		sourcePath: page?.sourcePath,
-		lastModified: page?.lastModified,
-		locale: scope?.locale[0],
-		framework: scope?.framework[0],
-		version: scope?.version[0],
-		package: scope?.package.length ? [...scope.package] : void 0,
-		tags: scope?.tags.length ? [...scope.tags] : void 0,
+		lastModified: result.source?.lastModified ?? page?.lastModified,
+		locale: scope?.locale[0] ?? provenanceScope?.locale?.[0],
+		framework: scope?.framework[0] ?? provenanceScope?.framework?.[0],
+		version: scope?.version[0] ?? provenanceScope?.version?.[0],
+		package: scope?.package.length ? [...scope.package] : provenanceScope?.package?.length ? [...provenanceScope.package] : void 0,
+		tags: scope?.tags.length ? [...scope.tags] : provenanceScope?.tags?.length ? [...provenanceScope.tags] : void 0,
+		source: result.source,
 		score: result.score,
 		content,
 		chars: content.length,
@@ -1155,9 +1188,12 @@ function parseAskAIContextSources(options) {
 			integrity = false;
 			continue;
 		}
-		const urlLines = block.slice(0, contentStart).split(/\r?\n/u).map((line) => line.match(/^URL:\s+(.+)$/u)?.[1]?.trim()).filter((value) => Boolean(value));
+		const headerLines = block.slice(0, contentStart).split(/\r?\n/u);
+		const urlLines = headerLines.map((line) => line.match(/^URL:\s+(.+)$/u)?.[1]?.trim()).filter((value) => Boolean(value));
+		const canonicalUrlLines = headerLines.map((line) => line.match(/^Canonical URL:\s+(.+)$/u)?.[1]?.trim()).filter((value) => Boolean(value));
 		if (urlLines.length !== 1) integrity = false;
-		const url = canonicalizeSource(urlLines[0] ?? "/", options.baseUrl);
+		if (canonicalUrlLines.length > 1) integrity = false;
+		const url = canonicalizeSource(canonicalUrlLines[0] ?? urlLines[0] ?? "/", options.baseUrl);
 		const expected = options.results[index];
 		if (!expected || !sourceMatches(url, expected.url) || canonicalizeSource(expected.url) !== url) integrity = false;
 		const content = block.slice(contentStart + 2);
@@ -1201,7 +1237,8 @@ async function buildGoldenSurface(options) {
 			package: options.task.filters?.package,
 			tags: options.task.filters?.tags,
 			locale: options.task.filters?.locale,
-			maxResults: options.topK
+			maxResults: options.topK,
+			baseUrl: options.runOptions.baseUrl
 		};
 		const [rankedContext, budgetedContext] = await Promise.all([buildDocsMcpContext({
 			...contextOptions,
@@ -1254,7 +1291,7 @@ async function buildGoldenSurface(options) {
 				signal
 			})
 		});
-		const rankedSources = results.slice(0, options.topK).map((result, index) => hydrateSearchSource(result, index, pagesByUrl, "result", options.runOptions.baseUrl));
+		const rankedSources = results.slice(0, options.topK).map((result, index) => hydrateDocsEvaluationSearchSource(result, index, pagesByUrl, "result", options.runOptions.baseUrl)).filter((source) => Boolean(source));
 		return {
 			surface,
 			provider,
@@ -1273,7 +1310,7 @@ async function buildGoldenSurface(options) {
 			citationEvidence: {
 				mode: "results",
 				actual: rankedSources.map((source) => canonicalizeSource(source.url)),
-				integrity: rankedSources.every((source, index) => source.url === canonicalizeSource(results[index]?.url ?? "", options.runOptions.baseUrl))
+				integrity: rankedSources.every((source, index) => source.url === canonicalizeSource(results[index]?.source?.canonicalUrl ?? results[index]?.url ?? "", options.runOptions.baseUrl))
 			}
 		};
 	}
@@ -1300,8 +1337,8 @@ async function buildGoldenSurface(options) {
 			signal
 		})
 	});
-	const rankedSources = askAI.searchResults.slice(0, options.topK).map((result, index) => hydrateSearchSource(result, index, pagesByUrl, "result", options.runOptions.baseUrl));
-	const resultSources = askAI.results.map((result, index) => hydrateSearchSource(result, index, pagesByUrl, "page-section", options.runOptions.baseUrl));
+	const rankedSources = askAI.searchResults.slice(0, options.topK).map((result, index) => hydrateDocsEvaluationSearchSource(result, index, pagesByUrl, "result", options.runOptions.baseUrl)).filter((source) => Boolean(source));
+	const resultSources = askAI.results.map((result, index) => hydrateDocsEvaluationSearchSource(result, index, pagesByUrl, "page-section", options.runOptions.baseUrl));
 	const parsed = parseAskAIContextSources({
 		context: askAI.context,
 		blocks: askAI.blocks.map((block) => block.text),
@@ -1947,14 +1984,20 @@ function buildSelectionMetrics(task, sources, pagesByUrl) {
 	const locale = expectedLocale ? normalizeAgentLocale(expectedLocale) : void 0;
 	const candidates = sources.map((source) => {
 		const page = findPageForSource(pagesByUrl, source.pageUrl || source.url);
+		const provenance = source.source?.scope;
+		const conflicts = new Set(provenance?.conflicts ?? []);
+		const truncated = new Set(provenance?.truncated ?? []);
 		const scope = page ? getPageScope(page) : {
-			framework: normalizeAgentScopeValues(source.framework).map(normalizeAgentFramework),
-			version: normalizeAgentScopeValues(source.version).map(normalizeAgentVersion),
-			package: normalizeDocsSearchFilters({ package: source.package }).package ?? [],
-			tags: normalizeDocsSearchFilters({ tags: source.tags }).tags ?? [],
-			locale: normalizeAgentScopeValues(source.locale).map(normalizeAgentLocale),
-			frameworkAmbiguous: false,
-			versionAmbiguous: false
+			framework: Array.from(new Set([...normalizeAgentScopeValues(source.framework), ...provenance?.framework ?? []].map(normalizeAgentFramework))),
+			version: Array.from(new Set([...normalizeAgentScopeValues(source.version), ...provenance?.version ?? []].map(normalizeAgentVersion))),
+			versionGroups: provenance?.versionGroups?.map((group) => group.map(normalizeAgentVersion)),
+			package: normalizeDocsSearchFilters({ package: provenance?.package?.length ? provenance.package : source.package }).package ?? [],
+			tags: normalizeDocsSearchFilters({ tags: provenance?.tags?.length ? provenance.tags : source.tags }).tags ?? [],
+			locale: Array.from(new Set([...normalizeAgentScopeValues(source.locale), ...provenance?.locale ?? []].map(normalizeAgentLocale))),
+			frameworkAmbiguous: conflicts.has("framework") || truncated.has("framework"),
+			versionAmbiguous: conflicts.has("version") || truncated.has("version"),
+			packageAmbiguous: conflicts.has("package") || truncated.has("package"),
+			tagsAmbiguous: conflicts.has("tags") || truncated.has("tags")
 		};
 		return {
 			source: canonicalizeSource(source.url),
@@ -1962,12 +2005,12 @@ function buildSelectionMetrics(task, sources, pagesByUrl) {
 		};
 	});
 	const firstFrameworkMatchRank = framework ? candidates.findIndex((candidate) => candidate.scope.framework.includes(framework)) + 1 || null : null;
-	const firstVersionMatchRank = expectedVersion ? candidates.findIndex((candidate) => candidate.scope.version.some((version) => agentVersionConstraintMatches(expectedVersion, version))) + 1 || null : null;
+	const firstVersionMatchRank = expectedVersion ? candidates.findIndex((candidate) => candidate.scope.versionGroups?.length ? agentVersionConstraintGroupsOverlap([[normalizeAgentVersion(expectedVersion)], ...candidate.scope.versionGroups]) : candidate.scope.version.some((version) => agentVersionConstraintMatches(expectedVersion, version))) + 1 || null : null;
 	const firstPackageMatchRank = expectedSearchScope.package ? candidates.findIndex((candidate) => valuesOverlap(expectedSearchScope.package ?? [], candidate.scope.package, (left, right) => left === right)) + 1 || null : null;
 	const firstTagsMatchRank = expectedSearchScope.tags ? candidates.findIndex((candidate) => valuesOverlap(expectedSearchScope.tags ?? [], candidate.scope.tags, (left, right) => left === right)) + 1 || null : null;
 	const firstLocaleMatchRank = locale ? candidates.findIndex((candidate) => candidate.scope.locale.includes(locale)) + 1 || null : null;
-	const conflictingSources = candidates.filter((candidate) => framework && candidate.scope.framework.length > 0 && !candidate.scope.framework.includes(framework) || expectedVersion && candidate.scope.version.length > 0 && !candidate.scope.version.some((version) => agentVersionConstraintMatches(expectedVersion, version)) || expectedSearchScope.package && candidate.scope.package.length > 0 && !valuesOverlap(expectedSearchScope.package, candidate.scope.package, (left, right) => left === right) || expectedSearchScope.tags && candidate.scope.tags.length > 0 && !valuesOverlap(expectedSearchScope.tags, candidate.scope.tags, (left, right) => left === right) || locale && candidate.scope.locale.length > 0 && !candidate.scope.locale.includes(locale)).map((candidate) => candidate.source);
-	const ambiguousSources = candidates.filter((candidate) => candidate.scope.frameworkAmbiguous || candidate.scope.versionAmbiguous || Boolean(framework && candidate.scope.framework.length === 0) || Boolean(expectedVersion && candidate.scope.version.length === 0) || Boolean(expectedSearchScope.package && candidate.scope.package.length === 0) || Boolean(expectedSearchScope.tags && candidate.scope.tags.length === 0) || Boolean(locale && candidate.scope.locale.length === 0)).map((candidate) => candidate.source);
+	const conflictingSources = candidates.filter((candidate) => framework && candidate.scope.framework.length > 0 && !candidate.scope.framework.includes(framework) || expectedVersion && candidate.scope.version.length > 0 && !(candidate.scope.versionGroups?.length ? agentVersionConstraintGroupsOverlap([[normalizeAgentVersion(expectedVersion)], ...candidate.scope.versionGroups]) : candidate.scope.version.some((version) => agentVersionConstraintMatches(expectedVersion, version))) || expectedSearchScope.package && candidate.scope.package.length > 0 && !valuesOverlap(expectedSearchScope.package, candidate.scope.package, (left, right) => left === right) || expectedSearchScope.tags && candidate.scope.tags.length > 0 && !valuesOverlap(expectedSearchScope.tags, candidate.scope.tags, (left, right) => left === right) || locale && candidate.scope.locale.length > 0 && !candidate.scope.locale.includes(locale)).map((candidate) => candidate.source);
+	const ambiguousSources = candidates.filter((candidate) => candidate.scope.frameworkAmbiguous || candidate.scope.versionAmbiguous || Boolean(expectedSearchScope.package && candidate.scope.packageAmbiguous) || Boolean(expectedSearchScope.tags && candidate.scope.tagsAmbiguous) || Boolean(framework && candidate.scope.framework.length === 0) || Boolean(expectedVersion && candidate.scope.version.length === 0) || Boolean(expectedSearchScope.package && candidate.scope.package.length === 0) || Boolean(expectedSearchScope.tags && candidate.scope.tags.length === 0) || Boolean(locale && candidate.scope.locale.length === 0)).map((candidate) => candidate.source);
 	const frameworkPassed = !framework || firstFrameworkMatchRank !== null;
 	const versionPassed = !expectedVersion || firstVersionMatchRank !== null;
 	const packagePassed = !expectedSearchScope.package || firstPackageMatchRank !== null;

package/dist/{agent-export-CpQhD8eA.mjs → agent-export-B92pNe6g.mjs}

@@ -1,16 +1,17 @@
-import { A as buildDocsAgentDiscoverySpec, Bt as renderDocsSitemapXml, It as buildDocsSitemapManifest, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as resolveDocsSitemapConfig, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, 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, it as renderDocsLlmsTxt, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, zt as renderDocsSitemapMarkdown } from "./agent-pS2nNQS3.mjs";
-import { D as buildDocsAgentSkillsIndex, E as buildDocsA2AAgentCard, I as resolveDocsPublishedAgentSkill, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, k as buildDocsLegacySkillsIndex, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-CYfiQE13.mjs";
-import "./search-BbArHODP.mjs";
-import { t as resolveDocsI18n } from "./i18n-CCaFUnAN.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-C2SindI5.mjs";
-import "./sitemap-server-PUoOhplO.mjs";
-import "./agent-evals-CjYzCQMZ.mjs";
+import { A as buildDocsAgentDiscoverySpec, Bt as renderDocsSitemapMarkdown, Ht as resolveDocsSitemapConfig, Lt as buildDocsSitemapManifest, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as renderDocsSitemapXml, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, 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, it as renderDocsLlmsTxt, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-BJ0KXN-A.mjs";
+import "./markdown-sections-7OoA7ylx.mjs";
+import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BwL5ffGx.mjs";
+import "./search-DIyIl-tE.mjs";
+import { t as resolveDocsI18n } from "./i18n-hHVWcflJ.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-RbgmSvPH.mjs";
+import "./sitemap-server-BfyBM7_V.mjs";
+import "./agent-evals-LIScgQVm.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-BPVv4gMg.mjs";
+import "./code-blocks-DnNVNK2M.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-z7_R0f86.mjs";
-import { t as detectFramework } from "./utils-C4RC8Zq_.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";

package/dist/agent-skills-bundle.d.mts

@@ -1,4 +1,4 @@
-import { I as DocsPublishedAgentSkill } from "./standards-discovery-DRJ10g7B.mjs";
+import { L as DocsPublishedAgentSkill } from "./standards-discovery-CdrOE-05.mjs";
 
 //#region src/agent-skills-bundle.d.ts
 /**

package/dist/{agent-skills-server-DZnNB4_S.d.mts → agent-skills-server-BqvIGQb1.d.mts}

@@ -1,5 +1,5 @@
-import { $ as DocsAgentSkillsInput } from "./types-B9DNNAdT.mjs";
-import { I as DocsPublishedAgentSkill } from "./standards-discovery-DRJ10g7B.mjs";
+import { $ as DocsAgentSkillsInput } from "./types-clg5J1R4.mjs";
+import { L as DocsPublishedAgentSkill } from "./standards-discovery-CdrOE-05.mjs";
 
 //#region src/agent-skills-server.d.ts
 interface ResolveConfiguredAgentSkillsOptions {

package/dist/{agent-skills-server-BPVv4gMg.mjs → agent-skills-server-noFn1l_p.mjs}

@@ -1,4 +1,4 @@
-import { A as buildDocsPublishedAgentSkill, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-CYfiQE13.mjs";
+import { f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, j as buildDocsPublishedAgentSkill } from "./standards-discovery-BwL5ffGx.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";

package/dist/agent-skills-vite.d.mts

@@ -1,6 +1,6 @@
-import { $ as DocsAgentSkillsInput } from "./types-B9DNNAdT.mjs";
-import { I as DocsPublishedAgentSkill } from "./standards-discovery-DRJ10g7B.mjs";
-import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-DZnNB4_S.mjs";
+import { $ as DocsAgentSkillsInput } from "./types-clg5J1R4.mjs";
+import { L as DocsPublishedAgentSkill } from "./standards-discovery-CdrOE-05.mjs";
+import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-BqvIGQb1.mjs";
 
 //#region src/agent-skills-vite.d.ts
 declare const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";

package/dist/agent-skills-vite.mjs

@@ -1,5 +1,5 @@
-import "./standards-discovery-CYfiQE13.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-BPVv4gMg.mjs";
+import "./standards-discovery-BwL5ffGx.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
 
 //#region src/agent-skills-vite.ts
 const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";

package/dist/{agents-B-1h9Jlm.mjs → agents-C228QGbp.mjs}

@@ -1,14 +1,15 @@
-import { a as DEFAULT_AGENT_MD_ROUTE, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-pS2nNQS3.mjs";
-import "./standards-discovery-CYfiQE13.mjs";
-import "./search-BbArHODP.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-PUoOhplO.mjs";
-import "./agent-evals-CjYzCQMZ.mjs";
+import { a as DEFAULT_AGENT_MD_ROUTE, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-BJ0KXN-A.mjs";
+import "./markdown-sections-7OoA7ylx.mjs";
+import "./standards-discovery-BwL5ffGx.mjs";
+import "./search-DIyIl-tE.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-BfyBM7_V.mjs";
+import "./agent-evals-LIScgQVm.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
-import "./agent-skills-server-BPVv4gMg.mjs";
+import "./code-blocks-DnNVNK2M.mjs";
+import "./agent-skills-server-noFn1l_p.mjs";
 import "./server.mjs";
-import { a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-z7_R0f86.mjs";
-import { t as detectFramework } from "./utils-C4RC8Zq_.mjs";
+import { a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { t as detectFramework } from "./utils-DpiIioYb.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-Cc_qplZU.mjs";
+import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-DbOhkE1h.mjs";
 import pc from "picocolors";
 
 //#region src/cli/index.ts
@@ -82,6 +82,7 @@ async function main() {
 		typesense: typeof flags.typesense === "boolean" ? flags.typesense : void 0,
 		algolia: typeof flags.algolia === "boolean" ? flags.algolia : void 0,
 		baseUrl: typeof flags["base-url"] === "string" ? flags["base-url"] : void 0,
+		siteUrl: typeof flags["site-url"] === "string" ? flags["site-url"] : void 0,
 		collection: typeof flags.collection === "string" ? flags.collection : void 0,
 		apiKey: typeof flags["api-key"] === "string" ? flags["api-key"] : void 0,
 		adminApiKey: typeof flags["admin-api-key"] === "string" ? flags["admin-api-key"] : void 0,
@@ -90,7 +91,8 @@ async function main() {
 		ollamaBaseUrl: typeof flags["ollama-base-url"] === "string" ? flags["ollama-base-url"] : void 0,
 		appId: typeof flags["app-id"] === "string" ? flags["app-id"] : void 0,
 		indexName: typeof flags["index-name"] === "string" ? flags["index-name"] : void 0,
-		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0
+		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0,
+		syncNamespace: typeof flags["sync-namespace"] === "string" ? flags["sync-namespace"] : void 0
 	};
 	const cloudOptions = {
 		configPath: typeof flags.config === "string" ? flags.config : void 0,
@@ -106,43 +108,43 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-p1MHf06G.mjs");
+		const { init } = await import("../init-DAkI0Lkf.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-qE7MYEh9.mjs");
+		const { dev } = await import("../dev-Cc1cFFj-.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-CyysfDny.mjs");
+		const { runCloudDeploy } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-CyysfDny.mjs");
+		const { runCloudPreview } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-CyysfDny.mjs");
+		const { runCloudDeploy } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-CyysfDny.mjs");
+		const { runCloudPreview } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-CyysfDny.mjs");
+		const { runCloudInit } = await import("../cloud-pdNC-tyj.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-CyysfDny.mjs");
+		const { syncCloudConfig } = await import("../cloud-pdNC-tyj.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-CyysfDny.mjs");
+		const { runCloudCheck } = await import("../cloud-pdNC-tyj.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-CyysfDny.mjs");
+		const { printCloudHelp } = await import("../cloud-pdNC-tyj.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-BNK45dzD.mjs");
+		const { runMcp } = await import("../mcp-YD37HlPY.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DbDfIqhe.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-D0LEY2Vy.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -150,7 +152,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-CpQhD8eA.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-B92pNe6g.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -160,13 +162,13 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-DbDfIqhe.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-CpQhD8eA.mjs");
+		const { printAgentCompactHelp } = await import("../agent-D0LEY2Vy.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-B92pNe6g.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-B-1h9Jlm.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-C228QGbp.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -176,11 +178,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-B-1h9Jlm.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-C228QGbp.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CBy8-tPu.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CgrUZ3tY.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -188,7 +190,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-Cace7A2c.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-Dbzkdl6K.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -196,7 +198,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-DAj7EAwt.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-CFuurVIH.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -206,11 +208,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-DAj7EAwt.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-CFuurVIH.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-DB3svkNQ.mjs");
+		const { syncSearch } = await import("../search-hcqaEZVN.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -218,7 +220,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-DPTLh_26.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-jhkS_jYx.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -228,11 +230,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-DPTLh_26.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-jhkS_jYx.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DmE_wXvG.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DUO0r4UI.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -242,11 +244,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-DmE_wXvG.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-DUO0r4UI.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-DCxezPZI.mjs");
+		const { downgrade } = await import("../downgrade-w7e6Se0L.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({
@@ -255,7 +257,7 @@ async function main() {
 			dryRun: flags["dry-run"] === true
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-DDJQ5l6n.mjs");
+		const { upgrade } = await import("../upgrade-oz-GChgt.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;
@@ -395,6 +397,8 @@ ${pc.dim("Options for search sync:")}
   ${pc.cyan("--typesense")}                        Shortcut for ${pc.cyan("--provider typesense")}
   ${pc.cyan("--algolia")}                          Shortcut for ${pc.cyan("--provider algolia")}
   ${pc.cyan("--base-url <url>")}                   Typesense base URL (or use ${pc.dim("TYPESENSE_URL")})
+  ${pc.cyan("--site-url <url>")}                   Canonical public docs URL for source provenance
+  ${pc.cyan("--sync-namespace <name>")}            Stable ownership namespace for a shared hosted index
   ${pc.cyan("--collection <name>")}                Typesense collection name (default ${pc.dim("docs")})
   ${pc.cyan("--api-key <key>")}                    Typesense search/api key (or use ${pc.dim("TYPESENSE_API_KEY")})
   ${pc.cyan("--admin-api-key <key>")}              Admin-capable sync key for Typesense/Algolia

package/dist/client/react.d.mts

@@ -1,4 +1,4 @@
-import { rt as DocsAnalyticsConfig } from "../types-B9DNNAdT.mjs";
+import { rt as DocsAnalyticsConfig } from "../types-clg5J1R4.mjs";
 import { ReactNode } from "react";
 
 //#region src/docs-cloud-client.d.ts

package/dist/{cloud-ask-ai-D9gIN4Vr.d.mts → cloud-ask-ai-6X9pVjIY.d.mts}

@@ -1,4 +1,4 @@
-import { _t as DocsCloudConfig, rt as DocsAnalyticsConfig, t as AIConfig } from "./types-B9DNNAdT.mjs";
+import { _t as DocsCloudConfig, rt as DocsAnalyticsConfig, t as AIConfig } from "./types-clg5J1R4.mjs";
 
 //#region src/cloud-ask-ai.d.ts
 interface DocsCloudAskAIConfig {

package/dist/{cloud-CyysfDny.mjs → cloud-pdNC-tyj.mjs}

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