@farming-labs/docs 0.2.103 → 0.2.104

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-DZiNXv5c.mjs";
+import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-B5KTe1Xo.mjs";
 import pc from "picocolors";
 
 //#region src/cli/index.ts
@@ -32,7 +32,9 @@ function parseFlags(argv) {
 		"analytics",
 		"ask-ai",
 		"deploy",
-		"dry-run"
+		"dry-run",
+		"write",
+		"allow-publish"
 	]);
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
@@ -70,6 +72,12 @@ async function main() {
 		client: typeof flags.client === "string" ? flags.client : void 0,
 		json: typeof flags.json === "boolean" ? flags.json : void 0
 	};
+	const authoringMcpOptions = {
+		configPath: typeof flags.config === "string" ? flags.config : void 0,
+		allowPublish: typeof flags["allow-publish"] === "boolean" ? flags["allow-publish"] : void 0,
+		branchPrefix: typeof flags["branch-prefix"] === "string" ? flags["branch-prefix"] : void 0,
+		baseBranch: typeof flags["base-branch"] === "string" ? flags["base-branch"] : void 0
+	};
 	const devOptions = {
 		verbose: typeof flags.verbose === "boolean" ? flags.verbose : void 0,
 		port: typeof flags.port === "string" ? flags.port : void 0,
@@ -108,43 +116,54 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-jDQSo-Or.mjs");
+		const { init } = await import("../init-DKukQdOQ.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-BvbYmTLz.mjs");
+		const { dev } = await import("../dev-B0iHJjTz.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-FNfcbfli.mjs");
+		const { runCloudDeploy } = await import("../cloud-BLxt_HYO.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-FNfcbfli.mjs");
+		const { runCloudPreview } = await import("../cloud-BLxt_HYO.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-FNfcbfli.mjs");
+		const { runCloudDeploy } = await import("../cloud-BLxt_HYO.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-FNfcbfli.mjs");
+		const { runCloudPreview } = await import("../cloud-BLxt_HYO.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-FNfcbfli.mjs");
+		const { runCloudInit } = await import("../cloud-BLxt_HYO.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-FNfcbfli.mjs");
+		const { syncCloudConfig } = await import("../cloud-BLxt_HYO.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-FNfcbfli.mjs");
+		const { runCloudCheck } = await import("../cloud-BLxt_HYO.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-FNfcbfli.mjs");
+		const { printCloudHelp } = await import("../cloud-BLxt_HYO.mjs");
 		printCloudHelp();
 		process.exit(1);
+	} else if (parsedCommand.command === "mcp" && subcommand === "author") {
+		const { runAuthoringMcp } = await import("../authoring-BsWXMH43.mjs");
+		await runAuthoringMcp(authoringMcpOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-CwgKlbIz.mjs");
+		const { runMcp } = await import("../mcp-B6ZZdp6F.mjs");
 		await runMcp(mcpOptions);
+	} else if (parsedCommand.command === "agent" && subcommand === "feedback") {
+		const { parseAgentFeedbackImproveArgs, printAgentFeedbackImproveHelp, runAgentFeedbackImprove } = await import("../feedback-DdWc33oO.mjs");
+		const feedbackOptions = parseAgentFeedbackImproveArgs(args.slice(2));
+		if (feedbackOptions.help) {
+			printAgentFeedbackImproveHelp();
+			return;
+		}
+		await runAgentFeedbackImprove(feedbackOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BLHMoVId.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-NerpHcQB.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -152,7 +171,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-oiWxB5aX.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-DlBUKkTt.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -162,13 +181,15 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-BLHMoVId.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-oiWxB5aX.mjs");
+		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");
 		printAgentCompactHelp();
 		printAgentExportHelp();
+		printAgentFeedbackImproveHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-CtqIUW5I.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-D3SLnQet.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -178,11 +199,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-CtqIUW5I.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-D3SLnQet.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "skills" && subcommand === "scaffold") {
-		const { parseSkillScaffoldArgs, printSkillScaffoldHelp, scaffoldSkillFromContracts } = await import("../skills-BFang8vF.mjs");
+		const { parseSkillScaffoldArgs, printSkillScaffoldHelp, scaffoldSkillFromContracts } = await import("../skills-aaE5L1go.mjs");
 		const skillOptions = parseSkillScaffoldArgs(args.slice(2));
 		if (skillOptions.help) {
 			printSkillScaffoldHelp();
@@ -190,16 +211,16 @@ async function main() {
 		}
 		await scaffoldSkillFromContracts(skillOptions);
 	} else if (parsedCommand.command === "skills" && (subcommand === "--help" || subcommand === "-h")) {
-		const { printSkillScaffoldHelp } = await import("../skills-BFang8vF.mjs");
+		const { printSkillScaffoldHelp } = await import("../skills-aaE5L1go.mjs");
 		printSkillScaffoldHelp();
 	} else if (parsedCommand.command === "skills") {
 		console.error(pc.red(`Unknown skills subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSkillScaffoldHelp } = await import("../skills-BFang8vF.mjs");
+		const { printSkillScaffoldHelp } = await import("../skills-aaE5L1go.mjs");
 		printSkillScaffoldHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-Bmm0uY98.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-x3k6aE2I.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -207,7 +228,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-C_5wB0rR.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-DgaNTtP0.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -215,7 +236,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-jbWuvtJQ.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-qHdKGVaE.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -225,11 +246,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-jbWuvtJQ.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-qHdKGVaE.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-B5etKU-v.mjs");
+		const { syncSearch } = await import("../search-CNzq9S5S.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -237,7 +258,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-DjhxvQP1.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-CHvips7o.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -247,11 +268,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-DjhxvQP1.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-CHvips7o.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-BQ42Y84a.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-msD1xoH5.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -261,11 +282,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-BQ42Y84a.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-msD1xoH5.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-Dqm0rJMy.mjs");
+		const { downgrade } = await import("../downgrade-Dd3vvVdD.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({
@@ -274,7 +295,7 @@ async function main() {
 			dryRun: flags["dry-run"] === true
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-kj2crJSk.mjs");
+		const { upgrade } = await import("../upgrade-B0OA_7jE.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;
@@ -306,13 +327,13 @@ ${pc.dim("Commands:")}
   ${pc.cyan("deploy")}   Sync cloud config and deploy hosted preview docs
   ${pc.cyan("preview")}  Alias for ${pc.cyan("deploy")}
   ${pc.cyan("cloud")}    Docs Cloud utilities (${pc.dim("init")}, ${pc.dim("check")}, ${pc.dim("deploy")}, ${pc.dim("preview")}, ${pc.dim("sync")})
-  ${pc.cyan("agent")}    Agent utilities (${pc.dim("compact")} page context, ${pc.dim("export")} static bundles)
+  ${pc.cyan("agent")}    Agent utilities (${pc.dim("compact")}, ${pc.dim("export")}, ${pc.dim("feedback")})
   ${pc.cyan("agents")}   AGENTS.md utilities (${pc.dim("generate")} for static agent instructions)
   ${pc.cyan("skills")}   Agent Skills utilities (${pc.dim("scaffold")} from structured page contracts)
   ${pc.cyan("doctor")}   Inspect and score agent or reader-facing docs quality
   ${pc.cyan("review")}   Review changed docs files and wire Docs Review CI
   ${pc.cyan("codeblocks")} Validate fenced MDX code blocks (${pc.dim("validate")})
-  ${pc.cyan("mcp")}      Run the built-in docs MCP server over stdio
+  ${pc.cyan("mcp")}      Run read-only docs MCP or the separate protected authoring server
   ${pc.cyan("robots")}   Robots.txt utilities (${pc.dim("generate")} for agent access policy)
   ${pc.cyan("search")}   Search utilities (${pc.dim("sync")} for external indexes)
   ${pc.cyan("sitemap")}  Sitemap utilities (${pc.dim("generate")} for sitemap XML/Markdown data)
@@ -339,6 +360,10 @@ ${pc.dim("Options for mcp:")}
   ${pc.cyan("--api-base-url <url>")} Override the hosted Docs Cloud API base URL for ${pc.cyan("mcp setup")}
   ${pc.cyan("--client <name>")}     Emit native config for ${pc.dim("claude-code")}, ${pc.dim("cursor")}, or ${pc.dim("vscode")}
   ${pc.cyan("--json")}              Print the selected MCP client JSON only for ${pc.cyan("mcp setup")}
+  ${pc.cyan("mcp author")}          Run the local docs-authoring MCP over stdio
+  ${pc.cyan("--branch-prefix <p>")} Restrict authoring branches (default: ${pc.dim("docs/")})
+  ${pc.cyan("--base-branch <name>")} Set the base used for authoring draft PRs
+  ${pc.cyan("--allow-publish")}      Explicitly register commit, push, and draft-PR publishing
 
 ${pc.dim("Options for dev:")}
   ${pc.cyan("--port <number>")}     Run the frameworkless preview on a custom port
@@ -383,6 +408,13 @@ ${pc.dim("Options for agent export:")}
   ${pc.cyan("agent export --check")}                Fail when the static Agent Bundle is stale
   ${pc.cyan("--config <path>")}                     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
 
+${pc.dim("Options for agent feedback:")}
+  ${pc.cyan("agent feedback --input <path>")}       Cluster JSON or JSONL agent feedback into improvement drafts
+  ${pc.cyan("--min-occurrences <2-100>")}           Recurrence threshold (default: 2)
+  ${pc.cyan("--write")}                             Write the report to ${pc.dim(".farming-labs/agent-feedback-improvements.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-DLLefoU5.mjs";
+import { ft as DocsAnalyticsConfig } from "../types-BthCiAD9.mjs";
 import { ReactNode } from "react";
 
 //#region src/docs-cloud-client.d.ts

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

@@ -1,6 +1,6 @@
-import { n as markCliErrorReported } from "./errors-DZiNXv5c.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-BaTmjDqD.mjs";
-import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-DOMeZW9V.mjs";
+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 fs from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";

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

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

package/dist/{code-blocks-Bel6vDqI.mjs → code-blocks-c3nIrWOM.mjs}

@@ -1,8 +1,8 @@
 import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { execFile } from "node:child_process";
-import { tmpdir } from "node:os";
 import { promisify } from "node:util";
+import { tmpdir } from "node:os";
 
 //#region src/code-blocks.ts
 const execFileAsync = promisify(execFile);

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

@@ -1,5 +1,5 @@
-import { a as validateCodeBlocks, r as resolveDocsCodeBlocksValidateConfig } from "./code-blocks-Bel6vDqI.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-BaTmjDqD.mjs";
+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 { existsSync, readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/{dev-BvbYmTLz.mjs → dev-B0iHJjTz.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-DcCUwxqS.mjs";
+import { $ as postcssConfigTemplate, C as globalCssTemplate, g as docsLayoutTemplate, kt as tsconfigTemplate, tt as rootLayoutTemplate } from "./templates-m_j4ARnu.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 { ft as DocsAnalyticsConfig, mt as DocsAnalyticsEventInput, pt as DocsAnalyticsEvent } from "./types-BthCiAD9.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-19G2HJ62.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 { t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-DeojA5lB.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-x3k6aE2I.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 { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-NerpHcQB.mjs";
+import { d as httpLinkHeaderHasTargetRelation, f as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, p as readAgentSkillDocumentFromTar } from "./prompt-references-Ca2Rcrpw.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, or as resolveDocsOkfConfig, pn as resolveAskAISearchRequestConfig, qn as isDocsMcpOAuthScopeToken, sr as resolveDocsOkfTrustMetadata, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-PSrgiJD8.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 { 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 "./openapi-mcp-B7u7Y0gB.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-DNod0XKB.mjs";
 import { a as resolveDocsMetadataBaseUrl } from "./metadata-D4v_R1t5.mjs";
-import "./sitemap-server-B0SiREN0.mjs";
+import "./sitemap-server-C2TauhKa.mjs";
 import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-DFqQyO_V.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-GpcaCbRb.mjs";
+import { t as runDocsGoldenTasks } from "./agent-evals-U9d_db2u.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-Bel6vDqI.mjs";
+import "./authoring-mcp-BCM5CJbJ.mjs";
+import "./code-blocks-c3nIrWOM.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-BhF6J2N4.mjs";
+import { t as detectFramework } from "./utils-DcCUwxqS.mjs";
+import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-7k7Akp3R.mjs";
+import { t as analyzeConfiguredAgentSkillsProgressiveDisclosure } from "./agent-skills-progressive-disclosure-CfIsq4Ew.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-Dd3vvVdD.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-DcCUwxqS.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-P4TT_9IO.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/feedback-DdWc33oO.mjs

@@ -0,0 +1,72 @@
+import { n as analyzeDocsAgentFeedback, r as readDocsAgentFeedbackFile } from "./agent-feedback-loop-CGrc-gDW.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/{golden-evaluations-K45fcWGW.mjs → golden-evaluations-7k7Akp3R.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 { Cn as findDocsAudienceMdxTags, Mn as normalizeAgentVersion, On as agentVersionConstraintsOverlap, Tn as resolveDocsAudienceMdxContent, kn as normalizeAgentFramework } from "./agent-PSrgiJD8.mjs";
 import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
-import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-Bel6vDqI.mjs";
+import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-c3nIrWOM.mjs";
 import { isMap, isScalar, isSeq, parseDocument } from "yaml";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";