decision-workspace.vercel.app

{
  "type": "object",
  "properties": {
    "question": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "prompt": {
          "type": "string"
        },
        "rationale": {
          "type": "string"
        },
        "selectionReason": {
          "type": "string",
          "description": "Mandatory justification explaining why this question is the highest-value step now"
        },
        "answerType": {
          "type": "string",
          "enum": [
            "text",
            "single_choice",
            "multi_choice",
            "number",
            "currency",
            "date",
            "scale",
            "boolean"
          ]
        },
        "mappingPolicy": {
          "type": "string",
          "enum": [
            "deterministic",
            "agent_required",
            "evidence_only"
          ],
          "description": "How answers map to criteria, constraints, or evidence"
        },
        "choices": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "value": {
                "description": "Underlying value for this choice"
              },
              "description": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "label",
              "value"
            ]
          }
        },
        "allowOther": {
          "type": "boolean",
          "description": "Allow user free-text / something else answer"
        },
        "otherLabel": {
          "type": "string"
        },
        "min": {
          "type": "number"
        },
        "max": {
          "type": "number"
        },
        "step": {
          "type": "number"
        },
        "unit": {
          "type": "string"
        },
        "affects": {
          "type": "object",
          "properties": {
            "criterionIds": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "optionIds": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "constraintIds": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "uncertaintyIds": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "assessmentKeys": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "mappingRules": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "targetType": {
                "type": "string",
                "enum": [
                  "constraint",
                  "criterion_weight",
                  "option_score",
                  "evidence"
                ]
              },
              "targetId": {
                "type": "string"
              },
              "subTargetId": {
                "type": "string"
              },
              "transform": {
                "type": "string",
                "enum": [
                  "direct",
                  "scale_10",
                  "boolean_match"
                ]
              },
              "valueMap": {
                "type": "object"
              }
            },
            "required": [
              "targetType",
              "targetId"
            ]
          }
        },
        "requiredFor": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "review",
              "recommend"
            ]
          }
        }
      },
      "required": [
        "id",
        "prompt",
        "rationale",
        "selectionReason",
        "mappingPolicy"
      ]
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 1,
      "description": "Expected current revision for optimistic concurrency control"
    }
  },
  "required": [
    "question",
    "expectedRevision"
  ],
  "additionalProperties": true
}