lansync

type Beacon struct {
	Magic       string `json:"cct"`         // protocol marker, always beaconMagic
	Hostname    string `json:"hostname"`    // human label
	Tool        string `json:"tool"`        // codex | claude
	Port        int    `json:"port"`        // the sync TCP port to dial
	Fingerprint string `json:"fingerprint"` // sender's cert fingerprint (hex), for trust recognition
	// Addr is filled in by the discoverer from the datagram source; it is not sent
	// on the wire (the sender does not know which interface a peer sees it on).
	Addr string `json:"-"`
}

type DaemonOptions struct {
	// Interval is how often the sessions directory is polled for changes.
	Interval time.Duration
	// DiscoverWindow is how long each discovery sweep listens for peers.
	DiscoverWindow time.Duration
	// Once runs a single discover-and-sync sweep, then returns (no listener). It is
	// used by `--once` and keeps the daemon testable/scriptable.
	Once bool
}

type DeltaPlan struct {
	// Append is true when the receiver holds an exact prefix and only the trailing
	// Suffix bytes need to be sent and appended. When false the whole file must be
	// sent (the receiver lacks it, or its copy diverged and is not a clean prefix).
	Append bool
	Suffix []byte // bytes to append (Append==true)
	Full   []byte // whole file to send (Append==false)
	// SHA256 is the sender's whole-file hash, which the receiver verifies after
	// applying, so a corrupt or mis-targeted transfer can never be committed.
	SHA256 string
}

type Options struct {
	Tool        agent.Kind      // codex or claude
	ClaudeHome  claudehome.Home // used to scan when Tool == claude
	ProjectPath string          // absolute; "" means all in-scope sessions
	Port        int             // serve: listen port (0 = OS-assigned)
	Code        string          // connect: the pairing code shown by the peer
	AllowPublic bool            // override the private-address guard
	PullOnly    bool            // do not send my sessions
	PushOnly    bool            // do not apply received sessions
	DryRun      bool            // exchange manifests and preview only; write nothing
	Confirmed   bool            // the experimental --i-understand gate
	Out         io.Writer       // progress/UX output
	// MapCWD / MapCWDHere / HereDir remap a received session's recorded cwd as it
	// is applied, so a peer's project that lives at a different path here still
	// lands under the right local project (and, for Claude, the right sidebar
	// group). Same semantics as on import.
	MapCWD     []bundle.CWDMapping
	MapCWDHere bool
	HereDir    string
	// Remember stores the peer's fingerprint after a successful code pairing
	// (trust-on-first-use), so future syncs between remembered devices skip the
	// code. ConfigDir overrides the location of the identity/peers store (default:
	// the OS config dir); used in tests.
	Remember  bool
	ConfigDir string
	// Redact replaces likely secrets in the sessions this device sends with
	// placeholders before they leave the machine. AllowSecrets disables the
	// pre-egress secret gate (which otherwise refuses to send a session containing
	// a likely secret). Redact and the gate apply to outbound data only.
	Redact       bool
	AllowSecrets bool
}

type Result struct {
	PeerHost    string
	Sent        int
	Received    bundle.ImportResult
	DryRun      bool
	PreviewSend int
	PreviewRecv int
}