An official website of the Disclosure Foundation

Introduction

Overview

Modules

The Manifest DocumentCalibration

Guides

Publishing a Manifest

Calibration

The calibration maturity gradient, honest nulls, and the scoring feedback loop

Most datasets reduce calibration to a boolean. The manifest replaces it with a maturity gradient that separates what an operator actually does today from the traceable reference it has identified:

StatusMeaning
noneNo calibration is performed. Declared honestly, this is itself useful information.
candidate_identifiedA traceable reference has been named but is not yet part of practice.
in_practiceA real calibration method is performed today, but no full uncertainty budget exists.
documentedThe calibration method and its uncertainty budget are published.

Alongside status, an entry can carry currentMethod (what is actually done), traceableReference and referenceInUse (the reference and whether it is practice or aspiration), cadence, uncertaintyBudget, and notes. All nullable — honest nulls are first-class, so calibration gaps stay visible and comparable across operators.

The scoring feedback loop

@disclosureos/scoring exposes the gradient as a trust input. calibrationTrust builds an evaluatorWeight policy that credits claims whose sensor evidence resolves — through SensorReading.sensorRef — to a manifest entry with real calibration provenance:

import { score, calibrationTrust, CALIBRATION_TRUST_WEIGHTS } from '@disclosureos/scoring';

const result = score(observation, {
  evaluatorWeight: calibrationTrust(observation, [manifest]),
});

CALIBRATION_TRUST_WEIGHTS;
// { unresolved: 1, none: 1, candidate_identified: 1.05, in_practice: 1.15, documented: 1.25 }

The default is deliberately conservative:

  • Nothing weighs below the baseline. Sensors with no manifest entry (and manifests that declare none) keep the 1.0 baseline. Publishing provenance can only add weight.
  • Only the consensus point shifts. Like every evaluatorWeight policy, the range and contested flag still report the honest spread of what evaluators actually asserted.
  • The gradient is overridable per call, and composes multiplicatively with any base evaluator-trust policy.

The Manifest Document

SensorManifest and SensorEntry — the anatomy of a published sensor catalog

Publishing a Manifest

Author, validate, and register your organization's sensor manifest

On this page

The scoring feedback loop