create-fhevm-example 1.2.3 → 1.3.1

package/dist/scripts/index.js

@@ -0,0 +1,384 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * create-fhevm-example - CLI for creating FHEVM example projects
+ *
+ * Usage:
+ *   npx create-fhevm-example                    # Interactive mode
+ *   npx create-fhevm-example --example <name>   # Create single example
+ *   npx create-fhevm-example --category <name>  # Create category project
+ *   npx create-fhevm-example --add              # Add to existing project
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const p = __importStar(require("@clack/prompts"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const config_1 = require("./config");
+const utils_1 = require("./utils");
+const builders_1 = require("./builders");
+const ui_1 = require("./ui");
+const add_mode_1 = require("./add-mode");
+const generate_docs_1 = require("./generate-docs");
+/** Prompts user to select mode and returns project configuration */
+async function getProjectConfig() {
+    // Build options - docs only available in local dev mode
+    const options = [
+        {
+            value: "single",
+            label: "Create a single example project",
+            hint: "One example contract with tests",
+        },
+        {
+            value: "category",
+            label: "Create a category-based project",
+            hint: "Bundle all examples from a category",
+        },
+    ];
+    // Add docs option only in local dev mode (npm run create)
+    if (process.env.LOCAL_DEV === "1") {
+        options.push({
+            value: "docs",
+            label: "Generate documentation",
+            hint: "Generate GitBook docs for examples",
+        });
+    }
+    const mode = await p.select({
+        message: "What would you like to create?",
+        options,
+    });
+    if (p.isCancel(mode)) {
+        p.cancel("Operation cancelled.");
+        return null;
+    }
+    let name;
+    if (mode === "single") {
+        const category = await (0, ui_1.promptSelectCategory)();
+        if (p.isCancel(category)) {
+            p.cancel("Operation cancelled.");
+            return null;
+        }
+        const example = await (0, ui_1.promptSelectExampleFromCategory)(category);
+        if (p.isCancel(example)) {
+            p.cancel("Operation cancelled.");
+            return null;
+        }
+        name = example;
+    }
+    else if (mode === "docs") {
+        // Handle docs mode - call generate-docs interactive
+        await (0, generate_docs_1.handleInteractiveDocs)();
+        return null; // Exit after docs generation
+    }
+    else {
+        const category = await (0, ui_1.promptSelectCategoryProject)();
+        if (p.isCancel(category)) {
+            p.cancel("Operation cancelled.");
+            return null;
+        }
+        name = category;
+    }
+    const projectName = await p.text({
+        message: "Project name:",
+        placeholder: `my-${name}-project`,
+        defaultValue: `my-${name}-project`,
+    });
+    if (p.isCancel(projectName)) {
+        p.cancel("Operation cancelled.");
+        return null;
+    }
+    const outputDir = await p.text({
+        message: "Output directory:",
+        placeholder: `./${projectName}`,
+        defaultValue: `./${projectName}`,
+    });
+    if (p.isCancel(outputDir)) {
+        p.cancel("Operation cancelled.");
+        return null;
+    }
+    const shouldInstall = await p.confirm({
+        message: "Install dependencies and run tests?",
+        initialValue: false,
+    });
+    if (p.isCancel(shouldInstall)) {
+        p.cancel("Operation cancelled.");
+        return null;
+    }
+    return {
+        mode: mode,
+        name,
+        outputDir: outputDir,
+        shouldInstall: shouldInstall,
+    };
+}
+/** Scaffolds project and shows completion message */
+async function scaffoldProject(config) {
+    const resolvedOutput = path.resolve(process.cwd(), config.outputDir);
+    if (fs.existsSync(resolvedOutput)) {
+        p.log.error(`Directory already exists: ${resolvedOutput}`);
+        process.exit(1);
+    }
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "fhevm-"));
+    const s = p.spinner();
+    try {
+        s.start("Downloading template...");
+        const tempRepoPath = await (0, utils_1.cloneTemplate)(tempDir);
+        s.message("Initializing submodules...");
+        await (0, utils_1.initSubmodule)(tempRepoPath);
+        s.message("Scaffolding your confidential project...");
+        if (config.mode === "single") {
+            await (0, builders_1.createSingleExample)(config.name, resolvedOutput, tempRepoPath);
+        }
+        else {
+            await (0, builders_1.createCategoryProject)(config.name, resolvedOutput, tempRepoPath);
+        }
+        s.stop("🎉 Project scaffolded successfully!");
+        const relativePath = path.relative(process.cwd(), resolvedOutput);
+        p.log.success(`📁 Created: ${picocolors_1.default.cyan(relativePath)}`);
+        if (config.mode === "single") {
+            const exampleConfig = config_1.EXAMPLES[config.name];
+            if (exampleConfig) {
+                p.log.info(`📝 Example: ${picocolors_1.default.yellow(exampleConfig.title)}`);
+            }
+        }
+        else {
+            const categoryConfig = config_1.CATEGORIES[config.name];
+            if (categoryConfig) {
+                p.log.info(`📦 Category: ${picocolors_1.default.yellow(categoryConfig.name)}`);
+                p.log.info(`📄 Contracts: ${picocolors_1.default.green(String(categoryConfig.contracts.length))}`);
+            }
+        }
+        if (config.shouldInstall) {
+            p.log.message("");
+            await (0, ui_1.runInstallAndTest)(resolvedOutput);
+        }
+        else {
+            p.note(`${picocolors_1.default.dim("$")} cd ${relativePath}\n${picocolors_1.default.dim("$")} npm install\n${picocolors_1.default.dim("$")} npm run compile\n${picocolors_1.default.dim("$")} npm run test`, "🚀 Quick Start");
+        }
+    }
+    catch (error) {
+        s.stop(picocolors_1.default.red("Failed to create project"));
+        p.log.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+    finally {
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+    }
+    p.outro(picocolors_1.default.green("✅ Setup complete. Happy encrypting!"));
+}
+/** Main interactive mode entry point */
+async function runInteractiveMode() {
+    console.clear();
+    p.intro(picocolors_1.default.bgCyan(picocolors_1.default.black(" ⚡ FHEVM Example Factory ")));
+    const config = await getProjectConfig();
+    if (!config)
+        return;
+    await scaffoldProject(config);
+}
+function parseArgs(args) {
+    const parsed = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const nextArg = args[i + 1];
+            if (nextArg && !nextArg.startsWith("--")) {
+                parsed[key] = nextArg;
+                i++;
+            }
+            else {
+                parsed[key] = true;
+            }
+        }
+        else if (arg === "-h") {
+            parsed["help"] = true;
+        }
+    }
+    return parsed;
+}
+async function runDirectMode(args) {
+    const parsedArgs = parseArgs(args);
+    if (parsedArgs["help"]) {
+        showHelp();
+        return;
+    }
+    if (parsedArgs["add"]) {
+        const targetDir = parsedArgs["target"];
+        await (0, add_mode_1.runAddMode)(targetDir);
+        return;
+    }
+    const exampleName = parsedArgs["example"];
+    const categoryName = parsedArgs["category"];
+    const outputDir = parsedArgs["output"];
+    const shouldInstall = parsedArgs["install"] === true;
+    if (!exampleName && !categoryName) {
+        utils_1.log.error(utils_1.ERROR_MESSAGES.EXAMPLE_REQUIRED);
+        showHelp();
+        (0, utils_1.handleError)("Missing required argument");
+    }
+    if (exampleName && categoryName) {
+        (0, utils_1.handleError)(utils_1.ERROR_MESSAGES.BOTH_SPECIFIED);
+    }
+    const mode = exampleName ? "example" : "category";
+    const name = (exampleName || categoryName);
+    try {
+        if (mode === "example") {
+            (0, utils_1.validateExample)(name);
+        }
+        else {
+            (0, utils_1.validateCategory)(name);
+        }
+    }
+    catch (error) {
+        utils_1.log.message("Available: " +
+            Object.keys(mode === "example" ? config_1.EXAMPLES : config_1.CATEGORIES).join(", "));
+        (0, utils_1.handleError)(error);
+    }
+    const defaultOutput = mode === "example" ? `./my-${name}-project` : `./my-${name}-examples`;
+    const output = outputDir || defaultOutput;
+    const resolved = path.resolve(process.cwd(), output);
+    try {
+        (0, utils_1.validateDirectoryNotExists)(resolved);
+    }
+    catch (error) {
+        (0, utils_1.handleError)(error);
+    }
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "fhevm-"));
+    try {
+        utils_1.log.info(`\n🚀 Creating ${mode}: ${picocolors_1.default.yellow(name)}`);
+        utils_1.log.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+        utils_1.log.dim("Downloading template...");
+        const tempRepoPath = await (0, utils_1.cloneTemplate)(tempDir);
+        utils_1.log.dim("Initializing submodules...");
+        await (0, utils_1.initSubmodule)(tempRepoPath);
+        utils_1.log.dim("Building project...");
+        if (mode === "example") {
+            await (0, builders_1.createSingleExample)(name, resolved, tempRepoPath);
+        }
+        else {
+            await (0, builders_1.createCategoryProject)(name, resolved, tempRepoPath);
+        }
+        utils_1.log.success(`\n✨ Successfully created: ${picocolors_1.default.cyan(output)}`);
+        if (shouldInstall) {
+            utils_1.log.dim("Installing dependencies and running tests...");
+            await (0, ui_1.runInstallAndTest)(resolved);
+        }
+        else {
+            utils_1.log.message(picocolors_1.default.dim("\nNext steps:"));
+            utils_1.log.message(`  ${picocolors_1.default.cyan("cd")} ${output}`);
+            utils_1.log.message(`  ${picocolors_1.default.cyan("npm install")}`);
+            utils_1.log.message(`  ${picocolors_1.default.cyan("npm run compile")}`);
+            utils_1.log.message(`  ${picocolors_1.default.cyan("npm run test")}`);
+        }
+    }
+    catch (error) {
+        (0, utils_1.handleError)(error);
+    }
+    finally {
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+    }
+}
+// =============================================================================
+// QUICK MODE (CLI Arguments)
+// =============================================================================
+function showHelp() {
+    console.log(`
+${picocolors_1.default.bgCyan(picocolors_1.default.black(picocolors_1.default.bold(" 🔐 create-fhevm-example ")))}
+${picocolors_1.default.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("📋 USAGE"))}
+
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")}                  ${picocolors_1.default.dim("→")} Interactive mode ${picocolors_1.default.yellow("(recommended)")}
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--example")} ${picocolors_1.default.yellow("<name>")}  ${picocolors_1.default.dim("→")} Create single example
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--category")} ${picocolors_1.default.yellow("<name>")} ${picocolors_1.default.dim("→")} Create category project
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--add")}               ${picocolors_1.default.dim("→")} Add to existing project
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("⚙️  OPTIONS"))}
+
+  ${picocolors_1.default.green("--example")} ${picocolors_1.default.dim("<name>")}      Create a single example project
+  ${picocolors_1.default.green("--category")} ${picocolors_1.default.dim("<name>")}     Create a category project
+  ${picocolors_1.default.green("--add")}                 Add FHEVM to existing Hardhat project
+  ${picocolors_1.default.green("--target")} ${picocolors_1.default.dim("<dir>")}        Target directory for --add mode
+  ${picocolors_1.default.green("--output")} ${picocolors_1.default.dim("<dir>")}        Output directory
+  ${picocolors_1.default.green("--install")}             Auto-install dependencies
+  ${picocolors_1.default.green("--test")}                Auto-run tests (requires --install)
+  ${picocolors_1.default.green("--help")}${picocolors_1.default.dim(", -h")}            Show this help message
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("⚡ EXAMPLES"))}
+
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--example")} ${picocolors_1.default.yellow("fhe-counter")}
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--category")} ${picocolors_1.default.yellow("basic")} ${picocolors_1.default.green("--output")} ${picocolors_1.default.blue("./my-project")}
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--add")}
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--example")} ${picocolors_1.default.yellow("fhe-counter")} ${picocolors_1.default.green("--install")} ${picocolors_1.default.green("--test")}
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("📦 AVAILABLE EXAMPLES"))}
+
+  ${picocolors_1.default.dim(Object.keys(config_1.EXAMPLES).slice(0, 10).join(", "))}
+  ${picocolors_1.default.dim("...")} and ${picocolors_1.default.yellow(String(Object.keys(config_1.EXAMPLES).length - 10))} more
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("📁 AVAILABLE CATEGORIES"))}
+
+  ${Object.keys(config_1.CATEGORIES)
+        .map((c) => picocolors_1.default.yellow(c))
+        .join(", ")}
+
+${picocolors_1.default.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
+${picocolors_1.default.dim("📚 Documentation:")} ${picocolors_1.default.blue("https://github.com/NecipAkgz/fhevm-example-factory")}
+`);
+}
+// =============================================================================
+// MAIN ENTRY POINT
+// =============================================================================
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length > 0) {
+        await runDirectMode(args);
+    }
+    else {
+        await runInteractiveMode();
+    }
+}
+main().catch((error) => {
+    (0, utils_1.handleError)(error);
+});

