@leejungkiin/awkit 1.0.7 → 1.0.8

package/workflows/_uncategorized/reverse-android-discover.md

@@ -0,0 +1,150 @@
+---
+description: 🗺️ RE Android Phase 0 — Discovery & App Map (NO CODE output)
+parent: reverse-android
+---
+
+# /re-android-discover — Discovery & App Map
+
+> **Parent:** [`/reverse-android`](reverse-android.md) → Phase 0
+> **Skill:** `smali-to-kotlin` → `phase-0-discovery.md`
+> **Zoom Level:** 0 — Satellite View
+> **Output:** App Map (diagrams, tables, NO CODE)
+
+---
+
+## ⛔ ZOOM 0 RULE
+
+```
+This workflow produces NO CODE output.
+Only: diagrams, tables, bullet lists, bash scan commands.
+If you are about to write Kotlin code → STOP → you are at wrong zoom level.
+```
+
+---
+
+## 📦 Step 0: Library Scanner
+
+> Nhận diện toàn bộ thư viện **trước khi làm bất kỳ thứ gì**.
+
+### 0.1: Quét structure
+
+```bash
+# Top-level packages
+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 counts
+ls [apktool_dir]/res/layout/ 2>/dev/null | wc -l
+ls [apktool_dir]/res/drawable*/ 2>/dev/null | wc -l
+
+# Native + Assets
+find [apktool_dir]/lib -name "*.so" 2>/dev/null
+ls [apktool_dir]/assets/ 2>/dev/null
+```
+
+### 0.2: Phân loại thư viện
+
+Dùng patterns từ `library-patterns.md`, phân thành 5 nhóm:
+
+| Category | Example | Action |
+|----------|---------|--------|
+| ✅ Reuse | Retrofit, OkHttp | Add to build.gradle |
+| 🔄 Replace | Volley, AsyncTask | Map to modern |
+| 🔵 Google/Firebase | FCM, Analytics | Use latest |
+| 📱 Native | .so files | Keep, JNI bridge |
+| 🏷️ App Code | com.app.* | Rebuild |
+
+### 0.3: User approval
+
+> **GATE:** Hiển thị Library Report → User approve trước khi tiếp.
+
+---
+
+## 📄 Step 1: Manifest Analysis
+
+```bash
+cat [apktool_dir]/AndroidManifest.xml
+```
+
+### 1.1: Trích xuất
+
+- Application ID + Package name
+- Min/Target SDK
+- Permissions (phân nhóm: network, storage, camera, location, other)
+- Entry points: Application class, Launcher Activity, MainActivity
+- Components: Activities (→ future screens), Services, Receivers, Providers
+- Deep links / Intent filters
+
+### 1.2: Screen Map
+
+Map Activities → future Compose screens:
+
+```
+SplashActivity    → presentation/screens/splash/
+LoginActivity     → presentation/screens/auth/
+MainActivity      → presentation/screens/main/
+DetailActivity    → presentation/screens/detail/
+SettingsActivity  → presentation/screens/settings/
+```
+
+Draw navigation flow (ASCII or Mermaid).
+
+### 1.3: Complexity Estimate
+
+| Area | Rating | Notes |
+|------|--------|-------|
+| Data Layer | ●●●○○ | [evidence] |
+| Core Logic | ●●○○○ | [evidence] |
+| UI Screens | ●●●●○ | [evidence] |
+| SDK Integration | ●●○○○ | [evidence] |
+
+---
+
+## 📊 Output: App Map
+
+Sử dụng template từ `skills/smali-to-kotlin/templates/app-map.md`:
+
+```markdown
+## 🗺️ App Map: [App Name]
+
+### Identity
+[package, SDK, counts]
+
+### Screen Flow
+[navigation graph]
+
+### Library Landscape
+[categorized table]
+
+### Complexity Estimate
+[rating dots]
+
+### Key Observations
+[notable findings]
+```
+
+---
+
+## ✅ Gate: Chuyển sang Phase 1
+
+```
+"🗺️ App Map xong! Anh review map này.
+Có gì cần điều chỉnh không? OK → em sẽ thiết kế Architecture."
+
+→ User approves → /re-android-design (Phase 1)
+→ User has questions → investigate và update map
+```
+
+---
+
+## 🔗 Related
+
+- **Next:** [`/re-android-design`](reverse-android-design.md) (Phase 1: Architecture)
+- **Parent:** [`/reverse-android`](reverse-android.md)
+- **Skill reference:** `skills/smali-to-kotlin/phase-0-discovery.md`
+
+---
+
+*re-android-discover v3.0.0 — Phase 0: Discovery & App Map*

