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

x_ipe/resources/skills/x-ipe-task-based-ideation/references/visualization-guide.md

@@ -0,0 +1,160 @@
+# Visualization Guide
+
+This reference document describes how to use visualization tools in idea summaries.
+
+---
+
+## Config-Driven Visualization
+
+Check `x-ipe-docs/config/tools.json` before choosing visualization method:
+
+```yaml
+decision_tree:
+  - check: "config.stages.ideation.ideation.antv-infographic"
+    if_true: "Use infographic DSL"
+    use_for: "Feature lists, roadmaps, comparisons"
+    
+  - check: "config.stages.ideation.ideation.mermaid"
+    if_true: "Use mermaid diagrams"
+    use_for: "Flowcharts, sequences, state diagrams"
+    
+  - check: "config.stages.ideation.ideation.tool-architecture-dsl"
+    if_true: "Use architecture DSL"
+    use_for: "Layered architecture, module views"
+    
+  - fallback: "Use standard markdown"
+    use_for: "Bullet lists, tables"
+```
+
+---
+
+## Infographic Templates
+
+| Use Case | Template | When to Use |
+|----------|----------|-------------|
+| Feature List | `list-grid-badge-card` | Listing key features with icons |
+| Roadmap | `sequence-roadmap-vertical-simple` | Implementation phases |
+| Comparison | `compare-binary-horizontal-badge-card-arrow` | Comparing options |
+
+### Feature List Example
+
+```infographic
+infographic list-grid-badge-card
+data
+  title Key Features
+  lists
+    - label Feature 1
+      desc Description of feature 1
+      icon flash
+    - label Feature 2
+      desc Description of feature 2
+      icon shield
+```
+
+### Roadmap Example
+
+```infographic
+infographic sequence-roadmap-vertical-simple
+data
+  title Implementation Phases
+  lists
+    - label Phase 1
+      desc MVP with core features
+    - label Phase 2
+      desc User feedback integration
+    - label Phase 3
+      desc Scale and optimize
+```
+
+---
+
+## Mermaid Diagrams
+
+| Use Case | Diagram Type | When to Use |
+|----------|--------------|-------------|
+| User Flow | flowchart | Step-by-step user journey |
+| Process | sequenceDiagram | System interactions |
+| States | stateDiagram | State transitions |
+
+### Flowchart Example
+
+```mermaid
+flowchart TD
+    A[User Action] --> B[Feature 1]
+    B --> C[Feature 2]
+    C --> D[Result]
+```
+
+### Sequence Example
+
+```mermaid
+sequenceDiagram
+    User->>App: Request
+    App->>API: Process
+    API-->>App: Response
+    App-->>User: Display
+```
+
+---
+
+## Architecture DSL
+
+Use for layered architecture when `tool-architecture-dsl` is enabled:
+
+```architecture-dsl
+@startuml module-view
+title "System Architecture"
+theme "theme-default"
+direction top-to-bottom
+grid 12 x 6
+
+layer "Frontend" {
+  color "#fce7f3"
+  border-color "#ec4899"
+  rows 2
+  module "Web" { cols 12, rows 2, grid 1 x 1, component "React App" { cols 1, rows 1 } }
+}
+
+layer "Backend" {
+  color "#dbeafe"
+  border-color "#3b82f6"
+  rows 2
+  module "Services" { cols 12, rows 2, grid 2 x 1, component "API" { cols 1, rows 1 }, component "Workers" { cols 1, rows 1 } }
+}
+
+@enduml
+```
+
+---
+
+## Fallback (No Tools Enabled)
+
+When all visualization tools are disabled, use standard markdown:
+
+### Feature List (Fallback)
+```markdown
+## Key Features
+
+- **Feature 1:** Description of feature 1
+- **Feature 2:** Description of feature 2
+- **Feature 3:** Description of feature 3
+```
+
+### Comparison (Fallback)
+```markdown
+| Option | Pros | Cons |
+|--------|------|------|
+| Option A | Fast, cheap | Limited features |
+| Option B | Full features | Slower, expensive |
+```
+
+### Process (Fallback)
+```markdown
+## Process Flow
+
+1. User logs in
+2. Dashboard loads
+3. User selects action
+4. System processes
+5. Result displayed
+```

