ALTERNATIVE™ Syrup Master System — Compliance + Production Rebuild

.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+output/
+*.egg-info/
+.pytest_cache/
+.DS_Store

README.md

@@ -1,2 +1,74 @@
 # ALT-Label-System
-Code-driven packaging and label generation system for ALTERNATIVE products.
+
+Code-driven packaging and label generation for **ALTERNATIVE™** products.
+
+## Product Lines
+
+| Line | System | Export |
+|------|--------|--------|
+| **12oz Sleek Cans** | `alt_label` v2.0 | `python3 scripts/export_production.py` |
+| **THC Syrup 4oz** | `alt_syrup` v1.0 | `python3 scripts/export_syrup_production.py` |
+
+```bash
+pip install -r requirements.txt
+```
+
+---
+
+## Can Labels (Retail Master Lock v2.0)
+
+8 PDFs — 4 SKUs × 2 flavors (Lychee Sweet Tea, Passion Fruit)
+
+```bash
+python3 scripts/export_production.py
+python3 scripts/validate_spec.py
+```
+
+Output: `output/production_v2/`
+
+---
+
+## Syrup Labels (Master Compliance + Production Rebuild)
+
+4 PDFs — Original · Grape · Strawberry · Mango
+
+```bash
+python3 scripts/export_syrup_production.py
+python3 scripts/validate_syrup_spec.py
+```
+
+Output: `output/syrup_production/`
+
+### Syrup Product Facts (locked)
+- 420mg THC · 5mg per 5mL serving · 84 servings · 4 FL OZ (120mL)
+
+### Documentation
+- [Compliance Audit Report](docs/syrup/COMPLIANCE_AUDIT_REPORT.md)
+- [Master Label Standard](docs/syrup/MASTER_LABEL_STANDARD.md)
+- [Change Log](docs/syrup/CHANGELOG.md)
+- [Future Expansion Guide](docs/syrup/FUTURE_EXPANSION_GUIDE.md)
+
+### Illustrator Masters
+- `assets/syrup/masters/front_panel_master.svg`
+- `assets/syrup/masters/back_panel_master.svg`
+
+---
+
+## Final Production Lock v3.0
+
+**Launch Readiness Score: 7.4/10** — Design frozen; retail inventory hold until CRITICAL items resolved.
+
+```bash
+python3 scripts/launch_readiness_audit.py
+```
+
+Full gate report: [docs/FINAL_PRODUCTION_LOCK_V3.md](docs/FINAL_PRODUCTION_LOCK_V3.md)
+
+---
+
+## Design Principles (all lines)
+
+- **Not a redesign** — refine, validate, productionize
+- Matte black · warm off-white · gold/amber accents
+- No AI artifacts · no decorative filler · no fruit/cannabis imagery
+- Manufacturer data only — no estimated compliance values

config/brand.yaml

@@ -0,0 +1,74 @@
+# ALTERNATIVE™ Final Prepress + Retail Master Lock v2.0
+# Refinement pass — NOT a redesign
+
+version: "2.0"
+
+brand:
+  name: "ALTERNATIVE™"
+  tagline: "A NEW STATE OF MIND"
+  positioning: "HEMP-DERIVED THC BEVERAGE"
+  website: "AlternativeBev.com"
+
+canvas:
+  width_mm: 182.22
+  height_mm: 148.0
+  dpi: 300
+  bleed_mm: 3.175
+  safe_zone_mm: 4.0
+
+colors:
+  matte_black:
+    cmyk: [0, 0, 0, 100]
+  warm_off_white:
+    cmyk: [0, 3, 8, 4]
+  champagne_gold:
+    cmyk: [0, 15, 35, 15]
+  deep_amber:
+    cmyk: [0, 45, 75, 25]
+
+typography:
+  tagline: 7.5
+  a_symbol_scale: 0.90
+  brand_name_scale: 1.225
+  brand_name_spacing: 1.6
+  positioning: 6.5
+  sku: 9.0
+  thc_content: 11.0
+  flavor_scale: 1.35
+  flavor_base: 8.5
+  net_contents: 7.0
+  compliance_body: 5.5
+  compliance_heading: 6.5
+
+manufacturing:
+  manufactured_by_label: "Manufactured By:"
+  manufactured_by: "Proleve"
+  manufactured_for_label: "Manufactured For:"
+  manufactured_for: "Invictus Wellness LLC"
+  address_lines:
+    - "11624 Red Bridge Rd"
+    - "Locust, NC 28097 USA"
+
+qr_section:
+  heading_lines:
+    - "SCAN FOR"
+    - "LAB RESULTS"
+    - "INGREDIENTS"
+    - "PRODUCT INFO"
+  quiet_zone_ratio: 0.12
+
+warning_panel:
+  heading: "WARNING:"
+  lines:
+    - "For adults 21 years of age or older."
+    - "Keep out of reach of children."
+    - "Do not drive or operate machinery after use."
+    - "Do not use while pregnant or breastfeeding."
+    - "Intoxicating effects may be delayed."
+    - "Consume responsibly."
+
+active_ingredient:
+  label: "Active Ingredient"
+  substance: "Hemp-Derived Delta-9 THC"
+
+net_contents: "12 FL OZ (355 mL)"

