A snapshot: read at commit 707a04c7ce8 on 2026-10-18T00:06:01Z by majordomus 0.29.0. Nothing on this page is read again. See it live

mesh.doctor

The mesh self-check

What it is

Every prerequisite proved on this machine alone — the declaration parses, the identity loads and, under an allowlist, is on it, the repository has a mesh identity, a UDP socket binds, the multicast group joins, broadcast enables, and the discovery and link protocols sign and verify end to end in memory — and then the server's own verdict: in a shared server, whether an enabled declaration actually activated the mesh and, when it did not, the server's reason, which fails the report. Each failed check names its impact and its remedy. Deterministic, no second node required.

Descriptor

Canonical id: mesh.doctor
Module: mesh
Kind: query
Stability: experimental
Provenance: declared
Source: apps/majordomus-cli/src/capability/builtin/mesh.rs
Cache: disabled
Benchmark: required
Tags: meshdiagnostics

Run

query

A query. It reads and changes nothing.

Projections

Interface	As	Where
MCP tool	`majordomus_mesh_doctor`	-
MCP resource	not exposed	-
HTTP	`GET /api/v1/mesh/doctor`	Swagger
Command line	`majordomus mesh doctor`	-

Schemas

Input · Empty

{
  "type": "object",
  "additionalProperties": false,
  "description": "No input.",
  "title": "Empty"
}

Output · MeshDoctorReport

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether every check holds."
    },
    "checks": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/DoctorCheck"
      },
      "description": "The checks, in the order they ran."
    }
  },
  "required": [
    "ok",
    "checks"
  ],
  "description": "The whole self-check.",
  "title": "MeshDoctorReport",
  "$defs": {
    "DoctorCheck": {
      "type": "object",
      "properties": {
        "check": {
          "type": "string",
          "description": "What was checked."
        },
        "ok": {
          "type": "boolean",
          "description": "Whether it holds."
        },
        "detail": {
          "type": "string",
          "description": "The evidence: a path, an address, an error."
        },
        "impact": {
          "type": [
            "string",
            "null"
          ],
          "description": "What a failure or a limitation means for the mesh."
        },
        "remediation": {
          "type": [
            "string",
            "null"
          ],
          "description": "What to do about it."
        }
      },
      "required": [
        "check",
        "ok",
        "detail"
      ],
      "description": "One check's verdict."
    }
  }
}

Examples

These are the capability's own benchmark cases: the same inputs the benchmark runs and the OpenAPI document shows.

default

{}