x-ipe 1.0.24__py3-none-any.whl → 1.0.25__py3-none-any.whl

x_ipe/services/file_service.py

@@ -1,5 +1,7 @@
 """
 FEATURE-001: Project Navigation
+FEATURE-002: Content Viewer
+FEATURE-003: Content Editor
 
 FileNode: Represents a file or folder in the project structure
 Section: Represents a top-level section in the sidebar
@@ -16,6 +18,8 @@ from dataclasses import dataclass
 from watchdog.observers import Observer
 from watchdog.events import FileSystemEventHandler, FileSystemEvent
 
+from x_ipe.tracing import x_ipe_tracing
+
 
 @dataclass
 class FileNode:
@@ -96,6 +100,12 @@ class ProjectService:
             'path': 'x-ipe-docs/requirements',
             'icon': 'bi-file-text'
         },
+        {
+            'id': 'skill-meta',
+            'label': 'Skill Meta',
+            'path': 'x-ipe-docs/skill-meta',
+            'icon': 'bi-stars'
+        },
         {
             'id': 'code',
             'label': 'Code',
@@ -121,6 +131,7 @@ class ProjectService:
         self.project_root = Path(project_root).resolve()
         self.sections_config = sections or self.DEFAULT_SECTIONS
 
+    @x_ipe_tracing(level="INFO")
     def get_structure(self) -> Dict[str, Any]:
         """
         Get the complete project structure for sidebar navigation.
@@ -155,6 +166,7 @@ class ProjectService:
             'sections': sections
         }
 
+    @x_ipe_tracing(level="DEBUG")
     def _scan_directory(self, directory: Path, relative_base: str) -> List[FileNode]:
         """
         Recursively scan a directory and build file tree.
@@ -323,6 +335,7 @@ class FileWatcher:
         self._running = False
         self.ignore_patterns = self._load_gitignore()
 
+    @x_ipe_tracing(level="DEBUG")
     def _load_gitignore(self) -> List[str]:
         """Load and parse .gitignore patterns."""
         gitignore_path = self.project_root / '.gitignore'
@@ -341,6 +354,7 @@ class FileWatcher:
         
         return patterns
 
+    @x_ipe_tracing(level="DEBUG")
     def _emit_event(self, event_data: Dict):
         """Emit file system event via WebSocket"""
         if self.socketio:
@@ -363,6 +377,7 @@ class FileWatcher:
             }
             self.socketio.emit('content_changed', content_event)
 
+    @x_ipe_tracing(level="INFO")
     def start(self):
         """Start watching project directories"""
         if self._running:
@@ -381,6 +396,7 @@ class FileWatcher:
         self.observer.start()
         self._running = True
 
+    @x_ipe_tracing(level="INFO")
     def stop(self):
         """Stop watching"""
         if self.observer and self._running:
@@ -433,6 +449,7 @@ class ContentService:
         """
         self.project_root = Path(project_root).resolve()
 
+    @x_ipe_tracing(level="DEBUG")
     def detect_file_type(self, extension: str) -> str:
         """
         Detect file type from extension.
@@ -445,6 +462,7 @@ class ContentService:
         """
         return self.FILE_TYPES.get(extension.lower(), 'text')
 
+    @x_ipe_tracing(level="INFO")
     def get_content(self, relative_path: str) -> Dict[str, Any]:
         """
         Get file content with metadata.
@@ -487,6 +505,7 @@ class ContentService:
             'size': size
         }
 
+    @x_ipe_tracing(level="DEBUG")
     def _validate_path_for_write(self, relative_path: str) -> tuple:
         """
         Validate a path for write operations.
@@ -543,6 +562,7 @@ class ContentService:
         
         return (True, full_path)
 
