@agentuity/cli 2.0.11 → 3.0.0-alpha.1

package/dist/cmd/dev/file-watcher.js

@@ -1,349 +0,0 @@
-/**
- * File Watcher for Dev Server Hot Reload
- *
- * Watches source files and triggers server restart on changes.
- * Handles both backend (API, agents, lib) and generates restart signals.
- */
-import { watch, statSync, readdirSync, lstatSync } from 'node:fs';
-import { resolve, relative } from 'node:path';
-import { createAgentTemplates } from './templates';
-/**
- * Create a file watcher manager for hot reload
- */
-export function createFileWatcher(options) {
-    const { rootDir, logger, onRestart, additionalPaths = [] } = options;
-    const watchers = [];
-    let paused = false;
-    let buildCooldownTimer = null;
-    // Directories to ignore - these are NEVER traversed into
-    // This prevents EMFILE errors from symlink cycles in node_modules
-    const ignoreDirs = new Set([
-        '.agentuity',
-        '.agents',
-        '.claude',
-        '.code',
-        '.opencode',
-        'node_modules',
-        '.git',
-        '.github',
-        'dist',
-        'build',
-        '.next',
-        '.turbo',
-        '.npm',
-        '.dist',
-        '.vscode',
-        '.idea',
-        '.DS_Store',
-        '.playwright',
-        '.bun',
-        'src/generated',
-    ]);
-    // Paths to ignore for file change events (but may still be traversed)
-    const ignorePaths = [
-        '.agentuity',
-        '.agents',
-        '.claude',
-        '.code',
-        '.opencode',
-        'node_modules',
-        '.git',
-        '.github',
-        'dist',
-        'build',
-        '.next',
-        '.turbo',
-        '.npm',
-        '.dist',
-        '.vscode',
-        '.idea',
-        '.bun',
-        '.DS_Store',
-        '.playwright',
-        'src/web', // Vite handles frontend with HMR - no backend restart needed
-        'src/generated', // Generated files shouldn't trigger rebuilds
-    ];
-    // File extensions to ignore - non-code files that shouldn't trigger reload
-    const ignoreExtensions = new Set([
-        '.md',
-        '.mdx',
-        '.txt',
-        '.log',
-        '.lock',
-        '.yaml',
-        '.yml',
-        '.toml',
-        '.csv',
-        '.svg',
-        '.png',
-        '.jpg',
-        '.jpeg',
-        '.gif',
-        '.webp',
-        '.ico',
-        '.woff',
-        '.woff2',
-        '.ttf',
-        '.eot',
-        '.mp4',
-        '.mp3',
-        '.wav',
-        '.ogg',
-        '.webm',
-        '.pdf',
-        '.zip',
-        '.tar',
-        '.gz',
-        '.map',
-    ]);
-    /**
-     * Check if a path should be ignored
-     */
-    function shouldIgnorePath(changedFile, watchDir) {
-        if (!changedFile)
-            return false;
-        const absPath = resolve(watchDir, changedFile);
-        // Check against ignore list - match both relative path and absolute path
-        for (const ignorePath of ignorePaths) {
-            // Check relative path from watchDir
-            if (changedFile === ignorePath ||
-                changedFile.startsWith(`${ignorePath}/`) ||
-                changedFile.startsWith(`${ignorePath}\\`)) {
-                logger.trace('File change ignored (%s): %s', ignorePath, changedFile);
-                return true;
-            }
-            // Check if absolute path contains the ignore pattern
-            const ignoreAbsPath = resolve(rootDir, ignorePath);
-            if (absPath === ignoreAbsPath ||
-                absPath.startsWith(`${ignoreAbsPath}/`) ||
-                absPath.startsWith(`${ignoreAbsPath}\\`)) {
-                logger.trace('File change ignored (%s): %s', ignorePath, changedFile);
-                return true;
-            }
-            // Also check if changedFile path includes the ignore pattern anywhere
-            // This handles cases like "some/path/.agentuity/file.js"
-            const normalizedChanged = changedFile.replace(/\\/g, '/');
-            const normalizedIgnore = ignorePath.replace(/\\/g, '/');
-            if (normalizedChanged.includes(`/${normalizedIgnore}/`) ||
-                normalizedChanged.includes(`/${normalizedIgnore}`)) {
-                logger.trace('File change ignored (%s in path): %s', ignorePath, changedFile);
-                return true;
-            }
-        }
-        // Ignore temp files from editors
-        if (changedFile.match(/\.(tmp|swp|swo|swx)$|~$/)) {
-            logger.trace('File change ignored (temp file): %s', changedFile);
-            return true;
-        }
-        // Ignore files with non-code extensions
-        const extIndex = changedFile.lastIndexOf('.');
-        if (extIndex !== -1) {
-            const ext = changedFile.slice(extIndex).toLowerCase();
-            if (ignoreExtensions.has(ext)) {
-                logger.trace('File change ignored (%s): %s', ext, changedFile);
-                return true;
-            }
-        }
-        // Ignore hidden files (except .env)
-        if (changedFile.startsWith('.') && !changedFile.startsWith('.env')) {
-            logger.trace('File change ignored (hidden file): %s', changedFile);
-            return true;
-        }
-        return false;
-    }
-    /**
-     * Handle file change event
-     */
-    function handleFileChange(eventType, changedFile, watchDir) {
-        if (paused) {
-            logger.trace('File change ignored (watcher paused): %s', changedFile);
-            return;
-        }
-        if (shouldIgnorePath(changedFile, watchDir)) {
-            return;
-        }
-        // During build cooldown, ignore changes (they're likely build outputs)
-        if (buildCooldownTimer) {
-            logger.trace('File change ignored (build cooldown): %s', changedFile);
-            return;
-        }
-        // Get absolute path for checking
-        const absPath = changedFile ? resolve(watchDir, changedFile) : watchDir;
-        // Check if this is a directory
-        let isDirectory = false;
-        try {
-            const stats = statSync(absPath);
-            isDirectory = stats.isDirectory();
-        }
-        catch {
-            // File doesn't exist (was deleted) - not a directory
-            isDirectory = false;
-        }
-        // Check if an empty directory was created in src/agent/
-        // This helps with developer experience by auto-scaffolding template files
-        if (changedFile && eventType === 'rename' && isDirectory) {
-            try {
-                // Normalize the path for comparison (use forward slashes)
-                const normalizedPath = changedFile.replace(/\\/g, '/');
-                // Check if it's empty
-                const contents = readdirSync(absPath);
-                if (contents.length === 0) {
-                    if (normalizedPath.startsWith('src/agent/') ||
-                        normalizedPath.includes('/src/agent/')) {
-                        logger.debug('Agent directory created: %s', changedFile);
-                        createAgentTemplates(absPath);
-                    }
-                }
-            }
-            catch (error) {
-                // File might have been deleted or doesn't exist yet - this is normal
-                logger.trace('Unable to check directory for template creation (%s): %s', changedFile, error);
-            }
-        }
-        // Ignore directory-only change events (mtime updates when files inside change)
-        // We only care about actual file changes - the watcher will report those directly
-        if (isDirectory && eventType === 'change') {
-            logger.trace('File change ignored (directory mtime update): %s', changedFile);
-            return;
-        }
-        logger.debug('File changed (%s): %s', eventType, changedFile || watchDir);
-        onRestart();
-    }
-    /**
-     * Recursively collect all directories to watch, skipping ignored directories.
-     * This prevents EMFILE errors from symlink cycles in node_modules.
-     */
-    function collectWatchDirs(dir, visited = new Set()) {
-        const dirs = [dir];
-        try {
-            // Use lstat to check for symlinks - get the real path to detect cycles
-            const stat = lstatSync(dir);
-            // Skip symlinks to prevent following circular symlinks
-            if (stat.isSymbolicLink()) {
-                logger.trace('Skipping symlink: %s', dir);
-                return [];
-            }
-            // Track visited inodes to detect cycles
-            const key = `${stat.dev}:${stat.ino}`;
-            if (visited.has(key)) {
-                logger.trace('Skipping already visited directory (cycle detected): %s', dir);
-                return [];
-            }
-            visited.add(key);
-            const entries = readdirSync(dir, { withFileTypes: true });
-            for (const entry of entries) {
-                if (!entry.isDirectory())
-                    continue;
-                const name = entry.name;
-                // Skip ignored directories entirely - this is the key fix
-                if (ignoreDirs.has(name)) {
-                    logger.trace('Skipping ignored directory: %s', resolve(dir, name));
-                    continue;
-                }
-                // Skip hidden directories (except specific ones like .env folders)
-                if (name.startsWith('.')) {
-                    logger.trace('Skipping hidden directory: %s', resolve(dir, name));
-                    continue;
-                }
-                const fullPath = resolve(dir, name);
-                dirs.push(...collectWatchDirs(fullPath, visited));
-            }
-        }
-        catch (error) {
-            logger.trace('Error reading directory %s: %s', dir, error);
-        }
-        return dirs;
-    }
-    /**
-     * Start watching files
-     */
-    function start() {
-        logger.debug('Starting file watchers for hot reload...');
-        // Collect all directories to watch, excluding node_modules and other ignored dirs
-        const allDirs = collectWatchDirs(rootDir);
-        // Add additional paths
-        if (additionalPaths && additionalPaths.length > 0) {
-            for (const additionalPath of additionalPaths) {
-                const fullPath = resolve(rootDir, additionalPath);
-                allDirs.push(...collectWatchDirs(fullPath));
-            }
-        }
-        // De-duplicate directories
-        const uniqueDirs = [...new Set(allDirs)];
-        logger.debug('Collected %d directories to watch', uniqueDirs.length);
-        // Watch each directory non-recursively
-        for (const watchPath of uniqueDirs) {
-            try {
-                // Use non-recursive watch to avoid traversing into node_modules
-                const watcher = watch(watchPath, { recursive: false }, (eventType, changedFile) => {
-                    // Construct relative path from rootDir for consistent handling
-                    const relPath = changedFile
-                        ? relative(rootDir, resolve(watchPath, changedFile))
-                        : relative(rootDir, watchPath);
-                    handleFileChange(eventType, relPath || changedFile, rootDir);
-                });
-                watchers.push(watcher);
-            }
-            catch (error) {
-                logger.trace('Failed to start watcher for %s: %s', watchPath, error);
-            }
-        }
-        logger.debug('File watchers started (%d directories)', watchers.length);
-    }
-    /**
-     * Stop all watchers
-     */
-    function stop() {
-        logger.debug('Stopping file watchers...');
-        for (const watcher of watchers) {
-            try {
-                watcher.close();
-            }
-            catch (error) {
-                logger.trace('Error closing watcher: %s', error);
-            }
-        }
-        watchers.length = 0;
-        if (buildCooldownTimer) {
-            clearTimeout(buildCooldownTimer);
-            buildCooldownTimer = null;
-        }
-        logger.debug('File watchers stopped');
-    }
-    /**
-     * Temporarily pause watching (e.g., during build)
-     */
-    function pause() {
-        paused = true;
-        logger.trace('File watchers paused');
-        // Set cooldown timer to ignore changes for a bit after build
-        if (buildCooldownTimer) {
-            clearTimeout(buildCooldownTimer);
-        }
-        buildCooldownTimer = setTimeout(() => {
-            buildCooldownTimer = null;
-            logger.trace('Build cooldown expired');
-        }, 500); // 500ms cooldown
-    }
-    /**
-     * Resume watching
-     */
-    function resume() {
-        paused = false;
-        // Clear any pending build cooldown timer so file changes are detected immediately.
-        // Without this, events arriving during the remaining cooldown window after a fast
-        // typecheck failure would be silently dropped.
-        if (buildCooldownTimer) {
-            clearTimeout(buildCooldownTimer);
-            buildCooldownTimer = null;
-        }
-        logger.trace('File watchers resumed');
-    }
-    return {
-        start,
-        stop,
-        pause,
-        resume,
-    };
-}
-//# sourceMappingURL=file-watcher.js.map

