Three voters, two options, and a trust graph that changes the answer.

0. Install

$ cargo binstall ljos-consensus
$ ljos-consensus --help

The crate is on crates.io as ljos-consensus. The name consensus is already a Bitcoin crate.

1. Settle with equal trust

$ ljos-consensus settle --ballots '[
    {"agent":"alice","choice":"ship"},
    {"agent":"bob","choice":"ship"},
    {"agent":"carol","choice":"hold"}]'
{ "options": ["hold","ship"], "shares": [0.333, 0.667], "rounds": 1, "settled": true, "engine": "degroot-fj" }

With no rows, every voter listens to everyone equally, so the group meets on the majority’s position and the shares are the tally as a fraction; the difference from a count shows once rows or anchors exist.

2. Add trust

$ ljos-consensus settle --ballots '[...]' --trust '[
    ["alice","carol",1.0], ["bob","carol",1.0], ["carol","carol",4.0], ["carol","alice",1.0]]'
{ ... "shares": [0.6, 0.4] ... }

Alice and bob each listen to carol as much as to themselves; carol weighs herself four to one over alice. The group moves toward carol’s hold.

3. Anchor the voters

$ ljos-consensus settle --ballots '[...]' --trust '[...]' --susceptibility 0.5

Below one, each voter stays partly anchored to the ballot they cast. The run always settles, and it settles on voters who still disagree; the shares report where the group’s weight ended up.

4. Read ballots from a tracker

$ ljos-consensus settle --issue proj-1a2b

Runs vissue vote proj-1a2b --json and settles those ballots. The seat’s ljos consensus adds the pack’s trust rows to this call.

5. Hand the same inputs to seldon

$ ljos-consensus settle --ballots '[...]' --trust '[...]' --seldon --out run/

Writes config.toml, network.txt and opinions.txt in Seldon’s format, runs seldon when it is on PATH, and parses the final opinions back into the same JSON shape. The parse path does not print a residual. When seldon is absent the discrete step is the settle.