@diamondslab/diamonds-hardhat-foundry 2.3.0 → 2.4.0

package/dist/tasks/coverage.js

@@ -11,26 +11,28 @@ const logger_1 = require("../utils/logger");
  * - Runs forge coverage with specified options
  *
  * Use Hardhat's built-in --network flag to specify the network
+ *
+ * Design: Mirrors diamonds-forge:test task structure for consistency
  */
 (0, config_1.task)("diamonds-forge:coverage", "Run forge coverage for Diamond contracts")
-    .addParam("diamondName", "Name of the Diamond to analyze", undefined, config_1.types.string)
+    .addOptionalParam("diamondName", "Name of the Diamond to analyze", "ExampleDiamond", config_1.types.string)
     // Report options
-    .addOptionalParam("report", "Report type (summary, lcov, debug, bytecode) - can be used multiple times by passing comma-separated values", undefined, config_1.types.string)
+    .addOptionalParam("report", "Report type (summary, lcov, debug, bytecode) - comma-separated for multiple", undefined, config_1.types.string)
     .addOptionalParam("reportFile", "Output path for report file", undefined, config_1.types.string)
-    .addOptionalParam("lcovVersion", "LCOV format version", undefined, config_1.types.string)
+    .addOptionalParam("lcovVersion", "LCOV format version (v1 or v2)", undefined, config_1.types.string)
     .addFlag("includeLibs", "Include libraries in coverage report")
     .addFlag("excludeTests", "Exclude tests from coverage report")
     .addFlag("irMinimum", "Enable viaIR with minimum optimization")
     // Test filtering
-    .addOptionalParam("matchTest", "Run tests matching pattern (--match-test)", undefined, config_1.types.string)
-    .addOptionalParam("noMatchTest", "Exclude tests matching pattern (--no-match-test)", undefined, config_1.types.string)
-    .addOptionalParam("matchContract", "Run contracts matching pattern (--match-contract)", undefined, config_1.types.string)
-    .addOptionalParam("noMatchContract", "Exclude contracts matching pattern (--no-match-contract)", undefined, config_1.types.string)
-    .addOptionalParam("matchPath", "Run files matching glob (--match-path)", undefined, config_1.types.string)
-    .addOptionalParam("noMatchPath", "Exclude files matching glob (--no-match-path)", undefined, config_1.types.string)
-    .addOptionalParam("noMatchCoverage", "Exclude files from coverage report (--no-match-coverage)", undefined, config_1.types.string)
+    .addOptionalParam("matchTest", "Run tests matching pattern", undefined, config_1.types.string)
+    .addOptionalParam("noMatchTest", "Exclude tests matching pattern", undefined, config_1.types.string)
+    .addOptionalParam("matchContract", "Run contracts matching pattern", undefined, config_1.types.string)
+    .addOptionalParam("noMatchContract", "Exclude contracts matching pattern", undefined, config_1.types.string)
+    .addOptionalParam("matchPath", "Run files matching glob", undefined, config_1.types.string)
+    .addOptionalParam("noMatchPath", "Exclude files matching glob", undefined, config_1.types.string)
+    .addOptionalParam("noMatchCoverage", "Exclude files from coverage report", undefined, config_1.types.string)
     // Display options
-    .addOptionalParam("verbosity", "Verbosity level (1-5, more v's = more verbose)", undefined, config_1.types.int)
+    .addOptionalParam("verbosity", "Verbosity level (1-5)", undefined, config_1.types.int)
     .addFlag("quiet", "Suppress log output")
     .addFlag("json", "Format output as JSON")
     .addFlag("md", "Format output as Markdown")
@@ -46,121 +48,100 @@ const logger_1 = require("../utils/logger");
     .addOptionalParam("initialBalance", "Initial balance for test contracts", undefined, config_1.types.string)
     .addOptionalParam("sender", "Test sender address", undefined, config_1.types.string)
     .addFlag("ffi", "Enable FFI cheatcode")
-    // Build options
+    // Build/deployment options
     .addFlag("force", "Force recompile and redeploy")
     .addFlag("noCache", "Disable cache")
     .addFlag("optimize", "Enable Solidity optimizer")
     .addOptionalParam("optimizerRuns", "Optimizer runs", undefined, config_1.types.int)
     .addFlag("viaIr", "Use Yul IR compilation")
