deploy.observed
Every deployment the forge recorded, to every environment it has one in — GitHub Pages among them — with the commit, the ref, who created it, how it ended, where it is served and the run that did it; every environment described by its newest deployment; and every release the forge published. Read from the record `majordomus served forge` wrote when it last asked the forge: nothing here reaches the network, and a checkout that has never asked answers `observed: false` with what to run.
Every deployment the forge recorded, to every environment it has one in — GitHub Pages among them — with the commit, the ref, who created it, how it ended, where it is served and the run that did it; every environment described by its newest deployment; and every release the forge published. Read from the record `majordomus served forge` wrote when it last asked the forge: nothing here reaches the network, and a checkout that has never asked answers `observed: false` with what to run.
- query
- behaviorally_verified
- module deploy
- #deployment
- #delivery
Exposure
Where this one definition is reachable. Absence is explicit: a surface not listed does not carry it.
| surface | as |
|---|---|
| MCP | tool majordomus_deployments_observed |
| HTTP | GET /api/v1/deployments/observed operationId deploy.observed |
| 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 properties: the capability takes no input.
JSON Schema
{
"additionalProperties": false,
"description": "No input.",
"title": "Empty",
"type": "object"
}output · ObservedDeployments
deploy.observed: what was deployed where, or that nothing has been observed here.| property | type | required | description |
|---|---|---|---|
| deployments | array | yes | The observed deployments, newest first. |
| environments | array | yes | Every environment something was deployed to, by name. |
| observed | boolean | yes | Whether this checkout holds an observation at all. |
| observed_at | string | null | no | When the forge was asked, when observed. |
| reason | string | null | no | Why not, and what to run, when it holds none or cannot read it. |
| releases | array | yes | The observed releases, newest first. |
| repository | string | null | no | owner/name, when observed. |
| repository_url | string | null | no | The repository's address on the forge, when observed. |
JSON Schema
{
"$defs": {
"EnvironmentSummary": {
"description": "One environment, as its deployments describe it.",
"properties": {
"activity_url": {
"description": "The environment's activity on the forge.",
"type": "string"
},
"deployed_at": {
"description": "When that was.",
"type": "string"
},
"deployments": {
"description": "How many of the observed deployments went to it.",
"format": "uint",
"minimum": 0,
"type": "integer"
},
"name": {
"description": "The environment.",
"type": "string"
},
"sha": {
"description": "The commit its newest deployment put there.",
"type": "string"
},
"state": {
"description": "The state of its newest deployment.",
"type": "string"
},
"url": {
"description": "Where it is served, when its newest deployment says.",
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"deployments",
"state",
"sha",
"deployed_at",
"activity_url"
],
"type": "object"
},
"ObservedDeployment": {
"description": "One deployment the forge recorded.",
"properties": {
"created_at": {
"description": "When it was created, RFC 3339.",
"type": "string"
},
"creator": {
"description": "Who or what created it.",
"type": [
"string",
"null"
]
},
"environment": {
"description": "The environment it went to, in the forge's words (`github-pages`, `production`, ...).",
"type": "string"
},
"environment_url": {
"description": "Where the environment is served, when the deployment says.",
"type": [
"string",
"null"
]
},
"git_ref": {
"description": "The ref it was deployed from, when the forge still names one.",
"type": [
"string",
"null"
]
},
"id": {
"description": "The forge's identity of the deployment.",
"type": "string"
},
"log_url": {
"description": "The run that performed it, when the deployment says.",
"type": [
"string",
"null"
]
},
"sha": {
"description": "The commit that was deployed.",
"type": "string"
},
"state": {
"description": "How it ended, lower case as the forge states it (`success`, `failure`, `in_progress`,\n...); `unknown` when the forge reported no status at all.",
"type": "string"
}
},
"required": [
"id",
"environment",
"sha",
"created_at",
"state"
],
"type": "object"
},
"ObservedRelease": {
"description": "One release the forge published.",
"properties": {
"draft": {
"description": "Whether it is still a draft.",
"type": "boolean"
},
"name": {
"description": "The release's title, when it has one.",
"type": [
"string",
"null"
]
},
"prerelease": {
"description": "Whether the forge marks it a pre-release.",
"type": "boolean"
},
"published_at": {
"description": "When it was published; absent for a draft.",
"type": [
"string",
"null"
]
},
"tag": {
"description": "The tag.",
"type": "string"
},
"url": {
"description": "Its page on the forge.",
"type": "string"
}
},
"required": [
"tag",
"url",
"prerelease",
"draft"
],
"type": "object"
}
},
"description": "`deploy.observed`: what was deployed where, or that nothing has been observed here.",
"properties": {
"deployments": {
"description": "The observed deployments, newest first.",
"items": {
"$ref": "#/$defs/ObservedDeployment"
},
"type": "array"
},
"environments": {
"description": "Every environment something was deployed to, by name.",
"items": {
"$ref": "#/$defs/EnvironmentSummary"
},
"type": "array"
},
"observed": {
"description": "Whether this checkout holds an observation at all.",
"type": "boolean"
},
"observed_at": {
"description": "When the forge was asked, when observed.",
"type": [
"string",
"null"
]
},
"reason": {
"description": "Why not, and what to run, when it holds none or cannot read it.",
"type": [
"string",
"null"
]
},
"releases": {
"description": "The observed releases, newest first.",
"items": {
"$ref": "#/$defs/ObservedRelease"
},
"type": "array"
},
"repository": {
"description": "`owner/name`, when observed.",
"type": [
"string",
"null"
]
},
"repository_url": {
"description": "The repository's address on the forge, when observed.",
"type": [
"string",
"null"
]
}
},
"required": [
"observed",
"environments",
"deployments",
"releases"
],
"title": "ObservedDeployments",
"type": "object"
}Policies
- benchmark
- required — a target on every transport the exposure declares; the cases are the input type's
- cache
- disabled — every call runs the handler
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.