product.matrix

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

{
  "$defs": {
    "MatrixRow": {
      "description": "One row of the matrix: a feature and the surfaces it is exposed through.",
      "properties": {
        "claims": {
          "description": "How many claims it names at all, so `proven` has its denominator beside it rather than\nin another table.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "exposed": {
          "description": "The surface ids that are true.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "id": {
          "description": "The feature id.",
          "type": "string"
        },
        "label": {
          "description": "The name a narrow column shows.",
          "type": "string"
        },
        "proven": {
          "description": "How many of the claims this feature names are guaranteed *and* name the test that\nsettles them. A surface column says where a feature is reachable; this says what of it\nis proven, which is the question a reader of a compliance table is actually asking.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "route": {
          "description": "`/features/<id>/`.",
          "type": "string"
        },
        "status": {
          "description": "`stable` or `draft`.",
          "type": "string"
        },
        "surfaces": {
          "$ref": "#/$defs/Surfaces",
          "description": "The surfaces, by id, in the vocabulary's order."
        }
      },
      "required": [
        "id",
        "label",
        "route",
        "status",
        "surfaces",
        "exposed",
        "proven",
        "claims"
      ],
      "type": "object"
    },
    "ProductCoverage": {
      "description": "One thing of the product — a module, a public command, a kind — and the features that\nname it. Empty means the product page says nothing about it, which is a gap the\nvalidation reports and the matrix shows rather than hides.",
      "properties": {
        "features": {
          "description": "The stable features that name it.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "id": {
          "description": "The id.",
          "type": "string"
        },
        "title": {
          "description": "The title.",
          "type": "string"
        }
      },
      "required": [
        "id",
        "title",
        "features"
      ],
      "type": "object"
    },
    "SurfaceInfo": {
      "description": "One surface of the vocabulary, as a client reads it.",
      "properties": {
        "features": {
          "description": "How many stable features it exposes.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "id": {
          "description": "`cli`, `api`, `mcp`, `cockpit` or `docs`.",
          "type": "string"
        },
        "route": {
          "description": "The route on the website where the surface is documented.",
          "type": "string"
        },
        "title": {
          "description": "The name a person reads.",
          "type": "string"
        }
      },
      "required": [
        "id",
        "title",
        "route",
        "features"
      ],
      "type": "object"
    },
    "Surfaces": {
      "description": "The interfaces a feature is exposed through, decided from what its references project\nand from nothing a file says. Each is a fact with a reason a reader can check: `cli` is\ntrue when a module of the feature has a capability with a command-line path or the\nfeature names a shell command; `api` when a module has an HTTP route; `mcp` when a module\nhas an MCP tool or resource, or the feature names a kind, since every object of the layer\nis an MCP resource; `cockpit` when the feature names a Cockpit area or a module, since\nevery capability has a Cockpit page; `docs` when it names a document.",
      "properties": {
        "api": {
          "description": "The HTTP routes under `/api/v1/`, and the OpenAPI document over them.",
          "type": "boolean"
        },
        "cli": {
          "description": "The command line: the executable's own, or the shell tool's.",
          "type": "boolean"
        },
        "cockpit": {
          "description": "The Cockpit.",
          "type": "boolean"
        },
        "docs": {
          "description": "The documentation.",
          "type": "boolean"
        },
        "mcp": {
          "description": "MCP: a tool, or a resource.",
          "type": "boolean"
        }
      },
      "required": [
        "cli",
        "api",
        "mcp",
        "cockpit",
        "docs"
      ],
      "type": "object"
    }
  },
  "description": "Every feature against every interface, and every module, command and kind against the\nfeatures that name it.",
  "properties": {
    "commands": {
      "description": "Every public command of the shell tool with the stable features that name it.",
      "items": {
        "$ref": "#/$defs/ProductCoverage"
      },
      "type": "array"
    },
    "kinds": {
      "description": "Every kind of the layer a feature can present, with the stable features that name it.",
      "items": {
        "$ref": "#/$defs/ProductCoverage"
      },
      "type": "array"
    },
    "modules": {
      "description": "Every builtin module of the executable with the stable features that name it.",
      "items": {
        "$ref": "#/$defs/ProductCoverage"
      },
      "type": "array"
    },
    "rows": {
      "description": "One row per feature of any status but deprecated, in presentation order.",
      "items": {
        "$ref": "#/$defs/MatrixRow"
      },
      "type": "array"
    },
    "schema": {
      "description": "`SCHEMA`.",
      "type": "string"
    },
    "surfaces": {
      "description": "The surface vocabulary.",
      "items": {
        "$ref": "#/$defs/SurfaceInfo"
      },
      "type": "array"
    }
  },
  "required": [
    "schema",
    "surfaces",
    "rows",
    "modules",
    "commands",
    "kinds"
  ],
  "title": "Matrix",
  "type": "object"
}