flutter-pro-max-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bui Long
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# 🚀 Flutter Pro Max CLI
+
+**The official command-line interface for deploying Flutter Pro Max technical intelligence to your favorite AI coding assistants.**
+
+[![npm version](https://img.shields.io/npm/v/flutter-pro-max-cli.svg)](https://www.npmjs.com/package/flutter-pro-max-cli)
+[![Downloads](https://img.shields.io/npm/dm/flutter-pro-max-cli.svg)](https://www.npmjs.com/package/flutter-pro-max-cli)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+---
+
+## 📦 Installation
+
+### The Quick Way (Recommended)
+Bootstrap any project in seconds. This command will guide you through selecting and installing the skill for your environment.
+
+```bash
+npx flutter-pro-max-cli
+```
+
+### Global Installation
+For heavy users who want the `flutter-pro-max` command available everywhere:
+
+```bash
+# Install globally
+npm install -g flutter-pro-max-cli
+
+# Initialize in your project
+flutter-pro-max init
+```
+
+---
+
+## 🛠️ Usage
+
+### Interactive Setup
+Simply run the command and follow the prompts to detect and install the skill for your active AI assistants.
+
+```bash
+flutter-pro-max init
+```
+
+### Scripted Installation
+For CI/CD or automated setups, you can specify the assistant type directly:
+
+```bash
+# Install for a specific assistant
+flutter-pro-max init --ai claude
+flutter-pro-max init --ai cursor
+
+# Install for all supported assistants
+flutter-pro-max init --ai all
+```
+
+---
+
+## 🤖 Supported AI Assistants
+
+This CLI bridges the gap between the Flutter Pro Max knowledge base and your development tools:
+
+| Assistant | Type Flag | Installation Path |
+|-----------|-----------|-------------------|
+| **Claude Code** | `claude` | `.claude/skills/` |
+| **Cursor** | `cursor` | `.cursor/commands/` |
+| **Windsurf** | `windsurf` | `.windsurf/workflows/` |
+| **Antigravity** | `antigravity` | `.agent/workflows/` |
+| **Trae** | `trae` | `.trae/skills/` |
+| **Gemini CLI** | `gemini` | `.gemini/skills/` |
+| **GitHub Copilot** | `copilot` | `.github/prompts/` |
+| **RooCode** | `roocode` | `.roo/commands/` |
+| **Kiro** | `kiro` | `.kiro/steering/` |
+| **Qoder** | `qoder` | `.qoder/rules/` |
+| **CodeBuddy** | `codebuddy` | `.codebuddy/commands/` |
+| **Codex** | `codex` | `.codex/skills/` |
+
+---
+
+## 🔧 Development
+
+If you want to contribute or modify the CLI:
+
+```bash
+# Clone and install
+git clone https://github.com/btLong402/flutter-skill.git
+cd cli
+npm install
+
+# Build the project
+npm run build
+
+# Run locally in development mode
+npm run dev
+```
+
+---
+
+## 📄 License
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+<div align="center">
+
+**Streamline your Flutter development with AI-powered architectural intelligence.**
+
+</div>

package/assets/.agent/workflows/flutter-pro-max.md

@@ -0,0 +1,167 @@
+---
+description: Flutter Pro Max - Chuyên gia Flutter với Clean Architecture và Performance
+---
+
+# flutter-pro-max
+
+Searchable database của Flutter widgets, packages, design patterns, architecture guidelines, colors, typography, và best practices.
+
+## Prerequisites
+
+```bash
+python3 --version
+pip install rank-bm25
+```
+
+---
+
+## How to Use This Workflow
+
+Khi user yêu cầu Flutter work, 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 (14 Sources)
+
+```bash
+python3 .agent/workflows/scripts/search.py "<keyword>" --top 5
+python3 .agent/workflows/scripts/search.py "<keyword>" --stack riverpod --top 5
+```
+
+**Available stacks:** `riverpod`, `bloc`, `provider`
+
+**Search Examples by Domain:**
+```bash
+# Flutter Widgets
+python3 .agent/workflows/scripts/search.py "ListView pagination" --top 5
+
+# Design Patterns
+python3 .agent/workflows/scripts/search.py "authentication login" --top 5
+
+# Charts
+python3 .agent/workflows/scripts/search.py "chart bar comparison" --top 5
+
+# Typography
+python3 .agent/workflows/scripts/search.py "font modern SaaS" --top 5
+
+# Colors by Product
+python3 .agent/workflows/scripts/search.py "fintech crypto dark" --top 5
+
+# UX Guidelines
+python3 .agent/workflows/scripts/search.py "touch target accessibility" --top 5
+
+# UI Styles
+python3 .agent/workflows/scripts/search.py "glassmorphism neumorphism" --top 5
+```
+
+### Step 3: Apply Technical Standards
+
+#### 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 .agent/workflows/scripts/search.py "form input text field" --top 5
+   ```
+
+2. **Search patterns:**
+   ```bash
+   python3 .agent/workflows/scripts/search.py "authentication login" --top 5
+   ```
+
+3. **Search packages:**
+   ```bash
+   python3 .agent/workflows/scripts/search.py "validation form" --stack riverpod --top 5
+   ```
+
+4. **Search colors:**
+   ```bash
+   python3 .agent/workflows/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
+- [ ] WCAG contrast requirements

package/assets/.agent/workflows/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