Reads cost-tracking:budget-config for the project's budget limit, sums total_cost_usd across session-* records produced by cost-track, computes utilization, and emits the measured 4-tier alert ladder (50% INFO / 75% WARNING / 90% CRITICAL / 100% HARD_STOP).
Until P2 (this skill) landed, the README documented the alert ladder but no code checked it. Now this skill is the gate.
/cost-optimize first./loop 30m for continuous monitoring.```bash
node plugins/ruflo-cost-tracker/scripts/budget.mjs check
```
Filter by period: BUDGET_PERIOD=today (default all). Use BUDGET_QUIET=1 for machine-readable JSON.
```bash
node plugins/ruflo-cost-tracker/scripts/budget.mjs set 50.00
node plugins/ruflo-cost-tracker/scripts/budget.mjs get
```
budget.mjs check exits with code 1 when utilization โฅ 100%. Wrap critical agent spawns in a budget.mjs check && spawn โฆ guard to fail closed.cost-tracking:budget-config){
"budget_usd": 50.00,
"setAt": "2026-05-05T...",
"thresholds": { "info": 0.50, "warning": 0.75, "critical": 0.90, "hard_stop": 1.00 }
}
| Threshold | Level | Action |
|---|---|---|
| 50% | INFO ๐ก | log notification, no UX disruption |
| 75% | WARNING ๐ | display warning, suggest /cost-optimize |
| 90% | CRITICAL ๐ด | urgent alert, recommend model downgrades |
| 100% | HARD_STOP ๐ | halt non-essential spawns; exit code 1 |
cost-track (producer) โ populates cost-tracking:session-*cost-report โ same data source, narrative formatcost-optimize โ recommended action when WARNING/CRITICAL