[RFC] (Target: v0.0.2)Interface Segregation for VFS: Transitioning to Capability-Based Abstractions

[egumaru]

English (英語)

Abstract:
The current interfaces, including IVfsFile, intentionally integrate read, write, and directory operations into a single contract. This was a strategic decision during the initial conceptual phase to minimize the blast radius of trial and error and to ensure rapid synchronization with documentation.

Now that the project has reached structural stability following v0.0.1, we are considering the segregation of these interfaces (ISP) for the upcoming v0.0.2 release. This will manifest AIKernel.NET's core philosophy of "Capability-Based Governance" at the type-system level. Additionally, we plan to review and refine interfaces as necessary alongside the implementation of standard Providers.

Objectives:

• Capability-Based Permissions: Explicitly define permissions via the type system, ensuring that implementations like WebGetFile (read-only) are not forced to implement unnecessary methods.
• Refinement & Compatibility: Decompose the monolithic interface into IReadableVfs, IWritableVfs, and INavigableVfs, then redefine IVfsFile as a composite of these. This approach increases design resolution while minimizing the impact on existing code.
• Step Towards Maturity: By pursuing further abstraction before the major v0.1.0 milestone, we will establish an even more extensible and robust foundation.

Roadmap:
This change will not be implemented immediately; it is scheduled for the v0.0.2 milestone. Our current priority remains the stabilization of the Core and the implementation of standard Providers (MemoryFile, LocalFile, and WebGetFile) based on the existing IVfsFile contract.

Japanese (日本語)

概要:
IVfsFile をはじめとする現在のインターフェースは、初期構想段階における試行錯誤の影響範囲を最小化し、ドキュメントとの整合性を迅速に確保するために、あえて読み取り、書き込み、およびディレクトリ操作を一つのインターフェースに統合しています。

プロジェクトが v0.0.1 を経て構造的に安定し始めた今、AIKernel.NETの核心である「能力ベースの統治」を型レベルで実現するため、次期バージョン v0.0.2 に向けてインターフェースの分離（ISP）を検討しています。
その他、標準Provider等の実装に伴い、Interfaceを必要に応じて見直しを予定しています。

意図:

• 能力ベースの権限管理: WebGetFile（読み取り専用）のような実装に対し、不要なメソッドの実装を強制せず、型システムによって権限を明示する。
• 設計の純化と互換性: 巨大なインターフェースを IReadableVfs, IWritableVfs, INavigableVfs 等に分解し、それらを合成する形で IVfsFile を再定義する。これにより、既存コードへの影響を最小限に抑えつつ、設計の解像度を高める。
• 成熟へのステップ: v0.1.0 という大きな節目を迎える前に、更なる抽象化を行い、拡張可能な基盤を作り上げます。

対応計画:
本件は直ちには実施せず、v0.0.2 のマイルストーンにおいて対応予定です。現在は現行の IVfsFile を基準に、標準Provider（MemoryFile, LocalFile, WebGetFile）の実装と、それらを統合する Core の安定化に注力します。