package/workflows/_uncategorized/reverse-android-scan.md

@@ -0,0 +1,158 @@
+---
+description: 📦 RE Android Phase 1 — Library Scanner + Manifest Analysis + Project Bootstrap
+parent: reverse-android
+---
+
+# /re-android-scan — Library Scanner & Manifest Analysis
+
+> **Parent:** [`/reverse-android`](reverse-android.md) → Step 0 + Step 1
+> **Skill:** `smali-to-kotlin` | **Reference:** `skills/smali-to-kotlin/library-patterns.md`
+
+---
+
+## 📦 Step 0: Library Scanner (BẮT BUỘC)
+
+> Nhận diện toàn bộ thư viện **trước khi code bất kỳ thứ gì**.
+
+### 0.3: Quét Smali directories
+
+```bash
+# Top-level packages
+find [apktool_dir]/smali -maxdepth 3 -type d | sed 's|[apktool_dir]/smali/||' | sort
+
+# Multi-dex
+find [apktool_dir] -name "smali*" -maxdepth 1 -type d
+find [apktool_dir]/smali_classes2 -maxdepth 3 -type d 2>/dev/null | sort
+
+# Native libraries & Assets
+find [apktool_dir]/lib -name "*.so" 2>/dev/null
+ls [apktool_dir]/assets/ 2>/dev/null
+```
+
+### 0.4: Tạo Library Detection Report
+
+Dùng patterns từ `library-patterns.md`, phân loại:
+
+```markdown
+## 📦 Library Detection Report — [App Name]
+
+### ✅ Reuse (build.gradle)
+| Library | Package Detected | Version | Notes |
+|---------|-----------------|---------|-------|
+| Retrofit | com/squareup/retrofit2 | 2.9.0 | Keep |
+| OkHttp | com/squareup/okhttp3 | 4.12.0 | Keep |
+
+### 🔄 Replace (Legacy → Modern)
+| Old Library | Detected | Replacement |
+|-------------|----------|-------------|
+| Volley | com/android/volley | Retrofit + OkHttp |
+| AsyncTask | android.os.AsyncTask | Coroutines |
+
+### 🔵 Firebase/Google SDKs
+| SDK | Detected | Action |
+|-----|----------|--------|
+
+### 📱 Native (.so) — Giữ nguyên
+| File | Architecture | Notes |
+|------|-------------|-------|
+
+### 🏷️ App Code (Rebuild in Kotlin)
+| Package | Module |
+|---------|--------|
+
+### ❓ Unknown (Cần điều tra)
+| Package | Path | Possible |
+|---------|------|----------|
+```
+
+### 0.5: User approval
+
+> **GATE:** Không tiếp tục Step 1 khi chưa có user approval report.
+
+---
+
+## 📄 Step 1: AndroidManifest Analysis & Project Bootstrap
+
+> **Input:** `[apktool_dir]/AndroidManifest.xml`
+
+### 1.1: Phân tích Manifest
+
+Trích xuất:
+
+```yaml
+extract:
+  - application_id, package_name
+  - min_sdk, target_sdk
+  - permissions: [network, storage, camera, location, other]
+  - entry_points: [application_class, splash_activity, main_activity]
+  - components: [activities, services, receivers, providers]
+  - deep_links, features
+```
+
+### 1.2: Đề xuất project structure
+
+Mapping activities → Compose screens (xem SKILL.md Step 1):
+
+```
+SplashActivity → presentation/screens/splash/SplashScreen.kt
+MainActivity   → presentation/screens/main/MainScreen.kt
+LoginActivity  → presentation/screens/auth/LoginScreen.kt
+```
+
+### 1.3: Tạo `build.gradle.kts` skeleton
+
+```kotlin
+plugins {
+    alias(libs.plugins.android.application)
+    alias(libs.plugins.kotlin.android)
+    alias(libs.plugins.kotlin.compose)
+    alias(libs.plugins.hilt.android)
+    alias(libs.plugins.ksp)
+    alias(libs.plugins.kotlin.serialization)
+}
+
+android {
+    namespace = "[package_name]"
+    compileSdk = [target_sdk]
+    defaultConfig {
+        applicationId = "[application_id]"
+        minSdk = [min_sdk]
+        targetSdk = [target_sdk]
+    }
+    buildFeatures { compose = true; buildConfig = true }
+}
+
+dependencies {
+    // Compose BOM + Material3 + Navigation
+    // Coroutines + Hilt DI
+    // Network: Retrofit + OkHttp (từ Library Report)
+    // Local: Room + DataStore
+    // Image: Coil + Logging: Timber
+    // [Thêm libs từ "Reuse" section]
+}
+```
+
+### ✅ Checkpoint Step 1
+
+```markdown
+## ✅ Step 1 Complete
+
+- Package: [package_name]
+- Entry points: [list]
+- Screens to rebuild: [list]
+
+⏭️ Next: `/re-android-build` — Step 2 (Data Layer)
+Cung cấp Smali: smali/[package]/network/, model/, data/
+```
+
+---
+
+## 🔗 Related
+
+- **Next:** [`/re-android-build`](reverse-android-build.md) (Step 2-6)
+- **Parent:** [`/reverse-android`](reverse-android.md)
+- **Library patterns:** `skills/smali-to-kotlin/library-patterns.md`
+
+---
+
+*re-android-scan v2.0.0 — Phase 1: Discovery & Bootstrap*

