@leejungkiin/awkit 1.0.3 → 1.0.5

package/workflows/mobile/reverse-android.md

@@ -1,19 +1,20 @@
 ---
-description: 🔧 Dịch ngược APK Android (Apktool output) → App Kotlin hiện đại với Jetpack Compose, Clean Architecture, và Library Scanner tự động.
+description: 🔧 Dịch ngược APK Android (Apktool output) → App Kotlin hiện đại với Jetpack Compose, Clean Architecture. Progressive Disclosure: Map → Blueprint → Build.
 skill: smali-to-kotlin
 ---
 
 # /reverse-android — Android APK Reverse Engineering Workflow
 
-> **Skill:** `smali-to-kotlin` | **Tech:** Kotlin + Compose + Hilt + Retrofit + Room
-> **Philosophy:** "Read Smali to understand WHAT & WHY → Write Kotlin for HOW"
+> **Skill:** `smali-to-kotlin` v2.0 | **Tech:** Kotlin + Compose + Hilt + Retrofit + Room
+> **Philosophy:** "Treat decompiled code as a MAP, not a TODO list"
+> **Approach:** Map → Blueprint → Build (progressive disclosure)
 
 ---
 
 ## ⚡ 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 từng bước — **không bao giờ nhảy cóc**.
+Workflow dẫn dắt qua **4 phases** — mỗi phase có zoom level riêng, **không bao giờ nhảy cóc**.
 
 ---
 
@@ -25,18 +26,20 @@ Workflow dẫn dắt từng bước — **không bao giờ nhảy cóc**.
 reverse_session:
   project_name: "[TBD - từ manifest]"
   apktool_dir: "[path]"
-  current_step: 0
-  library_report_done: false
-  manifest_analyzed: false
-  completed_screens: []
-  pending_screens: []
+  current_phase: 0
+  current_zoom: 0       # 0=satellite, 1=district, 2=block, 3=ground
+  current_feature: null  # set khi user chọn feature ở Phase 2
+  app_map_done: false
+  architecture_done: false
+  completed_features: []
+  pending_features: []
   decisions: []
 ```
 
 ### Bước 0.2: Xác nhận input
 
 ```
-🔧 Android Reverse Engineering bắt đầu!
+🔧 Android Reverse Engineering v2.0 — Map → Blueprint → Build
 
 Em cần biết:
 1. Thư mục Apktool output ở đâu?
@@ -47,25 +50,50 @@ Chưa chạy Apktool? → apktool d your-app.apk -o ./decompiled/
 
 ---
 
-## 📋 Pipeline Overview (7 Steps)
+## 📋 Pipeline Overview (4 Phases)
 
-| Step | Phase | Sub-workflow | Gate |
-|------|-------|-------------|------|
-| 0 | 📦 Library Scanner | [`/re-android-scan`](reverse-android-scan.md) | User approve report |
-| 1 | 📄 Manifest & Bootstrap | [`/re-android-scan`](reverse-android-scan.md) | Checkpoint |
-| 2 | 💾 Data Layer | [`/re-android-build`](reverse-android-build.md) | Checkpoint |
-| 3 | 🧮 Core Logic & Utils | [`/re-android-build`](reverse-android-build.md) | Checkpoint |
-| 4 | 🎨 UI & ViewModel | [`/re-android-build`](reverse-android-build.md) | Per-screen loop |
-| 5 | 📦 SDK Integration | [`/re-android-build`](reverse-android-build.md) | Checkpoint |
-| 6 | ✅ Parity Check | [`/re-android-build`](reverse-android-build.md) | Final QA |
+| Phase | Name | Sub-workflow | Zoom | Code? | Gate |
+|-------|------|-------------|------|-------|------|
+| 0 | 🗺️ Discovery | [`/re-android-discover`](reverse-android-discover.md) | Satellite | ❌ | User approves Map |
+| 1 | 🏗️ Architecture | [`/re-android-design`](reverse-android-design.md) | District | ❌ | User approves Architecture |
+| 2 | 📐 Blueprint | [`/re-android-build`](reverse-android-build.md) | Block | Signatures | Per-feature approval |
+| 3 | 🔨 Implementation | [`/re-android-build`](reverse-android-build.md) | Ground | Full | Per-feature checkpoint |
 
 ### Execution Flow
 
 ```
-Session Setup → Step 0+1 (/re-android-scan) → Step 2-6 (/re-android-build)
+Session Setup
+    ↓
+Phase 0: Discovery (/re-android-discover) → App Map
+    ↓ [User approves]
+Phase 1: Architecture (/re-android-design) → Architecture Blueprint
+    ↓ [User approves + picks feature]
+Phase 2+3 Loop (/re-android-build):
+    → Blueprint Feature X → Build Feature X → Checkpoint
+    → Blueprint Feature Y → Build Feature Y → Checkpoint
+    → ... (repeat for all features)
+    ↓
+Final: Parity Check & Quality Gate
 ```
 
