Files

nyash-codex cef820596f FileBox SSOT設計移行完了: Provider Pattern実装

## 🎯 目的
FileBoxをSSOT（Single Source of Truth）設計に移行し、
static/dynamic/builtin providerを統一的に扱える基盤を構築。

## ✅ 実装完了（7タスク）

### 1. Provider Lock Global
**File**: `src/runtime/provider_lock.rs`
- `FILEBOX_PROVIDER: OnceLock<Arc<dyn FileIo>>` 追加
- `set_filebox_provider()` / `get_filebox_provider()` 実装

### 2. VM初期化時のProvider選択
**File**: `src/runner/modes/vm.rs`
- `execute_vm_mode()` 冒頭でprovider選択・登録
- ENV（`NYASH_FILEBOX_MODE`, `NYASH_DISABLE_PLUGINS`）対応

### 3. CoreRoFileIo完全実装
**File**: `src/boxes/file/core_ro.rs` (NEW)
- Read-onlyファイルI/O実装
- Thread-safe: `RwLock<Option<File>>`
- Newline正規化（CRLF→LF）

### 4. FileBox委譲化
**File**: `src/boxes/file/mod.rs`
- 直接`std::fs::File`使用 → `Arc<dyn FileIo>` provider委譲
- 全メソッドをprovider経由に変更
- Fail-Fast: write/delete等の非対応操作は明確エラー

### 5. basic/file_box.rs Deprecate
**File**: `src/boxes/file/basic/file_box.rs`
- 120行 → 12行に削減
- `#[deprecated]` マーク + 再エクスポート
- 後方互換性維持

### 6. Feature Flag追加
**File**: `Cargo.toml`
- `builtin-filebox = []` feature追加

### 7. Provider抽象・選択ロジック
**Files**:
- `src/boxes/file/provider.rs` (NEW) - FileIo trait定義
- `src/boxes/file/box_shim.rs` (NEW) - 薄いラッパー
- `src/runner/modes/common_util/provider_registry.rs` (NEW) - 選択ロジック

## 📊 アーキテクチャ進化

**Before**:
```
FileBox (mod.rs) ──直接使用──> std::fs::File
FileBox (basic/)  ──直接使用──> std::fs
```

**After**:
```
FileBox ──委譲──> Arc<dyn FileIo> ──実装──> CoreRoFileIo
                                        ├──> PluginFileIo (future)
                                        └──> BuiltinFileIo (future)
```

## 🔧 技術的成果

1. **Thread Safety**: `RwLock<Option<File>>` で並行アクセス安全
2. **Fail-Fast**: 非対応操作は明確エラー（silent failure無し）
3. **後方互換性**: deprecated re-exportで既存コード維持
4. **環境制御**: `NYASH_FILEBOX_MODE` でランタイム切替

## 📝 環境変数

- `NYASH_FILEBOX_MODE=auto|core-ro|plugin-only`
  - `auto`: プラグインあれば使用、なければCoreRoにフォールバック
  - `core-ro`: 強制的にCoreRo（read-only）
  - `plugin-only`: プラグイン必須（なければFail-Fast）
- `NYASH_DISABLE_PLUGINS=1`: 強制的にcore-roモード

## 🎯 次のステップ（Future）

- [ ] Dynamic統合（plugin_loaderとの連携）
- [ ] BuiltinFileIo実装（feature builtin-filebox）
- [ ] Write/Delete等の操作対応（provider拡張）

## 📚 ドキュメント

- 詳細仕様: `docs/development/runtime/FILEBOX_PROVIDER.md`

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

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-08 15:13:22 +09:00

abi

builder/vm: stabilize json_lint_vm under unified calls

2025-09-28 12:19:49 +09:00

README.md

📚 Nyash Documentation

🚀 はじめに（導線）

現在のタスクと進行状況: ../CURRENT_TASK.md
コア概念の速習: reference/architecture/nyash_core_concepts.md
設計ブループリント（文字列/文字コード）: development/design/blueprints/strings-utf8-byte.md

📂 ドキュメント構造（指針）

📖 reference/ - 正式な技術仕様

