feat: ingest real exercise dataset into knowledge artifacts

data/knowledge/exercises.json

@@ -0,0 +1,523 @@
+{
+  "source_dataset": "DORTROX/Exercises-Data",
+  "generated_at": "2026-06-14T10:09:45.365188+00:00",
+  "exercise_count": 43,
+  "exercises": [
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "advancedtransitionlunge",
+      "title": "Advancedtransitionlunge",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "alignedsquat",
+      "title": "Alignedsquat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "benddownandruninplace",
+      "title": "Benddownandruninplace",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "bulgariansplitsquat",
+      "title": "Bulgariansplitsquat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "bulgariansquat",
+      "title": "Bulgariansquat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "calfraise",
+      "title": "Calfraise",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "chairplank",
+      "title": "Chairplank",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "extendedplank",
+      "title": "Extendedplank",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "frontplank",
+      "title": "Frontplank",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "inclinedlunge",
+      "title": "Inclinedlunge",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "inclinelunge",
+      "title": "Inclinelunge",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "isometricsquat",
+      "title": "Isometricsquat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "jumpingjack",
+      "title": "Jumpingjack",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "kneeraisecombinedwitharmlift",
+      "title": "Kneeraisecombinedwitharmlift",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "low_impactjumpingjacks",
+      "title": "Low Impactjumpingjacks",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "lowimpactheeltobutt",
+      "title": "Lowimpactheeltobutt",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "lowimpactjumpingjack",
+      "title": "Lowimpactjumpingjack",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "lunge",
+      "title": "Lunge",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "lunge",
+      "title": "Lunge",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "lungewithbalance",
+      "title": "Lungewithbalance",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "lungewithkneelift",
+      "title": "Lungewithkneelift",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "lungewithkneestrike",
+      "title": "Lungewithkneestrike",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "neutralalignedsquat",
+      "title": "Neutralalignedsquat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "plantarraisecalf",
+      "title": "Plantarraisecalf",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "polifootwear",
+      "title": "Polifootwear",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "poliopensandcloses",
+      "title": "Poliopensandcloses",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "polishoe",
+      "title": "Polishoe",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "runninginplace",
+      "title": "Runninginplace",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "sideshuffle",
+      "title": "Sideshuffle",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "sinkwithbalance",
+      "title": "Sinkwithbalance",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "sky",
+      "title": "Sky",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "squat",
+      "title": "Squat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "squat",
+      "title": "Squat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "squatandlateralshif",
+      "title": "Squatandlateralshif",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "squatandraisearms",
+      "title": "Squatandraisearms",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "squatandtouchthefootmp4",
+      "title": "Squatandtouchthefootmp4",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "squatwithbackwardlunge",
+      "title": "Squatwithbackwardlunge",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "squatwithinsistence2x",
+      "title": "Squatwithinsistence2x",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "stationaryrunning",
+      "title": "Stationaryrunning",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "stiffunilateral",
+      "title": "Stiffunilateral",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "sumosquat",
+      "title": "Sumosquat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "sumosquat",
+      "title": "Sumosquat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    },
+    {
+      "source_dataset": "DORTROX/Exercises-Data",
+      "exercise_label": "unilateralsquat",
+      "title": "Unilateralsquat",
+      "aliases": [],
+      "category": null,
+      "equipment": [],
+      "primary_muscles": [],
+      "secondary_muscles": [],
+      "instructions": [],
+      "description": null
+    }
+  ]
+}

data/knowledge_cards/external_exercise_dataset_pack.json

