@leejungkiin/awkit 1.7.1 → 1.7.4

package/skills/smali-to-kotlin/examples/pipeline/scanner-and-bootstrap.md

@@ -0,0 +1,106 @@
+# Step 0: Library Scanner (PRE-STEP — Always First) 🔍
+
+**Purpose:** Scan the APK structure to identify all third-party libraries before any coding.
+
+## Process
+
+1. **Scan `smali/` directories** for package patterns:
+   ```
+   smali/com/google/      → Google SDKs
+   smali/com/facebook/    → Facebook SDK
+   smali/com/squareup/    → OkHttp, Retrofit, Picasso
+   smali/io/reactivex/    → RxJava
+   smali/org/greenrobot/  → EventBus
+   smali/com/bumptech/    → Glide
+   smali/com/airbnb/      → Lottie
+   smali/androidx/         → AndroidX (baseline)
+   smali/com/jakewharton/ → Butterknife, Timber
+   ```
+
+2. **Check `lib/` for native libraries (.so)**:
+   ```
+   lib/arm64-v8a/*.so     → 64-bit native libs
+   lib/armeabi-v7a/*.so   → 32-bit native libs
+   ```
+
+3. **Check `assets/` for embedded resources:**
+   - ML models (.tflite, .onnx)
+   - WebView HTML/JS bundles
+   - Config files (JSON, XML)
+
+4. **Output: Library Report**
+   ```markdown
+   ## 📦 Library Detection Report
+   
+   ### ✅ Can Reuse (add to build.gradle)
+   | Library | Detected Package | Latest Version | Action |
+   |---------|-----------------|----------------|--------|
+   | Retrofit | com.squareup.retrofit2 | 2.9.0 | Add dependency |
+   | OkHttp | com.squareup.okhttp3 | 4.12.0 | Add dependency |
+   | Glide | com.bumptech.glide | 4.16.0 | Evaluate → Coil? |
+   
+   ### 🔄 Must Replace (legacy)
+   | Old Library | Detected Package | Replacement |
+   |-------------|-----------------|-------------|
+   | Volley | com.android.volley | Retrofit |
+   | AsyncTask | android.os.AsyncTask | Coroutines |
+   
+   ### 📱 Native (.so) — Keep As-Is
+   | File | Architecture | Notes |
+   |------|-------------|-------|
+   | libfoo.so | arm64-v8a | Need JNI bridge |
+   ```
+
+---
+
+# Step 1: AndroidManifest Analysis & Project Bootstrap 📄
+
+**Input:** User provides `AndroidManifest.xml` from Apktool output.
+
+## Tasks
+
+1. Extract Application ID and original package name
+2. List all required permissions (group by category)
+3. Identify entry points: Application class, SplashActivity, MainActivity
+4. Map all components:
+   - Activities → future Compose screens
+   - Services → WorkManager candidates?
+   - BroadcastReceivers → keep or replace with Flow?
+   - ContentProviders → keep or replace with Room?
+5. Detect intent-filters for deep links
+6. **Output:** Propose Clean Architecture project structure
+
+## Project Structure Template
+
+```
+app/src/main/java/com/package/app/
+├── App.kt                        # Application class
+├── di/                           # Hilt modules
+│   ├── AppModule.kt
+│   ├── NetworkModule.kt
+│   └── DatabaseModule.kt
+├── data/                         # Data Layer
+│   ├── remote/
+│   │   ├── api/                  # Retrofit interfaces
+│   │   ├── dto/                  # Data Transfer Objects
+│   │   └── interceptor/          # OkHttp interceptors
+│   ├── local/
+│   │   ├── db/                   # Room database
+│   │   ├── dao/                  # Room DAOs
+│   │   ├── entity/               # Room entities
+│   │   └── datastore/            # DataStore preferences
+│   └── repository/               # Repository implementations
+├── domain/                       # Domain Layer
+│   ├── model/                    # Business models
+│   ├── repository/               # Repository interfaces
+│   └── usecase/                  # Use cases
+├── presentation/                 # Presentation Layer
+│   ├── navigation/               # NavGraph + Routes
+│   ├── theme/                    # Material 3 Theme
+│   ├── components/               # Reusable Compose components
+│   └── screens/                  # Feature screens
+│       ├── splash/
+│       ├── home/
+│       └── ...
+└── util/                         # Extensions, helpers
+```