+    @x_ipe_tracing(level="INFO")
     def save_content(self, relative_path: str, content: str) -> Dict[str, Any]:
         """
         Save content to a file.

x_ipe/services/homepage_service.py

@@ -0,0 +1,160 @@
+"""
+Homepage Service
+FEATURE-026: Homepage Infinity Loop
+
+Provides stage mapping configuration and template generation
+for the interactive homepage infinity loop visualization.
+"""
+from x_ipe.services.tracing_service import x_ipe_tracing
+
+
+class HomepageService:
+    """Service for homepage infinity loop functionality"""
+    
+    # Stage-to-sidebar mapping configuration
+    STAGE_MAPPING = {
+        'ideation': {
+            'icon': '💡',
+            'label': 'IDEATION',
+            'theme': 'control',
+            'status': 'ready',
+            'section': 'workplace',
+            'selector': '[data-path="x-ipe-docs/ideas"]',
+            'position': {'left': '4.5%', 'top': '60%'}
+        },
+        'requirement': {
+            'icon': '📋',
+            'label': 'REQUIREMENT',
+            'theme': 'control',
+            'status': 'ready',
+            'section': 'project',
+            'selector': '[data-path="x-ipe-docs/requirements"]',
+            'position': {'left': '12%', 'top': '12%'}
+        },
+        'implementation': {
+            'icon': '⚙️',
+            'label': 'IMPLEMENT',
+            'theme': 'control',
+            'status': 'ready',
+            'section': 'project',
+            'selector': '[data-path="x-ipe-docs/requirements"]',
+            'position': {'left': '30%', 'top': '73%'}
+        },
+        'deployment': {
+            'icon': '🚀',
+            'label': 'DEPLOY',
+            'theme': 'control',
+            'status': 'tbd',
+            'section': 'management',
+            'selector': None,
+            'position': {'left': '56%', 'top': '19%'}
+        },
+        'validation': {
+            'icon': '✅',
+            'label': 'VALIDATION',
+            'theme': 'transparency',
+            'status': 'ready',
+            'section': 'quality',
+            'selector': '[data-section="quality-report"]',
+            'position': {'left': '80%', 'top': '13%'}
+        },
+        'monitoring': {
+            'icon': '📊',
+            'label': 'MONITORING',
+            'theme': 'transparency',
+            'status': 'ready',
+            'section': 'quality',
+            'selector': '[data-section="behavior-tracing"]',
+            'position': {'left': '85%', 'top': '65%'}
+        },
+        'feedback': {
+            'icon': '💬',
+            'label': 'FEEDBACK',
+            'theme': 'transparency',
+            'status': 'ready',
+            'section': 'feedback',
+            'selector': '[data-section="uiux-feedback"]',
+            'position': {'left': '58%', 'top': '70%'}
+        },
+        'planning': {
+            'icon': '📅',
+            'label': 'PLANNING',
+            'theme': 'transparency',
+            'status': 'ready',
+            'section': 'management',
+            'selector': '[data-path="x-ipe-docs/planning"]',
+            'position': {'left': '38%', 'top': '25%'}
+        }
+    }
+    
+    @x_ipe_tracing(level="INFO")
+    def get_stage_mapping(self) -> dict:
+        """
+        Get the stage-to-sidebar mapping configuration.
+        
+        Returns:
+            dict: Stage mapping with icons, labels, themes, selectors, and positions
+        """
+        return self.STAGE_MAPPING.copy()
+    
+    @x_ipe_tracing(level="INFO")
+    def get_template(self) -> str:
+        """
+        Generate HTML template for homepage infinity loop.
+        
+        Returns:
+            str: HTML template string
+        """
+        stage_buttons = self._render_stage_buttons()
+        
+        return f'''
+<div class="homepage-infinity-container">
+    <header class="homepage-header">
+        <h1>X-IPE</h1>
+        <p>AI-Powered Development Lifecycle</p>
+    </header>
+    
+    <div class="infinity-loop-container">
+        <div class="infinity-loop">
+            <img src="/api/file/content?path=x-ipe-docs%2Fideas%2FTBC008.%20Feature-Homepage%2FControl%26Transparency.png&raw=true" 
+                 alt="Development Lifecycle" 
+                 class="infinity-bg"
+                 onerror="this.style.display='none'">
+            
+            {stage_buttons}
+            
+            <span class="loop-label control">CONTROL</span>
+            <span class="loop-label transparency">TRANSPARENCY</span>
+        </div>
+    </div>
+    
+    <footer class="homepage-legend">
+        <span>Control (What we decide)</span>
+        <span>Transparency (What we see)</span>
+    </footer>
+</div>
+'''
+    
+    def _render_stage_buttons(self) -> str:
+        """Render HTML for all stage buttons"""
+        buttons = []
+        for stage_id, config in self.STAGE_MAPPING.items():
+            tbd_class = ' tbd' if config['status'] == 'tbd' else ''
+            tbd_attr = ' data-tbd="true"' if config['status'] == 'tbd' else ''
+            tbd_badge = '<span class="tbd-badge">TBD</span>' if config['status'] == 'tbd' else ''
+            
+            button = f'''
+            <button class="stage-btn {config['theme']}{tbd_class}"
+                    data-stage="{stage_id}"
+                    data-section="{config['section']}"
+                    data-selector="{config['selector'] or ''}"
+                    style="left: {config['position']['left']}; top: {config['position']['top']};"
+                    {tbd_attr}>
+                <span class="stage-icon">{config['icon']}</span>
+                <span class="stage-label">{config['label']}</span>
+                {tbd_badge}
+            </button>
+'''
+            buttons.append(button)
+        
+        return '\n'.join(buttons)

x_ipe/services/ideas_service.py

@@ -11,6 +11,8 @@ from datetime import datetime
 from pathlib import Path
 from typing import Dict, List, Any
 
+from x_ipe.tracing import x_ipe_tracing
+
 
 class IdeasService:
     """
@@ -48,6 +50,7 @@ class IdeasService:
         self.project_root = Path(project_root).resolve()
         self.ideas_root = self.project_root / self.IDEAS_PATH
     
