fusesell 1.2.3__tar.gz → 1.2.5__tar.gz

{fusesell-1.2.3 → fusesell-1.2.5}/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to FuseSell Local will be documented in this file.
 
+# [1.2.5] - 2025-10-24
+
+### Added
+- Local `reminder_task` table and scheduler plumbing so scheduled outreach mirrors the server flow and can be consumed by RealTimeX orchestration.
+- Initial outreach and follow-up stages now emit reminder metadata whenever emails are scheduled, including team/customer context.
+
+### Changed
+- Event scheduler returns reminder IDs alongside scheduled events while preserving immutable default prompts when layering team overrides.
+
 # [1.2.3] - 2025-10-21
 
 ### Added

{fusesell-1.2.3/fusesell.egg-info → fusesell-1.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fusesell
-Version: 1.2.3
+Version: 1.2.5
 Summary: Local implementation of FuseSell AI sales automation pipeline
 Author-email: FuseSell Team <team@fusesell.ai>
 License-Expression: MIT
@@ -45,7 +45,9 @@ Dynamic: license-file
 
 FuseSell Local is a production-ready implementation of the FuseSell AI sales automation system, converted from server-based YAML workflows to a comprehensive Python command-line tool with full data ownership and privacy control.
 
-> Latest release: `fusesell==1.2.1` is available on PyPI via `pip install fusesell`.
+Latest release: `fusesell==1.2.1` is available on PyPI via `pip install fusesell`.
+
+Contributors should review the [Repository Guidelines](AGENTS.md) before opening a pull request.
 
 ## 🚀 Complete Pipeline Overview
 

{fusesell-1.2.3 → fusesell-1.2.5}/README.md

@@ -2,9 +2,11 @@
 
 **Complete AI-powered sales automation pipeline that runs entirely on your local machine.**
 
-FuseSell Local is a production-ready implementation of the FuseSell AI sales automation system, converted from server-based YAML workflows to a comprehensive Python command-line tool with full data ownership and privacy control.
-
-> Latest release: `fusesell==1.2.1` is available on PyPI via `pip install fusesell`.
+FuseSell Local is a production-ready implementation of the FuseSell AI sales automation system, converted from server-based YAML workflows to a comprehensive Python command-line tool with full data ownership and privacy control.
+
+Latest release: `fusesell==1.2.1` is available on PyPI via `pip install fusesell`.
+
+Contributors should review the [Repository Guidelines](AGENTS.md) before opening a pull request.
 
 ## 🚀 Complete Pipeline Overview
 

{fusesell-1.2.3 → fusesell-1.2.5/fusesell.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fusesell
-Version: 1.2.3
+Version: 1.2.5
 Summary: Local implementation of FuseSell AI sales automation pipeline
 Author-email: FuseSell Team <team@fusesell.ai>
 License-Expression: MIT
@@ -45,7 +45,9 @@ Dynamic: license-file
 
 FuseSell Local is a production-ready implementation of the FuseSell AI sales automation system, converted from server-based YAML workflows to a comprehensive Python command-line tool with full data ownership and privacy control.
 
-> Latest release: `fusesell==1.2.1` is available on PyPI via `pip install fusesell`.
+Latest release: `fusesell==1.2.1` is available on PyPI via `pip install fusesell`.
+
+Contributors should review the [Repository Guidelines](AGENTS.md) before opening a pull request.
 
 ## 🚀 Complete Pipeline Overview
 

{fusesell-1.2.3 → fusesell-1.2.5}/fusesell_local/__init__.py

@@ -32,6 +32,6 @@ __all__ = [
     "validate_config",
 ]
 
-__version__ = "1.2.3"
+__version__ = "1.2.5"
 __author__ = "FuseSell Team"
 __description__ = "Local implementation of FuseSell AI sales automation pipeline"

{fusesell-1.2.3 → fusesell-1.2.5}/fusesell_local/pipeline.py

@@ -251,11 +251,17 @@ class FuseSellPipeline:
                 
                 self.logger.info("-" * 40)
                 self.logger.info("TIMING VALIDATION:")
-                if discrepancy_percentage < 5.0:
-                    self.logger.info(f"✅ Timing validation PASSED (discrepancy: {discrepancy_percentage:.1f}%)")
-                else:
-                    self.logger.warning(f"⚠️  Timing validation WARNING (discrepancy: {discrepancy_percentage:.1f}%)")
-                    self.logger.warning(f"   Expected ~{total_stage_time:.2f}s, got {total_duration:.2f}s")
+                if discrepancy_percentage < 5.0:
+                    self.logger.info(
+                        f"[OK] Timing validation PASSED (discrepancy: {discrepancy_percentage:.1f}%)"
+                    )
+                else:
+                    self.logger.warning(
+                        f"[WARN] Timing validation WARNING (discrepancy: {discrepancy_percentage:.1f}%)"
+                    )
+                    self.logger.warning(
+                        f"   Expected ~{total_stage_time:.2f}s, got {total_duration:.2f}s"
+                    )
             
             self.logger.info("=" * 60)
             

{fusesell-1.2.3 → fusesell-1.2.5}/fusesell_local/stages/follow_up.py

@@ -877,22 +877,29 @@ Generate only the email content, no additional commentary:"""
             input_data = context.get('input_data', {})
             
             # Initialize event scheduler
-            scheduler = EventScheduler(self.config.get('data_dir', './fusesell_data'))
-            
-            # Check if immediate sending is requested
-            send_immediately = input_data.get('send_immediately', False)
-            
-            # Schedule the follow-up email event
-            schedule_result = scheduler.schedule_email_event(
-                draft_id=draft.get('draft_id'),
-                recipient_address=recipient_address,
-                recipient_name=recipient_name,
-                org_id=input_data.get('org_id', 'default'),
-                team_id=input_data.get('team_id'),
-                customer_timezone=input_data.get('customer_timezone'),
-                email_type='follow_up',
-                send_immediately=send_immediately
-            )
+            scheduler = EventScheduler(self.config.get('data_dir', './fusesell_data'))
+            
+            # Check if immediate sending is requested
+            send_immediately = input_data.get('send_immediately', False)
+            reminder_context = self._build_follow_up_reminder_context(
+                draft,
+                recipient_address,
+                recipient_name,
+                context
+            )
+            
+            # Schedule the follow-up email event
+            schedule_result = scheduler.schedule_email_event(
+                draft_id=draft.get('draft_id'),
+                recipient_address=recipient_address,
+                recipient_name=recipient_name,
+                org_id=input_data.get('org_id', 'default'),
+                team_id=input_data.get('team_id'),
+                customer_timezone=input_data.get('customer_timezone'),
+                email_type='follow_up',
+                send_immediately=send_immediately,
+                reminder_context=reminder_context
+            )
             
             if schedule_result['success']:
                 self.logger.info(f"Follow-up email event scheduled successfully: {schedule_result['event_id']} for {schedule_result['scheduled_time']}")
@@ -912,12 +919,81 @@ Generate only the email content, no additional commentary:"""
                 }
                 
         except Exception as e:
-            self.logger.error(f"Follow-up email scheduling failed: {str(e)}")
-            return {
-                'success': False,
-                'message': f'Follow-up email scheduling failed: {str(e)}',
-                'error': str(e)
-            } 
+            self.logger.error(f"Follow-up email scheduling failed: {str(e)}")
+            return {
+                'success': False,
+                'message': f'Follow-up email scheduling failed: {str(e)}',
+                'error': str(e)
+            } 
+
+    def _build_follow_up_reminder_context(
+        self,
+        draft: Dict[str, Any],
+        recipient_address: str,
+        recipient_name: str,
+        context: Dict[str, Any]
+    ) -> Dict[str, Any]:
+        """
+        Build reminder_task metadata for scheduled follow-up emails.
+        """
+        input_data = context.get('input_data', {})
+        org_id = input_data.get('org_id', 'default') or 'default'
+        customer_id = input_data.get('customer_id') or context.get('execution_id') or 'unknown'
+        task_id = context.get('execution_id') or input_data.get('task_id') or 'unknown_task'
+        team_id = input_data.get('team_id')
+        team_name = input_data.get('team_name')
+        language = input_data.get('language')
+        customer_name = input_data.get('customer_name')
+        staff_name = input_data.get('staff_name')
+        interaction_type = input_data.get('interaction_type', 'follow_up')
+        follow_up_iteration = input_data.get('current_follow_up_time') or 1
+        reminder_room = self.config.get('reminder_room_id') or input_data.get('reminder_room_id')
+        draft_id = draft.get('draft_id') or 'unknown_draft'
+        product_name = draft.get('product_name') or input_data.get('product_name')
+
+        customextra = {
+            'reminder_content': 'follow_up',
+            'org_id': org_id,
+            'customer_id': customer_id,
+            'task_id': task_id,
+            'customer_name': customer_name,
+            'language': language,
+            'recipient_address': recipient_address,
+            'recipient_name': recipient_name,
+            'staff_name': staff_name,
+            'team_id': team_id,
+            'team_name': team_name,
+            'interaction_type': interaction_type,
+            'action_status': 'scheduled',
+            'current_follow_up_time': follow_up_iteration,
+            'draft_id': draft_id,
+            'import_uuid': f"{org_id}_{customer_id}_{task_id}_{draft_id}"
+        }
+
+        if product_name:
+            customextra['product_name'] = product_name
+        if draft.get('approach'):
+            customextra['approach'] = draft.get('approach')
+        if draft.get('mail_tone'):
+            customextra['mail_tone'] = draft.get('mail_tone')
+        if draft.get('message_type'):
+            customextra['message_type'] = draft.get('message_type')
+
+        return {
+            'status': 'published',
+            'task': f"FuseSell follow-up {org_id}_{customer_id} - {task_id}",
+            'tags': ['fusesell', 'follow-up'],
+            'room_id': reminder_room,
+            'org_id': org_id,
+            'customer_id': customer_id,
+            'task_id': task_id,
+            'team_id': team_id,
+            'team_name': team_name,
+            'language': language,
+            'customer_name': customer_name,
+            'staff_name': staff_name,
+            'customextra': customextra
+        }
    # Data access methods (similar to initial outreach)
     def _get_customer_data(self, context: Dict[str, Any]) -> Dict[str, Any]:
         """Get customer data from previous stages or input."""

{fusesell-1.2.3 → fusesell-1.2.5}/fusesell_local/stages/initial_outreach.py

@@ -250,23 +250,30 @@ class InitialOutreachStage(BaseStage):
             
             input_data = context.get('input_data', {})
             
-            # Initialize event scheduler
-            scheduler = EventScheduler(self.config.get('data_dir', './fusesell_data'))
-            
-            # Check if immediate sending is requested
-            send_immediately = input_data.get('send_immediately', False)
-            
-            # Schedule the email event
-            schedule_result = scheduler.schedule_email_event(
-                draft_id=draft.get('draft_id'),
-                recipient_address=recipient_address,
-                recipient_name=recipient_name,
-                org_id=input_data.get('org_id', 'default'),
-                team_id=input_data.get('team_id'),
-                customer_timezone=input_data.get('customer_timezone'),
-                email_type='initial',
-                send_immediately=send_immediately
-            )
+            # Initialize event scheduler
+            scheduler = EventScheduler(self.config.get('data_dir', './fusesell_data'))
+            
+            # Check if immediate sending is requested
+            send_immediately = input_data.get('send_immediately', False)
+            reminder_context = self._build_initial_reminder_context(
+                draft,
+                recipient_address,
+                recipient_name,
+                context
+            )
+            
+            # Schedule the email event
+            schedule_result = scheduler.schedule_email_event(
+                draft_id=draft.get('draft_id'),
+                recipient_address=recipient_address,
+                recipient_name=recipient_name,
+                org_id=input_data.get('org_id', 'default'),
+                team_id=input_data.get('team_id'),
+                customer_timezone=input_data.get('customer_timezone'),
+                email_type='initial',
+                send_immediately=send_immediately,
+                reminder_context=reminder_context
+            )
             
             if schedule_result['success']:
                 self.logger.info(f"Email event scheduled successfully: {schedule_result['event_id']} for {schedule_result['scheduled_time']}")
@@ -287,18 +294,80 @@ class InitialOutreachStage(BaseStage):
                 }
                 
         except Exception as e:
