Expand description
Phora is organized as source → projection → sync. Source obtains immutable content. Projection is a pure, I/O-free calculation of desired target structure. Sync is the sole owner of target-side machine state. Compatibility is guaranteed for the command-line interface and all serialized formats. The Rust library API is intentionally unstable and may change between releases.
Modules§
- cli
- Command-line surface.
- config
- Config DTOs (
phora.toml). This module is a boundary, so it carries serde. - diagnostic
- digest
- error
- Crate-wide error aggregate at the CLI edge.
- lock
- Lock file DTOs (
phora.lock,phora.local.lock) and resolution matching. - paths
- Filesystem locations for Phora’s shared state, rooted via XDG base directories.
- projection
- Projection: pure offer-selection, take-resolution, and collapse algorithms that project a source inventory onto the deployed materialization set.
- source
- Immutable source resolution, inventories, reads, and directory listings.
- sync
- Top-level orchestration: the
syncpipeline, eject/uneject, and shared helpers.