tomoaki/hakorune

Fork 0

Files

nyash-codex 8fd3a2b509 docs: restore docs/private/roadmap from 7b4908f9 (Phase 20.31)

2025-10-31 18:00:10 +09:00

12 KiB

Raw Blame History

Phase 15.75 — 完全脱Rust大作戦 📚 エントリーポイント

最終更新: 2025-10-14 ステータス: 計画段階 → 実装開始準備中目的: Rust 99,406行 → 10,400行（89.5%削減）への完全ロードマップ

⚡ 超急ぎの人向け（3分で全部わかる）

🎯 Phase 15.75を1行で説明

Rust 99,406行 → 10,400行（89.5%削減）を1ヶ月で実現
MIR疎結合により失敗時Rollback可能なゼロリスク計画

🚀 今すぐやる3ステップ

ステップ1: スモークテスト確認（2分）

bash tools/smokes/v2/run.sh --profile quick-selfhost
# 期待: 170/185 PASS（現状維持）

ステップ2: TODO読む（5分）

cat "docs/private/roadmap/phases/phase-15.75/TODO.md"

# 確認内容:
# - Phase 1（MirCall）準備タスク
# - plugin-on スモーク拡充
# - HostHandleRouter 段階移設

ステップ3: 1つ選んで実装開始

# Option A: 安全メソッドの whitelist を箱化
#   - normalize.rs に is_safe_core_method 追加

# Option B: Callable(argv 再構成) のパリティ確認
#   - arity>0 の methodRef.call(argv) 正常系スモーク追加

# Option C: HostHandleRouter 境界スモーク
#   - 型不一致を明示検出するスモーク追加

🚨 失敗したらどうなる？

✅ いつでもRollbackできます！

Level 1: バックエンド切替（0秒）
  ./hakorune-stage0.exe problem.hako

Level 2: Parser Rollback（5-10分）
  vim selfhost/compiler/parser.hako → 修正

Level 3: Full Rollback（10-30分）
  git checkout stage0-preserved

詳細: STRATEGY.md

🚀 今すぐ読むべきドキュメント（優先順）

1️⃣ TODO.md ← 👈 ここから始める！

読むべき人: 今すぐ作業開始したい人内容: 次の1-2週間でやるべきこと（P1スコープ） 所要時間: 5分

✅ 完了済み: Map.call P1, Fallback箱化, HostHandleRouter stub
📋 次のアクション:
  - Phase 1（MirCall）小粒・箱化方針で進行
  - plugin-on スモーク拡充
  - HostHandleRouter 段階移設

結論: 具体的な作業リストが欲しい → TODO.md

2️⃣ ROADMAP.md ← 全体像を知りたい人

読むべき人: 「なぜRust削減するのか」「どうやって実現するのか」を知りたい人内容: Phase 15.75の全体戦略と詳細タスクリスト 所要時間: 15-20分

📊 削減計画:
  - Option A: 99,406行 → 10,400行（89.5%削減）
  - Phase 1-5: 淡々とタスクを消化

🎯 核心戦略:
  - Rust VM → Hakorune VM（自己実装）
  - Parser → Selfhost Parser（.hako実装）
  - Boxes → Plugins（プラグインシステム）

結論: 全体像と背景理論を理解したい → ROADMAP.md

2.5️⃣ Stage‑4（最短導線）

ChatGPT最小プラン（2日）: stage-4-chatgpt/INDEX.md

2関数のC ABIハーネス / feature配下 / スモーク1本（bothヘッダ一致）
先の統合戦略: INTEGRATION_STRATEGY_CLAUDE.md

フル設計（Claude版）: stage-4/INDEX.md

2.6️⃣ Next Phase（15.76）

extern_c / Self‑Host Bootstrap: ../phase\ 15.76/INDEX.md

TODO: ../phase\ 15.76/TODO.md

3️⃣ STRATEGY.md ← 失敗が怖い人

読むべき人: 「本当に安全なのか」「失敗したらどうなるのか」が不安な人内容: MIR疎結合によるゼロリスク戦略 + ツールチェーン要件 所要時間: 15分

🔄 Rollbackレベル:
  - Level 1: バックエンド切替（0秒）
  - Level 2: Parser Rollback（5-10分）
  - Level 3: Full Rollback（10-30分）

