docs(phase 105): Logger Box Framework設計&ドキュメント整備

- Create logger_box_design.md: comprehensive Logger Box framework design
- Define 3 reference patterns (Lightweight/Structured/Contextual)
- Add pseudo-code examples for each pattern (reference only)
- Update logging_policy.md: add Logger Box reference
- Update hako_logging_design.md: Logger Box integration with Phase 104
- Update ring0-inventory.md: Phase 105 entry
- Update CURRENT_TASK.md: Phase 105 completion + Phase 106+ backlog

Design principles:
- Logger Box provides level-based logging (DEBUG/INFO/WARN/ERROR)
- Phase 105 scope: ConsoleBox output only
- Phase 106 scope: output redirection (FileBox/NetworkBox)
- Reference examples for documentation (execution testing Phase 106+)

This completes the structured logging framework design, building on
Phase 99 (logging policy), Phase 100-101 (Rust logging), Phase 104
(.hako patterns), and Phase 105.5 (console macro unification).
This commit is contained in:
nyash-codex
2025-12-03 14:33:04 +09:00
parent ea4c164dae
commit f8790b13cc
5 changed files with 542 additions and 1 deletions

View File

@ -263,6 +263,21 @@
- ✅ internal/dev println!/eprintln! 113箇所を Ring0.log に移行provider_lock / plugin_loader_unified / type_meta / deprecations / leak_tracker / provider_verify / scheduler / gc_controller / box_registry / plugin_loader_v2 周辺 / runner trace / mir verifier / mir core basic_block/control_form/hints/effect/printer/optimizer / loop_builder/phi_ops / builder/type_registry / region/observer / extern_functions / plugin types finalize trace / joinir_if_phi_selector / observe/types+resolve / join_ir_vm_bridge_dispatch run_generic / loop_builder/control など)
- ✅ logging_policy.md / ring0-inventory.md にテスト出力許容ポリシーと残件概算を追記(残 ~475495
- ⏭️ 残り internal/dev ログは Phase 101-C 以降で段階的に処理user-facing/.hako は別ライン)
- **Phase 104: .hako側ロギング設計**2025-12-04
- ✅ ConsoleBox適切な使い方ガイド作成
- ✅ 4つのロギングカテゴリ確立user-facing/dev-debug/monitoring/internal Rust
- ✅ 3つのロギングBoxパターン設計Lightweight/Structured/Contextual
- ✅ hako_logging_design.md 作成、logging_policy.md 更新
- **スコープ**: .hako アプリケーション側のロギングベストプラクティス確立
- **Phase 105: Logger Box Framework設計**2025-12-04← NEW
- ✅ Logger Box インターフェース設計(ログレベル: DEBUG/INFO/WARN/ERROR
- ✅ 3つの設計パターン文書化Lightweight/Structured/Contextual
- ✅ リファレンス実装例作成pseudo-code、実行テストは Phase 106+
- ✅ logger_box_design.md 作成500+ lines
- ✅ logging_policy.md / hako_logging_design.md / ring0-inventory.md にクロスリファレンス追加
- **スコープ**: 設計ドキュメントのみRust実装なし、Phase 106+で実装)
- **成果**: ConsoleBox基盤の構造化ロギングフレームワーク確立
- **次のステップ**: Phase 106FileBox/NetworkBox出力リダイレクト、Phase 107アプリ移行
12. **Phase 86: BoxFactory Priority 正常化****完了**2025-12-02
- **目的**: BoxFactory のデフォルトポリシーを `BuiltinFirst` から `StrictPluginFirst` に変更し、プラグイン版 Box が正常に使用できるよう正常化。
@ -280,6 +295,25 @@
### バックログ
#### ロギングフレームワーク拡張Phase 106+
- **Phase 106: Logger Box 出力リダイレクト**
- Logger Box から FileBox へのログ出力機能実装
- Logger Box から NetworkBox へのリモートログ送信機能実装
- Phase 105 で設計した interface 互換性維持
- **Phase 107: アプリケーション移行**
- hako_check を Logger Box 使用に移行
- selfhost-compiler を Logger Box 使用に移行
- Nyash ツール全体のロギング標準化
- **Phase 108+: 高度ロギング機能**
- 構造化ロギングJSON format
- ログアグリゲーション
- パフォーマンスメトリクス
#### その他
- StageB/selfhost smokes の扱い整理Phase 30.1 フォロー)
- quick プロファイルで `stage1_launcher_*` / `phase251*` 系が Stage3 デフォルト環境で不安定。今後、quick では SKIP にするか、StageB emit 抽出ロジックを安定化するかを決める。
- `MirFunction.blocks: HashMap``BTreeMap` で非決定的テスト解消