@nockdev/awf 6.2.0 → 6.2.1

package/.agent/skills/cross-cutting/ui-ux-pro-max/scripts/core.py

@@ -1,393 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-UI/UX Pro Max Core - Unified with HSA Infrastructure
-
-This module bridges the UI/UX Pro Max skill with DOMYH HSA search infrastructure.
-When HSA is available, it uses the more powerful BM25 implementation with:
-- Code-aware tokenization
-- LRU caching
-- Better relevance ranking
-
-When HSA is not available, falls back to the legacy local BM25.
-
-Usage:
-    from core import search, search_stack, detect_domain
-    
-    # Search with auto-domain detection
-    results = search("modern dashboard dark mode")
-    
-    # Search specific domain
-    results = search("glassmorphism", domain="style")
-    
-    # Search stack-specific
-    results = search_stack("button variants", stack="shadcn")
-"""
-
-import sys
-from pathlib import Path
-from typing import Dict, List, Any, Optional
-
-# =============================================================================
-# HSA Integration
-# =============================================================================
-
-# Try to import HSA adapter
-_USE_HSA = False
-_HSA_ADAPTER = None
-
-try:
-    # Add HSA scripts to path
-    HSA_SCRIPTS_PATH = Path(__file__).parent.parent.parent.parent.parent / "scripts"
-    if HSA_SCRIPTS_PATH.exists():
-        sys.path.insert(0, str(HSA_SCRIPTS_PATH))
-    
-    from hsa.adapters.uiux_adapter import (
-        get_uiux_adapter,
-        UIUXSearchResult,
-        DOMAIN_CONFIG as HSA_DOMAIN_CONFIG,
-        STACK_CONFIG as HSA_STACK_CONFIG,
-    )
-    
-    _HSA_ADAPTER = get_uiux_adapter()
-    _USE_HSA = True
-    
-except ImportError as e:
-    # HSA not available, will use legacy
-    pass
-
-
-# =============================================================================
-# Configuration (kept for backward compatibility)
-# =============================================================================
-
-DATA_DIR = Path(__file__).parent.parent / "data"
-MAX_RESULTS = 3
-
-CSV_CONFIG = {
-    "style": {
-        "file": "styles.yaml",
-        "search_cols": ["Style Category", "Keywords", "Best For", "Type"],
-        "output_cols": ["Style Category", "Type", "Keywords", "Primary Colors", "Effects & Animation", "Best For", "Performance", "Accessibility", "Framework Compatibility", "Complexity"]
-    },
-    "prompt": {
-        "file": "prompts.yaml",
-        "search_cols": ["Style Category", "AI Prompt Keywords (Copy-Paste Ready)", "CSS/Technical Keywords"],
-        "output_cols": ["Style Category", "AI Prompt Keywords (Copy-Paste Ready)", "CSS/Technical Keywords", "Implementation Checklist"]
-    },
-    "color": {
-        "file": "colors.yaml",
-        "search_cols": ["Product Type", "Keywords", "Notes"],
-        "output_cols": ["Product Type", "Keywords", "Primary (Hex)", "Secondary (Hex)", "CTA (Hex)", "Background (Hex)", "Text (Hex)", "Border (Hex)", "Notes"]
-    },
-    "chart": {
-        "file": "charts.yaml",
-        "search_cols": ["Data Type", "Keywords", "Best Chart Type", "Accessibility Notes"],
-        "output_cols": ["Data Type", "Keywords", "Best Chart Type", "Secondary Options", "Color Guidance", "Accessibility Notes", "Library Recommendation", "Interactive Level"]
-    },
-    "landing": {
-        "file": "landing.yaml",
-        "search_cols": ["Pattern Name", "Keywords", "Conversion Optimization", "Section Order"],
-        "output_cols": ["Pattern Name", "Keywords", "Section Order", "Primary CTA Placement", "Color Strategy", "Conversion Optimization"]
-    },
-    "product": {
-        "file": "products.yaml",
-        "search_cols": ["Product Type", "Keywords", "Primary Style Recommendation", "Key Considerations"],
-        "output_cols": ["Product Type", "Keywords", "Primary Style Recommendation", "Secondary Styles", "Landing Page Pattern", "Dashboard Style (if applicable)", "Color Palette Focus"]
-    },
-    "ux": {
-        "file": "ux-guidelines.yaml",
-        "search_cols": ["Category", "Issue", "Description", "Platform"],
-        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't", "Code Example Good", "Code Example Bad", "Severity"]
-    },
-    "typography": {
-        "file": "typography.yaml",
-        "search_cols": ["Font Pairing Name", "Category", "Mood/Style Keywords", "Best For", "Heading Font", "Body Font"],
-        "output_cols": ["Font Pairing Name", "Category", "Heading Font", "Body Font", "Mood/Style Keywords", "Best For", "Google Fonts URL", "CSS Import", "Tailwind Config", "Notes"]
-    },
-    "icons": {
-        "file": "icons.yaml",
-        "search_cols": ["Category", "Icon Name", "Keywords", "Best For"],
-        "output_cols": ["Category", "Icon Name", "Keywords", "Library", "Import Code", "Usage", "Best For", "Style"]
-    },
-    "react": {
-        "file": "react-performance.yaml",
-        "search_cols": ["Category", "Issue", "Keywords", "Description"],
-        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't", "Code Example Good", "Code Example Bad", "Severity"]
-    },
-    "web": {
-        "file": "web-interface.yaml",
-        "search_cols": ["Category", "Issue", "Keywords", "Description"],
-        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't", "Code Example Good", "Code Example Bad", "Severity"]
-    },
-    "component": {
-        "file": "component-decision.yaml",
-        "search_cols": ["component_type", "decision_factors", "primary_recommendation"],
-        "output_cols": ["component_type", "custom_score", "library_score", "headless_score", "decision_factors", "primary_recommendation", "accessibility_priority", "complexity_level"]
-    },
-    "design_tokens": {
-        "file": "design-tokens.yaml",
-        "search_cols": ["token_category", "token_name"],
-        "output_cols": ["token_category", "token_name", "web_css", "web_tailwind", "mobile_ios", "mobile_android", "mobile_flutter", "desktop_wpf"]
-    },
-    "platform": {
-        "file": "platform-guidelines.yaml",
-        "search_cols": ["platform", "design_system", "key_patterns"],
-        "output_cols": ["platform", "design_system", "spacing_base", "border_radius", "typography_scale", "touch_target", "animation_duration", "key_patterns"]
-    },
-    "implementation": {
-        "file": "implementation-strategy.yaml",
-        "search_cols": ["phase", "approach"],
-        "output_cols": ["phase", "component_priority", "approach", "directory_pattern"]
-    }
-}
-
-STACK_CONFIG = {
-    "html-tailwind": {"file": "stacks/html-tailwind.yaml"},
-    "react": {"file": "stacks/react.yaml"},
-    "nextjs": {"file": "stacks/nextjs.yaml"},
-    "vue": {"file": "stacks/vue.yaml"},
-    "nuxtjs": {"file": "stacks/nuxtjs.yaml"},
-    "nuxt-ui": {"file": "stacks/nuxt-ui.yaml"},
-    "svelte": {"file": "stacks/svelte.yaml"},
-    "swiftui": {"file": "stacks/swiftui.yaml"},
-    "react-native": {"file": "stacks/react-native.yaml"},
-    "flutter": {"file": "stacks/flutter.yaml"},
-    "shadcn": {"file": "stacks/shadcn.yaml"},
-    "desktop": {"file": "stacks/desktop.yaml"}
-}
-
-AVAILABLE_STACKS = list(STACK_CONFIG.keys())
-
-# Domain mapping for HSA adapter
-_DOMAIN_MAP = {
-    "style": "style",
-    "prompt": "prompts",
-    "color": "color",
-    "chart": "charts",
-    "landing": "landing",
-    "product": "products",
-    "ux": "ux-guidelines",
-    "typography": "typography",
-    "icons": "icons",
-    "react": "react-performance",
-    "web": "web-interface",
-    "component": "component-decision",
-    "design_tokens": "design-tokens",
-    "platform": "platform-guidelines",
-    "implementation": "implementation-strategy",
-}
-
-
-# =============================================================================
-# Domain Detection
-# =============================================================================
-
-def detect_domain(query: str) -> str:
-    """Auto-detect the most relevant domain from query."""
-    query_lower = query.lower()
-
-    domain_keywords = {
-        "color": ["color", "palette", "hex", "#", "rgb"],
-        "chart": ["chart", "graph", "visualization", "trend", "bar", "pie", "scatter", "heatmap", "funnel"],
-        "landing": ["landing", "page", "cta", "conversion", "hero", "testimonial", "pricing", "section"],
-        "product": ["saas", "ecommerce", "e-commerce", "fintech", "healthcare", "gaming", "portfolio", "crypto", "dashboard"],
-        "prompt": ["prompt", "css", "implementation", "variable", "checklist", "tailwind"],
-        "style": ["style", "design", "ui", "minimalism", "glassmorphism", "neumorphism", "brutalism", "dark mode", "flat", "aurora"],
-        "ux": ["ux", "usability", "accessibility", "wcag", "touch", "scroll", "animation", "keyboard", "navigation", "mobile"],
-        "typography": ["font", "typography", "heading", "serif", "sans"],
-        "icons": ["icon", "icons", "lucide", "heroicons", "symbol", "glyph", "pictogram", "svg icon"],
-        "react": ["react", "next.js", "nextjs", "suspense", "memo", "usecallback", "useeffect", "rerender", "bundle", "waterfall", "barrel", "dynamic import", "rsc", "server component"],
-        "web": ["aria", "focus", "outline", "semantic", "virtualize", "autocomplete", "form", "input type", "preconnect"],
-        "component": ["button", "input", "modal", "dialog", "select", "dropdown", "table", "card", "checkbox", "radio", "switch", "tabs", "accordion", "tooltip", "toast", "sidebar", "navbar", "slider", "form", "datepicker"],
-        "design_tokens": ["token", "spacing", "radius", "shadow", "z-index", "elevation", "design token", "dtcg"],
-        "platform": ["platform", "ios", "android", "windows", "macos", "flutter", "swiftui", "material", "fluent", "wpf", "qt"],
-        "implementation": ["strategy", "implementation", "mvp", "phase", "directory", "structure", "monorepo"]
-    }
-
-    scores = {domain: sum(1 for kw in keywords if kw in query_lower) for domain, keywords in domain_keywords.items()}
-    best = max(scores, key=scores.get)
-    return best if scores[best] > 0 else "style"
-
-
-# =============================================================================
-# HSA-Powered Search Functions
-# =============================================================================
-
-def _search_with_hsa(query: str, domain: str, max_results: int) -> List[Dict[str, Any]]:
-    """Search using HSA adapter."""
-    if _HSA_ADAPTER is None:
-        return []
-    
-    # Map domain name to HSA domain
-    hsa_domain = _DOMAIN_MAP.get(domain, domain)
-    
-    try:
-        results = _HSA_ADAPTER.search(
-            query=query,
-            domain=hsa_domain,
-            max_results=max_results
-        )
-        
-        # Convert UIUXSearchResult to dict format
-        return [r.data for r in results]
-        
-    except Exception as e:
-        # Log error and return empty
-        return []
-
-
-def _search_stack_with_hsa(query: str, stack: str, max_results: int) -> List[Dict[str, Any]]:
-    """Search stack using HSA adapter."""
-    if _HSA_ADAPTER is None:
-        return []
-    
-    try:
-        results = _HSA_ADAPTER.search_stack(
-            query=query,
-            stack=stack,
-            max_results=max_results
-        )
-        
-        return [r.data for r in results]
-        
-    except Exception:
-        return []
-
-
-# =============================================================================
-# Legacy Search Functions (Fallback)
-# =============================================================================
-
-def _search_legacy(query: str, domain: str, max_results: int) -> List[Dict[str, Any]]:
-    """Search using legacy BM25 (from core_legacy.py)."""
-    try:
-        from .core_legacy import search as legacy_search
-        result = legacy_search(query, domain, max_results)
-        return result.get("results", [])
-    except ImportError:
-        return []
-
-
-def _search_stack_legacy(query: str, stack: str, max_results: int) -> List[Dict[str, Any]]:
-    """Search stack using legacy implementation."""
-    try:
-        from .core_legacy import search_stack as legacy_search_stack
-        result = legacy_search_stack(query, stack, max_results)
-        return result.get("results", [])
-    except ImportError:
-        return []
-
-
-# =============================================================================
-# Main Search Functions (Public API)
-# =============================================================================
-
-def search(
-    query: str, 
-    domain: Optional[str] = None, 
-    max_results: int = MAX_RESULTS
-) -> Dict[str, Any]:
-    """
-    Main search function with auto-domain detection.
-    
-    Uses HSA infrastructure when available for better search quality.
-    Falls back to legacy BM25 otherwise.
-    
-    Args:
-        query: Search query string
-        domain: Domain to search (auto-detected if None)
-        max_results: Maximum results to return
-        
-    Returns:
-        Dict with keys: domain, query, count, results, engine
-    """
-    if domain is None:
-        domain = detect_domain(query)
-    
-    # Try HSA first
-    if _USE_HSA:
-        results = _search_with_hsa(query, domain, max_results)
-        engine = "hsa"
-    else:
-        results = _search_legacy(query, domain, max_results)
-        engine = "legacy"
-    
-    config = CSV_CONFIG.get(domain, CSV_CONFIG["style"])
-    
-    return {
-        "domain": domain,
-        "query": query,
-        "file": config["file"],
-        "count": len(results),
-        "results": results,
-        "engine": engine,
-    }
-
-
-def search_stack(
-    query: str, 
-    stack: str, 
-    max_results: int = MAX_RESULTS
-) -> Dict[str, Any]:
-    """
-    Search stack-specific guidelines.
-    
-    Args:
-        query: Search query string
-        stack: Stack name (react, vue, nextjs, etc.)
-        max_results: Maximum results
-        
-    Returns:
-        Dict with keys: domain, stack, query, count, results, engine
-    """
-    if stack not in STACK_CONFIG:
-        return {"error": f"Unknown stack: {stack}. Available: {', '.join(AVAILABLE_STACKS)}"}
-    
-    # Try HSA first
-    if _USE_HSA:
-        results = _search_stack_with_hsa(query, stack, max_results)
-        engine = "hsa"
-    else:
-        results = _search_stack_legacy(query, stack, max_results)
-        engine = "legacy"
-    
-    return {
-        "domain": "stack",
-        "stack": stack,
-        "query": query,
-        "file": STACK_CONFIG[stack]["file"],
-        "count": len(results),
-        "results": results,
-        "engine": engine,
-    }
-
-
-def get_engine_status() -> Dict[str, Any]:
-    """Get current search engine status."""
-    status = {
-        "hsa_available": _USE_HSA,
-        "engine": "hsa" if _USE_HSA else "legacy",
-    }
-    
-    if _USE_HSA and _HSA_ADAPTER:
-        status["hsa_stats"] = _HSA_ADAPTER.get_stats()
-    
-    return status
-
-
-# =============================================================================
-# Exports
-# =============================================================================
-
-__all__ = [
-    "search",
-    "search_stack",
-    "detect_domain",
-    "get_engine_status",
-    "CSV_CONFIG",
-    "STACK_CONFIG",
-    "AVAILABLE_STACKS",
-    "DATA_DIR",
-    "MAX_RESULTS",
-]