package/skills/smali-to-kotlin/library-patterns.md

@@ -0,0 +1,189 @@
+# 📦 Library Detection Patterns
+
+> Reference database for Step 0 (Library Scanner).
+> Agent uses these patterns to identify third-party libraries from Smali package structure.
+
+---
+
+## 🟢 Network & API
+
+| Package Pattern | Library | Latest Replacement | Action |
+|----------------|---------|-------------------|--------|
+| `com/squareup/retrofit2` | Retrofit 2 | Keep (current) | Add to build.gradle |
+| `com/squareup/okhttp3` | OkHttp 3 | Keep (current) | Add to build.gradle |
+| `com/android/volley` | Volley | Retrofit + OkHttp | Replace |
+| `com/squareup/okhttp` | OkHttp 2 | OkHttp 4 | Upgrade |
+| `com/loopj/android` | AsyncHttpClient | Retrofit | Replace |
+| `org/apache/http` | Apache HTTP | OkHttp | Replace |
+| `com/squareup/moshi` | Moshi | Keep (current) | Add to build.gradle |
+| `com/google/gson` | Gson | kotlinx.serialization | Evaluate |
+
+---
+
+## 🟡 Image Loading
+
+| Package Pattern | Library | Latest Replacement | Action |
+|----------------|---------|-------------------|--------|
+| `com/bumptech/glide` | Glide | Coil (Compose-native) | Evaluate |
+| `com/squareup/picasso` | Picasso | Coil | Replace |
+| `com/facebook/fresco` | Fresco | Coil | Replace |
+| `com/nostra13/universalimageloader` | UIL | Coil | Replace |
+| `io/coil` | Coil | Keep (current) | Add to build.gradle |
+
+---
+
+## 🔵 Reactive Programming
+
+| Package Pattern | Library | Latest Replacement | Action |
+|----------------|---------|-------------------|--------|
+| `io/reactivex/rxjava3` | RxJava 3 | Coroutines + Flow | Gradual migrate |
+| `io/reactivex/rxjava2` | RxJava 2 | Coroutines + Flow | Replace |
+| `io/reactivex` | RxJava 1 | Coroutines + Flow | Replace |
+| `io/reactivex/rxandroid` | RxAndroid | Dispatchers.Main | Replace |
+
+---
+
+## 🟠 Dependency Injection
+
+| Package Pattern | Library | Latest Replacement | Action |
+|----------------|---------|-------------------|--------|
+| `dagger/hilt` | Hilt | Keep (current) | Add to build.gradle |
+| `com/google/dagger` | Dagger 2 | Hilt | Upgrade |
+| `org/koin` | Koin | Keep or Hilt | Evaluate |
+| `toothpick` | Toothpick | Hilt | Replace |
+
+---
+
+## 🟣 Firebase & Google
+
+| Package Pattern | Library | Action |
+|----------------|---------|--------|
+| `com/google/firebase/analytics` | Firebase Analytics | Add latest |
+| `com/google/firebase/crashlytics` | Crashlytics | Add latest |
+| `com/google/firebase/messaging` | FCM | Add latest |
+| `com/google/firebase/auth` | Firebase Auth | Add latest |
+| `com/google/firebase/firestore` | Firestore | Add latest |
+| `com/google/firebase/database` | Realtime DB | Add latest |
+| `com/google/firebase/storage` | Cloud Storage | Add latest |
+| `com/google/firebase/config` | Remote Config | Add latest |
+| `com/google/android/gms/ads` | AdMob | Add latest |
+| `com/google/android/gms/auth` | Google Sign-In | Add latest |
+| `com/google/android/gms/maps` | Google Maps | Add latest |
+| `com/google/android/gms/location` | Location Services | Add latest |
+| `com/google/android/play` | Play Core | Add latest |
+
+---
+
+## 🔴 Social SDKs
+
+| Package Pattern | Library | Action |
+|----------------|---------|--------|
+| `com/facebook/login` | Facebook Login | Add latest |
+| `com/facebook/share` | Facebook Share | Add latest |
+| `com/facebook/appevents` | Facebook Analytics | Add latest |
+| `com/twitter` | Twitter SDK | Evaluate (deprecated?) |
+| `com/kakao` | Kakao SDK | Add latest |
+| `com/linecorp` | LINE SDK | Add latest |
+
+---
+
+## 🟤 UI & Animation
+
+| Package Pattern | Library | Latest Replacement | Action |
+|----------------|---------|-------------------|--------|
+| `com/airbnb/lottie` | Lottie | Keep (has Compose support) | Add to build.gradle |
+| `com/github/bumptech/glide` | Glide Transformations | Compose modifiers | Evaluate |
+| `com/makeramen/roundedimageview` | RoundedImageView | Compose `clip(CircleShape)` | Replace |
+| `de/hdodenhof/circleimageview` | CircleImageView | Compose `clip(CircleShape)` | Replace |
+| `com/github/chrisbanes` | PhotoView | Compose zoomable | Replace |
+| `com/google/android/material` | Material Components | Material 3 (Compose) | Upgrade |
+| `com/jakewharton/butterknife` | Butterknife | Not needed (Compose) | Remove |
+| `androidx/viewpager2` | ViewPager2 | HorizontalPager (Compose) | Replace |
+| `androidx/cardview` | CardView | Card (Material 3 Compose) | Replace |
+| `androidx/recyclerview` | RecyclerView | LazyColumn/LazyGrid | Replace |
+| `androidx/swiperefreshlayout` | SwipeRefresh | pullRefresh modifier | Replace |
+| `com/github/PhilJay/MPAndroidChart` | MPAndroidChart | Vico / Compose Charts | Evaluate |
+
+---
+
+## ⚪ Database & Storage
+
+| Package Pattern | Library | Latest Replacement | Action |
+|----------------|---------|-------------------|--------|
+| `androidx/room` | Room | Keep (current) | Add to build.gradle |
+| `io/realm` | Realm | Room | Evaluate |
+| `net/sqlcipher` | SQLCipher | Room + encrypted | Keep |
+| `com/google/protobuf` | Protocol Buffers | Keep | Add to build.gradle |
+| `com/tencent/mmkv` | MMKV | DataStore | Evaluate |
+
+---
+
+## ⚫ Utility
+
+| Package Pattern | Library | Latest Replacement | Action |
+|----------------|---------|-------------------|--------|
+| `com/jakewharton/timber` | Timber | Keep (current) | Add to build.gradle |
+| `org/greenrobot/eventbus` | EventBus | SharedFlow | Replace |
+| `com/google/zxing` | ZXing (QR/Barcode) | ML Kit Barcode | Evaluate |
+| `com/journeyapps/barcodescanner` | ZXing Android | ML Kit Barcode | Evaluate |
+| `com/github/permissions` | Various permission libs | Accompanist Permissions | Replace |
+| `pub/devrel/easypermissions` | EasyPermissions | Accompanist Permissions | Replace |
+| `org/jsoup` | Jsoup | Keep (HTML parsing) | Add to build.gradle |
+| `com/google/android/exoplayer2` | ExoPlayer | Media3 ExoPlayer | Upgrade |
+| `androidx/media3` | Media3 | Keep (current) | Add to build.gradle |
+
+---
+
+## 🔐 Security & Encryption
+
+| Package Pattern | Library | Action |
+|----------------|---------|--------|
+| `com/scottyab/rootbeer` | RootBeer | Evaluate |
+| `io/jsonwebtoken` | JJWT | Keep |
+| `org/bouncycastle` | BouncyCastle | Keep |
+| `net/sqlcipher` | SQLCipher | Keep |
+
+---
+
+## 🔍 Detection Strategy
+
+### Step 1: Directory Scan
+```bash
+# List all top-level smali packages
+ls -d smali/*/
+ls -d smali_classes*/*/   # multi-dex apps
+
+# Find specific library patterns
+find smali/ -maxdepth 3 -type d | sort
+```
+
+### Step 2: Classify Each Package
+```
+For each detected package:
+  1. Match against patterns above
+  2. If MATCH → categorize (Keep / Replace / Upgrade / Evaluate)
+  3. If NO MATCH → mark as "Unknown — investigate"
+  4. If app's own package → mark as "App Code — rebuild in Kotlin"
+```
+
+### Step 3: Check Native Libraries
+```bash
+# List native libraries
+ls lib/*/
+file lib/arm64-v8a/*.so   # identify library type
+
+# Common native libs:
+libfb*.so          → Facebook SDK
+libreact*.so       → React Native
+libflutter*.so     → Flutter engine
+libhermes*.so      → Hermes JS engine (React Native)
+libsqlcipher*.so   → SQLCipher encrypted DB
+libmmkv*.so        → MMKV storage
+```
+
+### Step 4: Generate Report
+Use the template from SKILL.md Step 0 output format.
+
+---
+
+*library-patterns v1.0.0 — Reference database for APK library detection*

