Co-authored-by: Carlos Florencio <carlosmflorencio@gmail.com>
2.8 KiB
status, system, specification_version, owners
| status | system | specification_version | owners | |
|---|---|---|---|---|
| draft | office | 1 |
|
Office glossary
Shared vocabulary for Office specifications. Terms are grouped by the capability that defines them; a capability's requirement documents reference this file rather than restating a definition, so one term cannot drift between documents.
Budget enforcement
Defined by Office: Pre-Launch Budget Enforcement and used by Budget Admission Integrity, Built-In Default Spend Ceiling, Budget Measurement Integrity and Budget Enforcement Observability.
- Run provenance: the classification of a run as attended or
unattended, derived from
runs.reason. - Attended run: a run whose reason is in the attended allowlist
(
AC-OFFICE-BUDGET-007.2). A person plausibly caused it and is plausibly waiting on it. - Unattended run: any run that is not attended, including any reason the allowlist does not recognize.
- Subcent: one hundredth of a United States cent, i.e.
1 USD = 10_000subcents. Already the storage unit ofoffice_cost_events.cost_subcentsandoffice_budget_policies.limit_subcents. - Priced spend: the sum of
cost_subcentsover the cost events a policy's scope selects (AC-OFFICE-BUDGET-002.15) and whoseoccurred_atfalls in the evaluation window, which by construction counts an unpriced event as zero. - Unpriced event: a cost event with
cost_source = 'unpriced'. A NULLcost_sourceis not an unpriced event — it is a legacy row written before the cost contract added the column, and it carries a real cost. - Pricing-degraded window: an evaluation window containing at least one unpriced event.
- Evaluator fault: the pre-execution budget evaluator returning a non-nil error. A missing evaluator is a distinct state, not a fault.
- Evaluation window: the half-open interval
[cutoff, now)a policy's period selects, withcutoffcomputed in UTC. - Admission gate: one of the five ordered checks in
AC-OFFICE-BUDGET-001.14that can stop a run before launch. - Applicable policy: a policy selected for a run by
AC-OFFICE-BUDGET-001.15.
Polarity warning for implementers.
IsPeriodicTasklessWakeclassifies the ambiguous legacy reasonroutine_dispatchas non-periodic, because for the idle-skip gate the safe answer is "do not skip". For budget enforcement the safe answer is the opposite: the same literal is unattended, because the safe answer here is "do not spend". ReusingIsPeriodicTasklessWakefor provenance would invert this and fail open on exactly the legacy cron rows it is meant to catch.