@farming-labs/docs 0.2.80 → 0.2.82

package/dist/mcp.d.mts

@@ -1,6 +1,6 @@
-import { Bn as DocsTelemetryConfig, F as DocsAgentContentChangesConfig, Fn as DocsSearchSourcePage, Gn as DocsTelemetryFramework, Ht as DocsMcpAllowedOrigins, Ut as DocsMcpAuthPrincipal, Wt as DocsMcpAuthenticate, it as DocsAnalyticsConfig, lr as OrderingItem, mr as PageAgentFrontmatter, on as DocsRetrievalSourceProvenance, qt as DocsMcpConfig, tn as DocsObservabilityConfig, xn as DocsSearchConfig } from "./types-o-ULHPK6.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-C2cUIQzW.mjs";
-import { it as DocsMarkdownSectionIndex, wn as DocsContentChangeFeed } from "./agent-DGALg9hQ.mjs";
+import { Cn as DocsSearchConfig, F as DocsAgentContentChangesConfig, Gt as DocsMcpAuthPrincipal, Hn as DocsTelemetryConfig, Kt as DocsMcpAuthenticate, Ln as DocsSearchSourcePage, Wt as DocsMcpAllowedOrigins, Yt as DocsMcpConfig, cn as DocsRetrievalSourceProvenance, dr as OrderingItem, gr as PageAgentFrontmatter, ot as DocsAnalyticsConfig, qn as DocsTelemetryFramework, rn as DocsObservabilityConfig } from "./types-lGEHcx_6.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-DPUEcUmb.mjs";
+import { An as MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, Cn as DocsContentChangeHydrationBudget, Dn as DocsContentChangeHydrationTombstone, En as DocsContentChangeHydrationSection, Fn as DocsContentChangeFeed, On as HydrateDocsContentChangesOptions, Sn as DOCS_CONTENT_CHANGE_HYDRATION_FORMAT, Tn as DocsContentChangeHydrationResponse, it as DocsMarkdownSectionIndex, jn as hydrateDocsContentChanges, kn as MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, wn as DocsContentChangeHydrationContent, xn as DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET } from "./agent-WS4GXGh6.mjs";
 import { McpServer } from "@modelcontextprotocol/server";
 
 //#region src/mcp.d.ts
