$ rad sync --fetch

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

```

``` ~alice

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

✓ Remote alice added

$ git push rad master

```

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

✓ Remote bob added

$ rad id update --title "Add Bob" --delegate did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk --no-confirm -q

27ab0d77a95581c59ca9d30e679ceb06a9f758db

$ rad id update --title "Update canonical reference rules" --payload xyz.radicle.crefs rules '{ "refs/tags/*": { "threshold": 2, "allow": "delegates" }, "refs/tags/qa/*": { "threshold": 1, "allow": "delegates" } }' -q

$ rad sync -f

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

$ rad id accept dace164ba43fa51802697ec28d0b1965a9d7808b -q

```

$ rad sync --fetch

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

```

``` ~eve

$ rad sync --fetch

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

```

To demonstrate the divergence, Alice, Bob, and Eve will all create a new change,

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

✓ Remote bob added

$ rad remote add did:key:z6Mkux1aUQD2voWWukVb5nNUR7thrHveQG4pDQua8nVhib7Z --name eve

✓ Follow policy updated for z6Mkux1aUQD2voWWukVb5nNUR7thrHveQG4pDQua8nVhib7Z (eve)

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

✓ Remote eve added

```

Alice does indeed have Bob and Eve's references, however, a new canonical

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

✓ Remote alice added

$ git reset --hard alice/master

HEAD is now at 0f9bd80 Merge remote-tracking branch 'eve/master'

```

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

✓ Remote alice added

$ git reset --hard alice/master

HEAD is now at 0f9bd80 Merge remote-tracking branch 'eve/master'

```

Let's see what happens if we try to push a head which diverges from the

canonical head.

$ rad sync --fetch

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

$ rad inspect --delegates

did:key:z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi (alice)

did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk (bob)

``` ~alice

$ rad remote add did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk --fetch --no-sync

✓ Remote bob@z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk added

$ git branch -arv

  bob@z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk/master 319a7dc Third commit

  rad/master                                                  f2de534 Second commit

$ rad sync --fetch

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

$ git commit -m "Third commit" --allow-empty -q

$ git push rad

$ git branch -arv

``` ~alice

$ rad remote add did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk --name bob --fetch --no-sync

✓ Remote bob added

$ git merge bob/master

Updating f2de534..319a7dc

Fast-forward

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

✓ Remote alice added

```

Bob is able to fetch Alice's tag into his working copy, and they're fetched

$ rad sync -f

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

```

``` ~bob (stderr)

✓ Target met: 1 seed(s)

✓ Creating checkout in ./heartwood..

✓ Remote alice@z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi added

✓ Repository successfully cloned under [..]/heartwood/

╭────────────────────────────────────╮

│ heartwood                          │

```

$ rad remote add z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk --name bob --no-sync --fetch

✓ Remote bob added

$ git branch --remotes

  alice@z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi/master

  bob/master

✓ Target met: 1 seed(s)

✓ Creating checkout in ./heartwood..

✓ Remote alice@z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi added

✓ Repository successfully cloned under [..]/heartwood/

╭────────────────────────────────────╮

│ heartwood                          │

✓ Target met: 1 seed(s)

✓ Creating checkout in ./Developer/Radicle..

✓ Remote alice@z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi added

✓ Repository successfully cloned under [..]/Developer/Radicle/

╭────────────────────────────────────╮

│ heartwood                          │

```

$ rad node routing

```

When she tries to clone, one of those will fail to fetch. But the clone command

still returns successfully.

✓ Target met: 1 seed(s)

✓ Creating checkout in ./heartwood..

✓ Remote alice@z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi added

✓ Repository successfully cloned under [..]/heartwood/

╭────────────────────────────────────╮

│ heartwood                          │

✓ Target met: [..] seed(s)

✓ Creating checkout in ./heartwood..

✓ Remote alice@z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi added

✓ Repository successfully cloned under [..]/heartwood/

╭────────────────────────────────────╮

│ heartwood                          │

$ rad sync --fetch rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

```

However, we don't have a local fork of the project. We can follow this

$ rad sync --fetch rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

```

One thing that can happen is that two delegates propose a revision at the same

$ rad sync --fetch rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

$ rad id list

╭─────────────────────────────────────────────────────────────────────────────────╮

│ ●   ID        Title               Author                     Status     Created │

$ rad sync --fetch rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

```

``` ~bob (fail)

$ rad id accept 12d7300 -q

$ rad sync --fetch rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

$ rad id --repo rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji

╭────────────────────────────────────────────────────────────────────────────────╮