language/ - 言語仕様（構文、型システム、Box仕様）
architecture/ - システムアーキテクチャ（MIR、VM、実行バックエンド）
api/ - ビルトインBoxのAPI仕様
plugin-system/ - プラグインシステム、BID-FFI仕様
- 🆕🔥 TypeBox ABI統合 + セルフホスティング - ABIすらBoxとして扱う革命的設計！
- まずはこちら: reference/boxes-system/plugin_lifecycle.md（PluginBoxV2のライフサイクル、singleton、nyash.tomlの要点）

📚 guides/ - 利用者向けガイド

getting-started.md - はじめに（統一版）
tutorials/ - ステップバイステップのチュートリアル
examples/ - 実践的なサンプルコード
wasm-guide/ - WebAssemblyビルドガイド

🧩 how-to/ - 目的別ハウツー

手順重視の短いガイド（前提→コマンド→検証）

🔧 development/ - 開発者向け

current/ - 現在進行中のタスク（CURRENT_TASK.md等）
roadmap/ - 開発計画
- phases/ - Phase 8～12の詳細計画
- phase-12/ - 🆕🔥 TypeBox統合ABI + Nyash ABI C実装（セルフホスティング実現！）
- native-plan/ - ネイティブビルド計画
proposals/ - RFC、新機能提案

🔌 Net Plugin（HTTP/TCP）

使い方と仕様: reference/plugin-system/net-plugin.md

🗄️ archive/ - アーカイブ

consultations/ - AI相談記録（gemini/chatgpt/codex）
decisions/ - 過去の設計決定
build-logs/ - ビルドログ、ベンチマーク結果
old-versions/ - 古いドキュメント

🎯 クイックアクセス

すぐ始める

guides/getting-started.md
guides/language-guide.md
guides/p2p-guide.md

技術リファレンス

reference/language/LANGUAGE_REFERENCE_2025.md
reference/language/EBNF.md（演算子: ! 採用 / do-while 非採用）
reference/language/strings.md（UTF‑8/Byte 二本柱）
reference/architecture/TECHNICAL_ARCHITECTURE_2025.md
reference/architecture/execution-backends.md
reference/runtime/gc.md
reference/plugin-system/
tools/cli-options.md（CLI早見表）

デザイン/ガイド

guides/language-core-and-sugar.md（コア最小＋糖衣）
guides/loopform.md（ループ正規化）
guides/scopebox.md（開発時の可視化）
guides/dev-local-alias.md（開発向け: 行頭 @name = expr → local 宣言糖衣）
guides/box-patterns.md（Boxパターン集：Ownership/Lease/Cancel/Capability/Affinity/Observable）
guides/box-design-checklist.md（Box 設計チェックリスト）
proposals/concurrency/boxes.md（並行モデルのBox設計：Routine/Channel/Select/Scope）
reference/concurrency/semantics.md（ブロッキング/close/select/観測の規約）
design/（設計ノート入口）
- development/design/legacy/flow-blocks.md（矢印フロー／匿名ブロック・設計草案）
- development/proposals/scope-reuse.md（スコープ再利用ブロック・MVP提案）
- reference/language/match-guards.md（ガード連鎖／Range・CharClass設計）
- guides/core-principles.md（最小構文・ゼロランタイム・可視化の原則）

開発状況

現在のタスク
開発ロードマップ
Phase別計画
- 🔥 Phase 12: TypeBox統合ABI
- 🔥 Phase 16: マクロ革命
- 🧪 Phase 17: LoopForm Self‑Hosting
- 💡 Rust所有権統合（候補） - Phase 17+候補
🧩 Mini‑VM 構築ロードマップ
🧭 Using→Loader 統合（最小設計）: development/design/legacy/using-loader-integration.md
🗂️ Docsの書き方（小さく・リンク駆動）: guides/contributing-docs.md

📋 再編成について / フォルダの見分け方

ドキュメントは2025年8月20日に再編成されました。詳細はREORGANIZATION_REPORT.mdを参照してください。

旧パスから新パスへの主な変更：

説明書/ → guides/ と reference/ に分割
予定/ → development/roadmap/
散在していたファイル → 適切なカテゴリに整理

補足:

reference/ は正本（仕様）。
guides/ は読み物、how-to/ は手順書。
design/ は公開できる設計ノート。
private/ は下書き保管庫（将来 reference//design/ に昇格）。

Nyash は「Everything is Box」哲学に基づく言語です。詳細はコア概念とガイドを参照してください。

README.md Unescape Escape