Update STARGATE_EXPANSION

STARGATE_EXPANSION

@@ -9,7 +9,7 @@ import json
 import glob
 from datetime import datetime
 from typing import List, Dict, Optional, Tuple
-from dataclasses import dataclass
+from dataclasses import dataclass, asdict  # Added asdict import
 import statistics
 from collections import Counter
 import matplotlib.pyplot as plt
@@ -430,37 +430,107 @@ def analyze_sessions_cli():
                        help='Generate metrics visualization')
     parser.add_argument('--trend-report', action='store_true',
                        help='Generate trend report')
+    parser.add_argument('--output-dir', default='.',
+                       help='Output directory for generated files')
     
     args = parser.parse_args()
     
     # Load sessions
     sessions = []
     for session_file in args.session_files:
-        with open(session_file, 'r') as f:
-            sessions.append(json.load(f))
+        try:
+            with open(session_file, 'r') as f:
+                sessions.append(json.load(f))
+            print(f"✓ Loaded {session_file}")
+        except Exception as e:
+            print(f"✗ Failed to load {session_file}: {e}")
+    
+    if not sessions:
+        print("No valid sessions loaded. Exiting.")
+        return
     
     analyzer = SessionAnalyzer(sessions)
     
     if args.trend_report:
+        print("\n" + "="*50)
+        print("SESSION TREND REPORT")
+        print("="*50)
         trends = analyzer.generate_trend_report()
-        print("\n=== SESSION TREND REPORT ===")
         for key, value in trends.items():
-            print(f"{key}: {value}")
+            print(f"{key.replace('_', ' ').title():<30}: {value:.3f}")
     
     if args.wordcloud:
+        print("\nGenerating word cloud...")
         all_impressions = []
         for session in sessions:
             all_impressions.extend(session['impressions'])
         
         visualizer = SessionVisualizer()
         fig = visualizer.generate_impression_wordcloud(all_impressions)
+        
+        output_path = f"{args.output_dir}/wordcloud_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png"
+        plt.savefig(output_path, dpi=300, bbox_inches='tight')
+        print(f"✓ Word cloud saved to: {output_path}")
         plt.show()
     
     if args.metrics_plot:
+        print("\nGenerating metrics visualization...")
         analyzer.analyze_all_sessions()
         visualizer = SessionVisualizer()
         fig = visualizer.plot_session_metrics(analyzer.metrics)
+        
+        output_path = f"{args.output_dir}/metrics_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png"
+        plt.savefig(output_path, dpi=300, bbox_inches='tight')
+        print(f"✓ Metrics plot saved to: {output_path}")
         plt.show()
 
+# ------------------------------------------------------------------------------------
+# Utility Functions
+# ------------------------------------------------------------------------------------
+
+def load_all_sessions(session_dir: str = ".") -> List[Dict]:
+    """Load all session JSON files from a directory"""
+    pattern = f"{session_dir}/stargate_session_*.json"
+    session_files = glob.glob(pattern)
+    sessions = []
+    
+    for session_file in session_files:
+        try:
+            with open(session_file, 'r') as f:
+                sessions.append(json.load(f))
+        except Exception as e:
+            print(f"Warning: Could not load {session_file}: {e}")
+    
+    return sessions
+
+def create_sample_targets():
+    """Create sample targets for testing"""
+    db = TargetDatabase("sample_targets.json")
+    
+    sample_targets = [
+        ("Tokyo_Tower", "coordinate", "Famous Tokyo landmark with distinctive red and white structure"),
+        ("Mars_Rover", "future", "Current operations of Perseverance rover on Mars surface"),
+        ("Pyramid_Giza", "symbol", "Great Pyramid of Giza interior chambers"),
+        ("Deep_Ocean", "coordinate", "Mariana Trench deepest point ecosystem"),
+        ("Tesla_Lab", "past", "Nikola Tesla's laboratory in Colorado Springs, 1899"),
+        ("Crop_Circle", "symbol", "Complex crop formation in English countryside"),
+    ]
+    
+    for identifier, category, description in sample_targets:
+        db.add_target(identifier, category, description)
+    
+    print("✓ Sample targets created in sample_targets.json")
+
 if __name__ == "__main__":
+    # If no arguments, show help and examples
+    if len(sys.argv) == 1:
+        print("Stargate Analysis Module")
+        print("\nUsage examples:")
+        print("  python stargate_analysis.py --session-files session1.json session2.json --trend-report")
+        print("  python stargate_analysis.py --session-files *.json --wordcloud --metrics-plot")
+        print("  python stargate_analysis.py --session-files recent_session.json --trend-report --output-dir ./reports")
+        print("\nTo create sample targets:")
+        print("  python -c \"from stargate_analysis import create_sample_targets; create_sample_targets()\"")
+        sys.exit(1)
+    
     analyze_sessions_cli()