package/skills/smali-to-kotlin/phase-0-discovery.md

@@ -0,0 +1,128 @@
+# 🗺️ Phase 0: Discovery (Satellite View)
+
+> **Zoom Level:** 0 — Bird's Eye
+> **Goal:** Create an "App Map" — understand WHAT the app is and WHAT it contains.
+> **Output:** Diagrams, tables, maps. **NO CODE.**
+
+---
+
+## ⛔ OUTPUT RULE
+
+```
+✅ ALLOWED: ASCII diagrams, Mermaid, tables, bullet lists, bash scan commands
+❌ BLOCKED: Kotlin/Java code, function signatures, class definitions
+```
+
+---
+
+## 📋 Sub-steps
+
+### 0.1: Confirm Input
+
+```
+🔧 Android Reverse Engineering bắt đầu!
+
+Em cần biết:
+1. Thư mục Apktool output ở đâu?
+2. Tên app gốc? Package name?
+
+Chưa chạy Apktool? → apktool d your-app.apk -o ./decompiled/
+```
+
+### 0.2: Structure Scan
+
+Quét folder structure để hiểu quy mô app:
+
+```bash
+# Top-level packages (app code vs libraries)
+find [apktool_dir]/smali -maxdepth 3 -type d | sed 's|.*/smali/||' | sort
+
+# Multi-dex check
+find [apktool_dir] -name "smali*" -maxdepth 1 -type d
+
+# Resource overview
+ls [apktool_dir]/res/layout/ | wc -l         # Number of layouts
+ls [apktool_dir]/res/drawable*/ | wc -l       # Number of drawables
+cat [apktool_dir]/res/values/strings.xml | grep '<string' | wc -l  # Strings count
+```
+
+### 0.3: Library Detection
+
+Quét smali directories để nhận diện thư viện. Ref: `library-patterns.md`
+
+```bash
+# Known library packages
+find [apktool_dir]/smali -maxdepth 3 -type d | grep -E "(google|facebook|squareup|airbnb|bumptech|jakewharton|reactivex|greenrobot)" | sort
+
+# Native libraries
+find [apktool_dir]/lib -name "*.so" 2>/dev/null
+
+# Assets (ML models, WebView, configs)
+ls [apktool_dir]/assets/ 2>/dev/null
+```
+
+**Phân loại thành 5 nhóm:**
+
+| Category | Meaning | Action |
+|----------|---------|--------|
+| ✅ Reuse | Modern, still maintained | Add to build.gradle |
+| 🔄 Replace | Legacy/deprecated | Map to modern replacement |
+| 🔵 Firebase/Google | Platform SDKs | Use latest version |
+| 📱 Native (.so) | JNI libraries | Keep, create bridge |
+| 🏷️ App Code | Original app logic | Rebuild in Kotlin |
+
+### 0.4: Manifest Analysis
+
+```bash
+cat [apktool_dir]/AndroidManifest.xml
+```
+
+Extract:
+- Application ID + Package name
+- Min/Target SDK
+- Permissions (grouped by category)
+- Entry points: Application class, Launcher Activity
+- All components: Activities, Services, Receivers, Providers
+- Deep links / Intent filters
+
+### 0.5: Screen Map
+
+Map Activities → future Compose screens. Draw navigation flow:
+
+```
+Activities found → Group by feature → Draw screen graph
+```
+
+### 0.6: Complexity Estimate
+
+Rate each area 1-5 dots:
+- Data Layer: ●●●○○ (APIs, DB, preferences)
+- Core Logic: ●●○○○ (crypto, formatters, utils)
+- UI Screens: ●●●●○ (screen count, complex layouts)
+- SDK Integration: ●●○○○ (third-party, native libs)
+
+---
+
+## 📊 Output: App Map
+
+Use template from `templates/app-map.md`. Must include:
+
+1. **Identity** — package, SDK levels, screen count
+2. **Screen Flow** — navigation graph (ASCII or Mermaid)
+3. **Library Landscape** — categorized dependency list
+4. **Complexity Estimate** — visual dots rating
+5. **Key Observations** — anything notable (obfuscation, unusual patterns)
+
+---
+
+## ✅ Gate
+
+```
+"🗺️ Đây là App Map. Anh review xem có gì cần diều chỉnh không?"
+→ User approves → Proceed to Phase 1 (Architecture)
+→ User has questions → Investigate and update map
+```
+
+---
+
+*Phase 0: Discovery — No code, just understanding*