+    @x_ipe_tracing()
     def get_tree(self) -> List[Dict]:
         """
         Scan x-ipe-docs/ideas/ and return tree structure.
@@ -93,6 +96,7 @@ class IdeasService:
         
         return items
     
+    @x_ipe_tracing()
     def upload(self, files: List[tuple], date: str = None, target_folder: str = None) -> Dict[str, Any]:
         """
         Upload files to a new or existing idea folder.
@@ -155,6 +159,7 @@ class IdeasService:
             'files_uploaded': uploaded_files
         }
     
+    @x_ipe_tracing()
     def create_folder(self, folder_name: str, parent_folder: str = None) -> Dict[str, Any]:
         """
         Create an empty folder in ideas directory.
@@ -220,6 +225,7 @@ class IdeasService:
             'folder_path': relative_path
         }
     
+    @x_ipe_tracing()
     def rename_folder(self, old_name: str, new_name: str) -> Dict[str, Any]:
         """
         Rename an idea folder.
@@ -272,6 +278,7 @@ class IdeasService:
             'new_path': f'{self.IDEAS_PATH}/{final_name}'
         }
     
+    @x_ipe_tracing()
     def rename_file(self, file_path: str, new_name: str) -> Dict[str, Any]:
         """
         Rename a file within x-ipe-docs/ideas/.
@@ -398,6 +405,7 @@ class IdeasService:
         
         return name
     
+    @x_ipe_tracing()
     def delete_item(self, path: str) -> Dict[str, Any]:
         """
         Delete a file or folder within x-ipe-docs/ideas/.
@@ -458,6 +466,7 @@ class IdeasService:
                 'error': f'Failed to delete: {str(e)}'
             }
     
+    @x_ipe_tracing()
     def get_next_version_number(self, folder_path: str, base_name: str = 'idea-summary') -> int:
         """
         Get the next version number for a versioned file.
@@ -486,6 +495,7 @@ class IdeasService:
         
         return max_version + 1
     
+    @x_ipe_tracing()
     def create_versioned_summary(self, folder_path: str, content: str, base_name: str = 'idea-summary') -> Dict[str, Any]:
         """
         Create a new versioned idea summary file.
@@ -544,6 +554,7 @@ class IdeasService:
                 'error': f'Failed to create file: {str(e)}'
             }
     
+    @x_ipe_tracing()
     def get_toolbox(self) -> Dict:
         """
         Read toolbox configuration from JSON file.
@@ -561,6 +572,7 @@ class IdeasService:
                 return copy.deepcopy(self.DEFAULT_TOOLBOX)
         return copy.deepcopy(self.DEFAULT_TOOLBOX)
     
+    @x_ipe_tracing()
     def save_toolbox(self, config: Dict) -> Dict:
         """
         Save toolbox configuration to JSON file.
@@ -587,6 +599,7 @@ class IdeasService:
     # CR-006: Folder Tree UX Enhancement
     # =========================================================================
     
+    @x_ipe_tracing()
     def move_item(self, source_path: str, target_folder: str) -> Dict[str, Any]:
         """
         Move file or folder to target folder.
@@ -657,6 +670,7 @@ class IdeasService:
         except OSError as e:
             return {'success': False, 'error': f'Failed to move: {str(e)}'}
     
+    @x_ipe_tracing()
     def duplicate_item(self, path: str) -> Dict[str, Any]:
         """
         Duplicate file or folder with -copy suffix.
@@ -729,6 +743,7 @@ class IdeasService:
         new_path = str(copy_path.relative_to(self.ideas_root))
         return {'success': True, 'new_path': new_path}
     
+    @x_ipe_tracing()
     def get_folder_contents(self, folder_path: str) -> Dict[str, Any]:
         """
         Get contents of a specific folder for folder view panel.
@@ -793,6 +808,7 @@ class IdeasService:
         folder_path_result = str(full_path.relative_to(self.project_root)) if full_path != self.ideas_root else self.IDEAS_PATH
         return {'success': True, 'items': items, 'folder_path': folder_path_result}
     
+    @x_ipe_tracing()
     def is_valid_drop_target(self, source_path: str, target_folder: str) -> bool:
         """
         Validate that target is not source or child of source.
@@ -837,6 +853,7 @@ class IdeasService:
         
         return True
     
+    @x_ipe_tracing()
     def filter_tree(self, query: str) -> List[Dict]:
         """
         Filter tree by search query, returning matching items with parent context.
@@ -890,6 +907,7 @@ class IdeasService:
         
         return any_match
     
+    @x_ipe_tracing()
     def get_download_info(self, path: str) -> Dict[str, Any]:
         """
         Get file content and mime type for download.
@@ -962,6 +980,7 @@ class IdeasService:
         except OSError as e:
             return {'success': False, 'error': f'Failed to read file: {str(e)}'}
     
+    @x_ipe_tracing()
     def get_delete_info(self, path: str) -> Dict[str, Any]:
         """
         Get item info for delete confirmation dialog.