-            self.logger.error(f"Email scheduling failed: {str(e)}")
-            return {
-                'success': False,
-                'message': f'Email scheduling failed: {str(e)}',
-                'error': str(e)
-            }
-
-    def _handle_close(self, context: Dict[str, Any]) -> Dict[str, Any]:
-        """
-        Handle close action - Close outreach when customer feels negative.
-        
-        Args:
+            self.logger.error(f"Email scheduling failed: {str(e)}")
+            return {
+                'success': False,
+                'message': f'Email scheduling failed: {str(e)}',
+                'error': str(e)
+            }
+
+    def _build_initial_reminder_context(
+        self,
+        draft: Dict[str, Any],
+        recipient_address: str,
+        recipient_name: str,
+        context: Dict[str, Any]
+    ) -> Dict[str, Any]:
+        """
+        Build reminder_task metadata for scheduled initial outreach emails.
+        """
+        input_data = context.get('input_data', {})
+        org_id = input_data.get('org_id', 'default') or 'default'
+        customer_id = input_data.get('customer_id') or context.get('execution_id') or 'unknown'
+        task_id = context.get('execution_id') or input_data.get('task_id') or 'unknown_task'
+        team_id = input_data.get('team_id')
+        team_name = input_data.get('team_name')
+        language = input_data.get('language')
+        customer_name = input_data.get('customer_name')
+        staff_name = input_data.get('staff_name')
+        reminder_room = self.config.get('reminder_room_id') or input_data.get('reminder_room_id')
+        draft_id = draft.get('draft_id') or 'unknown_draft'
+
+        customextra = {
+            'reminder_content': 'draft_send',
+            'org_id': org_id,
+            'customer_id': customer_id,
+            'task_id': task_id,
+            'customer_name': customer_name,
+            'language': language,
+            'recipient_address': recipient_address,
+            'recipient_name': recipient_name,
+            'staff_name': staff_name,
+            'team_id': team_id,
+            'team_name': team_name,
+            'interaction_type': input_data.get('interaction_type'),
+            'draft_id': draft_id,
+            'import_uuid': f"{org_id}_{customer_id}_{task_id}_{draft_id}"
+        }
+
+        if draft.get('product_name'):
+            customextra['product_name'] = draft.get('product_name')
+        if draft.get('approach'):
+            customextra['approach'] = draft.get('approach')
+        if draft.get('mail_tone'):
+            customextra['mail_tone'] = draft.get('mail_tone')
+
+        return {
+            'status': 'published',
+            'task': f"FuseSell initial outreach {org_id}_{customer_id} - {task_id}",
+            'tags': ['fusesell', 'init-outreach'],
+            'room_id': reminder_room,
+            'org_id': org_id,
+            'customer_id': customer_id,
+            'task_id': task_id,
+            'team_id': team_id,
+            'team_name': team_name,
+            'language': language,
+            'customer_name': customer_name,
+            'staff_name': staff_name,
+            'customextra': customextra
+        }
+
+    def _handle_close(self, context: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Handle close action - Close outreach when customer feels negative.
+        
+        Args:
             context: Execution context
             
         Returns:

{fusesell-1.2.3 → fusesell-1.2.5}/fusesell_local/utils/data_manager.py

@@ -4,10 +4,10 @@ Handles SQLite database operations and local file management
 """
 
 import sqlite3
