Files
hakorune/docs/development/roadmap/phases/phase-12/REFACTORING_PLAN.md

56 lines
1.9 KiB
Markdown
Raw Normal View 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成功
- レビュー観点のチェックリスト合格