@farming-labs/docs 0.2.38 → 0.2.40

package/dist/{agent-BjlgUwmW.mjs → agent-WcXCJ4EN.mjs}

@@ -1,9 +1,9 @@
 import "./reading-time-CPAy1SWO.mjs";
-import "./search-CCLIVI86.mjs";
+import "./search-BuOU4idW.mjs";
 import "./agent-B6szuz_8.mjs";
 import "./robots-CVoC0w0i.mjs";
-import "./sitemap-server--TxO6rGi.mjs";
+import "./sitemap-server-PLcNxmtk.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-CZ4ksbeK.mjs";
+import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-DTlvGTH4.mjs";
 
 export { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp };

package/dist/{agents-C3O0I2iR.mjs → agents-BjTEkCsY.mjs}

@@ -1,6 +1,6 @@
-import "./search-CCLIVI86.mjs";
+import "./search-BuOU4idW.mjs";
 import { $ as renderDocsAgentsDocument, C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, it as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-B6szuz_8.mjs";
-import { w as resolveApiReferenceConfig } from "./sitemap-server--TxO6rGi.mjs";
+import { w as resolveApiReferenceConfig } from "./sitemap-server-PLcNxmtk.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-De5z-2LK.mjs";

package/dist/cli/index.mjs

@@ -138,10 +138,10 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-IzaAkFGS.mjs");
+		const { runMcp } = await import("../mcp-DfJiBC0f.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BjlgUwmW.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-WcXCJ4EN.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -151,11 +151,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-BjlgUwmW.mjs");
+		const { printAgentCompactHelp } = await import("../agent-WcXCJ4EN.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-C3O0I2iR.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BjTEkCsY.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -165,11 +165,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-C3O0I2iR.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-BjTEkCsY.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-B5HXAHzl.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-VwhpJct8.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -185,7 +185,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-CZ4ksbeK.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-DTlvGTH4.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -195,11 +195,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-CZ4ksbeK.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-DTlvGTH4.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-BaoPusEb.mjs");
+		const { syncSearch } = await import("../search-CA3H4Dfv.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -207,7 +207,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BzumWs0b.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-CUtSSoGG.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -217,7 +217,7 @@ async function main() {
 	} else if (parsedCommand.command === "sitemap") {
 		console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSitemapGenerateHelp } = await import("../sitemap-BzumWs0b.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-CUtSSoGG.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {

package/dist/{codeblocks-CZ4ksbeK.mjs → codeblocks-DTlvGTH4.mjs}

@@ -1,4 +1,4 @@
-import { _ as parseGeneratedAgentDocument, h as hashGeneratedAgentContent, m as GENERATED_AGENT_PROVENANCE_VERSION, v as serializeGeneratedAgentDocument } from "./search-CCLIVI86.mjs";
+import { _ as parseGeneratedAgentDocument, h as hashGeneratedAgentContent, m as GENERATED_AGENT_PROVENANCE_VERSION, v as serializeGeneratedAgentDocument } from "./search-BuOU4idW.mjs";
 import { I as findDocsMarkdownPage, tt as renderDocsMarkdownDocument } from "./agent-B6szuz_8.mjs";
 import "./index.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";

package/dist/{doctor-B5HXAHzl.mjs → doctor-VwhpJct8.mjs}

@@ -1,13 +1,13 @@
 import "./reading-time-CPAy1SWO.mjs";
-import "./search-CCLIVI86.mjs";
+import "./search-BuOU4idW.mjs";
 import { Ct as DEFAULT_SITEMAP_XML_ROUTE, P as buildDocsMcpEndpointCandidates, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, St as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, kt as resolveDocsSitemapConfig, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, xt as DEFAULT_SITEMAP_MD_ROUTE } from "./agent-B6szuz_8.mjs";
 import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-CVoC0w0i.mjs";
-import "./sitemap-server--TxO6rGi.mjs";
+import "./sitemap-server-PLcNxmtk.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-De5z-2LK.mjs";
 import { t as detectFramework } from "./utils-CoHZJ1i4.mjs";
-import { n as inspectAgentCompactionState, o as scanDocsPageTargets, t as compactAgentDocs } from "./codeblocks-CZ4ksbeK.mjs";
+import { n as inspectAgentCompactionState, o as scanDocsPageTargets, t as compactAgentDocs } from "./codeblocks-DTlvGTH4.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/index.mjs

@@ -1,5 +1,5 @@
 import { _ as extendTheme, a as resolveReadingTimeOptions, b as defineDocs, c as buildPageTwitter, d as resolveOGImage, f as resolveTitle, g as createTheme, h as resolveDocsPath, i as resolveReadingTimeFromSource, l as renderDocsPageStructuredDataJson, m as resolveDocsLocale, n as resolvePageReadingTime, o as buildDocsPageStructuredData, p as resolveDocsI18n, r as resolveReadingTimeFromContent, s as buildPageOpenGraph, t as estimateReadingTimeMinutes, u as resolveDocsMetadataBaseUrl, v as deepMerge, y as resolveChangelogConfig } from "./reading-time-CPAy1SWO.mjs";
-import { A as resolveDocsTelemetryConfig, C as resolveSidebarFolderIndexBehaviorForPath, D as emitDocsTelemetryProjectEvent, E as emitDocsTelemetryMcpToolEvent, F as emitDocsAnalyticsEvent, I as emitDocsObservabilityEvent, L as getDocsRequestAnalyticsProperties, M as createDocsAgentTraceContext, N as createDocsAgentTraceId, O as getDocsTelemetryFeatures, P as emitDocsAgentTraceEvent, R as resolveDocsAnalyticsConfig, S as resolveSidebarFolderIndexBehavior, T as emitDocsTelemetryEvent, _ as parseGeneratedAgentDocument, a as createMcpSearchAdapter, b as applySidebarFolderIndexBehavior, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as normalizeGeneratedAgentContent, h as hashGeneratedAgentContent, i as createCustomSearchAdapter, j as DOCS_AGENT_TRACE_EVENT_TYPES, k as inferDocsTelemetryAgentSurface, l as inferDocsAskAIPackageHints, m as GENERATED_AGENT_PROVENANCE_VERSION, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as GENERATED_AGENT_PROVENANCE_MARKER, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as serializeGeneratedAgentDocument, w as emitDocsTelemetryAgentSurfaceEvent, x as resolvePageSidebarFolderIndexBehavior, y as stripGeneratedAgentProvenance, z as resolveDocsObservabilityConfig } from "./search-CCLIVI86.mjs";
+import { A as resolveDocsTelemetryConfig, C as resolveSidebarFolderIndexBehaviorForPath, D as emitDocsTelemetryProjectEvent, E as emitDocsTelemetryMcpToolEvent, F as emitDocsAnalyticsEvent, I as emitDocsObservabilityEvent, L as getDocsRequestAnalyticsProperties, M as createDocsAgentTraceContext, N as createDocsAgentTraceId, O as getDocsTelemetryFeatures, P as emitDocsAgentTraceEvent, R as resolveDocsAnalyticsConfig, S as resolveSidebarFolderIndexBehavior, T as emitDocsTelemetryEvent, _ as parseGeneratedAgentDocument, a as createMcpSearchAdapter, b as applySidebarFolderIndexBehavior, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as normalizeGeneratedAgentContent, h as hashGeneratedAgentContent, i as createCustomSearchAdapter, j as DOCS_AGENT_TRACE_EVENT_TYPES, k as inferDocsTelemetryAgentSurface, l as inferDocsAskAIPackageHints, m as GENERATED_AGENT_PROVENANCE_VERSION, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as GENERATED_AGENT_PROVENANCE_MARKER, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as serializeGeneratedAgentDocument, w as emitDocsTelemetryAgentSurfaceEvent, x as resolvePageSidebarFolderIndexBehavior, y as stripGeneratedAgentProvenance, z as resolveDocsObservabilityConfig } from "./search-BuOU4idW.mjs";
 import { $ as renderDocsAgentsDocument, A as buildDocsAgentDiscoverySpec, At as resolveDocsSitemapPageLastmod, B as hasDocsMarkdownSignatureAgent, C as DEFAULT_OPENAPI_SCHEMA_ROUTE, Ct as DEFAULT_SITEMAP_XML_ROUTE, D as DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, Dt as renderDocsSitemapMarkdown, E as DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, Et as readDocsSitemapManifestFromContentMap, F as detectDocsMarkdownAgentRequest, G as isDocsLlmsTxtPublicRequest, H as isDocsAgentsRequest, I as findDocsMarkdownPage, J as isDocsSkillRequest, K as isDocsMcpRequest, L as getDocsLlmsTxtMaxCharsIssue, M as buildDocsConfigMap, Mt as toDocsSitemapMarkdownUrl, N as buildDocsDiagnostics, Nt as normalizeDocsRelated, O as DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, Ot as renderDocsSitemapXml, P as buildDocsMcpEndpointCandidates, Pt as renderDocsRelatedMarkdownLines, Q as parseDocsAgentFeedbackData, R as getDocsMarkdownCanonicalLinkHeader, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, St as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as createDocsSitemapResponse, U as isDocsConfigRequest, V as isDocsAgentDiscoveryRequest, W as isDocsDiagnosticsRequest, X as normalizeDocsPathSegment, Y as matchesDocsLlmsTxtSection, Z as normalizeDocsUrlPath, _ as DEFAULT_LLMS_TXT_MAX_CHARS, _t as toDocsMarkdownUrl, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackRequest, b as DEFAULT_MCP_PUBLIC_ROUTE, bt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsLlmsTxtFormat, d as DEFAULT_DOCS_CONFIG_FORMAT, dt as resolveDocsMarkdownCanonicalUrl, et as renderDocsLlmsTxt, f as DEFAULT_DOCS_CONFIG_ROUTE, ft as resolveDocsMarkdownRecovery, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, gt as selectDocsLlmsTxtContent, h as DEFAULT_LLMS_FULL_TXT_ROUTE, ht as resolveDocsSkillFormat, i as DEFAULT_AGENT_FEEDBACK_ROUTE, it as resolveDocsAgentFeedbackConfig, j as buildDocsAgentFeedbackSchema, jt as resolveDocsSitemapRequest, k as DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, kt as resolveDocsSitemapConfig, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsLlmsTxtRequest, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, mt as resolveDocsOpenApiDiscoveryConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsMarkdownNotFound, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as resolveDocsAgentMdxContent, p as DEFAULT_DOCS_DIAGNOSTICS_FORMAT, pt as resolveDocsMarkdownRequest, q as isDocsPublicGetRequest, r as DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, rt as renderDocsSkillDocument, s as DEFAULT_AGENT_SPEC_ROUTE, st as resolveDocsAgentsFormat, t as DEFAULT_AGENTS_MD_ROUTE, tt as renderDocsMarkdownDocument, u as DEFAULT_DOCS_API_ROUTE, ut as resolveDocsLlmsTxtSections, v as DEFAULT_LLMS_TXT_ROUTE, vt as validateDocsAgentFeedbackPayload, w as DEFAULT_SKILL_MD_ROUTE, wt as buildDocsSitemapManifest, x as DEFAULT_MCP_ROUTE, xt as DEFAULT_SITEMAP_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, yt as DEFAULT_SITEMAP_MANIFEST_PATH, z as getDocsMarkdownVaryHeader } from "./agent-B6szuz_8.mjs";
 import { a as analyzeDocsRobotsTxt, c as renderDocsRobotsGeneratedBlock, d as resolveDocsRobotsRequest, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, l as renderDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, o as createDocsRobotsResponse, r as DOCS_ROBOTS_GENERATED_BLOCK_END, s as getDocsRobotsAllowRoutes, t as DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, u as resolveDocsRobotsConfig } from "./robots-CVoC0w0i.mjs";
 

package/dist/{mcp-IzaAkFGS.mjs → mcp-DfJiBC0f.mjs}

@@ -1,6 +1,6 @@
-import "./search-CCLIVI86.mjs";
+import "./search-BuOU4idW.mjs";
 import "./agent-B6szuz_8.mjs";
-import "./sitemap-server--TxO6rGi.mjs";
+import "./sitemap-server-PLcNxmtk.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import "./server.mjs";
 import { c as readNavTitle, m as resolveDocsContentDir, n as extractObjectLiteral, o as readBooleanProperty, p as resolveDocsConfigPath, u as readStringProperty } from "./config-De5z-2LK.mjs";

package/dist/mcp.mjs

@@ -1,4 +1,4 @@
-import { D as emitDocsTelemetryProjectEvent, E as emitDocsTelemetryMcpToolEvent, F as emitDocsAnalyticsEvent, M as createDocsAgentTraceContext, N as createDocsAgentTraceId, P as emitDocsAgentTraceEvent, u as performDocsSearch, w as emitDocsTelemetryAgentSurfaceEvent, x as resolvePageSidebarFolderIndexBehavior, y as stripGeneratedAgentProvenance } from "./search-CCLIVI86.mjs";
+import { D as emitDocsTelemetryProjectEvent, E as emitDocsTelemetryMcpToolEvent, F as emitDocsAnalyticsEvent, M as createDocsAgentTraceContext, N as createDocsAgentTraceId, P as emitDocsAgentTraceEvent, u as performDocsSearch, w as emitDocsTelemetryAgentSurfaceEvent, x as resolvePageSidebarFolderIndexBehavior, y as stripGeneratedAgentProvenance } from "./search-BuOU4idW.mjs";
 import { Nt as normalizeDocsRelated, Pt as renderDocsRelatedMarkdownLines } from "./agent-B6szuz_8.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";

package/dist/{search-CCLIVI86.mjs → search-BuOU4idW.mjs}

@@ -769,6 +769,25 @@ function normalizeMcpSsePayload(body) {
 function normalizeWhitespace(value) {
 	return value.replace(/\s+/g, " ").trim();
 }
+function normalizeSearchPhrase(value) {
+	return normalizeWhitespace(value.toLowerCase().replace(/[?!.,;:]+$/g, ""));
+}
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function literalMatchPriority(query, value) {
+	const q = normalizeSearchPhrase(query);
+	const text = normalizeSearchPhrase(value ?? "");
+	if (!q || !text) return 0;
+	if (text === q) return 2;
+	const boundary = "[^\\p{L}\\p{N}]";
+	return new RegExp(`(^|${boundary})${escapeRegExp(q)}(?=$|${boundary})`, "u").test(text) ? 1 : 0;
+}
+function isLiteralLookupQuery(query) {
+	const q = normalizeSearchPhrase(query);
+	const words = tokenizeSearchQuery(q);
+	return words.length > 0 && words.length <= 3 && words.join(" ") === q;
+}
 function tokenizeSearchQuery(query) {
 	return Array.from(new Set(query.toLowerCase().replace(/[^\p{L}\p{N}@/_:.-]+/gu, " ").split(/\s+/).map((word) => word.replace(/^[^\p{L}\p{N}@]+|[^\p{L}\p{N}]+$/gu, "")).filter((word) => word.length > 1 && !SEARCH_STOP_WORDS.has(word))));
 }
@@ -779,6 +798,25 @@ function normalizeUrlPathname(value) {
 		return value.split(/[?#]/)[0]?.replace(/\/+$/, "") || "/";
 	}
 }
+function safeDecodeUrlSegment(value) {
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		return value;
+	}
+}
+function getUrlSearchSegments(value) {
+	let pathname = "";
+	try {
+		pathname = new URL(value, "https://docs.local").pathname;
+	} catch {
+		pathname = value.split(/[?#]/)[0] ?? "";
+	}
+	return Array.from(new Set(pathname.split("/").flatMap((segment) => {
+		const decoded = safeDecodeUrlSegment(segment);
+		return [decoded, decoded.replace(/[-_]+/g, " ")];
+	}).map(normalizeSearchPhrase).filter(Boolean)));
+}
 function resolveAskAIContextUrl(value, baseUrl) {
 	if (!baseUrl) return value;
 	try {
@@ -936,6 +974,58 @@ function mergeSearchResults(...groups) {
 	}
 	return results;
 }
+function pageToSearchDocument(page) {
+	return {
+		id: makeDocumentId(page.url, "page"),
+		url: page.url,
+		title: page.title,
+		content: normalizeWhitespace(page.content),
+		description: page.description,
+		type: "page",
+		locale: page.locale,
+		framework: page.framework,
+		version: page.version,
+		tags: page.tags
+	};
+}
+function buildExactPageSearchResults(query, pages) {
+	const normalizedQuery = normalizeSearchPhrase(query);
+	if (!normalizedQuery) return [];
+	const results = [];
+	for (const page of pages) {
+		const document = pageToSearchDocument(page);
+		const title = normalizeSearchPhrase(page.title);
+		const urlSegments = getUrlSearchSegments(page.url);
+		if (!(title === normalizedQuery || urlSegments.includes(normalizedQuery))) continue;
+		results.push({
+			id: document.id,
+			url: document.url,
+			content: cleanSearchResultText(document.title) ?? document.title,
+			description: cleanSearchResultText(buildSnippet(document, query) ?? document.description),
+			type: "page",
+			score: scoreDocument(query, document) + 2e3
+		});
+	}
+	return results.sort((a, b) => (b.score ?? 0) - (a.score ?? 0) || a.url.localeCompare(b.url));
+}
+function hasDistinctResultSection(result) {
+	if (result.type === "page") return false;
+	const section = normalizeSearchPhrase(stripHtml(result.section ?? ""));
+	if (!section) return true;
+	return section !== normalizeSearchPhrase(normalizeSearchPhrase(stripHtml(result.content)).split(/\s+[—–]\s+/)[0] ?? "");
+}
+function insideLiteralResultPriority(query, result) {
+	if (!hasDistinctResultSection(result) || !isLiteralLookupQuery(query)) return 0;
+	return Math.max(literalMatchPriority(query, stripHtml(result.section ?? "")), literalMatchPriority(query, stripHtml(result.description ?? "")));
+}
+function prioritizeLiteralInsideResults(query, results) {
+	if (!isLiteralLookupQuery(query)) return results;
+	return [...results].sort((a, b) => {
+		const literalDelta = insideLiteralResultPriority(query, b) - insideLiteralResultPriority(query, a);
+		if (literalDelta) return literalDelta;
+		return 0;
+	});
+}
 function shouldSupplementAskAIWithSimpleSearch(search) {
 	return search.enabled && search.provider !== "simple";
 }
@@ -1012,18 +1102,7 @@ function splitPageIntoSections(page) {
 function buildDocsSearchDocuments(pages, chunking = {}) {
 	const strategy = chunking.strategy ?? "section";
 	return pages.flatMap((page) => {
-		const base = {
-			id: makeDocumentId(page.url, "page"),
-			url: page.url,
-			title: page.title,
-			content: normalizeWhitespace(page.content),
-			description: page.description,
-			type: "page",
-			locale: page.locale,
-			framework: page.framework,
-			version: page.version,
-			tags: page.tags
-		};
+		const base = pageToSearchDocument(page);
 		if (strategy === "page") return [base];
 		const sections = splitPageIntoSections(page);
 		if (sections.length === 0) return [base];
@@ -1031,23 +1110,34 @@ function buildDocsSearchDocuments(pages, chunking = {}) {
 	});
 }
 function scoreDocument(query, document) {
-	const q = normalizeWhitespace(query.toLowerCase().replace(/[?!.,;:]+$/g, ""));
+	const q = normalizeSearchPhrase(query);
 	if (!q) return 0;
 	const words = tokenizeSearchQuery(q);
-	const title = document.title.toLowerCase();
-	const section = document.section?.toLowerCase() ?? "";
-	const description = document.description?.toLowerCase() ?? "";
-	const content = document.content.toLowerCase();
-	const url = document.url.toLowerCase();
+	const title = normalizeSearchPhrase(document.title);
+	const section = document.section ? normalizeSearchPhrase(document.section) : "";
+	const hasDistinctSection = Boolean(section && section !== title);
+	const titleSection = section ? normalizeSearchPhrase(`${document.title} ${document.section}`) : "";
+	const description = document.description ? normalizeSearchPhrase(document.description) : "";
+	const content = normalizeSearchPhrase(document.content);
+	const url = normalizeSearchPhrase(document.url);
+	const urlSegments = getUrlSearchSegments(document.url);
 	const titleTokens = tokenizeSearchQuery(title);
 	const sectionTokens = tokenizeSearchQuery(section);
 	let score = 0;
-	if (title === q) score += 120;
+	const insideLiteralPriority = document.type !== "page" && hasDistinctSection && isLiteralLookupQuery(q) ? Math.max(literalMatchPriority(q, section), literalMatchPriority(q, description), literalMatchPriority(q, content)) : 0;
+	if (insideLiteralPriority > 0) score += insideLiteralPriority * 2250;
+	if (title === q) score += 1120;
 	else if (title.startsWith(q)) score += 70;
 	else if (title.includes(q)) score += 45;
-	if (section === q) score += 80;
-	else if (section.startsWith(q)) score += 55;
-	else if (section.includes(q)) score += 30;
+	if (hasDistinctSection) {
+		if (section === q) score += 1080;
+		else if (section.startsWith(q)) score += 55;
+		else if (section.includes(q)) score += 30;
+		if (titleSection === q) score += 1e3;
+		else if (titleSection.startsWith(q)) score += 50;
+		else if (titleSection.includes(q)) score += 28;
+	}
+	if (urlSegments.includes(q)) score += 950;
 	if (url.includes(q)) score += 12;
 	if (description.includes(q)) score += 18;
 	if (content.includes(q)) score += 12;
@@ -1064,15 +1154,17 @@ function scoreDocument(query, document) {
 			score += 12;
 			matched = true;
 		}
-		if (section === word) {
-			score += 22;
-			matched = true;
-		} else if (section.startsWith(word)) {
-			score += 16;
-			matched = true;
-		} else if (section.includes(word)) {
-			score += 10;
-			matched = true;
+		if (hasDistinctSection) {
+			if (section === word) {
+				score += 22;
+				matched = true;
+			} else if (section.startsWith(word)) {
+				score += 16;
+				matched = true;
+			} else if (section.includes(word)) {
+				score += 10;
+				matched = true;
+			}
 		}
 		if (description.includes(word)) {
 			score += 6;
@@ -1085,11 +1177,11 @@ function scoreDocument(query, document) {
 		if (matched) matchedWords += 1;
 	}
 	if (words.length > 1) {
-		if (sectionTokens.length > 0 && words.every((word) => sectionTokens.includes(word))) score += 30;
+		if (hasDistinctSection && sectionTokens.length > 0 && words.every((word) => sectionTokens.includes(word))) score += 30;
 		if (document.type === "page" && titleTokens.length > 0 && words.every((word) => titleTokens.includes(word))) score += 24;
 	}
 	if (matchedWords === words.length && words.length > 1) score += 20;
-	if (document.type === "heading") score += 6;
+	if (document.type === "heading" && hasDistinctSection) score += 6;
 	return score;
 }
 function buildSnippet(document, query) {
@@ -1613,7 +1705,9 @@ async function performDocsSearch(options) {
 	try {
 		const adapter = await resolveSearchAdapter(search, context);
 		await maybeSyncSearchIndex(adapter, search, context);
-		return await adapter.search(query, context);
+		const results = await adapter.search(query, context);
+		if (search.provider === "simple") return results;
+		return prioritizeLiteralInsideResults(options.query, mergeSearchResults(buildExactPageSearchResults(options.query, options.pages), results)).slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT);
 	} catch {
 		return createSimpleSearchAdapter().search(query, context);
 	}

package/dist/{search-BaoPusEb.mjs → search-CA3H4Dfv.mjs}

@@ -1,6 +1,6 @@
-import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-CCLIVI86.mjs";
+import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-BuOU4idW.mjs";
 import "./agent-B6szuz_8.mjs";
-import "./sitemap-server--TxO6rGi.mjs";
+import "./sitemap-server-PLcNxmtk.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
 import { a as loadProjectEnv, f as readTopLevelStringProperty, m as resolveDocsContentDir, p as resolveDocsConfigPath } from "./config-De5z-2LK.mjs";

package/dist/server.mjs

@@ -1,6 +1,6 @@
-import { F as emitDocsAnalyticsEvent, I as emitDocsObservabilityEvent, L as getDocsRequestAnalyticsProperties, M as createDocsAgentTraceContext, N as createDocsAgentTraceId, P as emitDocsAgentTraceEvent, R as resolveDocsAnalyticsConfig, a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, j as DOCS_AGENT_TRACE_EVENT_TYPES, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, z as resolveDocsObservabilityConfig } from "./search-CCLIVI86.mjs";
+import { F as emitDocsAnalyticsEvent, I as emitDocsObservabilityEvent, L as getDocsRequestAnalyticsProperties, M as createDocsAgentTraceContext, N as createDocsAgentTraceId, P as emitDocsAgentTraceEvent, R as resolveDocsAnalyticsConfig, a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, j as DOCS_AGENT_TRACE_EVENT_TYPES, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, z as resolveDocsObservabilityConfig } from "./search-BuOU4idW.mjs";
 import { At as resolveDocsSitemapPageLastmod, Ct as DEFAULT_SITEMAP_XML_ROUTE, Dt as renderDocsSitemapMarkdown, Et as readDocsSitemapManifestFromContentMap, Mt as toDocsSitemapMarkdownUrl, Ot as renderDocsSitemapXml, St as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Tt as createDocsSitemapResponse, bt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, jt as resolveDocsSitemapRequest, kt as resolveDocsSitemapConfig, wt as buildDocsSitemapManifest, xt as DEFAULT_SITEMAP_MD_ROUTE, yt as DEFAULT_SITEMAP_MANIFEST_PATH } from "./agent-B6szuz_8.mjs";
-import { C as isApiReferenceOpenApiRequest, D as remarkCodeGroup, E as resolveApiReferenceRenderer, S as buildApiReferenceScalarCss, T as resolveApiReferenceOpenApiDiscovery, _ as buildApiReferenceHtmlDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceOpenApiDocumentAsync, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, h as isDocsCloudAskAIProvider, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as createDocsCloudAskAIResponse, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceHtmlDocumentAsync, w as resolveApiReferenceConfig, x as buildApiReferencePageTitle, y as buildApiReferenceOpenApiDocument } from "./sitemap-server--TxO6rGi.mjs";
+import { C as isApiReferenceOpenApiRequest, D as remarkCodeGroup, E as resolveApiReferenceRenderer, S as buildApiReferenceScalarCss, T as resolveApiReferenceOpenApiDiscovery, _ as buildApiReferenceHtmlDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceOpenApiDocumentAsync, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, h as isDocsCloudAskAIProvider, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as createDocsCloudAskAIResponse, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceHtmlDocumentAsync, w as resolveApiReferenceConfig, x as buildApiReferencePageTitle, y as buildApiReferenceOpenApiDocument } from "./sitemap-server-PLcNxmtk.mjs";
 import { a as ensureDocsReviewWorkflow, i as buildDocsReviewWorkflowPathFilters, n as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, o as readDocsReviewConfigFromSource, r as buildDocsReviewWorkflow, s as resolveDocsReviewConfig, t as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD } from "./review-CJD85JTm.mjs";
 import { createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 

package/dist/{sitemap-BzumWs0b.mjs → sitemap-CUtSSoGG.mjs}

@@ -1,6 +1,6 @@
-import "./search-CCLIVI86.mjs";
+import "./search-BuOU4idW.mjs";
 import { Dt as renderDocsSitemapMarkdown, Ot as renderDocsSitemapXml, kt as resolveDocsSitemapConfig, wt as buildDocsSitemapManifest } from "./agent-B6szuz_8.mjs";
-import "./sitemap-server--TxO6rGi.mjs";
+import "./sitemap-server-PLcNxmtk.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
 import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-De5z-2LK.mjs";

package/dist/{sitemap-server--TxO6rGi.mjs → sitemap-server-PLcNxmtk.mjs}

@@ -1,4 +1,4 @@
-import { F as emitDocsAnalyticsEvent } from "./search-CCLIVI86.mjs";
+import { F as emitDocsAnalyticsEvent } from "./search-BuOU4idW.mjs";
 import { kt as resolveDocsSitemapConfig } from "./agent-B6szuz_8.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.38",
+  "version": "0.2.40",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",