@grunnverk/tree-execution 1.0.0

package/dist/TreeExecutor.d.ts

@@ -0,0 +1,113 @@
+/**
+ * TreeExecutor - Class-based tree command orchestration
+ *
+ * Refactored from tree.ts to use instance state instead of global state
+ * and dependency injection for commands.
+ */
+import type { TreeExecutionConfig } from './types/config.js';
+/**
+ * Published version tracking
+ */
+export interface PublishedVersion {
+    packageName: string;
+    version: string;
+    publishTime: Date;
+}
+/**
+ * Tree execution context for persistence
+ */
+export interface TreeExecutionContext {
+    command: string;
+    originalConfig: TreeExecutionConfig;
+    publishedVersions: PublishedVersion[];
+    completedPackages: string[];
+    buildOrder: string[];
+    startTime: Date;
+    lastUpdateTime: Date;
+}
+/**
+ * Command executor interface for dependency injection
+ */
+export interface CommandExecutor {
+    execute(config: TreeExecutionConfig, mode?: string): Promise<any>;
+}
+/**
+ * Command registry for built-in commands
+ */
+export interface CommandRegistry {
+    updates?: CommandExecutor;
+    commit?: CommandExecutor;
+    link?: CommandExecutor;
+    unlink?: CommandExecutor;
+}
+/**
+ * TreeExecutor options
+ */
+export interface TreeExecutorOptions {
+    /**
+     * Command registry for dependency injection
+     */
+    commands?: CommandRegistry;
+    /**
+     * Custom logger (optional)
+     */
+    logger?: any;
+}
+/**
+ * TreeExecutor - Orchestrates tree command execution
+ *
+ * This class encapsulates all state that was previously global,
+ * making it testable and allowing multiple concurrent executions.
+ */
+export declare class TreeExecutor {
+    private publishedVersions;
+    private executionContext;
+    private stateMutex;
+    private commands;
+    private logger;
+    constructor(options?: TreeExecutorOptions);
+    /**
+     * Get published versions (thread-safe)
+     */
+    getPublishedVersions(): Promise<PublishedVersion[]>;
+    /**
+     * Add published version (thread-safe)
+     */
+    addPublishedVersion(version: PublishedVersion): Promise<void>;
+    /**
+     * Get execution context (thread-safe)
+     * Returns a deep copy to prevent external modifications
+     */
+    getExecutionContext(): Promise<TreeExecutionContext | null>;
+    /**
+     * Set execution context (thread-safe)
+     */
+    setExecutionContext(context: TreeExecutionContext | null): Promise<void>;
+    /**
+     * Reset state (for testing)
+     */
+    reset(): Promise<void>;
+    /**
+     * Execute tree command
+     *
+     * This will be the main entry point, delegating to the execute function
+     * from tree.ts but with instance state instead of global state.
+     *
+     * @param config - Tree execution configuration
+     * @returns Result message
+     */
+    execute(config: TreeExecutionConfig): Promise<string>;
+    /**
+     * Get command executor
+     */
+    getCommand(name: keyof CommandRegistry): CommandExecutor | undefined;
+    /**
+     * Set command executor (for testing/injection)
+     */
+    setCommand(name: keyof CommandRegistry, executor: CommandExecutor): void;
+}
+/**
+ * Create a default TreeExecutor instance
+ */
+export declare function createTreeExecutor(options?: TreeExecutorOptions): TreeExecutor;
+//# sourceMappingURL=TreeExecutor.d.ts.map

package/dist/TreeExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeExecutor.d.ts","sourceRoot":"","sources":["../src/TreeExecutor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,mBAAmB,CAAC;IACpC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,UAAU,CAAc;IAGhC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAM;gBAER,OAAO,GAAE,mBAAwB;IAM7C;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMzD;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnE;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAcjE;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9E;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;;;;;;;OAQG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAU3D;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,eAAe,GAAG,eAAe,GAAG,SAAS;IAIpE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,eAAe,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;CAG3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAE9E"}

package/dist/TreeExecutor.js

