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

executions.demonstrate

Demonstrate an execution

What it is

Walk a given number of steps, reporting each one, logging a line and advancing progress, then finish — or fail at a step you name. It exists so that an operator, a probe and an end-to-end test can prove the whole path works without waiting for real work: it reads nothing, writes nothing, and its only effect is the events it produces. It looks at its cancellation flag between steps and while it waits, so cancelling it stops it.

Descriptor

Canonical id: executions.demonstrate
Module: executions
Kind: query
Stability: behaviorallyverified
Provenance: declared
Source: apps/majordomus-cli/src/capability/builtin/executions.rs
Cache: disabled
Benchmark: required
Tags: executionscontrol-planediagnostic

Run

query

It reads and changes nothing, and it stops when it is asked to. Run it as an execution to watch it happen and to be able to cancel it.

Projections

Interface	As	Where
MCP tool	`majordomus_demonstrate_execution`	-
MCP resource	not exposed	-
HTTP	`GET /api/v1/executions/demonstrate`	Swagger
Command line	not exposed	-

Schemas

Input · DemonstrateInput

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "steps": {
      "type": "integer",
      "format": "uint64",
      "minimum": 0,
      "description": "How many steps to walk through.",
      "default": 3
    },
    "delay_ms": {
      "type": "integer",
      "format": "uint64",
      "minimum": 0,
      "description": "How long each step takes, in milliseconds. Bounded at ten seconds a step, so this\ncannot be used to hold a worker.",
      "default": 0
    },
    "fail_at": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint64",
      "minimum": 0,
      "description": "Fail on this step instead of completing, to show what a failure looks like."
    }
  },
  "description": "The input of `executions.demonstrate`.",
  "title": "DemonstrateInput"
}

Output · DemonstrateReport

{
  "type": "object",
  "properties": {
    "steps": {
      "type": "integer",
      "format": "uint64",
      "minimum": 0,
      "description": "How many steps ran."
    },
    "elapsed_ms": {
      "type": "integer",
      "format": "uint64",
      "minimum": 0,
      "description": "How long it took, in milliseconds."
    },
    "observed": {
      "type": "boolean",
      "description": "Whether anything was watching: false when it was called directly rather than as an\nexecution, which is the difference this capability exists to show."
    }
  },
  "required": [
    "steps",
    "elapsed_ms",
    "observed"
  ],
  "description": "The answer of `executions.demonstrate`.",
  "title": "DemonstrateReport"
}

Examples

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

immediate

{
  "steps": 1,
  "delay_ms": 0
}