-**Chạy tuần tự:** Xong `/re-android-scan` → chuyển sang `/re-android-build`.
+---
+
+## 🔭 ZOOM CONTROL
+
+AI phải tự check **TRƯỚC MỖI output**:
+
+```yaml
+pre_output_check:
+  - "Đang ở zoom level nào? (0/1/2/3)"
+  - "Output có đúng zoom level không?"
+  - "Có function body trong Phase 0/1 không? → REMOVE"
+
+zoom_rules:
+  zoom_0: "NO CODE. Only diagrams, tables, maps."
+  zoom_1: "NO CODE BODIES. Only architecture diagrams, file lists."
+  zoom_2: "SIGNATURES ONLY. Interfaces, data classes, sealed classes."
+  zoom_3: "FULL CODE. Implementation for ONE feature at a time."
+```
 
 ---
 
@@ -73,34 +101,37 @@ Session Setup → Step 0+1 (/re-android-scan) → Step 2-6 (/re-android-build)
 
 ```yaml
 never_skip:
-  - Step 0 (Library Scanner) — always first
-  - User approval of Library Report — gate before Step 1
-  - Checkpoint after each step — no silent progress
+  - Phase 0 (Discovery) — always first, MUST create App Map
+  - Phase 1 (Architecture) — MUST design before coding
+  - User approval at each phase gate
+  - Per-feature Blueprint before Implementation
 
 never_do:
+  - Write code in Phase 0 or Phase 1
   - Mass-copy resources from APK (on-demand only)
-  - Use deprecated libraries without replacement plan
-  - Skip parity check for encryption utils
-  - Proceed to next step without user confirmation
+  - Implement multiple features simultaneously
+  - Skip parity check for crypto utils
 
 always_do:
-  - Document decisions in session state
-  - Present Library Report before any coding
-  - Unit test all crypto/hash functions
-  - Update session state after each screen in Step 4
+  - Start with App Map (Phase 0)
+  - Present Architecture for review (Phase 1)
+  - Create Blueprint before coding each feature (Phase 2)
+  - Checkpoint after each feature (Phase 3)
+  - Document all decisions in session state
 ```
 
 ---
 
 ## 🔗 Related
 
-- **Sub-workflows:** [`/re-android-scan`](reverse-android-scan.md) · [`/re-android-build`](reverse-android-build.md)
-- **Skill:** `smali-to-kotlin` (core knowledge & rules)
-- **Library DB:** `skills/smali-to-kotlin/library-patterns.md`
-- **Smali Guide:** `skills/smali-to-kotlin/smali-reading-guide.md`
+- **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: Blueprint + Build
+- **Skill:** `smali-to-kotlin` v2.0 (core knowledge & rules)
 - **Sibling:** `/reverse-ios` (iOS counterpart)
 - **After RE done:** `/test`, `/deploy`, `/code-janitor`
 
 ---
 
-*reverse-android workflow v2.0.0 — Modular RE Pipeline*
+*reverse-android workflow v3.0.0 — Progressive Disclosure RE Pipeline*

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

@@ -1,248 +1,129 @@
 ---
-description: 🏗️ RE iOS Phase 2 — Data Layer, Utils, UI, SDK Integration & Parity Check
+description: 🔨 RE iOS Phase 2+3 — Per-feature Blueprint → Implementation → Parity Check
 parent: reverse-ios
 ---
 
