@clarify-labs/cli 0.6.4 → 0.6.6

package/output/cli/commands/check.d.ts

@@ -0,0 +1,6 @@
+import { CliOptions } from '../options.js';
+export type CheckCommandOptions = CliOptions & {
+    strict?: boolean;
+    format?: 'text' | 'json' | string;
+};
+export declare function runCheck(options?: CheckCommandOptions): Promise<void>;

package/output/cli.cjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-const require_plugin = require("./plugin--jQ6D6O4.cjs");
+const require_plugin = require("./plugin-GTN_SQ7d.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
 let node_url = require("node:url");
 let vite = require("vite");
 let node_module = require("node:module");
 let cac = require("cac");
-let node_fs_promises = require("node:fs/promises");
 let _clarify_labs_templates = require("@clarify-labs/templates");
 let node_child_process = require("node:child_process");
 //#region source/core/log.ts
@@ -207,6 +207,152 @@ async function runBuild(options) {
 	}
 }
 //#endregion
+//#region source/cli/commands/check.ts
+var LOCAL_LINK_PATTERN = /(?<!!)(?:\[[^\]]*\]\(([^)\s]+)(?:\s+"[^"]*")?\)|<a\s+[^>]*href=["']([^"']+)["'])/gi;
+var ROUTE_EXTENSIONS = new Set([".md", ".mdx"]);
+var IGNORED_SCHEMES = /^[a-z][a-z0-9+.-]*:/i;
+function addDiagnostic(result, diagnostic) {
+	if (diagnostic.level === "error") result.errors.push(diagnostic);
+	else result.warnings.push(diagnostic);
+}
+function normalizeRoutePath(path) {
+	const [withoutHash] = path.split("#");
+	const clean = withoutHash.replace(/\/index$/, "") || "/";
+	return clean.startsWith("/") ? clean : `/${clean}`;
+}
+function routePathCandidates(href, route) {
+	const [withoutHashOrQuery] = href.split(/[?#]/);
+	if (!withoutHashOrQuery || withoutHashOrQuery.startsWith("#")) return [];
+	if (withoutHashOrQuery.startsWith("/")) return [normalizeRoutePath(withoutHashOrQuery)];
+	const joined = (0, node_path.normalize)((0, node_path.join)((0, node_path.dirname)(route.path), withoutHashOrQuery)).replaceAll("\\", "/");
+	const extension = (0, node_path.extname)(joined);
+	return [normalizeRoutePath(ROUTE_EXTENSIONS.has(extension) ? joined.slice(0, -extension.length) : joined)];
+}
+async function pathExists(filePath) {
+	try {
+		await (0, node_fs_promises.stat)(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+}
+function isLocalHref(href) {
+	return Boolean(href) && !href.startsWith("#") && !href.startsWith("//") && !IGNORED_SCHEMES.test(href);
+}
+async function resolveLocalFileLink(href, route, contentRoot) {
+	const [withoutHashOrQuery] = href.split(/[?#]/);
+	if (!withoutHashOrQuery || withoutHashOrQuery.startsWith("/")) return false;
+	const target = (0, node_path.resolve)((0, node_path.dirname)(route.filePath), withoutHashOrQuery);
+	const relativeTarget = (0, node_path.relative)(contentRoot, target);
+	if (relativeTarget.startsWith("..") || (0, node_path.isAbsolute)(relativeTarget)) return false;
+	if (await pathExists(target)) return true;
+	if (!(0, node_path.extname)(target)) return pathExists(`${target}.md`) || pathExists(`${target}.mdx`) || pathExists((0, node_path.join)(target, "index.md")) || pathExists((0, node_path.join)(target, "index.mdx"));
+	return false;
+}
+async function checkContentDirectory(contentRoot, result) {
+	try {
+		if (!(await (0, node_fs_promises.lstat)(contentRoot)).isDirectory()) addDiagnostic(result, {
+			level: "error",
+			code: "content-not-directory",
+			message: `Content path is not a directory: ${contentRoot}`,
+			filePath: contentRoot
+		});
+	} catch {
+		addDiagnostic(result, {
+			level: "error",
+			code: "content-missing",
+			message: `Content directory does not exist: ${contentRoot}`,
+			filePath: contentRoot
+		});
+	}
+}
+function checkDuplicateRoutes(routes, result) {
+	const byPath = /* @__PURE__ */ new Map();
+	for (const route of routes) {
+		const key = `${route.locale ?? ""}:${route.path}`;
+		byPath.set(key, [...byPath.get(key) ?? [], route]);
+	}
+	for (const duplicated of byPath.values()) {
+		if (duplicated.length < 2) continue;
+		for (const route of duplicated) addDiagnostic(result, {
+			level: "error",
+			code: "duplicate-route",
+			message: `Route "${route.path}" is defined by multiple files: ${duplicated.map((route) => (0, node_path.relative)(process.cwd(), route.filePath)).join(", ")}`,
+			filePath: route.filePath,
+			routePath: route.path
+		});
+	}
+}
+function checkFallbackRoutes(routes, result) {
+	for (const route of routes) {
+		if (!route.isFallback) continue;
+		addDiagnostic(result, {
+			level: "warning",
+			code: "i18n-fallback-route",
+			message: `Route "${route.path}" falls back to ${route.locale ?? "default"} content from ${(0, node_path.relative)(process.cwd(), route.filePath)}`,
+			filePath: route.filePath,
+			routePath: route.path
+		});
+	}
+}
+async function checkLocalLinks(routes, contentRoot, result) {
+	const routePaths = new Set(routes.map((route) => route.path));
+	for (const route of routes) {
+		if (route.kind !== "mdx" || !route.content) continue;
+		for (const match of route.content.matchAll(LOCAL_LINK_PATTERN)) {
+			const href = match[1] ?? match[2];
+			if (!href || !isLocalHref(href)) continue;
+			if (routePathCandidates(href, route).some((candidate) => routePaths.has(candidate))) continue;
+			if (await resolveLocalFileLink(href, route, contentRoot)) continue;
+			addDiagnostic(result, {
+				level: "error",
+				code: "broken-link",
+				message: `Broken local link "${href}" in route "${route.path}"`,
+				filePath: route.filePath,
+				routePath: route.path
+			});
+		}
+	}
+}
+function printTextResult(result, strict) {
+	const diagnostics = [...result.errors, ...result.warnings];
+	if (diagnostics.length === 0) {
+		console.log("✓ Clarify check passed");
+		return;
+	}
+	for (const diagnostic of diagnostics) {
+		const location = diagnostic.filePath ? ` ${(0, node_path.relative)(process.cwd(), diagnostic.filePath)}` : "";
+		const route = diagnostic.routePath ? ` (${diagnostic.routePath})` : "";
+		console.log(`${diagnostic.level.toUpperCase()} ${diagnostic.code}${location}${route}`);
+		console.log(`  ${diagnostic.message}`);
+	}
+	const warningExit = strict && result.warnings.length > 0;
+	console.log(`\n${result.errors.length} error(s), ${result.warnings.length} warning(s)${warningExit ? " (--strict treats warnings as failures)" : ""}`);
+}
+async function runCheck(options = {}) {
+	const root = (0, node_path.resolve)(options.root ?? process.cwd());
+	const site = await require_plugin.resolveClarifySite({
+		...(0, node_fs.existsSync)(root) ? await require_plugin.loadClarifyConfig(root, {
+			command: "build",
+			mode: "production"
+		}) : {},
+		projectRoot: root,
+		rootDirectory: options.content,
+		outputDirectory: options.output
+	}, { includeHtmlShellPlugin: false });
+	const result = {
+		errors: [],
+		warnings: []
+	};
+	await checkContentDirectory(site.contentRoot, result);
+	checkDuplicateRoutes(site.routes, result);
+	checkFallbackRoutes(site.routes, result);
+	await checkLocalLinks(site.routes, site.contentRoot, result);
+	if (options.format === "json") console.log(JSON.stringify(result, null, 2));
+	else printTextResult(result, Boolean(options.strict));
+	if (result.errors.length > 0 || options.strict && result.warnings.length > 0) process.exitCode = 1;
+}
+//#endregion
 //#region source/cli/commands/dev.ts
 async function runDev(options) {
 	const server = await (0, vite.createServer)(await createViteConfig(options, {
@@ -219,7 +365,7 @@ async function runDev(options) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.6.4",
+	version: "0.6.6",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -411,6 +557,9 @@ async function main() {
 	withSharedOptions(cli.command("build", "Build the static documentation site")).action(async (options) => {
 		await runBuild(resolveOptions(options));
 	});
+	withSharedOptions(cli.command("check", "Validate the documentation project")).option("--strict", "Treat warnings as failures").option("--format <format>", "Output format: text or json").action(async (options) => {
+		await runCheck(options);
+	});
 	withSharedOptions(cli.command("init", "Create a Clarify project scaffold")).option("--force", "Overwrite files created by init").option("--template <name>", "Template to use: minimal, standard, or complete").option("--install", "Install dependencies after init").action((options) => {
 		runInit(resolveOptions(options), options.force === true, options.template, options.install === true);
 	});

package/output/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.cjs","names":[],"sources":["../source/core/log.ts","../source/core/vite-config.ts","../source/cli/commands/build.ts","../source/cli/commands/dev.ts","../package.json","../source/cli/package.ts","../source/cli/spawn.ts","../source/cli/commands/init.ts","../source/cli/options.ts","../source/cli/index.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { readFile, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\n\nconst LOG_FILE_NAME = '.clarify.log'\nconst DEFAULT_LOG_ENTRIES = 50\nconst ENTRY_SEPARATOR = '\\n\\n---\\n\\n'\n\nfunction getMaxLogEntries(): number {\n  const envValue = process.env.CLARIFY_LOG_MAX_ENTRIES\n  if (!envValue) return DEFAULT_LOG_ENTRIES\n  const parsed = Number(envValue)\n  return Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_LOG_ENTRIES\n}\n\nfunction normalizeErrorMessage(error: unknown): string {\n  if (error === undefined) return 'undefined'\n  if (error === null) return 'null'\n  if (error instanceof Error) return error.message\n  if (typeof error === 'object') {\n    if ('message' in error && typeof (error as { message?: unknown }).message === 'string') {\n      return (error as { message: string }).message\n    }\n    try {\n      return JSON.stringify(error)\n    } catch {\n      return String(error)\n    }\n  }\n  return String(error)\n}\n\nfunction normalizeErrorStack(error: unknown): string | undefined {\n  if (error instanceof Error) {\n    return error.stack\n  }\n  return undefined\n}\n\nfunction formatLogEntry(root: string, error: unknown): string {\n  const timestamp = new Date().toISOString()\n  const message = normalizeErrorMessage(error)\n  const stack = normalizeErrorStack(error)\n\n  return [`=== Clarify build error ===`, `Timestamp: ${timestamp}`, `Project root: ${root}`, `Error: ${message}`, stack ? `Stack:\\n${stack}` : undefined]\n    .filter(Boolean)\n    .join('\\n')\n}\n\nexport async function logBuildError(root: string, error: unknown, maxEntries?: number): Promise<void> {\n  const logPath = join(root, LOG_FILE_NAME)\n  const entry = formatLogEntry(root, error)\n  const max = maxEntries ?? getMaxLogEntries()\n\n  let entries: string[] = []\n  if (existsSync(logPath)) {\n    try {\n      const content = await readFile(logPath, 'utf8')\n      entries = content\n        .split(ENTRY_SEPARATOR)\n        .map((item) => item.trim())\n        .filter(Boolean)\n    } catch {\n      entries = []\n    }\n  }\n\n  entries.push(entry)\n  if (entries.length > max) {\n    entries = entries.slice(-max)\n  }\n\n  mkdirSync(dirname(logPath), { recursive: true })\n  await writeFile(logPath, entries.join(ENTRY_SEPARATOR) + '\\n', 'utf8')\n}\n\nexport function logBuildErrorSync(root: string, error: unknown, maxEntries?: number): void {\n  const logPath = join(root, LOG_FILE_NAME)\n  const entry = formatLogEntry(root, error)\n  const max = maxEntries ?? getMaxLogEntries()\n\n  let entries: string[] = []\n  if (existsSync(logPath)) {\n    try {\n      const content = readFileSync(logPath, 'utf8')\n      entries = content\n        .split(ENTRY_SEPARATOR)\n        .map((item) => item.trim())\n        .filter(Boolean)\n    } catch {\n      entries = []\n    }\n  }\n\n  entries.push(entry)\n  if (entries.length > max) {\n    entries = entries.slice(-max)\n  }\n\n  mkdirSync(dirname(logPath), { recursive: true })\n  writeFileSync(logPath, entries.join(ENTRY_SEPARATOR) + '\\n', 'utf8')\n}\n","import { existsSync, mkdirSync, writeFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\n\nimport { createLogger } from 'vite'\nimport type { ConfigEnv, InlineConfig, Plugin, LogLevel, Logger, LogOptions, LogErrorOptions, LogType } from 'vite'\n\nimport { logBuildErrorSync } from './log.js'\nimport type { ClarifyBuildOptions } from './options.js'\nimport { clarifyPlugin } from './plugin.js'\nimport { createClarifyRuntimeAliases } from './runtime-deps.js'\nimport { loadClarifyConfig } from './user-config.js'\n\nexport type ClarifyViteConfigOptions = {\n  root: string\n  content: string\n  output: string\n  host?: string | boolean\n  port?: number\n  open?: boolean | string\n}\n\nconst DEFAULT_HTML = '<!doctype html><html lang=\"en\"><head><meta charset=\"UTF-8\" /><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" /><title>Clarify</title></head><body><div id=\"root\"></div></body></html>'\n\nfunction ensureHtmlEntry(root: string): string {\n  const projectHtmlPath = resolve(root, 'index.html')\n  if (existsSync(projectHtmlPath)) return projectHtmlPath\n\n  const generatedHtmlPath = resolve(root, '.clarify/index.html')\n  mkdirSync(dirname(generatedHtmlPath), { recursive: true })\n  writeFileSync(generatedHtmlPath, DEFAULT_HTML, 'utf-8')\n  return generatedHtmlPath\n}\n\nfunction createClarifyLogger(root: string, env: ConfigEnv, level: LogLevel): Logger | undefined {\n  if (env.command !== 'build') return undefined\n\n  const baseLogger = createLogger(level, { allowClearScreen: true })\n\n  return {\n    info(msg: string, options?: LogOptions) {\n      baseLogger.info(msg, options)\n    },\n    warn(msg: string, options?: LogOptions) {\n      baseLogger.warn(msg, options)\n    },\n    warnOnce(msg: string, options?: LogOptions) {\n      baseLogger.warnOnce(msg, options)\n    },\n    error(msg: string, options?: LogErrorOptions) {\n      baseLogger.error(msg, options)\n      if (options?.error) {\n        logBuildErrorSync(root, options.error)\n      } else {\n        logBuildErrorSync(root, typeof msg === 'string' ? new Error(msg) : msg)\n      }\n    },\n    clearScreen(type: LogType) {\n      baseLogger.clearScreen(type)\n    },\n    hasErrorLogged(error: Error | unknown) {\n      return baseLogger.hasErrorLogged(error as Error)\n    },\n    get hasWarned() {\n      return baseLogger.hasWarned\n    },\n  }\n}\n\nfunction createHtmlFallbackPlugin(): Plugin {\n  return {\n    name: 'clarify:cli-html-fallback',\n    configureServer(server) {\n      server.middlewares.use(async (req, res, next) => {\n        const requestPath = req.url?.split('?')[0] ?? '/'\n        const acceptsHtml = req.headers.accept?.includes('text/html') ?? false\n        const hasFileExtension = /\\.[^/]+$/.test(requestPath)\n        if (!acceptsHtml || hasFileExtension) {\n          next()\n          return\n        }\n\n        try {\n          const html = await server.transformIndexHtml(requestPath, DEFAULT_HTML)\n          res.statusCode = 200\n          res.setHeader('Content-Type', 'text/html; charset=utf-8')\n          res.end(html)\n        } catch (error) {\n          next(error)\n        }\n      })\n    },\n  }\n}\n\nexport async function createViteConfig(options: ClarifyViteConfigOptions, env: ConfigEnv): Promise<InlineConfig> {\n  const entryHtmlPath = ensureHtmlEntry(options.root)\n  const userConfig = await loadClarifyConfig(options.root, env)\n  const buildOptions: ClarifyBuildOptions = {\n    ...userConfig,\n    projectRoot: options.root,\n    rootDirectory: options.content,\n    outputDirectory: options.output,\n  }\n\n  return {\n    root: options.root,\n    configFile: false,\n    appType: 'custom',\n    resolve: {\n      alias: createClarifyRuntimeAliases(),\n    },\n    customLogger: createClarifyLogger(options.root, env, 'info'),\n    plugins: [\n      clarifyPlugin(buildOptions),\n      createHtmlFallbackPlugin(),\n    ],\n    server: {\n      host: options.host,\n      port: options.port,\n      open: options.open,\n    },\n    build: {\n      outDir: options.output,\n      rolldownOptions: {\n        input: {\n          index: entryHtmlPath,\n        },\n        checks: {\n          pluginTimings: false,\n        },\n        output: {\n          codeSplitting: {\n            groups: [\n              {\n                name: 'react-vendor',\n                test: /node_modules[\\\\/](react|react-dom|react-router|react-router-dom)[\\\\/]/,\n                priority: 40,\n              },\n              {\n                name: 'icons-vendor',\n                test: /node_modules[\\\\/]lucide-react[\\\\/]/,\n                priority: 35,\n              },\n              {\n                name: 'ui-vendor',\n                test: /node_modules[\\\\/](@headlessui|framer-motion)[\\\\/]/,\n                priority: 30,\n              },\n              {\n                name: 'vendor',\n                test: /node_modules[\\\\/]/,\n                priority: 10\n              },\n            ],\n          },\n        },\n      },\n    },\n  }\n}\n","import { build as viteBuild } from 'vite'\n\nimport { logBuildError } from '../../core/log.js'\nimport { createViteConfig } from '../../core/vite-config.js'\nimport type { ResolvedCliOptions } from '../options.js'\n\nexport async function runBuild(options: ResolvedCliOptions): Promise<void> {\n  try {\n    await viteBuild(await createViteConfig(options, { command: 'build', mode: 'production' }))\n  } catch (error) {\n    await logBuildError(options.root, error)\n    throw error\n  }\n}\n","import { createServer } from 'vite'\n\nimport { createViteConfig } from '../../core/vite-config.js'\nimport type { ResolvedCliOptions } from '../options.js'\n\nexport async function runDev(options: ResolvedCliOptions): Promise<void> {\n  const server = await createServer(await createViteConfig(options, { command: 'serve', mode: 'development' }))\n  await server.listen()\n  server.printUrls()\n  server.bindCLIShortcuts({ print: true })\n}\n","{\n  \"name\": \"@clarify-labs/cli\",\n  \"version\": \"0.6.4\",\n  \"license\": \"AGPL-3.0-only\",\n  \"type\": \"module\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/taicode-labs/clarify\",\n    \"directory\": \"packages/cli\"\n  },\n  \"main\": \"output/index.cjs\",\n  \"module\": \"output/index.js\",\n  \"types\": \"output/index.d.ts\",\n  \"bin\": {\n    \"clarify\": \"bin/clarify.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./output/index.d.ts\",\n      \"import\": \"./output/index.js\",\n      \"require\": \"./output/index.cjs\",\n      \"default\": \"./output/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"LICENSE\",\n    \"bin\",\n    \"output\"\n  ],\n  \"scripts\": {\n    \"dev\": \"vite build --watch\",\n    \"build\": \"vite build\",\n    \"lint\": \"eslint source/\",\n    \"lint:fix\": \"eslint source/ --fix\",\n    \"typecheck\": \"tsc -p tsconfig.json --noEmit\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\"\n  },\n  \"dependencies\": {\n    \"@apidevtools/swagger-parser\": \"^12.1.0\",\n    \"@clarify-labs/renderer\": \"workspace:*\",\n    \"@clarify-labs/templates\": \"workspace:*\",\n    \"@mdx-js/rollup\": \"^3.1.1\",\n    \"@tailwindcss/vite\": \"^4.1.11\",\n    \"@vitejs/plugin-react\": \"^6.0.2\",\n    \"cac\": \"^7.0.0\",\n    \"github-slugger\": \"^2.0.0\",\n    \"gray-matter\": \"^4.0.3\",\n    \"mdast-util-to-string\": \"^4.0.0\",\n    \"openapi-types\": \"^12.1.3\",\n    \"react\": \"^19.1.0\",\n    \"react-dom\": \"^19.1.0\",\n    \"react-router\": \"^7.0.0\",\n    \"react-router-dom\": \"^7.0.0\",\n    \"remark\": \"^15.0.1\",\n    \"remark-gfm\": \"^4.0.1\",\n    \"shiki\": \"0.14.7\",\n    \"unist-util-visit\": \"^5.1.0\",\n    \"vite\": \"^8.0.15\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"devDependencies\": {\n    \"@mdx-js/mdx\": \"^3.1.1\",\n    \"typescript\": \"^5.8.3\",\n    \"vite-plugin-dts\": \"^4.5.4\",\n    \"vitest\": \"^4.1.9\"\n  }\n}\n","import packageJson from '../../package.json' with { type: 'json' }\n\nexport const cliPackageJson = packageJson as { version?: string }\nexport const cliPackageVersion = cliPackageJson.version ?? '0.0.0'\nexport const cliPackageVersionWithCaret = `^${cliPackageVersion}`\n\nexport function readPackageVersion(): string {\n  return cliPackageVersion\n}\n","import { spawnSync as nodeSpawnSync, SpawnSyncOptions } from 'node:child_process'\n\ntype SpawnOptions = { cwd?: string; stdio?: 'inherit' | 'ignore' | Array<string> }\n\nexport function spawnSync(command: string, args: string[], options: SpawnOptions) {\n  return nodeSpawnSync(command, args, options as SpawnSyncOptions)\n}\n","import { existsSync, readFileSync, writeFileSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { copyTemplateDirectory, getTemplateDirectory, resolveTemplate } from '@clarify-labs/templates'\n\nimport type { ResolvedCliOptions } from '../options.js'\nimport { cliPackageVersionWithCaret } from '../package.js'\nimport { spawnSync } from '../spawn.js'\n\nconst require = createRequire(import.meta.url)\n\nfunction findTemplatesPackagePath(): string {\n  try {\n    return require.resolve('@clarify-labs/templates/package.json')\n  } catch {\n    const currentDirectory = dirname(fileURLToPath(import.meta.url))\n    const workspacePackagePath = resolve(currentDirectory, '../../../../templates/package.json')\n    if (existsSync(workspacePackagePath)) return workspacePackagePath\n    throw new Error('[clarify] Templates package not found.')\n  }\n}\n\nconst templatesPackagePath = findTemplatesPackagePath()\nconst templatesDirectory = dirname(templatesPackagePath)\n\nfunction commandExists(program: string): boolean {\n  const result = spawnSync(program, ['--version'], { stdio: 'ignore' })\n  return result.status === 0 && result.error === undefined\n}\n\ntype InstallCommand = { command: string; args: string[] }\n\nfunction getInstallCommand(): InstallCommand {\n  if (commandExists('pnpm')) return { command: 'pnpm', args: ['install'] }\n  if (commandExists('npm')) return { command: 'npm', args: ['install'] }\n  if (commandExists('yarn')) return { command: 'yarn', args: ['install'] }\n  return { command: 'npm', args: ['install'] }\n}\n\nfunction installDependencies(root: string): void {\n  const { command, args } = getInstallCommand()\n  console.log(`[clarify] Installing dependencies with ${command}...`)\n  const result = spawnSync(command, args, { cwd: root, stdio: 'inherit' })\n  if (result.status !== 0) {\n    throw new Error(`[clarify] Dependency install failed with ${command}`)\n  }\n}\n\nfunction getSuggestedInstallCommand(): string {\n  if (commandExists('pnpm')) return 'pnpm install'\n  if (commandExists('npm')) return 'npm install'\n  if (commandExists('yarn')) return 'yarn install'\n  return 'npm install'\n}\n\nfunction updatePackageJson(root: string, force: boolean): boolean {\n  const packageJsonPath = resolve(root, 'package.json')\n  const packageJson = existsSync(packageJsonPath)\n    ? JSON.parse(readFileSync(packageJsonPath, 'utf-8')) as Record<string, unknown>\n    : { type: 'module' }\n\n  const scripts = typeof packageJson.scripts === 'object' && packageJson.scripts !== null\n    ? packageJson.scripts as Record<string, string>\n    : {}\n\n  if (force || !scripts.dev) scripts.dev = 'clarify dev'\n  if (force || !scripts.build) scripts.build = 'clarify build'\n  packageJson.scripts = scripts\n\n  const devDependencies = typeof packageJson.devDependencies === 'object' && packageJson.devDependencies !== null\n    ? packageJson.devDependencies as Record<string, string>\n    : {}\n  if (!devDependencies['@clarify-labs/cli']) devDependencies['@clarify-labs/cli'] = cliPackageVersionWithCaret\n  packageJson.devDependencies = devDependencies\n\n  writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\\n`, 'utf-8')\n  return true\n}\n\nexport function runInit(options: ResolvedCliOptions, force: boolean, template?: string, install = false): void {\n  const selectedTemplate = resolveTemplate(template)\n  const templateDirectory = getTemplateDirectory(templatesDirectory, selectedTemplate)\n  const { created } = copyTemplateDirectory(templateDirectory, options.root, {\n    contentDir: options.content,\n    force,\n  })\n\n  const packageJsonUpdated = updatePackageJson(options.root, force)\n  if (packageJsonUpdated) created.push('package.json')\n\n  console.log(`[clarify] Project scaffold created using the ${selectedTemplate} template.`)\n  if (created.length > 0) {\n    console.log(`[clarify] Created or updated ${created.length} ${created.length === 1 ? 'file' : 'files'}: ${created.join(', ')}`)\n  }\n\n  if (install) {\n    installDependencies(options.root)\n    console.log('[clarify] Dependencies installed successfully.')\n    console.log('[clarify] You can now run `clarify dev` to start the local documentation server.')\n    return\n  }\n\n  const suggestedInstall = getSuggestedInstallCommand()\n  console.log('[clarify] Next steps:')\n  console.log('  1. Change into your new project directory:')\n  console.log(`       cd ${options.root}`)\n  console.log('  2. Install dependencies:')\n  console.log(`       ${suggestedInstall}`)\n  console.log('  3. Start the local documentation server:')\n  console.log('       clarify dev')\n}\n","import { resolve } from 'node:path'\n\nexport type CliOptions = {\n  root?: string\n  content?: string\n  output?: string\n  host?: string | boolean\n  port?: string | number\n  open?: boolean | string\n}\n\nexport type ResolvedCliOptions = {\n  root: string\n  content: string\n  output: string\n  host?: string | boolean\n  port?: number\n  open?: boolean | string\n}\n\nfunction resolvePort(port: CliOptions['port']): number | undefined {\n  if (port === undefined) return undefined\n\n  const parsedPort = typeof port === 'string' ? Number(port) : port\n  if (!Number.isInteger(parsedPort) || parsedPort < 1 || parsedPort > 65535) {\n    throw new Error('[clarify] --port must be an integer between 1 and 65535')\n  }\n\n  return parsedPort\n}\n\nexport function resolveCliOptions(options: CliOptions): ResolvedCliOptions {\n  return {\n    root: resolve(options.root ?? process.cwd()),\n    content: options.content ?? 'source',\n    output: options.output ?? 'output',\n    host: options.host,\n    port: resolvePort(options.port),\n    open: options.open,\n  }\n}\n","#!/usr/bin/env node\nimport { cac } from 'cac'\n\nimport { runBuild } from './commands/build.js'\nimport { runDev } from './commands/dev.js'\nimport { runInit } from './commands/init.js'\nimport { resolveCliOptions, type CliOptions, type ResolvedCliOptions } from './options.js'\nimport { cliPackageVersion } from './package.js'\n\ntype InitCommandOptions = CliOptions & {\n  force?: boolean\n  template?: string\n  install?: boolean\n}\n\nfunction withSharedOptions(command: ReturnType<ReturnType<typeof cac>['command']>) {\n  return command\n    .option('--root <dir>', 'Project root directory')\n    .option('--content <dir>', 'Content directory relative to root')\n    .option('--output <dir>', 'Build output directory relative to root')\n}\n\nfunction resolveOptions(options: CliOptions): ResolvedCliOptions {\n  return resolveCliOptions(options)\n}\n\nasync function main(): Promise<void> {\n  const cli = cac('clarify')\n\n  cli\n    .version(cliPackageVersion)\n    .help()\n\n  withSharedOptions(cli.command('dev', 'Start the local documentation server'))\n    .option('--host [host]', 'Dev server host')\n    .option('--port <port>', 'Dev server port')\n    .option('--open [path]', 'Open the dev server in a browser')\n    .action(async (options: CliOptions) => {\n      await runDev(resolveOptions(options))\n    })\n\n  withSharedOptions(cli.command('build', 'Build the static documentation site'))\n    .action(async (options: CliOptions) => {\n      await runBuild(resolveOptions(options))\n    })\n\n  withSharedOptions(cli.command('init', 'Create a Clarify project scaffold'))\n    .option('--force', 'Overwrite files created by init')\n    .option('--template <name>', 'Template to use: minimal, standard, or complete')\n    .option('--install', 'Install dependencies after init')\n    .action((options: InitCommandOptions) => {\n      runInit(resolveOptions(options), options.force === true, options.template, options.install === true)\n    })\n\n  const args = process.argv.slice(2)\n  cli.parse(process.argv, { run: false })\n\n  if (args.length === 0) {\n    cli.outputHelp()\n    return\n  }\n\n  await cli.runMatchedCommand()\n}\n\nmain().catch(error => {\n  console.error(error instanceof Error ? error.stack ?? error.message : String(error))\n  process.exitCode = 1\n})\n"],"mappings":"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"}
+{"version":3,"file":"cli.cjs","names":[],"sources":["../source/core/log.ts","../source/core/vite-config.ts","../source/cli/commands/build.ts","../source/cli/commands/check.ts","../source/cli/commands/dev.ts","../package.json","../source/cli/package.ts","../source/cli/spawn.ts","../source/cli/commands/init.ts","../source/cli/options.ts","../source/cli/index.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { readFile, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\n\nconst LOG_FILE_NAME = '.clarify.log'\nconst DEFAULT_LOG_ENTRIES = 50\nconst ENTRY_SEPARATOR = '\\n\\n---\\n\\n'\n\nfunction getMaxLogEntries(): number {\n  const envValue = process.env.CLARIFY_LOG_MAX_ENTRIES\n  if (!envValue) return DEFAULT_LOG_ENTRIES\n  const parsed = Number(envValue)\n  return Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_LOG_ENTRIES\n}\n\nfunction normalizeErrorMessage(error: unknown): string {\n  if (error === undefined) return 'undefined'\n  if (error === null) return 'null'\n  if (error instanceof Error) return error.message\n  if (typeof error === 'object') {\n    if ('message' in error && typeof (error as { message?: unknown }).message === 'string') {\n      return (error as { message: string }).message\n    }\n    try {\n      return JSON.stringify(error)\n    } catch {\n      return String(error)\n    }\n  }\n  return String(error)\n}\n\nfunction normalizeErrorStack(error: unknown): string | undefined {\n  if (error instanceof Error) {\n    return error.stack\n  }\n  return undefined\n}\n\nfunction formatLogEntry(root: string, error: unknown): string {\n  const timestamp = new Date().toISOString()\n  const message = normalizeErrorMessage(error)\n  const stack = normalizeErrorStack(error)\n\n  return [`=== Clarify build error ===`, `Timestamp: ${timestamp}`, `Project root: ${root}`, `Error: ${message}`, stack ? `Stack:\\n${stack}` : undefined]\n    .filter(Boolean)\n    .join('\\n')\n}\n\nexport async function logBuildError(root: string, error: unknown, maxEntries?: number): Promise<void> {\n  const logPath = join(root, LOG_FILE_NAME)\n  const entry = formatLogEntry(root, error)\n  const max = maxEntries ?? getMaxLogEntries()\n\n  let entries: string[] = []\n  if (existsSync(logPath)) {\n    try {\n      const content = await readFile(logPath, 'utf8')\n      entries = content\n        .split(ENTRY_SEPARATOR)\n        .map((item) => item.trim())\n        .filter(Boolean)\n    } catch {\n      entries = []\n    }\n  }\n\n  entries.push(entry)\n  if (entries.length > max) {\n    entries = entries.slice(-max)\n  }\n\n  mkdirSync(dirname(logPath), { recursive: true })\n  await writeFile(logPath, entries.join(ENTRY_SEPARATOR) + '\\n', 'utf8')\n}\n\nexport function logBuildErrorSync(root: string, error: unknown, maxEntries?: number): void {\n  const logPath = join(root, LOG_FILE_NAME)\n  const entry = formatLogEntry(root, error)\n  const max = maxEntries ?? getMaxLogEntries()\n\n  let entries: string[] = []\n  if (existsSync(logPath)) {\n    try {\n      const content = readFileSync(logPath, 'utf8')\n      entries = content\n        .split(ENTRY_SEPARATOR)\n        .map((item) => item.trim())\n        .filter(Boolean)\n    } catch {\n      entries = []\n    }\n  }\n\n  entries.push(entry)\n  if (entries.length > max) {\n    entries = entries.slice(-max)\n  }\n\n  mkdirSync(dirname(logPath), { recursive: true })\n  writeFileSync(logPath, entries.join(ENTRY_SEPARATOR) + '\\n', 'utf8')\n}\n","import { existsSync, mkdirSync, writeFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\n\nimport { createLogger } from 'vite'\nimport type { ConfigEnv, InlineConfig, Plugin, LogLevel, Logger, LogOptions, LogErrorOptions, LogType } from 'vite'\n\nimport { logBuildErrorSync } from './log.js'\nimport type { ClarifyBuildOptions } from './options.js'\nimport { clarifyPlugin } from './plugin.js'\nimport { createClarifyRuntimeAliases } from './runtime-deps.js'\nimport { loadClarifyConfig } from './user-config.js'\n\nexport type ClarifyViteConfigOptions = {\n  root: string\n  content: string\n  output: string\n  host?: string | boolean\n  port?: number\n  open?: boolean | string\n}\n\nconst DEFAULT_HTML = '<!doctype html><html lang=\"en\"><head><meta charset=\"UTF-8\" /><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" /><title>Clarify</title></head><body><div id=\"root\"></div></body></html>'\n\nfunction ensureHtmlEntry(root: string): string {\n  const projectHtmlPath = resolve(root, 'index.html')\n  if (existsSync(projectHtmlPath)) return projectHtmlPath\n\n  const generatedHtmlPath = resolve(root, '.clarify/index.html')\n  mkdirSync(dirname(generatedHtmlPath), { recursive: true })\n  writeFileSync(generatedHtmlPath, DEFAULT_HTML, 'utf-8')\n  return generatedHtmlPath\n}\n\nfunction createClarifyLogger(root: string, env: ConfigEnv, level: LogLevel): Logger | undefined {\n  if (env.command !== 'build') return undefined\n\n  const baseLogger = createLogger(level, { allowClearScreen: true })\n\n  return {\n    info(msg: string, options?: LogOptions) {\n      baseLogger.info(msg, options)\n    },\n    warn(msg: string, options?: LogOptions) {\n      baseLogger.warn(msg, options)\n    },\n    warnOnce(msg: string, options?: LogOptions) {\n      baseLogger.warnOnce(msg, options)\n    },\n    error(msg: string, options?: LogErrorOptions) {\n      baseLogger.error(msg, options)\n      if (options?.error) {\n        logBuildErrorSync(root, options.error)\n      } else {\n        logBuildErrorSync(root, typeof msg === 'string' ? new Error(msg) : msg)\n      }\n    },\n    clearScreen(type: LogType) {\n      baseLogger.clearScreen(type)\n    },\n    hasErrorLogged(error: Error | unknown) {\n      return baseLogger.hasErrorLogged(error as Error)\n    },\n    get hasWarned() {\n      return baseLogger.hasWarned\n    },\n  }\n}\n\nfunction createHtmlFallbackPlugin(): Plugin {\n  return {\n    name: 'clarify:cli-html-fallback',\n    configureServer(server) {\n      server.middlewares.use(async (req, res, next) => {\n        const requestPath = req.url?.split('?')[0] ?? '/'\n        const acceptsHtml = req.headers.accept?.includes('text/html') ?? false\n        const hasFileExtension = /\\.[^/]+$/.test(requestPath)\n        if (!acceptsHtml || hasFileExtension) {\n          next()\n          return\n        }\n\n        try {\n          const html = await server.transformIndexHtml(requestPath, DEFAULT_HTML)\n          res.statusCode = 200\n          res.setHeader('Content-Type', 'text/html; charset=utf-8')\n          res.end(html)\n        } catch (error) {\n          next(error)\n        }\n      })\n    },\n  }\n}\n\nexport async function createViteConfig(options: ClarifyViteConfigOptions, env: ConfigEnv): Promise<InlineConfig> {\n  const entryHtmlPath = ensureHtmlEntry(options.root)\n  const userConfig = await loadClarifyConfig(options.root, env)\n  const buildOptions: ClarifyBuildOptions = {\n    ...userConfig,\n    projectRoot: options.root,\n    rootDirectory: options.content,\n    outputDirectory: options.output,\n  }\n\n  return {\n    root: options.root,\n    configFile: false,\n    appType: 'custom',\n    resolve: {\n      alias: createClarifyRuntimeAliases(),\n    },\n    customLogger: createClarifyLogger(options.root, env, 'info'),\n    plugins: [\n      clarifyPlugin(buildOptions),\n      createHtmlFallbackPlugin(),\n    ],\n    server: {\n      host: options.host,\n      port: options.port,\n      open: options.open,\n    },\n    build: {\n      outDir: options.output,\n      rolldownOptions: {\n        input: {\n          index: entryHtmlPath,\n        },\n        checks: {\n          pluginTimings: false,\n        },\n        output: {\n          codeSplitting: {\n            groups: [\n              {\n                name: 'react-vendor',\n                test: /node_modules[\\\\/](react|react-dom|react-router|react-router-dom)[\\\\/]/,\n                priority: 40,\n              },\n              {\n                name: 'icons-vendor',\n                test: /node_modules[\\\\/]lucide-react[\\\\/]/,\n                priority: 35,\n              },\n              {\n                name: 'ui-vendor',\n                test: /node_modules[\\\\/](@headlessui|framer-motion)[\\\\/]/,\n                priority: 30,\n              },\n              {\n                name: 'vendor',\n                test: /node_modules[\\\\/]/,\n                priority: 10\n              },\n            ],\n          },\n        },\n      },\n    },\n  }\n}\n","import { build as viteBuild } from 'vite'\n\nimport { logBuildError } from '../../core/log.js'\nimport { createViteConfig } from '../../core/vite-config.js'\nimport type { ResolvedCliOptions } from '../options.js'\n\nexport async function runBuild(options: ResolvedCliOptions): Promise<void> {\n  try {\n    await viteBuild(await createViteConfig(options, { command: 'build', mode: 'production' }))\n  } catch (error) {\n    await logBuildError(options.root, error)\n    throw error\n  }\n}\n","import { existsSync } from 'node:fs'\nimport { lstat, stat } from 'node:fs/promises'\nimport { dirname, extname, isAbsolute, join, normalize, relative, resolve } from 'node:path'\n\nimport type { CliOptions } from '../options.js'\nimport { loadClarifyConfig } from '../../core/user-config.js'\nimport { resolveClarifySite } from '../../core/site.js'\nimport type { ContentRoute } from '../../types.js'\n\nexport type CheckCommandOptions = CliOptions & {\n  strict?: boolean\n  format?: 'text' | 'json' | string\n}\n\ntype CheckLevel = 'error' | 'warning'\n\ntype CheckDiagnostic = {\n  level: CheckLevel\n  code: string\n  message: string\n  filePath?: string\n  routePath?: string\n}\n\ntype CheckResult = {\n  errors: CheckDiagnostic[]\n  warnings: CheckDiagnostic[]\n}\n\nconst LOCAL_LINK_PATTERN = /(?<!!)(?:\\[[^\\]]*\\]\\(([^)\\s]+)(?:\\s+\"[^\"]*\")?\\)|<a\\s+[^>]*href=[\"']([^\"']+)[\"'])/gi\nconst ROUTE_EXTENSIONS = new Set(['.md', '.mdx'])\nconst IGNORED_SCHEMES = /^[a-z][a-z0-9+.-]*:/i\n\nfunction addDiagnostic(result: CheckResult, diagnostic: CheckDiagnostic): void {\n  if (diagnostic.level === 'error') result.errors.push(diagnostic)\n  else result.warnings.push(diagnostic)\n}\n\nfunction normalizeRoutePath(path: string): string {\n  const [withoutHash] = path.split('#')\n  const clean = withoutHash.replace(/\\/index$/, '') || '/'\n  return clean.startsWith('/') ? clean : `/${clean}`\n}\n\nfunction routePathCandidates(href: string, route: ContentRoute): string[] {\n  const [withoutHashOrQuery] = href.split(/[?#]/)\n  if (!withoutHashOrQuery || withoutHashOrQuery.startsWith('#')) return []\n  if (withoutHashOrQuery.startsWith('/')) return [normalizeRoutePath(withoutHashOrQuery)]\n\n  const routeDir = dirname(route.path)\n  const joined = normalize(join(routeDir, withoutHashOrQuery)).replaceAll('\\\\', '/')\n  const extension = extname(joined)\n  const base = ROUTE_EXTENSIONS.has(extension) ? joined.slice(0, -extension.length) : joined\n  return [normalizeRoutePath(base)]\n}\n\nasync function pathExists(filePath: string): Promise<boolean> {\n  try {\n    await stat(filePath)\n    return true\n  } catch {\n    return false\n  }\n}\n\nfunction isLocalHref(href: string): boolean {\n  return Boolean(href) && !href.startsWith('#') && !href.startsWith('//') && !IGNORED_SCHEMES.test(href)\n}\n\nasync function resolveLocalFileLink(href: string, route: ContentRoute, contentRoot: string): Promise<boolean> {\n  const [withoutHashOrQuery] = href.split(/[?#]/)\n  if (!withoutHashOrQuery || withoutHashOrQuery.startsWith('/')) return false\n\n  const target = resolve(dirname(route.filePath), withoutHashOrQuery)\n  const relativeTarget = relative(contentRoot, target)\n  if (relativeTarget.startsWith('..') || isAbsolute(relativeTarget)) return false\n  if (await pathExists(target)) return true\n\n  if (!extname(target)) {\n    return pathExists(`${target}.md`) || pathExists(`${target}.mdx`) || pathExists(join(target, 'index.md')) || pathExists(join(target, 'index.mdx'))\n  }\n  return false\n}\n\nasync function checkContentDirectory(contentRoot: string, result: CheckResult): Promise<void> {\n  try {\n    const stats = await lstat(contentRoot)\n    if (!stats.isDirectory()) {\n      addDiagnostic(result, {\n        level: 'error',\n        code: 'content-not-directory',\n        message: `Content path is not a directory: ${contentRoot}`,\n        filePath: contentRoot,\n      })\n    }\n  } catch {\n    addDiagnostic(result, {\n      level: 'error',\n      code: 'content-missing',\n      message: `Content directory does not exist: ${contentRoot}`,\n      filePath: contentRoot,\n    })\n  }\n}\n\nfunction checkDuplicateRoutes(routes: ContentRoute[], result: CheckResult): void {\n  const byPath = new Map<string, ContentRoute[]>()\n  for (const route of routes) {\n    const key = `${route.locale ?? ''}:${route.path}`\n    byPath.set(key, [...(byPath.get(key) ?? []), route])\n  }\n\n  for (const duplicated of byPath.values()) {\n    if (duplicated.length < 2) continue\n    for (const route of duplicated) {\n      addDiagnostic(result, {\n        level: 'error',\n        code: 'duplicate-route',\n        message: `Route \"${route.path}\" is defined by multiple files: ${duplicated.map(route => relative(process.cwd(), route.filePath)).join(', ')}`,\n        filePath: route.filePath,\n        routePath: route.path,\n      })\n    }\n  }\n}\n\nfunction checkFallbackRoutes(routes: ContentRoute[], result: CheckResult): void {\n  for (const route of routes) {\n    if (!route.isFallback) continue\n    addDiagnostic(result, {\n      level: 'warning',\n      code: 'i18n-fallback-route',\n      message: `Route \"${route.path}\" falls back to ${route.locale ?? 'default'} content from ${relative(process.cwd(), route.filePath)}`,\n      filePath: route.filePath,\n      routePath: route.path,\n    })\n  }\n}\n\nasync function checkLocalLinks(routes: ContentRoute[], contentRoot: string, result: CheckResult): Promise<void> {\n  const routePaths = new Set(routes.map(route => route.path))\n\n  for (const route of routes) {\n    if (route.kind !== 'mdx' || !route.content) continue\n    for (const match of route.content.matchAll(LOCAL_LINK_PATTERN)) {\n      const href = match[1] ?? match[2]\n      if (!href || !isLocalHref(href)) continue\n      const candidates = routePathCandidates(href, route)\n      if (candidates.some(candidate => routePaths.has(candidate))) continue\n      if (await resolveLocalFileLink(href, route, contentRoot)) continue\n\n      addDiagnostic(result, {\n        level: 'error',\n        code: 'broken-link',\n        message: `Broken local link \"${href}\" in route \"${route.path}\"`,\n        filePath: route.filePath,\n        routePath: route.path,\n      })\n    }\n  }\n}\n\nfunction printTextResult(result: CheckResult, strict: boolean): void {\n  const diagnostics = [...result.errors, ...result.warnings]\n  if (diagnostics.length === 0) {\n    console.log('✓ Clarify check passed')\n    return\n  }\n\n  for (const diagnostic of diagnostics) {\n    const location = diagnostic.filePath ? ` ${relative(process.cwd(), diagnostic.filePath)}` : ''\n    const route = diagnostic.routePath ? ` (${diagnostic.routePath})` : ''\n    console.log(`${diagnostic.level.toUpperCase()} ${diagnostic.code}${location}${route}`)\n    console.log(`  ${diagnostic.message}`)\n  }\n\n  const warningExit = strict && result.warnings.length > 0\n  console.log(`\\n${result.errors.length} error(s), ${result.warnings.length} warning(s)${warningExit ? ' (--strict treats warnings as failures)' : ''}`)\n}\n\nexport async function runCheck(options: CheckCommandOptions = {}): Promise<void> {\n  const root = resolve(options.root ?? process.cwd())\n  const userConfig = existsSync(root) ? await loadClarifyConfig(root, { command: 'build', mode: 'production' }) : {}\n  const site = await resolveClarifySite({\n    ...userConfig,\n    projectRoot: root,\n    rootDirectory: options.content,\n    outputDirectory: options.output,\n  }, { includeHtmlShellPlugin: false })\n\n  const result: CheckResult = { errors: [], warnings: [] }\n  await checkContentDirectory(site.contentRoot, result)\n  checkDuplicateRoutes(site.routes, result)\n  checkFallbackRoutes(site.routes, result)\n  await checkLocalLinks(site.routes, site.contentRoot, result)\n\n  if (options.format === 'json') {\n    console.log(JSON.stringify(result, null, 2))\n  } else {\n    printTextResult(result, Boolean(options.strict))\n  }\n\n  if (result.errors.length > 0 || (options.strict && result.warnings.length > 0)) {\n    process.exitCode = 1\n  }\n}\n","import { createServer } from 'vite'\n\nimport { createViteConfig } from '../../core/vite-config.js'\nimport type { ResolvedCliOptions } from '../options.js'\n\nexport async function runDev(options: ResolvedCliOptions): Promise<void> {\n  const server = await createServer(await createViteConfig(options, { command: 'serve', mode: 'development' }))\n  await server.listen()\n  server.printUrls()\n  server.bindCLIShortcuts({ print: true })\n}\n","{\n  \"name\": \"@clarify-labs/cli\",\n  \"version\": \"0.6.6\",\n  \"license\": \"AGPL-3.0-only\",\n  \"type\": \"module\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/taicode-labs/clarify\",\n    \"directory\": \"packages/cli\"\n  },\n  \"main\": \"output/index.cjs\",\n  \"module\": \"output/index.js\",\n  \"types\": \"output/index.d.ts\",\n  \"bin\": {\n    \"clarify\": \"bin/clarify.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./output/index.d.ts\",\n      \"import\": \"./output/index.js\",\n      \"require\": \"./output/index.cjs\",\n      \"default\": \"./output/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"LICENSE\",\n    \"bin\",\n    \"output\"\n  ],\n  \"scripts\": {\n    \"dev\": \"vite build --watch\",\n    \"build\": \"vite build\",\n    \"lint\": \"eslint source/\",\n    \"lint:fix\": \"eslint source/ --fix\",\n    \"typecheck\": \"tsc -p tsconfig.json --noEmit\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\"\n  },\n  \"dependencies\": {\n    \"@apidevtools/swagger-parser\": \"^12.1.0\",\n    \"@clarify-labs/renderer\": \"workspace:*\",\n    \"@clarify-labs/templates\": \"workspace:*\",\n    \"@mdx-js/rollup\": \"^3.1.1\",\n    \"@tailwindcss/vite\": \"^4.1.11\",\n    \"@vitejs/plugin-react\": \"^6.0.2\",\n    \"cac\": \"^7.0.0\",\n    \"github-slugger\": \"^2.0.0\",\n    \"gray-matter\": \"^4.0.3\",\n    \"mdast-util-to-string\": \"^4.0.0\",\n    \"openapi-types\": \"^12.1.3\",\n    \"react\": \"^19.1.0\",\n    \"react-dom\": \"^19.1.0\",\n    \"react-router\": \"^7.0.0\",\n    \"react-router-dom\": \"^7.0.0\",\n    \"remark\": \"^15.0.1\",\n    \"remark-gfm\": \"^4.0.1\",\n    \"shiki\": \"0.14.7\",\n    \"unist-util-visit\": \"^5.1.0\",\n    \"vite\": \"^8.0.15\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"devDependencies\": {\n    \"@mdx-js/mdx\": \"^3.1.1\",\n    \"typescript\": \"^5.8.3\",\n    \"vite-plugin-dts\": \"^4.5.4\",\n    \"vitest\": \"^4.1.9\"\n  }\n}\n","import packageJson from '../../package.json' with { type: 'json' }\n\nexport const cliPackageJson = packageJson as { version?: string }\nexport const cliPackageVersion = cliPackageJson.version ?? '0.0.0'\nexport const cliPackageVersionWithCaret = `^${cliPackageVersion}`\n\nexport function readPackageVersion(): string {\n  return cliPackageVersion\n}\n","import { spawnSync as nodeSpawnSync, SpawnSyncOptions } from 'node:child_process'\n\ntype SpawnOptions = { cwd?: string; stdio?: 'inherit' | 'ignore' | Array<string> }\n\nexport function spawnSync(command: string, args: string[], options: SpawnOptions) {\n  return nodeSpawnSync(command, args, options as SpawnSyncOptions)\n}\n","import { existsSync, readFileSync, writeFileSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { copyTemplateDirectory, getTemplateDirectory, resolveTemplate } from '@clarify-labs/templates'\n\nimport type { ResolvedCliOptions } from '../options.js'\nimport { cliPackageVersionWithCaret } from '../package.js'\nimport { spawnSync } from '../spawn.js'\n\nconst require = createRequire(import.meta.url)\n\nfunction findTemplatesPackagePath(): string {\n  try {\n    return require.resolve('@clarify-labs/templates/package.json')\n  } catch {\n    const currentDirectory = dirname(fileURLToPath(import.meta.url))\n    const workspacePackagePath = resolve(currentDirectory, '../../../../templates/package.json')\n    if (existsSync(workspacePackagePath)) return workspacePackagePath\n    throw new Error('[clarify] Templates package not found.')\n  }\n}\n\nconst templatesPackagePath = findTemplatesPackagePath()\nconst templatesDirectory = dirname(templatesPackagePath)\n\nfunction commandExists(program: string): boolean {\n  const result = spawnSync(program, ['--version'], { stdio: 'ignore' })\n  return result.status === 0 && result.error === undefined\n}\n\ntype InstallCommand = { command: string; args: string[] }\n\nfunction getInstallCommand(): InstallCommand {\n  if (commandExists('pnpm')) return { command: 'pnpm', args: ['install'] }\n  if (commandExists('npm')) return { command: 'npm', args: ['install'] }\n  if (commandExists('yarn')) return { command: 'yarn', args: ['install'] }\n  return { command: 'npm', args: ['install'] }\n}\n\nfunction installDependencies(root: string): void {\n  const { command, args } = getInstallCommand()\n  console.log(`[clarify] Installing dependencies with ${command}...`)\n  const result = spawnSync(command, args, { cwd: root, stdio: 'inherit' })\n  if (result.status !== 0) {\n    throw new Error(`[clarify] Dependency install failed with ${command}`)\n  }\n}\n\nfunction getSuggestedInstallCommand(): string {\n  if (commandExists('pnpm')) return 'pnpm install'\n  if (commandExists('npm')) return 'npm install'\n  if (commandExists('yarn')) return 'yarn install'\n  return 'npm install'\n}\n\nfunction updatePackageJson(root: string, force: boolean): boolean {\n  const packageJsonPath = resolve(root, 'package.json')\n  const packageJson = existsSync(packageJsonPath)\n    ? JSON.parse(readFileSync(packageJsonPath, 'utf-8')) as Record<string, unknown>\n    : { type: 'module' }\n\n  const scripts = typeof packageJson.scripts === 'object' && packageJson.scripts !== null\n    ? packageJson.scripts as Record<string, string>\n    : {}\n\n  if (force || !scripts.dev) scripts.dev = 'clarify dev'\n  if (force || !scripts.build) scripts.build = 'clarify build'\n  packageJson.scripts = scripts\n\n  const devDependencies = typeof packageJson.devDependencies === 'object' && packageJson.devDependencies !== null\n    ? packageJson.devDependencies as Record<string, string>\n    : {}\n  if (!devDependencies['@clarify-labs/cli']) devDependencies['@clarify-labs/cli'] = cliPackageVersionWithCaret\n  packageJson.devDependencies = devDependencies\n\n  writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\\n`, 'utf-8')\n  return true\n}\n\nexport function runInit(options: ResolvedCliOptions, force: boolean, template?: string, install = false): void {\n  const selectedTemplate = resolveTemplate(template)\n  const templateDirectory = getTemplateDirectory(templatesDirectory, selectedTemplate)\n  const { created } = copyTemplateDirectory(templateDirectory, options.root, {\n    contentDir: options.content,\n    force,\n  })\n\n  const packageJsonUpdated = updatePackageJson(options.root, force)\n  if (packageJsonUpdated) created.push('package.json')\n\n  console.log(`[clarify] Project scaffold created using the ${selectedTemplate} template.`)\n  if (created.length > 0) {\n    console.log(`[clarify] Created or updated ${created.length} ${created.length === 1 ? 'file' : 'files'}: ${created.join(', ')}`)\n  }\n\n  if (install) {\n    installDependencies(options.root)\n    console.log('[clarify] Dependencies installed successfully.')\n    console.log('[clarify] You can now run `clarify dev` to start the local documentation server.')\n    return\n  }\n\n  const suggestedInstall = getSuggestedInstallCommand()\n  console.log('[clarify] Next steps:')\n  console.log('  1. Change into your new project directory:')\n  console.log(`       cd ${options.root}`)\n  console.log('  2. Install dependencies:')\n  console.log(`       ${suggestedInstall}`)\n  console.log('  3. Start the local documentation server:')\n  console.log('       clarify dev')\n}\n","import { resolve } from 'node:path'\n\nexport type CliOptions = {\n  root?: string\n  content?: string\n  output?: string\n  host?: string | boolean\n  port?: string | number\n  open?: boolean | string\n}\n\nexport type ResolvedCliOptions = {\n  root: string\n  content: string\n  output: string\n  host?: string | boolean\n  port?: number\n  open?: boolean | string\n}\n\nfunction resolvePort(port: CliOptions['port']): number | undefined {\n  if (port === undefined) return undefined\n\n  const parsedPort = typeof port === 'string' ? Number(port) : port\n  if (!Number.isInteger(parsedPort) || parsedPort < 1 || parsedPort > 65535) {\n    throw new Error('[clarify] --port must be an integer between 1 and 65535')\n  }\n\n  return parsedPort\n}\n\nexport function resolveCliOptions(options: CliOptions): ResolvedCliOptions {\n  return {\n    root: resolve(options.root ?? process.cwd()),\n    content: options.content ?? 'source',\n    output: options.output ?? 'output',\n    host: options.host,\n    port: resolvePort(options.port),\n    open: options.open,\n  }\n}\n","#!/usr/bin/env node\nimport { cac } from 'cac'\n\nimport { runBuild } from './commands/build.js'\nimport { runCheck, type CheckCommandOptions } from './commands/check.js'\nimport { runDev } from './commands/dev.js'\nimport { runInit } from './commands/init.js'\nimport { resolveCliOptions, type CliOptions, type ResolvedCliOptions } from './options.js'\nimport { cliPackageVersion } from './package.js'\n\ntype InitCommandOptions = CliOptions & {\n  force?: boolean\n  template?: string\n  install?: boolean\n}\n\nfunction withSharedOptions(command: ReturnType<ReturnType<typeof cac>['command']>) {\n  return command\n    .option('--root <dir>', 'Project root directory')\n    .option('--content <dir>', 'Content directory relative to root')\n    .option('--output <dir>', 'Build output directory relative to root')\n}\n\nfunction resolveOptions(options: CliOptions): ResolvedCliOptions {\n  return resolveCliOptions(options)\n}\n\nasync function main(): Promise<void> {\n  const cli = cac('clarify')\n\n  cli\n    .version(cliPackageVersion)\n    .help()\n\n  withSharedOptions(cli.command('dev', 'Start the local documentation server'))\n    .option('--host [host]', 'Dev server host')\n    .option('--port <port>', 'Dev server port')\n    .option('--open [path]', 'Open the dev server in a browser')\n    .action(async (options: CliOptions) => {\n      await runDev(resolveOptions(options))\n    })\n\n  withSharedOptions(cli.command('build', 'Build the static documentation site'))\n    .action(async (options: CliOptions) => {\n      await runBuild(resolveOptions(options))\n    })\n\n  withSharedOptions(cli.command('check', 'Validate the documentation project'))\n    .option('--strict', 'Treat warnings as failures')\n    .option('--format <format>', 'Output format: text or json')\n    .action(async (options: CheckCommandOptions) => {\n      await runCheck(options)\n    })\n\n  withSharedOptions(cli.command('init', 'Create a Clarify project scaffold'))\n    .option('--force', 'Overwrite files created by init')\n    .option('--template <name>', 'Template to use: minimal, standard, or complete')\n    .option('--install', 'Install dependencies after init')\n    .action((options: InitCommandOptions) => {\n      runInit(resolveOptions(options), options.force === true, options.template, options.install === true)\n    })\n\n  const args = process.argv.slice(2)\n  cli.parse(process.argv, { run: false })\n\n  if (args.length === 0) {\n    cli.outputHelp()\n    return\n  }\n\n  await cli.runMatchedCommand()\n}\n\nmain().catch(error => {\n  console.error(error instanceof Error ? error.stack ?? error.message : String(error))\n  process.exitCode = 1\n})\n"],"mappings":"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"}

package/output/cli.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { i as createClarifyRuntimeAliases, r as loadClarifyConfig, t as clarifyPlugin } from "./plugin-DChFdTyI.js";
+import { a as resolveClarifySite, i as createClarifyRuntimeAliases, r as loadClarifyConfig, t as clarifyPlugin } from "./plugin-DC2f5YAH.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { dirname, extname, isAbsolute, join, normalize, relative, resolve } from "node:path";
+import { lstat, readFile, stat, writeFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { build, createLogger, createServer } from "vite";
 import { createRequire } from "node:module";
 import { cac } from "cac";
-import { readFile, writeFile } from "node:fs/promises";
 import { copyTemplateDirectory, getTemplateDirectory, resolveTemplate } from "@clarify-labs/templates";
 import { spawnSync } from "node:child_process";
 //#region source/core/log.ts
@@ -207,6 +207,152 @@ async function runBuild(options) {
 	}
 }
 //#endregion
+//#region source/cli/commands/check.ts
+var LOCAL_LINK_PATTERN = /(?<!!)(?:\[[^\]]*\]\(([^)\s]+)(?:\s+"[^"]*")?\)|<a\s+[^>]*href=["']([^"']+)["'])/gi;
+var ROUTE_EXTENSIONS = new Set([".md", ".mdx"]);
+var IGNORED_SCHEMES = /^[a-z][a-z0-9+.-]*:/i;
+function addDiagnostic(result, diagnostic) {
+	if (diagnostic.level === "error") result.errors.push(diagnostic);
+	else result.warnings.push(diagnostic);
+}
+function normalizeRoutePath(path) {
+	const [withoutHash] = path.split("#");
+	const clean = withoutHash.replace(/\/index$/, "") || "/";
+	return clean.startsWith("/") ? clean : `/${clean}`;
+}
+function routePathCandidates(href, route) {
+	const [withoutHashOrQuery] = href.split(/[?#]/);
+	if (!withoutHashOrQuery || withoutHashOrQuery.startsWith("#")) return [];
+	if (withoutHashOrQuery.startsWith("/")) return [normalizeRoutePath(withoutHashOrQuery)];
+	const joined = normalize(join(dirname(route.path), withoutHashOrQuery)).replaceAll("\\", "/");
+	const extension = extname(joined);
+	return [normalizeRoutePath(ROUTE_EXTENSIONS.has(extension) ? joined.slice(0, -extension.length) : joined)];
+}
+async function pathExists(filePath) {
+	try {
+		await stat(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+}
+function isLocalHref(href) {
+	return Boolean(href) && !href.startsWith("#") && !href.startsWith("//") && !IGNORED_SCHEMES.test(href);
+}
+async function resolveLocalFileLink(href, route, contentRoot) {
+	const [withoutHashOrQuery] = href.split(/[?#]/);
+	if (!withoutHashOrQuery || withoutHashOrQuery.startsWith("/")) return false;
+	const target = resolve(dirname(route.filePath), withoutHashOrQuery);
+	const relativeTarget = relative(contentRoot, target);
+	if (relativeTarget.startsWith("..") || isAbsolute(relativeTarget)) return false;
+	if (await pathExists(target)) return true;
+	if (!extname(target)) return pathExists(`${target}.md`) || pathExists(`${target}.mdx`) || pathExists(join(target, "index.md")) || pathExists(join(target, "index.mdx"));
+	return false;
+}
+async function checkContentDirectory(contentRoot, result) {
+	try {
+		if (!(await lstat(contentRoot)).isDirectory()) addDiagnostic(result, {
+			level: "error",
+			code: "content-not-directory",
+			message: `Content path is not a directory: ${contentRoot}`,
+			filePath: contentRoot
+		});
+	} catch {
+		addDiagnostic(result, {
+			level: "error",
+			code: "content-missing",
+			message: `Content directory does not exist: ${contentRoot}`,
+			filePath: contentRoot
+		});
+	}
+}
+function checkDuplicateRoutes(routes, result) {
+	const byPath = /* @__PURE__ */ new Map();
+	for (const route of routes) {
+		const key = `${route.locale ?? ""}:${route.path}`;
+		byPath.set(key, [...byPath.get(key) ?? [], route]);
+	}
+	for (const duplicated of byPath.values()) {
+		if (duplicated.length < 2) continue;
+		for (const route of duplicated) addDiagnostic(result, {
+			level: "error",
+			code: "duplicate-route",
+			message: `Route "${route.path}" is defined by multiple files: ${duplicated.map((route) => relative(process.cwd(), route.filePath)).join(", ")}`,
+			filePath: route.filePath,
+			routePath: route.path
+		});
+	}
+}
+function checkFallbackRoutes(routes, result) {
+	for (const route of routes) {
+		if (!route.isFallback) continue;
+		addDiagnostic(result, {
+			level: "warning",
+			code: "i18n-fallback-route",
+			message: `Route "${route.path}" falls back to ${route.locale ?? "default"} content from ${relative(process.cwd(), route.filePath)}`,
+			filePath: route.filePath,
+			routePath: route.path
+		});
+	}
+}
+async function checkLocalLinks(routes, contentRoot, result) {
+	const routePaths = new Set(routes.map((route) => route.path));
+	for (const route of routes) {
+		if (route.kind !== "mdx" || !route.content) continue;
+		for (const match of route.content.matchAll(LOCAL_LINK_PATTERN)) {
+			const href = match[1] ?? match[2];
+			if (!href || !isLocalHref(href)) continue;
+			if (routePathCandidates(href, route).some((candidate) => routePaths.has(candidate))) continue;
+			if (await resolveLocalFileLink(href, route, contentRoot)) continue;
+			addDiagnostic(result, {
+				level: "error",
+				code: "broken-link",
+				message: `Broken local link "${href}" in route "${route.path}"`,
+				filePath: route.filePath,
+				routePath: route.path
+			});
+		}
+	}
+}
+function printTextResult(result, strict) {
+	const diagnostics = [...result.errors, ...result.warnings];
+	if (diagnostics.length === 0) {
+		console.log("✓ Clarify check passed");
+		return;
+	}
+	for (const diagnostic of diagnostics) {
+		const location = diagnostic.filePath ? ` ${relative(process.cwd(), diagnostic.filePath)}` : "";
+		const route = diagnostic.routePath ? ` (${diagnostic.routePath})` : "";
+		console.log(`${diagnostic.level.toUpperCase()} ${diagnostic.code}${location}${route}`);
+		console.log(`  ${diagnostic.message}`);
+	}
+	const warningExit = strict && result.warnings.length > 0;
+	console.log(`\n${result.errors.length} error(s), ${result.warnings.length} warning(s)${warningExit ? " (--strict treats warnings as failures)" : ""}`);
+}
+async function runCheck(options = {}) {
+	const root = resolve(options.root ?? process.cwd());
+	const site = await resolveClarifySite({
+		...existsSync(root) ? await loadClarifyConfig(root, {
+			command: "build",
+			mode: "production"
+		}) : {},
+		projectRoot: root,
+		rootDirectory: options.content,
+		outputDirectory: options.output
+	}, { includeHtmlShellPlugin: false });
+	const result = {
+		errors: [],
+		warnings: []
+	};
+	await checkContentDirectory(site.contentRoot, result);
+	checkDuplicateRoutes(site.routes, result);
+	checkFallbackRoutes(site.routes, result);
+	await checkLocalLinks(site.routes, site.contentRoot, result);
+	if (options.format === "json") console.log(JSON.stringify(result, null, 2));
+	else printTextResult(result, Boolean(options.strict));
+	if (result.errors.length > 0 || options.strict && result.warnings.length > 0) process.exitCode = 1;
+}
+//#endregion
 //#region source/cli/commands/dev.ts
 async function runDev(options) {
 	const server = await createServer(await createViteConfig(options, {
@@ -219,7 +365,7 @@ async function runDev(options) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.6.4",
+	version: "0.6.6",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -411,6 +557,9 @@ async function main() {
 	withSharedOptions(cli.command("build", "Build the static documentation site")).action(async (options) => {
 		await runBuild(resolveOptions(options));
 	});
+	withSharedOptions(cli.command("check", "Validate the documentation project")).option("--strict", "Treat warnings as failures").option("--format <format>", "Output format: text or json").action(async (options) => {
+		await runCheck(options);
+	});
 	withSharedOptions(cli.command("init", "Create a Clarify project scaffold")).option("--force", "Overwrite files created by init").option("--template <name>", "Template to use: minimal, standard, or complete").option("--install", "Install dependencies after init").action((options) => {
 		runInit(resolveOptions(options), options.force === true, options.template, options.install === true);
 	});