Calculate True ROIcalculate_true_roi
Calculate fully-loaded True ROI for a single event or the entire portfolio. Returns ROI value, cost breakdown, pipeline attribution, and confidence scoring.
Answer
When to use Calculate True ROI
Use for governed event or portfolio ROI, fully-loaded cost, and cost-per-pipeline-dollar questions.
Governed tool contract
- Job
- Justify spend
- Output type
- Deterministic
- 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 | No | Catalog-defined value |
period | String | No | Q1 · Q2 · Q3 · Q4 · year |
year | Number | No | Catalog-defined value |
includeCapacityCost | Boolean | No | Catalog-defined value |
verbosity | String | No | summary · standard · detailed |
Question patterns
“What was the True ROI of this event?”
“Which events justified their spend?”
Do not
Do not treat scenario, planned, committed, and actual values as interchangeable or bypass governed provenance.
Related references
Glossary terms
- True ROI
- fully-loaded cost
- pipeline influenced
Related capabilities
- Portfolio ROI
bty://portfolio/roi - Generate CFO Report
generate_cfo_report
Machine references
Compare this human reference with the generated public catalog and the live, authenticated capability contract.