package/workflows/_uncategorized/reverse-android.md

@@ -0,0 +1,143 @@
+---
+description: 🔧 Dịch ngược APK Android (Apktool output) → App Kotlin hiện đại với Jetpack Compose, Clean Architecture, và UI-First methodology.
+skill: smali-to-kotlin
+---
+
+# /reverse-android — Android APK Reverse Engineering Workflow
+
+> **Skill:** `smali-to-kotlin` v2.0 | **Tech:** Kotlin + Compose + Hilt + Retrofit + Room
+> **Philosophy:** "Map → Blueprint → UI First → Logic Behind"
+> **Key:** UI is designed and approved BEFORE coding any business logic.
+
+---
+
+## ⚡ QUICK START
+
+User cung cấp: Apktool output dir, `AndroidManifest.xml`, hoặc nói "reverse engineer APK này".
+Workflow dẫn dắt qua **5 phases** — UI-First approach, **không bao giờ nhảy cóc**.
+
+---
+
+## 🔵 Session Setup
+
+### Bước 0.1: Khởi tạo session state
+
+```yaml
+reverse_session:
+  project_name: "[TBD - từ manifest]"
+  apktool_dir: "[path]"
+  current_phase: 0
+  current_feature: null
+  phase_2_status:
+    contracts: pending
+    ui_shell: pending
+    resources: pending
+  completed_features: []
+  pending_features: []
+  decisions: []
+```
+
+### Bước 0.2: Xác nhận input
+
+```
+🔧 Android Reverse Engineering v2.0 — UI-First Pipeline
+
+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/
+```
+
+---
+
+## 📋 Pipeline Overview (5 Phases — UI-First)
+
+| Phase | Name | Sub-workflow | Code? | Gate |
+|-------|------|-------------|-------|------|
+| 0 | 🗺️ Discovery | [`/re-android-discover`](reverse-android-discover.md) | ❌ | User approves Map |
+| 1 | 🏗️ Architecture | [`/re-android-design`](reverse-android-design.md) | ❌ | User approves Architecture |
+| 2 | 📐🎨 Blueprint + UI | [`/re-android-build`](reverse-android-build.md) | UI code | User approves UI + Contracts |
+| 3 | 🔨 Logic Build | [`/re-android-build`](reverse-android-build.md) | Full logic | Feature checkpoint |
+| 4 | ✅ Final Parity | [`/re-android-build`](reverse-android-build.md) | — | Final check |
+
+### Execution Flow
+
+```
+Session Setup
+    ↓
+Phase 0: Discovery (/re-android-discover) → App Map
+    ↓ [User approves]
+Phase 1: Architecture (/re-android-design) → Architecture Blueprint
+    ↓ [User approves + picks feature]
+Feature Loop (/re-android-build):
+    Phase 2: Blueprint + UI (contracts + visual shell + resources)
+        ↓ 🚦 GATE: User approves UI + contracts
+    Phase 3: Logic Build (domain → data → DI → VM → wire UI)
+        ↓ 📊 CHECKPOINT: Feature done
+    → Repeat for next feature
+    ↓
+Phase 4: Final Parity Check & Quality Gate
+```
+
+---
+
+## 🔭 ZOOM CONTROL
+
+```yaml
+pre_output_check:
+  - "Đang ở phase nào?"
+  - "Output có đúng phase rule không?"
+  - "Phase 0/1: NO CODE BODIES"
+  - "Phase 2: UI code + signatures (no logic bodies)"
+  - "Phase 3: Full implementation code"
+
+phase_rules:
+  phase_0: "NO CODE. Only diagrams, tables, maps."
+  phase_1: "NO CODE BODIES. Only architecture diagrams, file lists."
+  phase_2_contracts: "SIGNATURES ONLY. Interfaces, data classes, sealed classes."
+  phase_2_ui: "FULL UI CODE. Compose with hardcoded mock data + @Preview."
+  phase_3: "FULL LOGIC CODE. Domain → Data → DI → VM → Wire UI."
+```
+
+---
+
+## 🚫 WORKFLOW RULES
+
+```yaml
+never_skip:
+  - Phase 0 (Discovery) — always first
+  - Phase 1 (Architecture) — design before coding
+  - Phase 2 UI Gate — user MUST approve UI before Phase 3
+  - Per-feature Blueprint before Logic Build
+
+never_do:
+  - Write logic code before UI is approved
+  - Mass-copy resources from APK (on-demand only)
+  - Implement multiple features simultaneously
+  - Modify UI significantly in Phase 3 (only wire, don't redesign)
+  - Skip crypto parity check
+
+always_do:
+  - Extract resources BEFORE coding UI (Phase 2.7 → 2.8)
+  - Create @Preview for ALL states
+  - Keep stateless composable (LoginScreenContent) after wiring
+  - Checkpoint after each feature
+  - Document all decisions
+```
+
+---
+
+## 🔗 Related
+
+- **Sub-workflows:**
+  - [`/re-android-discover`](reverse-android-discover.md) — Phase 0: Discovery
+  - [`/re-android-design`](reverse-android-design.md) — Phase 1: Architecture
+  - [`/re-android-build`](reverse-android-build.md) — Phase 2+3+4: Blueprint + UI + Build
+- **Skill:** `smali-to-kotlin` v2.0 (UI-First pipeline)
+- **Sibling:** `/reverse-ios` (iOS counterpart)
+- **After RE done:** `/test`, `/deploy`, `/code-janitor`
+
+---
+
+*reverse-android workflow v4.0.0 — UI-First RE Pipeline*

