| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849 |
- """Gateway-less host evidence for the update-restart obligation (``update_cmd_fleet`` sibling).
- An inventory-less obligation (the pre-inventory writer, or a tail that died before recording one)
- has no owed set, so the live gateway matrix is its whole evidence. On a host that runs no gateway
- (the Desktop app alone, #118742) that matrix is empty forever and the obligation could never
- settle. An empty probe cannot tell that host from one whose gateway the dying update stopped, so
- these readers ask the live host directly. A historical receipt is never consulted: it can belong
- to an older update and says nothing about what runs now.
- """
- from __future__ import annotations
- from dataclasses import asdict
- def runtime_outside_gateway_evidence(runtime: dict) -> bool:
- """A serve/dashboard row the gateway matrix neither covers nor needs to.
- Its supervisor owns the restart (Desktop backend, launchd/systemd unit, Windows service), or it
- is a manual serve whose restart ``defer_manual_serve`` has handed to its own durable reminder.
- Unclassified backends and failed transfers stay evidence against settlement (#115090, #111494).
- """
- from hermes_cli.update_cmd_fleet import _SUPERVISOR_OWNED_SERVE_BACKENDS
- from hermes_cli.update_serve_obligations import defer_manual_serve
- return runtime.get("kind") in ("serve", "dashboard") and (
- defer_manual_serve(runtime) or runtime.get("supervisor") in _SUPERVISOR_OWNED_SERVE_BACKENDS
- )
- def host_owes_no_gateway_restart() -> bool:
- """True when no profile expects a gateway to be running and every live runtime is outside the matrix.
- A ``gateway_state.json`` that does not say ``stopped``/``startup_failed`` belongs to a gateway
- that went away without a clean stop, which is what an update that died mid-restart leaves
- behind; it keeps the obligation. Profiles that never ran a gateway have no record at all.
- """
- from gateway.status import read_runtime_status
- from hermes_cli.update_inventory import collect_runtime_inventory
- from hermes_cli.update_receipt import _NOT_EXPECTED_STATES, _profile_homes
- for _profile, home in _profile_homes():
- record = read_runtime_status(home / "gateway_state.json")
- if record is None:
- continue
- state = record.get("gateway_state") if isinstance(record, dict) else None
- if not (isinstance(state, str) and state in _NOT_EXPECTED_STATES):
- return False
- return all(runtime_outside_gateway_evidence(asdict(runtime)) for runtime in collect_runtime_inventory().runtimes)
|