Files
hakorune/docs/development/current/main/01-JoinIR-Selfhost-INDEX.md
nyash-codex 889492b617 docs(joinir): Phase 80 Tasks 80-0/80-A - Status verification + design doc
Task 80-0: Current status verification
-  970/970 lib tests PASS (production stable)
-  Core VM smoke tests PASS (json_pp_vm)
-  Phase 79 E2E tests broken (AST API mismatch, out-of-scope)
-  Pre-existing json_lint_vm failure (Pattern2 verifier, out-of-scope)
- **Conclusion**: Phase 80 has ZERO blockers

Task 80-A: SSOT design doc created
- New: docs/development/current/main/phase80-bindingid-p3p4-plan.md (336 lines)
- Pattern3/4 BindingId wiring strategy
- Implementation order: 80-B (P3) → 80-C (P4) → 80-D (E2E)
- Code examples and success metrics
- Fallback detection mechanism (existing log tags)

Design principles (consistent with Phase 74-79):
- Dev-only code (feature-gated)
- Dual-path maintained (BindingId priority + name fallback)
- Structural detection only (NO by-name branching)
- Fail-Fast error handling
- Zero production impact

Updated docs:
- 01-JoinIR-Selfhost-INDEX.md: Phase 79 Activation status
- 10-Now.md: Phase 80 tasks 80-0/80-A complete
- 20-Decisions.md: BindingId migration complete status
- joinir-architecture-overview.md: Phase 79/80 sections

Next: Task 80-B (Pattern3 BindingId registration)
2025-12-13 17:26:15 +09:00

4.0 KiB
Raw Blame History

JoinIR / Selfhost INDEX読み始めガイド

Status: Active
Scope: JoinIR と SelfhostStageB/Stage1/Stage3に関する「最初に読むべき現役ドキュメント」だけを集約した入口。

このファイルは、JoinIR と Selfhost ラインの主戦場をすばやく把握するためのインデックスだよ。
歴史メモや詳細な Phase 文書に飛ぶ前に、まずここに載っている現役ドキュメントから辿っていくことを想定しているよ。


1. まず全体像だけ掴みたいとき

  • JoinIR 全体像SSOT
    • docs/development/current/main/joinir-architecture-overview.md
  • Selfhost / StageB〜3 の代表フロー
    • docs/development/current/main/selfhost_stage3_expected_flow.md
  • 「いまどこまで進んでいるか」の現状サマリ
    • docs/development/current/main/10-Now.md
      • 「JoinIR / Loop / If ライン」
      • 「JsonParser / Selfhost depth2 ライン」

2. JoinIR をこれから触る人向け

JoinIR の箱構造と責務、ループ/if の lowering パターンを把握したいときの読み順だよ。

  1. JoinIR の基本設計SSOT
    • docs/development/current/main/joinir-architecture-overview.md
  2. ループパターン空間とパターン番号の意味
    • docs/development/current/main/loop_pattern_space.md
  3. Boundary / ExitLine / Carrier の具体パターン
    • docs/development/current/main/joinir-boundary-builder-pattern.md
  4. Scope/BindingIdshadowing・束縛同一性の段階移行
    • docs/development/current/main/phase73-scope-manager-design.md
    • docs/development/current/main/PHASE_74_SUMMARY.md
    • docs/development/current/main/PHASE_75_SUMMARY.md
    • docs/development/current/main/PHASE_77_EXECUTIVE_SUMMARY.md
    • docs/development/current/main/phase78-bindingid-promoted-carriers.md
    • docs/development/current/main/phase80-bindingid-p3p4-plan.mdP3/P4 への配線計画)
  5. 代表的な Phase 文書(現役ラインとの接点だけ絞ったもの)
    • docs/development/current/main/phase33-16-INDEX.md
    • docs/development/current/main/phase33-17-joinir-modularization-analysis.md
    • docs/development/current/main/phase183-selfhost-depth2-joinir-status.md

Phase 文書は歴史や検証ログも含むので、「JoinIR の現役設計を確認した上で、必要なときだけ掘る」という前提で読んでね。


3. SelfhostStageB / Stage1 / Stage3を触る人向け

自己ホストコンパイラのフローや実行手順、Ny Executor ラインの計画を押さえたいときの読み順だよ。

  1. Selfhost 全体フローStageB / Stage1 / Stage3 と JSON v0
    • docs/development/current/main/selfhost_stage3_expected_flow.md
  2. 実行手順・クイックスタート
    • docs/development/selfhosting/quickstart.md
    • docs/development/testing/selfhost_exe_stageb_quick_guide.md
  3. Ny ExecutorNy で MIR(JSON v0) を実行)のロードマップ
    • docs/development/roadmap/selfhosting-ny-executor.md
  4. Stage3 / depth2 関連で「現役」として参照する Phase 文書
    • docs/development/current/main/phase150_selfhost_stage3_depth1_baseline.md
    • docs/development/current/main/phase150_selfhost_stage3_depth1_results.md
    • docs/development/current/main/phase183-selfhost-depth2-joinir-status.md
    • docs/development/current/main/phase120_selfhost_stable_paths.md

4. 迷ったときの読み分けガイド

  • JoinIR の箱や契約で迷っているとき
    • → 2章の 1〜3 をこの順番で読む。
  • Selfhost のビルド / 実行フローで迷っているとき
    • → 3章の 1〜3 をこの順番で読む。
  • 「この Phase 文書は現役か?」で迷ったとき
    • → まず docs/development/current/main/10-Now.md
      docs/development/current/main/30-Backlog.md を確認し、そこで名前が挙がっている Phase 文書を優先して読んでね。