commands.list

Příkazy, které tento repozitář nabízí, filtrované podle programu, který je spouští, podle toho, co jejich spuštění mění, nebo podle textu. Shrnutí, ne celý graf: dost na výběr příkazu a nikdy tolik, aby klient musel číst každý argument každého příkazu, aby jeden našel.

query
implementováno
module commands
#commands
#introspection

Zpřístupnění

Kde je tato jedna definice dosažitelná. Absence je explicitní: povrch, který není uveden, ji nenese.

povrch	jako
MCP	nástroj majordomus_commands zdroj majordomus://commands
HTTP	GET /api/v1/commands operationId commands.list
příkazová řádka	—

Schémata

Kanonický vstup a výstup z typů Rustu; schéma nástroje MCP a parametry a odpovědi OpenAPI se odvozují z nich.

vstup · CommandFilter

Čím příkazy odpovědět. Každý filtr je vlastní slovník grafu; žádný není hledáním ve vykresleném textu.

vlastnost	typ	povinné	popis
účinek	string \| null	ne	Jen příkazy, jejichž efekt je nejvýše tento: `read_only`, `local_mutation`, `repository_mutation`, `network_mutation`, `destructive`.
původ	string \| null	ne	Jen příkazy jednoho programu: `executable`, `tool` nebo `workflow`.
hledání	string \| null	ne	Jen příkazy, které tomuto textu odpovídají v invokaci, shrnutí, štítcích nebo identitě.

JSON Schema

{
  "additionalProperties": false,
  "description": "Which commands to answer with. Every filter is the graph's own vocabulary; none is a\nsearch over rendered text.",
  "properties": {
    "effect": {
      "description": "Only the commands whose effect is at most this one: `read_only`,\n`local_mutation`, `repository_mutation`, `network_mutation`, `destructive`.",
      "type": [
        "string",
        "null"
      ]
    },
    "origin": {
      "description": "Only the commands of one program: `executable`, `tool` or `workflow`.",
      "type": [
        "string",
        "null"
      ]
    },
    "search": {
      "description": "Only the commands matching this text in their invocation, summary, tags or identity.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "title": "CommandFilter",
  "type": "object"
}

výstup · CommandIndex

Příkazy, které tento repozitář nabízí, filtrované.

vlastnost	typ	povinné	popis
commands	array	ano	Příkazy, které odpovídaly, v pořadí grafu.
otisk	string	ano	Otisk toho grafu: klient se proti němu může cachovat.
schema	string	ano	Schéma grafu, z něhož toto pochází.
celkem	integer	ano	Kolik příkazů graf obsahuje, před filtrem.

JSON Schema

{
  "$defs": {
    "CommandProjections": {
      "description": "Where one command appears, derived from its effect, its interactivity and its origin.\n\nEvery field is computed by `super::policy`. Nothing declares a projection, and no\nsurface keeps a list of what it carries: a surface asks the graph.",
      "properties": {
        "cli": {
          "description": "The command line, as typed.",
          "type": [
            "string",
            "null"
          ]
        },
        "cockpit": {
          "description": "The Cockpit address, when the surface carries it.",
          "type": [
            "string",
            "null"
          ]
        },
        "docs": {
          "description": "The page on the site. Every command has one.",
          "type": "string"
        },
        "http": {
          "description": "The HTTP route, when the capability behind it declares one.",
          "type": [
            "string",
            "null"
          ]
        },
        "mcp": {
          "description": "The MCP tool name, when the capability behind it declares one.",
          "type": [
            "string",
            "null"
          ]
        },
        "withheld": {
          "description": "Why a machine surface does not carry it, when one does not.",
          "type": [
            "string",
            "null"
          ]
        },
        "workflow": {
          "description": "The generated workflow bridge's recipe name.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "docs"
      ],
      "type": "object"
    },
    "CommandSummary": {
      "description": "One command, as an index shows it: enough to choose, never enough to have to skim.",
      "properties": {
        "effect": {
          "description": "What running it changes.",
          "type": "string"
        },
        "group": {
          "description": "The group it is found under.",
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "description": "The canonical identity.",
          "type": "string"
        },
        "invocation": {
          "description": "The command line a person types.",
          "type": "string"
        },
        "origin": {
          "description": "Which program runs it.",
          "type": "string"
        },
        "projections": {
          "$ref": "#/$defs/CommandProjections",
          "description": "Where it appears."
        },
        "summary": {
          "description": "One line.",
          "type": "string"
        }
      },
      "required": [
        "id",
        "invocation",
        "summary",
        "origin",
        "effect",
        "projections"
      ],
      "type": "object"
    }
  },
  "description": "The commands this repository offers, filtered.",
  "properties": {
    "commands": {
      "description": "The commands that matched, in graph order.",
      "items": {
        "$ref": "#/$defs/CommandSummary"
      },
      "type": "array"
    },
    "fingerprint": {
      "description": "The fingerprint of that graph: a client may cache against it.",
      "type": "string"
    },
    "schema": {
      "description": "The schema of the graph these came from.",
      "type": "string"
    },
    "total": {
      "description": "How many commands the graph holds, before the filter.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "schema",
    "fingerprint",
    "total",
    "commands"
  ],
  "title": "CommandIndex",
  "type": "object"
}

Politiky

benchmark: povinné — cíl na každém transportu, který expozice deklaruje; případy jsou ty ze vstupního typu
cache: vypnuto — každé volání spustí handler

Cíle benchmarku

Odvozeno z registru pro tento repozitář: jeden požadavek na transport a případy, které poskytuje typ vstupu. Celá matice je na stránce měření výkonu.

transport	state	případy	targets
direct	pokryto	3	vše jen pro čtení one-program
mcp	pokryto	3	vše jen pro čtení one-program
http	pokryto	3	vše jen pro čtení one-program