phase15: update CLAUDE.md and sync with current progress

- Update phase indicator to Phase 15 (Self-Hosting)
- Update documentation links to Phase 15 resources
- Reflect completion of R1-R5 tasks and ongoing work
- Fix CURRENT_TASK.md location to root directory

Co-Authored-By: Claude <noreply@anthropic.com>

docs/development/roadmap/phases/phase-15/ROADMAP.md

@@ -0,0 +1,71 @@
+# Phase 15 — Box Stacking Roadmap (Living)
+
+This roadmap is a living checklist to advance Phase 15 with small, safe boxes. Update continuously as we progress.
+
+## Now (ready/green)
+
+- [x] v0 Ny parser (Ny→JSON IR v0) with wrappers (Unix/Windows)
+- [x] Runner JSON v0 bridge (`--ny-parser-pipe`) → MIR → MIR-Interp
+- [x] E2E + roundtrip practical recipes (Windows/Unix)
+- [x] Docs path unify (phase-15 under roadmap tree)
+- [x] Direct bridge (design + skeleton; feature-gated)
+- [x] AOT P2 stubs (CraneliftAotBox/LinkerBox) + RUN smoke wiring
+
+## Next (small boxes)
+
+1) Ny config loader (Ny-only)
+   - FileBox + TOMLBox to read `nyash.toml` → Map (env/tasks/plugins/box_types)
+   - Deliver as `apps/std/ny-config.nyash` with simple API: `read_root()`, `load_toml()`, `get_env()/get_tasks()`
+2) Ny script plugins enumeration
+   - Add `[ny_plugins]` to `nyash.toml` for pure Nyash plugins
+   - Runner opt-in hook: `NYASH_LOAD_NY_PLUGINS=1`/`--load-ny-plugins` to include/register in order
+3) Direct bridge (v0) rollout
+   - `--parser ny`/`NYASH_USE_NY_PARSER=1` routes to in-proc bridge (subset: return/int/+ - * /, parens)
+   - Keep JSON as debug dump (`NYASH_DUMP_JSON_IR=1`)
+   - Expand smokes + parity checks with rust path
+4) AOT P2 (stub→first run)
+   - Emit `.obj/.o` → link → run; measure time/size; log instructions
+
+## Later (incremental)
+
+- v1 Ny parser (let/if/call) behind `NYASH_JSON_IR_VERSION=1`
+- JSON v1 bridge → MirBuilder (back-compat v0)
+- 12.7 sugars normalized patterns in bridge (?. / ?? / range)
+- E2E CI-lite matrix (no LLVM) for v0/v1/bridge roundtrip
+- Ny script plugin examples under `apps/plugins-scripts/`
+
+## Operational switches
+
+- Parser path: `--parser {rust|ny}` or `NYASH_USE_NY_PARSER=1`
+- JSON dump: `NYASH_DUMP_JSON_IR=1`
+- Load Ny plugins: `NYASH_LOAD_NY_PLUGINS=1` / `--load-ny-plugins`
+- AOT smoke: `CLIF_SMOKE_RUN=1`
+
+## Recipes / Smokes
+
+- JSON v0 bridge: `tools/ny_parser_bridge_smoke.sh` / `tools/ny_parser_bridge_smoke.ps1`
+- E2E roundtrip: `tools/ny_roundtrip_smoke.sh` / `tools/ny_roundtrip_smoke.ps1`
+
+## Stop criteria (Phase 15)
+
+- v0 E2E green (parser pipe + direct bridge)
+- v1 minimal samples pass via JSON bridge
+- AOT P2: emit→link→run stable for constant/arith
+- Docs/recipes usable on Windows/Unix
+
+## Notes
+
+- JSON is a temporary, safe boundary. We will keep it for observability even after the in-proc bridge is default.
+- Favor smallest viable steps; do not couple large refactors with new features.
+
+## Ny Plugins → Namespace (Plan)
+
+- Phase A (minimal): Add a shared `NyModules` registry (env.modules.{set,get}).
+  - Map file path → namespace (project‑relative, separators → `.`, trim extension).
+  - R5 hook: if a Ny plugin returns an exports map/static box, register it under the derived namespace.
+  - Guard: reject reserved prefixes (e.g., `nyashstd.*`, `system.*`).
+- Phase B (scope): Optionally run `[ny_plugins]` in a shared Interpreter to share static definitions.
+  - Flag: `NYASH_NY_PLUGINS_SHARED=0` to keep isolated execution.
+  - Logs: `[ny_plugins] <ns>: REGISTERED | FAIL(reason)`.
+- Phase C (language bridge): Resolve `using foo.bar` via `NyModules`, then fallback to file/package resolver (nyash.link).
+  - Keep IDE‑friendly fully qualified access; integrate with future `nyash_modules/`.

