Add an inbuxa doctor health check #60

Merged
jcoffey-dev merged 1 commits from feat/doctor into main 2026-11-13 15:05:35 +00:00
Owner

inbuxa doctor: a one-shot, read-only health check of the install on this machine (roadmap [27.1] "Also add"). It reports:

  • services -- each component the install means to run, from discover (running / stopped / missing)
  • certificate -- what the mail ports present, via apply.ReadServed + Served.Problem (skipped on --local); a cert close to expiry without renewing is a warning, anything else wrong is a failure
  • ports -- 25 / 465 / 993 / 443 dialed on loopback
  • DNS -- the domain's MX and the mail host's address (a warning, not a failure: a fresh install is healthy before records spread)

It changes nothing and exits 1 only on a failure (a warning does not fail it, so a script can gate on it without stopping for DNS that is still propagating). Join-only installs (no server here) check just their services; --local skips the certificate and DNS.

Shape: a new stdlib-only internal/doctor package of pure classifiers (services/cert/ports/DNS -> checks) with unit tests, and a thin doctorCmd that gathers the live facts and feeds them in -- the same split as cluster doctor, so the judgement is tested without a live install. No new dependencies. gofmt/vet (amd64+arm64)/go test ./... green; smoke-tested that a machine with nothing installed reports so and exits 0.

Complements cluster doctor (data-layer reachability); this is the single-node post-install check.

`inbuxa doctor`: a one-shot, read-only health check of the install on this machine (roadmap [27.1] "Also add"). It reports: - **services** -- each component the install means to run, from `discover` (running / stopped / missing) - **certificate** -- what the mail ports present, via `apply.ReadServed` + `Served.Problem` (skipped on `--local`); a cert close to expiry without renewing is a warning, anything else wrong is a failure - **ports** -- 25 / 465 / 993 / 443 dialed on loopback - **DNS** -- the domain's MX and the mail host's address (a warning, not a failure: a fresh install is healthy before records spread) It changes nothing and exits 1 only on a failure (a warning does not fail it, so a script can gate on it without stopping for DNS that is still propagating). Join-only installs (no server here) check just their services; `--local` skips the certificate and DNS. Shape: a new stdlib-only `internal/doctor` package of **pure classifiers** (services/cert/ports/DNS -> checks) with unit tests, and a thin `doctorCmd` that gathers the live facts and feeds them in -- the same split as `cluster doctor`, so the judgement is tested without a live install. No new dependencies. gofmt/vet (amd64+arm64)/`go test ./...` green; smoke-tested that a machine with nothing installed reports so and exits 0. Complements `cluster doctor` (data-layer reachability); this is the single-node post-install check.
jcoffey-dev added 1 commit 2026-11-13 15:04:15 +00:00
Add an inbuxa doctor health check
ci / test (pull_request) Successful in 53s
8cba9ff89d
jcoffey-dev merged commit 3e661a31b1 into main 2026-11-13 15:05:35 +00:00
jcoffey-dev deleted branch feat/doctor 2026-11-13 15:05:36 +00:00
Sign in to join this conversation.