health.report
Every dimension of what this process serves — the layer as it was read, the registry, the scope, version control, benchmark coverage, the committed registry manifest, the shared server of this checkout and the attached peers — each decided by the engine that owns it, with the command that reproduces the verdict.
Every dimension of what this process serves — the layer as it was read, the registry, the scope, version control, benchmark coverage, the committed registry manifest, the shared server of this checkout and the attached peers — each decided by the engine that owns it, with the command that reproduces the verdict.
- query
- behaviorally_verified
- module health
- #health
- #introspection
Exposure
Where this one definition is reachable. Absence is explicit: a surface not listed does not carry it.
| surface | as |
|---|---|
| MCP | tool majordomus_health resource majordomus://health |
| HTTP | GET /api/v1/health operationId health.report |
| command line | — |
Schemas
The canonical input and output, from the Rust types; the MCP tool schema and the OpenAPI parameters and responses are derived from these.
input · Empty
No input.
No properties: the capability takes no input.
JSON Schema
{
"additionalProperties": false,
"description": "No input.",
"title": "Empty",
"type": "object"
}output · Health
The health of what this process serves.
| property | type | required | description |
|---|---|---|---|
| checks | array | yes | Every dimension, in a stable order. |
| status | reference | yes | The worst check's status. |
| tallies | object | yes | How many checks stand where, by status word. |
JSON Schema
{
"$defs": {
"HealthCheck": {
"description": "One dimension of the system, decided by one engine, with what a reader needs to check\nit themselves.",
"properties": {
"decided_by": {
"description": "The engine that decided it, named so the reader knows what to fix.",
"type": "string"
},
"detail": {
"description": "One line: what the engine decided and on what.",
"type": "string"
},
"evidence": {
"description": "What reproduces the verdict: a command, or a path.",
"items": {
"type": "string"
},
"type": "array"
},
"findings": {
"description": "Findings behind the verdict, when the engine produced any: the diagnostic\nmessages, the stale files, the missing coverage lines.",
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "A stable id, `[a-z][a-z0-9-]*`.",
"type": "string"
},
"status": {
"$ref": "#/$defs/HealthStatus",
"description": "Where it stands."
},
"title": {
"description": "The short name.",
"type": "string"
}
},
"required": [
"id",
"title",
"status",
"detail",
"decided_by"
],
"type": "object"
},
"HealthStatus": {
"description": "Where one dimension of the system stands. Ordered by severity, so the worst check\ndecides the whole.",
"oneOf": [
{
"const": "ok",
"description": "The engine that decides this dimension is satisfied.",
"type": "string"
},
{
"const": "warn",
"description": "Nothing is broken and something is worth looking at.",
"type": "string"
},
{
"const": "fail",
"description": "The engine that decides this dimension is not satisfied.",
"type": "string"
},
{
"const": "unknown",
"description": "This process cannot decide it, and says so rather than reporting `ok`.",
"type": "string"
}
]
}
},
"description": "The health of what this process serves.",
"properties": {
"checks": {
"description": "Every dimension, in a stable order.",
"items": {
"$ref": "#/$defs/HealthCheck"
},
"type": "array"
},
"status": {
"$ref": "#/$defs/HealthStatus",
"description": "The worst check's status."
},
"tallies": {
"additionalProperties": {
"format": "uint",
"minimum": 0,
"type": "integer"
},
"description": "How many checks stand where, by status word.",
"type": "object"
}
},
"required": [
"status",
"tallies",
"checks"
],
"title": "Health",
"type": "object"
}Policies
- benchmark
- required — a target on every transport the exposure declares; the cases are the input type's
- cache
- process — up to 4 entries in the process, 5s each, scoped by the registry fingerprint
Benchmark targets
Derived from the registry for this repository: one requirement per transport, and the cases the input type provides. The whole matrix is on the benchmarks page.
The moments this answers
- accepted "done" because the model said so, and paid for it the next morning A fluent completion claim is accepted as evidence because nothing wrote down, beforehand, what would have to be true.
- found a task "in progress" that nobody had touched for three weeks A status that was authored rather than computed is true at the moment of writing and decays silently from then on.
- found five worktrees and could not say which of them still mattered Isolation is cheap to create and expensive to reason about: nothing records what a worktree was for or whether its work landed.
- found finished work on a branch that nobody ever merged Workers produce far more than integration absorbs, and nothing distinguishes work that is done from work that is done and landed.
- found a rule everyone believed was enforced and nothing ever invoked Every artefact of enforcement exists — the rule, the script, the test — and no path connects them, so the control is fiction.
- read a promise in the README that no test stood behind A sentence describing what the software does is written once and never connected to anything that would fail if it stopped being true.
- looked at the bill and could not say which of it produced anything Consumption is measured per account and outcomes are recorded per person, so the two can never be joined.
- published a page that promised more than any test could support Public material is written by a different act from the code, so it drifts ahead of the behaviour and nothing brings it back.
- could not reproduce a result because nothing recorded the state it came from The result is recorded and the conditions that produced it are not, so it is an anecdote rather than a measurement.