{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "taste-board-vocabulary",
  "description": "CE Brand Pipeline — controlled vocabularies for taste board tagging and visual-style.json shot_library references. This file is the shared vocabulary layer. Changes here require migration of all tagged records using the old values.",
  "version": "1.0",

  "archetypes": {
    "product_hero": {
      "description": "Subject isolated — no environmental context. Product is the total focus.",
      "styles": [
        "isolated_clean",
        "textured_surface",
        "macro_detail",
        "floating",
        "composed_group",
        "deconstructed"
      ]
    },
    "lifestyle": {
      "description": "Subject in lived environment. Context carries as much meaning as the product.",
      "styles": [
        "aspirational_staged",
        "candid_real",
        "minimalist",
        "maximalist_rich",
        "domestic_intimate",
        "social_connected"
      ]
    },
    "sports": {
      "description": "Athletic or movement context — either captured or constructed.",
      "styles": [
        "action_dynamic",
        "staged_controlled",
        "celebration",
        "training_grit",
        "recovery_quiet",
        "fan_crowd"
      ]
    },
    "process_craft": {
      "description": "Making, transformation, craft — subject in a state of becoming.",
      "styles": [
        "precision_scientific",
        "transformation_moment",
        "industrial_scale",
        "artisan_hand",
        "lab_clinical",
        "field_harvest"
      ]
    },
    "device_in_use": {
      "description": "Screen or interface as a primary element of the shot.",
      "styles": [
        "hand_held",
        "flat_lay",
        "environmental_context",
        "screen_detail",
        "multi_device",
        "desktop_workspace"
      ]
    },
    "portrait": {
      "description": "Person as subject. Face or figure is the primary visual anchor.",
      "styles": [
        "editorial_directed",
        "candid_unposed",
        "brand_character",
        "anonymous_faceless",
        "group_ensemble",
        "silhouette"
      ]
    },
    "texture_macro": {
      "description": "Extreme close-up — material, surface, or ingredient as abstract subject.",
      "styles": [
        "material_study",
        "surface_abstract",
        "ingredient_detail",
        "structural_pattern",
        "fabric_weave",
        "liquid_surface"
      ]
    },
    "environmental": {
      "description": "Space or atmosphere — no primary subject. Sets a world.",
      "styles": [
        "atmospheric_mood",
        "empty_space",
        "establishing_wide",
        "abstract_detail",
        "architectural",
        "natural_landscape"
      ]
    },
    "editorial": {
      "description": "Concept-driven, art-directed. Image carries an idea, not just a product.",
      "styles": [
        "conceptual_surreal",
        "cultural_reference",
        "typographic_led",
        "collage_layered",
        "archival_documentary",
        "symbolic"
      ]
    },
    "data_visual": {
      "description": "Numbers, charts, or information rendered as visual content.",
      "styles": [
        "infographic_illustrated",
        "ambient_data_art",
        "abstract_metric",
        "dashboard_ui",
        "comparative_chart",
        "motion_data"
      ]
    }
  },

  "mood_tags": [
    "warm_luxury",
    "quiet_confidence",
    "raw_energy",
    "clinical_precise",
    "playful_bold",
    "premium_restrained",
    "organic_natural",
    "editorial_sharp",
    "digital_clean",
    "melancholic",
    "aspirational",
    "intimate",
    "cerebral",
    "kinetic",
    "sensory"
  ],

  "color_cast_tags": [
    "monochromatic_warm",
    "monochromatic_cool",
    "split_tone",
    "neutral_desaturated",
    "high_contrast",
    "pastel_light",
    "deep_rich",
    "chromatic_pop"
  ],

  "palette_roles": [
    "primary",
    "secondary",
    "accent",
    "background",
    "shadow",
    "neutral"
  ],

  "category_tags": [
    "food_photography",
    "fintech",
    "lifestyle",
    "sports",
    "beauty",
    "hospitality",
    "tech",
    "fashion",
    "health",
    "automotive",
    "real_estate",
    "entertainment",
    "education",
    "events"
  ],

  "framing_tags": ["tight", "mid", "wide"],
  "ratio_tags": ["16:9", "3:4", "1:1", "9:16"],

  "client_relevance_values": {
    "ce_territory":    "CE would propose this direction unprompted. High aesthetic ownership.",
    "client_brief":    "Right for certain clients even if not distinctly CE. Competent, on-brief.",
    "reference_only":  "Informational. Understand the space, not inspiration.",
    "anti_pattern":    "Saved to understand what CE — or a specific client — is NOT.",
    "generation_test": "AI-generated image produced during direction testing (e.g. R1-R7). Not a curated reference — a test artifact. May be positive, partial, or negative result.",
    "lock_reference":  "The canonical image that triggered the lock decision (Gate 2). Ground truth for the direction. Distinguishable from other ce_territory images."
  },

  "image_source_values": {
    "human_curated":        "Added by a human from an external source (editorial, social, agency, etc.).",
    "ai_generated":         "Produced by an AI image generation model during direction testing.",
    "competitive_reference":"Sourced from competitive research sweep.",
    "client_supplied":      "Provided directly by the client as reference or existing brand asset."
  }

}