@leejungkiin/awkit 1.0.1 → 1.0.3

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

@@ -0,0 +1,248 @@
+---
+description: 🏗️ RE iOS Phase 2 — Data Layer, Utils, UI, SDK Integration & Parity Check
+parent: reverse-ios
+---
+
+# /re-ios-build — Build & Verify
+
+> **Parent:** [`/reverse-ios`](reverse-ios.md) → Step 2-6
+> **Prerequisite:** Hoàn thành [`/re-ios-scan`](reverse-ios-scan.md)
+> **Skill:** `smali-to-swift` | **ObjC Guide:** `skills/smali-to-swift/objc-reading-guide.md`
+
+---
+
+## 💾 Step 2: Data Layer Reconstruction
+
+> **Input:** Class-dump headers cho network, models, storage
+
+### 2.1: Models (ObjC → Swift Codable)
+
+```objc
+// From class-dump
+@interface UserModel : NSObject
+@property (nonatomic, copy) NSString *userId;
+@property (nonatomic, copy) NSString *fullName;
+@end
+```
+
+```swift
+struct User: Codable, Identifiable, Sendable {
+    let id: String
+    let fullName: String
+    enum CodingKeys: String, CodingKey {
+        case id = "user_id"
+        case fullName = "full_name"
+    }
+}
+```
+
+### 2.2: API Client (URLSession async/await)
+
+```swift
+actor APIClient {
+    func request<T: Decodable>(_ endpoint: Endpoint) async throws -> T {
+        var request = URLRequest(url: baseURL.appending(path: endpoint.path))
+        request.httpMethod = endpoint.method.rawValue
+        let (data, response) = try await session.data(for: request)
+        guard let http = response as? HTTPURLResponse,
+              (200...299).contains(http.statusCode) else {
+            throw APIError.invalidResponse
+        }
+        return try decoder.decode(T.self, from: data)
+    }
+}
+```
+
+### 2.3: SwiftData (nếu app dùng Core Data / SQLite)
+
+- `@Model` classes thay Core Data entities
+- `@Attribute(.unique)` cho primary keys
+- `ModelContext` cho CRUD operations
+
+### 2.4: Repository Pattern
+
+- Protocol: `protocol UserRepository: Sendable`
+- Implementation: offline-first (local → remote → cache)
+
+### ✅ Checkpoint Step 2
+
+---
+
+## 🧮 Step 3: Core Logic & Utils
+
+> **CRITICAL:** Crypto output MUST match original
+
+### 3.1: Crypto utils → Swift
+
+```swift
+import CryptoKit
+import CommonCrypto
+
+enum CryptoUtils {
+    static func md5(_ input: String) -> String {
+        let data = Data(input.utf8)
+        var digest = [UInt8](repeating: 0, count: Int(CC_MD5_DIGEST_LENGTH))
+        data.withUnsafeBytes { CC_MD5($0.baseAddress, CC_LONG(data.count), &digest) }
+        return digest.map { String(format: "%02x", $0) }.joined()
+    }
+    static func sha256(_ input: String) -> String {
+        SHA256.hash(data: Data(input.utf8))
+            .compactMap { String(format: "%02x", $0) }.joined()
+    }
+}
+```
+
+### 3.2: XCTest verification (BẮT BUỘC cho crypto)
+
+```swift
+final class CryptoUtilsTests: XCTestCase {
+    func testMD5MatchesOriginal() {
+        XCTAssertEqual(CryptoUtils.md5("test"), "098f6bcd4621d373cade4e832627b4f6")
+    }
+}
+```
+
+### ✅ Checkpoint Step 3
+
+---
+
+## 🎨 Step 4: UI & ViewModel (Per Screen — Loop)
+
+> **Input:** Storyboard + VC headers + disassembly
+> **Lặp lại** cho MỌI screen từ Step 1
+
+### 4.0: Thứ tự ưu tiên
+
+1. LaunchScreen → 2. Auth → 3. Main TabView → 4. Detail → 5. Settings
+
+### 4.1: Resource extraction (on-demand only)
+
+Images, colors, strings, fonts — chỉ cho screen hiện tại.
+
+### 4.2: UIKit → SwiftUI
+
+```swift
+struct LoginScreen: View {
+    @State private var viewModel: LoginViewModel
+    var body: some View {
+        NavigationStack {
+            ScrollView {
+                VStack(spacing: 24) {
+                    TextField("Email", text: $viewModel.email)
+                    SecureField("Password", text: $viewModel.password)
+                    Button("Login") { Task { await viewModel.login() } }
+                        .buttonStyle(.borderedProminent)
+                        .disabled(viewModel.isLoading)
+                }
+                .padding()
+            }
+            .overlay { if viewModel.isLoading { ProgressView() } }
+            .alert("Error", isPresented: $viewModel.showError) { Button("OK") {} }
+                message: { Text(viewModel.errorMessage) }
+        }
+    }
+}
+```
+
+### 4.3: @Observable ViewModel
+
+```swift
+@Observable
+final class LoginViewModel {
+    var email = "", password = ""
+    var isLoading = false, showError = false, errorMessage = ""
+    
+    private let authRepository: AuthRepository
+    
+    func login() async {
+        isLoading = true
+        defer { isLoading = false }
+        do { try await authRepository.login(email: email, password: password) }
+        catch { errorMessage = error.localizedDescription; showError = true }
+    }
+}
+```
+
+### ✅ Checkpoint Step 4 (Per Screen)
+
+> **Loop:** Lặp 4.0 cho screen tiếp. Hết screen → Step 5.
+
+---
+
+## 📦 Step 5: SDK & Native Library Integration
+
+### 5.1: App entry point
+
+```swift
+@main
+struct MyApp: App {
+    @UIApplicationDelegateAdaptor private var appDelegate: AppDelegate
+    var body: some Scene {
+        WindowGroup { ContentView() }
+            .modelContainer(for: [UserEntity.self])
+    }
+}
+```
+
+### 5.2: AppDelegate (Firebase, Push)
+
+```swift
+class AppDelegate: NSObject, UIApplicationDelegate {
+    func application(_ app: UIApplication,
+                     didFinishLaunchingWithOptions opt: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+        FirebaseApp.configure(); return true
+    }
+}
+```
+
+### 5.3: Native C/C++ → Bridging Header
+
+```c
+// App-Bridging-Header.h
+#include "native_lib.h"
+```
+
+### ✅ Checkpoint Step 5
+
+---
+
+## ✅ Step 6: Parity Check & Quality Gate
+
+### 6.1: Edge Case checklist
+
+```markdown
+- [ ] Login empty/invalid input
+- [ ] Network offline → cached data?
+- [ ] App background during API call
+- [ ] Deep link handling
+- [ ] Push notification → correct screen
+```
+
+### 6.2: Build & Test
+
+```bash
+xcodebuild -scheme App -destination 'generic/platform=iOS' build
+xcodebuild -scheme App -destination 'platform=iOS Simulator,name=iPhone 16' test
+swiftlint lint
+```
+
+### 🎉 Final Summary
+
+```markdown
+## Complete!
+- Screens: [count] | Frameworks reused: [count] | Replaced: [count]
+
+⏭️ Next: /test → /deploy → /code-janitor
+```
+
+---
+
+## 🔗 Related
+
+- **Parent:** [`/reverse-ios`](reverse-ios.md)
+- **Previous:** [`/re-ios-scan`](reverse-ios-scan.md) (Step 0-1)
+- **ObjC Guide:** `skills/smali-to-swift/objc-reading-guide.md`
+
+---
+
+*re-ios-build v2.0.0 — Phase 2: Build & Verify*

