@farming-labs/docs 0.2.62 → 0.2.64

package/dist/cli/index.mjs

@@ -0,0 +1,452 @@
+#!/usr/bin/env node
+import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-DbOhkE1h.mjs";
+import pc from "picocolors";
+
+//#region src/cli/index.ts
+const args = process.argv.slice(2);
+const command = args[0];
+const subcommand = args[1];
+const UPGRADE_TAGS = ["latest", "beta"];
+/** Normalize command aliases like `upgrade@beta` into the base command + dist-tag. */
+function parseCommandAlias(rawCommand) {
+	if (!rawCommand) return {};
+	const [baseCommand, rawTag] = rawCommand.split("@");
+	if (baseCommand === "upgrade" && rawTag && UPGRADE_TAGS.includes(rawTag)) return {
+		command: "upgrade",
+		tag: rawTag
+	};
+	return { command: rawCommand };
+}
+/** Parse flags like --template next, --name my-docs, --theme concrete, --entry docs, --framework astro (exported for tests). */
+function parseFlags(argv) {
+	const flags = {};
+	const booleanFlags = new Set([
+		"api-reference",
+		"cloud",
+		"typesense",
+		"algolia",
+		"verbose",
+		"host",
+		"json",
+		"network",
+		"analytics",
+		"ask-ai",
+		"deploy",
+		"dry-run"
+	]);
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg.startsWith("--") && arg.includes("=")) {
+			const [key, value] = arg.slice(2).split("=");
+			if (key.startsWith("no-")) flags[key.slice(3)] = false;
+			else if (booleanFlags.has(key) && value === "true") flags[key] = true;
+			else if (booleanFlags.has(key) && value === "false") flags[key] = false;
+			else flags[key] = value;
+		} else if (arg.startsWith("--") && argv[i + 1] && !argv[i + 1].startsWith("--")) {
+			flags[arg.slice(2)] = argv[i + 1];
+			i++;
+		} else if (arg.startsWith("--no-")) flags[arg.slice(5)] = false;
+		else if (arg.startsWith("--") && booleanFlags.has(arg.slice(2))) flags[arg.slice(2)] = true;
+	}
+	return flags;
+}
+async function main() {
+	const flags = parseFlags(args);
+	const parsedCommand = parseCommandAlias(command);
+	const initOptions = {
+		template: typeof flags.template === "string" ? flags.template : void 0,
+		name: typeof flags.name === "string" ? flags.name : void 0,
+		theme: typeof flags.theme === "string" ? flags.theme : void 0,
+		entry: typeof flags.entry === "string" ? flags.entry : void 0,
+		apiReference: typeof flags["api-reference"] === "boolean" ? flags["api-reference"] : void 0,
+		apiRouteRoot: typeof flags["api-route-root"] === "string" ? flags["api-route-root"] : void 0,
+		cloud: typeof flags.cloud === "boolean" ? flags.cloud : void 0
+	};
+	const mcpOptions = {
+		configPath: typeof flags.config === "string" ? flags.config : void 0,
+		setup: subcommand === "setup",
+		deploymentId: typeof flags.deployment === "string" ? flags.deployment : void 0,
+		apiBaseUrl: typeof flags["api-base-url"] === "string" ? flags["api-base-url"] : typeof flags.url === "string" ? flags.url : void 0,
+		client: typeof flags.client === "string" ? flags.client : void 0,
+		json: typeof flags.json === "boolean" ? flags.json : void 0
+	};
+	const devOptions = {
+		verbose: typeof flags.verbose === "boolean" ? flags.verbose : void 0,
+		port: typeof flags.port === "string" ? flags.port : void 0,
+		host: typeof flags.host === "boolean" || typeof flags.host === "string" ? flags.host : void 0,
+		hostname: typeof flags.hostname === "string" ? flags.hostname : void 0
+	};
+	const searchSyncOptions = {
+		configPath: typeof flags.config === "string" ? flags.config : void 0,
+		provider: typeof flags.provider === "string" ? flags.provider : void 0,
+		typesense: typeof flags.typesense === "boolean" ? flags.typesense : void 0,
+		algolia: typeof flags.algolia === "boolean" ? flags.algolia : void 0,
+		baseUrl: typeof flags["base-url"] === "string" ? flags["base-url"] : void 0,
+		collection: typeof flags.collection === "string" ? flags.collection : void 0,
+		apiKey: typeof flags["api-key"] === "string" ? flags["api-key"] : void 0,
+		adminApiKey: typeof flags["admin-api-key"] === "string" ? flags["admin-api-key"] : void 0,
+		mode: typeof flags.mode === "string" ? flags.mode : void 0,
+		ollamaModel: typeof flags["ollama-model"] === "string" ? flags["ollama-model"] : void 0,
+		ollamaBaseUrl: typeof flags["ollama-base-url"] === "string" ? flags["ollama-base-url"] : void 0,
+		appId: typeof flags["app-id"] === "string" ? flags["app-id"] : void 0,
+		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,
+		apiKeyEnv: typeof flags["api-key-env"] === "string" ? flags["api-key-env"] : void 0,
+		json: typeof flags.json === "boolean" ? flags.json : void 0,
+		network: typeof flags.network === "boolean" ? flags.network : void 0,
+		checkTargets: [
+			...flags.deploy === true ? ["deploy"] : [],
+			...flags.analytics === true ? ["analytics"] : [],
+			...flags["ask-ai"] === true ? ["ask-ai"] : []
+		]
+	};
+	if (!parsedCommand.command || parsedCommand.command === "init") {
+		const { init } = await import("../init-CQY0Woe3.mjs");
+		await init(initOptions);
+	} else if (parsedCommand.command === "dev") {
+		const { dev } = await import("../dev-Cmy6DtdF.mjs");
+		await dev(devOptions);
+	} else if (parsedCommand.command === "deploy") {
+		const { runCloudDeploy } = await import("../cloud-pdNC-tyj.mjs");
+		await runCloudDeploy(cloudOptions);
+	} else if (parsedCommand.command === "preview") {
+		const { runCloudPreview } = await import("../cloud-pdNC-tyj.mjs");
+		await runCloudPreview(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
+		const { runCloudDeploy } = await import("../cloud-pdNC-tyj.mjs");
+		await runCloudDeploy(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
+		const { runCloudPreview } = await import("../cloud-pdNC-tyj.mjs");
+		await runCloudPreview(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
+		const { runCloudInit } = await import("../cloud-pdNC-tyj.mjs");
+		await runCloudInit(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
+		const { syncCloudConfig } = await import("../cloud-pdNC-tyj.mjs");
+		await syncCloudConfig(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
+		const { runCloudCheck } = await import("../cloud-pdNC-tyj.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-pdNC-tyj.mjs");
+		printCloudHelp();
+		process.exit(1);
+	} else if (parsedCommand.command === "mcp") {
+		const { runMcp } = await import("../mcp-B9dcsivk.mjs");
+		await runMcp(mcpOptions);
+	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-CQTH7NFu.mjs").then((n) => n.t);
+		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
+		if (agentCompactOptions.help) {
+			printAgentCompactHelp();
+			return;
+		}
+		await compactAgentDocs(agentCompactOptions);
+	} else if (parsedCommand.command === "agent" && subcommand === "export") {
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-CBgWgPvH.mjs");
+		const agentExportOptions = parseAgentExportArgs(args.slice(2));
+		if (agentExportOptions.help) {
+			printAgentExportHelp();
+			return;
+		}
+		await exportAgentBundle(agentExportOptions);
+	} else if (parsedCommand.command === "agent") {
+		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
+		console.error();
+		const { printAgentCompactHelp } = await import("../agent-CQTH7NFu.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-CBgWgPvH.mjs");
+		printAgentCompactHelp();
+		printAgentExportHelp();
+		process.exit(1);
+	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-XWZBub6f.mjs");
+		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
+		if (agentsOptions.help) {
+			printAgentsGenerateHelp();
+			return;
+		}
+		await generateAgents(agentsOptions);
+	} else if (parsedCommand.command === "agents") {
+		console.error(pc.red(`Unknown agents subcommand: ${subcommand ?? "(missing)"}`));
+		console.error();
+		const { printAgentsGenerateHelp } = await import("../agents-XWZBub6f.mjs");
+		printAgentsGenerateHelp();
+		process.exit(1);
+	} else if (parsedCommand.command === "doctor") {
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-DtGYZ41i.mjs");
+		const doctorOptions = parseDoctorArgs(args.slice(1));
+		if (doctorOptions.help) {
+			printDoctorHelp();
+			return;
+		}
+		await runDoctor(doctorOptions);
+	} else if (parsedCommand.command === "review") {
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-CLoHTywU.mjs");
+		const reviewOptions = parseReviewArgs(args.slice(1));
+		if (reviewOptions.help) {
+			printReviewHelp();
+			return;
+		}
+		await runReview(reviewOptions);
+	} else if ((parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") && subcommand === "validate") {
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-CFuurVIH.mjs");
+		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
+		if (codeBlocksOptions.help) {
+			printCodeBlocksValidateHelp();
+			return;
+		}
+		await runCodeBlocksValidate(codeBlocksOptions);
+	} 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-CFuurVIH.mjs");
+		printCodeBlocksValidateHelp();
+		process.exit(1);
+	} else if (parsedCommand.command === "search" && subcommand === "sync") {
+		const { syncSearch } = await import("../search-DSjCeOk7.mjs");
+		await syncSearch(searchSyncOptions);
+	} else if (parsedCommand.command === "search") {
+		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
+		console.error();
+		printHelp();
+		process.exit(1);
+	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-Cykpe3Tz.mjs");
+		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
+		if (sitemapOptions.help) {
+			printSitemapGenerateHelp();
+			return;
+		}
+		await generateSitemap(sitemapOptions);
+	} else if (parsedCommand.command === "sitemap") {
+		console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
+		console.error();
+		const { printSitemapGenerateHelp } = await import("../sitemap-Cykpe3Tz.mjs");
+		printSitemapGenerateHelp();
+		process.exit(1);
+	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-CUTahhoY.mjs");
+		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
+		if (robotsOptions.help) {
+			printRobotsGenerateHelp();
+			return;
+		}
+		await generateRobots(robotsOptions);
+	} else if (parsedCommand.command === "robots") {
+		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
+		console.error();
+		const { printRobotsGenerateHelp } = await import("../robots-CUTahhoY.mjs");
+		printRobotsGenerateHelp();
+		process.exit(1);
+	} else if (parsedCommand.command === "downgrade") {
+		const { downgrade } = await import("../downgrade-w7e6Se0L.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({
+			framework,
+			version: typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0,
+			dryRun: flags["dry-run"] === true
+		});
+	} else if (parsedCommand.command === "upgrade") {
+		const { upgrade } = await import("../upgrade-oz-GChgt.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;
+		await upgrade({
+			framework,
+			tag: version !== void 0 ? void 0 : args.includes("--beta") ? "beta" : args.includes("--latest") ? "latest" : parsedCommand.tag ?? "latest",
+			version,
+			dryRun: flags["dry-run"] === true
+		});
+	} else if (parsedCommand.command === "--help" || parsedCommand.command === "-h") printHelp();
+	else if (parsedCommand.command === "--version" || parsedCommand.command === "-v") printVersion();
+	else {
+		console.error(pc.red(`Unknown command: ${command}`));
+		console.error();
+		printHelp();
+		process.exit(1);
+	}
+}
+function printHelp() {
+	console.log(`
+${pc.bold("@farming-labs/docs")} — Documentation framework CLI
+
+${pc.dim("Usage:")}
+  npx @farming-labs/docs@latest ${pc.cyan("<command>")}
+
+${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("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("agents")}   AGENTS.md utilities (${pc.dim("generate")} for static agent instructions)
+  ${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("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)
+  ${pc.cyan("upgrade")}  Upgrade @farming-labs/* packages (auto-detect or use --framework)
+  ${pc.cyan("downgrade")} Downgrade @farming-labs/* packages (auto-detect or use --framework)
+
+${pc.dim("Supported frameworks:")}
+  Next.js, TanStack Start, SvelteKit, Astro, Nuxt
+
+${pc.dim("Options for init:")}
+  ${pc.cyan("--template <name>")}  Bootstrap a project (${pc.dim("next")}, ${pc.dim("nuxt")}, ${pc.dim("sveltekit")}, ${pc.dim("astro")}, ${pc.dim("tanstack-start")}); use with ${pc.cyan("--name")}
+  ${pc.cyan("--name <project>")}  Project folder name when using ${pc.cyan("--template")}; prompt if omitted (e.g. ${pc.dim("my-docs")})
+  ${pc.cyan("--theme <name>")}     Skip theme prompt (e.g. ${pc.dim("darksharp")}, ${pc.dim("command-grid")})
+  ${pc.cyan("--entry <path>")}     Skip entry path prompt (e.g. ${pc.dim("docs")})
+  ${pc.cyan("--api-reference")}    Scaffold API reference support during ${pc.cyan("init")}
+  ${pc.cyan("--no-api-reference")} Skip API reference scaffold during ${pc.cyan("init")}
+  ${pc.cyan("--api-route-root <path>")}  Override the API route root scanned by ${pc.cyan("apiReference.routeRoot")} (e.g. ${pc.dim("api")}, ${pc.dim("internal-api")})
+  ${pc.cyan("--cloud")}            Add Docs Cloud infrastructure support during ${pc.cyan("init")}
+  ${pc.cyan("--no-cloud")}         Skip the Docs Cloud infrastructure prompt during ${pc.cyan("init")}
+
+${pc.dim("Options for mcp:")}
+  ${pc.cyan("--config <path>")}     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+  ${pc.cyan("mcp setup --deployment <id>")} Print Docs Cloud hosted MCP setup for a deployment id
+  ${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.dim("Options for dev:")}
+  ${pc.cyan("--port <number>")}     Run the frameworkless preview on a custom port
+  ${pc.cyan("--hostname <host>")}   Bind the preview server to a custom hostname
+  ${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:")}
+  ${pc.cyan("cloud init")}                           Add Docs Cloud config to ${pc.dim("docs.config.ts")} and ${pc.dim("docs.json")}
+  ${pc.cyan("deploy")}                               Sync ${pc.dim("docs.config.ts")} into ${pc.dim("docs.json")} and deploy hosted preview docs
+  ${pc.cyan("cloud deploy")}                         Same as ${pc.cyan("deploy")}
+  ${pc.cyan("preview")}                              Alias for ${pc.cyan("deploy")}
+  ${pc.cyan("cloud preview")}                        Compatibility alias for ${pc.cyan("cloud deploy")}
+  ${pc.cyan("cloud sync")}                           Only materialize cloud settings into ${pc.dim("docs.json")}
+  ${pc.cyan("cloud check")}                          Validate Docs Cloud config, analytics envs, API key, and Ask AI wiring
+  ${pc.cyan("--config <path>")}                      Use a custom docs config path
+  ${pc.cyan("--api-key-env <name>")}                 Env var that stores the Docs Cloud API key
+  ${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("--analytics")}                          Only check Docs Cloud analytics integration
+  ${pc.cyan("--ask-ai")}                             Only check Docs Cloud Ask AI integration
+  ${pc.cyan("--deploy")}                             Only check Docs Cloud deploy integration
+  ${pc.cyan("--no-network")}                         Skip live Docs Cloud API validation for ${pc.cyan("cloud check")}
+  ${pc.cyan("--json")}                              Print machine-readable output
+  ${pc.dim("required scopes")}                       project:read, preview:write, jobs:read
+
+${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
+  ${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("--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")}
+  ${pc.cyan("--api-key-env <name>")}                Env var name for the Docs Cloud API key; prefer ${pc.dim("cloud.apiKey.env")}
+  ${pc.cyan("--base-url <url>")}                    Override the compression API base URL
+  ${pc.cyan("--aggressiveness <0-1>")}              Compression intensity for compacted output
+  ${pc.cyan("--dry-run")}                           Resolve and compress pages without writing files
+
+${pc.dim("Options for agent export:")}
+  ${pc.cyan("agent export --public")}               Export page Markdown, llms.txt, discovery, skills, AGENTS, sitemaps, robots, and a SHA-256 manifest
+  ${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 doctor:")}
+  ${pc.cyan("doctor")}                              Score the current docs app for agent-readiness
+  ${pc.cyan("doctor --agent")}                      Same as ${pc.cyan("doctor")}; explicit agent scoring mode
+  ${pc.cyan("doctor --site")}                       Score the current docs app for reader-facing docs quality
+  ${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 --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 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
+  ${pc.cyan("--config <path>")}                     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+
+${pc.dim("Options for review:")}
+  ${pc.cyan("review")}                              Review docs changed in git
+  ${pc.cyan("review setup")}                        Create ${pc.dim(".github/workflows/docs-review.yml")} when enabled
+  ${pc.cyan("--ci")}                                Use docs.config review.ci behavior and GitHub annotations
+  ${pc.cyan("--json")}                              Print the review report as JSON
+  ${pc.cyan("--config <path>")}                     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+  ${pc.cyan("--mode <off|warn|block>")}             Override ${pc.dim("review.ci.mode")}
+  ${pc.cyan("--score-threshold <0-100>")}           Override ${pc.dim("review.score.threshold")}
+
+${pc.dim("Options for search sync:")}
+  ${pc.cyan("search sync --typesense")}             Sync docs content to Typesense using env/flags
+  ${pc.cyan("search sync --algolia")}              Sync docs content to Algolia using env/flags
+  ${pc.cyan("--config <path>")}                    Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+  ${pc.cyan("--provider <name>")}                  Explicit provider (${pc.dim("typesense")}, ${pc.dim("algolia")})
+  ${pc.cyan("--typesense")}                        Shortcut for ${pc.cyan("--provider typesense")}
+  ${pc.cyan("--algolia")}                          Shortcut for ${pc.cyan("--provider algolia")}
+  ${pc.cyan("--base-url <url>")}                   Typesense base URL (or use ${pc.dim("TYPESENSE_URL")})
+  ${pc.cyan("--collection <name>")}                Typesense collection name (default ${pc.dim("docs")})
+  ${pc.cyan("--api-key <key>")}                    Typesense search/api key (or use ${pc.dim("TYPESENSE_API_KEY")})
+  ${pc.cyan("--admin-api-key <key>")}              Admin-capable sync key for Typesense/Algolia
+  ${pc.cyan("--mode <keyword|hybrid>")}            Typesense mode (default ${pc.dim("keyword")})
+  ${pc.cyan("--ollama-model <name>")}              Embeddings model for Typesense hybrid sync
+  ${pc.cyan("--ollama-base-url <url>")}            Ollama base URL for hybrid embeddings
+  ${pc.cyan("--app-id <id>")}                      Algolia app id (or use ${pc.dim("ALGOLIA_APP_ID")})
+  ${pc.cyan("--index-name <name>")}                Algolia index name (default ${pc.dim("docs")})
+  ${pc.cyan("--search-api-key <key>")}             Algolia search key (or use ${pc.dim("ALGOLIA_SEARCH_API_KEY")})
+
+${pc.dim("Options for sitemap generate:")}
+  ${pc.cyan("sitemap generate")}                   Generate sitemap manifest and public ${pc.dim("sitemap.xml")}/${pc.dim("sitemap.md")}/${pc.dim("docs/sitemap.md")}
+  ${pc.cyan("--public")}                           Explicitly write public ${pc.dim("sitemap.xml")}, ${pc.dim("sitemap.md")}, and ${pc.dim("docs/sitemap.md")} files
+  ${pc.cyan("--manifest-only")}                    Only write the internal sitemap manifest
+  ${pc.cyan("--check")}                            Fail if generated sitemap output is stale
+  ${pc.cyan("--config <path>")}                    Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+
+${pc.dim("Options for robots generate:")}
+  ${pc.cyan("robots generate [path]")}              Generate a static ${pc.dim("robots.txt")} agent access policy
+  ${pc.cyan("--path <path>")}                       Write to a specific file; defaults to ${pc.dim("public/robots.txt")} or ${pc.dim("static/robots.txt")}
+  ${pc.cyan("--append")}                            Add/update a generated block inside an existing file
+  ${pc.cyan("--force")}                             Replace the target file with the generated policy
+  ${pc.cyan("--check")}                             Fail if generated robots output is stale
+  ${pc.cyan("--config <path>")}                     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+
+${pc.dim("Options for upgrade:")}
+  ${pc.cyan("--framework <name>")}  Explicit framework (${pc.dim("next")}, ${pc.dim("tanstack-start")}, ${pc.dim("nuxt")}, ${pc.dim("sveltekit")}, ${pc.dim("astro")}); omit to auto-detect
+  ${pc.cyan("--version <version>")} Install an exact version (e.g. ${pc.dim("0.1.104")})
+  ${pc.cyan("--latest")}            Install latest stable (default)
+  ${pc.cyan("--beta")}             Install beta versions
+  ${pc.cyan("--dry-run")}          Print the install command without changing dependencies
+  ${pc.cyan("upgrade@beta")}       Shortcut for ${pc.cyan("upgrade --beta")}
+  ${pc.cyan("upgrade@latest")}     Shortcut for ${pc.cyan("upgrade --latest")}
+
+${pc.dim("Options for downgrade:")}
+  ${pc.cyan("downgrade")}           Install the published version immediately below the current installed version
+  ${pc.cyan("--framework <name>")}  Explicit framework (${pc.dim("next")}, ${pc.dim("tanstack-start")}, ${pc.dim("nuxt")}, ${pc.dim("sveltekit")}, ${pc.dim("astro")}); omit to auto-detect
+  ${pc.cyan("--version <version>")} Install an exact lower version (e.g. ${pc.dim("0.1.103")})
+  ${pc.cyan("--dry-run")}          Print the install command without changing dependencies
+
+  ${pc.cyan("-h, --help")}         Show this help message
+  ${pc.cyan("-v, --version")}     Show version
+`);
+}
+function printVersion() {
+	console.log("0.1.0");
+}
+main().catch((err) => {
+	if (shouldPrintStackTrace()) console.error(err);
+	else if (!wasCliErrorReported(err)) console.error(pc.red(`Error: ${formatCliError(err)}`));
+	process.exit(1);
+});
+
+//#endregion
+export { formatCliError, parseCommandAlias, parseFlags };

package/dist/client/react.d.mts

@@ -0,0 +1,45 @@
+import { R as DocsAnalyticsConfig } from "../types-lMBIdZg0.mjs";
+import { ReactNode } from "react";
+
+//#region src/docs-cloud-client.d.ts
+type DocsCloudClientRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);
+type DocsCloudClientRuntimeEnv = Record<string, string | undefined> | (() => Record<string, string | undefined>);
+interface DocsCloudClientOptions {
+  projectId?: DocsCloudClientRuntimeValue;
+  endpoint?: DocsCloudClientRuntimeValue;
+  analyticsEndpoint?: DocsCloudClientRuntimeValue;
+  apiBaseUrl?: DocsCloudClientRuntimeValue;
+  analyticsKey?: DocsCloudClientRuntimeValue;
+  enabled?: DocsCloudClientRuntimeValue<boolean | string>;
+  includeInputs?: DocsCloudClientRuntimeValue<boolean>;
+  env?: DocsCloudClientRuntimeEnv;
+  fetch?: typeof fetch;
+  metadata?: Record<string, unknown>;
+  properties?: Record<string, unknown>;
+}
+//#endregion
+//#region src/client/react.d.ts
+interface DocsCloudAnalyticsProps extends DocsCloudClientOptions {
+  analytics?: boolean | DocsAnalyticsConfig;
+  children?: ReactNode;
+}
+type DocsCloudAnalyticsOptions = Omit<DocsCloudAnalyticsProps, "children">;
+type DocsCloudAnalyticsProjectId = DocsCloudClientRuntimeValue;
+declare function DocsCloudAnalytics({
+  analytics,
+  children,
+  projectId,
+  endpoint,
+  analyticsEndpoint,
+  apiBaseUrl,
+  analyticsKey,
+  enabled,
+  includeInputs,
+  env,
+  fetch,
+  metadata,
+  properties
+}: DocsCloudAnalyticsProps): ReactNode;
+declare const DocsCloudAnalyticsProvider: typeof DocsCloudAnalytics;
+//#endregion
+export { DocsCloudAnalytics, DocsCloudAnalyticsOptions, DocsCloudAnalyticsProjectId, DocsCloudAnalyticsProps, DocsCloudAnalyticsProvider };