hakmem/scripts/run_larson_claude.sh

#!/usr/bin/env bash
set -euo pipefail

# Claude Code quick runner for Larson + Tiny (with reproducible env presets)
# Usage:
#   scripts/run_larson_claude.sh [tput|pf|repro|fast0|guard|debug|asan|ubsan|tsan] [DUR] [THREADS]
# Examples:
#   scripts/run_larson_claude.sh tput 2 4
#   scripts/run_larson_claude.sh repro 2 4     # FAST_CAP=0 + TraceRing
#   scripts/run_larson_claude.sh fast0 2 4     # repro + front bypass
#   scripts/run_larson_claude.sh guard 2 4     # repro + remote guard
#   scripts/run_larson_claude.sh debug 10 4    # repro + periodic SIGUSR2 dumps

MODE=${1:-tput}
DUR=${2:-2}
THREADS=${3:-4}

ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")"/.. && pwd)"
cd "$ROOT_DIR"

# Ensure build (honor 3-layer/route build knobs)
# HAKMEM_BUILD_3LAYER=1    → make larson_hakmem_3layer
# HAKMEM_BUILD_ROUTE=1      → make larson_hakmem_route (implies 3-layer)
if [[ "${HAKMEM_BUILD_ROUTE:-0}" == "1" ]]; then
  make -s larson_hakmem_route >/dev/null
elif [[ "${HAKMEM_BUILD_3LAYER:-0}" == "1" ]]; then
  make -s larson_hakmem_3layer >/dev/null
else
  [[ -x ./larson_hakmem ]] || make -s larson_hakmem >/dev/null
fi

# Common Tiny + Larson envs
export HAKMEM_LARSON_TINY_ONLY=1
export HAKMEM_LARSON=1
export HAKMEM_WRAP_TINY=${HAKMEM_WRAP_TINY:-1}
export HAKMEM_DISABLE_BATCH=1
export HAKMEM_TINY_META_ALLOC=1
export HAKMEM_TINY_META_FREE=1
export HAKMEM_TINY_USE_SUPERSLAB=1
export HAKMEM_TINY_MAILBOX_SLOWDISC=1
export HAKMEM_TINY_MAILBOX_SLOWDISC_PERIOD=256

# Defaults used by all modes unless overridden below
export HAKMEM_TINY_FAST_CAP=${HAKMEM_TINY_FAST_CAP:-64}
export HAKMEM_TINY_FAST_SPARE_PERIOD=${HAKMEM_TINY_FAST_SPARE_PERIOD:-8}
export HAKMEM_TINY_TLS_LIST=${HAKMEM_TINY_TLS_LIST:-1}

# Fixed Larson args used across scripts (set early for set -u safety)
MIN=8; MAX=128; CHUNKS=1024; ROUNDS=1; SEED=12345

