@farming-labs/docs 0.2.104 → 0.2.106

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-B5KTe1Xo.mjs";
+import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-BDmra6mz.mjs";
 import pc from "picocolors";
 
 //#region src/cli/index.ts
@@ -116,54 +116,70 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-DKukQdOQ.mjs");
+		const { init } = await import("../init-CCV2eRNB.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-B0iHJjTz.mjs");
+		const { dev } = await import("../dev-Bx0JNglW.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-BLxt_HYO.mjs");
+		const { runCloudDeploy } = await import("../cloud-Bvof6mET.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-BLxt_HYO.mjs");
+		const { runCloudPreview } = await import("../cloud-Bvof6mET.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-BLxt_HYO.mjs");
+		const { runCloudDeploy } = await import("../cloud-Bvof6mET.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-BLxt_HYO.mjs");
+		const { runCloudPreview } = await import("../cloud-Bvof6mET.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-BLxt_HYO.mjs");
+		const { runCloudInit } = await import("../cloud-Bvof6mET.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-BLxt_HYO.mjs");
+		const { syncCloudConfig } = await import("../cloud-Bvof6mET.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-BLxt_HYO.mjs");
+		const { runCloudCheck } = await import("../cloud-Bvof6mET.mjs");
 		await runCloudCheck(cloudOptions);
 	} else if (parsedCommand.command === "cloud") {
 		console.error(pc.red(`Unknown cloud subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCloudHelp } = await import("../cloud-BLxt_HYO.mjs");
+		const { printCloudHelp } = await import("../cloud-Bvof6mET.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp" && subcommand === "author") {
-		const { runAuthoringMcp } = await import("../authoring-BsWXMH43.mjs");
+		const { runAuthoringMcp } = await import("../authoring-Do87QzBd.mjs");
 		await runAuthoringMcp(authoringMcpOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-B6ZZdp6F.mjs");
+		const { runMcp } = await import("../mcp-DsjWxF7g.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "feedback") {
-		const { parseAgentFeedbackImproveArgs, printAgentFeedbackImproveHelp, runAgentFeedbackImprove } = await import("../feedback-DdWc33oO.mjs");
+		const { parseAgentFeedbackImproveArgs, printAgentFeedbackImproveHelp, runAgentFeedbackImprove } = await import("../feedback-DWVUMrxy.mjs");
 		const feedbackOptions = parseAgentFeedbackImproveArgs(args.slice(2));
 		if (feedbackOptions.help) {
 			printAgentFeedbackImproveHelp();
 			return;
 		}
 		await runAgentFeedbackImprove(feedbackOptions);
+	} else if (parsedCommand.command === "agent" && subcommand === "feedback-evals") {
+		const { parseAgentFeedbackEvaluationsArgs, printAgentFeedbackEvaluationsHelp, runAgentFeedbackEvaluations } = await import("../feedback-evals-k0sFDdms.mjs");
+		const evaluationOptions = parseAgentFeedbackEvaluationsArgs(args.slice(2));
+		if (evaluationOptions.help) {
+			printAgentFeedbackEvaluationsHelp();
+			return;
+		}
+		await runAgentFeedbackEvaluations(evaluationOptions);
+	} else if (parsedCommand.command === "agent" && subcommand === "propose") {
+		const { parseAgentMaintenanceProposeArgs, printAgentMaintenanceProposeHelp, runAgentMaintenancePropose } = await import("../propose-DJOiHu9Y.mjs");
+		const proposeOptions = parseAgentMaintenanceProposeArgs(args.slice(2));
+		if (proposeOptions.help) {
+			printAgentMaintenanceProposeHelp();
+			return;
+		}
+		await runAgentMaintenancePropose(proposeOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-NerpHcQB.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-CaCWThBY.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -171,7 +187,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-DlBUKkTt.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-GcTZPLfB.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -181,15 +197,19 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-NerpHcQB.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-DlBUKkTt.mjs");
-		const { printAgentFeedbackImproveHelp } = await import("../feedback-DdWc33oO.mjs");
+		const { printAgentCompactHelp } = await import("../agent-CaCWThBY.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-GcTZPLfB.mjs");
+		const { printAgentFeedbackImproveHelp } = await import("../feedback-DWVUMrxy.mjs");
+		const { printAgentFeedbackEvaluationsHelp } = await import("../feedback-evals-k0sFDdms.mjs");
+		const { printAgentMaintenanceProposeHelp } = await import("../propose-DJOiHu9Y.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		printAgentFeedbackImproveHelp();
+		printAgentFeedbackEvaluationsHelp();
+		printAgentMaintenanceProposeHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-D3SLnQet.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-e1SYT64z.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -199,11 +219,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-D3SLnQet.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-e1SYT64z.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "skills" && subcommand === "scaffold") {
-		const { parseSkillScaffoldArgs, printSkillScaffoldHelp, scaffoldSkillFromContracts } = await import("../skills-aaE5L1go.mjs");
+		const { parseSkillScaffoldArgs, printSkillScaffoldHelp, scaffoldSkillFromContracts } = await import("../skills-BILSESek.mjs");
 		const skillOptions = parseSkillScaffoldArgs(args.slice(2));
 		if (skillOptions.help) {
 			printSkillScaffoldHelp();
@@ -211,16 +231,16 @@ async function main() {
 		}
 		await scaffoldSkillFromContracts(skillOptions);
 	} else if (parsedCommand.command === "skills" && (subcommand === "--help" || subcommand === "-h")) {
-		const { printSkillScaffoldHelp } = await import("../skills-aaE5L1go.mjs");
+		const { printSkillScaffoldHelp } = await import("../skills-BILSESek.mjs");
 		printSkillScaffoldHelp();
 	} else if (parsedCommand.command === "skills") {
 		console.error(pc.red(`Unknown skills subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSkillScaffoldHelp } = await import("../skills-aaE5L1go.mjs");
+		const { printSkillScaffoldHelp } = await import("../skills-BILSESek.mjs");
 		printSkillScaffoldHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-x3k6aE2I.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CtK1CRPj.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -228,7 +248,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-DgaNTtP0.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-XI9FXeos.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -236,7 +256,7 @@ async function main() {
 		}
 		await runReview(reviewOptions);
 	} else if ((parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") && subcommand === "validate") {
-		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-qHdKGVaE.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-C911CdyJ.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -246,11 +266,11 @@ async function main() {
 	} else if (parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") {
 		console.error(pc.red(`Unknown codeblocks subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCodeBlocksValidateHelp } = await import("../codeblocks-qHdKGVaE.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-C911CdyJ.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-CNzq9S5S.mjs");
+		const { syncSearch } = await import("../search-DwAoC9X7.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -258,7 +278,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-CHvips7o.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-DOaJIKJf.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -268,11 +288,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-CHvips7o.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-DOaJIKJf.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-msD1xoH5.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-CzKesbdX.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -282,11 +302,11 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-msD1xoH5.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-CzKesbdX.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-Dd3vvVdD.mjs");
+		const { downgrade } = await import("../downgrade-BXmQMkMy.mjs");
 		const framework = (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0);
 		const hasVersionFlag = args.includes("--version") || args.some((arg) => arg.startsWith("--version="));
 		await downgrade({
@@ -295,7 +315,7 @@ async function main() {
 			dryRun: flags["dry-run"] === true
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-B0OA_7jE.mjs");
+		const { upgrade } = await import("../upgrade-B92U83xo.mjs");
 		const framework = (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0);
 		const hasVersionFlag = args.includes("--version") || args.some((arg) => arg.startsWith("--version="));
 		const version = typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0;
@@ -415,6 +435,22 @@ ${pc.dim("Options for agent feedback:")}
   ${pc.cyan("--output <path>")}                     Override the written report path
   ${pc.cyan("--json")}                              Print JSON while writing
 
+${pc.dim("Options for feedback-derived evaluations:")}
+  ${pc.cyan("agent feedback-evals --write")}        Sanitize and deduplicate feedback-derived golden-task candidates
+  ${pc.cyan("--existing <path>")}                   Compare against an existing candidate registry, task list, or config JSON
+  ${pc.cyan("--results <path> --baseline <path>")} Read golden-task or doctor JSON for baseline comparison
+  ${pc.cyan("--write-baseline")}                    Create or replace an explicit evaluation baseline
+  ${pc.cyan("--check")}                             Fail CI when suite/task results regress
+  ${pc.cyan("--max-score-drop <0-100>")}            Allow a bounded suite/task score decrease
+
+${pc.dim("Options for agent maintenance proposals:")}
+  ${pc.cyan("agent propose --input <path>")}        Combine JSON/JSONL feedback, search, MCP, issue, support, and git signals
+  ${pc.cyan("--input <path>")}                      Repeat to combine multiple signal exports
+  ${pc.cyan("--min-occurrences <1-100>")}           Proposal threshold (default: 2)
+  ${pc.cyan("--write")}                             Write the draft-only report to ${pc.dim(".farming-labs/agent-maintenance-proposals.json")}
+  ${pc.cyan("--output <path>")}                     Override the written report path
+  ${pc.cyan("--json")}                              Print JSON while writing
+
 ${pc.dim("Options for skills scaffold:")}
   ${pc.cyan("skills scaffold [name]")}              Compile page agent contracts into a compact ${pc.dim("SKILL.md")} router and focused references
   ${pc.cyan("--output <directory>")}                Write to a full skill directory; defaults to ${pc.dim("skills/<name>")}

package/dist/client/react.d.mts

@@ -1,4 +1,4 @@
-import { ft as DocsAnalyticsConfig } from "../types-BthCiAD9.mjs";
+import { mt as DocsAnalyticsConfig } from "../types-QhYMnKvb.mjs";
 import { ReactNode } from "react";
 
 //#region src/docs-cloud-client.d.ts

package/dist/client/react.mjs

@@ -1,6 +1,6 @@
 "use client";
 
-import { n as sendDocsCloudAnalyticsEvent } from "../cloud-analytics-CSyFE6SS.mjs";
+import { n as sendDocsCloudAnalyticsEvent } from "../cloud-analytics-Ci1yiwD8.mjs";
 import { useEffect } from "react";
 
 //#region src/docs-cloud-client.ts

package/dist/{cloud-BLxt_HYO.mjs → cloud-Bvof6mET.mjs}

@@ -1,6 +1,6 @@
-import { n as markCliErrorReported } from "./errors-B5KTe1Xo.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BhF6J2N4.mjs";
-import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-DcCUwxqS.mjs";
+import { n as markCliErrorReported } from "./errors-BDmra6mz.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-DrZ3fXgf.mjs";
+import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-Cc1SrVza.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";

package/dist/{cloud-ask-ai-19G2HJ62.d.mts → cloud-ask-ai-BqfiQaNZ.d.mts}

@@ -1,4 +1,4 @@
-import { Et as DocsCloudConfig, ft as DocsAnalyticsConfig, t as AIConfig } from "./types-BthCiAD9.mjs";
+import { Ot as DocsCloudConfig, mt as DocsAnalyticsConfig, t as AIConfig } from "./types-QhYMnKvb.mjs";
 
 //#region src/cloud-ask-ai.d.ts
 interface DocsCloudAskAIConfig {

package/dist/{cloud-ask-ai-DeojA5lB.mjs → cloud-ask-ai-CK2qlNns.mjs}

@@ -1,4 +1,4 @@
-import { a as emitDocsAnalyticsEvent } from "./analytics-Bx44lg6d.mjs";
+import { a as emitDocsAnalyticsEvent } from "./analytics-CqfcIBdg.mjs";
 
 //#region src/cloud-ask-ai.ts
 const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";

package/dist/{codeblocks-qHdKGVaE.mjs → codeblocks-C911CdyJ.mjs}

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