@farming-labs/docs 0.2.103 → 0.2.104

package/dist/{agent-lWTq6pgr.d.mts → agent-C9IdC__R.d.mts}

@@ -1,6 +1,6 @@
-import { $n as DocsSearchResult, Cn as DocsRobotsConfig, Dn as DocsSearchAdapterFactory, F as DocsAgentContentChangesConfig, Gt as DocsContentSnapshot, Hn as DocsSearchFilterField, Hr as ResolvedDocsRelatedLink, K as DocsAgentFeedbackData, Mn as DocsSearchChunkingConfig, Nn as DocsSearchConfig, Pn as DocsSearchDocument, Pr as PageAgentFrontmatter, Qr as TypesenseDocsSearchConfig, Rt as DocsConfig, Tn as DocsSearchAdapter, Un as DocsSearchFilterInput, Wn as DocsSearchFilters, Wt as DocsContentChangesResponse, Yt as DocsI18nConfig, Zn as DocsSearchRequest, _r as LlmsTxtConfig, br as LlmsTxtSectionConfig, f as CustomDocsSearchConfig, ir as DocsSitemapConfig, pn as DocsPaginatedSearchResponse, pr as FeedbackConfig, r as AlgoliaDocsSearchConfig, tn as DocsMcpConfig, tr as DocsSearchSourcePage, vr as LlmsTxtMaxCharsConfig, wt as DocsAskAIMcpConfig, xr as McpDocsSearchConfig, yr as LlmsTxtMaxCharsMode, zn as DocsSearchFacetsResponse } from "./types-DLLefoU5.mjs";
-import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-D1Ys4J3h.mjs";
-import { t as DocsContentAudience } from "./audience-exposure-Cw3SA4WE.mjs";
+import { $n as DocsSearchFilterInput, Ar as LlmsTxtSectionConfig, Cn as DocsPaginatedSearchResponse, Cr as FeedbackConfig, Dr as LlmsTxtConfig, F as DocsAgentContentChangesConfig, Fn as DocsSearchAdapter, Gt as DocsContentSnapshot, Hn as DocsSearchChunkingConfig, K as DocsAgentFeedbackData, Ln as DocsSearchAdapterFactory, Nn as DocsRobotsConfig, Or as LlmsTxtMaxCharsConfig, Qn as DocsSearchFilterField, Rt as DocsConfig, Un as DocsSearchConfig, Wn as DocsSearchDocument, Wt as DocsContentChangesResponse, Yn as DocsSearchFacetsResponse, Yt as DocsI18nConfig, di as TypesenseDocsSearchConfig, dr as DocsSearchSourcePage, er as DocsSearchFilters, f as CustomDocsSearchConfig, jr as McpDocsSearchConfig, kr as LlmsTxtMaxCharsMode, lr as DocsSearchResult, mn as DocsOkfConfig, mr as DocsSitemapConfig, qr as PageAgentFrontmatter, r as AlgoliaDocsSearchConfig, sr as DocsSearchRequest, ti as ResolvedDocsRelatedLink, tn as DocsMcpConfig, vn as DocsOkfTrustMetadataInput, wt as DocsAskAIMcpConfig } from "./types-BthCiAD9.mjs";
+import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-Cqq8QmlH.mjs";
+import { t as DocsContentAudience } from "./audience-exposure-BW13cI2O.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig, DocsMcpResolvedPromptsConfig } from "./mcp.mjs";
 
 //#region src/i18n.d.ts
