Skip to main content

HOST_API_VERSION

Constant HOST_API_VERSION 

Source
pub const HOST_API_VERSION: u32 = 1;
Expand description

The version of the ctx surface this build exposes.

Bump this whenever ctx gains, loses or changes a function. It is a cache-key input, and it has to be: a result computed by a build where ctx.readFile did not exist is not a valid result for a build where it does — the rule could not have called something that was not there, so its cached verdict was reached without evidence it would have used.

Nothing detects this automatically. A function added without bumping it serves stale results silently, which is the failure mode the whole cache design is arranged against.

History:

  • 1 — reporting, navigation, binding resolution, emitFact, readFile, fileExists.