@solana-epic/cli 0.1.0-beta.1

package/dist/benchmark.d.ts

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

package/dist/benchmark.d.ts.map

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

package/dist/benchmark.js

@@ -0,0 +1,344 @@
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import fs from "node:fs";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const BENCHMARK_SUITE = [
+    // 1. Squads V4
+    {
+        id: "squads_add_rent_collector",
+        protocol: "Squads",
+        upgradeName: "Multisig Add rent_collector field",
+        repoPath: path.resolve(__dirname, "../../../test-repos/squads-v4"),
+        filePath: "programs/squads_multisig_program/src/state/multisig.rs",
+        oldCommit: "72e3c3b542c7ba9a5d0a7e0d6d784d889727d009^",
+        newCommit: "72e3c3b542c7ba9a5d0a7e0d6d784d889727d009",
+        expectedSeverity: "Critical",
+        expectedChange: "StructFieldRemoval"
+    },
+    {
+        id: "squads_add_spending_limit",
+        protocol: "Squads",
+        upgradeName: "Add SpendingLimit Account",
+        repoPath: path.resolve(__dirname, "../../../test-repos/squads-v4"),
+        filePath: "programs/multisig/src/state/spending_limit.rs",
+        oldCommit: "88e3486^",
+        newCommit: "88e3486",
+        expectedSeverity: "Safe",
+        expectedChange: "AccountLayoutChange"
+    },
+    {
+        id: "squads_time_lock_refactor",
+        protocol: "Squads",
+        upgradeName: "Constant and helper refactoring",
+        repoPath: path.resolve(__dirname, "../../../test-repos/squads-v4"),
+        filePath: "programs/squads_multisig_program/src/state/multisig.rs",
+        oldCommit: "720ca8c^",
+        newCommit: "720ca8c",
+        expectedSeverity: "Safe",
+        expectedChange: "None"
+    },
+    // 2. MarginFi V2
+    {
+        id: "marginfi_padding_admin_utilization",
+        protocol: "MarginFi",
+        upgradeName: "Group Padding Admin Utilization",
+        repoPath: path.resolve(__dirname, "../../../test-repos/marginfi"),
+        filePath: "type-crate/src/types/group.rs",
+        oldCommit: "8f38cfb9109cbc7ee78cea6fe4c4e9a925933122^",
+        newCommit: "8f38cfb9109cbc7ee78cea6fe4c4e9a925933122",
+        expectedSeverity: "Critical",
+        expectedChange: "StructFieldAddition"
+    },
+    {
+        id: "marginfi_delegate_bank_admins",
+        protocol: "MarginFi",
+        upgradeName: "Delegate Bank Admins Expansion",
+        repoPath: path.resolve(__dirname, "../../../test-repos/marginfi"),
+        filePath: "type-crate/src/types/group.rs",
+        oldCommit: "35b8970^",
+        newCommit: "35b8970",
+        expectedSeverity: "Critical",
+        expectedChange: "StructFieldAddition"
+    },
+    {
+        id: "marginfi_juplend_integration",
+        protocol: "MarginFi",
+        upgradeName: "JupLend OracleSetup Enum Additions",
+        repoPath: path.resolve(__dirname, "../../../test-repos/marginfi"),
+        filePath: "type-crate/src/types/bank.rs",
+        oldCommit: "72ef8fc^",
+        newCommit: "72ef8fc",
+        expectedSeverity: "Minor",
+        expectedChange: "EnumVariantAddition"
+    },
+    // 3. Drift V2
+    {
+        id: "drift_lp_position_replacement",
+        protocol: "Drift",
+        upgradeName: "User Isolated Position Replacement",
+        repoPath: path.resolve(__dirname, "../../../test-repos/drift-v2"),
+        filePath: "programs/drift/src/state/user.rs",
+        oldCommit: "97355509aba9a4373ad99e7c741a3527c20483b3^",
+        newCommit: "97355509aba9a4373ad99e7c741a3527c20483b3",
+        expectedSeverity: "Critical",
+        expectedChange: "StructFieldRemoval"
+    },
+    {
+        id: "drift_max_margin_ratio_add",
+        protocol: "Drift",
+        upgradeName: "Max Margin Ratio field addition",
+        repoPath: path.resolve(__dirname, "../../../test-repos/drift-v2"),
+        filePath: "programs/drift/src/state/user.rs",
+        oldCommit: "5bc8dd0^",
+        newCommit: "5bc8dd0",
+        expectedSeverity: "Critical",
+        expectedChange: "TypeChange"
+    },
+    {
+        id: "drift_margin_mode_refactor",
+        protocol: "Drift",
+        upgradeName: "Separate margin checks refactor",
+        repoPath: path.resolve(__dirname, "../../../test-repos/drift-v2"),
+        filePath: "programs/drift/src/state/user.rs",
+        oldCommit: "bd68a37^",
+        newCommit: "bd68a37",
+        expectedSeverity: "Safe",
+        expectedChange: "None"
+    },
+    // 4. Kamino Lending
+    {
+        id: "kamino_permissioned_ops_add",
+        protocol: "Kamino",
+        upgradeName: "Release 1.23.0 PermissionedOps",
+        repoPath: path.resolve(__dirname, "../../../test-repos/kamino"),
+        filePath: "programs/klend/src/state/reserve.rs",
+        oldCommit: "3759217^",
+        newCommit: "3759217",
+        expectedSeverity: "Major",
+        expectedChange: "StructFieldAddition"
+    },
+    {
+        id: "kamino_rewards_available_add",
+        protocol: "Kamino",
+        upgradeName: "Release 1.21.0 Rewards Sizing",
+        repoPath: path.resolve(__dirname, "../../../test-repos/kamino"),
+        filePath: "programs/klend/src/state/reserve.rs",
+        oldCommit: "a26220c^",
+        newCommit: "a26220c",
+        expectedSeverity: "Critical",
+        expectedChange: "StructFieldAddition"
+    },
+    {
+        id: "kamino_rewards_bps_refactor",
+        protocol: "Kamino",
+        upgradeName: "Release 1.22.0 Rewards signature refactor",
+        repoPath: path.resolve(__dirname, "../../../test-repos/kamino"),
+        filePath: "programs/klend/src/state/reserve.rs",
+        oldCommit: "4c7653a^",
+        newCommit: "4c7653a",
+        expectedSeverity: "Safe",
+        expectedChange: "None"
+    },
+    // 5. Mango V4
+    {
+        id: "mango_collateral_fees_add",
+        protocol: "Mango",
+        upgradeName: "Add Collateral Fees Layout Shift",
+        repoPath: path.resolve(__dirname, "../../../test-repos/mango"),
+        filePath: "programs/mango-v4/src/state/mango_account.rs",
+        oldCommit: "e57dcdc2a^",
+        newCommit: "e57dcdc2a",
+        expectedSeverity: "Critical",
+        expectedChange: "StructFieldAddition"
+    },
+    {
+        id: "mango_sequence_check_u8",
+        protocol: "Mango",
+        upgradeName: "Sequence Number type shrinking",
+        repoPath: path.resolve(__dirname, "../../../test-repos/mango"),
+        filePath: "programs/mango-v4/src/state/mango_account.rs",
+        oldCommit: "0728bb566^",
+        newCommit: "0728bb566",
+        expectedSeverity: "Critical",
+        expectedChange: "TypeChange"
+    },
+    {
+        id: "mango_withdraw_overflow_fix",
+        protocol: "Mango",
+        upgradeName: "Withdraw overflow error refactor",
+        repoPath: path.resolve(__dirname, "../../../test-repos/mango"),
+        filePath: "programs/mango-v4/src/state/mango_account.rs",
+        oldCommit: "61117ccd1^",
+        newCommit: "61117ccd1",
+        expectedSeverity: "Safe",
+        expectedChange: "None"
+    }
+];
+function findRustBinary() {
+    const possiblePaths = [
+        path.resolve(__dirname, "../../parser-v2/target/release/parser-v2"),
+        path.resolve(__dirname, "../../parser-v2/target/debug/parser-v2"),
+        path.resolve(__dirname, "./parser-v2"),
+    ];
+    for (const binaryPath of possiblePaths) {
+        const target = process.platform === "win32" ? `${binaryPath}.exe` : binaryPath;
+        if (fs.existsSync(target)) {
+            return target;
+        }
+    }
+    return "parser-v2";
+}
+function getGitFileContent(repoPath, commit, filePath) {
+    const result = spawnSync("git", ["show", `${commit}:${filePath}`], {
+        cwd: repoPath,
+        encoding: "utf-8",
+        maxBuffer: 10 * 1024 * 1024
+    });
+    if (result.status === 0) {
+        return result.stdout;
+    }
+    return null;
+}
+function runBenchmark() {
+    console.log("==================================================");
+    console.log("EPIC HISTORICAL UPGRADE BENCHMARK RUNNER");
+    console.log(`Total Cases to Evaluate: ${BENCHMARK_SUITE.length}`);
+    console.log("==================================================");
+    const binary = findRustBinary();
+    console.log(`Using EPIC Engine: ${binary}\n`);
+    const tempOldDir = path.resolve(__dirname, "../temp-benchmark/old");
+    const tempNewDir = path.resolve(__dirname, "../temp-benchmark/new");
+    fs.mkdirSync(tempOldDir, { recursive: true });
+    fs.mkdirSync(tempNewDir, { recursive: true });
+    const results = [];
+    let passedCount = 0;
+    let falsePositives = 0;
+    let falseNegatives = 0;
+    for (const c of BENCHMARK_SUITE) {
+        console.log(`[Evaluating] ${c.protocol} - ${c.upgradeName}...`);
+        // Clean temp directories
+        fs.readdirSync(tempOldDir).forEach((file) => fs.unlinkSync(path.join(tempOldDir, file)));
+        fs.readdirSync(tempNewDir).forEach((file) => fs.unlinkSync(path.join(tempNewDir, file)));
+        // Fetch and write old content
+        const oldContent = getGitFileContent(c.repoPath, c.oldCommit, c.filePath);
+        if (oldContent) {
+            fs.writeFileSync(path.join(tempOldDir, "lib.rs"), oldContent);
+        }
+        // Fetch and write new content
+        const newContent = getGitFileContent(c.repoPath, c.newCommit, c.filePath);
+        if (newContent) {
+            fs.writeFileSync(path.join(tempNewDir, "lib.rs"), newContent);
+        }
+        // Run parser-v2 comparison
+        const runResult = spawnSync(binary, [tempOldDir, tempNewDir], { encoding: "utf-8" });
+        // Read generated epic-report.json
+        const reportPath = path.resolve(process.cwd(), "epic-report.json");
+        let actualSeverity = "Safe";
+        let riskCategory = "None";
+        let detectedChanges = [];
+        let recommendations = [];
+        if (fs.existsSync(reportPath)) {
+            try {
+                const report = JSON.parse(fs.readFileSync(reportPath, "utf-8"));
+                actualSeverity = report.severity;
+                riskCategory = report.risk_category;
+                detectedChanges = report.impact || [];
+                recommendations = report.recommendations || [];
+            }
+            catch (err) {
+                console.error(`Error parsing epic-report.json for ${c.id}:`, err);
+            }
+        }
+        const isCorrect = actualSeverity === c.expectedSeverity;
+        if (isCorrect) {
+            passedCount++;
+        }
+        else {
+            if (actualSeverity === "Critical" && c.expectedSeverity !== "Critical") {
+                falsePositives++;
+            }
+            else if (actualSeverity !== "Critical" && c.expectedSeverity === "Critical") {
+                falseNegatives++;
+            }
+        }
+        const caseResult = {
+            id: c.id,
+            protocol: c.protocol,
+            upgradeWindow: `${c.oldCommit.substring(0, 7)} -> ${c.newCommit.substring(0, 7)}`,
+            expectedSeverity: c.expectedSeverity,
+            actualSeverity,
+            riskCategory,
+            detectedChanges,
+            recommendations,
+            isCorrect,
+            whyEPICFlaggedIt: riskCategory,
+            confidence: "100% (AST Proof)"
+        };
+        results.push(caseResult);
+        // Save individual benchmark file
+        const benchmarkProtoDir = path.resolve(__dirname, `../../../benchmarks/${c.protocol.toLowerCase()}`);
+        fs.mkdirSync(benchmarkProtoDir, { recursive: true });
+        fs.writeFileSync(path.join(benchmarkProtoDir, `${c.id}.json`), JSON.stringify(caseResult, null, 2));
+        console.log(`  Expected: ${c.expectedSeverity} | Actual: ${actualSeverity} | Correct: ${isCorrect ? "✅" : "❌"}\n`);
+    }
+    // Clean temp directories
+    fs.rmSync(path.resolve(__dirname, "../temp-benchmark"), { recursive: true, force: true });
+    const accuracy = (passedCount / BENCHMARK_SUITE.length) * 100;
+    // Print console summary table
+    console.log("==================================================");
+    console.log("BENCHMARK COMPLETED");
+    console.log(`Total Upgrades Evaluated: ${BENCHMARK_SUITE.length}`);
+    console.log(`Successful Classifications: ${passedCount}`);
+    console.log(`Accuracy Rate: ${accuracy.toFixed(2)}%`);
+    console.log(`False Positives: ${falsePositives}`);
+    console.log(`False Negatives: ${falseNegatives}`);
+    console.log("==================================================");
+    // Generate EPIC_BENCHMARK_REPORT.md
+    let reportMd = `# Solana EPIC: Historical Upgrade Benchmark Report
+
+This public benchmark report validates the reliability and precision of **EPIC (Engineering Platform for Intelligent Contracts)** against 15 real-world historical upgrades from 5 leading Solana DeFi and infrastructure protocols.
+
+---
+
+## 1. Executive Summary
+
+To move beyond theoretical safety profiles, EPIC has been evaluated against real-world smart contract code modifications fetched directly from production Git repositories. The benchmark suite tests structural layout modifications, padding replacements, enum updates, and method refactorings to evaluate upgrade readiness categorization accuracy.
+
+*   **Total Historical Upgrades Evaluated:** ${BENCHMARK_SUITE.length}
+*   **Successful Classifications:** ${passedCount}
+*   **Classification Accuracy:** **${accuracy.toFixed(2)}%**
+*   **False Positives:** ${falsePositives}
+*   **False Negatives:** ${falseNegatives}
+*   **Confidence Level:** **100% (AST Determinism)**
+
+---
+
+## 2. Summary Validation Matrix
+
+| Protocol | Upgrade Case | Expected Severity | Actual Severity | Correct? |
+| :--- | :--- | :--- | :--- | :--- |
+`;
+    for (const r of results) {
+        reportMd += `| **${r.protocol}** | ${BENCHMARK_SUITE.find((c) => c.id === r.id)?.upgradeName} | ${r.expectedSeverity} | ${r.actualSeverity} | ${r.isCorrect ? "✅ Pass" : "❌ Fail"} |\n`;
+    }
+    reportMd += `\n---\n\n## 3. Detailed Upgrade Benchmarks\n\n`;
+    for (const r of results) {
+        reportMd += `### ${r.protocol}: ${BENCHMARK_SUITE.find((c) => c.id === r.id)?.upgradeName}
+*   **Upgrade Window:** \`${r.upgradeWindow}\`
+*   **EPIC Severity:** **${r.actualSeverity}**
+*   **Was the Classification Correct?** ${r.isCorrect ? "Yes" : "No"}
+*   **Why EPIC Flagged It:** ${r.whyEPICFlaggedIt}
+*   **Confidence:** ${r.confidence}
+*   **Detected Changes:**
+${r.detectedChanges.map((d) => `    - ${d}`).join("\n")}
+*   **Recommendations:**
+${r.recommendations.map((rec) => `    - ${rec}`).join("\n")}
+
+\n`;
+    }
+    fs.writeFileSync(path.resolve(__dirname, "../../../EPIC_BENCHMARK_REPORT.md"), reportMd);
+    console.log("Report generated at: EPIC_BENCHMARK_REPORT.md\n");
+}
+runBenchmark();
+//# sourceMappingURL=benchmark.js.map

