@bhimudev/gnanai 0.4.0

package/dist/utils/file-merger.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Merge strategy types.
+ */
+export type MergeStrategy = 'union_arrays' | 'append' | 'replace' | 'manual' | 'skip';
+/**
+ * Result of a merge operation.
+ */
+export interface MergeResult {
+    success: boolean;
+    merged: string;
+    strategy: MergeStrategy;
+    changes: string[];
+    conflicts: string[];
+}
+/**
+ * Settings file structure (settings.local.json).
+ */
+export interface SettingsFile {
+    permissions?: {
+        allow?: string[];
+        deny?: string[];
+    };
+    [key: string]: unknown;
+}
+/**
+ * Determine the merge strategy for a file based on its path.
+ */
+export declare function getMergeStrategy(filePath: string): MergeStrategy;
+/**
+ * Check if a file type supports automatic merging.
+ */
+export declare function canAutoMerge(filePath: string): boolean;
+/**
+ * Deduplicate an array while preserving order.
+ */
+export declare function dedupeArray<T>(arr: T[]): T[];
+/**
+ * Merge two settings files by unioning arrays and preserving user keys.
+ */
+export declare function mergeSettings(existing: SettingsFile, template: SettingsFile): MergeResult;
+/**
+ * Merge two JSON files with array union strategy.
+ */
+export declare function mergeJson(existing: Record<string, unknown>, template: Record<string, unknown>): MergeResult;
+/**
+ * Merge gitignore files by appending new entries.
+ */
+export declare function mergeGitignore(existing: string, template: string): MergeResult;
+/**
+ * Merge a file based on its type.
+ */
+export declare function mergeFile(existingPath: string, templatePath: string): Promise<MergeResult>;
+/**
+ * Preview what a merge would do without applying it.
+ */
+export declare function previewMerge(existingPath: string, templatePath: string): Promise<{
+    strategy: MergeStrategy;
+    canAutoMerge: boolean;
+    changes: string[];
+    conflicts: string[];
+}>;
+/**
+ * Apply a merge result to a file.
+ */
+export declare function applyMerge(filePath: string, result: MergeResult): Promise<boolean>;
+/**
+ * Copy a new file from template.
+ */
+export declare function copyNewFile(templatePath: string, targetPath: string): Promise<boolean>;
+/**
+ * Format merge changes for display.
+ */
+export declare function formatMergeChanges(result: MergeResult): string[];
+//# sourceMappingURL=file-merger.d.ts.map

package/dist/utils/file-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-merger.d.ts","sourceRoot":"","sources":["../../src/utils/file-merger.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAqChE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAE5C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,WAAW,CA2DzF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAuB3G;AAiDD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAyC9E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,CAoEtB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IACT,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC,CA6BD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAcxF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU5F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAkBhE"}

package/dist/utils/file-merger.js

