codeprobe 0.1.0

package/dist/core/agentTracer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Agent tracer: heuristic scanner for Claude-related workflow assets.
+ *
+ * Walks a repository tree and identifies files that are part of a
+ * Claude Code workflow -- configuration, agents, skills, hooks,
+ * MCP configs, and prompt specs.
+ */
+import type { ClaudeAsset } from '../types/agent.js';
+/**
+ * Heuristically scan a repository for Claude-related workflow assets.
+ *
+ * Walks the directory tree (skipping node_modules, .git, dist, etc.)
+ * and matches files against a set of pattern rules to identify
+ * configuration files, agents, skills, hooks, MCP configs, and
+ * prompt specs.
+ *
+ * @param rootPath  Absolute path to the repository root.
+ * @returns         Array of discovered Claude assets with confidence and reason.
+ */
+export declare function scanForClaudeAssets(rootPath: string): Promise<ClaudeAsset[]>;
+//# sourceMappingURL=agentTracer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentTracer.d.ts","sourceRoot":"","sources":["../../src/core/agentTracer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AAwUtE;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAkDxB"}

package/dist/core/agentTracer.js

@@ -0,0 +1,355 @@
+/**
+ * Agent tracer: heuristic scanner for Claude-related workflow assets.
+ *
+ * Walks a repository tree and identifies files that are part of a
+ * Claude Code workflow -- configuration, agents, skills, hooks,
+ * MCP configs, and prompt specs.
+ */
+import { basename, extname } from 'node:path';
+import { stat } from 'node:fs/promises';
+import { walkDirectory } from '../utils/fs.js';
+/** Directories to skip during traversal. */
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', 'coverage',
+    '__pycache__', '.next', '.nuxt', '.cache', '.turbo',
+    '.parcel-cache', '.vscode', '.idea', 'vendor', 'tmp',
+    '.tmp', '.terraform',
+]);
+const ASSET_RULES = [
+    // CLAUDE.md at any level
+    {
+        match: (_rel, name) => name === 'CLAUDE.md',
+        type: 'claude-config',
+        confidence: 'high',
+        reason: 'CLAUDE.md is a Claude Code project instructions file.',
+    },
+    // .claude/ directory contents
+    {
+        match: (rel) => rel.startsWith('.claude/') || rel.startsWith('.claude\\'),
+        type: 'claude-config',
+        confidence: 'high',
+        reason: 'File inside .claude/ directory (Claude Code configuration).',
+    },
+    // .claude/settings.json specifically
+    {
+        match: (rel) => rel === '.claude/settings.json' ||
+            rel === '.claude\\settings.json',
+        type: 'claude-config',
+        confidence: 'high',
+        reason: 'Claude Code settings file.',
+    },
+    // agents/*.yaml or agents/*.yml
+    {
+        match: (rel, _name, ext) => {
+            const parts = rel.split(/[/\\]/);
+            return parts.length >= 2 &&
+                parts[0] === 'agents' &&
+                (ext === '.yaml' || ext === '.yml');
+        },
+        type: 'agent',
+        confidence: 'medium',
+        reason: 'YAML file in agents/ directory -- likely an agent definition.',
+    },
+    // SKILL.md
+    {
+        match: (_rel, name) => name === 'SKILL.md',
+        type: 'skill',
+        confidence: 'medium',
+        reason: 'SKILL.md is a Claude Code skill definition file.',
+    },
+    // skills/*.md
+    {
+        match: (rel, _name, ext) => {
+            const parts = rel.split(/[/\\]/);
+            return parts.length >= 2 &&
+                parts[0] === 'skills' &&
+                ext === '.md';
+        },
+        type: 'skill',
+        confidence: 'medium',
+        reason: 'Markdown file in skills/ directory -- likely a skill definition.',
+    },
+    // hooks/ directory at root
+    {
+        match: (rel) => {
+            const parts = rel.split(/[/\\]/);
+            return parts.length >= 2 && parts[0] === 'hooks';
+        },
+        type: 'hook',
+        confidence: 'medium',
+        reason: 'File in hooks/ directory.',
+    },
+    // .claude/hooks directory
+    {
+        match: (rel) => rel.startsWith('.claude/hooks/') ||
+            rel.startsWith('.claude\\hooks\\'),
+        type: 'hook',
+        confidence: 'medium',
+        reason: 'File in .claude/hooks/ directory.',
+    },
+    // MCP config files
+    {
+        match: (_rel, name) => name === '.mcp.json' ||
+            name === 'mcp.json',
+        type: 'mcp-config',
+        confidence: 'high',
+        reason: 'MCP configuration file.',
+    },
+    // .claude/mcp*.json
+    {
+        match: (rel, name) => {
+            const parts = rel.split(/[/\\]/);
+            return parts.length >= 2 &&
+                parts[0] === '.claude' &&
+                name.startsWith('mcp') &&
+                name.endsWith('.json');
+        },
+        type: 'mcp-config',
+        confidence: 'high',
+        reason: 'MCP configuration file in .claude/ directory.',
+    },
+    // *.prompt.yaml / *.prompt.yml
+    {
+        match: (_rel, name) => name.endsWith('.prompt.yaml') ||
+            name.endsWith('.prompt.yml'),
+        type: 'prompt-spec',
+        confidence: 'high',
+        reason: 'Prompt specification file (*.prompt.yaml).',
+    },
+    // prompts/*.yaml
+    {
+        match: (rel, _name, ext) => {
+            const parts = rel.split(/[/\\]/);
+            return parts.length >= 2 &&
+                parts[0] === 'prompts' &&
+                (ext === '.yaml' || ext === '.yml');
+        },
+        type: 'prompt-spec',
+        confidence: 'medium',
+        reason: 'YAML file in prompts/ directory -- likely a prompt specification.',
+    },
+    // ── Cursor ──────────────────────────────────────────────
+    {
+        match: (_rel, name) => name === '.cursorrules',
+        type: 'cursor-config',
+        confidence: 'high',
+        reason: 'Cursor rules configuration file.',
+    },
+    {
+        match: (rel) => rel.startsWith('.cursor/rules/') || rel.startsWith('.cursor\\rules\\'),
+        type: 'cursor-config',
+        confidence: 'high',
+        reason: 'File inside .cursor/rules/ directory (Cursor rule definition).',
+    },
+    {
+        match: (rel) => rel === '.cursor/mcp.json' || rel === '.cursor\\mcp.json',
+        type: 'mcp-config',
+        confidence: 'high',
+        reason: 'MCP configuration file for Cursor.',
+    },
+    // ── Windsurf ────────────────────────────────────────────
+    {
+        match: (_rel, name) => name === '.windsurfrules',
+        type: 'windsurf-config',
+        confidence: 'high',
+        reason: 'Windsurf rules configuration file.',
+    },
+    {
+        match: (rel) => rel.startsWith('.windsurf/rules/') || rel.startsWith('.windsurf\\rules\\'),
+        type: 'windsurf-config',
+        confidence: 'high',
+        reason: 'File inside .windsurf/rules/ directory (Windsurf rule definition).',
+    },
+    // ── GitHub Copilot ──────────────────────────────────────
+    {
+        match: (rel) => rel === '.github/copilot-instructions.md' ||
+            rel === '.github\\copilot-instructions.md',
+        type: 'copilot-config',
+        confidence: 'high',
+        reason: 'GitHub Copilot custom instructions file.',
+    },
+    {
+        match: (rel) => rel.startsWith('.copilot/') || rel.startsWith('.copilot\\'),
+        type: 'copilot-config',
+        confidence: 'medium',
+        reason: 'File inside .copilot/ directory (GitHub Copilot configuration).',
+    },
+    // ── Aider ───────────────────────────────────────────────
+    {
+        match: (_rel, name) => name === '.aider.conf.yml',
+        type: 'aider-config',
+        confidence: 'high',
+        reason: 'Aider configuration file.',
+    },
+    {
+        match: (_rel, name) => name === '.aiderignore',
+        type: 'aider-config',
+        confidence: 'high',
+        reason: 'Aider ignore file.',
+    },
+    {
+        match: (_rel, name) => name === '.aider.model.settings.yml',
+        type: 'aider-config',
+        confidence: 'high',
+        reason: 'Aider model settings file.',
+    },
+    // ── Continue.dev ────────────────────────────────────────
+    {
+        match: (rel) => rel === '.continue/config.json' || rel === '.continue\\config.json',
+        type: 'continue-config',
+        confidence: 'high',
+        reason: 'Continue.dev configuration file.',
+    },
+    {
+        match: (_rel, name) => name === '.continuerules',
+        type: 'continue-config',
+        confidence: 'high',
+        reason: 'Continue.dev rules file.',
+    },
+    {
+        match: (rel) => rel.startsWith('.continue/') || rel.startsWith('.continue\\'),
+        type: 'continue-config',
+        confidence: 'medium',
+        reason: 'File inside .continue/ directory (Continue.dev configuration).',
+    },
+    // ── Cline ───────────────────────────────────────────────
+    {
+        match: (_rel, name) => name === '.clinerules',
+        type: 'cline-config',
+        confidence: 'high',
+        reason: 'Cline rules configuration file.',
+    },
+    {
+        match: (rel) => rel.startsWith('.cline/') || rel.startsWith('.cline\\'),
+        type: 'cline-config',
+        confidence: 'medium',
+        reason: 'File inside .cline/ directory (Cline configuration).',
+    },
+    // ── OpenAI Codex CLI ────────────────────────────────────
+    {
+        match: (_rel, name) => name === 'codex.md' || name === 'CODEX.md',
+        type: 'codex-config',
+        confidence: 'high',
+        reason: 'OpenAI Codex CLI instruction file.',
+    },
+    {
+        match: (rel) => rel.startsWith('.codex/') || rel.startsWith('.codex\\'),
+        type: 'codex-config',
+        confidence: 'medium',
+        reason: 'File inside .codex/ directory (OpenAI Codex configuration).',
+    },
+    // ── General AI context files ────────────────────────────
+    {
+        match: (_rel, name) => name === 'AGENTS.md',
+        type: 'context-file',
+        confidence: 'medium',
+        reason: 'AI agent instructions file.',
+    },
+    {
+        match: (_rel, name) => name === 'CONTEXT.md',
+        type: 'context-file',
+        confidence: 'medium',
+        reason: 'AI context documentation file.',
+    },
+    {
+        match: (_rel, name) => name === 'AI.md',
+        type: 'context-file',
+        confidence: 'medium',
+        reason: 'AI instructions file.',
+    },
+    {
+        match: (rel) => rel.startsWith('.ai/') || rel.startsWith('.ai\\'),
+        type: 'context-file',
+        confidence: 'medium',
+        reason: 'File inside .ai/ directory (AI configuration).',
+    },
+    // ── Agentic workflow files ──────────────────────────────
+    {
+        match: (rel) => rel === 'tasks/todo.md' || rel === 'tasks\\todo.md',
+        type: 'agentic-workflow',
+        confidence: 'high',
+        reason: 'Agentic workflow task list.',
+    },
+    {
+        match: (rel) => rel === 'tasks/lessons.md' || rel === 'tasks\\lessons.md',
+        type: 'agentic-workflow',
+        confidence: 'high',
+        reason: 'Agentic workflow lessons learned.',
+    },
+    {
+        match: (_rel, name) => name === 'PLAN.md',
+        type: 'agentic-workflow',
+        confidence: 'medium',
+        reason: 'Agentic workflow plan file.',
+    },
+    {
+        match: (rel, _name, ext) => {
+            const parts = rel.split(/[/\\]/);
+            return parts.length >= 2 &&
+                parts[0] === 'plans' &&
+                ext === '.md';
+        },
+        type: 'agentic-workflow',
+        confidence: 'medium',
+        reason: 'Markdown file in plans/ directory -- likely an agentic workflow plan.',
+    },
+];
+/**
+ * Heuristically scan a repository for Claude-related workflow assets.
+ *
+ * Walks the directory tree (skipping node_modules, .git, dist, etc.)
+ * and matches files against a set of pattern rules to identify
+ * configuration files, agents, skills, hooks, MCP configs, and
+ * prompt specs.
+ *
+ * @param rootPath  Absolute path to the repository root.
+ * @returns         Array of discovered Claude assets with confidence and reason.
+ */
+export async function scanForClaudeAssets(rootPath) {
+    // Verify root exists and is a directory
+    try {
+        const rootStat = await stat(rootPath);
+        if (!rootStat.isDirectory()) {
+            return [];
+        }
+    }
+    catch {
+        return [];
+    }
+    const assets = [];
+    const seenPaths = new Set();
+    const entries = await walkDirectory(rootPath, { ignoreDirs: SKIP_DIRS });
+    for (const entry of entries) {
+        if (!entry.isFile)
+            continue;
+        const relativePath = entry.relativePath;
+        const fileName = basename(entry.path);
+        const ext = extname(entry.path).toLowerCase();
+        for (const rule of ASSET_RULES) {
+            if (rule.match(relativePath, fileName, ext)) {
+                // Avoid duplicates when multiple rules match the same file.
+                // Use the first (highest priority) match.
+                if (!seenPaths.has(entry.path)) {
+                    seenPaths.add(entry.path);
+                    assets.push({
+                        path: entry.path,
+                        type: rule.type,
+                        confidence: rule.confidence,
+                        reason: rule.reason,
+                    });
+                }
+                break;
+            }
+        }
+    }
+    // Sort by confidence (high first), then by path
+    const confidenceOrder = { high: 0, medium: 1, low: 2 };
+    assets.sort((a, b) => {
+        const confDiff = confidenceOrder[a.confidence] - confidenceOrder[b.confidence];
+        if (confDiff !== 0)
+            return confDiff;
+        return a.path.localeCompare(b.path);
+    });
+    return assets;
+}
+//# sourceMappingURL=agentTracer.js.map

