@farming-labs/docs 0.2.106 → 0.2.108

package/dist/cli/index.mjs

@@ -149,12 +149,13 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp" && subcommand === "author") {
-		const { runAuthoringMcp } = await import("../authoring-Do87QzBd.mjs");
+		const { runAuthoringMcp } = await import("../authoring-ct8s0Z_X.mjs");
 		await runAuthoringMcp(authoringMcpOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-DsjWxF7g.mjs");
+		const { runMcp } = await import("../mcp-CC74oNj3.mjs");
 		await runMcp(mcpOptions);
-	} else if (parsedCommand.command === "agent" && subcommand === "feedback") {
+	} else if (parsedCommand.command === "agent" && (subcommand === "--help" || subcommand === "-h")) printAgentHelp();
+	else if (parsedCommand.command === "agent" && subcommand === "feedback") {
 		const { parseAgentFeedbackImproveArgs, printAgentFeedbackImproveHelp, runAgentFeedbackImprove } = await import("../feedback-DWVUMrxy.mjs");
 		const feedbackOptions = parseAgentFeedbackImproveArgs(args.slice(2));
 		if (feedbackOptions.help) {
@@ -179,7 +180,7 @@ async function main() {
 		}
 		await runAgentMaintenancePropose(proposeOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-CaCWThBY.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent--fSgaVIK.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -187,7 +188,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-GcTZPLfB.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-CSdby81L.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -197,19 +198,10 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		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();
+		printAgentHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-e1SYT64z.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-DDt41QR8.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -219,11 +211,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-e1SYT64z.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-DDt41QR8.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "skills" && subcommand === "scaffold") {
-		const { parseSkillScaffoldArgs, printSkillScaffoldHelp, scaffoldSkillFromContracts } = await import("../skills-BILSESek.mjs");
+		const { parseSkillScaffoldArgs, printSkillScaffoldHelp, scaffoldSkillFromContracts } = await import("../skills-Bucp3wjq.mjs");
 		const skillOptions = parseSkillScaffoldArgs(args.slice(2));
 		if (skillOptions.help) {
 			printSkillScaffoldHelp();
@@ -231,16 +223,16 @@ async function main() {
 		}
 		await scaffoldSkillFromContracts(skillOptions);
 	} else if (parsedCommand.command === "skills" && (subcommand === "--help" || subcommand === "-h")) {
-		const { printSkillScaffoldHelp } = await import("../skills-BILSESek.mjs");
+		const { printSkillScaffoldHelp } = await import("../skills-Bucp3wjq.mjs");
 		printSkillScaffoldHelp();
 	} else if (parsedCommand.command === "skills") {
 		console.error(pc.red(`Unknown skills subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSkillScaffoldHelp } = await import("../skills-BILSESek.mjs");
+		const { printSkillScaffoldHelp } = await import("../skills-Bucp3wjq.mjs");
 		printSkillScaffoldHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CtK1CRPj.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-DESIZy7v.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -248,7 +240,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-XI9FXeos.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-glShh1or.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -270,7 +262,7 @@ async function main() {
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-DwAoC9X7.mjs");
+		const { syncSearch } = await import("../search-BOOiOwTS.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -278,7 +270,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-DOaJIKJf.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-Ck1YKSAJ.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -288,11 +280,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-DOaJIKJf.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-Ck1YKSAJ.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-CzKesbdX.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-D6RgVpll.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -302,7 +294,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-CzKesbdX.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-D6RgVpll.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
@@ -334,6 +326,22 @@ async function main() {
 		process.exit(1);
 	}
 }
+function printAgentHelp() {
+	console.log(`${pc.bold("docs agent")} — Agent documentation utilities
+
+Usage:
+  docs agent <command> [options]
+
+Commands:
+  ${pc.cyan("compact")}         Generate or refresh page-level ${pc.dim("agent.md")} files
+  ${pc.cyan("export")}          Export or check a static Agent Bundle
+  ${pc.cyan("feedback")}        Cluster recurring agent feedback into improvement drafts
+  ${pc.cyan("feedback-evals")}  Create reviewed evaluation candidates and regression baselines
+  ${pc.cyan("propose")}         Combine recurring signals into maintenance proposals
+
+Run ${pc.cyan("docs agent <command> --help")} for command-specific options.
+`);
+}
 function printHelp() {
 	console.log(`
 ${pc.bold("@farming-labs/docs")} — Documentation framework CLI
@@ -415,6 +423,8 @@ ${pc.dim("Options for agent compact:")}
   ${pc.cyan("agent compact --all")}                 Compact every folder-based docs page
   ${pc.cyan("agent compact --changed")}             Compact only docs pages changed in the current git working tree
   ${pc.cyan("agent compact --stale")}               Refresh only stale generated ${pc.dim("agent.md")} files
+  ${pc.cyan("agent compact --check")}               Fail when generated ${pc.dim("agent.md")} files are stale or required files are missing
+  ${pc.cyan("agent compact --review <page...>")}    Record hash-bound human review without rewriting ${pc.dim("agent.md")}
   ${pc.cyan("--page <slug|path>")}                  Repeatable explicit page flag; positional page args work too
   ${pc.cyan("--include-missing")}                   With ${pc.cyan("--stale")}, also create explicit or token-budget pages missing ${pc.dim("agent.md")}
   ${pc.cyan("--api-key <key>")}                     Use an API key directly; prefer ${pc.dim("cloud.apiKey.env")}
@@ -472,6 +482,8 @@ ${pc.dim("Options for doctor:")}
   ${pc.cyan("doctor --agent --fix")}                Refresh stale generated ${pc.dim("agent.md")} files and token-budget missing outputs
   ${pc.cyan("doctor --agent --fix --dry-run")}      Report the fix command without writing generated ${pc.dim("agent.md")} files
   ${pc.cyan("doctor --fail-on warn|fail")}          Choose whether warnings or only failures fail CI
+  ${pc.cyan("doctor --timeout <ms>")}               Set each hosted probe timeout (default: ${pc.dim("15000")})
+  ${pc.cyan("doctor --retries <0-5>")}              Retry safe hosted GET/HEAD probes (default: ${pc.dim("1")})
   ${pc.cyan("doctor agent")}                        Subcommand alias for agent scoring
   ${pc.cyan("doctor site")}                         Subcommand alias for reader-facing scoring
   ${pc.cyan("doctor human")}                        Legacy alias for reader-facing scoring
@@ -550,4 +562,4 @@ main().catch((err) => {
 });
 
 //#endregion
-export { formatCliError, parseCommandAlias, parseFlags };
+export { formatCliError, parseCommandAlias, parseFlags, printAgentHelp };

package/dist/client/react.d.mts

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

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

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

package/dist/{content-change-hydration-CoYRs3pC.d.mts → content-change-hydration-CDuohygf.d.mts}

@@ -1,5 +1,5 @@
-import { Ar as LlmsTxtConfig, Bn as DocsSearchAdapterFactory, Bt as DocsConfig, En as DocsPaginatedSearchResponse, Er as FeedbackConfig, Et as DocsAskAIMcpConfig, Gn as DocsSearchChunkingConfig, In as DocsRobotsConfig, J as DocsAgentFeedbackData, Kn as DocsSearchConfig, Kt as DocsContentChangesResponse, L as DocsAgentContentChangesConfig, Mr as LlmsTxtMaxCharsMode, Nr as LlmsTxtSectionConfig, Pr as McpDocsSearchConfig, Qn as DocsSearchFacetsResponse, Rn as DocsSearchAdapter, Tn as DocsPageAccessPolicy, Xr as PageAgentFrontmatter, Zt as DocsI18nConfig, _r as DocsSitemapConfig, bn as DocsOkfTrustMetadataInput, f as CustomDocsSearchConfig, fr as DocsSearchResult, gn as DocsOkfConfig, ii as ResolvedDocsRelatedLink, jr as LlmsTxtMaxCharsConfig, m as DocsAccessPrincipal, mi as TypesenseDocsSearchConfig, mr as DocsSearchSourcePage, nr as DocsSearchFilterInput, qn as DocsSearchDocument, qt as DocsContentSnapshot, r as AlgoliaDocsSearchConfig, rn as DocsMcpConfig, rr as DocsSearchFilters, tr as DocsSearchFilterField, ur as DocsSearchRequest } from "./types-QhYMnKvb.mjs";
-import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-Xm84bS4M.mjs";
+import { $n as DocsSearchFacetsResponse, Dn as DocsPaginatedSearchResponse, Dr as FeedbackConfig, Dt as DocsAskAIMcpConfig, En as DocsPageAccessPolicy, Fr as McpDocsSearchConfig, J as DocsAgentFeedbackData, Jn as DocsSearchDocument, Jt as DocsContentSnapshot, Kn as DocsSearchChunkingConfig, L as DocsAgentContentChangesConfig, Ln as DocsRobotsConfig, Mr as LlmsTxtMaxCharsConfig, Nr as LlmsTxtMaxCharsMode, Pr as LlmsTxtSectionConfig, Qt as DocsI18nConfig, Vn as DocsSearchAdapterFactory, Vt as DocsConfig, Zr as PageAgentFrontmatter, _n as DocsOkfConfig, ai as ResolvedDocsRelatedLink, dr as DocsSearchRequest, f as CustomDocsSearchConfig, hi as TypesenseDocsSearchConfig, hr as DocsSearchSourcePage, in as DocsMcpConfig, ir as DocsSearchFilters, jr as LlmsTxtConfig, m as DocsAccessPrincipal, nr as DocsSearchFilterField, pr as DocsSearchResult, qn as DocsSearchConfig, qt as DocsContentChangesResponse, r as AlgoliaDocsSearchConfig, rr as DocsSearchFilterInput, vr as DocsSitemapConfig, xn as DocsOkfTrustMetadataInput, zn as DocsSearchAdapter } from "./types-BkAk6B2d.mjs";
+import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-CjyUCxdy.mjs";
 import { t as DocsContentAudience } from "./audience-exposure-CkNZNeVX.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig, DocsMcpResolvedPromptsConfig } from "./mcp.mjs";
 

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

@@ -1,5 +1,5 @@
-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";
+import { _t as DocsAnalyticsEventInput, gt as DocsAnalyticsEvent, ht as DocsAnalyticsConfig } from "./types-BkAk6B2d.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-C9dvEBpW.mjs";
 
 //#region src/docs-cloud-server.d.ts
 type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);

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

@@ -1,22 +1,22 @@
-import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-CaCWThBY.mjs";
+import { a as scanDocsPageTargets, i as loadAgentCompactionReviews, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent--fSgaVIK.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 { d as httpLinkHeaderHasTargetRelation, f as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, p as readAgentSkillDocumentFromTar } from "./prompt-references-DVhk8W6r.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-BDrflLmt.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 "./openapi-mcp-DQ3xptKo.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-BOjWB1ky.mjs";
+import "./openapi-mcp-CFWUsMUr.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-dNbBnlVh.mjs";
 import { a as resolveDocsMetadataBaseUrl } from "./metadata-7htr-Xj_.mjs";
-import "./sitemap-server-NeVu8W38.mjs";
+import "./sitemap-server-BKNIqgvq.mjs";
 import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-Ddbf15pY.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-D-sPJfXz.mjs";
+import { t as runDocsGoldenTasks } from "./agent-evals-3m5FXStK.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./authoring-mcp-Be7quE5R.mjs";
+import "./authoring-mcp-Wy-h93DM.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-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 { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-Dc06CZM-.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";
@@ -24,8 +24,12 @@ import { createHash } from "node:crypto";
 import { gunzipSync } from "node:zlib";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/server";
 import pc from "picocolors";
+import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/cli/doctor.ts
+const DEFAULT_HOSTED_TIMEOUT_MS = 15e3;
+const DEFAULT_HOSTED_RETRIES = 1;
+const hostedProbeOptions = new AsyncLocalStorage();
 const NEXT_CONFIG_PATTERN = /^next\.config\.(?:[cm]?js|[cm]?ts)$/;
 const ASTRO_CONFIG_PATTERN = /^astro\.config\.(?:[cm]?js|[cm]?ts)$/;
 const CODE_FILE_PATTERN = /\.(?:[cm]?js|[cm]?ts|jsx|tsx)$/;
@@ -58,6 +62,12 @@ function parseDoctorFailOn(value) {
 	if (value === "warn" || value === "fail") return value;
 	throw new Error("Invalid value for --fail-on. Expected warn or fail.");
 }
+function parseDoctorInteger(flag, value, bounds) {
+	if (!/^\d+$/.test(value)) throw new Error(`Invalid value for ${flag}. Expected an integer.`);
+	const parsed = Number(value);
+	if (parsed < bounds.min || parsed > bounds.max) throw new Error(`Invalid value for ${flag}. Expected a value between ${bounds.min} and ${bounds.max}.`);
+	return parsed;
+}
 function parseDoctorArgs(argv) {
 	const parsed = {};
 	for (let index = 0; index < argv.length; index += 1) {
@@ -152,6 +162,44 @@ function parseDoctorArgs(argv) {
 			index += 1;
 			continue;
 		}
+		if (arg.startsWith("--timeout=")) {
+			const value = parseInlineFlag(arg).value;
+			if (!value) throw new Error("Missing value for --timeout.");
+			parsed.hostedTimeoutMs = parseDoctorInteger("--timeout", value, {
+				min: 100,
+				max: 12e4
+			});
+			continue;
+		}
+		if (arg === "--timeout") {
+			const value = argv[index + 1];
+			if (!value || value.startsWith("--")) throw new Error("Missing value for --timeout.");
+			parsed.hostedTimeoutMs = parseDoctorInteger("--timeout", value, {
+				min: 100,
+				max: 12e4
+			});
+			index += 1;
+			continue;
+		}
+		if (arg.startsWith("--retries=")) {
+			const value = parseInlineFlag(arg).value;
+			if (value === void 0 || value === "") throw new Error("Missing value for --retries.");
+			parsed.hostedRetries = parseDoctorInteger("--retries", value, {
+				min: 0,
+				max: 5
+			});
+			continue;
+		}
+		if (arg === "--retries") {
+			const value = argv[index + 1];
+			if (!value || value.startsWith("--")) throw new Error("Missing value for --retries.");
+			parsed.hostedRetries = parseDoctorInteger("--retries", value, {
+				min: 0,
+				max: 5
+			});
+			index += 1;
+			continue;
+		}
 		if (arg === "--config") {
 			const value = argv[index + 1];
 			if (!value || value.startsWith("--")) throw new Error("Missing value for --config.");
@@ -195,6 +243,8 @@ ${pc.dim("Options:")}
   ${pc.cyan("--dry-run")}          With ${pc.cyan("--fix")}, report the compaction command without writing files
   ${pc.cyan("--fail-on <level>")}  Exit with failure on ${pc.cyan("warn")} or only on ${pc.cyan("fail")}
   ${pc.cyan("--url <url>")}        Probe hosted agent surfaces, e.g. ${pc.dim("https://docs.example.com")}
+  ${pc.cyan("--timeout <ms>")}     Set each hosted probe timeout (default: ${pc.dim(String(DEFAULT_HOSTED_TIMEOUT_MS))})
+  ${pc.cyan("--retries <count>")}  Retry safe hosted GET/HEAD probes (default: ${pc.dim(String(DEFAULT_HOSTED_RETRIES))})
   ${pc.cyan("--config <path>")}    Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
   ${pc.cyan("-h, --help")}         Show this help message
 `);
@@ -677,6 +727,9 @@ function buildCoverage(pages) {
 		explicitCoverage: totalPages === 0 ? 0 : Math.round(explicitPages / Math.max(totalPages, 1) * 100),
 		compaction: {
 			freshGeneratedPages: 0,
+			reviewedGeneratedPages: 0,
+			invalidReviewedPages: 0,
+			orphanedReviews: 0,
 			staleGeneratedPages: 0,
 			modifiedGeneratedPages: 0,
 			unknownGeneratedPages: 0,
@@ -704,20 +757,36 @@ function buildCompactionCoverage(rootDir, contentDir, entry, pages, defaults) {
 	const targetsBySlug = new Map(targets.map((target) => [target.slug, target]));
 	const coverage = {
 		freshGeneratedPages: 0,
+		reviewedGeneratedPages: 0,
+		invalidReviewedPages: 0,
+		orphanedReviews: 0,
 		staleGeneratedPages: 0,
 		modifiedGeneratedPages: 0,
 		unknownGeneratedPages: 0,
 		tokenBudgetMissingPages: 0,
 		otherMissingPages: 0
 	};
+	const reviewRecords = loadAgentCompactionReviews(rootDir, defaults.reviewManifestPath);
+	const inspectionDefaults = {
+		...defaults,
+		reviewRecords
+	};
+	const targetRoutes = new Set(targets.map((target) => target.url));
+	coverage.orphanedReviews = reviewRecords.filter((review) => !targetRoutes.has(review.route)).length;
 	for (const page of pages) {
 		const target = targetsBySlug.get(page.slug);
 		if (!target) continue;
-		const state = inspectAgentCompactionState(page, target, defaults);
+		const state = inspectAgentCompactionState(page, target, inspectionDefaults);
 		switch (state.status) {
 			case "fresh":
 				coverage.freshGeneratedPages += 1;
 				break;
+			case "reviewed":
+				coverage.reviewedGeneratedPages += 1;
+				break;
+			case "review-invalid":
+				coverage.invalidReviewedPages += 1;
+				break;
 			case "stale":
 				coverage.staleGeneratedPages += 1;
 				break;
@@ -737,8 +806,10 @@ function buildCompactionCoverage(rootDir, contentDir, entry, pages, defaults) {
 	return coverage;
 }
 function compactionFreshnessScore(coverage, compactConfigured) {
-	if (coverage.staleGeneratedPages > 0 || coverage.modifiedGeneratedPages > 0 || coverage.tokenBudgetMissingPages > 0) {
+	if (coverage.invalidReviewedPages > 0 || coverage.orphanedReviews > 0 || coverage.staleGeneratedPages > 0 || coverage.modifiedGeneratedPages > 0 || coverage.tokenBudgetMissingPages > 0) {
 		const recommendations = [];
+		if (coverage.invalidReviewedPages > 0) recommendations.push("Inspect every changed source/settings/output hash, then rerun docs agent compact --review with an explicit reviewer and rationale only when the preserved agent.md remains correct.");
+		if (coverage.orphanedReviews > 0) recommendations.push("Remove or replace orphaned entries in the agent compaction review manifest.");
 		if (coverage.staleGeneratedPages > 0) recommendations.push("Run docs agent compact --stale to refresh stale generated agent.md files.");
 		if (coverage.modifiedGeneratedPages > 0) recommendations.push("Review modified generated agent.md files before overwriting them; --stale skips manual edits on purpose.");
 		if (coverage.tokenBudgetMissingPages > 0) recommendations.push("Run docs agent compact --stale --include-missing to create generated agent.md files for pages that opted into agent.tokenBudget.");
@@ -752,7 +823,7 @@ function compactionFreshnessScore(coverage, compactConfigured) {
 		status: "pass",
 		score: compactConfigured ? 5 : 3
 	};
-	if (coverage.freshGeneratedPages > 0) return {
+	if (coverage.freshGeneratedPages > 0 || coverage.reviewedGeneratedPages > 0) return {
 		status: "pass",
 		score: compactConfigured ? 5 : 4
 	};
@@ -837,16 +908,31 @@ function toMarkdownRoute(pageUrl) {
 	const normalized = pageUrl === "/" ? "/index" : pageUrl.replace(/\/+$/, "");
 	return normalized.endsWith(".md") ? normalized : `${normalized}.md`;
 }
-async function fetchWithTimeout(url, init = {}, timeoutMs = 8e3) {
-	const controller = new AbortController();
-	const timeout = setTimeout(() => controller.abort(), timeoutMs);
-	try {
-		return await fetch(url, {
-			...init,
-			signal: controller.signal
-		});
-	} finally {
-		clearTimeout(timeout);
+async function fetchWithTimeout(url, init = {}) {
+	const options = hostedProbeOptions.getStore();
+	const timeoutMs = options?.timeoutMs ?? DEFAULT_HOSTED_TIMEOUT_MS;
+	const retries = options?.retries ?? DEFAULT_HOSTED_RETRIES;
+	const method = init.method?.toUpperCase() ?? "GET";
+	const retryableMethod = method === "GET" || method === "HEAD";
+	for (let attempt = 0;; attempt += 1) {
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), timeoutMs);
+		try {
+			const response = await fetch(url, {
+				...init,
+				signal: controller.signal
+			});
+			const retryableStatus = response.status === 408 || response.status === 425 || response.status === 429 || response.status >= 500;
+			if (retryableMethod && retryableStatus && attempt < retries) {
+				await response.body?.cancel().catch(() => void 0);
+				continue;
+			}
+			return response;
+		} catch (error) {
+			if (!retryableMethod || attempt >= retries) throw error;
+		} finally {
+			clearTimeout(timeout);
+		}
 	}
 }
 async function probeTextRoute(baseUrl, route) {
@@ -1707,6 +1793,9 @@ async function inspectAgentReadiness(options = {}) {
 				explicitCoverage: 0,
 				compaction: {
 					freshGeneratedPages: 0,
+					reviewedGeneratedPages: 0,
+					invalidReviewedPages: 0,
+					orphanedReviews: 0,
 					staleGeneratedPages: 0,
 					modifiedGeneratedPages: 0,
 					unknownGeneratedPages: 0,
@@ -1917,19 +2006,26 @@ async function inspectAgentReadiness(options = {}) {
 	checks.push(makeCheck("agent-applicability", "Framework and version applicability", applicabilityResult.status, applicabilityResult.score, 10, `${usefulness.metrics.applicability.conflictingPages} conflicting, ${usefulness.metrics.applicability.ambiguousPages} ambiguous, and ${usefulness.metrics.applicability.mismatchedPages} project-mismatched actionable pages.`, usefulness.metrics.actionablePages > 0 && applicabilityIssueCount === 0 ? void 0 : "Declare consistent framework/version metadata in page frontmatter and agent.appliesTo so retrieval can select the right variant."));
 	checks.push(makeCheck("command-health", "Documented command health", commandHealthResult.status, commandHealthResult.score, 10, `${usefulness.metrics.commands.healthy}/${usefulness.metrics.commands.total} statically inspected commands are healthy; ${usefulness.metrics.commands.unhealthy} are unhealthy and ${usefulness.metrics.commands.unverified} could not be verified safely.`, usefulness.metrics.commands.total > 0 && usefulness.metrics.commands.unhealthy === 0 && usefulness.metrics.commands.unverified === 0 ? void 0 : "Update broken or stale commands and make workspace selectors resolvable so scripts, working directories, package managers, and docs CLI subcommands can be verified.", commandFindings));
 	checks.push(makeCheck("related-coverage", "Related-page task coverage", relatedCoverageResult.status, relatedCoverageResult.score, 5, `${usefulness.metrics.related.coveredActionablePages}/${usefulness.metrics.actionablePages} actionable pages link to a valid related docs route; ${usefulness.metrics.related.brokenLinks} related links are broken.`, usefulness.metrics.actionablePages > 0 && usefulness.metrics.related.coverage >= 80 && usefulness.metrics.related.brokenLinks === 0 ? void 0 : "Add and validate related routes on actionable pages so agents can expand context without guessing."));
-	checks.push(makeCheck("compact", "Agent compaction freshness", compactionResult.status, compactionResult.score, 5, `${compactionCoverage.freshGeneratedPages} fresh, ${compactionCoverage.staleGeneratedPages} stale, ${compactionCoverage.modifiedGeneratedPages} modified, ${compactionCoverage.unknownGeneratedPages} unknown, ${compactionCoverage.tokenBudgetMissingPages} token-budget missing, and ${compactionCoverage.otherMissingPages} other missing page${compactionCoverage.otherMissingPages === 1 ? "" : "s"} across compactable docs pages.` + (compactConfigured ? " agent.compact defaults are configured." : " No agent.compact defaults were found in docs config."), compactionResult.recommendation));
+	checks.push(makeCheck("compact", "Agent compaction freshness", compactionResult.status, compactionResult.score, 5, `${compactionCoverage.freshGeneratedPages} fresh, ${compactionCoverage.reviewedGeneratedPages} reviewed, ${compactionCoverage.invalidReviewedPages} invalid reviews, ${compactionCoverage.orphanedReviews} orphaned reviews, ${compactionCoverage.staleGeneratedPages} stale, ${compactionCoverage.modifiedGeneratedPages} modified, ${compactionCoverage.unknownGeneratedPages} unknown, ${compactionCoverage.tokenBudgetMissingPages} token-budget missing, and ${compactionCoverage.otherMissingPages} other missing page${compactionCoverage.otherMissingPages === 1 ? "" : "s"} across compactable docs pages.` + (compactConfigured ? " agent.compact defaults are configured." : " No agent.compact defaults were found in docs config."), compactionResult.recommendation));
 	const averageMetric = (values) => values.length === 0 ? 0 : Math.round(values.reduce((total, value) => total + value, 0) / values.length * 100) / 100;
 	const evaluationQuality = evaluations.quality;
 	const proportionalEvaluationScore = evaluationQuality.score === null ? 0 : Math.round(evaluationQuality.score / 100 * 10);
 	const evaluationScore = evaluationQuality.status === "failed" ? Math.min(9, proportionalEvaluationScore) : proportionalEvaluationScore;
 	checks.push(makeCheck("golden-tasks", "Golden task quality", evaluationQuality.status === "passed" ? "pass" : evaluationQuality.status === "failed" ? "fail" : "warn", evaluationScore, 10, evaluationQuality.status === "unmeasured" ? "No golden agent tasks are configured; evaluation quality is unmeasured." : `${evaluationQuality.passedTaskCount}/${evaluationQuality.taskCount} golden tasks passed with ${evaluationQuality.score}/100 average quality across configured expectations, ${averageMetric(evaluations.tasks.map((task) => task.retrieval.recallAtK))} retrieval recall, ${averageMetric(evaluations.tasks.map((task) => task.citations.recall))} citation recall, and ${evaluations.tasks.reduce((total, task) => total + task.usage.usedUtf8Bytes, 0)} UTF-8 context bytes used.`, evaluationQuality.status === "passed" ? void 0 : evaluationQuality.status === "unmeasured" ? "Configure agent.evaluations.tasks so doctor and review can measure retrieval, citations, framework/version selection, adversarial safety, executable examples, and token usage." : "Inspect the failed golden task metrics and fix retrieval ranking, citations, applicability metadata, adversarial safety, examples, or context budgets."));
 	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 formatDimensionCoverage = (label, dimension) => {
+		if (dimension.status === "not-applicable") return `${label}: not applicable (${dimension.notApplicableTaskCount} tasks)`;
+		return `${label}: ${dimension.status} (${dimension.measuredTaskCount}/${dimension.applicableTaskCount} applicable tasks${dimension.notApplicableTaskCount > 0 ? `, ${dimension.notApplicableTaskCount} not applicable` : ""})`;
+	};
+	const evaluationCoveragePassed = evaluationCoverage.status === "measured" || evaluationCoverage.status === "not-applicable";
+	checks.push(makeCheck("golden-task-coverage", "Golden evaluation coverage", evaluationCoveragePassed ? "pass" : "warn", Math.round(evaluationCoverage.coveragePercent / 100 * 5), 5, `${evaluationCoverage.status} coverage across optional confidence dimensions (${evaluationCoverage.measuredTaskDimensions}/${evaluationCoverage.applicableTaskDimensions} applicable task-dimensions, ${evaluationCoverage.notApplicableTaskDimensions} not applicable, ${evaluationCoverage.coveragePercent}%): ${formatDimensionCoverage("safety", evaluationCoverage.dimensions.safety)}; ${formatDimensionCoverage("answer quality", evaluationCoverage.dimensions.answerQuality)}; ${formatDimensionCoverage("executable examples", evaluationCoverage.dimensions.executableExamples)}.`, evaluationCoveragePassed ? void 0 : "Add golden-task safety expectations, actual-answer assertions, and execute-level example checks for applicable tasks; explicitly mark example execution not-applicable only when it would not meaningfully validate the task."));
 	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;
+	const hosted = options.url ? await hostedProbeOptions.run({
+		timeoutMs: options.hostedTimeoutMs ?? DEFAULT_HOSTED_TIMEOUT_MS,
+		retries: options.hostedRetries ?? DEFAULT_HOSTED_RETRIES
+	}, () => 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));
 	return {
@@ -2048,9 +2144,9 @@ function printAgentDoctorReport(report) {
 		const evaluationQuality = report.evaluations.quality;
 		console.log(`${pc.bold("Golden task quality:")} ${evaluationQuality.status === "unmeasured" ? "unmeasured" : `${evaluationQuality.passedTaskCount}/${evaluationQuality.taskCount} passed (${evaluationQuality.score}/100)`}`);
 		const evaluationCoverage = report.evaluations.coverage;
-		console.log(`${pc.bold("Evaluation coverage:")} ${evaluationCoverage.status} ${pc.dim(`(${evaluationCoverage.measuredTaskDimensions}/${evaluationCoverage.totalTaskDimensions} task-dimensions, ${evaluationCoverage.coveragePercent}%)`)} ${pc.dim("•")} safety ${evaluationCoverage.dimensions.safety.status} ${pc.dim("•")} answer quality ${evaluationCoverage.dimensions.answerQuality.status} ${pc.dim("•")} executable examples ${evaluationCoverage.dimensions.executableExamples.status}`);
+		console.log(`${pc.bold("Evaluation coverage:")} ${evaluationCoverage.status} ${pc.dim(`(${evaluationCoverage.measuredTaskDimensions}/${evaluationCoverage.applicableTaskDimensions} applicable task-dimensions, ${evaluationCoverage.notApplicableTaskDimensions} not applicable, ${evaluationCoverage.coveragePercent}%)`)} ${pc.dim("•")} safety ${evaluationCoverage.dimensions.safety.status} ${pc.dim("•")} answer quality ${evaluationCoverage.dimensions.answerQuality.status} ${pc.dim("•")} executable examples ${evaluationCoverage.dimensions.executableExamples.status}`);
 	}
-	console.log(`${pc.bold("Generated agent.md freshness:")} ${report.coverage.compaction.freshGeneratedPages} fresh ${pc.dim("•")} ${report.coverage.compaction.staleGeneratedPages} stale ${pc.dim("•")} ${report.coverage.compaction.modifiedGeneratedPages} modified ${pc.dim("•")} ${report.coverage.compaction.tokenBudgetMissingPages} token-budget missing`);
+	console.log(`${pc.bold("Generated agent.md freshness:")} ${report.coverage.compaction.freshGeneratedPages} fresh ${pc.dim("•")} ${report.coverage.compaction.reviewedGeneratedPages} reviewed ${pc.dim("•")} ${report.coverage.compaction.invalidReviewedPages} invalid reviews ${pc.dim("•")} ${report.coverage.compaction.staleGeneratedPages} stale ${pc.dim("•")} ${report.coverage.compaction.modifiedGeneratedPages} modified ${pc.dim("•")} ${report.coverage.compaction.tokenBudgetMissingPages} token-budget missing`);
 	if (report.fixes && report.fixes.length > 0) console.log(`${pc.bold("Fixes:")} ${report.fixes.map((fix) => `${fix.status === "applied" ? "applied" : "skipped"} ${fix.title}`).join(pc.dim(" • "))}`);
 	console.log();
 	for (const check of report.checks) {
@@ -2137,11 +2233,11 @@ async function runAgentDoctorFixes(report, options) {
 	const fixes = [];
 	const compaction = report.coverage.compaction;
 	if (!(compaction.staleGeneratedPages > 0 || compaction.tokenBudgetMissingPages > 0)) {
-		if (compaction.modifiedGeneratedPages > 0 || compaction.unknownGeneratedPages > 0) fixes.push({
+		if (compaction.invalidReviewedPages > 0 || compaction.orphanedReviews > 0 || compaction.modifiedGeneratedPages > 0 || compaction.unknownGeneratedPages > 0) fixes.push({
 			id: "agent-compact",
 			title: "agent compact",
 			status: "skipped",
-			detail: "Only modified or unknown generated agent.md files need attention; doctor --fix leaves those for manual review."
+			detail: "Only invalid/orphaned reviews or modified/unknown agent.md files need attention; doctor --fix leaves those for manual review."
 		});
 		return fixes;
 	}

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

@@ -1,5 +1,5 @@
 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 { An as normalizeAgentFramework, En as resolveDocsAudienceMdxContent, Nn as normalizeAgentVersion, kn as agentVersionConstraintsOverlap, wn as findDocsAudienceMdxTags } from "./agent-BDrflLmt.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";
@@ -43,6 +43,9 @@ const DEFAULT_DOCS_COMMANDS = [
 	"skills scaffold",
 	"agent compact",
 	"agent export",
+	"agent feedback",
+	"agent feedback-evals",
+	"agent propose",
 	"agents generate",
 	"doctor",
 	"review",