@farming-labs/docs 0.2.80 → 0.2.82

package/dist/{agent-aWl_O6xn.mjs → agent-Biyd8A98.mjs}

@@ -1,6 +1,6 @@
-import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-Cj50nyeV.mjs";
+import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-Dze2Cy5B.mjs";
 import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
-import { a as parseGeneratedAgentDocument, n as GENERATED_AGENT_PROVENANCE_VERSION, o as serializeGeneratedAgentDocument, r as hashGeneratedAgentContent } from "./agent-provenance-C_jgqNTW.mjs";
+import { c as hashGeneratedAgentContent, d as serializeGeneratedAgentDocument, s as GENERATED_AGENT_PROVENANCE_VERSION, u as parseGeneratedAgentDocument } from "./content-change-hydration-DpQ0KdAD.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-Cj50nyeV.mjs → agent-Dze2Cy5B.mjs}

@@ -8715,4 +8715,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-export { matchesDocsLlmsTxtSection as $, normalizeDocsMcpEndpointPath as $n, buildDocsRetrievalDigestProjection as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentFramework as An, DEFAULT_SITEMAP_XML_ROUTE as At, findDocsMarkdownPage as B, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_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, agentVersionConstraintGroupsOverlap as Dn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, resolveDocsAudienceMdxContent as En, DEFAULT_SITEMAP_MANIFEST_PATH as Et, buildDocsMcpEndpointCandidates as F, paginateDocsItems as Fn, renderDocsSitemapXml as Ft, isDocsAgentDiscoveryRequest as G, getDocsMcpProtectedResourceMetadataRoutes as Gn, createDocsContentChangesHttpResponse as Gt, getDocsMarkdownCanonicalLinkHeader as H, DEFAULT_MCP_ROUTE as Hn, DOCS_CONTENT_SNAPSHOT_FORMAT as Ht, collectDocsMarkdownSections as I, digestDocsRetrievalContent as In, resolveDocsSitemapConfig as It, isDocsDiagnosticsRequest as J, isDocsMcpOAuthScopeToken as Jn, resolveDocsContentChangesConfig as Jt, isDocsAgentsRequest as K, getDocsMcpResourcePaths as Kn, isDocsContentChangeGeneration as Kt, createDocsMarkdownResponse as L, isDocsRetrievalCanonicalUrl as Ln, resolveDocsSitemapPageLastmod as Lt, buildDocsConfigMap as M, normalizeAgentScopeValues as Mn, createDocsSitemapResponse as Mt, buildDocsDiagnostics as N, normalizeAgentVersion as Nn, readDocsSitemapManifestFromContentMap as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintMatches as On, DEFAULT_SITEMAP_MD_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, DocsPaginationCursorError as Pn, renderDocsSitemapMarkdown as Pt, isDocsSkillRequest as Q, normalizeDocsMcpAuthorizationServerUrls as Qn, buildDocsContentSnapshot as Qt, createDocsStandardsDiscoveryResponse as R, normalizeDocsRelated 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, resolveDocsAudienceExposure as Tn, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, DEFAULT_MCP_WELL_KNOWN_ROUTE as Un, DocsContentChangesRequestError as Ut, getDocsLlmsTxtMaxCharsIssue as V, DEFAULT_MCP_PUBLIC_ROUTE as Vn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Vt, hasDocsMarkdownSignatureAgent as W, buildDocsMcpProtectedResourceMetadataRoute as Wn, createDocsContentChangeFeed as Wt, isDocsMarkdownSectionIndexRequest as X, isDocsMcpRequest as Xn, DocsSearchRequestError as Xt, isDocsLlmsTxtPublicRequest as Y, isDocsMcpProtectedResourceMetadataPath as Yn, resolveDocsContentChangesRequest as Yt, isDocsPublicGetRequest as Z, isDocsMcpResourcePath 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, resolveDocsMcpProtectedResourceMetadataLocation 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, normalizeAgentLocale as jn, buildDocsSitemapManifest as jt, acceptsDocsMarkdown as k, agentVersionConstraintsOverlap 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, hasDocsMcpProtectedResourceConfig 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, resolveDocsMcpResourceLocation 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, renderDocsRelatedMarkdownLines as zn, toDocsSitemapMarkdownUrl as zt };
+export { matchesDocsLlmsTxtSection as $, isDocsMcpResourcePath as $n, buildDocsRetrievalDigestProjection as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentFramework as An, DEFAULT_SITEMAP_XML_ROUTE as At, findDocsMarkdownPage as B, normalizeDocsRelated 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, agentVersionConstraintGroupsOverlap as Dn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, resolveDocsAudienceMdxContent as En, DEFAULT_SITEMAP_MANIFEST_PATH as Et, buildDocsMcpEndpointCandidates as F, createDocsPaginationCursor as Fn, renderDocsSitemapXml as Ft, isDocsAgentDiscoveryRequest as G, DEFAULT_MCP_WELL_KNOWN_ROUTE as Gn, createDocsContentChangesHttpResponse as Gt, getDocsMarkdownCanonicalLinkHeader as H, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Hn, DOCS_CONTENT_SNAPSHOT_FORMAT as Ht, collectDocsMarkdownSections as I, paginateDocsItems as In, resolveDocsSitemapConfig as It, isDocsDiagnosticsRequest as J, getDocsMcpResourcePaths as Jn, resolveDocsContentChangesConfig as Jt, isDocsAgentsRequest as K, buildDocsMcpProtectedResourceMetadataRoute as Kn, isDocsContentChangeGeneration as Kt, createDocsMarkdownResponse as L, resolveDocsPaginationOffset as Ln, resolveDocsSitemapPageLastmod as Lt, buildDocsConfigMap as M, normalizeAgentScopeValues as Mn, createDocsSitemapResponse as Mt, buildDocsDiagnostics as N, normalizeAgentVersion as Nn, readDocsSitemapManifestFromContentMap as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintMatches as On, DEFAULT_SITEMAP_MD_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, DocsPaginationCursorError as Pn, renderDocsSitemapMarkdown as Pt, isDocsSkillRequest as Q, isDocsMcpRequest as Qn, buildDocsContentSnapshot as Qt, createDocsStandardsDiscoveryResponse as R, digestDocsRetrievalContent 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, resolveDocsAudienceExposure as Tn, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, DEFAULT_MCP_PUBLIC_ROUTE as Un, DocsContentChangesRequestError as Ut, getDocsLlmsTxtMaxCharsIssue as V, renderDocsRelatedMarkdownLines as Vn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Vt, hasDocsMarkdownSignatureAgent as W, DEFAULT_MCP_ROUTE as Wn, createDocsContentChangeFeed as Wt, isDocsMarkdownSectionIndexRequest as X, isDocsMcpOAuthScopeToken as Xn, DocsSearchRequestError as Xt, isDocsLlmsTxtPublicRequest as Y, hasDocsMcpProtectedResourceConfig as Yn, resolveDocsContentChangesRequest as Yt, isDocsPublicGetRequest as Z, isDocsMcpProtectedResourceMetadataPath 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, normalizeDocsMcpAuthorizationServerUrls 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, normalizeAgentLocale as jn, buildDocsSitemapManifest as jt, acceptsDocsMarkdown as k, agentVersionConstraintsOverlap 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, resolveDocsMcpProtectedResourceMetadataLocation as nr, 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, getDocsMcpProtectedResourceMetadataRoutes as qn, isDocsContentChangesRequest as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createCustomSearchAdapter as rn, resolveDocsMcpResourceLocation as rr, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, enrichDocsSearchDocumentsWithProvenance as sn, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchFacets as tn, normalizeDocsMcpEndpointPath 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, isDocsRetrievalCanonicalUrl as zn, toDocsSitemapMarkdownUrl as zt };

