Skip to main content

Control-Loop Stability Margin

CT phase/gain margin tracking: stable → marginal → unstable as a closed loop's margins erode (sensor lag, plant drift). Catches oscillation before it runs away.

CategoryControl Systems
Template IDcontrol-loop-stability
Definitioncontrol_loop_stability v1.0
States4 (initial: stable; terminal: retuned)
Transitions4
Operators composedCT2, CT3, KO42
Audit clockon · tick rate 1

What it's for

  • Industrial PID tuning
  • Flight-control health
  • Autopilot certification logs

States

StateRole
stableinitial
marginalintermediate
unstableintermediate
retunedterminal

Transitions

FromToOperatorFires whenProofTrigger / actions
stablemarginalCT2input.phase_margin_deg < input.marginal_degrequired
marginalunstableCT3input.phase_margin_deg < input.unstable_deg || input.gain_margin_db < input.min_gain_dbrequired
marginalstableCT2input.phase_margin_deg >= input.marginal_degrequired
unstableretunedKO42input.retune_done == trueno

Operators it composes

Each transition fires a registry operator through the master equation (compute → prove → verify). This template composes:

  • CT2
  • CT3
  • KO42

Browse the operators at /operators/; the building blocks a transition calls are the framework's protocols. KO42 is the always-on substrate operator; physics operators carry proof_required: true, so each fire runs the full compute → prove → verify path and lands a verifiable proof digest on your entangled state.

Deploy it

Inspect the full definition, then deploy it onto your state machine. Every fire is Zeqond-stamped onto your entangled state.

# 1. Inspect — the full definition (states, transitions, operators) as served
curl -sS https://zeqsdk.com/api/contracts/templates/control-loop-stability

# 2. Deploy onto your machine (auth: session; body carries your machine slug)
curl -sS -X POST https://zeqsdk.com/api/contracts/templates/control-loop-stability/deploy \
-H "Content-Type: application/json" \
-b "<your session cookie>" \
-d '{"slug":"<your-machine>"}'
# → 201 { "ok": true, "contract": { "id": "…", "currentState": "stable", … },
# "template_id": "control-loop-stability" }

The deploy path runs the same two-stage validation as the canonical create route (ContractDefinitionSchema.parse + validateContractDefinition against the live registry), writes the creation row onto your entangled state, and schedules the first fire. From there, drive transitions with POST /api/chain/<your-machine>/contracts/<id>/transition or let any triggers fire them autonomously.

Next

  • Contract IDE — author, preview, and deploy contracts (this template is in the Templates tab).
  • State Contracts — the full contract model: conditions, triggers, pre/post actions, lifecycle.
  • Templates Library — every ready-to-deploy contract, grouped by category.
  • Protocols — the named building blocks a transition composes.