## 修正内容 1. **hako_check.sh/run_tests.sh**: NYASH_DISABLE_PLUGINS=1 + NYASH_BOX_FACTORY_POLICY=builtin_first追加 2. **src/box_factory/plugin.rs**: NYASH_DISABLE_PLUGINS=1チェック追加 3. **src/box_factory/mod.rs**: plugin shortcut pathでNYASH_DISABLE_PLUGINS尊重 4. **tools/hako_check/render/graphviz.hako**: smart quotes修正(parse error解消) ## 根本原因 - NYASH_USE_PLUGIN_BUILTINS=1が自動設定され、ArrayBox/MapBoxがplugin経由で生成を試行 - bid/registry.rsで"Plugin loading temporarily disabled"の状態でも試行されエラー - mod.rs:272のshortcut pathがNYASH_DISABLE_PLUGINSを無視していた ## テスト結果 - 10/11 PASS(HC011,13-18,21-22,31) - HC012: 既存issue(JSON安定化未完) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
4.5 KiB
4.5 KiB
Nyash Environment Variables (管理棟ガイド)
本ドキュメントは Nyash の環境変数を用途別に整理し、最小限の運用セットを提示します。nyash.toml の [env] で上書き可能(起動時に適用)。
- 例:
nyash.toml
[env]
NYASH_JIT_THRESHOLD = "1"
NYASH_CLI_VERBOSE = "1"
NYASH_DISABLE_PLUGINS = "1"
起動時に nyash は [env] の値を std::env に適用します(src/config/env.rs)。
コア運用セット(最小)
- NYASH_CLI_VERBOSE: CLI の詳細ログ("1" で有効)
- NYASH_DISABLE_PLUGINS: 外部プラグインを無効化(CI/再現性向上)
JIT(共通)
- NYASH_JIT_THRESHOLD: JIT 降下開始の閾値(整数)
- NYASH_JIT_EXEC: JIT 実行("1" で有効)
- NYASH_JIT_HOSTCALL: ホストコール経路の有効化
- NYASH_JIT_PHI_MIN: PHI(min) 合流の最適化ヒント
- NYASH_JIT_NATIVE_F64: f64 のネイティブ ABI 利用(実験的)
- NYASH_JIT_NATIVE_BOOL: bool のネイティブ ABI 利用(実験的)
- NYASH_JIT_ABI_B1: B1 返り値 ABI を要求(実験的)
- NYASH_JIT_RET_B1: bool 返り値ヒント(実験的)
JIT トレース/ダンプ
- NYASH_JIT_DUMP: JIT IR/CFG ダンプ("1" で有効)
- NYASH_JIT_DOT: DOT 出力先ファイル指定でダンプ暗黙有効
- NYASH_JIT_TRACE_BLOCKS: ブロック入場ログ
- NYASH_JIT_TRACE_BR: 条件分岐ログ
- NYASH_JIT_TRACE_SEL: select のログ
- NYASH_JIT_TRACE_RET: return 経路のログ
- NYASH_JIT_EVENTS_COMPILE: コンパイルイベント JSONL を出力
- NYASH_JIT_EVENTS_PATH: イベント出力パス(既定: events.jsonl)
Async/Runtime
- NYASH_AWAIT_MAX_MS: await の最大待機ミリ秒(既定 5000)
- (今後)タスク/スケジューラ関連の変数は
runtime.*名で集約予定
CLI Script Args(改行・特殊文字の安全輸送)
- NYASH_SCRIPT_ARGS_JSON:
--以降のスクリプト引数(JSON配列)。標準経路。 - NYASH_SCRIPT_ARGS_HEX_JSON: 上記のHEX版(各要素をUTF‑8→16進文字列化)。VMは HEX→JSON→ARGV の順で復元を試みる。
- NYASH_ARGV: 互換目的のJSON配列(最終フォールバック)。
メモ: 改行・特殊文字を含む長文を --source-file <path> <text> で渡す場合も HEX 経路で安全に輸送される。
FileBox Provider(コア/プラグイン切替)
- NYASH_FILEBOX_MODE:
auto|core-ro|plugin-only- auto(既定): プラグインがあれば PluginFileIo、無ければ CoreRoFileIo
- core-ro: 常にコアの read‑only 実装を使用(Analyzer/CI 向け)
- plugin-only: プラグイン必須(無ければ Fail‑Fast)
- NYASH_DISABLE_PLUGINS / HAKO_DISABLE_PLUGINS:
1でプラグイン無効(結果として core‑ro 相当)
LLVM/AOT
- NYASH_LLVM_FEATURE: LLVM機能選択("llvm"(default) または "llvm-inkwell-legacy")
- LLVM_SYS_180_PREFIX: LLVM 18 のパス指定(llvm-inkwell-legacy使用時のみ必要)
- NYASH_LLVM_VINVOKE_RET_SMOKE, NYASH_LLVM_ARRAY_RET_SMOKE: CI 用スモークトグル
- NYASH_LLVM_OBJ_OUT: LLVM経路で生成する
.oの出力パス(Runner/スクリプトが尊重) - NYASH_AOT_OBJECT_OUT: AOT パイプラインで使用する
.o出力ディレクトリ/パス - NYASH_LLVM_USE_HARNESS: "1" で llvmlite ハーネス経路を有効化(MIR(JSON)→Python→.ll→llc→.o)
LLVM Feature 詳細
- llvm (デフォルト): llvmlite Python ハーネス使用、LLVM_SYS_180_PREFIX不要
- llvm-inkwell-legacy: Rust inkwell bindings使用、LLVM_SYS_180_PREFIX必要
管理方針(提案)
- コード側:
src/config/env.rsを単一の集約窓口に(JIT はjit::configに委譲)。 - ドキュメント側: 本ファイルを単一索引にし、用途別に追加。
- 設定ファイル:
nyash.tomlの[env]で標準化(ブランチ/CI での一括制御)。 - 将来:
nyash env print/setの CLI サブコマンドを追加し、実行前に.env/toml 反映と検証を行う。
MIR Cleanup (Phase 11.8) 用トグル(段階導入)
- NYASH_MIR_ARRAY_BOXCALL: ArrayGet/Set → BoxCall 変換を有効化
- NYASH_MIR_REF_BOXCALL: RefGet/Set → BoxCall 変換を有効化
- NYASH_MIR_CORE13: Core‑13 セットの一括有効(将来拡張)
- NYASH_MIR_CORE13_PURE: Core‑13 純化モード("1" で有効)。最終MIRは13命令のみ許可され、Load/Store などは
env.local.get/set、newはenv.box.new経由へ強制正規化。禁制命令が残存するとコンパイルエラーで早期失敗。