config/flavors.yaml

@@ -0,0 +1,10 @@
+# Flavor system — no fruit graphics, no illustrations
+
+flavors:
+  - id: lychee_sweet_tea
+    name: "LYCHEE SWEET TEA"
+    accent_color: champagne_gold
+
+  - id: passion_fruit
+    name: "PASSION FRUIT"
+    accent_color: deep_amber

config/skus.yaml

@@ -0,0 +1,26 @@
+# Locked SKU system — no 20MG, no additional strengths
+
+skus:
+  - id: session_5mg
+    name: "SESSION™"
+    thc_mg: 5
+    thc_line: "5MG HEMP-DERIVED THC PER CAN"
+    active_ingredient_amount: "5mg"
+
+  - id: social_10mg
+    name: "SOCIAL™"
+    thc_mg: 10
+    thc_line: "10MG HEMP-DERIVED THC PER CAN"
+    active_ingredient_amount: "10mg"
+
+  - id: reserve_50mg
+    name: "RESERVE™"
+    thc_mg: 50
+    thc_line: "50MG HEMP-DERIVED THC PER CAN"
+    active_ingredient_amount: "50mg"
+
+  - id: reserve_100mg
+    name: "RESERVE™"
+    thc_mg: 100
+    thc_line: "100MG HEMP-DERIVED THC PER CAN"
+    active_ingredient_amount: "100mg"

config/syrup/brand.yaml

