skills/diligence/references/shared/framework.schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "diligence framework",
  "type": "object",
  "additionalProperties": false,
  "required": ["framework_version", "approved", "source_inputs", "lenses"],
  "properties": {
    "framework_version": {"type": "integer", "minimum": 1},
    "approved": {"type": "boolean"},
    "source_inputs": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["kind", "label"],
        "properties": {
          "kind": {"enum": ["checklist", "pleading", "chronology", "rfp", "rfa", "srog", "issues-list", "topics", "other"]},
          "label": {"type": "string", "minLength": 1}
        }
      }
    },
    "frame": {
      "type": "object",
      "additionalProperties": false,
      "required": ["kind", "frame_id", "purpose", "instruments"],
      "properties": {
        "kind": {
          "description": "v1 supports requests and issues; events and statements are staged for a later schema version",
          "enum": ["requests", "issues"]
        },
        "frame_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
        "corpus_id": {"type": "string", "pattern": "^[0-9a-f]{16}$"},
        "purpose": {"enum": ["receiving-audit", "producing-review"]},
        "instruments": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": ["instrument_id", "kind", "label", "party", "set", "element_count", "staged"],
            "properties": {
              "instrument_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
              "kind": {"enum": ["rfp", "rfa", "srog", "issues-list"]},
              "label": {"type": "string", "minLength": 1},
              "party": {"anyOf": [{"type": "string"}, {"type": "null"}]},
              "set": {"anyOf": [{"type": "string"}, {"type": "null"}]},
              "element_count": {"type": "integer", "minimum": 1},
              "staged": {"type": "boolean"}
            }
          }
        }
      }
    },
    "lenses": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["lens_id", "name", "items"],
        "properties": {
          "lens_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
          "name": {"type": "string", "minLength": 1},
          "items": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": ["issue_id", "question", "hit_rule", "exclusions", "materiality", "evidence", "answer_shape", "disposition", "overlap_owner"],
              "properties": {
                "issue_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
                "target_ref": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": ["instrument_id", "element"],
                  "properties": {
                    "instrument_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
                    "element": {"type": "integer", "minimum": 1},
                    "series": {"type": "string", "pattern": "^[A-Z]+$"}
                  }
                },
                "question": {"type": "string", "minLength": 1},
                "hit_rule": {"type": "string", "minLength": 1},
                "exclusions": {"type": "array", "items": {"type": "string", "minLength": 1}},
                "materiality": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": ["default", "bands"],
                  "properties": {
                    "default": {"enum": ["high", "medium", "low"]},
                    "bands": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": ["band", "when"],
                        "properties": {
                          "band": {"enum": ["high", "medium", "low"]},
                          "when": {"type": "string", "minLength": 1}
                        }
                      }
                    }
                  }
                },
                "evidence": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": ["required", "unresolved_when"],
                  "properties": {
                    "required": {"const": "verbatim quote plus section reference"},
                    "unresolved_when": {"type": "string", "minLength": 1}
                  }
                },
                "answer_shape": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": ["statuses", "characterization_max_words", "template"],
                  "properties": {
                    "statuses": {
                      "type": "array",
                      "items": {"enum": ["present", "absent", "unresolved"]},
                      "minItems": 3,
                      "maxItems": 3
                    },
                    "characterization_max_words": {"type": "integer", "minimum": 5, "maximum": 120},
                    "template": {"type": "string", "minLength": 1}
                  }
                },
                "disposition": {"enum": ["report", "register", "queue"]},
                "overlap_owner": {
                  "anyOf": [
                    {"type": "null"},
                    {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"}
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}