Page kind: Reference
swarmops ref log#
List ref NAME's moves, newest first: the op log filtered to the ref.
A deleted ref lists its moves, the newest with no new value. A name the journal records no move of is E_REF_NOT_FOUND; finding that reads the whole journal.
- Group
refs- Since
0.11.0- Mutates
- no
- Identity required
- no
- MCP tool
ref_log- Envelope op
ref_log- Exit codes
- 06
- Errors
- E_REF_NOT_FOUND
Syntax#
swarmops ref log [OPTIONS] <NAME>Required arguments#
Syntax: <NAME>.
The ref.
Optional arguments#
The command also takes the global options.
Syntax: --before <OP>.
List the moves of operations numbered below OP: the last op of a page reads on from there.
Syntax: -n, --limit <N>.
Default: 50.
The most moves to list.
Examples#
swarmops --repo [tmp]/store --as agent/worker-17 ref log release/neverShow 13 more lines
"exit":Exit code 6. Recorded by the CLI tests. A name in square brackets, such as [tmp] or [c1], stands for what differs from run to run: the test's temporary directory, an id, a time.
No recorded example yet.
Return information#
result is a RefLogPage (swarmops schema RefLogPage prints its JSON Schema).
| Field | Type | Required | Description |
|---|---|---|---|
moves | array of RefLogEntryOut | yes | Its moves. |
name | string | yes | The ref. |
truncated | boolean | yes | Whether older moves follow this page: give the last one's op as before to read them. |
Envelope op: ref_log.
Exit codes:
0: Success.6: Something the request names does not exist.
Errors#
- E_REF_NOT_FOUND (exit 6): No ref by that name.
Any command that opens a store may also fail with a store error, such as E_NOT_A_REPO, E_IO or E_STORE_CORRUPT; a command line the grammar refuses is E_INVALID_ARG (exit 2).