@farming-labs/docs 0.2.103 → 0.2.105

package/dist/{dev-BvbYmTLz.mjs → dev-Bx0JNglW.mjs}

@@ -1,12 +1,12 @@
-import { i as detectPackageManagerFromProject } from "./utils-DOMeZW9V.mjs";
-import { $ as postcssConfigTemplate, C as globalCssTemplate, g as docsLayoutTemplate, kt as tsconfigTemplate, tt as rootLayoutTemplate } from "./templates-kc7jxspR.mjs";
+import { i as detectPackageManagerFromProject } from "./utils-Cc1SrVza.mjs";
+import { $ as postcssConfigTemplate, C as globalCssTemplate, g as docsLayoutTemplate, kt as tsconfigTemplate, tt as rootLayoutTemplate } from "./templates-DdB4BBGq.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";
+import { z } from "zod";
 import os from "node:os";
 import pc from "picocolors";
 import { fileURLToPath } from "node:url";
-import { z } from "zod";
 
 //#region src/cli/dev-banner.ts
 function createDevLogger() {

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

@@ -1,5 +1,5 @@
-import { ft as DocsAnalyticsConfig, mt as DocsAnalyticsEventInput, pt as DocsAnalyticsEvent } from "./types-DLLefoU5.mjs";
-import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-BmbZVAT5.mjs";
+import { gt as DocsAnalyticsEventInput, ht as DocsAnalyticsEvent, mt as DocsAnalyticsConfig } from "./types-QhYMnKvb.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-BqfiQaNZ.mjs";
 
 //#region src/docs-cloud-server.d.ts
 type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);

package/dist/docs-cloud-server.mjs

