trace: add execution route visibility + debug passthrough; phase2170 canaries; docs

- Add HAKO_TRACE_EXECUTION to trace executor route
  - Rust hv1_inline: stderr [trace] executor: hv1_inline (rust)
  - Hakovm dispatcher: stdout [trace] executor: hakovm (hako)
  - test_runner: trace lines for hv1_inline/core/hakovm routes
- Add HAKO_VERIFY_SHOW_LOGS and HAKO_DEBUG=1 (enables both)
  - verify_v1_inline_file() log passthrough with numeric rc extraction
  - test_runner exports via HAKO_DEBUG
- Canary expansion under phase2170 (state spec)
  - Array: push×5/10 → size, len/length alias, per‑recv/global, flow across blocks
  - Map: set dup-key non-increment, value_state get/has
  - run_all.sh: unify, remove SKIPs; all PASS
- Docs
  - ENV_VARS.md: add Debug/Tracing toggles and examples
  - PLAN.md/CURRENT_TASK.md: mark 21.7 green, add Quickstart lines

All changes gated by env vars; default behavior unchanged.
This commit is contained in:
nyash-codex
2025-11-08 23:45:29 +09:00
parent bf185ec2b2
commit fa3091061d
49 changed files with 1334 additions and 110 deletions

View File

@ -51,6 +51,15 @@ NYASH_DISABLE_PLUGINS = "1"
メモ: 改行・特殊文字を含む長文を `--source-file <path> <text>` で渡す場合も HEX 経路で安全に輸送される。
## Debug/Tracing開発用の軽量トグル
- HAKO_TRACE_EXECUTION: 実行経路の可視化("1" で有効)
- 例: `[trace] executor: hv1_inline (rust)` / `[trace] executor: hakovm (hako)` / `[trace] executor: core (rust)`
- 出力先: 原則 stderrHakovm は stdout。テストランナーは numeric rc 抽出時に非数値行を無視します。
- HAKO_VERIFY_SHOW_LOGS: verify_v1_inline_file() のログ透過("1" で有効)
- hv1 inline 実行の全出力を stderr に表示し、数値 rc は別途抽出します。
- HAKO_DEBUG: 開発向け一括トグル("1" で `HAKO_TRACE_EXECUTION=1``HAKO_VERIFY_SHOW_LOGS=1` を自動有効化)
- 実装箇所: tools/smokes/v2/lib/test_runner.sh のデバッグ便宜機能
## FileBox Providerコア/プラグイン切替)
- NYASH_FILEBOX_MODE: `auto|core-ro|plugin-only`
- auto既定: プラグインがあれば PluginFileIo、無ければ CoreRoFileIo