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

deploy.check

Would these deployments work

What it is

Every refusal the declared deployments earn locally: a health route no capability registers, a package or binary the workspace does not produce, a build input that does not resolve, more machines running than exist, a hosted process that would bind loopback. Each names the file, the key, the value observed and the correction. Nothing here contacts the provider.

Descriptor

Canonical id: deploy.check
Module: deploy
Kind: query
Stability: behaviorallyverified
Provenance: declaredcached
Source: apps/majordomus-cli/src/capability/builtin/deploy.rs
Cache: process, 2 entries, 5s
Benchmark: required
Tags: deploymentdiagnostics

Run

query

A query. It reads and changes nothing.

Projections

Interface	As	Where
MCP tool	`majordomus_deploy_check`	-
MCP resource	not exposed	-
HTTP	`GET /api/v1/deployments/check`	Swagger
Command line	not exposed	-

Schemas

Input · Empty

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

Output · DeploymentCheck

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when no deployment earned a refusal."
    },
    "decided": {
      "type": "integer",
      "format": "uint",
      "minimum": 0,
      "description": "How many deployments were decided."
    },
    "refusals": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Refusal"
      },
      "description": "Every refusal, in the order the objects and their keys appear."
    }
  },
  "required": [
    "ok",
    "decided",
    "refusals"
  ],
  "description": "Whether the deployments this repository declares would work, decided locally: against\nthe capability registry this process built and the workspace it sits in.",
  "title": "DeploymentCheck",
  "$defs": {
    "Refusal": {
      "type": "object",
      "properties": {
        "file": {
          "type": "string",
          "description": "The repository-relative file the value came from."
        },
        "key": {
          "type": "string",
          "description": "The key path within it, as the contract names it."
        },
        "found": {
          "type": "string",
          "description": "The value observed, rendered as it was read."
        },
        "problem": {
          "type": "string",
          "description": "What is wrong with it, in one line."
        },
        "correction": {
          "type": "string",
          "description": "What to do instead."
        }
      },
      "required": [
        "file",
        "key",
        "found",
        "problem",
        "correction"
      ],
      "description": "Why a deployment object is refused: what was read, where, and what to do about it."
    }
  }
}

Examples

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

default

{}