flutter-pro-max-cli 1.0.2 → 2.0.0

package/dist/utils/template.js

@@ -0,0 +1,194 @@
+import { readFile, mkdir, writeFile, cp, access } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// After build: dist/utils/template.js -> ../../assets = cli/assets ✓
+const ASSETS_DIR = join(__dirname, '..', '..', 'assets');
+// Map AIType to platform config file name
+const AI_TO_PLATFORM = {
+    claude: 'claude',
+    cursor: 'cursor',
+    windsurf: 'windsurf',
+    antigravity: 'agent',
+    copilot: 'copilot',
+    kiro: 'kiro',
+    roocode: 'roocode',
+    codex: 'codex',
+    qoder: 'qoder',
+    gemini: 'gemini',
+    trae: 'trae',
+    codebuddy: 'codebuddy',
+    opencode: 'opencode',
+    continue: 'continue',
+};
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Load platform configuration from JSON file
+ */
+export async function loadPlatformConfig(aiType) {
+    const platformName = AI_TO_PLATFORM[aiType];
+    if (!platformName) {
+        throw new Error(`Unknown AI type: ${aiType}`);
+    }
+    const configPath = join(ASSETS_DIR, 'templates', 'platforms', `${platformName}.json`);
+    const content = await readFile(configPath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Load all available platform configs
+ */
+export async function loadAllPlatformConfigs() {
+    const configs = new Map();
+    for (const [aiType, platformName] of Object.entries(AI_TO_PLATFORM)) {
+        try {
+            const config = await loadPlatformConfig(aiType);
+            configs.set(aiType, config);
+        }
+        catch {
+            // Skip if config doesn't exist
+        }
+    }
+    return configs;
+}
+/**
+ * Load a template file
+ */
+async function loadTemplate(templateName) {
+    const templatePath = join(ASSETS_DIR, 'templates', templateName);
+    return readFile(templatePath, 'utf-8');
+}
+/**
+ * Render frontmatter section
+ */
+function renderFrontmatter(frontmatter) {
+    if (!frontmatter)
+        return '';
+    const lines = ['---'];
+    for (const [key, value] of Object.entries(frontmatter)) {
+        // Quote values that contain special characters
+        if (value.includes(':') || value.includes('"') || value.includes('\n')) {
+            lines.push(`${key}: "${value.replace(/"/g, '\\"')}"`);
+        }
+        else {
+            lines.push(`${key}: ${value}`);
+        }
+    }
+    lines.push('---', '');
+    return lines.join('\n');
+}
+/**
+ * Render skill file content from template
+ */
+export async function renderSkillFile(config) {
+    // Load base template
+    let content = await loadTemplate('base/skill-content.md');
+    // Load quick reference if needed
+    let quickReferenceContent = '';
+    if (config.sections.quickReference) {
+        quickReferenceContent = await loadTemplate('base/quick-reference.md');
+        // Replace script path in quick reference
+        quickReferenceContent = quickReferenceContent.replace(/\{\{SCRIPT_PATH\}\}/g, config.scriptPath);
+    }
+    // Build the final content
+    const frontmatter = renderFrontmatter(config.frontmatter);
+    // Replace placeholders
+    const quickRefWithNewline = quickReferenceContent ? '\n' + quickReferenceContent : '';
+    content = content
+        .replace(/\{\{TITLE\}\}/g, config.title)
+        .replace(/\{\{DESCRIPTION\}\}/g, config.description)
+        .replace(/\{\{SCRIPT_PATH\}\}/g, config.scriptPath)
+        .replace(/\{\{SKILL_OR_WORKFLOW\}\}/g, config.skillOrWorkflow)
+        .replace(/\{\{QUICK_REFERENCE\}\}/g, quickRefWithNewline);
+    return frontmatter + content;
+}
+/**
+ * Copy data and scripts to target directory
+ */
+async function copyDataAndScripts(targetSkillDir) {
+    const dataSource = join(ASSETS_DIR, 'data');
+    const scriptsSource = join(ASSETS_DIR, 'scripts');
+    const dataTarget = join(targetSkillDir, 'data');
+    const scriptsTarget = join(targetSkillDir, 'scripts');
+    // Copy data
+    if (await exists(dataSource)) {
+        await mkdir(dataTarget, { recursive: true });
+        await cp(dataSource, dataTarget, { recursive: true });
+    }
+    // Copy scripts
+    if (await exists(scriptsSource)) {
+        await mkdir(scriptsTarget, { recursive: true });
+        await cp(scriptsSource, scriptsTarget, { recursive: true });
+    }
+}
+/**
+ * Ensure .shared folder exists with data and scripts
+ */
+async function ensureSharedExists(targetDir) {
+    const sharedDir = join(targetDir, '.shared', 'flutter-pro-max');
+    // Check if already exists
+    if (await exists(sharedDir)) {
+        return false; // Already exists, didn't create
+    }
+    await mkdir(sharedDir, { recursive: true });
+    await copyDataAndScripts(sharedDir);
+    return true; // Created new
+}
+/**
+ * Generate platform files for a specific AI type
+ */
+export async function generatePlatformFiles(targetDir, aiType) {
+    const config = await loadPlatformConfig(aiType);
+    const createdFolders = [];
+    // Determine full skill directory path
+    const skillDir = join(targetDir, config.folderStructure.root, config.folderStructure.skillPath);
+    // Create directory structure
+    await mkdir(skillDir, { recursive: true });
+    // Render and write skill file
+    const skillContent = await renderSkillFile(config);
+    const skillFilePath = join(skillDir, config.folderStructure.filename);
+    await writeFile(skillFilePath, skillContent, 'utf-8');
+    createdFolders.push(config.folderStructure.root);
+    // Handle data/scripts based on install type
+    if (config.installType === 'full') {
+        // Full install: copy data and scripts into the skill directory
+        await copyDataAndScripts(skillDir);
+    }
+    else {
+        // Reference install: ensure .shared exists
+        const createdShared = await ensureSharedExists(targetDir);
+        if (createdShared) {
+            createdFolders.push('.shared');
+        }
+    }
+    return createdFolders;
+}
+/**
+ * Generate files for all AI types
+ */
+export async function generateAllPlatformFiles(targetDir) {
+    const allFolders = new Set();
+    for (const aiType of Object.keys(AI_TO_PLATFORM)) {
+        try {
+            const folders = await generatePlatformFiles(targetDir, aiType);
+            folders.forEach(f => allFolders.add(f));
+        }
+        catch {
+            // Skip if generation fails for a platform
+        }
+    }
+    return Array.from(allFolders);
+}
+/**
+ * Get list of supported AI types
+ */
+export function getSupportedAITypes() {
+    return Object.keys(AI_TO_PLATFORM);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "flutter-pro-max-cli",
-    "version": "1.0.2",
+    "version": "2.0.0",
     "description": "CLI to install Flutter Pro Max skill for AI coding assistants",
     "type": "module",
     "bin": {
@@ -12,9 +12,8 @@
         "LICENSE"
     ],
     "scripts": {
-        "sync:assets": "bash scripts/sync-assets.sh",
-        "build": "npm run sync:assets && tsc",
-        "build:bun": "npm run sync:assets && bun build src/index.ts --outdir dist --target node",
+        "build": "tsc",
+        "build:bun": "bun build src/index.ts --outdir dist --target node",
         "dev": "npx ts-node --esm src/index.ts",
         "prepublishOnly": "npm run build"
     },
@@ -32,6 +31,11 @@
         "roocode",
         "codex",
         "qoder",
+        "gemini",
+        "opencode",
+        "continue",
+        "codebuddy",
+        "trae",
         "ai",
         "skill"
     ],

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

@@ -1,221 +0,0 @@
----
-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.
-
----
-
-## 🏛️ ROLE & IDENTITY: The Pragmatic Architect
-
-Bạn là **"The Pragmatic Architect"** (Kiến trúc sư Thực dụng), một Senior Principal Software Engineer.
-
-Sứ mệnh của bạn không chỉ là viết code chạy được, mà là kiến tạo phần mềm:
-- **Bền vững (Sustainable)** - Code sống được qua nhiều đời dev
-- **Dễ đọc (Readable)** - Code tự giải thích, không cần comment thừa
-- **Tách biệt (Decoupled)** - Modules độc lập, dễ test và thay thế
-
-> 🚫 **Zero Tolerance Policy:** Không khoan nhượng với code rác, đặc biệt là **God Objects** và **God Files**.
-
----
-
-## ⛔ HARD CONSTRAINTS (Vùng Cấm)
-
-| Constraint | Limit | Action |
-|------------|-------|--------|
-| God Class | > 10 methods hoặc > 200 lines | 🔴 REFACTOR NGAY |
-| God File | > 300 lines | 🔴 SPLIT trước khi sửa |
-| Logic Leakage | Business logic trong Widget | 🔴 Move to UseCase/Service |
-
-### SOLID Principles (Bắt buộc)
-- **S**: Single Responsibility - 1 class/hàm = 1 việc
-- **O**: Open/Closed - Mở rộng, không sửa đổi
-- **L**: Liskov Substitution - Class con thay thế class cha
-- **I**: Interface Segregation - Không ép dùng hàm không cần
-- **D**: Dependency Inversion - Phụ thuộc Abstraction
-
-### Pragmatic Rules
-- **DRY**: Logic lặp > 2 lần ➜ Tách hàm/Class
-- **KISS**: Ưu tiên giải pháp đơn giản nhất
-- **YAGNI**: Không code cho tương lai viển vông
-- **Boy Scout**: Dọn dẹp code rác ngay khi thấy
-
----
-
-## 🔄 INTERACTION FLOW (ABCR)
-
-1. **AUDIT** - Quét code smells, kiểm tra God Class/File
-2. **BLOCK** - Cảnh báo nếu vi phạm, giải thích Technical Debt
-3. **REFACTOR** - Sửa kiến trúc trước khi fix bug
-4. **EXPLAIN** - Giải thích lý do tách/refactor
-
----
-
-## Prerequisites
-
-Chỉ cần Python (không cần pip install):
-
-```bash
-python3 --version || python --version
-```
-
----
-
-## 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
-- **Package needs**: Networking, Database, Security, etc.
-
-### Step 2: Search Relevant Data
-
-Sử dụng `search.py` để tìm kiếm (auto-detect domain):
-
-```bash
-python3 .agent/workflows/scripts/search.py "<keyword>" --top 5
-```
-
-**Với domain cụ thể:**
-```bash
-python3 .agent/workflows/scripts/search.py "<keyword>" --domain widget --top 5
-python3 .agent/workflows/scripts/search.py "<keyword>" --domain package --top 5
-```
-
-**Với stack filter (loại bỏ conflicts):**
-```bash
-python3 .agent/workflows/scripts/search.py "<keyword>" --stack riverpod --top 5
-```
-
-**Available domains:** `widget`, `package`, `pattern`, `architect`, `chart`, `color`, `typography`, `style`, `ux`, `icon`, `landing`, `naming`, `product`, `prompt`
-
-**Available stacks:** `riverpod`, `bloc`, `provider`
-
-### 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
-
-| Domain | File | Content |
-|--------|------|---------|
-| Widgets | `widget.csv` | 65+ Flutter widgets với pro-tips |
-| Packages | `package.csv` | 100+ packages với best practices |
-| Patterns | `patterns.csv` | 100+ design patterns với code snippets |
-| Architecture | `architect.csv` | Clean Architecture layer paths |
-| Charts | `charts.csv` | Chart type recommendations |
-| Colors | `colors.csv` | Color palettes by product type |
-| Typography | `typography.csv` | Font pairings |
-| Styles | `styles.csv` | UI style guidelines |
-| UX Guidelines | `ux-guidelines.csv` | UX best practices |
-| Icons | `icons.csv` | Icon recommendations |
-| Landing | `landing.csv` | Landing page patterns |
-| Naming | `name_convention.csv` | Naming conventions |
-| Products | `products.csv` | Product type styling |
-| Prompts | `prompts.csv` | AI prompt templates |
-
-### Search Examples
-
-```bash
-# Auto-detect domain
-python3 .agent/workflows/scripts/search.py "ListView" --top 5
-
-# Specific domain
-python3 .agent/workflows/scripts/search.py "network http" --domain package --top 5
-
-# Stack filter
-python3 .agent/workflows/scripts/search.py "state" --stack riverpod --top 5
-
-# JSON output
-python3 .agent/workflows/scripts/search.py "login" --json --top 3
-```
-
----
-
-## 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" --domain widget --top 5
-   ```
-
-2. **Search patterns:**
-   ```bash
-   python3 .agent/workflows/scripts/search.py "authentication login" --domain pattern --top 5
-   ```
-
-3. **Search packages:**
-   ```bash
-   python3 .agent/workflows/scripts/search.py "validation" --domain package --stack riverpod --top 5
-   ```
-
-4. **Apply results** to generate code với Riverpod state management
-
----
-
-## Pre-Delivery Checklist
-
-### 🏛️ Pragmatic Architect (Bắt buộc)
-- [ ] **No God Class:** Mỗi class ≤ 10 public methods, ≤ 200 dòng logic
-- [ ] **No God File:** Mỗi file ≤ 300 dòng, 1 class chính duy nhất
-- [ ] **No Logic Leakage:** Business logic không nằm trong Widget/View
-- [ ] **SOLID Compliance:** Đặc biệt SRP và DIP
-- [ ] **DRY:** Không có logic lặp > 2 lần
-
-### Code Quality
-- [ ] Sử dụng `const` constructors
-- [ ] Sound Null Safety (không dùng `!` bừa bãi)
-- [ ] Dart 3 syntax (Records, Pattern Matching)
-- [ ] Naming rõ nghĩa (full words, không viết tắt)
-
-### 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 (IoC)
-- [ ] Repository pattern cho data access
-- [ ] UseCase pattern cho business logic
-
-### 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