Help

Help›The engines›The verdicts engine

The verdicts engine

Reviewed Sep 7, 2026

View as Markdown
Words

What it is ​

The verdicts engine reads each declared term of a commitment against what traded, once a week, and says what happened. Its only sentence has one shape: you declared this; we measured that, at this grain, over this week; the gap is worth this much. It never produces a new number you must react to. It does not re-forecast, suggest a replacement glidepath, adjust a declaration or open a planning grid; those would be a planning engine, and this is a measuring one. The only thing it writes is its weekly verdicts. Its faces are All commitments, a room's five and This week, Hindsight, the desk's readings, Home and Today.

How Tightly decides it ​

The engine runs every night at 00:30 UTC. The week it scores is the retail week that closed on Saturday, and scoring starts on Monday's run; the runs from Tuesday to Saturday only fill in verdicts that week is still missing, and Sunday's run scores nothing. It walks every tenant with an active connection and an active plan, and for each active commitment it reads seven terms against the closed week: the availability floor, the sell-through pace, the margin floor, the buy envelope, the chase reserve, the order book's coverage and the terminal stock ceiling. Each verdict reads on track, needs review or urgent. A term's tolerance is the one declared, or the engine's default where none was declared.

Before any term is tested the engine asks where the week sits in the commitment's window. Until the window opens, availability, pace and margin are not applicable yet, with the window's open date named, never a miss; the envelope and the order book are read from the start, and the terminal stock ceiling only once the window has closed. Every verdict carries the week it read, when it was scored, the grain it measured at, the size of the population it read and where its tolerance came from. A term that could not be read, or whose population moved too far since last week, is recorded as not measured with the reason, never as a miss. A verdict once written is never rewritten; a run that did not finish leaves the missing verdicts for the next night to fill.

The words on the face ​

The verdicts are one of two engines whose running state is a sentence, because the week being scored is worth naming. Where the run is not fresh, All commitments and the desk's This week reading print the engine's own sentence, character for character. Running:

Scoring last week now; started {started}.

Stale:

Last week is not scored; the last verdicts are from {as_of}.

Partial:

Last week was scored; some commitments could not be read.

Failed:

Monday's weekly run did not finish; it retries tonight.

Nothing yet (no active commitment):

Nothing is declared, so nothing is scored.

Not on your plan (the plan is not active):

The weekly verdicts run on an active plan; this is paused.

Where no run has been recorded at all, the head reads:

No weekly verdict has run yet.

On the room's This week the five read on track, needs review, urgent, not measured or not applicable yet, with the declaration each verdict read beside it. One amber mark belongs on that table, beside the word of the single number most at risk: a declared promise at risk, once per fact. Late, Stale and Failed carry no dot, because a late engine is a fact about the platform and not about your promise.

What you can do about it ​

Nothing is pressed to score a week; the engine runs each night and a failed Monday is picked up by the following nights on its own. A Stale or Failed week puts one row in your Inbox, which closes itself when a run succeeds. Declare a term on Declaration and the next Monday's run scores it. Read a term that needs you on the room's This week, then act on the desk: release the chase, amend the declaration with a second signature, or hold. At close, Hindsight reads every scored week of the season and says, for each declared term, in how many weeks it landed inside its band and whether it was kept or missed.

Weekly verdicts and Variance tiers carry the reading of each word.

Glossary line ​

The verdicts engine's Monday reading of each declared term against what traded.