Explain Varianceexplain_variance
Explain why a metric (budget, pipeline, attendance, ROI) differed from expectation. Returns named causes from the provenance trail with magnitude and direction.
Answer
When to use Explain Variance
Use when a specific event metric changed or missed expectation and governed causes are needed.
Governed tool contract
- Job
- Justify spend
- Output type
- Heuristic
- Write contract
- Read-only; no approval or commit action
- Governance
- Policy-backed (Attribution, Capacity) with confidence and provenance
- Scope
- Chapter Isolated
- Role
- Member
Inputs
| Name | Type | Required | Accepted values / notes |
|---|---|---|---|
eventId | String | Yes | Catalog-defined value |
metric | String | Yes | budget · pipeline · attendance · roi |
verbosity | String | No | summary · standard · detailed |
Question patterns
“Why did this event miss budget?”
“What caused the ROI variance?”
Do not
Do not treat scenario, planned, committed, and actual values as interchangeable or bypass governed provenance.
Related references
Glossary terms
- variance
- provenance
Related capabilities
- Event Provenance
bty://events/{eventId}/provenance - Event Changelog
bty://events/{eventId}/changelog
Machine references
Compare this human reference with the generated public catalog and the live, authenticated capability contract.