+    .addFlag("skipDeployment", "Skip Diamond deployment step")
+    .addFlag("skipHelpers", "Skip helper generation step")
+    .addFlag("saveDeployment", "Write deployment data to file for reuse")
     .setAction(async (taskArgs, hre) => {
     logger_1.Logger.section("Running Forge Coverage with Diamond");
     const diamondName = taskArgs.diamondName;
     const networkName = hre.network.name;
-    // Validate required parameters
-    if (!diamondName) {
-        logger_1.Logger.error("--diamond-name is required");
-        process.exitCode = 1;
-        return;
-    }
     logger_1.Logger.info(`Diamond: ${diamondName}`);
     logger_1.Logger.info(`Network: ${networkName}`);
+    // Log key options
+    if (taskArgs.report)
+        logger_1.Logger.info(`Report: ${taskArgs.report}`);
+    if (taskArgs.reportFile)
+        logger_1.Logger.info(`Report File: ${taskArgs.reportFile}`);
+    if (taskArgs.matchTest)
+        logger_1.Logger.info(`Match Test: ${taskArgs.matchTest}`);
+    if (taskArgs.matchContract)
+        logger_1.Logger.info(`Match Contract: ${taskArgs.matchContract}`);
+    if (taskArgs.skipDeployment)
+        logger_1.Logger.info("Skip Deployment: true");
+    if (taskArgs.skipHelpers)
+        logger_1.Logger.info("Skip Helpers: true");
+    if (taskArgs.saveDeployment)
+        logger_1.Logger.info("Save Deployment: true");
+    // Lazy-load framework to avoid circular dependency during config loading
+    const { ForgeCoverageFramework } = await import("../framework/ForgeCoverageFramework.js");
+    // Parse comma-separated report types
+    const reportTypes = taskArgs.report
+        ? taskArgs.report.split(",").map((r) => r.trim())
+        : undefined;
+    // Create coverage options (matches test.ts pattern)
+    const options = {
+        diamondName,
+        networkName,
+        force: taskArgs.force,
+        skipDeployment: taskArgs.skipDeployment,
+        skipHelpers: taskArgs.skipHelpers,
+        writeDeployedDiamondData: taskArgs.saveDeployment,
+        // Report options
+        report: reportTypes,
+        reportFile: taskArgs.reportFile,
+        lcovVersion: taskArgs.lcovVersion,
+        includeLibs: taskArgs.includeLibs,
+        excludeTests: taskArgs.excludeTests,
+        irMinimum: taskArgs.irMinimum,
+        // Test filtering
+        matchTest: taskArgs.matchTest,
+        noMatchTest: taskArgs.noMatchTest,
+        matchContract: taskArgs.matchContract,
+        noMatchContract: taskArgs.noMatchContract,
+        matchPath: taskArgs.matchPath,
+        noMatchPath: taskArgs.noMatchPath,
+        noMatchCoverage: taskArgs.noMatchCoverage,
+        // Display options
+        verbosity: taskArgs.verbosity,
+        quiet: taskArgs.quiet,
+        json: taskArgs.json,
+        md: taskArgs.md,
+        color: taskArgs.color,
+        // Test execution
+        threads: taskArgs.threads,
+        fuzzRuns: taskArgs.fuzzRuns,
+        fuzzSeed: taskArgs.fuzzSeed,
+        failFast: taskArgs.failFast,
+        allowFailure: taskArgs.allowFailure,
+        // EVM options
+        forkBlockNumber: taskArgs.forkBlockNumber,
+        initialBalance: taskArgs.initialBalance,
+        sender: taskArgs.sender,
+        ffi: taskArgs.ffi,
+        // Build options
+        noCache: taskArgs.noCache,
+        optimize: taskArgs.optimize,
+        optimizerRuns: taskArgs.optimizerRuns,
+        viaIr: taskArgs.viaIr,
+    };
+    // Run coverage using the framework (same pattern as test.ts)
+    const framework = new ForgeCoverageFramework(hre);
     try {
-        // Lazy-load framework classes to avoid circular dependency
-        const { DeploymentManager } = await import("../framework/DeploymentManager.js");
-        const { HelperGenerator } = await import("../framework/HelperGenerator.js");
-        // Step 1: Ensure Diamond deployment
-        logger_1.Logger.section("Step 1/3: Ensuring Diamond Deployment");
-        const deploymentManager = new DeploymentManager(hre);
-        await deploymentManager.ensureDeployment(diamondName, networkName, taskArgs.force || false, false // Don't write deployment data for coverage (ephemeral by default)
-        );
-        // Step 2: Generate helpers
-        logger_1.Logger.section("Step 2/3: Generating Solidity Helpers");
-        const deployment = await deploymentManager.getDeployment(diamondName, networkName);
-        if (!deployment) {
-            logger_1.Logger.error("No deployment found. Cannot generate helpers.");
-            process.exitCode = 1;
-            return;
-        }
-        const provider = hre.ethers.provider;
-        const network = await provider.getNetwork();
-        const chainId = Number(network.chainId);
-        const deploymentData = deployment.getDeployedDiamondData();
-        const helperGenerator = new HelperGenerator(hre);
-        await helperGenerator.generateDeploymentHelpers(diamondName, networkName, chainId, deploymentData, deployment);
-        // Step 3: Run coverage
-        logger_1.Logger.section("Step 3/3: Running Forge Coverage");
-        // Construct fork URL for network
-        // Coverage requires forking from a running network to access deployed contracts
-        let forkUrl;
-        if (networkName !== "hardhat") {
-            // Use the configured network's URL
-            forkUrl = provider._hardhatProvider?._wrapped?.url || "http://127.0.0.1:8545";
-            logger_1.Logger.info(`Forking from ${networkName}: ${forkUrl}`);
-        }
-        else {
-            // Default to localhost for hardhat network
-            // This assumes user has `npx hardhat node` running
-            forkUrl = "http://127.0.0.1:8545";
-            logger_1.Logger.warn(`⚠️  Network is "${networkName}" - defaulting to localhost fork: ${forkUrl}`);
-            logger_1.Logger.warn(`💡 Make sure Hardhat node is running: npx hardhat node`);
-            logger_1.Logger.warn(`💡 Or specify network explicitly: --network localhost`);
-        }
-        // Lazy-load framework to avoid circular dependency
-        const { ForgeCoverageFramework } = await import("../framework/ForgeCoverageFramework.js");
-        // Build coverage options from task args
-        const options = {
-            // Fork URL
-            forkUrl,
-            // Report options
-            report: taskArgs.report ? taskArgs.report.split(",") : undefined,
-            reportFile: taskArgs.reportFile,
-            lcovVersion: taskArgs.lcovVersion,
-            includeLibs: taskArgs.includeLibs,
-            excludeTests: taskArgs.excludeTests,
-            irMinimum: taskArgs.irMinimum,
-            // Test filtering
-            matchTest: taskArgs.matchTest,
-            noMatchTest: taskArgs.noMatchTest,
-            matchContract: taskArgs.matchContract,
-            noMatchContract: taskArgs.noMatchContract,
-            matchPath: taskArgs.matchPath,
-            noMatchPath: taskArgs.noMatchPath,
-            noMatchCoverage: taskArgs.noMatchCoverage,
-            // Display options
-            verbosity: taskArgs.verbosity,
-            quiet: taskArgs.quiet,
-            json: taskArgs.json,
-            md: taskArgs.md,
-            color: taskArgs.color,
-            // Test execution options
-            threads: taskArgs.threads,
-            fuzzRuns: taskArgs.fuzzRuns,
-            fuzzSeed: taskArgs.fuzzSeed,
-            failFast: taskArgs.failFast,
-            allowFailure: taskArgs.allowFailure,
-            // EVM options
-            forkBlockNumber: taskArgs.forkBlockNumber,
-            initialBalance: taskArgs.initialBalance,
-            sender: taskArgs.sender,
-            ffi: taskArgs.ffi,
-            // Build options
-            force: taskArgs.force,
-            noCache: taskArgs.noCache,
-            optimize: taskArgs.optimize,
-            optimizerRuns: taskArgs.optimizerRuns,
-            viaIr: taskArgs.viaIr,
-        };
-        // Run coverage
-        const framework = new ForgeCoverageFramework(hre);
         const success = await framework.runCoverage(options);
         if (success) {
             logger_1.Logger.section("Coverage Analysis Complete");
-            logger_1.Logger.success("Coverage analysis completed successfully!");
+            logger_1.Logger.success("✅ Coverage completed successfully!");
             process.exitCode = 0;
         }
         else {
             logger_1.Logger.section("Coverage Analysis Complete");
-            logger_1.Logger.error("Coverage analysis failed");
+            logger_1.Logger.error("❌ Coverage analysis failed");
             process.exitCode = 1;
         }
     }

package/dist/tasks/coverage.js.map

@@ -1 +1 @@
-{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/tasks/coverage.ts"],"names":[],"mappings":";;AAAA,2CAA6C;AAE7C,4CAAyC;AAEzC;;;;;;;;;GASG;AACH,IAAA,aAAI,EAAC,yBAAyB,EAAE,0CAA0C,CAAC;KACxE,QAAQ,CACP,aAAa,EACb,gCAAgC,EAChC,SAAS,EACT,cAAK,CAAC,MAAM,CACb;IACD,iBAAiB;KAChB,gBAAgB,CACf,QAAQ,EACR,6GAA6G,EAC7G,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,gBAAgB,CACf,YAAY,EACZ,6BAA6B,EAC7B,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,gBAAgB,CACf,aAAa,EACb,qBAAqB,EACrB,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,OAAO,CAAC,aAAa,EAAE,sCAAsC,CAAC;KAC9D,OAAO,CAAC,cAAc,EAAE,oCAAoC,CAAC;KAC7D,OAAO,CAAC,WAAW,EAAE,wCAAwC,CAAC;IAC/D,iBAAiB;KAChB,gBAAgB,CACf,WAAW,EACX,2CAA2C,EAC3C,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,gBAAgB,CACf,aAAa,EACb,kDAAkD,EAClD,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,gBAAgB,CACf,eAAe,EACf,mDAAmD,EACnD,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,gBAAgB,CACf,iBAAiB,EACjB,0DAA0D,EAC1D,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,gBAAgB,CACf,WAAW,EACX,wCAAwC,EACxC,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,gBAAgB,CACf,aAAa,EACb,+CAA+C,EAC/C,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,gBAAgB,CACf,iBAAiB,EACjB,0DAA0D,EAC1D,SAAS,EACT,cAAK,CAAC,MAAM,CACb;IACD,kBAAkB;KACjB,gBAAgB,CACf,WAAW,EACX,gDAAgD,EAChD,SAAS,EACT,cAAK,CAAC,GAAG,CACV;KACA,OAAO,CAAC,OAAO,EAAE,qBAAqB,CAAC;KACvC,OAAO,CAAC,MAAM,EAAE,uBAAuB,CAAC;KACxC,OAAO,CAAC,IAAI,EAAE,2BAA2B,CAAC;KAC1C,gBAAgB,CACf,OAAO,EACP,kCAAkC,EAClC,SAAS,EACT,cAAK,CAAC,MAAM,CACb;IACD,yBAAyB;KACxB,gBAAgB,CACf,SAAS,EACT,0BAA0B,EAC1B,SAAS,EACT,cAAK,CAAC,GAAG,CACV;KACA,gBAAgB,CACf,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,cAAK,CAAC,GAAG,CACV;KACA,gBAAgB,CACf,UAAU,EACV,0BAA0B,EAC1B,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,OAAO,CAAC,UAAU,EAAE,uBAAuB,CAAC;KAC5C,OAAO,CAAC,cAAc,EAAE,2BAA2B,CAAC;IACrD,cAAc;KACb,gBAAgB,CACf,iBAAiB,EACjB,iCAAiC,EACjC,SAAS,EACT,cAAK,CAAC,GAAG,CACV;KACA,gBAAgB,CACf,gBAAgB,EAChB,oCAAoC,EACpC,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,gBAAgB,CACf,QAAQ,EACR,qBAAqB,EACrB,SAAS,EACT,cAAK,CAAC,MAAM,CACb;KACA,OAAO,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,gBAAgB;KACf,OAAO,CAAC,OAAO,EAAE,8BAA8B,CAAC;KAChD,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC;KACnC,OAAO,CAAC,UAAU,EAAE,2BAA2B,CAAC;KAChD,gBAAgB,CACf,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,cAAK,CAAC,GAAG,CACV;KACA,OAAO,CAAC,OAAO,EAAE,wBAAwB,CAAC;KAC1C,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAA8B,EAAE,EAAE;IAC5D,eAAM,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;IAEtD,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;IACzC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;IAErC,+BAA+B;IAC/B,IAAI,CAAC,WAAW,EAAE;QAChB,eAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC3C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;KACR;IAED,eAAM,CAAC,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC,CAAC;IACvC,eAAM,CAAC,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC,CAAC;IAEvC,IAAI;QACF,2DAA2D;QAC3D,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;QAChF,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;QAE5E,oCAAoC;QACpC,eAAM,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC;QAExD,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAErD,MAAM,iBAAiB,CAAC,gBAAgB,CACtC,WAAW,EACX,WAAW,EACX,QAAQ,CAAC,KAAK,IAAI,KAAK,EACvB,KAAK,CAAC,kEAAkE;SACzE,CAAC;QAEF,2BAA2B;QAC3B,eAAM,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC;QAExD,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,aAAa,CACtD,WAAW,EACX,WAAW,CACZ,CAAC;QAEF,IAAI,CAAC,UAAU,EAAE;YACf,eAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;SACR;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,cAAc,GAAG,UAAU,CAAC,sBAAsB,EAAE,CAAC;QAE3D,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,eAAe,CAAC,yBAAyB,CAC7C,WAAW,EACX,WAAW,EACX,OAAO,EACP,cAAc,EACd,UAAU,CACX,CAAC;QAEF,uBAAuB;QACvB,eAAM,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;QAEnD,iCAAiC;QACjC,gFAAgF;QAChF,IAAI,OAAe,CAAC;QACpB,IAAI,WAAW,KAAK,SAAS,EAAE;YAC7B,mCAAmC;YACnC,OAAO,GAAI,QAAgB,CAAC,gBAAgB,EAAE,QAAQ,EAAE,GAAG,IAAI,uBAAuB,CAAC;YACvF,eAAM,CAAC,IAAI,CAAC,gBAAgB,WAAW,KAAK,OAAO,EAAE,CAAC,CAAC;SACxD;aAAM;YACL,2CAA2C;YAC3C,mDAAmD;YACnD,OAAO,GAAG,uBAAuB,CAAC;YAClC,eAAM,CAAC,IAAI,CAAC,mBAAmB,WAAW,qCAAqC,OAAO,EAAE,CAAC,CAAC;YAC1F,eAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;YACtE,eAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;SACtE;QAED,mDAAmD;QACnD,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAAC;QAG1F,wCAAwC;QACxC,MAAM,OAAO,GAAoB;YAC/B,WAAW;YACX,OAAO;YAEP,iBAAiB;YACjB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;YAChE,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;YAE7B,iBAAiB;YACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,eAAe,EAAE,QAAQ,CAAC,eAAe;YAEzC,kBAAkB;YAClB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,KAAK,EAAE,QAAQ,CAAC,KAAgD;YAEhE,yBAAyB;YACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,YAAY,EAAE,QAAQ,CAAC,YAAY;YAEnC,cAAc;YACd,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,GAAG,EAAE,QAAQ,CAAC,GAAG;YAEjB,gBAAgB;YAChB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;QAEF,eAAe;QACf,MAAM,SAAS,GAAG,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAErD,IAAI,OAAO,EAAE;YACX,eAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;YAC7C,eAAM,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC;YAC5D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;SACtB;aAAM;YACL,eAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;YAC7C,eAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;SACtB;KACF;IAAC,OAAO,KAAU,EAAE;QACnB,eAAM,CAAC,KAAK,CAAC,8BAA8B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,MAAM,KAAK,CAAC;KACb;AACH,CAAC,CAAC,CAAC","sourcesContent":["import { task, types } from \"hardhat/config\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { Logger } from \"../utils/logger\";\n\n/**\n * Task: diamonds-forge:coverage\n *\n * Runs Forge coverage with Diamond deployment.\n * - Ensures Diamond deployment exists\n * - Generates Solidity helpers\n * - Runs forge coverage with specified options\n *\n * Use Hardhat's built-in --network flag to specify the network\n */\ntask(\"diamonds-forge:coverage\", \"Run forge coverage for Diamond contracts\")\n  .addParam(\n    \"diamondName\",\n    \"Name of the Diamond to analyze\",\n    undefined,\n    types.string\n  )\n  // Report options\n  .addOptionalParam(\n    \"report\",\n    \"Report type (summary, lcov, debug, bytecode) - can be used multiple times by passing comma-separated values\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"reportFile\",\n    \"Output path for report file\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"lcovVersion\",\n    \"LCOV format version\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"includeLibs\", \"Include libraries in coverage report\")\n  .addFlag(\"excludeTests\", \"Exclude tests from coverage report\")\n  .addFlag(\"irMinimum\", \"Enable viaIR with minimum optimization\")\n  // Test filtering\n  .addOptionalParam(\n    \"matchTest\",\n    \"Run tests matching pattern (--match-test)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchTest\",\n    \"Exclude tests matching pattern (--no-match-test)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"matchContract\",\n    \"Run contracts matching pattern (--match-contract)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchContract\",\n    \"Exclude contracts matching pattern (--no-match-contract)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"matchPath\",\n    \"Run files matching glob (--match-path)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchPath\",\n    \"Exclude files matching glob (--no-match-path)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchCoverage\",\n    \"Exclude files from coverage report (--no-match-coverage)\",\n    undefined,\n    types.string\n  )\n  // Display options\n  .addOptionalParam(\n    \"verbosity\",\n    \"Verbosity level (1-5, more v's = more verbose)\",\n    undefined,\n    types.int\n  )\n  .addFlag(\"quiet\", \"Suppress log output\")\n  .addFlag(\"json\", \"Format output as JSON\")\n  .addFlag(\"md\", \"Format output as Markdown\")\n  .addOptionalParam(\n    \"color\",\n    \"Color mode (auto, always, never)\",\n    undefined,\n    types.string\n  )\n  // Test execution options\n  .addOptionalParam(\n    \"threads\",\n    \"Number of threads to use\",\n    undefined,\n    types.int\n  )\n  .addOptionalParam(\n    \"fuzzRuns\",\n    \"Number of fuzz runs\",\n    undefined,\n    types.int\n  )\n  .addOptionalParam(\n    \"fuzzSeed\",\n    \"Seed for fuzz randomness\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"failFast\", \"Stop on first failure\")\n  .addFlag(\"allowFailure\", \"Exit 0 even if tests fail\")\n  // EVM options\n  .addOptionalParam(\n    \"forkBlockNumber\",\n    \"Fork from specific block number\",\n    undefined,\n    types.int\n  )\n  .addOptionalParam(\n    \"initialBalance\",\n    \"Initial balance for test contracts\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"sender\",\n    \"Test sender address\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"ffi\", \"Enable FFI cheatcode\")\n  // Build options\n  .addFlag(\"force\", \"Force recompile and redeploy\")\n  .addFlag(\"noCache\", \"Disable cache\")\n  .addFlag(\"optimize\", \"Enable Solidity optimizer\")\n  .addOptionalParam(\n    \"optimizerRuns\",\n    \"Optimizer runs\",\n    undefined,\n    types.int\n  )\n  .addFlag(\"viaIr\", \"Use Yul IR compilation\")\n  .setAction(async (taskArgs, hre: HardhatRuntimeEnvironment) => {\n    Logger.section(\"Running Forge Coverage with Diamond\");\n\n    const diamondName = taskArgs.diamondName;\n    const networkName = hre.network.name;\n\n    // Validate required parameters\n    if (!diamondName) {\n      Logger.error(\"--diamond-name is required\");\n      process.exitCode = 1;\n      return;\n    }\n\n    Logger.info(`Diamond: ${diamondName}`);\n    Logger.info(`Network: ${networkName}`);\n\n    try {\n      // Lazy-load framework classes to avoid circular dependency\n      const { DeploymentManager } = await import(\"../framework/DeploymentManager.js\");\n      const { HelperGenerator } = await import(\"../framework/HelperGenerator.js\");\n\n      // Step 1: Ensure Diamond deployment\n      Logger.section(\"Step 1/3: Ensuring Diamond Deployment\");\n      \n      const deploymentManager = new DeploymentManager(hre);\n      \n      await deploymentManager.ensureDeployment(\n        diamondName,\n        networkName,\n        taskArgs.force || false,\n        false // Don't write deployment data for coverage (ephemeral by default)\n      );\n\n      // Step 2: Generate helpers\n      Logger.section(\"Step 2/3: Generating Solidity Helpers\");\n      \n      const deployment = await deploymentManager.getDeployment(\n        diamondName,\n        networkName\n      );\n\n      if (!deployment) {\n        Logger.error(\"No deployment found. Cannot generate helpers.\");\n        process.exitCode = 1;\n        return;\n      }\n\n      const provider = hre.ethers.provider;\n      const network = await provider.getNetwork();\n      const chainId = Number(network.chainId);\n      const deploymentData = deployment.getDeployedDiamondData();\n\n      const helperGenerator = new HelperGenerator(hre);\n      await helperGenerator.generateDeploymentHelpers(\n        diamondName,\n        networkName,\n        chainId,\n        deploymentData,\n        deployment\n      );\n\n      // Step 3: Run coverage\n      Logger.section(\"Step 3/3: Running Forge Coverage\");\n\n      // Construct fork URL for network\n      // Coverage requires forking from a running network to access deployed contracts\n      let forkUrl: string;\n      if (networkName !== \"hardhat\") {\n        // Use the configured network's URL\n        forkUrl = (provider as any)._hardhatProvider?._wrapped?.url || \"http://127.0.0.1:8545\";\n        Logger.info(`Forking from ${networkName}: ${forkUrl}`);\n      } else {\n        // Default to localhost for hardhat network\n        // This assumes user has `npx hardhat node` running\n        forkUrl = \"http://127.0.0.1:8545\";\n        Logger.warn(`⚠️  Network is \"${networkName}\" - defaulting to localhost fork: ${forkUrl}`);\n        Logger.warn(`💡 Make sure Hardhat node is running: npx hardhat node`);\n        Logger.warn(`💡 Or specify network explicitly: --network localhost`);\n      }\n\n      // Lazy-load framework to avoid circular dependency\n      const { ForgeCoverageFramework } = await import(\"../framework/ForgeCoverageFramework.js\");\n      type CoverageOptions = Parameters<InstanceType<typeof ForgeCoverageFramework>[\"runCoverage\"]>[0];\n\n      // Build coverage options from task args\n      const options: CoverageOptions = {\n        // Fork URL\n        forkUrl,\n\n        // Report options\n        report: taskArgs.report ? taskArgs.report.split(\",\") : undefined,\n        reportFile: taskArgs.reportFile,\n        lcovVersion: taskArgs.lcovVersion,\n        includeLibs: taskArgs.includeLibs,\n        excludeTests: taskArgs.excludeTests,\n        irMinimum: taskArgs.irMinimum,\n\n        // Test filtering\n        matchTest: taskArgs.matchTest,\n        noMatchTest: taskArgs.noMatchTest,\n        matchContract: taskArgs.matchContract,\n        noMatchContract: taskArgs.noMatchContract,\n        matchPath: taskArgs.matchPath,\n        noMatchPath: taskArgs.noMatchPath,\n        noMatchCoverage: taskArgs.noMatchCoverage,\n\n        // Display options\n        verbosity: taskArgs.verbosity,\n        quiet: taskArgs.quiet,\n        json: taskArgs.json,\n        md: taskArgs.md,\n        color: taskArgs.color as \"auto\" | \"always\" | \"never\" | undefined,\n\n        // Test execution options\n        threads: taskArgs.threads,\n        fuzzRuns: taskArgs.fuzzRuns,\n        fuzzSeed: taskArgs.fuzzSeed,\n        failFast: taskArgs.failFast,\n        allowFailure: taskArgs.allowFailure,\n\n        // EVM options\n        forkBlockNumber: taskArgs.forkBlockNumber,\n        initialBalance: taskArgs.initialBalance,\n        sender: taskArgs.sender,\n        ffi: taskArgs.ffi,\n\n        // Build options\n        force: taskArgs.force,\n        noCache: taskArgs.noCache,\n        optimize: taskArgs.optimize,\n        optimizerRuns: taskArgs.optimizerRuns,\n        viaIr: taskArgs.viaIr,\n      };\n\n      // Run coverage\n      const framework = new ForgeCoverageFramework(hre);\n      const success = await framework.runCoverage(options);\n\n      if (success) {\n        Logger.section(\"Coverage Analysis Complete\");\n        Logger.success(\"Coverage analysis completed successfully!\");\n        process.exitCode = 0;\n      } else {\n        Logger.section(\"Coverage Analysis Complete\");\n        Logger.error(\"Coverage analysis failed\");\n        process.exitCode = 1;\n      }\n    } catch (error: any) {\n      Logger.error(`Coverage execution failed: ${error.message}`);\n      process.exitCode = 1;\n      throw error;\n    }\n  });\n"]}
+{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/tasks/coverage.ts"],"names":[],"mappings":"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","sourcesContent":["import { task, types } from \"hardhat/config\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { Logger } from \"../utils/logger\";\n\n/**\n * Task: diamonds-forge:coverage\n *\n * Runs Forge coverage with Diamond deployment.\n * - Ensures Diamond deployment exists\n * - Generates Solidity helpers\n * - Runs forge coverage with specified options\n *\n * Use Hardhat's built-in --network flag to specify the network\n * \n * Design: Mirrors diamonds-forge:test task structure for consistency\n */\ntask(\"diamonds-forge:coverage\", \"Run forge coverage for Diamond contracts\")\n  .addOptionalParam(\n    \"diamondName\",\n    \"Name of the Diamond to analyze\",\n    \"ExampleDiamond\",\n    types.string\n  )\n  // Report options\n  .addOptionalParam(\n    \"report\",\n    \"Report type (summary, lcov, debug, bytecode) - comma-separated for multiple\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"reportFile\",\n    \"Output path for report file\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"lcovVersion\",\n    \"LCOV format version (v1 or v2)\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"includeLibs\", \"Include libraries in coverage report\")\n  .addFlag(\"excludeTests\", \"Exclude tests from coverage report\")\n  .addFlag(\"irMinimum\", \"Enable viaIR with minimum optimization\")\n  // Test filtering\n  .addOptionalParam(\n    \"matchTest\",\n    \"Run tests matching pattern\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchTest\",\n    \"Exclude tests matching pattern\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"matchContract\",\n    \"Run contracts matching pattern\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchContract\",\n    \"Exclude contracts matching pattern\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"matchPath\",\n    \"Run files matching glob\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchPath\",\n    \"Exclude files matching glob\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchCoverage\",\n    \"Exclude files from coverage report\",\n    undefined,\n    types.string\n  )\n  // Display options\n  .addOptionalParam(\n    \"verbosity\",\n    \"Verbosity level (1-5)\",\n    undefined,\n    types.int\n  )\n  .addFlag(\"quiet\", \"Suppress log output\")\n  .addFlag(\"json\", \"Format output as JSON\")\n  .addFlag(\"md\", \"Format output as Markdown\")\n  .addOptionalParam(\n    \"color\",\n    \"Color mode (auto, always, never)\",\n    undefined,\n    types.string\n  )\n  // Test execution options\n  .addOptionalParam(\n    \"threads\",\n    \"Number of threads to use\",\n    undefined,\n    types.int\n  )\n  .addOptionalParam(\n    \"fuzzRuns\",\n    \"Number of fuzz runs\",\n    undefined,\n    types.int\n  )\n  .addOptionalParam(\n    \"fuzzSeed\",\n    \"Seed for fuzz randomness\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"failFast\", \"Stop on first failure\")\n  .addFlag(\"allowFailure\", \"Exit 0 even if tests fail\")\n  // EVM options\n  .addOptionalParam(\n    \"forkBlockNumber\",\n    \"Fork from specific block number\",\n    undefined,\n    types.int\n  )\n  .addOptionalParam(\n    \"initialBalance\",\n    \"Initial balance for test contracts\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"sender\",\n    \"Test sender address\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"ffi\", \"Enable FFI cheatcode\")\n  // Build/deployment options\n  .addFlag(\"force\", \"Force recompile and redeploy\")\n  .addFlag(\"noCache\", \"Disable cache\")\n  .addFlag(\"optimize\", \"Enable Solidity optimizer\")\n  .addOptionalParam(\n    \"optimizerRuns\",\n    \"Optimizer runs\",\n    undefined,\n    types.int\n  )\n  .addFlag(\"viaIr\", \"Use Yul IR compilation\")\n  .addFlag(\"skipDeployment\", \"Skip Diamond deployment step\")\n  .addFlag(\"skipHelpers\", \"Skip helper generation step\")\n  .addFlag(\"saveDeployment\", \"Write deployment data to file for reuse\")\n  .setAction(async (taskArgs, hre: HardhatRuntimeEnvironment) => {\n    Logger.section(\"Running Forge Coverage with Diamond\");\n\n    const diamondName = taskArgs.diamondName;\n    const networkName = hre.network.name;\n\n    Logger.info(`Diamond: ${diamondName}`);\n    Logger.info(`Network: ${networkName}`);\n\n    // Log key options\n    if (taskArgs.report) Logger.info(`Report: ${taskArgs.report}`);\n    if (taskArgs.reportFile) Logger.info(`Report File: ${taskArgs.reportFile}`);\n    if (taskArgs.matchTest) Logger.info(`Match Test: ${taskArgs.matchTest}`);\n    if (taskArgs.matchContract) Logger.info(`Match Contract: ${taskArgs.matchContract}`);\n    if (taskArgs.skipDeployment) Logger.info(\"Skip Deployment: true\");\n    if (taskArgs.skipHelpers) Logger.info(\"Skip Helpers: true\");\n    if (taskArgs.saveDeployment) Logger.info(\"Save Deployment: true\");\n\n    // Lazy-load framework to avoid circular dependency during config loading\n    const { ForgeCoverageFramework } = await import(\n      \"../framework/ForgeCoverageFramework.js\"\n    );\n    type CoverageOptions = Parameters<\n      InstanceType<typeof ForgeCoverageFramework>[\"runCoverage\"]\n    >[0];\n\n    // Parse comma-separated report types\n    const reportTypes = taskArgs.report\n      ? taskArgs.report.split(\",\").map((r: string) => r.trim())\n      : undefined;\n\n    // Create coverage options (matches test.ts pattern)\n    const options: CoverageOptions = {\n      diamondName,\n      networkName,\n      force: taskArgs.force,\n      skipDeployment: taskArgs.skipDeployment,\n      skipHelpers: taskArgs.skipHelpers,\n      writeDeployedDiamondData: taskArgs.saveDeployment,\n      // Report options\n      report: reportTypes,\n      reportFile: taskArgs.reportFile,\n      lcovVersion: taskArgs.lcovVersion,\n      includeLibs: taskArgs.includeLibs,\n      excludeTests: taskArgs.excludeTests,\n      irMinimum: taskArgs.irMinimum,\n      // Test filtering\n      matchTest: taskArgs.matchTest,\n      noMatchTest: taskArgs.noMatchTest,\n      matchContract: taskArgs.matchContract,\n      noMatchContract: taskArgs.noMatchContract,\n      matchPath: taskArgs.matchPath,\n      noMatchPath: taskArgs.noMatchPath,\n      noMatchCoverage: taskArgs.noMatchCoverage,\n      // Display options\n      verbosity: taskArgs.verbosity,\n      quiet: taskArgs.quiet,\n      json: taskArgs.json,\n      md: taskArgs.md,\n      color: taskArgs.color,\n      // Test execution\n      threads: taskArgs.threads,\n      fuzzRuns: taskArgs.fuzzRuns,\n      fuzzSeed: taskArgs.fuzzSeed,\n      failFast: taskArgs.failFast,\n      allowFailure: taskArgs.allowFailure,\n      // EVM options\n      forkBlockNumber: taskArgs.forkBlockNumber,\n      initialBalance: taskArgs.initialBalance,\n      sender: taskArgs.sender,\n      ffi: taskArgs.ffi,\n      // Build options\n      noCache: taskArgs.noCache,\n      optimize: taskArgs.optimize,\n      optimizerRuns: taskArgs.optimizerRuns,\n      viaIr: taskArgs.viaIr,\n    };\n\n    // Run coverage using the framework (same pattern as test.ts)\n    const framework = new ForgeCoverageFramework(hre);\n\n    try {\n      const success = await framework.runCoverage(options);\n\n      if (success) {\n        Logger.section(\"Coverage Analysis Complete\");\n        Logger.success(\"✅ Coverage completed successfully!\");\n        process.exitCode = 0;\n      } else {\n        Logger.section(\"Coverage Analysis Complete\");\n        Logger.error(\"❌ Coverage analysis failed\");\n        process.exitCode = 1;\n      }\n    } catch (error: any) {\n      Logger.error(`Coverage execution failed: ${error.message}`);\n      process.exitCode = 1;\n      throw error;\n    }\n  });\n"]}

