Files
hakorune/docs/development/current/main/ring0-inventory.md
nyash-codex 42b09b3c1c feat(phase88): Ring0Context Skeleton implementation
Phase 88: OS API abstraction layer implementation

**Implementation**:
- Ring0Context module added (4 files)
  - mod.rs: Public API, global initialization (OnceLock)
  - traits.rs: MemApi, IoApi, TimeApi, LogApi trait definitions
  - std_impls.rs: std-based default implementations
  - errors.rs: IoError, TimeError type definitions

**Design Principles**:
- Ring0 knows nothing about Box
- Ring0 knows nothing about Nyash
- Pure OS API abstraction

**Global Initialization**:
- NyashRunner::new() initializes Ring0Context globally
- OnceLock ensures safe initialization (idempotent)

**Migration (2 paths)**:
- src/runner/selfhost.rs:27: eprintln! → ring0.log.error() (OOB strict)
- src/runner/selfhost.rs:177: eprintln! → ring0.log.error() (PyVM error)

**Tests**:
- 4 unit tests added (ring0 module)
- All tests passed
- Build successful (0 errors)

**Migration Status**:
- Migrated: 2/3,955 (0.05%)
- Remaining: 3,953 paths (Phase 89+)

**Files Changed**:
- src/runtime/ring0/mod.rs (new, 100 lines)
- src/runtime/ring0/traits.rs (new, 93 lines)
- src/runtime/ring0/std_impls.rs (new, 77 lines)
- src/runtime/ring0/errors.rs (new, 26 lines)
- src/runtime/mod.rs (Ring0Context export)
- src/runner/mod.rs (global initialization)
- src/runner/selfhost.rs (2 paths migrated)
- docs/development/current/main/ring0-inventory.md (Phase 88 status)

Phase 88 complete. Ready for Phase 89 (gradual migration).

🐱
2025-12-02 22:38:27 +09:00

3.4 KiB
Raw Blame History

Ring0 Inventory初回棚卸しメモ

このドキュメントは、Phase 85-ring0-runtime のための「Ring0 候補呼び出し」の棚卸しメモだよ。
ここでは Task 調査で分かった概況だけをまとめておき、詳細な一覧化や移行は後続フェーズで扱う。


1. println!/eprintln! 呼び出し

  • println! / eprintln! の合計呼び出し回数: 3,955 回
    • デバッグログ/一時ログ/ユーザ向けメッセージが混在している。
    • Ring0 の LogApi / Console 相当として、最優先で整理したい対象。
  • 方針メモ:
    • 将来的には Ring0Context.log / Ring0Context.io 経由に寄せる。
    • 代表パスselfhost/hack_check/VM/LLVMprintln!/eprintln! から段階的に移行する。

Phase 88 移行状況2025-12-02

移行済みパス2箇所:

ファイル Before After
src/runner/selfhost.rs 27 eprintln!("[selfhost][oob-strict] ...") ring0.log.error("[selfhost][oob-strict] ...")
src/runner/selfhost.rs 177 eprintln!("❌ PyVM error ...") ring0.log.error("❌ PyVM error ...")

残存パス3,953箇所:

カテゴリ 出現回数 移行予定
println! 2,200 Phase 89-A
eprintln! 1,753 Phase 89-B

Phase 89 以降で段階的に移行予定。


2. Box / プラグイン / カーネル実装の数

  • src/boxes: 34 Box
  • plugins/: 22 プラグイン
  • crates/nyash_kernel: 12 カーネル実装

ざっくり分類案Phase 85 時点の暫定):

  • core_required:
    • StringBox, IntegerBox, BoolBox, ArrayBox, MapBox, ConsoleBox など、言語の基本型+コンソール。
  • core_optional:
    • FileBox, PathBox, RegexBox, MathBox, TimeBox, JsonBox, TomlBox など、標準ユーティリティ系。
  • selfhost_required:
    • Stage1CliBox, AotCompilerBox, MirJsonBuilderBox など、selfhost/Stage1 ライン専用。
  • user_plugin:
    • P2P, HTTP, GUI, Python 連携 等の外部拡張。

※ 正確な一覧とファイルパスは、後続フェーズで Box 定義ファイルを機械的に列挙して作る。


3. Factory Priority 問題Phase 15.5 の再確認)

  • 現状の Factory Priority が BuiltinFirst(ビルトイン優先)となっている箇所があり、
    • プラグインで上書きしたいケースでも、ビルトイン版が優先されてしまう。
  • これは:
    • 「core_required な Box」と「user_plugin を使って差し替えたい Box」の境界が曖昧なことの副作用でもある。
  • 方針メモ:
    • Ring1-core の整理と合わせて、Factory Priority を
      • core_required は常にビルトイン
      • core_optional / user_plugin は設定やプロファイルで切り替え可能 に整理していく。

4. 今後の棚卸しタスクTODO メモ)

  • std::fs / File::open / std::io::stdin などの呼び出し地点を一覧化。
  • SystemTime::now / Instant::now / thread::sleep など時間・スレッド系 API の呼び出し地点を一覧化。
  • hakmem / nyrt 経由の低レベル API 呼び出しalloc/free など)を一覧化。
  • 代表パスselfhost/hack_check/VM/LLVMのみを対象にした「最小 Ring0 呼び出しセット」を定義する。

これらは Phase 8687 で Ring0Context に寄せていくための下準備だよ。