@windagency/valora 2.0.1

package/dist/exploration/shared-volume-manager.js

@@ -0,0 +1,303 @@
+/**
+ * Shared Volume Manager - Initialize and manage shared volumes for collaboration
+ *
+ * Sets up the shared volume structure that allows agents to collaborate
+ */
+import { promises as fs } from 'fs';
+import { getLogger } from '../output/logger.js';
+import * as path from 'path';
+import { ensureDir } from '../utils/file-utils.js';
+const logger = getLogger();
+export class SharedVolumeManager {
+    explorationId;
+    sharedVolumePath;
+    constructor(sharedVolumePath, explorationId) {
+        this.sharedVolumePath = sharedVolumePath;
+        this.explorationId = explorationId;
+    }
+    /**
+     * Initialize the shared volume structure
+     */
+    async initialize(worktreeCount) {
+        logger.info(`Initializing shared volume for exploration ${this.explorationId}`);
+        // Create root directory
+        await ensureDir(this.sharedVolumePath);
+        // Create locks directory
+        const locksDir = path.join(this.sharedVolumePath, 'locks');
+        await ensureDir(locksDir);
+        // Initialize insights pool
+        const insightsPoolPath = path.join(this.sharedVolumePath, 'insights-pool.json');
+        await this.initializeInsightsPool(insightsPoolPath);
+        // Initialize decisions pool
+        const decisionsPoolPath = path.join(this.sharedVolumePath, 'decisions-pool.json');
+        await this.initializeDecisionsPool(decisionsPoolPath);
+        // Create worktree data directories
+        const worktreeDataDirs = [];
+        for (let i = 1; i <= worktreeCount; i++) {
+            const worktreeDir = path.join(this.sharedVolumePath, `worktree-${i}`);
+            await this.initializeWorktreeData(worktreeDir, i);
+            worktreeDataDirs.push(worktreeDir);
+        }
+        // Create README for documentation
+        await this.createReadme();
+        const structure = {
+            decisions_pool_path: decisionsPoolPath,
+            insights_pool_path: insightsPoolPath,
+            locks_dir: locksDir,
+            root_path: this.sharedVolumePath,
+            worktree_data_dirs: worktreeDataDirs
+        };
+        logger.info(`Shared volume initialized at ${this.sharedVolumePath}`);
+        return structure;
+    }
+    /**
+     * Initialize insights pool file
+     */
+    async initializeInsightsPool(filePath) {
+        const pool = {
+            exploration_id: this.explorationId,
+            insights: [],
+            last_updated: new Date().toISOString(),
+            total_count: 0
+        };
+        await fs.writeFile(filePath, JSON.stringify(pool, null, 2), 'utf-8');
+        logger.debug(`Insights pool initialized: ${filePath}`);
+    }
+    /**
+     * Initialize decisions pool file
+     */
+    async initializeDecisionsPool(filePath) {
+        const pool = {
+            decisions: [],
+            exploration_id: this.explorationId,
+            last_updated: new Date().toISOString(),
+            total_count: 0
+        };
+        await fs.writeFile(filePath, JSON.stringify(pool, null, 2), 'utf-8');
+        logger.debug(`Decisions pool initialized: ${filePath}`);
+    }
+    /**
+     * Initialize worktree data directory
+     */
+    async initializeWorktreeData(worktreeDir, index) {
+        await ensureDir(worktreeDir);
+        // Create latest-insight.json
+        const latestInsightPath = path.join(worktreeDir, 'latest-insight.json');
+        await fs.writeFile(latestInsightPath, JSON.stringify({
+            insight: null,
+            last_updated: new Date().toISOString(),
+            worktree_index: index
+        }, null, 2), 'utf-8');
+        // Create metrics.json
+        const metricsPath = path.join(worktreeDir, 'metrics.json');
+        await fs.writeFile(metricsPath, JSON.stringify({
+            decisions_participated: 0,
+            insights_published: 0,
+            last_updated: new Date().toISOString(),
+            worktree_index: index
+        }, null, 2), 'utf-8');
+        // Create progress.json
+        const progressPath = path.join(worktreeDir, 'progress.json');
+        await fs.writeFile(progressPath, JSON.stringify({
+            current_stage: 'initializing',
+            errors: [],
+            last_updated: new Date().toISOString(),
+            percentage: 0,
+            stages_completed: [],
+            worktree_index: index
+        }, null, 2), 'utf-8');
+        logger.debug(`Worktree data initialized: ${worktreeDir}`);
+    }
+    /**
+     * Create README file explaining the shared volume structure
+     */
+    async createReadme() {
+        const readmePath = path.join(this.sharedVolumePath, 'README.md');
+        const content = `# Shared Exploration Volume
+
+This directory contains shared data for parallel exploration: ${this.explorationId}
+
+## Structure
+
+\`\`\`
+shared/
+├── README.md                  # This file
+├── insights-pool.json         # Aggregated insights from all agents
+├── decisions-pool.json        # Collaborative decisions
+├── locks/                     # File locks for coordination
+└── worktree-{N}/              # Per-worktree data
+    ├── latest-insight.json    # Most recent insight published
+    ├── metrics.json           # Worktree metrics
+    └── progress.json          # Progress tracking
+\`\`\`
+
+## Usage
+
+### Publishing Insights
+
+Agents write insights to \`insights-pool.json\` using the file locking mechanism.
+
+### Reading Insights
+
+Agents read from \`insights-pool.json\` to learn from other explorations.
+
+### Making Decisions
+
+Agents propose and vote on decisions via \`decisions-pool.json\`.
+
+### Tracking Progress
+
+Each worktree writes its progress to \`worktree-{N}/progress.json\` for monitoring.
+
+## File Locking
+
+All shared files use atomic operations with file locks (\`.lock\` files) to prevent race conditions.
+Locks automatically expire after 5 seconds.
+
+## Generated
+
+Created: ${new Date().toISOString()}
+Exploration ID: ${this.explorationId}
+`;
+        await fs.writeFile(readmePath, content, 'utf-8');
+    }
+    /**
+     * Get shared volume paths
+     */
+    getPaths() {
+        return {
+            decisions_pool: path.join(this.sharedVolumePath, 'decisions-pool.json'),
+            insights_pool: path.join(this.sharedVolumePath, 'insights-pool.json'),
+            locks_dir: path.join(this.sharedVolumePath, 'locks'),
+            root: this.sharedVolumePath,
+            worktreeData: (index) => path.join(this.sharedVolumePath, `worktree-${index}`)
+        };
+    }
+    /**
+     * Clean up shared volume (remove all files)
+     */
+    async cleanup() {
+        try {
+            logger.info(`Cleaning up shared volume: ${this.sharedVolumePath}`);
+            await fs.rm(this.sharedVolumePath, { force: true, recursive: true });
+            logger.info(`Shared volume cleaned up`);
+        }
+        catch (error) {
+            const typedError = error;
+            logger.error(`Failed to cleanup shared volume: ${typedError.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Validate shared volume structure
+     */
+    async validate() {
+        const missingFiles = [];
+        const errors = [];
+        try {
+            // Check root directory
+            try {
+                await fs.access(this.sharedVolumePath);
+            }
+            catch {
+                missingFiles.push(this.sharedVolumePath);
+            }
+            // Check insights pool
+            const insightsPoolPath = path.join(this.sharedVolumePath, 'insights-pool.json');
+            try {
+                await fs.access(insightsPoolPath);
+            }
+            catch {
+                missingFiles.push(insightsPoolPath);
+            }
+            // Check decisions pool
+            const decisionsPoolPath = path.join(this.sharedVolumePath, 'decisions-pool.json');
+            try {
+                await fs.access(decisionsPoolPath);
+            }
+            catch {
+                missingFiles.push(decisionsPoolPath);
+            }
+            // Check locks directory
+            const locksDir = path.join(this.sharedVolumePath, 'locks');
+            try {
+                await fs.access(locksDir);
+            }
+            catch {
+                missingFiles.push(locksDir);
+            }
+            return {
+                errors,
+                missing_files: missingFiles,
+                valid: missingFiles.length === 0 && errors.length === 0
+            };
+        }
+        catch (error) {
+            const typedError = error;
+            errors.push(typedError.message);
+            return {
+                errors,
+                missing_files: missingFiles,
+                valid: false
+            };
+        }
+    }
+    /**
+     * Get shared volume size in bytes
+     */
+    async getSize() {
+        let totalSize = 0;
+        async function calculateSize(dirPath) {
+            let size = 0;
+            try {
+                const entries = await fs.readdir(dirPath, { withFileTypes: true });
+                for (const entry of entries) {
+                    const entryPath = path.join(dirPath, entry.name);
+                    if (entry.isDirectory()) {
+                        size += await calculateSize(entryPath);
+                    }
+                    else if (entry.isFile()) {
+                        const stats = await fs.stat(entryPath);
+                        size += stats.size;
+                    }
+                }
+            }
+            catch (error) {
+                // Ignore errors
+            }
+            return size;
+        }
+        totalSize = await calculateSize(this.sharedVolumePath);
+        return totalSize;
+    }
+    /**
+     * Get formatted size
+     */
+    async getFormattedSize() {
+        const bytes = await this.getSize();
+        if (bytes === 0)
+            return '0 B';
+        const k = 1024;
+        const sizes = ['B', 'KB', 'MB', 'GB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return `${Math.round((bytes / Math.pow(k, i)) * 100) / 100} ${sizes[i]}`;
+    }
+    /**
+     * Archive shared volume to a tar.gz file
+     */
+    async archive(outputPath) {
+        const { exec } = await import('child_process');
+        const { promisify } = await import('util');
+        const execAsync = promisify(exec);
+        try {
+            logger.info(`Archiving shared volume to ${outputPath}`);
+            await execAsync(`tar -czf ${outputPath} -C ${path.dirname(this.sharedVolumePath)} ${path.basename(this.sharedVolumePath)}`);
+            logger.info(`Shared volume archived successfully`);
+        }
+        catch (error) {
+            const typedError = error;
+            throw new Error(`Failed to archive shared volume: ${typedError.message}`);
+        }
+    }
+}
+//# sourceMappingURL=shared-volume-manager.js.map

package/dist/exploration/shared-volume-manager.js.map

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

package/dist/exploration/worktree-manager-secure.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Worktree Manager (Security Hardened) - Git worktree CRUD operations
+ *
+ * SECURITY IMPROVEMENTS:
+ * - Command injection prevention (spawn instead of shell)
+ * - Input validation for all user-controlled parameters
+ * - Path traversal prevention
+ * - Race condition fixes (TOCTOU)
+ * - Retry logic for transient failures
+ * - Cleanup rollback on partial failures
+ */
+export interface CreateWorktreeOptions {
+    baseRef?: string;
+    branch: string;
+    force?: boolean;
+    path: string;
+}
+export interface WorktreeInfo {
+    branch: string;
+    commit: string;
+    path: string;
+    prunable: boolean;
+}
+/**
+ * Security-hardened WorktreeManager
+ *
+ * All security fixes from assessment applied
+ */
+export declare class WorktreeManager {
+    private repoRoot;
+    constructor(repoRoot?: string);
+    /**
+     * Create a new git worktree (SECURITY HARDENED)
+     *
+     * FIXES:
+     * - Command injection: Uses spawn with args array
+     * - Input validation: Validates branch name and path
+     * - Path traversal: Ensures path is within repo
+     * - TOCTOU: Removed pre-check, let git handle atomically
+     */
+    createWorktree(options: CreateWorktreeOptions): Promise<WorktreeInfo>;
+    /**
+     * List all git worktrees (SECURITY HARDENED)
+     */
+    listWorktrees(): Promise<WorktreeInfo[]>;
+    /**
+     * Get information about a specific worktree
+     */
+    getWorktreeInfo(worktreePath: string): Promise<WorktreeInfo>;
+    /**
+     * Remove a git worktree (SECURITY HARDENED)
+     */
+    removeWorktree(worktreePath: string, force?: boolean): Promise<void>;
+    /**
+     * Prune stale worktree administrative files
+     */
+    pruneWorktrees(): Promise<void>;
+    /**
+     * Check if a worktree exists
+     */
+    worktreeExists(worktreePath: string): Promise<boolean>;
+    /**
+     * Check if a branch name is available (SECURITY HARDENED)
+     */
+    isBranchNameAvailable(branchName: string): Promise<boolean>;
+    /**
+     * Get all exploration worktrees (prefixed with exploration/)
+     */
+    getExplorationWorktrees(): Promise<WorktreeInfo[]>;
+    /**
+     * Delete branch after worktree removal (SECURITY HARDENED)
+     */
+    deleteBranch(branchName: string, force?: boolean): Promise<void>;
+    /**
+     * Lock a worktree to prevent automatic pruning (SECURITY HARDENED)
+     */
+    lockWorktree(worktreePath: string, reason?: string): Promise<void>;
+    /**
+     * Unlock a worktree (SECURITY HARDENED)
+     */
+    unlockWorktree(worktreePath: string): Promise<void>;
+    /**
+     * Parse git worktree list --porcelain output
+     */
+    private parseWorktreeList;
+    /**
+     * Create multiple worktrees with rollback on failure (IMPROVED)
+     *
+     * RELIABILITY FIX: Rollback on partial failure
+     */
+    createMultipleWorktrees(optionsArray: CreateWorktreeOptions[]): Promise<WorktreeInfo[]>;
+    /**
+     * Remove multiple worktrees in parallel
+     */
+    removeMultipleWorktrees(paths: string[], force?: boolean): Promise<void>;
+    /**
+     * Get worktree status (clean, dirty, etc.) (SECURITY HARDENED)
+     */
+    getWorktreeStatus(worktreePath: string): Promise<{
+        clean: boolean;
+        uncommitted_changes: number;
+    }>;
+    /**
+     * Verify worktree limit hasn't been exceeded
+     *
+     * NEW: Prevents exhausting filesystem limits
+     */
+    checkWorktreeLimit(maxWorktrees?: number): Promise<void>;
+}
+//# sourceMappingURL=worktree-manager-secure.d.ts.map

package/dist/exploration/worktree-manager-secure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-manager-secure.d.ts","sourceRoot":"","sources":["../../src/exploration/worktree-manager-secure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,CAAC,EAAE,MAAM;IAI7B;;;;;;;;OAQG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAwC3E;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAa9C;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBlE;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBjF;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrC;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW5D;;OAEG;IACG,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcjE;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKxD;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7E;;OAEG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxE;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBzD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+BzB;;;;OAIG;IACG,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkC7F;;OAEG;IACG,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrF;;OAEG;IACG,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBvG;;;;OAIG;IACG,kBAAkB,CAAC,YAAY,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAUlE"}