@@ -0,0 +1,89 @@
+# ALTERNATIVE™ Syrup Master System v1.0
+# Scalable master — NOT a redesign
+
+version: "1.0"
+product_line: syrup
+
+brand:
+  name: "ALTERNATIVE™"
+  website: "AlternativeBev.com"
+  statement_of_identity: "Hemp-Derived Delta-9 THC Syrup"
+
+canvas:
+  panel_width_mm: 52.0
+  panel_height_mm: 90.0
+  combined_width_mm: 104.0
+  dpi: 300
+  bleed_mm: 3.175
+  safe_zone_mm: 3.0
+  gutter_mm: 0.0
+
+colors:
+  matte_black:
+    cmyk: [0, 0, 0, 100]
+  warm_off_white:
+    cmyk: [0, 3, 8, 4]
+  champagne_gold:
+    cmyk: [0, 15, 35, 15]
+  deep_amber:
+    cmyk: [0, 45, 75, 25]
+  berry_accent:
+    cmyk: [25, 55, 30, 10]
+  citrus_accent:
+    cmyk: [0, 25, 55, 10]
+
+typography:
+  brand_name: 14.0
+  flavor_name: 11.0
+  thc_total: 13.0
+  thc_per_serving: 8.0
+  servings: 7.5
+  net_contents: 7.0
+  panel_heading: 6.5
+  panel_body: 5.5
+  supplement_heading: 6.0
+  supplement_body: 5.0
+
+product:
+  total_thc_mg: 420
+  thc_per_serving_mg: 5
+  serving_size: "5 mL"
+  servings_per_container: 84
+  net_contents: "4 FL OZ (120 mL)"
+
+directions:
+  heading: "DIRECTIONS:"
+  lines:
+    - "Shake well before use."
+    - "Adults 21+: Take 5 mL (1 teaspoon) per serving."
+    - "Wait at least 2 hours before taking an additional serving."
+    - "Do not exceed one serving at onset."
+
+responsible_party:
+  manufactured_by_label: "Manufactured By:"
+  manufactured_by: "Proleve"
+  manufactured_for_label: "Manufactured For:"
+  manufactured_for: "Invictus Wellness LLC"
+  address_lines:
+    - "11624 Red Bridge Rd"
+    - "Locust, NC 28097 USA"
+
+qr_section:
+  heading_lines:
+    - "SCAN FOR"
+    - "LAB RESULTS"
+    - "INGREDIENTS"
+    - "PRODUCT INFO"
+  quiet_zone_ratio: 0.12
+
+warning_panel:
+  heading: "WARNING:"
+  lines:
+    - "For adults 21 years of age or older."
+    - "Keep out of reach of children and pets."
+    - "Do not drive or operate machinery after use."
+    - "Do not use while pregnant or breastfeeding."
+    - "Intoxicating effects may be delayed up to 2 hours."
+    - "Start with a single serving. Do not exceed recommended use."
+    - "May cause a positive drug test result."
+    - "Consume responsibly."

config/syrup/flavors.yaml

@@ -0,0 +1,22 @@
+# Locked syrup flavors — scalable via this file only
+
+flavors:
+  - id: original
+    name: "ORIGINAL"
+    display_name: "Original"
+    accent_color: champagne_gold
+
+  - id: grape
+    name: "GRAPE"
+    display_name: "Grape"
+    accent_color: berry_accent
+
+  - id: strawberry
+    name: "STRAWBERRY"
+    display_name: "Strawberry"
+    accent_color: berry_accent
+
+  - id: mango
+    name: "MANGO"
+    display_name: "Mango"
+    accent_color: citrus_accent

data/compliance/README.md

@@ -0,0 +1,26 @@
+# Compliance Data — Manufacturer Provided
+
+Retail Master Lock v1.0 requires **exact manufacturer-provided** nutrition and ingredient data. No estimates.
+
+## Flavor-Level Data (locked)
+
+| Flavor | Calories | Ingredients |
+|--------|----------|-------------|
+| PASSION FRUIT | 0 | Carbonated Water, Natural Passion Fruit Flavor, Hemp-Derived THC |
+| LYCHEE SWEET TEA | 20 | Water, Organic Cane Sugar, Natural Lychee Flavoring, Citric Acid, Malic Acid, Tartaric Acid, Tea Flavoring, Potassium Sorbate, Hemp-Derived Delta-9 THC |
+
+Stored in `flavors/{flavor_id}.json`. Product files inherit this data automatically.
+
+## Product Overrides
+
+Optional per-SKU files in `products/{sku_id}_{flavor_id}.json` for:
+- Assigned UPC barcode
+- Lot / batch / best-by per production run
+- State-specific warnings
+
+## Generate Labels
+
+```bash
+python3 scripts/generate_labels.py --mode production
+python3 scripts/validate_spec.py
+```

data/compliance/TEMPLATE.json

@@ -0,0 +1,15 @@
+{
+  "_comment": "Manufacturer-provided data only. Flavor-level data lives in data/compliance/flavors/",
+  "verified": true,
+  "product_id": "alternative_session_5mg_lychee_sweet_tea",
+  "source": "manufacturer_provided",
+  "nutrition_facts": {
+    "serving_size": "1 can (355 mL)",
+    "servings_per_container": "1",
+    "calories": "FROM_MANUFACTURER",
+    "nutrients": []
+  },
+  "ingredients": "FROM_MANUFACTURER",
+  "qr_url": "https://AlternativeBev.com/lab-results",
+  "state_warnings": []
+}