feat: Ship docs directly at vite-plus/docs.

Author: cpojer

packages/cli/.gitignore

@@ -1,4 +1,4 @@
 /npm
 /artifacts
 /LICENSE
-/skills/vite-plus/docs
+/docs

packages/cli/AGENTS.md

@@ -4,17 +4,12 @@
 
 This project is using Vite+, a unified toolchain built on top of Vite, Rolldown, Vitest, tsdown, Oxlint, Oxfmt, and Vite Task. Vite+ wraps runtime management, package management, and frontend tooling in a single global CLI called `vp`. Vite+ is distinct from Vite, and it invokes Vite through `vp dev` and `vp build`. Run `vp help` to print a list of commands and `vp <command> --help` for information about a specific command.
 
-## Common Pitfalls
-
-- **Running scripts:** Vite+ built-in commands (`vp lint`, `vp dev`, `vp build`, `vp test`, etc.) always run the Vite+ built-in tool. Use `vp run <script>` to run `package.json` scripts or tasks defined in `vite.config.ts`
-- **Do not install Vitest, Oxlint, Oxfmt, or tsdown directly:** Vite+ wraps these tools. Do not install or upgrade them, use Vite+ directly.
-- **Import JavaScript modules from `vite-plus`:** Import modules from the `vite-plus` dependency, not from `vite` or `vitest`. For example, `import { defineConfig } from 'vite-plus';` or `import { expect, test, vi } from 'vite-plus/test';`. You must not install `vitest` to import test utilities.
+Docs are local at `node_modules/vite-plus/docs` or online at https://viteplus.dev/guide/.
 
 ## Review Checklist
 
 - [ ] Run `vp install` after pulling remote changes and before getting started.
 - [ ] Run `vp check` and `vp test` to format, lint, type check and test changes.
-- [ ] Check if there are tasks or `package.json` scripts necessary for validation, run via `vp run <script>`.
+- [ ] Check if there are `vite.config.ts` tasks or `package.json` scripts necessary for validation, run via `vp run <script>`.
 
-* Docs: https://viteplus.dev/guide/
 <!--VITE PLUS END-->

packages/cli/build.ts

@@ -7,7 +7,7 @@
  * 3. syncCorePackageExports() - Creates shim files to re-export from @voidzero-dev/vite-plus-core
  * 4. syncTestPackageExports() - Creates shim files to re-export from @voidzero-dev/vite-plus-test
  * 5. syncVersionsExport() - Generates ./versions module with bundled tool versions
- * 6. copySkillDocs() - Copies docs into skills/vite-plus/docs for runtime MCP access
+ * 6. copyBundledDocs() - Copies docs into docs/ for bundled package access
  * 7. syncReadmeFromRoot() - Keeps package README in sync
  *
  * The sync functions allow this package to be a drop-in replacement for 'vite' by
@@ -19,7 +19,7 @@
  */
 
 import { execSync } from 'node:child_process';
