From 5f9469e11b09c03d58abafe1f0210b509228315c Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 16:25:45 +0000 Subject: continuum-party: show, a proposal in words before a vote MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A party saw a proposal as its version's JSON changed field by field (`keys.makefu: - -> {"keys":[…],"since":4}`), and voted with nothing more before it. `continuum-party show PROPOSAL` now says what a party votes on, in words (`client::described`): * whether it passed or is dead, who voted what, and how many more `true` pass it; * who proposed it, and the version's number; * the parties it lets in or takes out, with their keys by fingerprint, as `ssh-keygen -l` gives them, and their nodes; the keys and node lists it names anew, with what it adds and drops; * the rules it adds and drops, each where it is among the rules, a rule moved being dropped at one place and added at another; * the checkpoint it moves the store to, and what moving there refuses of what the node took (`beside`); the revision it moves to, and the nodes not known to know it; * the places holding a value whose writer it changes, and why no client backs it, where none does. `proposals` says each proposal so. `vote`, through the node too, says it before anything is cast, then its warnings, and on a terminal asks: `y` casts, anything else casts nothing. Without a terminal, as in a script, it asks nothing. --- docs/guides/federation/upgrades.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) (limited to 'docs/guides/federation/upgrades.md') diff --git a/docs/guides/federation/upgrades.md b/docs/guides/federation/upgrades.md index f6964a6..6ffde67 100644 --- a/docs/guides/federation/upgrades.md +++ b/docs/guides/federation/upgrades.md @@ -101,13 +101,13 @@ adds is refused everywhere until a version names it. 3. **Vote.** Each party backs it once every node of the party knows the revision: ```sh - continuum-party --node http://tv:secret@localhost:3000 proposals - # 5e81…: can still pass; true: tv; false: nobody - # changes: "1f4c…" -> "8a20…" - # number: 4 -> 5 - # revision: the base revision -> revision 1 (merge-events), 6c1d… + continuum-party --node http://tv:secret@localhost:3000 show 5e81 + # 5e81…: can still pass, 2 more `true` passing it (3 of 4); true: tv; false: nobody + # proposed by tv: version 5 on 4 + # moves to revision 1 (merge-events) + # not known to know revision 1 (merge-events): lass: continuum:9c07… said nothing: … continuum-party --node http://tv:secret@localhost:3000 --key tv.key \ - --record tv.record vote 5e81… yes + --record tv.record vote 5e81 yes ``` The client backs it only where its node knows the revision, and says so otherwise. It -- cgit v1.3.1