Subchapter 25.82
references/vendored/estimate/pricing-mode.mdMarkdown3 KBView on GitHub
Canonical pricing-mode procedure for estimate cost engines, vendored into each skill (
references/vendored/estimate/pricing-mode.md) and kept byte-identical by hand — copy this file over every vendored copy in the same change (see ). The enum bug happened because two copies of this logic evolved separately — do not fork this text again. Skill cost engines execute this file AS their Step 0, then own everything after it (baseline rungs, service formulas, tiers).
references/vendored/README.mdcached_staleRead references/vendored/pricing/aws-infra-pricing.json. Check
_meta.last_updated against _meta.staleness_days (default 30):
pricing_source: "cached".pricing_source: "cached_stale". A cache-miss now goes
straight to estimated (if the engine states the formula rate) or
unavailable — never to a live lookup.Each service object carries its rates and (where relevant) a
multi_az_handling key. Look rates up from the file — never hardcode them.
Before any calculation, surface the status:
pricing_source: unavailable in the estimate.”| Priority | Source | Condition | pricing_source value |
|---|---|---|---|
| 1 | references/vendored/pricing/aws-infra-pricing.json | Service found in the pricing file | "cached" |
| 2 | Formula constants / well-known published rate | NOT in file, but the cost engine’s own formulas carry the rate (state it verbatim) | "estimated" |
| 3 | Unavailable | NOT in file, no formula constant | "unavailable" |
Row 2 is the documented home of the services_by_source.estimated bucket the
shared schema and assemblers carry: a service priced from a rate the cost
engine itself states (never a guessed or remembered number) is "estimated",
always accompanied by a warning naming the rate and its source. Only a service
with no cache entry AND no stated formula rate is "unavailable" and
excluded from totals.