Skip to content
CoGov Assessment Report (JSON Schema) (GAR)
Governance Assessment Report JSON Schema (GAR)
{
"title": "governance-assessment-report",
"type": "object",
"additionalProperties": false,
"required": [
"spec",
"assessment",
"scores",
"total_score",
"readiness_band",
"risk_flags",
"evidence",
"recommendations"
],
"properties": {
"spec": {
"type": "object",
"additionalProperties": false,
"required": ["name", "version", "created_at"],
"properties": {
"name": { "const": "governance-assessment-report" },
"version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
"created_at": { "type": "string", "format": "date-time" },
"notes": { "type": "string" }
}
},
"assessment": {
"type": "object",
"additionalProperties": false,
"required": ["assessment_id", "instance_id", "config_spec", "config_version", "timestamp", "inputs"],
"properties": {
"assessment_id": { "type": "string", "minLength": 6 },
"instance_id": { "type": "string", "minLength": 6 },
"config_spec": { "type": "string", "const": "holonic-governance-config" },
"config_version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
"timestamp": { "type": "string", "format": "date-time" },
"inputs": {
"type": "object",
"additionalProperties": false,
"required": ["config", "artifacts", "telemetry"],
"properties": {
"config": {
"type": "object",
"additionalProperties": false,
"required": ["present", "hash"],
"properties": {
"present": { "type": "boolean" },
"hash": { "type": "string", "minLength": 8 },
"uri": { "type": "string" }
}
},
"artifacts": {
"type": "array",
"items": { "$ref": "#/$defs/evidenceRef" }
},
"telemetry": {
"type": "array",
"items": { "$ref": "#/$defs/evidenceRef" }
}
}
},
"rubric": {
"type": "object",
"additionalProperties": false,
"properties": {
"rubric_id": { "type": "string" },
"rubric_version": { "type": "string" },
"scoring_mode": { "type": "string", "enum": ["rule_scored", "hybrid", "ai_assist_rule_scored"] }
}
}
}
},
"scores": {
"type": "object",
"additionalProperties": false,
"required": ["domains", "optional_domains"],
"properties": {
"domains": {
"type": "array",
"minItems": 1,
"items": { "$ref": "#/$defs/domainScore" }
},
"optional_domains": {
"type": "array",
"items": { "$ref": "#/$defs/domainScore" }
}
}
},
"total_score": {
"type": "object",
"additionalProperties": false,
"required": ["earned", "possible", "possible_excluding_optional"],
"properties": {
"earned": { "type": "integer", "minimum": 0 },
"possible": { "type": "integer", "minimum": 0 },
"possible_excluding_optional": { "type": "integer", "minimum": 0 }
}
},
"readiness_band": {
"type": "string",
"enum": ["pre-formation", "emergent", "operational", "institutionalized"]
},
"risk_flags": {
"type": "array",
"items": { "$ref": "#/$defs/riskFlag" }
},
"evidence": {
"type": "array",
"items": { "$ref": "#/$defs/evidenceItem" }
},
"recommendations": {
"type": "array",
"items": { "$ref": "#/$defs/recommendation" }
},
"patch_suggestions": {
"type": "array",
"description": "Optional JSON Patch operations to improve the config deterministically.",
"items": { "$ref": "#/$defs/jsonPatchOp" }
},
"signoff": {
"type": "object",
"additionalProperties": false,
"properties": {
"generated_by": { "type": "string" },
"generator_version": { "type": "string" },
"validated": { "type": "boolean" },
"validation_errors": { "type": "array", "items": { "type": "string" } }
}
}
},
"$defs": {
"domainScore": {
"type": "object",
"additionalProperties": false,
"required": ["domain_id", "label", "score", "max", "status", "rule_basis", "evidence_refs"],
"properties": {
"domain_id": {
"type": "string",
"enum": [
"purpose_intent",
"constitutional_foundation",
"governance_roles",
"decision_systems",
"treasury_capital",
"accountability_ledger",
"network_graph_ontology",
"participation_boundaries",
"conflict_resolution",
"adaptation_evolution",
"incentive_alignment"
]
},
"label": { "type": "string" },
"score": { "type": "integer", "minimum": 0, "maximum": 4 },
"max": { "type": "integer", "const": 4 },
"status": { "type": "string", "enum": ["absent", "informal", "defined_incomplete", "operational", "institutionalized"] },
"rule_basis": {
"type": "object",
"additionalProperties": false,
"required": ["rule_set", "rule_version"],
"properties": {
"rule_set": { "type": "string" },
"rule_version": { "type": "string" },
"computed_from": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": ["type", "ref"],
"properties": {
"type": { "type": "string", "enum": ["config_path", "artifact", "telemetry"] },
"ref": { "type": "string" }
}
}
}
}
},
"gaps": { "type": "array", "items": { "type": "string" } },
"strengths": { "type": "array", "items": { "type": "string" } },
"evidence_refs": { "type": "array", "items": { "type": "string" } }
}
},
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ··· in the right corner or using a keyboard shortcut (
CtrlP
) instead.