x-ipe 1.0.24__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
@@ -92,6 +95,7 @@ def upload_ideas():
 
 
 @ideas_bp.route('/api/ideas/create-folder', methods=['POST'])
+@x_ipe_tracing()
 def create_idea_folder():
     """
     POST /api/ideas/create-folder
@@ -134,6 +138,7 @@ def create_idea_folder():
 
 
 @ideas_bp.route('/api/ideas/rename', methods=['POST'])
+@x_ipe_tracing()
 def rename_idea_folder():
     """
     POST /api/ideas/rename
@@ -177,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
@@ -220,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
@@ -260,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
@@ -280,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
@@ -311,6 +320,7 @@ def save_ideas_toolbox():
 # ==========================================================================
 
 @ideas_bp.route('/api/ideas/move', methods=['POST'])
+@x_ipe_tracing()
 def move_idea_item():
     """
     POST /api/ideas/move
@@ -349,6 +359,7 @@ def move_idea_item():
 
 
 @ideas_bp.route('/api/ideas/duplicate', methods=['POST'])
+@x_ipe_tracing()
 def duplicate_idea_item():
     """
     POST /api/ideas/duplicate
@@ -382,6 +393,7 @@ def duplicate_idea_item():
 
 
 @ideas_bp.route('/api/ideas/download', methods=['GET'])
+@x_ipe_tracing()
 def download_idea_file():
     """
     GET /api/ideas/download?path=...
@@ -426,6 +438,7 @@ def download_idea_file():
 
 
 @ideas_bp.route('/api/ideas/folder-contents', methods=['GET'])
+@x_ipe_tracing()
 def get_folder_contents():
     """
     GET /api/ideas/folder-contents?path=...
@@ -452,6 +465,7 @@ def get_folder_contents():
 
 
 @ideas_bp.route('/api/ideas/search', methods=['GET'])
+@x_ipe_tracing()
 def search_ideas():
     """
     GET /api/ideas/search?q=...
@@ -478,6 +492,7 @@ def search_ideas():
 
 
 @ideas_bp.route('/api/ideas/delete-info', methods=['GET'])
+@x_ipe_tracing()
 def get_delete_info():
     """
     GET /api/ideas/delete-info?path=...
@@ -509,6 +524,7 @@ def get_delete_info():
 
 
 @ideas_bp.route('/api/ideas/validate-drop', methods=['POST'])
+@x_ipe_tracing()
 def validate_drop_target():
     """
     POST /api/ideas/validate-drop
@@ -543,6 +559,7 @@ def validate_drop_target():
 # ==========================================================================
 
 @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)

x_ipe/routes/main_routes.py

@@ -15,17 +15,20 @@ from pathlib import Path
 from flask import Blueprint, render_template, jsonify, request, current_app, send_file
 
 from x_ipe.services import ProjectService, ContentService
+from x_ipe.tracing import x_ipe_tracing
 
 main_bp = Blueprint('main', __name__)
 
 
 @main_bp.route('/')
+@x_ipe_tracing()
 def index():
     """Serve main page with sidebar navigation"""
     return render_template('index.html')
 
 
 @main_bp.route('/uiux-feedbacks')
+@x_ipe_tracing()
 def uiux_feedbacks():
     """
     GET /uiux-feedbacks
@@ -36,6 +39,7 @@ def uiux_feedbacks():
 
 
 @main_bp.route('/workplace')
+@x_ipe_tracing()
 def workplace():
     """
     GET /workplace
@@ -46,7 +50,19 @@ def workplace():
     return render_template('workplace.html')
 
 
+@main_bp.route('/knowledge-base')
+@x_ipe_tracing()
+def knowledge_base():
+    """
+    GET /knowledge-base
+    
+    FEATURE-025-A: Knowledge Base page
+    """
+    return render_template('knowledge-base.html')
+
+
 @main_bp.route('/api/project/structure')
+@x_ipe_tracing()
 def get_project_structure():
     """
     GET /api/project/structure
@@ -68,6 +84,7 @@ def get_project_structure():
 
 
 @main_bp.route('/api/file/content')
+@x_ipe_tracing()
 def get_file_content():
     """
     GET /api/file/content?path=<relative_path>&raw=<true/false>
@@ -148,6 +165,7 @@ def get_file_content():
 
 
 @main_bp.route('/api/file/save', methods=['POST'])
+@x_ipe_tracing()
 def save_file():
     """
     POST /api/file/save

x_ipe/routes/project_routes.py

@@ -13,6 +13,8 @@ Provides:
 import os
 from flask import Blueprint, jsonify, request, current_app
 
+from x_ipe.tracing import x_ipe_tracing
+
 project_bp = Blueprint('project', __name__)
 
 
@@ -22,6 +24,7 @@ def get_project_folders_service():
 
 
 @project_bp.route('/api/projects', methods=['GET'])
+@x_ipe_tracing()
 def get_projects():
     """
     GET /api/projects
@@ -43,6 +46,7 @@ def get_projects():
 
 
 @project_bp.route('/api/projects', methods=['POST'])
+@x_ipe_tracing()
 def add_project():
     """
     POST /api/projects
@@ -78,6 +82,7 @@ def add_project():
 
 
 @project_bp.route('/api/projects/<int:project_id>', methods=['PUT'])
+@x_ipe_tracing()
 def update_project(project_id):
     """
     PUT /api/projects/<id>
@@ -113,6 +118,7 @@ def update_project(project_id):
 
 
 @project_bp.route('/api/projects/<int:project_id>', methods=['DELETE'])
+@x_ipe_tracing()
 def delete_project(project_id):
     """
     DELETE /api/projects/<id>
@@ -137,6 +143,7 @@ def delete_project(project_id):
 
 
 @project_bp.route('/api/projects/switch', methods=['POST'])
+@x_ipe_tracing()
 def switch_project():
     """
     POST /api/projects/switch

x_ipe/routes/proxy_routes.py

@@ -8,11 +8,13 @@ Provides localhost URL proxying endpoint.
 from flask import Blueprint, jsonify, request, Response
 
 from x_ipe.services import ProxyService
+from x_ipe.tracing import x_ipe_tracing
 
 proxy_bp = Blueprint('proxy', __name__)
 
 
 @proxy_bp.route('/api/proxy', methods=['GET'])
+@x_ipe_tracing()
 def proxy_url():
     """
     GET /api/proxy?url=<encoded_url>