@@ -0,0 +1,782 @@
+{
+  "source_dataset": "DORTROX/Exercises-Data",
+  "generated_at": "2026-06-14T10:09:45.368287+00:00",
+  "normalized_exercise_count": 43,
+  "card_count": 43,
+  "cards": [
+    {
+      "card_id": "exercise:advancedtransitionlunge",
+      "card_type": "exercise",
+      "labels": [
+        "advancedtransitionlunge"
+      ],
+      "title": "Advancedtransitionlunge",
+      "summary": "A Advancedtransitionlunge summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:alignedsquat",
+      "card_type": "exercise",
+      "labels": [
+        "alignedsquat"
+      ],
+      "title": "Alignedsquat",
+      "summary": "A Alignedsquat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:benddownandruninplace",
+      "card_type": "exercise",
+      "labels": [
+        "benddownandruninplace"
+      ],
+      "title": "Benddownandruninplace",
+      "summary": "A Benddownandruninplace summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:bulgariansplitsquat",
+      "card_type": "exercise",
+      "labels": [
+        "bulgariansplitsquat"
+      ],
+      "title": "Bulgariansplitsquat",
+      "summary": "A Bulgariansplitsquat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:bulgariansquat",
+      "card_type": "exercise",
+      "labels": [
+        "bulgariansquat"
+      ],
+      "title": "Bulgariansquat",
+      "summary": "A Bulgariansquat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:calfraise",
+      "card_type": "exercise",
+      "labels": [
+        "calfraise"
+      ],
+      "title": "Calfraise",
+      "summary": "A Calfraise summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:chairplank",
+      "card_type": "exercise",
+      "labels": [
+        "chairplank"
+      ],
+      "title": "Chairplank",
+      "summary": "A Chairplank summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:extendedplank",
+      "card_type": "exercise",
+      "labels": [
+        "extendedplank"
+      ],
+      "title": "Extendedplank",
+      "summary": "A Extendedplank summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:frontplank",
+      "card_type": "exercise",
+      "labels": [
+        "frontplank"
+      ],
+      "title": "Frontplank",
+      "summary": "A Frontplank summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:inclinedlunge",
+      "card_type": "exercise",
+      "labels": [
+        "inclinedlunge"
+      ],
+      "title": "Inclinedlunge",
+      "summary": "A Inclinedlunge summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:inclinelunge",
+      "card_type": "exercise",
+      "labels": [
+        "inclinelunge"
+      ],
+      "title": "Inclinelunge",
+      "summary": "A Inclinelunge summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:isometricsquat",
+      "card_type": "exercise",
+      "labels": [
+        "isometricsquat"
+      ],
+      "title": "Isometricsquat",
+      "summary": "A Isometricsquat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:jumpingjack",
+      "card_type": "exercise",
+      "labels": [
+        "jumpingjack"
+      ],
+      "title": "Jumpingjack",
+      "summary": "A Jumpingjack summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:kneeraisecombinedwitharmlift",
+      "card_type": "exercise",
+      "labels": [
+        "kneeraisecombinedwitharmlift"
+      ],
+      "title": "Kneeraisecombinedwitharmlift",
+      "summary": "A Kneeraisecombinedwitharmlift summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:low_impactjumpingjacks",
+      "card_type": "exercise",
+      "labels": [
+        "low_impactjumpingjacks"
+      ],
+      "title": "Low Impactjumpingjacks",
+      "summary": "A Low Impactjumpingjacks summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:lowimpactheeltobutt",
+      "card_type": "exercise",
+      "labels": [
+        "lowimpactheeltobutt"
+      ],
+      "title": "Lowimpactheeltobutt",
+      "summary": "A Lowimpactheeltobutt summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:lowimpactjumpingjack",
+      "card_type": "exercise",
+      "labels": [
+        "lowimpactjumpingjack"
+      ],
+      "title": "Lowimpactjumpingjack",
+      "summary": "A Lowimpactjumpingjack summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:lunge",
+      "card_type": "exercise",
+      "labels": [
+        "lunge"
+      ],
+      "title": "Lunge",
+      "summary": "A Lunge summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:lunge",
+      "card_type": "exercise",
+      "labels": [
+        "lunge"
+      ],
+      "title": "Lunge",
+      "summary": "A Lunge summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:lungewithbalance",
+      "card_type": "exercise",
+      "labels": [
+        "lungewithbalance"
+      ],
+      "title": "Lungewithbalance",
+      "summary": "A Lungewithbalance summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:lungewithkneelift",
+      "card_type": "exercise",
+      "labels": [
+        "lungewithkneelift"
+      ],
+      "title": "Lungewithkneelift",
+      "summary": "A Lungewithkneelift summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:lungewithkneestrike",
+      "card_type": "exercise",
+      "labels": [
+        "lungewithkneestrike"
+      ],
+      "title": "Lungewithkneestrike",
+      "summary": "A Lungewithkneestrike summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:neutralalignedsquat",
+      "card_type": "exercise",
+      "labels": [
+        "neutralalignedsquat"
+      ],
+      "title": "Neutralalignedsquat",
+      "summary": "A Neutralalignedsquat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:plantarraisecalf",
+      "card_type": "exercise",
+      "labels": [
+        "plantarraisecalf"
+      ],
+      "title": "Plantarraisecalf",
+      "summary": "A Plantarraisecalf summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:polifootwear",
+      "card_type": "exercise",
+      "labels": [
+        "polifootwear"
+      ],
+      "title": "Polifootwear",
+      "summary": "A Polifootwear summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:poliopensandcloses",
+      "card_type": "exercise",
+      "labels": [
+        "poliopensandcloses"
+      ],
+      "title": "Poliopensandcloses",
+      "summary": "A Poliopensandcloses summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:polishoe",
+      "card_type": "exercise",
+      "labels": [
+        "polishoe"
+      ],
+      "title": "Polishoe",
+      "summary": "A Polishoe summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:runninginplace",
+      "card_type": "exercise",
+      "labels": [
+        "runninginplace"
+      ],
+      "title": "Runninginplace",
+      "summary": "A Runninginplace summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:sideshuffle",
+      "card_type": "exercise",
+      "labels": [
+        "sideshuffle"
+      ],
+      "title": "Sideshuffle",
+      "summary": "A Sideshuffle summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:sinkwithbalance",
+      "card_type": "exercise",
+      "labels": [
+        "sinkwithbalance"
+      ],
+      "title": "Sinkwithbalance",
+      "summary": "A Sinkwithbalance summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:sky",
+      "card_type": "exercise",
+      "labels": [
+        "sky"
+      ],
+      "title": "Sky",
+      "summary": "A Sky summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:squat",
+      "card_type": "exercise",
+      "labels": [
+        "squat"
+      ],
+      "title": "Squat",
+      "summary": "A Squat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:squat",
+      "card_type": "exercise",
+      "labels": [
+        "squat"
+      ],
+      "title": "Squat",
+      "summary": "A Squat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:squatandlateralshif",
+      "card_type": "exercise",
+      "labels": [
+        "squatandlateralshif"
+      ],
+      "title": "Squatandlateralshif",
+      "summary": "A Squatandlateralshif summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:squatandraisearms",
+      "card_type": "exercise",
+      "labels": [
+        "squatandraisearms"
+      ],
+      "title": "Squatandraisearms",
+      "summary": "A Squatandraisearms summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:squatandtouchthefootmp4",
+      "card_type": "exercise",
+      "labels": [
+        "squatandtouchthefootmp4"
+      ],
+      "title": "Squatandtouchthefootmp4",
+      "summary": "A Squatandtouchthefootmp4 summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:squatwithbackwardlunge",
+      "card_type": "exercise",
+      "labels": [
+        "squatwithbackwardlunge"
+      ],
+      "title": "Squatwithbackwardlunge",
+      "summary": "A Squatwithbackwardlunge summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:squatwithinsistence2x",
+      "card_type": "exercise",
+      "labels": [
+        "squatwithinsistence2x"
+      ],
+      "title": "Squatwithinsistence2x",
+      "summary": "A Squatwithinsistence2x summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:stationaryrunning",
+      "card_type": "exercise",
+      "labels": [
+        "stationaryrunning"
+      ],
+      "title": "Stationaryrunning",
+      "summary": "A Stationaryrunning summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:stiffunilateral",
+      "card_type": "exercise",
+      "labels": [
+        "stiffunilateral"
+      ],
+      "title": "Stiffunilateral",
+      "summary": "A Stiffunilateral summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:sumosquat",
+      "card_type": "exercise",
+      "labels": [
+        "sumosquat"
+      ],
+      "title": "Sumosquat",
+      "summary": "A Sumosquat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:sumosquat",
+      "card_type": "exercise",
+      "labels": [
+        "sumosquat"
+      ],
+      "title": "Sumosquat",
+      "summary": "A Sumosquat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    },
+    {
+      "card_id": "exercise:unilateralsquat",
+      "card_type": "exercise",
+      "labels": [
+        "unilateralsquat"
+      ],
+      "title": "Unilateralsquat",
+      "summary": "A Unilateralsquat summary should stay grounded in structured rep evidence.",
+      "evidence_rules": [
+        "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
+        "Treat valid detected variations as context unless issue markers show a separate problem."
+      ],
+      "coaching_points": [
+        "Keep the summary focused on repeatable setup and execution cues supported by the evidence."
+      ],
+      "allowed_interpretations": [],
+      "related_cards": []
+    }
+  ]
+}

scripts/build_exercise_knowledge_base.py

@@ -0,0 +1,102 @@
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+import sys
+
+
+ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT / "src"))
+
+from pozify.knowledge_card_dataset_transformer import (  # noqa: E402
+    write_card_pack,
+    write_normalized_exercises,
+)
+
+
+DEFAULT_HF_DATASET = "DORTROX/Exercises-Data"
+DEFAULT_HF_FILENAME = "dataset.json"
+
+
+def _download_hf_dataset_file(repo_id: str, filename: str) -> Path:
+    try:
+        from huggingface_hub import hf_hub_download
+    except ImportError as exc:  # pragma: no cover
+        raise RuntimeError("huggingface_hub is required to download Hugging Face datasets") from exc
+
+    return Path(hf_hub_download(repo_id=repo_id, repo_type="dataset", filename=filename))
+
+
+def build_arg_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        description="Build a normalized exercise knowledge base and Pozify card pack from a real dataset export."
+    )
+    parser.add_argument(
+        "--input",
+        help="Local path to a JSON or JSONL exercise dataset export.",
+    )
+    parser.add_argument(
+        "--hf-dataset",
+        default=DEFAULT_HF_DATASET,
+        help="Hugging Face dataset repo id to download when --input is omitted.",
+    )
+    parser.add_argument(
+        "--hf-filename",
+        default=DEFAULT_HF_FILENAME,
+        help="Filename inside the Hugging Face dataset repo to download when --input is omitted.",
+    )
+    parser.add_argument(
+        "--normalized-output",
+        default=str(ROOT / "data/knowledge/exercises.json"),
+        help="Path for the normalized exercise-schema export.",
+    )
+    parser.add_argument(
+        "--card-pack-output",
+        default=str(ROOT / "data/knowledge_cards/external_exercise_dataset_pack.json"),
+        help="Path for the generated Pozify card-pack JSON.",
+    )
+    parser.add_argument(
+        "--source-dataset",
+        help="Optional source identifier to record in metadata. Defaults to the local file path or HF dataset id.",
+    )
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_arg_parser()
+    args = parser.parse_args(argv)
+
+    if args.input:
+        input_path = Path(args.input).expanduser().resolve()
+        source_dataset = args.source_dataset or str(input_path)
+    else:
+        input_path = _download_hf_dataset_file(args.hf_dataset, args.hf_filename)
+        source_dataset = args.source_dataset or args.hf_dataset
+
+    normalized = write_normalized_exercises(
+        input_path=input_path,
+        output_path=Path(args.normalized_output),
+        source_dataset=source_dataset,
+    )
+    pack = write_card_pack(
+        input_path=input_path,
+        output_path=Path(args.card_pack_output),
+        source_dataset=source_dataset,
+    )
+
+    print(
+        "Built exercise knowledge base",
+        {
+            "source_dataset": source_dataset,
+            "input_path": str(input_path),
+            "normalized_output": args.normalized_output,
+            "card_pack_output": args.card_pack_output,
+            "exercise_count": normalized["exercise_count"],
+            "card_count": pack["card_count"],
+        },
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

src/pozify/knowledge_card_dataset_transformer.py

@@ -133,12 +133,12 @@ def _build_summary(
     return " ".join(parts)
 
 
-def transform_dataset_rows(
+def normalize_dataset_rows(
     rows: list[dict[str, Any]],
     *,
     source_dataset: str,
-) -> dict[str, Any]:
-    cards: list[dict[str, Any]] = []
+) -> list[dict[str, Any]]:
+    exercises: list[dict[str, Any]] = []
     for row in rows:
         name_value = _first_present(row, FIELD_CANDIDATES["name"])
         if not isinstance(name_value, str) or not name_value.strip():
@@ -165,10 +165,45 @@ def transform_dataset_rows(
         description_value = _first_present(row, FIELD_CANDIDATES["description"])
         description = description_value.strip() if isinstance(description_value, str) else None
 
-        labels = _dedupe_keep_order(
-            [exercise_label, *(_slugify(alias) for alias in aliases if alias.strip())]
+        exercises.append(
+            {
+                "source_dataset": source_dataset,
+                "exercise_label": exercise_label,
+                "title": title,
+                "aliases": aliases,
+                "category": category.strip() if isinstance(category, str) else None,
+                "equipment": equipment,
+                "primary_muscles": primary_muscles,
+                "secondary_muscles": secondary_muscles,
+                "instructions": instructions,
+                "description": description,
+            }
         )
 
+    exercises.sort(key=lambda item: item["exercise_label"])
+    return exercises
+
+
+def transform_dataset_rows(
+    rows: list[dict[str, Any]],
+    *,
+    source_dataset: str,
+) -> dict[str, Any]:
+    exercises = normalize_dataset_rows(rows, source_dataset=source_dataset)
+    cards: list[dict[str, Any]] = []
+    for exercise in exercises:
+        exercise_label = str(exercise["exercise_label"])
+        title = str(exercise["title"])
+        aliases = [str(item) for item in exercise["aliases"]]
+        category = exercise["category"]
+        equipment = [str(item) for item in exercise["equipment"]]
+        primary_muscles = [str(item) for item in exercise["primary_muscles"]]
+        secondary_muscles = [str(item) for item in exercise["secondary_muscles"]]
+        instructions = [str(item) for item in exercise["instructions"]]
+        description = exercise["description"] if isinstance(exercise["description"], str) else None
+
+        labels = _dedupe_keep_order([exercise_label, *(_slugify(alias) for alias in aliases)])
+
         evidence_rules = [
             "Use structured rep analysis and issue markers instead of inferring directly from raw video.",
             "Treat valid detected variations as context unless issue markers show a separate problem.",
@@ -219,6 +254,7 @@ def transform_dataset_rows(
     return {
         "source_dataset": source_dataset,
         "generated_at": datetime.now(timezone.utc).isoformat(),
+        "normalized_exercise_count": len(exercises),
         "card_count": len(cards),
         "cards": cards,
     }
@@ -271,6 +307,25 @@ def write_card_pack(
     return pack
 
 
+def write_normalized_exercises(
+    *,
+    input_path: Path,
+    output_path: Path,
+    source_dataset: str,
+) -> dict[str, Any]:
+    rows = load_dataset_rows(input_path)
+    exercises = normalize_dataset_rows(rows, source_dataset=source_dataset)
+    payload = {
+        "source_dataset": source_dataset,
+        "generated_at": datetime.now(timezone.utc).isoformat(),
+        "exercise_count": len(exercises),
+        "exercises": exercises,
+    }
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    output_path.write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
+    return payload
+
+
 def build_arg_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         description="Convert an exercise dataset export into a Pozify knowledge-card pack."
@@ -281,6 +336,10 @@ def build_arg_parser() -> argparse.ArgumentParser:
         required=True,
         help="Destination path for the generated Pozify card-pack JSON.",
     )
+    parser.add_argument(
+        "--normalized-output",
+        help="Optional destination path for a normalized exercise-schema JSON export.",
+    )
     parser.add_argument(
         "--source-dataset",
         default="unknown_dataset",
@@ -292,6 +351,12 @@ def build_arg_parser() -> argparse.ArgumentParser:
 def main(argv: list[str] | None = None) -> int:
     parser = build_arg_parser()
     args = parser.parse_args(argv)
+    if args.normalized_output:
+        write_normalized_exercises(
+            input_path=Path(args.input),
+            output_path=Path(args.normalized_output),
+            source_dataset=args.source_dataset,
+        )
     pack = write_card_pack(
         input_path=Path(args.input),
         output_path=Path(args.output),

tests/test_knowledge_card_dataset_transformer.py

@@ -10,8 +10,10 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
 
 from pozify.knowledge_card_dataset_transformer import (
     load_dataset_rows,
+    normalize_dataset_rows,
     transform_dataset_rows,
     write_card_pack,
+    write_normalized_exercises,
 )
 
 
@@ -66,6 +68,24 @@ class KnowledgeCardDatasetTransformerTests(unittest.TestCase):
         self.assertEqual(len(rows), 2)
         self.assertEqual(rows[0]["name"], "Squat")
 
+    def test_normalize_dataset_rows_writes_intermediate_schema(self) -> None:
+        exercises = normalize_dataset_rows(
+            [
+                {
+                    "Exercise_Name": "Air Squat",
+                    "Equipment": ["Bodyweight"],
+                    "Target Muscle": ["Quadriceps", "Glutes"],
+                    "Instructions": "Stand tall.\nSit down.\nStand up.",
+                }
+            ],
+            source_dataset="demo/normalized",
+        )
+
+        self.assertEqual(len(exercises), 1)
+        self.assertEqual(exercises[0]["exercise_label"], "squat")
+        self.assertEqual(exercises[0]["equipment"], ["Bodyweight"])
+        self.assertEqual(exercises[0]["primary_muscles"], ["Quadriceps", "Glutes"])
+
     def test_write_card_pack_writes_transform_output(self) -> None:
         with tempfile.TemporaryDirectory() as temp_dir:
             input_path = Path(temp_dir) / "dataset.json"
@@ -100,6 +120,33 @@ class KnowledgeCardDatasetTransformerTests(unittest.TestCase):
             ["Press the weights overhead.", "Lower with control."],
         )
 
+    def test_write_normalized_exercises_writes_json_schema(self) -> None:
+        with tempfile.TemporaryDirectory() as temp_dir:
+            input_path = Path(temp_dir) / "dataset.json"
+            output_path = Path(temp_dir) / "normalized.json"
+            input_path.write_text(
+                json.dumps(
+                    [
+                        {
+                            "name": "Push Up",
+                            "equipment": ["Bodyweight"],
+                            "primary_muscles": ["Chest"],
+                        }
+                    ]
+                ),
+                encoding="utf-8",
+            )
+
+            payload = write_normalized_exercises(
+                input_path=input_path,
+                output_path=output_path,
+                source_dataset="demo/normalized-write",
+            )
+            written = json.loads(output_path.read_text(encoding="utf-8"))
+
+        self.assertEqual(payload["exercise_count"], 1)
+        self.assertEqual(written["exercises"][0]["exercise_label"], "push_up")
+
 
 if __name__ == "__main__":
     unittest.main()