-# /re-ios-build — Build & Verify
+# /re-ios-build — Blueprint & Build (Per Feature)
 
-> **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`
+> **Parent:** [`/reverse-ios`](reverse-ios.md) → Phase 2+3
+> **Prerequisite:** Completed Architecture from [`/re-ios-design`](reverse-ios-design.md)
+> **Skill:** `smali-to-swift` → `phase-2-blueprint.md` + `phase-3-build.md`
 
 ---
 
-## 💾 Step 2: Data Layer Reconstruction
+## 🔄 Feature Loop
 
-> **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)
-    }
-}
+For each feature (from Architecture Build Order):
+    Phase 2: Blueprint (Zoom 2 — signatures only)
+        ↓ [User approves]
+    Phase 3: Implementation (Zoom 3 — full code)
+        ↓ [Checkpoint]
+    → Next feature
 ```
 
-### 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
+## 📐 Phase 2: Feature Blueprint (Zoom 2)
 
-> **CRITICAL:** Crypto output MUST match original
+> **Output:** Contracts, protocols, state design. **Signatures only.**
 
-### 3.1: Crypto utils → Swift
+### 2.1: Deep Header Reading
 
-```swift
-import CryptoKit
-import CommonCrypto
+Read class-dump headers + Hopper pseudo-code for chosen feature.
 
-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()
-    }
-}
+**ObjC → Swift Quick Ref:**
 ```
-
-### 3.2: XCTest verification (BẮT BUỘC cho crypto)
-
-```swift
-final class CryptoUtilsTests: XCTestCase {
-    func testMD5MatchesOriginal() {
-        XCTAssertEqual(CryptoUtils.md5("test"), "098f6bcd4621d373cade4e832627b4f6")
-    }
-}
+@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
 ```
 
-### ✅ 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
+### 2.2: Domain Contracts
 
 ```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) }
-        }
-    }
+struct [Model]: Codable, Identifiable, Sendable {
+    let field1: Type
+    // CodingKeys if needed
 }
-```
 
-### 4.3: @Observable ViewModel
+protocol [Feature]Repository: Sendable {
+    func [method](...) async throws -> [Type]
+}
 
-```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 }
-    }
+struct [Action]UseCase: Sendable {
+    func execute(...) async throws -> [Type]
 }
 ```
 
-### ✅ Checkpoint Step 4 (Per Screen)
+### 2.3: UI State Design
 
-> **Loop:** Lặp 4.0 cho screen tiếp. Hết screen → Step 5.
+- @Observable ViewModel properties
+- User actions
+- Navigation events
+- Wireframe
 
----
-
-## 📦 Step 5: SDK & Native Library Integration
+### ✅ Blueprint Gate
 
-### 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
-    }
-}
+"📐 Blueprint cho [Feature] xong. OK? → Code."
 ```
 
-### 5.3: Native C/C++ → Bridging Header
+---
 
-```c
-// App-Bridging-Header.h
-#include "native_lib.h"
-```
+## 🔨 Phase 3: Implementation (Zoom 3)
 
-### ✅ Checkpoint Step 5
+> **Full Swift code for THIS feature only.**
 
----
+### 3.1: Domain → Data → DI → ViewModel → Screen
 
-## ✅ Step 6: Parity Check & Quality Gate
+Standard implementation order:
+1. Codable structs
+2. Repository protocol + implementation
+3. APIClient endpoints
+4. SwiftData models (if applicable)
+5. DI container entries
+6. @Observable ViewModel
+7. SwiftUI Screen
+8. Resource extraction (on-demand only)
 
-### 6.1: Edge Case checklist
+### 🔒 Crypto (Special)
 
-```markdown
-- [ ] Login empty/invalid input
-- [ ] Network offline → cached data?
-- [ ] App background during API call
-- [ ] Deep link handling
-- [ ] Push notification → correct screen
+```swift
+import CryptoKit
+import CommonCrypto
+// XCTest mandatory for crypto utils
 ```
 
-### 6.2: Build & Test
+> ⚠️ Crypto MUST match original output.
 
