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.artifact

The artifact of a target

What it is

The archive name a target and a tag derive, the directory it unpacks into, and where a release publishes it. The one naming function answers; the release pipeline asks it rather than composing a name in a workflow file.

Descriptor

Canonical id: distribution.artifact
Module: distribution
Kind: query
Stability: behaviorallyverified
Provenance: declared
Source: apps/majordomus-cli/src/capability/builtin/distribution.rs
Cache: disabled
Benchmark: required
Tags: distributionrelease

Run

query

A query. It reads and changes nothing.

Projections

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

Schemas

Input · ReleaseArtifactInput

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "target": {
      "type": "string",
      "description": "A target's id or its Rust target triple."
    },
    "tag": {
      "type": "string",
      "description": "The tag, `v` and a version. `{tag}` asks for the name with the placeholder left in."
    }
  },
  "required": [
    "target",
    "tag"
  ],
  "description": "Which artifact a target and a tag name.",
  "title": "ReleaseArtifactInput"
}

Output · ReleaseArtifactView

{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "description": "The target's id in the model."
    },
    "rust_target": {
      "type": "string",
      "description": "The Rust target triple."
    },
    "tag": {
      "type": "string",
      "description": "The tag the name was derived for."
    },
    "name": {
      "type": "string",
      "description": "The archive's file name."
    },
    "root": {
      "type": "string",
      "description": "The directory the archive unpacks into."
    },
    "url": {
      "type": "string",
      "description": "Where a release publishes it, when the tag is a real one."
    }
  },
  "required": [
    "target",
    "rust_target",
    "tag",
    "name",
    "root",
    "url"
  ],
  "description": "The artifact a target and a tag name, and the directory it unpacks into.",
  "title": "ReleaseArtifactView"
}

Examples

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

first-published-target

{
  "target": "aarch64-apple-darwin",
  "tag": "v0.0.0"
}