@opensassi/opencode 0.1.0

package/skills/opensassi/scripts/env-check.sh

@@ -0,0 +1,200 @@
+#!/usr/bin/env bash
+# env-check.sh — Bootstrap environment detection for opencode opensassi skill.
+# Detects OS, ensures git, installs Node.js LTS via nvm if needed.
+# Outputs JSON to stdout: {os, distro, version, codename, pkg_manager, shell,
+#                          is_wsl, arch, node_version, nvm_version, git_version}
+#
+# Usage: bash env-check.sh
+# Dependencies: bash, common UNIX utilities (uname, grep, cut, etc.)
+
+set -euo pipefail
+
+# --- OS Detection ---
+OS="$(uname -s)"
+ARCH="$(uname -m)"
+SHELL_NAME="$(basename "${SHELL:-bash}")"
+IS_WSL=false
+
+if grep -qi "microsoft\|wsl" /proc/version 2>/dev/null; then
+    IS_WSL=true
+fi
+
+# Normalize arch
+case "$ARCH" in
+    x86_64|amd64) ARCH="x64" ;;
+    aarch64|arm64) ARCH="arm64" ;;
+esac
+
+# --- Distro Detection ---
+DISTRO=""
+VERSION=""
+CODENAME=""
+PKG_MANAGER=""
+
+detect_linux() {
+    if [ -f /etc/os-release ]; then
+        . /etc/os-release
+        DISTRO="${ID:-linux}"
+        VERSION="${VERSION_ID:-}"
+        CODENAME="${VERSION_CODENAME:-$UBUNTU_CODENAME}"
+    elif [ -f /etc/lsb-release ]; then
+        . /etc/lsb-release
+        DISTRO="${DISTRIB_ID:-linux}"
+        VERSION="${DISTRIB_RELEASE:-}"
+        CODENAME="${DISTRIB_CODENAME:-}"
+    fi
+    DISTRO="$(echo "$DISTRO" | tr '[:upper:]' '[:lower:]')"
+
+    # Detect package manager
+    for pm in apt dnf yum pacman zypper; do
+        if command -v "$pm" &>/dev/null; then
+            PKG_MANAGER="$pm"
+            break
+        fi
+    done
+}
+
+detect_macos() {
+    DISTRO="macos"
+    if command -v sw_vers &>/dev/null; then
+        VERSION="$(sw_vers -productVersion 2>/dev/null || echo "")"
+        case "$VERSION" in
+            15.*) CODENAME="sequoia" ;;
+            14.*) CODENAME="sonoma" ;;
+            13.*) CODENAME="ventura" ;;
+            12.*) CODENAME="monterey" ;;
+            11.*) CODENAME="big-sur" ;;
+            *)    CODENAME="unknown" ;;
+        esac
+    fi
+    if command -v brew &>/dev/null; then
+        PKG_MANAGER="brew"
+    fi
+}
+
+case "$OS" in
+    Linux)
+        detect_linux
+        if $IS_WSL; then
+            # In WSL, use Windows-side detection for pkg_manager hint
+            :
+        fi
+        ;;
+    Darwin)
+        detect_macos
+        ;;
+    MINGW*|MSYS*|CYGWIN*)
+        # Git Bash / MSYS2 on Windows — limited support, point to ps1
+        DISTRO="windows"
+        OS="win32"
+        PKG_MANAGER=""
+        if command -v winget &>/dev/null; then
+            PKG_MANAGER="winget"
+        elif command -v choco &>/dev/null; then
+            PKG_MANAGER="choco"
+        fi
+        ;;
+    *)
+        DISTRO="unknown"
+        ;;
+esac
+
+# --- Ensure git ---
+if ! command -v git &>/dev/null; then
+    echo "[INFO] git not found. Installing..." >&2
+    case "${PKG_MANAGER:-}" in
+        apt)    sudo apt update && sudo apt install -y git ;;
+        dnf)    sudo dnf install -y git ;;
+        yum)    sudo yum install -y git ;;
+        pacman) sudo pacman -Sy --noconfirm git ;;
+        zypper) sudo zypper install -y git ;;
+        brew)   brew install git ;;
+        *)
+            echo "[WARN] Cannot install git automatically. Install git manually." >&2
+            ;;
+    esac
+fi
+GIT_VERSION="$(git --version 2>/dev/null | sed 's/git version //' || echo "")"
+
+# --- Ensure Node.js (LTS via nvm) ---
+NODE_VERSION=""
+NVM_VERSION=""
+
+setup_node() {
+    # Check if node is already at LTS or later
+    if command -v node &>/dev/null; then
+        local current
+        current="$(node --version | sed 's/^v//')"
+        local major
+        major="$(echo "$current" | cut -d. -f1)"
+        # Use node if >= 18 (LTS cutoff)
+        if [ "$major" -ge 18 ] 2>/dev/null; then
+            NODE_VERSION="$current"
+            echo "[INFO] Node.js v$NODE_VERSION already available" >&2
+            return 0
+        fi
+    fi
+
+    # Find or install nvm
+    local nvm_install_dir=""
+    if [ -n "${NVM_DIR:-}" ] && [ -s "$NVM_DIR/nvm.sh" ]; then
+        nvm_install_dir="$NVM_DIR"
+    elif [ -s "$HOME/.nvm/nvm.sh" ]; then
+        nvm_install_dir="$HOME/.nvm"
+    elif [ -s "$HOME/.local/share/nvm/nvm.sh" ]; then
+        nvm_install_dir="$HOME/.local/share/nvm"
+    fi
+
+    if [ -n "$nvm_install_dir" ]; then
+        echo "[INFO] nvm found at $nvm_install_dir" >&2
+        export NVM_DIR="$nvm_install_dir"
+        # shellcheck disable=SC1091
+        [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+        NVM_VERSION="$(nvm --version 2>/dev/null || echo "")"
+    else
+        echo "[INFO] nvm not found. Installing nvm v0.40.0..." >&2
+        export NVM_DIR="$HOME/.nvm"
+        mkdir -p "$NVM_DIR"
+        curl -o- "https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh" | bash 2>/dev/null || {
+            echo "[ERROR] Failed to install nvm. Install manually:" >&2
+            echo "  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash" >&2
+            return 1
+        }
+        # shellcheck disable=SC1091
+        [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+        NVM_VERSION="$(nvm --version 2>/dev/null || echo "")"
+        echo "[INFO] nvm v$NVM_VERSION installed" >&2
+    fi
+
+    # Install LTS node (idempotent — no-op if already present)
+    if [ -n "${NVM_DIR:-}" ] && [ -s "$NVM_DIR/nvm.sh" ]; then
+        echo "[INFO] Installing latest Node.js LTS via nvm..." >&2
+        nvm install --lts 2>/dev/null || true
+        nvm use --lts 2>/dev/null || true
+        # Write .nvmrc for project
+        local project_root
+        project_root="$(git rev-parse --show-toplevel 2>/dev/null || echo ".")"
+        echo "--lts" > "$project_root/.nvmrc" 2>/dev/null || true
+        NODE_VERSION="$(node --version 2>/dev/null | sed 's/^v//' || echo "")"
+        echo "[INFO] Node.js v$NODE_VERSION (LTS) ready via nvm" >&2
+    fi
+}
+
+setup_node || true
+
+# --- Output JSON ---
+cat <<JSONEOF
+{
+  "os": "$OS",
+  "distro": "$DISTRO",
+  "version": "$VERSION",
+  "codename": "$CODENAME",
+  "pkg_manager": "$PKG_MANAGER",
+  "shell": "$SHELL_NAME",
+  "is_wsl": $IS_WSL,
+  "arch": "$ARCH",
+  "node_version": "$NODE_VERSION",
+  "nvm_version": "$NVM_VERSION",
+  "git_version": "$GIT_VERSION"
+}
+JSONEOF

package/skills/opensassi/scripts/install-flamegraph.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# install-flamegraph.sh — Clone Brendan Gregg's FlameGraph at pinned tag v1.0.
+# Idempotent: updates existing clone if present.
+# Usage: bash install-flamegraph.sh
+
+set -euo pipefail
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || (cd "$(dirname "$0")/../../.." && pwd))"
+FLAMEGRAPH_DIR="$PROJECT_ROOT/scripts/FlameGraph"
+
+if [ -d "$FLAMEGRAPH_DIR/.git" ]; then
+    echo "[INFO] FlameGraph already cloned. Updating to v1.0..."
+    git -C "$FLAMEGRAPH_DIR" fetch --tags --depth=1 2>&1 | tail -1
+    git -C "$FLAMEGRAPH_DIR" checkout v1.0 2>&1 || {
+        echo "[WARN] Could not checkout v1.0; resetting to tag..."
+        git -C "$FLAMEGRAPH_DIR" reset --hard v1.0 2>&1
+    }
+else
+    echo "[INFO] Cloning FlameGraph v1.0 to $FLAMEGRAPH_DIR..."
+    git clone --depth=1 --branch v1.0 https://github.com/brendangregg/FlameGraph.git "$FLAMEGRAPH_DIR" 2>&1 || {
+        echo "[ERROR] Failed to clone FlameGraph. Clone manually:"
+        echo "  git clone --depth=1 --branch v1.0 https://github.com/brendangregg/FlameGraph.git $FLAMEGRAPH_DIR"
+        exit 1
+    }
+fi
+
+if [ -f "$FLAMEGRAPH_DIR/flamegraph.pl" ]; then
+    echo "[INFO] FlameGraph ready: $FLAMEGRAPH_DIR"
+else
+    echo "[WARN] FlameGraph clone may be incomplete — flamegraph.pl not found."
+    ls "$FLAMEGRAPH_DIR" | head -10
+fi

