Skip to content

Operate Shared Manual Gates (HyOps)

Purpose

core/shared/manual-gate is the generic operator acknowledgement module for control-plane workflows that must not proceed on assumption alone.

Use it when HyOps needs a durable, explicit decision point before actions such as:

  • DR DNS cutover
  • DR DNS cutback
  • destructive maintenance
  • external/provider-native promotion steps already done outside HyOps

Validate

cd "$HOME/hybridops-core"

./.venv/bin/hyops validate --env dev --skip-preflight \
  --module core/shared/manual-gate \
  --inputs modules/core/shared/manual-gate/examples/inputs.min.yml

Apply

cd "$HOME/hybridops-core"

./.venv/bin/hyops apply --env dev \
  --module core/shared/manual-gate \
  --inputs modules/core/shared/manual-gate/examples/inputs.min.yml

Required behavior

The module will fail unless:

  • confirm=true
  • every provided assertion is true
  • gate_name and gate_message are non-empty

Expected outputs

  • gate.name
  • gate.message
  • gate.confirmed
  • gate.assertions
  • gate.evidence_notes
  • cap.control.manual_gate = confirmed

Notes

  • this module does not mutate provider resources
  • it exists to make human control points explicit in state and evidence
  • use concise evidence notes only; do not place secrets or sensitive payloads into them