tomoaki
b0eeb14c54
## Summary Refactored Phase 284 P1 codebase to consolidate scattered logic into SSOT (Single Source of Truth) modules, improving maintainability and enabling Pattern4/5 code reuse. ## New Modules ### 1. Block Remapper SSOT **File**: `src/mir/builder/control_flow/joinir/merge/block_remapper.rs` (152 lines) - **Purpose**: Consolidate block ID remapping logic (Phase 284 P1 fix) - **Function**: `remap_block_id(block_id, local_block_map, skipped_entry_redirects)` - **Rule**: local_block_map priority > skipped_entry_redirects (prevents ID collision) - **Tests**: 4 unit tests (priority cascade, collision handling, etc.) ### 2. Return Jump Emitter **File**: `src/mir/join_ir/lowering/return_jump_emitter.rs` (354 lines) - **Purpose**: Reusable return handling helper for Pattern4/5 - **Function**: `emit_return_conditional_jump(loop_step_func, return_info, k_return_id, ...)` - **Scope**: P1 - unconditional return + conditional (loop_var == N) only - **Tests**: 3 unit tests (unconditional, no return, conditional) ## Modified Files **merge/instruction_rewriter.rs** (-15 lines): - Replaced inline block remapping with `remap_block_id()` call - Cleaner Branch remap logic **merge/rewriter/terminator.rs** (-43 lines): - Delegates remap_jump/remap_branch to block_remapper SSOT - Simplified duplicate logic **lowering/loop_with_continue_minimal.rs** (-108 lines): - Replaced ~100 line return handling with `emit_return_conditional_jump()` call - Extracted helper functions to return_jump_emitter.rs - Line reduction: 57% decrease in function complexity **merge/mod.rs, lowering/mod.rs**: - Added new module exports (block_remapper, return_jump_emitter) **phase-284/README.md**: - Updated completion status (P1 Complete + Refactored) - Added SSOT consolidation notes - Documented module architecture ## Code Quality Improvements | Metric | Before | After | Change | |--------|--------|-------|--------| | Duplicate block remap logic | 2 places | SSOT | -15 lines | | Return handling code | inline (100L) | helper call | -99 lines | | Testability | Limited | Unit tests (7) | +7 tests | | Module cohesion | Low (scattered) | High (consolidated) | Better | ## Testing ✅ Build: Success (cargo build --release) ✅ Smoke tests: All pass (46 PASS, 1 pre-existing FAIL) ✅ Regression: Zero ✅ Unit tests: 7 new tests added ## Future Benefits 1. **Pattern5 Reuse**: Direct use of `emit_return_conditional_jump()` helper 2. **Phase 285 (P2)**: Nested if/loop returns via same infrastructure 3. **Maintainability**: SSOT reduces debugging surface area 4. **Clarity**: Each module has single responsibility ## Architectural Notes **Block Remapper SSOT Rule**: ``` remap_block_id(id, local_block_map, skipped_entry_redirects): 1. Check local_block_map (function-local priority) 2. Fall back to skipped_entry_redirects (global redirects) 3. Return original if not found ``` Prevents function-local block ID collisions with global remap entries. **Return Emitter Pattern**: ``` emit_return_conditional_jump(func, return_info, k_return_id, alloc_value): - Pattern1-5: All use same infrastructure - P1 scope: top-level return only (nested if/loop → P2) - Returns: JoinInst::Jump(cont=k_return, cond=Some(return_cond)) ``` 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
📚 Nyash Documentation
🚀 はじめに（導線）
- 現在のタスクと進行状況: ../CURRENT_TASK.md
- コア概念の速習: reference/architecture/nyash_core_concepts.md
- 設計ブループリント（文字列/文字コード）: development/design/blueprints/strings-utf8-byte.md
📂 ドキュメント構造（指針）
📖 reference/ - 正式な技術仕様
- language/ - 言語仕様（構文、型システム、Box仕様）
- architecture/ - システムアーキテクチャ（MIR、VM、実行バックエンド）
- api/ - ビルトインBoxのAPI仕様
- plugin-system/ - プラグインシステム、BID-FFI仕様
- 🆕🔥 TypeBox ABI統合 + セルフホスティング - ABIすらBoxとして扱う革命的設計！
- まずはこちら:
reference/boxes-system/plugin_lifecycle.md（PluginBoxV2のライフサイクル、singleton、nyash.tomlの要点）
📚 guides/ - 利用者向けガイド
- getting-started.md - はじめに（統一版）
- tutorials/ - ステップバイステップのチュートリアル
- examples/ - 実践的なサンプルコード
- wasm-guide/ - WebAssemblyビルドガイド
🧩 how-to/ - 目的別ハウツー
- 手順重視の短いガイド（前提→コマンド→検証）
🔧 development/ - 開発者向け
- current/ - 現在進行中のタスク（CURRENT_TASK.md等）
- roadmap/ - 開発計画
- phases/ - Phase 8～12の詳細計画
- phase-12/ - 🆕🔥 TypeBox統合ABI + Nyash ABI C実装（セルフホスティング実現！）
- native-plan/ - ネイティブビルド計画
- proposals/ - RFC、新機能提案
🔌 Net Plugin（HTTP/TCP）
- 使い方と仕様:
reference/plugin-system/net-plugin.md
🗄️ archive/ - アーカイブ
- consultations/ - AI相談記録（gemini/chatgpt/codex）
- decisions/ - 過去の設計決定
- build-logs/ - ビルドログ、ベンチマーク結果
- old-versions/ - 古いドキュメント
📌 Docs マップ（トップレベルとステータス）
新しくドキュメントを書くときや、どこに置くか迷ったときはこの表を基準にする。
| パス | 用途 | 主な対象 | ステータス |
|---|---|---|---|
reference/ |
言語仕様・正式なリファレンス | 利用者 / 実装者 | Active / SSOT |
guides/ |
チュートリアル・長めの読み物 | 利用者 / 新規開発者 | Active |
how-to/ |
手順書・レシピ集 | 日常開発 | Active |
quick-reference/ |
コマンドやオプションの早見表 | 日常参照 | Active |
development/ |
Rust 実装側の設計・ロードマップ | コア開発者 | Active（Rust層） |
private/ |
将来の整理待ちのメモ・長文案 | コア開発者 | Draft / Incubator |
design/ |
公開可能な安定寄り設計ノート | 実装者 | Active（安定設計） |
architecture/ |
全体アーキテクチャの俯瞰図 | 実装者 / 設計者 | Active |
abi/ |
Nyash/Hakorune ABI 関連 | 実装者 | Active |
specs/ |
古めの仕様・実験的仕様 | 実装者 | Legacy（必要に応じ参照） |
checklists/ |
レビュー・設計チェックリスト | 実装者 | Active |
tools/ |
ドキュメント生成・補助スクリプト | 実装者 | Active |
updates/ |
リリースノート・変更履歴 | 利用者 / 実装者 | Active |
releases/ |
リリース関連ドキュメント | 利用者 | Active |
archive/ |
旧ドキュメント・歴史資料 | 研究・考古学用 | Archived（正本ではない） |
assets/ |
画像などの共有アセット | すべて | Support |
ENV_VARS.md |
環境変数リファレンス | 実装者 / 運用者 | Active（集約先） |
運用ルール（提案）:
- 新規仕様/設計: まずは
private/に置き、安定したらreference/ordesign/へ昇格する。 - Rust 実装寄りの話:
development/配下に置く（セルフホスト側はprivate/roadmap等）。 - 古い資料・置き換え済み: 内容を変えずに
archive/以下へ移動し、先頭に「Archived / 新しい場所」の一行メモを書く。 - ユーザー向けに見せたいもの:
guides/,how-to/,quick-reference/,releases/を優先する。
🎯 クイックアクセス
すぐ始める
- guides/getting-started.md
- guides/language-guide.md
- guides/p2p-guide.md
技術リファレンス
- reference/language/LANGUAGE_REFERENCE_2025.md
- reference/language/EBNF.md（演算子: ! 採用 / do-while 非採用）
- reference/language/strings.md（UTF‑8/Byte 二本柱）
- reference/architecture/TECHNICAL_ARCHITECTURE_2025.md
- reference/architecture/execution-backends.md
- reference/runtime/gc.md
- reference/plugin-system/
- tools/cli-options.md（CLI早見表）
デザイン/ガイド
- guides/language-core-and-sugar.md（コア最小＋糖衣）
- guides/loopform.md（ループ正規化）
- guides/scopebox.md（開発時の可視化）
- guides/dev-local-alias.md（開発向け: 行頭 @name = expr → local 宣言糖衣）
- guides/box-patterns.md（Boxパターン集：Ownership/Lease/Cancel/Capability/Affinity/Observable）
- guides/box-design-checklist.md（Box 設計チェックリスト）
- proposals/concurrency/boxes.md（並行モデルのBox設計：Routine/Channel/Select/Scope）
- reference/concurrency/semantics.md（ブロッキング/close/select/観測の規約）
- design/（設計ノート入口）
- development/design/legacy/flow-blocks.md（矢印フロー／匿名ブロック・設計草案）
- development/proposals/scope-reuse.md（スコープ再利用ブロック・MVP提案）
- reference/language/match-guards.md（ガード連鎖／Range・CharClass設計）
- guides/core-principles.md（最小構文・ゼロランタイム・可視化の原則）
開発状況
- 現在のタスク
- 開発ロードマップ
- Phase別計画
- 🔥 Phase 12: TypeBox統合ABI
- 🔥 Phase 16: マクロ革命
- 🧪 Phase 17: LoopForm Self‑Hosting
- 💡 Rust所有権統合（候補） - Phase 17+候補
- 🧩 Mini‑VM 構築ロードマップ
- 🧭 Using→Loader 統合（最小設計）: development/design/legacy/using-loader-integration.md
- 🗂️ Docsの書き方（小さく・リンク駆動）: guides/contributing-docs.md
📋 再編成について / フォルダの見分け方
ドキュメントは2025年8月20日に再編成されました。詳細はREORGANIZATION_REPORT.mdを参照してください。
旧パスから新パスへの主な変更：
説明書/→guides/とreference/に分割予定/→development/roadmap/- 散在していたファイル → 適切なカテゴリに整理
補足:
reference/は正本（仕様）。guides/は読み物、how-to/は手順書。design/は公開できる設計ノート。private/は下書き保管庫（将来reference//design/に昇格）。
Nyash は「Everything is Box」哲学に基づく言語です。詳細はコア概念とガイドを参照してください。