package/skills/opensassi/scripts/install-npm-deps.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# install-npm-deps.sh — Install npm dependencies for the opencode project.
+# Usage: bash install-npm-deps.sh
+
+set -euo pipefail
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || (cd "$(dirname "$0")/../../.." && pwd))"
+
+if ! command -v node &>/dev/null; then
+    echo "[ERROR] Node.js not found. Run env-check.sh first."
+    exit 1
+fi
+
+if [ ! -f "$PROJECT_ROOT/package.json" ]; then
+    echo "[WARN] No package.json found at $PROJECT_ROOT — skipping npm install"
+    exit 0
+fi
+
+echo "[INFO] Installing npm dependencies..."
+cd "$PROJECT_ROOT"
+npm install 2>&1 | tail -5 || {
+    echo "[ERROR] npm install failed"
+    exit 1
+}
+echo "[INFO] npm dependencies installed"

package/skills/profiler/SKILL.md

@@ -0,0 +1,213 @@
+---
+name: profiler
+description: Profiling, flamegraph generation, and benchmarking using Linux perf
+---
+
+# Interactive Profiler Agent Prompt
+
+## Persona
+
+You are a **senior performance engineer** with deep expertise in Linux perf, CPU profiling, SIMD optimization (SSE4.1, ARM Neon/SVE/SVE2).  
+Your role is to help users profile their software, generate flamegraphs, run benchmarks with quality regression detection, and target optimization efforts.
+
+You always work **interactively** — propose a profiling plan, run tools, analyze results, and only proceed to deeper investigation when the user agrees.
+
+---
+
+## Response Guidelines
+
+When activated:
+
+1. **Check environment** — Run `check` to verify: `perf` available, Release binary exists, benchmark data at `test/data/`, FlameGraph scripts at `scripts/FlameGraph/`, quality metric tooling if needed.
+2. **Report status** — Output a summary of what's available and what's missing. Do not initiate a profiling session without user direction.
+3. **Propose first steps** — Suggest running a baseline `profile` or `benchmark` depending on the user's goal.
+
+---
+
+## Commands
+
+### `check`
+
+Verify the profiling toolchain. Runs the following checks and reports pass/fail:
+
+- `perf` is installed and accessible
+- Encoder Release binary exists (check `bin/release-static/` or build tree)
+- `test/data/` contains benchmark input data
+- `scripts/FlameGraph/stackcollapse-perf.pl` and `flamegraph.pl` exist (clone via opensassi skill if missing)
+- `ffmpeg` available (needed for `--vmaf`)
+- `vmaf` tool available (needed for `--vmaf`)
+- `.profiler/` output directory exists
+
+Saves a brief report to `.profiler/check.json`.
+
+### `setup`
+
+Download and prepare test data for profiling.
+
+Usage:
+```
+setup                        # default: download/prompt for test data
+setup --frames 50            # override frame count
+setup --resize 1280x720      # produce resized variant via ffmpeg
+```
+
+What it does:
+1. Downloads or prepares test input data (configurable for your domain)
+ 3. If `--resize` given, runs `ffmpeg` to produce resized variants
+ 4. Creates `.profiler/` directory structure: `flamegraphs/`, `benchmarks/`, `perf_archives/`, `reports/`
+ 5. Creates `.gitignore` entries for test data and `.profiler/` if not present
+  6. Checks that `scripts/FlameGraph/` exists; if not, runs the opensassi skill to clone it
+
+Example output files (video encoder project):
+```
+test/data/input_1080p10.yuv        (full-res source, 10 frames)
+test/data/input_1280x720f10.yuv     (default profile resolution)
+test/data/input_832x480f10.yuv      (--resize 832x480)
+```
+
+### `profile`
+
+Run `perf record` on your program and produce a flamegraph.
+
+Usage:
+```
+profile                               # default: test data, default config, cycles
+profile --events cache-misses,branch-misses  # custom perf events
+profile --frames 50                   # override frame count
+```
+
+What it does:
+1. Runs: `perf record --call-graph fp -e cycles,cache-misses,branch-misses -o <file> -- <program> <args>`
+2. Generates folded stack: `perf script -i perf.data | stackcollapse-perf.pl > folded.txt`
+3. Generates flamegraph: `flamegraph.pl folded.txt > flame.svg`
+4. Collects hardware counter summary: `perf stat -e cycles,cache-misses,branch-misses -- <program> <args> > perf.stat 2>&1`
+5. Saves all to `.profiler/perf_archives/{label}/`
+
+Output artifacts:
+```
+.profiler/perf_archives/<label>/
+├── perf.data          (raw, for LLM/tooling analysis)
+├── perf.stat          (hardware counter summary)
+├── folded.txt         (collapsed stacks for diffing)
+├── flame.svg          (interactive flamegraph)
+└── meta.json          (program config, args, version)
+```
+
+### `benchmark`
+
+Run N iterations of the program with performance metric collection.
+
+Usage:
+```
+benchmark                             # default: 5 iterations
+benchmark --iter 10                   # 10 iterations
+```
+
+Output:
+```
+.profiler/benchmarks/benchmark-{timestamp}.json
+```
+
+JSON structure:
+```json
+{
+  "label": "benchmark-label",
+  "timestamp": "...",
+  "iterations": [
+    {
+      "iter": 1,
+      "wall_time_ms": 45230,
+      "metric_1": 38.42,
+      "metric_2": 44.15
+    }
+  ],
+  "summary": {
+    "time_avg_ms": 44987,
+    "time_min_ms": 44123,
+    "time_max_ms": 46234
+  },
+  "config": {
+    "source": "test/data/input.yuv",
+    "frames": 50,
+    "metrics": ["metric_1"]
+  }
+}
+```
+
+### `compare`
+
+Compare two benchmark runs side-by-side.
+
+Usage:
+```
+compare <baseline.json> <candidate.json>
+```
+
+Output:
+```
+=== Comparison: baseline vs candidate ===
+Metric           Baseline    Candidate   Δ%         Status
+──────────────────────────────────────────────────────────
+Wall time (ms)   44987       41230       -8.35%     ✓
+Throughput       1.112       1.213       +9.08%     ✓
+Quality          38.41       38.38       -0.08%     ⚠ below threshold
+
+Regression thresholds:
+  Δ time > +2% AND Δ quality < -0.1  → REGRESSION flag
+  Status: PASS (no regression detected)
+```
+
+A regression is flagged when both conditions are met:
+- Wall-clock time increases by more than the threshold (default +2%)
+- Any quality metric drops below its threshold
+
+These thresholds are configurable in `common.sh`.
+
+### `report`
+
+Bundle a profiling session into a report.
+
+Usage:
+```
+report                                 # bundle most recent profile + benchmark
+report --profile <label>               # specific profile archive
+report --benchmark <file>              # specific benchmark JSON
+```
+
+Produces:
+```
+.profiler/reports/report-{timestamp}/
+├── flame.svg
+├── benchmark-table.txt
+├── perf-summary.txt
+├── system-info.txt     (uname, cpuinfo, perf version, encoder version)
+└── meta.json
+```
+
+---
+
+## Design Principles
+
+- **Default workload**: configurable in `common.sh`
+- **Resized input variants** via `setup --resize WxH` for fast iteration
+- **Release build only** (ensure `-fno-omit-frame-pointer` is enabled for meaningful flamegraphs)
+- **5 iterations minimum** for benchmark; raw `perf.data` retained for LLM analysis
+- **FlameGraph scripts** at `scripts/FlameGraph/` (cloned by opensassi skill from Brendan Gregg's repo)
+- **Input data**: `test/data/` (gitignored, downloaded by setup)
+- **Output artifacts**: `.profiler/` (hidden dir, gitignored)
+- **Read-only on source code** — never modifies source or build files
+- **perf events**: `cycles,cache-misses,branch-misses` default; extend via `--events`
+
+---
+
+## Support Scripts
+
+Support scripts live in the `@opensassi/opencode` package. Run them via `npx @opensassi/opencode run --skill profiler <name>`:
+
+| Script | Purpose |
+|---|---|
+| `common.sh` | Shared config, paths, defaults, threshold constants |
+| `setup.sh` | Download test data, --resize/--frames, FlameGraph clone, gitignore |
+| `profile.sh` | perf record → flamegraph pipeline |
+| `benchmark.sh` | Iteration loop, metric collection, JSON output |
+| `compare.sh` | Two JSON input, Δ% table, regression detection |

package/skills/profiler/scripts/benchmark.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# Benchmark: run N iterations of your program with timing.
+# Usage: ./benchmark.sh [--iter N]
+
+source "$(dirname "$0")/common.sh"
+
+# --- Parse args ---
+ITERATIONS=$DEFAULT_ITERATIONS
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --iter)   shift; ITERATIONS="$1" ;;
+        *) log_error "Unknown option: $1"; exit 1 ;;
+    esac
+    shift
+done
+
+PROGRAM="$(find_program)"
+if [[ -z "$PROGRAM" ]]; then
+    log_error "Program binary not found."
+    exit 1
+fi
+
+# --- Iteration loop ---
+RESULTS_FILE="$OUTPUT_DIR/benchmarks/benchmark-$(timestamp).json"
+
+declare -a ITER_DATA
+for ((i=1; i<=ITERATIONS; i++)); do
+    log_info "Iteration $i / $ITERATIONS ..."
+
+    START_MS=$(date +%s%3N)
+    "$PROGRAM" 2>&1 | tee "$OUTPUT_DIR/benchmarks/iter_${i}.log"
+    END_MS=$(date +%s%3N)
+    WALL_MS=$((END_MS - START_MS))
+
+    ITEM=$(cat <<ITEMEOF
+    {
+      "iter": $i,
+      "wall_time_ms": $WALL_MS
+    }
+ITEMEOF
+)
+    ITER_DATA+=("$ITEM")
+done
+
+# --- Build JSON ---
+JSON=$(cat <<JSONEOF
+{
+  "label": "benchmark-$(timestamp)",
+  "timestamp": "$(timestamp)",
+  "iterations": [
+    $(IFS=,; echo "${ITER_DATA[*]}")
+  ],
+  "config": {
+    "program": "$PROGRAM",
+    "iterations": $ITERATIONS
+  }
+}
+JSONEOF
+)
+
+echo "$JSON" > "$RESULTS_FILE"
+log_info "Benchmark saved: $RESULTS_FILE"

