英語版: Index

vfs Interfaces

1. 責務の境界 (Responsibility Boundary)

Vfs は知能資産の保存・取得境界を抽象化します。IVfsProvider は認証済みセッションを開き、セッション、ファイル、ディレクトリの capability interface が provider の実際に提供できる操作のみを公開します。具体的データ構造は DTO 層へ分離します。

Vfs の権限は、実行時に遅延失敗させるメソッドではなく、実装されている capability interface によって表現します。読み取り専用 provider は読み取り可能な session/file contract のみを公開し、write/delete 操作の実装を強制されません。

2. 関連ユースケース (Related UCs)

• UC-01 ROM 構造のロードと解析
• UC-09 実行状態の永続化と復元
• UC-20 決定論的リプレイと監査証跡

3. 関連仕様 (Related Specs)

• 03.ROM_CORE_SPEC-jp.md
• 06.REPLAY_DUMP_SPEC-jp.md

4. 依存境界 (Dependency Boundary)

• Contract owner: AIKernel.Abstractions
• Public namespace: AIKernel.Vfs
• DTO dependency: AIKernel.Dtos.Vfs
• Package: これらの contract は AIKernel.Abstractions から直接公開する。個別の AIKernel.Vfs 互換 package は v0.0.4 で削除された
• Called by: AIKernel.Abstractions.Rom, AIKernel.Abstractions.Hosting, AIKernel.Abstractions.Execution

境界ルール

• Vfs interface contract は Abstractions assembly が所有し、具象データキャリアは AIKernel.Dtos.Vfs に定義する。
• AIKernel.Vfs は公開 namespace であり、個別 package/project dependency ではない。
• Capability の有無は、NotSupportedException を投げる placeholder method ではなく、実装 interface によって表現する。
• IVfsFile, IVfsDirectory, IVfsSession は、従来の全体 surface を必要とする呼び出し元のための互換合成 contract として残す。

ドキュメント一覧

• IVfsProvider
• Vfs Capability Contracts

変更履歴

• v0.0.0 / v0.0.0.0: 初期ドラフト
• v0.0.1 (2026-05-06): ドキュメント規約に基づくバージョン更新
• v0.0.2 (2026-05-09): Capability-based Vfs interface segregation を追加
• v0.0.3 (2026-06-02): Abstractions 所有と AIKernel.Vfs type-forwarding facade を明確化
• v0.0.4 (2026-06-04): 公開 namespace を維持したまま個別の AIKernel.Vfs 互換 package を削除