package/dist/benchmark.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,622 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { compareAnchorPrograms, formatHumanReport } from "@solana-epic/diff-engine";
+import { config } from "@solana-epic/parser";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import fs from "node:fs";
+const program = new Command();
+program
+    .name("epic")
+    .description("EPIC CLI for Solana Upgrade Intelligence (powered by parser-v2 Rust AST engine).")
+    .version("0.4.0");
+import { resolveParserBinary } from "./loader.js";
+function findRustBinary() {
+    try {
+        return resolveParserBinary();
+    }
+    catch (err) {
+        console.error(err.message);
+        process.exit(1);
+    }
+}
+program
+    .command("analyze")
+    .description("Analyze a Solana program workspace and report state account sizes.")
+    .argument("<path>", "Path to an Anchor project, Rust source directory, or Rust file")
+    .action((targetPath) => {
+    try {
+        const binary = findRustBinary();
+        const resolvedPath = path.resolve(targetPath);
+        const result = spawnSync(binary, [resolvedPath], { encoding: "utf-8" });
+        if (result.error) {
+            throw new Error(`Failed to execute parser-v2 binary: ${result.error.message}`);
+        }
+        if (result.status !== 0) {
+            console.error(result.stderr || `Execution failed with status code ${result.status}`);
+            process.exit(result.status ?? 1);
+        }
+        const report = JSON.parse(result.stdout.trim());
+        console.log(`\n🔍 Analyzing Solana Program Workspace: ${targetPath}`);
+        console.log(`Found ${report.structs_found} structs, ${report.enums_found} enums, ${report.aliases_found} aliases.\n`);
+        if (!report.accounts || report.accounts.length === 0) {
+            console.log("No state accounts (#[account] structures) found.");
+            return;
+        }
+        console.log("STATE ACCOUNTS:");
+        for (const account of report.accounts) {
+            const layoutType = account.dynamic ? "Dynamic" : "Static";
+            const prefix = account.dynamic ? "⚠️" : "├──";
+            console.log(`${prefix} ${account.account} (${account.size} bytes) [${account.namespace}] [${layoutType}]`);
+            if (account.dynamic) {
+                console.log(`   └─ Warning: Dynamic size detected. Static layout realloc checks may be inaccurate.`);
+            }
+        }
+        console.log("");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`epic analyze failed: ${message}`);
+        process.exit(1);
+    }
+});
+program
+    .command("check")
+    .description("Compare two Solana program workspace versions and report upgrade readiness.")
+    .option("-c, --config <path>", "Path to epic.toml configuration file")
+    .argument("<old_path>", "Path to the old program version source directory")
+    .argument("<new_path>", "Path to the new program version source directory")
+    .action(async (oldPath, newPath, options) => {
+    try {
+        const resolvedOldPath = path.resolve(oldPath);
+        const resolvedNewPath = path.resolve(newPath);
+        let epicConfig;
+        try {
+            epicConfig = config.loadEpicConfig(options.config);
+        }
+        catch (err) {
+            console.error(`epic.toml validation error: ${err.message}`);
+            process.exit(1);
+        }
+        const report = await compareAnchorPrograms(resolvedOldPath, resolvedNewPath, epicConfig);
+        console.log(formatHumanReport(report));
+        const severityOrder = ["SAFE", "MINOR", "WARNING", "MAJOR", "CRITICAL"];
+        const thresholdIndex = severityOrder.indexOf(epicConfig.failOnSeverity);
+        const reportSeverityIndex = severityOrder.indexOf(report.severity);
+        if (thresholdIndex !== -1 && reportSeverityIndex !== -1 && reportSeverityIndex >= thresholdIndex) {
+            console.error(`❌ EPIC Guard Blocked: Upgrade severity is ${report.severity} (threshold: ${epicConfig.failOnSeverity}).`);
+            process.exit(1);
+        }
+        else {
+            console.log(`✅ EPIC Guard Approved Upgrade.`);
+            process.exit(0);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`epic check failed: ${message}`);
+        process.exit(1);
+    }
+});
+function getSeverityLevel(sev) {
+    const s = sev.toUpperCase();
+    if (s === "WARNING" || s === "WARN" || s === "SAFE" || s === "MINOR")
+        return 0;
+    if (s === "MEDIUM" || s === "MAJOR")
+        return 1;
+    if (s === "HIGH")
+        return 2;
+    if (s === "CRITICAL")
+        return 3;
+    return 3;
+}
+function generateSarif(findings) {
+    const rulesMap = new Map();
+    rulesMap.set("EPIC-SEC-001", {
+        id: "EPIC-SEC-001",
+        shortDescription: {
+            text: "Owner Validation"
+        },
+        fullDescription: {
+            text: "Unchecked mutable account write without dominating owner validation."
+        },
+        helpUri: "https://github.com/akxh5/Solana-EPIC/blob/main/docs/rules/EPIC-SEC-001.md",
+        properties: {
+            category: "Security",
+            precision: "high"
+        }
+    });
+    rulesMap.set("EPIC-SEC-002", {
+        id: "EPIC-SEC-002",
+        shortDescription: {
+            text: "Missing Signer Validation"
+        },
+        fullDescription: {
+            text: "Unchecked mutable write or administrative mutation without dominating signer validation."
+        },
+        helpUri: "https://github.com/akxh5/Solana-EPIC/blob/main/docs/rules/EPIC-SEC-002.md",
+        properties: {
+            category: "Security",
+            precision: "high"
+        }
+    });
+    rulesMap.set("EPIC-SEC-003", {
+        id: "EPIC-SEC-003",
+        shortDescription: {
+            text: "Missing Post-CPI Account Reload"
+        },
+        fullDescription: {
+            text: "Account state accessed after a CPI mutation without reload, which may read or write stale cache state."
+        },
+        helpUri: "https://github.com/akxh5/Solana-EPIC/blob/main/docs/rules/EPIC-SEC-003.md",
+        properties: {
+            category: "Security",
+            precision: "high"
+        }
+    });
+    rulesMap.set("EPIC-SEC-004", {
+        id: "EPIC-SEC-004",
+        shortDescription: {
+            text: "PDA Cryptographic Seed Collision Risk"
+        },
+        fullDescription: {
+            text: "Adjacent variable-length seeds without separation delimiters create boundary ambiguities that permit PDA hijacking."
+        },
+        helpUri: "https://github.com/akxh5/Solana-EPIC/blob/main/docs/rules/EPIC-SEC-004.md",
+        properties: {
+            category: "Security",
+            precision: "high"
+        }
+    });
+    rulesMap.set("EPIC-SEC-005", {
+        id: "EPIC-SEC-005",
+        shortDescription: {
+            text: "Arbitrary CPI Target Program Spoofing"
+        },
+        fullDescription: {
+            text: "Invoking CPI on an external program without verifying that the target program matches a trusted program ID."
+        },
+        helpUri: "https://github.com/akxh5/Solana-EPIC/blob/main/docs/rules/EPIC-SEC-005.md",
+        properties: {
+            category: "Security",
+            precision: "high"
+        }
+    });
+    const results = findings.map((f) => {
+        let level = "warning";
+        const sev = f.severity.toLowerCase();
+        if (sev === "critical" || sev === "high") {
+            level = "error";
+        }
+        else if (sev === "medium") {
+            level = "warning";
+        }
+        else if (sev === "warning" || sev === "low") {
+            level = "note";
+        }
+        const relFile = path.relative(process.cwd(), f.location.file);
+        return {
+            ruleId: f.rule_id,
+            ruleIndex: 0,
+            level,
+            message: {
+                text: f.message
+            },
+            locations: [
+                {
+                    physicalLocation: {
+                        artifactLocation: {
+                            uri: relFile,
+                            uriBaseId: "%SRCROOT%"
+                        },
+                        region: {
+                            startLine: f.location.line,
+                            startColumn: f.location.column || 1
+                        }
+                    }
+                }
+            ]
+        };
+    });
+    const rules = Array.from(rulesMap.values());
+    for (const f of findings) {
+        if (!rulesMap.has(f.rule_id)) {
+            const genericRule = {
+                id: f.rule_id,
+                shortDescription: {
+                    text: f.rule_id
+                },
+                fullDescription: {
+                    text: f.message
+                }
+            };
+            rulesMap.set(f.rule_id, genericRule);
+            rules.push(genericRule);
+        }
+    }
+    return {
+        $schema: "https://schemastore.azurewebsites.net/schemas/json/sarif-2.1.0-rtm.5.json",
+        version: "2.1.0",
+        runs: [
+            {
+                tool: {
+                    driver: {
+                        name: "EPIC",
+                        informationUri: "https://github.com/akxh5/Solana-EPIC",
+                        version: "0.4.0",
+                        rules
+                    }
+                },
+                results
+            }
+        ]
+    };
+}
+program
+    .command("audit")
+    .description("Run security rules against the repository.")
+    .argument("[path]", "Path to search and audit", ".")
+    .option("-f, --format <format>", "Output format: text, json, sarif", "text")
+    .option("-s, --strict", "Exit code 1 if findings severity >= threshold", false)
+    .option("-c, --config <path>", "Path to epic.toml configuration file")
+    .option("--ignore <rules>", "Rule IDs to ignore (comma-separated)", (val) => val.split(",").map(r => r.trim()))
+    .action(async (targetPath, options) => {
+    try {
+        const binary = findRustBinary();
+        const resolvedPath = path.resolve(targetPath);
+        const result = spawnSync(binary, ["audit", resolvedPath], { encoding: "utf-8" });
+        if (result.error) {
+            throw new Error(`Failed to execute parser-v2 binary: ${result.error.message}`);
+        }
+        if (result.status !== 0) {
+            console.error(result.stderr || `Execution failed with status code ${result.status}`);
+            process.exit(result.status ?? 1);
+        }
+        const findings = JSON.parse(result.stdout.trim());
+        let epicConfig;
+        try {
+            epicConfig = config.loadEpicConfig(options.config);
+        }
+        catch (err) {
+            epicConfig = config.getDefaultConfig();
+        }
+        const ignoredRules = new Set();
+        if (epicConfig.ignore) {
+            for (const r of epicConfig.ignore) {
+                ignoredRules.add(r.trim());
+            }
+        }
+        if (options.ignore) {
+            const cliIgnores = Array.isArray(options.ignore) ? options.ignore : [options.ignore];
+            for (const r of cliIgnores) {
+                ignoredRules.add(r.trim());
+            }
+        }
+        const activeFindings = findings.filter((f) => !ignoredRules.has(f.rule_id));
+        if (options.format === "text") {
+            if (activeFindings.length === 0) {
+                console.log("No security findings found.");
+            }
+            else {
+                for (const finding of activeFindings) {
+                    const sevUpper = finding.severity.toUpperCase();
+                    const relPath = path.relative(process.cwd(), finding.location.file);
+                    console.log(`${sevUpper} ${finding.rule_id}`);
+                    console.log(`${relPath}:${finding.location.line}:${finding.location.column}`);
+                    console.log(`${finding.message}\n`);
+                }
+            }
+        }
+        else if (options.format === "json") {
+            console.log(JSON.stringify(activeFindings, null, 2));
+        }
+        else if (options.format === "sarif") {
+            const sarif = generateSarif(activeFindings);
+            const sarifString = JSON.stringify(sarif, null, 2);
+            fs.writeFileSync("sarif.json", sarifString, "utf8");
+            console.log(sarifString);
+        }
+        if (options.strict) {
+            const threshold = epicConfig.failOnSeverity || "CRITICAL";
+            const thresholdVal = getSeverityLevel(threshold);
+            let hasFailingFinding = false;
+            for (const finding of activeFindings) {
+                const sevVal = getSeverityLevel(finding.severity);
+                if (sevVal >= thresholdVal) {
+                    hasFailingFinding = true;
+                    break;
+                }
+            }
+            if (hasFailingFinding) {
+                process.exit(1);
+            }
+            else {
+                process.exit(0);
+            }
+        }
+        else {
+            process.exit(0);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`epic audit failed: ${message}`);
+        process.exit(1);
+    }
+});
+program
+    .command("rules")
+    .description("List all available security rules.")
+    .action(() => {
+    console.log("EPIC-SEC-001");
+    console.log("Owner Validation");
+    console.log("Critical");
+    console.log("Implemented\n");
+    console.log("EPIC-SEC-002");
+    console.log("Missing Signer Validation");
+    console.log("Critical");
+    console.log("Implemented\n");
+    console.log("EPIC-SEC-003");
+    console.log("Missing Post-CPI Account Reload");
+    console.log("Critical");
+    console.log("Implemented\n");
+    console.log("EPIC-SEC-004");
+    console.log("PDA Cryptographic Seed Collision Risk");
+    console.log("High");
+    console.log("Implemented\n");
+    console.log("EPIC-SEC-005");
+    console.log("Arbitrary CPI Target Program Spoofing");
+    console.log("Critical");
+    console.log("Implemented");
+});
+program
+    .command("explain")
+    .description("Explain a security rule in detail.")
+    .argument("<rule_id>", "Rule ID to explain")
+    .action(async (ruleId) => {
+    const normRuleId = ruleId.trim().toUpperCase();
+    if (normRuleId === "EPIC-SEC-001") {
+        let content = "";
+        try {
+            const docPaths = [
+                path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../docs/rules/EPIC-SEC-001.md"),
+                path.resolve(process.cwd(), "docs/rules/EPIC-SEC-001.md")
+            ];
+            for (const p of docPaths) {
+                if (fs.existsSync(p)) {
+                    content = fs.readFileSync(p, "utf8");
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            // ignore error
+        }
+        if (content) {
+            console.log(content);
+        }
+        else {
+            console.log(`# EPIC-SEC-001: Owner Validation
+
+## Description
+Tracks mutable account write operations to ensure they are protected by an ownership check (\`account.owner == program_id\`) that dominates the write path.
+
+## Threat Model
+In Solana, any account can be passed to an instruction. If a program writes data to a mutable account without verifying that the account is owned by the program itself, an attacker can pass a forged account with malicious data.
+
+## Vulnerable Example
+\`\`\`rust
+pub fn withdraw(ctx: Context<Withdraw>, amount: u64) -> Result<()> {
+    let vault = &mut ctx.accounts.vault;
+    let mut vault_data = vault.try_borrow_mut_data()?;
+    vault_data[0] = 9;
+    Ok(())
+}
+\`\`\`
+
+## Safe Example
+\`\`\`rust
+#[derive(Accounts)]
+pub struct Withdraw<'info> {
+    #[account(mut)]
+    pub vault: Account<'info, VaultState>,
+}
+\`\`\`
+
+## Historical Exploit References
+* Cashio App ($52M, March 2022)`);
+        }
+    }
+    else if (normRuleId === "EPIC-SEC-002") {
+        let content = "";
+        try {
+            const docPaths = [
+                path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../docs/rules/EPIC-SEC-002.md"),
+                path.resolve(process.cwd(), "docs/rules/EPIC-SEC-002.md")
+            ];
+            for (const p of docPaths) {
+                if (fs.existsSync(p)) {
+                    content = fs.readFileSync(p, "utf8");
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            // ignore error
+        }
+        if (content) {
+            console.log(content);
+        }
+        else {
+            console.log(`# EPIC-SEC-002: Missing Signer Validation
+
+## Description
+Detects situations where authority-like accounts are capable of mutating state, authorizing actions, or executing privileged flows without proving signer authority.
+
+## Threat Model
+In Solana, callers supply all account inputs. Because any caller can pass arbitrary public keys, the program must verify that the authority-like account signed the transaction. Failing to perform this signer validation allows an attacker to spoof the authority account.
+
+## Vulnerable Example
+\`\`\`rust
+pub fn update_config(ctx: Context<UpdateConfig>, new_val: u64) -> Result<()> {
+    ctx.accounts.config.admin_value = new_val;
+    Ok(())
+}
+// with authority declared as AccountInfo without Signer constraint
+\`\`\`
+
+## Safe Example
+\`\`\`rust
+pub fn update_config(ctx: Context<UpdateConfig>, new_val: u64) -> Result<()> {
+    require!(ctx.accounts.authority.is_signer, ErrorCode::MissingSignature);
+    ctx.accounts.config.admin_value = new_val;
+    Ok(())
+}
+\`\`\``);
+        }
+    }
+    else if (normRuleId === "EPIC-SEC-003") {
+        let content = "";
+        try {
+            const docPaths = [
+                path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../docs/rules/EPIC-SEC-003.md"),
+                path.resolve(process.cwd(), "docs/rules/EPIC-SEC-003.md")
+            ];
+            for (const p of docPaths) {
+                if (fs.existsSync(p)) {
+                    content = fs.readFileSync(p, "utf8");
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            // ignore error
+        }
+        if (content) {
+            console.log(content);
+        }
+        else {
+            console.log(`# EPIC-SEC-003: Missing Post-CPI Account Reload
+
+## Description
+Detects scenarios where an account's state data is read or written after a Cross-Program Invocation (CPI) that potentially mutates on-chain state, without executing an intervening reload.
+
+## Threat Model
+In Solana, external programs (like token program or pools) mutate accounts during CPI calls. The local execution context maintains a deserialized in-memory cache of accounts. Calling programs must refresh this cache via \`reload()\` before accessing fields again.
+
+## Vulnerable Example
+\`\`\`rust
+token::transfer(cpi_ctx, amount)?;
+ctx.accounts.vault.amount -= amount; // Stale layout read and write!
+\`\`\`
+
+## Safe Example
+\`\`\`rust
+token::transfer(cpi_ctx, amount)?;
+ctx.accounts.vault.reload()?; // Safe: reload matches state
+ctx.accounts.vault.amount -= amount;
+\`\`\``);
+        }
+    }
+    else if (normRuleId === "EPIC-SEC-004") {
+        let content = "";
+        try {
+            const docPaths = [
+                path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../docs/rules/EPIC-SEC-004.md"),
+                path.resolve(process.cwd(), "docs/rules/EPIC-SEC-004.md")
+            ];
+            for (const p of docPaths) {
+                if (fs.existsSync(p)) {
+                    content = fs.readFileSync(p, "utf8");
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            // ignore error
+        }
+        if (content) {
+            console.log(content);
+        }
+        else {
+            console.log(`# EPIC-SEC-004: PDA Cryptographic Seed Collision Risk
+
+## Description
+Detects scenarios where adjacent variable-length seeds in Program Derived Address (PDA) derivation can merge boundaries, allowing an attacker to generate the same address from two different inputs.
+
+## Threat Model
+In Solana, PDAs are derived by concatenating the raw seed bytes without adding delimiters. When two variable-length seeds (like strings or dynamic byte arrays) are placed next to each other, boundary bytes can shift between seeds while keeping the concatenated byte stream identical.
+
+## Vulnerable Example
+\`\`\`rust
+Pubkey::find_program_address(
+    &[
+        user_name.as_bytes(),
+        folder_name.as_bytes(),
+    ],
+    program_id,
+);
+\`\`\`
+
+## Safe Example
+\`\`\`rust
+Pubkey::find_program_address(
+    &[
+        user_name.as_bytes(),
+        b"|",
+        folder_name.as_bytes(),
+    ],
+    program_id,
+);
+\`\`\``);
+        }
+    }
+    else if (normRuleId === "EPIC-SEC-005") {
+        let content = "";
+        try {
+            const docPaths = [
+                path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../docs/rules/EPIC-SEC-005.md"),
+                path.resolve(process.cwd(), "docs/rules/EPIC-SEC-005.md")
+            ];
+            for (const p of docPaths) {
+                if (fs.existsSync(p)) {
+                    content = fs.readFileSync(p, "utf8");
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            // ignore error
+        }
+        if (content) {
+            console.log(content);
+        }
+        else {
+            console.log(`# EPIC-SEC-005: Arbitrary CPI Target Program Spoofing
+
+## Description
+Detects scenarios where a program invokes another program via CPI without verifying that the target program matches a trusted program ID.
+
+## Threat Model
+In Solana, callers supply all input accounts, including the program being invoked. If the program fails to verify that the target program account is trusted, an attacker can pass a custom malicious program and hijack control flow under the PDA authority of the program.
+
+## Vulnerable Example
+\`\`\`rust
+invoke(&ix, &[source, dest, token_program])?; // token_program is not validated!
+\`\`\`
+
+## Safe Example
+\`\`\`rust
+require_keys_eq!(token_program.key(), token::ID);
+invoke(&ix, &[source, dest, token_program])?;
+\`\`\``);
+        }
+    }
+    else {
+        console.log(`Rule ${ruleId} not found.`);
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,12 @@
+export declare class EPICBinaryNotFoundError extends Error {
+    constructor(platform: string, arch: string, attemptedLocations: string[]);
+}
+/**
+ * Returns the detected platform key (e.g. "darwin-arm64").
+ */
+export declare function getPlatformKey(platform?: NodeJS.Platform, arch?: NodeJS.Architecture): string;
+/**
+ * Resolves the absolute path to the parser-v2 Rust compiled binary.
+ */
+export declare function resolveParserBinary(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, arch?: NodeJS.Architecture, importMetaUrl?: string): string;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAYA,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE;CAWzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,kBAAmB,EAAE,IAAI,sBAAe,GAAG,MAAM,CAEvF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,oBAAc,EACjB,QAAQ,kBAAmB,EAC3B,IAAI,sBAAe,EACnB,aAAa,SAAkB,GAC9B,MAAM,CA0ER"}

package/dist/loader.js

@@ -0,0 +1,107 @@
+import path from "node:path";
+import fs from "node:fs";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+const PLATFORM_MAP = {
+    "darwin-arm64": "@solana-epic/cli-darwin-arm64",
+    "darwin-x64": "@solana-epic/cli-darwin-x64",
+    "linux-x64": "@solana-epic/cli-linux-x64",
+    "win32-x64": "@solana-epic/cli-win32-x64"
+};
+export class EPICBinaryNotFoundError extends Error {
+    constructor(platform, arch, attemptedLocations) {
+        const message = [
+            `EPIC Upgrade Guard parser-v2 binary not found.`,
+            `Current Platform: ${platform}`,
+            `Current Architecture: ${arch}`,
+            `Attempted Locations:`,
+            ...attemptedLocations.map(loc => `  - ${loc}`)
+        ].join("\n");
+        super(message);
+        this.name = "EPICBinaryNotFoundError";
+    }
+}
+/**
+ * Returns the detected platform key (e.g. "darwin-arm64").
+ */
+export function getPlatformKey(platform = process.platform, arch = process.arch) {
+    return `${platform}-${arch}`;
+}
+/**
+ * Resolves the absolute path to the parser-v2 Rust compiled binary.
+ */
+export function resolveParserBinary(env = process.env, platform = process.platform, arch = process.arch, importMetaUrl = import.meta.url) {
+    const platformKey = getPlatformKey(platform, arch);
+    const packageName = PLATFORM_MAP[platformKey];
+    const binName = platform === "win32" ? "parser-v2.exe" : "parser-v2";
+    const attempted = [];
+    // 1. Attempt package resolve from dependencies/optionalDependencies
+    if (packageName) {
+        try {
+            const resolvedUrl = import.meta.resolve(packageName);
+            const resolvedPath = fileURLToPath(resolvedUrl);
+            attempted.push(`NPM Package (${packageName}) -> ${resolvedPath}`);
+            if (fs.existsSync(resolvedPath)) {
+                return resolvedPath;
+            }
+        }
+        catch {
+            attempted.push(`NPM Package (${packageName}) -> Not installed / Resolution failed`);
+            // Local development fallback for packages when not installed/linked in monorepo
+            try {
+                const __dirname = path.dirname(fileURLToPath(importMetaUrl));
+                const localPackagePath = path.resolve(__dirname, "../..", packageName.split("/")[1], "bin", binName);
+                attempted.push(`Local Monorepo Package Fallback (${packageName}) -> ${localPackagePath}`);
+                if (fs.existsSync(localPackagePath)) {
+                    return localPackagePath;
+                }
+            }
+            catch { }
+        }
+    }
+    else {
+        attempted.push(`NPM Package -> Unsupported platform key: ${platformKey}`);
+    }
+    // 2. Attempt local development compilation fallback
+    try {
+        const __dirname = path.dirname(fileURLToPath(importMetaUrl));
+        const localPaths = [
+            path.resolve(__dirname, "../../parser-v2/target/release", binName),
+            path.resolve(__dirname, "../../parser-v2/target/debug", binName),
+            path.resolve(__dirname, "../../../parser-v2/target/release", binName),
+            path.resolve(__dirname, "../../../parser-v2/target/debug", binName)
+        ];
+        for (const localPath of localPaths) {
+            attempted.push(`Local Dev Target -> ${localPath}`);
+            if (fs.existsSync(localPath)) {
+                return localPath;
+            }
+        }
+    }
+    catch {
+        attempted.push(`Local Dev Target -> Directory lookup context failed`);
+    }
+    // 3. Attempt PATH environment traversal lookup
+    const pathEnv = env.PATH || "";
+    const pathDirs = pathEnv.split(path.delimiter);
+    attempted.push(`PATH Lookup -> Scanning ${pathDirs.length} path directories`);
+    for (const dir of pathDirs) {
+        if (!dir)
+            continue;
+        const candidatePath = path.join(dir, binName);
+        if (fs.existsSync(candidatePath)) {
+            try {
+                // Simple Windows sanity check (Windows has no X_OK, check exists is sufficient)
+                if (platform !== "win32") {
+                    fs.accessSync(candidatePath, fs.constants.X_OK);
+                }
+                return candidatePath;
+            }
+            catch {
+                // Exists but not executable
+            }
+        }
+    }
+    throw new EPICBinaryNotFoundError(platform, arch, attempted);
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@solana-epic/cli",
+  "version": "0.1.0-beta.1",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "epic": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsx src/index.ts",
+    "test": "node --test test/*.test.mjs"
+  },
+  "dependencies": {
+    "@solana-epic/diff-engine": "^0.1.0-beta.1",
+    "@solana-epic/parser": "^0.1.0-beta.1",
+    "commander": "^14.0.0"
+  },
+  "optionalDependencies": {
+    "@solana-epic/cli-darwin-arm64": "^0.1.0-beta.1",
+    "@solana-epic/cli-darwin-x64": "^0.1.0-beta.1",
+    "@solana-epic/cli-linux-x64": "^0.1.0-beta.1",
+    "@solana-epic/cli-win32-x64": "^0.1.0-beta.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.29",
+    "tsx": "^4.19.4"
+  }
+}