✅ 核心原則:
  - Stage 0/1/2並行運用（いつでも戻れる）
  - MIR = 疎結合ポイント（バックエンド交換可能）

🔧 ツールチェーン:
  - HakoBuildBox（500-800行）
  - HakoLspBox（1,200-2,000行）

結論: リスク管理とツールチェーンを知りたい → STRATEGY.md

4️⃣ ANALYSIS.md ← 「1ヶ月で可能？」と思った人

読むべき人: 実績ベースの見積もり根拠を知りたい人内容: Git履歴に基づく速度分析 + 3者見積もり比較 所要時間: 10分

📊 実績データ:
  - 21.6コミット/日（66日間）
  - 115行/日削減（直近13日間）
  - M2/M3達成: 63日（業界標準の29倍速）

🎯 結論:
  - ユーザー「1ヶ月」✅ 正しい（Phase 1-2コア完了）
  - Gemini「1年以上」❌ 業界標準ベース
  - Claude「6ヶ月」❌ 実績を無視した理論値

結論: 1ヶ月の根拠を知りたい → ANALYSIS.md

🎯 あなたの状況別ガイド

🚀 「今すぐ作業したい」

1. TODO.md 読む（5分）
2. 作業開始！

📚 「全体を理解してから作業したい」

1. ROADMAP.md 読む（15分）
   → 全体像理解
2. STRATEGY.md 読む（15分）
   → 安全性確認
3. TODO.md 読む（5分）
   → 作業開始

🔍 「リスクが心配」

1. STRATEGY.md 読む（15分）
   → Rollback手順確認
2. TODO.md 読む（5分）
   → 段階的作業開始

📊 「1ヶ月で本当に可能？」

1. ANALYSIS.md 読む（10分）
   → 実績ベースの根拠確認
2. ROADMAP.md 読む（15分）
   → 詳細計画確認

📊 4つのドキュメントの関係図

┌─────────────────────────────────────────┐
│   ROADMAP.md                             │
│   （全体戦略 + Phase別タスクリスト）      │
│   - なぜRust削減するのか                  │
│   - Phase 1-5 詳細スケジュール            │
│   - 週次TODO展開                         │
└────────────┬────────────────────────────┘
             │
    ┌────────┴────────┐
    │                 │
┌───▼──────────┐  ┌──▼─────────────────────┐
│ STRATEGY.md  │  │ ANALYSIS.md            │
│ （戦略・安全）│  │ （実績分析）            │
│ - Rollback   │  │ - Git履歴分析           │
│ - Stage並行  │  │ - 3者見積もり比較       │
│ - ツール要件  │  │ - 1ヶ月根拠             │
└───┬──────────┘  └────────────────────────┘
    │
    │ 実践↓
    │
┌───▼──────────────────────────────────────┐
│   TODO.md                                 │
│   （今すぐやること）                       │
│   - Phase 1（MirCall）小粒タスク           │
│   - plugin-on スモーク拡充                 │
│   - HostHandleRouter 段階移設             │
└───────────────────────────────────────────┘

🗺️ Phase 15.75 完全手順マップ

Phase 0（今）: 準備・計画確認

✅ ドキュメント読了
  1. INDEX.md（このファイル）
  2. TODO.md
  3. ROADMAP.md

✅ 環境確認
  - スモークテスト実行: bash tools/smokes/v2/run.sh --profile quick-selfhost
  - 現状: 170/185 PASS（15 FAIL）

Phase 1: Hakorune VM完成（MirCall実装）

📋 Phase 1タスク:
  - TODO.md の「Phase 1（MirCall）着手準備」参照
  - 小粒・箱化方針で段階実装
  - 15/16命令 → 16/16命令（100%完成）

Phase 2: Selfhost Parser実装

📋 Phase 2タスク:
  - Parser.hako 実装
  - MIR出力確認（Rust Parser と一致）
  - 詳細は ROADMAP.md 参照

Phase 3: Boxes Migration（進行中）

🔄 現状: P3-4（レガシー撤退）
✅ ChatGPT担当
📋 詳細: PHASE_3_BOXES_MIGRATION.md

Phase 4: Dual Parser Harness（次のフェーズ）

🎯 目標: Rust Parser層を100-200行のC ABI層に縮退