@@ -0,0 +1,113 @@
+/**
+ * TreeExecutor - Class-based tree command orchestration
+ *
+ * Refactored from tree.ts to use instance state instead of global state
+ * and dependency injection for commands.
+ */
+import { SimpleMutex } from './util/mutex.js';
+/**
+ * TreeExecutor - Orchestrates tree command execution
+ *
+ * This class encapsulates all state that was previously global,
+ * making it testable and allowing multiple concurrent executions.
+ */
+export class TreeExecutor {
+    // Instance state (previously global)
+    publishedVersions = [];
+    executionContext = null;
+    stateMutex;
+    // Dependency injection
+    commands;
+    logger;
+    constructor(options = {}) {
+        this.commands = options.commands || {};
+        this.logger = options.logger;
+        this.stateMutex = new SimpleMutex();
+    }
+    /**
+     * Get published versions (thread-safe)
+     */
+    async getPublishedVersions() {
+        return await this.stateMutex.runExclusive(async () => {
+            return [...this.publishedVersions];
+        });
+    }
+    /**
+     * Add published version (thread-safe)
+     */
+    async addPublishedVersion(version) {
+        await this.stateMutex.runExclusive(async () => {
+            this.publishedVersions.push(version);
+        });
+    }
+    /**
+     * Get execution context (thread-safe)
+     * Returns a deep copy to prevent external modifications
+     */
+    async getExecutionContext() {
+        return await this.stateMutex.runExclusive(async () => {
+            if (!this.executionContext)
+                return null;
+            // Return deep copy to prevent external modification
+            return {
+                ...this.executionContext,
+                publishedVersions: [...this.executionContext.publishedVersions],
+                completedPackages: [...this.executionContext.completedPackages],
+                buildOrder: [...this.executionContext.buildOrder]
+            };
+        });
+    }
+    /**
+     * Set execution context (thread-safe)
+     */
+    async setExecutionContext(context) {
+        await this.stateMutex.runExclusive(async () => {
+            this.executionContext = context;
+        });
+    }
+    /**
+     * Reset state (for testing)
+     */
+    async reset() {
+        await this.stateMutex.runExclusive(async () => {
+            this.publishedVersions = [];
+            this.executionContext = null;
+        });
+    }
+    /**
+     * Execute tree command
+     *
+     * This will be the main entry point, delegating to the execute function
+     * from tree.ts but with instance state instead of global state.
+     *
+     * @param config - Tree execution configuration
+     * @returns Result message
+     */
+    async execute(config) {
+        // Import the execute function from tree.ts
+        // We'll need to refactor tree.ts to accept TreeExecutor instance
+        const { execute } = await import('./tree.js');
+        // For now, this is a placeholder
+        // We'll refactor tree.ts to accept TreeExecutor in the next step
+        return await execute(config);
+    }
+    /**
+     * Get command executor
+     */
+    getCommand(name) {
+        return this.commands[name];
+    }
+    /**
+     * Set command executor (for testing/injection)
+     */
+    setCommand(name, executor) {
+        this.commands[name] = executor;
+    }
+}
+/**
+ * Create a default TreeExecutor instance
+ */
+export function createTreeExecutor(options) {
+    return new TreeExecutor(options);
+}
+//# sourceMappingURL=TreeExecutor.js.map

package/dist/TreeExecutor.js.map

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

package/dist/checkpoint/CheckpointManager.d.ts

@@ -0,0 +1,18 @@
+import type { ParallelExecutionCheckpoint } from '../types/index.js';
+export declare class CheckpointManager {
+    private checkpointPath;
+    private lockPath;
+    private tempPath;
+    private logger;
+    private storage;
+    constructor(outputDirectory?: string);
+    save(checkpoint: ParallelExecutionCheckpoint): Promise<void>;
+    load(): Promise<ParallelExecutionCheckpoint | null>;
+    backup(): Promise<void>;
+    cleanup(): Promise<void>;
+    private acquireLock;
+    private validateCheckpoint;
+    private isCompatibleVersion;
+    private loadBackup;
+}
+//# sourceMappingURL=CheckpointManager.d.ts.map

package/dist/checkpoint/CheckpointManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckpointManager.d.ts","sourceRoot":"","sources":["../../src/checkpoint/CheckpointManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AASrE,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAmB;gBAEtB,eAAe,GAAE,MAAsB;IAM7C,IAAI,CAAC,UAAU,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5D,IAAI,IAAI,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;IAoCnD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IASvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAahB,WAAW;IAqCzB,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,mBAAmB;YAOb,UAAU;CAa3B"}

package/dist/checkpoint/CheckpointManager.js

