@mearl/setup 2.20.5 → 2.21.0

package/README.md

@@ -121,6 +121,12 @@ npx @mearl/setup provider uninstall brow
   Ali Skills 安装的插件会同时移除 Skill；手工注册的外部插件只清除注册、保留源码；Provider
   只有在包管理器成功卸载 npm 包后才清除注册。单项失败不阻止其他项继续清理，命令最终返回非零。
   该选项不删除 Chrome 扩展；`extension --full` 仍表示安装扩展及完整本地环境。
+- `uninstall --full` 在所有环境、插件与 Provider 成功移除后统一收尾：停止插件执行服务，
+  确认没有活跃或退出状态未明的任务，再删除任务历史、源码快照、服务日志、AuthX SDK 缓存、
+  旧设计稿缓存和已结束宿主的页面会话文件。只卸载部分环境、单项失败或服务重新启动时保留共享缓存。
+  即使包和注册已移除，也可以再次运行该命令完成缓存收尾。自定义 `MEARL_PLUGIN_DIR` 只清理该注册表的执行缓存。
+  记事本、迭代记录、配置与身份、插件持久状态、Provider 私有数据、浏览器配置及用户导出的设计稿均保留；
+  CDP 标签 ID 计数也保留，防止旧请求命中新标签。
 - `--mcp` 的客户端配置和清理由 `@mearl/mcp-server` 自己的命令完成。
 - 默认的 `install` / `update` 不处理浏览器扩展。`extension` 是独立命令：从
   `https://mearl.alibaba-inc.com/` 识别并下载最新的 `mearl-chrome-v*.zip`，原子解压到

package/dist/aliSkills.d.ts

@@ -1,5 +1,5 @@
 import fs from 'node:fs';
