VeryFS.Core

Project Hub | Call for Contributions

VeryFS.Core is the minimal core library for the AI-native VeryFS virtual filesystem. It owns the namespace, mount registry, resource identity, API contract, access control, and workspace materialization primitives.

Core is designed for AI-native workspaces: drivers declare capabilities before actions are attempted, manifest and recent queries help agents inspect large trees efficiently, and signed requests plus ACLs keep user-scoped resources separate from privileged service operations.

This repository does not host the HTTP process. Use VeryFS.Server for the ASP.NET Core service and Docker packaging.

Build

dotnet build src/VeryFS.Core/VeryFS.Core.csproj

Smoke Test

In another terminal:

dotnet run --project tests/VeryFS.Core.Tests/VeryFS.Core.Tests.csproj

Scope

Included:

• Local read-write and read-only bootstrap drivers.
• EF Core PostgreSQL mount registry, with JSON-backed registry as a local fallback.
• Driver abstraction that can move to out-of-process drivers later.
• Driver definitions include a mountSchema descriptor so clients can render mount configuration forms without hard-coding every driver.
• Mount-level cache policy contract: no-cache, metadata-only, or encrypted-content.

Excluded:

• Application-specific business logic.
• HTTP server hosting. See VeryFS.Server.
• Application-specific graph semantics.
• Obsidian vault driver.
• Cross-driver writeback, FUSE, MCP, SSH.