package/skills/profiler/scripts/common.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# Common configuration and paths for the profiler skill.
+# Source this from other scripts: source "$(dirname "$0")/common.sh"
+
+set -euo pipefail
+
+# --- Paths ---
+PROJECT_ROOT="$(cd "$(dirname "$0")/../../../../" && pwd)"
+SCRIPTS_DIR="$PROJECT_ROOT/.opencode/skills/profiler/scripts"
+OUTPUT_DIR="$PROJECT_ROOT/.profiler"
+DATA_DIR="$PROJECT_ROOT/test/data"
+FLAMEGRAPH_DIR="$PROJECT_ROOT/scripts/FlameGraph"
+
+# --- Default workload (customize for your project) ---
+DEFAULT_INPUT="input"
+DEFAULT_RESOLUTION="1280x720"
+DEFAULT_FRAMES=10
+DEFAULT_CONFIG="default"
+
+# --- Benchmark defaults ---
+DEFAULT_ITERATIONS=5
+
+# --- Regression thresholds ---
+THRESHOLD_TIME_PCT=2.0
+THRESHOLD_QUALITY=0.1
+
+# --- perf defaults ---
+PERF_EVENTS_DEFAULT="cycles,cache-misses,branch-misses"
+
+# --- Binary discovery (customize for your project) ---
+find_program() {
+    local paths=(
+        "$PROJECT_ROOT/bin/release/program"
+        "$PROJECT_ROOT/build/program"
+        "$PROJECT_ROOT/program"
+    )
+    for p in "${paths[@]}"; do
+        if [[ -x "$p" ]]; then
+            echo "$p"
+            return 0
+        fi
+    done
+    echo ""
+    return 1
+}
+
+# --- Timestamp ---
+timestamp() {
+    date +%Y%m%dT%H%M%S
+}
+
+# --- Logging ---
+log_info()  { echo "[INFO]  $*"; }
+log_warn()  { echo "[WARN]  $*" >&2; }
+log_error() { echo "[ERROR] $*" >&2; }

