@farming-labs/docs 0.2.68 → 0.2.70

package/dist/{agent-D2SsSct2.mjs → agent-CXkn2ihX.mjs}

@@ -1,4 +1,4 @@
-import { F as resolveDocsDiscoveryApiRoute, O as buildDocsApiCatalog, P as isDocsStandardsDiscoveryRequest, S as DOCS_AGENT_MANIFEST_FORMAT, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, j as createDocsStandardsResponse, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-DSVKdQrl.mjs";
+import { F as resolveDocsDiscoveryApiRoute, O as buildDocsApiCatalog, P as isDocsStandardsDiscoveryRequest, S as DOCS_AGENT_MANIFEST_FORMAT, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, j as createDocsStandardsResponse, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-CYfiQE13.mjs";
 import { createProcessor } from "@mdx-js/mdx";
 
 //#region src/mcp-auth.ts

package/dist/{agent-BIzynBvk.mjs → agent-MOuft73V.mjs}

@@ -1,5 +1,5 @@
-import { Jt as normalizePageAgentFrontmatter, L as findDocsMarkdownPage, Zt as stripGeneratedPageAgentContractMarkdown, tt as renderDocsMarkdownDocument } from "./agent-D2SsSct2.mjs";
-import { _ as GENERATED_AGENT_PROVENANCE_VERSION, b as parseGeneratedAgentDocument, v as hashGeneratedAgentContent, x as serializeGeneratedAgentDocument } from "./search-DBlw9h3P.mjs";
+import { Jt as normalizePageAgentFrontmatter, L as findDocsMarkdownPage, Zt as stripGeneratedPageAgentContractMarkdown, tt as renderDocsMarkdownDocument } from "./agent-CXkn2ihX.mjs";
+import { _ as GENERATED_AGENT_PROVENANCE_VERSION, b as parseGeneratedAgentDocument, v as hashGeneratedAgentContent, x as serializeGeneratedAgentDocument } from "./search-Boqkxa3T.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-Wcdj-D0a.mjs";
 import { createRequire } from "node:module";

package/dist/{agent-evals-DZR4J7Iz.mjs → agent-evals-BTh28hl-.mjs}

@@ -1,4 +1,4 @@
-import { m as findDocsMarkdownSection, p as resolveSearchRequestConfig, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-DBlw9h3P.mjs";
+import { m as findDocsMarkdownSection, p as resolveSearchRequestConfig, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-Boqkxa3T.mjs";
 import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-C_U--OZ7.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
 import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";

package/dist/{agent-export-C_zd18VF.mjs → agent-export-43XUqLf5.mjs}

@@ -1,13 +1,13 @@
-import { $ as renderDocsAgentsDocument, At as buildDocsSitemapManifest, Ft as resolveDocsSitemapConfig, Nt as renderDocsSitemapMarkdown, Pt as renderDocsSitemapXml, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as renderDocsLlmsTxt, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, k as buildDocsAgentDiscoverySpec, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, tt as renderDocsMarkdownDocument, v as DEFAULT_LLMS_TXT_ROUTE, vt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-D2SsSct2.mjs";
-import { D as buildDocsAgentSkillsIndex, E as buildDocsA2AAgentCard, I as resolveDocsPublishedAgentSkill, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, k as buildDocsLegacySkillsIndex, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-DSVKdQrl.mjs";
-import "./search-DBlw9h3P.mjs";
+import { $ as renderDocsAgentsDocument, At as buildDocsSitemapManifest, Ft as resolveDocsSitemapConfig, Nt as renderDocsSitemapMarkdown, Pt as renderDocsSitemapXml, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as renderDocsLlmsTxt, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, k as buildDocsAgentDiscoverySpec, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, tt as renderDocsMarkdownDocument, v as DEFAULT_LLMS_TXT_ROUTE, vt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-CXkn2ihX.mjs";
+import { D as buildDocsAgentSkillsIndex, E as buildDocsA2AAgentCard, I as resolveDocsPublishedAgentSkill, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, k as buildDocsLegacySkillsIndex, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-CYfiQE13.mjs";
+import "./search-Boqkxa3T.mjs";
 import { t as resolveDocsI18n } from "./i18n-CCaFUnAN.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-Dz5XeT8F.mjs";
-import "./sitemap-server-DQp8qUKN.mjs";
-import "./agent-evals-DZR4J7Iz.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-DOnLGE0l.mjs";
+import "./sitemap-server-Bynukz-j.mjs";
+import "./agent-evals-BTh28hl-.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-iBfCLPOt.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B4u3qy-1.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";

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

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

package/dist/{agent-skills-server-iBfCLPOt.mjs → agent-skills-server-B4u3qy-1.mjs}

@@ -1,4 +1,4 @@
-import { A as buildDocsPublishedAgentSkill, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-DSVKdQrl.mjs";
+import { A as buildDocsPublishedAgentSkill, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-CYfiQE13.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";
@@ -329,8 +329,10 @@ function publishSkillDocumentSync(skillPath) {
 	const skillDocument = readFileSync(skillPath, "utf8");
 	const skillDocumentBytes = Buffer.byteLength(skillDocument, "utf8");
 	if (skillDocumentBytes > MAX_FILE_BYTES) throw new Error(`Agent Skill SKILL.md exceeds ${MAX_FILE_BYTES} bytes: ${skillPath}`);
-	const base = buildDocsPublishedAgentSkill(skillDocument, hashBytes(skillDocument));
-	if (base.name !== path.basename(skillDir)) throw new Error(`Agent Skill frontmatter name "${base.name}" must match its directory "${path.basename(skillDir)}".`);
+	const base = buildDocsPublishedAgentSkill(skillDocument, hashBytes(skillDocument), {
+		directoryName: path.basename(skillDir),
+		source: skillPath
+	});
 	const companions = readCompanionFiles(skillDir, base.name, skillDocumentBytes);
 	const files = [...base.files, ...companions].sort(compareSkillFilePath);
 	if (companions.length === 0) return {
@@ -356,8 +358,10 @@ async function publishSkillDocumentAsync(skillPath) {
 	const skillDocument = await readFile(skillPath, "utf8");
 	const skillDocumentBytes = Buffer.byteLength(skillDocument, "utf8");
 	if (skillDocumentBytes > MAX_FILE_BYTES) throw new Error(`Agent Skill SKILL.md exceeds ${MAX_FILE_BYTES} bytes: ${skillPath}`);
-	const base = buildDocsPublishedAgentSkill(skillDocument, hashBytes(skillDocument));
-	if (base.name !== path.basename(skillDir)) throw new Error(`Agent Skill frontmatter name "${base.name}" must match its directory "${path.basename(skillDir)}".`);
+	const base = buildDocsPublishedAgentSkill(skillDocument, hashBytes(skillDocument), {
+		directoryName: path.basename(skillDir),
+		source: skillPath
+	});
 	const companions = await readCompanionFilesAsync(skillDir, base.name, skillDocumentBytes);
 	const files = [...base.files, ...companions].sort(compareSkillFilePath);
 	if (companions.length === 0) return {

package/dist/{agent-skills-server-DJXdK_hS.d.mts → agent-skills-server-DTwblsLu.d.mts}

@@ -1,5 +1,5 @@
 import { $ as DocsAgentSkillsInput } from "./types-BQC05SQm.mjs";
-import { I as DocsPublishedAgentSkill } from "./standards-discovery-CQjJ-M2y.mjs";
+import { I as DocsPublishedAgentSkill } from "./standards-discovery-C0CIC4QI.mjs";
 
 //#region src/agent-skills-server.d.ts
 interface ResolveConfiguredAgentSkillsOptions {

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

@@ -0,0 +1,51 @@
+//#region src/agent-skills-spec.d.ts
+declare const AGENT_SKILL_FRONTMATTER_FIELDS: readonly ["name", "description", "license", "compatibility", "metadata", "allowed-tools"];
+declare const AGENT_SKILL_NAME_MAX_LENGTH = 64;
+declare const AGENT_SKILL_DESCRIPTION_MAX_LENGTH = 1024;
+declare const AGENT_SKILL_COMPATIBILITY_MAX_LENGTH = 500;
+type DocsAgentSkillFrontmatterField = (typeof AGENT_SKILL_FRONTMATTER_FIELDS)[number] | "frontmatter";
+interface DocsAgentSkillFrontmatter {
+  name: string;
+  description: string;
+  license?: string;
+  compatibility?: string;
+  metadata?: Record<string, string>;
+  "allowed-tools"?: string;
+}
+interface DocsAgentSkillFrontmatterIssue {
+  code: "missing-frontmatter" | "unclosed-frontmatter" | "invalid-yaml" | "invalid-mapping" | "unexpected-field" | "missing-field" | "invalid-type" | "invalid-length" | "invalid-name" | "directory-mismatch";
+  field: DocsAgentSkillFrontmatterField;
+  message: string;
+}
+interface DocsAgentSkillFrontmatterValidationOptions {
+  /** Parent directory name, when the document came from a skill directory. */
+  directoryName?: string;
+  /** Human-readable file or generated-document label used in thrown diagnostics. */
+  source?: string;
+}
+type DocsAgentSkillFrontmatterValidation = {
+  valid: true;
+  data: DocsAgentSkillFrontmatter;
+  issues: readonly [];
+} | {
+  valid: false;
+  data: null;
+  issues: readonly DocsAgentSkillFrontmatterIssue[];
+};
+/**
+ * Check the Agent Skills name grammar after NFKC normalization.
+ *
+ * The official reference validator accepts Unicode lowercase letters and numbers
+ * in addition to the ASCII examples documented by the specification.
+ */
+declare function isDocsAgentSkillName(value: unknown): value is string;
+/** Validate one SKILL.md document against the complete Agent Skills frontmatter contract. */
+declare function validateDocsAgentSkillFrontmatter(document: string, options?: DocsAgentSkillFrontmatterValidationOptions): DocsAgentSkillFrontmatterValidation;
+declare class DocsAgentSkillFrontmatterError extends Error {
+  readonly issues: readonly DocsAgentSkillFrontmatterIssue[];
+  constructor(issues: readonly DocsAgentSkillFrontmatterIssue[], options?: DocsAgentSkillFrontmatterValidationOptions);
+}
+/** Parse valid frontmatter or throw a structured, field-specific validation error. */
+declare function parseDocsAgentSkillFrontmatter(document: string, options?: DocsAgentSkillFrontmatterValidationOptions): DocsAgentSkillFrontmatter;
+//#endregion
+export { AGENT_SKILL_COMPATIBILITY_MAX_LENGTH, AGENT_SKILL_DESCRIPTION_MAX_LENGTH, AGENT_SKILL_FRONTMATTER_FIELDS, AGENT_SKILL_NAME_MAX_LENGTH, DocsAgentSkillFrontmatter, DocsAgentSkillFrontmatterError, DocsAgentSkillFrontmatterField, DocsAgentSkillFrontmatterIssue, DocsAgentSkillFrontmatterValidation, DocsAgentSkillFrontmatterValidationOptions, isDocsAgentSkillName, parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter };

package/dist/agent-skills-spec.mjs

@@ -0,0 +1,284 @@
+import { isMap, isScalar, parseDocument } from "yaml";
+
+//#region src/agent-skills-spec.ts
+const AGENT_SKILL_FRONTMATTER_FIELDS = [
+	"name",
+	"description",
+	"license",
+	"compatibility",
+	"metadata",
+	"allowed-tools"
+];
+const AGENT_SKILL_NAME_MAX_LENGTH = 64;
+const AGENT_SKILL_DESCRIPTION_MAX_LENGTH = 1024;
+const AGENT_SKILL_COMPATIBILITY_MAX_LENGTH = 500;
+const AGENT_SKILL_FRONTMATTER_FIELD_SET = new Set(AGENT_SKILL_FRONTMATTER_FIELDS);
+const FRONTMATTER_OPEN_PATTERN = /^---[ \t]*(?:\r?\n)/u;
+const FRONTMATTER_CLOSE_PATTERN = /^---[ \t]*(?:\r?\n|$)/mu;
+const UNICODE_ALPHANUMERIC_PATTERN = /^[\p{L}\p{N}]$/u;
+function characterCount(value) {
+	return Array.from(value).length;
+}
+function asRecord(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	return value;
+}
+function hasOwn(value, field) {
+	return Object.prototype.hasOwnProperty.call(value, field);
+}
+function yamlErrorMessage(error) {
+	return (error instanceof Error ? error.message : String(error)).trim() || "unknown YAML parser error";
+}
+function findYamlMappingValue(mapping, field) {
+	return mapping.items.find((pair) => isScalar(pair.key) && pair.key.value === field)?.value;
+}
+/**
+* Check the Agent Skills name grammar after NFKC normalization.
+*
+* The official reference validator accepts Unicode lowercase letters and numbers
+* in addition to the ASCII examples documented by the specification.
+*/
+function isDocsAgentSkillName(value) {
+	if (typeof value !== "string") return false;
+	const normalized = value.normalize("NFKC");
+	const characters = Array.from(normalized);
+	return characters.length > 0 && characters.length <= AGENT_SKILL_NAME_MAX_LENGTH && normalized === normalized.toLowerCase() && !normalized.startsWith("-") && !normalized.endsWith("-") && !normalized.includes("--") && characters.every((character) => character === "-" || UNICODE_ALPHANUMERIC_PATTERN.test(character));
+}
+function validateName(data, options, issues) {
+	if (!hasOwn(data, "name")) {
+		issues.push({
+			code: "missing-field",
+			field: "name",
+			message: "Missing required field in frontmatter: name"
+		});
+		return null;
+	}
+	if (typeof data.name !== "string" || data.name.trim().length === 0) {
+		issues.push({
+			code: "invalid-type",
+			field: "name",
+			message: "Field 'name' must be a non-empty string"
+		});
+		return null;
+	}
+	const name = data.name.normalize("NFKC");
+	const length = characterCount(name);
+	if (length > AGENT_SKILL_NAME_MAX_LENGTH) issues.push({
+		code: "invalid-length",
+		field: "name",
+		message: `Skill name '${name}' exceeds ${AGENT_SKILL_NAME_MAX_LENGTH} character limit (${length} chars)`
+	});
+	if (name !== name.toLowerCase()) issues.push({
+		code: "invalid-name",
+		field: "name",
+		message: `Skill name '${name}' must be lowercase`
+	});
+	if (name.startsWith("-") || name.endsWith("-")) issues.push({
+		code: "invalid-name",
+		field: "name",
+		message: "Skill name cannot start or end with a hyphen"
+	});
+	if (name.includes("--")) issues.push({
+		code: "invalid-name",
+		field: "name",
+		message: "Skill name cannot contain consecutive hyphens"
+	});
+	if (!Array.from(name).every((character) => character === "-" || UNICODE_ALPHANUMERIC_PATTERN.test(character))) issues.push({
+		code: "invalid-name",
+		field: "name",
+		message: `Skill name '${name}' contains invalid characters. Only letters, digits, and hyphens are allowed.`
+	});
+	if (options.directoryName !== void 0 && options.directoryName.normalize("NFKC") !== name) issues.push({
+		code: "directory-mismatch",
+		field: "name",
+		message: `Agent Skill frontmatter name "${name}" must match its directory "${options.directoryName}".`
+	});
+	return name;
+}
+function validateDescription(data, issues) {
+	if (!hasOwn(data, "description")) {
+		issues.push({
+			code: "missing-field",
+			field: "description",
+			message: "Missing required field in frontmatter: description"
+		});
+		return null;
+	}
+	if (typeof data.description !== "string" || data.description.trim().length === 0) {
+		issues.push({
+			code: "invalid-type",
+			field: "description",
+			message: "Field 'description' must be a non-empty string"
+		});
+		return null;
+	}
+	const length = characterCount(data.description);
+	if (length > AGENT_SKILL_DESCRIPTION_MAX_LENGTH) issues.push({
+		code: "invalid-length",
+		field: "description",
+		message: `Description exceeds ${AGENT_SKILL_DESCRIPTION_MAX_LENGTH} character limit (${length} chars)`
+	});
+	return data.description;
+}
+function validateOptionalFields(data, frontmatter, issues) {
+	const result = {};
+	if (hasOwn(data, "license")) if (typeof data.license !== "string") issues.push({
+		code: "invalid-type",
+		field: "license",
+		message: "Field 'license' must be a string"
+	});
+	else result.license = data.license;
+	if (hasOwn(data, "compatibility")) if (typeof data.compatibility !== "string") issues.push({
+		code: "invalid-type",
+		field: "compatibility",
+		message: "Field 'compatibility' must be a string"
+	});
+	else {
+		const length = characterCount(data.compatibility);
+		if (data.compatibility.trim().length === 0) issues.push({
+			code: "invalid-length",
+			field: "compatibility",
+			message: "Field 'compatibility' must contain at least 1 character"
+		});
+		else if (length > AGENT_SKILL_COMPATIBILITY_MAX_LENGTH) issues.push({
+			code: "invalid-length",
+			field: "compatibility",
+			message: `Compatibility exceeds ${AGENT_SKILL_COMPATIBILITY_MAX_LENGTH} character limit (${length} chars)`
+		});
+		result.compatibility = data.compatibility;
+	}
+	if (hasOwn(data, "metadata")) {
+		const metadataNode = findYamlMappingValue(frontmatter, "metadata");
+		const metadata = asRecord(data.metadata);
+		if (!isMap(metadataNode) || !metadata) issues.push({
+			code: "invalid-type",
+			field: "metadata",
+			message: "Field 'metadata' must be a mapping from string keys to string values"
+		});
+		else {
+			if (metadataNode.items.some((pair) => !isScalar(pair.key) || typeof pair.key.value !== "string")) issues.push({
+				code: "invalid-type",
+				field: "metadata",
+				message: "Field 'metadata' keys must be strings"
+			});
+			const invalidKeys = Object.keys(metadata).filter((key) => typeof metadata[key] !== "string").sort();
+			for (const key of invalidKeys) issues.push({
+				code: "invalid-type",
+				field: "metadata",
+				message: `Field 'metadata.${key}' must be a string`
+			});
+			result.metadata = Object.fromEntries(Object.entries(metadata).filter((entry) => {
+				return typeof entry[1] === "string";
+			}));
+		}
+	}
+	if (hasOwn(data, "allowed-tools")) if (typeof data["allowed-tools"] !== "string") issues.push({
+		code: "invalid-type",
+		field: "allowed-tools",
+		message: "Field 'allowed-tools' must be a space-separated string"
+	});
+	else result["allowed-tools"] = data["allowed-tools"];
+	return result;
+}
+/** Validate one SKILL.md document against the complete Agent Skills frontmatter contract. */
+function validateDocsAgentSkillFrontmatter(document, options = {}) {
+	const issues = [];
+	const opening = document.match(FRONTMATTER_OPEN_PATTERN);
+	if (!opening) return {
+		valid: false,
+		data: null,
+		issues: [{
+			code: "missing-frontmatter",
+			field: "frontmatter",
+			message: "SKILL.md must start with YAML frontmatter (---)"
+		}]
+	};
+	const remainder = document.slice(opening[0].length);
+	const closing = FRONTMATTER_CLOSE_PATTERN.exec(remainder);
+	if (!closing) return {
+		valid: false,
+		data: null,
+		issues: [{
+			code: "unclosed-frontmatter",
+			field: "frontmatter",
+			message: "SKILL.md frontmatter not properly closed with ---"
+		}]
+	};
+	let data;
+	let frontmatter;
+	try {
+		const parsed = parseDocument(remainder.slice(0, closing.index), { uniqueKeys: true });
+		if (parsed.errors.length > 0) throw parsed.errors[0];
+		if (!isMap(parsed.contents)) return {
+			valid: false,
+			data: null,
+			issues: [{
+				code: "invalid-mapping",
+				field: "frontmatter",
+				message: "SKILL.md frontmatter must be a YAML mapping"
+			}]
+		};
+		frontmatter = parsed.contents;
+		data = asRecord(parsed.toJS());
+	} catch (error) {
+		return {
+			valid: false,
+			data: null,
+			issues: [{
+				code: "invalid-yaml",
+				field: "frontmatter",
+				message: `Invalid YAML in frontmatter: ${yamlErrorMessage(error)}`
+			}]
+		};
+	}
+	if (!data) return {
+		valid: false,
+		data: null,
+		issues: [{
+			code: "invalid-mapping",
+			field: "frontmatter",
+			message: "SKILL.md frontmatter must be a YAML mapping"
+		}]
+	};
+	const unexpectedFields = Object.keys(data).filter((field) => !AGENT_SKILL_FRONTMATTER_FIELD_SET.has(field)).sort();
+	if (unexpectedFields.length > 0) issues.push({
+		code: "unexpected-field",
+		field: "frontmatter",
+		message: `Unexpected fields in frontmatter: ${unexpectedFields.join(", ")}. Only ${JSON.stringify([...AGENT_SKILL_FRONTMATTER_FIELDS])} are allowed.`
+	});
+	const name = validateName(data, options, issues);
+	const description = validateDescription(data, issues);
+	const optionalFields = validateOptionalFields(data, frontmatter, issues);
+	if (issues.length > 0 || name === null || description === null) return {
+		valid: false,
+		data: null,
+		issues
+	};
+	return {
+		valid: true,
+		data: {
+			name,
+			description,
+			...optionalFields
+		},
+		issues: []
+	};
+}
+var DocsAgentSkillFrontmatterError = class extends Error {
+	issues;
+	constructor(issues, options = {}) {
+		const source = options.source ? ` in ${options.source}` : "";
+		super(`Invalid Agent Skill frontmatter${source}:\n${issues.map((issue) => `- ${issue.message}`).join("\n")}`);
+		this.name = "DocsAgentSkillFrontmatterError";
+		this.issues = issues;
+	}
+};
+/** Parse valid frontmatter or throw a structured, field-specific validation error. */
+function parseDocsAgentSkillFrontmatter(document, options = {}) {
+	const validation = validateDocsAgentSkillFrontmatter(document, options);
+	if (!validation.valid) throw new DocsAgentSkillFrontmatterError(validation.issues, options);
+	return validation.data;
+}
+
+//#endregion
+export { AGENT_SKILL_COMPATIBILITY_MAX_LENGTH, AGENT_SKILL_DESCRIPTION_MAX_LENGTH, AGENT_SKILL_FRONTMATTER_FIELDS, AGENT_SKILL_NAME_MAX_LENGTH, DocsAgentSkillFrontmatterError, isDocsAgentSkillName, parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter };

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

@@ -1,6 +1,6 @@
 import { $ as DocsAgentSkillsInput } from "./types-BQC05SQm.mjs";
-import { I as DocsPublishedAgentSkill } from "./standards-discovery-CQjJ-M2y.mjs";
-import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-DJXdK_hS.mjs";
+import { I as DocsPublishedAgentSkill } from "./standards-discovery-C0CIC4QI.mjs";
+import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-DTwblsLu.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-DSVKdQrl.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-iBfCLPOt.mjs";
+import "./standards-discovery-CYfiQE13.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B4u3qy-1.mjs";
 
 //#region src/agent-skills-vite.ts
 const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";

package/dist/{agents-BR5tSkbq.mjs → agents-C16sSxHU.mjs}

@@ -1,11 +1,11 @@
-import { $ as renderDocsAgentsDocument, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-D2SsSct2.mjs";
-import "./standards-discovery-DSVKdQrl.mjs";
-import "./search-DBlw9h3P.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-DQp8qUKN.mjs";
-import "./agent-evals-DZR4J7Iz.mjs";
+import { $ as renderDocsAgentsDocument, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-CXkn2ihX.mjs";
+import "./standards-discovery-CYfiQE13.mjs";
+import "./search-Boqkxa3T.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-Bynukz-j.mjs";
+import "./agent-evals-BTh28hl-.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-iBfCLPOt.mjs";
+import "./agent-skills-server-B4u3qy-1.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

@@ -139,10 +139,10 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-YWlNI2d4.mjs");
+		const { runMcp } = await import("../mcp-BDPfedoh.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BIzynBvk.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-MOuft73V.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -150,7 +150,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-C_zd18VF.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-43XUqLf5.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -160,13 +160,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-BIzynBvk.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-C_zd18VF.mjs");
+		const { printAgentCompactHelp } = await import("../agent-MOuft73V.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-43XUqLf5.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BR5tSkbq.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-C16sSxHU.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -176,11 +176,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-BR5tSkbq.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-C16sSxHU.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CVhU0YKo.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-WjSas47Z.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -188,7 +188,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-DdfvxMh2.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-_0G2gAtx.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -210,7 +210,7 @@ async function main() {
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-DjN1Gfid.mjs");
+		const { syncSearch } = await import("../search-B9tkri5i.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -218,7 +218,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-B0hlAZ8o.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-FgXlxHEO.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -228,11 +228,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-B0hlAZ8o.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-FgXlxHEO.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-CD14j-mU.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DLl9Zizg.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -242,7 +242,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-CD14j-mU.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-DLl9Zizg.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {

package/dist/docs-cloud-server.d.mts

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