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

BoxFactory Priority 問題と解決策

現状の問題

FactoryPolicy の種類

ポリシー	優先順位	状態
StrictPluginFirst	Plugin > User > Builtin	理想（実装済・未使用）
CompatPluginFirst	Plugin > Builtin > User	互換（実装済・未使用）
BuiltinFirst	Builtin > User > Plugin	現デフォルト（問題）

問題の詳細

場所: src/box_factory/mod.rs::UnifiedBoxRegistry::new()

// 現在の実装（問題）- Line 120-122
impl UnifiedBoxRegistry {
    pub fn new() -> Self {
        Self::with_policy(FactoryPolicy::BuiltinFirst)  // ← ここが問題
    }
}

影響:

• プラグイン版 StringBox が無視される
• プラグイン版 ArrayBox が無視される
• プラグイン版 MapBox が無視される
• Phase 15.5 で特定された優先度問題の根本原因

環境変数による回避:

NYASH_BOX_FACTORY_POLICY=strict_plugin_first ./target/release/nyash program.hako

しかし、これは一時的な回避策であり、デフォルト動作が間違っている。

既存の実装状況

良いニュース: with_env_policy() は既に実装済み（Line 134-146）

pub fn with_env_policy() -> Self {
    let policy = match std::env::var("NYASH_BOX_FACTORY_POLICY").ok().as_deref() {
        Some("compat_plugin_first") => FactoryPolicy::CompatPluginFirst,
        Some("builtin_first") => FactoryPolicy::BuiltinFirst,
        Some("strict_plugin_first") | _ => FactoryPolicy::StrictPluginFirst, // Plugin First DEFAULT!
    };

    eprintln!(
        "[UnifiedBoxRegistry] 🎯 Factory Policy: {:?} (Phase 15.5: Everything is Plugin!)",
        policy
    );
    Self::with_policy(policy)
}

問題: new() が with_env_policy() を呼ばず、ハードコードされた BuiltinFirst を使用。

is_reserved_type() の実装状況

場所: src/box_factory/mod.rs Line 176-194（rebuild_cache内のローカル関数）

現在の core_required リスト:

• StringBox
• IntegerBox
• BoolBox
• FloatBox
• NullBox
• ArrayBox
• MapBox
• ResultBox
• MethodBox

環境変数サポート:

• NYASH_USE_PLUGIN_BUILTINS=1: 予約型保護を解除（既に実装済み）
• NYASH_PLUGIN_OVERRIDE_TYPES=Type1,Type2: 個別指定（既に実装済み）

---

Phase 86 の目標ポリシー

基本方針

Box 種別	ポリシー	環境変数 override
core_required	Builtin 固定（予約名）	NYASH_USE_PLUGIN_BUILTINS=1 で可
それ以外	Plugin が Builtin override 可	デフォルト動作
BuiltinFirst	Legacy 専用（非推奨）	CI/古いプロファイルのみ

core_required Box リスト

Phase 85 調査結果および既存実装より：

Core value types:

• StringBox
• IntegerBox
• BoolBox
• FloatBox
• NullBox

Core containers and result:

• ArrayBox
• MapBox
• ResultBox

Core method indirection:

• MethodBox

ConsoleBox の扱い:

• Phase 85 調査では core_required とされたが、現在の is_reserved_type() には含まれていない
• Phase 86 では既存実装を尊重し、ConsoleBox を予約型に追加しない
• 将来的に必要であれば Phase 85 で再検討

これらは is_reserved_type() で保護される（既に実装済み）。

デフォルトポリシー

新デフォルト: StrictPluginFirst

理由:

1. ✅ プラグインによる拡張を優先（Nyash の設計思想）
2. ✅ core_required は予約名保護で安全性を確保
3. ✅ 開発者の期待に合致（プラグインが優先されるべき）
4. ✅ "Everything is Plugin" 哲学の体現

環境変数

環境変数	用途	デフォルト値
NYASH_BOX_FACTORY_POLICY	ポリシー選択	strict_plugin_first
NYASH_USE_PLUGIN_BUILTINS	core_required override 許可	未設定（無効）
NYASH_PLUGIN_OVERRIDE_TYPES	個別 Box override 許可	未設定（空）

使用例:

# core_required もプラグイン版を使用（開発用）
NYASH_USE_PLUGIN_BUILTINS=1 ./target/release/nyash program.hako

# 特定 Box のみプラグイン版を使用
NYASH_PLUGIN_OVERRIDE_TYPES=StringBox,ArrayBox ./target/release/nyash program.hako

# Legacy モード（古いテスト用）
NYASH_BOX_FACTORY_POLICY=builtin_first ./target/release/nyash program.hako

---

Phase 86 実装内容

修正箇所

1つの修正のみ: UnifiedBoxRegistry::new() を変更

// Before (Line 120-122)
impl UnifiedBoxRegistry {
    pub fn new() -> Self {
        Self::with_policy(FactoryPolicy::BuiltinFirst)
    }
}

// After
impl UnifiedBoxRegistry {
    pub fn new() -> Self {
        Self::with_env_policy()  // with_env_policy() を使用
    }
}

変更理由:

• with_env_policy() は既に完全実装済み（Line 134-146）
• デフォルトで StrictPluginFirst を返す
• 環境変数 NYASH_BOX_FACTORY_POLICY による制御も完全対応
• is_reserved_type() による保護も実装済み
• 追加実装は不要！

追加実装は不要

以下の機能は既に実装済み：

• ✅ with_env_policy() の実装（Line 134-146）
• ✅ is_reserved_type() の実装（Line 176-194）
• ✅ 環境変数 NYASH_USE_PLUGIN_BUILTINS のサポート（Line 178-184）
• ✅ 環境変数 NYASH_PLUGIN_OVERRIDE_TYPES のサポート（Line 179-183）
• ✅ Policy-based priority ordering（Line 224-256）

Phase 86 の本質:

• デフォルト動作を正常化する（1行の変更）
• 既存の完全実装を活用する
• テストで検証する

---

テスト戦略

追加するテスト（5件）

ファイル: src/box_factory/mod.rs の #[cfg(test)] mod tests セクション

1. test_default_policy_is_strict_plugin_first

   • new() のデフォルトポリシーを確認

2. test_env_policy_override

   • 環境変数 NYASH_BOX_FACTORY_POLICY の動作確認

3. test_reserved_type_protection

   • 予約型が非 builtin factory で登録されないことを確認

4. test_plugin_override_with_env

   • NYASH_USE_PLUGIN_BUILTINS=1 での予約型 override を確認

5. test_non_reserved_plugin_priority

   • 非予約型（FileBox等）が plugin で override できることを確認

---

完了条件

• ✅ docs/development/current/main/factory_priority.md 作成完了
• ✅ UnifiedBoxRegistry::new() が with_env_policy() を使用
• ✅ デフォルトポリシーが StrictPluginFirst
• ✅ is_reserved_type() が Phase 85 の core_required リストと一致（既存実装確認）
• ✅ テスト 5件追加・全パス
• ✅ CURRENT_TASK.md 更新完了
• ✅ Phase 85 README 準備完了

---

次のステップ（Phase 85）

Phase 86 完了後、Phase 85 で以下を実施：

• Ring0/Ring1-Core 境界の文書化
• core_required Box の最終確定
• ConsoleBox の扱いの再検討

Phase 86 は Phase 85 の土台を安定させるための準備フェーズ。