package/workflows/mobile/reverse-ios-scan.md

@@ -0,0 +1,155 @@
+---
+description: 📦 RE iOS Phase 1 — Framework Scanner + Info.plist Analysis + Project Bootstrap
+parent: reverse-ios
+---
+
+# /re-ios-scan — Framework Scanner & Plist Analysis
+
+> **Parent:** [`/reverse-ios`](reverse-ios.md) → Step 0 + Step 1
+> **Skill:** `smali-to-swift` | **Reference:** `skills/smali-to-swift/framework-patterns.md`
+
+---
+
+## 📦 Step 0: Framework Scanner (BẮT BUỘC)
+
+> Nhận diện toàn bộ frameworks **trước khi code bất kỳ thứ gì**.
+
+### 0.3: Quét IPA structure
+
+```bash
+# Embedded frameworks
+ls [app_bundle]/Frameworks/
+
+# Linked libraries (Mach-O)
+otool -L [app_bundle]/App | grep -v /System | grep -v /usr/lib
+
+# Header imports
+grep -rh "#import <" [headers_dir]/ | sort -u
+grep -rh "@import " [headers_dir]/ | sort -u
+
+# SDK identifiers
+strings [app_bundle]/App | grep -i "cocoapods\|carthage\|firebase\|facebook\|google"
+
+# Assets & resources
+ls [app_bundle]/*.car [app_bundle]/*.momd [app_bundle]/*.storyboardc 2>/dev/null
+find [app_bundle] -name "*.json" -o -name "*.plist" | grep -v Info.plist | sort
+```
+
+### 0.4: Tạo Framework Detection Report
+
+Dùng patterns từ `framework-patterns.md`:
+
+```markdown
+## 📦 Framework Detection Report — [App Name]
+
+### ✅ Reuse (Add via SPM)
+| Framework | Detected | Version | Notes |
+|-----------|----------|---------|-------|
+
+### 🔄 Replace (Legacy → Modern Swift)
+| Old Framework | Detected | Replacement |
+|---------------|----------|-------------|
+| AFNetworking | Frameworks/ | URLSession async/await |
+| SDWebImage | imports | AsyncImage + Kingfisher |
+| SnapKit | imports | SwiftUI layout |
+
+### 🍏 Apple Frameworks
+| Framework | Purpose | SwiftUI Equivalent |
+|-----------|---------|-------------------|
+| MapKit | Maps | Map (SwiftUI) |
+| CoreData | Database | SwiftData |
+
+### 📱 Native Libraries
+| File | Notes |
+|------|-------|
+
+### 🏷️ App Code (Rewrite in Swift)
+| Class Prefix | Module |
+|-------------|--------|
+
+### ❓ Unknown
+| Framework | Notes |
+|-----------|-------|
+```
+
+### 0.5: User approval
+
+> **GATE:** Không tiếp tục khi chưa có user approval.
+
+---
+
+## 📄 Step 1: Info.plist & Entitlements + Project Bootstrap
+
+> **Input:** `[app_bundle]/Info.plist` + entitlements
+
+### 1.1: Đọc Info.plist
+
+```bash
+plutil -p [app_bundle]/Info.plist
+codesign -d --entitlements :- [app_bundle]/App 2>/dev/null
+```
+
+Trích xuất:
+
+```yaml
+extract:
+  - bundle_id, display_name, min_ios_version
+  - permissions: [camera, photos, location, microphone, notifications, tracking]
+  - url_schemes, universal_links
+  - capabilities: [push, apple_pay, sign_in_apple, app_groups]
+  - supported_orientations
+```
+
+### 1.2: Phân tích class hierarchy
+
+```bash
+grep -rl "UIViewController" [headers_dir]/ | sort
+grep -rl "UITabBarController" [headers_dir]/
+grep -rl "UINavigationController" [headers_dir]/
+```
+
+Mapping VCs → SwiftUI:
+```
+SplashViewController  → SplashScreen.swift
+LoginViewController   → Auth/LoginScreen.swift
+MainTabBarController  → TabView in ContentView.swift
+HomeViewController    → Home/HomeScreen.swift
+```
+
+### 1.3: Xcode project structure
+
+Đề xuất Clean Architecture structure (xem SKILL.md Step 1).
+
+### 1.4: SPM Dependencies (từ Framework Report)
+
+```swift
+// Firebase: firebase/firebase-ios-sdk 11.0+
+// Kingfisher: onevcat/Kingfisher 7.12+
+// KeychainAccess: kishikawakatsumi/KeychainAccess 4.2+
+// Lottie: airbnb/lottie-ios 4.4+
+```
+
+### ✅ Checkpoint Step 1
+
+```markdown
+## ✅ Step 1 Complete
+
+- Bundle ID: [bundle_id]
+- Permissions: [count] | Screens: [count]
+- URL Schemes: [list]
+
+⏭️ Next: `/re-ios-build` — Step 2 (Data Layer)
+Cung cấp headers: *Service, *Manager, *Client, *API, *Model
+```
+
+---
+
+## 🔗 Related
+
+- **Next:** [`/re-ios-build`](reverse-ios-build.md) (Step 2-6)
+- **Parent:** [`/reverse-ios`](reverse-ios.md)
+- **Framework patterns:** `skills/smali-to-swift/framework-patterns.md`
+
+---
+
+*re-ios-scan v2.0.0 — Phase 1: Discovery & Bootstrap*

