はじめに

Sounio プログラムは souc で check、run、build される .sio ファイルです。現在の公開導線は、チェックイン済みのコンパイラ artifact から始まり、souc check で検証し、リポジトリの gate と fixture を「現時点で実際に何がサポートされているか」の情報源として扱います。

本日時点で確認済み

• ドキュメント上最も安全なエントリポイントは、$(pwd)/bin/souc にある規範的なランチャー（canonical launcher）です。
• 最初に信頼すべきは run ではなく check です。実行パスはホスト artifact と backend サポートによって変わるためです。
• このプロジェクトには異なるものを指す 2 つのバージョン番号があります。2.1.0 は言語のリリース（README バッジ、CITATION.cff、CHANGELOG.md）、bin/souc --version はツールチェーンのバージョンを表示します（例: 3.0.0-rc.1 (madaros <build>)、既定エンジン Madaros）。2.0 以前の古い beta バージョン文字列は廃止されています。
• stdlib のエンドツーエンド: 533 件のテストプログラムのうち 196 件が合格（165 件が失敗、172 件がスキップ）、2026-10-06 に bash scripts/stdlib/run_stdlib_e2e.sh で計測。結果は artifacts/stdlib/stdlib_e2e_result.v1.json にあります。
• コンパイラの対象は Linux x86-64 のみで、静的 ELF を出力します。Cranelift JIT はもう出荷されていません（CHANGELOG 2.1.0）。souc build --backend gpu は名前付きカーネルパターンの骨組みに対して PTX を出力するだけで、汎用 GPU バックエンドではありません。WASM バックエンドはブロック中のドラフトです（#2237）。TOUR.md §6 を参照してください。
• SOUNIO_STDLIB_PATH をチェックイン済みの stdlib/ に向けてください。
• run や build の前に、まず souc check を使ってください。

現在の注意点

• 実際の挙動は、リポジトリ上のファイルだけではなく、使用している souc バイナリそのものに依存します。
• トップレベルの Cargo ビルドは、公開ドキュメント向けの最初の導線としてはもはや最適ではありません。

このリポジトリで確認する

export SOUC_BIN="$(pwd)/bin/souc"
export SOUNIO_STDLIB_PATH="$(pwd)/stdlib"

"$SOUC_BIN" --version
"$SOUC_BIN" check examples/hello.sio
# Not re-run on 2026-10-15.
# "$SOUC_BIN" check tests/run-pass/covid_2020_kernel.sio
# "$SOUC_BIN" check tests/run-pass/vancomycin_propagation.sio
# "$SOUC_BIN" check tests/compile-fail/vancomycin_low_conf.sio