@farming-labs/docs 0.2.11 → 0.2.13

package/dist/cli/index.mjs

@@ -162,7 +162,7 @@ async function main() {
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-DiggaRYi.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CRtFloHw.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -341,6 +341,7 @@ ${pc.dim("Options for doctor:")}
   ${pc.cyan("doctor --human")}                      Alias for ${pc.cyan("doctor --site")}
   ${pc.cyan("doctor --json")}                       Print the report as JSON for CI, scripts, and automation
   ${pc.cyan("doctor --strict")}                     Exit with failure when any doctor check warns or fails
+  ${pc.cyan("doctor --fail-on warn|fail")}          Choose whether warnings or only failures fail CI
   ${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

package/dist/{doctor-DiggaRYi.mjs → doctor-CRtFloHw.mjs}

@@ -42,6 +42,10 @@ function parseDoctorOnlyMode(value) {
 	if (value === "site") return "human";
 	throw new Error("Invalid value for --only. Expected agent or site.");
 }
+function parseDoctorFailOn(value) {
+	if (value === "warn" || value === "fail") return value;
+	throw new Error("Invalid value for --fail-on. Expected warn or fail.");
+}
 function parseDoctorArgs(argv) {
 	const parsed = {};
 	for (let index = 0; index < argv.length; index += 1) {
@@ -62,6 +66,19 @@ function parseDoctorArgs(argv) {
 			parsed.strict = true;
 			continue;
 		}
+		if (arg.startsWith("--fail-on=")) {
+			const value = parseInlineFlag(arg).value;
+			if (!value) throw new Error("Missing value for --fail-on.");
+			parsed.failOn = parseDoctorFailOn(value);
+			continue;
+		}
+		if (arg === "--fail-on") {
+			const value = argv[index + 1];
+			if (!value || value.startsWith("--")) throw new Error("Missing value for --fail-on.");
+			parsed.failOn = parseDoctorFailOn(value);
+			index += 1;
+			continue;
+		}
 		if (arg.startsWith("--only=")) {
 			const value = parseInlineFlag(arg).value;
 			if (!value) throw new Error("Missing value for --only.");
@@ -120,6 +137,7 @@ ${pc.dim("Usage:")}
   pnpm exec docs doctor --site
   pnpm exec docs doctor --agent --json
   pnpm exec docs doctor --agent --strict
+  pnpm exec docs doctor --agent --fail-on fail
   pnpm exec docs doctor --only agent
   pnpm exec docs doctor --only site
   pnpm exec docs doctor agent
@@ -132,6 +150,7 @@ ${pc.dim("Options:")}
   ${pc.cyan("--only <mode>")}      Run only one doctor suite: ${pc.cyan("agent")} or ${pc.cyan("site")}
   ${pc.cyan("--json")}             Print the report as JSON for CI, scripts, and other agents
   ${pc.cyan("--strict")}           Exit with failure when any check warns or fails
+  ${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("--config <path>")}    Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
   ${pc.cyan("-h, --help")}         Show this help message
@@ -1486,13 +1505,18 @@ function printDoctorJsonReport(report) {
 function hasNonPassingDoctorCheck(report) {
 	return report.checks.some((check) => check.status !== "pass");
 }
-function applyStrictExitCode(report, options) {
-	if (options.strict && hasNonPassingDoctorCheck(report)) process.exitCode = 1;
+function hasFailingDoctorCheck(report) {
+	return report.checks.some((check) => check.status === "fail");
+}
+function applyDoctorExitCode(report, options) {
+	const failOn = options.failOn ?? (options.strict ? "warn" : void 0);
+	if (!failOn) return;
+	if (failOn === "warn" ? hasNonPassingDoctorCheck(report) : hasFailingDoctorCheck(report)) process.exitCode = 1;
 }
 async function runDoctor(options = {}) {
 	if (options.mode === "human") {
 		const report = await inspectHumanReadiness(options);
-		applyStrictExitCode(report, options);
+		applyDoctorExitCode(report, options);
 		if (options.json) {
 			printDoctorJsonReport(report);
 			return report;
@@ -1501,7 +1525,7 @@ async function runDoctor(options = {}) {
 		return report;
 	}
 	const report = await inspectAgentReadiness(options);
-	applyStrictExitCode(report, options);
+	applyDoctorExitCode(report, options);
 	if (options.json) {
 		printDoctorJsonReport(report);
 		return report;

package/package.json

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