package/workflows/_uncategorized/reverse-ios-build.md

@@ -0,0 +1,240 @@
+---
+description: 🔨 RE iOS Phase 2+3+4 — Blueprint + UI Shell → Logic Build → Final Parity (UI-First)
+parent: reverse-ios
+---
+
+# /re-ios-build — Blueprint + UI + Build (Per Feature)
+
+> **Parent:** [`/reverse-ios`](reverse-ios.md) → Phase 2+3+4
+> **Prerequisite:** Completed Architecture from [`/re-ios-design`](reverse-ios-design.md)
+> **Skill:** `smali-to-swift` → `phase-2-blueprint-ui.md` + `phase-3-logic-build.md`
+
+---
+
+## 🔄 Feature Loop (UI-First)
+
+```
+For each feature (from Architecture Build Order):
+    Phase 2: Blueprint + UI (contracts + visual shell)
+        ↓ 🚦 GATE: User approves UI + contracts
+    Phase 3: Logic Build (domain → data → wire)
+        ↓ 📊 CHECKPOINT
+    → Next feature
+```
+
+---
+
+## 📐🎨 Phase 2: Blueprint + UI Design
+
+> **Output:** Approved contracts + Working SwiftUI shell with mock data.
+
+### Part A: Contracts (signatures only)
+
+#### 2.1: Deep Header Reading
+Read class-dump headers + Hopper pseudo-code. See `objc-reading-guide.md`.
+
+**ObjC → Swift Quick Ref:**
+```
+@property (copy) NSString *name     → let name: String
+@property (assign) BOOL active      → let active: Bool
+- (void)fetchWith:(block)completion → func fetch() async throws -> T
++ (instancetype)sharedInstance      → static let shared
+```
+
+#### 2.2–2.5: Define Contracts
+```swift
+// 2.2 Domain Model
+struct [Model]: Codable, Identifiable, Sendable {
+    let field: Type
+}
+
+// 2.3 Repository Protocol
+protocol [Feature]Repository: Sendable {
+    func [method](...) async throws -> [Type]
+}
+
+// 2.4 API Endpoint
+enum [Feature]Endpoint {
+    case [action](param: Type)
+    var path: String { /* ... */ }
+}
+
+// 2.5 UseCase
+struct [Action]UseCase {
+    func execute(...) async throws -> [Type] // TODO
+}
+```
+
+#### 2.6: UI State Design
+```swift
+struct [Screen]ViewState {
+    var field: Type = default
+    var isLoading: Bool = false
+    var error: String? = nil
+}
+enum [Screen]Action { /* user interactions */ }
+enum [Screen]Event { /* navigation, alerts */ }
+
+extension [Screen]ViewState {
+    static let normal = [Screen]ViewState(/* sample */)
+    static let loading = [Screen]ViewState(isLoading: true)
+    static let error = [Screen]ViewState(error: "Error message")
+}
+```
+
+### Part B: UI Visual Shell
+
+#### 2.7: Resource Extraction ⭐ (BEFORE UI code!)
+
+Extract from IPA bundle / Assets.car:
+- Images → Assets.xcassets
+- Colors → Color extension or asset catalog
+- Strings → Localizable.xcstrings
+- Fonts → custom fonts
+
+Copy ONLY needed resources. Verify they build.
+
+#### 2.8: UI Implementation ⭐ (Visual shell with mock data)
+
+- Use ViewState from 2.6 with hardcoded defaults
+- Use REAL resources from 2.7
+- Create `[Screen]Content` view (stateless)
+- Match visual parity with original app
+- NO ViewModel connection, NO real API calls
+
+```swift
+struct [Screen]Content: View {
+    var state: [Screen]ViewState = .normal   // Mock
+    var onAction: ([Screen]Action) -> Void = { _ in }  // No-op
+
+    var body: some View {
+        // Full SwiftUI matching original app
+    }
+}
+
+#Preview("Normal") { [Screen]Content(state: .normal) }
+#Preview("Loading") { [Screen]Content(state: .loading) }
+#Preview("Error") { [Screen]Content(state: .error) }
+```
+
+#### 2.9: Visual Parity Check ⭐
+
+Compare with original app:
+- [ ] Layout structure matches
+- [ ] Colors, typography, spacing correct
+- [ ] Icons/images positioned correctly
+- [ ] All states: normal, loading, error, empty
+
+### 🚦 UI + Contracts Gate (MANDATORY)
+
+```
+"📐🎨 Blueprint + UI cho [Feature] xong:
+📝 Contracts: [N] models, [N] protocols, [N] use cases, [N] endpoints
+🎨 UI: [Screen] with [N] state previews
+📸 Visual Parity: [OK / needs adjustment]
+
+→ ✅ Approve → Phase 3 (Logic Build)
+→ 🎨 Adjust UI → fix then re-check
+→ 📝 Adjust contracts → revise"
+```
+
+> ⚠️ **DO NOT proceed to Phase 3 without user approval.**
+
+---
+
+## 🔨 Phase 3: Logic Build
+
+> **Output:** Full Swift code. Wire logic to EXISTING UI.
+
+### 3.1: Domain Layer
+Models + Repository protocols + UseCases (implement with repo calls)
+
+### 3.2: Data Layer
+DTOs + APIClient endpoints + SwiftData (if applicable) + Repository implementation
+
+### 3.3: DI Container
+AppContainer with lazy properties for repos, use cases, view models
+
+### 3.4: ViewModel
+@Observable with state property + handle(_ action:) + event handler
+
+### 3.5: Wire UI ↔ Logic ⭐ (NOT "code new UI")
+
+The UI already exists from Phase 2.8. Only CONNECT it:
+
+```swift
+// Keep stateless Content view from Phase 2 (for Preview):
+// [Screen]Content(state:, onAction:) — DO NOT MODIFY
+
+// ADD wrapper that wires ViewModel:
+struct [Screen]: View {
+    @State private var viewModel: [Screen]ViewModel
+
+    init(container: AppContainer) {
+        _viewModel = State(initialValue: container.make[Screen]ViewModel())
+    }
+
+    var body: some View {
+        [Screen]Content(
+            state: viewModel.state,
+            onAction: viewModel.handle
+        )
+    }
+}
+```
+
+### 3.6: Integration Test ⭐
+- [ ] API calls succeed, data displays
+- [ ] Loading/error states work
+- [ ] Navigation correct
+- [ ] Crypto output matches (if applicable)
+
+### 🔒 Crypto (Special)
+```swift
+import CryptoKit
+import CommonCrypto
+// XCTest mandatory for crypto utils
+```
+> ⚠️ Crypto MUST match original output.
+
+### ✅ Feature Checkpoint
+
+```markdown
+## ✅ Feature Complete: [Name]
+Files: [list] | Resources: [count] | Tests: [status]
+⏭️ Next Feature: [Name] → Return to Phase 2
+```
+
+---
+
+## ✅ Phase 4: Final Parity Check (After ALL features)
+
+### Checklist
+- [ ] API Parity — all endpoints match
+- [ ] Data/Crypto Parity — output identical
+- [ ] UI Parity — screen-by-screen comparison
+- [ ] Edge Cases — empty, error, offline, lifecycle
+- [ ] Build: `xcodebuild build && xcodebuild test`
+
+### 🎉 Final Summary
+
+```markdown
+## ✅ Reverse Engineering Complete!
+- Screens: [N] | Features: [N]
+- Frameworks reused: [N] | Replaced: [N]
+- Tests: [pass/fail]
+
+⏭️ Next: /test → /deploy → /code-janitor
+```
+
+---
+
+## 🔗 Related
+
+- **Parent:** [`/reverse-ios`](reverse-ios.md)
+- **Previous:** [`/re-ios-design`](reverse-ios-design.md) (Phase 1)
+- **Skill:** `smali-to-swift` → `phase-2-blueprint-ui.md` + `phase-3-logic-build.md`
+
+---
+
+*re-ios-build v4.0.0 — UI-First Blueprint + Build*