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

distribution.releases

Published releases

What it is

Every release this repository recorded, newest first, and the one an unpinned installation resolves to: the highest version among the stable, unwithdrawn records. The pointer is derived here and never authored anywhere.

Descriptor

Canonical id: distribution.releases
Module: distribution
Kind: query
Stability: behaviorallyverified
Provenance: declaredcached
Source: apps/majordomus-cli/src/capability/builtin/distribution.rs
Cache: process, 1 entries, per generation
Benchmark: required
Tags: distributionrelease

Run

query

A query. It reads and changes nothing.

Projections

Interface	As	Where
MCP tool	`majordomus_releases`	-
MCP resource	not exposed	-
HTTP	`GET /api/v1/distribution/releases`	Swagger
Command line	`majordomus distribution releases`	-

Schemas

Input · Empty

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

Output · ReleasesReport

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "format": "uint",
      "minimum": 0,
      "description": "How many records there are."
    },
    "latest": {
      "anyOf": [
        {
          "$ref": "#/$defs/ReleaseView"
        },
        {
          "type": "null"
        }
      ],
      "description": "The release an unpinned installation resolves to, when there is one."
    },
    "releases": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ReleaseView"
      },
      "description": "Every record, newest first."
    }
  },
  "required": [
    "count",
    "releases"
  ],
  "description": "The releases this repository recorded, and the one an unpinned installation resolves to.",
  "title": "ReleasesReport",
  "$defs": {
    "ReleaseView": {
      "type": "object",
      "properties": {
        "tag": {
          "type": "string",
          "description": "The git tag."
        },
        "version": {
          "type": "string",
          "description": "The semantic version."
        },
        "channel": {
          "$ref": "#/$defs/Channel",
          "description": "Whether an unpinned installation may resolve it."
        },
        "published_at": {
          "type": "string",
          "description": "When it was published, UTC."
        },
        "commit": {
          "type": "string",
          "description": "The commit it was built from."
        },
        "yanked": {
          "type": "boolean",
          "description": "True when it has been withdrawn."
        },
        "artifacts": {
          "type": "integer",
          "format": "uint",
          "minimum": 0,
          "description": "How many artifacts it published."
        },
        "metadata_url": {
          "type": "string",
          "description": "Where its public metadata is served."
        }
      },
      "required": [
        "tag",
        "version",
        "channel",
        "published_at",
        "commit",
        "yanked",
        "artifacts",
        "metadata_url"
      ],
      "description": "One release, as every projection shows it."
    },
    "Channel": {
      "oneOf": [
        {
          "type": "string",
          "const": "stable",
          "description": "Resolved by `latest`."
        },
        {
          "type": "string",
          "const": "prerelease",
          "description": "Published, addressable by its exact tag, never resolved by default."
        }
      ],
      "description": "Which releases an unpinned installation may resolve to."
    }
  }
}

Examples

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

default

{}