@windagency/valora 2.0.1

package/dist/exploration/safety-validator.js

@@ -0,0 +1,339 @@
+/**
+ * Safety Validator - Pre-flight validation checks
+ *
+ * Performs comprehensive safety checks before starting an exploration
+ */
+import { exec } from 'child_process';
+import * as os from 'os';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+export class SafetyValidator {
+    config;
+    repoRoot;
+    constructor(repoRoot, config) {
+        this.repoRoot = repoRoot ?? process.cwd();
+        this.config = this.buildConfig(config);
+    }
+    /**
+     * Build configuration with defaults
+     */
+    buildConfig(config) {
+        const defaults = {
+            check_docker: true,
+            min_disk_space_gb: 5,
+            min_memory_gb_per_branch: 2,
+            require_clean_tree: true,
+            require_updated_main: true
+        };
+        return {
+            ...defaults,
+            ...config
+        };
+    }
+    /**
+     * Run all safety validations
+     */
+    async validate(branches = 1) {
+        const checks = [];
+        const errors = [];
+        const warnings = [];
+        // 1. Git state check
+        await this.runSafetyCheck('Git State', () => this.checkGitState(), checks, errors);
+        // 2. Docker availability check
+        if (this.config.check_docker) {
+            await this.runSafetyCheck('Docker Availability', () => this.checkDockerAvailability(), checks, errors);
+        }
+        // 3. Resource availability check
+        await this.runSafetyCheck('Resource Availability', () => this.checkResourceAvailability(branches), checks, errors);
+        // 4. Disk space check
+        await this.runSafetyCheck('Disk Space', () => this.checkDiskSpace(), checks, errors);
+        const passed = checks.every((check) => check.passed);
+        return {
+            checks,
+            errors,
+            passed,
+            warnings
+        };
+    }
+    /**
+     * Run a safety check with error handling
+     */
+    async runSafetyCheck(checkName, checkFn, checks, errors) {
+        try {
+            const result = await checkFn();
+            checks.push(result);
+            if (!result.passed) {
+                errors.push(result.message);
+            }
+        }
+        catch (error) {
+            const typedError = error;
+            checks.push({
+                message: `${checkName} check failed: ${typedError.message}`,
+                name: checkName,
+                passed: false
+            });
+            errors.push(`${checkName} validation failed: ${typedError.message}`);
+        }
+    }
+    /**
+     * Check git repository state
+     */
+    async checkGitState() {
+        const state = await this.getGitState();
+        // Check if working tree is clean (if required)
+        if (this.config.require_clean_tree && !state.is_clean) {
+            return {
+                details: state,
+                message: `Working tree has ${state.uncommitted_changes} uncommitted changes. Commit or stash changes before creating explorations.`,
+                name: 'Git Working Tree',
+                passed: false
+            };
+        }
+        // Check if on a valid branch (not detached HEAD)
+        if (!state.current_branch || state.current_branch === 'HEAD') {
+            return {
+                details: state,
+                message: 'Not on a valid branch (detached HEAD). Checkout a branch first.',
+                name: 'Git Working Tree',
+                passed: false
+            };
+        }
+        // Check if main branch is up to date (if required)
+        if (this.config.require_updated_main && !state.main_branch_up_to_date) {
+            return {
+                details: state,
+                message: 'Main branch is not up to date. Pull latest changes before creating explorations.',
+                name: 'Git Working Tree',
+                passed: false
+            };
+        }
+        return {
+            details: state,
+            message: 'Git repository state is valid',
+            name: 'Git Working Tree',
+            passed: true
+        };
+    }
+    /**
+     * Check Docker availability
+     */
+    async checkDockerAvailability() {
+        try {
+            // Check if Docker daemon is running
+            const { stdout } = await execAsync('docker info');
+            // Extract Docker version
+            const versionMatch = stdout.match(/Server Version: (.+)/);
+            const version = versionMatch?.[1] ?? 'unknown';
+            // Check version (require >= 20.10)
+            if (version === 'unknown') {
+                return {
+                    details: { version },
+                    message: 'Could not determine Docker version',
+                    name: 'Docker Availability',
+                    passed: false
+                };
+            }
+            const versionParts = version.split('.');
+            const majorVersion = parseInt(versionParts[0] ?? '0');
+            const minorVersion = parseInt(versionParts[1] ?? '0');
+            if (majorVersion < 20 || (majorVersion === 20 && minorVersion < 10)) {
+                return {
+                    details: { version },
+                    message: `Docker version ${version} is too old. Require >= 20.10`,
+                    name: 'Docker Availability',
+                    passed: false
+                };
+            }
+            return {
+                details: { version },
+                message: `Docker ${version} is available and running`,
+                name: 'Docker Availability',
+                passed: true
+            };
+        }
+        catch (error) {
+            const typedError = error;
+            return {
+                details: { error: typedError.message },
+                message: 'Docker is not running or not installed',
+                name: 'Docker Availability',
+                passed: false
+            };
+        }
+    }
+    /**
+     * Check resource availability
+     */
+    async checkResourceAvailability(branches) {
+        const resources = await this.getResourceAvailability();
+        // Calculate required resources
+        const requiredMemoryGb = branches * this.config.min_memory_gb_per_branch * 1.2; // 20% buffer
+        const requiredCpuCores = branches;
+        // Check memory
+        if (resources.available_memory_gb < requiredMemoryGb) {
+            return {
+                details: resources,
+                message: `Insufficient memory: ${resources.available_memory_gb.toFixed(1)}GB available, ${requiredMemoryGb.toFixed(1)}GB required for ${branches} branches`,
+                name: 'Resource Availability',
+                passed: false
+            };
+        }
+        // Check CPU
+        if (resources.available_cpu_cores < requiredCpuCores) {
+            return {
+                details: resources,
+                message: `Insufficient CPU: ${resources.available_cpu_cores} cores available, ${requiredCpuCores} required for ${branches} branches`,
+                name: 'Resource Availability',
+                passed: false
+            };
+        }
+        return {
+            details: resources,
+            message: `Sufficient resources available (${resources.available_memory_gb.toFixed(1)}GB RAM, ${resources.available_cpu_cores} CPU cores)`,
+            name: 'Resource Availability',
+            passed: true
+        };
+    }
+    /**
+     * Check available disk space
+     */
+    async checkDiskSpace() {
+        try {
+            // Get disk usage for current directory
+            const { stdout } = await execAsync(`df -BG "${this.repoRoot}" | tail -1`);
+            const parts = stdout.trim().split(/\s+/);
+            const availableStr = parts[3]; // Available column
+            if (!availableStr) {
+                throw new Error('Unable to parse disk space output');
+            }
+            const availableGb = parseInt(availableStr.replace('G', ''));
+            if (availableGb < this.config.min_disk_space_gb) {
+                return {
+                    details: { available_gb: availableGb },
+                    message: `Insufficient disk space: ${availableGb}GB available, ${this.config.min_disk_space_gb}GB required`,
+                    name: 'Disk Space',
+                    passed: false
+                };
+            }
+            return {
+                details: { available_gb: availableGb },
+                message: `Sufficient disk space available (${availableGb}GB)`,
+                name: 'Disk Space',
+                passed: true
+            };
+        }
+        catch (error) {
+            // Fallback: assume disk space is okay if check fails
+            const typedError = error;
+            return {
+                details: { error: typedError.message },
+                message: 'Disk space check skipped (unable to verify)',
+                name: 'Disk Space',
+                passed: true
+            };
+        }
+    }
+    /**
+     * Get git repository state
+     */
+    async getGitState() {
+        try {
+            // Check if working tree is clean
+            const { stdout: statusOutput } = await execAsync('git status --porcelain', {
+                cwd: this.repoRoot
+            });
+            const uncommittedChanges = statusOutput
+                .trim()
+                .split('\n')
+                .filter((line) => line).length;
+            // Get current branch
+            const { stdout: branchOutput } = await execAsync('git branch --show-current', {
+                cwd: this.repoRoot
+            });
+            const currentBranch = branchOutput.trim();
+            // Get existing worktrees
+            const { stdout: worktreeOutput } = await execAsync('git worktree list --porcelain', {
+                cwd: this.repoRoot
+            });
+            const existingWorktrees = this.parseWorktreePaths(worktreeOutput);
+            // Check if main branch is up to date (basic check)
+            let mainBranchUpToDate = true;
+            try {
+                await execAsync('git fetch origin main:main', {
+                    cwd: this.repoRoot
+                });
+            }
+            catch {
+                // If fetch fails, assume it's okay (might not have origin/main)
+                mainBranchUpToDate = true;
+            }
+            return {
+                current_branch: currentBranch,
+                existing_worktrees: existingWorktrees,
+                is_clean: uncommittedChanges === 0,
+                main_branch_up_to_date: mainBranchUpToDate,
+                uncommitted_changes: uncommittedChanges
+            };
+        }
+        catch (error) {
+            const typedError = error;
+            throw new Error(`Failed to get git state: ${typedError.message}`);
+        }
+    }
+    /**
+     * Get resource availability
+     */
+    async getResourceAvailability() {
+        // Get available memory
+        const freeMemory = os.freemem();
+        const availableMemoryGb = freeMemory / 1024 ** 3;
+        // Get available CPU cores
+        const availableCpuCores = os.cpus().length;
+        // Check if Docker is running
+        let dockerRunning = false;
+        let dockerVersion;
+        try {
+            const { stdout } = await execAsync('docker version --format "{{.Server.Version}}"');
+            dockerVersion = stdout.trim();
+            dockerRunning = true;
+        }
+        catch {
+            dockerRunning = false;
+        }
+        // Get available disk space (simplified, just check current directory)
+        let availableDiskGb = 0;
+        try {
+            const { stdout } = await execAsync(`df -BG "${this.repoRoot}" | tail -1`);
+            const parts = stdout.trim().split(/\s+/);
+            const availableStr = parts[3];
+            if (availableStr) {
+                availableDiskGb = parseInt(availableStr.replace('G', ''));
+            }
+        }
+        catch {
+            // Default to 0 if check fails
+        }
+        return {
+            available_cpu_cores: availableCpuCores,
+            available_disk_gb: availableDiskGb,
+            available_memory_gb: availableMemoryGb,
+            docker_running: dockerRunning,
+            docker_version: dockerVersion
+        };
+    }
+    /**
+     * Parse worktree paths from git worktree list output
+     */
+    parseWorktreePaths(output) {
+        const paths = [];
+        const lines = output.split('\n');
+        for (const line of lines) {
+            if (line.startsWith('worktree ')) {
+                paths.push(line.substring(9));
+            }
+        }
+        return paths;
+    }
+}
+//# sourceMappingURL=safety-validator.js.map

