hakorune/docs/development/current/main/phase173_task1_investigation.md

Phase 173 Task 1: 名前解決経路調査結果

調査日時

2025-12-04

1. 現状の名前解決経路

1.1 AST表現の確認

using文の処理

• ファイル: lang/src/compiler/pipeline_v2/using_resolver_box.hako
• 機能: using tools.hako_shared.json_parser as JsonParserBox を解決
• 実装:
  • resolve_path_alias(): エイリアスからファイルパスを解決
  • resolve_namespace_alias(): 名前空間エイリアスを tail マッチングで解決
  • JSON文字列ベースの単純検索（正規表現不使用）

静的Boxメソッド呼び出しの現状

• 呼び出し形式: JsonParserBox.parse(json_text)
• 問題点:
  • JsonParserBox は using ... as JsonParserBox で import されたエイリアス
  • パーサーは JsonParserBox.parse() を「インスタンスメソッド呼び出し」として解釈
  • 実際には「静的Boxの静的メソッド呼び出し」であるべき

1.2 MIR Loweringの確認

Callee解決システム

• ファイル: src/mir/builder/calls/resolver.rs
• 実装: CalleeResolverBox によるCallee解決
• 処理フロー:
  1. CallTarget::Method { box_type, method, receiver } として受け取る
  2. infer_box_type() で Box 名を推論
  3. classify_box_kind() で Box 種別を分類（StaticCompiler/RuntimeData/UserDefined）
  4. Callee::Method { box_name, method, receiver, box_kind, certainty } に変換

Box種別分類

• ファイル: src/mir/builder/calls/call_unified.rs
• 関数: classify_box_kind()
• 分類:
  • StaticCompiler: StageBArgsBox, ParserBox, UsingResolverBox 等
  • RuntimeData: MapBox, ArrayBox, StringBox 等
  • UserDefined: その他すべて

問題点:

• JsonParserBox は StaticCompiler でも RuntimeData でもなく UserDefined に分類される
• しかし実際には static box として扱うべき

1.3 エラー発生箇所の特定

Phase 171-2 で発見されたエラー

[ERROR] ❌ [rust-vm] VM error: Invalid instruction: Unknown method '_skip_whitespace' on InstanceBox

根本原因:

1. using tools.hako_shared.json_parser as JsonParserBox で import
2. JsonParserBox.parse(json_text) として呼び出し
3. MIR lowering で「インスタンスメソッド呼び出し」として解釈
4. VM 実行時に InstanceBox として扱われる
5. 内部メソッド _skip_whitespace が見つからない

証拠:

• tools/hako_shared/tests/json_parser_simple_test.hako は using を使わず、JsonParserBox 全体をインライン化
• コメント: "Test JsonParserBox without using statement"
• → using statement 経由だと動作しないことが明示的に回避されている

2. AST構造の詳細

2.1 静的Boxの定義

static box JsonParserBox {
  method parse(json_str) {
    // ...
  }

  method _skip_whitespace(s, pos) {
    // 内部メソッド
  }
}

• static box として定義
• すべてのメソッドは静的メソッド（me. で自己参照）
• インスタンス化不要（シングルトン的動作）

2.2 using statement

using tools.hako_shared.json_parser as JsonParserBox

• tools.hako_shared.json_parser: ファイルパス（.hako 省略）
• JsonParserBox: エイリアス名
• 期待動作: エイリアスを static box の型 として登録

2.3 呼び出し形式

local v = JsonParserBox.parse("{\"x\":1}")

• 期待: JsonParserBox は静的Box名として解決
• 現状: 変数名として解決 → インスタンスメソッド呼び出しとして処理
• 問題: TypeRef（型参照）と VarRef（変数参照）の区別がない

3. 問題の構造化

3.1 名前解決の段階

1. using 解決 (lang/src/compiler/pipeline_v2/using_resolver_box.hako)

   • ✅ ファイルパスの解決は動作
   • ❌ エイリアスの「型としての登録」がない