package/dist/cmd/dev/file-watcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-watcher.js","sourceRoot":"","sources":["../../../src/cmd/dev/file-watcher.ts"],"names":[],"mappings":"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"}

package/dist/cmd/dev/process-manager.d.ts

@@ -1,104 +0,0 @@
-/**
- * Process Manager for Dev Mode
- *
- * Tracks all spawned processes and ensures they're cleaned up on:
- * - Startup failure (any server fails to start)
- * - Runtime crash (uncaught exception)
- * - Graceful shutdown (SIGINT/SIGTERM)
- *
- * This prevents orphan processes and port conflicts between dev sessions.
- */
-import type { Logger } from '../../types';
-export interface ManagedProcess {
-    /** Process identifier for logging */
-    id: string;
-    /** The process handle */
-    process: {
-        kill: (signal?: number | NodeJS.Signals) => void;
-        exitCode: number | null;
-        pid?: number;
-    };
-    /** Human-readable description */
-    description: string;
-    /** The port this process uses (if any) */
-    port?: number;
-    /** Whether this process is critical (startup fails if it dies) */
-    critical?: boolean;
-}
-export interface ManagedServer {
-    /** Server identifier */
-    id: string;
-    /** The server handle */
-    server: {
-        close: () => void | Promise<void>;
-    };
-    /** Human-readable description */
-    description: string;
-    /** The port this server uses */
-    port?: number;
-}
-/**
- * Process Manager
- *
- * Tracks all processes and servers started during dev mode and provides
- * centralized cleanup on failure or shutdown.
- */
-export declare class ProcessManager {
-    private processes;
-    private servers;
-    private logger;
-    private cleaningUp;
-    constructor(logger: Logger);
-    /**
-     * Register a spawned process for tracking.
-     */
-    registerProcess(proc: ManagedProcess): void;
-    /**
-     * Register a server for tracking.
-     */
-    registerServer(server: ManagedServer): void;
-    /**
-     * Unregister a process (e.g., after it exits normally).
-     */
-    unregisterProcess(id: string): void;
-    /**
-     * Unregister a server.
-     */
-    unregisterServer(id: string): void;
-    /**
-     * Get all registered ports (for cleanup verification).
-     */
-    getPorts(): number[];
-    /**
-     * Clean up all tracked processes and servers.
-     *
-     * @param reason - Why cleanup is happening (for logging)
-     * @param timeout - Max time to wait for graceful shutdown (ms)
-     */
-    cleanup(reason: string, timeout?: number): Promise<void>;
-    /**
-     * Verify that all ports used by tracked processes are released.
-     * Used after cleanup to ensure no orphan processes remain.
-     */
-    verifyPortsReleased(): Promise<{
-        port: number;
-        released: boolean;
-    }[]>;
-    /**
-     * Check if a port is available.
-     */
-    private isPortAvailable;
-}
-/**
- * Get the global process manager (throws if not initialized).
- */
-export declare function getProcessManager(): ProcessManager;
-/**
- * Initialize the global process manager.
- */
-export declare function initProcessManager(logger: Logger): ProcessManager;
-/**
- * Cleanup helper that can be called from signal handlers or error handlers.
- */
-export declare function cleanupAll(reason: string): Promise<void>;
-//# sourceMappingURL=process-manager.d.ts.map

