Skip to content

gz chores run

Execute one chore and append a dated log entry.

Usage

Bash
gz chores run <slug>

Runtime Behavior

  • Executes only steps[*].argv arrays declared in the chore's acceptance.json / CHORE.md, resolved via the project-first → package-fallback resolver (ADR-0.0.21): <project_root>/.gzkit/chores/<slug>/ first, then importlib.resources.files("gzkit.chores") as the package fallback.
  • Refuses shell-string command definitions (command) to keep execution deterministic.
  • Writes a dated entry to: .gzkit/chores/<slug>/proofs/CHORE-LOG.md (project-local execution evidence is never canonical).
  • Returns non-zero on command failure, timeout, or missing executable.
  • Refuses a chore with no class declaration before running anything, with a BLOCKERS: message naming it and exit 1 (GHI #999). Declare it on its registry.json entry (src/gzkit/chores/README.md § Class Declaration).

Example

Bash
uv run gz chores run quality-check