package/dist/{agent-DGALg9hQ.d.mts → agent-WS4GXGh6.d.mts}

@@ -1,5 +1,5 @@
-import { $n as LlmsTxtMaxCharsMode, At as DocsConfig, Dn as DocsSearchFilterField, En as DocsSearchFacetsResponse, F as DocsAgentContentChangesConfig, Fn as DocsSearchSourcePage, It as DocsContentChangesResponse, K as DocsAgentFeedbackData, Lt as DocsContentSnapshot, Mr as TypesenseDocsSearchConfig, Nn as DocsSearchResult, On as DocsSearchFilterInput, Qn as LlmsTxtMaxCharsConfig, Rn as DocsSitemapConfig, Sn as DocsSearchDocument, Sr as ResolvedDocsRelatedLink, Vt as DocsI18nConfig, Zn as LlmsTxtConfig, bn as DocsSearchChunkingConfig, er as LlmsTxtSectionConfig, f as CustomDocsSearchConfig, gn as DocsSearchAdapter, gt as DocsAskAIMcpConfig, in as DocsPaginatedSearchResponse, jn as DocsSearchRequest, kn as DocsSearchFilters, mn as DocsRobotsConfig, mr as PageAgentFrontmatter, qn as FeedbackConfig, qt as DocsMcpConfig, r as AlgoliaDocsSearchConfig, tr as McpDocsSearchConfig, vn as DocsSearchAdapterFactory, xn as DocsSearchConfig } from "./types-o-ULHPK6.mjs";
-import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-C2cUIQzW.mjs";
+import { $n as LlmsTxtConfig, An as DocsSearchFilterInput, Bn as DocsSitemapConfig, Cn as DocsSearchConfig, F as DocsAgentContentChangesConfig, Fn as DocsSearchResult, K as DocsAgentFeedbackData, Ln as DocsSearchSourcePage, Mt as DocsConfig, Nn as DocsSearchRequest, On as DocsSearchFacetsResponse, Pr as TypesenseDocsSearchConfig, Rt as DocsContentChangesResponse, Sn as DocsSearchChunkingConfig, Ut as DocsI18nConfig, Yn as FeedbackConfig, Yt as DocsMcpConfig, bn as DocsSearchAdapterFactory, er as LlmsTxtMaxCharsConfig, f as CustomDocsSearchConfig, gn as DocsRobotsConfig, gr as PageAgentFrontmatter, jn as DocsSearchFilters, kn as DocsSearchFilterField, nr as LlmsTxtSectionConfig, on as DocsPaginatedSearchResponse, r as AlgoliaDocsSearchConfig, rr as McpDocsSearchConfig, tr as LlmsTxtMaxCharsMode, vn as DocsSearchAdapter, vt as DocsAskAIMcpConfig, wn as DocsSearchDocument, wr as ResolvedDocsRelatedLink, zt as DocsContentSnapshot } from "./types-lGEHcx_6.mjs";
+import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-DPUEcUmb.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/i18n.d.ts
@@ -303,6 +303,90 @@ declare function createDocsContentChangesHttpResponse(options: {
   baseUrl?: string;
 }): Promise<Response>;
 //#endregion