@@ -1,5 +1,5 @@
-import { n as sendDocsCloudAnalyticsEvent } from "./cloud-analytics-CSyFE6SS.mjs";
-import { t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-CkCYjf2N.mjs";
+import { n as sendDocsCloudAnalyticsEvent } from "./cloud-analytics-Ci1yiwD8.mjs";
+import { t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-CK2qlNns.mjs";
 
 //#region src/docs-cloud-server.ts
 const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";

package/dist/{doctor-Bmm0uY98.mjs → doctor-CtK1CRPj.mjs}

@@ -1,22 +1,23 @@
-import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-BLHMoVId.mjs";
-import { d as httpLinkHeaderHasTargetRelation, f as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, p as readAgentSkillDocumentFromTar } from "./prompt-references-DW5vG5zs.mjs";
-import { A as buildDocsAgentDiscoverySpec, At as DEFAULT_SITEMAP_XML_ROUTE, Bn as DEFAULT_MCP_PUBLIC_ROUTE, F as buildDocsMcpEndpointCandidates, Hn as DEFAULT_MCP_WELL_KNOWN_ROUTE, It as resolveDocsSitemapConfig, M as buildDocsConfigMap, Ot as DEFAULT_SITEMAP_MD_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Wn as getDocsMcpProtectedResourceMetadataRoutes, Zn as normalizeDocsMcpAuthorizationServerUrls, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, kt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, pn as resolveAskAISearchRequestConfig, qn as isDocsMcpOAuthScopeToken, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-CFqECAG0.mjs";
-import { f as PAGE_AGENT_CONTRACT_FIELDS } from "./markdown-sections-7OoA7ylx.mjs";
-import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, h as DEFAULT_AGENT_SKILL_FORMAT, 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 } from "./standards-discovery-Ckx0tN7B.mjs";
+import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-CaCWThBY.mjs";
+import { f as PAGE_AGENT_CONTRACT_FIELDS } from "./markdown-sections-BKy4labo.mjs";
+import { d as httpLinkHeaderHasTargetRelation, f as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, p as readAgentSkillDocumentFromTar } from "./prompt-references-1Wce71c7.mjs";
+import { A as buildDocsAgentDiscoverySpec, At as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, F as buildDocsMcpEndpointCandidates, Gn as getDocsMcpProtectedResourceMetadataRoutes, Jn as isDocsMcpOAuthScopeToken, Lt as resolveDocsSitemapConfig, M as buildDocsConfigMap, Qn as normalizeDocsMcpAuthorizationServerUrls, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Un as DEFAULT_MCP_WELL_KNOWN_ROUTE, Vn as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, cr as resolveDocsOkfTrustMetadata, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_XML_ROUTE, kt as DEFAULT_SITEMAP_MD_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, mn as resolveAskAISearchRequestConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, sr as resolveDocsOkfConfig, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-DCTGj6J7.mjs";
+import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, h as DEFAULT_AGENT_SKILL_FORMAT, 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 } from "./standards-discovery-Bpz90VYq.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
-import "./content-change-hydration-BsbBXAUi.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-NQesPX5L.mjs";
-import { a as resolveDocsMetadataBaseUrl } from "./metadata-D4v_R1t5.mjs";
-import "./sitemap-server-B0SiREN0.mjs";
-import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-DFqQyO_V.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-GpcaCbRb.mjs";
+import "./openapi-mcp-DQ3xptKo.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-BOjWB1ky.mjs";
+import { a as resolveDocsMetadataBaseUrl } from "./metadata-7htr-Xj_.mjs";
+import "./sitemap-server-NeVu8W38.mjs";
+import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-Ddbf15pY.mjs";
+import { t as runDocsGoldenTasks } from "./agent-evals-D-sPJfXz.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-Bel6vDqI.mjs";
+import "./authoring-mcp-Be7quE5R.mjs";
+import "./code-blocks-D90CCJFs.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, r as extractTopLevelConfigObject, s as loadDocsConfigModuleResultWithProjectEnv, t as extractNestedObjectLiteral, v as resolveDocsProjectRoot } from "./config-BaTmjDqD.mjs";
-import { t as detectFramework } from "./utils-DOMeZW9V.mjs";
-import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-K45fcWGW.mjs";
-import { t as analyzeConfiguredAgentSkillsProgressiveDisclosure } from "./agent-skills-progressive-disclosure-Da9LKEKv.mjs";
+import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, r as extractTopLevelConfigObject, s as loadDocsConfigModuleResultWithProjectEnv, t as extractNestedObjectLiteral, v as resolveDocsProjectRoot } from "./config-DrZ3fXgf.mjs";
+import { t as detectFramework } from "./utils-Cc1SrVza.mjs";
+import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-De4KwoYr.mjs";
+import { t as analyzeConfiguredAgentSkillsProgressiveDisclosure } from "./agent-skills-progressive-disclosure-DL-q4JZo.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";
@@ -1925,6 +1926,9 @@ async function inspectAgentReadiness(options = {}) {
 	const evaluationCoverage = evaluations.coverage;
 	const formatDimensionCoverage = (label, dimension) => `${label}: ${dimension.status} (${dimension.measuredTaskCount}/${dimension.totalTaskCount} tasks)`;
 	checks.push(makeCheck("golden-task-coverage", "Golden evaluation coverage", evaluationCoverage.status === "measured" ? "pass" : "warn", Math.round(evaluationCoverage.coveragePercent / 100 * 5), 5, `${evaluationCoverage.status} coverage across optional confidence dimensions (${evaluationCoverage.measuredTaskDimensions}/${evaluationCoverage.totalTaskDimensions} task-dimensions, ${evaluationCoverage.coveragePercent}%): ${formatDimensionCoverage("safety", evaluationCoverage.dimensions.safety)}; ${formatDimensionCoverage("answer quality", evaluationCoverage.dimensions.answerQuality)}; ${formatDimensionCoverage("executable examples", evaluationCoverage.dimensions.executableExamples)}.`, evaluationCoverage.status === "measured" ? void 0 : "Add golden-task safety expectations, actual-answer assertions, and execute-level example checks so each confidence dimension is measured explicitly."));
+	const okfConfig = resolveDocsOkfConfig(config?.agent?.okf);
+	const staleOkfPages = okfConfig.enabled ? pages.filter((page) => resolveDocsOkfTrustMetadata(page, okfConfig).stale) : [];
+	checks.push(makeCheck("okf-trust", "OKF trust metadata", staleOkfPages.length > 0 ? "warn" : "pass", staleOkfPages.length > 0 ? 1 : 2, 2, !okfConfig.enabled ? "OKF export is optional and not configured." : staleOkfPages.length === 0 ? `OKF v0.2 trust metadata is enabled at ${okfConfig.route}; ${pages.length} page${pages.length === 1 ? "" : "s"} passed the configured staleness policy.` : `${staleOkfPages.length}/${pages.length} OKF document${staleOkfPages.length === 1 ? " is" : "s are"} beyond stale_after.`, staleOkfPages.length > 0 ? "Review or regenerate stale pages, then update okf.verified or stale_after with an auditable timestamp." : void 0));
 	const hosted = options.url ? await buildHostedAgentChecks(options.url, pages) : void 0;
 	if (hosted) checks.push(...hosted.checks);
 	const { score, maxScore } = normalizedDoctorScore(checks.reduce((total, check) => total + check.score, 0), checks.reduce((total, check) => total + check.maxScore, 0));

package/dist/{downgrade-Dqm0rJMy.mjs → downgrade-BXmQMkMy.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec, s as execOutput } from "./utils-DOMeZW9V.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version--oQiHwZj.mjs";
+import { c as fileExists, o as exec, s as execOutput } from "./utils-Cc1SrVza.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-Ci99L0yo.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/feedback-DWVUMrxy.mjs

@@ -0,0 +1,72 @@
+import { n as analyzeDocsAgentFeedback, r as readDocsAgentFeedbackFile } from "./agent-feedback-loop-vaC-M1sx.mjs";
+import { mkdirSync, renameSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+
+//#region src/cli/feedback.ts
+function parseAgentFeedbackImproveArgs(argv) {
+	const options = {};
+	for (let index = 0; index < argv.length; index += 1) {
+		const argument = argv[index];
+		if (argument === "--write") options.write = true;
+		else if (argument === "--json") options.json = true;
+		else if (argument === "--help" || argument === "-h") options.help = true;
+		else if (argument === "--input" || argument === "--output" || argument === "--min-occurrences") {
+			const value = argv[index + 1];
+			if (!value || value.startsWith("--")) throw new Error(`${argument} requires a value.`);
+			index += 1;
+			if (argument === "--input") options.input = value;
+			else if (argument === "--output") options.output = value;
+			else {
+				const parsed = Number(value);
+				if (!Number.isInteger(parsed) || parsed < 2 || parsed > 100) throw new Error("--min-occurrences must be an integer from 2 through 100.");
+				options.minOccurrences = parsed;
+			}
+		} else throw new Error(`Unknown agent feedback flag: ${argument}`);
+	}
+	return options;
+}
+function resolveProjectPath(rootDir, value) {
+	if (path.isAbsolute(value)) throw new Error("Feedback paths must be project-relative.");
+	const candidate = path.resolve(rootDir, value);
+	const relative = path.relative(rootDir, candidate);
+	if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error("Feedback paths must stay inside the project root.");
+	return candidate;
+}
+function writeReport(outputPath, report) {
+	mkdirSync(path.dirname(outputPath), { recursive: true });
+	const temporaryPath = `${outputPath}.${process.pid}.tmp`;
+	writeFileSync(temporaryPath, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+	renameSync(temporaryPath, outputPath);
+}
+async function runAgentFeedbackImprove(options = {}) {
+	const rootDir = path.resolve(options.rootDir ?? process.cwd());
+	const input = options.input ?? ".farming-labs/agent-feedback.jsonl";
+	const output = options.output ?? ".farming-labs/agent-feedback-improvements.json";
+	const report = analyzeDocsAgentFeedback(readDocsAgentFeedbackFile(resolveProjectPath(rootDir, input)), { minOccurrences: options.minOccurrences });
+	if (options.write) {
+		const outputPath = resolveProjectPath(rootDir, output);
+		writeReport(outputPath, report);
+		if (!options.json) console.log(pc.green(`Wrote ${path.relative(rootDir, outputPath)} with ${report.recurringClusterCount} recurring cluster${report.recurringClusterCount === 1 ? "" : "s"}.`));
+	}
+	if (options.json || !options.write) console.log(JSON.stringify(report, null, 2));
+	return report;
+}
+function printAgentFeedbackImproveHelp() {
+	console.log(`${pc.bold("docs agent feedback")} — turn agent feedback into improvement drafts
+
+${pc.dim("Usage:")}
+  docs agent feedback --input .farming-labs/agent-feedback.jsonl
+  docs agent feedback --input feedback.json --write
+
+${pc.dim("Options:")}
+  ${pc.cyan("--input <path>")}             JSON array/object or JSON Lines feedback export
+  ${pc.cyan("--min-occurrences <2-100>")} Recurrence threshold (default: 2)
+  ${pc.cyan("--write")}                    Write the improvement report
+  ${pc.cyan("--output <path>")}            Output path (default: .farming-labs/agent-feedback-improvements.json)
+  ${pc.cyan("--json")}                     Print JSON when writing
+`);
+}
+
+//#endregion
+export { parseAgentFeedbackImproveArgs, printAgentFeedbackImproveHelp, runAgentFeedbackImprove };

package/dist/feedback-evals-k0sFDdms.mjs

@@ -0,0 +1,146 @@
+import { a as compareDocsAgentFeedbackEvaluationBaseline, i as buildDocsAgentFeedbackEvaluationCandidates, o as createDocsAgentFeedbackEvaluationBaseline, t as DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT } from "./agent-feedback-evaluations-DQCTFegz.mjs";
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+
+//#region src/agent-feedback-evaluations-node.ts
+function isRecord(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readJsonFile(filePath) {
+	return JSON.parse(readFileSync(filePath, "utf8"));
+}
+function readDocsAgentFeedbackImprovementReport(filePath) {
+	const value = readJsonFile(filePath);
+	if (!isRecord(value) || value.format !== "farming-labs-agent-feedback-improvements.v1" || !Array.isArray(value.clusters) || typeof value.feedbackCount !== "number" || typeof value.recurringClusterCount !== "number") throw new Error("Input is not a supported agent feedback improvement report.");
+	return value;
+}
+function readDocsAgentEvaluationTasksFile(filePath) {
+	const value = readJsonFile(filePath);
+	if (Array.isArray(value)) return value;
+	if (!isRecord(value)) throw new Error("Existing evaluation tasks must be a JSON object or array.");
+	if (Array.isArray(value.candidates)) return value.candidates.flatMap((candidate) => isRecord(candidate) && isRecord(candidate.task) ? [candidate.task] : []);
+	if (Array.isArray(value.tasks)) return value.tasks;
+	if (isRecord(value.agent) && isRecord(value.agent.evaluations) && Array.isArray(value.agent.evaluations.tasks)) return value.agent.evaluations.tasks;
+	throw new Error("Could not find evaluation tasks in the existing JSON file.");
+}
+function readDocsGoldenTasksReportFile(filePath) {
+	const value = readJsonFile(filePath);
+	const report = isRecord(value) && isRecord(value.evaluations) ? value.evaluations : value;
+	if (!isRecord(report) || !Array.isArray(report.tasks) || typeof report.taskCount !== "number" || !(typeof report.score === "number" || report.score === null)) throw new Error("Input does not contain a golden-task evaluation report.");
+	return report;
+}
+function readDocsAgentFeedbackEvaluationBaseline(filePath) {
+	const value = readJsonFile(filePath);
+	if (!isRecord(value) || value.format !== DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT || typeof value.score !== "number" || !Array.isArray(value.tasks)) throw new Error("Evaluation baseline format is not supported.");
+	return value;
+}
+
+//#endregion
+//#region src/cli/feedback-evals.ts
+function parseAgentFeedbackEvaluationsArgs(argv) {
+	const options = { existing: [] };
+	for (let index = 0; index < argv.length; index += 1) {
+		const argument = argv[index];
+		if (argument === "--write") options.write = true;
+		else if (argument === "--write-baseline") options.writeBaseline = true;
+		else if (argument === "--check") options.check = true;
+		else if (argument === "--allow-new-failures") options.allowNewFailures = true;
+		else if (argument === "--json") options.json = true;
+		else if (argument === "--help" || argument === "-h") options.help = true;
+		else if (argument === "--input" || argument === "--existing" || argument === "--output" || argument === "--results" || argument === "--baseline" || argument === "--max-score-drop") {
+			const value = argv[index + 1];
+			if (!value || value.startsWith("--")) throw new Error(`${argument} requires a value.`);
+			index += 1;
+			if (argument === "--input") options.input = value;
+			else if (argument === "--existing") options.existing.push(value);
+			else if (argument === "--output") options.output = value;
+			else if (argument === "--results") options.results = value;
+			else if (argument === "--baseline") options.baseline = value;
+			else {
+				const parsed = Number(value);
+				if (!Number.isFinite(parsed) || parsed < 0 || parsed > 100) throw new Error("--max-score-drop must be a number from 0 through 100.");
+				options.maxScoreDrop = parsed;
+			}
+		} else throw new Error(`Unknown agent feedback-evals flag: ${argument}`);
+	}
+	return options;
+}
+function resolveProjectPath(rootDir, value) {
+	if (path.isAbsolute(value)) throw new Error("Evaluation paths must be project-relative.");
+	const candidate = path.resolve(rootDir, value);
+	const relative = path.relative(rootDir, candidate);
+	if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error("Evaluation paths must stay inside the project root.");
+	return candidate;
+}
+function writeJson(outputPath, value) {
+	mkdirSync(path.dirname(outputPath), { recursive: true });
+	const temporaryPath = `${outputPath}.${process.pid}.tmp`;
+	writeFileSync(temporaryPath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+	renameSync(temporaryPath, outputPath);
+}
+async function runCandidateMode(rootDir, options) {
+	const registry = buildDocsAgentFeedbackEvaluationCandidates(readDocsAgentFeedbackImprovementReport(resolveProjectPath(rootDir, options.input ?? ".farming-labs/agent-feedback-improvements.json")), { existingTasks: (options.existing ?? []).flatMap((filePath) => readDocsAgentEvaluationTasksFile(resolveProjectPath(rootDir, filePath))) });
+	if (options.write) {
+		const outputPath = resolveProjectPath(rootDir, options.output ?? ".farming-labs/agent-evaluation-candidates.json");
+		writeJson(outputPath, registry);
+		if (!options.json) console.log(pc.green(`Wrote ${path.relative(rootDir, outputPath)} with ${registry.candidateCount} review-required candidate${registry.candidateCount === 1 ? "" : "s"}.`));
+	}
+	if (options.json || !options.write) console.log(JSON.stringify(registry, null, 2));
+	return registry;
+}
+async function runRegressionMode(rootDir, options) {
+	if (!options.results || !options.baseline) throw new Error("--results and --baseline are required for baseline or regression mode.");
+	const results = readDocsGoldenTasksReportFile(resolveProjectPath(rootDir, options.results));
+	const baselinePath = resolveProjectPath(rootDir, options.baseline);
+	if (options.writeBaseline) {
+		const baseline = createDocsAgentFeedbackEvaluationBaseline(results);
+		writeJson(baselinePath, baseline);
+		if (!options.json) console.log(pc.green(`Wrote ${path.relative(rootDir, baselinePath)}.`));
+		if (options.json) console.log(JSON.stringify(baseline, null, 2));
+		return;
+	}
+	const comparison = compareDocsAgentFeedbackEvaluationBaseline(results, readDocsAgentFeedbackEvaluationBaseline(baselinePath), {
+		maxScoreDrop: options.maxScoreDrop,
+		failOnNewFailures: options.allowNewFailures !== true
+	});
+	console.log(JSON.stringify(comparison, null, 2));
+	if (options.check && !comparison.passed) throw new Error(`Agent evaluation regression check failed with ${comparison.regressions.length} regression(s).`);
+	return comparison;
+}
+async function runAgentFeedbackEvaluations(options = {}) {
+	const rootDir = path.resolve(options.rootDir ?? process.cwd());
+	if (options.writeBaseline && options.check) throw new Error("--write-baseline and --check are separate operations.");
+	if (options.results !== void 0 || options.baseline !== void 0 || options.writeBaseline === true || options.check === true) return runRegressionMode(rootDir, options);
+	return runCandidateMode(rootDir, options);
+}
+function printAgentFeedbackEvaluationsHelp() {
+	console.log(`${pc.bold("docs agent feedback-evals")} — promote feedback into reviewed evaluations and guard regressions
+
+${pc.dim("Candidate usage:")}
+  docs agent feedback-evals --input .farming-labs/agent-feedback-improvements.json
+  docs agent feedback-evals --existing docs-evaluations.json --write
+
+${pc.dim("Regression usage:")}
+  docs agent feedback-evals --results doctor.json --baseline .farming-labs/agent-evaluation-baseline.json --write-baseline
+  docs agent feedback-evals --results doctor.json --baseline .farming-labs/agent-evaluation-baseline.json --check
+
+${pc.dim("Options:")}
+  ${pc.cyan("--input <path>")}             Feedback improvement report
+  ${pc.cyan("--existing <path>")}          Repeatable registry/config/task JSON used for deduplication
+  ${pc.cyan("--write")}                    Write sanitized candidates
+  ${pc.cyan("--output <path>")}            Candidate output (default: .farming-labs/agent-evaluation-candidates.json)
+  ${pc.cyan("--results <path>")}           Golden-task or doctor JSON evaluation results
+  ${pc.cyan("--baseline <path>")}          Baseline JSON path
+  ${pc.cyan("--write-baseline")}           Create or replace the baseline from --results
+  ${pc.cyan("--check")}                    Fail when results regress from the baseline
+  ${pc.cyan("--max-score-drop <0-100>")}   Allowed suite/task score decrease (default: 0)
+  ${pc.cyan("--allow-new-failures")}        Do not fail only because a newly added task fails
+  ${pc.cyan("--json")}                     Print written candidate/baseline JSON
+
+Candidates are redacted, deduplicated, and never added to docs.config without human review.
+`);
+}
+
+//#endregion
+export { parseAgentFeedbackEvaluationsArgs, printAgentFeedbackEvaluationsHelp, runAgentFeedbackEvaluations };

package/dist/{golden-evaluations-K45fcWGW.mjs → golden-evaluations-De4KwoYr.mjs}

@@ -1,6 +1,6 @@
-import { Cn as findDocsAudienceMdxTags, Mn as normalizeAgentVersion, On as agentVersionConstraintsOverlap, Tn as resolveDocsAudienceMdxContent, kn as normalizeAgentFramework } from "./agent-CFqECAG0.mjs";
-import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
-import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-Bel6vDqI.mjs";
+import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-BKy4labo.mjs";
+import { An as normalizeAgentFramework, En as resolveDocsAudienceMdxContent, Nn as normalizeAgentVersion, kn as agentVersionConstraintsOverlap, wn as findDocsAudienceMdxTags } from "./agent-DCTGj6J7.mjs";
+import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-D90CCJFs.mjs";
 import { isMap, isScalar, isSeq, parseDocument } from "yaml";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";