{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.connectsoft.ai/reference/schemas/blueprint-vision.schema.json",
  "title": "Vision Blueprint (blueprint-vision-v1)",
  "description": "Descriptor document of the Vision Blueprint kind (BC-02). Validated by BlueprintService; metadata per blueprint-common.schema.json; generation outputs and validation rules per model/blueprints.yaml.",
  "type": "object",
  "required": [
    "metadata",
    "problem",
    "opportunity",
    "proposedSolution",
    "softwareType",
    "features",
    "personas",
    "successMetrics"
  ],
  "additionalProperties": false,
  "properties": {
    "metadata": {
      "$ref": "blueprint-common.schema.json#/$defs/Metadata"
    },
    "problem": {
      "type": "object",
      "required": [
        "statement"
      ],
      "properties": {
        "statement": {
          "type": "string"
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "affected": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false
    },
    "opportunity": {
      "type": "object",
      "required": [
        "statement"
      ],
      "properties": {
        "statement": {
          "type": "string"
        },
        "marketContext": {
          "type": "string"
        },
        "differentiation": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false
    },
    "proposedSolution": {
      "type": "object",
      "required": [
        "statement",
        "capabilities"
      ],
      "properties": {
        "statement": {
          "type": "string"
        },
        "capabilities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "nonGoals": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false
    },
    "softwareType": {
      "enum": [
        "SaaS",
        "InternalPlatform",
        "Library",
        "MobileApp",
        "Integration",
        "AgentService"
      ]
    },
    "features": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "scope"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "scope": {
            "enum": [
              "mvp",
              "stretch",
              "non-goal"
            ]
          },
          "description": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "personas": {
      "type": "array",
      "items": {
        "$ref": "blueprint-common.schema.json#/$defs/Persona"
      }
    },
    "successMetrics": {
      "type": "array",
      "items": {
        "$ref": "blueprint-common.schema.json#/$defs/Metric"
      }
    },
    "constraints": {
      "type": "object",
      "required": [],
      "properties": {
        "residency": {
          "type": "string"
        },
        "compliance": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "budget": {
          "type": "string"
        },
        "timeline": {
          "type": "string"
        },
        "technical": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false
    }
  }
}