Skip to content

Every finding carries the command that reproduces it

When doctor, check, watch or finish report a failure or a drift, the line ends with [reproduce: <command>] — a shell command a person can run to see the same fact without Majordomus. A finding that cannot be reproduced independently is treated as a bug in Majordomus.

declared statusdeclared status: guaranteed Declared deterministic and blocking, implemented, and naming the behavioural test that is to prove it. Whether a recorded run supports it is the evidence verdict, shown beside it.

recorded evidencerecorded evidence: not run Declared guaranteed, and not supported by a recorded run: the test is named, and no passing run of the current inputs is recorded. how evidence is recorded

What it means

When doctor, check, watch or finish report a failure or a drift, the line ends with [reproduce: <command>] — a shell command a person can run to see the same fact without Majordomus. A finding that cannot be reproduced independently is treated as a bug in Majordomus.

How it works

Every finding goes through one printer in lib/common.sh that takes a level, a category, a subject, a message and a reproduce command. With --json the same fields come out as one JSON object per line, so a script can act on them.

How to see it

majordomus doctor
# FAIL wiring      finish-on-push — hook .git/hooks/pre-push does not exist  [reproduce: ls -l .git/hooks/pre-push]
majordomus --json doctor | head -1

What it does not cover

Informational lines (INFO) may omit a reproduce command when there is nothing to reproduce.

Why it exists

Every audit in the source environment — including the one that cleaned up the others — contained at least one false claim caught only by an independent second reader. A finding you can rerun yourself does not need to be believed.

Detail rendered from docs/claims/reproduce-command.md.

From the statement to the proof

  1. 1 · the public statement

    Every finding carries the command that reproduces it

    Made on Finish contract.

  2. 2 · the canonical claim

    reproduce-commanddeclared status: guaranteed in docs/CLAIMS.yaml

    Defined in read it on this site · docs/DESIGN.md

  3. 3 · the implementation

    lib/common.sh

  4. 4 · the test and the scenarios

    Test: test/cases/02_doctor_basic.sh

    Executed in Prove a rule is actually enforced, not merely written down, Find out what has drifted since anyone last looked, Gate CI on the tool itself, with an exit code that is a contract.

  5. 5 · the recorded runs

    recorded evidence: not run how evidence is recorded

Verify it yourself

The test runs in a disposable temporary repository and asserts the behaviour, not a string in the source.

from a clone of the repository
bash test/run.sh 02_doctor_basic

Where this claim is used

Related claims same implementation

The moments this answers

Searches the titles and descriptions of every page this site publishes.