-```bash
-xcodebuild -scheme App -destination 'generic/platform=iOS' build
-xcodebuild -scheme App -destination 'platform=iOS Simulator,name=iPhone 16' test
-swiftlint lint
+### ✅ Feature Checkpoint
+
+```markdown
+## ✅ Feature Complete: [Name]
+### Files created: [list]
+### Tests: [crypto verified?]
+⏭️ Next: Phase 2 for [next feature]
 ```
 
-### 🎉 Final Summary
+---
 
-```markdown
-## Complete!
-- Screens: [count] | Frameworks reused: [count] | Replaced: [count]
+## ✅ Final Parity Check
 
-⏭️ Next: /test → /deploy → /code-janitor
-```
+- [ ] API Parity
+- [ ] Data/Crypto Parity
+- [ ] UI Parity
+- [ ] Build: `xcodebuild build && xcodebuild test`
 
 ---
 
 ## 🔗 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`
+- **Previous:** [`/re-ios-design`](reverse-ios-design.md)
+- **Skill:** `smali-to-swift` → `phase-2-blueprint.md` + `phase-3-build.md`
 
 ---
 
-*re-ios-build v2.0.0 — Phase 2: Build & Verify*
+*re-ios-build v3.0.0 — Phase 2+3: Blueprint & Build*

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

@@ -0,0 +1,103 @@
+---
+description: 🏗️ RE iOS Phase 1 — Architecture Design (NO CODE BODIES)
+parent: reverse-ios
+---
+
+# /re-ios-design — Architecture Blueprint
+
+> **Parent:** [`/reverse-ios`](reverse-ios.md) → Phase 1
+> **Prerequisite:** Completed App Map from [`/re-ios-discover`](reverse-ios-discover.md)
+> **Skill:** `smali-to-swift` → `phase-1-architecture.md`
+> **Zoom Level:** 1 — District View
+> **Output:** Architecture Blueprint (NO CODE BODIES)
+
+---
+
+## ⛔ ZOOM 1 RULE
+
+```
+NO CODE BODIES. Only architecture diagrams, file paths, tables, SPM declarations.
+```
+
+---
+
+## 📐 Architecture Steps
+
+### Step 1: Layer Design
+
+```
+┌────────────────────────────────┐
+│ Presentation (SwiftUI)         │
+├────────────────────────────────┤
+│ Domain (Models, Protocols, UC) │
+├────────────────────────────────┤
+│ Data (Network, Local, Repos)   │
+├────────────────────────────────┤
+│ DI (AppContainer)              │
+└────────────────────────────────┘
+```
+
+### Step 2: Feature → File Mapping
+
+| Feature | Model | Repository | UseCase | Screen | ViewModel |
+|---------|-------|-----------|---------|--------|-----------|
+
+### Step 3: API Inventory
+
+| # | Method | Endpoint | Auth | Notes |
+|---|--------|----------|------|-------|
+
+### Step 4: Data Schema
+
+| Model | Key Fields | Source | Storage |
+|-------|-----------|--------|---------|
+
+### Step 5: Xcode Structure
+
+```
+App/
+├── App.swift
+├── DI/
+├── Data/Network/ + Local/ + Repositories/
+├── Domain/Models/ + Repositories/ + UseCases/
+├── Presentation/Navigation/ + Screens/ + Theme/
+├── Utilities/
+└── Resources/
+```
+
+### Step 6: Build Order
+
+| # | Phase | Scope | Complexity |
+|---|-------|-------|-----------|
+
+### Step 7: Tech Decisions
+
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+
+---
+
+## 📊 Output
+
+Template: `skills/smali-to-swift/templates/architecture.md`
+
+---
+
+## ✅ Gate
+
+```
+"🏗️ Architecture xong! Anh chọn feature nào làm trước?"
+→ /re-ios-build (Phase 2: Blueprint)
+```
+
+---
+
+## 🔗 Related
+
+- **Previous:** [`/re-ios-discover`](reverse-ios-discover.md)
+- **Next:** [`/re-ios-build`](reverse-ios-build.md)
+- **Parent:** [`/reverse-ios`](reverse-ios.md)
+
+---
+
+*re-ios-design v3.0.0 — Phase 1: Architecture Blueprint*