ADR 0280: the resolver restarts itself when it stops answering, braked and said as its health (issue 348) #284

Closed
mesh-admin wants to merge 1 commits from decisions/0280-the-resolver-restarts-itself-when-it-stops-answering into main
Contributor

Records the operator's word on the departure from ADR 0240 rule 6 that mesh-catalog pull request 161 asked for (issue 348, a resolver that stopped answering ran on unnoticed).

  • ADR 0280 (new): the dnsmasq module's watch restarts the resolver's unit after two failing looks, at most once every two minutes and three times an hour, budget kept across the watch's own restart; only its next look says whether the restart helped, and dnsmasq_health says it, so a restart that did not help becomes module.dnsmasq.<machine>.unhealthy. Rejected: keeping rule 6 (twenty minutes of a dead resolver until a person notices) and a healer row in the controller (it cannot reach a machine whose name lookups fail). The operator gave the word on 2026-10-10 by approving the merge of catalogue PR 161. One module's exception; rule 6 stands for the rest.
  • ADR 0240: a dated pointer note under rule 6 (the mechanism changed, by ADR 0280), per 02-DECISIONS/README.md.
  • To-be 48: 0280 in decisions:; §7 and What is not decided here name the exception; updated: today.

Checks: records, index, cycle, words (with the catalogue's list) pass locally.

Records the operator's word on the departure from ADR 0240 rule 6 that mesh-catalog pull request 161 asked for (issue 348, a resolver that stopped answering ran on unnoticed). - **ADR 0280** (new): the dnsmasq module's watch restarts the resolver's unit after two failing looks, at most once every two minutes and three times an hour, budget kept across the watch's own restart; only its next look says whether the restart helped, and `dnsmasq_health` says it, so a restart that did not help becomes `module.dnsmasq.<machine>.unhealthy`. Rejected: keeping rule 6 (twenty minutes of a dead resolver until a person notices) and a healer row in the controller (it cannot reach a machine whose name lookups fail). The operator gave the word on 2026-10-10 by approving the merge of catalogue PR 161. One module's exception; rule 6 stands for the rest. - **ADR 0240**: a dated pointer note under rule 6 (the mechanism changed, by ADR 0280), per 02-DECISIONS/README.md. - **To-be 48**: 0280 in `decisions:`; §7 and *What is not decided here* name the exception; `updated:` today. Checks: records, index, cycle, words (with the catalogue's list) pass locally.
mesh-admin added 1 commit 2026-10-10 15:48:00 +00:00
ADR 0280: the resolver restarts itself when it stops answering, by the operator's word (issue 348)
mesh/merge-gate out of date: judged against a trunk it does not name, the trunk is now a0e51c061b5e; judged again on a recheck or when it is merged
mesh/repo-check out of date: judged against a trunk it does not name, the trunk is now a0e51c061b5e; judged again on a recheck or when it is merged
mesh/delivery stopped: the pull request closed unmerged
c58f3dc765
ADR 0240 rule 6 left a restart on health to a record of its own. The resolver's
failure cuts its machine off by name, so no healer in the controller can reach
it; the module repairs itself, braked, and says it as its health. To-be 48 and
ADR 0240 point to the exception.
Author
Contributor

Delivery novox/hq@c58f3dc765a4 — stopped since 2026-10-14T21:24:10Z

Delivery plan — builds nothing: the change touches no module of the mesh's graph

Transitions

  • 2026-10-10 15:48 (new) → proposed (announced): novox/hq#284's head announced
  • 2026-10-10 15:49 proposed → checked (checked): the verdict names this commit
  • 2026-10-10 15:49 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
  • 2026-10-14 21:24 ready → stopped (closed): the pull request closed unmerged

The commit's note under refs/notes/mesh-plan keeps every transition: git log --notes=mesh-plan.

<!-- mesh-delivery:view --> **Delivery** `novox/hq@c58f3dc765a4` — **stopped** since 2026-10-14T21:24:10Z **Delivery plan** — builds nothing: the change touches no module of the mesh's graph **Transitions** - 2026-10-10 15:48 (new) → proposed (announced): novox/hq#284's head announced - 2026-10-10 15:49 proposed → checked (checked): the verdict names this commit - 2026-10-10 15:49 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail - 2026-10-14 21:24 ready → stopped (closed): the pull request closed unmerged The commit's note under `refs/notes/mesh-plan` keeps every transition: `git log --notes=mesh-plan`.
Author
Contributor

Rework needed before merge (triage, 2026-10-11): it adds ADR 0280 and a note on ADR 0240 as files, which hq no longer holds (#312), and conflicts. The knowledge base has no ADR 0280: reserve a number and propose the record there (and the 0240 note as a progressive insight), then rebase the to-be 48 change onto main with "ADR NNNN" in frontmatter and prose. The to-be 48 change is still wanted.

Rework needed before merge (triage, 2026-10-11): it adds ADR 0280 and a note on ADR 0240 as files, which hq no longer holds (#312), and conflicts. The knowledge base has no ADR 0280: reserve a number and propose the record there (and the 0240 note as a progressive insight), then rebase the to-be 48 change onto main with "ADR NNNN" in frontmatter and prose. The to-be 48 change is still wanted.
Author
Contributor

Closed as superseded by the knowledge base: this pull request's ADR 0280 is now ADR 0368 (accepted 2026-10-14, the resolver restarts itself; mesh-catalog #161, the operator's word of 2026-10-10, issue 348). Decision records live in the knowledge base since ADR 0290. Design 48's citation of it comes in a new pull request.

Closed as superseded by the knowledge base: this pull request's ADR 0280 is now ADR 0368 (accepted 2026-10-14, the resolver restarts itself; mesh-catalog #161, the operator's word of 2026-10-10, issue 348). Decision records live in the knowledge base since ADR 0290. Design 48's citation of it comes in a new pull request.
mesh-admin closed this pull request 2026-10-14 21:18:17 +00:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novox/hq#284