package/skills/profiler/scripts/compare.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# Compare two benchmark JSON files, output Δ% table with regression detection.
+# Usage: ./compare.sh <baseline.json> <candidate.json>
+
+source "$(dirname "$0")/common.sh"
+
+if [[ $# -ne 2 ]]; then
+    log_error "Usage: $0 <baseline.json> <candidate.json>"
+    exit 1
+fi
+
+BASELINE="$1"
+CANDIDATE="$2"
+
+if [[ ! -f "$BASELINE" ]]; then log_error "Baseline not found: $BASELINE"; exit 1; fi
+if [[ ! -f "$CANDIDATE" ]]; then log_error "Candidate not found: $CANDIDATE"; exit 1; fi
+
+python3 -c "
+import json, sys
+
+with open('$BASELINE') as f: b = json.load(f)
+with open('$CANDIDATE') as f: c = json.load(f)
+
+def avg(items, key):
+    vals = [i.get(key) for i in items if i.get(key) is not None]
+    if not vals:
+        return None
+    return sum(vals) / len(vals)
+
+def pct(b_val, c_val):
+    if b_val is None or c_val is None or b_val == 0:
+        return None
+    return ((c_val - b_val) / b_val) * 100
+
+b_t = avg(b['iterations'], 'wall_time_ms')
+c_t = avg(c['iterations'], 'wall_time_ms')
+
+print(f\"{'Metric':<25} {'Baseline':<14} {'Candidate':<14} {'Δ%':<10} {'Status'}\")
+print(f\"{'-'*25} {'-'*14} {'-'*14} {'-'*10} {'-'*10}\")
+
+def fmt(v, unit=''):
+    if v is None: return 'N/A'
+    return f'{v:.2f}{unit}'
+
+regression = False
+
+# Wall time: negative Δ% = good (faster)
+dt = pct(b_t, c_t)
+status = '✓' if dt is not None and dt < $THRESHOLD_TIME_PCT else ''
+if dt is not None and dt >= $THRESHOLD_TIME_PCT:
+    status = '⚠ REGRESSION'
+    regression = True
+print(f\"{'Wall time (ms)':<25} {fmt(b_t):<14} {fmt(c_t):<14} {fmt(dt, '%'):<10} {status}\")
+
+print()
+if regression:
+    print('⚠  REGRESSION DETECTED: time exceeded threshold.')
+else:
+    print('✓  PASS: no regression detected.')
+" 2>&1 || {
+    log_error "Comparison failed. Ensure both files are valid benchmark JSON."
+    exit 1
+}