-import json
-import os
-import uuid
-from typing import Dict, Any, List, Optional, Union
+import json
+import os
+import uuid
+from typing import Dict, Any, List, Optional, Sequence, Union
 from datetime import datetime
 import logging
 from pathlib import Path
@@ -454,11 +454,11 @@ class LocalDataManager:
                         submission_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
                         retrieved_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
                     )
-                """)
-
-                # Create scheduler_rules table (equivalent to gs_scheduler)
-                cursor.execute("""
-                    CREATE TABLE IF NOT EXISTS scheduler_rules (
+                """)
+
+                # Create scheduler_rules table (equivalent to gs_scheduler)
+                cursor.execute("""
+                    CREATE TABLE IF NOT EXISTS scheduler_rules (
                         id TEXT PRIMARY KEY,
                         org_id TEXT NOT NULL,
                         org_name TEXT,
@@ -478,14 +478,36 @@ class LocalDataManager:
                         username TEXT,
                         fullname TEXT,
                         instance_id TEXT,
-                        submission_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-                    )
-                """)
-
-                # Create extracted_files table (equivalent to gs_plan_setting_extracted_file)
-                cursor.execute("""
-                    CREATE TABLE IF NOT EXISTS extracted_files (
-                        id TEXT PRIMARY KEY,
+                        submission_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+                    )
+                """)
+
+                # Create reminder_task table (equivalent to Directus reminder_task)
+                cursor.execute("""
+                    CREATE TABLE IF NOT EXISTS reminder_task (
+                        id TEXT PRIMARY KEY,
+                        status TEXT NOT NULL,
+                        task TEXT NOT NULL,
+                        cron TEXT NOT NULL,
+                        room_id TEXT,
+                        tags TEXT,
+                        customextra TEXT,
+                        org_id TEXT,
+                        customer_id TEXT,
+                        task_id TEXT,
+                        import_uuid TEXT,
+                        scheduled_time TIMESTAMP,
+                        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+                        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+                        executed_at TIMESTAMP,
+                        error_message TEXT
+                    )
+                """)
+
+                # Create extracted_files table (equivalent to gs_plan_setting_extracted_file)
+                cursor.execute("""
+                    CREATE TABLE IF NOT EXISTS extracted_files (
+                        id TEXT PRIMARY KEY,
                         org_id TEXT NOT NULL,
                         plan_id TEXT,
                         team_id TEXT,
@@ -585,17 +607,25 @@ class LocalDataManager:
                     "CREATE INDEX IF NOT EXISTS idx_team_settings_team_id ON team_settings(team_id)")
                 cursor.execute(
                     "CREATE INDEX IF NOT EXISTS idx_products_org_id ON products(org_id)")
-                cursor.execute(
-                    "CREATE INDEX IF NOT EXISTS idx_gs_customer_llmtask_task_id ON gs_customer_llmtask(task_id)")
-                cursor.execute(
-                    "CREATE INDEX IF NOT EXISTS idx_prompts_org_id ON prompts(org_id)")
-                cursor.execute(
-                    "CREATE INDEX IF NOT EXISTS idx_scheduler_rules_org_id ON scheduler_rules(org_id)")
-                cursor.execute(
-                    "CREATE INDEX IF NOT EXISTS idx_extracted_files_org_id ON extracted_files(org_id)")
-                cursor.execute(
-                    "CREATE INDEX IF NOT EXISTS idx_llm_worker_plan_org_id ON llm_worker_plan(org_id)")
-                cursor.execute(
+                cursor.execute(
+                    "CREATE INDEX IF NOT EXISTS idx_gs_customer_llmtask_task_id ON gs_customer_llmtask(task_id)")
+                cursor.execute(
+                    "CREATE INDEX IF NOT EXISTS idx_prompts_org_id ON prompts(org_id)")
+                cursor.execute(
+                    "CREATE INDEX IF NOT EXISTS idx_scheduler_rules_org_id ON scheduler_rules(org_id)")
+                cursor.execute(
+                    "CREATE INDEX IF NOT EXISTS idx_reminder_task_status ON reminder_task(status)")
+                cursor.execute(
+                    "CREATE INDEX IF NOT EXISTS idx_reminder_task_org_id ON reminder_task(org_id)")
+                cursor.execute(
+                    "CREATE INDEX IF NOT EXISTS idx_reminder_task_task_id ON reminder_task(task_id)")
+                cursor.execute(
+                    "CREATE INDEX IF NOT EXISTS idx_reminder_task_cron ON reminder_task(cron)")
+                cursor.execute(
+                    "CREATE INDEX IF NOT EXISTS idx_extracted_files_org_id ON extracted_files(org_id)")
+                cursor.execute(
+                    "CREATE INDEX IF NOT EXISTS idx_llm_worker_plan_org_id ON llm_worker_plan(org_id)")
+                cursor.execute(
                     "CREATE INDEX IF NOT EXISTS idx_gs_company_criteria_org_id ON gs_company_criteria(org_id)")
 
                 # Create compatibility views for backward compatibility
@@ -1408,6 +1438,162 @@ class LocalDataManager:
             self.logger.error(f"Failed to get team settings: {str(e)}")
             raise
 
+    def build_team_settings_snapshot(
+        self,
+        team_id: str,
+        sections: Optional[Sequence[str]] = None
+    ) -> Dict[str, Any]:
+        """
+        Build a response payload containing team settings in the expected RealTimeX format.
+
+        Args:
+            team_id: Team identifier
+            sections: Optional sequence of section names to include. Accepts either
+                full keys (e.g. ``gs_team_product``) or shorthand without the prefix.
+
+        Returns:
+            Dictionary shaped as ``{"data": [{...}]}``. When no settings exist,
+            returns ``{"data": []}``.
+        """
+        settings = self.get_team_settings(team_id)
+        if not settings:
+            return {"data": []}
+
+        available_fields = [
+            'gs_team_organization',
+            'gs_team_rep',
+            'gs_team_product',
+            'gs_team_schedule_time',
+            'gs_team_initial_outreach',
+            'gs_team_follow_up',
+            'gs_team_auto_interaction',
+            'gs_team_followup_schedule_time',
+            'gs_team_birthday_email',
+        ]
+
+        if sections:
+            normalized = set()
+            for item in sections:
+                if not item:
+                    continue
+                item = item.strip()
+                if not item:
+                    continue
+                if item.startswith("gs_team_"):
+                    normalized.add(item)
+                else:
+                    normalized.add(f"gs_team_{item}")
+            fields_to_include = [field for field in available_fields if field in normalized]
+        else:
+            fields_to_include = available_fields
+
+        list_like_fields = {
+            'gs_team_organization',
+            'gs_team_rep',
+            'gs_team_product',
+            'gs_team_auto_interaction',
+        }
+        list_field_defaults = {
+            'gs_team_organization': {
+                'org_name': None,
+                'address': None,
+                'website': None,
+                'industry': None,
+                'description': None,
+                'logo': None,
+                'primary_email': None,
+                'primary_phone': None,
+                'primary_color': None,
+                'is_active': False,
+                'avg_rating': None,
+                'total_sales': None,
+                'total_products': None,
+                'date_joined': None,
+                'last_active': None,
+                'social_media_links': [],
+            },
+            'gs_team_rep': {
+                'name': None,
+                'email': None,
+                'phone': None,
+                'position': None,
+                'website': None,
+                'logo': None,
+                'username': None,
+                'is_primary': False,
+                'primary_color': None,
+                'primary_phone': None,
+            },
+            'gs_team_product': {
+                'product_id': None,
+                'product_name': None,
+                'image_url': None,
+                'enabled': True,
+                'priority': None,
+            },
+            'gs_team_auto_interaction': {
+                'from_email': '',
+                'from_name': '',
+                'from_number': '',
+                'tool_type': 'Email',
+                'email_cc': '',
+                'email_bcc': '',
+            },
+        }
+        alias_fields = {
+            'gs_team_organization': {
+                'name': 'org_name',
+                'brand_palette': 'primary_color',
+            },
+        }
+
+        snapshot: Dict[str, Any] = {}
+        for field in fields_to_include:
+            value = settings.get(field)
+            if value is None:
+                continue
+
+            if field in list_like_fields:
+                if isinstance(value, list):
+                    normalized_items = []
+                    defaults = list_field_defaults.get(field, {})
+                    aliases = alias_fields.get(field, {})
+                    for item in value:
+                        if not isinstance(item, dict):
+                            continue
+                        normalized = {}
+                        for key, default_val in defaults.items():
+                            if key == 'social_media_links':
+                                current = item.get(key)
+                                normalized[key] = current if isinstance(current, list) else []
+                            else:
+                                normalized[key] = item.get(key, default_val)
+                        for legacy_key, target_key in aliases.items():
+                            if normalized.get(target_key) in (None, '', []):
+                                if legacy_key in item:
+                                    normalized[target_key] = item[legacy_key]
+                        # include any additional keys that might exist
+                        normalized_items.append(normalized)
+                    snapshot[field] = normalized_items
+                elif value:
+                    defaults = list_field_defaults.get(field, {})
+                    aliases = alias_fields.get(field, {})
+                    normalized = {key: value.get(key, default_val) for key, default_val in defaults.items()}
+                    for legacy_key, target_key in aliases.items():
+                        if normalized.get(target_key) in (None, '', []):
+                            if legacy_key in value:
+                                normalized[target_key] = value[legacy_key]
+                    snapshot[field] = [normalized]
+                else:
+                    snapshot[field] = []
+            else:
+                snapshot[field] = value
+
+        if not snapshot:
+            return {"data": []}
+
+        return {"data": [snapshot]}
+
     def _deserialize_product_row(self, row: sqlite3.Row) -> Dict[str, Any]:
         """
         Convert a product row into a dictionary with JSON fields parsed.