package/dist/tasks/coverage.old.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=coverage.old.d.ts.map

package/dist/tasks/coverage.old.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.old.d.ts","sourceRoot":"","sources":["../../src/tasks/coverage.old.ts"],"names":[],"mappings":""}

package/dist/tasks/coverage.old.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("hardhat/config");
+const logger_1 = require("../utils/logger");
+/**
+ * Task: diamonds-forge:coverage
+ *
+ * Runs Forge coverage with Diamond deployment.
+ * - Ensures Diamond deployment exists
+ * - Generates Solidity helpers
+ * - Runs forge coverage with specified options
+ *
+ * Use Hardhat's built-in --network flag to specify the network
+ */
+(0, config_1.task)("diamonds-forge:coverage", "Run forge coverage for Diamond contracts")
+    .addParam("diamondName", "Name of the Diamond to analyze", undefined, config_1.types.string)
+    // Report options
+    .addOptionalParam("report", "Report type (summary, lcov, debug, bytecode) - can be used multiple times by passing comma-separated values", undefined, config_1.types.string)
+    .addOptionalParam("reportFile", "Output path for report file", undefined, config_1.types.string)
+    .addOptionalParam("lcovVersion", "LCOV format version", undefined, config_1.types.string)
+    .addFlag("includeLibs", "Include libraries in coverage report")
+    .addFlag("excludeTests", "Exclude tests from coverage report")
+    .addFlag("irMinimum", "Enable viaIR with minimum optimization")
+    // Test filtering
+    .addOptionalParam("matchTest", "Run tests matching pattern (--match-test)", undefined, config_1.types.string)
+    .addOptionalParam("noMatchTest", "Exclude tests matching pattern (--no-match-test)", undefined, config_1.types.string)
+    .addOptionalParam("matchContract", "Run contracts matching pattern (--match-contract)", undefined, config_1.types.string)
+    .addOptionalParam("noMatchContract", "Exclude contracts matching pattern (--no-match-contract)", undefined, config_1.types.string)
+    .addOptionalParam("matchPath", "Run files matching glob (--match-path)", undefined, config_1.types.string)
+    .addOptionalParam("noMatchPath", "Exclude files matching glob (--no-match-path)", undefined, config_1.types.string)
+    .addOptionalParam("noMatchCoverage", "Exclude files from coverage report (--no-match-coverage)", undefined, config_1.types.string)
+    // Display options
+    .addOptionalParam("verbosity", "Verbosity level (1-5, more v's = more verbose)", undefined, config_1.types.int)
+    .addFlag("quiet", "Suppress log output")
+    .addFlag("json", "Format output as JSON")
+    .addFlag("md", "Format output as Markdown")
+    .addOptionalParam("color", "Color mode (auto, always, never)", undefined, config_1.types.string)
+    // Test execution options
+    .addOptionalParam("threads", "Number of threads to use", undefined, config_1.types.int)
+    .addOptionalParam("fuzzRuns", "Number of fuzz runs", undefined, config_1.types.int)
+    .addOptionalParam("fuzzSeed", "Seed for fuzz randomness", undefined, config_1.types.string)
+    .addFlag("failFast", "Stop on first failure")
+    .addFlag("allowFailure", "Exit 0 even if tests fail")
+    // EVM options
+    .addOptionalParam("forkBlockNumber", "Fork from specific block number", undefined, config_1.types.int)
+    .addOptionalParam("initialBalance", "Initial balance for test contracts", undefined, config_1.types.string)
+    .addOptionalParam("sender", "Test sender address", undefined, config_1.types.string)
+    .addFlag("ffi", "Enable FFI cheatcode")
+    // Build options
+    .addFlag("force", "Force recompile and redeploy")
+    .addFlag("noCache", "Disable cache")
+    .addFlag("optimize", "Enable Solidity optimizer")
+    .addOptionalParam("optimizerRuns", "Optimizer runs", undefined, config_1.types.int)
+    .addFlag("viaIr", "Use Yul IR compilation")
+    .setAction(async (taskArgs, hre) => {
+    logger_1.Logger.section("Running Forge Coverage with Diamond");
+    const diamondName = taskArgs.diamondName;
+    const networkName = hre.network.name;
+    // Validate required parameters
+    if (!diamondName) {
+        logger_1.Logger.error("--diamond-name is required");
+        process.exitCode = 1;
+        return;
+    }
+    logger_1.Logger.info(`Diamond: ${diamondName}`);
+    logger_1.Logger.info(`Network: ${networkName}`);
+    try {
+        // Lazy-load framework classes to avoid circular dependency
+        const { DeploymentManager } = await import("../framework/DeploymentManager.js");
+        const { HelperGenerator } = await import("../framework/HelperGenerator.js");
+        // Step 1: Ensure Diamond deployment
+        logger_1.Logger.section("Step 1/3: Ensuring Diamond Deployment");
+        const deploymentManager = new DeploymentManager(hre);
+        await deploymentManager.ensureDeployment(diamondName, networkName, taskArgs.force || false, false // Don't write deployment data for coverage (ephemeral by default)
+        );
+        // Step 2: Generate helpers
+        logger_1.Logger.section("Step 2/3: Generating Solidity Helpers");
+        const deployment = await deploymentManager.getDeployment(diamondName, networkName);
+        if (!deployment) {
+            logger_1.Logger.error("No deployment found. Cannot generate helpers.");
+            process.exitCode = 1;
+            return;
+        }
+        const provider = hre.ethers.provider;
+        const network = await provider.getNetwork();
+        const chainId = Number(network.chainId);
+        const deploymentData = deployment.getDeployedDiamondData();
+        const helperGenerator = new HelperGenerator(hre);
+        await helperGenerator.generateDeploymentHelpers(diamondName, networkName, chainId, deploymentData, deployment);
+        // Step 3: Run coverage
+        logger_1.Logger.section("Step 3/3: Running Forge Coverage");
+        // Construct fork URL for network
+        // Coverage requires forking from a running network to access deployed contracts
+        let forkUrl;
+        if (networkName !== "hardhat") {
+            // Use the configured network's URL
+            forkUrl = provider._hardhatProvider?._wrapped?.url || "http://127.0.0.1:8545";
+            logger_1.Logger.info(`Forking from ${networkName}: ${forkUrl}`);
+        }
+        else {
+            // Default to localhost for hardhat network
+            // This assumes user has `npx hardhat node` running
+            forkUrl = "http://127.0.0.1:8545";
+            logger_1.Logger.warn(`⚠️  Network is "${networkName}" - defaulting to localhost fork: ${forkUrl}`);
+            logger_1.Logger.warn(`💡 Make sure Hardhat node is running: npx hardhat node`);
+            logger_1.Logger.warn(`💡 Or specify network explicitly: --network localhost`);
+        }
+        // Lazy-load framework to avoid circular dependency
+        const { ForgeCoverageFramework } = await import("../framework/ForgeCoverageFramework.js");
+        // Build coverage options from task args
+        const options = {
+            // Fork URL
+            forkUrl,
+            // Report options
+            report: taskArgs.report ? taskArgs.report.split(",") : undefined,
+            reportFile: taskArgs.reportFile,
+            lcovVersion: taskArgs.lcovVersion,
+            includeLibs: taskArgs.includeLibs,
+            excludeTests: taskArgs.excludeTests,
+            irMinimum: taskArgs.irMinimum,
+            // Test filtering
+            matchTest: taskArgs.matchTest,
+            noMatchTest: taskArgs.noMatchTest,
+            matchContract: taskArgs.matchContract,
+            noMatchContract: taskArgs.noMatchContract,
+            matchPath: taskArgs.matchPath,
+            noMatchPath: taskArgs.noMatchPath,
+            noMatchCoverage: taskArgs.noMatchCoverage,
+            // Display options
+            verbosity: taskArgs.verbosity,
+            quiet: taskArgs.quiet,
+            json: taskArgs.json,
+            md: taskArgs.md,
+            color: taskArgs.color,
+            // Test execution options
+            threads: taskArgs.threads,
+            fuzzRuns: taskArgs.fuzzRuns,
+            fuzzSeed: taskArgs.fuzzSeed,
+            failFast: taskArgs.failFast,
+            allowFailure: taskArgs.allowFailure,
+            // EVM options
+            forkBlockNumber: taskArgs.forkBlockNumber,
+            initialBalance: taskArgs.initialBalance,
+            sender: taskArgs.sender,
+            ffi: taskArgs.ffi,
+            // Build options
+            force: taskArgs.force,
+            noCache: taskArgs.noCache,
+            optimize: taskArgs.optimize,
+            optimizerRuns: taskArgs.optimizerRuns,
+            viaIr: taskArgs.viaIr,
+        };
+        // Run coverage
+        const framework = new ForgeCoverageFramework(hre);
+        const success = await framework.runCoverage(options);
+        if (success) {
+            logger_1.Logger.section("Coverage Analysis Complete");
+            logger_1.Logger.success("Coverage analysis completed successfully!");
+            process.exitCode = 0;
+        }
+        else {
+            logger_1.Logger.section("Coverage Analysis Complete");
+            logger_1.Logger.error("Coverage analysis failed");
+            process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        logger_1.Logger.error(`Coverage execution failed: ${error.message}`);
+        process.exitCode = 1;
+        throw error;
+    }
+});
+//# sourceMappingURL=coverage.old.js.map

package/dist/tasks/coverage.old.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.old.js","sourceRoot":"","sources":["../../src/tasks/coverage.old.ts"],"names":[],"mappings":"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","sourcesContent":["import { task, types } from \"hardhat/config\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { Logger } from \"../utils/logger\";\n\n/**\n * Task: diamonds-forge:coverage\n *\n * Runs Forge coverage with Diamond deployment.\n * - Ensures Diamond deployment exists\n * - Generates Solidity helpers\n * - Runs forge coverage with specified options\n *\n * Use Hardhat's built-in --network flag to specify the network\n */\ntask(\"diamonds-forge:coverage\", \"Run forge coverage for Diamond contracts\")\n  .addParam(\n    \"diamondName\",\n    \"Name of the Diamond to analyze\",\n    undefined,\n    types.string\n  )\n  // Report options\n  .addOptionalParam(\n    \"report\",\n    \"Report type (summary, lcov, debug, bytecode) - can be used multiple times by passing comma-separated values\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"reportFile\",\n    \"Output path for report file\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"lcovVersion\",\n    \"LCOV format version\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"includeLibs\", \"Include libraries in coverage report\")\n  .addFlag(\"excludeTests\", \"Exclude tests from coverage report\")\n  .addFlag(\"irMinimum\", \"Enable viaIR with minimum optimization\")\n  // Test filtering\n  .addOptionalParam(\n    \"matchTest\",\n    \"Run tests matching pattern (--match-test)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchTest\",\n    \"Exclude tests matching pattern (--no-match-test)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"matchContract\",\n    \"Run contracts matching pattern (--match-contract)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchContract\",\n    \"Exclude contracts matching pattern (--no-match-contract)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"matchPath\",\n    \"Run files matching glob (--match-path)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchPath\",\n    \"Exclude files matching glob (--no-match-path)\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"noMatchCoverage\",\n    \"Exclude files from coverage report (--no-match-coverage)\",\n    undefined,\n    types.string\n  )\n  // Display options\n  .addOptionalParam(\n    \"verbosity\",\n    \"Verbosity level (1-5, more v's = more verbose)\",\n    undefined,\n    types.int\n  )\n  .addFlag(\"quiet\", \"Suppress log output\")\n  .addFlag(\"json\", \"Format output as JSON\")\n  .addFlag(\"md\", \"Format output as Markdown\")\n  .addOptionalParam(\n    \"color\",\n    \"Color mode (auto, always, never)\",\n    undefined,\n    types.string\n  )\n  // Test execution options\n  .addOptionalParam(\n    \"threads\",\n    \"Number of threads to use\",\n    undefined,\n    types.int\n  )\n  .addOptionalParam(\n    \"fuzzRuns\",\n    \"Number of fuzz runs\",\n    undefined,\n    types.int\n  )\n  .addOptionalParam(\n    \"fuzzSeed\",\n    \"Seed for fuzz randomness\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"failFast\", \"Stop on first failure\")\n  .addFlag(\"allowFailure\", \"Exit 0 even if tests fail\")\n  // EVM options\n  .addOptionalParam(\n    \"forkBlockNumber\",\n    \"Fork from specific block number\",\n    undefined,\n    types.int\n  )\n  .addOptionalParam(\n    \"initialBalance\",\n    \"Initial balance for test contracts\",\n    undefined,\n    types.string\n  )\n  .addOptionalParam(\n    \"sender\",\n    \"Test sender address\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"ffi\", \"Enable FFI cheatcode\")\n  // Build options\n  .addFlag(\"force\", \"Force recompile and redeploy\")\n  .addFlag(\"noCache\", \"Disable cache\")\n  .addFlag(\"optimize\", \"Enable Solidity optimizer\")\n  .addOptionalParam(\n    \"optimizerRuns\",\n    \"Optimizer runs\",\n    undefined,\n    types.int\n  )\n  .addFlag(\"viaIr\", \"Use Yul IR compilation\")\n  .setAction(async (taskArgs, hre: HardhatRuntimeEnvironment) => {\n    Logger.section(\"Running Forge Coverage with Diamond\");\n\n    const diamondName = taskArgs.diamondName;\n    const networkName = hre.network.name;\n\n    // Validate required parameters\n    if (!diamondName) {\n      Logger.error(\"--diamond-name is required\");\n      process.exitCode = 1;\n      return;\n    }\n\n    Logger.info(`Diamond: ${diamondName}`);\n    Logger.info(`Network: ${networkName}`);\n\n    try {\n      // Lazy-load framework classes to avoid circular dependency\n      const { DeploymentManager } = await import(\"../framework/DeploymentManager.js\");\n      const { HelperGenerator } = await import(\"../framework/HelperGenerator.js\");\n\n      // Step 1: Ensure Diamond deployment\n      Logger.section(\"Step 1/3: Ensuring Diamond Deployment\");\n      \n      const deploymentManager = new DeploymentManager(hre);\n      \n      await deploymentManager.ensureDeployment(\n        diamondName,\n        networkName,\n        taskArgs.force || false,\n        false // Don't write deployment data for coverage (ephemeral by default)\n      );\n\n      // Step 2: Generate helpers\n      Logger.section(\"Step 2/3: Generating Solidity Helpers\");\n      \n      const deployment = await deploymentManager.getDeployment(\n        diamondName,\n        networkName\n      );\n\n      if (!deployment) {\n        Logger.error(\"No deployment found. Cannot generate helpers.\");\n        process.exitCode = 1;\n        return;\n      }\n\n      const provider = hre.ethers.provider;\n      const network = await provider.getNetwork();\n      const chainId = Number(network.chainId);\n      const deploymentData = deployment.getDeployedDiamondData();\n\n      const helperGenerator = new HelperGenerator(hre);\n      await helperGenerator.generateDeploymentHelpers(\n        diamondName,\n        networkName,\n        chainId,\n        deploymentData,\n        deployment\n      );\n\n      // Step 3: Run coverage\n      Logger.section(\"Step 3/3: Running Forge Coverage\");\n\n      // Construct fork URL for network\n      // Coverage requires forking from a running network to access deployed contracts\n      let forkUrl: string;\n      if (networkName !== \"hardhat\") {\n        // Use the configured network's URL\n        forkUrl = (provider as any)._hardhatProvider?._wrapped?.url || \"http://127.0.0.1:8545\";\n        Logger.info(`Forking from ${networkName}: ${forkUrl}`);\n      } else {\n        // Default to localhost for hardhat network\n        // This assumes user has `npx hardhat node` running\n        forkUrl = \"http://127.0.0.1:8545\";\n        Logger.warn(`⚠️  Network is \"${networkName}\" - defaulting to localhost fork: ${forkUrl}`);\n        Logger.warn(`💡 Make sure Hardhat node is running: npx hardhat node`);\n        Logger.warn(`💡 Or specify network explicitly: --network localhost`);\n      }\n\n      // Lazy-load framework to avoid circular dependency\n      const { ForgeCoverageFramework } = await import(\"../framework/ForgeCoverageFramework.js\");\n      type CoverageOptions = Parameters<InstanceType<typeof ForgeCoverageFramework>[\"runCoverage\"]>[0];\n\n      // Build coverage options from task args\n      const options: CoverageOptions = {\n        // Fork URL\n        forkUrl,\n\n        // Report options\n        report: taskArgs.report ? taskArgs.report.split(\",\") : undefined,\n        reportFile: taskArgs.reportFile,\n        lcovVersion: taskArgs.lcovVersion,\n        includeLibs: taskArgs.includeLibs,\n        excludeTests: taskArgs.excludeTests,\n        irMinimum: taskArgs.irMinimum,\n\n        // Test filtering\n        matchTest: taskArgs.matchTest,\n        noMatchTest: taskArgs.noMatchTest,\n        matchContract: taskArgs.matchContract,\n        noMatchContract: taskArgs.noMatchContract,\n        matchPath: taskArgs.matchPath,\n        noMatchPath: taskArgs.noMatchPath,\n        noMatchCoverage: taskArgs.noMatchCoverage,\n\n        // Display options\n        verbosity: taskArgs.verbosity,\n        quiet: taskArgs.quiet,\n        json: taskArgs.json,\n        md: taskArgs.md,\n        color: taskArgs.color as \"auto\" | \"always\" | \"never\" | undefined,\n\n        // Test execution options\n        threads: taskArgs.threads,\n        fuzzRuns: taskArgs.fuzzRuns,\n        fuzzSeed: taskArgs.fuzzSeed,\n        failFast: taskArgs.failFast,\n        allowFailure: taskArgs.allowFailure,\n\n        // EVM options\n        forkBlockNumber: taskArgs.forkBlockNumber,\n        initialBalance: taskArgs.initialBalance,\n        sender: taskArgs.sender,\n        ffi: taskArgs.ffi,\n\n        // Build options\n        force: taskArgs.force,\n        noCache: taskArgs.noCache,\n        optimize: taskArgs.optimize,\n        optimizerRuns: taskArgs.optimizerRuns,\n        viaIr: taskArgs.viaIr,\n      };\n\n      // Run coverage\n      const framework = new ForgeCoverageFramework(hre);\n      const success = await framework.runCoverage(options);\n\n      if (success) {\n        Logger.section(\"Coverage Analysis Complete\");\n        Logger.success(\"Coverage analysis completed successfully!\");\n        process.exitCode = 0;\n      } else {\n        Logger.section(\"Coverage Analysis Complete\");\n        Logger.error(\"Coverage analysis failed\");\n        process.exitCode = 1;\n      }\n    } catch (error: any) {\n      Logger.error(`Coverage execution failed: ${error.message}`);\n      process.exitCode = 1;\n      throw error;\n    }\n  });\n"]}

