magus v0.4.3 is out. See what's new
¶ View markdown source · ✎ Suggest an edit
1 min read

agent-sign-off

A deny rule: it refuses an agent stamping a read receipt or closing an attention request, which only a person may do, and names what to run instead.

What it catches

An agent stamping a read receipt or closing an attention request, which only a person may do.

Why

This is not a permission an agent is missing: there is no spelling of either an agent may use, because an agent stamping the changeset or closing its own block would make the measure mean nothing for everybody, including the human relying on it. Report what is unread instead: magus diff --impact names every changed file carrying no receipt, and magus diff -o json puts read_state on each file for a caller to branch on. Waiting on a request instead: say you are waiting on its id and hand it back; magus session dispose <id> is a person's to run.

Seeing it

A verdict names its rule in brackets, which is how you got here:

deny [agent-sign-off]: ...

magus describe rule agent-sign-off prints the same entry at a terminal, and magus describe rules lists every rule this workspace enforces.

See also

  • All rules - what this workspace enforces, deny first
  • The guard - how a verdict is reached and wired
guardrulesagent-sign-offdeny
Last updated (02c35c81)
Glossary

Workspace

The magus root directory that owns a set of projects and shared config; the unit magus operates over. See workspace.

Spell

A language/runtime adapter (e.g. go, md) that maps generic targets onto a toolchain's real commands. See spells.

Session

An agent host's conversation, by the id the host delivers to its hooks. magus never mints one: a record with no session is unattributed, and the OS user it carries says whose account ran it.

Attention request

A durable "an agent is blocked" record, opened when a magus session notify event carries the waiting or permission outcome and held until a person disposes it. magus session attention lists what is open. Nothing closes one on its own - see doctrine.

Dispose

The human act of closing an attention request: a judgment rendered, recorded with who and why. Distinct from resolving a review thread or a merge conflict - a disposition answers a request; it does not merge anything.

Run

One target executing under one magus invocation, such as magus run test web or magus affected ci. A run keeps its captured output behind an output reference. Every magus run is a run whether or not any job asked for it; see Job for how the two relate.

Conventions

Placeholders

Angle brackets mark a value you replace with your own - never type the brackets:

magus run <target>
magus completion <shell>    # e.g. bash, zsh, fish

<target>, <path>, <shell>, <name> and the like are stand-ins, not literal text.