package/dist/exploration/safety-validator.js.map

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

package/dist/exploration/shared-volume-manager.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Shared Volume Manager - Initialize and manage shared volumes for collaboration
+ *
+ * Sets up the shared volume structure that allows agents to collaborate
+ */
+export interface SharedVolumeStructure {
+    decisions_pool_path: string;
+    insights_pool_path: string;
+    locks_dir: string;
+    root_path: string;
+    worktree_data_dirs: string[];
+}
+export declare class SharedVolumeManager {
+    private explorationId;
+    private sharedVolumePath;
+    constructor(sharedVolumePath: string, explorationId: string);
+    /**
+     * Initialize the shared volume structure
+     */
+    initialize(worktreeCount: number): Promise<SharedVolumeStructure>;
+    /**
+     * Initialize insights pool file
+     */
+    private initializeInsightsPool;
+    /**
+     * Initialize decisions pool file
+     */
+    private initializeDecisionsPool;
+    /**
+     * Initialize worktree data directory
+     */
+    private initializeWorktreeData;
+    /**
+     * Create README file explaining the shared volume structure
+     */
+    private createReadme;
+    /**
+     * Get shared volume paths
+     */
+    getPaths(): {
+        decisions_pool: string;
+        insights_pool: string;
+        locks_dir: string;
+        root: string;
+        worktreeData: (index: number) => string;
+    };
+    /**
+     * Clean up shared volume (remove all files)
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Validate shared volume structure
+     */
+    validate(): Promise<{
+        errors: string[];
+        missing_files: string[];
+        valid: boolean;
+    }>;
+    /**
+     * Get shared volume size in bytes
+     */
+    getSize(): Promise<number>;
+    /**
+     * Get formatted size
+     */
+    getFormattedSize(): Promise<string>;
+    /**
+     * Archive shared volume to a tar.gz file
+     */
+    archive(outputPath: string): Promise<void>;
+}
+//# sourceMappingURL=shared-volume-manager.d.ts.map

package/dist/exploration/shared-volume-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-volume-manager.d.ts","sourceRoot":"","sources":["../../src/exploration/shared-volume-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,WAAW,qBAAqB;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAK3D;;OAEG;IACG,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAyCvE;;OAEG;YACW,sBAAsB;IAYpC;;OAEG;YACW,uBAAuB;IAYrC;;OAEG;YACW,sBAAsB;IA0DpC;;OAEG;YACW,YAAY;IAoD1B;;OAEG;IACH,QAAQ,IAAI;QACX,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;KACxC;IAUD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,EAAE,OAAO,CAAC;KACf,CAAC;IAoDF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA6BhC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAYzC;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBhD"}