vite-plus 0.1.7 → 0.1.9

package/README.md

@@ -29,7 +29,7 @@ Install Vite+ globally as `vp`:
 For Linux or macOS:
 
 ```bash
-curl -fsSL https://viteplus.dev/install.sh | bash
+curl -fsSL https://vite.plus | bash
 ```
 
 For Windows:
@@ -138,6 +138,7 @@ Vite+ automatically wraps your package manager (pnpm, npm, or Yarn) based on `pa
 #### Maintain
 
 - **upgrade** - Update `vp` itself to the latest version
+- **implode** - Remove `vp` and all related data
 
 ### Scaffolding your first Vite+ project
 

package/dist/bin.js

@@ -19,7 +19,16 @@ import { pack } from './resolve-pack.js';
 import { test } from './resolve-test.js';
 import { resolveUniversalViteConfig } from './resolve-vite-config.js';
 import { vite } from './resolve-vite.js';
-import { accent, log } from './utils/terminal.js';
+import { accent, errorMsg, log } from './utils/terminal.js';
+function getErrorMessage(err) {
+    if (err instanceof Error) {
+        return err.message;
+    }
+    if (typeof err === 'object' && err && 'message' in err && typeof err.message === 'string') {
+        return err.message;
+    }
+    return String(err);
+}
 // Parse command line arguments
 let args = process.argv.slice(2);
 // Transform `vp help [command]` into `vp [command] --help`
@@ -100,7 +109,7 @@ else {
         process.exit(finalExitCode);
     }
     catch (err) {
-        console.error('[Vite+] run error:', err);
+        errorMsg(getErrorMessage(err));
         process.exit(1);
     }
 }

package/dist/config/agent.d.ts

@@ -1,9 +1,9 @@
-import { type AgentConfig } from '../utils/agent.js';
+import { hasExistingAgentInstructions, type AgentConfig } from '../utils/agent.js';
 export interface AgentSetupSelection {
     instructionFilePath: 'CLAUDE.md' | 'AGENTS.md';
     agents: AgentConfig[];
 }
 export declare function resolveAgentSetup(root: string, interactive: boolean): Promise<AgentSetupSelection>;
-export declare function hasExistingAgentInstructions(root: string): boolean;
+export { hasExistingAgentInstructions };
 export declare function injectAgentBlock(root: string, filePath: string): void;
 export declare function setupMcpConfig(root: string, selectedAgents: AgentConfig[]): void;

package/dist/config/agent.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import * as prompts from '@voidzero-dev/vite-plus-prompts';
-import { detectAgents, getAgentById, } from '../utils/agent.js';
+import { detectAgents, getAgentById, hasExistingAgentInstructions, replaceMarkedAgentInstructionsSection, } from '../utils/agent.js';
 import { writeJsonFile, readJsonFile } from '../utils/json.js';
 import { pkgRoot } from '../utils/path.js';
 function detectInstructionFilePath(root, agentConfigs) {
@@ -56,69 +56,36 @@ export async function resolveAgentSetup(root, interactive) {
     }
     return pickAgentWhenUndetected();
 }
-// --- Version and template reading ---
-function getOwnVersion() {
-    const pkg = JSON.parse(readFileSync(join(pkgRoot, 'package.json'), 'utf-8'));
-    if (typeof pkg.version !== 'string') {
-        throw new Error('vite-plus package.json is missing a "version" field');
-    }
-    return pkg.version;
-}
+// --- Template reading ---
 function readAgentPrompt() {
     return readFileSync(join(pkgRoot, 'AGENTS.md'), 'utf-8');
 }
-// --- Versioned injection ---
-const MARKER_OPEN_RE = /<!--injected-by-vite-plus-v([\w.+-]+)-->/;
-const MARKER_CLOSE = '<!--/injected-by-vite-plus-->';
-const MARKER_BLOCK_RE = /<!--injected-by-vite-plus-v[\w.+-]+-->\n[\s\S]*?<!--\/injected-by-vite-plus-->/;
-export function hasExistingAgentInstructions(root) {
-    for (const file of ['AGENTS.md', 'CLAUDE.md']) {
-        const fullPath = join(root, file);
-        if (existsSync(fullPath)) {
-            const content = readFileSync(fullPath, 'utf-8');
-            if (MARKER_OPEN_RE.test(content)) {
-                return true;
-            }
-        }
-    }
-    return false;
-}
+// --- Agent instructions injection ---
+export { hasExistingAgentInstructions };
 export function injectAgentBlock(root, filePath) {
     const fullPath = join(root, filePath);
-    const version = getOwnVersion();
-    const promptContent = readAgentPrompt();
-    const openMarker = `<!--injected-by-vite-plus-v${version}-->`;
-    const block = `${openMarker}\n${promptContent}\n${MARKER_CLOSE}`;
+    const template = readAgentPrompt();
     if (existsSync(fullPath)) {
         const existing = readFileSync(fullPath, 'utf-8');
-        const match = existing.match(MARKER_OPEN_RE);
-        if (match) {
-            if (match[1] === version) {
-                prompts.log.info(`${filePath} already has Vite+ instructions (v${version})`);
-                return;
-            }
-            // Replace existing block with updated version
-            const updated = existing.replace(MARKER_BLOCK_RE, block);
-            if (updated === existing) {
-                // Closing marker is missing or malformed — append fresh block
-                const separator = existing.endsWith('\n') ? '\n' : '\n\n';
-                writeFileSync(fullPath, existing + separator + block + '\n');
-                prompts.log.warn(`Existing Vite+ block in ${filePath} was malformed; appended fresh block`);
+        const updated = replaceMarkedAgentInstructionsSection(existing, template);
+        if (updated !== undefined) {
+            if (updated !== existing) {
+                writeFileSync(fullPath, updated);
+                prompts.log.success(`Updated Vite+ instructions in ${filePath}`);
             }
             else {
-                writeFileSync(fullPath, updated);
-                prompts.log.success(`Updated Vite+ instructions in ${filePath} (v${match[1]} → v${version})`);
+                prompts.log.info(`${filePath} already has up-to-date Vite+ instructions`);
             }
         }
         else {
-            // Append block to end of file
+            // No markers found — append template
             const separator = existing.endsWith('\n') ? '\n' : '\n\n';
-            writeFileSync(fullPath, existing + separator + block + '\n');
+            writeFileSync(fullPath, existing + separator + template);
             prompts.log.success(`Added Vite+ instructions to ${filePath}`);
         }
     }
     else {
-        writeFileSync(fullPath, block + '\n');
+        writeFileSync(fullPath, template);
         prompts.log.success(`Created ${filePath} with Vite+ instructions`);
     }
 }

package/dist/config/bin.js

@@ -23,6 +23,7 @@ async function main() {
         const helpMessage = renderCliDoc({
             usage: 'vp config [OPTIONS]',
             summary: 'Configure Vite+ for the current project (hooks + agent integration).',
+            documentationUrl: 'https://viteplus.dev/guide/commit-hooks',
             sections: [
                 {
                     title: 'Options',

package/dist/global/{agent-CpNB3GIY.js → agent-D0WD4q4_.js}

@@ -1,6 +1,6 @@
 import { t as __commonJSMin } from "./chunk-CgnkrU7a.js";
 import { o as DEFAULT_ENVS, u as resolve$1 } from "./json-BRdVJ52a.js";
-import { n as accent } from "./help-BAGHa8fD.js";
+import { n as accent } from "./help-CbTzUdXc.js";
 import path from "node:path";
 import { stripVTControlCharacters } from "node:util";
 import color from "picocolors";
@@ -1986,6 +1986,12 @@ function detectExistingAgentTargetPaths(projectRoot) {
 	}
 	return detectedPaths.length > 0 ? detectedPaths : void 0;
 }
+function hasExistingAgentInstructions(projectRoot) {
+	const targetPaths = detectExistingAgentTargetPaths(projectRoot);
+	if (!targetPaths) return false;
+	for (const targetPath of targetPaths) if (fs.readFileSync(path.join(projectRoot, targetPath), "utf-8").includes(AGENT_INSTRUCTIONS_START_MARKER)) return true;
+	return false;
+}
 function resolveAgentTargetPaths(agent) {
 	const agentNames = parseAgentNames(agent);
 	const resolvedAgentNames = agentNames.length > 0 ? agentNames : ["other"];
@@ -2165,4 +2171,4 @@ function getMarkedRange(content, startMarker, endMarker) {
 	};
 }
 //#endregion
-export { select as A, cancel as C, multiselect as D, log as E, text as M, Ct as N, note as O, PackageManager as S, intro as T, pkgRoot as _, selectAgentTargetPaths as a, runCommandSilently as b, defaultInteractive as c, promptGitHooks as d, runViteFmt as f, displayRelative as g, upgradeYarn as h, getAgentById as i, spinner as j, outro as k, downloadPackageManager$1 as l, selectPackageManager as m, detectAgents as n, writeAgentInstructions as o, runViteInstall as p, detectExistingAgentTargetPaths as r, cancelAndExit as s, detectAgentConflicts as t, getSpinner as u, rulesDir as v, confirm as w, DependencyType as x, templatesDir as y };
+export { note as A, DependencyType as C, intro as D, confirm as E, Ct as F, select as M, spinner as N, log as O, text as P, runCommandSilently as S, cancel as T, upgradeYarn as _, hasExistingAgentInstructions as a, rulesDir as b, writeAgentInstructions as c, downloadPackageManager$1 as d, getSpinner as f, selectPackageManager as g, runViteInstall as h, getAgentById as i, outro as j, multiselect as k, cancelAndExit as l, runViteFmt as m, detectAgents as n, replaceMarkedAgentInstructionsSection as o, promptGitHooks as p, detectExistingAgentTargetPaths as r, selectAgentTargetPaths as s, detectAgentConflicts as t, defaultInteractive as u, displayRelative as v, PackageManager as w, templatesDir as x, pkgRoot as y };

package/dist/global/config.js

@@ -1,7 +1,7 @@
-import { A as select, C as cancel, E as log, N as Ct, O as note, _ as pkgRoot, c as defaultInteractive, d as promptGitHooks, i as getAgentById, n as detectAgents } from "./agent-CpNB3GIY.js";
+import { A as note, F as Ct, M as select, O as log, T as cancel, a as hasExistingAgentInstructions, i as getAgentById, n as detectAgents, o as replaceMarkedAgentInstructionsSection, p as promptGitHooks, u as defaultInteractive, y as pkgRoot } from "./agent-D0WD4q4_.js";
 import { t as lib_default } from "./lib-DxappLRQ.js";
 import { i as writeJsonFile, r as readJsonFile, s as VITE_PLUS_NAME } from "./json-BRdVJ52a.js";
-import { r as log$1, t as renderCliDoc } from "./help-BAGHa8fD.js";
+import { i as log$1, t as renderCliDoc } from "./help-CbTzUdXc.js";
 import { dirname, join, relative } from "node:path";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, realpathSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
 import { vitePlusHeader } from "../../binding/index.js";
@@ -151,54 +151,25 @@ async function resolveAgentSetup(root, interactive) {
 	};
 	return pickAgentWhenUndetected();
 }
-function getOwnVersion() {
-	const pkg = JSON.parse(readFileSync(join(pkgRoot, "package.json"), "utf-8"));
-	if (typeof pkg.version !== "string") throw new Error("vite-plus package.json is missing a \"version\" field");
-	return pkg.version;
-}
 function readAgentPrompt() {
 	return readFileSync(join(pkgRoot, "AGENTS.md"), "utf-8");
 }
-const MARKER_OPEN_RE = /<!--injected-by-vite-plus-v([\w.+-]+)-->/;
-const MARKER_CLOSE = "<!--/injected-by-vite-plus-->";
-const MARKER_BLOCK_RE = /<!--injected-by-vite-plus-v[\w.+-]+-->\n[\s\S]*?<!--\/injected-by-vite-plus-->/;
-function hasExistingAgentInstructions(root) {
-	for (const file of ["AGENTS.md", "CLAUDE.md"]) {
-		const fullPath = join(root, file);
-		if (existsSync(fullPath)) {
-			const content = readFileSync(fullPath, "utf-8");
-			if (MARKER_OPEN_RE.test(content)) return true;
-		}
-	}
-	return false;
-}
 function injectAgentBlock(root, filePath) {
 	const fullPath = join(root, filePath);
-	const version = getOwnVersion();
-	const promptContent = readAgentPrompt();
-	const block = `${`<!--injected-by-vite-plus-v${version}-->`}\n${promptContent}\n${MARKER_CLOSE}`;
+	const template = readAgentPrompt();
 	if (existsSync(fullPath)) {
 		const existing = readFileSync(fullPath, "utf-8");
-		const match = existing.match(MARKER_OPEN_RE);
-		if (match) {
-			if (match[1] === version) {
-				log.info(`${filePath} already has Vite+ instructions (v${version})`);
-				return;
-			}
-			const updated = existing.replace(MARKER_BLOCK_RE, block);
-			if (updated === existing) {
-				writeFileSync(fullPath, existing + (existing.endsWith("\n") ? "\n" : "\n\n") + block + "\n");
-				log.warn(`Existing Vite+ block in ${filePath} was malformed; appended fresh block`);
-			} else {
-				writeFileSync(fullPath, updated);
-				log.success(`Updated Vite+ instructions in ${filePath} (v${match[1]} → v${version})`);
-			}
-		} else {
-			writeFileSync(fullPath, existing + (existing.endsWith("\n") ? "\n" : "\n\n") + block + "\n");
+		const updated = replaceMarkedAgentInstructionsSection(existing, template);
+		if (updated !== void 0) if (updated !== existing) {
+			writeFileSync(fullPath, updated);
+			log.success(`Updated Vite+ instructions in ${filePath}`);
+		} else log.info(`${filePath} already has up-to-date Vite+ instructions`);
+		else {
+			writeFileSync(fullPath, existing + (existing.endsWith("\n") ? "\n" : "\n\n") + template);
 			log.success(`Added Vite+ instructions to ${filePath}`);
 		}
 	} else {
-		writeFileSync(fullPath, block + "\n");
+		writeFileSync(fullPath, template);
 		log.success(`Created ${filePath} with Vite+ instructions`);
 	}
 }
@@ -366,6 +337,7 @@ async function main() {
 		const helpMessage = renderCliDoc({
 			usage: "vp config [OPTIONS]",
 			summary: "Configure Vite+ for the current project (hooks + agent integration).",
+			documentationUrl: "https://viteplus.dev/guide/commit-hooks",
 			sections: [{
 				title: "Options",
 				rows: [{

package/dist/global/create.js

@@ -1,11 +1,11 @@
 import { i as __toESM, t as __commonJSMin } from "./chunk-CgnkrU7a.js";
-import { A as select, C as cancel, D as multiselect, E as log, M as text, N as Ct, S as PackageManager, T as intro, a as selectAgentTargetPaths, c as defaultInteractive, d as promptGitHooks, f as runViteFmt, g as displayRelative, j as spinner, l as downloadPackageManager$1, m as selectPackageManager, o as writeAgentInstructions, p as runViteInstall, r as detectExistingAgentTargetPaths, w as confirm, x as DependencyType, y as templatesDir } from "./agent-CpNB3GIY.js";
+import { C as DependencyType, D as intro, E as confirm, F as Ct, M as select, N as spinner, O as log, P as text, T as cancel, c as writeAgentInstructions, d as downloadPackageManager$1, g as selectPackageManager, h as runViteInstall, k as multiselect, m as runViteFmt, p as promptGitHooks, r as detectExistingAgentTargetPaths, s as selectAgentTargetPaths, u as defaultInteractive, v as displayRelative, w as PackageManager, x as templatesDir } from "./agent-D0WD4q4_.js";
 import { t as lib_default } from "./lib-DxappLRQ.js";
-import { _ as rewriteMonorepo, a as detectExistingEditor, f as installGitHooks, n as updatePackageJsonWithDeps, o as selectEditor, r as updateWorkspaceConfig, s as writeEditorConfigs, t as detectWorkspace$1, v as rewriteMonorepoProject, y as rewriteStandaloneProject } from "./workspace-pvS7F6d2.js";
+import { _ as rewriteMonorepo, a as detectExistingEditor, f as installGitHooks, n as updatePackageJsonWithDeps, o as selectEditor, r as updateWorkspaceConfig, s as writeEditorConfigs, t as detectWorkspace$1, v as rewriteMonorepoProject, y as rewriteStandaloneProject } from "./workspace-ktWMiLVj.js";
 import "./browser-CBapUTD0.js";
 import { r as readJsonFile, t as editJsonFile } from "./json-BRdVJ52a.js";
 import "./package-YAMvX5PJ.js";
-import { a as success, i as muted, n as accent, r as log$1, t as renderCliDoc } from "./help-BAGHa8fD.js";
+import { a as muted, i as log$1, n as accent, o as success, t as renderCliDoc } from "./help-CbTzUdXc.js";
 import path from "node:path";
 import { styleText } from "node:util";
 import color from "picocolors";
@@ -253,6 +253,27 @@ function inferParentDir(templateName, workspaceInfo) {
 	for (const parentDir of workspaceInfo.parentDirs) if (rule.test(parentDir)) return parentDir;
 }
 //#endregion
+//#region src/create/initial-template-options.ts
+function getInitialTemplateOptions(isMonorepo) {
+	return [
+		...!isMonorepo ? [{
+			label: "Vite+ Monorepo",
+			value: BuiltinTemplate.monorepo,
+			hint: "Create a new Vite+ monorepo project"
+		}] : [],
+		{
+			label: "Vite+ Application",
+			value: BuiltinTemplate.application,
+			hint: "Create vite applications"
+		},
+		{
+			label: "Vite+ Library",
+			value: BuiltinTemplate.library,
+			hint: "Create vite libraries"
+		}
+	];
+}
+//#endregion
 //#region ../../node_modules/.pnpm/validate-npm-package-name@7.0.2/node_modules/validate-npm-package-name/lib/builtin-modules.json
 var require_builtin_modules = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = [
@@ -3592,6 +3613,7 @@ function getScopeFromPackageName(packageName) {
 const helpMessage = renderCliDoc({
 	usage: "vp create [TEMPLATE] [OPTIONS] [-- TEMPLATE_OPTIONS]",
 	summary: "Use any builtin, local or remote template with Vite+.",
+	documentationUrl: "https://viteplus.dev/guide/create",
 	sections: [
 		{
 			title: "Arguments",
@@ -3682,6 +3704,7 @@ const helpMessage = renderCliDoc({
 const listTemplatesMessage = renderCliDoc({
 	usage: "vp create --list",
 	summary: "List available builtin and popular project templates.",
+	documentationUrl: "https://viteplus.dev/guide/create",
 	sections: [
 		{
 			title: "Vite+ Built-in Templates",
@@ -3889,61 +3912,12 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
 	let remoteTargetDir;
 	let shouldSetupHooks = false;
 	if (!selectedTemplateName) {
-		const templates = [];
-		if (isMonorepo) {
-			for (const pkg of workspaceInfoOptional.packages) if (pkg.isTemplatePackage) templates.push({
-				label: pkg.name,
-				value: pkg.name,
-				hint: pkg.description ?? pkg.path
-			});
-		} else templates.push({
-			label: "Vite+ Monorepo",
-			value: BuiltinTemplate.monorepo,
-			hint: "Create a new Vite+ monorepo project"
-		});
 		const template = await select({
 			message: "",
-			options: [
-				...templates,
-				{
-					label: "Vite+ Application",
-					value: BuiltinTemplate.application,
-					hint: "Create vite applications"
-				},
-				{
-					label: "Vite+ Library",
-					value: BuiltinTemplate.library,
-					hint: "Create vite libraries"
-				},
-				...isMonorepo ? [{
-					label: "Vite+ Generator",
-					value: BuiltinTemplate.generator,
-					hint: "Scaffold a new code generator"
-				}] : [],
-				{
-					label: "TanStack Start",
-					value: "@tanstack/create-start@latest",
-					hint: "Create TanStack applications and libraries"
-				},
-				{
-					label: "Others",
-					value: "other",
-					hint: "Enter a custom template package name"
-				}
-			]
+			options: getInitialTemplateOptions(isMonorepo)
 		});
 		if (Ct(template)) cancelAndExit();
-		if (template === "other") {
-			const customTemplate = await text({
-				message: "Enter the template package name:",
-				placeholder: "e.g., create-next-app, create-nuxt",
-				validate: (value) => {
-					if (!value || value.trim().length === 0) return "Template name is required";
-				}
-			});
-			if (Ct(customTemplate)) cancelAndExit();
-			selectedTemplateName = customTemplate;
-		} else selectedTemplateName = template;
+		selectedTemplateName = template;
 	}
 	const isBuiltinTemplate = selectedTemplateName.startsWith("vite:");
 	if (!isBuiltinTemplate) compactOutput = false;

package/dist/global/{help-BAGHa8fD.js → help-CbTzUdXc.js}

@@ -12,6 +12,9 @@ function muted(text) {
 function success(text) {
 	return styleText("green", text);
 }
+function errorMsg(msg) {
+	console.error(styleText(["red", "bold"], "error:"), msg);
+}
 //#endregion
 //#region src/utils/help.ts
 function toLines(value) {
@@ -42,7 +45,8 @@ function renderRows(rows) {
 	return output;
 }
 function heading(label, color) {
-	return color ? styleText("bold", `${label}:`) : `${label}:`;
+	if (!color) return `${label}:`;
+	return label === "Usage" ? styleText("bold", `${label}:`) : styleText(["blue", "bold"], `${label}:`);
 }
 function renderCliDoc(doc, options = {}) {
 	const color = options.color ?? true;
@@ -63,8 +67,12 @@ function renderCliDoc(doc, options = {}) {
 		if (lines.length > 0) output.push(...lines);
 		if (section.rows && section.rows.length > 0) output.push(...renderRows(section.rows));
 	}
+	if (doc.documentationUrl) {
+		if (output.length > 0) output.push("");
+		output.push(`${heading("Documentation", color)} ${doc.documentationUrl}`);
+	}
 	output.push("");
 	return output.join("\n");
 }
 //#endregion
-export { success as a, muted as i, accent as n, log as r, renderCliDoc as t };
+export { muted as a, log as i, accent as n, success as o, errorMsg as r, renderCliDoc as t };

package/dist/global/migrate.js

@@ -1,11 +1,11 @@
 import { i as __toESM } from "./chunk-CgnkrU7a.js";
-import { A as select, E as log, N as Ct, S as PackageManager, a as selectAgentTargetPaths, c as defaultInteractive, d as promptGitHooks, g as displayRelative, h as upgradeYarn, j as spinner, k as outro, l as downloadPackageManager$1, m as selectPackageManager, o as writeAgentInstructions, p as runViteInstall, s as cancelAndExit, t as detectAgentConflicts, w as confirm } from "./agent-CpNB3GIY.js";
+import { E as confirm, F as Ct, M as select, N as spinner, O as log, _ as upgradeYarn, c as writeAgentInstructions, d as downloadPackageManager$1, g as selectPackageManager, h as runViteInstall, j as outro, l as cancelAndExit, p as promptGitHooks, s as selectAgentTargetPaths, t as detectAgentConflicts, u as defaultInteractive, v as displayRelative, w as PackageManager } from "./agent-D0WD4q4_.js";
 import { t as lib_default } from "./lib-DxappLRQ.js";
-import { _ as rewriteMonorepo, b as createMigrationReport, c as checkViteVersion, d as detectPrettierProject, f as installGitHooks, g as preflightGitHooksSetup, h as migratePrettierToOxfmt, i as detectEditorConflicts, l as checkVitestVersion, m as migrateEslintToOxlint, o as selectEditor, p as mergeViteConfigFiles, s as writeEditorConfigs, t as detectWorkspace$1, u as detectEslintProject, x as require_semver, y as rewriteStandaloneProject } from "./workspace-pvS7F6d2.js";
+import { _ as rewriteMonorepo, b as createMigrationReport, c as checkViteVersion, d as detectPrettierProject, f as installGitHooks, g as preflightGitHooksSetup, h as migratePrettierToOxfmt, i as detectEditorConflicts, l as checkVitestVersion, m as migrateEslintToOxlint, o as selectEditor, p as mergeViteConfigFiles, s as writeEditorConfigs, t as detectWorkspace$1, u as detectEslintProject, x as require_semver, y as rewriteStandaloneProject } from "./workspace-ktWMiLVj.js";
 import "./browser-CBapUTD0.js";
 import "./json-BRdVJ52a.js";
 import { i as readNearestPackageJson, r as hasVitePlusDependency } from "./package-YAMvX5PJ.js";
-import { i as muted, n as accent, r as log$1, t as renderCliDoc } from "./help-BAGHa8fD.js";
+import { a as muted, i as log$1, n as accent, t as renderCliDoc } from "./help-CbTzUdXc.js";
 import path from "node:path";
 import { styleText } from "node:util";
 import { vitePlusHeader } from "../../binding/index.js";
@@ -72,6 +72,7 @@ async function promptPrettierMigration(projectPath, interactive, packages) {
 const helpMessage = renderCliDoc({
 	usage: "vp migrate [PATH] [OPTIONS]",
 	summary: "Migrate standalone Vite, Vitest, Oxlint, Oxfmt, and Prettier projects to unified Vite+.",
+	documentationUrl: "https://viteplus.dev/guide/migrate",
 	sections: [
 		{
 			title: "Arguments",
@@ -129,6 +130,46 @@ const helpMessage = renderCliDoc({
 				`  ${muted("# Non-interactive mode")}`,
 				`  ${accent("vp migrate --no-interactive")}`
 			]
+		},
+		{
+			title: "Migration Prompt",
+			lines: [
+				"  Give this to a coding agent when you want it to drive the migration:",
+				"",
+				"  Migrate this project to Vite+.",
+				"  Vite+ replaces the current split tooling around runtime management, package",
+				"  management, dev/build/test commands, linting, formatting, and packaging.",
+				"  Run `vp help` and `vp help migrate` before making changes.",
+				`  Use ${accent("vp migrate --no-interactive")} in the workspace root.`,
+				"  Make sure the project is using Vite 8+ and Vitest 4.1+ before migrating.",
+				"",
+				"  After the migration:",
+				"  - Confirm `vite` imports were rewritten to `vite-plus` where needed",
+				"  - Confirm `vitest` imports were rewritten to `vite-plus/test` where needed",
+				"  - Remove old `vite` and `vitest` dependencies only after those rewrites",
+				"    are confirmed",
+				"  - Move remaining tool-specific config into the appropriate blocks in",
+				"    `vite.config.ts`",
+				"",
+				"  Command mapping:",
+				"  - `vp run <script>` is the equivalent of `pnpm run <script>`",
+				"  - `vp test` runs the built-in test command, while `vp run test` runs the",
+				"    `test` script from `package.json`",
+				"  - `vp install`, `vp add`, and `vp remove` delegate through the package",
+				"    manager declared by `packageManager`",
+				"  - `vp dev`, `vp build`, `vp preview`, `vp lint`, `vp fmt`, `vp check`,",
+				"    and `vp pack` replace the corresponding standalone tools",
+				"  - Prefer `vp check` for validation loops",
+				"",
+				"  Finally, verify the migration by running:",
+				`  - ${accent("vp install")}`,
+				`  - ${accent("vp check")}`,
+				`  - ${accent("vp test")}`,
+				`  - ${accent("vp build")}`,
+				"",
+				"  Summarize the migration at the end and report any manual follow-up still",
+				"  required."
+			]
 		}
 	]
 });

package/dist/global/staged.js

@@ -1,6 +1,6 @@
 import { i as __toESM, r as __require, t as __commonJSMin } from "./chunk-CgnkrU7a.js";
 import { t as lib_default } from "./lib-DxappLRQ.js";
-import { r as log, t as renderCliDoc } from "./help-BAGHa8fD.js";
+import { i as log, r as errorMsg, t as renderCliDoc } from "./help-CbTzUdXc.js";
 import path, { delimiter, dirname, normalize, resolve } from "node:path";
 import { formatWithOptions, inspect, promisify } from "node:util";
 import { cwd } from "node:process";
@@ -8157,6 +8157,7 @@ if (args.help) {
 	const helpMessage = renderCliDoc({
 		usage: "vp staged [options]",
 		summary: "Run linters on staged files using staged config from vite.config.ts.",
+		documentationUrl: "https://viteplus.dev/guide/commit-hooks",
 		sections: [{
 			title: "Options",
 			rows: [
@@ -8251,7 +8252,8 @@ if (args.help) {
 	}
 	if (stagedConfig) options.config = stagedConfig;
 	else {
-		log("No \"staged\" config found in vite.config.ts. Please add a staged config:");
+		log(vitePlusHeader() + "\n");
+		errorMsg("No \"staged\" config found in vite.config.ts. Please add a staged config:");
 		log("");
 		log("  // vite.config.ts");
 		log("  export default defineConfig({");

package/dist/global/version.js

@@ -1,6 +1,6 @@
 import { s as VITE_PLUS_NAME } from "./json-BRdVJ52a.js";
 import { r as hasVitePlusDependency, t as detectPackageMetadata } from "./package-YAMvX5PJ.js";
-import { n as accent, r as log, t as renderCliDoc } from "./help-BAGHa8fD.js";
+import { i as log, n as accent, t as renderCliDoc } from "./help-CbTzUdXc.js";
 import path from "node:path";
 import fs from "node:fs";
 import { vitePlusHeader } from "../../binding/index.js";

package/dist/global/{workspace-pvS7F6d2.js → workspace-ktWMiLVj.js}

@@ -1,5 +1,5 @@
 import { i as __toESM, t as __commonJSMin } from "./chunk-CgnkrU7a.js";
-import { A as select, E as log, N as Ct, S as PackageManager, b as runCommandSilently, g as displayRelative, u as getSpinner, v as rulesDir } from "./agent-CpNB3GIY.js";
+import { F as Ct, M as select, O as log, S as runCommandSilently, b as rulesDir, f as getSpinner, v as displayRelative, w as PackageManager } from "./agent-D0WD4q4_.js";
 import { _ as YAMLMap, g as YAMLSeq, i as parseDocument, n as parse, y as Scalar } from "./browser-CBapUTD0.js";
 import { a as BASEURL_TSCONFIG_WARNING, c as VITE_PLUS_OVERRIDE_PACKAGES, i as writeJsonFile, l as VITE_PLUS_VERSION, n as isJsonFile, r as readJsonFile, s as VITE_PLUS_NAME, t as editJsonFile } from "./json-BRdVJ52a.js";
 import { n as getScopeFromPackageName, t as detectPackageMetadata } from "./package-YAMvX5PJ.js";
@@ -1912,7 +1912,6 @@ function rewriteStandaloneProject(projectPath, workspaceInfo, skipStagedMigratio
 	if (!skipStagedMigration) rewriteLintStagedConfigFile(projectPath, report);
 	mergeViteConfigFiles(projectPath, silent, report);
 	injectLintTypeCheckDefaults(projectPath, silent, report);
-	injectFmtDefaults(projectPath, silent, report);
 	mergeTsdownConfigFile(projectPath, silent, report);
 	rewriteAllImports(projectPath, silent, report);
 	setPackageManager(projectPath, workspaceInfo.downloadPackageManager);
@@ -1929,7 +1928,6 @@ function rewriteMonorepo(workspaceInfo, skipStagedMigration, silent = false, rep
 	if (!skipStagedMigration) rewriteLintStagedConfigFile(workspaceInfo.rootDir, report);
 	mergeViteConfigFiles(workspaceInfo.rootDir, silent, report);
 	injectLintTypeCheckDefaults(workspaceInfo.rootDir, silent, report);
-	injectFmtDefaults(workspaceInfo.rootDir, silent, report);
 	mergeTsdownConfigFile(workspaceInfo.rootDir, silent, report);
 	rewriteAllImports(workspaceInfo.rootDir, silent, report);
 	setPackageManager(workspaceInfo.rootDir, workspaceInfo.downloadPackageManager);
@@ -2227,14 +2225,6 @@ function injectLintTypeCheckDefaults(projectPath, silent = false, report) {
 		typeCheck: true
 	} }), silent, report);
 }
-/**
-* Inject an empty `fmt: {}` field into vite.config.ts if it doesn't already exist.
-* This is needed because oxfmt auto-discovers vite.config.ts and errors if
-* the `fmt` field is missing.
-*/
-function injectFmtDefaults(projectPath, silent = false, report) {
-	injectConfigDefaults(projectPath, "fmt", ".vite-plus-fmt-init.oxfmtrc.json", "{}", silent, report);
-}
 function injectConfigDefaults(projectPath, configKey, tempFileName, tempFileContent, silent, report) {
 	const configs = detectConfigs(projectPath);
 	if (configs.viteConfig) {
@@ -2619,7 +2609,7 @@ const VSCODE_SETTINGS = {
 	"editor.formatOnSaveMode": "file",
 	"editor.codeActionsOnSave": { "source.fixAll.oxc": "explicit" }
 };
-const VSCODE_EXTENSIONS = { recommendations: ["oxc.oxc-vscode"] };
+const VSCODE_EXTENSIONS = { recommendations: ["VoidZero.vite-plus-extension-pack"] };
 const EDITORS = [{
 	id: "vscode",
 	label: "VSCode",

package/dist/init-config.js

@@ -98,26 +98,6 @@ function hasConfigKey(viteConfigPath, configKey) {
     const viteConfig = fs.readFileSync(viteConfigPath, 'utf8');
     return new RegExp(`\\b${configKey}\\s*:`).test(viteConfig);
 }
-/**
- * Ensure `fmt: {}` exists in vite.config.ts so oxfmt auto-discovery doesn't
- * error when the config file lacks a `fmt` field.
- */
-function injectFmtDefaultsIfMissing(viteConfigPath) {
-    if (hasConfigKey(viteConfigPath, 'fmt')) {
-        return;
-    }
-    const tempConfigPath = `${viteConfigPath}.fmt-init.json`;
-    fs.writeFileSync(tempConfigPath, '{}');
-    try {
-        const result = mergeJsonConfig(viteConfigPath, tempConfigPath, 'fmt');
-        if (result.updated) {
-            fs.writeFileSync(viteConfigPath, result.content);
-        }
-    }
-    finally {
-        fs.rmSync(tempConfigPath, { force: true });
-    }
-}
 async function vpFmt(cwd, filePath) {
     const { binPath, envs } = await resolveFmt();
     const result = await runCommandSilently({
@@ -130,7 +110,7 @@ async function vpFmt(cwd, filePath) {
         },
     });
     if (result.exitCode !== 0) {
-        throw new Error(`Failed to format ${filePath} with vp fmt:\n${result.stdout.toString()}${result.stderr.toString()}`);
+        warnMsg(`Failed to format ${filePath} with vp fmt:\n${result.stdout.toString()}${result.stderr.toString()}`);
     }
 }
 function resolveInitSpec(command, args) {
@@ -206,7 +186,6 @@ export async function applyToolInitConfigToViteConfig(command, args, projectPath
         if (generatedConfigPath) {
             fs.rmSync(generatedConfigPath, { force: true });
         }
-        injectFmtDefaultsIfMissing(viteConfigPath);
         await vpFmt(projectPath, path.relative(projectPath, viteConfigPath));
         return {
             handled: true,
@@ -229,7 +208,6 @@ export async function applyToolInitConfigToViteConfig(command, args, projectPath
     }
     fs.writeFileSync(viteConfigPath, mergeResult.content);
     fs.rmSync(generatedConfigPath, { force: true });
-    injectFmtDefaultsIfMissing(viteConfigPath);
     await vpFmt(projectPath, path.relative(projectPath, viteConfigPath));
     return {
         handled: true,

package/dist/pack-bin.js

@@ -57,6 +57,7 @@ cli
     .option('--public-dir <dir>', 'Alias for --copy, deprecated')
     .option('--tsconfig <tsconfig>', 'Set tsconfig path')
     .option('--unbundle', 'Unbundle mode')
+    .option('--root <dir>', 'Root directory of input files')
     .option('--exe', 'Bundle as executable')
     .option('-W, --workspace [dir]', 'Enable workspace mode')
     .option('-F, --filter <pattern>', 'Filter configs (cwd or name), e.g. /pkg-name$/ or pkg-name')

package/dist/run-config.d.ts

@@ -1,10 +1,8 @@
 export type Task = {
     /**
      * The command to run for the task.
-     *
-     * If omitted, the script from `package.json` with the same name will be used
      */
-    command?: string;
+    command: string;
     /**
      * The working directory for the task, relative to the package root (not workspace root).
      */
@@ -21,11 +19,11 @@ export type Task = {
     /**
      * Environment variable names to be fingerprinted and passed to the task.
      */
-    envs?: Array<string>;
+    env?: Array<string>;
     /**
      * Environment variable names to be passed to the task without fingerprinting.
      */
-    passThroughEnvs?: Array<string>;
+    untrackedEnv?: Array<string>;
     /**
      * Files to include in the cache fingerprint.
      *
@@ -37,7 +35,7 @@ export type Task = {
      *
      * Patterns are relative to the package directory.
      */
-    inputs?: Array<string | {
+    input?: Array<string | {
         /**
          * Automatically track which files the task reads
          */
@@ -84,4 +82,15 @@ export type RunConfig = {
     tasks?: {
         [key in string]?: Task;
     };
+    /**
+     * Whether to automatically run `preX`/`postX` package.json scripts as
+     * lifecycle hooks when script `X` is executed.
+     *
+     * When `true` (the default), running script `test` will automatically
+     * run `pretest` before and `posttest` after, if they exist.
+     *
+     * This option can only be set in the workspace root's config file.
+     * Setting it in a package's config will result in an error.
+     */
+    enablePrePostScripts?: boolean;
 };

package/dist/staged/bin.js

@@ -13,7 +13,7 @@ import mri from 'mri';
 import { vitePlusHeader } from '../../binding/index.js';
 import { resolveViteConfig } from '../resolve-vite-config.js';
 import { renderCliDoc } from '../utils/help.js';
-import { log } from '../utils/terminal.js';
+import { errorMsg, log } from '../utils/terminal.js';
 const args = mri(process.argv.slice(3), {
     alias: {
         h: 'help',
@@ -43,6 +43,7 @@ if (args.help) {
     const helpMessage = renderCliDoc({
         usage: 'vp staged [options]',
         summary: 'Run linters on staged files using staged config from vite.config.ts.',
+        documentationUrl: 'https://viteplus.dev/guide/commit-hooks',
         sections: [
             {
                 title: 'Options',
@@ -147,7 +148,8 @@ else {
         options.config = stagedConfig;
     }
     else {
-        log('No "staged" config found in vite.config.ts. Please add a staged config:');
+        log(vitePlusHeader() + '\n');
+        errorMsg('No "staged" config found in vite.config.ts. Please add a staged config:');
         log('');
         log('  // vite.config.ts');
         log('  export default defineConfig({');

package/dist/utils/agent.d.ts

@@ -63,6 +63,7 @@ export declare function selectAgentTargetPath({ interactive, agent, onCancel, }:
 }): Promise<string | undefined>;
 export declare function detectExistingAgentTargetPaths(projectRoot: string): string[] | undefined;
 export declare function detectExistingAgentTargetPath(projectRoot: string): string | undefined;
+export declare function hasExistingAgentInstructions(projectRoot: string): boolean;
 export declare function resolveAgentTargetPaths(agent?: string | string[]): string[];
 export declare function resolveAgentTargetPath(agent?: string): string;
 export interface AgentConflictInfo {

package/dist/utils/agent.js

@@ -203,6 +203,19 @@ export function detectExistingAgentTargetPaths(projectRoot) {
 export function detectExistingAgentTargetPath(projectRoot) {
     return detectExistingAgentTargetPaths(projectRoot)?.[0];
 }
+export function hasExistingAgentInstructions(projectRoot) {
+    const targetPaths = detectExistingAgentTargetPaths(projectRoot);
+    if (!targetPaths) {
+        return false;
+    }
+    for (const targetPath of targetPaths) {
+        const content = fs.readFileSync(path.join(projectRoot, targetPath), 'utf-8');
+        if (content.includes(AGENT_INSTRUCTIONS_START_MARKER)) {
+            return true;
+        }
+    }
+    return false;
+}
 export function resolveAgentTargetPaths(agent) {
     const agentNames = parseAgentNames(agent);
     const resolvedAgentNames = agentNames.length > 0 ? agentNames : ['other'];

package/dist/utils/editor.js

@@ -14,7 +14,7 @@ const VSCODE_SETTINGS = {
     },
 };
 const VSCODE_EXTENSIONS = {
-    recommendations: ['oxc.oxc-vscode'],
+    recommendations: ['VoidZero.vite-plus-extension-pack'],
 };
 export const EDITORS = [
     {

package/dist/utils/help.d.ts

@@ -2,6 +2,7 @@ export type CliDoc = {
     usage?: string;
     summary?: readonly string[] | string;
     sections: readonly CliSection[];
+    documentationUrl?: string;
 };
 export type CliSection = {
     title: string;

package/dist/utils/help.js

@@ -33,7 +33,12 @@ function renderRows(rows) {
     return output;
 }
 function heading(label, color) {
-    return color ? styleText('bold', `${label}:`) : `${label}:`;
+    if (!color) {
+        return `${label}:`;
+    }
+    return label === 'Usage'
+        ? styleText('bold', `${label}:`)
+        : styleText(['blue', 'bold'], `${label}:`);
 }
 export function renderCliDoc(doc, options = {}) {
     const color = options.color ?? true;
@@ -62,6 +67,12 @@ export function renderCliDoc(doc, options = {}) {
             output.push(...renderRows(section.rows));
         }
     }
+    if (doc.documentationUrl) {
+        if (output.length > 0) {
+            output.push('');
+        }
+        output.push(`${heading('Documentation', color)} ${doc.documentationUrl}`);
+    }
     output.push('');
     return output.join('\n');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plus",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "license": "MIT",
   "bin": {
     "oxfmt": "./bin/oxfmt",
@@ -297,12 +297,12 @@
     "@oxc-project/types": "=0.115.0",
     "cac": "^6.7.14",
     "cross-spawn": "^7.0.5",
-    "oxfmt": "^0.38.0",
-    "oxlint": "^1.53.0",
-    "oxlint-tsgolint": "^0.16.0",
+    "oxfmt": "=0.40.0",
+    "oxlint": "=1.55.0",
+    "oxlint-tsgolint": "=0.16.0",
     "picocolors": "^1.1.1",
-    "@voidzero-dev/vite-plus-test": "0.1.7",
-    "@voidzero-dev/vite-plus-core": "0.1.7"
+    "@voidzero-dev/vite-plus-core": "0.1.9",
+    "@voidzero-dev/vite-plus-test": "0.1.9"
   },
   "devDependencies": {
     "@napi-rs/cli": "^3.4.1",
@@ -320,12 +320,12 @@
     "mri": "^1.2.0",
     "rolldown-plugin-dts": "^0.22.0",
     "semver": "^7.7.3",
-    "tsdown": "^0.21.1",
+    "tsdown": "^0.21.2",
     "validate-npm-package-name": "^7.0.2",
     "yaml": "^2.8.1",
-    "@voidzero-dev/vite-plus-prompts": "0.0.0",
-    "rolldown": "1.0.0-rc.8",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.1.7"
+    "rolldown": "1.0.0-rc.9",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.1.9",
+    "@voidzero-dev/vite-plus-prompts": "0.0.0"
   },
   "napi": {
     "binaryName": "vite-plus",
@@ -343,12 +343,12 @@
     "node": "^20.19.0 || >=22.12.0"
   },
   "optionalDependencies": {
-    "@voidzero-dev/vite-plus-darwin-arm64": "0.1.7",
-    "@voidzero-dev/vite-plus-darwin-x64": "0.1.7",
-    "@voidzero-dev/vite-plus-linux-arm64-gnu": "0.1.7",
-    "@voidzero-dev/vite-plus-linux-x64-gnu": "0.1.7",
-    "@voidzero-dev/vite-plus-win32-x64-msvc": "0.1.7",
-    "@voidzero-dev/vite-plus-win32-arm64-msvc": "0.1.7"
+    "@voidzero-dev/vite-plus-darwin-arm64": "0.1.9",
+    "@voidzero-dev/vite-plus-darwin-x64": "0.1.9",
+    "@voidzero-dev/vite-plus-linux-arm64-gnu": "0.1.9",
+    "@voidzero-dev/vite-plus-linux-x64-gnu": "0.1.9",
+    "@voidzero-dev/vite-plus-win32-x64-msvc": "0.1.9",
+    "@voidzero-dev/vite-plus-win32-arm64-msvc": "0.1.9"
   },
   "scripts": {
     "build": "oxnode -C dev ./build.ts",