+//#region src/content-change-hydration.d.ts
+declare const DOCS_CONTENT_CHANGE_HYDRATION_FORMAT = "docs-content-change-hydration.v1";
+declare const DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 5000;
+declare const MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 4;
+declare const MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 32000;
+interface DocsContentChangeHydrationSection {
+  id: string;
+  heading: string;
+  level: number;
+}
+interface DocsContentChangeHydrationContent {
+  type: "content";
+  change: "added" | "changed";
+  url: string;
+  canonicalUrl: string;
+  /** Digest from the body-free document change feed. */
+  digest: string;
+  previousDigest?: string;
+  lastModified?: string;
+  previousLastModified?: string;
+  section: DocsContentChangeHydrationSection;
+  /** Digest of the complete, non-overlapping section before chunking. */
+  sectionDigest: string;
+  /** Digest of the content bytes returned in this chunk. */
+  chunkDigest: string;
+  chunk: {
+    index: number;
+    count: number;
+  };
+  content: string;
+  utf8Bytes: number;
+}
+interface DocsContentChangeHydrationTombstone {
+  type: "tombstone";
+  change: "deleted";
+  url: string;
+  canonicalUrl: string;
+  /** Last known digest for the deleted document. */
+  digest: string;
+  lastModified?: string;
+}
+interface DocsContentChangeHydrationBudget {
+  requestedTokens: number;
+  strategy: "utf8-bytes";
+  maxUtf8Bytes: number;
+  usedUtf8Bytes: number;
+  conservativeTokenUpperBound: number;
+  remainingUtf8Bytes: number;
+}
+interface DocsContentChangeHydrationResponse {
+  format: typeof DOCS_CONTENT_CHANGE_HYDRATION_FORMAT;
+  audience: "agent";
+  locale?: string;
+  since: string;
+  indexGeneration: string;
+  mode: DocsContentChangesResponse["mode"];
+  resetRequired: boolean;
+  documentCount: number;
+  counts: DocsContentChangesResponse["counts"];
+  budget: DocsContentChangeHydrationBudget;
+  resultCount: number;
+  total: number;
+  hasMore: boolean;
+  nextCursor?: string;
+  content: DocsContentChangeHydrationContent[];
+  tombstones: DocsContentChangeHydrationTombstone[];
+}
+interface HydrateDocsContentChangesOptions {
+  changes: DocsContentChangesResponse;
+  pages: readonly DocsSearchSourcePage[];
+  since: string;
+  tokenBudget?: number;
+  cursor?: string;
+  /** Stable MCP server identity mixed into opaque continuation cursors. */
+  cursorScope: string;
+}
+/**
+ * Hydrate only the current bodies named by a content-change delta.
+ *
+ * The conservative budget treats one UTF-8 byte as at most one token. Cursors are
+ * bound to the requested generation, current generation, locale, and budget.
+ */
+declare function hydrateDocsContentChanges(options: HydrateDocsContentChangesOptions): DocsContentChangeHydrationResponse;
+//#endregion
 //#region src/mcp-auth.d.ts
 declare const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
 declare const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
