merge
verbdestructiveBring two stores that merge together: a plan first with its hash (what each takes from the other), then the apply that the hash approves; there is no conflict to settle.
Program anyfs-reader. Origin anyfs.
Governance: the action
What the verb is and may do, as governance says it. Each annotation is expressed by the surfaces or says why it is not.
| Property | Value |
|---|---|
kind | action |
effect | destructive |
idempotent | false |
audience | both |
tier | writer |
dryRun | true |
check | false |
reachChannels | local, mcp |
reachReadOnly | false |
reachNeedsTty | false |
reachRunsAs | caller |
reachConfirmation | flag |
Operands
| Operand | Meaning |
|---|---|
A | The first store that merges. |
B | The second store that merges. |
Options
| Option | Meaning | Properties |
|---|---|---|
--max-rows | Refuse a plan in which a store would take more than N rows at once. | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--max-bytes | Refuse a plan in which a store would take more than N bytes of blobs at once. | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--plan-hash | Apply only the plan with this hash: where the stores changed since it was read, nothing is applied. | type=value, required=false, standard=false, humanOnly=false, valueName=HASH |
--trust | Whom to take changes from: open (anyone), allowlist (the replicas of --replicas) or signed (the keys of --roster). Where it is left out the mount says, and where the mount says nothing the store keeps the trust it has. | type=value, required=false, standard=false, humanOnly=false, valueName=MODE |
--roster | The keys that are known, as a file of a JSON list (or env:NAME, a variable that holds the text): for --trust signed. | type=value, required=false, standard=false, humanOnly=false, valueName=FILE |
--sign-key | The keys that sign what is published, each a file (or env:NAME, a variable that holds the key): a delta is signed with the key of the replica that made it. The key is never given on the command line. | type=value, required=false, standard=false, humanOnly=false, valueName=FILE[,FILE] |
--replicas | The replicas that are taken changes from, by identity (32 hexadecimal digits); with --trust signed it narrows the roster. | type=value, required=false, standard=false, humanOnly=false, valueName=ID[,ID] |
--json | Write one JSON document and nothing else for a person. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--quiet | Show only how it ended. | type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--verbose | Show every step as it happens. | type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--color | Use colour where the terminal shows it (--no-color turns it off). | type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true |
--non-interactive | Never ask a question: where one is needed, fail and say so. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--dry-run | Show what would change and change nothing. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--yes | Confirm the destruction without asking. | type=flag, short=y, required=false, standard=true, humanOnly=false, negatable=false, default=false |
Examples
anyfs merge --dry-run fleet-a:/ fleet-b:/ # What each store takes from the other, and the hash of that plan; nothing is changed.
anyfs merge --yes --plan-hash <hash> fleet-a:/ fleet-b:/ # Bring them together: each takes what the other has, whole or not at all.Physical: what it is drawn as
Not drawn by any surface for this tier.
Not drawn
- cli: merge is for the tier writer; this caller holds reader
- mcp: merge is for the tier writer; this caller holds reader
- rest: merge is for the tier writer; this caller holds reader