unplugin-devpilot 0.0.2 → 0.0.4

package/README.md

@@ -0,0 +1,105 @@
+# unplugin-devpilot
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Unit Test][unit-test-src]][unit-test-href]
+
+## Installation
+
+```bash
+npm i -D unplugin-devpilot
+```
+
+<details>
+<summary>Vite</summary><br>
+
+```ts
+// vite.config.ts
+import Devpilot from 'unplugin-devpilot/vite';
+
+export default defineConfig({
+  plugins: [Devpilot()],
+});
+```
+
+<br></details>
+
+<details>
+<summary>Webpack</summary><br>
+
+```js
+// webpack.config.js
+import Devpilot from 'unplugin-devpilot/webpack';
+
+export default {
+  /* ... */
+  plugins: [Devpilot()],
+};
+```
+
+<br></details>
+
+<details>
+<summary>Rspack</summary><br>
+
+```ts
+// rspack.config.js
+import Devpilot from 'unplugin-devpilot/rspack';
+
+export default {
+  /* ... */
+  plugins: [Devpilot()],
+};
+```
+
+<br></details>
+
+## Client Import
+
+Add this import to your project entry point to enable the devpilot client:
+
+```ts
+// main.ts or main.js (entry point)
+import 'virtual:devpilot-client';
+```
+
+This import activates the WebSocket connection to the development server and initializes all registered plugins on the client side.
+
+## Configuration
+
+You can customize the plugin behavior by passing options:
+
+```ts
+// vite.config.ts
+import Devpilot from 'unplugin-devpilot/vite';
+
+export default defineConfig({
+  plugins: [
+    Devpilot({
+      wsPort: 3100, // Optional: Specify WebSocket port (will be randomly allocated if not specified)
+      mcpPort: 3101, // Optional: Specify MCP server port (will use random port if specified port is occupied)
+      plugins: [], // Optional: Array of DevpilotPlugin instances
+    }),
+  ],
+});
+```
+
+### Port Allocation Strategy
+
+- **wsPort**: When provided, the specified port is used if available; otherwise, a random available port is allocated. When not provided, a random available port is automatically allocated
+- **mcpPort**: When not provided, defaults to 3101. If the port is already in use, an error will be thrown
+
+This ensures your MCP server runs on a predictable port. If the default port is occupied, you'll need to specify a different port or free up the occupied port.
+
+## License
+
+[MIT](./LICENSE) License © 2025-PRESENT [Huali](https://github.com/zcf0508)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/unplugin-devpilot.svg
+[npm-version-href]: https://npmjs.com/package/unplugin-devpilot
+[npm-downloads-src]: https://img.shields.io/npm/dm/unplugin-devpilot
+[npm-downloads-href]: https://www.npmcharts.com/compare/unplugin-devpilot?interval=30
+[unit-test-src]: https://github.com/zcf0508/unplugin-devpilot/actions/workflows/unit-test.yml/badge.svg
+[unit-test-href]: https://github.com/zcf0508/unplugin-devpilot/actions/workflows/unit-test.yml

package/dist/farm.d.mts

@@ -1,4 +1,4 @@
-import { t as unpluginDevpilot } from "./index-CQudsm6j.mjs";
+import { t as unpluginDevpilot } from "./index-WH3owjvn.mjs";
 
 //#region src/farm.d.ts
 /**

package/dist/farm.mjs

@@ -1,4 +1,4 @@
-import { n as unpluginDevpilot } from "./src-D62s1VAN.mjs";
+import { n as unpluginDevpilot } from "./src-AEXLBOF9.mjs";
 
 //#region src/farm.ts
 /**

package/dist/{index-9V3dRAxA.d.mts → index-Csy16I0Z.d.mts}

@@ -1,3 +1,18 @@
+//#region src/core/utils.d.ts
+/**
+* Resolve the module path relative to the plugin to an absolute path
+* Handles cross-platform paths (Windows, macOS, Linux) and proper escaping for imports
+* @param importMetaUrl - Pass in import.meta.url
+* @param relativePath - Path relative to the plugin
+* @example
+* ```ts
+* import { resolveModule } from 'unplugin-devpilot/core/utils'
+*
+* const skillPath = resolveModule(import.meta.url, './skill.md')
+* ```
+*/
+declare function resolveModule(importMetaUrl: string, relativePath: string): string;
+//#endregion
 //#region ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v3/helpers/typeAliases.d.cts
 type Primitive$2 = string | number | symbol | bigint | boolean | null | undefined;
 //#endregion
@@ -4128,4 +4143,4 @@ interface DevpilotPluginContext {
 */
 declare function resolveClientModule(importMetaUrl: string, relativePath: string): string;
 //#endregion
-export { defineMcpToolRegister as i, resolveClientModule as n, McpToolRegister as r, DevpilotPluginContext as t };
+export { resolveModule as a, defineMcpToolRegister as i, resolveClientModule as n, McpToolRegister as r, DevpilotPluginContext as t };

package/dist/{index-CQudsm6j.d.mts → index-WH3owjvn.d.mts}

@@ -1,4 +1,4 @@
-import { r as McpToolRegister, t as DevpilotPluginContext } from "./index-9V3dRAxA.mjs";
+import { r as McpToolRegister, t as DevpilotPluginContext } from "./index-Csy16I0Z.mjs";
 import { UnpluginInstance } from "unplugin";
 import { WebSocket } from "ws";
 
@@ -25,11 +25,40 @@ interface DevpilotPlugin {
   */
   serverSetup?: (ctx: DevpilotPluginContext) => Record<string, (...args: any[]) => any>;
   mcpSetup?: (ctx: DevpilotPluginContext) => Array<McpToolRegister>;
+  /**
+  * The skill module path to be injected
+  * - npm package path: 'my-plugin/skill'
+  * - absolute path: '/path/to/skill.md'
+  *
+  * Note: relative paths need to be resolved to absolute paths first
+  * @example
+  * ```ts
+  * import { resolveSkillModule } from 'unplugin-devpilot'
+  *
+  * skillModule: resolveSkillModule(import.meta.url, './skill.md')
+  * ```
+  */
+  skillModule?: string | ((ctx: DevpilotPluginContext) => string);
 }
 interface Options {
   wsPort?: number;
   mcpPort?: number;
   plugins?: DevpilotPlugin[];
+  /**
+  * The path to generate the core skill file
+  * - directory path: './src/skills/devpilot' (will generate SKILL.md in this directory)
+  * - file path: './src/skills/devpilot/SKILL.md' (will generate the specified file)
+  *
+  * If not specified, no core skill file will be generated
+  * @example
+  * ```ts
+  * Devpilot({
+  *   skillCorePath: './src/skills/devpilot',
+  *   plugins: [],
+  * })
+  * ```
+  */
+  skillCorePath?: string;
 }
 //#endregion
 //#region ../../node_modules/.pnpm/birpc@4.0.0/node_modules/birpc/dist/index.d.mts
@@ -222,7 +251,27 @@ declare class ClientManager {
 }
 declare const clientManager: ClientManager;
 //#endregion
+//#region src/core/skill-generator.d.ts
+/**
+* Resolve the skill module path relative to the plugin to an absolute path
+* Handles cross-platform paths (Windows, macOS, Linux) and proper escaping for imports
+* @param importMetaUrl - Pass in import.meta.url
+* @param relativePath - Path relative to the plugin
+* @example
+* ```ts
+* import { resolveSkillModule } from 'unplugin-devpilot'
+*
+* export function myPlugin(): DevpilotPlugin {
+*   return {
+*     namespace: 'my-plugin',
+*     skillModule: resolveSkillModule(import.meta.url, './skill.md'),
+*   }
+* }
+* ```
+*/
+declare function resolveSkillModule(importMetaUrl: string, relativePath: string): string;
+//#endregion
 //#region src/index.d.ts
 declare const unpluginDevpilot: UnpluginInstance<Options | undefined, false>;
 //#endregion
-export { ClientDiscoveryFilter as a, PendingTask as c, ServerFunctions as d, TaskHistory as f, BaseServerFunctions as i, PluginClientFunctions as l, Options as m, clientManager as n, ClientFunctions as o, DevpilotPlugin as p, BaseClientFunctions as r, ClientInfo as s, unpluginDevpilot as t, PluginServerFunctions as u };
+export { BaseServerFunctions as a, ClientInfo as c, PluginServerFunctions as d, ServerFunctions as f, Options as h, BaseClientFunctions as i, PendingTask as l, DevpilotPlugin as m, resolveSkillModule as n, ClientDiscoveryFilter as o, TaskHistory as p, clientManager as r, ClientFunctions as s, unpluginDevpilot as t, PluginClientFunctions as u };

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-import { i as defineMcpToolRegister, n as resolveClientModule, t as DevpilotPluginContext } from "./index-9V3dRAxA.mjs";
-import { a as ClientDiscoveryFilter, c as PendingTask, d as ServerFunctions, f as TaskHistory, i as BaseServerFunctions, l as PluginClientFunctions, m as Options, n as clientManager, o as ClientFunctions, p as DevpilotPlugin, r as BaseClientFunctions, s as ClientInfo, t as unpluginDevpilot, u as PluginServerFunctions } from "./index-CQudsm6j.mjs";
-export { BaseClientFunctions, BaseServerFunctions, ClientDiscoveryFilter, ClientFunctions, ClientInfo, DevpilotPlugin, DevpilotPluginContext, Options, PendingTask, PluginClientFunctions, PluginServerFunctions, ServerFunctions, TaskHistory, clientManager, unpluginDevpilot as default, unpluginDevpilot, defineMcpToolRegister, resolveClientModule };
+import { a as resolveModule, i as defineMcpToolRegister, n as resolveClientModule, t as DevpilotPluginContext } from "./index-Csy16I0Z.mjs";
+import { a as BaseServerFunctions, c as ClientInfo, d as PluginServerFunctions, f as ServerFunctions, h as Options, i as BaseClientFunctions, l as PendingTask, m as DevpilotPlugin, n as resolveSkillModule, o as ClientDiscoveryFilter, p as TaskHistory, r as clientManager, s as ClientFunctions, t as unpluginDevpilot, u as PluginClientFunctions } from "./index-WH3owjvn.mjs";
+export { BaseClientFunctions, BaseServerFunctions, ClientDiscoveryFilter, ClientFunctions, ClientInfo, DevpilotPlugin, DevpilotPluginContext, Options, PendingTask, PluginClientFunctions, PluginServerFunctions, ServerFunctions, TaskHistory, clientManager, unpluginDevpilot as default, unpluginDevpilot, defineMcpToolRegister, resolveClientModule, resolveModule, resolveSkillModule };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { n as unpluginDevpilot, r as clientManager, t as src_default } from "./src-D62s1VAN.mjs";
-import { n as defineMcpToolRegister, t as resolveClientModule } from "./plugin-BPkoZQbf.mjs";
+import { i as clientManager, n as unpluginDevpilot, r as resolveSkillModule, t as src_default } from "./src-AEXLBOF9.mjs";
+import { n as defineMcpToolRegister, r as resolveModule, t as resolveClientModule } from "./plugin-B1Afr0m3.mjs";
 
-export { clientManager, src_default as default, defineMcpToolRegister, resolveClientModule, unpluginDevpilot };
+export { clientManager, src_default as default, defineMcpToolRegister, resolveClientModule, resolveModule, resolveSkillModule, unpluginDevpilot };

package/dist/{plugin-BPkoZQbf.mjs → plugin-B1Afr0m3.mjs}

@@ -1,6 +1,24 @@
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
+//#region src/core/utils.ts
+/**
+* Resolve the module path relative to the plugin to an absolute path
+* Handles cross-platform paths (Windows, macOS, Linux) and proper escaping for imports
+* @param importMetaUrl - Pass in import.meta.url
+* @param relativePath - Path relative to the plugin
+* @example
+* ```ts
+* import { resolveModule } from 'unplugin-devpilot/core/utils'
+*
+* const skillPath = resolveModule(import.meta.url, './skill.md')
+* ```
+*/
+function resolveModule(importMetaUrl, relativePath) {
+	return pathToFileURL(join(dirname(fileURLToPath(importMetaUrl)), relativePath)).href;
+}
+
+//#endregion
 //#region src/core/plugin/mcp.ts
 function defineMcpToolRegister(name, config, cb) {
 	return () => ({
@@ -30,8 +48,8 @@ function defineMcpToolRegister(name, config, cb) {
 * ```
 */
 function resolveClientModule(importMetaUrl, relativePath) {
-	return pathToFileURL(join(dirname(fileURLToPath(importMetaUrl)), relativePath)).href;
+	return resolveModule(importMetaUrl, relativePath);
 }
 
 //#endregion
-export { defineMcpToolRegister as n, resolveClientModule as t };
+export { defineMcpToolRegister as n, resolveModule as r, resolveClientModule as t };

package/dist/plugin.d.mts

@@ -1,2 +1,2 @@
-import { i as defineMcpToolRegister, n as resolveClientModule, r as McpToolRegister, t as DevpilotPluginContext } from "./index-9V3dRAxA.mjs";
-export { DevpilotPluginContext, McpToolRegister as McpServerRegister, defineMcpToolRegister, resolveClientModule };
+import { a as resolveModule, i as defineMcpToolRegister, n as resolveClientModule, r as McpToolRegister, t as DevpilotPluginContext } from "./index-Csy16I0Z.mjs";
+export { DevpilotPluginContext, McpToolRegister as McpServerRegister, defineMcpToolRegister, resolveClientModule, resolveModule };

package/dist/plugin.mjs

@@ -1,3 +1,3 @@
-import { n as defineMcpToolRegister, t as resolveClientModule } from "./plugin-BPkoZQbf.mjs";
+import { n as defineMcpToolRegister, r as resolveModule, t as resolveClientModule } from "./plugin-B1Afr0m3.mjs";
 
-export { defineMcpToolRegister, resolveClientModule };
+export { defineMcpToolRegister, resolveClientModule, resolveModule };

package/dist/rspack.d.mts

@@ -1,4 +1,4 @@
-import { t as unpluginDevpilot } from "./index-CQudsm6j.mjs";
+import { t as unpluginDevpilot } from "./index-WH3owjvn.mjs";
 
 //#region src/rspack.d.ts
 /**

package/dist/rspack.mjs

@@ -1,4 +1,4 @@
-import { n as unpluginDevpilot } from "./src-D62s1VAN.mjs";
+import { n as unpluginDevpilot } from "./src-AEXLBOF9.mjs";
 
 //#region src/rspack.ts
 /**

package/dist/{src-D62s1VAN.mjs → src-AEXLBOF9.mjs}

@@ -1,3 +1,4 @@
+import { r as resolveModule } from "./plugin-B1Afr0m3.mjs";
 import { createRequire } from "node:module";
 import process$1 from "node:process";
 import { createUnplugin } from "unplugin";
@@ -5,6 +6,11 @@ import { createServer } from "node:http";
 import { Http2ServerRequest } from "http2";
 import { Readable } from "stream";
 import crypto$1 from "crypto";
+import { createServer as createServer$1 } from "node:net";
+import { networkInterfaces } from "node:os";
+import { dirname, extname, join } from "node:path";
+import { promises } from "node:fs";
+import { fileURLToPath } from "node:url";
 
 //#region rolldown:runtime
 var __create = Object.create;
@@ -19793,7 +19799,7 @@ var StreamableHTTPServerTransport = class {
 
 //#endregion
 //#region package.json
-var version = "0.0.2";
+var version = "0.0.4";
 
 //#endregion
 //#region ../../node_modules/.pnpm/es-toolkit@1.44.0/node_modules/es-toolkit/dist/compat/util/uniqueId.mjs
@@ -20190,21 +20196,314 @@ async function startMcpServer(port) {
 	});
 }
 function stopMcpServer() {
-	if (httpServer) {
-		httpServer.close();
-		httpServer = null;
+	return new Promise((resolve) => {
+		if (httpServer) {
+			const server = httpServer;
+			httpServer = null;
+			server.close(() => resolve());
+		} else resolve();
+	});
+}
+
+//#endregion
+//#region ../../node_modules/.pnpm/get-port-please@3.2.0/node_modules/get-port-please/dist/index.mjs
+const unsafePorts = /* @__PURE__ */ new Set([
+	1,
+	7,
+	9,
+	11,
+	13,
+	15,
+	17,
+	19,
+	20,
+	21,
+	22,
+	23,
+	25,
+	37,
+	42,
+	43,
+	53,
+	69,
+	77,
+	79,
+	87,
+	95,
+	101,
+	102,
+	103,
+	104,
+	109,
+	110,
+	111,
+	113,
+	115,
+	117,
+	119,
+	123,
+	135,
+	137,
+	139,
+	143,
+	161,
+	179,
+	389,
+	427,
+	465,
+	512,
+	513,
+	514,
+	515,
+	526,
+	530,
+	531,
+	532,
+	540,
+	548,
+	554,
+	556,
+	563,
+	587,
+	601,
+	636,
+	989,
+	990,
+	993,
+	995,
+	1719,
+	1720,
+	1723,
+	2049,
+	3659,
+	4045,
+	5060,
+	5061,
+	6e3,
+	6566,
+	6665,
+	6666,
+	6667,
+	6668,
+	6669,
+	6697,
+	10080
+]);
+function isUnsafePort(port) {
+	return unsafePorts.has(port);
+}
+function isSafePort(port) {
+	return !isUnsafePort(port);
+}
+var GetPortError = class extends Error {
+	constructor(message, opts) {
+		super(message, opts);
+		this.message = message;
 	}
+	name = "GetPortError";
+};
+function _log(verbose, message) {
+	if (verbose) console.log(`[get-port] ${message}`);
+}
+function _tryPort(port, host) {
+	return new Promise((resolve) => {
+		const server = createServer$1();
+		server.unref();
+		server.on("error", () => {
+			resolve(false);
+		});
+		server.listen({
+			port,
+			host
+		}, () => {
+			const { port: port2 } = server.address();
+			server.close(() => {
+				resolve(isSafePort(port2) && port2);
+			});
+		});
+	});
+}
+function _getLocalHosts(additional) {
+	const hosts = new Set(additional);
+	for (const _interface of Object.values(networkInterfaces())) for (const config of _interface || []) if (config.address && !config.internal && !config.address.startsWith("fe80::") && !config.address.startsWith("169.254")) hosts.add(config.address);
+	return [...hosts];
+}
+function _fmtOnHost(hostname) {
+	return hostname ? `on host ${JSON.stringify(hostname)}` : "on any host";
+}
+async function getRandomPort(host) {
+	const port = await checkPort(0, host);
+	if (port === false) throw new GetPortError(`Unable to find a random port ${_fmtOnHost(host)}`);
+	return port;
+}
+async function checkPort(port, host = process.env.HOST, verbose) {
+	if (!host) host = _getLocalHosts([void 0, "0.0.0.0"]);
+	if (!Array.isArray(host)) return _tryPort(port, host);
+	for (const _host of host) {
+		const _port = await _tryPort(port, _host);
+		if (_port === false) {
+			if (port < 1024 && verbose) _log(verbose, `Unable to listen to the privileged port ${port} ${_fmtOnHost(_host)}`);
+			return false;
+		}
+		if (port === 0 && _port !== 0) port = _port;
+	}
+	return port;
 }
 
 //#endregion
 //#region src/core/options.ts
-function resolveOptions(options) {
+let lastResolvedWsPort;
+let lastResolvedMcpPort;
+async function resolveOptions(options) {
+	const wsPort = await resolveWsPort(options.wsPort);
+	const mcpPort = await resolveMcpPort(options.mcpPort);
+	lastResolvedWsPort = wsPort;
+	lastResolvedMcpPort = mcpPort;
 	return {
-		wsPort: options.wsPort || 3100,
-		mcpPort: options.mcpPort || 3101,
-		plugins: options.plugins || []
+		wsPort,
+		mcpPort,
+		plugins: options.plugins || [],
+		skillCorePath: options.skillCorePath
 	};
 }
+async function resolveWsPort(preferred) {
+	const candidate = preferred ?? lastResolvedWsPort;
+	if (candidate !== void 0) {
+		if (await checkPort(candidate) !== false) return candidate;
+		if (candidate === lastResolvedWsPort) return candidate;
+	}
+	if (lastResolvedWsPort !== void 0) return lastResolvedWsPort;
+	return getRandomPort();
+}
+async function resolveMcpPort(preferred) {
+	const candidate = preferred || 3101;
+	if (candidate === lastResolvedMcpPort) return candidate;
+	if (await checkPort(candidate) === false) throw new Error(`MCP port ${candidate} is already in use. Please specify a different port or free up the port.`);
+	return candidate;
+}
+
+//#endregion
+//#region src/core/skill-generator.ts
+/**
+* Resolve the skill module path relative to the plugin to an absolute path
+* Handles cross-platform paths (Windows, macOS, Linux) and proper escaping for imports
+* @param importMetaUrl - Pass in import.meta.url
+* @param relativePath - Path relative to the plugin
+* @example
+* ```ts
+* import { resolveSkillModule } from 'unplugin-devpilot'
+*
+* export function myPlugin(): DevpilotPlugin {
+*   return {
+*     namespace: 'my-plugin',
+*     skillModule: resolveSkillModule(import.meta.url, './skill.md'),
+*   }
+* }
+* ```
+*/
+function resolveSkillModule(importMetaUrl, relativePath) {
+	return resolveModule(importMetaUrl, relativePath);
+}
+/**
+* Determine if a path is a directory (no file extension) or a file
+* @param path - The path to check
+* @returns true if the path is a directory, false if it's a file
+*/
+function isDirectoryPath(path) {
+	return extname(path) === "";
+}
+/**
+* Get the core skill file path, handling both directory and file paths
+* @param skillCorePath - The configured skill core path (directory or file)
+* @returns The actual file path to use for the core skill file
+*/
+function getCoreSkillFilePath(skillCorePath) {
+	if (isDirectoryPath(skillCorePath)) return join(skillCorePath, "SKILL.md");
+	return skillCorePath;
+}
+/**
+* Get all plugin skill modules
+*/
+function getPluginSkillModules(plugins, options) {
+	const ctx = { wsPort: options.wsPort };
+	return plugins.filter((p) => p.skillModule).map((p) => {
+		const mod = typeof p.skillModule === "function" ? p.skillModule(ctx) : p.skillModule;
+		let skillPath;
+		if (mod.startsWith("file://")) skillPath = fileURLToPath(mod);
+		else if (mod.startsWith("npm:") || !mod.startsWith(".") && !mod.startsWith("/") && (mod.includes("/") || mod.match(/^[@a-z0-9]\S+$/i))) skillPath = mod;
+		else skillPath = mod;
+		return {
+			namespace: p.namespace,
+			path: skillPath,
+			originalSkillModule: mod
+		};
+	});
+}
+/**
+* Generate the core skill markdown content
+*/
+function generateCoreSkillContent(options, isDev) {
+	if (!isDev) return "";
+	return `# Devpilot Core Skills
+
+This is the core skill file that aggregates all plugin skills.
+
+## Available Skills
+
+${getPluginSkillModules(options.plugins, options).map((skill) => {
+		if (skill.originalSkillModule.startsWith("file://")) {
+			const linkPath = `./${skill.namespace}.md`;
+			return `- [${skill.namespace}](${linkPath}) - ${skill.namespace} capabilities`;
+		} else if (skill.originalSkillModule.startsWith("npm:") || !skill.originalSkillModule.startsWith(".") && !skill.originalSkillModule.startsWith("/") && (skill.originalSkillModule.includes("/") || skill.originalSkillModule.match(/^[@a-z0-9]\S+$/i))) return `- [${skill.namespace}](${skill.originalSkillModule}) - ${skill.namespace} capabilities`;
+		else {
+			const linkPath = `./${skill.namespace}.md`;
+			return `- [${skill.namespace}](${linkPath}) - ${skill.namespace} capabilities`;
+		}
+	}).join("\n") || "No plugin skills configured"}
+
+## Usage
+
+These skills can be used with Claude Agent to interact with web applications.
+
+## Configuration
+
+- **Core Skill Path**: ${options.skillCorePath || "Not configured"}
+- **Plugins**: ${options.plugins.length}
+- **WebSocket Port**: ${options.wsPort}
+- **MCP Port**: ${options.mcpPort}
+`;
+}
+/**
+* Generate and write the core skill file
+*/
+async function generateCoreSkill(options, isDev) {
+	if (!options.skillCorePath) return;
+	const skillFilePath = getCoreSkillFilePath(options.skillCorePath);
+	const content = generateCoreSkillContent(options, isDev);
+	if (!isDev || !content) {
+		try {
+			await promises.unlink(skillFilePath);
+		} catch {}
+		return;
+	}
+	let existingContent;
+	try {
+		existingContent = await promises.readFile(skillFilePath, "utf-8");
+	} catch {}
+	if (existingContent === content) return;
+	const dir = dirname(skillFilePath);
+	await promises.mkdir(dir, { recursive: true });
+	const pluginSkills = getPluginSkillModules(options.plugins, options);
+	for (const skill of pluginSkills) if (skill.originalSkillModule.startsWith("file://")) {
+		const sourcePath = skill.path;
+		const destPath = join(dir, `${skill.namespace}.md`);
+		try {
+			const skillContent = await promises.readFile(sourcePath, "utf-8");
+			await promises.writeFile(destPath, skillContent, "utf-8");
+		} catch {}
+	}
+	await promises.writeFile(skillFilePath, content, "utf-8");
+}
 
 //#endregion
 //#region ../../node_modules/.pnpm/birpc@4.0.0/node_modules/birpc/dist/index.mjs
@@ -23990,10 +24289,13 @@ function startWebSocketServer(port) {
 	return wss;
 }
 function stopWebSocketServer() {
-	if (wss) {
-		wss.close();
-		wss = null;
-	}
+	return new Promise((resolve) => {
+		if (wss) {
+			const server = wss;
+			wss = null;
+			server.close(() => resolve());
+		} else resolve();
+	});
 }
 
 //#endregion
@@ -24024,23 +24326,33 @@ ${handlerCollection}
 });
 `;
 }
-const unpluginDevpilot = createUnplugin((rawOptions = {}) => {
-	const options = resolveOptions(rawOptions);
-	let serversStarted = false;
-	const name = "unplugin-devpilot";
-	async function startServers() {
-		if (serversStarted) return;
+let serversStarted = false;
+let lastOptions = null;
+async function startServers(rawOptions) {
+	const options = await resolveOptions(rawOptions);
+	lastOptions = options;
+	registerPluginServerMethods(options.plugins);
+	registerPluginMcpRegisterMethods(options.plugins);
+	if (!serversStarted) {
 		serversStarted = true;
-		registerPluginServerMethods(options.plugins);
-		registerPluginMcpRegisterMethods(options.plugins);
 		startWebSocketServer(options.wsPort);
 		await startMcpServer(options.mcpPort);
 	}
-	function stopServers() {
-		if (!serversStarted) return;
-		serversStarted = false;
-		stopWebSocketServer();
-		stopMcpServer();
+	await generateCoreSkill(options, process$1.env.NODE_ENV !== "production");
+	return options;
+}
+async function stopServers() {
+	if (!serversStarted) return;
+	serversStarted = false;
+	await Promise.all([stopWebSocketServer(), stopMcpServer()]);
+	if (lastOptions) await generateCoreSkill(lastOptions, false);
+}
+const unpluginDevpilot = createUnplugin((rawOptions = {}) => {
+	let options = null;
+	let isDevServer = false;
+	const name = "unplugin-devpilot";
+	async function ensureServersStarted() {
+		options = await startServers(rawOptions);
 	}
 	return {
 		name,
@@ -24051,38 +24363,53 @@ const unpluginDevpilot = createUnplugin((rawOptions = {}) => {
 		loadInclude(id) {
 			return id === RESOLVED_VIRTUAL_MODULE_ID;
 		},
-		load(id) {
-			if (id === RESOLVED_VIRTUAL_MODULE_ID) return generateVirtualClientModule(options, process$1.env.NODE_ENV !== "production");
+		async load(id) {
+			if (id === RESOLVED_VIRTUAL_MODULE_ID) {
+				if (!options) options = await resolveOptions(rawOptions);
+				return generateVirtualClientModule(options, process$1.env.NODE_ENV !== "production");
+			}
 		},
 		buildStart() {
 			if (process$1.env.NODE_ENV === "production") return;
-			startServers();
+			if (isDevServer) return;
+			return ensureServersStarted();
 		},
 		buildEnd() {
-			stopServers();
+			if (isDevServer) return;
+			return stopServers();
 		},
 		vite: { configureServer() {
-			startServers();
+			isDevServer = true;
+			ensureServersStarted();
 		} },
 		webpack(compiler) {
 			compiler.hooks.watchRun.tapPromise(name, async () => {
-				await startServers();
+				isDevServer = true;
+				await ensureServersStarted();
 			});
-			compiler.hooks.done.tap(name, () => {
-				if (!compiler.options.watch) stopServers();
+			compiler.hooks.shutdown?.tap(name, () => {
+				stopServers();
 			});
 		},
 		rspack(compiler) {
 			compiler.hooks.watchRun.tapPromise(name, async () => {
-				await startServers();
+				isDevServer = true;
+				await ensureServersStarted();
 			});
-			compiler.hooks.done.tap(name, () => {
-				if (!compiler.options.watch) stopServers();
+			compiler.hooks.shutdown?.tap(name, () => {
+				stopServers();
 			});
-		}
+		},
+		farm: { configureDevServer() {
+			isDevServer = true;
+			ensureServersStarted();
+		} }
 	};
 });
+process$1.on("beforeExit", () => {
+	stopServers();
+});
 var src_default = unpluginDevpilot;
 
 //#endregion
-export { unpluginDevpilot as n, clientManager as r, src_default as t };
+export { clientManager as i, unpluginDevpilot as n, resolveSkillModule as r, src_default as t };

package/dist/vite.d.mts

@@ -1,4 +1,4 @@
-import { t as unpluginDevpilot } from "./index-CQudsm6j.mjs";
+import { t as unpluginDevpilot } from "./index-WH3owjvn.mjs";
 
 //#region src/vite.d.ts
 /**

package/dist/vite.mjs

@@ -1,4 +1,4 @@
-import { n as unpluginDevpilot } from "./src-D62s1VAN.mjs";
+import { n as unpluginDevpilot } from "./src-AEXLBOF9.mjs";
 
 //#region src/vite.ts
 /**

package/dist/webpack.d.mts

@@ -1,4 +1,4 @@
-import { t as unpluginDevpilot } from "./index-CQudsm6j.mjs";
+import { t as unpluginDevpilot } from "./index-WH3owjvn.mjs";
 
 //#region src/webpack.d.ts
 /**

package/dist/webpack.mjs

@@ -1,4 +1,4 @@
-import { n as unpluginDevpilot } from "./src-D62s1VAN.mjs";
+import { n as unpluginDevpilot } from "./src-AEXLBOF9.mjs";
 
 //#region src/webpack.ts
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "unplugin-devpilot",
   "type": "module",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Description.",
   "author": "zcf0508 <zcf0508@live.com>",
   "license": "MIT",
@@ -52,6 +52,30 @@
   "engines": {
     "node": ">=20.19.0"
   },
+  "peerDependencies": {
+    "@farmfe/core": ">=1",
+    "@nuxt/kit": "^3",
+    "@nuxt/schema": "^3",
+    "vite": ">=3",
+    "webpack": "^4 || ^5"
+  },
+  "peerDependenciesMeta": {
+    "@farmfe/core": {
+      "optional": true
+    },
+    "@nuxt/kit": {
+      "optional": true
+    },
+    "@nuxt/schema": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "unplugin": "^3.0.0"
   },
@@ -60,6 +84,7 @@
     "@types/ws": "^8.18.1",
     "birpc": "^4.0.0",
     "es-toolkit": "^1.44.0",
+    "get-port-please": "^3.2.0",
     "hookable": "^6.0.1",
     "mitt": "^3.0.1",
     "ws": "^8.19.0",
@@ -69,8 +94,8 @@
     "build": "tsdown",
     "dev": "tsdown --watch",
     "test": "vitest --run",
-    "typecheck:client": "tsc --project tsconfig.client.json --noEmit",
-    "typecheck:node": "tsc --noEmit",
+    "typecheck:client": "tsgo --project tsconfig.client.json --noEmit",
+    "typecheck:node": "tsgo --noEmit",
     "typecheck": "pnpm run typecheck:client && pnpm run typecheck:node"
   }
 }