@@ -1195,6 +1279,7 @@ declare function buildDocsAgentDiscoverySpec({
       searchDocs: boolean;
       searchFacets?: boolean;
       listContentChanges?: boolean;
+      hydrateContentChanges?: boolean;
       getNavigation: boolean;
       getCodeExamples: boolean;
       getConfigSchema: boolean;
@@ -1219,4 +1304,4 @@ declare function buildDocsAgentDiscoverySpec({
 declare function acceptsDocsMarkdown(request: Request): boolean;
 declare function resolveDocsOpenApiDiscoveryConfig(openapi?: boolean | DocsOpenApiDiscoveryConfig): DocsOpenApiResolvedDiscoveryConfig;
 //#endregion
-export { DocsMarkdownPage as $, enrichDocsSearchDocumentsWithProvenance as $n, resolveDocsLlmsTxtRequest as $t, DocsAgentFeedbackDiscoveryConfig as A, createDocsContentChangesHttpResponse as An, hasDocsMarkdownSignatureAgent as At, DocsDiagnosticsIssueSeverity as B, DocsSearchRequestResolutionOptions as Bn, normalizeDocsPathSegment as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, DOCS_CONTENT_SNAPSHOT_FORMAT as Cn, ResolvedDocsI18n as Cr, createDocsMarkdownResponse as Ct, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as D, DocsResolvedContentChangesConfig as Dn, getDocsLlmsTxtMaxCharsIssue as Dt, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as E, DocsContentChangesRequestError as En, resolveDocsPath as Er, findDocsMarkdownPage as Et, DocsConfigMapJsonValue as F, BuildDocsContentSnapshotOptions as Fn, isDocsLlmsTxtPublicRequest as Ft, DocsLlmsTxtGeneratedSection as G, buildDocsRetrievalDigestProjection as Gn, renderDocsMarkdownDocument as Gt, DocsDiagnosticsStatus as H, PerformDocsSearchOptions as Hn, parseDocsAgentFeedbackData as Ht, DocsConfigMapPointer as I, BuildDocsSearchFacetsOptions as In, isDocsMarkdownSectionIndexRequest as It, DocsLlmsTxtRequest as J, createAlgoliaSearchAdapter as Jn, resolveDocsAgentContractMcpTools as Jt, DocsLlmsTxtMaxCharsIssue as K, buildDocsSearchDocuments as Kn, renderDocsMarkdownNotFound as Kt, DocsDiagnostics as L, DocsLocalMcpSearchRuntimeConfig as Ln, isDocsPublicGetRequest as Lt, DocsAgentFeedbackResolvedConfig as M, isDocsContentChangesRequest as Mn, isDocsAgentsRequest as Mt, DocsAgentsDocumentOptions as N, resolveDocsContentChangesConfig as Nn, isDocsConfigRequest as Nt, DocsAgentContractMcpTools as O, ResolveDocsContentChangesOptions as On, getDocsMarkdownCanonicalLinkHeader as Ot, DocsConfigMap as P, resolveDocsContentChangesRequest as Pn, isDocsDiagnosticsRequest as Pt, DocsMarkdownAgentDetection as Q, createTypesenseSearchAdapter as Qn, resolveDocsLlmsTxtFormat as Qt, DocsDiagnosticsFeature as R, DocsLocalMcpSearchRuntimeInput as Rn, isDocsSkillRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Sn, DocsPathMatch as Sr, collectDocsMarkdownSections as St, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as T, DocsContentChangesRequest as Tn, resolveDocsLocale as Tr, detectDocsMarkdownAgentRequest as Tt, DocsLlmsDiscoveryConfig as U, buildDocsAskAIContext as Un, renderDocsAgentsDocument as Ut, DocsDiagnosticsOptions as V, EnrichDocsSearchDocumentsWithProvenanceOptions as Vn, normalizeDocsUrlPath as Vt, DocsLlmsTxtGeneratedContent as W, buildDocsContentSnapshot as Wn, renderDocsLlmsTxt as Wt, DocsLlmsTxtResolvedSection as X, createMcpSearchAdapter as Xn, resolveDocsAgentFeedbackRequest as Xt, DocsLlmsTxtResolvedMaxChars as Y, createCustomSearchAdapter as Yn, resolveDocsAgentFeedbackConfig as Yt, DocsLlmsTxtSelectedContent as Z, createSimpleSearchAdapter as Zn, resolveDocsAgentsFormat as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, getDocsMcpProtectedResourceMetadataRoutes as _n, extractDocsMarkdownPromptBlocks as _r, buildDocsAgentFeedbackSchema as _t, DEFAULT_AGENT_MD_ROUTE as a, resolveDocsOpenApiDiscoveryConfig as an, resolveAskAISearchRequestConfig as ar, DocsMarkdownSectionIndexOptions as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, isDocsMcpRequest as bn, resolveDocsAudienceExposure as br, buildDocsMarkdownSectionIndex as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, selectDocsLlmsTxtContent as cn, resolveDocsSearchError as cr, DocsMarkdownSectionResult as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, validateDocsAgentFeedbackPayload as dn, resolveLocalDocsMcpSearchConfig as dr, DocsOpenApiDiscoveryConfig as dt, resolveDocsLlmsTxtSections as en, formatDocsAskAIPackageHints as er, DocsMarkdownRecoveryMatch as et, DEFAULT_DOCS_CONFIG_ROUTE as f, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as fn, resolveSearchRequestConfig as fr, DocsOpenApiResolvedDiscoveryConfig as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, buildDocsMcpProtectedResourceMetadataRoute as gn, ExtractedDocsMarkdownPromptBlocks as gr, buildDocsAgentDiscoverySpec as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, DEFAULT_MCP_WELL_KNOWN_ROUTE as hn, DocsMarkdownPromptBlock as hr, acceptsDocsMarkdown as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, resolveDocsMarkdownSectionRequest as in, performDocsSearchWithMetadata as ir, DocsMarkdownSectionIndex as it, DocsAgentFeedbackRequest as j, isDocsContentChangeGeneration as jn, isDocsAgentDiscoveryRequest as jt, DocsAgentDiscoverySpecOptions as k, createDocsContentChangeFeed as kn, getDocsMarkdownVaryHeader as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, selectDocsMarkdownSection as ln, resolveDocsSearchFilters as lr, DocsMcpEndpointCandidate as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, DEFAULT_MCP_ROUTE as mn, DocsContentAudience as mr, DocsStandardsDiscoveryResponseOptions as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, resolveDocsMarkdownRecovery as nn, normalizeDocsSearchFilters as nr, DocsMarkdownResponseOptions as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, resolveDocsRequestApiRoute as on, resolveDocsRetrievalLastModified as or, DocsMarkdownSectionMetadata as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, DEFAULT_MCP_PUBLIC_ROUTE as pn, DocsAudienceMdxIssue as pr, DocsSkillDocumentOptions as pt, DocsLlmsTxtPageInput as q, buildDocsSearchFacets as qn, renderDocsSkillDocument as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, resolveDocsMarkdownRequest as rn, performDocsSearch as rr, DocsMarkdownSection as rt, DEFAULT_AGENT_SPEC_ROUTE as s, resolveDocsSkillFormat as sn, resolveDocsSearchAudience as sr, DocsMarkdownSectionRequest as st, DEFAULT_AGENTS_MD_ROUTE as t, resolveDocsMarkdownCanonicalUrl as tn, inferDocsAskAIPackageHints as tr, DocsMarkdownRecoveryResult as tt, DEFAULT_DOCS_API_ROUTE as u, toDocsMarkdownUrl as un, resolveDocsSearchRequest as ur, DocsMcpEndpointCandidateOptions as ut, DEFAULT_LLMS_TXT_ROUTE as v, getDocsMcpResourcePaths as vn, findDocsAudienceMdxIssues as vr, buildDocsConfigMap as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, DocsContentChangeFeed as wn, resolveDocsI18n as wr, createDocsStandardsDiscoveryResponse as wt, DEFAULT_SKILL_MD_ROUTE as x, DOCS_CONTENT_CHANGES_FORMAT as xn, resolveDocsAudienceMdxContent as xr, buildDocsMcpEndpointCandidates as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, hasDocsMcpProtectedResourceConfig as yn, resolveDocsAgentMdxContent as yr, buildDocsDiagnostics as yt, DocsDiagnosticsIssue as z, DocsSearchRequestError as zn, matchesDocsLlmsTxtSection as zt };
+export { DocsMarkdownPage as $, PerformDocsSearchOptions as $n, resolveDocsLlmsTxtRequest as $t, DocsAgentFeedbackDiscoveryConfig as A, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as An, resolveDocsAgentMdxContent as Ar, hasDocsMarkdownSignatureAgent as At, DocsDiagnosticsIssueSeverity as B, createDocsContentChangeFeed as Bn, normalizeDocsPathSegment as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, DocsContentChangeHydrationBudget as Cn, resolveSearchRequestConfig as Cr, createDocsMarkdownResponse as Ct, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as D, DocsContentChangeHydrationTombstone as Dn, ExtractedDocsMarkdownPromptBlocks as Dr, getDocsLlmsTxtMaxCharsIssue as Dt, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as E, DocsContentChangeHydrationSection as En, DocsMarkdownPromptBlock as Er, findDocsMarkdownPage as Et, DocsConfigMapJsonValue as F, DocsContentChangeFeed as Fn, resolveDocsI18n as Fr, isDocsLlmsTxtPublicRequest as Ft, DocsLlmsTxtGeneratedSection as G, resolveDocsContentChangesRequest as Gn, renderDocsMarkdownDocument as Gt, DocsDiagnosticsStatus as H, isDocsContentChangeGeneration as Hn, parseDocsAgentFeedbackData as Ht, DocsConfigMapPointer as I, DocsContentChangesRequest as In, resolveDocsLocale as Ir, isDocsMarkdownSectionIndexRequest as It, DocsLlmsTxtRequest as J, DocsLocalMcpSearchRuntimeConfig as Jn, resolveDocsAgentContractMcpTools as Jt, DocsLlmsTxtMaxCharsIssue as K, BuildDocsContentSnapshotOptions as Kn, renderDocsMarkdownNotFound as Kt, DocsDiagnostics as L, DocsContentChangesRequestError as Ln, resolveDocsPath as Lr, isDocsPublicGetRequest as Lt, DocsAgentFeedbackResolvedConfig as M, DOCS_CONTENT_CHANGES_FORMAT as Mn, resolveDocsAudienceMdxContent as Mr, isDocsAgentsRequest as Mt, DocsAgentsDocumentOptions as N, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Nn, DocsPathMatch as Nr, isDocsConfigRequest as Nt, DocsAgentContractMcpTools as O, HydrateDocsContentChangesOptions as On, extractDocsMarkdownPromptBlocks as Or, getDocsMarkdownCanonicalLinkHeader as Ot, DocsConfigMap as P, DOCS_CONTENT_SNAPSHOT_FORMAT as Pn, ResolvedDocsI18n as Pr, isDocsDiagnosticsRequest as Pt, DocsMarkdownAgentDetection as Q, EnrichDocsSearchDocumentsWithProvenanceOptions as Qn, resolveDocsLlmsTxtFormat as Qt, DocsDiagnosticsFeature as R, DocsResolvedContentChangesConfig as Rn, isDocsSkillRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT as Sn, resolveLocalDocsMcpSearchConfig as Sr, collectDocsMarkdownSections as St, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as T, DocsContentChangeHydrationResponse as Tn, DocsContentAudience as Tr, detectDocsMarkdownAgentRequest as Tt, DocsLlmsDiscoveryConfig as U, isDocsContentChangesRequest as Un, renderDocsAgentsDocument as Ut, DocsDiagnosticsOptions as V, createDocsContentChangesHttpResponse as Vn, normalizeDocsUrlPath as Vt, DocsLlmsTxtGeneratedContent as W, resolveDocsContentChangesConfig as Wn, renderDocsLlmsTxt as Wt, DocsLlmsTxtResolvedSection as X, DocsSearchRequestError as Xn, resolveDocsAgentFeedbackRequest as Xt, DocsLlmsTxtResolvedMaxChars as Y, DocsLocalMcpSearchRuntimeInput as Yn, resolveDocsAgentFeedbackConfig as Yt, DocsLlmsTxtSelectedContent as Z, DocsSearchRequestResolutionOptions as Zn, resolveDocsAgentsFormat as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, getDocsMcpProtectedResourceMetadataRoutes as _n, resolveDocsRetrievalLastModified as _r, buildDocsAgentFeedbackSchema as _t, DEFAULT_AGENT_MD_ROUTE as a, resolveDocsOpenApiDiscoveryConfig as an, createAlgoliaSearchAdapter as ar, DocsMarkdownSectionIndexOptions as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, isDocsMcpRequest as bn, resolveDocsSearchFilters as br, buildDocsMarkdownSectionIndex as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, selectDocsLlmsTxtContent as cn, createSimpleSearchAdapter as cr, DocsMarkdownSectionResult as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, validateDocsAgentFeedbackPayload as dn, formatDocsAskAIPackageHints as dr, DocsOpenApiDiscoveryConfig as dt, resolveDocsLlmsTxtSections as en, buildDocsAskAIContext as er, DocsMarkdownRecoveryMatch as et, DEFAULT_DOCS_CONFIG_ROUTE as f, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as fn, inferDocsAskAIPackageHints as fr, DocsOpenApiResolvedDiscoveryConfig as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, buildDocsMcpProtectedResourceMetadataRoute as gn, resolveAskAISearchRequestConfig as gr, buildDocsAgentDiscoverySpec as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, DEFAULT_MCP_WELL_KNOWN_ROUTE as hn, performDocsSearchWithMetadata as hr, acceptsDocsMarkdown as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, resolveDocsMarkdownSectionRequest as in, buildDocsSearchFacets as ir, DocsMarkdownSectionIndex as it, DocsAgentFeedbackRequest as j, hydrateDocsContentChanges as jn, resolveDocsAudienceExposure as jr, isDocsAgentDiscoveryRequest as jt, DocsAgentDiscoverySpecOptions as k, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as kn, findDocsAudienceMdxIssues as kr, getDocsMarkdownVaryHeader as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, selectDocsMarkdownSection as ln, createTypesenseSearchAdapter as lr, DocsMcpEndpointCandidate as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, DEFAULT_MCP_ROUTE as mn, performDocsSearch as mr, DocsStandardsDiscoveryResponseOptions as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, resolveDocsMarkdownRecovery as nn, buildDocsRetrievalDigestProjection as nr, DocsMarkdownResponseOptions as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, resolveDocsRequestApiRoute as on, createCustomSearchAdapter as or, DocsMarkdownSectionMetadata as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, DEFAULT_MCP_PUBLIC_ROUTE as pn, normalizeDocsSearchFilters as pr, DocsSkillDocumentOptions as pt, DocsLlmsTxtPageInput as q, BuildDocsSearchFacetsOptions as qn, renderDocsSkillDocument as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, resolveDocsMarkdownRequest as rn, buildDocsSearchDocuments as rr, DocsMarkdownSection as rt, DEFAULT_AGENT_SPEC_ROUTE as s, resolveDocsSkillFormat as sn, createMcpSearchAdapter as sr, DocsMarkdownSectionRequest as st, DEFAULT_AGENTS_MD_ROUTE as t, resolveDocsMarkdownCanonicalUrl as tn, buildDocsContentSnapshot as tr, DocsMarkdownRecoveryResult as tt, DEFAULT_DOCS_API_ROUTE as u, toDocsMarkdownUrl as un, enrichDocsSearchDocumentsWithProvenance as ur, DocsMcpEndpointCandidateOptions as ut, DEFAULT_LLMS_TXT_ROUTE as v, getDocsMcpResourcePaths as vn, resolveDocsSearchAudience as vr, buildDocsConfigMap as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, DocsContentChangeHydrationContent as wn, DocsAudienceMdxIssue as wr, createDocsStandardsDiscoveryResponse as wt, DEFAULT_SKILL_MD_ROUTE as x, DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as xn, resolveDocsSearchRequest as xr, buildDocsMcpEndpointCandidates as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, hasDocsMcpProtectedResourceConfig as yn, resolveDocsSearchError as yr, buildDocsDiagnostics as yt, DocsDiagnosticsIssue as z, ResolveDocsContentChangesOptions as zn, matchesDocsLlmsTxtSection as zt };

package/dist/{agent-evals-DvQQtN62.mjs → agent-evals-Burrzyam.mjs}

@@ -1,7 +1,8 @@
-import { An as normalizeAgentFramework, Dn as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentScopeValues, Nn as normalizeAgentVersion, On as agentVersionConstraintMatches, Zt as buildDocsAskAIContext, bn as resolveSearchRequestConfig, dn as performDocsSearch, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, un as normalizeDocsSearchFilters } from "./agent-Cj50nyeV.mjs";
+import { An as normalizeAgentFramework, Dn as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentScopeValues, Nn as normalizeAgentVersion, On as agentVersionConstraintMatches, Zt as buildDocsAskAIContext, bn as resolveSearchRequestConfig, dn as performDocsSearch, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, un as normalizeDocsSearchFilters } from "./agent-Dze2Cy5B.mjs";
 import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.mjs";
+import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-D5qYU19g.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 { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-0wjOsqdJ.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { createJiti } from "jiti";
@@ -27,7 +28,8 @@ const DEFAULT_REVIEW_RULES = {
 	relatedCoverage: "suggestion",
 	configConfidence: "warn",
 	agentSurfaceDrift: "error",
-	goldenTasks: "warn"
+	goldenTasks: "warn",
+	agentSkills: "warn"
 };
 const DEFAULT_REVIEW_WEIGHTS = {
 	error: 20,
@@ -228,10 +230,23 @@ function buildDocsReviewWorkflowPathFilters(options) {
 		prefixPath(projectPrefix, "src/content/docs/**"),
 		prefixPath(projectPrefix, "src/lib/docs.config.*"),
 		DEFAULT_DOCS_REVIEW_WORKFLOW_PATH,
-		DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW_PATH
+		DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW_PATH,
+		...buildAgentSkillPathFilters({
+			rootDir: options.rootDir,
+			repoRoot,
+			skills: options.config?.agent?.skills
+		})
 	];
 	return Array.from(new Set(candidates.filter((candidate) => Boolean(candidate))));
 }
+function buildAgentSkillPathFilters(options) {
+	return getDocsAgentSkillsConfiguredPaths(options.skills).map((configuredPath) => {
+		const absolutePath = isAbsolute(configuredPath) ? configuredPath : join(options.rootDir, configuredPath);
+		const repoRelative = toPosixPath(relative(options.repoRoot, absolutePath));
+		if (!repoRelative || repoRelative.startsWith("../")) return void 0;
+		return repoRelative.endsWith("/SKILL.md") || repoRelative === "SKILL.md" ? repoRelative : `${repoRelative.replace(/\/+$/u, "")}/**`;
+	}).filter((candidate) => Boolean(candidate));
+}
 function normalizeRules(rules) {
 	if (!rules) return {};
 	const knownRules = new Set(Object.keys(DEFAULT_REVIEW_RULES));

package/dist/{agent-export-BISSb83U.mjs → agent-export-whKAZQUI.mjs}

@@ -1,21 +1,21 @@
-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-Cj50nyeV.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, 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-Dze2Cy5B.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-BKlEnK_H.mjs";
-import "./agent-provenance-C_jgqNTW.mjs";
+import "./content-change-hydration-DpQ0KdAD.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-BukukxNm.mjs";
-import "./sitemap-server-DzlV1NOB.mjs";
-import "./agent-evals-DvQQtN62.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-D96X6eVX.mjs";
+import "./sitemap-server-BefXEox6.mjs";
+import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-D5qYU19g.mjs";
+import "./agent-evals-Burrzyam.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.mjs";
+import "./code-blocks-0wjOsqdJ.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-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
-import { execFileSync } from "node:child_process";
 import { createHash, randomUUID } from "node:crypto";
+import { execFileSync } from "node:child_process";
 import pc from "picocolors";
 
 //#region src/cli/agent-export.ts

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

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

package/dist/{agent-skills-server-B2EXn2QD.mjs → agent-skills-server-D5qYU19g.mjs}

@@ -47,7 +47,7 @@ async function findWorkspaceRootAsync(rootDir) {
 		current = parent;
 	}
 }
-function normalizeConfiguredPaths(input) {
+function getDocsAgentSkillsConfiguredPaths(input) {
 	if (!input) return [];
 	const value = typeof input === "string" || Array.isArray(input) ? input : input.paths;
 	return (typeof value === "string" ? [value] : [...value]).map((candidate) => candidate.trim()).filter(Boolean);
@@ -390,9 +390,14 @@ function validateAndSortSkills(published) {
 	}
 	return published.sort((left, right) => left.name.localeCompare(right.name));
 }
-/** Resolve and safely package all project skills configured through `agent.skills` synchronously. */
-function resolveConfiguredAgentSkillsSync(input, options = {}) {
-	const configuredPaths = normalizeConfiguredPaths(input);
+/**
+* Resolve configured SKILL.md files without parsing or packaging their contents.
+*
+* Diagnostics use this path-only form so broken references and invalid frontmatter
+* can be reported independently instead of publication failing at the first skill.
+*/
+function resolveConfiguredAgentSkillPathsSync(input, options = {}) {
+	const configuredPaths = getDocsAgentSkillsConfiguredPaths(input);
 	if (configuredPaths.length === 0) return [];
 	const rootDir = realpathSync(options.rootDir ?? process.cwd());
 	const workspaceRoot = realpathSync(options.workspaceRoot ?? findWorkspaceRoot(rootDir));
@@ -400,11 +405,15 @@ function resolveConfiguredAgentSkillsSync(input, options = {}) {
 	const documents = /* @__PURE__ */ new Set();
 	const visited = /* @__PURE__ */ new Set();
 	for (const configuredPath of configuredPaths) collectSkillDocuments(resolveSafeConfiguredPath(configuredPath, rootDir, workspaceRoot), workspaceRoot, documents, visited);
-	return validateAndSortSkills([...documents].sort().map(publishSkillDocumentSync));
+	return [...documents].sort();
+}
+/** Resolve and safely package all project skills configured through `agent.skills` synchronously. */
+function resolveConfiguredAgentSkillsSync(input, options = {}) {
+	return validateAndSortSkills(resolveConfiguredAgentSkillPathsSync(input, options).map(publishSkillDocumentSync));
 }
 /** Resolve and package configured skills without blocking runtime filesystem or compression work. */
 async function resolveConfiguredAgentSkills(input, options = {}) {
-	const configuredPaths = normalizeConfiguredPaths(input);
+	const configuredPaths = getDocsAgentSkillsConfiguredPaths(input);
 	if (configuredPaths.length === 0) return [];
 	const rootDir = await realpath(options.rootDir ?? process.cwd());
 	const workspaceRoot = options.workspaceRoot === void 0 ? await findWorkspaceRootAsync(rootDir) : await realpath(options.workspaceRoot);
@@ -416,4 +425,4 @@ async function resolveConfiguredAgentSkills(input, options = {}) {
 }
 
 //#endregion
-export { resolveConfiguredAgentSkillsSync as n, resolveConfiguredAgentSkills as t };
+export { resolveConfiguredAgentSkillsSync as i, resolveConfiguredAgentSkillPathsSync as n, resolveConfiguredAgentSkills as r, getDocsAgentSkillsConfiguredPaths as t };

package/dist/{agent-skills-server-Daq-FOay.d.mts → agent-skills-server-q4B9kRGg.d.mts}

@@ -1,5 +1,5 @@
-import { et as DocsAgentSkillsInput } from "./types-o-ULHPK6.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-C2cUIQzW.mjs";
+import { tt as DocsAgentSkillsInput } from "./types-lGEHcx_6.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-DPUEcUmb.mjs";
 
 //#region src/agent-skills-server.d.ts
 interface ResolveConfiguredAgentSkillsOptions {

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

@@ -1,6 +1,6 @@
-import { et as DocsAgentSkillsInput } from "./types-o-ULHPK6.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-C2cUIQzW.mjs";
-import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-Daq-FOay.mjs";
+import { tt as DocsAgentSkillsInput } from "./types-lGEHcx_6.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-DPUEcUmb.mjs";
+import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-q4B9kRGg.mjs";
 
 //#region src/agent-skills-vite.d.ts
 declare const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";

package/dist/agent-skills-vite.mjs

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

package/dist/{agents-DLNUgcgU.mjs → agents-B_980VCs.mjs}

@@ -1,12 +1,12 @@
-import { a as DEFAULT_AGENT_MD_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-Cj50nyeV.mjs";
+import { a as DEFAULT_AGENT_MD_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-Dze2Cy5B.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
 import "./standards-discovery-BKlEnK_H.mjs";
-import "./agent-provenance-C_jgqNTW.mjs";
-import { C as resolveApiReferenceOpenApiDiscovery } from "./sitemap-server-DzlV1NOB.mjs";
-import "./agent-evals-DvQQtN62.mjs";
+import "./content-change-hydration-DpQ0KdAD.mjs";
+import { C as resolveApiReferenceOpenApiDiscovery } from "./sitemap-server-BefXEox6.mjs";
+import "./agent-skills-server-D5qYU19g.mjs";
+import "./agent-evals-Burrzyam.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-B2EXn2QD.mjs";
+import "./code-blocks-0wjOsqdJ.mjs";
 import "./server.mjs";
 import { a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";

package/dist/cli/index.mjs

@@ -141,10 +141,10 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-BU63wzaM.mjs");
+		const { runMcp } = await import("../mcp-bhIsgqxy.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-aWl_O6xn.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-Biyd8A98.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -152,7 +152,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-BISSb83U.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-whKAZQUI.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -162,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-aWl_O6xn.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-BISSb83U.mjs");
+		const { printAgentCompactHelp } = await import("../agent-Biyd8A98.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-whKAZQUI.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-DLNUgcgU.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-B_980VCs.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -178,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-DLNUgcgU.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-B_980VCs.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-BxP-UHaE.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-WjuyRWYT.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -190,7 +190,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-D14mUw5D.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-2e4TXoGS.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -198,7 +198,7 @@ async function main() {
 		}
 		await runReview(reviewOptions);
 	} else if ((parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") && subcommand === "validate") {
-		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-CFuurVIH.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-CPA6Ae5r.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -208,11 +208,11 @@ async function main() {
 	} else if (parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") {
 		console.error(pc.red(`Unknown codeblocks subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCodeBlocksValidateHelp } = await import("../codeblocks-CFuurVIH.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-CPA6Ae5r.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-DP96dV3e.mjs");
+		const { syncSearch } = await import("../search-DfB3LQ4s.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -220,7 +220,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-DuosRvmn.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-AcwP8jIo.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -230,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-DuosRvmn.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-AcwP8jIo.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DmczzidR.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-BIySk2gE.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -244,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-DmczzidR.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-BIySk2gE.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {

package/dist/client/react.d.mts

@@ -1,4 +1,4 @@
-import { it as DocsAnalyticsConfig } from "../types-o-ULHPK6.mjs";
+import { ot as DocsAnalyticsConfig } from "../types-lGEHcx_6.mjs";
 import { ReactNode } from "react";
 
 //#region src/docs-cloud-client.d.ts

package/dist/{cloud-ask-ai-o41WfOTk.d.mts → cloud-ask-ai-BQAeHkpZ.d.mts}

@@ -1,4 +1,4 @@
-import { it as DocsAnalyticsConfig, t as AIConfig, vt as DocsCloudConfig } from "./types-o-ULHPK6.mjs";
+import { bt as DocsCloudConfig, ot as DocsAnalyticsConfig, t as AIConfig } from "./types-lGEHcx_6.mjs";
 
 //#region src/cloud-ask-ai.d.ts
 interface DocsCloudAskAIConfig {

package/dist/{codeblocks-CFuurVIH.mjs → codeblocks-CPA6Ae5r.mjs}

@@ -1,4 +1,4 @@
-import { a as validateCodeBlocks, r as resolveDocsCodeBlocksValidateConfig } from "./code-blocks-DnNVNK2M.mjs";
+import { a as validateCodeBlocks, r as resolveDocsCodeBlocksValidateConfig } from "./code-blocks-0wjOsqdJ.mjs";
 import { _ as resolveDocsContentDir, a as loadDocsConfigModule, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import pc from "picocolors";