@leejungkiin/awkit 1.0.7 → 1.0.8

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

@@ -0,0 +1,112 @@
+---
+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 (UI-First) ⭐
+
+| # | Phase | Scope | Complexity |
+|---|-------|-------|-----------|
+| 1 | 🟢 Foundation | Xcode project + DI skeleton + Theme | Low |
+| 2 | 🟢 Navigation | NavigationStack, TabView, routes | Low |
+| 3 | 🔵 Per Feature | Blueprint (contracts) + UI Shell (visual) | Medium |
+| 4 | 🚦 UI Gate | User approves UI before logic | — |
+| 5 | 🟡 Per Feature | Logic Build (Domain → Data → VM → Wire UI) | High |
+| 6 | 📦 SDKs | Third-party SDK + Native libs integration | Medium |
+| N | 🔴 Final | Full Parity Check | High |
+
+> **UI-First:** Design and approve UI before coding logic for each feature.
+
+### 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*

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

@@ -0,0 +1,120 @@
+---
+description: 🗺️ RE iOS Phase 0 — Discovery & App Map (NO CODE output)
+parent: reverse-ios
+---
+
+# /re-ios-discover — Discovery & App Map
+
+> **Parent:** [`/reverse-ios`](reverse-ios.md) → Phase 0
+> **Skill:** `smali-to-swift` → `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 Swift code → STOP → wrong zoom level.
+```
+
+---
+
+## 📦 Step 0: Framework Scanner
+
+### 0.1: Quét IPA structure
+
+```bash
+# Embedded frameworks
+ls [app_bundle]/Frameworks/ 2>/dev/null
+
+# Non-system linked libs
+otool -L [app_bundle]/[AppName] | grep -v /System | grep -v /usr/lib
+
+# Header imports
+grep -rh "#import <" [headers_dir]/ | sort -u | head -30
+grep -rh "@import " [headers_dir]/ | sort -u
+
+# VC count
+grep -rl "UIViewController" [headers_dir]/ | wc -l
+
+# 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
+
+# SDK markers
+strings [app_bundle]/[AppName] | grep -i "cocoapods\|carthage\|firebase\|facebook" | head -20
+```
+
+### 0.2: Phân loại frameworks
+
+| Category | Action |
+|----------|--------|
+| ✅ Reuse | Add via SPM |
+| 🔄 Replace | Map to modern Swift |
+| 🍏 Apple | Use SwiftUI equivalents |
+| 📱 Native | Keep, bridging header |
+| 🏷️ App Code | Rebuild in Swift |
+
+### 0.3: User approval
+
+> **GATE:** Framework Report → User approve.
+
+---
+
+## 📄 Step 1: Info.plist & Entitlements
+
+```bash
+plutil -p [app_bundle]/Info.plist
+codesign -d --entitlements :- [app_bundle]/[AppName] 2>/dev/null
+```
+
+### 1.1: Trích xuất
+
+- Bundle ID, Display Name, Min iOS
+- Privacy permissions (NSCameraUsageDescription, etc.)
+- URL Schemes, Universal Links
+- Capabilities (push, Apple Pay, Sign In with Apple)
+
+### 1.2: Screen Map
+
+```bash
+grep -rl "UIViewController" [headers_dir]/ | sort
+grep -rl "UITabBarController" [headers_dir]/
+grep -rl "UINavigationController" [headers_dir]/
+```
+
+Mapping VCs → SwiftUI screens + navigation flow.
+
+### 1.3: Complexity Estimate
+
+| Area | Rating | Notes |
+|------|--------|-------|
+
+---
+
+## 📊 Output: App Map
+
+Template: `skills/smali-to-swift/templates/app-map.md`
+
+---
+
+## ✅ Gate
+
+```
+"🗺️ App Map xong! Anh review → OK → Phase 1 (Architecture)."
+→ /re-ios-design
+```
+
+---
+
+## 🔗 Related
+
+- **Next:** [`/re-ios-design`](reverse-ios-design.md)
+- **Parent:** [`/reverse-ios`](reverse-ios.md)
+
+---
+
+*re-ios-discover v3.0.0 — Phase 0: Discovery & App Map*

