SupraConduit

A hardened, encrypted cloud-storage gateway providing standard WebDAV interfaces for Zotero and Calibre, backed by rclone + crypt.

Core Value

SupraConduit turns unreliable consumer cloud drives (Google Drive, OneDrive, iCloud) into reliable, zero-knowledge backing stores. It enforces strict atomicity and high-performance caching to bridge the gap between "WebDAV expectations" and "Cloud Provider reality."

Key Mandates (See PROJECT_CHARTER.md)

• Container-Only Tooling: All builds and tests run in Docker.
• No Hidden Artifacts: All system files and directories are visible (no dot-prefixes).
• Single Mutator: Transactional state management with lease-locked concurrency.
• Zero-Knowledge: Client-side encryption ensures providers never see plaintext data.

Developer Quick Start

make help      # Show available commands
make all       # Full validation pipeline (Lint, Scan, Test, Conformance)
make build     # Local binary build
make smoke-test # Verify runtime image

Documentation Map

• Architecture: System design and tier separation.
• Architecture Decisions FAQ: Rationale and tradeoffs behind major architecture choices.
• Release Policy: Release guardrails, validation gates, and publication rules.
• Invariants: Reliability and consistency rules.
• User Guide: Setup and client connection guide.
• Backlog: Planned features and optimizations.
• Contributing: Contribution workflow and standards.