flutter-pro-max-cli 1.0.0

package/assets/.agent/workflows/scripts/search.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Flutter Pro Max Search - CLI for Flutter knowledge base search
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--top 5]
+
+Domains: widget, package, pattern, architect, chart, color, typography, style, ux, icon, landing, naming, product, prompt
+Stacks: riverpod, bloc, provider
+"""
+
+import argparse
+import json
+from core import (
+    CSV_CONFIG, 
+    AVAILABLE_DOMAINS, 
+    AVAILABLE_STACKS, 
+    MAX_RESULTS, 
+    search, 
+    search_with_stack
+)
+
+
+def format_output(result):
+    """Format results for human-readable output (token-optimized for AI)"""
+    if "error" in result:
+        return f"❌ Error: {result['error']}"
+
+    output = []
+    
+    # Header
+    output.append(f"\n🔍 Flutter Pro Max Search Results")
+    if result.get("stack"):
+        output.append(f"   Stack: {result['stack']} (excluding: {', '.join(result.get('excluded', []))})")
+    output.append(f"   Domain: {result['domain']} | Query: '{result['query']}'")
+    output.append(f"   Source: {result['file']} | Found: {result['count']} results\n")
+
+    # Results
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"{'='*60}")
+        output.append(f"[{i}] Score: {row.get('_score', 'N/A')}")
+        
+        for key, value in row.items():
+            if key == "_score":
+                continue
+            value_str = str(value)
+            if len(value_str) > 200:
+                value_str = value_str[:200] + "..."
+            output.append(f"    {key}: {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Flutter Pro Max Search - BM25 search for Flutter knowledge base",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  python search.py "ListView pagination" --top 3
+  python search.py "network http" --domain package
+  python search.py "state management" --stack riverpod
+  python search.py "login" --json
+        """
+    )
+    
+    parser.add_argument("query", help="Search query")
+    parser.add_argument(
+        "--domain", "-d", 
+        choices=AVAILABLE_DOMAINS, 
+        help=f"Search domain (auto-detected if not specified)"
+    )
+    parser.add_argument(
+        "--stack", "-s", 
+        choices=AVAILABLE_STACKS, 
+        help="Stack preference to exclude conflicting packages"
+    )
+    parser.add_argument(
+        "--top", "-n", 
+        type=int, 
+        default=MAX_RESULTS, 
+        help=f"Max results (default: {MAX_RESULTS})"
+    )
+    parser.add_argument(
+        "--json", "-j", 
+        action="store_true", 
+        help="Output as JSON"
+    )
+
+    args = parser.parse_args()
+
+    # Perform search
+    if args.stack:
+        result = search_with_stack(args.query, args.stack, args.domain, args.top)
+    else:
+        result = search(args.query, args.domain, args.top)
+
+    # Output
+    if args.json:
+        print(json.dumps(result, indent=2, ensure_ascii=False))
+    else:
+        print(format_output(result))
+
+
+if __name__ == "__main__":
+    main()