-import { type CommandRunner } from './process.js';
+import { type CommandRunner } from '@mearl/daemon-core';
 export interface AliSkillsCliOutput {
     stdout: string;
     stderr: string;

package/dist/aliSkills.js

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { spawn } from 'node:child_process';
-import { executableNames, findExecutable, isExecutable, prependCommandPath, prependNodePath, resolveSpawnCommand, runCommand, versionManagerExecutableCandidates, } from './process.js';
+import { executableNames, findExecutable, isExecutable, prependCommandPath, prependNodePath, resolveSpawnCommand, runCommand, versionManagerExecutableCandidates, } from '@mearl/daemon-core';
 const COMMAND_TIMEOUT_MS = 120_000;
 const MAX_OUTPUT_LENGTH = 1_000_000;
 const ANSI_ESCAPE_PATTERN = new RegExp(String.raw `\u001B\[[0-?]*[ -/]*[@-~]`, 'g');

package/dist/internalPlugins.d.ts

@@ -1,7 +1,7 @@
 import { findPluginRegistration, listPluginNames, unregisterPlugin } from '@mearl/client/plugin';
 import { resolveAliSkillsInvocation } from './aliSkills.js';
 import { installPlugins } from './plugin.js';
-import { findExecutable, type CommandRunner } from './process.js';
+import { findExecutable, type CommandRunner } from '@mearl/daemon-core';
 export { ALIBABA_NPM_REGISTRY } from './npmRegistry.js';
 export declare const ALIBABA_INTERNAL_PLUGIN_NAMES: string[];
 export interface InternalPluginOptions {

package/dist/internalPlugins.js

@@ -3,7 +3,7 @@ import { findOfficialPlugin, findPluginRegistration, listPluginNames, listOffici
 import { resolveAliSkillsInvocation } from './aliSkills.js';
 import { ALIBABA_NPM_REGISTRY } from './npmRegistry.js';
 import { installPlugins } from './plugin.js';
-import { findExecutable, prependCommandPath, runCommand } from './process.js';
+import { findExecutable, prependCommandPath, runCommand, } from '@mearl/daemon-core';
 export { ALIBABA_NPM_REGISTRY } from './npmRegistry.js';
 export const ALIBABA_INTERNAL_PLUGIN_NAMES = listOfficialPluginNames('alibaba');
 export async function canAccessAlibabaNpmRegistry(options = {}, dependencies = {}) {

package/dist/lifecycle.d.ts

@@ -4,10 +4,11 @@ import { runGlobalMearlSkillOperation } from './aliSkills.js';
 import { detectGlobalPackage, type PackageManagerInstallation, type PackageDetectionOptions } from './packageManager.js';
 import { type DetectedMearlProfiles, type MearlProfile } from './profiles.js';
 import { uninstallNativeHostArtifacts } from './nativeHost.js';
-import { type CommandRunner } from './process.js';
+import { type CommandRunner } from '@mearl/daemon-core';
 import { installAlibabaInternalPlugins, uninstallAlibabaInternalPlugins } from './internalPlugins.js';
 import { uninstallPlugin } from './plugin.js';
 import { uninstallProviderPackage } from './provider.js';
+import { cleanupUninstalledRuntime } from './runtimeCleanup.js';
 export type MearlLifecycleOperation = 'install' | 'update' | 'uninstall';
 export interface MearlLifecycleOptions {
     operation: MearlLifecycleOperation;
@@ -23,6 +24,7 @@ export interface MearlLifecycleOptions {
     env?: NodeJS.ProcessEnv;
 }
 export interface MearlLifecycleDependencies {
+    cleanupRuntime?: typeof cleanupUninstalledRuntime;
     cleanupNativeHost?: typeof uninstallNativeHostArtifacts;
     confirm?: (message: string) => Promise<boolean>;
     detectPackage?: typeof detectGlobalPackage;

package/dist/lifecycle.js

@@ -8,12 +8,13 @@ import { runGlobalMearlSkillOperation } from './aliSkills.js';
 import { buildGlobalPackageCommand, detectGlobalPackage, resolveInvokingPackageManager, resolvePackageManagerInstallation, } from './packageManager.js';
 import { MEARL_PROFILES, detectMearlProfiles, } from './profiles.js';
 import { uninstallNativeHostArtifacts } from './nativeHost.js';
-import { executableNames, prependCommandPath, runCommand, } from './process.js';
+import { executableNames, prependCommandPath, runCommand, } from '@mearl/daemon-core';
 import { isMearlReleaseLine } from './version.js';
 import { installAlibabaInternalPlugins, uninstallAlibabaInternalPlugins, } from './internalPlugins.js';
 import { uninstallPlugin } from './plugin.js';
 import { uninstallProviderPackage } from './provider.js';
 import { packageRegistryEnvironment } from './npmRegistry.js';
+import { cleanupUninstalledRuntime } from './runtimeCleanup.js';
 const LEGACY_CLOUD_CLIENT = '@mearl/cloud-client';
 const UNIFIED_CLIENT = '@mearl/client';
 const PROFILE_ORDER = ['local', 'cloud', 'mcp'];
@@ -227,17 +228,9 @@ export async function runMearlLifecycle(options, dependencies = {}) {
             return false;
         }
     }
-    const hasFullIntegrationTargets = fullPluginNames.length > 0 || fullProviders.length > 0;
-    if (options.operation === 'uninstall' &&
-        options.full &&
-        lifecycleSelected.length === 0 &&
-        !hasFullIntegrationTargets) {
-        writeLine('No installed Mearl environments, CLI plugins, or Providers were detected.');
-        return true;
-    }
     if (selected.length === 0 &&
         !autoUpdateClient &&
-        !(options.operation === 'uninstall' && options.full && hasFullIntegrationTargets)) {
+        !(options.operation === 'uninstall' && options.full)) {
         writeLine('No installed Mearl environment was detected on the current PATH.');
         if (options.operation === 'uninstall')
             return true;
@@ -488,6 +481,18 @@ export async function runMearlLifecycle(options, dependencies = {}) {
         }
     }
     if (packagesOk && skillOk && fullOk) {
+        if (options.operation === 'uninstall' &&
+            options.full &&
+            PROFILE_ORDER.every(profile => !detected.has(profile) || lifecycleSelected.includes(profile))) {
+            try {
+                await (dependencies.cleanupRuntime ?? cleanupUninstalledRuntime)();
+                writeLine('Runtime caches: cleaned; user data and browser profiles were retained.');
+            }
+            catch (error) {
+                writeLine(`Runtime caches: ${error instanceof Error ? error.message : String(error)}`);
+                return false;
+            }
+        }
         writeLine('Mearl setup complete.');
         return true;
     }

package/dist/packageManager.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { executableNames, findExecutable, isExecutable } from './process.js';
+import { executableNames, findExecutable, isExecutable } from '@mearl/daemon-core';
 function normalizePath(filePath) {
     return filePath.replaceAll('\\', '/').replace(/\/+$/, '');
 }

package/dist/plugin.d.ts

@@ -1,4 +1,4 @@
-import { type CommandRunner } from './process.js';
+import { type CommandRunner } from '@mearl/daemon-core';
 export interface PluginSetupResult {
     entry: string;
     name: string;

package/dist/plugin.js

@@ -4,7 +4,7 @@ import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'nod
 import { assertPluginName, findPluginDirectoryEntry, findOfficialPlugin, findPluginEntry, findPluginRegistration, listPluginNames, loadPlugin, OFFICIAL_PLUGIN_MANAGER, registerPlugin, resolvePluginEntry, unregisterPlugin, } from '@mearl/client/plugin';
 import { ensurePluginRuntime } from './pluginRuntime.js';
 import { resolveAliSkillsInvocation, stripAnsi } from './aliSkills.js';
-import { findExecutable, prependNodePath, runCommand } from './process.js';
+import { findExecutable, prependNodePath, runCommand, } from '@mearl/daemon-core';
 const registrationContext = {
     options: {},
     invoke: async () => {
@@ -38,6 +38,7 @@ export async function setupPlugin(target, requestedName) {
     await ensurePluginRuntime();
     return {
         entry: registerPlugin(name, entry, plugin.description, {
+            hasPublicCommands: Boolean(plugin.commandHelp(name)),
             toolbox: plugin.toolbox,
             appProfiles: plugin.appProfiles,
             profileSources: plugin.profileSources,
@@ -266,6 +267,7 @@ export async function installPlugins(args, runner = runCommand, options = {}) {
             throw new Error(`多个 skill 使用插件名称 ${name}，请调整入口的 name metadata。`);
         plugins.set(name, {
             entry,
+            hasPublicCommands: Boolean(plugin.commandHelp(name)),
             description: plugin.description,
             ...(plugin.toolbox ? { toolbox: plugin.toolbox } : {}),
             appProfiles: plugin.appProfiles,
@@ -277,14 +279,15 @@ export async function installPlugins(args, runner = runCommand, options = {}) {
         return 0;
     }
     await ensurePluginRuntime(runner);
-    for (const [name, { entry, description, toolbox, appProfiles, profileSources }] of plugins) {
+    for (const [name, { entry, description, toolbox, appProfiles, profileSources, hasPublicCommands },] of plugins) {
         registerPlugin(name, entry, description, {
+            hasPublicCommands,
             managedBy: options.registrationManagedBy,
             ...(toolbox ? { toolbox } : {}),
             appProfiles,
             profileSources,
         });
-        console.error(`Plugin ${name} registered: ${entry}\nRun: mearl ${name} --help`);
+        console.error(`Plugin ${name} registered: ${entry}${hasPublicCommands ? `\nRun: mearl ${name} --help` : toolbox ? '\nOpen in Mearl toolbox.' : ''}`);
     }
     return 0;
 }

package/dist/pluginRuntime.d.ts

@@ -1,4 +1,4 @@
-import { type CommandRunner } from './process.js';
+import { type CommandRunner } from '@mearl/daemon-core';
 export declare const PLUGIN_RUNTIME_VERSION: string;
 /** 插件使用当前 setup 同版本的运行时；已安装的更高版本保持不动。 */
 export declare function ensurePluginRuntime(runner?: CommandRunner): Promise<void>;

package/dist/pluginRuntime.js

@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { join } from 'node:path';
 import { buildGlobalPackageCommand, detectCliPackage, detectGlobalPackage, resolveInvokingPackageManager, } from './packageManager.js';
-import { prependCommandPath, runCommand } from './process.js';
+import { prependCommandPath, runCommand } from '@mearl/daemon-core';
 import { compareMearlReleaseVersions, isMearlReleaseVersion } from './version.js';
 import { packageRegistryEnvironment } from './npmRegistry.js';
 const require = createRequire(import.meta.url);

package/dist/provider.d.ts

@@ -1,6 +1,6 @@
-import { listInstalledProviders, registerProviderPackage, stopProvider, uninstallProvider, type InstalledProviderManifest } from '@mearl/provider/host';
+import { listInstalledProviders, registerProviderPackage, uninstallProvider, type InstalledProviderManifest } from '@mearl/provider/host';
 import { resolvePackageManagerInstallation, type PackageManagerInstallation } from './packageManager.js';
-import { type CommandRunner } from './process.js';
+import { type CommandRunner } from '@mearl/daemon-core';
 interface ProviderPackageSpec {
     packageName: string;
     target: string;
@@ -13,7 +13,7 @@ export interface ProviderSetupDependencies {
     resolvePackageManager?: typeof resolvePackageManagerInstallation;
     resolvePackageRoot?: (installation: PackageManagerInstallation, packageName: string, runner: CommandRunner, env: NodeJS.ProcessEnv) => Promise<string>;
     runCommand?: CommandRunner;
-    stopProvider?: typeof stopProvider;
+    stopProvider?: (providerId: string) => void | boolean | Promise<void | boolean>;
     unregisterProvider?: typeof uninstallProvider;
 }
 export interface ProviderSetupResult {

package/dist/provider.js

@@ -1,9 +1,26 @@
 import { existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
-import { listInstalledProviders, registerProviderPackage, stopProvider, uninstallProvider, } from '@mearl/provider/host';
+import { listInstalledProviders, registerProviderPackage, stopProvider, readLiveProvider, readProviderStart, uninstallProvider, } from '@mearl/provider/host';
 import { buildGlobalPackageCommand, resolveInvokingPackageManager, resolvePackageManagerInstallation, } from './packageManager.js';
 import { packageRegistryEnvironment } from './npmRegistry.js';
-import { prependCommandPath, runCommand } from './process.js';
+import { isProcessOwnerAlive, processIdentity, prependCommandPath, runCommand, } from '@mearl/daemon-core';
+async function stopProviderBeforePackageChange(providerId) {
+    if (readProviderStart(providerId))
+        throw new Error(`Provider ${providerId} is still starting`);
+    const live = readLiveProvider(providerId);
+    if (!live)
+        return;
+    const owner = { pid: live.pid, processIdentity: processIdentity(live.pid) };
+    stopProvider(providerId);
+    const deadline = Date.now() + 5000;
+    while (isProcessOwnerAlive(owner)) {
+        if (Date.now() >= deadline)
+            throw new Error(`Provider ${providerId} did not finish stopping`);
+        await new Promise(resolve => setTimeout(resolve, 50));
+    }
+    if (readLiveProvider(providerId) || readProviderStart(providerId))
+        throw new Error(`Provider ${providerId} restarted during shutdown`);
+}
 export function parseProviderPackageSpec(value) {
     const input = value.trim();
     const nameMatch = input.match(/^(@[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*|[a-z0-9][a-z0-9._-]*)(?:@(.+))?$/i);
@@ -94,7 +111,7 @@ export async function updateProviderPackage(selector, dependencies = {}) {
     const runner = dependencies.runCommand ?? runCommand;
     const detectedManager = (dependencies.resolvePackageManager ?? resolvePackageManagerInstallation)(current.packageRoot, current.packageName) ?? undefined;
     const installation = providerManager(env, dependencies, detectedManager);
-    (dependencies.stopProvider ?? stopProvider)(current.providerId);
+    await (dependencies.stopProvider ?? stopProviderBeforePackageChange)(current.providerId);
     await runPackageCommand(installation, 'update', current.packageName, 'latest', runner, env);
     const manifest = (dependencies.registerPackage ?? registerProviderPackage)(current.packageRoot);
     return { manifest, manager: installation.manager };
@@ -104,7 +121,7 @@ export async function uninstallProviderPackage(selector, dependencies = {}) {
     const manifest = findRegisteredProvider(selector, listProviders);
     const env = process.env;
     const installation = (dependencies.resolvePackageManager ?? resolvePackageManagerInstallation)(manifest.packageRoot, manifest.packageName) ?? providerManager(env, dependencies);
-    (dependencies.stopProvider ?? stopProvider)(manifest.providerId);
+    await (dependencies.stopProvider ?? stopProviderBeforePackageChange)(manifest.providerId);
     await runPackageCommand(installation, 'uninstall', manifest.packageName, 'latest', dependencies.runCommand ?? runCommand, env);
     (dependencies.unregisterProvider ?? uninstallProvider)(manifest.providerId);
     return { manifest, manager: installation.manager };

package/dist/runtimeCleanup.d.ts

@@ -0,0 +1,2 @@
+/** User state, browser profiles and CDP tab-ID counters survive uninstall. */
+export declare function cleanupUninstalledRuntime(): Promise<void>;

package/dist/runtimeCleanup.js

@@ -0,0 +1,50 @@
+import { readdirSync, rmSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { cleanupPluginRuntime, pluginDirectory } from '@mearl/client/plugin';
+import { isProcessOwnerAlive, listRecordFiles, pruneOrphanLogs, readRecord, removeRecordIfPid, } from '@mearl/daemon-core';
+/** User state, browser profiles and CDP tab-ID counters survive uninstall. */
+export async function cleanupUninstalledRuntime() {
+    await cleanupPluginRuntime();
+    const root = join(homedir(), '.mearl');
+    if (resolve(pluginDirectory()) !== resolve(join(root, 'plugins')))
+        return;
+    if (listRecordFiles(join(root, 'providers/installed')).length)
+        throw new Error('Registered Providers still use runtime caches; caches were retained');
+    for (const directory of ['providers/live', 'providers/starting']) {
+        if (listRecordFiles(join(root, directory)).some(file => {
+            const record = readRecord(file);
+            return record && isProcessOwnerAlive(record);
+        }))
+            throw new Error('Providers still use runtime caches; caches were retained');
+    }
+    for (const directory of [
+        'authx-sdk',
+        'design-overlay/objects',
+        'design-overlay/uploads',
+        'design-overlay/pages',
+    ])
+        rmSync(join(root, directory), { recursive: true, force: true });
+    pruneOrphanLogs(join(root, 'managed-browsers'), 0);
+    pruneOrphanLogs(join(root, 'providers/logs'), 0);
+    let entries;
+    try {
+        entries = readdirSync(join(root, 'plugin-pages'), { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory() || !/^[a-f0-9]{16}\.json\.d$/.test(entry.name))
+            continue;
+        for (const file of listRecordFiles(join(root, 'plugin-pages', entry.name))) {
+            if (!/^session-[a-f0-9]{16}\.json$/.test(basename(file)))
+                continue;
+            const record = readRecord(file);
+            if (record && !isProcessOwnerAlive(record))
+                removeRecordIfPid(file, record.pid);
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/setup",
-  "version": "2.20.5",
+  "version": "2.21.0",
   "description": "One-shot environment setup and configuration for Mearl",
   "type": "module",
   "main": "dist/index.js",
@@ -18,10 +18,6 @@
       "types": "./dist/aliSkills.d.ts",
       "import": "./dist/aliSkills.js"
     },
-    "./process": {
-      "types": "./dist/process.d.ts",
-      "import": "./dist/process.js"
-    },
     "./package-manager": {
       "types": "./dist/packageManager.d.ts",
       "import": "./dist/packageManager.js"
@@ -69,8 +65,9 @@
     "commander": "^15.0.0",
     "extract-zip": "^2.0.1",
     "ws": "^8.18.3",
-    "@mearl/client": "2.20.5",
-    "@mearl/provider": "2.20.5"
+    "@mearl/client": "2.21.0",
+    "@mearl/provider": "2.21.0",
+    "@mearl/daemon-core": "2.21.0"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",

package/dist/process.d.ts

@@ -1,38 +0,0 @@
-import fs from 'node:fs';
-export interface SpawnCommand {
-    command: string;
-    args: string[];
-}
-export interface CommandResult {
-    code: number;
-    stdout: string;
-    stderr: string;
-}
-export interface RunCommandOptions {
-    capture?: boolean;
-    /** 显示并捕获输出，同时继承 stdin 以保留安装器交互。 */
-    tee?: boolean;
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-    timeoutMs?: number;
-}
-export type CommandRunner = (command: string, args: string[], options?: RunCommandOptions) => Promise<CommandResult>;
-export declare function isExecutable(filePath: string, platform?: NodeJS.Platform): boolean;
-export declare function executableNames(name: string, platform?: NodeJS.Platform): string[];
-export interface VersionManagerExecutableCandidateOptions {
-    env?: NodeJS.ProcessEnv;
-    platform?: NodeJS.Platform;
-    readdirSync?: typeof fs.readdirSync;
-}
-export declare function versionManagerExecutableCandidates(home: string, names: string[], options?: VersionManagerExecutableCandidateOptions): string[];
-export declare function resolveSpawnCommand(executable: string, args: string[], platform?: NodeJS.Platform, commandInterpreter?: string | undefined): SpawnCommand;
-export declare function prependCommandPath(command: string, env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-export declare function prependNodePath(env?: NodeJS.ProcessEnv, nodeExecutable?: string): NodeJS.ProcessEnv;
-export declare function prependPathDirectory(directory: string, env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-export declare function findExecutable(name: string, options?: {
-    env?: NodeJS.ProcessEnv;
-    existsSync?: (filePath: string) => boolean;
-    platform?: NodeJS.Platform;
-    extraDirectories?: string[];
-}): string | null;
-export declare const runCommand: CommandRunner;

package/dist/process.js

@@ -1,139 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawn } from 'node:child_process';
-const MAX_CAPTURE_LENGTH = 1_000_000;
-export function isExecutable(filePath, platform = process.platform) {
-    try {
-        fs.accessSync(filePath, platform === 'win32' ? fs.constants.F_OK : fs.constants.X_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export function executableNames(name, platform = process.platform) {
-    return platform === 'win32' ? [`${name}.cmd`, `${name}.exe`, name] : [name];
-}
-export function versionManagerExecutableCandidates(home, names, options = {}) {
-    const env = options.env ?? process.env;
-    const platform = options.platform ?? process.platform;
-    const readdirSync = options.readdirSync ?? fs.readdirSync;
-    const fnmDefaultRoot = env.XDG_DATA_HOME
-        ? path.join(env.XDG_DATA_HOME, 'fnm')
-        : platform === 'darwin'
-            ? path.join(home, 'Library', 'Application Support', 'fnm')
-            : platform === 'win32' && env.APPDATA
-                ? path.join(env.APPDATA, 'fnm')
-                : path.join(home, '.local', 'share', 'fnm');
-    const roots = [
-        path.join(env.NVM_DIR || path.join(home, '.nvm'), 'versions', 'node'),
-        path.join(env.FNM_DIR || fnmDefaultRoot, 'node-versions'),
-        path.join(home, '.fnm', 'node-versions'),
-    ].filter((root, index, all) => all.indexOf(root) === index);
-    return roots.flatMap(root => {
-        try {
-            return readdirSync(root, { withFileTypes: true })
-                .filter(entry => entry.isDirectory())
-                .sort((left, right) => right.name.localeCompare(left.name, undefined, { numeric: true }))
-                .flatMap(entry => names.flatMap(name => [
-                path.join(root, entry.name, 'bin', name),
-                path.join(root, entry.name, 'installation', 'bin', name),
-            ]));
-        }
-        catch {
-            return [];
-        }
-    });
-}
-export function resolveSpawnCommand(executable, args, platform = process.platform, commandInterpreter = process.env.ComSpec) {
-    if (platform === 'win32' && /\.(?:cmd|bat)$/i.test(executable)) {
-        return {
-            command: commandInterpreter || 'cmd.exe',
-            args: ['/d', '/s', '/c', executable, ...args],
-        };
-    }
-    return { command: executable, args };
-}
-export function prependCommandPath(command, env = process.env) {
-    if (!path.isAbsolute(command))
-        return env;
-    return prependPathDirectory(path.dirname(command), env);
-}
-export function prependNodePath(env = process.env, nodeExecutable = process.execPath) {
-    return prependPathDirectory(path.dirname(nodeExecutable), env);
-}
-export function prependPathDirectory(directory, env = process.env) {
-    const pathKey = Object.keys(env).find(key => key.toLowerCase() === 'path') || 'PATH';
-    const inherited = env[pathKey] || '';
-    const entries = inherited.split(path.delimiter).filter(Boolean);
-    if (entries.includes(directory))
-        return env;
-    return { ...env, [pathKey]: [directory, ...entries].join(path.delimiter) };
-}
-export function findExecutable(name, options = {}) {
-    const env = options.env ?? process.env;
-    const platform = options.platform ?? process.platform;
-    const existsSync = options.existsSync ?? (candidate => isExecutable(candidate, platform));
-    const pathKey = Object.keys(env).find(key => key.toLowerCase() === 'path') || 'PATH';
-    const directories = [
-        ...(options.extraDirectories ?? []),
-        ...(env[pathKey] ?? '').split(path.delimiter).filter(Boolean),
-    ];
-    for (const directory of directories) {
-        for (const executableName of executableNames(name, platform)) {
-            const candidate = path.join(directory, executableName);
-            if (existsSync(candidate))
-                return candidate;
-        }
-    }
-    return null;
-}
-export const runCommand = (command, args, options = {}) => new Promise((resolve, reject) => {
-    const capture = options.capture === true || options.tee === true;
-    const launch = resolveSpawnCommand(command, args);
-    const child = spawn(launch.command, launch.args, {
-        cwd: options.cwd,
-        env: options.env,
-        stdio: capture ? [options.tee ? 'inherit' : 'ignore', 'pipe', 'pipe'] : 'inherit',
-        windowsHide: true,
-    });
-    let stdout = '';
-    let stderr = '';
-    let settled = false;
-    const append = (current, chunk) => options.tee
-        ? (current + chunk).slice(-MAX_CAPTURE_LENGTH)
-        : current.length >= MAX_CAPTURE_LENGTH
-            ? current
-            : (current + chunk).slice(0, MAX_CAPTURE_LENGTH);
-    const finish = (error, code = 1) => {
-        if (settled)
-            return;
-        settled = true;
-        if (timer)
-            clearTimeout(timer);
-        if (error)
-            reject(error);
-        else
-            resolve({ code, stdout, stderr });
-    };
-    const timer = options.timeoutMs === undefined
-        ? undefined
-        : setTimeout(() => {
-            child.kill('SIGTERM');
-            finish(new Error(`Command timed out after ${options.timeoutMs}ms`));
-        }, options.timeoutMs);
-    if (capture) {
-        child.stdout?.setEncoding('utf8').on('data', (chunk) => {
-            stdout = append(stdout, chunk);
-            if (options.tee)
-                process.stdout.write(chunk);
-        });
-        child.stderr?.setEncoding('utf8').on('data', (chunk) => {
-            stderr = append(stderr, chunk);
-            if (options.tee)
-                process.stderr.write(chunk);
-        });
-    }
-    child.once('error', error => finish(error));
-    child.once('close', code => finish(undefined, code ?? 1));
-});