case "$MODE" in
  tput)
    export HAKMEM_TINY_SS_FORCE_LG=${HAKMEM_TINY_SS_FORCE_LG:-21}
    export HAKMEM_TINY_SS_CACHE=${HAKMEM_TINY_SS_CACHE:-0}
    export HAKMEM_TINY_SS_PRECHARGE=${HAKMEM_TINY_SS_PRECHARGE:-0}
    # Opportunistic background remote drain (lightweight)
    export HAKMEM_TINY_BG_REMOTE=${HAKMEM_TINY_BG_REMOTE:-1}
    export HAKMEM_TINY_BG_REMOTE_TRYRATE=${HAKMEM_TINY_BG_REMOTE_TRYRATE:-16}
    export HAKMEM_TINY_BG_REMOTE_BUDGET=${HAKMEM_TINY_BG_REMOTE_BUDGET:-2}
    ;;
  pf)
    export HAKMEM_TINY_SS_FORCE_LG=${HAKMEM_TINY_SS_FORCE_LG:-20}
    export HAKMEM_TINY_SS_CACHE=${HAKMEM_TINY_SS_CACHE:-4}
    export HAKMEM_TINY_SS_PRECHARGE=${HAKMEM_TINY_SS_PRECHARGE:-1}
    export HAKMEM_TINY_BG_REMOTE=${HAKMEM_TINY_BG_REMOTE:-1}
    export HAKMEM_TINY_BG_REMOTE_TRYRATE=${HAKMEM_TINY_BG_REMOTE_TRYRATE:-8}
    export HAKMEM_TINY_BG_REMOTE_BUDGET=${HAKMEM_TINY_BG_REMOTE_BUDGET:-4}
    ;;
  repro)
    export HAKMEM_TINY_SS_FORCE_LG=${HAKMEM_TINY_SS_FORCE_LG:-21}
    export HAKMEM_TINY_FAST_CAP=0
    export HAKMEM_TINY_TRACE_RING=1
    export HAKMEM_TINY_RF_TRACE=${HAKMEM_TINY_RF_TRACE:-1}
    export HAKMEM_TINY_SS_ADOPT=1
    # Force notify to surface publish even if slab_listed was missed
    export HAKMEM_TINY_RF_FORCE_NOTIFY=${HAKMEM_TINY_RF_FORCE_NOTIFY:-1}
    export HAKMEM_TINY_BG_REMOTE=${HAKMEM_TINY_BG_REMOTE:-1}
    export HAKMEM_TINY_BG_REMOTE_TRYRATE=${HAKMEM_TINY_BG_REMOTE_TRYRATE:-4}
    export HAKMEM_TINY_BG_REMOTE_BUDGET=${HAKMEM_TINY_BG_REMOTE_BUDGET:-2}
    ;;
  fast0)
    export HAKMEM_TINY_SS_FORCE_LG=${HAKMEM_TINY_SS_FORCE_LG:-21}
    export HAKMEM_TINY_FAST_CAP=0
    export HAKMEM_TINY_TRACE_RING=1
    export HAKMEM_TINY_RF_TRACE=${HAKMEM_TINY_RF_TRACE:-1}
    export HAKMEM_TINY_DEBUG_FAST0=1
    export HAKMEM_TINY_SS_ADOPT=1
    export HAKMEM_TINY_RF_FORCE_NOTIFY=${HAKMEM_TINY_RF_FORCE_NOTIFY:-1}
    export HAKMEM_TINY_BG_REMOTE=${HAKMEM_TINY_BG_REMOTE:-1}
    export HAKMEM_TINY_BG_REMOTE_TRYRATE=${HAKMEM_TINY_BG_REMOTE_TRYRATE:-4}
    export HAKMEM_TINY_BG_REMOTE_BUDGET=${HAKMEM_TINY_BG_REMOTE_BUDGET:-2}
    ;;
  guard)
    export HAKMEM_TINY_SS_FORCE_LG=${HAKMEM_TINY_SS_FORCE_LG:-21}
    export HAKMEM_TINY_FAST_CAP=0
    export HAKMEM_TINY_TRACE_RING=1
    export HAKMEM_TINY_RF_TRACE=${HAKMEM_TINY_RF_TRACE:-1}
    export HAKMEM_TINY_DEBUG_REMOTE_GUARD=1
    export HAKMEM_TINY_FORCE_REMOTE=1
    export HAKMEM_TINY_SS_ADOPT=1
    export HAKMEM_TINY_RF_FORCE_NOTIFY=${HAKMEM_TINY_RF_FORCE_NOTIFY:-1}
    export HAKMEM_SAFE_FREE=${HAKMEM_SAFE_FREE:-1}
    export HAKMEM_SAFE_FREE_STRICT=${HAKMEM_SAFE_FREE_STRICT:-1}
    export HAKMEM_TINY_BG_REMOTE=${HAKMEM_TINY_BG_REMOTE:-1}
    export HAKMEM_TINY_BG_REMOTE_TRYRATE=${HAKMEM_TINY_BG_REMOTE_TRYRATE:-4}
    export HAKMEM_TINY_BG_REMOTE_BUDGET=${HAKMEM_TINY_BG_REMOTE_BUDGET:-2}
    ;;
  debug)
    export HAKMEM_TINY_SS_FORCE_LG=${HAKMEM_TINY_SS_FORCE_LG:-21}
    export HAKMEM_TINY_FAST_CAP=0
    export HAKMEM_TINY_TRACE_RING=1
    export HAKMEM_TINY_RF_TRACE=${HAKMEM_TINY_RF_TRACE:-1}
    export HAKMEM_TINY_SS_ADOPT=1
    export HAKMEM_TINY_RF_FORCE_NOTIFY=${HAKMEM_TINY_RF_FORCE_NOTIFY:-1}
    export HAKMEM_SAFE_FREE=${HAKMEM_SAFE_FREE:-1}
    export HAKMEM_SAFE_FREE_STRICT=${HAKMEM_SAFE_FREE_STRICT:-1}
    export HAKMEM_TINY_BG_REMOTE=${HAKMEM_TINY_BG_REMOTE:-1}
    export HAKMEM_TINY_BG_REMOTE_TRYRATE=${HAKMEM_TINY_BG_REMOTE_TRYRATE:-4}
    export HAKMEM_TINY_BG_REMOTE_BUDGET=${HAKMEM_TINY_BG_REMOTE_BUDGET:-2}
    ;;
  asan)
    make -s asan-larson >/dev/null || exit 1
    export HAKMEM_TINY_SS_FORCE_LG=${HAKMEM_TINY_SS_FORCE_LG:-21}
    export HAKMEM_TINY_FAST_CAP=0
    export HAKMEM_TINY_TRACE_RING=1
    export HAKMEM_TINY_RF_TRACE=${HAKMEM_TINY_RF_TRACE:-0}
    export HAKMEM_TINY_SS_ADOPT=1
    export HAKMEM_TINY_RF_FORCE_NOTIFY=${HAKMEM_TINY_RF_FORCE_NOTIFY:-1}
    export HAKMEM_SAFE_FREE=${HAKMEM_SAFE_FREE:-1}
    export HAKMEM_SAFE_FREE_STRICT=${HAKMEM_SAFE_FREE_STRICT:-1}
    ASAN_OPTIONS="abort_on_error=1,detect_leaks=0,verify_asan_link_order=0,detect_stack_use_after_return=1,fast_unwind_on_malloc=0" \
      UBSAN_OPTIONS="print_stacktrace=1" \
      ./larson_hakmem_asan "$DUR" "$MIN" "$MAX" "$CHUNKS" "$ROUNDS" "$SEED" "$THREADS"
    exit 0
    ;;
  ubsan)
    make -s ubsan-larson >/dev/null || exit 1
    UBSAN_OPTIONS="print_stacktrace=1" ./larson_hakmem_ubsan "$DUR" "$MIN" "$MAX" "$CHUNKS" "$ROUNDS" "$SEED" "$THREADS"
    exit 0
    ;;
  tsan)
    make -s tsan-larson >/dev/null || exit 1
    TSAN_OPTIONS="history_size=7,halt_on_error=1" ./larson_hakmem_tsan "$DUR" "$MIN" "$MAX" "$CHUNKS" "$ROUNDS" "$SEED" "$THREADS"
    exit 0
    ;;
  *)
    echo "Unknown mode: $MODE" >&2; exit 1;
    ;;
