Weave documentation
Strand

Replication

Sparse retrieval requires a real ReplicationClient; local scheduling is explicit.

Strand::replication(options).await creates a range handle. ReplicationOptions has is_initiator (reserved), linear and local_only. Network retrieval requires an installed ReplicationClient; without one, download returns an unsupported-network error unless local_only is explicitly true.

RangeSpec uses an inclusive start and exclusive optional end. An omitted end is the current length sampled when the task starts; it is not an indefinitely tailing subscription. poll_once() is currently a no-op. cancel_async() requests cancellation and awaits task termination; it does not prove the range was downloaded. Individual get errors inside the background scheduler are discarded, so verify required blocks explicitly after scheduling.

Local-only scheduling walks local storage. The handle reopens from the Strand configuration; an in-memory Strand does not gain shared storage simply by opening a replication handle. For network use, install the real client and verify remote writer/checkpoint authority in the service integration. See the SDK’s replication guide.

Source declarations