package/skills/smali-to-kotlin/phase-1-architecture.md

@@ -0,0 +1,166 @@
+# 🏗️ Phase 1: Architecture (District View)
+
+> **Zoom Level:** 1 — Architecture Design
+> **Goal:** Design the overall architecture BEFORE writing any code.
+> **Input:** Completed App Map from Phase 0.
+> **Output:** Architecture Blueprint (layer maps, feature tables, API list). **NO CODE BODIES.**
+
+---
+
+## ⛔ OUTPUT RULE
+
+```
+✅ ALLOWED: Architecture diagrams, layer maps, feature-to-file mapping tables, API endpoint tables
+✅ ALLOWED: File paths, package names, dependency lists
+❌ BLOCKED: Function bodies, implementation details, actual Kotlin code
+⚠️ EXCEPTION: build.gradle.kts skeleton (plugin + dependency declarations only)
+```
+
+---
+
+## 📋 Sub-steps
+
+### 1.1: Layer Design
+
+Design Clean Architecture layers based on App Map:
+
+```
+┌─────────────────────────────────────┐
+│ Presentation                        │
+│ ├── screens/ ([N] screens)          │
+│ ├── navigation/ (NavGraph)          │
+│ └── theme/ (Material3)             │
+├─────────────────────────────────────┤
+│ Domain                              │
+│ ├── model/ ([N] business models)    │
+│ ├── repository/ ([N] interfaces)   │
+│ └── usecase/ ([N] use cases)        │
+├─────────────────────────────────────┤
+│ Data                                │
+│ ├── remote/ ([N] API services)     │
+│ ├── local/ (Room, DataStore)       │
+│ └── repository/ (implementations)  │
+├─────────────────────────────────────┤
+│ DI                                  │
+│ └── modules/ (Network, DB, Repo)   │
+└─────────────────────────────────────┘
+```
+
+### 1.2: Feature → File Mapping
+
+Map each feature to its Clean Architecture components:
+
+| Feature | Domain Model | Repository | UseCase | Screen | ViewModel |
+|---------|-------------|-----------|---------|--------|-----------|
+| Auth | User, Token | AuthRepo | LoginUC | Login | AuthVM |
+| Home | Data | HomeRepo | GetDataUC | Home | HomeVM |
+| ... | ... | ... | ... | ... | ... |
+
+### 1.3: API Endpoint Inventory
+
+Extract ALL API endpoints from Smali analysis:
+
+| # | Method | Endpoint | Auth | Request | Response | Notes |
+|---|--------|----------|------|---------|----------|-------|
+| 1 | POST | /auth/login | No | email, pwd | JWT token | - |
+| 2 | GET | /users/me | Bearer | - | User object | - |
+
+**How to find in Smali:**
+```
+Look for: const-string → "https://" or "http://"
+Look for: .field → BASE_URL, API_URL
+Look for: StringBuilder + append patterns (endpoint construction)
+Look for: annotation patterns (@GET, @POST in okhttp/retrofit)
+```
+
+### 1.4: Data Schema Inventory
+
+List ALL data structures found:
+
+| Model | Fields (key ones) | Source | Storage |
+|-------|-------------------|--------|---------|
+| User | id, name, email, avatar | API | Room + Memory |
+| Settings | theme, language, notifications | Local | DataStore |
+
+### 1.5: Project Structure
+
+Propose directory structure based on features:
+
+```
+app/src/main/java/com/package/
+├── App.kt
+├── di/ (AppModule, NetworkModule, DatabaseModule)
+├── data/
+│   ├── remote/api/ ([N] Retrofit interfaces)
+│   ├── remote/dto/ (DTOs)
+│   ├── local/db/ (Room)
+│   ├── local/datastore/ (DataStore)
+│   └── repository/ (Implementations)
+├── domain/
+│   ├── model/ (Business models)
+│   ├── repository/ (Interfaces)
+│   └── usecase/ (Use cases)
+├── presentation/
+│   ├── navigation/ (NavGraph, Routes)
+│   ├── theme/ (Colors, Typography, Theme)
+│   ├── components/ (Shared composables)
+│   └── screens/
+│       ├── splash/
+│       ├── auth/
+│       ├── home/
+│       └── [feature]/
+└── util/ (Extensions, helpers)
+```
+
+### 1.6: Build Order Suggestion
+
+Recommend order based on dependency graph:
+
+```
+1. 🟢 Project setup + DI skeleton + Theme
+2. 🟢 Domain models (data classes — no logic)
+3. 🟡 Data layer (API interfaces + Room entities)
+4. 🟡 Core utils (crypto, formatters — need parity testing)
+5. 🔴 UI screens (per-feature, starting from auth)
+6. 🔴 SDK integration + Parity check
+```
+
+### 1.7: Tech Stack Decisions
+
+Confirm decisions from Phase 0 Library Report:
+
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+| Image Loading | Coil (replace Glide) | Modern, Compose-native |
+| JSON | Kotlin Serialization | Type-safe, no reflection |
+| ... | ... | ... |
+
+---
+
+## 📊 Output: Architecture Blueprint
+
+Use template from `templates/architecture.md`. Must include:
+
+1. **Layer Map** — ASCII architecture diagram with counts
+2. **Feature Table** — feature → file mapping
+3. **API Inventory** — all endpoints found
+4. **Data Schema** — all models with key fields
+5. **Project Structure** — proposed directory tree
+6. **Build Order** — suggested implementation sequence
+7. **Tech Decisions** — confirmed choices
+
+---
+
+## ✅ Gate
+
+```
+"🏗️ Architecture Blueprint xong. Anh muốn bắt đầu từ feature nào?
+Em suggest: [Feature X] vì [reason — e.g., nhiều feature khác phụ thuộc]."
+
+→ User picks feature → Proceed to Phase 2 (Blueprint) for that feature
+→ User wants changes → Adjust architecture
+```
+
+---
+
+*Phase 1: Architecture — Design before you build*