889492b617
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)
79 lines
4.0 KiB
Markdown
79 lines
4.0 KiB
Markdown
# JoinIR / Selfhost INDEX（読み始めガイド）
|
||
|
||
Status: Active
|
||
Scope: JoinIR と Selfhost（Stage‑B/Stage‑1/Stage‑3）に関する「最初に読むべき現役ドキュメント」だけを集約した入口。
|
||
|
||
このファイルは、JoinIR と Selfhost ラインの主戦場をすばやく把握するためのインデックスだよ。
|
||
歴史メモや詳細な Phase 文書に飛ぶ前に、まずここに載っている現役ドキュメントから辿っていくことを想定しているよ。
|
||
|
||
|
||
---
|
||
|
||
## 1. まず全体像だけ掴みたいとき
|
||
|
||
- JoinIR 全体像（SSOT）
|
||
- `docs/development/current/main/joinir-architecture-overview.md`
|
||
- Selfhost / Stage‑B〜3 の代表フロー
|
||
- `docs/development/current/main/selfhost_stage3_expected_flow.md`
|
||
- 「いまどこまで進んでいるか」の現状サマリ
|
||
- `docs/development/current/main/10-Now.md`
|
||
- 「JoinIR / Loop / If ライン」
|
||
- 「JsonParser / Selfhost depth‑2 ライン」
|
||
|
||
---
|
||
|
||
## 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/BindingId（shadowing・束縛同一性の段階移行）
|
||
- `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.md`（P3/P4 への配線計画）
|
||
4. 代表的な 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. Selfhost（Stage‑B / Stage‑1 / Stage‑3）を触る人向け
|
||
|
||
自己ホストコンパイラのフローや実行手順、Ny Executor ラインの計画を押さえたいときの読み順だよ。
|
||
|
||
1. Selfhost 全体フロー（Stage‑B / Stage‑1 / Stage‑3 と 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 Executor（Ny で MIR(JSON v0) を実行）のロードマップ
|
||
- `docs/development/roadmap/selfhosting-ny-executor.md`
|
||
4. Stage‑3 / depth‑2 関連で「現役」として参照する 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 文書を優先して読んでね。
|