hex-audit 0.4.0

package/dist/commands/update.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { ConfigSchema } from './schema.js';
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Load and validate config from an output directory.
+ * Searches for config.json in the specified or default output dir.
+ */
+export declare function loadConfig(projectDir?: string): Config;
+export interface CreateConfigOptions {
+    name: string;
+    projectDir: string;
+    commit: string;
+    chain?: string;
+    solidityVersion: string;
+    docsUrl?: string;
+    scope: string[];
+    exclude?: string[];
+    outputDir?: string;
+}
+/**
+ * Create a new config.json in the output directory.
+ */
+export declare function createConfig(options: CreateConfigOptions): Config;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBtD;AAuBD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAwBjE"}

package/dist/core/config.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { ConfigSchema } from './schema.js';
+import { normalizePath, getOutputDir } from './paths.js';
+import { readJsonFile, writeJsonOutput } from './output.js';
+/**
+ * Load and validate config from an output directory.
+ * Searches for config.json in the specified or default output dir.
+ */
+export function loadConfig(projectDir) {
+    const dir = projectDir ?? process.cwd();
+    const configPath = findConfigFile(dir);
+    if (!configPath) {
+        throw new Error(`No config.json found. Run 'hex init' first.\nSearched in: ${dir}`);
+    }
+    const raw = readJsonFile(configPath);
+    if (!raw) {
+        throw new Error(`Failed to read config file: ${configPath}`);
+    }
+    const result = ConfigSchema.safeParse(raw);
+    if (!result.success) {
+        throw new Error(`Invalid config.json:\n${result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\n')}`);
+    }
+    return result.data;
+}
+/**
+ * Search for config.json in common output directory locations.
+ */
+function findConfigFile(projectDir) {
+    const candidates = [
+        path.join(projectDir, '.hex', 'config.json'),
+        path.join(projectDir, '.solaudit', 'config.json'),
+        path.join(projectDir, 'solaudit-output', 'config.json'),
+    ];
+    // Also check if projectDir itself is an output dir
+    candidates.push(path.join(projectDir, 'config.json'));
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return normalizePath(candidate);
+        }
+    }
+    return null;
+}
+/**
+ * Create a new config.json in the output directory.
+ */
+export function createConfig(options) {
+    const config = {
+        version: '1.0',
+        project: {
+            name: options.name,
+            project_dir: normalizePath(options.projectDir),
+            commit: options.commit,
+            chain: options.chain ?? 'ethereum',
+            solidity_version: options.solidityVersion,
+            docs_url: options.docsUrl,
+            scope: options.scope.map(normalizePath),
+            exclude: (options.exclude ?? []).map(normalizePath),
+        },
+        settings: {
+            output_dir: options.outputDir ?? '.hex',
+            ai_model: 'claude-sonnet-4-20250514',
+            finding_template: 'default',
+        },
+    };
+    const outputDir = getOutputDir(options.projectDir, config.settings.output_dir);
+    writeJsonOutput(outputDir, 'config.json', config);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,17 @@
+export interface ErrorHint {
+    cause: string;
+    fix: string;
+    docs?: string;
+}
+export type ErrorCode = 'tool.slither.missing' | 'tool.slither.failed' | 'tool.forge.missing' | 'tool.forge.failed' | 'tool.solc.missing' | 'tool.claude.missing' | 'tool.node.outdated' | 'project.scope.empty' | 'project.scope.unmatched' | 'project.scope.missing-file' | 'project.missing-config' | 'project.foundry-missing' | 'output.dir.unwritable' | 'output.file.unparseable' | 'ai-tool.missing-scan-id' | 'ai-tool.scan-failed' | 'analysis.no-data';
+export declare const ERROR_HINTS: Record<ErrorCode, ErrorHint>;
+export declare class HexError extends Error {
+    code: ErrorCode;
+    hint: ErrorHint;
+    detail?: string;
+    constructor(code: ErrorCode, detail?: string);
+}
+export declare function isHexError(err: unknown): err is HexError;
+export declare function formatHexError(err: HexError): string;
+export declare function reportError(err: unknown): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,SAAS,GACjB,sBAAsB,GACtB,qBAAqB,GACrB,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,GACpB,qBAAqB,GACrB,yBAAyB,GACzB,4BAA4B,GAC5B,wBAAwB,GACxB,yBAAyB,GACzB,uBAAuB,GACvB,yBAAyB,GACzB,yBAAyB,GACzB,qBAAqB,GACrB,kBAAkB,CAAC;AAEvB,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CA0EpD,CAAC;AAEF,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEJ,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM;CAO7C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAExD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAYpD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAO9C"}

package/dist/core/errors.js

@@ -0,0 +1,113 @@
+import chalk from 'chalk';
+export const ERROR_HINTS = {
+    'tool.slither.missing': {
+        cause: "Slither isn't installed or isn't on PATH.",
+        fix: 'Install with: pip install slither-analyzer',
+        docs: 'https://github.com/crytic/slither#how-to-install',
+    },
+    'tool.slither.failed': {
+        cause: 'Slither ran but exited with a non-zero code.',
+        fix: 'Re-run `slither <project>` manually to see the underlying compilation error.',
+        docs: 'https://github.com/crytic/slither/wiki/Usage',
+    },
+    'tool.forge.missing': {
+        cause: 'Foundry (forge/cast) is not installed or not on PATH.',
+        fix: 'Install with: curl -L https://foundry.paradigm.xyz | bash && foundryup',
+        docs: 'https://book.getfoundry.sh/getting-started/installation',
+    },
+    'tool.forge.failed': {
+        cause: 'forge build failed before analysis could finish.',
+        fix: 'Run `forge build` directly and fix the compilation errors first.',
+    },
+    'tool.solc.missing': {
+        cause: 'solc was not found on PATH.',
+        fix: 'Install with `solc-select install <version> && solc-select use <version>`, or rely on Foundry.',
+        docs: 'https://github.com/crytic/solc-select#quickstart',
+    },
+    'tool.claude.missing': {
+        cause: 'Claude Code CLI is not installed (hex skills run via Claude Code).',
+        fix: 'Install Claude Code, then re-run `hex claude` to copy skills into the project.',
+        docs: 'https://docs.claude.com/claude-code',
+    },
+    'tool.node.outdated': {
+        cause: 'Your Node.js version is older than Hex requires.',
+        fix: 'Upgrade to Node.js 18 or later (https://nodejs.org).',
+    },
+    'project.scope.empty': {
+        cause: '--scope was not provided.',
+        fix: 'Pass --scope with comma-separated globs, e.g. --scope "src/**/*.sol".',
+    },
+    'project.scope.unmatched': {
+        cause: 'No files matched any of the scope globs.',
+        fix: 'Check the glob syntax. Examples: "src/**/*.sol", "src/Vault.sol,src/lib/Math.sol". Globs are POSIX-style.',
+    },
+    'project.scope.missing-file': {
+        cause: 'A scope entry expanded to a path that does not exist on disk.',
+        fix: 'Either remove the entry or correct the path. Globs are resolved relative to --project (defaults to cwd).',
+    },
+    'project.missing-config': {
+        cause: 'No .hex/config.json was found in the project directory.',
+        fix: 'Run `hex init --scope "<globs>" --commit <hash>` first.',
+    },
+    'project.foundry-missing': {
+        cause: 'foundry.toml is missing — Hex can analyse Hardhat too but coverage/build verification rely on Foundry.',
+        fix: 'Add a foundry.toml or run with --no-verify to skip the build check.',
+    },
+    'output.dir.unwritable': {
+        cause: 'Hex cannot write to the output directory.',
+        fix: 'Check filesystem permissions or pass --output-dir to a writable location.',
+    },
+    'output.file.unparseable': {
+        cause: 'A .hex/*.json file exists but is malformed.',
+        fix: 'Re-run the producing command (e.g. `hex stats`) to regenerate it, or delete the file.',
+    },
+    'ai-tool.missing-scan-id': {
+        cause: 'auditagent expects a scan_id in ai-status.json but none was found.',
+        fix: 'Re-run `/run-ai-analysis` so the orchestrator kicks off a new scan.',
+    },
+    'ai-tool.scan-failed': {
+        cause: 'The remote AI scan reported failure.',
+        fix: 'Check the tool dashboard or logs, then re-trigger `/run-ai-analysis`.',
+    },
+    'analysis.no-data': {
+        cause: 'An analysis command was invoked but a required upstream output is missing.',
+        fix: 'Run `hex analyze` first, or generate the missing file explicitly (e.g. `hex stats`).',
+    },
+};
+export class HexError extends Error {
+    code;
+    hint;
+    detail;
+    constructor(code, detail) {
+        const hint = ERROR_HINTS[code];
+        super(detail ? `${hint.cause} ${detail}` : hint.cause);
+        this.code = code;
+        this.hint = hint;
+        this.detail = detail;
+    }
+}
+export function isHexError(err) {
+    return err instanceof HexError;
+}
+export function formatHexError(err) {
+    const lines = [
+        `${chalk.red('✖')} ${chalk.bold(err.hint.cause)}`,
+    ];
+    if (err.detail) {
+        lines.push(`  ${chalk.dim(err.detail)}`);
+    }
+    lines.push(`  ${chalk.cyan('→')} ${err.hint.fix}`);
+    if (err.hint.docs) {
+        lines.push(`  ${chalk.dim('docs:')} ${chalk.dim(err.hint.docs)}`);
+    }
+    return lines.join('\n');
+}
+export function reportError(err) {
+    if (isHexError(err)) {
+        process.stderr.write(formatHexError(err) + '\n');
+        return;
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`${chalk.red('✖')} ${message}\n`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AA2B1B,MAAM,CAAC,MAAM,WAAW,GAAiC;IACvD,sBAAsB,EAAE;QACtB,KAAK,EAAE,2CAA2C;QAClD,GAAG,EAAE,4CAA4C;QACjD,IAAI,EAAE,kDAAkD;KACzD;IACD,qBAAqB,EAAE;QACrB,KAAK,EAAE,8CAA8C;QACrD,GAAG,EAAE,8EAA8E;QACnF,IAAI,EAAE,8CAA8C;KACrD;IACD,oBAAoB,EAAE;QACpB,KAAK,EAAE,uDAAuD;QAC9D,GAAG,EAAE,wEAAwE;QAC7E,IAAI,EAAE,yDAAyD;KAChE;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE,kDAAkD;QACzD,GAAG,EAAE,kEAAkE;KACxE;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE,6BAA6B;QACpC,GAAG,EAAE,gGAAgG;QACrG,IAAI,EAAE,kDAAkD;KACzD;IACD,qBAAqB,EAAE;QACrB,KAAK,EAAE,oEAAoE;QAC3E,GAAG,EAAE,gFAAgF;QACrF,IAAI,EAAE,qCAAqC;KAC5C;IACD,oBAAoB,EAAE;QACpB,KAAK,EAAE,kDAAkD;QACzD,GAAG,EAAE,sDAAsD;KAC5D;IACD,qBAAqB,EAAE;QACrB,KAAK,EAAE,2BAA2B;QAClC,GAAG,EAAE,uEAAuE;KAC7E;IACD,yBAAyB,EAAE;QACzB,KAAK,EAAE,0CAA0C;QACjD,GAAG,EAAE,2GAA2G;KACjH;IACD,4BAA4B,EAAE;QAC5B,KAAK,EAAE,+DAA+D;QACtE,GAAG,EAAE,0GAA0G;KAChH;IACD,wBAAwB,EAAE;QACxB,KAAK,EAAE,yDAAyD;QAChE,GAAG,EAAE,yDAAyD;KAC/D;IACD,yBAAyB,EAAE;QACzB,KAAK,EAAE,wGAAwG;QAC/G,GAAG,EAAE,qEAAqE;KAC3E;IACD,uBAAuB,EAAE;QACvB,KAAK,EAAE,2CAA2C;QAClD,GAAG,EAAE,2EAA2E;KACjF;IACD,yBAAyB,EAAE;QACzB,KAAK,EAAE,6CAA6C;QACpD,GAAG,EAAE,uFAAuF;KAC7F;IACD,yBAAyB,EAAE;QACzB,KAAK,EAAE,oEAAoE;QAC3E,GAAG,EAAE,qEAAqE;KAC3E;IACD,qBAAqB,EAAE;QACrB,KAAK,EAAE,sCAAsC;QAC7C,GAAG,EAAE,uEAAuE;KAC7E;IACD,kBAAkB,EAAE;QAClB,KAAK,EAAE,4EAA4E;QACnF,GAAG,EAAE,sFAAsF;KAC5F;CACF,CAAC;AAEF,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,IAAI,CAAY;IAChB,IAAI,CAAY;IAChB,MAAM,CAAU;IAEhB,YAAY,IAAe,EAAE,MAAe;QAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,GAAG,YAAY,QAAQ,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAa;IAC1C,MAAM,KAAK,GAAG;QACZ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;KAClD,CAAC;IACF,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;AACzD,CAAC"}

package/dist/core/external-tools.d.ts

@@ -0,0 +1,39 @@
+export interface ToolInfo {
+    name: string;
+    available: boolean;
+    version: string | null;
+}
+interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Detect all supported external tools.
+ */
+export declare function detectTools(): Promise<ToolInfo[]>;
+/**
+ * Require a tool to be available, throwing if not found.
+ */
+export declare function requireTool(name: string): Promise<void>;
+/**
+ * Run Slither with JSON output.
+ */
+export declare function runSlither(dir: string, args: string[]): Promise<ExecResult>;
+/**
+ * Get Slither function-summary output with file-based caching.
+ * access.ts and state.ts both run the identical `slither . --print function-summary --json -`
+ * command. This cache ensures it only runs once per analysis session.
+ */
+export declare function getSlitherFunctionSummary(projectDir: string, outputDir: string): Promise<ExecResult>;
+/**
+ * Run Forge (Foundry).
+ */
+export declare function runForge(dir: string, args: string[]): Promise<ExecResult>;
+export declare function flattenFile(projectDir: string, filePath: string): Promise<string | null>;
+/**
+ * Run solc.
+ */
+export declare function runSolc(dir: string, args: string[]): Promise<ExecResult>;
+export {};
+//# sourceMappingURL=external-tools.d.ts.map

package/dist/core/external-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-tools.d.ts","sourceRoot":"","sources":["../../src/core/external-tools.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAOvD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CA6BrB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,UAAU,CAAC,CAGrB;AASD,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiB9F;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,UAAU,CAAC,CAGrB"}

package/dist/core/external-tools.js

@@ -0,0 +1,151 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { logger } from './logger.js';
+/**
+ * Run a command and capture output.
+ */
+function exec(command, args, options = {}) {
+    return new Promise((resolve) => {
+        const env = {
+            ...process.env,
+            PYTHONIOENCODING: 'utf-8',
+            ...options.env,
+        };
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env,
+            shell: true,
+            timeout: options.timeout ?? 120_000,
+        });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on('data', (data) => stdout.push(data));
+        child.stderr.on('data', (data) => stderr.push(data));
+        child.on('close', (code) => {
+            resolve({
+                stdout: Buffer.concat(stdout).toString('utf-8'),
+                stderr: Buffer.concat(stderr).toString('utf-8'),
+                exitCode: code ?? 1,
+            });
+        });
+        child.on('error', () => {
+            resolve({
+                stdout: '',
+                stderr: `Failed to start: ${command}`,
+                exitCode: 1,
+            });
+        });
+    });
+}
+/**
+ * Check if a tool is available by running its version command.
+ */
+async function checkTool(name, command, args) {
+    const result = await exec(command, args);
+    if (result.exitCode === 0) {
+        const version = result.stdout.trim().split('\n')[0] ?? null;
+        return { name, available: true, version };
+    }
+    return { name, available: false, version: null };
+}
+/**
+ * Detect all supported external tools.
+ */
+export async function detectTools() {
+    const checks = await Promise.all([
+        checkTool('solc', 'solc', ['--version']),
+        checkTool('slither', 'slither', ['--version']),
+        checkTool('forge', 'forge', ['--version']),
+    ]);
+    return checks;
+}
+/**
+ * Require a tool to be available, throwing if not found.
+ */
+export async function requireTool(name) {
+    const tools = await detectTools();
+    const tool = tools.find((t) => t.name === name);
+    if (!tool?.available) {
+        throw new Error(`Required tool '${name}' not found. Please install it and ensure it's in your PATH.`);
+    }
+}
+/**
+ * Run Slither with JSON output.
+ */
+export async function runSlither(dir, args) {
+    logger.dim(`Running: slither ${args.join(' ')}`);
+    return exec('slither', args, { cwd: dir, timeout: 300_000 });
+}
+/**
+ * Get Slither function-summary output with file-based caching.
+ * access.ts and state.ts both run the identical `slither . --print function-summary --json -`
+ * command. This cache ensures it only runs once per analysis session.
+ */
+export async function getSlitherFunctionSummary(projectDir, outputDir) {
+    const cacheDir = path.join(outputDir, '.cache');
+    const cachePath = path.join(cacheDir, 'slither-function-summary.json');
+    // Use cache if it exists and is less than 5 minutes old
+    try {
+        const stat = fs.statSync(cachePath);
+        if (Date.now() - stat.mtimeMs < 5 * 60 * 1000) {
+            const cached = JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+            logger.dim('Using cached Slither function-summary');
+            return cached;
+        }
+    }
+    catch {
+        // Cache miss — run Slither
+    }
+    const result = await runSlither(projectDir, ['.', '--print', 'function-summary', '--json', '-']);
+    // Cache the result on success
+    if (result.exitCode === 0) {
+        try {
+            fs.mkdirSync(cacheDir, { recursive: true });
+            fs.writeFileSync(cachePath, JSON.stringify(result));
+        }
+        catch {
+            // Non-fatal — caching is best-effort
+        }
+    }
+    return result;
+}
+/**
+ * Run Forge (Foundry).
+ */
+export async function runForge(dir, args) {
+    logger.dim(`Running: forge ${args.join(' ')}`);
+    return exec('forge', args, { cwd: dir, timeout: 300_000 });
+}
+/**
+ * Flatten a Solidity file using forge flatten.
+ * Results are cached in-memory so repeated calls (e.g., from stats + access
+ * during `hex analyze`) skip the subprocess.
+ */
+const flattenCache = new Map();
+export async function flattenFile(projectDir, filePath) {
+    const key = `${projectDir}:${filePath}`;
+    if (flattenCache.has(key)) {
+        return flattenCache.get(key);
+    }
+    try {
+        const result = await runForge(projectDir, ['flatten', filePath]);
+        const value = result.exitCode === 0 && result.stdout.trim().length > 0
+            ? result.stdout
+            : null;
+        flattenCache.set(key, value);
+        return value;
+    }
+    catch {
+        flattenCache.set(key, null);
+        return null;
+    }
+}
+/**
+ * Run solc.
+ */
+export async function runSolc(dir, args) {
+    logger.dim(`Running: solc ${args.join(' ')}`);
+    return exec('solc', args, { cwd: dir });
+}
+//# sourceMappingURL=external-tools.js.map

package/dist/core/external-tools.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,16 @@
+import { type Ora } from 'ora';
+export declare function info(message: string): void;
+export declare function warn(message: string): void;
+export declare function error(message: string): void;
+export declare function success(message: string): void;
+export declare function dim(message: string): void;
+export declare function spinner(text: string): Ora;
+export declare const logger: {
+    info: typeof info;
+    warn: typeof warn;
+    error: typeof error;
+    success: typeof success;
+    dim: typeof dim;
+    spinner: typeof spinner;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAEzC;AAED,eAAO,MAAM,MAAM;;;;;;;CAA+C,CAAC"}

package/dist/core/logger.js

@@ -0,0 +1,22 @@
+import chalk from 'chalk';
+import ora from 'ora';
+export function info(message) {
+    console.log(chalk.blue('ℹ'), message);
+}
+export function warn(message) {
+    console.log(chalk.yellow('⚠'), message);
+}
+export function error(message) {
+    console.error(chalk.red('✖'), message);
+}
+export function success(message) {
+    console.log(chalk.green('✔'), message);
+}
+export function dim(message) {
+    console.log(chalk.dim(message));
+}
+export function spinner(text) {
+    return ora({ text, color: 'cyan' }).start();
+}
+export const logger = { info, warn, error, success, dim, spinner };
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAiB,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAe;IACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC"}

package/dist/core/output.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Write a JSON output file with pretty-printing.
+ */
+export declare function writeJsonOutput(dir: string, filename: string, data: unknown): string;
+/**
+ * Write a markdown output file.
+ */
+export declare function writeMarkdownOutput(dir: string, filename: string, content: string): string;
+/**
+ * Read and parse a JSON file, returning null if it doesn't exist.
+ */
+export declare function readJsonFile<T>(filePath: string): T | null;
+//# sourceMappingURL=output.d.ts.map

package/dist/core/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAKpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI1F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAO1D"}

package/dist/core/output.js

@@ -0,0 +1,45 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { normalizePath } from './paths.js';
+/**
+ * Atomic write: write to .tmp file then rename, to avoid partial reads by dashboard watcher.
+ */
+function atomicWrite(filePath, content) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const tmpPath = filePath + '.tmp';
+    fs.writeFileSync(tmpPath, content, 'utf-8');
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * Write a JSON output file with pretty-printing.
+ */
+export function writeJsonOutput(dir, filename, data) {
+    const filePath = normalizePath(path.join(dir, filename));
+    const content = JSON.stringify(data, null, 2) + '\n';
+    atomicWrite(filePath, content);
+    return filePath;
+}
+/**
+ * Write a markdown output file.
+ */
+export function writeMarkdownOutput(dir, filename, content) {
+    const filePath = normalizePath(path.join(dir, filename));
+    atomicWrite(filePath, content);
+    return filePath;
+}
+/**
+ * Read and parse a JSON file, returning null if it doesn't exist.
+ */
+export function readJsonFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,SAAS,WAAW,CAAC,QAAgB,EAAE,OAAe;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,QAAgB,EAAE,IAAa;IAC1E,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,QAAgB,EAAE,OAAe;IAChF,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzD,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAI,QAAgB;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Normalize a file path to use forward slashes (for consistent JSON output).
+ */
+export declare function normalizePath(filePath: string): string;
+/**
+ * Resolve a path relative to the project directory.
+ */
+export declare function resolveFromProject(projectDir: string, ...segments: string[]): string;
+/**
+ * Make a path relative to the project directory.
+ */
+export declare function makeRelative(projectDir: string, absolutePath: string): string;
+/**
+ * Get the output directory path from the project dir and config output_dir setting.
+ */
+export declare function getOutputDir(projectDir: string, outputDir?: string): string;
+/**
+ * Split text into lines, handling both Unix and Windows line endings.
+ */
+export declare function splitLines(text: string): string[];
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEpF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe,GAAG,MAAM,CAEnF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD"}

package/dist/core/paths.js

@@ -0,0 +1,32 @@
+import path from 'node:path';
+/**
+ * Normalize a file path to use forward slashes (for consistent JSON output).
+ */
+export function normalizePath(filePath) {
+    return filePath.replace(/\\/g, '/');
+}
+/**
+ * Resolve a path relative to the project directory.
+ */
+export function resolveFromProject(projectDir, ...segments) {
+    return normalizePath(path.resolve(projectDir, ...segments));
+}
+/**
+ * Make a path relative to the project directory.
+ */
+export function makeRelative(projectDir, absolutePath) {
+    return normalizePath(path.relative(projectDir, absolutePath));
+}
+/**
+ * Get the output directory path from the project dir and config output_dir setting.
+ */
+export function getOutputDir(projectDir, outputDir = '.hex') {
+    return resolveFromProject(projectDir, outputDir);
+}
+/**
+ * Split text into lines, handling both Unix and Windows line endings.
+ */
+export function splitLines(text) {
+    return text.split(/\r?\n/);
+}
+//# sourceMappingURL=paths.js.map