package/workflows/mobile/reverse-ios.md

@@ -0,0 +1,114 @@
+---
+description: 🍎 Dịch ngược IPA iOS (class-dump, Hopper output) → App Swift hiện đại với SwiftUI, Clean Architecture, và Framework Scanner tự động.
+skill: smali-to-swift
+---
+
+# /reverse-ios — iOS IPA Reverse Engineering Workflow
+
+> **Skill:** `smali-to-swift` | **Tech:** Swift + SwiftUI + async/await + URLSession + SwiftData
+> **Philosophy:** "Read ObjC headers to understand WHAT & WHY → Write Swift for HOW"
+> **Sibling:** `/reverse-android`
+
+---
+
+## ⚡ QUICK START
+
+User cung cấp: Decrypted `.app` bundle, class-dump headers, Hopper pseudo-code, hoặc nói "reverse engineer IPA này".
+Workflow dẫn dắt từng bước — **không bao giờ nhảy cóc**.
+
+---
+
+## 🔵 Session Setup
+
+### Bước 0.1: Khởi tạo session state
+
+```yaml
+reverse_ios_session:
+  project_name: "[TBD - từ Info.plist]"
+  app_bundle_dir: "[path]"
+  headers_dir: "[class-dump output]"
+  current_step: 0
+  framework_report_done: false
+  plist_analyzed: false
+  completed_screens: []
+  pending_screens: []
+  decisions: []
+```
+
+### Bước 0.2: Xác nhận input
+
+```
+🍎 iOS Reverse Engineering bắt đầu!
+
+Em cần biết:
+1. Decrypted .app bundle ở đâu?
+2. Class-dump headers ở đâu?
+3. Tên app gốc? Bundle ID?
+
+Chưa chuẩn bị?
+→ bagbak -o ~/decrypted/ com.example.app
+→ class-dump -H ~/decrypted/App.app -o ~/headers/
+```
+
+---
+
+## 📋 Pipeline Overview (7 Steps)
+
+| Step | Phase | Sub-workflow | Gate |
+|------|-------|-------------|------|
+| 0 | 📦 Framework Scanner | [`/re-ios-scan`](reverse-ios-scan.md) | User approve report |
+| 1 | 📄 Info.plist & Bootstrap | [`/re-ios-scan`](reverse-ios-scan.md) | Checkpoint |
+| 2 | 💾 Data Layer | [`/re-ios-build`](reverse-ios-build.md) | Checkpoint |
+| 3 | 🧮 Core Logic & Utils | [`/re-ios-build`](reverse-ios-build.md) | Checkpoint |
+| 4 | 🎨 UI & ViewModel | [`/re-ios-build`](reverse-ios-build.md) | Per-screen loop |
+| 5 | 📦 SDK Integration | [`/re-ios-build`](reverse-ios-build.md) | Checkpoint |
+| 6 | ✅ Parity Check | [`/re-ios-build`](reverse-ios-build.md) | Final QA |
+
+### Execution Flow
+
+```
+Session Setup → Step 0+1 (/re-ios-scan) → Step 2-6 (/re-ios-build)
+```
+
+**Chạy tuần tự:** Xong `/re-ios-scan` → chuyển sang `/re-ios-build`.
+
+---
+
+## 🚫 WORKFLOW RULES
+
+```yaml
+never_skip:
+  - Step 0 (Framework Scanner) — always first
+  - User approval of Framework Report
+  - Checkpoint after each step
+
+never_do:
+  - Mass-copy assets from IPA
+  - Use UIKit when SwiftUI equivalent exists
+  - Use GCD for new async code (use async/await)
+  - Use ObjC in new code (Swift only, except bridging headers)
+  - Skip crypto parity testing
+
+always_do:
+  - Document decisions in session state
+  - Present Framework Report before coding
+  - XCTest all crypto/hash functions
+  - Use @Observable for ViewModels (iOS 17+)
+  - Use NavigationStack for navigation
+  - Use SPM for all dependencies
+```
+
+---
+
+## 🔗 Related
+
+- **Sub-workflows:** [`/re-ios-scan`](reverse-ios-scan.md) · [`/re-ios-build`](reverse-ios-build.md)
+- **Skill:** `smali-to-swift` (core knowledge & rules)
+- **Framework DB:** `skills/smali-to-swift/framework-patterns.md`
+- **ObjC Guide:** `skills/smali-to-swift/objc-reading-guide.md`
+- **Sibling:** `/reverse-android` (Android counterpart)
+- **After RE done:** `/test`, `/deploy`, `/code-janitor`
+
+---
+
+*reverse-ios workflow v2.0.0 — Modular RE Pipeline*