Hero Sync

Multi-protocol file synchronization for the Hero Ecosystem.

Workspace Structure

This is a Cargo workspace with 5 crates:

Crate	Type	Description
hero_sync_sdk	library	SDK: types, config, error handling, and async Unix socket client
hero_sync_server	binary	OpenRPC backend server (Unix socket only, no UI)
hero_sync	binary	CLI tool for managing sync profiles and running sync operations
hero_sync_ui	binary	Web dashboard UI with embedded static assets (Bootstrap, Unpoly)
hero_sync_examples	examples	Example programs demonstrating SDK usage

Dependency graph

hero_sync_sdk  (no internal deps)
     ^         ^          ^
     |         |          |
    CLI        UI      examples

hero_sync_server  (standalone — business logic + OpenRPC)

Sockets

Service	Binding	Path
hero_sync_server	Unix socket (OpenRPC)	~/hero/var/sockets/hero_sync_server.sock
hero_sync_ui	Unix socket (HTTP + /rpc proxy)	~/hero/var/sockets/hero_sync_ui.sock

No service binds TCP. Only hero_proxy exposes TCP.

Building

# Build all crates (release)
make build

# Build specific crate
cargo build --release -p hero_sync
cargo build --release -p hero_sync_server

Running

# Start server + UI (server on socket, UI on socket)
make run

# Use the CLI
./target/release/hero_sync list
./target/release/hero_sync sync <profile>
./target/release/hero_sync pull <profile>
./target/release/hero_sync push <profile>
./target/release/hero_sync health

Development

make check      # Fast type-check all crates
make test       # Run all tests
make fmt        # Format code
make lint       # Run clippy
make rundev     # Run server + UI in debug mode

Static Assets

The web dashboard uses Bootstrap 5, Bootstrap Icons, and Unpoly. To download/update these:

make download-assets

Assets are embedded into the hero_sync_ui binary via rust-embed.