@diamondslab/diamonds-hardhat-foundry 2.2.2 → 2.3.0

package/dist/tasks/coverage.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.js.map

package/dist/tasks/coverage.js.map

@@ -0,0 +1 @@
+{"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 */\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

@@ -38,4 +38,84 @@ export interface DiamondsFoundryConfig {
  * Default configuration values
  */
 export declare const DEFAULT_CONFIG: Required<DiamondsFoundryConfig>;
+/**
+ * Type for forge coverage report formats
+ */
+export type CoverageReportType = "summary" | "lcov" | "debug" | "bytecode";
+/**
+ * Type for color output modes
+ */
+export type ColorMode = "auto" | "always" | "never";
+/**
+ * Coverage options for forge coverage command
+ * Maps to all available forge coverage command-line options
+ */
+export interface CoverageOptions {
+    /** Report type(s) - can specify multiple */
+    report?: CoverageReportType[];
+    /** Output path for report file */
+    reportFile?: string;
+    /** LCOV format version (default: 1) */
+    lcovVersion?: string;
+    /** Include libraries in coverage report */
+    includeLibs?: boolean;
+    /** Exclude tests from coverage report */
+    excludeTests?: boolean;
+    /** Enable viaIR with minimum optimization */
+    irMinimum?: boolean;
+    /** Run tests matching regex pattern */
+    matchTest?: string;
+    /** Exclude tests matching regex pattern */
+    noMatchTest?: string;
+    /** Run contracts matching regex pattern */
+    matchContract?: string;
+    /** Exclude contracts matching regex pattern */
+    noMatchContract?: string;
+    /** Run files matching glob pattern */
+    matchPath?: string;
+    /** Exclude files matching glob pattern */
+    noMatchPath?: string;
+    /** Exclude files from coverage report matching regex */
+    noMatchCoverage?: string;
+    /** Verbosity level (1-5) - more v's = more verbose */
+    verbosity?: number;
+    /** Suppress log output */
+    quiet?: boolean;
+    /** Format output as JSON */
+    json?: boolean;
+    /** Format output as Markdown */
+    md?: boolean;
+    /** Color output mode */
+    color?: ColorMode;
+    /** Number of threads to use for parallel execution */
+    threads?: number;
+    /** Number of fuzz test runs */
+    fuzzRuns?: number;
+    /** Seed for fuzz test randomness (for reproducibility) */
+    fuzzSeed?: string;
+    /** Stop running tests after first failure */
+    failFast?: boolean;
+    /** Exit with code 0 even if tests fail */
+    allowFailure?: boolean;
+    /** Fork URL for network state */
+    forkUrl?: string;
+    /** Fork from specific block number */
+    forkBlockNumber?: number;
+    /** Initial balance for deployed test contracts */
+    initialBalance?: string;
+    /** Address to use as test sender */
+    sender?: string;
+    /** Enable FFI (Foreign Function Interface) cheatcode */
+    ffi?: boolean;
+    /** Force recompilation and cache clearing */
+    force?: boolean;
+    /** Disable compiler cache */
+    noCache?: boolean;
+    /** Enable Solidity optimizer */
+    optimize?: boolean;
+    /** Number of optimizer runs */
+    optimizerRuns?: number;
+    /** Use Yul intermediate representation compilation */
+    viaIr?: boolean;
+}
 //# sourceMappingURL=config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC,CAAC;IAEtD;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,qBAAqB,CAO1D,CAAC"}
+{"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"]}
+{"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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diamondslab/diamonds-hardhat-foundry",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "description": "Hardhat plugin that integrates Foundry testing with Diamond proxy contracts, providing deployment helpers and fuzzing support",
   "repository": {
     "type": "git",
@@ -68,8 +68,8 @@
     "typescript": "~5.0.0"
   },
   "peerDependencies": {
-    "@diamondslab/diamonds": "^1.3.0",
-    "@diamondslab/hardhat-diamonds": "^1.1.12",
+    "@diamondslab/diamonds": "workspace:^",
+    "@diamondslab/hardhat-diamonds": "workspace:^",
     "@nomicfoundation/hardhat-ethers": "^3.0.8",
     "ethers": "^6.0.0",
     "hardhat": "^2.26.0"

package/src/framework/ForgeCoverageFramework.ts

@@ -0,0 +1,287 @@
+import { spawn } from "child_process";
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+import { CoverageOptions } from "../types/config";
+import { Logger } from "../utils/logger";
+
+/**
+ * ForgeCoverageFramework - Orchestrates forge coverage execution for Diamond contracts
+ *
+ * Responsibilities:
+ * 1. Build forge coverage command with all options
+ * 2. Execute forge coverage with proper fork URL
+ * 3. Stream output to terminal
+ * 4. Handle errors appropriately
+ */
+export class ForgeCoverageFramework {
+  constructor(private hre: HardhatRuntimeEnvironment) {}
+
+  /**
+   * Run forge coverage with provided options
+   *
+   * @param options - Coverage execution options
+   * @returns Promise<boolean> - true if coverage succeeds, false otherwise
+   */
+  async runCoverage(options: CoverageOptions = {}): Promise<boolean> {
+    Logger.section("Forge Coverage - Execution");
+
+    try {
+      // Build command arguments
+      const args = this.buildCoverageCommand(options);
+
+      Logger.info(`Executing: forge coverage ${args.join(" ")}`);
+      Logger.info("⏳ Running coverage analysis (this may take a while)...\n");
+
+      // Execute forge coverage
+      const success = await this.executeForge(args);
+
+      if (success) {
+        Logger.success("✅ Coverage analysis completed successfully");
+      } else {
+        Logger.error("❌ Coverage analysis failed");
+      }
+
+      return success;
+    } catch (error: any) {
+      Logger.error(`Coverage execution error: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Build complete forge coverage command arguments
+   *
+   * @param options - Coverage options
+   * @returns Array of command arguments
+   */
+  private buildCoverageCommand(options: CoverageOptions): string[] {
+    const args: string[] = [];
+
+    // Add fork URL if provided
+    if (options.forkUrl) {
+      args.push("--fork-url", options.forkUrl);
+    }
+
+    // Add all option groups
+    args.push(...this.buildReportOptions(options));
+    args.push(...this.buildFilterOptions(options));
+    args.push(...this.buildDisplayOptions(options));
+    args.push(...this.buildTestOptions(options));
+    args.push(...this.buildEvmOptions(options));
+    args.push(...this.buildBuildOptions(options));
+
+    return args.filter((arg) => arg !== "");
+  }
+
+  /**
+   * Build report-related options
+   */
+  private buildReportOptions(options: CoverageOptions): string[] {
+    const args: string[] = [];
+
+    // Multiple --report flags
+    if (options.report && options.report.length > 0) {
+      options.report.forEach((reportType) => {
+        args.push("--report", reportType);
+      });
+    }
+
+    if (options.reportFile) {
+      args.push("--report-file", options.reportFile);
+    }
+
+    if (options.lcovVersion) {
+      args.push("--lcov-version", options.lcovVersion);
+    }
+
+    if (options.includeLibs) {
+      args.push("--include-libs");
+    }
+
+    if (options.excludeTests) {
+      args.push("--exclude-tests");
+    }
+
+    if (options.irMinimum) {
+      args.push("--ir-minimum");
+    }
+
+    return args;
+  }
+
+  /**
+   * Build test filtering options
+   */
+  private buildFilterOptions(options: CoverageOptions): string[] {
+    const args: string[] = [];
+
+    if (options.matchTest) {
+      args.push("--match-test", options.matchTest);
+    }
+
+    if (options.noMatchTest) {
+      args.push("--no-match-test", options.noMatchTest);
+    }
+
+    if (options.matchContract) {
+      args.push("--match-contract", options.matchContract);
+    }
+
+    if (options.noMatchContract) {
+      args.push("--no-match-contract", options.noMatchContract);
+    }
+
+    if (options.matchPath) {
+      args.push("--match-path", options.matchPath);
+    }
+
+    if (options.noMatchPath) {
+      args.push("--no-match-path", options.noMatchPath);
+    }
+
+    if (options.noMatchCoverage) {
+      args.push("--no-match-coverage", options.noMatchCoverage);
+    }
+
+    return args;
+  }
+
+  /**
+   * Build display options
+   */
+  private buildDisplayOptions(options: CoverageOptions): string[] {
+    const args: string[] = [];
+
+    // Verbosity (-v, -vv, -vvv, etc.)
+    if (options.verbosity && options.verbosity > 0) {
+      args.push("-" + "v".repeat(options.verbosity));
+    }
+
+    if (options.quiet) {
+      args.push("--quiet");
+    }
+
+    if (options.json) {
+      args.push("--json");
+    }
+
+    if (options.md) {
+      args.push("--md");
+    }
+
+    if (options.color) {
+      args.push("--color", options.color);
+    }
+
+    return args;
+  }
+
+  /**
+   * Build test execution options
+   */
+  private buildTestOptions(options: CoverageOptions): string[] {
+    const args: string[] = [];
+
+    if (options.threads !== undefined) {
+      args.push("--threads", options.threads.toString());
+    }
+
+    if (options.fuzzRuns !== undefined) {
+      args.push("--fuzz-runs", options.fuzzRuns.toString());
+    }
+
+    if (options.fuzzSeed) {
+      args.push("--fuzz-seed", options.fuzzSeed);
+    }
+
+    if (options.failFast) {
+      args.push("--fail-fast");
+    }
+
+    if (options.allowFailure) {
+      args.push("--allow-failure");
+    }
+
+    return args;
+  }
+
+  /**
+   * Build EVM options
+   */
+  private buildEvmOptions(options: CoverageOptions): string[] {
+    const args: string[] = [];
+
+    if (options.forkBlockNumber !== undefined) {
+      args.push("--fork-block-number", options.forkBlockNumber.toString());
+    }
+
+    if (options.initialBalance) {
+      args.push("--initial-balance", options.initialBalance);
+    }
+
+    if (options.sender) {
+      args.push("--sender", options.sender);
+    }
+
+    if (options.ffi) {
+      args.push("--ffi");
+    }
+
+    return args;
+  }
+
+  /**
+   * Build build options
+   */
+  private buildBuildOptions(options: CoverageOptions): string[] {
+    const args: string[] = [];
+
+    if (options.force) {
+      args.push("--force");
+    }
+
+    if (options.noCache) {
+      args.push("--no-cache");
+    }
+
+    if (options.optimize) {
+      args.push("--optimize");
+    }
+
+    if (options.optimizerRuns !== undefined) {
+      args.push("--optimizer-runs", options.optimizerRuns.toString());
+    }
+
+    if (options.viaIr) {
+      args.push("--via-ir");
+    }
+
+    return args;
+  }
+
+  /**
+   * Execute forge coverage command and stream output
+   *
+   * @param args - Command arguments
+   * @returns Promise<boolean> - true if command succeeds
+   */
+  private executeForge(args: string[]): Promise<boolean> {
+    return new Promise((resolve, reject) => {
+      const forgeProcess = spawn("forge", ["coverage", ...args], {
+        cwd: this.hre.config.paths.root,
+        stdio: "inherit", // Stream output directly to terminal
+      });
+
+      forgeProcess.on("close", (code) => {
+        if (code === 0) {
+          resolve(true);
+        } else {
+          resolve(false);
+        }
+      });
+
+      forgeProcess.on("error", (error) => {
+        reject(new Error(`Failed to execute forge coverage: ${error.message}`));
+      });
+    });
+  }
+}

package/src/framework/HelperGenerator.ts

@@ -1,4 +1,4 @@
-import { DeployedDiamondData } from "@diamondslab/diamonds";
+import { DeployedDiamondData, Diamond } from "@diamondslab/diamonds";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { HardhatRuntimeEnvironment } from "hardhat/types";
 import { join } from "path";
@@ -79,12 +79,16 @@ export class HelperGenerator {
    * @private
    */
   private setForgeEnvironmentVariables(
-    diamond: any,
+    diamond: Diamond,
     deploymentData: DeployedDiamondData
   ): void {
     try {
-      // Get Diamond ABI path
-      const abiPath = diamond.getDiamondAbiFilePath?.() || `./diamond-abi/${deploymentData.DiamondAddress}.json`;
+      // Get Diamond ABI path - remove leading "./" for Foundry compatibility
+      let abiPath = diamond.getDiamondAbiFilePath?.() || `diamond-abi/${diamond.getDiamondConfig().diamondName}.json` || `diamond-abi/Diamond.json`;
+      // Normalize path - remove leading "./" if present
+      if (abiPath.startsWith('./')) {
+        abiPath = abiPath.substring(2);
+      }
       
       // Get Diamond address
       const diamondAddress = deploymentData.DiamondAddress;
@@ -222,7 +226,7 @@ export class HelperGenerator {
     // Diamond ABI path
     source += `    /// @notice Path to the Diamond ABI file\n`;
     source += `    /// @dev Used by DiamondFuzzBase to load ABI for testing\n`;
-    source += `    string constant DIAMOND_ABI_PATH = "./diamond-abi/${diamondName}.json";\n\n`;
+    source += `    string constant DIAMOND_ABI_PATH = "diamond-abi/${diamondName}.json";\n\n`;
 
     // Diamond address
     source += `    /// @notice Address of the deployed ${diamondName} contract\n`;