Check, then apply a play

§ 1Purpose

Preview what a play would change (report-only), then converge the machine.

§ 2Prerequisites

• A validated playbook.
• Authorization to mutate the target machine before applying.

§ 3Flowchart

§ 4Steps

$ config-weave check ./my-playbook baseline
make-a   not configured
make-b   not configured

Run config-weave check ./my-playbook <play> to see the per-step status without changing anything. Use --var KEY=VALUE / --var-file to supply variables.

$ config-weave apply ./my-playbook baseline
make-a   configured
make-b   configured

Run config-weave apply ./my-playbook <play>. Each unconfigured step applies, then re-checks; configured means apply changed it and the re-check confirmed. A reboot-required step halts the play with exit 3.

$ config-weave apply ./my-playbook baseline
make-a   already configured
make-b   already configured

Run apply again: every step should report already configured. If a step re-applies, its check depends on in-process state and the convergence contract is broken.