@@ -0,0 +1,156 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { getLogger } from '../util/logger.js';
+import { createStorage } from '@grunnverk/shared';
+const CHECKPOINT_VERSION = '1.0.0';
+export class CheckpointManager {
+    checkpointPath;
+    lockPath;
+    tempPath;
+    logger = getLogger();
+    storage = createStorage();
+    constructor(outputDirectory = process.cwd()) {
+        this.checkpointPath = path.join(outputDirectory, '.kodrdriv-parallel-context.json');
+        this.lockPath = `${this.checkpointPath}.lock`;
+        this.tempPath = `${this.checkpointPath}.tmp`;
+    }
+    async save(checkpoint) {
+        const lock = await this.acquireLock();
+        try {
+            // Set version and timestamp
+            checkpoint.version = CHECKPOINT_VERSION;
+            checkpoint.lastUpdated = new Date().toISOString();
+            // Validate before saving
+            this.validateCheckpoint(checkpoint);
+            // Write to temp file
+            const serialized = JSON.stringify(checkpoint, null, 2);
+            await fs.writeFile(this.tempPath, serialized, 'utf-8');
+            // Atomic rename
+            await fs.rename(this.tempPath, this.checkpointPath);
+            this.logger.debug(`Checkpoint saved: ${this.checkpointPath}`);
+        }
+        finally {
+            await lock.release();
+        }
+    }
+    async load() {
+        if (!await this.storage.exists(this.checkpointPath)) {
+            return null;
+        }
+        const lock = await this.acquireLock();
+        try {
+            const content = await fs.readFile(this.checkpointPath, 'utf-8');
+            const checkpoint = JSON.parse(content);
+            // Validate
+            this.validateCheckpoint(checkpoint);
+            // Check version
+            if (!this.isCompatibleVersion(checkpoint.version)) {
+                throw new Error(`Incompatible checkpoint version: ${checkpoint.version}`);
+            }
+            return checkpoint;
+        }
+        catch (error) {
+            this.logger.error(`CHECKPOINT_LOAD_FAILED: Failed to load checkpoint file | Error: ${error.message} | Impact: Cannot resume execution`);
+            // Try backup
+            const backup = await this.loadBackup();
+            if (backup) {
+                this.logger.info('CHECKPOINT_RECOVERED_BACKUP: Recovered from backup checkpoint | Source: backup | Status: loaded');
+                return backup;
+            }
+            return null;
+        }
+        finally {
+            await lock.release();
+        }
+    }
+    async backup() {
+        if (!await this.storage.exists(this.checkpointPath)) {
+            return;
+        }
+        const backupPath = `${this.checkpointPath}.backup`;
+        await fs.copyFile(this.checkpointPath, backupPath);
+    }
+    async cleanup() {
+        const files = [
+            this.checkpointPath,
+            this.lockPath,
+            this.tempPath,
+            `${this.checkpointPath}.backup`
+        ];
+        await Promise.all(files.map(file => fs.unlink(file).catch(() => { })));
+    }
+    async acquireLock() {
+        const maxWaitMs = 30000;
+        const startTime = Date.now();
+        while (true) {
+            try {
+                const fileHandle = await fs.open(this.lockPath, 'wx');
+                try {
+                    const pid = process.pid;
+                    const timestamp = new Date().toISOString();
+                    await fileHandle.writeFile(`${pid}\n${timestamp}`);
+                }
+                finally {
+                    await fileHandle.close();
+                }
+                return {
+                    release: async () => {
+                        await fs.unlink(this.lockPath).catch(() => { });
+                    }
+                };
+            }
+            catch (error) {
+                if (error.code !== 'EEXIST') {
+                    throw error;
+                }
+                const elapsed = Date.now() - startTime;
+                if (elapsed > maxWaitMs) {
+                    this.logger.warn('CHECKPOINT_LOCK_STALE: Breaking stale checkpoint lock | Reason: Lock expired | Action: Force break lock');
+                    await fs.unlink(this.lockPath).catch(() => { });
+                    continue;
+                }
+                await new Promise(resolve => setTimeout(resolve, 100));
+            }
+        }
+    }
+    validateCheckpoint(checkpoint) {
+        if (!checkpoint.executionId) {
+            throw new Error('Invalid checkpoint: missing executionId');
+        }
+        if (!checkpoint.state) {
+            throw new Error('Invalid checkpoint: missing state');
+        }
+        // Validate state consistency
+        const allPackages = new Set([
+            ...checkpoint.state.pending,
+            ...checkpoint.state.ready,
+            ...checkpoint.state.running.map(r => r.name),
+            ...checkpoint.state.completed,
+            ...checkpoint.state.failed.map(f => f.name),
+            ...checkpoint.state.skipped
+        ]);
+        if (allPackages.size !== checkpoint.buildOrder.length) {
+            this.logger.warn('CHECKPOINT_INCONSISTENCY: Checkpoint state inconsistency detected | Issue: State validation failed | Impact: May need manual recovery');
+        }
+    }
+    isCompatibleVersion(version) {
+        // Simple major version check
+        const [major] = version.split('.');
+        const [expectedMajor] = CHECKPOINT_VERSION.split('.');
+        return major === expectedMajor;
+    }
+    async loadBackup() {
+        const backupPath = `${this.checkpointPath}.backup`;
+        if (!await this.storage.exists(backupPath)) {
+            return null;
+        }
+        try {
+            const content = await fs.readFile(backupPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=CheckpointManager.js.map

package/dist/checkpoint/CheckpointManager.js.map

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

package/dist/checkpoint/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Checkpoint management for parallel execution
+ */
+export { CheckpointManager } from './CheckpointManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/checkpoint/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkpoint/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/checkpoint/index.js

@@ -0,0 +1,5 @@
+/**
+ * Checkpoint management for parallel execution
+ */
+export { CheckpointManager } from './CheckpointManager.js';
+//# sourceMappingURL=index.js.map

package/dist/checkpoint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/checkpoint/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/execution/CommandValidator.d.ts

@@ -0,0 +1,25 @@
+export interface ValidationResult {
+    valid: boolean;
+    issues: string[];
+    warnings: string[];
+    recommendations: string[];
+}
+/**
+ * CommandValidator checks if commands are safe for parallel execution
+ */
+export declare class CommandValidator {
+    private static logger;
+    /**
+     * Validate a command for parallel execution
+     */
+    static validateForParallel(command: string, builtInCommand?: string): ValidationResult;
+    /**
+     * Log validation results
+     */
+    static logValidation(result: ValidationResult): void;
+    /**
+     * Get recommended concurrency for a command type
+     */
+    static getRecommendedConcurrency(builtInCommand?: string, cpuCount?: number, command?: string): number;
+}
+//# sourceMappingURL=CommandValidator.d.ts.map

package/dist/execution/CommandValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandValidator.d.ts","sourceRoot":"","sources":["../../src/execution/CommandValidator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAe;IAEpC;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAoEtF;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAuBpD;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;CAuC5G"}

package/dist/execution/CommandValidator.js

@@ -0,0 +1,129 @@
+import { getLogger } from '../util/logger.js';
+/**
+ * CommandValidator checks if commands are safe for parallel execution
+ */
+export class CommandValidator {
+    static logger = getLogger();
+    /**
+     * Validate a command for parallel execution
+     */
+    static validateForParallel(command, builtInCommand) {
+        const issues = [];
+        const warnings = [];
+        const recommendations = [];
+        // Check for inherently unsafe operations
+        const unsafePatterns = [
+            { pattern: /git\s+checkout/, message: 'Branch switching is not safe for parallel execution' },
+            { pattern: /git\s+switch/, message: 'Branch switching is not safe for parallel execution' },
+            { pattern: /git\s+rebase/, message: 'Rebase operations should not run in parallel' },
+            { pattern: /git\s+merge/, message: 'Merge operations should not run in parallel' },
+            { pattern: /rm\s+-rf\s+\//, message: 'Dangerous deletion commands detected' },
+            { pattern: /sudo/, message: 'Sudo commands should not run in parallel' },
+            { pattern: /format/, message: 'Format commands may be destructive' }
+        ];
+        for (const { pattern, message } of unsafePatterns) {
+            if (pattern.test(command)) {
+                issues.push(message);
+            }
+        }
+        // Check for potentially problematic operations
+        const warningPatterns = [
+            { pattern: /npm\s+(link|unlink)/, message: 'npm link/unlink may conflict in parallel execution' },
+            { pattern: /npm\s+install/, message: 'npm install in parallel may cause lock file conflicts' },
+            { pattern: /npm\s+ci/, message: 'npm ci in parallel may cause lock file conflicts' },
+            { pattern: /package-lock\.json/, message: 'Operations modifying package-lock.json may conflict' },
+            { pattern: /node_modules/, message: 'Operations in node_modules may conflict' }
+        ];
+        for (const { pattern, message } of warningPatterns) {
+            if (pattern.test(command)) {
+                warnings.push(message);
+            }
+        }
+        // Built-in command specific checks
+        if (builtInCommand === 'commit') {
+            warnings.push('Parallel commits: Recommend max concurrency of 2 to avoid conflicts');
+            recommendations.push('Use: --max-concurrency 2');
+        }
+        if (builtInCommand === 'publish') {
+            warnings.push('Parallel publish: PR checks may take significant time');
+            warnings.push('Version propagation happens automatically between dependency levels');
+            recommendations.push('Use: --max-concurrency 2-3 for publish operations');
+            recommendations.push('Monitor with: kodrdriv tree --status-parallel');
+        }
+        if (builtInCommand === 'link' || builtInCommand === 'unlink') {
+            warnings.push('Link operations may have filesystem race conditions');
+            recommendations.push('Consider sequential execution for link/unlink');
+        }
+        // Check for output redirection
+        if (command.includes('>') || command.includes('>>')) {
+            warnings.push('Output redirection in parallel may interleave output');
+        }
+        return {
+            valid: issues.length === 0,
+            issues,
+            warnings,
+            recommendations
+        };
+    }
+    /**
+     * Log validation results
+     */
+    static logValidation(result) {
+        if (!result.valid) {
+            this.logger.error('VALIDATOR_FAILED: Command validation failed for parallel execution | Error Count: ' + result.issues.length + ' | Impact: Cannot proceed safely');
+            for (const issue of result.issues) {
+                this.logger.error(`VALIDATOR_ERROR_DETAIL: Validation issue | Issue: ${issue}`);
+            }
+        }
+        if (result.warnings.length > 0) {
+            this.logger.warn('VALIDATOR_WARNINGS: Command validation warnings for parallel execution | Warning Count: ' + result.warnings.length + ' | Impact: May cause issues');
+            for (const warning of result.warnings) {
+                this.logger.warn(`VALIDATOR_WARNING_DETAIL: Validation warning | Warning: ${warning}`);
+            }
+        }
+        if (result.recommendations.length > 0 && this.logger.verbose) {
+            this.logger.info('VALIDATOR_RECOMMENDATIONS: Command validation recommendations | Count: ' + result.recommendations.length + ' | Purpose: Improve parallel execution');
+            for (const rec of result.recommendations) {
+                this.logger.info(`VALIDATOR_RECOMMENDATION_DETAIL: ${rec}`);
+            }
+        }
+    }
+    /**
+     * Get recommended concurrency for a command type
+     */
+    static getRecommendedConcurrency(builtInCommand, cpuCount = 4, command) {
+        // If command is provided, check for memory-intensive patterns
+        if (command) {
+            const memoryIntensivePatterns = [
+                { pattern: /npm\s+test/, message: 'Test execution is memory intensive' },
+                { pattern: /npm\s+run\s+test/, message: 'Test execution is memory intensive' },
+                { pattern: /vitest/, message: 'Vitest execution is memory intensive' },
+                { pattern: /coverage/, message: 'Coverage generation is memory intensive' },
+                { pattern: /npm\s+run\s+precommit/, message: 'Precommit tasks (build+lint+test) are resource intensive' }
+            ];
+            for (const { pattern } of memoryIntensivePatterns) {
+                if (pattern.test(command)) {
+                    // Return lower concurrency for memory intensive tasks: 25% of CPUs, min 2, max 4
+                    const recommended = Math.max(2, Math.min(4, Math.floor(cpuCount * 0.25)));
+                    return Math.min(recommended, cpuCount);
+                }
+            }
+        }
+        switch (builtInCommand) {
+            case 'commit':
+                // Lower concurrency for commit to reduce conflicts
+                return Math.min(2, cpuCount);
+            case 'publish':
+                // Moderate concurrency for publish (long-running)
+                return Math.max(2, Math.floor(cpuCount / 2));
+            case 'link':
+            case 'unlink':
+                // Very conservative for link operations
+                return 1; // Sequential recommended
+            default:
+                // Full concurrency for general commands
+                return cpuCount;
+        }
+    }
+}
+//# sourceMappingURL=CommandValidator.js.map

package/dist/execution/CommandValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandValidator.js","sourceRoot":"","sources":["../../src/execution/CommandValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAS9C;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACjB,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;IAEpC;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAe,EAAE,cAAuB;QAC/D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,yCAAyC;QACzC,MAAM,cAAc,GAAG;YACnB,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,qDAAqD,EAAE;YAC7F,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,qDAAqD,EAAE;YAC3F,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,8CAA8C,EAAE;YACpF,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,6CAA6C,EAAE;YAClF,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,sCAAsC,EAAE;YAC7E,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,0CAA0C,EAAE;YACxE,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,oCAAoC,EAAE;SACvE,CAAC;QAEF,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,cAAc,EAAE,CAAC;YAChD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACL,CAAC;QAED,+CAA+C;QAC/C,MAAM,eAAe,GAAG;YACpB,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,oDAAoD,EAAE;YACjG,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,uDAAuD,EAAE;YAC9F,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,kDAAkD,EAAE;YACpF,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,qDAAqD,EAAE;YACjG,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,yCAAyC,EAAE;SAClF,CAAC;QAEF,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,eAAe,EAAE,CAAC;YACjD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;QAED,mCAAmC;QACnC,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;YACrF,eAAe,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;YACvE,QAAQ,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;YACrF,eAAe,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;YAC1E,eAAe,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,cAAc,KAAK,MAAM,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;YAC3D,QAAQ,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YACrE,eAAe,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC1E,CAAC;QAED,+BAA+B;QAC/B,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO;YACH,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;YACR,eAAe;SAClB,CAAC;IACN,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAwB;QACzC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oFAAoF,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,kCAAkC,CAAC,CAAC;YACpK,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,KAAK,EAAE,CAAC,CAAC;YACpF,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0FAA0F,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,6BAA6B,CAAC,CAAC;YACtK,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2DAA2D,OAAO,EAAE,CAAC,CAAC;YAC3F,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,IAAK,IAAI,CAAC,MAAc,CAAC,OAAO,EAAE,CAAC;YACpE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yEAAyE,GAAG,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,wCAAwC,CAAC,CAAC;YACvK,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBACvC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;YAChE,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,cAAuB,EAAE,WAAmB,CAAC,EAAE,OAAgB;QAC5F,8DAA8D;QAC9D,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,uBAAuB,GAAG;gBAC5B,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,oCAAoC,EAAE;gBACxE,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,oCAAoC,EAAE;gBAC9E,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,sCAAsC,EAAE;gBACtE,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,yCAAyC,EAAE;gBAC3E,EAAE,OAAO,EAAE,uBAAuB,EAAE,OAAO,EAAE,0DAA0D,EAAE;aAC5G,CAAC;YAEF,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,uBAAuB,EAAE,CAAC;gBAChD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBACxB,iFAAiF;oBACjF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;oBAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;gBAC3C,CAAC;YACL,CAAC;QACL,CAAC;QAED,QAAQ,cAAc,EAAE,CAAC;YACrB,KAAK,QAAQ;gBACT,mDAAmD;gBACnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAEjC,KAAK,SAAS;gBACV,kDAAkD;gBAClD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;YAEjD,KAAK,MAAM,CAAC;YACZ,KAAK,QAAQ;gBACT,wCAAwC;gBACxC,OAAO,CAAC,CAAC,CAAC,yBAAyB;YAEvC;gBACI,wCAAwC;gBACxC,OAAO,QAAQ,CAAC;QACxB,CAAC;IACL,CAAC"}

package/dist/execution/DependencyChecker.d.ts

@@ -0,0 +1,47 @@
+import type { DependencyGraph } from '@grunnverk/tree-core';
+import type { ExecutionState } from '../types/index.js';
+/**
+ * DependencyChecker validates package readiness and provides dependency information
+ * for the task pool scheduler.
+ */
+export declare class DependencyChecker {
+    private graph;
+    constructor(graph: DependencyGraph);
+    /**
+     * Check if a package is ready to execute
+     * A package is ready when all its dependencies are completed and none have failed
+     */
+    isReady(packageName: string, state: ExecutionState): boolean;
+    /**
+     * Get count of packages that depend on this one
+     * Higher count = higher priority (unlocks more packages)
+     */
+    getDependentCount(packageName: string): number;
+    /**
+     * Get depth of package in dependency tree
+     * Depth = longest path from a root package (package with no dependencies)
+     * Lower depth = higher priority (can unlock dependent packages sooner)
+     */
+    getDepth(packageName: string): number;
+    /**
+     * Get all dependencies for a package
+     */
+    getDependencies(packageName: string): Set<string>;
+    /**
+     * Get all dependents (packages that depend on this one)
+     */
+    getDependents(packageName: string): Set<string>;
+    /**
+     * Check if package has any dependencies
+     */
+    hasDependencies(packageName: string): boolean;
+    /**
+     * Check if package has any dependents
+     */
+    hasDependents(packageName: string): boolean;
+    /**
+     * Get packages that are blocked by a failed package
+     */
+    getBlockedPackages(failedPackage: string, state: ExecutionState): Set<string>;
+}
+//# sourceMappingURL=DependencyChecker.d.ts.map