# SyncGuard (CLI prototype)

One-way mirror sync with a dry-run conflict preview and an audit log,
built on the same checksum-verified copy approach as CopySure. Working
prototype of the sync engine — see ../plan.md for the full product plan
(two-way sync with conflict resolution, scheduling, and cloud/NAS targets
are still on the roadmap; this build is one-way local-to-local mirroring
only).

## Build from source

Requires Go 1.24+, no external dependencies.

    go build -o syncguard .

Cross-compile for another platform:

    GOOS=windows GOARCH=amd64 go build -o syncguard.exe .
    GOOS=darwin  GOARCH=arm64 go build -o syncguard .

## Usage

    syncguard mirror <src> <dst> [--delete] [--apply] [--log FILE]

Without --apply, mirror is a dry run: it prints the plan (copy / update /
delete) and touches nothing. --delete is opt-in on top of --apply — a
plain --apply run only ever adds or updates files at dst, never removes
them; --delete makes it a true mirror that also removes dst files no
longer present in src. --log appends a JSON-lines audit record for every
action actually taken.

## Prebuilt binaries

See ../downloads/ for prebuilt binaries (Windows/macOS/Linux) and
CHECKSUMS.txt for their SHA-256 hashes. These are unsigned indie builds —
Windows SmartScreen and macOS Gatekeeper will warn on first run, which is
expected until a code-signing certificate is in place (see the build
plan's risk section).