Testing Guide¶

Test Scope in bf-dev¶

The harness itself includes smoke-level tests in tests/ focused on scripts and menu behavior.

Running Harness Tests¶

Use your preferred test runner for shell/python tests in tests/ (for example, local shell scripts and menu tests).

Service-level Tests¶

Run tests inside each downstream service repo or its containerized runtime.

Validation Layers¶

flowchart TD
  Harness[bf-dev script tests] --> Confidence[orchestration confidence]
  ServiceTests[service repo tests] --> Behavior[domain behavior confidence]
  ComposeRun[compose startup checks] --> Runtime[runtime integration confidence]

Practical Checks¶

• Start target mode and ensure healthchecks pass.
• Validate critical UI/API paths for the active domain.
• Re-run after ./pull when dependencies move.