modestbench 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.3.0](https://github.com/boneskull/modestbench/compare/modestbench-v0.2.0...modestbench-v0.3.0) (2025-10-28)
+
+
+### Features
+
+* add analyze command for code profiling and benchmark discovery ([330b345](https://github.com/boneskull/modestbench/commit/330b345493fc43ba6e00d64c245e2a84fd734e6d))
+* add performance budgets ([367c554](https://github.com/boneskull/modestbench/commit/367c5542efea8bab7a64d22728b2ea793de91f99))
+* implement --bail ([#82](https://github.com/boneskull/modestbench/issues/82)) ([69d4327](https://github.com/boneskull/modestbench/commit/69d4327ee9327ab5e6076654e79dd4a21f15770a))
+
+
+### Bug Fixes
+
+* **deps:** pin dependency tinybench to 5.1.0 ([#81](https://github.com/boneskull/modestbench/issues/81)) ([1be5bbe](https://github.com/boneskull/modestbench/commit/1be5bbe332545eea8d25143f61492f87cbb2089d))
+* **deps:** update dependency tinybench to v5.1.0 ([#76](https://github.com/boneskull/modestbench/issues/76)) ([cbd763c](https://github.com/boneskull/modestbench/commit/cbd763ca7d7335f9b3e7e4cda2217160b76e366c))
+* **deps:** upgrade to tinybench@5.1.0 ([6668a38](https://github.com/boneskull/modestbench/commit/6668a38c1ea737320a132efd884a57a4c5f91a25))
+* fix bin script ([68155e9](https://github.com/boneskull/modestbench/commit/68155e93a19cd88fa8add5fad4e2baae356eaba0))
+* resolve merge conflict issues and test failures ([ab1e288](https://github.com/boneskull/modestbench/commit/ab1e288cbe11d729266fd74dc14dedc58a01bf27))
+* resolve test failures and improve default behavior ([a61d798](https://github.com/boneskull/modestbench/commit/a61d798127ca58eac4ef2f3e03944703459dda31))
+* resolve TypeScript type errors in budget transformation ([b8f2155](https://github.com/boneskull/modestbench/commit/b8f215533829e533515c7af1f8396aea71517c10))
+
+## [0.2.0](https://github.com/boneskull/modestbench/compare/modestbench-v0.1.0...modestbench-v0.2.0) (2025-10-26)
+
+
+### Features
+
+* add --output-file CLI option ([#66](https://github.com/boneskull/modestbench/issues/66)) ([09bb5ae](https://github.com/boneskull/modestbench/commit/09bb5ae7468c9d5eb9d1e9641c58350a5b3856dd))
+* **history:** implement trend analysis and comparison ([#64](https://github.com/boneskull/modestbench/issues/64)) ([acf7dda](https://github.com/boneskull/modestbench/commit/acf7ddaa91f7ae242c2a2df86fd610ce88f8ac91))
+* **history:** implement trends and comparison ([acf7dda](https://github.com/boneskull/modestbench/commit/acf7ddaa91f7ae242c2a2df86fd610ce88f8ac91))
+* implement date parsing, compare, and trend analysis core ([acf7dda](https://github.com/boneskull/modestbench/commit/acf7ddaa91f7ae242c2a2df86fd610ce88f8ac91))
+* implement full trends command with visualizations ([acf7dda](https://github.com/boneskull/modestbench/commit/acf7ddaa91f7ae242c2a2df86fd610ce88f8ac91))
+
 ## [0.1.0](https://github.com/boneskull/modestbench/compare/modestbench-v0.0.3...modestbench-v0.1.0) (2025-10-24)
 
 

package/README.md

@@ -14,6 +14,7 @@
 - **Multiple Output Formats**: Human-readable, JSON, and CSV reports (at the same time!!)
 - **Historical Tracking**: Store and compare benchmark results over time
 - **Tagging System**: Organize and filter benchmarks by categories
+- **Performance Budgets**: Enforce performance standards and prevent regressions
 - **CLI & API**: Command-line interface and programmatic API
 - **TypeScript Support**: Full type safety
 
@@ -125,42 +126,12 @@ export default {
 modestbench
 
 # Run with specific options
-modestbench --iterations 5000 --reporters human,json
+modestbench --iterations 5000 --reporter human --reporter json
 ```
 
 ### View Results
 
-```text
-🚀 ModestBench
-
-Environment:
-  Node.js: v24.10.0
-  Platform: darwin arm64
-  CPU: Apple M4 Max (16 cores)
-  Memory: 48.0 GB
-
-Found 1 benchmark file(s)
-
-▶ benchmarks/example.bench.js
-
-  ▶ Array Operations
-    ✓ Array.push()
-      810.05μs ±2.45% (1.23M ops/sec)
-    ✓ Array spread
-      81.01ms ±4.12% (12.34K ops/sec)
-  ✓ 2 passed
-
-  ✓ All 2 tasks passed
-
-📊 Results
-
-✓ All tests passed: 2
-📁 Files: 1
-📊 Suites: 1
-⏱️ Duration: 1.82s
-
-🎉 All benchmarks completed successfully!
-```
+![Example output showing colorful terminal display with benchmark results](./public/human-reporter.png)
 
 ## Getting Started
 
@@ -200,9 +171,12 @@ modestbench file.bench.js benchmarks/ "tests/**/*.bench.ts"
 modestbench \
   --config ./config.json \
   --iterations 2000 \
-  --reporters human,json,csv \
+  --reporter human \
+  --reporter json \
+  --reporter csv \
   --output ./results \
-  --tags performance,algorithm \
+  --tag performance \
+  --tag algorithm \
   --concurrent
 ```
 
@@ -252,27 +226,65 @@ Run specific subsets of benchmarks using tags:
 
 ```bash
 # Run only benchmarks tagged with 'fast'
-modestbench --tags fast
+modestbench --tag fast
 
 # Run benchmarks with multiple tags (OR logic - matches ANY)
-modestbench --tags string,array,algorithm
+modestbench --tag string --tag array --tag algorithm
 
 # Exclude specific benchmarks
-modestbench --exclude-tags slow,experimental
+modestbench --exclude-tag slow --exclude-tag experimental
 
 # Combine: run fast benchmarks except experimental ones
-modestbench --tags fast --exclude-tags experimental
+modestbench --tag fast --exclude-tag experimental
 ```
 
 **Key Features:**
 
 - Tags cascade from file → suite → task levels
-- `--tags` uses OR logic (matches ANY specified tag)
-- `--exclude-tags` takes precedence over `--tags`
+- `--tag` uses OR logic when specified multiple times (matches ANY specified tag)
+- `--exclude-tag` takes precedence over `--tag`
 - Suite setup/teardown only runs if at least one task matches
 
 See [Tagging and Filtering](#tagging-and-filtering) for detailed examples.
 
+#### Output Options
+
+Control where and how benchmark results are saved:
+
+```bash
+# Write to a directory (creates results.json, results.csv, etc.)
+modestbench --reporter json --reporter csv --output ./results
+
+# Custom filename for single reporter
+modestbench --reporter json --output-file my-benchmarks.json
+
+# Custom filename in specific directory
+modestbench --reporter json --output ./results --output-file benchmarks-2024.json
+
+# Custom filename with absolute path
+modestbench --reporter json --output-file /tmp/my-benchmarks.json
+
+# With subdirectories
+modestbench --reporter csv --output ./results --output-file reports/performance.csv
+
+# Short flag alias (using -r for --reporter)
+modestbench -r json --of custom.json
+```
+
+**Key Options:**
+
+- `--output <dir>`, `-o <dir>` - Directory to write output files (default: stdout)
+- `--output-file <filename>`, `--of <filename>` - Custom filename for output
+  - Works with absolute or relative paths
+  - Requires exactly one reporter (e.g., `--reporter json`)
+  - When used with `--output`, the filename is relative to that directory
+  - When used alone, the path is relative to current working directory
+
+**Limitations:**
+
+- `--output-file` only works with a single reporter
+- For multiple reporters, use `--output <dir>` (defaults to `results.json`, `results.csv`, etc.)
+
 ### History Management
 
 **modestbench** automatically tracks benchmark results over time in a local `.modestbench/` directory. This history enables you to:
@@ -299,6 +311,98 @@ modestbench history export --format csv --output results.csv
 modestbench history clean --older-than 30d
 ```
 
+### Performance Budgets
+
+**modestbench** supports performance budgets to prevent regressions and enforce performance standards in CI/CD.
+
+#### Configuring Budgets
+
+Define budgets in your `modestbench.config.json`:
+
+```json
+{
+  "budgetMode": "fail",
+  "budgets": {
+    "benchmarks/critical.bench.js/default/parseConfig": {
+      "absolute": {
+        "maxTime": "10ms",
+        "minOpsPerSec": 100000
+      }
+    }
+  }
+}
+```
+
+**Budget Types:**
+
+- **Absolute Budgets**: Fixed thresholds
+  - `maxTime` - Maximum mean execution time (e.g., `"10ms"`, `"500us"`)
+  - `minOpsPerSec` - Minimum operations per second
+  - `maxP99` - Maximum 99th percentile latency
+
+- **Relative Budgets**: Comparison against baseline
+  - `maxRegression` - Maximum performance degradation (e.g., `"10%"`, `0.1`)
+
+**Budget Modes:**
+
+- `fail` (default) - Exit with error code if budgets fail
+- `warn` - Show warnings but don't fail
+- `report` - Include in output without failing
+
+#### Managing Baselines
+
+```bash
+# Save current run as a baseline
+modestbench baseline set production-v1.0
+
+# List all baselines
+modestbench baseline list
+
+# Compare against a baseline
+modestbench run --baseline production-v1.0
+
+# Analyze history and suggest budgets
+modestbench baseline analyze
+```
+
+### Profile Code Execution
+
+Identify hot code paths that are good candidates for benchmarking:
+
+```bash
+# Profile a command
+modestbench analyze "npm test"
+
+# Profile a specific script
+modestbench analyze "node ./src/server.js"
+
+# Analyze existing profile
+modestbench analyze --input isolate-0x123-v8.log
+
+# Filter and customize output
+modestbench analyze "npm test" \
+  --filter-file "src/**" \
+  --min-percent 2.0 \
+  --top 50 \
+  --group-by-file
+```
+
+**Profile Options:**
+
+- `[command]` - Command to profile (e.g., `npm test`, `node script.js`)
+- `--input`, `-i` - Path to existing V8 profile log file
+- `--filter-file` - Filter functions by file glob pattern
+- `--min-percent` - Minimum execution percentage to show (default: 1.0)
+- `--top`, `-n` - Number of top functions to show (default: 25)
+- `--group-by-file` - Group results by source file
+- `--color` - Enable/disable color output
+
+**How It Works:**
+
+The profile command uses Node.js's built-in V8 profiler to identify functions that consume the most execution time. It automatically filters out Node.js internals and `node_modules` to focus on your code.
+
+Functions that appear at the top of the profile report are good candidates for benchmarking, as optimizing them will have the most impact on overall performance.
+
 ## Configuration
 
 ### Project Configuration
@@ -501,37 +605,37 @@ export default {
 
 #### Filtering Benchmarks
 
-Use `--tags` to include only benchmarks with specific tags (OR logic - matches ANY tag):
+Use `--tag` (or `-t`) to include only benchmarks with specific tags (OR logic - matches ANY tag):
 
 ```bash
-# Run only fast algorithms
-modestbench run --tags fast
+# Run fast algorithms
+modestbench run --tag fast
 
 # Run benchmarks tagged with 'string' OR 'array'
-modestbench run --tags string,array
+modestbench run --tag string --tag array
 
-# Multiple tags can be space-separated too
-modestbench run --tags fast optimized
+# Using short aliases
+modestbench run -t fast -t optimized
 ```
 
-Use `--exclude-tags` to skip benchmarks with specific tags:
+Use `--exclude-tag` (or `-e`) to skip benchmarks with specific tags:
 
 ```bash
 # Exclude slow benchmarks
-modestbench run --exclude-tags slow
+modestbench run --exclude-tag slow
 
 # Exclude experimental and unstable benchmarks
-modestbench run --exclude-tags experimental,unstable
+modestbench run --exclude-tag experimental --exclude-tag unstable
 ```
 
 Combine both to fine-tune your benchmark runs (exclusion takes precedence):
 
 ```bash
 # Run fast benchmarks, but exclude experimental ones
-modestbench run --tags fast --exclude-tags experimental
+modestbench run --tag fast --exclude-tag experimental
 
 # Run algorithm benchmarks but skip slow reference implementations
-modestbench run --tags algorithm --exclude-tags slow,reference
+modestbench run --tag algorithm --exclude-tag slow --exclude-tag reference
 ```
 
 #### Tag Cascading Example
@@ -557,10 +661,10 @@ export default {
 
 **Filtering Behavior:**
 
-- `--tags math` → Runs only Task A (matches 'math')
-- `--tags fast` → Runs both Task A and Task B (both have 'fast')
-- `--tags file-level` → Runs both tasks (both inherit 'file-level')
-- `--exclude-tags math` → Runs only Task B (Task A excluded)
+- `--tag math` → Runs only Task A (matches 'math')
+- `--tag fast` → Runs both Task A and Task B (both have 'fast')
+- `--tag file-level` → Runs both tasks (both inherit 'file-level')
+- `--exclude-tag math` → Runs only Task B (Task A excluded)
 
 #### Suite Lifecycle with Filtering
 
@@ -589,7 +693,8 @@ jobs:
       - name: Run Benchmarks
         run: |
           modestbench \
-            --reporters json,csv \
+            --reporter json \
+            --reporter csv \
             --output ./results
 
       - name: Upload Results
@@ -607,7 +712,7 @@ import { execSync } from 'child_process';
 import { readFileSync } from 'fs';
 
 // Run current benchmarks
-execSync('modestbench --reporters json --output ./current');
+execSync('modestbench --reporter json --output ./current');
 const current = JSON.parse(readFileSync('./current/results.json'));
 
 // Load baseline results

package/dist/bootstrap.cjs

@@ -7,12 +7,12 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bootstrap = void 0;
-const manager_js_1 = require("./config/manager.cjs");
 const index_js_1 = require("./core/engines/index.cjs");
-const loader_js_1 = require("./core/loader.cjs");
-const manager_js_2 = require("./progress/manager.cjs");
-const registry_js_1 = require("./reporters/registry.cjs");
-const history_js_1 = require("./storage/history.cjs");
+const config_manager_js_1 = require("./services/config-manager.cjs");
+const file_loader_js_1 = require("./services/file-loader.cjs");
+const history_storage_js_1 = require("./services/history-storage.cjs");
+const progress_manager_js_1 = require("./services/progress-manager.cjs");
+const reporter_registry_js_1 = require("./services/reporter-registry.cjs");
 /**
  * Initializes the ModestBench engine with default dependencies.
  *
@@ -23,11 +23,11 @@ const history_js_1 = require("./storage/history.cjs");
  */
 const bootstrap = () => {
     const engine = new index_js_1.TinybenchEngine({
-        configManager: new manager_js_1.ModestBenchConfigurationManager(),
-        fileLoader: new loader_js_1.BenchmarkFileLoader(),
-        historyStorage: new history_js_1.FileHistoryStorage(),
-        progressManager: new manager_js_2.ModestBenchProgressManager(),
-        reporterRegistry: new registry_js_1.ModestBenchReporterRegistry(),
+        configManager: new config_manager_js_1.ModestBenchConfigurationManager(),
+        fileLoader: new file_loader_js_1.BenchmarkFileLoader(),
+        historyStorage: new history_storage_js_1.FileHistoryStorage(),
+        progressManager: new progress_manager_js_1.ModestBenchProgressManager(),
+        reporterRegistry: new reporter_registry_js_1.ModestBenchReporterRegistry(),
     });
     return engine;
 };

package/dist/bootstrap.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qDAAsE;AAEtE,uDAA0D;AAC1D,iDAAuD;AACvD,uDAAmE;AACnE,0DAAsE;AACtE,sDAA0D;AAE1D;;;;;;;GAOG;AACI,MAAM,SAAS,GAAG,GAAsB,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,0BAAe,CAAC;QACjC,aAAa,EAAE,IAAI,4CAA+B,EAAE;QACpD,UAAU,EAAE,IAAI,+BAAmB,EAAE;QACrC,cAAc,EAAE,IAAI,+BAAkB,EAAE;QACxC,eAAe,EAAE,IAAI,uCAA0B,EAAE;QACjD,gBAAgB,EAAE,IAAI,yCAA2B,EAAE;KACpD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AATW,QAAA,SAAS,aASpB"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,uDAA0D;AAC1D,qEAA+E;AAC/E,+DAAgE;AAChE,uEAAmE;AACnE,yEAA4E;AAC5E,2EAA8E;AAE9E;;;;;;;GAOG;AACI,MAAM,SAAS,GAAG,GAAsB,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,0BAAe,CAAC;QACjC,aAAa,EAAE,IAAI,mDAA+B,EAAE;QACpD,UAAU,EAAE,IAAI,oCAAmB,EAAE;QACrC,cAAc,EAAE,IAAI,uCAAkB,EAAE;QACxC,eAAe,EAAE,IAAI,gDAA0B,EAAE;QACjD,gBAAgB,EAAE,IAAI,kDAA2B,EAAE;KACpD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AATW,QAAA,SAAS,aASpB"}

package/dist/bootstrap.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,iBAAiB,EAAE,0BAAyB;AAO1D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAO,iBAS5B,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,0BAAyB;AAQ1D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAO,iBAS5B,CAAC"}

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,iBAAiB,EAAE,yBAAyB;AAO1D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAO,iBAS5B,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,yBAAyB;AAQ1D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAO,iBAS5B,CAAC"}

package/dist/bootstrap.js

@@ -4,12 +4,12 @@
  *
  * @packageDocumentation
  */
-import { ModestBenchConfigurationManager } from "./config/manager.js";
 import { TinybenchEngine } from "./core/engines/index.js";
-import { BenchmarkFileLoader } from "./core/loader.js";
-import { ModestBenchProgressManager } from "./progress/manager.js";
-import { ModestBenchReporterRegistry } from "./reporters/registry.js";
-import { FileHistoryStorage } from "./storage/history.js";
+import { ModestBenchConfigurationManager } from "./services/config-manager.js";
+import { BenchmarkFileLoader } from "./services/file-loader.js";
+import { FileHistoryStorage } from "./services/history-storage.js";
+import { ModestBenchProgressManager } from "./services/progress-manager.js";
+import { ModestBenchReporterRegistry } from "./services/reporter-registry.js";
 /**
  * Initializes the ModestBench engine with default dependencies.
  *

package/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,+BAA+B,EAAE,4BAA4B;AAEtE,OAAO,EAAE,eAAe,EAAE,gCAAgC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,yBAAyB;AACvD,OAAO,EAAE,0BAA0B,EAAE,8BAA8B;AACnE,OAAO,EAAE,2BAA2B,EAAE,gCAAgC;AACtE,OAAO,EAAE,kBAAkB,EAAE,6BAA6B;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAsB,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,aAAa,EAAE,IAAI,+BAA+B,EAAE;QACpD,UAAU,EAAE,IAAI,mBAAmB,EAAE;QACrC,cAAc,EAAE,IAAI,kBAAkB,EAAE;QACxC,eAAe,EAAE,IAAI,0BAA0B,EAAE;QACjD,gBAAgB,EAAE,IAAI,2BAA2B,EAAE;KACpD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,gCAAgC;AAC1D,OAAO,EAAE,+BAA+B,EAAE,qCAAqC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,kCAAkC;AAChE,OAAO,EAAE,kBAAkB,EAAE,sCAAsC;AACnE,OAAO,EAAE,0BAA0B,EAAE,uCAAuC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,wCAAwC;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAsB,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,aAAa,EAAE,IAAI,+BAA+B,EAAE;QACpD,UAAU,EAAE,IAAI,mBAAmB,EAAE;QACrC,cAAc,EAAE,IAAI,kBAAkB,EAAE;QACxC,eAAe,EAAE,IAAI,0BAA0B,EAAE;QACjD,gBAAgB,EAAE,IAAI,2BAA2B,EAAE;KACpD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/cli/commands/analyze.cjs

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Analyze Command
+ *
+ * CLI command for analyzing code execution and identifying benchmark
+ * candidates. Uses Node.js V8 profiler to capture function execution data.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAnalyzeCommand = void 0;
+const profile_human_js_1 = require("../../reporters/profile-human.cjs");
+const profile_filter_js_1 = require("../../services/profiler/profile-filter.cjs");
+const profile_parser_js_1 = require("../../services/profiler/profile-parser.cjs");
+const profile_runner_js_1 = require("../../services/profiler/profile-runner.cjs");
+const package_js_1 = require("../../utils/package.cjs");
+/**
+ * Handle analyze command
+ */
+const handleAnalyzeCommand = async (_context, options) => {
+    try {
+        const startTime = Date.now();
+        // Run profiling or load existing profile
+        const logPath = options.input
+            ? options.input
+            : await (0, profile_runner_js_1.runWithProfiling)(options.command, {
+                cwd: options.cwd,
+            });
+        const duration = Date.now() - startTime;
+        // Parse profile data
+        const profileData = await (0, profile_parser_js_1.parseProfile)(logPath);
+        // Find package root for smart detection
+        const packageRoot = await (0, package_js_1.findPackageRoot)(options.cwd);
+        // Apply filtering
+        const config = {
+            focus: options.filterFile ? [options.filterFile] : undefined,
+            groupByFile: options.groupByFile,
+            minExecutionPercent: options.minPercent,
+            smartDetection: true,
+            topN: options.top,
+        };
+        const filtered = (0, profile_filter_js_1.filterProfile)(profileData, config, packageRoot);
+        // Add command and duration to filtered data
+        filtered.command = options.command;
+        filtered.duration = duration;
+        // Report results
+        const reporter = new profile_human_js_1.ProfileHumanReporter({
+            color: options.color,
+            groupByFile: options.groupByFile,
+        });
+        reporter.report(filtered);
+        return 0;
+    }
+    catch (error) {
+        console.error('Analyze command failed:', error);
+        return 1;
+    }
+};
+exports.handleAnalyzeCommand = handleAnalyzeCommand;
+//# sourceMappingURL=analyze.js.map

package/dist/cli/commands/analyze.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAKH,wEAAwE;AACxE,kFAA0E;AAC1E,kFAAyE;AACzE,kFAA6E;AAC7E,wDAAyD;AA+BzD;;GAEG;AACI,MAAM,oBAAoB,GAAG,KAAK,EACvC,QAAoB,EACpB,OAAuB,EACN,EAAE;IACnB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,yCAAyC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK;YAC3B,CAAC,CAAC,OAAO,CAAC,KAAK;YACf,CAAC,CAAC,MAAM,IAAA,oCAAgB,EAAC,OAAO,CAAC,OAAQ,EAAE;gBACvC,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;QAEP,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAExC,qBAAqB;QACrB,MAAM,WAAW,GAAG,MAAM,IAAA,gCAAY,EAAC,OAAO,CAAC,CAAC;QAEhD,wCAAwC;QACxC,MAAM,WAAW,GAAG,MAAM,IAAA,4BAAe,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvD,kBAAkB;QAClB,MAAM,MAAM,GAAkB;YAC5B,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5D,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,mBAAmB,EAAE,OAAO,CAAC,UAAU;YACvC,cAAc,EAAE,IAAI;YACpB,IAAI,EAAE,OAAO,CAAC,GAAG;SAClB,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAA,iCAAa,EAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAEjE,4CAA4C;QAC5C,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACnC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAE7B,iBAAiB;QACjB,MAAM,QAAQ,GAAG,IAAI,uCAAoB,CAAC;YACxC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QAEH,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE1B,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC,CAAC;AAlDW,QAAA,oBAAoB,wBAkD/B"}

package/dist/cli/commands/analyze.d.cts

@@ -0,0 +1,35 @@
+/**
+ * Analyze Command
+ *
+ * CLI command for analyzing code execution and identifying benchmark
+ * candidates. Uses Node.js V8 profiler to capture function execution data.
+ *
+ * @packageDocumentation
+ */
+import type { CliContext } from "../index.cjs";
+/**
+ * Analyze command options interface
+ */
+export interface AnalyzeOptions {
+    /** Enable color output */
+    color?: boolean | undefined;
+    /** Command to analyze */
+    command?: string | undefined;
+    /** Working directory */
+    cwd: string;
+    /** Filter by file pattern */
+    filterFile?: string | undefined;
+    /** Group by file */
+    groupByFile?: boolean | undefined;
+    /** Input profile file */
+    input?: string | undefined;
+    /** Minimum execution percentage */
+    minPercent?: number | undefined;
+    /** Number of top functions to show */
+    top?: number | undefined;
+}
+/**
+ * Handle analyze command
+ */
+export declare const handleAnalyzeCommand: (_context: CliContext, options: AnalyzeOptions) => Promise<number>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/cli/commands/analyze.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAoB;AAQ9C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE5B,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IAEZ,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC,oBAAoB;IACpB,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAElC,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,UAAU,EACpB,SAAS,cAAc,KACtB,OAAO,CAAC,MAAM,CA+ChB,CAAC"}

package/dist/cli/commands/analyze.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Analyze Command
+ *
+ * CLI command for analyzing code execution and identifying benchmark
+ * candidates. Uses Node.js V8 profiler to capture function execution data.
+ *
+ * @packageDocumentation
+ */
+import type { CliContext } from "../index.js";
+/**
+ * Analyze command options interface
+ */
+export interface AnalyzeOptions {
+    /** Enable color output */
+    color?: boolean | undefined;
+    /** Command to analyze */
+    command?: string | undefined;
+    /** Working directory */
+    cwd: string;
+    /** Filter by file pattern */
+    filterFile?: string | undefined;
+    /** Group by file */
+    groupByFile?: boolean | undefined;
+    /** Input profile file */
+    input?: string | undefined;
+    /** Minimum execution percentage */
+    minPercent?: number | undefined;
+    /** Number of top functions to show */
+    top?: number | undefined;
+}
+/**
+ * Handle analyze command
+ */
+export declare const handleAnalyzeCommand: (_context: CliContext, options: AnalyzeOptions) => Promise<number>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/cli/commands/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB;AAQ9C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE5B,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IAEZ,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC,oBAAoB;IACpB,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAElC,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,UAAU,EACpB,SAAS,cAAc,KACtB,OAAO,CAAC,MAAM,CA+ChB,CAAC"}

package/dist/cli/commands/analyze.js

@@ -0,0 +1,56 @@
+/**
+ * Analyze Command
+ *
+ * CLI command for analyzing code execution and identifying benchmark
+ * candidates. Uses Node.js V8 profiler to capture function execution data.
+ *
+ * @packageDocumentation
+ */
+import { ProfileHumanReporter } from "../../reporters/profile-human.js";
+import { filterProfile } from "../../services/profiler/profile-filter.js";
+import { parseProfile } from "../../services/profiler/profile-parser.js";
+import { runWithProfiling } from "../../services/profiler/profile-runner.js";
+import { findPackageRoot } from "../../utils/package.js";
+/**
+ * Handle analyze command
+ */
+export const handleAnalyzeCommand = async (_context, options) => {
+    try {
+        const startTime = Date.now();
+        // Run profiling or load existing profile
+        const logPath = options.input
+            ? options.input
+            : await runWithProfiling(options.command, {
+                cwd: options.cwd,
+            });
+        const duration = Date.now() - startTime;
+        // Parse profile data
+        const profileData = await parseProfile(logPath);
+        // Find package root for smart detection
+        const packageRoot = await findPackageRoot(options.cwd);
+        // Apply filtering
+        const config = {
+            focus: options.filterFile ? [options.filterFile] : undefined,
+            groupByFile: options.groupByFile,
+            minExecutionPercent: options.minPercent,
+            smartDetection: true,
+            topN: options.top,
+        };
+        const filtered = filterProfile(profileData, config, packageRoot);
+        // Add command and duration to filtered data
+        filtered.command = options.command;
+        filtered.duration = duration;
+        // Report results
+        const reporter = new ProfileHumanReporter({
+            color: options.color,
+            groupByFile: options.groupByFile,
+        });
+        reporter.report(filtered);
+        return 0;
+    }
+    catch (error) {
+        console.error('Analyze command failed:', error);
+        return 1;
+    }
+};
+//# sourceMappingURL=analyze.js.map

package/dist/cli/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,oBAAoB,EAAE,yCAAyC;AACxE,OAAO,EAAE,aAAa,EAAE,kDAAkD;AAC1E,OAAO,EAAE,YAAY,EAAE,kDAAkD;AACzE,OAAO,EAAE,gBAAgB,EAAE,kDAAkD;AAC7E,OAAO,EAAE,eAAe,EAAE,+BAA+B;AA+BzD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,QAAoB,EACpB,OAAuB,EACN,EAAE;IACnB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,yCAAyC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK;YAC3B,CAAC,CAAC,OAAO,CAAC,KAAK;YACf,CAAC,CAAC,MAAM,gBAAgB,CAAC,OAAO,CAAC,OAAQ,EAAE;gBACvC,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;QAEP,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAExC,qBAAqB;QACrB,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAEhD,wCAAwC;QACxC,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvD,kBAAkB;QAClB,MAAM,MAAM,GAAkB;YAC5B,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5D,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,mBAAmB,EAAE,OAAO,CAAC,UAAU;YACvC,cAAc,EAAE,IAAI;YACpB,IAAI,EAAE,OAAO,CAAC,GAAG;SAClB,CAAC;QAEF,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAEjE,4CAA4C;QAC5C,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACnC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAE7B,iBAAiB;QACjB,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC;YACxC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QAEH,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE1B,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC,CAAC"}