The verbs
| verb | writes | page |
|---|---|---|
init | yes (files) | init |
create | yes | create |
show | no | show |
list | no | list |
ready | no | ready |
search | no | search |
stale | no | stale |
stats (alias status) | no | stats |
q | yes | q |
query, upgrade, gate, scheduler, audit, robot-docs | no (exit 21, pointer) | elsewhere |
count | no | count |
update | yes | update |
close | yes | close |
reopen, defer, undefer | yes | reopen, defer, undefer |
delete | yes (tombstone) | delete |
blocked | no | blocked |
label add, label remove, label rename, label list, label list-all | add/remove/rename | label |
graph | no | graph |
history | no | history |
changelog | no | changelog |
lint | no | lint |
orphans | no | orphans |
epic status, epic close-eligible | close-eligible | epic |
dep add, dep remove, dep list | add/remove | dep |
comments add, comments list | add | comments |
version, where, info | no | version, where, info |
config list, get, path | no | config |
capabilities | no | capabilities |
schema | no | schema |
doctor | no | doctor |
key | no | key |
completions | no | completions |
export, import, sync, merge-driver | import, sync, merge-driver | export, import, sync |
Behaviour change (#41):
listandsearchhide deferred seeds unless--deferred,--allor--statusis given, as the upstream tracker does. Earlier versions listed them by default.
Every verb accepts the global options, and
every read accepts --at <tx>. A verb that writes prints the transaction it
wrote as (tx N) in text mode and as tx in --json (on the object, or on
each seed of a bare array); that number is what --at takes. A --dry-run
writes nothing, so its tx is null. Against a quipu server a write’s
tx is also null today: quipu’s /update returns no transaction id
(aegis-xajsgn). --at reads still work there, and history
recovers each version’s transaction from them.
--json output is a contract: every documented key is always present (an
absent value is null, never a missing key), and tests/json_schema.rs pins
the key sets. Errors in --json mode print {"error": {"code", "message"}}
on stdout and exit with the code from Reference.