Module fleet 

Fleet — a named squad of agents working a shared goal over one channel.

Structs

Fleet

FleetHitl

Per-fleet approval policy. A floor, never a grant: every field here can only make an outcome stricter or change WHO waits — none of them approves anything, and there is deliberately no “auto-approve” knob (that is what --yes is, and it stays unreachable from unattended fleet paths).

FleetLoop

Job

A job represents a unit of work submitted to a fleet for execution. The id is a UUIDv7 — time-sortable, so FIFO ordering is just a filename sort.

Enums

JobStatus

Job status lifecycle: queued → running → {done, failed, canceled}, with blocked as a non-terminal detour: the run reached an action that needs a human and stopped there. An approval resumes it, so it is deliberately NOT terminal — reporting it as done would claim work nobody did, and reporting it as failed would claim a fault that did not occur.

Constants

CHANNEL_PREFIX

Channel-id prefix for a fleet’s shared channel (fleet-<name>).

CONCIERGE_AGENT

Functions

fleet_name_from_channel_id

Derive the fleet name from a channel id of the form fleet-<name>.

valid_fleet_name

A fleet name must be a filesystem-safe lowercase slug (it becomes a directory ~/.mur/fleets/<name> and a channel id fleet-<name>).