@@ -273,7 +273,8 @@ interface DocsMcpResolvedConfig {
     readTask?: boolean;
     searchDocs: boolean; /** Optional so manually constructed resolved configs from older releases remain assignable. */
     searchFacets?: boolean; /** Optional so manually constructed resolved configs from older releases remain assignable. */
-    listContentChanges?: boolean;
+    listContentChanges?: boolean; /** Optional so manually constructed resolved configs from older releases remain assignable. */
+    hydrateContentChanges?: boolean;
     getNavigation: boolean;
     getCodeExamples: boolean;
     getConfigSchema: boolean;
@@ -349,4 +350,4 @@ declare function getDocsConfigSchema(filters?: {
 }): DocsMcpConfigSchema;
 declare function buildDocsMcpContext(options: DocsMcpContextOptions): Promise<DocsMcpContextResult>;
 //#endregion
-export { CreateDocsMcpServerOptions, DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DOCS_MCP_CONTENT_CHANGES_CURRENT_URI, DOCS_MCP_CONTENT_CHANGES_URI_TEMPLATE, DocsMcpAgentContractSummary, DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpContextOptions, DocsMcpContextResult, DocsMcpContextSource, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpFolderNode, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpPageNode, DocsMcpPageSectionIndex, DocsMcpPageSectionList, DocsMcpPaginatedDocsList, DocsMcpPagination, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedProtectedResourceConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, buildDocsMcpContext, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };
+export { CreateDocsMcpServerOptions, DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT, DOCS_MCP_CONTENT_CHANGES_CURRENT_URI, DOCS_MCP_CONTENT_CHANGES_URI_TEMPLATE, type DocsContentChangeHydrationBudget, type DocsContentChangeHydrationContent, type DocsContentChangeHydrationResponse, type DocsContentChangeHydrationSection, type DocsContentChangeHydrationTombstone, DocsMcpAgentContractSummary, DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpContextOptions, DocsMcpContextResult, DocsMcpContextSource, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpFolderNode, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpPageNode, DocsMcpPageSectionIndex, DocsMcpPageSectionList, DocsMcpPaginatedDocsList, DocsMcpPagination, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedProtectedResourceConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, type HydrateDocsContentChangesOptions, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, buildDocsMcpContext, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, hydrateDocsContentChanges, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };

package/dist/mcp.mjs

@@ -1,8 +1,8 @@
 import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
-import { $n as normalizeDocsMcpEndpointPath, An as normalizeAgentFramework, E as DOCS_MARKDOWN_SECTION_INDEX_FORMAT, En as resolveDocsAudienceMdxContent, Fn as paginateDocsItems, Jn as isDocsMcpOAuthScopeToken, Jt as resolveDocsContentChangesConfig, Kt as isDocsContentChangeGeneration, Ln as isDocsRetrievalCanonicalUrl, Mn as normalizeAgentScopeValues, On as agentVersionConstraintMatches, P as buildDocsMarkdownSectionIndex, Pn as DocsPaginationCursorError, Qn as normalizeDocsMcpAuthorizationServerUrls, Rn as normalizeDocsRelated, Ut as DocsContentChangesRequestError, Wt as createDocsContentChangeFeed, Yn as isDocsMcpProtectedResourceMetadataPath, Zn as isDocsMcpResourcePath, dn as performDocsSearch, er as resolveDocsMcpProtectedResourceMetadataLocation, fn as performDocsSearchWithMetadata, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, tn as buildDocsSearchFacets, tr as resolveDocsMcpResourceLocation, un as normalizeDocsSearchFilters, wt as toDocsMarkdownUrl, yn as resolveLocalDocsMcpSearchConfig, zn as renderDocsRelatedMarkdownLines } from "./agent-Cj50nyeV.mjs";
+import { $n as isDocsMcpResourcePath, An as normalizeAgentFramework, Bn as normalizeDocsRelated, E as DOCS_MARKDOWN_SECTION_INDEX_FORMAT, En as resolveDocsAudienceMdxContent, In as paginateDocsItems, Jt as resolveDocsContentChangesConfig, Kt as isDocsContentChangeGeneration, Mn as normalizeAgentScopeValues, On as agentVersionConstraintMatches, P as buildDocsMarkdownSectionIndex, Pn as DocsPaginationCursorError, Ut as DocsContentChangesRequestError, Vn as renderDocsRelatedMarkdownLines, Wt as createDocsContentChangeFeed, Xn as isDocsMcpOAuthScopeToken, Zn as isDocsMcpProtectedResourceMetadataPath, dn as performDocsSearch, er as normalizeDocsMcpAuthorizationServerUrls, fn as performDocsSearchWithMetadata, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, nr as resolveDocsMcpProtectedResourceMetadataLocation, rr as resolveDocsMcpResourceLocation, tn as buildDocsSearchFacets, tr as normalizeDocsMcpEndpointPath, un as normalizeDocsSearchFilters, wt as toDocsMarkdownUrl, yn as resolveLocalDocsMcpSearchConfig, zn as isDocsRetrievalCanonicalUrl } from "./agent-Dze2Cy5B.mjs";
 import { S as upsertPageAgentContractMarkdown, _ as hasStructuredPageAgentContract, o as findDocsMarkdownSection, s as parseDocsMarkdownSections, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
 import "./standards-discovery-BKlEnK_H.mjs";
-import { f as emitDocsTelemetryAgentSurfaceEvent, h as emitDocsTelemetryProjectEvent, l as resolvePageSidebarFolderIndexBehavior, m as emitDocsTelemetryMcpToolEvent, s as stripGeneratedAgentProvenance } from "./agent-provenance-C_jgqNTW.mjs";
+import { _ as emitDocsTelemetryAgentSurfaceEvent, a as hydrateDocsContentChanges, b as emitDocsTelemetryProjectEvent, f as stripGeneratedAgentProvenance, i as MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, m as resolvePageSidebarFolderIndexBehavior, n as DOCS_CONTENT_CHANGE_HYDRATION_FORMAT, r as MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, t as DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, y as emitDocsTelemetryMcpToolEvent } from "./content-change-hydration-DpQ0KdAD.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
 import path from "node:path";
@@ -269,17 +269,68 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 				name: "skills",
 				type: "string | readonly string[] | DocsAgentSkillsConfig",
 				description: "Project skill files or collection directories published through discovery, static export, and MCP.",
-				children: [{
-					path: "agent.skills.paths",
-					name: "paths",
-					type: "string | readonly string[]",
-					description: "Workspace-contained SKILL.md file, skill directory, or collection directory paths."
-				}, {
-					path: "agent.skills.paths[]",
-					name: "path",
-					type: "string",
-					description: "One workspace-contained Agent Skill path."
-				}]
+				children: [
+					{
+						path: "agent.skills.paths",
+						name: "paths",
+						type: "string | readonly string[]",
+						description: "Workspace-contained SKILL.md file, skill directory, or collection directory paths."
+					},
+					{
+						path: "agent.skills.paths[]",
+						name: "path",
+						type: "string",
+						description: "One workspace-contained Agent Skill path."
+					},
+					{
+						path: "agent.skills.progressiveDisclosure",
+						name: "progressiveDisclosure",
+						type: "DocsAgentSkillsProgressiveDisclosureConfig",
+						description: "Thresholds used by doctor and review to keep SKILL.md instructions compact, references shallow, and scripts documented.",
+						children: [
+							{
+								path: "agent.skills.progressiveDisclosure.maxSkillLines",
+								name: "maxSkillLines",
+								type: "number",
+								default: 500,
+								description: "Maximum recommended line count for the complete SKILL.md document."
+							},
+							{
+								path: "agent.skills.progressiveDisclosure.instructionTokenBudget",
+								name: "instructionTokenBudget",
+								type: "number",
+								default: 5e3,
+								description: "Approximate token budget for SKILL.md instructions after frontmatter."
+							},
+							{
+								path: "agent.skills.progressiveDisclosure.maxReferenceDepth",
+								name: "maxReferenceDepth",
+								type: "number",
+								default: 1,
+								description: "Maximum local Markdown reference hops from SKILL.md before doctor and review warn."
+							},
+							{
+								path: "agent.skills.progressiveDisclosure.compatibility",
+								name: "compatibility",
+								type: "\"when-needed\" | \"always\" | \"off\"",
+								default: "when-needed",
+								values: [
+									"when-needed",
+									"always",
+									"off"
+								],
+								description: "Whether compatibility frontmatter is expected only for environment-dependent skills, always, or never."
+							},
+							{
+								path: "agent.skills.progressiveDisclosure.checkScripts",
+								name: "checkScripts",
+								type: "boolean",
+								default: true,
+								description: "Diagnose bundled scripts without dependency and validation guidance."
+							}
+						]
+					}
+				]
 			},
 			{
 				path: "agent.a2a",
@@ -1193,7 +1244,8 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 					["relatedCoverage", "suggestion"],
 					["configConfidence", "warn"],
 					["agentSurfaceDrift", "error"],
-					["goldenTasks", "warn"]
+					["goldenTasks", "warn"],
+					["agentSkills", "warn"]
 				].map(([name, defaultValue]) => ({
 					path: `review.rules.${name}`,
 					name,
@@ -1578,6 +1630,13 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 						default: true,
 						description: "Expose list_content_changes polling and docs://changes resources when agent.contentChanges is enabled."
 					},
+					{
+						path: "mcp.tools.hydrateContentChanges",
+						name: "hydrateContentChanges",
+						type: "boolean",
+						default: true,
+						description: "Expose hydrate_content_changes for budget-aware changed section bodies, deletion tombstones, digests, and continuation cursors."
+					},
 					{
 						path: "mcp.tools.readPage",
 						name: "readPage",
@@ -1894,6 +1953,12 @@ const listContentChangesInputSchema = z.object({
 	since: z.string().refine(isDocsContentChangeGeneration, "Expected a SHA-256 index generation").optional(),
 	locale: z.string().trim().min(1).max(128).optional()
 });
+const hydrateContentChangesInputSchema = z.object({
+	since: z.string().refine(isDocsContentChangeGeneration, "Expected a SHA-256 index generation"),
+	tokenBudget: z.number().int().min(MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET).max(MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET).default(DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET),
+	cursor: paginationCursorInputSchema,
+	locale: z.string().trim().min(1).max(128).optional()
+});
 const getConfigSchemaInputSchema = z.object({
 	option: z.string().trim().min(1).optional(),
 	query: z.string().trim().min(1).optional()
@@ -2032,6 +2097,59 @@ const contentChangesOutputSchema = z.object({
 	})),
 	deleted: z.array(contentChangeDocumentOutputSchema)
 });
+const contentChangeHydrationContentOutputSchema = contentChangeDocumentOutputSchema.extend({
+	type: z.literal("content"),
+	change: z.enum(["added", "changed"]),
+	previousDigest: retrievalSourceDigestOutputSchema.optional(),
+	previousLastModified: z.string().optional(),
+	section: z.object({
+		id: z.string(),
+		heading: z.string(),
+		level: z.number().int().positive()
+	}),
+	sectionDigest: retrievalSourceDigestOutputSchema,
+	chunkDigest: retrievalSourceDigestOutputSchema,
+	chunk: z.object({
+		index: z.number().int().nonnegative(),
+		count: z.number().int().positive()
+	}),
+	content: z.string(),
+	utf8Bytes: z.number().int().nonnegative()
+});
+const contentChangeHydrationTombstoneOutputSchema = contentChangeDocumentOutputSchema.extend({
+	type: z.literal("tombstone"),
+	change: z.literal("deleted")
+});
+const contentChangeHydrationOutputSchema = z.object({
+	format: z.literal(DOCS_CONTENT_CHANGE_HYDRATION_FORMAT),
+	audience: z.literal("agent"),
+	locale: z.string().optional(),
+	since: retrievalSourceDigestOutputSchema,
+	indexGeneration: retrievalSourceDigestOutputSchema,
+	mode: z.enum([
+		"snapshot",
+		"delta",
+		"reset"
+	]),
+	resetRequired: z.boolean(),
+	documentCount: z.number().int().nonnegative(),
+	counts: z.object({
+		added: z.number().int().nonnegative(),
+		changed: z.number().int().nonnegative(),
+		deleted: z.number().int().nonnegative()
+	}),
+	budget: z.object({
+		requestedTokens: z.number().int().positive(),
+		strategy: z.literal("utf8-bytes"),
+		maxUtf8Bytes: z.number().int().positive(),
+		usedUtf8Bytes: z.number().int().nonnegative(),
+		conservativeTokenUpperBound: z.number().int().nonnegative(),
+		remainingUtf8Bytes: z.number().int().nonnegative()
+	}),
+	...paginationOutputShape,
+	content: z.array(contentChangeHydrationContentOutputSchema),
+	tombstones: z.array(contentChangeHydrationTombstoneOutputSchema)
+});
 const retrievalSourceOutputSchema = z.object({
 	canonicalUrl: z.string().max(4096).refine(isDocsRetrievalCanonicalUrl, "Expected a safe HTTP(S) URL or root-relative path"),
 	scope: retrievalSourceScopeOutputSchema,
@@ -2274,6 +2392,7 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
 			searchDocs: true,
 			searchFacets: true,
 			listContentChanges: true,
+			hydrateContentChanges: true,
 			getNavigation: true,
 			getCodeExamples: true,
 			getConfigSchema: true,
@@ -2297,6 +2416,7 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
 			searchDocs: config.tools?.searchDocs ?? true,
 			searchFacets: config.tools?.searchFacets ?? true,
 			listContentChanges: config.tools?.listContentChanges ?? true,
+			hydrateContentChanges: config.tools?.hydrateContentChanges ?? true,
 			getNavigation: config.tools?.getNavigation ?? true,
 			getCodeExamples: config.tools?.getCodeExamples ?? true,
 			getConfigSchema: config.tools?.getConfigSchema ?? true,
@@ -2608,6 +2728,7 @@ async function createDocsMcpServer(options) {
 		version: resolved.version
 	});
 	const contentChangesEnabled = resolveDocsContentChangesConfig(options.contentChanges).enabled && resolved.tools.listContentChanges !== false;
+	const contentChangeHydrationEnabled = contentChangesEnabled && resolved.tools.hydrateContentChanges !== false;
 	const server = new McpServer({
 		name: resolved.name,
 		version: resolved.version
@@ -2651,25 +2772,33 @@ async function createDocsMcpServer(options) {
 	const defaultTree = await getSourceNavigation();
 	const defaultSkills = await getSourceSkills();
 	const contentChangeFeed = options.contentChangeFeed ?? createDocsContentChangeFeed(options.contentChanges);
-	async function resolveContentChanges(since, locale) {
+	async function resolveContentChangeState(since, locale) {
 		if (!contentChangesEnabled) throw new ProtocolError(ProtocolErrorCode.MethodNotFound, "Content changes are disabled.");
 		if (since && !isDocsContentChangeGeneration(since)) throw new ProtocolError(ProtocolErrorCode.InvalidParams, "Content-change `since` must be a SHA-256 index generation.");
 		const resolvedLocale = resolveSourceLocale(locale);
+		const pages = dedupePages(await options.source.getPages(resolvedLocale, options.requestContext));
 		try {
-			return await contentChangeFeed.resolve({
-				pages: toSearchSourcePages(dedupePages(await options.source.getPages(resolvedLocale, options.requestContext))),
-				search: options.search,
-				audience: "agent",
-				locale: resolvedLocale,
-				baseUrl: options.source.baseUrl ?? (options.requestContext?.request ? new URL(options.requestContext.request.url).origin : void 0),
-				...since ? { since } : {},
-				...options.requestContext?.request ? { request: options.requestContext.request.clone() } : {}
-			});
+			return {
+				result: await contentChangeFeed.resolve({
+					pages: toSearchSourcePages(pages),
+					search: options.search,
+					audience: "agent",
+					locale: resolvedLocale,
+					baseUrl: options.source.baseUrl ?? (options.requestContext?.request ? new URL(options.requestContext.request.url).origin : void 0),
+					...since ? { since } : {},
+					...options.requestContext?.request ? { request: options.requestContext.request.clone() } : {}
+				}),
+				pages,
+				...resolvedLocale ? { resolvedLocale } : {}
+			};
 		} catch (error) {
 			if (error instanceof DocsContentChangesRequestError) throw new ProtocolError(ProtocolErrorCode.InvalidParams, error.message);
 			throw error;
 		}
 	}
+	async function resolveContentChanges(since, locale) {
+		return (await resolveContentChangeState(since, locale)).result;
+	}
 	registerResource("docs-navigation", "docs://navigation", {
 		title: "Docs Navigation",
 		description: "Structured navigation tree for the documentation site.",
@@ -2737,6 +2866,51 @@ async function createDocsMcpServer(options) {
 			});
 			return createStructuredTextResult(result);
 		});
+		if (contentChangeHydrationEnabled) registerTool("hydrate_content_changes", {
+			title: "Hydrate docs content changes",
+			description: "Fetch only added and changed agent-facing sections after list_content_changes. Returns deletion tombstones and digest-bound continuation cursors under a conservative token budget.",
+			inputSchema: hydrateContentChangesInputSchema,
+			outputSchema: contentChangeHydrationOutputSchema,
+			annotations: { readOnlyHint: true }
+		}, async ({ since, tokenBudget, cursor, locale }) => {
+			const startedAt = nowMs();
+			const state = await resolveContentChangeState(since, locale);
+			let result;
+			try {
+				result = hydrateDocsContentChanges({
+					changes: state.result,
+					pages: state.pages,
+					since,
+					tokenBudget,
+					cursor,
+					cursorScope: protocolScope
+				});
+			} catch (error) {
+				if (error instanceof DocsPaginationCursorError) throw new ProtocolError(ProtocolErrorCode.InvalidParams, error.message);
+				throw error;
+			}
+			trackMcpTool("hydrate_content_changes", {
+				locale: state.resolvedLocale,
+				resultCount: result.resultCount
+			});
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "mcp_tool",
+				source: "mcp",
+				locale: state.resolvedLocale,
+				properties: {
+					tool: "hydrate_content_changes",
+					mode: result.mode,
+					resetRequired: result.resetRequired,
+					resultCount: result.resultCount,
+					total: result.total,
+					hasMore: result.hasMore,
+					tokenBudget,
+					usedUtf8Bytes: result.budget.usedUtf8Bytes,
+					durationMs: durationMs(startedAt)
+				}
+			});
+			return createStructuredTextResult(result);
+		});
 	}
 	for (const page of defaultPages) {
 		const resourceUri = toPageResourceUri(page.url);
@@ -5843,4 +6017,4 @@ function toPageResourceUri(url) {
 }
 
 //#endregion
-export { DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DOCS_MCP_CONTENT_CHANGES_CURRENT_URI, DOCS_MCP_CONTENT_CHANGES_URI_TEMPLATE, buildDocsMcpContext, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };
+export { DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT, DOCS_MCP_CONTENT_CHANGES_CURRENT_URI, DOCS_MCP_CONTENT_CHANGES_URI_TEMPLATE, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, buildDocsMcpContext, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, hydrateDocsContentChanges, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };

package/dist/{prompt-references-CMMoF6AY.mjs → prompt-references-embiJdYt.mjs}

@@ -1,7 +1,7 @@
-import { At as DEFAULT_SITEMAP_XML_ROUTE, Ot as DEFAULT_SITEMAP_MD_ROUTE, Un as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-Cj50nyeV.mjs";
+import { At as DEFAULT_SITEMAP_XML_ROUTE, Gn as DEFAULT_MCP_WELL_KNOWN_ROUTE, Ot as DEFAULT_SITEMAP_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-Dze2Cy5B.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
 import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-BKlEnK_H.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-BukukxNm.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-D96X6eVX.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts

package/dist/{retrieval-digest-DIbiu0TW.d.mts → retrieval-digest-DRRHA1B3.d.mts}

@@ -1,5 +1,5 @@
-import { Rn as DocsSitemapConfig, Sr as ResolvedDocsRelatedLink, at as DocsAnalyticsEvent, ir as OpenDocsProvider, it as DocsAnalyticsConfig, nn as DocsObservabilityEvent, ot as DocsAnalyticsEventInput, rn as DocsObservabilityEventInput, sr as OpenDocsTarget, tn as DocsObservabilityConfig, tt as DocsAgentTraceEventInput } from "./types-o-ULHPK6.mjs";
-import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-C2cUIQzW.mjs";
+import { Bn as DocsSitemapConfig, an as DocsObservabilityEventInput, ct as DocsAnalyticsEventInput, in as DocsObservabilityEvent, lr as OpenDocsTarget, or as OpenDocsProvider, ot as DocsAnalyticsConfig, rn as DocsObservabilityConfig, rt as DocsAgentTraceEventInput, st as DocsAnalyticsEvent, wr as ResolvedDocsRelatedLink } from "./types-lGEHcx_6.mjs";
+import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-DPUEcUmb.mjs";
 
 //#region src/analytics.d.ts
 declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["run.start", "run.end", "run.error", "user.input", "prompt.build", "retrieval.query", "retrieval.result", "retrieval.error", "model.call", "model.response", "model.stream", "model.error", "tool.call", "tool.result", "tool.error", "retry", "timeout", "error", "agent.final"];

package/dist/{review-D14mUw5D.mjs → review-2e4TXoGS.mjs}

@@ -1,14 +1,15 @@
-import { A as buildDocsAgentDiscoverySpec, Gn as getDocsMcpProtectedResourceMetadataRoutes, M as buildDocsConfigMap, Sn as findDocsAudienceMdxIssues, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, pn as resolveAskAISearchRequestConfig } from "./agent-Cj50nyeV.mjs";
+import { A as buildDocsAgentDiscoverySpec, M as buildDocsConfigMap, Sn as findDocsAudienceMdxIssues, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, pn as resolveAskAISearchRequestConfig, qn as getDocsMcpProtectedResourceMetadataRoutes } from "./agent-Dze2Cy5B.mjs";
 import { _ as hasStructuredPageAgentContract, f as PAGE_AGENT_CONTRACT_FIELDS, g as getPageAgentFrontmatterIssues, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
 import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-BKlEnK_H.mjs";
-import "./agent-provenance-C_jgqNTW.mjs";
+import "./content-change-hydration-DpQ0KdAD.mjs";
 import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
-import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-DvQQtN62.mjs";
+import "./agent-skills-server-D5qYU19g.mjs";
+import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-Burrzyam.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
+import "./code-blocks-0wjOsqdJ.mjs";
 import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
-import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-Bk8MBi3Z.mjs";
+import { a as createAgentUsefulnessPagesFromMcp, i as analyzeAgentUsefulness, n as analyzeConfiguredAgentSkillsProgressiveDisclosure, o as extractAgentBlocks, r as analyzeAgentSurfaceDrift, t as resolveGoldenEvaluationInput } from "./golden-evaluations-B2GHnoFa.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
@@ -133,6 +134,20 @@ async function runReview(options = {}) {
 		rootDir,
 		contentDir
 	});
+	let skillDisclosure;
+	let skillDisclosureError;
+	if (config?.agent?.skills) try {
+		skillDisclosure = analyzeConfiguredAgentSkillsProgressiveDisclosure(config.agent.skills, { rootDir });
+	} catch (error) {
+		skillDisclosureError = error instanceof Error ? error.message : String(error);
+	}
+	const relevantSkillFiles = selectReviewSkillFiles({
+		rootDir,
+		configPath: path.relative(rootDir, configPath),
+		changedFiles,
+		report: skillDisclosure
+	});
+	const reviewedFiles = [...new Set([...relevantFiles, ...relevantSkillFiles])].sort();
 	const mcpSource = createFilesystemDocsMcpSource({
 		rootDir,
 		entry,
@@ -152,6 +167,30 @@ async function runReview(options = {}) {
 		files: relevantFiles,
 		review
 	});
+	if (skillDisclosureError) pushFinding(findings, review, {
+		rule: "agentSkills",
+		code: "agent-skills-analysis-failed",
+		severity: "error",
+		file: toPosixPath(path.relative(rootDir, configPath)),
+		line: 1,
+		message: `Configured Agent Skills could not be analyzed: ${skillDisclosureError}`
+	});
+	if (skillDisclosure) {
+		const relevantSkillSet = new Set(relevantSkillFiles);
+		for (const issue of skillDisclosure.issues) {
+			const file = toPosixPath(path.relative(rootDir, issue.filePath));
+			const skillFile = toPosixPath(path.relative(rootDir, issue.skillPath));
+			if (!relevantSkillSet.has(file) && !relevantSkillSet.has(skillFile)) continue;
+			pushFinding(findings, review, {
+				rule: "agentSkills",
+				code: issue.code,
+				severity: issue.severity === "error" ? "error" : issue.severity === "warning" ? "warn" : "suggestion",
+				file,
+				line: issue.line,
+				message: issue.message
+			});
+		}
+	}
 	const relevantSet = new Set(relevantFiles);
 	for (const issue of usefulness.findings) {
 		if (!relevantSet.has(issue.file)) continue;
@@ -274,7 +313,7 @@ async function runReview(options = {}) {
 		score,
 		threshold: review.score.threshold,
 		mode,
-		reviewedFiles: relevantFiles,
+		reviewedFiles,
 		changedFiles,
 		findings,
 		usefulness: usefulness.metrics,
@@ -513,7 +552,7 @@ function printReviewReport(report) {
 	console.log(`Threshold: ${report.threshold}`);
 	console.log(`Mode: ${modeLabel}`);
 	console.log(`Changed files: ${report.changedFiles.length}`);
-	console.log(`Reviewed docs files: ${report.reviewedFiles.length}`);
+	console.log(`Reviewed docs and skill files: ${report.reviewedFiles.length}`);
 	console.log(`Findings: ${counts.error} error${counts.error === 1 ? "" : "s"}, ${counts.warn} warning${counts.warn === 1 ? "" : "s"}, ${counts.suggestion} suggestion${counts.suggestion === 1 ? "" : "s"}`);
 	if (report.usefulness) console.log(`Useful agent-only blocks: ${report.usefulness.agentBlocks.useful}/${report.usefulness.agentBlocks.total}; task-complete pages: ${report.usefulness.taskCompleteness.completePages}/${report.usefulness.actionablePages}`);
 	if (report.evaluations) console.log(`Golden tasks: ${report.evaluations.status === "unmeasured" ? "unmeasured" : `${report.evaluations.passedTaskCount}/${report.evaluations.taskCount} passed (${report.evaluations.score}/100)`}`);
@@ -577,6 +616,25 @@ function selectReviewFiles(options) {
 	}
 	return Array.from(selected).sort();
 }
+function selectReviewSkillFiles(options) {
+	if (!options.report) return [];
+	const normalizedConfigPath = toPosixPath(options.configPath);
+	const configChanged = options.changedFiles.includes(normalizedConfigPath);
+	const changed = new Set(options.changedFiles.map(toPosixPath));
+	const selected = /* @__PURE__ */ new Set();
+	for (const skill of options.report.skills) {
+		const skillPath = toPosixPath(path.relative(options.rootDir, skill.skillPath));
+		const skillDir = `${toPosixPath(path.dirname(skillPath)).replace(/\/+$/u, "")}/`;
+		if (!(configChanged || changed.has(skillPath) || [...changed].some((file) => file.startsWith(skillDir)))) continue;
+		selected.add(skillPath);
+		for (const file of changed) if (file.startsWith(skillDir)) selected.add(file);
+		for (const issue of options.report.issues) {
+			if (issue.skillPath !== skill.skillPath) continue;
+			selected.add(toPosixPath(path.relative(options.rootDir, issue.filePath)));
+		}
+	}
+	return [...selected].sort();
+}
 function getChangedFiles(rootDir, options) {
 	const ranges = [
 		options.base && options.head ? `${options.base}...${options.head}` : void 0,
@@ -585,17 +643,20 @@ function getChangedFiles(rootDir, options) {
 		void 0
 	].filter((range, index, allRanges) => range !== void 0 || index === allRanges.length - 1);
 	for (const range of ranges) try {
+		const repoRoot = execFileSync("git", ["rev-parse", "--show-toplevel"], {
+			cwd: rootDir,
+			encoding: "utf-8"
+		}).trim();
 		const args = [
 			"diff",
-			"--relative",
 			"--name-only",
 			"--diff-filter=ACMRTUXB"
 		];
 		if (range) args.push(range);
 		const files = execFileSync("git", args, {
-			cwd: rootDir,
+			cwd: repoRoot,
 			encoding: "utf-8"
-		}).split(/\r?\n/).map((file) => file.trim()).filter(Boolean).map(toPosixPath);
+		}).split(/\r?\n/).map((file) => file.trim()).filter(Boolean).map((file) => toPosixPath(path.relative(rootDir, path.resolve(repoRoot, file))));
 		if (files.length > 0 || range === void 0) return files;
 	} catch {}
 	return [];

package/dist/{robots-DmczzidR.mjs → robots-BIySk2gE.mjs}

@@ -1,7 +1,7 @@
-import "./agent-Cj50nyeV.mjs";
+import "./agent-Dze2Cy5B.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
 import "./standards-discovery-BKlEnK_H.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 { 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 { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";

package/dist/{robots-BukukxNm.mjs → robots-D96X6eVX.mjs}

@@ -1,4 +1,4 @@
-import { It as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Un as DEFAULT_MCP_WELL_KNOWN_ROUTE, Vn as DEFAULT_MCP_PUBLIC_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as normalizeDocsPathSegment, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-Cj50nyeV.mjs";
+import { Gn as DEFAULT_MCP_WELL_KNOWN_ROUTE, It as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Un as DEFAULT_MCP_PUBLIC_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as normalizeDocsPathSegment, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-Dze2Cy5B.mjs";
 import { 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, v as DEFAULT_API_CATALOG_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BKlEnK_H.mjs";
 
 //#region src/robots.ts

package/dist/{search-DP96dV3e.mjs → search-DfB3LQ4s.mjs}

@@ -1,14 +1,14 @@
-import { en as buildDocsSearchDocuments, nn as createAlgoliaSearchAdapter, on as createTypesenseSearchAdapter } from "./agent-Cj50nyeV.mjs";
+import { en as buildDocsSearchDocuments, nn as createAlgoliaSearchAdapter, on as createTypesenseSearchAdapter } from "./agent-Dze2Cy5B.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
 import "./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 { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
-import "./sitemap-server-DzlV1NOB.mjs";
-import "./agent-evals-DvQQtN62.mjs";
+import "./sitemap-server-BefXEox6.mjs";
+import "./agent-skills-server-D5qYU19g.mjs";
+import "./agent-evals-Burrzyam.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-B2EXn2QD.mjs";
+import "./code-blocks-0wjOsqdJ.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
 import { readFileSync } from "node:fs";