Function record_observation 

pub fn record_observation(
    state: &Path,
    command_hash: &str,
    environment_hash: &str,
    revisions: &Revisions,
    report: &DifferentialReport,
) -> Result<RecordedObservation, String>

Appends a report and rebuilds the advisory receipt.

environment_hash is the environment_hash of the effective_environment the report’s three runs actually executed in. The first observation pins it in activation.json; later observations must match it or are refused, exactly as a changed command snapshot is.

Errors

A revision is not a canonical full Git object id, state cannot be created, belongs to another command or another environment, contains an invalid row, or cannot be durably updated.