cost-guard

# cost-guard ## Purpose Watch app-level financial state and warn an operator when GCP burn or LLM token consumption is on track to breach a configured budget. cost-guard is the alarm complement to F001 cost-model: cost-model tells you what the trajectory is, cost-guard tells you whether the trajectory matters. Writes findings into the existing F008 INBOX.md surface so cost alerts share an inbox with `quota_warn` and `breaker_tripped` rather than introducing a new operator channel. This skill is **app-level**, distinct from F006 budget_ceiling which guards orchestration-agent quotas inside autonomous dispatches. Different lane, different consumer. ## Arguments | Argument | Required | Description | |---|---|---| | `--costs` | no | Path to costs.json (default: `dashboard/state/costs.json`) | | `--quota` | no | Path to quota_state.json (default: `~/.jarvis/quota_state.json`) | | `--budgets` | no | Path to cost_budgets.json (default: `config/cost_budgets.json`) | | `--inbox-dir` | no | Directory containing INBOX.md (default: `dashboard/state/cost-guard/`) | | `--seen-state` | no | Path to dedupe state file (default: `dashboard/state/cost-guard/cost_guard_seen.json`) | | `--as-of` | no | Override "now" with an ISO-8601 timestamp for deterministic tests | | `--fixtures` | no | Directory containing `costs.json`, `quota_state.json`, `cost_budgets.json` — convenient for testing | If no arguments: reads defaults and writes to `dashboard/state/cost-guard/INBOX.md`. ## Prerequisite...