Sleep-based rules

What this does

A sleep-based rule is a rule about your other rules. On a day you slept badly, it tightens the limits you already set, then grades you against the tighter numbers.

Two templates ship with it built in. One drops your trade cap and your daily red line when you sleep under 6.5 hours. The other cuts your maximum position size when you sleep under 6 hours.

How it works

The rule has two parts: a condition on your sleep hours, and a list of rules to tighten, each with a new limit.

Grading happens in two passes.

Pass one checks the condition. If it holds for that day, every rule you listed is graded against its new limit instead of its normal one. When two modifiers point at the same rule, the tighter of the two wins: the lower number for a trade count or a position size, and the number closer to zero for a loss line.

Pass two grades the modifier itself:

condition did not fire, or any target is missing or N/A  → N/A
condition fired and every target was Followed             → Followed
any target was Partial or Not Followed                    → Not Followed

A modifier can only point at ordinary rules. It cannot point at another modifier, so there is no chain to unravel.

Why it stays N/A

Without sleep hours for that day, the condition cannot be evaluated, so the rule never fires and never grades. It sits at N/A indefinitely, and because N/A rules are excluded from the day’s compliance score, it quietly contributes nothing.

Sleep hours reach VEXA two ways:

• Synced from your phone. Apple Health on iPhone, Health Connect on Android. The web can display what your phone collected but never collects any itself.
• Typed in by hand in the Day Detail panel of the Rules Tracker.

If you have no wearable, the manual field is the whole mechanism. It is also the fix for a night the watch missed.

Enter sleep hours by hand

One rule can tighten several rules at once

A modifier takes between one and fifty targets, each with its own new limit. The built-in low-sleep template uses two: it takes a ten-trade cap down to five and a minus 5,000 red line down to minus 2,000, on the same night.

There is a consequence worth knowing. A modifier can point at a template rather than at one specific rule. If you created three rules from the same template, all three get tightened together.

Where to create one

The conditional modifier is in the structured builder on the web and on Android, listed as Conditional modifier (sleep) and Conditional.

It is not in the structured builder on iPhone or iPad. On those devices, add it from the template gallery or describe it in plain English. Both routes produce exactly the same rule. See Create a rule from a template.

What you should see

On a day the condition fired, the targeted rules show their tightened limits in their evidence strings rather than their normal ones. The modifier itself shows Followed or Not Followed rather than N/A.

If it doesn’t work

• The rule has never graded anything. No sleep data. Enter sleep hours for a day by hand and check that the rule grades on that day.
• It fired but the targeted rules used their normal limits. The target could not be resolved. Rules whose targets do not exist are stripped when the rule is saved, so recreate the modifier after the target rules exist.
• It grades N/A on a day you know you slept badly. One of its targets was itself N/A. The modifier will not claim a result it cannot verify across every target.
• You cannot find the option on your iPhone. Use a template or plain English.

Related

• The six rule types explained
• Override a day’s grading