@@ -0,0 +1,350 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { logger } from './logger.js';
+/**
+ * Determine the merge strategy for a file based on its path.
+ */
+export function getMergeStrategy(filePath) {
+    const normalized = filePath.replace(/\\/g, '/').toLowerCase();
+    const basename = path.basename(normalized);
+    const ext = path.extname(normalized);
+    // Generated specialists - never touch
+    if (normalized.includes('.claude/agents/') && normalized.endsWith('-specialist.md')) {
+        return 'skip';
+    }
+    // Settings files - can merge arrays
+    if (basename === 'settings.local.json' || basename === 'settings.json') {
+        return 'union_arrays';
+    }
+    // Gitignore - append new entries
+    if (basename === '.gitignore') {
+        return 'append';
+    }
+    // Other JSON files - try union arrays
+    if (ext === '.json') {
+        return 'union_arrays';
+    }
+    // Markdown config files - manual merge needed
+    if (basename === 'archai.config.md') {
+        return 'manual';
+    }
+    // Core agent markdown files - manual merge
+    if (ext === '.md' && normalized.includes('.claude/agents/')) {
+        return 'manual';
+    }
+    // Default - replace
+    return 'replace';
+}
+/**
+ * Check if a file type supports automatic merging.
+ */
+export function canAutoMerge(filePath) {
+    const strategy = getMergeStrategy(filePath);
+    return strategy === 'union_arrays' || strategy === 'append' || strategy === 'replace';
+}
+/**
+ * Deduplicate an array while preserving order.
+ */
+export function dedupeArray(arr) {
+    return [...new Set(arr)];
+}
+/**
+ * Merge two settings files by unioning arrays and preserving user keys.
+ */
+export function mergeSettings(existing, template) {
+    const changes = [];
+    const conflicts = [];
+    try {
+        // Start with existing as base
+        const merged = { ...existing };
+        // Merge permissions
+        if (template.permissions || existing.permissions) {
+            merged.permissions = merged.permissions || {};
+            // Merge allow arrays
+            const existingAllow = existing.permissions?.allow || [];
+            const templateAllow = template.permissions?.allow || [];
+            const mergedAllow = dedupeArray([...existingAllow, ...templateAllow]);
+            if (mergedAllow.length > existingAllow.length) {
+                const newAllows = templateAllow.filter(a => !existingAllow.includes(a));
+                changes.push(`Added ${newAllows.length} allow rules: ${newAllows.join(', ')}`);
+            }
+            merged.permissions.allow = mergedAllow;
+            // Merge deny arrays
+            const existingDeny = existing.permissions?.deny || [];
+            const templateDeny = template.permissions?.deny || [];
+            const mergedDeny = dedupeArray([...existingDeny, ...templateDeny]);
+            if (mergedDeny.length > existingDeny.length) {
+                const newDenies = templateDeny.filter(d => !existingDeny.includes(d));
+                changes.push(`Added ${newDenies.length} deny rules: ${newDenies.join(', ')}`);
+            }
+            merged.permissions.deny = mergedDeny;
+        }
+        // Add any new top-level keys from template that don't exist in existing
+        for (const [key, value] of Object.entries(template)) {
+            if (key !== 'permissions' && !(key in existing)) {
+                merged[key] = value;
+                changes.push(`Added new key: ${key}`);
+            }
+        }
+        return {
+            success: true,
+            merged: JSON.stringify(merged, null, 2),
+            strategy: 'union_arrays',
+            changes,
+            conflicts,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            merged: JSON.stringify(existing, null, 2),
+            strategy: 'union_arrays',
+            changes: [],
+            conflicts: [`Merge failed: ${error instanceof Error ? error.message : String(error)}`],
+        };
+    }
+}
+/**
+ * Merge two JSON files with array union strategy.
+ */
+export function mergeJson(existing, template) {
+    const changes = [];
+    const conflicts = [];
+    try {
+        const merged = deepMerge(existing, template, changes);
+        return {
+            success: true,
+            merged: JSON.stringify(merged, null, 2),
+            strategy: 'union_arrays',
+            changes,
+            conflicts,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            merged: JSON.stringify(existing, null, 2),
+            strategy: 'union_arrays',
+            changes: [],
+            conflicts: [`Merge failed: ${error instanceof Error ? error.message : String(error)}`],
+        };
+    }
+}
+/**
+ * Deep merge two objects, unioning arrays.
+ */
+function deepMerge(existing, template, changes, path = '') {
+    const result = { ...existing };
+    for (const [key, templateValue] of Object.entries(template)) {
+        const currentPath = path ? `${path}.${key}` : key;
+        const existingValue = existing[key];
+        if (!(key in existing)) {
+            // New key from template
+            result[key] = templateValue;
+            changes.push(`Added: ${currentPath}`);
+        }
+        else if (Array.isArray(templateValue) && Array.isArray(existingValue)) {
+            // Union arrays
+            const merged = dedupeArray([...existingValue, ...templateValue]);
+            if (merged.length > existingValue.length) {
+                changes.push(`Extended array: ${currentPath} (+${merged.length - existingValue.length} items)`);
+            }
+            result[key] = merged;
+        }
+        else if (typeof templateValue === 'object' &&
+            templateValue !== null &&
+            typeof existingValue === 'object' &&
+            existingValue !== null &&
+            !Array.isArray(templateValue)) {
+            // Recursively merge objects
+            result[key] = deepMerge(existingValue, templateValue, changes, currentPath);
+        }
+        // Otherwise keep existing value (user's value takes precedence)
+    }
+    return result;
+}
+/**
+ * Merge gitignore files by appending new entries.
+ */
+export function mergeGitignore(existing, template) {
+    const changes = [];
+    // Parse existing entries (ignore comments and empty lines for comparison)
+    const existingLines = existing.split('\n').map(l => l.trim());
+    const existingEntries = new Set(existingLines.filter(l => l && !l.startsWith('#')));
+    // Parse template entries
+    const templateLines = template.split('\n').map(l => l.trim());
+    const templateEntries = templateLines.filter(l => l && !l.startsWith('#'));
+    // Find new entries
+    const newEntries = templateEntries.filter(e => !existingEntries.has(e));
+    if (newEntries.length === 0) {
+        return {
+            success: true,
+            merged: existing,
+            strategy: 'append',
+            changes: [],
+            conflicts: [],
+        };
+    }
+    // Append new entries with a section header
+    const mergedLines = [
+        existing.trimEnd(),
+        '',
+        '# Added by archai',
+        ...newEntries,
+    ];
+    changes.push(`Added ${newEntries.length} entries: ${newEntries.join(', ')}`);
+    return {
+        success: true,
+        merged: mergedLines.join('\n'),
+        strategy: 'append',
+        changes,
+        conflicts: [],
+    };
+}
+/**
+ * Merge a file based on its type.
+ */
+export async function mergeFile(existingPath, templatePath) {
+    const strategy = getMergeStrategy(existingPath);
+    // Skip generated files
+    if (strategy === 'skip') {
+        return {
+            success: true,
+            merged: '',
+            strategy: 'skip',
+            changes: ['Skipped (generated file)'],
+            conflicts: [],
+        };
+    }
+    // Manual merge needed
+    if (strategy === 'manual') {
+        return {
+            success: false,
+            merged: '',
+            strategy: 'manual',
+            changes: [],
+            conflicts: ['Manual merge required'],
+        };
+    }
+    try {
+        const existingContent = await fs.readFile(existingPath, 'utf-8');
+        const templateContent = await fs.readFile(templatePath, 'utf-8');
+        // Handle different strategies
+        if (strategy === 'append') {
+            return mergeGitignore(existingContent, templateContent);
+        }
+        if (strategy === 'union_arrays') {
+            const basename = path.basename(existingPath).toLowerCase();
+            // Special handling for settings.local.json
+            if (basename === 'settings.local.json' || basename === 'settings.json') {
+                const existingJson = JSON.parse(existingContent);
+                const templateJson = JSON.parse(templateContent);
+                return mergeSettings(existingJson, templateJson);
+            }
+            // Generic JSON merge
+            const existingJson = JSON.parse(existingContent);
+            const templateJson = JSON.parse(templateContent);
+            return mergeJson(existingJson, templateJson);
+        }
+        // Replace strategy - just use template
+        return {
+            success: true,
+            merged: templateContent,
+            strategy: 'replace',
+            changes: ['Replaced with template'],
+            conflicts: [],
+        };
+    }
+    catch (error) {
+        logger.debug(`Merge failed for ${existingPath}`, error);
+        return {
+            success: false,
+            merged: '',
+            strategy,
+            changes: [],
+            conflicts: [`Failed to merge: ${error instanceof Error ? error.message : String(error)}`],
+        };
+    }
+}
+/**
+ * Preview what a merge would do without applying it.
+ */
+export async function previewMerge(existingPath, templatePath) {
+    const strategy = getMergeStrategy(existingPath);
+    if (strategy === 'skip') {
+        return {
+            strategy,
+            canAutoMerge: false,
+            changes: ['Will skip (generated file)'],
+            conflicts: [],
+        };
+    }
+    if (strategy === 'manual') {
+        return {
+            strategy,
+            canAutoMerge: false,
+            changes: [],
+            conflicts: ['Requires manual merge'],
+        };
+    }
+    const result = await mergeFile(existingPath, templatePath);
+    return {
+        strategy: result.strategy,
+        canAutoMerge: result.success,
+        changes: result.changes,
+        conflicts: result.conflicts,
+    };
+}
+/**
+ * Apply a merge result to a file.
+ */
+export async function applyMerge(filePath, result) {
+    if (!result.success || result.strategy === 'skip' || result.strategy === 'manual') {
+        return false;
+    }
+    try {
+        await fs.ensureDir(path.dirname(filePath));
+        await fs.writeFile(filePath, result.merged, 'utf-8');
+        logger.debug(`Applied merge to ${filePath}`);
+        return true;
+    }
+    catch (error) {
+        logger.debug(`Failed to apply merge to ${filePath}`, error);
+        return false;
+    }
+}
+/**
+ * Copy a new file from template.
+ */
+export async function copyNewFile(templatePath, targetPath) {
+    try {
+        await fs.ensureDir(path.dirname(targetPath));
+        await fs.copy(templatePath, targetPath);
+        logger.debug(`Copied new file: ${targetPath}`);
+        return true;
+    }
+    catch (error) {
+        logger.debug(`Failed to copy ${templatePath} to ${targetPath}`, error);
+        return false;
+    }
+}
+/**
+ * Format merge changes for display.
+ */
+export function formatMergeChanges(result) {
+    const lines = [];
+    if (result.changes.length > 0) {
+        lines.push('Changes:');
+        for (const change of result.changes) {
+            lines.push(`  + ${change}`);
+        }
+    }
+    if (result.conflicts.length > 0) {
+        lines.push('Conflicts:');
+        for (const conflict of result.conflicts) {
+            lines.push(`  ! ${conflict}`);
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=file-merger.js.map

package/dist/utils/file-merger.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,26 @@
+export declare const logger: {
+    /**
+     * Enable or disable debug mode for verbose logging.
+     */
+    setDebugMode(enabled: boolean): void;
+    /**
+     * Check if debug mode is enabled.
+     */
+    isDebugMode(): boolean;
+    /**
+     * Get the current version from package.json.
+     */
+    getVersion(): string;
+    banner(): void;
+    section(title: string): void;
+    divider(): void;
+    success(message: string): void;
+    error(message: string): void;
+    warn(message: string): void;
+    info(message: string): void;
+    /**
+     * Log debug information. Only outputs when debug mode is enabled.
+     */
+    debug(message: string, data?: unknown): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,MAAM;IACjB;;OAEG;0BACmB,OAAO;IAI7B;;OAEG;mBACY,OAAO;IAItB;;OAEG;kBACW,MAAM;;mBAkBL,MAAM;;qBAQJ,MAAM;mBAIR,MAAM;kBAIP,MAAM;kBAIN,MAAM;IAIpB;;OAEG;mBACY,MAAM,SAAS,OAAO;CAYtC,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,72 @@
+import chalk from 'chalk';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+let debugMode = false;
+export const logger = {
+    /**
+     * Enable or disable debug mode for verbose logging.
+     */
+    setDebugMode(enabled) {
+        debugMode = enabled;
+    },
+    /**
+     * Check if debug mode is enabled.
+     */
+    isDebugMode() {
+        return debugMode;
+    },
+    /**
+     * Get the current version from package.json.
+     */
+    getVersion() {
+        return pkg.version;
+    },
+    banner() {
+        const version = pkg.version;
+        const versionStr = `archai v${version}`;
+        const padding = Math.max(0, 37 - versionStr.length - 11);
+        const paddedVersion = ' '.repeat(11) + versionStr + ' '.repeat(padding);
+        console.log('');
+        console.log(chalk.cyan.bold('  ╔═══════════════════════════════════════╗'));
+        console.log(chalk.cyan.bold('  ║') + chalk.white.bold(paddedVersion) + chalk.cyan.bold('║'));
+        console.log(chalk.cyan.bold('  ║') + chalk.gray('   Multi-Agent Development Workflow   ') + chalk.cyan.bold('║'));
+        console.log(chalk.cyan.bold('  ╚═══════════════════════════════════════╝'));
+        console.log('');
+    },
+    section(title) {
+        console.log(chalk.cyan.bold(`━━━ ${title} ━━━`));
+    },
+    divider() {
+        console.log(chalk.gray('━'.repeat(50)));
+    },
+    success(message) {
+        console.log(chalk.green.bold('✓ ' + message));
+    },
+    error(message) {
+        console.log(chalk.red.bold('✗ ' + message));
+    },
+    warn(message) {
+        console.log(chalk.yellow('⚠ ' + message));
+    },
+    info(message) {
+        console.log(chalk.blue('ℹ ' + message));
+    },
+    /**
+     * Log debug information. Only outputs when debug mode is enabled.
+     */
+    debug(message, data) {
+        if (debugMode) {
+            console.log(chalk.gray(`[DEBUG] ${message}`));
+            if (data !== undefined) {
+                if (typeof data === 'object') {
+                    console.log(chalk.gray(JSON.stringify(data, null, 2)));
+                }
+                else {
+                    console.log(chalk.gray(String(data)));
+                }
+            }
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/managed-process.d.ts

@@ -0,0 +1,109 @@
+import { EventEmitter } from 'events';
+import type { Readable } from 'stream';
+import type { ManagedProcessOpts, CompletionResult, ExitResult, HealthReport, ProcessStateData, KillResult } from '../types/index.js';
+export interface RegistryHook {
+    register: (mp: ManagedProcess) => void;
+    unregister: (id: string) => void;
+}
+export declare function setRegistryHook(hook: RegistryHook | null): void;
+/**
+ * Build a clean environment for the child process.
+ * Removes Claude Code internal env vars that cause hangs when leaked.
+ */
+export declare function buildCleanEnv(): NodeJS.ProcessEnv;
+/**
+ * Monitors stdout for stream-json formatted output.
+ * Parses JSON lines, detects result events, accumulates assistant text.
+ */
+export declare class StreamJsonMonitor {
+    private _assistantText;
+    private _rawLines;
+    private _resultCount;
+    private _eventCount;
+    private _lastEventTime;
+    private _rl;
+    readonly resultPromise: Promise<unknown>;
+    constructor(stdout: Readable);
+    getTextOutput(): string;
+    getLastEventTime(): number | null;
+    getEventCount(): number;
+    destroy(): void;
+}
+/**
+ * No-op monitor for passthrough stdout mode.
+ * resultPromise never resolves.
+ */
+export declare class PassthroughMonitor {
+    readonly resultPromise: Promise<never>;
+    constructor(_stdout: Readable);
+    getTextOutput(): string;
+    getLastEventTime(): number | null;
+    getEventCount(): number;
+    destroy(): void;
+}
+/**
+ * Manages state files for ManagedProcess instances.
+ * Uses atomic writes (write .tmp then renameSync).
+ */
+export declare class ProcessStateManager {
+    private _data;
+    private _filePath;
+    private _stateDir;
+    constructor(stateDir: string, id: string);
+    update(patch: Partial<ProcessStateData>): void;
+    getData(): Partial<ProcessStateData>;
+    static readAll(stateDir: string): ProcessStateData[];
+    static readOne(id: string, stateDir: string): ProcessStateData | null;
+    static pruneStale(stateDir: string): void;
+}
+/**
+ * Unified process lifecycle abstraction.
+ * Wraps child_process.spawn() with intrinsic monitoring:
+ * state files, stream-json sentinel, lifecycle guards, process tree snapshots.
+ */
+export declare class ManagedProcess extends EventEmitter {
+    private _child;
+    private _opts;
+    private _monitor;
+    private _stateManager;
+    private _cleanups;
+    private _killing;
+    private _timedOut;
+    private _parentDied;
+    private _startTime;
+    private _state;
+    readonly completion: Promise<CompletionResult>;
+    readonly exit: Promise<ExitResult>;
+    readonly pid: number;
+    private constructor();
+    /**
+     * Spawn a managed process. Factory method.
+     */
+    static spawn(opts: ManagedProcessOpts): ManagedProcess;
+    /**
+     * Get the process ID string (task identifier).
+     */
+    get id(): string;
+    /**
+     * Get current state.
+     */
+    get state(): ProcessStateData['state'];
+    /**
+     * Kill the process tree. Public async API.
+     */
+    kill(): Promise<KillResult>;
+    /**
+     * Get health report.
+     */
+    health(): HealthReport;
+    private _updateState;
+    private _setupGuards;
+    private _activateZombieGuard;
+    private _cleanupGuards;
+    private _killTree;
+    private _onSignal;
+    private _onTimeout;
+    private _onParentDeath;
+    private _takeTreeSnapshot;
+}
+//# sourceMappingURL=managed-process.d.ts.map

package/dist/utils/managed-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-process.d.ts","sourceRoot":"","sources":["../../src/utils/managed-process.ts"],"names":[],"mappings":"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"}