@farming-labs/docs 0.2.73 → 0.2.74

package/dist/{agent-o9OTadrf.mjs → agent-BJ0KXN-A.mjs}

@@ -2786,6 +2786,13 @@ function validateDocsDiagnosticsSearchConfig(search, errors) {
 		requireString("apiKey");
 	}
 	if (provider === "mcp") requireString("endpoint");
+	const syncNamespace = stringConfigValue(search.syncNamespace);
+	if (syncNamespace && syncNamespace.length > 1024) errors.push({
+		severity: "error",
+		code: "invalid-search-sync-namespace",
+		path: "/search/syncNamespace",
+		message: "search.syncNamespace must be 1024 characters or fewer."
+	});
 	if (provider === "custom" && !("adapter" in search)) errors.push({
 		severity: "error",
 		code: "missing-search-adapter",

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

@@ -1,6 +1,6 @@
-import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-o9OTadrf.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 { E as hashGeneratedAgentContent, O as parseGeneratedAgentDocument, T as GENERATED_AGENT_PROVENANCE_VERSION, k as serializeGeneratedAgentDocument } from "./search-RfPcG1if.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-Wcdj-D0a.mjs";
 import { createRequire } from "node:module";

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

@@ -1,5 +1,5 @@
 import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.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-RfPcG1if.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-DnNVNK2M.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
@@ -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,6 +825,7 @@ 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;
@@ -832,7 +834,9 @@ function canonicalizeSource(value, baseUrl) {
 		const hashIndex = rawValue.indexOf("#");
 		const pathAndQuery = hashIndex >= 0 ? rawValue.slice(0, hashIndex) : rawValue || "/";
 		const fragment = hashIndex >= 0 ? rawValue.slice(hashIndex + 1) : "";
-		pathname = pathAndQuery.split("?", 1)[0] || "/";
+		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, "");
@@ -840,14 +844,19 @@ function canonicalizeSource(value, baseUrl) {
 	if (!pathname.startsWith("/")) pathname = `/${pathname}`;
 	const decodedHash = hash ? safeDecode(hash.slice(1)).trim() : "";
 	const normalizedHash = decodedHash ? `#${encodeURIComponent(decodedHash)}` : "";
-	return `${origin}${pathname || "/"}${normalizedHash === "#" ? "" : normalizedHash}`;
+	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) {
@@ -867,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) {
@@ -894,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,
@@ -950,7 +962,8 @@ function getPageAgentMarkdown(page) {
 	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) {
 	const canonical = canonicalizeSource(value);
@@ -959,15 +972,17 @@ function getResultAnchor(value) {
 }
 /** @internal */
 function hydrateDocsEvaluationSearchSource(result, index, pagesByUrl, contentMode, baseUrl) {
-	const normalizedResultUrl = canonicalizeSource(result.url, baseUrl);
-	const page = findPageForSource(pagesByUrl, normalizedResultUrl);
-	const anchor = getResultAnchor(result.url);
+	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 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}`,
@@ -977,12 +992,13 @@ function hydrateDocsEvaluationSearchSource(result, index, pagesByUrl, contentMod
 		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,
@@ -1172,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);
@@ -1218,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,
@@ -1290,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))
 			}
 		};
 	}
@@ -1964,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),
@@ -1979,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-B9bah0AV.mjs → agent-export-B92pNe6g.mjs}

@@ -1,11 +1,11 @@
-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-o9OTadrf.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-RfPcG1if.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-BcuxnZqZ.mjs";
-import "./sitemap-server-VefDnzEB.mjs";
-import "./agent-evals-BFHGypqh.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-DnNVNK2M.mjs";
 import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";

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

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

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

@@ -1,5 +1,5 @@
-import { $ as DocsAgentSkillsInput } from "./types-_HCPD4wc.mjs";
-import { L as DocsPublishedAgentSkill } from "./standards-discovery-83lp1lew.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-vite.d.mts

@@ -1,6 +1,6 @@
-import { $ as DocsAgentSkillsInput } from "./types-_HCPD4wc.mjs";
-import { L as DocsPublishedAgentSkill } from "./standards-discovery-83lp1lew.mjs";
-import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-DCbAx5WU.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/{agents-CR-Uasbc.mjs → agents-C228QGbp.mjs}

@@ -1,9 +1,9 @@
-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-o9OTadrf.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-RfPcG1if.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-VefDnzEB.mjs";
-import "./agent-evals-BFHGypqh.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-DnNVNK2M.mjs";
 import "./agent-skills-server-noFn1l_p.mjs";

package/dist/cli/index.mjs

@@ -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,
@@ -139,10 +141,10 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-BLLXvEXB.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-ClRpctMG.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-B9bah0AV.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-ClRpctMG.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-B9bah0AV.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-CR-Uasbc.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-CR-Uasbc.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-C228QGbp.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-BeyN3Ljh.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-DaJLdPLh.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-Dbzkdl6K.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -210,7 +212,7 @@ async function main() {
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-DeOJiMAy.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-BGGbX_KE.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-BGGbX_KE.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-DI-9MZz1.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DUO0r4UI.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -242,7 +244,7 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-DI-9MZz1.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-DUO0r4UI.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
@@ -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-_HCPD4wc.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-yR9vZmSG.d.mts → cloud-ask-ai-6X9pVjIY.d.mts}

@@ -1,4 +1,4 @@
-import { _t as DocsCloudConfig, rt as DocsAnalyticsConfig, t as AIConfig } from "./types-_HCPD4wc.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/docs-cloud-server.d.mts

@@ -1,5 +1,5 @@
-import { at as DocsAnalyticsEventInput, it as DocsAnalyticsEvent, rt as DocsAnalyticsConfig } from "./types-_HCPD4wc.mjs";
-import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-yR9vZmSG.mjs";
+import { at as DocsAnalyticsEventInput, it as DocsAnalyticsEvent, rt as DocsAnalyticsConfig } from "./types-clg5J1R4.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-6X9pVjIY.mjs";
 
 //#region src/docs-cloud-server.d.ts
 type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);

package/dist/{doctor-BeyN3Ljh.mjs → doctor-CgrUZ3tY.mjs}

@@ -1,21 +1,21 @@
-import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-ClRpctMG.mjs";
-import { d as httpLinkHeaderHasTargetRelation, f as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, p as readAgentSkillDocumentFromTar } from "./prompt-references-Cz35rlOa.mjs";
-import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, F as buildDocsMcpEndpointCandidates, Ft as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Ht as resolveDocsSitemapConfig, It as DEFAULT_SITEMAP_XML_ROUTE, M as buildDocsConfigMap, Pt as DEFAULT_SITEMAP_MD_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as isDocsMcpOAuthScopeToken, on as normalizeDocsMcpAuthorizationServerUrls, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-o9OTadrf.mjs";
+import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-D0LEY2Vy.mjs";
+import { d as httpLinkHeaderHasTargetRelation, f as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, p as readAgentSkillDocumentFromTar } from "./prompt-references-BIS1eXt4.mjs";
+import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, F as buildDocsMcpEndpointCandidates, Ft as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Ht as resolveDocsSitemapConfig, It as DEFAULT_SITEMAP_XML_ROUTE, M as buildDocsConfigMap, Pt as DEFAULT_SITEMAP_MD_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as isDocsMcpOAuthScopeToken, on as normalizeDocsMcpAuthorizationServerUrls, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-BJ0KXN-A.mjs";
 import { f as PAGE_AGENT_CONTRACT_FIELDS } from "./markdown-sections-7OoA7ylx.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
 import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-BwL5ffGx.mjs";
-import { p as resolveAskAISearchRequestConfig } from "./search-RfPcG1if.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-BcuxnZqZ.mjs";
+import { h as resolveAskAISearchRequestConfig } from "./search-DIyIl-tE.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-RbgmSvPH.mjs";
 import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
-import "./sitemap-server-VefDnzEB.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-BFHGypqh.mjs";
+import "./sitemap-server-BfyBM7_V.mjs";
+import { t as runDocsGoldenTasks } from "./agent-evals-LIScgQVm.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
 import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, r as extractTopLevelConfigObject, s as loadDocsConfigModuleResultWithProjectEnv, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
-import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CloP0pAe.mjs";
+import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-DTEPZeb0.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/{golden-evaluations-CloP0pAe.mjs → golden-evaluations-DTEPZeb0.mjs}

@@ -1,6 +1,6 @@
-import { Ot as findDocsAudienceMdxTags, jt as resolveDocsAudienceMdxContent } from "./agent-o9OTadrf.mjs";
+import { Ot as findDocsAudienceMdxTags, jt as resolveDocsAudienceMdxContent } from "./agent-BJ0KXN-A.mjs";
 import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
-import { C as normalizeAgentVersion, b as normalizeAgentFramework, y as agentVersionConstraintsOverlap } from "./search-RfPcG1if.mjs";
+import { C as agentVersionConstraintsOverlap, D as normalizeAgentVersion, w as normalizeAgentFramework } from "./search-DIyIl-tE.mjs";
 import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";