@farming-labs/docs 0.1.89 → 0.1.90

package/dist/{agent-B-CYVd4D.mjs → agent-ByVfHy7k.mjs}

@@ -5,7 +5,7 @@ import "./index.mjs";
 import "./sitemap-server-DwEPfk13.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, l as readNumberProperty, o as readBooleanProperty, p as resolveDocsContentDir, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-BR6CcCfr.mjs";
+import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, l as readNumberProperty, o as readBooleanProperty, p as resolveDocsContentDir, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-UI31_wlO.mjs";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/cli/index.mjs

@@ -83,10 +83,10 @@ async function main() {
 		const { dev } = await import("../dev-B5L7k3b6.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-RBCFEtoX.mjs");
+		const { runMcp } = await import("../mcp-OuciCVEf.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-B-CYVd4D.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-ByVfHy7k.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -96,11 +96,11 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-B-CYVd4D.mjs");
+		const { printAgentCompactHelp } = await import("../agent-ByVfHy7k.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-B8bT0Aol.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-Zn6h4wkZ.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -108,7 +108,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-DrTVZ2XK.mjs");
+		const { syncSearch } = await import("../search-CHiEEXZI.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -116,7 +116,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-CEE2vnGz.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-Bk9HqW_J.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -126,11 +126,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-CEE2vnGz.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-Bk9HqW_J.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-NI6VU8rj.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-BHEIUAYm.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -140,7 +140,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-NI6VU8rj.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-BHEIUAYm.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "upgrade") {

package/dist/{config-BR6CcCfr.mjs → config-UI31_wlO.mjs}

@@ -115,6 +115,34 @@ function extractObjectLiteral(content, key) {
 	const braceEnd = findBalancedBraceEnd(content, braceStart);
 	return braceEnd === -1 ? void 0 : content.slice(braceStart + 1, braceEnd);
 }
+function stripLeadingPropertyTrivia(content) {
+	let current = content;
+	while (true) {
+		const trimmed = current.replace(/^\s+/, "");
+		if (trimmed.startsWith("//")) {
+			const lineEnd = trimmed.indexOf("\n");
+			current = lineEnd === -1 ? "" : trimmed.slice(lineEnd + 1);
+			continue;
+		}
+		if (trimmed.startsWith("/*")) {
+			const blockEnd = trimmed.indexOf("*/");
+			current = blockEnd === -1 ? trimmed : trimmed.slice(blockEnd + 2);
+			continue;
+		}
+		return trimmed;
+	}
+}
+function extractTopLevelObjectLiteral(content, key) {
+	const propertyPattern = new RegExp(`^${escapeRegExp(key)}\\s*:\\s*\\{`);
+	for (const property of splitTopLevelProperties(content)) {
+		const normalizedProperty = stripLeadingPropertyTrivia(property);
+		if (!propertyPattern.test(normalizedProperty)) continue;
+		const braceStart = normalizedProperty.indexOf("{");
+		if (braceStart === -1) return void 0;
+		const braceEnd = findBalancedBraceEnd(normalizedProperty, braceStart);
+		return braceEnd === -1 ? void 0 : normalizedProperty.slice(braceStart + 1, braceEnd);
+	}
+}
 function extractTopLevelConfigObject(content) {
 	for (const marker of ["defineDocs(", "export default"]) {
 		const markerIndex = content.indexOf(marker);
@@ -129,7 +157,7 @@ function extractNestedObjectLiteral(content, keys) {
 	if (keys.length === 0) return void 0;
 	let current = extractTopLevelConfigObject(content) ?? content;
 	for (const key of keys) {
-		const next = extractObjectLiteral(current, key);
+		const next = extractTopLevelObjectLiteral(current, key);
 		if (!next) return void 0;
 		current = next;
 	}

package/dist/{doctor-B8bT0Aol.mjs → doctor-Zn6h4wkZ.mjs}

@@ -5,8 +5,8 @@ import { C as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROU
 import "./sitemap-server-DwEPfk13.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-BR6CcCfr.mjs";
-import { inspectAgentCompactionState, scanDocsPageTargets } from "./agent-B-CYVd4D.mjs";
+import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-UI31_wlO.mjs";
+import { inspectAgentCompactionState, scanDocsPageTargets } from "./agent-ByVfHy7k.mjs";
 import { t as detectFramework } from "./utils-AmYxHDoz.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
@@ -536,6 +536,12 @@ function percentageScore(score, maxScore) {
 	if (maxScore <= 0) return 0;
 	return Math.round(score / maxScore * 100);
 }
+function normalizedDoctorScore(score, maxScore) {
+	return {
+		score: percentageScore(score, maxScore),
+		maxScore: 100
+	};
+}
 function formatStatus(status) {
 	if (status === "pass") return pc.green("PASS");
 	if (status === "warn") return pc.yellow("WARN");
@@ -613,7 +619,7 @@ function compactionFreshnessScore(coverage, compactConfigured) {
 	}
 	if (coverage.unknownGeneratedPages > 0) return {
 		status: "pass",
-		score: compactConfigured ? 4 : 3
+		score: compactConfigured ? 5 : 3
 	};
 	if (coverage.freshGeneratedPages > 0) return {
 		status: "pass",
@@ -1092,8 +1098,7 @@ async function inspectAgentReadiness(options = {}) {
 	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));
 	const hosted = options.url ? await buildHostedAgentChecks(options.url, pages) : void 0;
 	if (hosted) checks.push(...hosted.checks);
-	const score = checks.reduce((total, check) => total + check.score, 0);
-	const maxScore = checks.reduce((total, check) => total + check.maxScore, 0);
+	const { score, maxScore } = normalizedDoctorScore(checks.reduce((total, check) => total + check.score, 0), checks.reduce((total, check) => total + check.maxScore, 0));
 	return {
 		mode: "agent",
 		framework,
@@ -1103,7 +1108,7 @@ async function inspectAgentReadiness(options = {}) {
 		url: hosted?.baseUrl,
 		score,
 		maxScore,
-		grade: gradeForAgentScore(percentageScore(score, maxScore)),
+		grade: gradeForAgentScore(score),
 		checks,
 		coverage,
 		recommendations: checks.map((check) => check.recommendation).filter((recommendation) => Boolean(recommendation)).slice(0, 3)
@@ -1174,8 +1179,7 @@ async function inspectHumanReadiness(options = {}) {
 	checks.push(makeCheck("trust", "Trust signals", trustScore === 10 ? "pass" : "warn", trustScore, 10, githubEnabled && lastUpdatedEnabled ? "Edit links and last-updated metadata are configured." : githubEnabled ? "Edit links are configured, but last-updated metadata is not enabled." : lastUpdatedEnabled ? "Last-updated metadata is enabled, but edit links are not configured." : "Edit links and last-updated metadata are not configured.", trustScore === 10 ? void 0 : "Configure GitHub edit links and/or lastUpdated so readers can trust freshness and find the source of truth faster."));
 	checks.push(humanFeedbackEnabled ? makeCheck("feedback", "Reader feedback", "pass", 5, 5, "Built-in page feedback is enabled for the docs site.") : makeCheck("feedback", "Reader feedback", "warn", 0, 5, "Built-in page feedback is not enabled.", "Enable feedback if you want readers to leave quick page-level quality signals without opening an issue."));
 	checks.push(readingTimeEnabled ? makeCheck("reading-time", "Reading-time cues", "pass", 5, 5, "Reading time is configured for the docs site.") : makeCheck("reading-time", "Reading-time cues", "warn", 0, 5, "Reading time is not enabled.", "Enable readingTime if you want readers to get a quick effort estimate before they dive into longer pages."));
-	const score = checks.reduce((total, check) => total + check.score, 0);
-	const maxScore = checks.reduce((total, check) => total + check.maxScore, 0);
+	const { score, maxScore } = normalizedDoctorScore(checks.reduce((total, check) => total + check.score, 0), checks.reduce((total, check) => total + check.maxScore, 0));
 	return {
 		mode: "human",
 		framework,
@@ -1184,7 +1188,7 @@ async function inspectHumanReadiness(options = {}) {
 		contentDir,
 		score,
 		maxScore,
-		grade: gradeForHumanScore(percentageScore(score, maxScore)),
+		grade: gradeForHumanScore(score),
 		checks,
 		coverage,
 		recommendations: checks.map((check) => check.recommendation).filter((recommendation) => Boolean(recommendation)).slice(0, 3)
@@ -1193,7 +1197,7 @@ async function inspectHumanReadiness(options = {}) {
 function printAgentDoctorReport(report) {
 	console.log(`${pc.bold("@farming-labs/docs doctor")} ${pc.dim("—")} ${pc.bold("agent")}`);
 	console.log();
-	console.log(`${pc.bold("Score:")} ${pc.cyan(`${report.score}/${report.maxScore}`)} ${pc.dim(`(${report.grade})`)}`);
+	console.log(`${pc.bold("Score:")} ${pc.cyan(`${report.score}%`)} ${pc.dim(`(${report.grade})`)}`);
 	console.log(`${pc.bold("Framework:")} ${report.framework} ${pc.dim("•")} ${pc.bold("Entry:")} ${report.entry ?? "docs"} ${pc.dim("•")} ${pc.bold("Content:")} ${report.contentDir ?? "-"}`);
 	if (report.url) console.log(`${pc.bold("Hosted URL:")} ${report.url}`);
 	console.log(`${pc.bold("Explicit agent-friendly pages:")} ${report.coverage.explicitPages}/${report.coverage.totalPages} pages ${pc.dim(`(${report.coverage.explicitCoverage}%)`)}`);
@@ -1214,7 +1218,7 @@ function printAgentDoctorReport(report) {
 function printHumanDoctorReport(report) {
 	console.log(`${pc.bold("@farming-labs/docs doctor")} ${pc.dim("—")} ${pc.bold("site")}`);
 	console.log();
-	console.log(`${pc.bold("Score:")} ${pc.cyan(`${report.score}/${report.maxScore}`)} ${pc.dim(`(${report.grade})`)}`);
+	console.log(`${pc.bold("Score:")} ${pc.cyan(`${report.score}%`)} ${pc.dim(`(${report.grade})`)}`);
 	console.log(`${pc.bold("Framework:")} ${report.framework} ${pc.dim("•")} ${pc.bold("Entry:")} ${report.entry ?? "docs"} ${pc.dim("•")} ${pc.bold("Content:")} ${report.contentDir ?? "-"}`);
 	console.log(`${pc.bold("Described pages:")} ${report.coverage.describedPages}/${report.coverage.totalPages} pages ${pc.dim(`(${report.coverage.descriptionCoverage}%)`)}`);
 	console.log();

package/dist/{mcp-RBCFEtoX.mjs → mcp-OuciCVEf.mjs}

@@ -2,7 +2,7 @@ import "./search-B5ze-heM.mjs";
 import "./sitemap-server-DwEPfk13.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, f as resolveDocsConfigPath, n as extractObjectLiteral, o as readBooleanProperty, p as resolveDocsContentDir, u as readStringProperty } from "./config-BR6CcCfr.mjs";
+import { c as readNavTitle, f as resolveDocsConfigPath, n as extractObjectLiteral, o as readBooleanProperty, p as resolveDocsContentDir, u as readStringProperty } from "./config-UI31_wlO.mjs";
 import { readFileSync } from "node:fs";
 
 //#region src/cli/mcp.ts

package/dist/{robots-NI6VU8rj.mjs → robots-BHEIUAYm.mjs}

@@ -1,5 +1,5 @@
 import { i as DOCS_ROBOTS_GENERATED_BLOCK_START, l as resolveDocsRobotsConfig, r as DOCS_ROBOTS_GENERATED_BLOCK_END, s as renderDocsRobotsGeneratedBlock, u as upsertDocsRobotsGeneratedBlock } from "./robots-DR-Gy1Hs.mjs";
-import { d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-BR6CcCfr.mjs";
+import { d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-UI31_wlO.mjs";
 import { t as detectFramework } from "./utils-AmYxHDoz.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/{search-DrTVZ2XK.mjs → search-CHiEEXZI.mjs}

@@ -2,7 +2,7 @@ import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as cr
 import "./sitemap-server-DwEPfk13.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, d as readTopLevelStringProperty, f as resolveDocsConfigPath, p as resolveDocsContentDir } from "./config-BR6CcCfr.mjs";
+import { a as loadProjectEnv, d as readTopLevelStringProperty, f as resolveDocsConfigPath, p as resolveDocsContentDir } from "./config-UI31_wlO.mjs";
 import { readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/{sitemap-CEE2vnGz.mjs → sitemap-Bk9HqW_J.mjs}

@@ -3,7 +3,7 @@ import { a as buildDocsSitemapManifest, c as renderDocsSitemapMarkdown, l as ren
 import "./sitemap-server-DwEPfk13.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-BR6CcCfr.mjs";
+import { c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-UI31_wlO.mjs";
 import { t as detectFramework } from "./utils-AmYxHDoz.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.89",
+  "version": "0.1.90",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",