package/assets/.claude/skills/flutter-pro-max/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: flutter-pro-max
+description: Chuyên gia Flutter với kiến thức sâu về Clean Architecture, Performance và Modern Dart 3
+---
+
+# Flutter Pro Max - Flutter Design Intelligence
+
+Searchable database của Flutter widgets, packages, design patterns, architecture guidelines, và best practices.
+
+## Prerequisites
+
+Kiểm tra Python đã cài đặt:
+
+```bash
+python3 --version || python --version
+```
+
+Cài đặt dependency:
+
+```bash
+pip install rank-bm25
+```
+
+---
+
+## How to Use This Skill
+
+Khi user yêu cầu Flutter work (design, build, create, implement, review, fix, improve), follow workflow này:
+
+### Step 1: Analyze User Requirements
+
+Trích xuất thông tin từ request:
+- **Architecture**: Clean Architecture, Feature-First, DDD
+- **State Management**: Riverpod (default), Bloc, Provider
+- **UI Components**: Widgets, Layouts, Animations
+- **Design**: Colors, Typography, Styles
+- **Package needs**: Networking, Database, Security, etc.
+
+### Step 2: Search Relevant Data
+
+Sử dụng `search.py` để tìm kiếm trong **14 data sources**:
+
+```bash
+python3 .claude/skills/flutter-pro-max/scripts/search.py "<keyword>" --top 5
+```
+
+**Với stack filter (loại bỏ conflicts):**
+```bash
+python3 .claude/skills/flutter-pro-max/scripts/search.py "<keyword>" --stack riverpod --top 5
+```
+
+**Available stacks:** `riverpod`, `bloc`, `provider`
+
+**Search Examples by Domain:**
+```bash
+# Flutter Widgets
+python3 scripts/search.py "ListView pagination" --top 5
+
+# Design Patterns
+python3 scripts/search.py "authentication login" --top 5
+
+# Charts
+python3 scripts/search.py "chart bar comparison" --top 5
+
+# Typography
+python3 scripts/search.py "font modern SaaS" --top 5
+
+# Colors by Product
+python3 scripts/search.py "fintech crypto dark" --top 5
+
+# UX Guidelines
+python3 scripts/search.py "touch target accessibility" --top 5
+
+# UI Styles
+python3 scripts/search.py "glassmorphism neumorphism" --top 5
+```
+
+### Step 3: Apply Technical Standards
+
+Luôn tuân thủ các tiêu chuẩn:
+
+#### Dart 3 Modern Syntax
+```dart
+// ✅ Records
+(String name, int age) getUserInfo() => ('John', 25);
+
+// ✅ Pattern Matching
+String getMessage(UIState state) => switch (state) {
+  LoadingState() => 'Loading...',
+  DataState(data: var d) => 'Data: $d',
+  ErrorState(message: var m) => 'Error: $m',
+};
+```
+
+#### Performance Rules
+- Luôn dùng `const` constructor khi có thể
+- Ưu tiên `SizedBox` hơn `Container` cho spacing
+- Dùng `ListView.builder` thay vì `ListView` + `children`
+
+#### State Management
+- **Default**: Riverpod với `riverpod_generator`
+- **Alternative**: Bloc (khi user yêu cầu)
+
+---
+
+## Search Reference
+
+### Available Data Sources (14 files)
+
+| Type | File | Content |
+|------|------|---------|
+| Widget | `widget.csv` | 65+ Flutter widgets với pro-tips |
+| Package | `package.csv` | 100+ packages với best practices |
+| Pattern | `patterns.csv` | 100+ design patterns với code snippets |
+| Architecture | `architect.csv` | Clean Architecture layer paths |
+| Chart | `charts.csv` | Chart type recommendations by data |
+| Color | `colors.csv` | Color palettes by product type |
+| Typography | `typography.csv` | Font pairings với Google Fonts |
+| Style | `styles.csv` | UI style guidelines (Glass, Neubrutalism...) |
+| UX Guideline | `ux-guidelines.csv` | UX best practices (Do/Don't) |
+| Icon | `icons.csv` | Icon recommendations |
+| Landing | `landing.csv` | Landing page section patterns |
+| Naming | `name_convention.csv` | Dart/Flutter naming conventions |
+| Product | `products.csv` | Product type styling recommendations |
+| Prompt | `prompts.csv` | AI prompt templates |
+
+---
+
+## Example Workflow
+
+**User Request:** "Tạo màn hình đăng nhập với Riverpod"
+
+1. **Search widgets:**
+   ```bash
+   python3 scripts/search.py "form input text field" --top 5
+   ```
+
+2. **Search patterns:**
+   ```bash
+   python3 scripts/search.py "authentication login" --top 5
+   ```
+
+3. **Search packages:**
+   ```bash
+   python3 scripts/search.py "validation form" --stack riverpod --top 5
+   ```
+
+4. **Search colors:**
+   ```bash
+   python3 scripts/search.py "saas professional" --top 3
+   ```
+
+5. **Apply results** to generate code với Riverpod state management
+
+---
+
+## Pre-Delivery Checklist
+
+### Code Quality
+- [ ] Sử dụng `const` constructors
+- [ ] Sound Null Safety (không dùng `!` bừa bãi)
+- [ ] Dart 3 syntax (Records, Pattern Matching)
+
+### Performance
+- [ ] `ListView.builder` cho lists dài
+- [ ] `SizedBox` thay vì `Container` cho spacing
+- [ ] `const` widgets được đánh dấu
+
+### Architecture
+- [ ] Tuân thủ Clean Architecture layers
+- [ ] Dependency Injection đúng cách
+- [ ] Repository pattern cho data access
+
+### State Management
+- [ ] Riverpod providers được tổ chức hợp lý
+- [ ] Không leak state giữa các features
+- [ ] Error handling với AsyncValue
+
+### UX/UI
+- [ ] Touch targets tối thiểu 44x44px
+- [ ] Colors đúng với product type
+- [ ] Typography phù hợp với brand

package/assets/.claude/skills/flutter-pro-max/scripts/core.py

@@ -0,0 +1,341 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Flutter Pro Max Core - BM25 search engine for Flutter knowledge base
+Zero dependencies - self-contained BM25 implementation
+"""
+
+import csv
+import re
+from pathlib import Path
+from math import log
+from collections import defaultdict
+
+# ============ CONFIGURATION ============
+def _get_data_dir():
+    """Auto-detect data directory based on script location"""
+    script_dir = Path(__file__).parent
+    possible_paths = [
+        # When running from root/scripts/
+        script_dir.parent / ".shared" / "data",
+        # When running from .shared/flutter-pro-max/scripts/
+        script_dir.parent.parent / "data",
+        # Fallback: cwd
+        Path.cwd() / ".shared" / "data",
+    ]
+    for p in possible_paths:
+        if p.exists():
+            return p.resolve()
+    return possible_paths[0]  # Default to first option
+
+DATA_DIR = _get_data_dir()
+MAX_RESULTS = 5
+
+# Domain configuration: file, search columns, output columns
+CSV_CONFIG = {
+    "widget": {
+        "file": "widget.csv",
+        "search_cols": ["Widget Name", "Category", "Description", "Key Properties", "Usage Context & Pro-Tips"],
+        "output_cols": ["Widget Name", "Category", "Description", "Key Properties", "Usage Context & Pro-Tips"]
+    },
+    "package": {
+        "file": "package.csv",
+        "search_cols": ["pkg_name", "category", "description", "best_practice_snippet", "pro_tip", "alternatives"],
+        "output_cols": ["pkg_name", "category", "description", "best_practice_snippet", "pro_tip", "alternatives"]
+    },
+    "pattern": {
+        "file": "patterns.csv",
+        "search_cols": ["pattern_name", "category", "problem_tags", "description", "key_widgets", "code_snippet", "anti_pattern"],
+        "output_cols": ["pattern_name", "category", "problem_tags", "description", "key_widgets", "code_snippet", "anti_pattern"]
+    },
+    "architect": {
+        "file": "architect.csv",
+        "search_cols": ["path_pattern", "layer", "responsibility_description", "allowed_dependencies", "tech_stack_note"],
+        "output_cols": ["path_pattern", "layer", "responsibility_description", "allowed_dependencies", "tech_stack_note"]
+    },
+    "chart": {
+        "file": "charts.csv",
+        "search_cols": ["Data Type", "Keywords", "Best Chart Type", "Secondary Options", "Accessibility Notes"],
+        "output_cols": ["Data Type", "Keywords", "Best Chart Type", "Secondary Options", "Color Guidance", "Accessibility Notes", "Library Recommendation"]
+    },
+    "color": {
+        "file": "colors.csv",
+        "search_cols": ["Product Type", "Keywords", "Notes"],
+        "output_cols": ["Product Type", "Keywords", "Primary (Hex)", "Secondary (Hex)", "CTA (Hex)", "Notes"]
+    },
+    "typography": {
+        "file": "typography.csv",
+        "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", "Notes"]
+    },
+    "style": {
+        "file": "styles.csv",
+        "search_cols": ["Style Category", "Type", "Keywords", "Best For"],
+        "output_cols": ["Style Category", "Type", "Keywords", "Primary Colors", "Effects & Animation", "Best For", "Do Not Use For"]
+    },
+    "ux": {
+        "file": "ux-guidelines.csv",
+        "search_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't"],
+        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't"]
+    },
+    "icon": {
+        "file": "icons.csv",
+        "search_cols": ["Category", "Icon Name", "Keywords", "Best For"],
+        "output_cols": ["Category", "Icon Name", "Keywords", "Library", "Import Code", "Usage", "Best For"]
+    },
+    "landing": {
+        "file": "landing.csv",
+        "search_cols": ["Pattern Name", "Keywords", "Section Order", "Conversion Optimization"],
+        "output_cols": ["Pattern Name", "Keywords", "Section Order", "Primary CTA Placement", "Color Strategy", "Conversion Optimization"]
+    },
+    "naming": {
+        "file": "name_convention.csv",
+        "search_cols": ["Layer", "File Template", "Class Template", "Example File", "Example Class", "Notes"],
+        "output_cols": ["Layer", "File Template", "Class Template", "Example File", "Example Class", "Notes"]
+    },
+    "product": {
+        "file": "products.csv",
+        "search_cols": ["Product Type", "Keywords", "Primary Style Recommendation"],
+        "output_cols": ["Product Type", "Keywords", "Primary Style Recommendation", "Secondary Styles", "Color Palette Focus"]
+    },
+    "prompt": {
+        "file": "prompts.csv",
+        "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"]
+    }
+}
+
+# Stack exclusion mapping for filtering conflicting packages
+STACK_EXCLUSIONS = {
+    "riverpod": ["bloc", "flutter_bloc", "provider", "hydrated_bloc"],
+    "bloc": ["riverpod", "flutter_riverpod", "provider"],
+    "provider": ["riverpod", "flutter_riverpod", "bloc", "flutter_bloc"],
+}
+
+AVAILABLE_DOMAINS = list(CSV_CONFIG.keys())
+AVAILABLE_STACKS = list(STACK_EXCLUSIONS.keys())
+
+
+# ============ BM25 IMPLEMENTATION ============
+class BM25:
+    """BM25 ranking algorithm for text search - zero dependencies"""
+
+    def __init__(self, k1=1.5, b=0.75):
+        self.k1 = k1
+        self.b = b
+        self.corpus = []
+        self.doc_lengths = []
+        self.avgdl = 0
+        self.idf = {}
+        self.doc_freqs = defaultdict(int)
+        self.N = 0
+
+    def tokenize(self, text):
+        """Lowercase, split, remove punctuation, filter short words"""
+        text = re.sub(r'[^\w\s]', ' ', str(text).lower())
+        return [w for w in text.split() if len(w) > 1]
+
+    def fit(self, documents):
+        """Build BM25 index from documents"""
+        self.corpus = [self.tokenize(doc) for doc in documents]
+        self.N = len(self.corpus)
+        if self.N == 0:
+            return
+        self.doc_lengths = [len(doc) for doc in self.corpus]
+        self.avgdl = sum(self.doc_lengths) / self.N
+
+        for doc in self.corpus:
+            seen = set()
+            for word in doc:
+                if word not in seen:
+                    self.doc_freqs[word] += 1
+                    seen.add(word)
+
+        for word, freq in self.doc_freqs.items():
+            self.idf[word] = log((self.N - freq + 0.5) / (freq + 0.5) + 1)
+
+    def score(self, query):
+        """Score all documents against query"""
+        query_tokens = self.tokenize(query)
+        scores = []
+
+        for idx, doc in enumerate(self.corpus):
+            score = 0
+            doc_len = self.doc_lengths[idx]
+            term_freqs = defaultdict(int)
+            for word in doc:
+                term_freqs[word] += 1
+
+            for token in query_tokens:
+                if token in self.idf:
+                    tf = term_freqs[token]
+                    idf = self.idf[token]
+                    numerator = tf * (self.k1 + 1)
+                    denominator = tf + self.k1 * (1 - self.b + self.b * doc_len / self.avgdl)
+                    score += idf * numerator / denominator
+
+            scores.append((idx, score))
+
+        return sorted(scores, key=lambda x: x[1], reverse=True)
+
+
+# ============ HELPER FUNCTIONS ============
+def _load_csv(filepath):
+    """Load CSV and return list of dicts"""
+    with open(filepath, 'r', encoding='utf-8') as f:
+        return list(csv.DictReader(f))
+
+
+def _search_csv(filepath, search_cols, output_cols, query, max_results, boost_col=None, boost_query=None):
+    """Core search function using BM25 with optional boosting"""
+    if not filepath.exists():
+        return []
+
+    data = _load_csv(filepath)
+
+    # Build documents from search columns
+    documents = [" ".join(str(row.get(col, "")) for col in search_cols) for row in data]
+
+    # BM25 search
+    bm25 = BM25()
+    bm25.fit(documents)
+    ranked = bm25.score(query)
+
+    # Apply boosting if specified (widget name match, etc.)
+    if boost_col and boost_query:
+        boost_query_lower = boost_query.lower()
+        boosted = []
+        for idx, score in ranked:
+            if score > 0:
+                boost_value = str(data[idx].get(boost_col, "")).lower()
+                if boost_value in boost_query_lower or boost_query_lower in boost_value:
+                    score *= 2.0  # Double score for exact/partial match
+            boosted.append((idx, score))
+        ranked = sorted(boosted, key=lambda x: x[1], reverse=True)
+
+    # Get top results with score > 0
+    results = []
+    for idx, score in ranked[:max_results]:
+        if score > 0:
+            row = data[idx]
+            result = {col: row.get(col, "") for col in output_cols if col in row}
+            result["_score"] = round(score, 4)
+            results.append(result)
+
+    return results
+
+
+def detect_domain(query):
+    """Auto-detect the most relevant domain from query keywords"""
+    query_lower = query.lower()
+
+    domain_keywords = {
+        "widget": ["widget", "listview", "column", "row", "container", "text", "button", "scaffold", "appbar", "sliver"],
+        "package": ["package", "pub", "dependency", "library", "dio", "http", "riverpod", "bloc", "hive", "isar"],
+        "pattern": ["pattern", "architecture", "repository", "usecase", "state", "async", "error handling", "offline"],
+        "architect": ["layer", "folder", "structure", "clean", "feature", "domain", "data", "presentation"],
+        "chart": ["chart", "graph", "visualization", "bar", "pie", "line", "scatter", "heatmap"],
+        "color": ["color", "palette", "hex", "theme", "dark mode", "light mode"],
+        "typography": ["font", "typography", "heading", "text style", "google fonts"],
+        "style": ["style", "design", "ui", "glassmorphism", "neumorphism", "minimal", "modern"],
+        "ux": ["ux", "usability", "accessibility", "touch", "scroll", "animation", "gesture"],
+        "icon": ["icon", "lucide", "material icons", "cupertino"],
+        "landing": ["landing", "page", "hero", "cta", "section"],
+        "naming": ["naming", "convention", "file name", "class name", "snake_case", "PascalCase"],
+        "product": ["saas", "ecommerce", "fintech", "healthcare", "education", "food", "travel"],
+        "prompt": ["prompt", "ai", "css", "tailwind", "implementation"],
+    }
+
+    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 "widget"
+
+
+# ============ MAIN SEARCH FUNCTIONS ============
+def search(query, domain=None, max_results=MAX_RESULTS):
+    """
+    Main search function with auto-domain detection
+    
+    Args:
+        query: Search query string
+        domain: Optional domain (widget, package, pattern, etc.)
+        max_results: Number of results to return
+    
+    Returns:
+        Dict with domain, query, file, count, and results
+    """
+    if domain is None:
+        domain = detect_domain(query)
+
+    if domain not in CSV_CONFIG:
+        return {"error": f"Unknown domain: {domain}. Available: {', '.join(AVAILABLE_DOMAINS)}"}
+
+    config = CSV_CONFIG[domain]
+    filepath = DATA_DIR / config["file"]
+
+    if not filepath.exists():
+        return {"error": f"File not found: {filepath}", "domain": domain}
+
+    # Apply widget boosting for widget domain
+    boost_col = "Widget Name" if domain == "widget" else None
+    boost_query = query if domain == "widget" else None
+
+    results = _search_csv(
+        filepath, 
+        config["search_cols"], 
+        config["output_cols"], 
+        query, 
+        max_results,
+        boost_col=boost_col,
+        boost_query=boost_query
+    )
+
+    return {
+        "domain": domain,
+        "query": query,
+        "file": config["file"],
+        "count": len(results),
+        "results": results
+    }
+
+
+def search_with_stack(query, stack, domain=None, max_results=MAX_RESULTS):
+    """
+    Search with stack-specific filtering (excludes conflicting packages)
+    
+    Args:
+        query: Search query string
+        stack: Stack preference (riverpod, bloc, provider)
+        domain: Optional domain filter
+        max_results: Number of results to return
+    
+    Returns:
+        Dict with filtered results
+    """
+    if stack not in STACK_EXCLUSIONS:
+        return {"error": f"Unknown stack: {stack}. Available: {', '.join(AVAILABLE_STACKS)}"}
+
+    result = search(query, domain, max_results * 2)  # Get more to filter
+
+    if "error" in result:
+        return result
+
+    # Filter out conflicting packages
+    excluded = STACK_EXCLUSIONS[stack]
+    filtered_results = []
+    
+    for item in result["results"]:
+        # Check package name field
+        pkg_name = item.get("pkg_name", "").lower()
+        if pkg_name not in excluded:
+            filtered_results.append(item)
+        
+        if len(filtered_results) >= max_results:
+            break
+
+    result["results"] = filtered_results
+    result["count"] = len(filtered_results)
+    result["stack"] = stack
+    result["excluded"] = excluded
+
+    return result