Fix annotation mode and HuggingFace push issues

- Fix README short_description to be under 60 chars (HF requirement)
- Improve annotation mode error handling and visibility
- Add clear error messages when AI doesn't provide annotations
- Add annotation count feedback when successful
- Update UI description to clarify numbered markers are drawn
- Add detailed error messages for annotation parsing failures

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

README.md

@@ -7,7 +7,7 @@ sdk: gradio
 sdk_version: 5.49.1
 app_file: app.py
 pinned: false
-short_description: Professional satellite imagery intelligence analysis powered by Claude
+short_description: Professional satellite imagery intelligence analysis
 ---
 
 # 🛰️ SATINT Analyst

app.py

@@ -207,6 +207,23 @@ Remember: The annotations will be numbered automatically in the order you list t
                 annotated_image = image
 
                 # Look for ANNOTATIONS: section
+                if "ANNOTATIONS:" not in analysis_text:
+                    # Model didn't provide annotations section
+                    error_msg = """
+⚠️ **ANNOTATION MODE ERROR**
+
+The AI model did not provide an ANNOTATIONS: section in its response.
+This means it didn't follow the annotation format instructions.
+
+Try again, or use Text Only mode for standard analysis.
+
+---
+
+**AI Response:**
+
+"""
+                    return error_msg + analysis_text, image
+
                 if "ANNOTATIONS:" in analysis_text:
                     # Extract the JSON part
                     parts = analysis_text.split("ANNOTATIONS:")
@@ -223,23 +240,45 @@ Remember: The annotations will be numbered automatically in the order you list t
                             annotations = json.loads(json_str)
 
                             # Draw annotations on image
-                            if annotations:
+                            if annotations and len(annotations) > 0:
                                 annotated_image = draw_annotations(image, annotations)
 
+                                # Add annotation count to the analysis
+                                annotation_count_msg = f"\n\n**✓ {len(annotations)} annotation(s) marked on image**\n\n"
+
                                 # Clean up the analysis text to remove JSON section
                                 # Keep only the analysis part
                                 if "ANALYSIS:" in analysis_text:
-                                    analysis_text = "ANALYSIS:\n" + analysis_text.split("ANALYSIS:")[1].strip()
+                                    analysis_text = annotation_count_msg + "ANALYSIS:\n" + analysis_text.split("ANALYSIS:")[1].strip()
                                 elif "SECTION 2" in analysis_text:
-                                    analysis_text = analysis_text.split("SECTION 2")[1].strip()
+                                    analysis_text = annotation_count_msg + analysis_text.split("SECTION 2")[1].strip()
                                     if analysis_text.startswith("- ANALYSIS:"):
                                         analysis_text = analysis_text[12:].strip()
+                            else:
+                                # Annotations array was empty
+                                analysis_text = "\n\n⚠️ **No annotations provided by AI model**\n\n" + analysis_text
 
                 return analysis_text, annotated_image
 
             except Exception as e:
-                # If annotation parsing fails, return original image with a note
-                return f"[Note: Annotation parsing failed: {str(e)}]\n\n{analysis_text}", image
+                # If annotation parsing fails, return original image with a detailed note
+                error_msg = f"""
+⚠️ **ANNOTATION MODE ERROR**
+
+The AI model's response could not be parsed for annotations. This usually happens when:
+- The model doesn't return properly formatted JSON
+- The ANNOTATIONS: section is missing or malformed
+- The coordinate values are invalid
+
+Error details: {str(e)}
+
+---
+
+**Original AI Response:**
+
+{analysis_text}
+"""
+                return error_msg, image
         else:
             return analysis_text, None
 
@@ -293,7 +332,7 @@ with gr.Blocks(title="SATINT Analyst - Satellite Imagery Analysis", theme=gr.the
                 choices=["text_only", "annotated"],
                 value="text_only",
                 label="Analysis Mode",
-                info="Text Only: Written analysis only | Annotated: Analysis with annotation descriptions"
+                info="Text Only: Written analysis only | Annotated: Analysis with numbered markers drawn on the image"
             )
 
             analyze_btn = gr.Button("Analyze Imagery", variant="primary", size="lg")