package/dist/cmd/dev/process-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../../src/cmd/dev/process-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC9B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,OAAO,EAAE;QACR,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;QACjD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,GAAG,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC7B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,MAAM,EAAE;QACP,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAClC,CAAC;IACF,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAU3C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAK3C;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQnC;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAWpB;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAwE5D;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAgB3E;;OAEG;IACH,OAAO,CAAC,eAAe;CAUvB;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAGjE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D"}

package/dist/cmd/dev/process-manager.js

@@ -1,204 +0,0 @@
-/**
- * Process Manager for Dev Mode
- *
- * Tracks all spawned processes and ensures they're cleaned up on:
- * - Startup failure (any server fails to start)
- * - Runtime crash (uncaught exception)
- * - Graceful shutdown (SIGINT/SIGTERM)
- *
- * This prevents orphan processes and port conflicts between dev sessions.
- */
-/**
- * Process Manager
- *
- * Tracks all processes and servers started during dev mode and provides
- * centralized cleanup on failure or shutdown.
- */
-export class ProcessManager {
-    processes = [];
-    servers = [];
-    logger;
-    cleaningUp = false;
-    constructor(logger) {
-        this.logger = logger;
-    }
-    /**
-     * Register a spawned process for tracking.
-     */
-    registerProcess(proc) {
-        this.processes.push(proc);
-        this.logger.debug('Registered process: %s (pid=%s, port=%s)', proc.id, proc.process.pid ?? 'unknown', proc.port ?? 'n/a');
-    }
-    /**
-     * Register a server for tracking.
-     */
-    registerServer(server) {
-        this.servers.push(server);
-        this.logger.debug('Registered server: %s (port=%s)', server.id, server.port ?? 'n/a');
-    }
-    /**
-     * Unregister a process (e.g., after it exits normally).
-     */
-    unregisterProcess(id) {
-        const idx = this.processes.findIndex((p) => p.id === id);
-        if (idx !== -1) {
-            this.processes.splice(idx, 1);
-            this.logger.debug('Unregistered process: %s', id);
-        }
-    }
-    /**
-     * Unregister a server.
-     */
-    unregisterServer(id) {
-        const idx = this.servers.findIndex((s) => s.id === id);
-        if (idx !== -1) {
-            this.servers.splice(idx, 1);
-            this.logger.debug('Unregistered server: %s', id);
-        }
-    }
-    /**
-     * Get all registered ports (for cleanup verification).
-     */
-    getPorts() {
-        const ports = [];
-        for (const proc of this.processes) {
-            if (proc.port)
-                ports.push(proc.port);
-        }
-        for (const server of this.servers) {
-            if (server.port)
-                ports.push(server.port);
-        }
-        return ports;
-    }
-    /**
-     * Clean up all tracked processes and servers.
-     *
-     * @param reason - Why cleanup is happening (for logging)
-     * @param timeout - Max time to wait for graceful shutdown (ms)
-     */
-    async cleanup(reason, timeout = 3000) {
-        if (this.cleaningUp) {
-            this.logger.debug('Cleanup already in progress, skipping');
-            return;
-        }
-        this.cleaningUp = true;
-        this.logger.debug('Starting cleanup (reason: %s)', reason);
-        // Kill processes in reverse order (LIFO)
-        for (let i = this.processes.length - 1; i >= 0; i--) {
-            const proc = this.processes[i];
-            if (!proc)
-                continue;
-            try {
-                if (proc.process.exitCode === null) {
-                    this.logger.debug('Killing process %s (pid=%s)', proc.id, proc.process.pid ?? 'unknown');
-                    proc.process.kill('SIGTERM');
-                }
-            }
-            catch (err) {
-                this.logger.debug('Error killing process %s: %s', proc.id, err);
-            }
-        }
-        // Close servers
-        for (let i = this.servers.length - 1; i >= 0; i--) {
-            const server = this.servers[i];
-            if (!server)
-                continue;
-            try {
-                this.logger.debug('Closing server %s', server.id);
-                const closePromise = server.server.close();
-                if (closePromise instanceof Promise) {
-                    await Promise.race([
-                        closePromise,
-                        new Promise((resolve) => setTimeout(resolve, 1000)),
-                    ]);
-                }
-            }
-            catch (err) {
-                this.logger.debug('Error closing server %s: %s', server.id, err);
-            }
-        }
-        // Wait for processes to exit, then force-kill if needed
-        const startTime = Date.now();
-        while (Date.now() - startTime < timeout) {
-            const allExited = this.processes.every((p) => p.process.exitCode !== null);
-            if (allExited)
-                break;
-            await new Promise((resolve) => setTimeout(resolve, 100));
-        }
-        // Force kill any remaining
-        for (const proc of this.processes) {
-            if (proc.process.exitCode === null) {
-                try {
-                    this.logger.debug('Force killing process %s', proc.id);
-                    proc.process.kill('SIGKILL');
-                }
-                catch (err) {
-                    this.logger.debug('Error force killing process %s: %s', proc.id, err);
-                }
-            }
-        }
-        this.logger.debug('Cleanup complete');
-        this.processes = [];
-        this.servers = [];
-    }
-    /**
-     * Verify that all ports used by tracked processes are released.
-     * Used after cleanup to ensure no orphan processes remain.
-     */
-    async verifyPortsReleased() {
-        const results = [];
-        const ports = this.getPorts();
-        for (const port of ports) {
-            const released = await this.isPortAvailable(port);
-            results.push({ port, released });
-            if (!released) {
-                this.logger.warn('Port %d is still in use after cleanup', port);
-            }
-        }
-        return results;
-    }
-    /**
-     * Check if a port is available.
-     */
-    isPortAvailable(port, host = '127.0.0.1') {
-        return new Promise((resolve) => {
-            const net = require('node:net');
-            const server = net.createServer();
-            server.once('error', () => resolve(false));
-            server.listen(port, host, () => {
-                server.close(() => resolve(true));
-            });
-        });
-    }
-}
-/**
- * Global process manager instance for dev mode.
- * Set in dev/index.ts during startup.
- */
-let globalProcessManager = null;
-/**
- * Get the global process manager (throws if not initialized).
- */
-export function getProcessManager() {
-    if (!globalProcessManager) {
-        throw new Error('ProcessManager not initialized. Call initProcessManager first.');
-    }
-    return globalProcessManager;
-}
-/**
- * Initialize the global process manager.
- */
-export function initProcessManager(logger) {
-    globalProcessManager = new ProcessManager(logger);
-    return globalProcessManager;
-}
-/**
- * Cleanup helper that can be called from signal handlers or error handlers.
- */
-export async function cleanupAll(reason) {
-    if (globalProcessManager) {
-        await globalProcessManager.cleanup(reason);
-    }
-}
-//# sourceMappingURL=process-manager.js.map