│ ●   ID        Title              Author                     Status     Created │

$ rad sync --fetch rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

$ rad inspect rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji --delegates

did:key:z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi (alice)

did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk (bob)

$ rad sync rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji -f

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

```

We can also inspect the repository to ensure all the data is

✓ Target met: 1 seed(s)

✓ Creating checkout in ./heartwood..

✓ Remote alice@z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi added

✓ Repository successfully cloned under [..]/bob/heartwood/

╭────────────────────────────────────╮

│ heartwood                          │

$ rad sync -f

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

$ rad inspect --sigrefs

z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi ae3c6b77dc1ed51c1c1e6a2772339c2779fa9ba8

z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk dace6fe948548168a2bb687718949d9b5d9076ee

✓ Target met: 1 preferred seed(s).

✓ Creating checkout in ./heartwood..

✓ Remote alice@z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi added

✓ Repository successfully cloned under [...]/.radicle/heartwood/

╭────────────────────────────────────╮

│ heartwood                          │

$ rad clone rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu --seed z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi --timeout 1

✓ Seeding policy updated for rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu with scope 'all'

Fetching rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu from the network, found 1 potential seed(s).

! Warning: Failed to fetch from 1 seed(s).

✗ Error: no seeds found for rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu

```

$ rad sync rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu --fetch

Fetching rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

$ rad ls --private --all

╭───────────────────────────────────────────────────────────────────────────────────────────────────────────╮

│ Name        RID                                 Visibility   Head      Description                        │

$ rad sync rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu --fetch --seed z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

Fetching rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu from the network, found 1 potential seed(s).

✓ Target met: 1 preferred seed(s).

```

``` ~bob

$ rad sync rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu --fetch --seed z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi --seed z6MkwPUeUS2fJMfc2HZN1RQTQcTTuhw4HhPySB8JeUg2mVvx

Fetching rad:z2ug5mwNKZB8KGpBDRTrWHAMbvHCu from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

```

```

$ rad node routing

```

Finally, if we want to stop the daemon process from running we can

$ rad sync -f

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

$ rad patch checkout aa45913 --name alice-init

✓ Switched to branch alice-init at revision aa45913

✓ Branch alice-init setup to track rad/patches/aa45913e757cacd46972733bddee5472c78fa32a

$ rad sync -f

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

$ rad patch comment 6c61ef1 -m "I think we should use MIT"

╭───────────────────────────╮

│ bob (you) now 833db19     │

✓ Target met: 1 seed(s)

✓ Creating checkout in ./heartwood..

✓ Remote alice@z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi added

✓ Repository successfully cloned under [..]/heartwood/

╭────────────────────────────────────╮

│ heartwood                          │

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

✓ Remote bob@z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk added

$ git checkout master -q

$ cat .git/FETCH_HEAD

f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354	not-for-merge	branch 'master' of rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk

```

$ rad remote add did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk --name bob --no-sync

✓ Remote bob added

```

Now, we can see that there is a new remote in the list of remotes:

```

$ rad remote add did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk --no-sync

✓ Remote bob@z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk added

```

We can also use `rad remote` to list all the remotes that are

```

$ rad remote add did:key:z6Mkux1aUQD2voWWukVb5nNUR7thrHveQG4pDQua8nVhib7Z --name eve --no-sync

✓ Remote eve added

```

After adding `eve`'s remote, we no longer see any entries that are

$ rad sync --fetch

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

```

Specifying both `--fetch` and `--announce` is equivalent to specifying none:

$ rad sync --fetch --announce

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 2 seed(s)

✓ Nothing to announce, already in sync with 2 seed(s) (see `rad sync status`)

```

$ rad sync --fetch --seed z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 3 potential seed(s).

✓ Target met: 1 preferred seed(s).

```

And the `--replicas` flag to sync with a number of nodes. First we'll

$ rad sync --replicas 1

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 2 potential seed(s).

✓ Target met: 1 seed(s)

✓ Synced with 1 seed(s)

```

```

$ rad sync --fetch rad:z39mP9rQAaGmERfUMPULfPUi473tY --seed z6MkjM3HpqNVV4ZsL5s3RAd8ThVG3VG98YsDCjHBNnGMq5o7

Fetching rad:z39mP9rQAaGmERfUMPULfPUi473tY from the network, found 1 potential seed(s).

✗ Error: Fetched from 0 preferred seed(s), could not reach 1 seed(s)

✗ Error: Could not replicate from 1 preferred seed(s)

