Daily Operations Runbook¶

Typical Daily Loop¶

flowchart TD Start[Start day] --> Pull[Pull repositories] Pull --> Up[Start selected mode] Up --> Work[Develop and test] Work --> Profile[Adjust active profile] Profile --> Work Work --> Stop[Stop stack and compose down]

Command Cheat Sheet¶

Install/update host tools from mise.toml: mise install
Start manage stack: mise run up
Start plan stack: mise run up --mode=plan
Pull clean repos: ./pull
Run service tests: mise run test [selector]
Run service lint checks: mise run lint [selector]
Run service type checks: mise run type-check [selector]
Start only DB: ./db
Start only MQ: ./mq
Clean reset: mise run reset

Selectors match checked-out repos under bf/. For example, core resolves to bf/manage-core, web resolves to bf/manage-web, and manage resolves to checked-out bf/manage-* repos. Leave the selector blank to run the detected command across every checked-out repo that supports it.

Safe Practices¶

Use focused profiles to reduce startup time.
Pull often to reduce merge drift in cloned repos.
Re-run mise install after mise.toml or a service-local mise.toml changes.
Reset when debugging stateful inconsistencies.