package/dist/scripts/maintenance.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Maintenance Tools - Utilities for project maintenance and testing.
+ *
+ * Includes the test-all runner which allows for efficient testing
+ * of multiple examples in a temporary workspace.
+ *
+ * Usage:
+ *   npm run test:all                      # Interactive selection
+ *   npm run test:all fhe-counter,fhe-add  # Direct CLI
+ */
+export declare function testAllExamples(cliExamples?: string[]): Promise<void>;
+//# sourceMappingURL=maintenance.d.ts.map

package/dist/scripts/maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../scripts/maintenance.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AAwNH,wBAAsB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC3E"}

package/dist/scripts/maintenance.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Maintenance Tools - Utilities for project maintenance and testing.
+ *
+ * Includes the test-all runner which allows for efficient testing
+ * of multiple examples in a temporary workspace.
+ *
+ * Usage:
+ *   npm run test:all                      # Interactive selection
+ *   npm run test:all fhe-counter,fhe-add  # Direct CLI
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testAllExamples = testAllExamples;
+const p = __importStar(require("@clack/prompts"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const utils_1 = require("./utils");
+const builders_1 = require("./builders");
+// =============================================================================
+// Example Selection
+// =============================================================================
+async function getExamplesToTest(cliExamples) {
+    const allExamples = (0, config_1.getExampleNames)();
+    if (cliExamples && cliExamples.length > 0) {
+        const invalid = cliExamples.filter((e) => !allExamples.includes(e));
+        if (invalid.length > 0) {
+            p.log.error(`Unknown examples: ${invalid.join(", ")}`);
+            p.log.message(picocolors_1.default.dim(`Available: ${allExamples.join(", ")}`));
+            process.exit(1);
+        }
+        p.log.message(`Testing ${picocolors_1.default.bold(String(cliExamples.length))} examples...`);
+        return cliExamples;
+    }
+    const selected = await p.multiselect({
+        message: "Select examples to test (space to toggle, enter to confirm):",
+        options: allExamples.map((ex) => ({
+            value: ex,
+            label: ex,
+            hint: config_1.EXAMPLES[ex]?.category || "",
+        })),
+        required: true,
+    });
+    if (p.isCancel(selected)) {
+        p.cancel("Operation cancelled");
+        process.exit(0);
+    }
+    return selected;
+}
+// =============================================================================
+// Test Runner
+// =============================================================================
+async function runTestPipeline(tempDir, exampleCount) {
+    const summary = {
+        totalExamples: exampleCount,
+        passed: 0,
+        failed: 0,
+        compileSuccess: false,
+        failedTests: [],
+    };
+    const s1 = p.spinner();
+    s1.start("Installing dependencies...");
+    const installResult = await (0, utils_1.runCommandWithStatus)("npm", ["install"], tempDir);
+    if (!installResult.success) {
+        s1.stop(picocolors_1.default.red("✗ npm install failed"));
+        p.log.error((0, utils_1.extractErrorMessage)(installResult.output));
+        return summary;
+    }
+    s1.stop(picocolors_1.default.green("✓ Dependencies installed"));
+    const s2 = p.spinner();
+    s2.start("Compiling contracts...");
+    const compileResult = await (0, utils_1.runCommandWithStatus)("npm", ["run", "compile"], tempDir);
+    if (!compileResult.success) {
+        s2.stop(picocolors_1.default.red("✗ Compilation failed"));
+        p.log.error((0, utils_1.extractErrorMessage)(compileResult.output));
+        return summary;
+    }
+    s2.stop(picocolors_1.default.green("✓ Contracts compiled"));
+    summary.compileSuccess = true;
+    const testDir = path.join(tempDir, "test");
+    const testFiles = fs
+        .readdirSync(testDir)
+        .filter((f) => f.endsWith(".test.ts") || f.endsWith(".ts"))
+        .filter((f) => f !== "types.ts");
+    if (testFiles.length === 0) {
+        p.log.warning("No test files found");
+        return summary;
+    }
+    p.log.message("");
+    p.log.message(picocolors_1.default.bold(`🧪 Running ${testFiles.length} test files:`));
+    p.log.message("");
+    let passedTests = 0;
+    let failedTests = 0;
+    const startTime = Date.now();
+    for (let i = 0; i < testFiles.length; i++) {
+        const testFile = testFiles[i];
+        const progress = `[${i + 1}/${testFiles.length}]`;
+        process.stdout.write(`  ${picocolors_1.default.dim(progress)} ${testFile} `);
+        const testStart = Date.now();
+        const result = await (0, utils_1.runCommandWithStatus)("npx", ["hardhat", "test", `test/${testFile}`], tempDir);
+        const duration = ((Date.now() - testStart) / 1000).toFixed(1);
+        if (result.success) {
+            const testResults = (0, utils_1.extractTestResults)(result.output);
+            const resultInfo = testResults
+                ? picocolors_1.default.dim(`(${testResults.replace(" ✓", "")})`)
+                : "";
+            p.log.message(picocolors_1.default.green(`✓`) + ` ${picocolors_1.default.dim(duration + "s")} ${resultInfo}`);
+            passedTests++;
+        }
+        else {
+            p.log.message(picocolors_1.default.red(`✗`) + ` ${picocolors_1.default.dim(duration + "s")}`);
+            failedTests++;
+            summary.failedTests.push(testFile);
+            const errorMsg = (0, utils_1.extractErrorMessage)(result.output);
+            if (errorMsg) {
+                const shortError = errorMsg.split("\n")[0].slice(0, 80);
+                p.log.message(`    ${picocolors_1.default.red(picocolors_1.default.dim(shortError))}`);
+            }
+        }
+    }
+    const totalDuration = ((Date.now() - startTime) / 1000).toFixed(1);
+    p.log.message("");
+    p.log.message(picocolors_1.default.dim(`Completed in ${totalDuration}s`));
+    summary.passed = passedTests;
+    summary.failed = failedTests;
+    return summary;
+}
+function showSummary(summary) {
+    p.log.message("");
+    p.log.message(picocolors_1.default.bold("📊 Test Summary"));
+    p.log.message(picocolors_1.default.dim("─".repeat(50)));
+    p.log.message(`${picocolors_1.default.blue("📦 Examples:")} ${summary.totalExamples}`);
+    p.log.message(`${picocolors_1.default.blue("📁 Compile:")} ${summary.compileSuccess ? picocolors_1.default.green("✓ Success") : picocolors_1.default.red("✗ Failed")}`);
+    if (summary.compileSuccess) {
+        if (summary.failed === 0) {
+            p.log.message(`${picocolors_1.default.green("✓ Tests:")} All passed`);
+        }
+        else {
+            p.log.message(`${picocolors_1.default.green("✓ Passed:")} ${summary.passed}`);
+            p.log.message(`${picocolors_1.default.red("✗ Failed:")} ${summary.failed}`);
+            if (summary.failedTests.length > 0) {
+                p.log.message("");
+                p.log.message(picocolors_1.default.red(picocolors_1.default.bold("Failed tests:")));
+                for (const test of summary.failedTests.slice(0, 10)) {
+                    p.log.message(picocolors_1.default.red(`  ✗ ${test}`));
+                }
+                if (summary.failedTests.length > 10) {
+                    p.log.message(picocolors_1.default.dim(`  ... and ${summary.failedTests.length - 10} more`));
+                }
+            }
+        }
+    }
+    p.log.message(picocolors_1.default.dim("─".repeat(50)));
+    if (summary.compileSuccess && summary.failed === 0) {
+        p.outro(picocolors_1.default.green("✨ All tests passed!"));
+    }
+    else {
+        p.outro(picocolors_1.default.yellow("Some issues need attention"));
+    }
+}
+// =============================================================================
+// Main Command
+// =============================================================================
+async function testAllExamples(cliExamples) {
+    p.intro(picocolors_1.default.cyan("🧪 FHEVM Example Tester"));
+    const examplesToTest = await getExamplesToTest(cliExamples);
+    if (examplesToTest.length === 0) {
+        p.log.warning("No examples selected");
+        p.outro(picocolors_1.default.dim("Nothing to test"));
+        return;
+    }
+    p.log.message("");
+    p.log.message(`📦 Testing ${picocolors_1.default.bold(String(examplesToTest.length))} examples...`);
+    const tempDir = path.join((0, utils_1.getRootDir)(), ".test-temp");
+    if (fs.existsSync(tempDir)) {
+        fs.rmSync(tempDir, { recursive: true });
+    }
+    let summary;
+    try {
+        const s = p.spinner();
+        s.start("Setting up test project...");
+        await (0, builders_1.createLocalTestProject)(examplesToTest, tempDir);
+        s.stop(picocolors_1.default.green("✓ Project ready"));
+        summary = await runTestPipeline(tempDir, examplesToTest.length);
+    }
+    finally {
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true });
+        }
+    }
+    showSummary(summary);
+}
+// =============================================================================
+// CLI Entry Point
+// =============================================================================
+function showHelp() {
+    utils_1.log.info("🔧 FHEVM Maintenance Tools");
+    utils_1.log.message("");
+    utils_1.log.message("Available commands:");
+    utils_1.log.message("");
+    utils_1.log.message("  test-all  Test examples");
+    utils_1.log.message("");
+    utils_1.log.message("Usage:");
+    utils_1.log.dim("  npm run test:all");
+    utils_1.log.dim("  npm run test:all fhe-counter,fhe-add");
+}
+async function main() {
+    const args = process.argv.slice(2);
+    // Check for help flag first
+    if (args.includes("--help") || args.includes("-h")) {
+        showHelp();
+        return;
+    }
+    const command = args[0];
+    switch (command) {
+        case "test-all": {
+            const exampleArg = args[1];
+            // Filter out help flags from example list
+            const examples = exampleArg && !exampleArg.startsWith("-")
+                ? exampleArg.split(",")
+                : undefined;
+            await testAllExamples(examples);
+            break;
+        }
+        default:
+            showHelp();
+    }
+}
+// Only run if this is the main module
+const isMainModule = process.argv[1]?.includes("maintenance");
+if (isMainModule) {
+    main().catch(console.error);
+}