feat: publish FreeRTOS C FC03 card

scripts/check_abi.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env sh
+set -eu
+
+nm=${RISCV_NM:-riscv64-unknown-elf-nm}
+readelf=${RISCV_READELF:-riscv64-unknown-elf-readelf}
+elf=build/task01_scheduler/prog.elf
+
+if "$nm" --defined-only "$elf" | awk '{print $3}' | grep -Eq '^_Z|^__cxa_|^_Unwind_'; then
+  echo "unexpected C++ or unwind symbol in the C teaching ELF" >&2
+  exit 1
+fi
+
+if "$readelf" -S "$elf" | grep -Eq '\.init_array|\.eh_frame|\.gcc_except_table'; then
+  echo "unexpected C++ initialization or unwind section in $elf" >&2
+  "$readelf" -S "$elf" >&2
+  exit 1
+fi
+
+for symbol in peer_task_entry high_probe_task_entry verifier_task_entry \
+  vApplicationTickHook task01_scheduler_checkpoint \
+  task01_scheduler_checkpoint_committed task01_tick_checkpoint_committed \
+  xTaskCreate vTaskPrioritySet uxTaskPriorityGet vTaskDelete; do
+  if ! "$nm" --defined-only "$elf" | grep -Eq "[[:space:]]${symbol}$"; then
+    echo "required C/FreeRTOS symbol is missing: $symbol" >&2
+    exit 1
+  fi
+done
+
+echo "PASS ABI: freestanding C11 scheduler experiment, no C++ runtime"

scripts/check_determinism.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env sh
+set -eu
+
+tb=${1:?usage: check_determinism.sh /path/to/tb [build-dir]}
+build_dir=${2:-build}
+artifact="$build_dir/task01_scheduler/prog.bin"
+reference="$build_dir/determinism-1.log"
+
+run_once() {
+  output=$1
+  "$tb" --bin "$artifact" --cycles 3000000 --cpuret >"$output"
+}
+
+run_once "$reference"
+run_once "$build_dir/determinism-2.log"
+run_once "$build_dir/determinism-3.log"
+cmp "$reference" "$build_dir/determinism-2.log"
+cmp "$reference" "$build_dir/determinism-3.log"
+echo "PASS determinism: three clean Hazard3 processes produced identical evidence"

scripts/render_pdf.sh

@@ -0,0 +1,52 @@
+#!/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/generated/main.tex"
+
+read_tex_command() {
+  sed -n "s/^\\\\newcommand{\\\\$1}{\\([^}]*\\)}$/\\1/p" "$tex_path" | head -n 1
+}
+
+publisher=mpabi
+area=inf
+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
+  git_root=$(git -C "$repo_root" rev-parse --show-toplevel 2>/dev/null || true)
+  if [ "$git_root" = "$repo_root" ]; then
+    commit=$(git -C "$repo_root" rev-parse HEAD)
+  else
+    commit=local
+  fi
+fi
+short_commit=$(printf '%s' "$commit" | cut -c1-12)
+meta="$repo_root/doc/build-meta.tex"
+trap 'rm -f "$meta"' EXIT HUP INT TERM
+printf '\\newcommand{\\BuildCommit}{%s}\n' "$short_commit" > "$meta"
+
+out="$repo_root/doc/pdf"
+mkdir -p "$out"
+find "$out" -maxdepth 1 -type f -name '*.pdf' -delete
+(
+  cd "$repo_root/doc/generated"
+  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,8 @@
+#!/usr/bin/env sh
+set -eu
+
+tb=${1:?usage: run_sim.sh /path/to/tb [build-dir]}
+build_dir=${2:-build}
+
+echo "== task01_scheduler =="
+"$tb" --bin "$build_dir/task01_scheduler/prog.bin" --cycles 3000000 --cpuret