GCMD_Keyword_Classifier_MVP / schemas /classification_result.schema.json
igerasimov's picture
MVP Milestone 4
0539596
Raw
History Blame Contribute Delete
22.4 kB
{
"$defs": {
"ArticleClassificationOutcome": {
"description": "Semantic article-level outcome when processing completes.",
"enum": [
"classified",
"pending_review",
"not_classified"
],
"title": "ArticleClassificationOutcome",
"type": "string"
},
"ArticleProcessingStatus": {
"description": "Workflow execution state for one article.",
"enum": [
"completed",
"partial",
"failed",
"skipped"
],
"title": "ArticleProcessingStatus",
"type": "string"
},
"ClassificationFinalStatus": {
"description": "Final automated status for one classification candidate.",
"enum": [
"accepted",
"reduced_to_ancestor",
"review_required",
"rejected"
],
"title": "ClassificationFinalStatus",
"type": "string"
},
"ClassificationRecord": {
"additionalProperties": false,
"description": "Article output record for one GCMD classification or retained diagnostic candidate.",
"properties": {
"UUID": {
"minLength": 1,
"title": "Uuid",
"type": "string"
},
"branch_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Branch Id"
},
"canonical_path": {
"minLength": 1,
"title": "Canonical Path",
"type": "string"
},
"classifier_evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Classifier Evidence"
},
"confidence": {
"anyOf": [
{
"$ref": "#/$defs/ConfidenceMetadata"
},
{
"type": "null"
}
],
"default": null
},
"deterministic_validation": {
"$ref": "#/$defs/DeterministicValidationResult"
},
"errors": {
"items": {
"$ref": "#/$defs/OutputError"
},
"title": "Errors",
"type": "array"
},
"final_status": {
"$ref": "#/$defs/ClassificationFinalStatus"
},
"level": {
"enum": [
"Topic",
"Term",
"Variable_Level_1",
"Variable_Level_2",
"Variable_Level_3"
],
"title": "Level",
"type": "string"
},
"name": {
"minLength": 1,
"title": "Name",
"type": "string"
},
"original_candidate": {
"anyOf": [
{
"$ref": "#/$defs/OriginalCandidateReference"
},
{
"type": "null"
}
],
"default": null
},
"parent_uuid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Uuid"
},
"path_components": {
"items": {
"type": "string"
},
"minItems": 1,
"title": "Path Components",
"type": "array"
},
"reason_for_stopping": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Reason For Stopping"
},
"review_required": {
"default": false,
"title": "Review Required",
"type": "boolean"
},
"review_status": {
"anyOf": [
{
"$ref": "#/$defs/ReviewStatus"
},
{
"type": "null"
}
],
"default": null
},
"semantic_validation": {
"anyOf": [
{
"$ref": "#/$defs/SemanticValidationResult"
},
{
"type": "null"
}
],
"default": null
},
"support_type": {
"anyOf": [
{
"$ref": "#/$defs/SupportType"
},
{
"type": "null"
}
],
"default": null
},
"term": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Term"
},
"topic": {
"minLength": 1,
"title": "Topic",
"type": "string"
},
"warnings": {
"items": {
"$ref": "#/$defs/OutputWarning"
},
"title": "Warnings",
"type": "array"
}
},
"required": [
"UUID",
"name",
"level",
"canonical_path",
"path_components",
"topic",
"deterministic_validation",
"final_status"
],
"title": "ClassificationRecord",
"type": "object"
},
"ConfidenceMetadata": {
"additionalProperties": false,
"description": "Optional, uncalibrated confidence signals from routing stages.",
"properties": {
"final": {
"anyOf": [
{
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Final"
},
"term": {
"anyOf": [
{
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Term"
},
"topic": {
"anyOf": [
{
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Topic"
},
"variable_level_1": {
"anyOf": [
{
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Variable Level 1"
},
"variable_level_2": {
"anyOf": [
{
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Variable Level 2"
},
"variable_level_3": {
"anyOf": [
{
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Variable Level 3"
}
},
"title": "ConfidenceMetadata",
"type": "object"
},
"DeterministicValidationResult": {
"additionalProperties": false,
"description": "Vocabulary validation result for a proposed final classification.",
"properties": {
"errors": {
"items": {
"$ref": "#/$defs/OutputError"
},
"title": "Errors",
"type": "array"
},
"valid": {
"title": "Valid",
"type": "boolean"
},
"warnings": {
"items": {
"$ref": "#/$defs/OutputWarning"
},
"title": "Warnings",
"type": "array"
}
},
"required": [
"valid"
],
"title": "DeterministicValidationResult",
"type": "object"
},
"OriginalCandidateReference": {
"additionalProperties": false,
"description": "Reference to an earlier candidate retained for reductions or diagnostics.",
"properties": {
"UUID": {
"minLength": 1,
"title": "Uuid",
"type": "string"
},
"canonical_path": {
"minLength": 1,
"title": "Canonical Path",
"type": "string"
},
"level": {
"anyOf": [
{
"enum": [
"Topic",
"Term",
"Variable_Level_1",
"Variable_Level_2",
"Variable_Level_3"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"path_components": {
"items": {
"type": "string"
},
"title": "Path Components",
"type": "array"
}
},
"required": [
"UUID",
"canonical_path"
],
"title": "OriginalCandidateReference",
"type": "object"
},
"OutputError": {
"additionalProperties": false,
"description": "Structured failure associated with an article or classification.",
"properties": {
"DOI": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Doi"
},
"code": {
"minLength": 1,
"title": "Code",
"type": "string"
},
"details": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Details"
},
"index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Index"
},
"message": {
"minLength": 1,
"title": "Message",
"type": "string"
},
"retry_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Retry Count"
},
"stage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Stage"
}
},
"required": [
"code",
"message"
],
"title": "OutputError",
"type": "object"
},
"OutputWarning": {
"additionalProperties": false,
"description": "Non-fatal warning associated with an article or classification.",
"properties": {
"DOI": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Doi"
},
"code": {
"minLength": 1,
"title": "Code",
"type": "string"
},
"details": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Details"
},
"index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Index"
},
"message": {
"minLength": 1,
"title": "Message",
"type": "string"
},
"stage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Stage"
}
},
"required": [
"code",
"message"
],
"title": "OutputWarning",
"type": "object"
},
"ProcessingMetadata": {
"additionalProperties": false,
"description": "Reproducibility and runtime metadata for an article result.",
"properties": {
"abstract_available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Abstract Available"
},
"application_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Application Version"
},
"article_fingerprint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Article Fingerprint"
},
"cache_used": {
"default": false,
"title": "Cache Used",
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Completed At"
},
"configuration_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Configuration Hash"
},
"estimated_cost": {
"anyOf": [
{
"minimum": 0.0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Estimated Cost"
},
"input_tokens": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Input Tokens"
},
"model_calls": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Model Calls"
},
"model_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Model Name"
},
"model_parameters": {
"additionalProperties": true,
"title": "Model Parameters",
"type": "object"
},
"model_provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Model Provider"
},
"output_tokens": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Output Tokens"
},
"processed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Processed At"
},
"processing_time_seconds": {
"anyOf": [
{
"minimum": 0.0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Processing Time Seconds"
},
"prompt_versions": {
"additionalProperties": {
"type": "string"
},
"title": "Prompt Versions",
"type": "object"
},
"run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Run Id"
},
"started_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Started At"
},
"title_available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Title Available"
},
"vocabulary_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Vocabulary Hash"
},
"vocabulary_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Vocabulary Version"
}
},
"title": "ProcessingMetadata",
"type": "object"
},
"ReviewStatus": {
"description": "Human-review workflow state.",
"enum": [
"not_required",
"pending",
"completed"
],
"title": "ReviewStatus",
"type": "string"
},
"SemanticValidationResult": {
"additionalProperties": false,
"description": "Draft semantic-validation result shape for future pipeline stages.",
"properties": {
"decision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Decision"
},
"deepest_supported_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Deepest Supported Path"
},
"deepest_supported_uuid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Deepest Supported Uuid"
},
"errors": {
"items": {
"$ref": "#/$defs/OutputError"
},
"title": "Errors",
"type": "array"
},
"evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Evidence"
},
"support_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Support Level"
},
"unsupported_components": {
"items": {
"type": "string"
},
"title": "Unsupported Components",
"type": "array"
}
},
"title": "SemanticValidationResult",
"type": "object"
},
"SupportType": {
"description": "Uncalibrated model support category for a candidate selection.",
"enum": [
"explicit",
"inferred",
"mixed"
],
"title": "SupportType",
"type": "string"
}
},
"additionalProperties": false,
"description": "Structured output for one article, preserving source fields exactly.",
"properties": {
"Abstract": {
"title": "Abstract",
"type": "string"
},
"DOI": {
"title": "Doi",
"type": "string"
},
"Title": {
"title": "Title",
"type": "string"
},
"Year": {
"title": "Year",
"type": "integer"
},
"classification_outcome": {
"anyOf": [
{
"$ref": "#/$defs/ArticleClassificationOutcome"
},
{
"type": "null"
}
],
"default": null
},
"classifications": {
"items": {
"$ref": "#/$defs/ClassificationRecord"
},
"title": "Classifications",
"type": "array"
},
"errors": {
"items": {
"$ref": "#/$defs/OutputError"
},
"title": "Errors",
"type": "array"
},
"no_classification_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "No Classification Reason"
},
"processing_metadata": {
"$ref": "#/$defs/ProcessingMetadata"
},
"processing_status": {
"$ref": "#/$defs/ArticleProcessingStatus"
},
"review_status": {
"$ref": "#/$defs/ReviewStatus",
"default": "not_required"
},
"warnings": {
"items": {
"$ref": "#/$defs/OutputWarning"
},
"title": "Warnings",
"type": "array"
}
},
"required": [
"DOI",
"Title",
"Year",
"Abstract",
"processing_status"
],
"title": "ArticleResult",
"type": "object"
}