@leejungkiin/awkit 1.5.2 → 1.5.4

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

@@ -1,240 +0,0 @@
----
-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*

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

@@ -1,112 +0,0 @@
----
-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/mobile/reverse-ios-discover.md

@@ -1,120 +0,0 @@
----
-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/mobile/reverse-ios.md

@@ -1,152 +0,0 @@
----
-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*