CLI command
skarbiec bond status
Report local bond state, whether the running serve pulls each bond, and, for serve channels, remote health and item counts.
Invocation#
skarbiec bond status [--bond <name>] [--consumer <name>] [--token-file <path>]Purpose#
Report local bond state, whether the running serve pulls each bond, and, for serve channels, remote health and item counts.
Required inputs and options#
- No required input. --bond filters one name. --token-file overrides the bearer with an owner-only file; without it a bond that records --token-file is read with that file, the one the service pulls with. --consumer overrides the bond's recorded consumer, then defaults to replica.
Output and state effects#
- Prints bond mode, role, channel, pulled_by_service, token_file_error, pull stamps, local/remote item counts, and health. It changes no state. The old spelling sync-status is withdrawn and refused as an unknown command; Stado runs bond status.
Refusals#
- --token is refused naming --token-file, and an explicitly named --token-file that cannot be read fails the command. Unavailable remote health or authorization is represented as null rather than fabricated; a bond's unreadable bearer file is reported in token_file_error with the error the service meets; no bearer means no remote vault read.