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

x_ipe/routes/uiux_feedback_routes.py

@@ -5,12 +5,62 @@ API routes for submitting UI/UX feedback.
 """
 from flask import Blueprint, request, jsonify, current_app
 from ..services.uiux_feedback_service import UiuxFeedbackService
+from x_ipe.tracing import x_ipe_tracing
 
 
 uiux_feedback_bp = Blueprint('uiux_feedback', __name__)
 
 
+@uiux_feedback_bp.route('/api/uiux-feedback', methods=['GET'])
+@x_ipe_tracing()
+def list_feedback():
+    """
+    List recent feedback entries.
+    
+    Query params:
+        days: Number of days to look back (default 2)
+    
+    Returns:
+        200: {"entries": [...]}
+    """
+    project_root = current_app.config.get('PROJECT_ROOT', '.')
+    days = request.args.get('days', 2, type=int)
+    
+    service = UiuxFeedbackService(project_root)
+    entries = service.list_feedback(days=days)
+    
+    return jsonify({'entries': entries}), 200
+
+
+@uiux_feedback_bp.route('/api/uiux-feedback/<feedback_id>', methods=['DELETE'])
+@x_ipe_tracing()
+def delete_feedback(feedback_id):
+    """
+    Delete a feedback entry by ID.
+    
+    Path params:
+        feedback_id: The feedback folder name/ID
+    
+    Returns:
+        200: {"success": true}
+        404: {"success": false, "error": "Feedback not found"}
+        500: {"success": false, "error": "..."}
+    """
+    project_root = current_app.config.get('PROJECT_ROOT', '.')
+    
+    service = UiuxFeedbackService(project_root)
+    result = service.delete_feedback(feedback_id)
+    
+    if result['success']:
+        return jsonify(result), 200
+    elif 'not found' in result.get('error', '').lower():
+        return jsonify(result), 404
+    else:
+        return jsonify(result), 500
+
+
 @uiux_feedback_bp.route('/api/uiux-feedback', methods=['POST'])
+@x_ipe_tracing()
 def submit_feedback():
     """
     Submit UI/UX feedback entry.

x_ipe/services/__init__.py

@@ -26,6 +26,9 @@ from .file_service import (
 # Ideas Service (FEATURE-008)
 from .ideas_service import IdeasService
 
+# KB Service (FEATURE-025-A)
+from .kb_service import KBService
+
 # Terminal Service (FEATURE-005)
 from .terminal_service import (
     OutputBuffer,
@@ -80,6 +83,8 @@ __all__ = [
     'ContentService',
     # Ideas
     'IdeasService',
+    # KB
+    'KBService',
     # Terminal
     'OutputBuffer',
     'PersistentSession',

x_ipe/services/config_service.py

@@ -10,6 +10,8 @@ from pathlib import Path
 from typing import Optional
 from dataclasses import dataclass
 
+from x_ipe.tracing import x_ipe_tracing
+
 
 CONFIG_FILE_NAME = '.x-ipe.yaml'
 MAX_PARENT_LEVELS = 20
@@ -31,14 +33,17 @@ class ConfigData:
     file_tree_scope: str
     terminal_cwd: str
     
+    @x_ipe_tracing()
     def get_file_tree_path(self) -> str:
         """Return the path for file tree based on file_tree_scope."""
         return self.project_root if self.file_tree_scope == "project_root" else self.x_ipe_app
     
+    @x_ipe_tracing()
     def get_terminal_cwd(self) -> str:
         """Return the path for terminal cwd based on terminal_cwd setting."""
         return self.project_root if self.terminal_cwd == "project_root" else self.x_ipe_app
     
+    @x_ipe_tracing()
     def to_dict(self) -> dict:
         """Convert to dictionary for API response."""
         return {
@@ -74,6 +79,7 @@ class ConfigService:
         self._config_data: Optional[ConfigData] = None
         self._error: Optional[str] = None
     
+    @x_ipe_tracing()
     def load(self) -> Optional[ConfigData]:
         """
         Discover, parse, and validate config file.

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)