agentic-qe 2.3.4 → 2.4.0

package/dist/core/platform/FileOperations.js

@@ -0,0 +1,371 @@
+"use strict";
+/**
+ * FileOperations - Platform-optimized file operations
+ *
+ * Provides file copy/clone operations that leverage platform-specific
+ * features like APFS clonefile (macOS) and reflink (Linux btrfs/xfs)
+ * for 50-100x performance improvements.
+ *
+ * @module core/platform/FileOperations
+ * @version 1.0.0
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CopyStrategy = void 0;
+exports.copyFile = copyFile;
+exports.copyDirectory = copyDirectory;
+exports.cloneForIsolation = cloneForIsolation;
+exports.linkFixture = linkFixture;
+exports.getCopyCapabilities = getCopyCapabilities;
+exports.benchmarkCopy = benchmarkCopy;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const PlatformDetector_1 = require("./PlatformDetector");
+/**
+ * Copy strategy used for a file operation
+ */
+var CopyStrategy;
+(function (CopyStrategy) {
+    /** Copy-on-write clone (fastest) */
+    CopyStrategy["REFLINK"] = "reflink";
+    /** Filesystem hardlink (instant, shares data) */
+    CopyStrategy["HARDLINK"] = "hardlink";
+    /** Kernel-space copy (fast) */
+    CopyStrategy["KERNEL"] = "kernel";
+    /** Userspace copy (fallback) */
+    CopyStrategy["USERSPACE"] = "userspace";
+})(CopyStrategy || (exports.CopyStrategy = CopyStrategy = {}));
+/**
+ * Copy a file using the optimal strategy for the platform
+ *
+ * Priority: reflink > kernel copy > userspace copy
+ *
+ * @param source - Source file path
+ * @param destination - Destination file path
+ * @param options - Copy options
+ * @returns Copy result with strategy and timing info
+ */
+async function copyFile(source, destination, options = {}) {
+    const startTime = performance.now();
+    const sourcePath = path.resolve(source);
+    const destPath = path.resolve(destination);
+    // Check source exists
+    let stats;
+    try {
+        stats = await fs.promises.stat(sourcePath);
+        if (!stats.isFile()) {
+            throw new Error(`Source is not a file: ${sourcePath}`);
+        }
+    }
+    catch (err) {
+        return {
+            source: sourcePath,
+            destination: destPath,
+            strategy: CopyStrategy.USERSPACE,
+            duration: performance.now() - startTime,
+            size: 0,
+            success: false,
+            error: err.message,
+        };
+    }
+    // Create parent directory if needed
+    if (options.recursive) {
+        await fs.promises.mkdir(path.dirname(destPath), { recursive: true });
+    }
+    // Handle overwrite
+    if (!options.overwrite) {
+        try {
+            await fs.promises.access(destPath);
+            return {
+                source: sourcePath,
+                destination: destPath,
+                strategy: CopyStrategy.USERSPACE,
+                duration: performance.now() - startTime,
+                size: stats.size,
+                success: false,
+                error: 'Destination already exists',
+            };
+        }
+        catch {
+            // File doesn't exist, continue
+        }
+    }
+    // Determine strategy
+    let strategy = options.strategy;
+    if (!strategy) {
+        const caps = await (0, PlatformDetector_1.detectCapabilities)(sourcePath);
+        strategy = caps.supportsReflink ? CopyStrategy.REFLINK : CopyStrategy.KERNEL;
+    }
+    // Execute copy with fallback chain
+    let usedStrategy = strategy;
+    let error;
+    try {
+        switch (strategy) {
+            case CopyStrategy.REFLINK:
+                try {
+                    await fs.promises.copyFile(sourcePath, destPath, fs.constants.COPYFILE_FICLONE_FORCE);
+                }
+                catch {
+                    // Reflink failed, try kernel copy
+                    usedStrategy = CopyStrategy.KERNEL;
+                    await fs.promises.copyFile(sourcePath, destPath, fs.constants.COPYFILE_FICLONE);
+                }
+                break;
+            case CopyStrategy.HARDLINK:
+                try {
+                    await fs.promises.link(sourcePath, destPath);
+                }
+                catch {
+                    // Hardlink failed, fallback to copy
+                    usedStrategy = CopyStrategy.KERNEL;
+                    await fs.promises.copyFile(sourcePath, destPath, fs.constants.COPYFILE_FICLONE);
+                }
+                break;
+            case CopyStrategy.KERNEL:
+                await fs.promises.copyFile(sourcePath, destPath, fs.constants.COPYFILE_FICLONE);
+                break;
+            case CopyStrategy.USERSPACE:
+            default:
+                await fs.promises.copyFile(sourcePath, destPath);
+                break;
+        }
+        // Preserve timestamps if requested
+        if (options.preserveTimestamps) {
+            const srcStats = await fs.promises.stat(sourcePath);
+            await fs.promises.utimes(destPath, srcStats.atime, srcStats.mtime);
+        }
+    }
+    catch (err) {
+        error = err.message;
+    }
+    return {
+        source: sourcePath,
+        destination: destPath,
+        strategy: usedStrategy,
+        duration: performance.now() - startTime,
+        size: stats.size,
+        success: !error,
+        error,
+    };
+}
+/**
+ * Copy a directory recursively using optimal strategies
+ *
+ * @param source - Source directory path
+ * @param destination - Destination directory path
+ * @param options - Copy options
+ * @returns Array of copy results for all files
+ */
+async function copyDirectory(source, destination, options = {}) {
+    const sourcePath = path.resolve(source);
+    const destPath = path.resolve(destination);
+    // Check source is a directory
+    const stats = await fs.promises.stat(sourcePath);
+    if (!stats.isDirectory()) {
+        throw new Error(`Source is not a directory: ${sourcePath}`);
+    }
+    // Create destination directory
+    await fs.promises.mkdir(destPath, { recursive: true });
+    // Get all entries
+    const entries = await fs.promises.readdir(sourcePath, { withFileTypes: true });
+    const results = [];
+    // Process entries in parallel with concurrency limit
+    const CONCURRENCY = 10;
+    const chunks = [];
+    for (let i = 0; i < entries.length; i += CONCURRENCY) {
+        chunks.push(entries.slice(i, i + CONCURRENCY));
+    }
+    for (const chunk of chunks) {
+        const chunkResults = await Promise.all(chunk.map(async (entry) => {
+            const srcEntryPath = path.join(sourcePath, entry.name);
+            const destEntryPath = path.join(destPath, entry.name);
+            if (entry.isDirectory()) {
+                return copyDirectory(srcEntryPath, destEntryPath, options);
+            }
+            else if (entry.isFile()) {
+                return [await copyFile(srcEntryPath, destEntryPath, options)];
+            }
+            else {
+                // Symlinks, etc. - skip for now
+                return [];
+            }
+        }));
+        results.push(...chunkResults.flat());
+    }
+    return results;
+}
+/**
+ * Clone a directory for test isolation
+ *
+ * Optimized for creating isolated test workspaces with COW cloning.
+ *
+ * @param source - Source directory path
+ * @param destination - Destination directory path
+ * @returns Clone result summary
+ */
+async function cloneForIsolation(source, destination) {
+    const startTime = performance.now();
+    const results = await copyDirectory(source, destination, {
+        overwrite: true,
+        recursive: true,
+    });
+    const errors = results.filter(r => !r.success).map(r => r.error || 'Unknown error');
+    const successResults = results.filter(r => r.success);
+    // Determine predominant strategy used
+    const strategyCount = new Map();
+    for (const r of successResults) {
+        strategyCount.set(r.strategy, (strategyCount.get(r.strategy) || 0) + 1);
+    }
+    let predominantStrategy = CopyStrategy.USERSPACE;
+    let maxCount = 0;
+    for (const [strategy, count] of strategyCount) {
+        if (count > maxCount) {
+            maxCount = count;
+            predominantStrategy = strategy;
+        }
+    }
+    return {
+        success: errors.length === 0,
+        filesCloned: successResults.length,
+        totalSize: successResults.reduce((sum, r) => sum + r.size, 0),
+        duration: performance.now() - startTime,
+        strategy: predominantStrategy,
+        errors,
+    };
+}
+/**
+ * Create a read-only fixture copy using hardlinks
+ *
+ * Useful for test fixtures that won't be modified.
+ *
+ * @param source - Source file path
+ * @param destination - Destination file path
+ * @returns Copy result
+ */
+async function linkFixture(source, destination) {
+    return copyFile(source, destination, {
+        strategy: CopyStrategy.HARDLINK,
+        recursive: true,
+    });
+}
+/**
+ * Get platform copy capabilities summary
+ */
+async function getCopyCapabilities() {
+    const caps = await (0, PlatformDetector_1.detectCapabilities)();
+    let optimalStrategy;
+    let expectedSpeedup;
+    if (caps.supportsReflink) {
+        optimalStrategy = CopyStrategy.REFLINK;
+        expectedSpeedup = '100-1000x';
+    }
+    else if (caps.supportsCopyFileRange) {
+        optimalStrategy = CopyStrategy.KERNEL;
+        expectedSpeedup = '2-5x';
+    }
+    else {
+        optimalStrategy = CopyStrategy.USERSPACE;
+        expectedSpeedup = '1x (baseline)';
+    }
+    return {
+        platform: caps.platform,
+        filesystem: caps.filesystem,
+        optimalStrategy,
+        expectedSpeedup,
+    };
+}
+/**
+ * Benchmark copy operations for the current platform
+ *
+ * @param testPath - Path to run benchmark in
+ * @returns Benchmark results
+ */
+async function benchmarkCopy(testPath = '/tmp') {
+    const testDir = path.join(testPath, '.copy-benchmark');
+    const testData = Buffer.alloc(1024 * 1024, 'x'); // 1MB test file
+    try {
+        await fs.promises.mkdir(testDir, { recursive: true });
+        const srcFile = path.join(testDir, 'src.tmp');
+        await fs.promises.writeFile(srcFile, testData);
+        const results = {
+            reflink: null,
+            kernel: null,
+            userspace: 0,
+        };
+        // Benchmark reflink
+        try {
+            const destReflink = path.join(testDir, 'dest-reflink.tmp');
+            const startReflink = performance.now();
+            await fs.promises.copyFile(srcFile, destReflink, fs.constants.COPYFILE_FICLONE_FORCE);
+            results.reflink = performance.now() - startReflink;
+            await fs.promises.unlink(destReflink);
+        }
+        catch {
+            // Reflink not supported
+        }
+        // Benchmark kernel copy
+        const destKernel = path.join(testDir, 'dest-kernel.tmp');
+        const startKernel = performance.now();
+        await fs.promises.copyFile(srcFile, destKernel, fs.constants.COPYFILE_FICLONE);
+        results.kernel = performance.now() - startKernel;
+        await fs.promises.unlink(destKernel);
+        // Benchmark userspace copy
+        const destUser = path.join(testDir, 'dest-user.tmp');
+        const startUser = performance.now();
+        await fs.promises.copyFile(srcFile, destUser);
+        results.userspace = performance.now() - startUser;
+        await fs.promises.unlink(destUser);
+        // Calculate improvement
+        let improvement = '1x';
+        if (results.reflink !== null) {
+            const factor = Math.round(results.userspace / results.reflink);
+            improvement = `${factor}x (reflink)`;
+        }
+        else if (results.kernel !== null && results.kernel < results.userspace) {
+            const factor = Math.round(results.userspace / results.kernel);
+            improvement = `${factor}x (kernel)`;
+        }
+        return { ...results, improvement };
+    }
+    finally {
+        try {
+            await fs.promises.rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+//# sourceMappingURL=FileOperations.js.map

package/dist/core/platform/FileOperations.js.map

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

package/dist/core/platform/PlatformDetector.d.ts

@@ -0,0 +1,53 @@
+/**
+ * PlatformDetector - Detects platform capabilities for optimized file operations
+ *
+ * Identifies filesystem features like reflink (copy-on-write) support
+ * to enable 100x+ performance improvements for file operations.
+ *
+ * @module core/platform/PlatformDetector
+ * @version 1.0.0
+ */
+/**
+ * Platform capabilities for file operations
+ */
+export interface PlatformCapabilities {
+    /** Platform identifier (darwin, linux, win32, etc.) */
+    platform: NodeJS.Platform;
+    /** Detected filesystem type */
+    filesystem: string;
+    /** Whether reflink/clonefile is supported */
+    supportsReflink: boolean;
+    /** Whether hardlinks are supported */
+    supportsHardlinks: boolean;
+    /** Whether copy_file_range is available */
+    supportsCopyFileRange: boolean;
+    /** Node.js copyFile flags to use */
+    recommendedCopyFlags: number;
+    /** Human-readable capability summary */
+    summary: string;
+}
+/**
+ * Detect platform capabilities for a given path
+ *
+ * @param targetPath - Path to check capabilities for (uses tmpdir if not specified)
+ * @returns Platform capabilities object
+ */
+export declare function detectCapabilities(targetPath?: string): Promise<PlatformCapabilities>;
+/**
+ * Test if reflink actually works for a given path
+ *
+ * This performs an actual file clone test to verify capabilities.
+ *
+ * @param targetPath - Path to test
+ * @returns True if reflink works
+ */
+export declare function testReflinkSupport(targetPath: string): Promise<boolean>;
+/**
+ * Clear the capabilities cache
+ */
+export declare function clearCapabilitiesCache(): void;
+/**
+ * Get a quick summary of current platform capabilities
+ */
+export declare function getQuickSummary(): Promise<string>;
+//# sourceMappingURL=PlatformDetector.d.ts.map

package/dist/core/platform/PlatformDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformDetector.d.ts","sourceRoot":"","sources":["../../../src/core/platform/PlatformDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,eAAe,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oCAAoC;IACpC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,GAAE,MAAoB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CA0D/B;AAuGD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA2B7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAGvD"}