@clarify-labs/cli 0.7.2 → 0.8.2

package/README.md

@@ -2,6 +2,13 @@
 
 Official Clarify CLI package.
 
+Start a new project with:
+
+```bash
+npx @clarify-labs/cli init my-docs
+cd my-docs
+```
+
 This package provides the public `clarify` command used for:
 
 - `clarify init`

package/output/cli/program.d.ts

@@ -0,0 +1,2 @@
+export declare function createCli(): import('cac').CAC;
+export declare function main(argv?: string[]): Promise<void>;

package/output/cli.cjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-const require_plugin = require("./plugin-DFpkIm9j.cjs");
+const require_plugin = require("./plugin-DyceHdXd.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
@@ -182,6 +182,11 @@ async function createViteConfig(options, env) {
 						test: /node_modules[\\/](@headlessui|framer-motion)[\\/]/,
 						priority: 30
 					},
+					{
+						name: "mermaid-vendor",
+						test: /node_modules[\\/](mermaid|@mermaid-js|cytoscape|cytoscape-[^\\/]+|dagre-d3-es|@dagrejs|dagre|graphlib|elkjs|katex|d3|d3-[^\\/]+|internmap|delaunator|robust-predicates|roughjs|points-on-curve|points-on-path|path-data-parser|@braintree[\\/]sanitize-url|dompurify|khroma|ts-dedent|stylis|cose-base|layout-base)[\\/]/,
+						priority: 20
+					},
 					{
 						name: "vendor",
 						test: /node_modules[\\/]/,
@@ -364,7 +369,7 @@ async function runDev(options) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.7.2",
+	version: "0.8.2",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -410,17 +415,20 @@ var cliPackageVersion = {
 		"github-slugger": "^2.0.0",
 		"gray-matter": "^4.0.3",
 		"mdast-util-to-string": "^4.0.0",
+		"mermaid": "^11.4.0",
 		"openapi-types": "^12.1.3",
 		"pagefind": "^1.5.2",
 		"react": "^19.1.0",
 		"react-dom": "^19.1.0",
 		"react-router": "^7.0.0",
 		"react-router-dom": "^7.0.0",
+		"react-zoom-pan-pinch": "^4.0.3",
 		"remark": "^15.0.1",
 		"remark-gfm": "^4.0.1",
 		"shiki": "0.14.7",
 		"unist-util-visit": "^5.1.0",
 		"vite": "^8.0.15",
+		"yaml": "^2.9.0",
 		"zod": "^4.4.3"
 	},
 	devDependencies: {
@@ -486,6 +494,11 @@ function getSuggestedInstallCommand() {
 	if (commandExists("yarn")) return "yarn install";
 	return "npm install";
 }
+function getSuggestedRunCommand() {
+	if (commandExists("pnpm")) return "pnpm dev";
+	if (commandExists("yarn")) return "yarn dev";
+	return "npm run dev";
+}
 function updatePackageJson(root, force) {
 	const packageJsonPath = (0, node_path.resolve)(root, "package.json");
 	const packageJson = (0, node_fs.existsSync)(packageJsonPath) ? JSON.parse((0, node_fs.readFileSync)(packageJsonPath, "utf-8")) : { type: "module" };
@@ -510,18 +523,20 @@ function runInit(options, force, template, install = false) {
 	if (created.length > 0) console.log(`[clarify] Created or updated ${created.length} ${created.length === 1 ? "file" : "files"}: ${created.join(", ")}`);
 	if (install) {
 		installDependencies(options.root);
+		const suggestedRun = getSuggestedRunCommand();
 		console.log("[clarify] Dependencies installed successfully.");
-		console.log("[clarify] You can now run `clarify dev` to start the local documentation server.");
+		console.log(`[clarify] You can now run \`${suggestedRun}\` to start the local documentation server.`);
 		return;
 	}
 	const suggestedInstall = getSuggestedInstallCommand();
+	const suggestedRun = getSuggestedRunCommand();
 	console.log("[clarify] Next steps:");
 	console.log("  1. Change into your new project directory:");
 	console.log(`       cd ${options.root}`);
 	console.log("  2. Install dependencies:");
 	console.log(`       ${suggestedInstall}`);
 	console.log("  3. Start the local documentation server:");
-	console.log("       clarify dev");
+	console.log(`       ${suggestedRun}`);
 }
 //#endregion
 //#region source/cli/options.ts
@@ -542,14 +557,23 @@ function resolveCliOptions(options) {
 	};
 }
 //#endregion
-//#region source/cli/index.ts
+//#region source/cli/program.ts
+function withBuildOptions(command) {
+	return command.option("--content <dir>", "Content directory relative to root");
+}
+function resolveInitOptions(directory, options) {
+	return resolveOptions({
+		...options,
+		root: directory
+	});
+}
 function withSharedOptions(command) {
 	return command.option("--root <dir>", "Project root directory").option("--content <dir>", "Content directory relative to root").option("--output <dir>", "Build output directory relative to root");
 }
 function resolveOptions(options) {
 	return resolveCliOptions(options);
 }
-async function main() {
+function createCli() {
 	const cli = (0, cac.cac)("clarify");
 	cli.version(cliPackageVersion).help();
 	withSharedOptions(cli.command("dev", "Start the local documentation server")).option("--host [host]", "Dev server host").option("--port <port>", "Dev server port").option("--open [path]", "Open the dev server in a browser").action(async (options) => {
@@ -561,17 +585,23 @@ async function main() {
 	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);
+	withBuildOptions(cli.command("init [directory]", "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((directory, options) => {
+		runInit(resolveInitOptions(directory, options), options.force === true, options.template, options.install === true);
 	});
-	const args = process.argv.slice(2);
-	cli.parse(process.argv, { run: false });
+	return cli;
+}
+async function main(argv = process.argv) {
+	const cli = createCli();
+	const args = argv.slice(2);
+	cli.parse(argv, { run: false });
 	if (args.length === 0) {
 		cli.outputHelp();
 		return;
 	}
 	await cli.runMatchedCommand();
 }
+//#endregion
+//#region source/cli/index.ts
 main().catch((error) => {
 	console.error(error instanceof Error ? error.stack ?? error.message : String(error));
 	process.exitCode = 1;

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/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, writeFileSync } from 'node:fs'\nimport { 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 { createClarifyTempDir } from './temp-dir.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(createClarifyTempDir('html'), 'index.html')\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 { resolveClarifySite } from '../../core/site.js'\nimport { loadClarifyConfig } from '../../core/user-config.js'\nimport type { ContentRoute } from '../../types.js'\nimport type { CliOptions } from '../options.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.7.2\",\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    \"pagefind\": \"^1.5.2\",\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    \"@types/react\": \"^19.1.8\",\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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"}
+{"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/program.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, writeFileSync } from 'node:fs'\nimport { 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 { createClarifyTempDir } from './temp-dir.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(createClarifyTempDir('html'), 'index.html')\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                // Keep mermaid and its heavy diagram/render dependencies out of\n                // the eager `vendor` chunk so they stay lazily loaded only on\n                // pages that actually render a diagram.\n                name: 'mermaid-vendor',\n                test: /node_modules[\\\\/](mermaid|@mermaid-js|cytoscape|cytoscape-[^\\\\/]+|dagre-d3-es|@dagrejs|dagre|graphlib|elkjs|katex|d3|d3-[^\\\\/]+|internmap|delaunator|robust-predicates|roughjs|points-on-curve|points-on-path|path-data-parser|@braintree[\\\\/]sanitize-url|dompurify|khroma|ts-dedent|stylis|cose-base|layout-base)[\\\\/]/,\n                priority: 20,\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 { resolveClarifySite } from '../../core/site.js'\nimport { loadClarifyConfig } from '../../core/user-config.js'\nimport type { ContentRoute } from '../../types.js'\nimport type { CliOptions } from '../options.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.8.2\",\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    \"mermaid\": \"^11.4.0\",\n    \"openapi-types\": \"^12.1.3\",\n    \"pagefind\": \"^1.5.2\",\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    \"react-zoom-pan-pinch\": \"^4.0.3\",\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    \"yaml\": \"^2.9.0\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"devDependencies\": {\n    \"@mdx-js/mdx\": \"^3.1.1\",\n    \"@types/react\": \"^19.1.8\",\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 getSuggestedRunCommand(): string {\n  if (commandExists('pnpm')) return 'pnpm dev'\n  if (commandExists('yarn')) return 'yarn dev'\n  return 'npm run dev'\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    const suggestedRun = getSuggestedRunCommand()\n    console.log('[clarify] Dependencies installed successfully.')\n    console.log(`[clarify] You can now run \\`${suggestedRun}\\` to start the local documentation server.`)\n    return\n  }\n\n  const suggestedInstall = getSuggestedInstallCommand()\n  const suggestedRun = getSuggestedRunCommand()\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(`       ${suggestedRun}`)\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","import { 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 withBuildOptions(command: ReturnType<ReturnType<typeof cac>['command']>) {\n  return command\n    .option('--content <dir>', 'Content directory relative to root')\n}\n\nfunction resolveInitOptions(directory: string | undefined, options: InitCommandOptions): ResolvedCliOptions {\n  return resolveOptions({\n    ...options,\n    root: directory,\n  })\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\nexport function createCli() {\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  withBuildOptions(cli.command('init [directory]', '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((directory: string | undefined, options: InitCommandOptions) => {\n      runInit(resolveInitOptions(directory, options), options.force === true, options.template, options.install === true)\n    })\n\n  return cli\n}\n\nexport async function main(argv = process.argv): Promise<void> {\n  const cli = createCli()\n  const args = argv.slice(2)\n  cli.parse(argv, { run: false })\n\n  if (args.length === 0) {\n    cli.outputHelp()\n    return\n  }\n\n  await cli.runMatchedCommand()\n}\n","#!/usr/bin/env node\nimport { main } from './program.js'\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 { a as resolveClarifySite, i as createClarifyRuntimeAliases, o as createClarifyTempDir, r as loadClarifyConfig, t as clarifyPlugin } from "./plugin-o1rP_gts.js";
+import { a as resolveClarifySite, i as createClarifyRuntimeAliases, o as createClarifyTempDir, r as loadClarifyConfig, t as clarifyPlugin } from "./plugin-D5EF3pYl.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 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 { lstat, readFile, stat, writeFile } from "node:fs/promises";
 import { copyTemplateDirectory, getTemplateDirectory, resolveTemplate } from "@clarify-labs/templates";
 import { spawnSync } from "node:child_process";
 //#region source/core/log.ts
@@ -182,6 +182,11 @@ async function createViteConfig(options, env) {
 						test: /node_modules[\\/](@headlessui|framer-motion)[\\/]/,
 						priority: 30
 					},
+					{
+						name: "mermaid-vendor",
+						test: /node_modules[\\/](mermaid|@mermaid-js|cytoscape|cytoscape-[^\\/]+|dagre-d3-es|@dagrejs|dagre|graphlib|elkjs|katex|d3|d3-[^\\/]+|internmap|delaunator|robust-predicates|roughjs|points-on-curve|points-on-path|path-data-parser|@braintree[\\/]sanitize-url|dompurify|khroma|ts-dedent|stylis|cose-base|layout-base)[\\/]/,
+						priority: 20
+					},
 					{
 						name: "vendor",
 						test: /node_modules[\\/]/,
@@ -364,7 +369,7 @@ async function runDev(options) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.7.2",
+	version: "0.8.2",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -410,17 +415,20 @@ var cliPackageVersion = {
 		"github-slugger": "^2.0.0",
 		"gray-matter": "^4.0.3",
 		"mdast-util-to-string": "^4.0.0",
+		"mermaid": "^11.4.0",
 		"openapi-types": "^12.1.3",
 		"pagefind": "^1.5.2",
 		"react": "^19.1.0",
 		"react-dom": "^19.1.0",
 		"react-router": "^7.0.0",
 		"react-router-dom": "^7.0.0",
+		"react-zoom-pan-pinch": "^4.0.3",
 		"remark": "^15.0.1",
 		"remark-gfm": "^4.0.1",
 		"shiki": "0.14.7",
 		"unist-util-visit": "^5.1.0",
 		"vite": "^8.0.15",
+		"yaml": "^2.9.0",
 		"zod": "^4.4.3"
 	},
 	devDependencies: {
@@ -486,6 +494,11 @@ function getSuggestedInstallCommand() {
 	if (commandExists("yarn")) return "yarn install";
 	return "npm install";
 }
+function getSuggestedRunCommand() {
+	if (commandExists("pnpm")) return "pnpm dev";
+	if (commandExists("yarn")) return "yarn dev";
+	return "npm run dev";
+}
 function updatePackageJson(root, force) {
 	const packageJsonPath = resolve(root, "package.json");
 	const packageJson = existsSync(packageJsonPath) ? JSON.parse(readFileSync(packageJsonPath, "utf-8")) : { type: "module" };
@@ -510,18 +523,20 @@ function runInit(options, force, template, install = false) {
 	if (created.length > 0) console.log(`[clarify] Created or updated ${created.length} ${created.length === 1 ? "file" : "files"}: ${created.join(", ")}`);
 	if (install) {
 		installDependencies(options.root);
+		const suggestedRun = getSuggestedRunCommand();
 		console.log("[clarify] Dependencies installed successfully.");
-		console.log("[clarify] You can now run `clarify dev` to start the local documentation server.");
+		console.log(`[clarify] You can now run \`${suggestedRun}\` to start the local documentation server.`);
 		return;
 	}
 	const suggestedInstall = getSuggestedInstallCommand();
+	const suggestedRun = getSuggestedRunCommand();
 	console.log("[clarify] Next steps:");
 	console.log("  1. Change into your new project directory:");
 	console.log(`       cd ${options.root}`);
 	console.log("  2. Install dependencies:");
 	console.log(`       ${suggestedInstall}`);
 	console.log("  3. Start the local documentation server:");
-	console.log("       clarify dev");
+	console.log(`       ${suggestedRun}`);
 }
 //#endregion
 //#region source/cli/options.ts
@@ -542,14 +557,23 @@ function resolveCliOptions(options) {
 	};
 }
 //#endregion
-//#region source/cli/index.ts
+//#region source/cli/program.ts
+function withBuildOptions(command) {
+	return command.option("--content <dir>", "Content directory relative to root");
+}
+function resolveInitOptions(directory, options) {
+	return resolveOptions({
+		...options,
+		root: directory
+	});
+}
 function withSharedOptions(command) {
 	return command.option("--root <dir>", "Project root directory").option("--content <dir>", "Content directory relative to root").option("--output <dir>", "Build output directory relative to root");
 }
 function resolveOptions(options) {
 	return resolveCliOptions(options);
 }
-async function main() {
+function createCli() {
 	const cli = cac("clarify");
 	cli.version(cliPackageVersion).help();
 	withSharedOptions(cli.command("dev", "Start the local documentation server")).option("--host [host]", "Dev server host").option("--port <port>", "Dev server port").option("--open [path]", "Open the dev server in a browser").action(async (options) => {
@@ -561,17 +585,23 @@ async function main() {
 	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);
+	withBuildOptions(cli.command("init [directory]", "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((directory, options) => {
+		runInit(resolveInitOptions(directory, options), options.force === true, options.template, options.install === true);
 	});
-	const args = process.argv.slice(2);
-	cli.parse(process.argv, { run: false });
+	return cli;
+}
+async function main(argv = process.argv) {
+	const cli = createCli();
+	const args = argv.slice(2);
+	cli.parse(argv, { run: false });
 	if (args.length === 0) {
 		cli.outputHelp();
 		return;
 	}
 	await cli.runMatchedCommand();
 }
+//#endregion
+//#region source/cli/index.ts
 main().catch((error) => {
 	console.error(error instanceof Error ? error.stack ?? error.message : String(error));
 	process.exitCode = 1;