@farming-labs/docs 0.2.0 → 0.2.1

package/dist/cli/index.mjs

@@ -27,7 +27,11 @@ function parseFlags(argv) {
 		"algolia",
 		"verbose",
 		"host",
-		"json"
+		"json",
+		"network",
+		"analytics",
+		"ask-ai",
+		"deploy"
 	]);
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
@@ -85,36 +89,45 @@ async function main() {
 		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
+		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-CZx_vasZ.mjs");
+		const { init } = await import("../init-BHUB2nUr.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
 		const { dev } = await import("../dev-D58nBPBv.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-BBg-41RG.mjs");
+		const { runCloudDeploy } = await import("../cloud-CHeiSRTt.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-BBg-41RG.mjs");
+		const { runCloudPreview } = await import("../cloud-CHeiSRTt.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-BBg-41RG.mjs");
+		const { runCloudDeploy } = await import("../cloud-CHeiSRTt.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-BBg-41RG.mjs");
+		const { runCloudPreview } = await import("../cloud-CHeiSRTt.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-BBg-41RG.mjs");
+		const { runCloudInit } = await import("../cloud-CHeiSRTt.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-BBg-41RG.mjs");
+		const { syncCloudConfig } = await import("../cloud-CHeiSRTt.mjs");
 		await syncCloudConfig(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
+		const { runCloudCheck } = await import("../cloud-CHeiSRTt.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-BBg-41RG.mjs");
+		const { printCloudHelp } = await import("../cloud-CHeiSRTt.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
@@ -253,7 +266,7 @@ ${pc.dim("Commands:")}
   ${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("deploy")}, ${pc.dim("preview")}, ${pc.dim("sync")})
+  ${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")} 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
@@ -289,17 +302,22 @@ ${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 deploy:")}
+${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
 

package/dist/{cloud-BBg-41RG.mjs → cloud-CHeiSRTt.mjs}

@@ -20,6 +20,13 @@ const REQUIRED_PREVIEW_API_KEY_SCOPES = [
 	"preview:write",
 	"jobs:read"
 ];
+const DOCS_CLOUD_PROJECT_ID_ENVS = ["NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID", "DOCS_CLOUD_PROJECT_ID"];
+const DEFAULT_PUBLIC_DOCS_CLOUD_API_KEY_ENV = "NEXT_PUBLIC_DOCS_CLOUD_API_KEY";
+const CLOUD_CHECK_TARGETS = [
+	"deploy",
+	"analytics",
+	"ask-ai"
+];
 function isRecord(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -593,6 +600,90 @@ async function materializeCloudConfig(options = {}) {
 		updated
 	};
 }
+function readCombinedEnv(rootDir) {
+	const env = { ...loadProjectEnv(rootDir) };
+	for (const [key, value] of Object.entries(process.env)) if (typeof value === "string") env[key] = value;
+	return env;
+}
+function readEnvValue(env, name) {
+	if (!name) return void 0;
+	const value = env[name]?.trim();
+	return value ? value : void 0;
+}
+function readFirstEnv(env, names) {
+	for (const name of names) {
+		const value = readEnvValue(env, name);
+		if (value) return {
+			name,
+			value
+		};
+	}
+}
+function readConfiguredCloudApiKeyEnv(snapshot) {
+	const moduleEnv = snapshot.config?.cloud?.apiKey?.env?.trim();
+	if (moduleEnv) return moduleEnv;
+	const apiKeyBlock = extractNestedObjectLiteral(snapshot.content ?? "", ["cloud", "apiKey"]);
+	return (apiKeyBlock ? readStringProperty(apiKeyBlock, "env") : void 0)?.trim() || void 0;
+}
+function readAiProvider(snapshot) {
+	const moduleProvider = (snapshot.config?.ai)?.provider;
+	if (typeof moduleProvider === "string" && moduleProvider.trim()) return moduleProvider.trim();
+	const aiBlock = extractNestedObjectLiteral(snapshot.content ?? "", ["ai"]);
+	return (aiBlock ? readStringProperty(aiBlock, "provider") : void 0)?.trim() || void 0;
+}
+function readRuntimeAnalyticsDisabled(snapshot) {
+	const moduleAnalytics = snapshot.config?.analytics;
+	if (moduleAnalytics === false) return true;
+	if (isRecord(moduleAnalytics) && moduleAnalytics.enabled === false) return true;
+	if (readTopLevelBooleanProperty(snapshot.content ?? "", "analytics") === false) return true;
+	const analyticsBlock = extractNestedObjectLiteral(snapshot.content ?? "", ["analytics"]);
+	return (analyticsBlock ? readTopLevelBooleanProperty(analyticsBlock, "enabled") : void 0) === false;
+}
+function isCloudAnalyticsEnabled(analytics) {
+	if (analytics === false) return false;
+	if (isRecord(analytics) && analytics.enabled === false) return false;
+	return typeof analytics !== "undefined";
+}
+function createCheck(name, status, message, details) {
+	return {
+		name,
+		status,
+		message,
+		...details ? { details } : {}
+	};
+}
+function summarizeIdentity(identity) {
+	if (!isRecord(identity)) return void 0;
+	const workspace = isRecord(identity.workspace) ? identity.workspace : void 0;
+	const apiKey = isRecord(identity.apiKey) ? identity.apiKey : void 0;
+	const scopes = readApiKeyScopes(identity);
+	return {
+		...workspace ? { workspace: {
+			...typeof workspace.id === "string" ? { id: workspace.id } : {},
+			...typeof workspace.name === "string" ? { name: workspace.name } : {}
+		} } : {},
+		...apiKey ? { apiKey: {
+			...typeof apiKey.id === "string" ? { id: apiKey.id } : {},
+			...scopes.length > 0 ? { scopes } : {}
+		} } : {}
+	};
+}
+function formatCheckStatus(status) {
+	if (status === "pass") return pc.green("ok");
+	if (status === "warn") return pc.yellow("warn");
+	return pc.red("fail");
+}
+function countChecks(checks, status) {
+	return checks.filter((check) => check.status === status).length;
+}
+function resolveCloudCheckTargets(options) {
+	const targets = new Set(options.checkTargets);
+	if (targets.size > 0) return targets;
+	return new Set(CLOUD_CHECK_TARGETS);
+}
+function formatCloudCheckTargets(targets) {
+	return targets.join(", ");
+}
 function resolveApiBaseUrl(options) {
 	return (options.apiBaseUrl ?? process.env.DOCS_CLOUD_API_URL ?? process.env.NEXT_PUBLIC_DOCS_CLOUD_URL ?? DEFAULT_DOCS_CLOUD_API_BASE_URL).replace(/\/+$/, "");
 }
@@ -849,6 +940,129 @@ function createSpinner(initialMessage, options = {}) {
 		}
 	};
 }
+async function checkCloudConfig(options = {}) {
+	const rootDir = options.rootDir ?? process.cwd();
+	const docsJsonPath = path.join(rootDir, DOCS_JSON_FILE);
+	const existing = readExistingDocsJson(docsJsonPath);
+	const snapshot = await loadDocsConfigSnapshot(rootDir, options.configPath);
+	const config = materializeDocsJsonObject({
+		rootDir,
+		snapshot,
+		existing
+	});
+	const serialized = serializeMaterializedDocsJson(config);
+	const previous = existing ? fs.readFileSync(docsJsonPath, "utf-8") : void 0;
+	const apiBaseUrl = resolveApiBaseUrl(options);
+	const apiKeyEnv = config.cloud?.apiKey?.env ?? DOCS_CLOUD_DEFAULT_API_KEY_ENV;
+	const env = readCombinedEnv(rootDir);
+	const checks = [];
+	const configPath = snapshot.path ?? docsJsonPath;
+	const network = options.network !== false;
+	const explicitApiKey = options.apiKey?.trim();
+	const targetSet = resolveCloudCheckTargets(options);
+	const targets = CLOUD_CHECK_TARGETS.filter((target) => targetSet.has(target));
+	const checkDeploy = targetSet.has("deploy");
+	const checkAnalytics = targetSet.has("analytics");
+	const checkAskAi = targetSet.has("ask-ai");
+	const checkProjectEnv = checkAnalytics || checkAskAi;
+	let identity;
+	checks.push(createCheck("config", snapshot.path ? "pass" : "warn", snapshot.path ? `Loaded ${path.relative(rootDir, snapshot.path) || "docs.config.ts"}` : `No docs.config.* found; checking ${DOCS_JSON_FILE} defaults instead.`));
+	checks.push(createCheck("docs.json", !existing ? "warn" : previous === serialized ? "pass" : "warn", !existing ? `${DOCS_JSON_FILE} is missing. Run docs cloud sync to materialize cloud config.` : previous === serialized ? `${DOCS_JSON_FILE} is in sync with docs.config.` : `${DOCS_JSON_FILE} is stale. Run docs cloud sync before deploying.`));
+	const apiKey = explicitApiKey || readEnvValue(env, apiKeyEnv);
+	if (checkDeploy) {
+		try {
+			normalizeEnvName(apiKeyEnv, DOCS_CLOUD_DEFAULT_API_KEY_ENV);
+			checks.push(createCheck("apiKey.config", "pass", `Using cloud.apiKey.env ${apiKeyEnv}.`));
+		} catch (error) {
+			checks.push(createCheck("apiKey.config", "fail", error instanceof Error ? error.message : `Invalid API key env ${apiKeyEnv}.`));
+		}
+		checks.push(createCheck("apiKey.value", apiKey ? "pass" : "fail", apiKey ? explicitApiKey ? "Docs Cloud API key was provided with --api-key." : `Docs Cloud API key is present in ${apiKeyEnv}.` : `Missing Docs Cloud API key. Set ${apiKeyEnv} or pass --api-key.`, {
+			env: apiKeyEnv,
+			source: explicitApiKey ? "flag" : apiKey ? "env" : "missing"
+		}));
+	}
+	checks.push(createCheck("cloud.enabled", config.cloud?.enabled === false ? "fail" : "pass", config.cloud?.enabled === false ? "Docs Cloud is disabled by cloud.enabled: false." : "Docs Cloud is enabled."));
+	if (checkDeploy) {
+		if (config.cloud?.deploy?.enabled === false) checks.push(createCheck("deploy.enabled", "fail", "Docs Cloud deployment is disabled by cloud.deploy.enabled: false."));
+		else checks.push(createCheck("deploy.enabled", "pass", "Docs Cloud deployment is enabled."));
+		if (config.cloud?.preview?.enabled === false) checks.push(createCheck("preview.enabled", "fail", "Docs Cloud preview deployment is disabled by cloud.preview.enabled: false."));
+	}
+	const runtimeAnalyticsDisabled = readRuntimeAnalyticsDisabled(snapshot);
+	const cloudAnalyticsEnabled = isCloudAnalyticsEnabled(config.cloud?.analytics);
+	if (checkAnalytics) {
+		if (runtimeAnalyticsDisabled) checks.push(createCheck("analytics.runtime", "fail", "Runtime analytics is disabled by analytics: false or analytics.enabled: false."));
+		else checks.push(createCheck("analytics.runtime", "pass", "Runtime analytics is not disabled."));
+		checks.push(createCheck("analytics.cloud", cloudAnalyticsEnabled ? "pass" : "warn", cloudAnalyticsEnabled ? "Docs Cloud analytics is enabled in cloud.analytics." : "cloud.analytics is not enabled; run docs cloud init to add the recommended analytics config."));
+	}
+	const projectEnv = readFirstEnv(env, DOCS_CLOUD_PROJECT_ID_ENVS);
+	const analyticsNeedsProjectId = cloudAnalyticsEnabled && !runtimeAnalyticsDisabled;
+	if (checkProjectEnv) checks.push(createCheck("project.env", projectEnv ? "pass" : analyticsNeedsProjectId || checkAskAi ? "fail" : "warn", projectEnv ? `Docs Cloud project id is present in ${projectEnv.name}.` : `Missing Docs Cloud project id. Set ${DOCS_CLOUD_PROJECT_ID_ENVS.join(" or ")} for analytics and docs-cloud Ask AI.`, projectEnv ? { env: projectEnv.name } : void 0));
+	const aiProvider = readAiProvider(snapshot);
+	if (checkAskAi) if (aiProvider === "docs-cloud") {
+		checks.push(createCheck("askAi.provider", "pass", "Ask AI is configured with provider: \"docs-cloud\"."));
+		const configuredApiKeyEnv = readConfiguredCloudApiKeyEnv(snapshot);
+		const directApiKeyEnv = configuredApiKeyEnv ? configuredApiKeyEnv.startsWith("NEXT_PUBLIC_") ? configuredApiKeyEnv : void 0 : DEFAULT_PUBLIC_DOCS_CLOUD_API_KEY_ENV;
+		const directApiKey = readEnvValue(env, directApiKeyEnv);
+		if (directApiKeyEnv) checks.push(createCheck("askAi.direct", directApiKey && projectEnv ? "pass" : "fail", directApiKey && projectEnv ? `Ask AI can call the Docs Cloud knowledge endpoint directly with ${directApiKeyEnv}.` : `Ask AI docs-cloud direct mode needs ${directApiKeyEnv} and a Docs Cloud project id.`, { apiKeyEnv: directApiKeyEnv }));
+	} else if (aiProvider) checks.push(createCheck("askAi.provider", "pass", `Ask AI provider is ${aiProvider}.`));
+	else checks.push(createCheck("askAi.provider", "warn", "Ask AI is not configured with provider: \"docs-cloud\"."));
+	if (checkDeploy) if (!network) checks.push(createCheck("apiKey.network", "warn", "Skipped Docs Cloud API validation because --no-network was passed."));
+	else if (!apiKey) checks.push(createCheck("apiKey.network", "warn", "Skipped Docs Cloud API validation because no API key value was available."));
+	else try {
+		const response = await fetchCloudJson({
+			url: `${apiBaseUrl}/api/cloud/me`,
+			apiKey
+		});
+		identity = summarizeIdentity(response);
+		checks.push(createCheck("apiKey.network", "pass", `Validated API key with ${apiBaseUrl}.`, identity));
+		const scopes = readApiKeyScopes(response);
+		if (scopes.length === 0) checks.push(createCheck("apiKey.scopes", "warn", "Docs Cloud validated the API key but did not return scope metadata."));
+		else {
+			const missing = REQUIRED_PREVIEW_API_KEY_SCOPES.filter((scope) => !scopes.includes(scope));
+			checks.push(createCheck("apiKey.scopes", missing.length === 0 ? "pass" : "fail", missing.length === 0 ? `API key has required deploy scopes: ${REQUIRED_PREVIEW_API_KEY_SCOPES.join(", ")}.` : `API key is missing required deploy scope${missing.length === 1 ? "" : "s"}: ${missing.join(", ")}.`, { scopes }));
+		}
+	} catch (error) {
+		checks.push(createCheck("apiKey.network", "fail", error instanceof Error ? error.message : "Could not validate Docs Cloud API key."));
+	}
+	return {
+		ok: countChecks(checks, "fail") === 0,
+		apiBaseUrl,
+		configPath,
+		docsJsonPath,
+		apiKeyEnv,
+		analyticsProjectIdEnv: projectEnv?.name,
+		network,
+		targets,
+		checks,
+		...identity ? { identity } : {}
+	};
+}
+async function runCloudCheck(options = {}) {
+	const result = await checkCloudConfig(options);
+	if (options.json) console.log(JSON.stringify(result, null, 2));
+	else {
+		console.log(pc.bold("Docs Cloud check"));
+		console.log(`${pc.dim("api")} ${result.apiBaseUrl}`);
+		console.log(`${pc.dim("scope")} ${formatCloudCheckTargets(result.targets)}`);
+		console.log();
+		for (const check of result.checks) console.log(`${formatCheckStatus(check.status)} ${pc.bold(check.name)} ${check.message}`);
+		console.log();
+		if (result.ok) {
+			const warnings = countChecks(result.checks, "warn");
+			const suffix = warnings > 0 ? ` with ${warnings} warning${warnings === 1 ? "" : "s"}` : "";
+			console.log(`${pc.green("ok")} Docs Cloud check passed${suffix}.`);
+		} else {
+			const failures = countChecks(result.checks, "fail");
+			console.log(`${pc.red("fail")} Docs Cloud check failed with ${failures} failed check${failures === 1 ? "" : "s"}.`);
+		}
+	}
+	if (!result.ok) {
+		const error = /* @__PURE__ */ new Error("Docs Cloud check failed.");
+		markCliErrorReported(error);
+		throw error;
+	}
+	return result;
+}
 async function syncCloudConfig(options = {}) {
 	const result = await materializeCloudConfig(options);
 	if (options.json) {
@@ -970,6 +1184,7 @@ ${pc.bold("@farming-labs/docs cloud")}
 
 ${pc.dim("Usage:")}
   ${pc.cyan("docs cloud init")}           Add Docs Cloud config to ${pc.dim("docs.config.ts")} and ${pc.dim("docs.json")}
+  ${pc.cyan("docs cloud check")}          Validate Docs Cloud config, analytics envs, API key, and Ask AI wiring
   ${pc.cyan("docs deploy")}               Sync ${pc.dim("docs.config.ts")} to ${pc.dim("docs.json")} and deploy hosted preview docs
   ${pc.cyan("docs cloud deploy")}         Same as ${pc.cyan("docs deploy")}
   ${pc.cyan("docs preview")}              Compatibility alias for ${pc.cyan("docs deploy")}
@@ -981,6 +1196,10 @@ ${pc.dim("Options:")}
   ${pc.cyan("--api-key-env <name>")}      Env var that stores the Docs Cloud API key
   ${pc.cyan("--api-base-url <url>")}      Override 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("API key scopes:")}
@@ -997,4 +1216,4 @@ ${pc.dim("Config example:")}
 }
 
 //#endregion
-export { initCloudConfig, printCloudHelp, runCloudDeploy, runCloudInit, runCloudPreview, syncCloudConfig };
+export { initCloudConfig, printCloudHelp, runCloudCheck, runCloudDeploy, runCloudInit, runCloudPreview, syncCloudConfig };

package/dist/{init-CZx_vasZ.mjs → init-BHUB2nUr.mjs}

@@ -188,7 +188,7 @@ async function configureDocsCloudOnboarding(options) {
 		enabled = cloudAnswer;
 	}
 	if (!enabled) return;
-	const { initCloudConfig } = await import("./cloud-BBg-41RG.mjs");
+	const { initCloudConfig } = await import("./cloud-CHeiSRTt.mjs");
 	printDocsCloudOnboardingInstructions(await initCloudConfig({
 		rootDir: options.rootDir,
 		configPath: getDocsCloudConfigPathForFramework(options.framework)

package/package.json

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