package/dist/core/agentTracer.js.map

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

package/dist/core/anthropicClient.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Anthropic API client — thin wrapper for live execution mode.
+ *
+ * Uses dynamic import so anthropic SDK is optional.
+ * Install with: npm install @anthropic-ai/sdk
+ */
+export interface AnthropicMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface AnthropicRequest {
+    model: string;
+    system?: string;
+    messages: AnthropicMessage[];
+    maxTokens?: number;
+}
+export interface AnthropicResponse {
+    content: string;
+    inputTokens: number;
+    outputTokens: number;
+    model: string;
+    stopReason: string;
+}
+export declare function isAnthropicAvailable(): Promise<boolean>;
+export declare function callAnthropic(request: AnthropicRequest): Promise<AnthropicResponse>;
+//# sourceMappingURL=anthropicClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropicClient.d.ts","sourceRoot":"","sources":["../../src/core/anthropicClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ7D;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgDzF"}

package/dist/core/anthropicClient.js

@@ -0,0 +1,62 @@
+/**
+ * Anthropic API client — thin wrapper for live execution mode.
+ *
+ * Uses dynamic import so anthropic SDK is optional.
+ * Install with: npm install @anthropic-ai/sdk
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let clientInstance = null;
+export async function isAnthropicAvailable() {
+    try {
+        const SDK_MODULE = '@anthropic-ai/sdk';
+        await import(SDK_MODULE);
+        return !!process.env.ANTHROPIC_API_KEY;
+    }
+    catch {
+        return false;
+    }
+}
+export async function callAnthropic(request) {
+    if (!process.env.ANTHROPIC_API_KEY) {
+        throw new Error('ANTHROPIC_API_KEY environment variable is required for live mode');
+    }
+    try {
+        // Dynamic import — only loaded when live mode is used.
+        // Use a string variable to prevent TypeScript from attempting
+        // static module resolution on an optional dependency.
+        const SDK_MODULE = '@anthropic-ai/sdk';
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import(SDK_MODULE);
+        const Anthropic = mod.default ?? mod.Anthropic ?? mod;
+        if (!clientInstance) {
+            clientInstance = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
+        }
+        const response = await clientInstance.messages.create({
+            model: request.model,
+            max_tokens: request.maxTokens ?? 1024,
+            system: request.system,
+            messages: request.messages,
+        });
+        // Extract text content from response
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const contentBlocks = response.content;
+        const text = contentBlocks
+            .filter((block) => block.type === 'text')
+            .map((block) => block.text ?? '')
+            .join('');
+        return {
+            content: text,
+            inputTokens: response.usage?.input_tokens ?? 0,
+            outputTokens: response.usage?.output_tokens ?? 0,
+            model: request.model,
+            stopReason: response.stop_reason ?? 'unknown',
+        };
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes('Cannot find package')) {
+            throw new Error('Live mode requires the Anthropic SDK. Install it with: npm install @anthropic-ai/sdk');
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=anthropicClient.js.map

package/dist/core/anthropicClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropicClient.js","sourceRoot":"","sources":["../../src/core/anthropicClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,8DAA8D;AAC9D,IAAI,cAAc,GAAQ,IAAI,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,mBAAmB,CAAC;QACvC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAyB;IAC3D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,CAAC;QACH,uDAAuD;QACvD,8DAA8D;QAC9D,sDAAsD;QACtD,MAAM,UAAU,GAAG,mBAAmB,CAAC;QACvC,8DAA8D;QAC9D,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC;QAEtD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,cAAc,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;YACpD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACrC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,qCAAqC;QACrC,8DAA8D;QAC9D,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAiD,CAAC;QACjF,MAAM,IAAI,GAAG,aAAa;aACvB,MAAM,CAAC,CAAC,KAAuB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;aAC1D,GAAG,CAAC,CAAC,KAAsC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;aACjE,IAAI,CAAC,EAAE,CAAC,CAAC;QAEZ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;YAC9C,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;YAChD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,QAAQ,CAAC,WAAW,IAAI,SAAS;SAC9C,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/core/benchmarkRunner.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Benchmark runner for AI models.
+ *
+ * Runs a prompt spec against one or more models, collecting
+ * score, token usage, latency, and cost data across multiple runs.
+ * Supports a mock mode for offline development and CI pipelines.
+ *
+ * Pricing and model metadata are sourced from the central model registry.
+ */
+import type { BenchmarkResult } from '../types/results.js';
+export interface BenchmarkOptions {
+    models?: string[];
+    runs?: number;
+    mode?: 'mock' | 'live';
+    verbose?: boolean;
+}
+/**
+ * Run benchmarks for a prompt spec across one or more models.
+ *
+ * @param specPath  Path to a YAML prompt spec file.
+ * @param options   Benchmark configuration.
+ * @returns         An array of results, one per model.
+ */
+export declare function runBenchmark(specPath: string, options?: BenchmarkOptions): Promise<BenchmarkResult[]>;
+//# sourceMappingURL=benchmarkRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"benchmarkRunner.d.ts","sourceRoot":"","sources":["../../src/core/benchmarkRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,qBAAqB,CAAC;AAGzE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA+ID;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,EAAE,CAAC,CA2D5B"}