2. パーサー (lang/src/compiler/parser/*)

   • ❌ Alias.method() を TypeRef として認識しない
   • ❌ VarRef として処理される

3. MIR lowering (src/mir/builder/calls/resolver.rs)

   • ❌ CallTarget::Method で receiver が ValueId
   • ❌ 静的Box呼び出しの判別条件がない

3.2 必要な修正箇所

A. using resolver (.hako 側)

ファイル: lang/src/compiler/pipeline_v2/using_resolver_box.hako

必要な機能:

• 静的Box名を「型」として環境に登録
• エイリアス → 静的Box の対応を保持
• パーサーに引き渡す context に型情報を含める

B. パーサー (.hako 側)

ファイル: lang/src/compiler/parser/parser_*.hako

必要な機能:

• Alias.method() の AST 表現を追加
• フラグ: is_static_box_call: true を付与
• ノード種別: StaticBoxMethodCall 的な kind を追加

C. MIR lowering (Rust 側)

ファイル: src/mir/builder/calls/resolver.rs, call_unified.rs

必要な機能:

• AST の is_static_box_call フラグを確認
• 静的Box呼び出しの場合、receiver を無視
• Callee::Global("BoxName.method/arity") として解決
• または Callee::Method { box_name: "JsonParserBox", ... } で box_kind を StaticCompiler に設定

4. 追加の問題発見

4.1 JsonParserBox の無限ループバグ

症状:

[ERROR] ❌ [rust-vm] VM error: vm step budget exceeded (max_steps=1000000, steps=1000001)
at bb=bb338 fn=JsonParserBox._parse_number/2

原因: _parse_number() メソッドに無限ループがある可能性

影響:

• 現時点では簡単なJSON ({\"x\":1}) でも動作しない
• Phase 171-2 の実装確認が困難

対応:

• Phase 173 とは別に JsonParserBox のバグ修正が必要
• または Phase 173 では別の静的Box（より単純なもの）でテスト

4.2 パーサーの構文制限

症状:

❌ Parse error: Unexpected token DOT, expected LPAREN at line 5
local parser = new JsonLib.JsonParserBox()
                          ^^^

原因: new Alias.BoxName() 構文がサポートされていない

影響:

• 静的Box内の Box 定義をインスタンス化できない
• 名前空間的な使用ができない

対応:

• Phase 173 では Alias.method() の直接呼び出しのみに集中
• new Alias.BoxName() は Phase 174+ で対応

5. 推奨される実装戦略

戦略A: 最小限の修正（推奨）

1. JsonParserBox のバグ修正を先行

   • _parse_number() の無限ループを修正
   • 簡単な JSON で動作確認

2. using resolver に型登録を追加

   • load_modules_json() で静的Box情報も保持
   • to_context_json() に型情報を含める

3. パーサーに最小限のフラグ追加

   • Alias.method() を検出時に is_static_box_call: true
   • AST ノードに追加

4. MIR lowering で判別処理追加

   • is_static_box_call フラグを確認
   • Callee::Global("BoxName.method/arity") に変換

戦略B: 包括的な対応（Phase 174+）

1. HIR層の導入
2. 型システムの拡張
3. 明示的スコープ演算子（::）のサポート

6. 次のステップ

Task 2: 仕様固定

• using.md に静的Box using のパターンを追記
• LANGUAGE_REFERENCE_2025.md に static box ライブラリ利用方針を追加
• 許容する呼び方を明確化（Alias.method() のみ、new Alias.Box() は Phase 174+）

Task 3: JsonParserBox バグ修正

• _parse_number() の無限ループ原因を特定
• 修正実装
• 簡単な JSON ({"x":1}) で動作確認

Task 4: using resolver 修正

• 静的Box型情報の登録実装
• context JSON への型情報含め
• テスト確認

Task 5: パーサー修正

• Alias.method() 検出実装
• AST フラグ追加
• テスト確認

Task 6: MIR lowering 修正

• 静的Box呼び出し判別条件追加
• Callee 解決実装
• テスト確認

7. リスク評価

高リスク

• JsonParserBox の無限ループバグ（Task 3 で対応必要）
• パーサー変更による既存コードへの影響
• using resolver の型登録による互換性問題

中リスク

• MIR lowering の複雑化
• VM 実行時の予期しないエラー
• テストケース不足

低リスク

• ドキュメント更新のみ
• 段階的な実装による影響範囲の限定

8. 成果物チェックリスト

• AST 表現の確認（using statement, 静的Box呼び出し）
• MIR lowering の確認（CalleeResolverBox, classify_box_kind）
• エラー発生箇所の特定（Phase 171-2 エラー分析）
• 追加問題の発見（JsonParserBox 無限ループ、パーサー構文制限）
• 推奨戦略の提案（戦略A: 最小限、戦略B: 包括的）
• JsonParserBox バグ修正（次タスク）
• 仕様ドキュメント作成（Task 2）

---

作成日: 2025-12-04 調査時間: 約2時間 次のタスク: Task 3（JsonParserBox バグ修正）または Task 2（仕様固定）