Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
36 lines (27 loc) · 1.24 KB

ARCHITECTURE.md

File metadata and controls

36 lines (27 loc) · 1.24 KB
Raw

tcfs Architecture

The full architecture document is maintained as a LaTeX source file and distributed as PDF.

To build locally:

task docs:pdf
# Output: dist/docs/architecture.pdf

Overview

tcfs is a Rust monorepo of 19 workspace crates organized around a daemon (tcfsd) that exposes a gRPC service over a Unix domain socket. The daemon manages Linux FUSE mounts, coordinates with SeaweedFS via OpenDAL, and synchronizes state across a device fleet using NATS JetStream with vector clocks. Clients (CLI, TUI, MCP server) connect to the daemon via gRPC. Files are content-addressed using FastCDC chunking with BLAKE3 hashes, compressed with zstd, and encrypted with XChaCha20-Poly1305 before upload.

Quick Reference

See the Architecture PDF for full details including:

  • System architecture (client + server components)
  • Crate map (19 workspace crates)
  • Stub file format specification
  • Hydration sequence
  • Credential chain
  • Phase roadmap
  • Infrastructure layout