coulomb/railiance-clock
5
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
railiance-clock/tools/README.md
tegwick fb09e138b8 Add repeatable read-only host clock inventory and live receipt 
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a09cbc-910e-77a0-b336-3130194350b3
2026-09-14 13:19:22 +02:00

1.2 KiB
Raw Blame History

Host clock inventory

From the repository root, using an existing SSH alias and trust configuration:

python3 tools/observe_host_clock.py railiance01 --output docs/evidence/UNIQUE-host-clock-inventory.json
python3 -m unittest discover -s tests -v

Choose a unique output name for every observation. The collector refuses to replace an existing file. The remote host needs Python 3 and the systemd/ss tools; individual unavailable commands are recorded as failed observations. SSH failure aborts collection. No sudo, installation or host configuration change is performed.

The JSON records daemon/upstream metadata, configuration hashes and command exit codes. synchronized_reported is an OS report; authority_usable remains null. Neither host nor workstation observation timestamps are authenticated Railiance time, and this tool cannot establish an independent UTC error bound. It supports RCLK-WP-0005-T01 inventory; service acceptance remains in the specification and later workplan tasks.

The 2026-09-14 live JSON receipt accompanies the human-readable host inventory. Six unit tests cover transport failure, host argument validation, fixed command transport and unknown-versus-synchronized semantics.