# NousResearch/hermes-agent · Stale restart-pending marker causes false warnings

## Open now

- Nothing open on GitHub.

A cluster of bugs and fixes around the \`fleet_restart_pending\` marker not being cleared after a successful gateway update and restart. The work addresses false warnings at CLI startup and in \`hermes doctor\`, slow gateway boot timing, and conditions under which the marker is considered settled.

## TL;DR

- 6 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 2 merged PR(s), 3 PR(s) closed without merging.
- A fix was merged to main in PR #111371. Verify it addresses your case.
- **Recommended:** read PR #111371 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `resolved` · deciding PR(s): `pr-111371`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.33`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #111272: bug(update): successful update + gateway restart leaves \`fleet_restart_pending\` marker — every CLI startup and \`hermes doctor\` print a false "did not restart running gateways" warning

## Prior & competing PRs

- **#111371: fix(update): fleet_restart_pending settles on a verified gateway serving the pulled sha; foreign state-file writers never read as current (#111272, #110420, salvage #110426 #105417)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `contributors/emails/[redacted:email]`, `hermes_cli/update_cmd_fleet.py`, `hermes_cli/update_receipt.py`, `tests/gateway/test_control_socket.py`, `tests/hermes_cli/test_fleet_matrix_down_state.py`, `tests/hermes_cli/test_update_fleet_restart_pending.py`, `tests/hermes_cli/test_update_receipt.py`
- **#112259: hermes update no longer fails fleet verification on a slow gateway boot (fixes #111272, salvage #111385)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `hermes_cli/update_cmd_fleet.py`, `tests/hermes_cli/test_update_fleet_snapshot_settle.py`
- **#111300: fix(cli): clear fleet_restart_pending when degraded probe is answered by marker SHA**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#111272`
- **#111302: fix(update): settle fleet_restart_pending when the gateway already serves the pulled sha**. closed without merge
  - maintainer direction: category `wontfix_bydesign`; implication `wontfix`; refs `de16ce9d0c`, `#105417`, `#105417`, `#111272`, `#111272`, `#105417`, `#105417`, `#105417`, `#105417`, `#105417`
- **#111385: fix(update): wait for fleet state publication after supervised restart**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `f81c33cb6a7a`, `#112259`

## Fix status

- Merged to main in PR #111371 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-09-15`.