ccg-workflow 1.7.83 → 1.7.85

package/README.md

@@ -354,4 +354,4 @@ MIT
 
 ---
 
-v1.7.83 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)
+v1.7.85 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.OKd5dIP0.mjs';
+import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.B9Mj76CP.mjs';
 import 'inquirer';
 import 'node:child_process';
 import 'node:util';

package/dist/index.d.mts

@@ -178,9 +178,12 @@ interface UninstallResult {
     errors: string[];
 }
 /**
- * Uninstall workflows by removing their command files
+ * Uninstall workflows by removing their command files.
+ * @param options.preserveBinary — when true, skip binary removal (used during update)
  */
-declare function uninstallWorkflows(installDir: string): Promise<UninstallResult>;
+declare function uninstallWorkflows(installDir: string, options?: {
+    preserveBinary?: boolean;
+}): Promise<UninstallResult>;
 
 /**
  * Migration utilities for v1.4.0

package/dist/index.d.ts

@@ -178,9 +178,12 @@ interface UninstallResult {
     errors: string[];
 }
 /**
- * Uninstall workflows by removing their command files
+ * Uninstall workflows by removing their command files.
+ * @param options.preserveBinary — when true, skip binary removal (used during update)
  */
-declare function uninstallWorkflows(installDir: string): Promise<UninstallResult>;
+declare function uninstallWorkflows(installDir: string, options?: {
+    preserveBinary?: boolean;
+}): Promise<UninstallResult>;
 
 /**
  * Migration utilities for v1.4.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.OKd5dIP0.mjs';
+export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.B9Mj76CP.mjs';
 import 'ansis';
 import 'inquirer';
 import 'node:child_process';

package/dist/shared/{ccg-workflow.OKd5dIP0.mjs → ccg-workflow.B9Mj76CP.mjs}

@@ -10,7 +10,7 @@ import { parse, stringify } from 'smol-toml';
 import i18next from 'i18next';
 import ora from 'ora';
 
-const version = "1.7.83";
+const version = "1.7.85";
 
 function cmd(id, order, category, name, nameEn, description, descriptionEn, cmdOverride) {
   return {
@@ -637,19 +637,19 @@ async function removeFastContextPrompt() {
 
 const GITHUB_REPO = "fengshao1227/ccg-workflow";
 const RELEASE_TAG = "preset";
-const BINARY_DOWNLOAD_URL = `https://github.com/${GITHUB_REPO}/releases/download/${RELEASE_TAG}`;
-async function downloadBinaryFromRelease(binaryName, destPath) {
-  const url = `${BINARY_DOWNLOAD_URL}/${binaryName}`;
-  const MAX_ATTEMPTS = 3;
-  const TIMEOUT_MS = 6e4;
-  for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+const BINARY_SOURCES = [
+  { name: "GitHub Release", url: `https://github.com/${GITHUB_REPO}/releases/download/${RELEASE_TAG}`, timeoutMs: 8e3 },
+  { name: "Cloudflare R2", url: "https://pub-29270440a0854a49bf1589cd3662c067.r2.dev/preset", timeoutMs: 6e4 }
+];
+async function downloadFromUrl(url, destPath, timeoutMs, maxAttempts = 2) {
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
     try {
       const controller = new AbortController();
-      const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+      const timer = setTimeout(() => controller.abort(), timeoutMs);
       const response = await fetch(url, { redirect: "follow", signal: controller.signal });
       if (!response.ok) {
         clearTimeout(timer);
-        if (attempt < MAX_ATTEMPTS) {
+        if (attempt < maxAttempts) {
           await new Promise((resolve) => setTimeout(resolve, attempt * 2e3));
           continue;
         }
@@ -663,7 +663,7 @@ async function downloadBinaryFromRelease(binaryName, destPath) {
       }
       return true;
     } catch {
-      if (attempt < MAX_ATTEMPTS) {
+      if (attempt < maxAttempts) {
         await new Promise((resolve) => setTimeout(resolve, attempt * 2e3));
         continue;
       }
@@ -672,6 +672,14 @@ async function downloadBinaryFromRelease(binaryName, destPath) {
   }
   return false;
 }
+async function downloadBinaryFromRelease(binaryName, destPath) {
+  for (const source of BINARY_SOURCES) {
+    const url = `${source.url}/${binaryName}`;
+    const ok = await downloadFromUrl(url, destPath, source.timeoutMs);
+    if (ok) return true;
+  }
+  return false;
+}
 async function copyMdTemplates(ctx, srcDir, destDir, options = {}) {
   const installed = [];
   if (!await fs.pathExists(srcDir)) return installed;
@@ -850,6 +858,52 @@ function getBinaryName() {
   const ext = process.platform === "win32" ? ".exe" : "";
   return `codeagent-wrapper-${os}-${arch}${ext}`;
 }
+async function verifyBinary(installDir) {
+  const binDir = join(installDir, "bin");
+  const wrapperName = process.platform === "win32" ? "codeagent-wrapper.exe" : "codeagent-wrapper";
+  const wrapperPath = join(binDir, wrapperName);
+  if (!await fs.pathExists(wrapperPath)) return false;
+  try {
+    const { execSync } = await import('node:child_process');
+    execSync(`"${wrapperPath}" --version`, { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function showBinaryDownloadWarning(binDir) {
+  const binaryExt = process.platform === "win32" ? ".exe" : "";
+  const platformLabel = process.platform === "darwin" ? process.arch === "arm64" ? "darwin-arm64" : "darwin-amd64" : process.platform === "linux" ? process.arch === "arm64" ? "linux-arm64" : "linux-amd64" : process.arch === "arm64" ? "windows-arm64" : "windows-amd64";
+  const binaryFileName = `codeagent-wrapper-${platformLabel}${binaryExt}`;
+  const destFileName = `codeagent-wrapper${binaryExt}`;
+  const releaseUrl = `https://github.com/${GITHUB_REPO}/releases/tag/${RELEASE_TAG}`;
+  console.log();
+  console.log(ansis.red.bold(`  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557`));
+  console.log(ansis.red.bold(`  \u2551  \u26A0  codeagent-wrapper \u4E0B\u8F7D\u5931\u8D25                            \u2551`));
+  console.log(ansis.red.bold(`  \u2551     Binary download failed (network issue)                 \u2551`));
+  console.log(ansis.red.bold(`  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D`));
+  console.log();
+  console.log(ansis.yellow(`  \u591A\u6A21\u578B\u534F\u4F5C\u547D\u4EE4 (/ccg:workflow, /ccg:plan \u7B49) \u9700\u8981\u6B64\u6587\u4EF6\u624D\u80FD\u5DE5\u4F5C\u3002`));
+  console.log(ansis.yellow(`  Multi-model commands require this binary to work.`));
+  console.log();
+  console.log(ansis.cyan(`  \u624B\u52A8\u4FEE\u590D / Manual fix:`));
+  console.log();
+  console.log(ansis.white(`    1. \u4E0B\u8F7D / Download:`));
+  console.log(ansis.cyan(`       ${releaseUrl}`));
+  console.log(ansis.gray(`       \u2192 \u627E\u5230 ${ansis.white(binaryFileName)} \u5E76\u4E0B\u8F7D`));
+  console.log();
+  console.log(ansis.white(`    2. \u653E\u5230 / Place at:`));
+  console.log(ansis.cyan(`       ${binDir}/${destFileName}`));
+  console.log();
+  if (process.platform !== "win32") {
+    console.log(ansis.white(`    3. \u52A0\u6743\u9650 / Make executable:`));
+    console.log(ansis.cyan(`       chmod +x "${binDir}/${destFileName}"`));
+    console.log();
+  }
+  console.log(ansis.white(`    \u6216\u91CD\u65B0\u5B89\u88C5 / Or re-install:`));
+  console.log(ansis.cyan(`       npx ccg-workflow@latest`));
+  console.log();
+}
 async function installBinaryFile(ctx) {
   try {
     const binDir = join(ctx.installDir, "bin");
@@ -861,6 +915,16 @@ async function installBinaryFile(ctx) {
       return;
     }
     const destBinary = join(binDir, process.platform === "win32" ? "codeagent-wrapper.exe" : "codeagent-wrapper");
+    if (await fs.pathExists(destBinary)) {
+      try {
+        const { execSync } = await import('node:child_process');
+        execSync(`"${destBinary}" --version`, { stdio: "pipe" });
+        ctx.result.binPath = binDir;
+        ctx.result.binInstalled = true;
+        return;
+      } catch {
+      }
+    }
     const installed = await downloadBinaryFromRelease(binaryName, destBinary);
     if (installed) {
       try {
@@ -913,7 +977,7 @@ async function installWorkflows(workflowIds, installDir, force = false, config)
   ctx.result.configPath = join(installDir, "commands", "ccg");
   return ctx.result;
 }
-async function uninstallWorkflows(installDir) {
+async function uninstallWorkflows(installDir, options) {
   const result = {
     success: true,
     removedCommands: [],
@@ -964,7 +1028,7 @@ async function uninstallWorkflows(installDir) {
       result.errors.push(`Failed to remove rules: ${error}`);
     }
   }
-  if (await fs.pathExists(binDir)) {
+  if (!options?.preserveBinary && await fs.pathExists(binDir)) {
     try {
       const wrapperName = process.platform === "win32" ? "codeagent-wrapper.exe" : "codeagent-wrapper";
       const wrapperPath = join(binDir, wrapperName);
@@ -988,6 +1052,17 @@ async function uninstallWorkflows(installDir) {
   return result;
 }
 
+async function syncMcpMirrors() {
+  const [codex, gemini] = await Promise.all([syncMcpToCodex(), syncMcpToGemini()]);
+  const synced = [];
+  if (codex.success && codex.synced.length > 0) synced.push(`Codex(${codex.synced.join(",")})`);
+  if (gemini.success && gemini.synced.length > 0) synced.push(`Gemini(${gemini.synced.join(",")})`);
+  if (synced.length > 0) {
+    console.log(ansis.green(`\u2713 MCP \u5DF2\u540C\u6B65\u5230 ${synced.join(" + ")}`));
+  }
+  if (!codex.success) console.log(ansis.yellow(`\u26A0 Codex \u540C\u6B65\u5931\u8D25: ${codex.message}`));
+  if (!gemini.success) console.log(ansis.yellow(`\u26A0 Gemini \u540C\u6B65\u5931\u8D25: ${gemini.message}`));
+}
 async function configMcp() {
   console.log();
   console.log(ansis.cyan.bold(`  \u914D\u7F6E MCP \u5DE5\u5177`));
@@ -1063,6 +1138,7 @@ async function handleInstallAceTool(isRs) {
   console.log();
   if (result.success) {
     console.log(ansis.green(`\u2713 ${toolName} MCP \u914D\u7F6E\u6210\u529F\uFF01`));
+    await syncMcpMirrors();
     console.log(ansis.gray(`  \u91CD\u542F Claude Code CLI \u4F7F\u914D\u7F6E\u751F\u6548`));
   } else {
     console.log(ansis.red(`\u2717 ${toolName} MCP \u914D\u7F6E\u5931\u8D25: ${result.message}`));
@@ -1088,6 +1164,7 @@ async function handleInstallContextWeaver() {
   console.log();
   if (result.success) {
     console.log(ansis.green("\u2713 ContextWeaver MCP \u914D\u7F6E\u6210\u529F\uFF01"));
+    await syncMcpMirrors();
     console.log(ansis.gray("  \u91CD\u542F Claude Code CLI \u4F7F\u914D\u7F6E\u751F\u6548"));
   } else {
     console.log(ansis.red(`\u2717 ContextWeaver MCP \u914D\u7F6E\u5931\u8D25: ${result.message}`));
@@ -1121,6 +1198,7 @@ async function handleInstallFastContext() {
     await writeFastContextPrompt();
     console.log(ansis.green("\u2713 fast-context MCP \u914D\u7F6E\u6210\u529F\uFF01"));
     console.log(ansis.green("\u2713 \u641C\u7D22\u63D0\u793A\u8BCD\u5DF2\u5199\u5165 ~/.claude/rules/ + ~/.codex/AGENTS.md + ~/.gemini/GEMINI.md"));
+    await syncMcpMirrors();
     console.log(ansis.gray("  \u91CD\u542F Claude Code CLI \u4F7F\u914D\u7F6E\u751F\u6548"));
   } else {
     console.log(ansis.red(`\u2717 fast-context MCP \u914D\u7F6E\u5931\u8D25: ${result.message}`));
@@ -1213,6 +1291,7 @@ async function handleGrokSearch() {
     await writeGrokPromptToRules();
     console.log(ansis.green("\u2713 grok-search MCP \u914D\u7F6E\u6210\u529F\uFF01"));
     console.log(ansis.green("\u2713 \u5168\u5C40\u641C\u7D22\u63D0\u793A\u8BCD\u5DF2\u5199\u5165 ~/.claude/rules/ccg-grok-search.md"));
+    await syncMcpMirrors();
     console.log(ansis.gray("  \u91CD\u542F Claude Code CLI \u4F7F\u914D\u7F6E\u751F\u6548"));
   } else {
     console.log(ansis.red(`\u2717 grok-search MCP \u5B89\u88C5\u5931\u8D25: ${result.message}`));
@@ -1265,6 +1344,7 @@ async function handleAuxiliary() {
     }
   }
   console.log();
+  await syncMcpMirrors();
   console.log(ansis.gray("\u91CD\u542F Claude Code CLI \u4F7F\u914D\u7F6E\u751F\u6548"));
 }
 async function handleUninstall() {
@@ -1306,6 +1386,7 @@ async function handleUninstall() {
       console.log(ansis.red(`\u2717 ${target} \u5378\u8F7D\u5931\u8D25: ${result.message}`));
     }
   }
+  await syncMcpMirrors();
   console.log();
 }
 
@@ -3103,38 +3184,7 @@ ${exportCommand}
         }
       }
     } else {
-      const binDest = join(installDir, "bin");
-      const binaryExt = process.platform === "win32" ? ".exe" : "";
-      const platformLabel = process.platform === "darwin" ? process.arch === "arm64" ? "darwin-arm64" : "darwin-amd64" : process.platform === "linux" ? process.arch === "arm64" ? "linux-arm64" : "linux-amd64" : process.arch === "arm64" ? "windows-arm64" : "windows-amd64";
-      const binaryFileName = `codeagent-wrapper-${platformLabel}${binaryExt}`;
-      const destFileName = `codeagent-wrapper${binaryExt}`;
-      const releaseUrl = `https://github.com/fengshao1227/ccg-workflow/releases/tag/preset`;
-      console.log();
-      console.log(ansis.red.bold(`  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557`));
-      console.log(ansis.red.bold(`  \u2551  \u26A0  codeagent-wrapper \u4E0B\u8F7D\u5931\u8D25                            \u2551`));
-      console.log(ansis.red.bold(`  \u2551     Binary download failed (network issue)                 \u2551`));
-      console.log(ansis.red.bold(`  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D`));
-      console.log();
-      console.log(ansis.yellow(`  \u591A\u6A21\u578B\u534F\u4F5C\u547D\u4EE4 (/ccg:workflow, /ccg:plan \u7B49) \u9700\u8981\u6B64\u6587\u4EF6\u624D\u80FD\u5DE5\u4F5C\u3002`));
-      console.log(ansis.yellow(`  Multi-model commands require this binary to work.`));
-      console.log();
-      console.log(ansis.cyan(`  \u624B\u52A8\u4FEE\u590D / Manual fix:`));
-      console.log();
-      console.log(ansis.white(`    1. \u4E0B\u8F7D / Download:`));
-      console.log(ansis.cyan(`       ${releaseUrl}`));
-      console.log(ansis.gray(`       \u2192 \u627E\u5230 ${ansis.white(binaryFileName)} \u5E76\u4E0B\u8F7D`));
-      console.log();
-      console.log(ansis.white(`    2. \u653E\u5230 / Place at:`));
-      console.log(ansis.cyan(`       ${binDest}/${destFileName}`));
-      console.log();
-      if (process.platform !== "win32") {
-        console.log(ansis.white(`    3. \u52A0\u6743\u9650 / Make executable:`));
-        console.log(ansis.cyan(`       chmod +x "${binDest}/${destFileName}"`));
-        console.log();
-      }
-      console.log(ansis.white(`    \u6216\u91CD\u65B0\u5B89\u88C5 / Or re-install:`));
-      console.log(ansis.cyan(`       npx ccg-workflow@latest`));
-      console.log();
+      showBinaryDownloadWarning(join(installDir, "bin"));
     }
     if (mcpProvider === "skip" || (mcpProvider === "ace-tool" || mcpProvider === "ace-tool-rs") && !aceToolToken || mcpProvider === "contextweaver" && !contextWeaverApiKey) {
       console.log();
@@ -3376,18 +3426,8 @@ async function performUpdate(fromVersion, toVersion, isNewVersion) {
   }
   spinner = ora(i18n.t("update:removingOld")).start();
   const installDir = join(homedir(), ".claude");
-  const binDir = join(installDir, "bin");
-  const wrapperName = process.platform === "win32" ? "codeagent-wrapper.exe" : "codeagent-wrapper";
-  const wrapperPath = join(binDir, wrapperName);
-  const wrapperBackup = join(binDir, `${wrapperName}.bak`);
-  let binaryBackedUp = false;
   try {
-    const fsExtra = await import('fs-extra');
-    if (await fsExtra.pathExists(wrapperPath)) {
-      await fsExtra.copy(wrapperPath, wrapperBackup);
-      binaryBackedUp = true;
-    }
-    const uninstallResult = await uninstallWorkflows(installDir);
+    const uninstallResult = await uninstallWorkflows(installDir, { preserveBinary: true });
     if (uninstallResult.success) {
       spinner.succeed(i18n.t("update:oldRemoved"));
     } else {
@@ -3410,11 +3450,6 @@ async function performUpdate(fromVersion, toVersion, isNewVersion) {
       }
     });
     spinner.succeed(i18n.t("update:installDone"));
-    if (binaryBackedUp) {
-      const fsExtra = await import('fs-extra');
-      await fsExtra.remove(wrapperBackup).catch(() => {
-      });
-    }
     const config = await readCcgConfig();
     if (config?.workflows?.installed) {
       console.log();
@@ -3423,19 +3458,11 @@ async function performUpdate(fromVersion, toVersion, isNewVersion) {
         console.log(`  ${ansis.gray("\u2022")} /ccg:${cmd}`);
       }
     }
+    if (!await verifyBinary(installDir)) {
+      showBinaryDownloadWarning(join(installDir, "bin"));
+    }
   } catch (error) {
     spinner.fail(i18n.t("update:installFailed"));
-    if (binaryBackedUp) {
-      try {
-        const fsExtra = await import('fs-extra');
-        if (await fsExtra.pathExists(wrapperBackup)) {
-          await fsExtra.ensureDir(binDir);
-          await fsExtra.move(wrapperBackup, wrapperPath, { overwrite: true });
-          console.log(ansis.yellow(`  \u2022 codeagent-wrapper restored from backup`));
-        }
-      } catch {
-      }
-    }
     console.log(ansis.red(`${i18n.t("common:error")}: ${error}`));
     console.log();
     console.log(ansis.yellow(i18n.t("update:manualRetry")));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.7.83",
+  "version": "1.7.85",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
@@ -77,7 +77,10 @@
     "prepublishOnly": "pnpm build",
     "test": "vitest run",
     "lint": "eslint",
-    "lint:fix": "eslint --fix"
+    "lint:fix": "eslint --fix",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
   },
   "dependencies": {
     "ansis": "^4.1.0",
@@ -90,6 +93,9 @@
     "pathe": "^2.0.3",
     "smol-toml": "^1.4.2"
   },
+  "pnpm": {
+    "onlyBuiltDependencies": ["esbuild"]
+  },
   "devDependencies": {
     "@antfu/eslint-config": "^5.4.1",
     "@types/fs-extra": "^11.0.4",
@@ -98,6 +104,7 @@
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "unbuild": "^3.6.1",
+    "vitepress": "^1.6.4",
     "vitest": "^3.1.1"
   }
 }