x_ipe/resources/skills/x-ipe-task-based-ideation/templates/idea-summary.md

@@ -0,0 +1,86 @@
+# Idea Summary Template
+
+> Use this template when creating `idea-summary-vN.md` files.
+
+```markdown
+# Idea Summary
+
+> Idea ID: IDEA-XXX
+> Folder: {folder_name}
+> Version: vN
+> Created: {date}
+> Status: Refined
+
+## Overview
+{Brief description of the refined idea}
+
+## Problem Statement
+{What problem does this idea solve?}
+
+## Target Users
+{Who will benefit?}
+
+## Proposed Solution
+{High-level description of the solution}
+
+## Key Features
+
+{IF antv-infographic enabled → use infographic DSL}
+{IF mermaid enabled → use mermaid for flow}
+{IF both disabled → use bullet list}
+
+<!-- Example if antv-infographic: true -->
+```infographic
+infographic list-grid-badge-card
+data
+  title Key Features
+  lists
+    - label Feature 1
+      desc Description of feature 1
+      icon flash
+    - label Feature 2
+      desc Description of feature 2
+      icon shield
+```
+
+<!-- Example if mermaid: true (for user flow) -->
+```mermaid
+flowchart TD
+  A[User Action] --> B[Feature 1]
+  B --> C[Feature 2]
+```
+
+## Success Criteria
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+## Constraints & Considerations
+- Constraint 1
+- Constraint 2
+
+## Brainstorming Notes
+{Key insights from brainstorming session}
+
+## Ideation Artifacts (If Tools Used)
+{Link to any mockups, prototypes, or visual artifacts created during brainstorming}
+- Mockup: {path or description}
+- Prototype: {path or URL}
+
+## Source Files
+- file1.md
+- file2.txt
+
+## Next Steps
+- [ ] Proceed to Idea Mockup / Idea to Architecture / Requirement Gathering
+
+## References & Common Principles
+{Include if the idea involves common/established topics}
+
+### Applied Principles
+- **Principle 1:** {Description} - [Source](URL)
+- **Principle 2:** {Description} - [Source](URL)
+
+### Further Reading
+- [Resource 1](URL) - {Brief description}
+- [Resource 2](URL) - {Brief description}
+```

x_ipe/routes/__init__.py

@@ -10,6 +10,7 @@ from .project_routes import project_bp
 from .ideas_routes import ideas_bp
 from .tools_routes import tools_bp
 from .proxy_routes import proxy_bp
