Skip to content

Candidate evaluation

Read mandatory outcomes, score completeness, KPI evidence, categories and limiting caps separately.

Contract version: 1.0.0. Download the full JSON schema.

Use the tables for exact field names, types and constraints. Wide tables scroll horizontally. How to read defaults, units and result states.

For interpretation and examples, read spacecraft evaluation.

Fields

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
caps array of Applied Score Cap No [] —
categories array of Category Score No [] maxItems: 4
comparison_context_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
desirabilities array of Kpi Desirability No [] maxItems: 20
limitations array of string No [] —
mandatory array of Mandatory Assessment Yes Not specified minItems: 1
mandatory_status Assessment Status Yes Not specified —
normalized_category_weights array of Category Policy No [] —
objective_exclusion_reasons array of string No [] —
objective_values array of Objective Value No [] —
observations array of Kpi Observation Yes Not specified maxItems: 20
overall_score number or null No null anyOf branch 1: minimum: 0
maximum: 100
policy Evaluation Policy Reference Yes Not specified —
schema_kind string No "candidate_evaluation" const: "candidate_evaluation"
schema_version string No "1.0.0" const: "1.0.0"
score_state string Yes Not specified enum: ["complete", "incomplete", "ineligible"]
source Evaluation Source Yes Not specified —
uncapped_score number or null No null anyOf branch 1: minimum: 0
maximum: 100

Nested definitions

Open a definition below, or follow a type link in a field table. Direct links open the relevant section automatically.

Applied Score Cap

Applied Score Cap

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
category string Yes Not specified enum: ["mission", "resource", "architecture", "programmatic"]
category_score number Yes Not specified minimum: 0
maximum: 100
maximum_overall number Yes Not specified minimum: 0
maximum: 100
threshold number Yes Not specified minimum: 0
maximum: 100
Artifact Reference

Artifact Reference

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
artifact_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
media_type string Yes Not specified minLength: 3
maxLength: 128
relative_path string Yes Not specified minLength: 1
maxLength: 512
sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
size_bytes integer Yes Not specified minimum: 0
Assessment Status

Assessment Status

enum: ["pass", "warn", "fail", "not_assessed"]

Category Policy

Category Policy

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
category string Yes Not specified enum: ["mission", "resource", "architecture", "programmatic"]
weight number Yes Not specified exclusiveMinimum: 0
Category Score

Category Score

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
category string Yes Not specified enum: ["mission", "resource", "architecture", "programmatic"]
contributions array of Score Contribution No [] —
missing_kpi_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
omitted_kpi_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
score number or null No null anyOf branch 1: minimum: 0
maximum: 100
state string Yes Not specified enum: ["complete", "incomplete", "inapplicable"]
Evaluation Evidence

Evaluation Evidence

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
applicability Model Applicability Status or null No null —
authority_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
confidence Evidence Confidence No "unknown" —
evidence_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
knowledge_state Knowledge State No "unknown" —
limitation_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
reason string Yes Not specified minLength: 1
maxLength: 2000
source_tiers array of Evidence Tier No [] —
sources array of Evaluation Source Reference No [] —
state string Yes Not specified enum: ["present", "missing", "inapplicable", "deferred"]
unit string Yes Not specified enum: ["ratio", "1", "K", "deg", "m/s", "s", "W", "Wh", "W/kg", "W/m3", "W/m2", "kg", "m3", "m2", "dB", "bit/day", "bit", "USD", "EUR", "GBP", "count", "composite", "inventory", "score_points", "text", "bool", "V", "A", "m", "N", "degC", "km", "year", "deg/s", "rpm", "N*m", "N*m*s", "A*m2", "bit/s", "USD_2025", "arcsec", "enum", "m/s2"]
value number or boolean or string or null No null —
Evaluation Policy Reference

Evaluation Policy Reference

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
policy_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
version string No "1.0.0" const: "1.0.0"
Evaluation Source

Evaluation Source

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
artifact_index_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
candidate_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
contract_version string No "1.0.0" const: "1.0.0"
input_snapshot_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
manifest_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
result_index_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
run_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
Evaluation Source Reference

Evaluation Source Reference

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
artifact Artifact Reference Yes Not specified —
component_id string or null No null anyOf branch 1: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
mode_id string or null No null anyOf branch 1: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
pointer string No "" maxLength: 1024
pattern: "^(?:/(?:[^~]|~[01])*)*$"
result_id string or null No null anyOf branch 1: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
scenario_id string or null No null anyOf branch 1: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
Evidence Confidence

Evidence Confidence

enum: ["authoritative", "supplier_based", "verified", "estimated", "assumed", "unknown"]

Evidence Tier

Evidence Tier

enum: ["verified", "credible", "engineering_estimate", "policy_default", "unknown"]

Knowledge State

Knowledge State

enum: ["known", "estimated", "defaulted", "unknown"]

Kpi Desirability

Kpi Desirability

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
category string Yes Not specified enum: ["mission", "resource", "architecture", "programmatic"]
controlling_component_ids array of string Yes Not specified minItems: 1
items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
kpi_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
score number Yes Not specified minimum: 0
maximum: 100
Kpi Observation

Kpi Observation

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
category string Yes Not specified enum: ["mission", "resource", "architecture", "programmatic"]
components array of Evaluation Evidence No [] —
kpi_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
reason string Yes Not specified minLength: 1
maxLength: 2000
role string Yes Not specified enum: ["scored", "advisory", "deferred"]
state string Yes Not specified enum: ["present", "missing", "inapplicable", "deferred"]
unit string Yes Not specified enum: ["ratio", "1", "K", "deg", "m/s", "s", "W", "Wh", "W/kg", "W/m3", "W/m2", "kg", "m3", "m2", "dB", "bit/day", "bit", "USD", "EUR", "GBP", "count", "composite", "inventory", "score_points", "text", "bool", "V", "A", "m", "N", "degC", "km", "year", "deg/s", "rpm", "N*m", "N*m*s", "A*m2", "bit/s", "USD_2025", "arcsec", "enum", "m/s2"]
value number or null No null —
Mandatory Assessment

Mandatory Assessment

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
check_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
rationale string Yes Not specified minLength: 1
maxLength: 2000
reason_code string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
sources array of Evaluation Source Reference No [] —
statement_id string or null No null anyOf branch 1: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
status Assessment Status Yes Not specified —
Model Applicability Status

Model Applicability Status

enum: ["applicable", "degraded", "unsupported"]

Objective Value

Objective Value

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
direction string Yes Not specified enum: ["maximize", "minimize"]
objective_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
sources array of Evaluation Source Reference No [] —
statement_id string or null No null anyOf branch 1: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
unit string Yes Not specified enum: ["ratio", "1", "K", "deg", "m/s", "s", "W", "Wh", "W/kg", "W/m3", "W/m2", "kg", "m3", "m2", "dB", "bit/day", "bit", "USD", "EUR", "GBP", "count", "composite", "inventory", "score_points", "text", "bool", "V", "A", "m", "N", "degC", "km", "year", "deg/s", "rpm", "N*m", "N*m*s", "A*m2", "bit/s", "USD_2025", "arcsec", "enum", "m/s2"]
value number Yes Not specified —
Score Contribution

Score Contribution

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
kpi_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
normalized_weight number Yes Not specified maximum: 1
exclusiveMinimum: 0
points number Yes Not specified minimum: 0
maximum: 100
score number Yes Not specified minimum: 0
maximum: 100

Schema integrity

Schema SHA-256: a0bc2601da34647abab8c81cb5563649c1c67143a5a87eae7c159f5e1bf753cc.

Return to the reference guide.