luke/mattertimectl/src/main.rs, branch v0.1.0Unnamed repository; edit this file 'description' to name the repository.
https://src.nth.io/luke/mattertimectl/atom?h=v0.1.02026-07-29T01:13:03+00:00Rename project to mattertimectl; default fabric label to Matter Time Controller2026-07-29T01:13:03+00:00Luke Hoerstenluke@hoersten.org2026-07-29T01:13:03+00:00urn:sha1:3a535a57c1b5fa48d5495c31d308b42943f92583
- Rename crate, binary, and repo from mattertimesync to mattertimectl
- Change default fabricLabel to "Matter Time Controller"
- Point README at src.nth.io as the main repo, GitHub as the mirror
Merge the two device state files and reduce mutation2026-07-28T23:09:57+00:00Luke Hoerstenluke@hoersten.org2026-07-28T23:09:57+00:00urn:sha1:cf5eabb9647e6d53ec29a3f7de599a38dbfd5490
The registry (device names) and service-state (sync results) were two
JSON files keyed the same way, split only for a TypeScript-compatibility
that is moot now that the fabric identity cannot migrate between
implementations. Merge them into one devices.json with a DeviceRecord per
node, which also removes the parallel-map join in status and collapses the
per-command load/store pairs. identity.json stays separate as a write-once
secret.
Also, from a reduction/immutability review:
- Fix with_timeout passing a literal "{what}" instead of the error context
- Drop needless mut: CompactDuration and parse_wall_clock become immutable
expressions; run_status filters with a predicate instead of a mutator;
sync_one extracts write_zone_and_dst; InspectOutcome gains Default plus a
failed() constructor
- Share a join_ids helper and a devices_path helper; add IdentityReport
From; minor combinator tidy-ups
35 unit tests, clippy clean.
Address remaining audit findings: input hardening and cleanup2026-07-28T22:38:06+00:00Luke Hoerstenluke@hoersten.org2026-07-28T22:38:06+00:00urn:sha1:29943e536f2be420a9d4042cd26d7b7eddf71438
Security:
- SNTP replies must echo a random nonce in their originate timestamp, and
unsynchronized (LI=3) or invalid-stratum servers are rejected, so an
off-path spoofer cannot defeat the clock-trust gate
- The storage directory is created 0700 but an existing one is tightened
only when it is provably ours (holds our artifacts or is empty); a
misconfigured path like /tmp under root is left alone with a warning
- Device-supplied vendor/product names are stripped of control characters
at ingestion so a device cannot inject terminal escapes
Cleanup:
- ensure_fabric splits into decision logic plus bootstrap_fabric
- read_device_names merges the two name readers; a From impl replaces the
hand-mapped IdentityReport; run_sync uses map/transpose with an extracted
manual_instant; pick_interface runs once; print_json escapes its fallback;
device_name dedups the vendor/product join; identity_status ignores
leftover .tmp blobs; dead parameters and repeated random-id code removed
36 unit tests, clippy clean.
Implement mattertimesync: one-shot Matter time synchronization CLI2026-07-28T21:58:20+00:00Luke Hoerstenluke@hoersten.org2026-07-28T21:58:20+00:00urn:sha1:07d4713f554b2ae2ccf4871f6be0590c129342b0
A standalone CLI Matter controller that joins Matter devices as a
secondary administrator (multi-admin) and sets their clocks via the
standard Time Synchronization cluster. Built on rs-matter 0.2.0, the
official CSA Rust Matter stack: its PASE/CASE initiators, Commissioner
flow, builtin mDNS, and generated cluster clients. One-shot runs from a
systemd timer; there is no daemon.
Hardware-validated end to end (commission, inspect, sync, decommission)
against an IKEA ALPSTUGA air quality monitor over Thread, commissioned
alongside Apple Home. Design and operation are documented in the
README. 34 unit tests, clippy clean.