package/workflows/_uncategorized/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/_uncategorized/reverse-ios.md

@@ -0,0 +1,152 @@
+---
+description: 🍎 Dịch ngược IPA iOS (class-dump, Hopper output) → App Swift hiện đại với SwiftUI, Clean Architecture, và UI-First methodology.
+skill: smali-to-swift
+---
+
+# /reverse-ios — iOS IPA Reverse Engineering Workflow
+
+> **Skill:** `smali-to-swift` v2.0 | **Tech:** Swift + SwiftUI + async/await + URLSession + SwiftData
+> **Philosophy:** "Map → Blueprint → UI First → Logic Behind"
+> **Key:** UI is designed and approved BEFORE coding any business logic.
+> **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 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_ios_session:
+  project_name: "[TBD - từ Info.plist]"
+  app_bundle_dir: "[path]"
+  headers_dir: "[class-dump output]"
+  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
+
+```
+🍎 iOS Reverse Engineering v2.0 — UI-First Pipeline
+
+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 (5 Phases — UI-First)
+
+| Phase | Name | Sub-workflow | Code? | Gate |
+|-------|------|-------------|-------|------|
+| 0 | 🗺️ Discovery | [`/re-ios-discover`](reverse-ios-discover.md) | ❌ | User approves Map |
+| 1 | 🏗️ Architecture | [`/re-ios-design`](reverse-ios-design.md) | ❌ | User approves Architecture |
+| 2 | 📐🎨 Blueprint + UI | [`/re-ios-build`](reverse-ios-build.md) | UI code | User approves UI + Contracts |
+| 3 | 🔨 Logic Build | [`/re-ios-build`](reverse-ios-build.md) | Full logic | Feature checkpoint |
+| 4 | ✅ Final Parity | [`/re-ios-build`](reverse-ios-build.md) | — | Final check |
+
+### Execution Flow
+
+```
+Session Setup
+    ↓
+Phase 0: Discovery (/re-ios-discover) → App Map
+    ↓ [User approves]
+Phase 1: Architecture (/re-ios-design) → Architecture Blueprint
+    ↓ [User approves + picks feature]
+Feature Loop (/re-ios-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, file lists."
+  phase_2_contracts: "SIGNATURES ONLY. Protocols, structs, enums."
+  phase_2_ui: "FULL UI CODE. SwiftUI 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 assets from IPA (on-demand only)
+  - Use UIKit when SwiftUI equivalent exists
+  - Use GCD for new async code (use async/await)
+  - Use ObjC in new code (Swift only)
+  - Modify UI significantly in Phase 3 (only wire, don't redesign)
+  - Implement multiple features simultaneously
+
+always_do:
+  - Extract resources BEFORE coding UI (Phase 2.7 → 2.8)
+  - Create #Preview for ALL states
+  - Keep stateless View (LoginScreenContent) after wiring
+  - XCTest all crypto/hash functions
+  - Use @Observable for ViewModels
+  - Use NavigationStack, SPM
+  - Checkpoint after each feature
+```
+
+---
+
+## 🔗 Related
+
+- **Sub-workflows:**
+  - [`/re-ios-discover`](reverse-ios-discover.md) — Phase 0: Discovery
+  - [`/re-ios-design`](reverse-ios-design.md) — Phase 1: Architecture
+  - [`/re-ios-build`](reverse-ios-build.md) — Phase 2+3+4: Blueprint + UI + Build
+- **Skill:** `smali-to-swift` v2.0 (UI-First pipeline)
+- **Sibling:** `/reverse-android`
+- **After RE done:** `/test`, `/deploy`, `/code-janitor`
+
+---
+
+*reverse-ios workflow v4.0.0 — UI-First RE Pipeline*