feat: add lab-rv32i-freertos-mutex card

scripts/check_abi.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env sh
+set -eu
+nm=${RISCV_NM:-riscv64-unknown-elf-nm}
+readelf=${RISCV_READELF:-riscv64-unknown-elf-readelf}
+elf=build/task01_mutex/prog.elf
+if "$nm" -C -u "$elf" | grep -Eq '__cxa_|_Unwind_|std::|libstdc\+\+'; then echo "hosted C++ runtime dependency" >&2; exit 1; fi
+if "$nm" -C --defined-only "$elf" | grep -Eq 'vtable for|typeinfo for|typeinfo name for'; then echo "virtual/RTTI metadata" >&2; exit 1; fi
+if "$readelf" -S "$elf" | grep -Eq '\.init_array|\.eh_frame|\.gcc_except_table'; then echo "initializer/exception/unwind section" >&2; exit 1; fi
+for symbol in mutex_debug_checkpoint g_low_inherited_priority g_owner_low g_mutex_pass; do
+  if ! "$nm" --defined-only "$elf" | grep -Fq "$symbol"; then echo "missing evidence: $symbol" >&2; exit 1; fi
+done
+if ! "$nm" -C --defined-only "$elf" | grep -E '[[:space:]][bB][[:space:]].*g_mutex_storage' >/dev/null; then
+  echo "static mutex storage is not in .bss" >&2; exit 1
+fi
+echo "PASS ABI: static mutex storage in .bss; no vtable/runtime/init array"

scripts/render_pdf.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env sh
+set -eu
+script_dir=$(CDPATH= cd "$(dirname "$0")" && pwd); repo_root=$(CDPATH= cd "$script_dir/.." && pwd); tex_path="$repo_root/doc/main.tex"
+read_tex_command() { sed -n "s/^\\\\newcommand{\\\\$1}{\\([^}]*\\)}$/\\1/p" "$tex_path" | head -n 1; }
+publisher=$(read_tex_command PublisherDomain); area=$(read_tex_command CardArea); series=$(read_tex_command CardSeries); number=$(read_tex_command CardNumber); slug=$(read_tex_command CardSlug); version=$(read_tex_command CardVersion); uuid=$(read_tex_command DocumentUUID)
+if [ -z "$publisher" ] || [ -z "$area" ] || [ -z "$series" ] || [ -z "$number" ] || [ -z "$slug" ] || [ -z "$version" ] || [ -z "$uuid" ]; then echo "missing card metadata in $tex_path" >&2; exit 1; fi
+commit=${GITEA_SHA:-${GITHUB_SHA:-}}; if [ -z "$commit" ]; then commit=$(git -C "$repo_root" rev-parse HEAD 2>/dev/null || printf '%s' uncommitted); fi
+meta="$repo_root/doc/build-meta.tex"; trap 'rm -f "$meta"' EXIT HUP INT TERM; printf '\\newcommand{\\BuildCommit}{%s}\n' "$(printf '%s' "$commit" | cut -c1-12)" > "$meta"
+out="$repo_root/doc/pdf"; mkdir -p "$out"; ( cd "$repo_root/doc" && latexmk -pdf -interaction=nonstopmode -halt-on-error -outdir="$out" main.tex )
+target="$out/$publisher-$area-$series-$number-$slug-$version-$uuid.pdf"; mv "$out/main.pdf" "$target"
+find "$out" -maxdepth 1 -type f \( -name '*.aux' -o -name '*.log' -o -name '*.out' -o -name '*.fls' -o -name '*.fdb_latexmk' \) -delete
+printf '%s\n' "$target"

scripts/run_sim.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+set -eu
+tb=${1:?usage: run_sim.sh /path/to/tb [build-dir]}
+build_dir=${2:-build}
+echo "== task01_mutex =="
+"$tb" --bin "$build_dir/task01_mutex/prog.bin" --cycles 1000000 --cpuret

scripts/test_host.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env sh
+set -eu
+cxx=${CXX_HOST:-c++}
+build_dir=${1:-host-build}
+mkdir -p "$build_dir"
+$cxx -std=c++17 -Wall -Wextra -Werror -pedantic \
+  -fsanitize=address,undefined -fno-omit-frame-pointer \
+  -Itests/host-shim -Iinclude tests/mutex_host.cpp -o "$build_dir/mutex_host"
+ASAN_OPTIONS=detect_leaks=1 "$build_dir/mutex_host"
+echo "PASS host: LockGuard balances three returns and rejects recursive take"