```

Also note that you cannot sync an unseeded repo:

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

✓ Remote bob added

```

The contributor's changes are now visible to us.

$ rad sync --fetch

Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).

✓ Target met: 1 seed(s)

```

Now let's checkout `master` and pull the maintainer's changes:

        term::success!(

            "Remote-tracking branch {} created for {}",

            term::format::tertiary(branch),

        );

    }

    Ok(remote_name)

    for (node, reason) in failure.fetch_results().failed() {

        term::warning(format!(

            "{}: {}",

            term::format::yellow(reason),

        ))

    }

) -> anyhow::Result<()> {

    let spinner = term::spinner(format!(

        "Connecting to {}@{addr}...",

    ));

    match node.connect(

        nid,

    for addr in addrs {

        spinner.message(format!(

            "Connecting to {}@{addr}...",

        ));

        match node.connect(

            nid,

    table.divider();

    for sess in sessions {

        let (addr, state, time) = match sess.state {

            node::State::Initial => (

                term::Label::blank(),

                term::Label::blank(),

            ),

            node::State::Attempted => (

                term::Label::from(state_attempted()),

                term::Label::blank(),

            ),

            node::State::Connected { since, .. } => (

                term::Label::from(state_connected()),

                term::format::dim(now - since).into(),

            ),

            node::State::Disconnected { since, .. } => (

                term::Label::from(state_disconnected()),

                term::format::dim(now - since).into(),

            ),

    for (rid, nid) in entries {

        t.push([

            term::format::highlight(rid.to_string()),

        ]);

    }

    t.print();

            term::format::secondary(self.preferred_seeds),

            term::format::secondary(progress.succeeded()),

            term::format::secondary(self.replicas.lower_bound()),

        ))

    }

            term::format::secondary(self.preferred_seeds),

            term::format::secondary(progress.succeeded()),

            term::format::secondary(self.replicas.lower_bound()),

        ))

    }

        let missing_preferred_seeds = missed

            .missed_nodes()

            .iter()

            .collect::<Vec<_>>();

        let required = missed.required_nodes();

        if !missing_preferred_seeds.is_empty() {

                for (node, reason) in results.failed() {

                    term::warning(format!(

                        "{}: {}",

                        term::format::yellow(reason),

                    ))

                }

            for (node, reason) in results.failed() {

                term::error(format!(

                    "{}: {}",

                    term::format::negative(reason),

                ))

            }

    for (node, updates, _) in results {

        term::println(

            "🌱 Fetched from",

        );

        if verbose {

            let mut updates = updates

            if verbose {

                print_synced(result.synced());

                for node in timed_out {

                }

            }

        }

fn print_synced(synced: &BTreeMap<NodeId, sync::announce::SyncStatus>) {

    for (node, status) in synced.iter() {

        match status {

            sync::announce::SyncStatus::AlreadySynced => {

    match node.announce(rid, settings.timeout, announcer, |node, progress| {

        spinner.message(format!(

            "Synced with {}, {} of {} preferred seeds, and {} of at least {} replica(s).",

            term::format::secondary(progress.preferred()),

            term::format::secondary(n_preferred_seeds),

            term::format::secondary(progress.synced()),

use radicle::cob::ObjectId;

use radicle::identity::Visibility;

use radicle::node::policy::Policy;

use radicle::prelude::Did;

use radicle::profile::{env, Profile};

use radicle::storage::RefUpdate;

use crate::terminal as term;

/// Format a node id to be more compact.

    let node = node.to_human();

    let start = node.chars().take(7).collect::<String>();

    let end = node.chars().skip(node.len() - 7).collect::<String>();

    Paint::new(format!("{start}…{end}"))

}

/// Format a git Oid.

pub fn oid(oid: impl Into<radicle::git::Oid>) -> Paint<String> {

    Paint::new(format!("{:.7}", oid.into()))

        let nid = self.profile.id();

        let alias = self.profile.aliases().alias(nid);

        let node_id = match self.short {

            false => nid.to_human(),

        };

    pub fn labels(self) -> (term::Label, term::Label) {

        let alias = match self.alias.as_ref() {

            Some(alias) => term::format::primary(alias).into(),

            None => term::Label::blank(),

        };

        let author = self.you().unwrap_or_else(|| {

                .dim()

                .into()

        });

use bytes::Buf;

use bytes::BufMut;

use radicle::crypto::Signature;

use radicle::git::Oid;

use radicle::identity::RepoId;

            _ => true,

        }

    }

}

impl cyphernet::addr::Host for Address {