Module run_dir 

Human-readable run directory naming: {slug}_{unix_timestamp}.

The run’s internal identifier stays a UUID v7 (stored in checkpoint.json and event payloads). The on-disk directory name is derived from the workflow name + timestamp for easy scanning and CLI tab-completion.

Functions

compose

Compose a directory name: {slug}_{timestamp}.

derive_slug

Derive a slug from the workflow source.

ensure_unique

Ensure the directory name doesn’t collide with an existing directory. Appends _2, _3, … as needed.

slugify

Convert an arbitrary string into a filesystem-safe slug.