Brand Studio docs
Engineering manualSchema reference

Brand Evidence Pack

Declared schema: schemas/brand-evidence-pack.schema.json

Source: schemas/brand-evidence-pack.schema.json. This is the complete declaration, including nested definitions and constraints. Its presence is not evidence that a runtime producer or consumer validates against it.

All schemas · Data structures and lineage

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://brand-studio.local/schemas/brand-evidence-pack.schema.json",
  "title": "Brand Evidence Pack",
  "type": "object",
  "additionalProperties": true,
  "required": [
    "evidence_pack_id",
    "brand_slug",
    "created_at",
    "intake_mode",
    "evidence_status",
    "confidence_summary",
    "identity",
    "sources",
    "context_dev",
    "site_map",
    "scraped_pages",
    "screenshots",
    "visual_identity",
    "typography",
    "layout_and_components",
    "content_voice",
    "positioning",
    "proof_and_reputation",
    "seo_and_site_architecture",
    "social_and_external_voice",
    "claims",
    "items_to_confirm",
    "open_design_handoff"
  ],
  "properties": {
    "evidence_pack_id": {
      "type": "string",
      "minLength": 3
    },
    "brand_slug": {
      "type": "string",
      "minLength": 2
    },
    "domain": {
      "type": "string"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "intake_mode": {
      "enum": [
        "website",
        "no_website",
        "hybrid"
      ]
    },
    "evidence_status": {
      "enum": [
        "complete",
        "partial",
        "blocked",
        "needs_human_confirmation"
      ]
    },
    "confidence_summary": {
      "type": "object",
      "required": [
        "confirmed_count",
        "observed_count",
        "inferred_count",
        "estimated_count"
      ],
      "properties": {
        "confirmed_count": {
          "type": "integer",
          "minimum": 0
        },
        "observed_count": {
          "type": "integer",
          "minimum": 0
        },
        "inferred_count": {
          "type": "integer",
          "minimum": 0
        },
        "estimated_count": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "identity": {
      "type": "object",
      "required": [
        "brand_name",
        "source_confidence"
      ],
      "properties": {
        "brand_name": {
          "type": "string"
        },
        "domain": {
          "type": "string"
        },
        "canonical_url": {
          "type": "string"
        },
        "industry": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "slogan": {
          "type": "string"
        },
        "contact": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string"
            },
            "phone": {
              "type": "string"
            },
            "address": {
              "type": "string"
            }
          }
        },
        "source_confidence": {
          "$ref": "#/$defs/confidence"
        }
      }
    },
    "sources": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/source"
      }
    },
    "context_dev": {
      "type": "object",
      "required": [
        "used",
        "credit_usage"
      ],
      "properties": {
        "used": {
          "type": "boolean"
        },
        "credit_usage": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "site_map": {
      "type": "object",
      "required": [
        "status"
      ],
      "properties": {
        "status": {
          "enum": [
            "collected",
            "partial",
            "blocked",
            "not_applicable"
          ]
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "scraped_pages": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "screenshots": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "visual_identity": {
      "type": "object"
    },
    "typography": {
      "type": "object"
    },
    "layout_and_components": {
      "type": "object"
    },
    "content_voice": {
      "type": "object"
    },
    "positioning": {
      "type": "object"
    },
    "proof_and_reputation": {
      "type": "object"
    },
    "seo_and_site_architecture": {
      "type": "object"
    },
    "social_and_external_voice": {
      "type": "object"
    },
    "claims": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/claim"
      }
    },
    "items_to_confirm": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "open_design_handoff": {
      "type": "object",
      "required": [
        "handoff_id",
        "handoff_path"
      ],
      "properties": {
        "handoff_id": {
          "type": "string"
        },
        "handoff_path": {
          "type": "string"
        }
      }
    }
  },
  "$defs": {
    "confidence": {
      "enum": [
        "confirmed",
        "observed",
        "inferred",
        "estimated"
      ]
    },
    "source": {
      "type": "object",
      "required": [
        "source_id",
        "source_type",
        "confidence"
      ],
      "properties": {
        "source_id": {
          "type": "string"
        },
        "source_type": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "path": {
          "type": "string"
        },
        "confidence": {
          "$ref": "#/$defs/confidence"
        }
      }
    },
    "claim": {
      "type": "object",
      "required": [
        "claim_id",
        "claim",
        "source_ids",
        "confidence",
        "allowed_for_content",
        "requires_human_review"
      ],
      "properties": {
        "claim_id": {
          "type": "string"
        },
        "claim": {
          "type": "string"
        },
        "source_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1
        },
        "confidence": {
          "$ref": "#/$defs/confidence"
        },
        "allowed_for_content": {
          "type": "boolean"
        },
        "requires_human_review": {
          "type": "boolean"
        }
      }
    }
  }
}