Brand Studio docs
Engineering manualSchema reference

Brand Studio Reference Manifest

Declared schema: schemas/reference-manifest.schema.json

Source: schemas/reference-manifest.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/reference-manifest.schema.json",
  "title": "Brand Studio Reference Manifest",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema_version",
    "reference_manifest_id",
    "brand_id",
    "reference_mode",
    "references",
    "review_status"
  ],
  "properties": {
    "schema_version": {
      "type": "string",
      "const": "brand-studio-reference-manifest/v1"
    },
    "reference_manifest_id": {
      "type": "string",
      "minLength": 1
    },
    "brand_id": {
      "type": "string",
      "minLength": 1
    },
    "campaign_id": {
      "type": "string"
    },
    "created_at": {
      "type": "string"
    },
    "reference_mode": {
      "type": "string",
      "enum": [
        "uploaded",
        "verbal_only",
        "agent_inferred",
        "mixed"
      ]
    },
    "bypass": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "allowed": {
          "type": "boolean"
        },
        "mode": {
          "type": "string",
          "enum": [
            "none",
            "verbal_only",
            "agent_decide"
          ]
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "references": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/reference_item"
      }
    },
    "review_status": {
      "type": "string",
      "enum": [
        "draft",
        "needs_review",
        "approved",
        "accepted_with_warnings",
        "rejected",
        "blocked"
      ]
    },
    "notes": {
      "type": "string"
    }
  },
  "$defs": {
    "reference_item": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "reference_id",
        "type",
        "category",
        "reference_intent",
        "path_or_url",
        "rights_status",
        "review_status"
      ],
      "properties": {
        "reference_id": {
          "type": "string",
          "minLength": 1
        },
        "type": {
          "type": "string",
          "enum": [
            "image",
            "url",
            "document",
            "note",
            "screenshot",
            "video",
            "audio"
          ]
        },
        "category": {
          "type": "string",
          "enum": [
            "logo",
            "logo_variation",
            "design_inspiration",
            "layout_inspiration",
            "style_inspiration",
            "asset_source",
            "screenshot",
            "source_document",
            "do_not_use"
          ]
        },
        "reference_intent": {
          "type": "string",
          "enum": [
            "structure",
            "style",
            "both",
            "asset_source",
            "do_not_use"
          ]
        },
        "path_or_url": {
          "type": "string",
          "minLength": 1
        },
        "title": {
          "type": "string"
        },
        "usage_notes": {
          "type": "string"
        },
        "source_id": {
          "type": "string"
        },
        "rights_status": {
          "type": "string",
          "enum": [
            "user_provided",
            "observed_candidate",
            "generated_candidate",
            "approved",
            "unknown"
          ]
        },
        "allowed_uses": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "blocked_uses": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "review_status": {
          "type": "string",
          "enum": [
            "draft",
            "needs_review",
            "approved",
            "accepted_with_warnings",
            "rejected",
            "blocked"
          ]
        }
      }
    }
  }
}