📚 完全ドキュメント: stage-4/ フォルダ
  - INDEX.md - エントリーポイント
  - QUICKSTART.md - 3行要約 + 2日間スケジュール
  - C_ABI_DESIGN_SPEC.md - C ABI層設計
  - HAKO_ABI_DESIGN_SPEC.md - Hako ABI層設計
  - TECHNICAL_REQUIREMENTS.md - 技術要件
  - SCHEDULE.md - 詳細スケジュール
  - RISK_ANALYSIS.md - リスク分析

👉 次のアクション: cd stage-4/ && cat INDEX.md

Phase 5以降

🔄 Phase 5: Parser完全移行（1週間）
🔄 Phase 6-N: 他のコンポーネントも同様にC ABI化

※ ROADMAP.md 参照

📝 各ドキュメントの詳細情報

ドキュメント	サイズ	読了時間	優先度	役割
INDEX.md	11KB	3分	★★★★★	エントリーポイント
TODO.md	7.4KB	5分	★★★★★	今すぐやること
ROADMAP.md	41KB	15-20分	★★★★	全体戦略＋タスクリスト
STRATEGY.md	30KB	15分	★★★★	安全性保証＋ツール
ANALYSIS.md	18.2KB	10分	★★★	実績分析＋見積もり
stage-4/	165KB	2時間	★★★★	Stage 4完全設計
PHASE_3_BOXES_MIGRATION.md	1.9KB	3分	★★★	Stage 3進行状況

🚨 よくある質問（FAQ）

Q1: どこから読めばいいの？

A: 👉 TODO.md から始めてください（5分で読める）

Q2: Phase 15.75って何？

A: Rust 99,406行 → 10,400行（89.5%削減）する計画です。詳細は ROADMAP.md 参照

Q3: 失敗したらどうなるの？

A: MIR疎結合により、いつでもRollback可能です。詳細は STRATEGY.md 参照

Q4: いつから始めるの？

A: 今すぐ始められます。TODO.md の「次アクション」参照

Q5: どのくらい時間がかかるの？

A: 1ヶ月計画（Phase 1-2コア完了）。詳細は ANALYSIS.md 参照

Q6: 1ヶ月で本当に可能？

A: Git履歴の実績ベースで可能です。詳細は ANALYSIS.md 参照

Q7: Stage 4（Dual Parser Harness）って何？

A: Rust Parser層を100-200行のC ABI層に縮退するフェーズです。詳細は stage-4/INDEX.md 参照

🔗 関連ドキュメント（外部リンク）

上位ドキュメント

00_MASTER_ROADMAP.md - Hakorune全体のマスタープラン
CURRENT_TASK.md - 現在進行状況

参考ドキュメント

INSTRUCTION_SET.md - MIR命令セット
実行モード完全ガイド - VM/LLVM/WASM実行

📋 次のアクション（明確な手順）

ステップ1: 理解する（30分）

# 1. このファイル（INDEX.md）を読む（3分）✅ 完了！
# 2. TODO.md を読む（5分）
cat TODO.md

# 3. ROADMAP を流し読み（15分）
less ROADMAP.md

# 4. STRATEGY を流し読み（10分）
less STRATEGY.md

ステップ2: 現状確認（10分）

# スモークテスト実行
bash tools/smokes/v2/run.sh --profile quick-selfhost

# 期待: 170/185 PASS（現状維持）

ステップ3: 作業開始（TODO.mdベース）

# TODO.md の「次アクション」を1つずつ実行
# Phase 1（MirCall）小粒タスクから開始

🎯 まとめ: Phase 15.75 を1行で説明

Rust 99,406行 → 10,400行（89.5%削減）を1ヶ月で実現する、
MIR疎結合により失敗時Rollback可能なゼロリスク計画

📝 変更履歴

2025-10-14: ファイル整理（9→5ファイルに削減）
- QUICKSTART.md を INDEX.md に統合
- ROADMAP.md, STRATEGY.md, ANALYSIS.md 作成
- リンク修正完了
2025-10-13: 初版作成（Claude Code）
- 4つのドキュメントの整理・導線設計
- 読む順番と優先度の明確化
- FAQ・手順マップ追加

12 KiB Raw Blame History Unescape Escape