BMAD-METHOD/scripts/epic-execute-lib
Caleb b3a41e577e feat(epic-execute): contract harness preflight + dry-run readiness gate
Let a project declare a contract-validation harness (contract-harness.yaml)
describing how to bring up a sample/test environment and verify API + database
contracts. The system validates readiness itself - the user never hand-checks.

- contract-harness.sh: discover the harness, auto-derive prerequisites from its
  own commands (env var refs, executables, file paths) plus an optional
  requires: block, then run a presence preflight with a ✓/✗ readiness report
- Startup wiring: real runs fail fast (abort before story 1 if prerequisites are
  missing); dry runs print the report and exit non-zero when anything required
  is missing, so --dry-run works as a CI readiness gate
- Opt-in deep connectivity smoke (--preflight-deep) boots the sample env, polls
  the readiness URL, and tears down
- Safety guard: warns when the datastore target looks production-scoped
  (contract validation must only ever touch a throwaway/test store)
- --init-harness scaffolds a commented template; --skip-contract-validation
  bypasses the gate; full --help/usage documentation

Opt-in by presence of the harness file - projects without one are unaffected.
Parses/validates harness `cases`; executing them per-story is the next
increment.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-03 08:04:57 -05:00
..
INIT.md merge: sync with upstream v6.8.0 2026-05-26 06:00:02 -05:00
contract-harness.sh feat(epic-execute): contract harness preflight + dry-run readiness gate 2026-06-03 08:04:57 -05:00
decision-log.sh feat(epic-execute): add phase 2+3 improvements with modular architecture 2026-01-26 14:23:16 -06:00
design-phase.sh feat(epic-execute): domain-aware design (frontend/backend/fullstack lenses) 2026-06-03 06:25:00 -05:00
json-output.sh feat(epic-execute): domain-aware design (frontend/backend/fullstack lenses) 2026-06-03 06:25:00 -05:00
regression-gate.sh feat(scripts): port memory-safe execution and reliability improvements from revive-dev 2026-04-12 11:52:39 -05:00
tdd-flow.sh feat(epic-execute): reconcile TDD test specs with design plan 2026-06-03 06:05:33 -05:00
test-failure-filter.sh feat(epic-execute): add test failure filtering and sync improvements from revive-dev 2026-02-10 13:49:55 -06:00
utils.sh feat(scripts): port memory-safe execution and reliability improvements from revive-dev 2026-04-12 11:52:39 -05:00