@@ -751,6 +751,8 @@ interface DocsMarkdownPage {
   markdownUrl?: string;
   lastModified?: string;
   lastmod?: string;
+  sourcePath?: string;
+  okf?: DocsOkfTrustMetadataInput;
   related?: ResolvedDocsRelatedLink[];
   agent?: PageAgentFrontmatter;
   content: string;
@@ -762,6 +764,7 @@ interface DocsMarkdownPage {
 }
 interface DocsMarkdownDocumentOptions {
   llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig;
+  okf?: boolean | DocsOkfConfig;
   origin?: string;
   sitemap?: boolean | DocsSitemapConfig;
 }
@@ -1287,6 +1290,8 @@ declare function buildDocsAgentDiscoverySpec({
       listPages: boolean;
       listPageSections?: boolean;
       readPage: boolean;
+      readPages?: boolean;
+      submitFeedback?: boolean;
       listTasks?: boolean;
       readTask?: boolean;
       searchDocs: boolean;
@@ -1297,6 +1302,7 @@ declare function buildDocsAgentDiscoverySpec({
       getCodeExamples: boolean;
       getConfigSchema: boolean;
       getContext: boolean;
+      getTrustMetadata?: boolean;
     };
     prompts: DocsMcpResolvedPromptsConfig;
   };

package/dist/{agent-BLHMoVId.mjs → agent-NerpHcQB.mjs}

@@ -1,8 +1,8 @@
-import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-CFqECAG0.mjs";
+import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-PSrgiJD8.mjs";
 import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
-import { c as hashGeneratedAgentContent, d as serializeGeneratedAgentDocument, s as GENERATED_AGENT_PROVENANCE_VERSION, u as parseGeneratedAgentDocument } from "./content-change-hydration-BsbBXAUi.mjs";
+import { f as parseGeneratedAgentDocument, l as GENERATED_AGENT_PROVENANCE_VERSION, p as serializeGeneratedAgentDocument, u as hashGeneratedAgentContent } from "./openapi-mcp-B7u7Y0gB.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-BaTmjDqD.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-BhF6J2N4.mjs";
 import { createRequire } from "node:module";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";

package/dist/{agent-CFqECAG0.mjs → agent-PSrgiJD8.mjs}

@@ -3,6 +3,150 @@ import { B as createDocsCacheableResponse, F as isDocsStandardsDiscoveryRequest,
 import { t as resolveDocsAudienceExposure } from "./audience-exposure-DVsfT9Sx.mjs";
 import { createProcessor } from "@mdx-js/mdx";
 
+//#region src/okf.ts
+const DOCS_OKF_VERSION = "0.2";
+const DOCS_OKF_BUNDLE_FORMAT = "open-knowledge-format.v0.2";
+const DEFAULT_DOCS_OKF_ROUTE = "/.well-known/okf.json";
+function cleanString$1(value) {
+	if (typeof value !== "string") return void 0;
+	return value.trim() || void 0;
+}
+function normalizeDate(value) {
+	if (value instanceof Date && Number.isFinite(value.getTime())) return value.toISOString();
+	const stringValue = cleanString$1(value);
+	if (!stringValue) return void 0;
+	const parsed = new Date(stringValue);
+	return Number.isFinite(parsed.getTime()) ? parsed.toISOString() : void 0;
+}
+function normalizeDateOnly$1(value) {
+	return normalizeDate(value)?.slice(0, 10);
+}
+function normalizeStatus(value) {
+	return value === "draft" || value === "stable" || value === "deprecated" ? value : void 0;
+}
+function normalizeActorTimestamp(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const record = value;
+	const by = cleanString$1(record.by);
+	const at = normalizeDate(record.at);
+	return by && at ? {
+		by,
+		at
+	} : void 0;
+}
+function normalizeSource(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const record = value;
+	const resource = cleanString$1(record.resource);
+	if (!resource) return void 0;
+	const usageCount = typeof record.usage_count === "number" && Number.isInteger(record.usage_count) ? Math.max(0, record.usage_count) : void 0;
+	const usageWindowRecord = record.usage_window && typeof record.usage_window === "object" && !Array.isArray(record.usage_window) ? record.usage_window : void 0;
+	const usageWindow = usageWindowRecord ? {
+		...normalizeDate(usageWindowRecord.start) ? { start: normalizeDate(usageWindowRecord.start) } : {},
+		...normalizeDate(usageWindowRecord.end) ? { end: normalizeDate(usageWindowRecord.end) } : {}
+	} : void 0;
+	return {
+		resource,
+		...cleanString$1(record.id) ? { id: cleanString$1(record.id) } : {},
+		...cleanString$1(record.title) ? { title: cleanString$1(record.title) } : {},
+		...cleanString$1(record.author) ? { author: cleanString$1(record.author) } : {},
+		...usageCount !== void 0 ? { usage_count: usageCount } : {},
+		...normalizeDate(record.last_modified) ? { last_modified: normalizeDate(record.last_modified) } : {},
+		...usageWindow && Object.keys(usageWindow).length > 0 ? { usage_window: usageWindow } : {}
+	};
+}
+function normalizeDocsOkfTrustMetadataInput(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const record = value;
+	const sources = Array.isArray(record.sources) ? record.sources.flatMap((source) => {
+		const normalized = normalizeSource(source);
+		return normalized ? [normalized] : [];
+	}) : void 0;
+	const verified = Array.isArray(record.verified) ? record.verified.flatMap((entry) => {
+		const normalized = normalizeActorTimestamp(entry);
+		return normalized ? [normalized] : [];
+	}) : void 0;
+	const generated = normalizeActorTimestamp(record.generated);
+	const status = normalizeStatus(record.status);
+	const staleAfter = normalizeDateOnly$1(record.stale_after);
+	const result = {
+		...sources && sources.length > 0 ? { sources } : {},
+		...generated ? { generated } : {},
+		...verified && verified.length > 0 ? { verified } : {},
+		...status ? { status } : {},
+		...staleAfter ? { stale_after: staleAfter } : {}
+	};
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+function resolveDocsOkfConfig(value) {
+	const config = value && typeof value === "object" ? value : {};
+	return {
+		enabled: value === true || typeof value === "object" && value !== null && value.enabled !== false,
+		route: cleanString$1(config.route) ?? DEFAULT_DOCS_OKF_ROUTE,
+		generatedBy: cleanString$1(config.generatedBy) ?? "software:@farming-labs/docs",
+		...Number.isInteger(config.staleAfterDays) && (config.staleAfterDays ?? 0) > 0 ? { staleAfterDays: config.staleAfterDays } : {},
+		...normalizeDocsOkfTrustMetadataInput(config)
+	};
+}
+function addDays(value, days) {
+	const parsed = new Date(value);
+	if (!Number.isFinite(parsed.getTime())) return void 0;
+	parsed.setUTCDate(parsed.getUTCDate() + days);
+	return parsed.toISOString().slice(0, 10);
+}
+function trustTier(verified) {
+	if (verified.some((entry) => entry.by.toLowerCase().startsWith("human:"))) return "human-reviewed";
+	return verified.length > 0 ? "machine-confirmed" : "unverified";
+}
+function resolveDocsOkfTrustMetadata(page, value, now = /* @__PURE__ */ new Date()) {
+	const config = resolveDocsOkfConfig(value);
+	const authored = normalizeDocsOkfTrustMetadataInput(page.okf) ?? {};
+	const bestTimestamp = normalizeDate(page.lastmod) ?? normalizeDate(page.lastModified);
+	const generated = authored.generated ?? config.generated ?? {
+		by: config.generatedBy,
+		at: bestTimestamp ?? "1970-01-01T00:00:00.000Z"
+	};
+	const sources = [...authored.sources ?? config.sources ?? []];
+	if (sources.length === 0) sources.push({
+		resource: page.canonicalUrl ?? page.url,
+		...page.sourcePath ? { id: page.sourcePath } : {},
+		title: page.title,
+		...bestTimestamp ? { last_modified: bestTimestamp } : {}
+	});
+	const verified = [...authored.verified ?? config.verified ?? []];
+	const staleAfter = authored.stale_after ?? config.stale_after ?? (config.staleAfterDays && bestTimestamp ? addDays(bestTimestamp, config.staleAfterDays) : void 0);
+	return {
+		sources,
+		generated,
+		verified,
+		status: authored.status ?? config.status ?? "stable",
+		...staleAfter ? { stale_after: staleAfter } : {},
+		trust_tier: trustTier(verified),
+		stale: staleAfter ? now.getTime() > (/* @__PURE__ */ new Date(`${staleAfter}T23:59:59.999Z`)).getTime() : false
+	};
+}
+function buildDocsOkfBundle(pages, value) {
+	const config = resolveDocsOkfConfig(value);
+	const documents = pages.map((page) => ({
+		id: page.sourcePath ?? page.url,
+		url: page.canonicalUrl ?? page.url,
+		title: page.title,
+		...page.content ? { content: page.content } : {},
+		trust: resolveDocsOkfTrustMetadata(page, config)
+	})).sort((left, right) => left.url.localeCompare(right.url));
+	const generatedAt = documents.reduce((latest, document) => document.trust.generated.at > latest ? document.trust.generated.at : latest, "1970-01-01T00:00:00.000Z");
+	return {
+		format: DOCS_OKF_BUNDLE_FORMAT,
+		spec_version: DOCS_OKF_VERSION,
+		generated: {
+			by: config.generatedBy,
+			at: generatedAt
+		},
+		documents
+	};
+}
+
+//#endregion
 //#region src/mcp-auth.ts
 const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
 const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
@@ -3315,6 +3459,7 @@ async function enrichDocsSearchResultsWithSources(options) {
 		const page = findPageForSearchResult(localizedPages, result, options.baseUrl, pagesByRoute);
 		if (page) return {
 			...resultWithoutSource,
+			trust: resolveDocsOkfTrustMetadata(page),
 			source: await buildDocsRetrievalSource(page, result.url, {
 				audience: options.audience,
 				chunking: options.chunking,
@@ -6123,6 +6268,8 @@ const DEFAULT_DOCS_DIAGNOSTICS_MCP_TOOLS = {
 	listPages: true,
 	listPageSections: true,
 	readPage: true,
+	readPages: true,
+	submitFeedback: true,
 	listTasks: true,
 	readTask: true,
 	searchDocs: true,
@@ -7633,7 +7780,7 @@ function resolveDocsMarkdownMetadataUrl(value, origin) {
 		return value;
 	}
 }
-function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markdownUrl, lastUpdated, agent, generatedPreamble }) {
+function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markdownUrl, lastUpdated, trust, agent, generatedPreamble }) {
 	return [
 		"---",
 		`title: ${toYamlString(title)}`,
@@ -7641,6 +7788,7 @@ function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markd
 		`canonical_url: ${toYamlString(canonicalUrl)}`,
 		`markdown_url: ${toYamlString(markdownUrl)}`,
 		...lastUpdated ? [`last_updated: ${toYamlString(lastUpdated)}`] : [],
+		...trust ? [`okf: ${JSON.stringify(trust)}`] : [],
 		...generatedPreamble ? [`${DOCS_MARKDOWN_GENERATED_PREAMBLE_FIELD}: true`] : [],
 		...renderPageAgentFrontmatterYamlLines(agent),
 		"---"
@@ -7914,13 +8062,19 @@ function selectDocsMarkdownSection(document, request) {
 	};
 }
 function resolveDocsMarkdownPageMetadata(page, options) {
+	const canonicalUrl = resolveDocsMarkdownMetadataUrl(page.url, options?.origin);
+	const okfEnabled = resolveDocsOkfConfig(options?.okf).enabled || page.okf !== void 0;
 	return {
 		title: page.title,
 		description: page.description,
-		canonicalUrl: resolveDocsMarkdownMetadataUrl(page.url, options?.origin),
+		canonicalUrl,
 		markdownUrl: resolveDocsMarkdownMetadataUrl(page.markdownUrl ?? toDocsMarkdownUrl(page.url), options?.origin),
 		lastUpdated: normalizeDocsMarkdownLastUpdated(page.lastmod ?? page.lastModified),
-		agent: page.agent
+		agent: page.agent,
+		...okfEnabled ? { trust: resolveDocsOkfTrustMetadata({
+			...page,
+			canonicalUrl
+		}, options?.okf) } : {}
 	};
 }
 function renderDocsMarkdownNotFound({ entry = "docs", apiRoute, requestedPath, origin, pages, sitemap }) {
@@ -8003,8 +8157,11 @@ function createDocsMarkdownResponse(options) {
 	});
 	const contentLocation = options.contentLocation ?? resolveDocsMarkdownContentLocation(canonicalUrl);
 	const varyHeader = getDocsMarkdownVaryHeader(request);
+	const llmsTxtUrl = new URL(DEFAULT_LLMS_TXT_ROUTE, origin).toString();
+	const discoveryLink = `<${llmsTxtUrl}>; rel="describedby"; type="text/plain"`;
 	const baseSharedHeaders = {
 		"X-Robots-Tag": "noindex",
+		"X-Llms-Txt": llmsTxtUrl,
 		...locale ? { "Content-Language": locale } : {},
 		...varyHeader ? { Vary: varyHeader } : {}
 	};
@@ -8020,7 +8177,7 @@ function createDocsMarkdownResponse(options) {
 			headers: {
 				...baseSharedHeaders,
 				"Content-Location": contentLocation,
-				Link: `<${canonicalUrl}>; rel="canonical"`,
+				Link: `<${canonicalUrl}>; rel="canonical", ${discoveryLink}`,
 				"Cache-Control": "no-store",
 				Location: new URL(recovery.redirect.markdownUrl, request.url).toString()
 			}
@@ -8037,7 +8194,7 @@ function createDocsMarkdownResponse(options) {
 			headers: {
 				...baseSharedHeaders,
 				"Content-Location": contentLocation,
-				Link: `<${canonicalUrl}>; rel="canonical"`,
+				Link: `<${canonicalUrl}>; rel="canonical", ${discoveryLink}`,
 				"Cache-Control": "no-store",
 				"Content-Type": "text/markdown; charset=utf-8"
 			}
@@ -8064,7 +8221,7 @@ function createDocsMarkdownResponse(options) {
 			headers: {
 				...baseSharedHeaders,
 				"Content-Location": sectionIndexContentLocation,
-				Link: `<${canonicalUrl}>; rel="canonical", <${contentLocation}>; rel="alternate"; type="text/markdown"`,
+				Link: `<${canonicalUrl}>; rel="canonical", <${contentLocation}>; rel="alternate"; type="text/markdown", ${discoveryLink}`,
 				"Cache-Control": options.cacheControl ?? "public, max-age=0, s-maxage=3600",
 				"Content-Type": "application/json; charset=utf-8",
 				"X-Docs-Markdown-Section-Index": DOCS_MARKDOWN_SECTION_INDEX_FORMAT,
@@ -8096,7 +8253,7 @@ function createDocsMarkdownResponse(options) {
 	const responseHeaders = {
 		...baseSharedHeaders,
 		"Content-Location": sectionContentLocation,
-		Link: `<${sectionCanonicalUrl}>; rel="canonical"`,
+		Link: `<${sectionCanonicalUrl}>; rel="canonical", ${discoveryLink}`,
 		"Cache-Control": sectionResult?.found === false ? "no-store" : options.cacheControl ?? "public, max-age=0, s-maxage=3600",
 		"Content-Type": "text/markdown; charset=utf-8",
 		...sectionHeaders,
@@ -8764,4 +8921,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-export { matchesDocsLlmsTxtSection as $, resolveDocsMcpProtectedResourceMetadataLocation as $n, buildDocsRetrievalDigestProjection as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentLocale as An, DEFAULT_SITEMAP_XML_ROUTE as At, findDocsMarkdownPage as B, DEFAULT_MCP_PUBLIC_ROUTE as Bn, DOCS_CONTENT_CHANGES_FORMAT as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, findDocsAudienceMdxTags as Cn, selectDocsMarkdownSection as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, agentVersionConstraintMatches as Dn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, agentVersionConstraintGroupsOverlap as En, DEFAULT_SITEMAP_MANIFEST_PATH as Et, buildDocsMcpEndpointCandidates as F, paginateDocsItems as Fn, renderDocsSitemapXml as Ft, isDocsAgentDiscoveryRequest as G, getDocsMcpResourcePaths as Gn, createDocsContentChangesHttpResponse as Gt, getDocsMarkdownCanonicalLinkHeader as H, DEFAULT_MCP_WELL_KNOWN_ROUTE as Hn, DOCS_CONTENT_SNAPSHOT_FORMAT as Ht, collectDocsMarkdownSections as I, resolveDocsPaginationOffset as In, resolveDocsSitemapConfig as It, isDocsDiagnosticsRequest as J, isDocsMcpProtectedResourceMetadataPath as Jn, resolveDocsContentChangesConfig as Jt, isDocsAgentsRequest as K, hasDocsMcpProtectedResourceConfig as Kn, isDocsContentChangeGeneration as Kt, createDocsMarkdownResponse as L, normalizeDocsRelated as Ln, resolveDocsSitemapPageLastmod as Lt, buildDocsConfigMap as M, normalizeAgentVersion as Mn, createDocsSitemapResponse as Mt, buildDocsDiagnostics as N, DocsPaginationCursorError as Nn, readDocsSitemapManifestFromContentMap as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintsOverlap as On, DEFAULT_SITEMAP_MD_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, createDocsPaginationCursor as Pn, renderDocsSitemapMarkdown as Pt, isDocsSkillRequest as Q, normalizeDocsMcpEndpointPath as Qn, buildDocsContentSnapshot as Qt, createDocsStandardsDiscoveryResponse as R, renderDocsRelatedMarkdownLines as Rn, resolveDocsSitemapRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, findDocsAudienceMdxIssues as Sn, selectDocsLlmsTxtContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, resolveDocsAudienceMdxContent as Tn, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, buildDocsMcpProtectedResourceMetadataRoute as Un, DocsContentChangesRequestError as Ut, getDocsLlmsTxtMaxCharsIssue as V, DEFAULT_MCP_ROUTE as Vn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Vt, hasDocsMarkdownSignatureAgent as W, getDocsMcpProtectedResourceMetadataRoutes as Wn, createDocsContentChangeFeed as Wt, isDocsMarkdownSectionIndexRequest as X, isDocsMcpResourcePath as Xn, DocsSearchRequestError as Xt, isDocsLlmsTxtPublicRequest as Y, isDocsMcpRequest as Yn, resolveDocsContentChangesRequest as Yt, isDocsPublicGetRequest as Z, normalizeDocsMcpAuthorizationServerUrls as Zn, buildDocsAskAIContext as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchFilters as _n, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, createSimpleSearchAdapter as an, renderDocsMarkdownDocument as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveSearchRequestConfig as bn, resolveDocsRequestApiRoute as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, formatDocsAskAIPackageHints as cn, resolveDocsAgentContractMcpTools as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, performDocsSearch as dn, resolveDocsAgentsFormat as dt, buildDocsSearchDocuments as en, resolveDocsMcpResourceLocation as er, normalizeDocsPathSegment as et, DEFAULT_DOCS_CONFIG_ROUTE as f, performDocsSearchWithMetadata as fn, resolveDocsLlmsTxtFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSearchError as gn, resolveDocsMarkdownRecovery as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsSearchAudience as hn, resolveDocsMarkdownCanonicalUrl as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createMcpSearchAdapter as in, renderDocsLlmsTxt as it, buildDocsAgentFeedbackSchema as j, normalizeAgentScopeValues as jn, buildDocsSitemapManifest as jt, acceptsDocsMarkdown as k, normalizeAgentFramework as kn, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, inferDocsAskAIPackageHints as ln, resolveDocsAgentFeedbackConfig as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsRetrievalLastModified as mn, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, createAlgoliaSearchAdapter as nn, parseDocsAgentFeedbackData as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createTypesenseSearchAdapter as on, renderDocsMarkdownNotFound as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveAskAISearchRequestConfig as pn, resolveDocsLlmsTxtRequest as pt, isDocsConfigRequest as q, isDocsMcpOAuthScopeToken as qn, isDocsContentChangesRequest as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createCustomSearchAdapter as rn, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, enrichDocsSearchDocumentsWithProvenance as sn, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchFacets as tn, normalizeDocsUrlPath as tt, DEFAULT_DOCS_API_ROUTE as u, normalizeDocsSearchFilters as un, resolveDocsAgentFeedbackRequest as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchRequest as vn, resolveDocsMarkdownSectionRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, resolveDocsAgentMdxContent as wn, toDocsMarkdownUrl as wt, DEFAULT_SKILL_MD_ROUTE as x, extractDocsMarkdownPromptBlocks as xn, resolveDocsSkillFormat as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveLocalDocsMcpSearchConfig as yn, resolveDocsOpenApiDiscoveryConfig as yt, detectDocsMarkdownAgentRequest as z, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as zn, toDocsSitemapMarkdownUrl as zt };
+export { matchesDocsLlmsTxtSection as $, resolveDocsMcpProtectedResourceMetadataLocation as $n, buildDocsRetrievalDigestProjection as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentLocale as An, DEFAULT_SITEMAP_XML_ROUTE as At, findDocsMarkdownPage as B, DEFAULT_MCP_PUBLIC_ROUTE as Bn, DOCS_CONTENT_CHANGES_FORMAT as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, findDocsAudienceMdxTags as Cn, selectDocsMarkdownSection as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, agentVersionConstraintMatches as Dn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, agentVersionConstraintGroupsOverlap as En, DEFAULT_SITEMAP_MANIFEST_PATH as Et, buildDocsMcpEndpointCandidates as F, paginateDocsItems as Fn, renderDocsSitemapXml as Ft, isDocsAgentDiscoveryRequest as G, getDocsMcpResourcePaths as Gn, createDocsContentChangesHttpResponse as Gt, getDocsMarkdownCanonicalLinkHeader as H, DEFAULT_MCP_WELL_KNOWN_ROUTE as Hn, DOCS_CONTENT_SNAPSHOT_FORMAT as Ht, collectDocsMarkdownSections as I, resolveDocsPaginationOffset as In, resolveDocsSitemapConfig as It, isDocsDiagnosticsRequest as J, isDocsMcpProtectedResourceMetadataPath as Jn, resolveDocsContentChangesConfig as Jt, isDocsAgentsRequest as K, hasDocsMcpProtectedResourceConfig as Kn, isDocsContentChangeGeneration as Kt, createDocsMarkdownResponse as L, normalizeDocsRelated as Ln, resolveDocsSitemapPageLastmod as Lt, buildDocsConfigMap as M, normalizeAgentVersion as Mn, createDocsSitemapResponse as Mt, buildDocsDiagnostics as N, DocsPaginationCursorError as Nn, readDocsSitemapManifestFromContentMap as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintsOverlap as On, DEFAULT_SITEMAP_MD_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, createDocsPaginationCursor as Pn, renderDocsSitemapMarkdown as Pt, isDocsSkillRequest as Q, normalizeDocsMcpEndpointPath as Qn, buildDocsContentSnapshot as Qt, createDocsStandardsDiscoveryResponse as R, renderDocsRelatedMarkdownLines as Rn, resolveDocsSitemapRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, findDocsAudienceMdxIssues as Sn, selectDocsLlmsTxtContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, resolveDocsAudienceMdxContent as Tn, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, buildDocsMcpProtectedResourceMetadataRoute as Un, DocsContentChangesRequestError as Ut, getDocsLlmsTxtMaxCharsIssue as V, DEFAULT_MCP_ROUTE as Vn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Vt, hasDocsMarkdownSignatureAgent as W, getDocsMcpProtectedResourceMetadataRoutes as Wn, createDocsContentChangeFeed as Wt, isDocsMarkdownSectionIndexRequest as X, isDocsMcpResourcePath as Xn, DocsSearchRequestError as Xt, isDocsLlmsTxtPublicRequest as Y, isDocsMcpRequest as Yn, resolveDocsContentChangesRequest as Yt, isDocsPublicGetRequest as Z, normalizeDocsMcpAuthorizationServerUrls as Zn, buildDocsAskAIContext as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchFilters as _n, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, createSimpleSearchAdapter as an, normalizeDocsOkfTrustMetadataInput as ar, renderDocsMarkdownDocument as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveSearchRequestConfig as bn, resolveDocsRequestApiRoute as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, formatDocsAskAIPackageHints as cn, resolveDocsAgentContractMcpTools as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, performDocsSearch as dn, resolveDocsAgentsFormat as dt, buildDocsSearchDocuments as en, resolveDocsMcpResourceLocation as er, normalizeDocsPathSegment as et, DEFAULT_DOCS_CONFIG_ROUTE as f, performDocsSearchWithMetadata as fn, resolveDocsLlmsTxtFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSearchError as gn, resolveDocsMarkdownRecovery as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsSearchAudience as hn, resolveDocsMarkdownCanonicalUrl as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createMcpSearchAdapter as in, buildDocsOkfBundle as ir, renderDocsLlmsTxt as it, buildDocsAgentFeedbackSchema as j, normalizeAgentScopeValues as jn, buildDocsSitemapManifest as jt, acceptsDocsMarkdown as k, normalizeAgentFramework as kn, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, inferDocsAskAIPackageHints as ln, resolveDocsAgentFeedbackConfig as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsRetrievalLastModified as mn, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, createAlgoliaSearchAdapter as nn, DOCS_OKF_BUNDLE_FORMAT as nr, parseDocsAgentFeedbackData as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createTypesenseSearchAdapter as on, resolveDocsOkfConfig as or, renderDocsMarkdownNotFound as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveAskAISearchRequestConfig as pn, resolveDocsLlmsTxtRequest as pt, isDocsConfigRequest as q, isDocsMcpOAuthScopeToken as qn, isDocsContentChangesRequest as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createCustomSearchAdapter as rn, DOCS_OKF_VERSION as rr, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, enrichDocsSearchDocumentsWithProvenance as sn, resolveDocsOkfTrustMetadata as sr, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchFacets as tn, DEFAULT_DOCS_OKF_ROUTE as tr, normalizeDocsUrlPath as tt, DEFAULT_DOCS_API_ROUTE as u, normalizeDocsSearchFilters as un, resolveDocsAgentFeedbackRequest as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchRequest as vn, resolveDocsMarkdownSectionRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, resolveDocsAgentMdxContent as wn, toDocsMarkdownUrl as wt, DEFAULT_SKILL_MD_ROUTE as x, extractDocsMarkdownPromptBlocks as xn, resolveDocsSkillFormat as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveLocalDocsMcpSearchConfig as yn, resolveDocsOpenApiDiscoveryConfig as yt, detectDocsMarkdownAgentRequest as z, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as zn, toDocsSitemapMarkdownUrl as zt };

package/dist/{agent-evals-GpcaCbRb.mjs → agent-evals-U9d_db2u.mjs}

@@ -1,9 +1,9 @@
-import { $t as buildDocsRetrievalDigestProjection, An as normalizeAgentLocale, Dn as agentVersionConstraintMatches, En as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentVersion, On as agentVersionConstraintsOverlap, Zt as buildDocsAskAIContext, bn as resolveSearchRequestConfig, dn as performDocsSearch, jn as normalizeAgentScopeValues, kn as normalizeAgentFramework, un as normalizeDocsSearchFilters } from "./agent-CFqECAG0.mjs";
+import { $t as buildDocsRetrievalDigestProjection, An as normalizeAgentLocale, Dn as agentVersionConstraintMatches, En as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentVersion, On as agentVersionConstraintsOverlap, Zt as buildDocsAskAIContext, bn as resolveSearchRequestConfig, dn as performDocsSearch, jn as normalizeAgentScopeValues, kn as normalizeAgentFramework, un as normalizeDocsSearchFilters } from "./agent-PSrgiJD8.mjs";
 import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.mjs";
 import { K as digestDocsRetrievalContent } from "./standards-discovery-Ckx0tN7B.mjs";
 import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-DFqQyO_V.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
-import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-Bel6vDqI.mjs";
+import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-c3nIrWOM.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { createJiti } from "jiti";

package/dist/{agent-export-oiWxB5aX.mjs → agent-export-DlBUKkTt.mjs}

@@ -1,17 +1,18 @@
-import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapXml, It as resolveDocsSitemapConfig, Pt as renderDocsSitemapMarkdown, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, 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, jt as buildDocsSitemapManifest, 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-CFqECAG0.mjs";
+import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapXml, It as resolveDocsSitemapConfig, Pt as renderDocsSitemapMarkdown, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, 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, ir as buildDocsOkfBundle, it as renderDocsLlmsTxt, jt as buildDocsSitemapManifest, 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, or as resolveDocsOkfConfig, 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-PSrgiJD8.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
 import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, V as formatDocsContentDigest, W as resolveDocsHttpDate, 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-Ckx0tN7B.mjs";
-import "./content-change-hydration-BsbBXAUi.mjs";
+import "./openapi-mcp-B7u7Y0gB.mjs";
 import { t as resolveDocsI18n } from "./i18n-B3BIxShC.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-NQesPX5L.mjs";
-import "./sitemap-server-B0SiREN0.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-DNod0XKB.mjs";
+import "./sitemap-server-C2TauhKa.mjs";
 import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-DFqQyO_V.mjs";
-import "./agent-evals-GpcaCbRb.mjs";
+import "./agent-evals-U9d_db2u.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-Bel6vDqI.mjs";
+import "./authoring-mcp-BCM5CJbJ.mjs";
+import "./code-blocks-c3nIrWOM.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-BaTmjDqD.mjs";
-import { t as detectFramework } from "./utils-DOMeZW9V.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-BhF6J2N4.mjs";
+import { t as detectFramework } from "./utils-DcCUwxqS.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -443,7 +444,8 @@ function resolveUserOwnedOverrides(outputs, previous) {
 		"page",
 		"llms",
 		"discovery",
-		"skill"
+		"skill",
+		"okf"
 	]);
 	const previousByPath = new Map(previous?.files.map((file) => [file.path, file]) ?? []);
 	return outputs.map((output) => {
@@ -684,6 +686,7 @@ async function exportAgentBundle(options = {}) {
 	});
 	if (localizedPages.length === 0) throw new Error(`No docs content was found under ${contentDir}.`);
 	const pages = localizedPages.map(({ page }) => page);
+	const okfConfig = resolveDocsOkfConfig(config?.agent?.okf);
 	const sitemap = resolveDocsSitemapConfig(sitemapInput, { baseUrl });
 	const robots = resolveDocsRobotsConfig(robotsInput, { baseUrl: typeof robotsInput === "object" ? robotsInput.baseUrl ?? sitemap.baseUrl : sitemap.baseUrl });
 	const mcp = resolveDocsMcpConfig(false, { defaultName: resolvedSiteTitle });
@@ -731,11 +734,19 @@ async function exportAgentBundle(options = {}) {
 			markdownUrl: staticMarkdownRoute(page, sourceEntry, routeEntry)
 		}, {
 			llms,
+			okf: config?.agent?.okf,
 			origin: baseUrl,
 			sitemap: sitemapInput
 		}));
 		output.lastModified = resolveDocsHttpDate(page.lastModified);
 	}
+	if (okfConfig.enabled) {
+		const okfBundle = buildDocsOkfBundle(pages.map((page) => ({
+			...page,
+			canonicalUrl: baseUrl ? new URL(page.url, baseUrl).toString() : page.url
+		})), okfConfig);
+		addOutput(outputs, publicDir, okfConfig.route, "okf", "application/json", JSON.stringify(okfBundle, null, 2));
+	}
 	if (llmsEnabled) {
 		const llmsContent = renderDocsLlmsTxt(pages.map((page) => ({
 			url: page.url,

package/dist/agent-feedback-loop-CGrc-gDW.mjs

@@ -0,0 +1,196 @@
+import { readFileSync } from "node:fs";
+
+//#region src/agent-feedback-loop.ts
+const DOCS_AGENT_FEEDBACK_IMPROVEMENT_FORMAT = "farming-labs-agent-feedback-improvements.v1";
+const TASK_STOP_WORDS = new Set([
+	"a",
+	"an",
+	"and",
+	"do",
+	"for",
+	"from",
+	"how",
+	"i",
+	"in",
+	"of",
+	"on",
+	"the",
+	"to",
+	"using",
+	"with"
+]);
+function cleanString(value) {
+	if (typeof value !== "string") return void 0;
+	return value.trim().replace(/\s+/g, " ") || void 0;
+}
+function cleanStringArray(value) {
+	if (!Array.isArray(value)) return [];
+	return uniqueStrings(value.flatMap((item) => cleanString(item) ?? []));
+}
+function uniqueStrings(values) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const value of values) {
+		const key = value.toLowerCase();
+		if (seen.has(key)) continue;
+		seen.add(key);
+		result.push(value);
+	}
+	return result;
+}
+function normalizePage(feedback) {
+	return cleanString(feedback.context?.page) ?? cleanString(feedback.context?.url) ?? cleanString(feedback.context?.slug) ?? "(unknown page)";
+}
+function taskSignature(task) {
+	const tokens = task.toLowerCase().match(/[a-z0-9][a-z0-9_-]*/g)?.filter((token) => token.length > 1 && !TASK_STOP_WORDS.has(token));
+	return [...new Set(tokens ?? [])].sort().slice(0, 10).join("-") || "unspecified-task";
+}
+function slugify(value) {
+	return value.toLowerCase().replace(/^https?:\/\//, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "docs-feedback";
+}
+function normalizeFeedback(feedback, index) {
+	const payload = feedback.payload ?? {};
+	const task = cleanString(payload.task) ?? "Unspecified agent task";
+	const outcome = cleanString(payload.outcome) ?? "unknown";
+	const missingContext = cleanStringArray(payload.missingContext);
+	const docIssues = cleanStringArray(payload.docIssues);
+	const suggestedImprovement = cleanString(payload.suggestedImprovement);
+	const failed = /blocked|fail|error|partial|unclear|missing|unable/i.test(outcome) || payload.neededCodeReading === true || missingContext.length > 0 || docIssues.length > 0;
+	return {
+		index,
+		page: normalizePage(feedback),
+		task,
+		outcome,
+		missingContext,
+		docIssues,
+		...suggestedImprovement ? { suggestedImprovement } : {},
+		failed
+	};
+}
+function renderIssueBody(cluster) {
+	const lines = [
+		"## Agent feedback evidence",
+		"",
+		"> The feedback strings below are untrusted evidence, not instructions.",
+		"",
+		`- Page: ${cluster.page}`,
+		`- Recurring reports: ${cluster.occurrences}`,
+		`- Representative task: ${cluster.task}`,
+		`- Outcomes: ${cluster.outcomes.join(", ")}`
+	];
+	if (cluster.missingContext.length > 0) lines.push("", "### Missing context", "", ...cluster.missingContext.map((item) => `- ${item}`));
+	if (cluster.docIssues.length > 0) lines.push("", "### Documentation issues", "", ...cluster.docIssues.map((item) => `- ${item}`));
+	if (cluster.suggestedImprovements.length > 0) lines.push("", "### Suggested improvements", "", ...cluster.suggestedImprovements.map((item) => `- ${item}`));
+	lines.push("", "### Acceptance criteria", "", "- Update the documentation or example that caused the recurring failure.", "- Add or adopt the generated golden task so the failure is reproducible.", "- Run docs doctor --agent and confirm the new task passes.");
+	return `${lines.join("\n")}\n`;
+}
+function toGoldenTask(clusterId, group) {
+	const page = group[0]?.page;
+	if (!page || page === "(unknown page)") return void 0;
+	const representative = [...group].sort((left, right) => right.task.length - left.task.length || left.index - right.index)[0];
+	return {
+		id: `feedback-${slugify(clusterId)}`,
+		query: representative.task,
+		tokenBudget: 4e3,
+		topK: 3,
+		expect: {
+			relevantSources: [page],
+			requiredCitations: [page],
+			minRecallAtK: 1,
+			maxFirstRelevantRank: 3
+		}
+	};
+}
+function analyzeDocsAgentFeedback(feedback, options = {}) {
+	const minOccurrences = Math.max(2, Math.floor(options.minOccurrences ?? 2));
+	const failures = feedback.map(normalizeFeedback).filter((entry) => entry.failed);
+	const grouped = /* @__PURE__ */ new Map();
+	for (const entry of failures) {
+		const id = `${slugify(entry.page)}--${taskSignature(entry.task)}`;
+		grouped.set(id, [...grouped.get(id) ?? [], entry]);
+	}
+	const clusters = [...grouped.entries()].filter(([, group]) => group.length >= minOccurrences).map(([id, group]) => {
+		const representative = [...group].sort((left, right) => right.task.length - left.task.length || left.index - right.index)[0];
+		const clusterWithoutIssue = {
+			id,
+			page: representative.page,
+			task: representative.task,
+			occurrences: group.length,
+			outcomes: uniqueStrings(group.map((entry) => entry.outcome)),
+			missingContext: uniqueStrings(group.flatMap((entry) => entry.missingContext)),
+			docIssues: uniqueStrings(group.flatMap((entry) => entry.docIssues)),
+			suggestedImprovements: uniqueStrings(group.flatMap((entry) => entry.suggestedImprovement ?? [])),
+			...toGoldenTask(id, group) ? { goldenTask: toGoldenTask(id, group) } : {}
+		};
+		return {
+			...clusterWithoutIssue,
+			issue: {
+				title: `docs: address recurring agent failure for ${representative.page}`,
+				body: renderIssueBody(clusterWithoutIssue),
+				labels: ["documentation", "agent-readiness"]
+			}
+		};
+	}).sort((left, right) => right.occurrences - left.occurrences || left.id.localeCompare(right.id));
+	const goldenTasks = clusters.flatMap((cluster) => cluster.goldenTask ?? []);
+	const issueDrafts = clusters.map((cluster) => cluster.issue);
+	return {
+		format: DOCS_AGENT_FEEDBACK_IMPROVEMENT_FORMAT,
+		generatedAt: options.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		feedbackCount: feedback.length,
+		failureCount: failures.length,
+		recurringClusterCount: clusters.length,
+		clusters,
+		goldenTasks,
+		issueDrafts,
+		pullRequestDraft: {
+			title: `docs: address ${clusters.length} recurring agent feedback cluster${clusters.length === 1 ? "" : "s"}`,
+			body: [
+				"## Summary",
+				"",
+				...clusters.map((cluster) => `- ${cluster.page}: ${cluster.occurrences} reports for ${cluster.task}`),
+				"",
+				"## Verification",
+				"",
+				"- [ ] Add the generated golden tasks to agent.evaluations.tasks",
+				"- [ ] Run docs doctor --agent",
+				"- [ ] Confirm the affected docs pages no longer reproduce the feedback failures",
+				""
+			].join("\n")
+		}
+	};
+}
+function asFeedbackArray(value) {
+	if (Array.isArray(value)) return value;
+	if (!value || typeof value !== "object") return void 0;
+	const record = value;
+	const candidate = record.feedback ?? record.events ?? record.items;
+	return Array.isArray(candidate) ? candidate : void 0;
+}
+function parseFeedbackData(value, label) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${label} must be an object.`);
+	const record = value;
+	if (!record.payload || typeof record.payload !== "object" || Array.isArray(record.payload)) throw new Error(`${label}.payload must be an object.`);
+	const context = record.context && typeof record.context === "object" && !Array.isArray(record.context) ? record.context : void 0;
+	return {
+		...context ? { context } : {},
+		payload: record.payload
+	};
+}
+function readDocsAgentFeedbackFile(filePath) {
+	const content = readFileSync(filePath, "utf8").trim();
+	if (!content) return [];
+	try {
+		const parsed = asFeedbackArray(JSON.parse(content));
+		if (parsed) return parsed.map((item, index) => parseFeedbackData(item, `Feedback ${index + 1}`));
+	} catch {}
+	return content.split(/\r?\n/).map((line, index) => {
+		try {
+			return parseFeedbackData(JSON.parse(line), `Feedback line ${index + 1}`);
+		} catch (error) {
+			throw new Error(`Invalid agent feedback JSON on line ${index + 1}: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	});
+}
+
+//#endregion
+export { analyzeDocsAgentFeedback as n, readDocsAgentFeedbackFile as r, DOCS_AGENT_FEEDBACK_IMPROVEMENT_FORMAT as t };

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

@@ -1,4 +1,4 @@
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-D1Ys4J3h.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-Cqq8QmlH.mjs";
 
 //#region src/agent-skills-bundle.d.ts
 /**

package/dist/{agent-skills-server-CICMh0zv.d.mts → agent-skills-server-CIoL58X7.d.mts}

@@ -1,5 +1,5 @@
-import { st as DocsAgentSkillsInput } from "./types-DLLefoU5.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-D1Ys4J3h.mjs";
+import { st as DocsAgentSkillsInput } from "./types-BthCiAD9.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-Cqq8QmlH.mjs";
 
 //#region src/agent-skills-server.d.ts
 interface ResolveConfiguredAgentSkillsOptions {

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

@@ -1,6 +1,6 @@
-import { st as DocsAgentSkillsInput } from "./types-DLLefoU5.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-D1Ys4J3h.mjs";
-import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CICMh0zv.mjs";
+import { st as DocsAgentSkillsInput } from "./types-BthCiAD9.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-Cqq8QmlH.mjs";
+import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CIoL58X7.mjs";
 
 //#region src/agent-skills-vite.d.ts
 declare const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";