+from .kb_routes import kb_bp
 
 __all__ = [
     'main_bp',
@@ -18,4 +19,5 @@ __all__ = [
     'ideas_bp',
     'tools_bp',
     'proxy_bp',
+    'kb_bp',
 ]

x_ipe/routes/ideas_routes.py

@@ -15,11 +15,13 @@ import os
 from flask import Blueprint, jsonify, request, current_app
 
 from x_ipe.services import IdeasService, SkillsService
+from x_ipe.tracing import x_ipe_tracing
 
 ideas_bp = Blueprint('ideas', __name__)
 
 
 @ideas_bp.route('/api/ideas/tree', methods=['GET'])
+@x_ipe_tracing()
 def get_ideas_tree():
     """
     GET /api/ideas/tree
@@ -47,6 +49,7 @@ def get_ideas_tree():
 
 
 @ideas_bp.route('/api/ideas/upload', methods=['POST'])
+@x_ipe_tracing()
 def upload_ideas():
     """
     POST /api/ideas/upload
@@ -91,7 +94,51 @@ def upload_ideas():
     return jsonify(result), 400
 
 
+@ideas_bp.route('/api/ideas/create-folder', methods=['POST'])
+@x_ipe_tracing()
+def create_idea_folder():
+    """
+    POST /api/ideas/create-folder
+    
+    Create a new empty folder in ideas directory.
+    
+    Request body:
+        - folder_name: string - Name for the new folder
+        - parent_folder: string (optional) - Parent folder path
+    
+    Response:
+        - success: true/false
+        - folder_name: string
+        - folder_path: string
+    """
+    project_root = current_app.config.get('PROJECT_ROOT', os.getcwd())
+    service = IdeasService(project_root)
+    
+    if not request.is_json:
+        return jsonify({
+            'success': False,
+            'error': 'JSON required'
+        }), 400
+    
+    data = request.get_json()
+    folder_name = data.get('folder_name')
+    parent_folder = data.get('parent_folder')
+    
+    if not folder_name:
+        return jsonify({
+            'success': False,
+            'error': 'folder_name is required'
+        }), 400
+    
+    result = service.create_folder(folder_name, parent_folder)
+    
+    if result['success']:
+        return jsonify(result)
+    return jsonify(result), 400
+
+
 @ideas_bp.route('/api/ideas/rename', methods=['POST'])
+@x_ipe_tracing()
 def rename_idea_folder():
     """
     POST /api/ideas/rename
@@ -135,6 +182,7 @@ def rename_idea_folder():
 
 
 @ideas_bp.route('/api/ideas/rename-file', methods=['POST'])
+@x_ipe_tracing()
 def rename_idea_file():
     """
     POST /api/ideas/rename-file
@@ -178,6 +226,7 @@ def rename_idea_file():
 
 
 @ideas_bp.route('/api/ideas/delete', methods=['POST'])
+@x_ipe_tracing()
 def delete_idea_item():
     """
     POST /api/ideas/delete
@@ -218,6 +267,7 @@ def delete_idea_item():
 
 
 @ideas_bp.route('/api/ideas/toolbox', methods=['GET'])
+@x_ipe_tracing()
 def get_ideas_toolbox():
     """
     GET /api/ideas/toolbox
@@ -238,6 +288,7 @@ def get_ideas_toolbox():
 
 
 @ideas_bp.route('/api/ideas/toolbox', methods=['POST'])
+@x_ipe_tracing()
 def save_ideas_toolbox():
     """
     POST /api/ideas/toolbox
@@ -264,6 +315,243 @@ def save_ideas_toolbox():
     return jsonify(result), 400
 
 
+# ==========================================================================
+# CR-006: Folder Tree UX Enhancement API Endpoints
+# ==========================================================================
+
+@ideas_bp.route('/api/ideas/move', methods=['POST'])
+@x_ipe_tracing()
+def move_idea_item():
+    """
+    POST /api/ideas/move
+    
+    Move a file or folder to a new location.
+    
+    Request body:
+        - source_path: string - Path of item to move
+        - target_folder: string - Destination folder path
+    
+    Response:
+        - success: true/false
+        - new_path: string
+    """
+    project_root = current_app.config.get('PROJECT_ROOT', os.getcwd())
+    service = IdeasService(project_root)
+    
+    if not request.is_json:
+        return jsonify({'success': False, 'error': 'JSON required'}), 400
+    
+    data = request.get_json()
+    source_path = data.get('source_path')
+    target_folder = data.get('target_folder')
+    
+    if source_path is None:
+        return jsonify({'success': False, 'error': 'source_path is required'}), 400
+    
+    if target_folder is None:
+        return jsonify({'success': False, 'error': 'target_folder is required'}), 400
+    
+    result = service.move_item(source_path, target_folder)
+    
+    if result['success']:
+        return jsonify(result)
+    return jsonify(result), 400
+
+
+@ideas_bp.route('/api/ideas/duplicate', methods=['POST'])
+@x_ipe_tracing()
+def duplicate_idea_item():
+    """
+    POST /api/ideas/duplicate
+    
+    Duplicate a file or folder with -copy suffix.
+    
+    Request body:
+        - path: string - Path of item to duplicate
+    
+    Response:
+        - success: true/false
+        - new_path: string
+    """
+    project_root = current_app.config.get('PROJECT_ROOT', os.getcwd())
+    service = IdeasService(project_root)
+    
+    if not request.is_json:
+        return jsonify({'success': False, 'error': 'JSON required'}), 400
+    
+    data = request.get_json()
+    path = data.get('path')
+    
+    if not path:
+        return jsonify({'success': False, 'error': 'path is required'}), 400
+    
+    result = service.duplicate_item(path)
+    
+    if result['success']:
+        return jsonify(result)
+    return jsonify(result), 400
+
+
+@ideas_bp.route('/api/ideas/download', methods=['GET'])
+@x_ipe_tracing()
+def download_idea_file():
+    """
+    GET /api/ideas/download?path=...
+    
+    Download a file from ideas folder.
+    
+    Query params:
+        - path: string - Path of file to download
+    
+    Response:
+        File download with appropriate Content-Type
+    """
+    from flask import send_file
+    import io
+    
+    project_root = current_app.config.get('PROJECT_ROOT', os.getcwd())
+    service = IdeasService(project_root)
+    
+    path = request.args.get('path')
+    
+    if not path:
+        return jsonify({'success': False, 'error': 'path is required'}), 400
+    
+    result = service.get_download_info(path)
+    
+    if not result['success']:
+        # Return 404 for file not found
+        status_code = 404 if 'not found' in result['error'].lower() else 400
+        return jsonify(result), status_code
+    
+    # Handle both string and bytes content
+    content = result['content']
+    if isinstance(content, str):
+        content = content.encode('utf-8')
+    
+    return send_file(
+        io.BytesIO(content),
+        mimetype=result['mime_type'],
+        as_attachment=True,
+        download_name=result['filename']
+    )
+
+
+@ideas_bp.route('/api/ideas/folder-contents', methods=['GET'])
+@x_ipe_tracing()
+def get_folder_contents():
+    """
+    GET /api/ideas/folder-contents?path=...
+    
+    Get contents of a specific folder.
+    
+    Query params:
+        - path: string - Folder path (optional, defaults to ideas root)
+    
+    Response:
+        - success: true/false
+        - items: array of file/folder objects
+    """
+    project_root = current_app.config.get('PROJECT_ROOT', os.getcwd())
+    service = IdeasService(project_root)
+    
+    path = request.args.get('path', '')
+    
+    result = service.get_folder_contents(path)
+    
+    if result['success']:
+        return jsonify(result)
+    return jsonify(result), 400
+
+
+@ideas_bp.route('/api/ideas/search', methods=['GET'])
+@x_ipe_tracing()
+def search_ideas():
+    """
+    GET /api/ideas/search?q=...
+    
+    Search/filter ideas tree by query.
+    
+    Query params:
+        - q: string - Search query
+    
+    Response:
+        - success: true/false
+        - tree: filtered tree structure
+    """
+    project_root = current_app.config.get('PROJECT_ROOT', os.getcwd())
+    service = IdeasService(project_root)
+    
+    query = request.args.get('q', '')
+    
+    try:
+        tree = service.filter_tree(query)
+        return jsonify({'success': True, 'tree': tree})
+    except Exception as e:
+        return jsonify({'success': False, 'error': str(e)}), 500
+
+
+@ideas_bp.route('/api/ideas/delete-info', methods=['GET'])
+@x_ipe_tracing()
+def get_delete_info():
+    """
+    GET /api/ideas/delete-info?path=...
+    
+    Get item info for delete confirmation dialog.
+    
+    Query params:
+        - path: string - Path of item to delete
+    
+    Response:
+        - success: true/false
+        - name: string
+        - type: 'file' | 'folder'
+        - item_count: number (for folders)
+    """
+    project_root = current_app.config.get('PROJECT_ROOT', os.getcwd())
+    service = IdeasService(project_root)
+    
+    path = request.args.get('path')
+    
+    if not path:
+        return jsonify({'success': False, 'error': 'path is required'}), 400
+    
+    result = service.get_delete_info(path)
+    
+    if result['success']:
+        return jsonify(result)
+    return jsonify(result), 400
+
+
+@ideas_bp.route('/api/ideas/validate-drop', methods=['POST'])
+@x_ipe_tracing()
+def validate_drop_target():
+    """
+    POST /api/ideas/validate-drop
+    
+    Validate if drop target is valid for drag source.
+    
+    Request body:
+        - source_path: string - Path being dragged
+        - target_folder: string - Drop target folder
+    
+    Response:
+        - valid: true/false
+    """
+    project_root = current_app.config.get('PROJECT_ROOT', os.getcwd())
+    service = IdeasService(project_root)
+    
+    if not request.is_json:
+        return jsonify({'valid': False}), 400
+    
+    data = request.get_json()
+    source_path = data.get('source_path')
+    target_folder = data.get('target_folder', '')
+    
+    valid = service.is_valid_drop_target(source_path, target_folder)
+    return jsonify({'valid': valid})
+
+
 # ==========================================================================
 # SKILLS API
 # 
@@ -271,6 +559,7 @@ def save_ideas_toolbox():
 # ==========================================================================
 
 @ideas_bp.route('/api/skills', methods=['GET'])
+@x_ipe_tracing()
 def get_skills():
     """
     GET /api/skills

x_ipe/routes/kb_routes.py

@@ -0,0 +1,80 @@
+"""
+FEATURE-025-A: KB Core Infrastructure
+
+KB Routes: REST API endpoints for Knowledge Base operations.
+"""
+from flask import Blueprint, jsonify, current_app
+
+from x_ipe.services.kb_service import KBService
+from x_ipe.tracing import x_ipe_tracing
+
+kb_bp = Blueprint('kb', __name__, url_prefix='/api/kb')
+
+
+def _get_kb_service() -> KBService:
+    """Get KBService instance using project root from app config."""
+    project_root = current_app.config.get('PROJECT_ROOT', '.')
+    return KBService(project_root)
+
+
+@kb_bp.route('/index', methods=['GET'])
+@x_ipe_tracing(level="INFO")
+def get_index():
+    """
+    Get current file index.
+    
+    Returns:
+        JSON: File index with version, last_updated, and files list
+    """
+    service = _get_kb_service()
+    index = service.get_index()
+    return jsonify(index)
+
+
+@kb_bp.route('/index/refresh', methods=['POST'])
+@x_ipe_tracing(level="INFO")
+def refresh_index():
+    """
+    Rebuild file index from file system.
+    
+    Returns:
+        JSON: Updated file index
+    """
+    service = _get_kb_service()
+    index = service.refresh_index()
+    return jsonify(index)
+
+
+@kb_bp.route('/topics', methods=['GET'])
+@x_ipe_tracing(level="INFO")
+def get_topics():
+    """
+    Get list of all topics.
+    
+    Returns:
+        JSON: { "topics": ["topic1", "topic2", ...] }
+    """
+    service = _get_kb_service()
+    topics = service.get_topics()
+    return jsonify({"topics": topics})
+
+
+@kb_bp.route('/topics/<name>', methods=['GET'])
+@x_ipe_tracing(level="INFO")
+def get_topic_metadata(name: str):
+    """
+    Get metadata for a specific topic.
+    
+    Args:
+        name: Topic folder name
+        
+    Returns:
+        JSON: Topic metadata or 404 if not found
+    """
+    service = _get_kb_service()
+    metadata = service.get_topic_metadata(name)
+    
+    if metadata is None:
+        return jsonify({"error": f"Topic '{name}' not found"}), 404
+    
+    return jsonify(metadata)