tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
e2e25f6615058732d9f0fd2477637a2fef7cf72d
hakorune/docs/development/roadmap/phases/phase-12/REFACTORING_PLAN.md
Moe Charm de99b40bee Phase 12 TypeBox統合ABI設計完了: C ABI + Nyash ABI革命的統合 
主な成果:
- TypeBox（型情報をBoxとして扱う）による統合ABI設計
- C ABI + Nyash ABIの完全統合仕様書作成
- 3大AI専門家（Gemini/Codex/ChatGPT5）による検証済み
- ChatGPT5の10個の安全性改善提案を反映
- README.mdのドキュメント更新（全起点から到達可能）

MapBox拡張:
- string型キーサポート（従来のi64に加えて）
- remove/clear/getOr/keysStr/valuesStr/toJson実装
- keys()/values()のランタイムシムサポート（TypeBox待ち）

その他の改善:
- Phase 11.9（文法統一化）ドキュメント追加
- Phase 16（FoldLang）ドキュメント追加
- 非同期タイムアウトテスト追加
- 各種ビルド警告（未使用import等）は次のリファクタリングで対応予定

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-02 09:26:09 +09:00

1.9 KiB
Raw Blame History

Phase 12 リファクタリング計画（<= 1000行/ファイル方針）

目的: 可読性とAI/人間のレビュー効率を上げるため、大型ファイルを責務単位で分割。

対象候補（行数ベース）

  • src/mir/builder.rs ~2100行
  • src/jit/lower/builder.rs ~2050行
  • src/backend/vm.rs ~1510行
  • src/runtime/plugin_loader_v2.rs ~1430行
  • src/jit/lower/core.rs ~1430行
  • src/backend/vm_instructions.rs ~1360行
  • src/backend/llvm/compiler.rs ~1230行
  • src/interpreter/plugin_loader.rs ~1210行
  • src/runner.rs ~1170行
  • src/ast.rs ~1010行

分割提案（第1期: 安全にファイル分割のみ）

  1. src/runner.rs

    • runner/mod.rs（エントリ）
    • runner/modes/{vm.rs,jit.rs,llvm.rs,mir_interpreter.rs}
    • runner/utils.rs（共通ヘルパ）

  2. src/runtime/plugin_loader_v2.rs

    • runtime/plugin_loader/{mod.rs,registry.rs,encoder.rs,decoder.rs,invoke.rs}
    • 既存のTLV共通は plugin_ffi_common.rs へ残置

  3. src/mir/builder.rs

    • mir/builder/{mod.rs,blocks.rs,phis.rs,lower_ops.rs}

  4. src/jit/lower/{core.rs,builder.rs}

    • jit/lower/core/{mod.rs,graph.rs,stats.rs}
    • jit/lower/builder/{mod.rs,clif.rs,object.rs,stats.rs}

  5. src/backend/vm*.rs

    • backend/vm/{mod.rs,values.rs,dispatch.rs,gc.rs}
    • backend/vm_instructions.rs → backend/vm/ops_*.rs (load/store/arith/call等で分割)

  6. src/backend/llvm/compiler.rs

    • backend/llvm/{mod.rs,emit_object.rs,link.rs,passes.rs}

  7. src/ast.rs

    • ast/{mod.rs,node.rs,visitor.rs,printer.rs}

実行順（トライ&スライス）

    1. runner → 2) plugin_loader → 3) mir/builder
  • 各ステップで cargo build ＋ 既存smoke確認

非目標（現段階で触らない）

  • 機能変更や最適化（挙動は完全に不変）
  • 命名や公開APIの変更

完了条件

  • 1000行超のファイルを概ね収束（±50行は許容）
  • CIスモーク（apps/tests）成功
  • レビュー観点のチェックリスト合格