@farming-labs/docs 0.1.125 → 0.1.128

package/dist/{agent-CBhuGaVu.mjs → agent-CJNYhzu7.mjs}

@@ -1,9 +1,9 @@
-import "./reading-time-HpTq-0VB.mjs";
+import "./reading-time-DPAazAGu.mjs";
 import "./search-BL7o2rXk.mjs";
 import "./agent-BS39vnhS.mjs";
 import "./robots-B2BfoyVM.mjs";
-import "./sitemap-server-BZHoJHqC.mjs";
-import "./config-B8wA38OC.mjs";
-import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-B4QzFqNC.mjs";
+import "./sitemap-server-idLUrmmU.mjs";
+import "./config-CBoixmrv.mjs";
+import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-DbJrclYa.mjs";
 
 export { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp };

package/dist/{agents-BPX4YRPs.mjs → agents-BuL01_U0.mjs}

@@ -1,9 +1,9 @@
 import "./search-BL7o2rXk.mjs";
 import { K as resolveDocsAgentFeedbackConfig, V as renderDocsAgentsDocument, a as DEFAULT_AGENT_MD_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, y as DEFAULT_OPENAPI_SCHEMA_ROUTE } from "./agent-BS39vnhS.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-BZHoJHqC.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-idLUrmmU.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-B8wA38OC.mjs";
+import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-CBoixmrv.mjs";
 import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/cli/index.mjs

@@ -24,7 +24,8 @@ function parseFlags(argv) {
 		"typesense",
 		"algolia",
 		"verbose",
-		"host"
+		"host",
+		"json"
 	]);
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
@@ -76,17 +77,38 @@ async function main() {
 		indexName: typeof flags["index-name"] === "string" ? flags["index-name"] : void 0,
 		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0
 	};
+	const cloudOptions = {
+		configPath: typeof flags.config === "string" ? flags.config : void 0,
+		apiBaseUrl: typeof flags["api-base-url"] === "string" ? flags["api-base-url"] : typeof flags.url === "string" ? flags.url : void 0,
+		apiKey: typeof flags["api-key"] === "string" ? flags["api-key"] : void 0,
+		json: typeof flags.json === "boolean" ? flags.json : void 0
+	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-DzQWiVN1.mjs");
+		const { init } = await import("../init-BJqy-LK2.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-1VFeAWUi.mjs");
+		const { dev } = await import("../dev-DdlhqXNU.mjs");
 		await dev(devOptions);
+	} else if (parsedCommand.command === "preview") {
+		const { runCloudPreview } = await import("../cloud-88xTLXn3.mjs");
+		await runCloudPreview(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
+		const { runCloudPreview } = await import("../cloud-88xTLXn3.mjs");
+		await runCloudPreview(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
+		const { syncCloudConfig } = await import("../cloud-88xTLXn3.mjs");
+		await syncCloudConfig(cloudOptions);
+	} else if (parsedCommand.command === "cloud") {
+		console.error(pc.red(`Unknown cloud subcommand: ${subcommand ?? "(missing)"}`));
+		console.error();
+		const { printCloudHelp } = await import("../cloud-88xTLXn3.mjs");
+		printCloudHelp();
+		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-BvERlrP_.mjs");
+		const { runMcp } = await import("../mcp-CUAR3XfW.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-CBhuGaVu.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-CJNYhzu7.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -96,11 +118,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-CBhuGaVu.mjs");
+		const { printAgentCompactHelp } = await import("../agent-CJNYhzu7.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BPX4YRPs.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BuL01_U0.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -110,11 +132,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-BPX4YRPs.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-BuL01_U0.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-lV9lhqGA.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-D_c7vJCb.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -122,7 +144,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-ClNDYRnn.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-CjyI-bVg.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -130,7 +152,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-B4QzFqNC.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-DbJrclYa.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -140,11 +162,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-B4QzFqNC.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-DbJrclYa.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-BjyDm30M.mjs");
+		const { syncSearch } = await import("../search-Cekr2OyP.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -152,7 +174,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BdSdcAmS.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BBfGr3tJ.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -162,11 +184,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-BdSdcAmS.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-BBfGr3tJ.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-CNLiZCay.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-Dx2uMF3g.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -176,11 +198,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-CNLiZCay.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-Dx2uMF3g.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-BGANzvQb.mjs");
+		const { downgrade } = await import("../downgrade-BayU3nlg.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({
@@ -188,7 +210,7 @@ async function main() {
 			version: typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-C7DvvfTR.mjs");
+		const { upgrade } = await import("../upgrade-DDWolmHe.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;
@@ -216,6 +238,8 @@ ${pc.dim("Usage:")}
 ${pc.dim("Commands:")}
   ${pc.cyan("init")}     Scaffold docs in your project (default)
   ${pc.cyan("dev")}      Run frameworkless docs locally from ${pc.dim("docs.json")}
+  ${pc.cyan("preview")}  Sync cloud config and request a hosted Docs Cloud preview
+  ${pc.cyan("cloud")}    Docs Cloud utilities (${pc.dim("preview")}, ${pc.dim("sync")})
   ${pc.cyan("agent")}    Agent utilities (${pc.dim("compact")} to generate sibling agent.md files)
   ${pc.cyan("agents")}   AGENTS.md utilities (${pc.dim("generate")} for static agent instructions)
   ${pc.cyan("doctor")}   Inspect and score agent or reader-facing docs quality
@@ -249,6 +273,15 @@ ${pc.dim("Options for dev:")}
   ${pc.cyan("--host [host]")}       Expose the preview on your network; optionally pass a host value
   ${pc.cyan("--verbose")}           Show raw runtime logs in addition to branded CLI output
 
+${pc.dim("Options for cloud preview:")}
+  ${pc.cyan("preview")}                              Sync ${pc.dim("docs.config.ts")} into ${pc.dim("docs.json")} and request a hosted preview
+  ${pc.cyan("cloud preview")}                        Same as ${pc.cyan("preview")}
+  ${pc.cyan("cloud sync")}                           Only materialize cloud settings into ${pc.dim("docs.json")}
+  ${pc.cyan("--config <path>")}                      Use a custom docs config path
+  ${pc.cyan("--api-base-url <url>")}                 Override the Docs Cloud API base URL
+  ${pc.cyan("--api-key <key>")}                      Use an API key directly; prefer ${pc.dim("cloud.apiKey.env")}
+  ${pc.cyan("--json")}                              Print machine-readable output
+
 ${pc.dim("Options for agent compact:")}
   ${pc.cyan("agent compact <page...>")}             Compact pages and write sibling ${pc.dim("agent.md")} files
   ${pc.cyan("agent compact --all")}                 Compact every folder-based docs page