Deploy v12 Primeo-fused single-space mapper

SPACE_FILE_LIST.txt

@@ -0,0 +1,9 @@
+README.md
+app.py
+deploy_to_hf.ps1
+docs/PRIMEO_FUSION_NOTES.md
+memory/model_stack.json
+memory/pipeline_schema.json
+memory/production_rules.json
+requirements.txt
+tests/README.md

docs/docs/PRIMEO_FUSION_NOTES.md

@@ -0,0 +1,27 @@
+# Primeo Fusion Notes
+
+Primeo had strong pipeline concepts but was split across Flutter, HF Inference API, device temp storage, and hardcoded garment polygons.
+
+v12 ports the useful concepts into one Hugging Face Gradio Space:
+
+- PipelineOutput
+- PiecePlan
+- qualityScore
+- warnings
+- productionReady
+- staged pipeline logic
+
+v12 rejects the split architecture:
+
+- no user API key box
+- no Flutter runtime
+- no hardcoded final garment polygons as the only source of truth
+- no separate Supabase/job layer for v1
+
+The real production core remains:
+
+- uploaded template ZIP
+- white-only printable region scanner
+- role-safe mapping
+- pocket continuity
+- transparent PNG export

memory/memory/model_stack.json

@@ -0,0 +1,10 @@
+{
+  "current": "deterministic_cv_core",
+  "zerogpu_slots": {
+    "vlm_art_director": "future optional",
+    "object_detector": "Grounding DINO future optional",
+    "segmentation": "SAM/SAM2 future optional",
+    "ocr_text_regions": "Florence future optional"
+  },
+  "rule": "AI may suggest layout, deterministic renderer owns final production math."
+}

memory/memory/pipeline_schema.json

@@ -0,0 +1,20 @@
+{
+  "ported_from_primeo": [
+    "PiecePlan",
+    "BoundingBox",
+    "PipelineOutput",
+    "qualityScore",
+    "warnings",
+    "productionReady",
+    "progressive pipeline stages"
+  ],
+  "kept_from_v11": [
+    "white-only scanner",
+    "real template ZIP parsing",
+    "no hero spam",
+    "pocket continuity from front underlay",
+    "transparent print PNG export",
+    "manifest JSON"
+  ],
+  "runtime_target": "single Hugging Face Gradio Space"
+}

memory/memory/production_rules.json

@@ -0,0 +1,21 @@
+{
+  "version": "v12-primeo-fused",
+  "rules": [
+    "Only white printable areas are pieces.",
+    "Colored seam, bleed, blur, safe-zone, label, and guide marks are restrictions only.",
+    "Front body gets hero by default.",
+    "No hero spam on hood, sleeves, trim, pocket, or label.",
+    "Pocket/flap/overlay must inherit rendered parent underlay.",
+    "Export transparent PNGs only, no template board or guide lines.",
+    "Quality Tribunal must mark non-ready if hero repeats on non-front pieces."
+  ],
+  "piece_roles": {
+    "front_body": "hero_subject",
+    "back_body": "secondary_scene_or_atmosphere",
+    "hood": "abstract_atmosphere_only",
+    "sleeve": "motion_texture_background",
+    "trim": "low_detail_texture",
+    "inside_label": "small_hidden_detail",
+    "overlay_pocket": "exact_parent_underlay"
+  }
+}

tests/README.md

@@ -0,0 +1,3 @@
+# Tests
+
+Drop sample artwork and template zips here for local/HF test runs.