esac

echo "[Claude Runner] mode=$MODE dur=$DUR threads=$THREADS"
echo "[Claude Runner] SS_LG=$HAKMEM_TINY_SS_FORCE_LG FAST_CAP=$HAKMEM_TINY_FAST_CAP FAST0=${HAKMEM_TINY_DEBUG_FAST0:-0} GUARD=${HAKMEM_TINY_DEBUG_REMOTE_GUARD:-0} TRACE_RING=${HAKMEM_TINY_TRACE_RING:-0}"

if [[ "$MODE" == "debug" ]]; then
  # Run in background and poke SIGUSR2 a few times
  ./larson_hakmem "$DUR" "$MIN" "$MAX" "$CHUNKS" "$ROUNDS" "$SEED" "$THREADS" > /tmp/larson_dbg.out 2> /tmp/larson_dbg.err &
  pid=$!
  sleep 0.08; kill -USR2 $pid || true
  sleep 0.08; kill -USR2 $pid || true
  sleep 0.08; kill -USR2 $pid || true
  wait $pid || true
  echo "--- stderr (tail) ---"; tail -n 120 /tmp/larson_dbg.err || true
  echo "--- stdout (tail) ---"; tail -n 40 /tmp/larson_dbg.out || true
else
  ./larson_hakmem "$DUR" "$MIN" "$MAX" "$CHUNKS" "$ROUNDS" "$SEED" "$THREADS"
fi