Finding

Finding used by this schema object.

$defs.finding · object

Definition JSON

This fragment is shown exactly as published. Use the chevrons to fold objects and arrays; linked $ref values return to their targets in the complete schema.

{    "type": "object",
    "additionalProperties": false,
    "required": [        "id",
        "requirement_resolution_ref",
        "subject_refs",
        "status",
        "severity",
        "evaluation_mode",
        "explanation"    ],
    "properties": {        "id": {            "$ref": "https://matjson.org/schema/core/0.1/schema.json#/$defs/local_id"        },
        "requirement_resolution_ref": {            "$ref": "https://matjson.org/schema/core/0.1/schema.json#/$defs/local_id"        },
        "subject_refs": {            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "items": {                "$ref": "https://matjson.org/schema/core/0.1/schema.json#/$defs/local_id"            }        },
        "status": {            "enum": [                "pass",
                "fail",
                "not_applicable",
                "missing_evidence",
                "missing_project_input",
                "requisition_gap",
                "ambiguous_material_selector",
                "conflicting_requirements",
                "manual_review_required",
                "external_evidence_required",
                "unsupported_evaluation",
                "not_evaluated"            ]        },
        "severity": {            "enum": [                "error",
                "warning",
                "information"            ]        },
        "evaluation_mode": {            "enum": [                "direct",
                "computed",
                "record_review",
                "cross_document",
                "inspection_record",
                "manual_review"            ]        },
        "observed_values": {            "type": "array",
            "items": {                "$ref": "#/$defs/observed_value"            }        },
        "comparison": {            "$ref": "#/$defs/comparison"        },
        "calculation_ref": {            "$ref": "https://matjson.org/schema/core/0.1/schema.json#/$defs/local_id"        },
        "evidence_refs": {            "type": "array",
            "items": {                "$ref": "https://matjson.org/schema/core/0.1/schema.json#/$defs/record_object_ref"            }        },
        "confidence": {            "type": "number",
            "minimum": 0,
            "maximum": 1        },
        "evaluated_at": {            "type": "string",
            "format": "date-time"        },
        "evaluator": {            "$ref": "https://matjson.org/schema/core/0.1/schema.json#/$defs/actor"        },
        "explanation": {            "type": "string",
            "minLength": 1        },
        "notes": {            "type": "array",
            "items": {                "type": "string"            }        }    }}

Fields

FieldTypeStatusMeaning
idLocal idRequiredStable identifier for this object within its containing MatJSON document.
requirement_resolution_refLocal idRequiredRequirement resolution ref used by this schema object.
subject_refsarray — at least 1 item(s)RequiredSubject refs used by this schema object.
statusenum — "pass", "fail", "not_applicable", "missing_evidence", "missing_project_input", "requisition_gap", …RequiredStatus used by this schema object.
severityenum — "error", "warning", "information"RequiredSeverity used by this schema object.
evaluation_modeenum — "direct", "computed", "record_review", "cross_document", "inspection_record", "manual_review"RequiredEvaluation mode used by this schema object.
observed_valuesarrayOptionalObserved values used by this schema object.
comparisonComparisonOptionalComparison used by this schema object.
calculation_refLocal idOptionalCalculation ref used by this schema object.
evidence_refsarrayOptionalEvidence refs used by this schema object.
confidencenumber — minimum 0 · maximum 1OptionalConfidence used by this schema object.
evaluated_atstringOptionalEvaluated at used by this schema object.
evaluatorActorOptionalEvaluator used by this schema object.
explanationstringRequiredExplanation used by this schema object.
notesarrayOptionalAdditional explanatory notes that do not replace the structured requirement.