delivery.feature

One product feature against the delivery invariant: every dimension with its verdict, the sentence that decided it and what would change it, whether it exists, and — when it does not — how far development has carried it and which dimensions block it. An id the layer does not declare is not found rather than answered as not delivered.

query
experimental
module delivery
#delivery
#features
#verification

Exposure

Where this one definition is reachable. Absence is explicit: a surface not listed does not carry it.

surface	as
MCP	tool majordomus_delivery_feature
HTTP	GET /api/v1/delivery/feature operationId delivery.feature
command line	majordomus delivery show

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 · DeliveryFeatureInput

The input of delivery.feature: which feature.

property	type	required	description
id	string	yes	The feature's id, as `product.features` gives it.

JSON Schema

{
  "additionalProperties": false,
  "description": "The input of `delivery.feature`: which feature.",
  "properties": {
    "id": {
      "description": "The feature's id, as `product.features` gives it.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "title": "DeliveryFeatureInput",
  "type": "object"
}

output · FeatureDelivery

One feature against the invariant.

property	type	required	description
delivery	reference	yes	Delivered, or the development stage and what blocks it.
dimensions	array	yes	Every dimension, in the order of the conjunction.
exists	boolean	yes	The conjunction: true only when every dimension passes.
id	string	yes	The feature's id.
implementation	reference	yes	What it is implemented by.
status	string	yes	The status its file declares. Editorial, and not one of the dimensions.
title	string	yes	Its title.

JSON Schema

{
  "$defs": {
    "DeliveryState": {
      "description": "Delivered, or not — and when not, how far development got and which dimensions stand in\nthe way. Two variants of one type rather than a flag beside a stage: a delivered feature\nhas no stage to report, and a stage can never be read as delivery.",
      "oneOf": [
        {
          "description": "Every dimension passes.",
          "properties": {
            "state": {
              "const": "delivered",
              "type": "string"
            }
          },
          "required": [
            "state"
          ],
          "type": "object"
        },
        {
          "description": "At least one dimension does not pass.",
          "properties": {
            "blocking": {
              "description": "The dimensions that do not pass, in the order of the conjunction.",
              "items": {
                "$ref": "#/$defs/DimensionId"
              },
              "type": "array"
            },
            "stage": {
              "$ref": "#/$defs/DevelopmentStage",
              "description": "How far development has carried it."
            },
            "state": {
              "const": "not_delivered",
              "type": "string"
            }
          },
          "required": [
            "state",
            "stage",
            "blocking"
          ],
          "type": "object"
        }
      ]
    },
    "DeliveryVerdict": {
      "description": "One dimension's answer. Three values and never two: a question that could not be asked\nis not a question answered yes, and it is not one answered no either.",
      "oneOf": [
        {
          "const": "pass",
          "description": "The dimension holds, and the reason says what was observed.",
          "type": "string"
        },
        {
          "const": "fail",
          "description": "The dimension was measured and does not hold.",
          "type": "string"
        },
        {
          "const": "unknown",
          "description": "The dimension could not be measured. Not a pass.",
          "type": "string"
        }
      ]
    },
    "DevelopmentStage": {
      "description": "How far development has carried a feature that does not exist yet. A ladder: a rung is\nreached only when every rung below it passes, so a feature whose tests are unknown is\n`on_master` even when the site already serves it.",
      "oneOf": [
        {
          "const": "unknown",
          "description": "Git could not say where its implementation is.",
          "type": "string"
        },
        {
          "const": "not_implemented",
          "description": "It names no implementation, or nothing ever committed one.",
          "type": "string"
        },
        {
          "const": "implemented_on_branch",
          "description": "Its latest implementation revision is on a branch and not on the trunk.",
          "type": "string"
        },
        {
          "const": "on_master",
          "description": "Its implementation is on the trunk.",
          "type": "string"
        },
        {
          "const": "tested",
          "description": "On the trunk, with every required test current.",
          "type": "string"
        },
        {
          "const": "deployed",
          "description": "Tested, and contained in what the public site serves.",
          "type": "string"
        }
      ]
    },
    "Dimension": {
      "description": "One dimension, decided: the verdict, the sentence that decided it, and what would move it.",
      "properties": {
        "dimension": {
          "$ref": "#/$defs/DimensionId",
          "description": "Which dimension."
        },
        "reason": {
          "description": "What was observed, in one sentence.",
          "type": "string"
        },
        "remediation": {
          "description": "What would change the verdict; absent on a pass.",
          "type": [
            "string",
            "null"
          ]
        },
        "verdict": {
          "$ref": "#/$defs/DeliveryVerdict",
          "description": "Pass, fail or unknown."
        }
      },
      "required": [
        "dimension",
        "verdict",
        "reason"
      ],
      "type": "object"
    },
    "DimensionId": {
      "description": "The six dimensions of the delivery invariant, in the order the conjunction is written.",
      "oneOf": [
        {
          "const": "on_master",
          "description": "The feature's latest implementation revision is reachable from the trunk.",
          "type": "string"
        },
        {
          "const": "deployed",
          "description": "The public site's identity commit contains that revision.",
          "type": "string"
        },
        {
          "const": "publicly_verified",
          "description": "The publication was verified from outside: the site answers with a clean identity,\na second probe agrees, and GitHub's own build of the published branch succeeded.",
          "type": "string"
        },
        {
          "const": "required_tests_current",
          "description": "Every test the feature requires has a current passing execution.",
          "type": "string"
        },
        {
          "const": "test_evidence_published",
          "description": "The evidence of those executions is published.",
          "type": "string"
        },
        {
          "const": "ui_linked",
          "description": "The feature is linked from the user interface.",
          "type": "string"
        }
      ]
    },
    "Implementation": {
      "description": "The paths a feature is implemented by and the revisions that last touched them.",
      "properties": {
        "head_revision": {
          "description": "The latest commit touching them reachable from `HEAD`.",
          "type": [
            "string",
            "null"
          ]
        },
        "master_revision": {
          "description": "The latest commit touching them reachable from the trunk.",
          "type": [
            "string",
            "null"
          ]
        },
        "paths": {
          "description": "Repository-relative paths, derived from what the feature names: the source file of\nevery capability module, `lib/<command>.sh` of every shell command the dispatcher\nsources, and the `implementation` of every claim.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "paths"
      ],
      "type": "object"
    }
  },
  "description": "One feature against the invariant.",
  "properties": {
    "delivery": {
      "$ref": "#/$defs/DeliveryState",
      "description": "Delivered, or the development stage and what blocks it."
    },
    "dimensions": {
      "description": "Every dimension, in the order of the conjunction.",
      "items": {
        "$ref": "#/$defs/Dimension"
      },
      "type": "array"
    },
    "exists": {
      "description": "The conjunction: true only when every dimension passes.",
      "type": "boolean"
    },
    "id": {
      "description": "The feature's id.",
      "type": "string"
    },
    "implementation": {
      "$ref": "#/$defs/Implementation",
      "description": "What it is implemented by."
    },
    "status": {
      "description": "The status its file declares. Editorial, and not one of the dimensions.",
      "type": "string"
    },
    "title": {
      "description": "Its title.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "title",
    "status",
    "exists",
    "delivery",
    "dimensions",
    "implementation"
  ],
  "title": "FeatureDelivery",
  "type": "object"
}

Policies

benchmark: waived — waived: external_dependency
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.

transport	state	cases	targets
direct	waived (external_dependency)	0
mcp	waived (external_dependency)	0
http	waived (external_dependency)	0