docs/development/roadmap/phases/phase-15/recommended-sequence.txt

@@ -0,0 +1,123 @@
+===============================================================================
+Phase 15 推奨進行順（JIT優先・自己ホスティング最小）
+更新日: 2025-09-05
+===============================================================================
+
+方針（原則）
+- JITオンリー（Cranelift）で前進。LLVM/AOT・lld系は後段にスライド。
+- 最小自己ホスト体験を早期に成立 → ドキュメント/スモーク/CIを先に固める。
+- using（名前空間）はゲート付きで段階導入。NyModulesとny_pluginsの基盤を強化。
+- tmux + codex-async を使い、常時2本並走で小粒に積み上げる。
+
+===============================================================================
+推奨シーケンス（概要→実施要点→完了基準）
+===============================================================================
+
+1) 基盤整備（NyModules / ny_plugins / Windows正規化）
+- 要点:
+  - NyModules 共有レジストリ導入: env.modules.set/get（または ModulesBox）
+  - ny_plugins のパス→名前空間導出: ルート相対、"/"→".", 拡張子 .nyash 省略、[^a-zA-Z0-9_.]→"_"
+  - Windowsパス: "\\"→"/" 正規化後に上記規則を適用
+  - 予約衝突: nyashstd.* の登録を明示拒否しログ出力
+- スモーク/CI:
+  - tools/modules_smoke.sh, tools/modules_winpath_smoke.sh
+- 完了基準:
+  - env.modules.get("acme.logger") などが取得可能、LIST_ONLY/Fail-continue維持、予約拒否ログが出る。
+
+2) 最小コンパイラ経路（JIT）
+- 要点:
+  - パーサ/レクサのサブセット: ident/literals/let/call/return/if/block
+  - Nyash から呼べる MIR ビルダ（小さなサブセット）
+  - VM/JIT ブリッジを通して apps/selfhost-minimal が走る
+- スモーク/CI:
+  - tools/jit_smoke.sh, tools/selfhost_vm_smoke.sh
+- 完了基準:
+  - ./target/release/nyash --backend vm apps/selfhost-minimal/main.nyash が安定実行し、CIでJITスモーク合格。
+
+3) using（ゲート付き）設計・実装（15.2/15.3）
+- 要点:
+  - パーサフック: 'using <ns>' を受理（--enable-using / NYASH_ENABLE_USING=1）
+  - リゾルバskeleton: resolve(ns) → NyModules を優先。外部/パッケージは TODO として設計のみ。
+  - 実行時フック: 未解決時に提案を含む診断。セッションキャッシュを導入（ny_plugins再読込で無効化）。
+  - using alias: 'using a.b as x' を設計→段階導入。
+- スモーク/CI:
+  - jit_smoke に using ケースとキャッシュケースを追加。
+- 完了基準:
+  - フラグONで using 経路が動作し、未解決時の診断・キャッシュ挙動がテストで担保。
+
+4) nyash.link ミニマルリゾルバ（15.4）
+- 要点:
+  - ファイル/相対解決 → 名前空間への写像、検索パス（nyash.toml と環境）、Windows正規化
+  - 未解決時は候補提示、NyModules へのフォールバック
+  - using alias + 診断を仕上げる
+- スモーク/CI:
+  - end-to-end 例（apps/）とJITスモークの拡充
+- 完了基準:
+  - 小規模プロジェクトで using + nyash.link の基本導線がJITでE2E通る。
+
+5) パフォーマンス守り（MIRマイクロ最適化 + 回帰ゲート）
+- 要点:
+  - const-fold（リテラル・単純四則）、DCE（unreachable return/blocks）をスコープ限定で有効化
+  - 回帰時は NYASH_CLI_VERBOSE=1 で診断を落とす
+- スモーク/CI:
+  - jit_smoke に閾値付きケースを追加、CI optional stage で監視
+- 完了基準:
+  - 主要ケースで回帰検出が機能し、JITパリティが維持される。
+
+6) Boxes 高レベル移植（15.5 開始）
+- 要点:
+  - StringBox → ArrayBox の順で表層メソッドをNyashへ移植（NyRTは最小プリミティブ維持）
+  - MapBox は次段で検討。ABI/churnを避けるため段階導入
+- スモーク/CI:
+  - 文字列/配列操作のJITスモークを追加
+- 完了基準:
+  - 代表的な文字列/配列APIがNyash実装で安定動作し、CI常時緑。
+
+7) インタープリターコアの段階移植（15.5/15.6）
+- 要点:
+  - MIR実行ループを段階的にNyash化（動的ディスパッチで13命令処理）
+  - ブートストラップ: c0(Rust) → c1(Nyash) → c1'（自己再コンパイル）
+- 検証:
+  - パリティテスト（trace_hash 等）とスモークを追加
+- 完了基準:
+  - 自己再コンパイルループが成立し、差分トレースが安定。
+
+8) YAML 自動生成（15.1 を後段にスライドして導入）
+- 要点:
+  - boxes.yaml / externs.yaml / semantics.yaml を定義し、build.rs でコード自動生成
+  - まず externs/boxes の一部から段階導入 → 重複削減を早期に回収
+- 完了基準:
+  - 重複コードが実測で大幅削減（1〜2万行級）、CI・ドキュメントに反映。
+
+9) クローズアウト（各小節の都度）
+- README.ja.md / AGENTS.md / docs のHOWTO・旗一覧・スモーク手順を常に最新化
+- ツール類索引: tools/jit_smoke.sh, selfhost_vm_smoke.sh, modules_smoke.sh, modules_winpath_smoke.sh
+- CIトグル整備: LLVM系は無効化、JIT（--features cranelift-jit）を標準経路に
+
+===============================================================================
+クイックコマンド（JITオンリー）
+===============================================================================
+- ビルド: cargo build --release --features cranelift-jit
+- 実行:  ./target/release/nyash --backend vm apps/selfhost-minimal/main.nyash
+- スモーク:
+  - tools/jit_smoke.sh
+  - tools/selfhost_vm_smoke.sh
+  - tools/modules_smoke.sh ; tools/modules_winpath_smoke.sh
+
+フラグ（抜粋）
+- --load-ny-plugins / NYASH_LOAD_NY_PLUGINS=1
+- --enable-using      / NYASH_ENABLE_USING=1
+- NYASH_CLI_VERBOSE=1（診断強化）
+
+===============================================================================
+運用（Codex async / tmux）
+===============================================================================
+- 2並走・重複回避: CODEX_MAX_CONCURRENT=2 CODEX_DEDUP=1 CODEX_ASYNC_DETACH=1
+- 監視: pgrep -af 'codex .* exec' / tail -f ~/.codex-async-work/logs/codex-*.log
+- Windowsパス/名前空間: "\\"→"/" 正規化 → ルール適用（/→., .nyash除去, sanitize）
+
+備考
+- 本シーケンスは docs/development/roadmap/phases/phase-15/self-hosting-plan.txt を尊重しつつ、
+  JIT最小体験を優先させるため順序を最適化（LLVM/lld と YAML自動生成は後段へスライド）。
+  進捗に応じて適宜見直し、CI/スモークで常時検証する。
+