Skip to main content
Architecture · Intent & ECO

Severity Escalation

Dimension failures compose into a task-level severity that forces lane escalation. The final lane is always max(eco_forced_min, analyst_override).


Escalation Matrix​

ECO stateForced minimum laneNotes
All dimensions OKADefault — most commits
Any dimension at warnAPenalty applied, lane unchanged
Any dimension at escalateBAnalyst notified
Any dimension at blockCHuman gate required
2+ dimensions at escalateCCompound escalation
Coverage block + Graph blockC + pipeline haltInsufficient evidence

Escalation is a Floor​

Escalation can only raise the lane — it can never lower it. A task the analyst manually classified as Lane C stays in Lane C even if all ECO dimensions are OK.

final_lane = max(eco_forced_minimum, analyst_override, default_lane)

Notification Behaviour​

SeverityDeveloper notificationAnalyst notification
warnNone (silent)None
escalateIn-terminal warningYes — queue entry
blockBlocking error + reasonYes — priority

Recovery​

Escalated tasks can recover without manual intervention if the root cause is fixed:

  • Freshness escalation — resolves after nirnex index catches up to HEAD
  • Coverage escalation — resolves after missing modules are indexed
  • Conflict escalation — requires manual conflict resolution or source override
  • Mapping block — requires fixing the spec reference or creating the missing module