package/dist/types/config.d.ts

@@ -49,8 +49,19 @@ export type ColorMode = "auto" | "always" | "never";
 /**
  * Coverage options for forge coverage command
  * Maps to all available forge coverage command-line options
+ * Plus orchestration options for Diamond deployment and helpers
  */
 export interface CoverageOptions {
+    /** Name of the Diamond to analyze */
+    diamondName?: string;
+    /** Network name for deployment (hardhat, localhost, etc.) */
+    networkName?: string;
+    /** Skip Diamond deployment step */
+    skipDeployment?: boolean;
+    /** Skip helper generation step */
+    skipHelpers?: boolean;
+    /** Write deployment data to file for reuse */
+    writeDeployedDiamondData?: boolean;
     /** Report type(s) - can specify multiple */
     report?: CoverageReportType[];
     /** Output path for report file */

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}

package/dist/types/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAwCH;;GAEG;AACU,QAAA,cAAc,GAAoC;IAC7D,UAAU,EAAE,sBAAsB;IAClC,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC;IAC7C,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,EAAE;CAClB,CAAC","sourcesContent":["/**\n * Configuration types for diamonds-hardhat-foundry plugin\n * Will be fully implemented in Task 2.1\n */\n\nexport interface DiamondsFoundryConfig {\n  /**\n   * Output directory for generated helpers (relative to project root)\n   * @default \"test/foundry/helpers\"\n   */\n  helpersDir?: string;\n\n  /**\n   * Whether to generate example tests on init\n   * @default true\n   */\n  generateExamples?: boolean;\n\n  /**\n   * Example test templates to generate\n   * @default [\"unit\", \"integration\", \"fuzz\"]\n   */\n  exampleTests?: Array<\"unit\" | \"integration\" | \"fuzz\">;\n\n  /**\n   * Default network for deployments\n   * @default \"hardhat\"\n   */\n  defaultNetwork?: string;\n\n  /**\n   * Whether to reuse existing deployment or deploy fresh\n   * @default true\n   */\n  reuseDeployment?: boolean;\n\n  /**\n   * Additional forge test arguments\n   * @default []\n   */\n  forgeTestArgs?: string[];\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: Required<DiamondsFoundryConfig> = {\n  helpersDir: \"test/foundry/helpers\",\n  generateExamples: true,\n  exampleTests: [\"unit\", \"integration\", \"fuzz\"],\n  defaultNetwork: \"hardhat\",\n  reuseDeployment: true,\n  forgeTestArgs: [],\n};\n\n/**\n * Type for forge coverage report formats\n */\nexport type CoverageReportType = \"summary\" | \"lcov\" | \"debug\" | \"bytecode\";\n\n/**\n * Type for color output modes\n */\nexport type ColorMode = \"auto\" | \"always\" | \"never\";\n\n/**\n * Coverage options for forge coverage command\n * Maps to all available forge coverage command-line options\n */\nexport interface CoverageOptions {\n  // Report options\n  /** Report type(s) - can specify multiple */\n  report?: CoverageReportType[];\n  /** Output path for report file */\n  reportFile?: string;\n  /** LCOV format version (default: 1) */\n  lcovVersion?: string;\n  /** Include libraries in coverage report */\n  includeLibs?: boolean;\n  /** Exclude tests from coverage report */\n  excludeTests?: boolean;\n  /** Enable viaIR with minimum optimization */\n  irMinimum?: boolean;\n\n  // Test filtering\n  /** Run tests matching regex pattern */\n  matchTest?: string;\n  /** Exclude tests matching regex pattern */\n  noMatchTest?: string;\n  /** Run contracts matching regex pattern */\n  matchContract?: string;\n  /** Exclude contracts matching regex pattern */\n  noMatchContract?: string;\n  /** Run files matching glob pattern */\n  matchPath?: string;\n  /** Exclude files matching glob pattern */\n  noMatchPath?: string;\n  /** Exclude files from coverage report matching regex */\n  noMatchCoverage?: string;\n\n  // Display options\n  /** Verbosity level (1-5) - more v's = more verbose */\n  verbosity?: number;\n  /** Suppress log output */\n  quiet?: boolean;\n  /** Format output as JSON */\n  json?: boolean;\n  /** Format output as Markdown */\n  md?: boolean;\n  /** Color output mode */\n  color?: ColorMode;\n\n  // Test execution options\n  /** Number of threads to use for parallel execution */\n  threads?: number;\n  /** Number of fuzz test runs */\n  fuzzRuns?: number;\n  /** Seed for fuzz test randomness (for reproducibility) */\n  fuzzSeed?: string;\n  /** Stop running tests after first failure */\n  failFast?: boolean;\n  /** Exit with code 0 even if tests fail */\n  allowFailure?: boolean;\n\n  // EVM options\n  /** Fork URL for network state */\n  forkUrl?: string;\n  /** Fork from specific block number */\n  forkBlockNumber?: number;\n  /** Initial balance for deployed test contracts */\n  initialBalance?: string;\n  /** Address to use as test sender */\n  sender?: string;\n  /** Enable FFI (Foreign Function Interface) cheatcode */\n  ffi?: boolean;\n\n  // Build options\n  /** Force recompilation and cache clearing */\n  force?: boolean;\n  /** Disable compiler cache */\n  noCache?: boolean;\n  /** Enable Solidity optimizer */\n  optimize?: boolean;\n  /** Number of optimizer runs */\n  optimizerRuns?: number;\n  /** Use Yul intermediate representation compilation */\n  viaIr?: boolean;\n}\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAwCH;;GAEG;AACU,QAAA,cAAc,GAAoC;IAC7D,UAAU,EAAE,sBAAsB;IAClC,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC;IAC7C,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,EAAE;CAClB,CAAC","sourcesContent":["/**\n * Configuration types for diamonds-hardhat-foundry plugin\n * Will be fully implemented in Task 2.1\n */\n\nexport interface DiamondsFoundryConfig {\n  /**\n   * Output directory for generated helpers (relative to project root)\n   * @default \"test/foundry/helpers\"\n   */\n  helpersDir?: string;\n\n  /**\n   * Whether to generate example tests on init\n   * @default true\n   */\n  generateExamples?: boolean;\n\n  /**\n   * Example test templates to generate\n   * @default [\"unit\", \"integration\", \"fuzz\"]\n   */\n  exampleTests?: Array<\"unit\" | \"integration\" | \"fuzz\">;\n\n  /**\n   * Default network for deployments\n   * @default \"hardhat\"\n   */\n  defaultNetwork?: string;\n\n  /**\n   * Whether to reuse existing deployment or deploy fresh\n   * @default true\n   */\n  reuseDeployment?: boolean;\n\n  /**\n   * Additional forge test arguments\n   * @default []\n   */\n  forgeTestArgs?: string[];\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: Required<DiamondsFoundryConfig> = {\n  helpersDir: \"test/foundry/helpers\",\n  generateExamples: true,\n  exampleTests: [\"unit\", \"integration\", \"fuzz\"],\n  defaultNetwork: \"hardhat\",\n  reuseDeployment: true,\n  forgeTestArgs: [],\n};\n\n/**\n * Type for forge coverage report formats\n */\nexport type CoverageReportType = \"summary\" | \"lcov\" | \"debug\" | \"bytecode\";\n\n/**\n * Type for color output modes\n */\nexport type ColorMode = \"auto\" | \"always\" | \"never\";\n\n/**\n * Coverage options for forge coverage command\n * Maps to all available forge coverage command-line options\n * Plus orchestration options for Diamond deployment and helpers\n */\nexport interface CoverageOptions {\n  // Orchestration options (matching ForgeFuzzingFramework pattern)\n  /** Name of the Diamond to analyze */\n  diamondName?: string;\n  /** Network name for deployment (hardhat, localhost, etc.) */\n  networkName?: string;\n  /** Skip Diamond deployment step */\n  skipDeployment?: boolean;\n  /** Skip helper generation step */\n  skipHelpers?: boolean;\n  /** Write deployment data to file for reuse */\n  writeDeployedDiamondData?: boolean;\n\n  // Report options\n  /** Report type(s) - can specify multiple */\n  report?: CoverageReportType[];\n  /** Output path for report file */\n  reportFile?: string;\n  /** LCOV format version (default: 1) */\n  lcovVersion?: string;\n  /** Include libraries in coverage report */\n  includeLibs?: boolean;\n  /** Exclude tests from coverage report */\n  excludeTests?: boolean;\n  /** Enable viaIR with minimum optimization */\n  irMinimum?: boolean;\n\n  // Test filtering\n  /** Run tests matching regex pattern */\n  matchTest?: string;\n  /** Exclude tests matching regex pattern */\n  noMatchTest?: string;\n  /** Run contracts matching regex pattern */\n  matchContract?: string;\n  /** Exclude contracts matching regex pattern */\n  noMatchContract?: string;\n  /** Run files matching glob pattern */\n  matchPath?: string;\n  /** Exclude files matching glob pattern */\n  noMatchPath?: string;\n  /** Exclude files from coverage report matching regex */\n  noMatchCoverage?: string;\n\n  // Display options\n  /** Verbosity level (1-5) - more v's = more verbose */\n  verbosity?: number;\n  /** Suppress log output */\n  quiet?: boolean;\n  /** Format output as JSON */\n  json?: boolean;\n  /** Format output as Markdown */\n  md?: boolean;\n  /** Color output mode */\n  color?: ColorMode;\n\n  // Test execution options\n  /** Number of threads to use for parallel execution */\n  threads?: number;\n  /** Number of fuzz test runs */\n  fuzzRuns?: number;\n  /** Seed for fuzz test randomness (for reproducibility) */\n  fuzzSeed?: string;\n  /** Stop running tests after first failure */\n  failFast?: boolean;\n  /** Exit with code 0 even if tests fail */\n  allowFailure?: boolean;\n\n  // EVM options\n  /** Fork URL for network state */\n  forkUrl?: string;\n  /** Fork from specific block number */\n  forkBlockNumber?: number;\n  /** Initial balance for deployed test contracts */\n  initialBalance?: string;\n  /** Address to use as test sender */\n  sender?: string;\n  /** Enable FFI (Foreign Function Interface) cheatcode */\n  ffi?: boolean;\n\n  // Build options\n  /** Force recompilation and cache clearing */\n  force?: boolean;\n  /** Disable compiler cache */\n  noCache?: boolean;\n  /** Enable Solidity optimizer */\n  optimize?: boolean;\n  /** Number of optimizer runs */\n  optimizerRuns?: number;\n  /** Use Yul intermediate representation compilation */\n  viaIr?: boolean;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diamondslab/diamonds-hardhat-foundry",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Hardhat plugin that integrates Foundry testing with Diamond proxy contracts, providing deployment helpers and fuzzing support",
   "repository": {
     "type": "git",