flutter-pro-max-cli 1.0.2 → 2.0.0

package/assets/.windsurf/workflows/scripts/core.py

@@ -1,345 +0,0 @@
-#!/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",
-        # When running from .agent/workflows/scripts/ (nested 3 levels deep)
-        script_dir.parent.parent.parent / ".shared" / "data",
-        # When running from .claude/skills/flutter-pro-max/scripts/ (nested 4 levels deep)
-        script_dir.parent.parent.parent.parent / ".shared" / "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

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

@@ -1,106 +0,0 @@
-#!/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/dist/utils/extract.js

@@ -1,83 +0,0 @@
-import { mkdir, rm, access, cp } from 'node:fs/promises';
-import { join, basename } from 'node:path';
-import { exec } from 'node:child_process';
-import { promisify } from 'node:util';
-import { AI_FOLDERS } from '../types/index.js';
-const execAsync = promisify(exec);
-const EXCLUDED_FILES = ['settings.local.json'];
-export async function extractZip(zipPath, destDir) {
-    try {
-        const isWindows = process.platform === 'win32';
-        if (isWindows) {
-            await execAsync(`powershell -Command "Expand-Archive -Path '${zipPath}' -DestinationPath '${destDir}' -Force"`);
-        }
-        else {
-            await execAsync(`unzip -o "${zipPath}" -d "${destDir}"`);
-        }
-    }
-    catch (error) {
-        throw new Error(`Failed to extract zip: ${error}`);
-    }
-}
-async function exists(path) {
-    try {
-        await access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export async function copyFolders(sourceDir, targetDir, aiType) {
-    const copiedFolders = [];
-    const foldersToCopy = aiType === 'all'
-        ? ['.claude', '.cursor', '.windsurf', '.agent', '.github', '.kiro', '.roo', '.codex', '.gemini', '.qoder', '.codebuddy', '.trae', '.shared']
-        : AI_FOLDERS[aiType];
-    // Deduplicate folders (e.g., .shared might be listed multiple times)
-    const uniqueFolders = [...new Set(foldersToCopy)];
-    for (const folder of uniqueFolders) {
-        const sourcePath = join(sourceDir, folder);
-        const targetPath = join(targetDir, folder);
-        // Check if source folder exists
-        const sourceExists = await exists(sourcePath);
-        if (!sourceExists) {
-            continue;
-        }
-        // Create target directory if needed
-        await mkdir(targetPath, { recursive: true });
-        // Filter function to exclude certain files
-        const filterFn = (src) => {
-            const fileName = basename(src);
-            return !EXCLUDED_FILES.includes(fileName);
-        };
-        // Copy recursively
-        try {
-            await cp(sourcePath, targetPath, { recursive: true, filter: filterFn });
-            copiedFolders.push(folder);
-        }
-        catch {
-            // Try shell fallback for older Node versions
-            try {
-                if (process.platform === 'win32') {
-                    await execAsync(`xcopy "${sourcePath}" "${targetPath}" /E /I /Y`);
-                }
-                else {
-                    await execAsync(`cp -r "${sourcePath}/." "${targetPath}"`);
-                }
-                copiedFolders.push(folder);
-            }
-            catch {
-                // Skip if copy fails
-            }
-        }
-    }
-    return copiedFolders;
-}
-export async function cleanup(tempDir) {
-    try {
-        await rm(tempDir, { recursive: true, force: true });
-    }
-    catch {
-        // Ignore cleanup errors
-    }
-}