@windagency/valora 2.0.1

package/dist/exploration/worktree-manager-secure.js

@@ -0,0 +1,347 @@
+/**
+ * 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
+ */
+import { DEFAULT_TIMEOUT_MS } from '../config/constants.js';
+import * as path from 'path';
+import { InputValidator } from '../utils/input-validator.js';
+import { RetryExecutor, SafeExecutor } from '../utils/safe-exec.js';
+/**
+ * Security-hardened WorktreeManager
+ *
+ * All security fixes from assessment applied
+ */
+export class WorktreeManager {
+    repoRoot;
+    constructor(repoRoot) {
+        this.repoRoot = repoRoot ?? process.cwd();
+    }
+    /**
+     * 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
+     */
+    async createWorktree(options) {
+        const { baseRef = 'HEAD', branch, force = false, path: worktreePath } = options;
+        // SECURITY: Validate inputs
+        InputValidator.validateBranchName(branch);
+        InputValidator.validateGitRef(baseRef);
+        const validatedPath = InputValidator.validatePath(worktreePath, this.repoRoot);
+        // Build git command args (NO shell interpolation)
+        const args = ['worktree', 'add'];
+        if (force) {
+            args.push('--force');
+        }
+        args.push('-b', branch, validatedPath, baseRef);
+        try {
+            // SECURITY: Use spawn instead of execAsync
+            // RELIABILITY: Add retry logic for transient failures
+            await RetryExecutor.withRetry(async () => {
+                const result = await SafeExecutor.executeGit(args, {
+                    cwd: this.repoRoot,
+                    timeout: DEFAULT_TIMEOUT_MS
+                });
+                // Git worktree add can output to stderr even on success
+                if (result.stderr && !result.stderr.includes('Preparing worktree')) {
+                    console.warn('Git worktree warning:', result.stderr);
+                }
+                return result;
+            }, 3);
+            // Get worktree info
+            return await this.getWorktreeInfo(validatedPath);
+        }
+        catch (error) {
+            const typedError = error;
+            throw new Error(`Failed to create worktree: ${typedError.message}`);
+        }
+    }
+    /**
+     * List all git worktrees (SECURITY HARDENED)
+     */
+    async listWorktrees() {
+        try {
+            const result = await SafeExecutor.executeGit(['worktree', 'list', '--porcelain'], {
+                cwd: this.repoRoot
+            });
+            return this.parseWorktreeList(result.stdout);
+        }
+        catch (error) {
+            const typedError = error;
+            throw new Error(`Failed to list worktrees: ${typedError.message}`);
+        }
+    }
+    /**
+     * Get information about a specific worktree
+     */
+    async getWorktreeInfo(worktreePath) {
+        // SECURITY: Validate path
+        const validatedPath = InputValidator.validatePath(worktreePath, this.repoRoot);
+        const worktrees = await this.listWorktrees();
+        const absolutePath = path.resolve(validatedPath);
+        const worktree = worktrees.find((wt) => path.resolve(wt.path) === absolutePath);
+        if (!worktree) {
+            throw new Error(`Worktree not found: ${worktreePath}`);
+        }
+        return worktree;
+    }
+    /**
+     * Remove a git worktree (SECURITY HARDENED)
+     */
+    async removeWorktree(worktreePath, force = false) {
+        // SECURITY: Validate path
+        const validatedPath = InputValidator.validatePath(worktreePath, this.repoRoot);
+        const args = ['worktree', 'remove'];
+        if (force) {
+            args.push('--force');
+        }
+        args.push(validatedPath);
+        try {
+            await SafeExecutor.executeGit(args, {
+                cwd: this.repoRoot
+            });
+        }
+        catch (error) {
+            const typedError = error;
+            // If worktree doesn't exist, that's okay
+            if (typedError.message.includes('not a working tree')) {
+                console.warn(`Worktree ${worktreePath} does not exist, skipping removal`);
+                return;
+            }
+            throw new Error(`Failed to remove worktree: ${typedError.message}`);
+        }
+    }
+    /**
+     * Prune stale worktree administrative files
+     */
+    async pruneWorktrees() {
+        try {
+            await SafeExecutor.executeGit(['worktree', 'prune'], {
+                cwd: this.repoRoot
+            });
+        }
+        catch (error) {
+            const typedError = error;
+            throw new Error(`Failed to prune worktrees: ${typedError.message}`);
+        }
+    }
+    /**
+     * Check if a worktree exists
+     */
+    async worktreeExists(worktreePath) {
+        try {
+            // SECURITY: Validate path before checking
+            const validatedPath = InputValidator.validatePath(worktreePath, this.repoRoot);
+            await this.getWorktreeInfo(validatedPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if a branch name is available (SECURITY HARDENED)
+     */
+    async isBranchNameAvailable(branchName) {
+        // SECURITY: Validate branch name
+        InputValidator.validateBranchName(branchName);
+        try {
+            const result = await SafeExecutor.executeGit(['branch', '--list', branchName], {
+                cwd: this.repoRoot
+            });
+            return result.stdout.trim() === '';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get all exploration worktrees (prefixed with exploration/)
+     */
+    async getExplorationWorktrees() {
+        const allWorktrees = await this.listWorktrees();
+        return allWorktrees.filter((wt) => wt.branch.includes('exploration/'));
+    }
+    /**
+     * Delete branch after worktree removal (SECURITY HARDENED)
+     */
+    async deleteBranch(branchName, force = false) {
+        // SECURITY: Validate branch name
+        InputValidator.validateBranchName(branchName);
+        const args = ['branch', force ? '-D' : '-d', branchName];
+        try {
+            await SafeExecutor.executeGit(args, {
+                cwd: this.repoRoot
+            });
+        }
+        catch (error) {
+            const typedError = error;
+            // If branch doesn't exist, that's okay
+            if (typedError.message.includes('not found')) {
+                console.warn(`Branch ${branchName} does not exist, skipping deletion`);
+                return;
+            }
+            throw new Error(`Failed to delete branch: ${typedError.message}`);
+        }
+    }
+    /**
+     * Lock a worktree to prevent automatic pruning (SECURITY HARDENED)
+     */
+    async lockWorktree(worktreePath, reason) {
+        // SECURITY: Validate path and sanitize reason
+        const validatedPath = InputValidator.validatePath(worktreePath, this.repoRoot);
+        const sanitizedReason = InputValidator.validateReasonText(reason ?? 'Locked by exploration system');
+        const args = ['worktree', 'lock', validatedPath, '--reason', sanitizedReason];
+        try {
+            await SafeExecutor.executeGit(args, {
+                cwd: this.repoRoot
+            });
+        }
+        catch (error) {
+            const typedError = error;
+            throw new Error(`Failed to lock worktree: ${typedError.message}`);
+        }
+    }
+    /**
+     * Unlock a worktree (SECURITY HARDENED)
+     */
+    async unlockWorktree(worktreePath) {
+        // SECURITY: Validate path
+        const validatedPath = InputValidator.validatePath(worktreePath, this.repoRoot);
+        const args = ['worktree', 'unlock', validatedPath];
+        try {
+            await SafeExecutor.executeGit(args, {
+                cwd: this.repoRoot
+            });
+        }
+        catch (error) {
+            const typedError = error;
+            // Ignore if worktree is not locked
+            if (!typedError.message.includes('not locked')) {
+                throw new Error(`Failed to unlock worktree: ${typedError.message}`);
+            }
+        }
+    }
+    /**
+     * Parse git worktree list --porcelain output
+     */
+    parseWorktreeList(output) {
+        const worktrees = [];
+        const entries = output.split('\n\n').filter((entry) => entry.trim());
+        for (const entry of entries) {
+            const lines = entry.split('\n');
+            const worktree = {
+                prunable: false
+            };
+            for (const line of lines) {
+                if (line.startsWith('worktree ')) {
+                    worktree.path = line.substring(9);
+                }
+                else if (line.startsWith('HEAD ')) {
+                    worktree.commit = line.substring(5);
+                }
+                else if (line.startsWith('branch ')) {
+                    worktree.branch = line.substring(7);
+                }
+                else if (line === 'prunable') {
+                    worktree.prunable = true;
+                }
+            }
+            // Only add if we have the required fields
+            if (worktree.path && worktree.commit) {
+                worktrees.push(worktree);
+            }
+        }
+        return worktrees;
+    }
+    /**
+     * Create multiple worktrees with rollback on failure (IMPROVED)
+     *
+     * RELIABILITY FIX: Rollback on partial failure
+     */
+    async createMultipleWorktrees(optionsArray) {
+        const created = [];
+        const createdPaths = [];
+        try {
+            // Create worktrees one by one to track progress
+            for (const options of optionsArray) {
+                const info = await this.createWorktree(options);
+                created.push(info);
+                createdPaths.push(info.path);
+            }
+            return created;
+        }
+        catch (error) {
+            // RELIABILITY: Rollback on failure
+            console.error(`Worktree creation failed, rolling back ${createdPaths.length} worktrees...`);
+            for (const worktreePath of createdPaths) {
+                try {
+                    await this.removeWorktree(worktreePath, true);
+                    // Also try to delete the branch
+                    const worktree = created.find((w) => w.path === worktreePath);
+                    if (worktree) {
+                        await this.deleteBranch(worktree.branch, true);
+                    }
+                }
+                catch (cleanupError) {
+                    console.error(`Failed to cleanup worktree ${worktreePath}: ${cleanupError.message}`);
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * Remove multiple worktrees in parallel
+     */
+    async removeMultipleWorktrees(paths, force = false) {
+        const promises = paths.map((p) => this.removeWorktree(p, force));
+        await Promise.all(promises);
+    }
+    /**
+     * Get worktree status (clean, dirty, etc.) (SECURITY HARDENED)
+     */
+    async getWorktreeStatus(worktreePath) {
+        // SECURITY: Validate path
+        const validatedPath = InputValidator.validatePath(worktreePath, this.repoRoot);
+        try {
+            const result = await SafeExecutor.executeGit(['status', '--porcelain'], {
+                cwd: validatedPath
+            });
+            const lines = result.stdout
+                .trim()
+                .split('\n')
+                .filter((line) => line);
+            return {
+                clean: lines.length === 0,
+                uncommitted_changes: lines.length
+            };
+        }
+        catch (error) {
+            const typedError = error;
+            throw new Error(`Failed to get worktree status: ${typedError.message}`);
+        }
+    }
+    /**
+     * Verify worktree limit hasn't been exceeded
+     *
+     * NEW: Prevents exhausting filesystem limits
+     */
+    async checkWorktreeLimit(maxWorktrees = 50) {
+        const worktrees = await this.listWorktrees();
+        if (worktrees.length >= maxWorktrees) {
+            throw new Error(`Too many worktrees (${worktrees.length}/${maxWorktrees}). ` +
+                `Run 'git worktree prune' to clean up old worktrees.`);
+        }
+    }
+}
+//# sourceMappingURL=worktree-manager-secure.js.map

package/dist/exploration/worktree-manager-secure.js.map

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

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

@@ -0,0 +1,97 @@
+/**
+ * Worktree Manager - Git worktree CRUD operations
+ *
+ * Manages git worktrees for parallel explorations with safety checks
+ */
+export interface CreateWorktreeOptions {
+    baseRef?: string;
+    branch: string;
+    force?: boolean;
+    path: string;
+}
+export interface WorktreeInfo {
+    branch: string;
+    commit: string;
+    path: string;
+    prunable: boolean;
+}
+export declare class WorktreeManager {
+    private repoRoot;
+    constructor(repoRoot?: string);
+    /**
+     * Create a new git worktree
+     */
+    createWorktree(options: CreateWorktreeOptions): Promise<WorktreeInfo>;
+    /**
+     * Validate worktree creation options
+     */
+    private validateWorktreeOptions;
+    /**
+     * Check if path is available for worktree creation
+     */
+    private checkPathAvailability;
+    /**
+     * Build git worktree add command
+     */
+    private buildWorktreeCommand;
+    /**
+     * List all git worktrees
+     */
+    listWorktrees(): Promise<WorktreeInfo[]>;
+    /**
+     * Get information about a specific worktree
+     */
+    getWorktreeInfo(worktreePath: string): Promise<WorktreeInfo>;
+    /**
+     * Remove a git worktree
+     */
+    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
+     */
+    isBranchNameAvailable(branchName: string): Promise<boolean>;
+    /**
+     * Get all exploration worktrees (prefixed with exploration/)
+     */
+    getExplorationWorktrees(): Promise<WorktreeInfo[]>;
+    /**
+     * Delete branch after worktree removal
+     */
+    deleteBranch(branchName: string, force?: boolean): Promise<void>;
+    /**
+     * Lock a worktree to prevent automatic pruning
+     */
+    lockWorktree(worktreePath: string, reason?: string): Promise<void>;
+    /**
+     * Unlock a worktree
+     */
+    unlockWorktree(worktreePath: string): Promise<void>;
+    /**
+     * Parse git worktree list --porcelain output
+     */
+    private parseWorktreeList;
+    /**
+     * Create multiple worktrees in parallel
+     */
+    createMultipleWorktrees(optionsArray: CreateWorktreeOptions[]): Promise<WorktreeInfo[]>;
+    /**
+     * Remove multiple worktrees in parallel
+     */
+    removeMultipleWorktrees(paths: string[], force?: boolean): Promise<void>;
+    /**
+     * Get worktree status (clean, dirty, etc.)
+     */
+    getWorktreeStatus(worktreePath: string): Promise<{
+        clean: boolean;
+        uncommitted_changes: number;
+    }>;
+}
+//# sourceMappingURL=worktree-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-manager.d.ts","sourceRoot":"","sources":["../../src/exploration/worktree-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,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,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,CAAC,EAAE,MAAM;IAI7B;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IA8B3E;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAS/B;;OAEG;YACW,qBAAqB;IAenC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAa9C;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAalE;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjF;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrC;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5D;;OAEG;IACG,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWjE;;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;IAmB7E;;OAEG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxE;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+BzB;;OAEG;IACG,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAK7F;;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;CAmBvG"}