@grunnverk/tree-execution 1.0.0

package/dist/util/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Simple logger interface for tree-execution
+ */
+export interface Logger {
+    info(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    verbose(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    silly(message: string, ...args: any[]): void;
+}
+export declare function setLogger(newLogger: Logger): void;
+export declare function getLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAChD;AAwBD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/util/logger.js

@@ -0,0 +1,30 @@
+/**
+ * Check if we're running in MCP server mode.
+ * When true, console output must be suppressed as it interferes with the MCP protocol.
+ */
+function isMcpServerMode() {
+    return process.env.KODRDRIV_MCP_SERVER === 'true';
+}
+/**
+ * Default logger that respects MCP server mode.
+ * In MCP mode, all output is suppressed (callers should configure a proper logger via setLogger).
+ * Outside MCP mode, logs go to console as usual.
+ */
+let logger = {
+    info: (...args) => { if (!isMcpServerMode())
+        console.log(...args); },
+    error: (...args) => { if (!isMcpServerMode())
+        console.error(...args); },
+    warn: (...args) => { if (!isMcpServerMode())
+        console.warn(...args); },
+    verbose: () => { },
+    debug: () => { },
+    silly: () => { } // Most verbose level, disabled by default
+};
+export function setLogger(newLogger) {
+    logger = newLogger;
+}
+export function getLogger() {
+    return logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,SAAS,eAAe;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,IAAI,MAAM,GAAW;IACjB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE;QAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,0CAA0C;CAC7D,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,SAAiB;IACvC,MAAM,GAAG,SAAS,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,SAAS;IACrB,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/util/mutex.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Simple mutex implementation for serializing async operations
+ * Prevents race conditions when multiple async operations need exclusive access
+ */
+export declare class SimpleMutex {
+    private locked;
+    private queue;
+    private destroyed;
+    /**
+     * Acquire the mutex lock
+     * If already locked, waits in queue until released
+     */
+    lock(): Promise<void>;
+    /**
+     * Release the mutex lock
+     * Allows next waiting operation in queue to proceed
+     */
+    unlock(): void;
+    /**
+     * Destroy the mutex and reject all waiting operations
+     * Prevents memory leaks when mutex is no longer needed
+     */
+    destroy(): void;
+    /**
+     * Check if mutex is currently locked
+     */
+    isLocked(): boolean;
+    /**
+     * Get number of operations waiting in queue
+     */
+    getQueueLength(): number;
+    /**
+     * Run a function with exclusive access (convenience method)
+     * Automatically acquires and releases the lock
+     */
+    runExclusive<T>(fn: () => Promise<T> | T): Promise<T>;
+}
+//# sourceMappingURL=mutex.d.ts.map

package/dist/util/mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.d.ts","sourceRoot":"","sources":["../../src/util/mutex.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAAS;IAE1B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;;OAGG;IACH,MAAM,IAAI,IAAI;IAuBd;;;OAGG;IACH,OAAO,IAAI,IAAI;IAkBf;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACG,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAQ9D"}

package/dist/util/mutex.js

@@ -0,0 +1,101 @@
+/**
+ * Simple mutex implementation for serializing async operations
+ * Prevents race conditions when multiple async operations need exclusive access
+ */
+export class SimpleMutex {
+    locked = false;
+    queue = [];
+    destroyed = false;
+    /**
+     * Acquire the mutex lock
+     * If already locked, waits in queue until released
+     */
+    async lock() {
+        return new Promise((resolve, reject) => {
+            if (this.destroyed) {
+                reject(new Error('Mutex has been destroyed'));
+                return;
+            }
+            if (!this.locked) {
+                this.locked = true;
+                resolve();
+            }
+            else {
+                this.queue.push(resolve);
+            }
+        });
+    }
+    /**
+     * Release the mutex lock
+     * Allows next waiting operation in queue to proceed
+     */
+    unlock() {
+        if (this.destroyed) {
+            return;
+        }
+        this.locked = false;
+        const next = this.queue.shift();
+        if (next) {
+            this.locked = true;
+            try {
+                next();
+            }
+            catch {
+                // If resolver throws, unlock and continue with next in queue
+                this.locked = false;
+                const nextInQueue = this.queue.shift();
+                if (nextInQueue) {
+                    this.locked = true;
+                    nextInQueue();
+                }
+            }
+        }
+    }
+    /**
+     * Destroy the mutex and reject all waiting operations
+     * Prevents memory leaks when mutex is no longer needed
+     */
+    destroy() {
+        this.destroyed = true;
+        this.locked = false;
+        // Reject all queued promises to prevent memory leaks
+        while (this.queue.length > 0) {
+            const resolve = this.queue.shift();
+            if (resolve) {
+                try {
+                    // Resolve with error state
+                    resolve();
+                }
+                catch {
+                    // Ignore errors during cleanup
+                }
+            }
+        }
+    }
+    /**
+     * Check if mutex is currently locked
+     */
+    isLocked() {
+        return this.locked;
+    }
+    /**
+     * Get number of operations waiting in queue
+     */
+    getQueueLength() {
+        return this.queue.length;
+    }
+    /**
+     * Run a function with exclusive access (convenience method)
+     * Automatically acquires and releases the lock
+     */
+    async runExclusive(fn) {
+        await this.lock();
+        try {
+            return await fn();
+        }
+        finally {
+            this.unlock();
+        }
+    }
+}
+//# sourceMappingURL=mutex.js.map

package/dist/util/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../src/util/mutex.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACZ,MAAM,GAAG,KAAK,CAAC;IACf,KAAK,GAAsB,EAAE,CAAC;IAC9B,SAAS,GAAG,KAAK,CAAC;IAE1B;;;OAGG;IACH,KAAK,CAAC,IAAI;QACN,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;gBAC9C,OAAO;YACX,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,OAAO,EAAE,CAAC;YACd,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACH,MAAM;QACF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO;QACX,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACP,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC;gBACD,IAAI,EAAE,CAAC;YACX,CAAC;YAAC,MAAM,CAAC;gBACL,6DAA6D;gBAC7D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;gBACpB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACvC,IAAI,WAAW,EAAE,CAAC;oBACd,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;oBACnB,WAAW,EAAE,CAAC;gBAClB,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,OAAO;QACH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QAEpB,qDAAqD;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC;oBACD,2BAA2B;oBAC3B,OAAO,EAAE,CAAC;gBACd,CAAC;gBAAC,MAAM,CAAC;oBACL,+BAA+B;gBACnC,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,cAAc;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAI,EAAwB;QAC1C,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC;IACL,CAAC;CACJ"}

package/dist/util/treeUtils.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Utility functions for tree.ts
+ * These are stubs/inlines of kodrdriv utilities
+ */
+import type { TreeExecutionConfig } from '../types/config.js';
+/**
+ * Get output path - can accept config or directory string
+ */
+export declare function getOutputPath(configOrDir: TreeExecutionConfig | string, filename?: string): string;
+/**
+ * Simple performance timer
+ */
+export declare class PerformanceTimer {
+    private startTime;
+    private label;
+    constructor(label: string);
+    end(): number;
+    getDuration(): number;
+}
+/**
+ * Check if in git repository
+ */
+export declare function isInGitRepository(dir: string): Promise<boolean>;
+/**
+ * Run git command with lock (simplified version)
+ */
+export declare function runGitWithLock<T>(fn: () => Promise<T>, _lockKey?: string): Promise<T>;
+/**
+ * Optimize precommit command (stub)
+ */
+export declare function optimizePrecommitCommand(_packagePath: string, command: string): Promise<{
+    optimizedCommand: string;
+    skipped: {
+        clean?: boolean;
+        test?: boolean;
+    };
+    reasons: {
+        clean?: string;
+        test?: string;
+    };
+}>;
+/**
+ * Record test run (stub)
+ */
+export declare function recordTestRun(_packagePath: string, _success?: boolean, _duration?: number): Promise<void>;
+//# sourceMappingURL=treeUtils.d.ts.map

package/dist/util/treeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeUtils.d.ts","sourceRoot":"","sources":["../../src/util/treeUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,mBAAmB,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlG;AAED;;GAEG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,EAAE,MAAM;IAKzB,GAAG,IAAI,MAAM;IAKb,WAAW,IAAI,MAAM;CAGxB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWrE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAClC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,CAAC,CAIZ;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC1C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC;IACP,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,CAAC,CAQD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAC/B,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,OAAO,EAClB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/util/treeUtils.js

@@ -0,0 +1,74 @@
+/**
+ * Utility functions for tree.ts
+ * These are stubs/inlines of kodrdriv utilities
+ */
+/**
+ * Get output path - can accept config or directory string
+ */
+export function getOutputPath(configOrDir, filename) {
+    const baseDir = typeof configOrDir === 'string'
+        ? configOrDir
+        : (configOrDir.outputDirectory || 'output/kodrdriv');
+    return filename ? `${baseDir}/${filename}` : baseDir;
+}
+/**
+ * Simple performance timer
+ */
+export class PerformanceTimer {
+    startTime;
+    label;
+    constructor(label) {
+        this.label = label;
+        this.startTime = Date.now();
+    }
+    end() {
+        const duration = Date.now() - this.startTime;
+        return duration;
+    }
+    getDuration() {
+        return Date.now() - this.startTime;
+    }
+}
+/**
+ * Check if in git repository
+ */
+export async function isInGitRepository(dir) {
+    // Simple check - could be enhanced
+    const fs = await import('fs/promises');
+    const path = await import('path');
+    try {
+        await fs.access(path.join(dir, '.git'));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run git command with lock (simplified version)
+ */
+export async function runGitWithLock(fn, _lockKey) {
+    // Simplified - just run the function
+    // In kodrdriv this uses a mutex to prevent concurrent git operations
+    return await fn();
+}
+/**
+ * Optimize precommit command (stub)
+ */
+export async function optimizePrecommitCommand(_packagePath, command) {
+    // Stub - return command as-is with no optimizations
+    // In kodrdriv this optimizes test commands based on previous runs
+    return {
+        optimizedCommand: command,
+        skipped: {},
+        reasons: {}
+    };
+}
+/**
+ * Record test run (stub)
+ */
+export async function recordTestRun(_packagePath, _success, _duration) {
+    // Stub - no-op
+    // In kodrdriv this records test results for optimization
+}
+//# sourceMappingURL=treeUtils.js.map

package/dist/util/treeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeUtils.js","sourceRoot":"","sources":["../../src/util/treeUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAyC,EAAE,QAAiB;IACtF,MAAM,OAAO,GAAG,OAAO,WAAW,KAAK,QAAQ;QAC3C,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,CAAC,WAAW,CAAC,eAAe,IAAI,iBAAiB,CAAC,CAAC;IAEzD,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACjB,SAAS,CAAS;IAClB,KAAK,CAAS;IAEtB,YAAY,KAAa;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,GAAG;QACC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7C,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,WAAW;QACP,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;IACvC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IAC/C,mCAAmC;IACnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAElC,IAAI,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,EAAoB,EACpB,QAAiB;IAEjB,qCAAqC;IACrC,qEAAqE;IACrE,OAAO,MAAM,EAAE,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,YAAoB,EACpB,OAAe;IAMf,oDAAoD;IACpD,kEAAkE;IAClE,OAAO;QACH,gBAAgB,EAAE,OAAO;QACzB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;KACd,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,YAAoB,EACpB,QAAkB,EAClB,SAAkB;IAElB,eAAe;IACf,yDAAyD;AAC7D,CAAC"}

package/guide/index.md

@@ -0,0 +1,84 @@
+# @grunnverk/tree-execution - Agentic Guide
+
+## Purpose
+
+Parallel execution framework and tree orchestration for monorepo workflows. Provides task pool management, checkpoint/recovery, and resource monitoring.
+
+## Key Features
+
+- **Parallel Execution** - Execute tasks across dependency graph in parallel
+- **Dynamic Task Pool** - Adaptive concurrency based on resources
+- **Checkpoint/Recovery** - Save and resume execution state
+- **Resource Monitoring** - Track CPU, memory, and disk usage
+- **Dependency Validation** - Ensure dependencies are met before execution
+- **Progress Tracking** - Real-time execution progress
+
+## Usage
+
+```typescript
+import { TreeExecutor, DynamicTaskPool } from '@grunnverk/tree-execution';
+
+// Create executor
+const executor = new TreeExecutor({
+  maxConcurrency: 4,
+  enableCheckpoint: true,
+  resourceLimits: {
+    maxMemory: 4096,
+    maxCpu: 80
+  }
+});
+
+// Execute tree command
+await executor.execute({
+  command: 'npm run build',
+  packages: graph.getTopologicalOrder()
+});
+
+// Resume from checkpoint
+await executor.resume('/path/to/checkpoint.json');
+```
+
+## Dependencies
+
+- @grunnverk/tree-core - Dependency graph
+- @grunnverk/git-tools - Git operations
+- @grunnverk/shared - Shared utilities
+
+## Package Structure
+
+```
+src/
+├── execution/                    # Execution engine
+│   ├── TreeExecutionAdapter.ts   # Execution adapter
+│   ├── DynamicTaskPool.ts        # Task pool
+│   ├── Scheduler.ts              # Task scheduler
+│   ├── ResourceMonitor.ts        # Resource monitoring
+│   ├── RecoveryManager.ts        # Recovery logic
+│   ├── DependencyChecker.ts      # Dependency validation
+│   └── CommandValidator.ts       # Command validation
+├── checkpoint/                   # Checkpoint management
+│   ├── CheckpointManager.ts      # Checkpoint logic
+│   └── index.ts
+├── util/                         # Utilities
+│   ├── treeUtils.ts              # Tree utilities
+│   ├── commandStubs.ts           # Command stubs
+│   ├── mutex.ts                  # Mutex implementation
+│   └── logger.ts                 # Logging
+├── types/                        # Type definitions
+│   ├── config.ts
+│   ├── parallelExecution.ts
+│   └── index.ts
+├── TreeExecutor.ts               # Main executor
+├── tree.ts                       # Tree command
+└── index.ts
+```
+
+## Key Exports
+
+- `TreeExecutor` - Main execution orchestrator
+- `DynamicTaskPool` - Adaptive task pool
+- `CheckpointManager` - Checkpoint/recovery
+- `ResourceMonitor` - Resource tracking
+- `executeTree()` - Execute tree command
+- `resumeExecution()` - Resume from checkpoint
+

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@grunnverk/tree-execution",
+  "version": "1.0.0",
+  "description": "Parallel execution framework and tree orchestration for monorepo workflows",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint 'src/**/*.ts' --ignore-pattern 'src/util/logger.ts'",
+    "clean": "rm -rf dist coverage",
+    "precommit": "npm run lint && npm run build && npm test",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "keywords": [
+    "parallel-execution",
+    "task-pool",
+    "dependency-graph",
+    "tree-command",
+    "monorepo",
+    "recovery",
+    "checkpoint"
+  ],
+  "author": "Tim O'Brien <tobrien@discursive.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grunnverk/tree-execution.git"
+  },
+  "bugs": {
+    "url": "https://github.com/grunnverk/tree-execution/issues"
+  },
+  "homepage": "https://github.com/grunnverk/tree-execution#readme",
+  "dependencies": {
+    "@grunnverk/tree-core": "^1.0.0",
+    "@grunnverk/git-tools": "^1.0.1",
+    "@grunnverk/shared": "^0.1.11"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.17.0",
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.18.1",
+    "@typescript-eslint/parser": "^8.18.1",
+    "@vitest/coverage-v8": "^4.0.16",
+    "eslint": "^9.17.0",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.5.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "files": [
+    "dist",
+    "guide",
+    "README.md",
+    "LICENSE"
+  ]
+}