Files
hakorune/docs/development/architecture
nyash-codex b92d9f335d docs(mir-logs): MIRログ観測リスト完成 - __mir__.log 全箇所を分類
Phase 25.4-C: MIR ログ観測リスト作成

## 📋 実装内容

### 1. ログ呼び出し全14箇所を列挙
- `rg "__mir__\\.log" lang/src -n` で全箇所を調査
- ファイル・行番号・タグ・用途を完全文書化

### 2. 3分類に整理

#### Dev専用(11箇所)- 削除候補
- **Stage-1 CLI Debug** (10箇所): entry/config/argc debug
  - 制御: `STAGE1_CLI_DEBUG=1`
  - MIR Builder type confusion デバッグ用
- **StringHelpers Debug** (1箇所): to_i64 input debug
  - 制御: `NYASH_TO_I64_DEBUG=1`
  - Void → Integer 型崩れデバッグ用

#### 観測用(3箇所)- 残す候補
- **FuncScanner Debug** (3箇所): skip_ws loop iteration
  - LoopForm v2 / PHI 生成検証
  - Region+next_i SSA 安定性確認
  - 将来的な「MIR 観測 API」の代表例

#### コメント(1箇所)
- Test file comment

### 3. 将来構想
- `MirLogBox` 箱化構想を記載
- ログレベル制御・構造化ログ・パフォーマンストレース機能
- MIR デバッガー統合の下地

## 技術的成果
- **全箇所可視化**: 14箇所のログ用途を完全把握
- **分類明確化**: Dev専用 vs 観測用を明示
- **将来設計**: MIR 観測 API 構想を文書化

## 文書作成
- 新規: `docs/development/architecture/mir-logs-observability.md`

## 方針
- **Phase 25.4**: ドキュメント整理のみ(コード変更なし)
- **後続フェーズ**: Dev専用ログ削除・観測用ログ API化を検討

## 参考
- Phase 25.4 全体: docs/development/roadmap/phases/phase-25.4-naming-cli-cleanup/README.md

🎉 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 09:48:08 +09:00
..