-import { existsSync, globSync, readdirSync, statSync } from 'node:fs';
+import { existsSync, readdirSync, statSync } from 'node:fs';
 import { copyFile, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -74,7 +74,7 @@ if (!skipTs) {
   await syncTestPackageExports();
   await syncVersionsExport();
 }
-await copySkillDocs();
+await copyBundledDocs();
 await syncReadmeFromRoot();
 
 async function buildNapiBinding() {
@@ -387,42 +387,27 @@ async function syncVersionsExport() {
 }
 
 /**
- * Copy markdown doc files from the monorepo docs/ directory into skills/vite-plus/docs/,
- * preserving the relative directory structure. This keeps stable file paths for
- * skills routing and MCP page slugs.
+ * Copy the docs source tree into docs/, preserving relative paths.
+ * Generated VitePress output and installed dependencies are excluded so the package
+ * only ships authoring sources and referenced assets.
  */
-async function copySkillDocs() {
-  console.log('\nCopying skill docs...');
+async function copyBundledDocs() {
+  console.log('\nCopying bundled docs...');
 
   const docsSourceDir = join(projectDir, '..', '..', 'docs');
-  const docsTargetDir = join(projectDir, 'skills', 'vite-plus', 'docs');
+  const docsTargetDir = join(projectDir, 'docs');
 
   if (!existsSync(docsSourceDir)) {
-    console.log('  Docs source directory not found, skipping skill docs copy');
+    console.log('  Docs source directory not found, skipping docs copy');
     return;
   }
 
   // Clean and recreate target directory
   await rm(docsTargetDir, { recursive: true, force: true });
   await mkdir(docsTargetDir, { recursive: true });
 
-  // Find all markdown files recursively and copy them with their relative paths.
-  const mdFiles = globSync('**/*.md', { cwd: docsSourceDir }).filter(
-    (f) => !f.includes('node_modules') && f !== 'index.md',
-  );
-  // eslint-disable-next-line unicorn/no-array-sort -- sorted traversal keeps output deterministic
-  mdFiles.sort();
-
-  let copied = 0;
-  for (const relPath of mdFiles) {
-    const sourcePath = join(docsSourceDir, relPath);
-    const targetPath = join(docsTargetDir, relPath);
-    await mkdir(dirname(targetPath), { recursive: true });
-    await copyFile(sourcePath, targetPath);
-    copied++;
-  }
-
-  console.log(`  Copied ${copied} doc files to skills/vite-plus/docs/ (with paths preserved)`);
+  const copied = await copyDocsTree(docsSourceDir, docsTargetDir);
+  console.log(`  Copied ${copied} docs files to docs/ (with paths preserved)`);
 }
 
 async function syncReadmeFromRoot() {
@@ -460,6 +445,49 @@ function splitReadme(content: string, label: string) {
   };
 }
 
+async function copyDocsTree(
+  docsSourceDir: string,
+  docsTargetDir: string,
+  relativePath = '',
+): Promise<number> {
+  let copied = 0;
+  const currentDir = join(docsSourceDir, relativePath);
+
+  for (const entry of readdirSync(currentDir, { withFileTypes: true })) {
+    const entryRelPath = relativePath ? join(relativePath, entry.name) : entry.name;
+    const normalizedPath = entryRelPath.replaceAll('\\', '/');
+
+    if (shouldSkipDocsPath(normalizedPath)) {
+      continue;
+    }
+
+    const sourcePath = join(docsSourceDir, entryRelPath);
+    const targetPath = join(docsTargetDir, entryRelPath);
+
+    if (entry.isDirectory()) {
+      await mkdir(targetPath, { recursive: true });
+      copied += await copyDocsTree(docsSourceDir, docsTargetDir, entryRelPath);
+      continue;
+    }
+
+    if (!entry.isFile()) {
+      continue;
+    }
+
+    await mkdir(dirname(targetPath), { recursive: true });
+    await copyFile(sourcePath, targetPath);
+    copied++;
+  }
+
+  return copied;
+}
+
+function shouldSkipDocsPath(relativePath: string) {
+  return ['node_modules', '.vitepress/cache', '.vitepress/dist'].some(
+    (prefix) => relativePath === prefix || relativePath.startsWith(`${prefix}/`),
+  );
+}
+
 type ExportValue =
   | string
   | {

packages/cli/package.json

@@ -28,8 +28,8 @@
     "binding/index.d.ts",
     "binding/index.js",
     "dist/test",
+    "docs",
     "rules",
-    "skills",
     "templates"
   ],
   "type": "module",

packages/cli/skills/vite-plus/SKILL.md

@@ -1,7 +1,7 @@
 /**
  * Unified entry point for both the local CLI (via bin/vp) and the global CLI (via Rust vp binary).
  *
- * Global commands (create, migrate, config, mcp, staged, --version) are handled by tsdown-bundled modules.
+ * Global commands (create, migrate, config, staged, --version) are handled by tsdown-bundled modules.
  * All other commands are delegated to the Rust core through NAPI bindings, which
  * uses JavaScript tool resolver functions to locate tool binaries.
  *
@@ -54,8 +54,6 @@ if (command === 'create') {
   await import('./migration/bin.js');
 } else if (command === 'config') {
   await import('./config/bin.js');
-} else if (command === 'mcp') {
-  await import('./mcp/bin.js');
 } else if (command === '--version' || command === '-V') {
   await import('./version.js');
 } else if (command === 'staged') {