bench: add test helpers and test runner

bench/lib/test_helpers.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# Tiny assertion helpers used by bench/lib/*_test.sh
+
+assert_eq() {
+    local expected="$1" actual="$2" msg="${3:-}"
+    if [ "$expected" != "$actual" ]; then
+        printf 'FAIL %s\n  expected: %q\n  actual:   %q\n' \
+            "${msg:-assert_eq}" "$expected" "$actual" >&2
+        return 1
+    fi
+}
+
+assert_contains() {
+    local needle="$1" haystack="$2" msg="${3:-}"
+    case "$haystack" in
+        *"$needle"*) return 0 ;;
+        *)
+            printf 'FAIL %s\n  needle:   %q\n  haystack: %q\n' \
+                "${msg:-assert_contains}" "$needle" "$haystack" >&2
+            return 1
+            ;;
+    esac
+}
+
+assert_file_exists() {
+    local path="$1" msg="${2:-}"
+    if [ ! -e "$path" ]; then
+        printf 'FAIL %s\n  missing: %s\n' "${msg:-assert_file_exists}" "$path" >&2
+        return 1
+    fi
+}
+
+assert_exit_code() {
+    local expected="$1"; shift
+    local actual=0
+    "$@" >/dev/null 2>&1 || actual=$?
+    if [ "$expected" != "$actual" ]; then
+        printf 'FAIL assert_exit_code\n  expected: %s\n  actual:   %s\n  cmd: %s\n' \
+            "$expected" "$actual" "$*" >&2
+        return 1
+    fi
+}
+
+mktempdir() {
+    mktemp -d "${TMPDIR:-/tmp}/bench-test-XXXXXX"
+}

bench/test.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+pass=0
+fail=0
+failing_files=()
+
+for t in "${SCRIPT_DIR}"/lib/*_test.sh; do
+    [ -e "$t" ] || continue
+    printf '── %s ──\n' "$(basename "$t")"
+    if bash "$t"; then
+        pass=$((pass + 1))
+    else
+        fail=$((fail + 1))
+        failing_files+=("$(basename "$t")")
+    fi
+done
+
+printf '\n=== %d passed, %d failed ===\n' "$pass" "$fail"
+if [ "$fail" -gt 0 ]; then
+    printf 'Failing files:\n'
+    for f in "${failing_files[@]}"; do
+        printf '  %s\n' "$f"
+    done
+    exit 1
+fi