@leejungkiin/awkit 1.3.4 → 1.3.8

package/bin/awk.js

@@ -27,6 +27,7 @@ const fs = require('fs');
 const path = require('path');
 const https = require('https');
 const { execSync, spawnSync } = require('child_process');
+const os = require('os');
 
 const packageJson = require(path.join(__dirname, '..', 'package.json'));
 const AWK_VERSION = packageJson.version;
@@ -1817,9 +1818,11 @@ async function cmdInit(forceFlag = false) {
         });
 
         const question = (query) => new Promise(resolve => rl.question(query, resolve));
+        // Sanitize: strip ALL whitespace (spaces, tabs, newlines) from pasted input
+        const sanitize = (s) => s.replace(/\s+/g, '');
 
         try {
-            const apiKey = (await question(`  ${C.yellow}Enter Trello API Key: ${C.reset}`)).trim();
+            const apiKey = sanitize(await question(`  ${C.yellow}Enter Trello API Key: ${C.reset}`));
 
             if (apiKey) {
                 const tokenUrl = `https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&key=${apiKey}&name=AWKit`;
@@ -1829,7 +1832,7 @@ async function cmdInit(forceFlag = false) {
                 log('');
             }
 
-            const apiToken = (await question(`  ${C.yellow}Enter Trello API Token: ${C.reset}`)).trim();
+            const apiToken = sanitize(await question(`  ${C.yellow}Enter Trello API Token: ${C.reset}`));
 
             if (apiKey && apiToken) {
                 let profilePath = path.join(os.homedir(), '.zshrc');
@@ -1840,13 +1843,17 @@ async function cmdInit(forceFlag = false) {
                 const exportLines = `\n# Trello API Credentials for AWKit\nexport TRELLO_KEY="${apiKey}"\nexport TRELLO_TOKEN="${apiToken}"\n`;
                 fs.appendFileSync(profilePath, exportLines);
                 
-                ok(`Credentials saved to ${profilePath}`);
-                log(`  ${C.cyan}👉 Please run 'source ~/${path.basename(profilePath)}' or restart your terminal to apply them.${C.reset}`);
+                // Also inject into current process so immediate awkit trello calls work
+                process.env.TRELLO_KEY = apiKey;
+                process.env.TRELLO_TOKEN = apiToken;
+                
+                ok(`Credentials saved to ${path.basename(profilePath)} ✅`);
+                log(`  ${C.green}👉 Trello is ready! Credentials are active for this session and all future terminals.${C.reset}`);
             } else {
                 warn('Setup skipped. Automated Trello sync will be disabled.');
             }
         } catch (e) {
-            warn('Failed to setup Trello interactively.');
+            warn(`Failed to setup Trello: ${e.message}`);
         } finally {
             rl.close();
         }
@@ -2194,12 +2201,12 @@ function cmdTrello(args) {
     const subCmd = args[0];
     const text = args.slice(1).join(' ');
 
-    if (!subCmd || subCmd === 'help') {
+    if (!subCmd || subCmd === 'help' || subCmd === '--help' || subCmd === '-h') {
         trelloHelp();
         return;
     }
 
-    if (!text && subCmd !== 'help') {
+    if (!text) {
         err(`Missing argument for 'trello ${subCmd}'. Usage: awkit trello ${subCmd} <text>`);
         return;
     }
@@ -2207,7 +2214,7 @@ function cmdTrello(args) {
     switch (subCmd) {
         case 'desc':
             info(`Updating card description...`);
-            trelloExec(['card:update', '--desc', text]);
+            trelloExec(['card:update', '--description', text]);
             break;
 
         case 'comment':
@@ -2216,12 +2223,51 @@ function cmdTrello(args) {
             break;
 
         case 'item':
-            // trello-cli doesn't support adding checklist items natively.
-            // We fall back to marking an item incomplete (which implicitly creates it in some versions)
-            // or inform the user to use the REST API.
-            info(`Adding checklist item: ${text}`);
-            warn('Note: trello-cli may not support adding items. Use REST API if this fails.');
-            trelloExec(['card:check-item', '--item', text, '--state', 'incomplete']);
+            info(`Adding checklist item via REST API: ${text}`);
+            const credItem = trelloLoadCredentials();
+            const cfgItem = trelloLoadProjectConfig();
+            if (!credItem || !cfgItem) {
+                err("Credentials or config missing for REST API fallback.");
+                break;
+            }
+            
+            // 1. Get checklists
+            const clRes = spawnSync('npx', ['--yes', 'trello-cli', 'card:checklists', '--board', cfgItem.board, '--list', cfgItem.list, '--card', cfgItem.card, '--format', 'json'], { env: { ...process.env, TRELLO_KEY: credItem.api_key, TRELLO_TOKEN: credItem.api_token }, encoding: 'utf-8' });
+            
+            if (clRes.status !== 0) {
+                err(`Failed to get checklists: ${clRes.stderr || clRes.stdout}`);
+                break;
+            }
+            
+            try {
+                // Sometime trello-cli outputs to stdout along with some other logs.
+                // We extract the JSON array part.
+                const outText = clRes.stdout;
+                const jsonStr = outText.substring(outText.indexOf('['));
+                const checklists = JSON.parse(jsonStr);
+                
+                if (!checklists || checklists.length === 0) {
+                    err("No checklists found on card. Create one first using 'awkit trello checklist <name>'.");
+                    break;
+                }
+                
+                // Add to the LAST checklist (most recently appended usually)
+                const targetChecklist = checklists[checklists.length - 1];
+                const checklistId = targetChecklist.id;
+                
+                // 2. Add item via curl
+                const url = `https://api.trello.com/1/checklists/${checklistId}/checkItems?name=${encodeURIComponent(text)}&key=${credItem.api_key}&token=${credItem.api_token}`;
+                const addRes = spawnSync('curl', ['-s', '-X', 'POST', url], { encoding: 'utf-8' });
+                
+                const responseJson = JSON.parse(addRes.stdout);
+                if (responseJson.id) {
+                    ok(`Item added successfully to checklist "${targetChecklist.name}".`);
+                } else {
+                    err(`Failed to add item via REST API: ${addRes.stdout}`);
+                }
+            } catch (e) {
+                err(`Failed to parse checklists or execute curl: ${e.message}`);
+            }
             break;
 
         case 'complete':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leejungkiin/awkit",
-  "version": "1.3.4",
+  "version": "1.3.8",
   "description": "Antigravity Workflow Kit. Unified AI agent orchestration system.",
   "main": "bin/awk.js",
   "bin": {
@@ -40,4 +40,4 @@
     "@leejungkiin/awkit-symphony": "^0.1.0",
     "@leejungkiin/gitnexus": "file:../gitnexus/gitnexus"
   }
-}
+}

package/skill-packs/superpowers/skills/single-flow-task-execution/SKILL.md

@@ -110,6 +110,56 @@ digraph process {
 }
 ```
 
+## UI-First Task Ordering (Gate 4 Three-Phase — v12.3)
+
+When a task set includes UI components (COMPLEX or MODERATE), tasks MUST be ordered in three phases:
+
+### Phase A: Infrastructure Tasks
+```
+Priority: Execute FIRST
+Examples:
+  - Add dependencies (Gradle, SPM, CocoaPods)
+  - Create project structure (packages, modules, DI)
+  - Set up navigation skeleton (NavGraph, Router)
+  - Configure build variants, signing
+Gate: App MUST build successfully → proceed
+```
+
+### Phase B: UI Shell Tasks (Mock Data)
+```
+Priority: Execute SECOND, BEFORE any logic tasks
+Examples:
+  - Build all screen layouts with static/mock data
+  - Implement navigation between screens
+  - Add animations, transitions, loading/empty/error states
+  - Wire up UI components (no real API/DB calls)
+Gate: 🧪 USER TEST CHECKPOINT — user must test UI on device
+  → Present test guidance (see symphony-enforcer TP1.7)
+  → User confirms UI OK → proceed to Phase C
+  → User reports issue → fix → re-checkpoint
+```
+
+### Phase C: Logic Tasks (Per Feature)
+```
+Priority: Execute LAST, after UI is confirmed
+Examples:
+  - Replace mock data with real API/DB calls
+  - Implement business logic, validation
+  - Add error handling, retry, offline support
+  - Wire up hardware features (camera, GPS, sensors)
+Gate: 🧪 USER TEST CHECKPOINT per feature (batch small ones)
+  → Especially important for hardware-dependent features
+```
+
+### Task Sorting Rule
+```
+When creating task list from implementation plan:
+1. Tag each task: [INFRA] [UI] [LOGIC]  
+2. Sort: INFRA first → UI second → LOGIC last
+3. Within each phase: respect dependency ordering
+4. Between phases: MANDATORY checkpoint where indicated
+```
+
 ## Task Decomposition
 
 When facing multiple problems (e.g., 5 test failures across 3 files):

package/skills/admob-roas/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: admob-roas
+description: When the user wants to implement AdMob ROAS tracking, track ad impressions to Firebase, or optimize in-app ad revenue events in Native Android (Kotlin) or iOS (Swift). Also use when the user mentions "tROAS", "ad_impression", "OnPaidEventListener", "paidEventHandler", or "admob ROAS event".
+metadata:
+  version: 1.0.0
+---
+
+# ROAS Event Tracking cho AdMob (Native Android & iOS)
+
+You are an expert in mobile app analytics and AdMob monetization. Your goal is to help the user implement ROAS event tracking (`ad_impression`) for AdMob in Native Android (Kotlin) and iOS (Swift).
+
+> **🎯 Mục tiêu**: Đảm bảo Firebase Analytics nhận được sự kiện `ad_impression` kèm theo giá trị doanh thu (`value`, `currency`) mỗi khi quảng cáo hiển thị. Điều này **bắt buộc** để Google Ads / Facebook Ads có thể chạy tROAS (Target Return On Ad Spend) campaign.
+
+---
+
+## 1. Yêu Cầu Cốt Lõi (Requirements)
+
+Khi AI Agent được giao nhiệm vụ tích hợp quảng cáo (AdMob) vào dự án Native Android (Kotlin) hoặc iOS (Swift), **LUÔN** phải đảm bảo:
+- SDK `Firebase Analytics` đã được cài đặt và khởi tạo.
+- Bắt sự kiện **OnPaidEventListener** (Android) hoặc **paidEventHandler** (iOS) trên TẤT CẢ các loại quảng cáo: Banner, Interstitial, Rewarded, AppOpen, Native.
+- Convert chuẩn xác giá trị vi mô (`valueMicros` / `NSDecimalNumber`) ra giá trị thập phân thực.
+- Bắn event `ad_impression` về Firebase.
+
+---
+
+## 2. Standard Pattern: Android (Kotlin)
+
+### Bước 1: Tạo Helper/Tracker Class
+
+Tạo file `RoasTracker.kt` ở package data/analytics:
+
+```kotlin
+import android.os.Bundle
+import com.google.android.gms.ads.AdValue
+import com.google.android.gms.ads.AdapterResponseInfo
+import com.google.firebase.analytics.FirebaseAnalytics
+
+object RoasTracker {
+    fun trackAdMobImpression(
+        firebaseAnalytics: FirebaseAnalytics, 
+        adValue: AdValue, 
+        responseInfo: AdapterResponseInfo?, 
+        adFormat: String
+    ) {
+        val valueMicros = adValue.valueMicros
+        val currencyCode = adValue.currencyCode
+        val valueDouble = valueMicros / 1_000_000.0 // Convert sang dạng float/double
+        
+        val bundle = Bundle().apply {
+            putString(FirebaseAnalytics.Param.AD_PLATFORM, "admob")
+            putString(FirebaseAnalytics.Param.AD_SOURCE, responseInfo?.adSourceName ?: "AdMob")
+            putString(FirebaseAnalytics.Param.AD_FORMAT, adFormat)
+            putDouble(FirebaseAnalytics.Param.VALUE, valueDouble)
+            putString(FirebaseAnalytics.Param.CURRENCY, currencyCode)
+        }
+        
+        firebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, bundle)
+    }
+}
+```
+
+### Bước 2: Tích hợp vào Ad Lifecycle
+
+**Ví dụ với AppOpenAd / InterstitialAd:**
+```kotlin
+interstitialAd?.onPaidEventListener = OnPaidEventListener { adValue ->
+    RoasTracker.trackAdMobImpression(
+        firebaseAnalytics = FirebaseAnalytics.getInstance(context),
+        adValue = adValue,
+        responseInfo = interstitialAd?.responseInfo?.loadedAdapterResponseInfo,
+        adFormat = "interstitial"
+    )
+}
+```
+
+---
+
+## 3. Standard Pattern: iOS (Swift)
+
+### Bước 1: Tạo Helper/Tracker Struct
+
+Tạo file `RoasTracker.swift`:
+
+```swift
+import Foundation
+import FirebaseAnalytics
+import GoogleMobileAds
+
+struct RoasTracker {
+    static func trackAdMobImpression(
+        adValue: GADAdValue, 
+        responseInfo: GADAdNetworkResponseInfo?, 
+        adFormat: String
+    ) {
+        let value = adValue.value.doubleValue
+        let currency = adValue.currencyCode
+        
+        Analytics.logEvent(AnalyticsEventAdImpression, parameters: [
+            AnalyticsParameterAdPlatform: "admob",
+            AnalyticsParameterAdSource: responseInfo?.adNetworkClassName ?? "AdMob",
+            AnalyticsParameterAdFormat: adFormat,
+            AnalyticsParameterValue: value,
+            AnalyticsParameterCurrency: currency
+        ])
+    }
+}
+```
+
+### Bước 2: Tích hợp vào Ad Lifecycle
+
+**Ví dụ với GADRewardedAd:**
+```swift
+rewardedAd?.paidEventHandler = { [weak rewardedAd] adValue in
+    guard let ad = rewardedAd else { return }
+    RoasTracker.trackAdMobImpression(
+        adValue: adValue,
+        responseInfo: ad.responseInfo?.loadedAdNetworkResponseInfo,
+        adFormat: "rewarded"
+    )
+}
+```
+
+---
+
+## 4. Kiểm tra Validation
+
+Một luồng ROAS hợp lệ phải có đủ các yếu tố sau:
+1. Bạn phải đăng ký `OnPaidEventListener` NGAY SAU KHI Ad báo quá trình load thành công (trong `onAdLoaded`).
+2. Log output phải hiển thị event `ad_impression` trong Logcat (hoặc Xcode console) qua chế độ `-enable_core_ads` hoặc Firebase Verbose logging `adb shell setprop log.tag.FA VERBOSE`.
+3. Kiểm tra các event onboarding `tutorial_begin` và `tutorial_complete` để đảm bảo luồng cài đặt và sử dụng ứng dụng được tracking liên kết.