deploy.observed

Každé nasazení, které forge zaznamenal, do každého prostředí, v němž nějaké má — mimo jiné GitHub Pages — s commitem, refem, tím, kdo je vytvořil, jak skončilo, kde se servíruje a během, který je provedl; každé prostředí popsané jeho nejnovějším nasazením; a každý release, který forge publikoval. Čte se ze záznamu, který zapsal `majordomus served forge`, když se forge naposledy ptal: nic zde nesahá na síť a checkout, který se nikdy neptal, odpoví `observed: false` s tím, co spustit.

query
behaviorally_verified
module deploy
#deployment
#delivery

Zpřístupnění

Kde je tato jedna definice dosažitelná. Absence je explicitní: povrch, který není uveden, ji nenese.

povrch	jako
MCP	nástroj majordomus_deployments_observed
HTTP	GET /api/v1/deployments/observed operationId deploy.observed
příkazová řádka	—

Schémata

Kanonický vstup a výstup z typů Rustu; schéma nástroje MCP a parametry a odpovědi OpenAPI se odvozují z nich.

vstup · Prázdné

Žádný vstup.

Žádné vlastnosti: schopnost nebere žádný vstup.

JSON Schema

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

výstup · ObservedDeployments

deploy.observed: co bylo nasazeno kam, nebo že zde nebylo nic pozorováno.

vlastnost	typ	povinné	popis
nasazení	array	ano	Pozorovaná nasazení, nejnovější první.
prostředí	array	ano	Každé prostředí, do kterého se cokoli nasadilo, podle jména.
pozorováno	boolean	ano	Zda tento checkout vůbec drží nějaké pozorování.
observed_at	string \| null	ne	Kdy se forge ptalo, když bylo pozorováno.
důvod	string \| null	ne	Proč ne a co spustit, když žádný nedrží nebo ho nelze přečíst.
releases	array	ano	Pozorované releasy, nejnovější první.
repozitář	string \| null	ne	`owner/name`, pokud bylo pozorováno.
repository_url	string \| null	ne	Adresa repozitáře na forge, když byla pozorována.

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"
}

Politiky

benchmark: povinné — cíl na každém transportu, který expozice deklaruje; případy jsou ty ze vstupního typu
cache: vypnuto — každé volání spustí handler

Cíle benchmarku

Odvozeno z registru pro tento repozitář: jeden požadavek na transport a případy, které poskytuje typ vstupu. Celá matice je na stránce měření výkonu.

transport	state	případy	targets
direct	pokryto	1	výchozí
mcp	pokryto	1	výchozí
http	pokryto	1	výchozí