@leejungkiin/awkit 1.0.7 → 1.0.8

package/skills/smali-to-swift/phase-3-build.md

@@ -0,0 +1,257 @@
+# 🔨 Phase 3: Implementation (Ground View — per feature) — iOS
+
+> **Zoom Level:** 3 — Code Implementation
+> **Goal:** Write actual, production-quality Swift code for ONE feature.
+> **Input:** Approved Blueprint from Phase 2.
+> **Output:** Complete implementation files.
+
+---
+
+## ✅ PREREQUISITES
+
+Before writing ANY code, confirm:
+- [ ] Phase 0 App Map approved
+- [ ] Phase 1 Architecture Blueprint approved
+- [ ] Phase 2 Feature Blueprint approved for THIS feature
+- [ ] All contracts (protocols, models, state) defined in Blueprint
+
+---
+
+## 📋 Implementation Order (per feature)
+
+### 3.1: Domain Layer
+
+1. **Models** — Codable structs from Blueprint 2.2
+2. **Repository protocols** — from Blueprint 2.3
+3. **UseCases** — implement with repository calls
+
+```swift
+struct LoginUseCase: Sendable {
+    let authRepository: AuthRepository
+    
+    func execute(email: String, password: String) async throws -> User {
+        try await authRepository.login(email: email, password: password)
+    }
+}
+```
+
+### 3.2: Data Layer
+
+1. **DTOs** — Codable structs matching API JSON
+2. **Endpoint definitions** — enum with path/method
+3. **APIClient** — URLSession async/await wrapper
+4. **SwiftData models** (if applicable)
+5. **Repository implementation** — offline-first
+
+```swift
+final class AuthRepositoryImpl: AuthRepository, Sendable {
+    private let apiClient: APIClient
+    private let tokenStore: TokenStore
+    
+    func login(email: String, password: String) async throws -> User {
+        let response: LoginResponse = try await apiClient.request(
+            .login(email: email, password: password)
+        )
+        await tokenStore.save(response.accessToken)
+        return response.user.toDomain()
+    }
+    
+    var isLoggedIn: AsyncStream<Bool> {
+        tokenStore.tokenStream.map { !$0.isEmpty }.eraseToStream()
+    }
+}
+```
+
+### 3.3: DI Container
+
+```swift
+@MainActor
+final class AppContainer: Observable {
+    private let apiClient: APIClient
+    
+    lazy var authRepository: AuthRepository = AuthRepositoryImpl(
+        apiClient: apiClient,
+        tokenStore: tokenStore
+    )
+    
+    lazy var loginUseCase = LoginUseCase(authRepository: authRepository)
+}
+```
+
+### 3.4: ViewModel
+
+@Observable with properties from Blueprint:
+
+```swift
+@Observable
+final class LoginViewModel {
+    var email = ""
+    var password = ""
+    var isLoading = false
+    var showError = false
+    var errorMessage = ""
+    var isPasswordVisible = false
+    
+    private let loginUseCase: LoginUseCase
+    
+    init(loginUseCase: LoginUseCase) {
+        self.loginUseCase = loginUseCase
+    }
+    
+    func login() async {
+        isLoading = true
+        defer { isLoading = false }
+        
+        do {
+            let user = try await loginUseCase.execute(email: email, password: password)
+            // Navigation handled by parent
+        } catch {
+            errorMessage = error.localizedDescription
+            showError = true
+        }
+    }
+}
+```
+
+### 3.5: SwiftUI Screen
+
+```swift
+struct LoginScreen: View {
+    @State private var viewModel: LoginViewModel
+    var onLoginSuccess: (User) -> Void
+    
+    init(loginUseCase: LoginUseCase, onLoginSuccess: @escaping (User) -> Void) {
+        _viewModel = State(initialValue: LoginViewModel(loginUseCase: loginUseCase))
+        self.onLoginSuccess = onLoginSuccess
+    }
+    
+    var body: some View {
+        ScrollView {
+            VStack(spacing: 24) {
+                // Logo
+                // Email TextField
+                TextField("Email", text: $viewModel.email)
+                    .textContentType(.emailAddress)
+                    .keyboardType(.emailAddress)
+                    .textFieldStyle(.roundedBorder)
+                
+                // Password SecureField
+                // Login Button
+                Button("Login") {
+                    Task { await viewModel.login() }
+                }
+                .buttonStyle(.borderedProminent)
+                .disabled(viewModel.isLoading)
+            }
+            .padding(24)
+        }
+        .overlay { if viewModel.isLoading { ProgressView() } }
+        .alert("Error", isPresented: $viewModel.showError) {
+            Button("OK") {}
+        } message: {
+            Text(viewModel.errorMessage)
+        }
+    }
+}
+```
+
+### 3.6: Resource Extraction (On-Demand)
+
+**ONLY** extract resources used by this screen:
+
+```bash
+# Images from Assets.car (use assetutil)
+# Strings from Localizable.strings for this VC
+# Colors referenced in storyboard for this screen
+```
+
+---
+
+## 🔒 CRYPTO UTILS (Special Handling)
+
+If the feature involves encryption/hashing:
+
+```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()
+    }
+}
+
+// XCTest (mandatory)
+final class CryptoUtilsTests: XCTestCase {
+    func testMD5MatchesOriginal() {
+        XCTAssertEqual(CryptoUtils.md5("test"), "098f6bcd4621d373cade4e832627b4f6")
+    }
+}
+```
+
+> ⚠️ Crypto functions MUST produce identical output. Test with known pairs from original app.
+
+---
+
+## ✅ Checkpoint (After each feature)
+
+```markdown
+## ✅ Feature Complete: [Feature Name]
+
+### Files created:
+- Domain/Models/User.swift
+- Domain/Repositories/AuthRepository.swift
+- Domain/UseCases/LoginUseCase.swift
+- Data/Network/Endpoints/AuthEndpoint.swift
+- Data/Network/DTOs/LoginRequest.swift, LoginResponse.swift
+- Data/Repositories/AuthRepositoryImpl.swift
+- Presentation/Screens/Auth/LoginScreen.swift
+- Presentation/Screens/Auth/LoginViewModel.swift
+
+### Resources extracted:
+- [only what was needed]
+
+### Tests:
+- [ ] Crypto utils verified
+- [ ] API contract matches original
+
+### ⏭️ Next Feature: [Name]
+→ Return to Phase 2 (Blueprint)
+```
+
+---
+
+## 🔄 Loop
+
+```
+Phase 2 (Blueprint Feature X) → Phase 3 (Build Feature X) → Checkpoint
+    ↓
+Phase 2 (Blueprint Feature Y) → Phase 3 (Build Feature Y) → Checkpoint
+    ↓
+... → Final Parity Check
+```
+
+---
+
+## ✅ Final Parity Check
+
+1. **API Parity** — all endpoints match
+2. **Data Parity** — crypto output identical
+3. **UI Parity** — screen comparison
+4. **Build & Test:**
+```bash
+xcodebuild -scheme App -destination 'generic/platform=iOS' build
+xcodebuild -scheme App -destination 'platform=iOS Simulator,name=iPhone 16' test
+```
+
+---
+
+*Phase 3: Implementation — One feature at a time, guided by Blueprint*

package/skills/smali-to-swift/templates/app-map.md

@@ -0,0 +1,82 @@
+# 🗺️ App Map: [App Name] (iOS)
+
+**Generated:** [Date]
+**Source:** [Decrypted .app bundle path]
+
+---
+
+## 📱 Identity
+
+| Property | Value |
+|----------|-------|
+| Bundle ID | [com.example.app] |
+| App Name | [Display Name] |
+| Min iOS | [value] |
+| ViewControllers | [count] |
+| Frameworks | [count] embedded |
+| Capabilities | [push, apple pay, etc.] |
+
+---
+
+## 🧭 Screen Flow
+
+```mermaid
+graph LR
+    Launch --> Login
+    Login --> MainTab
+    MainTab --> Home
+    MainTab --> Tab2
+    MainTab --> Tab3
+    Home --> Detail
+```
+
+---
+
+## 📦 Framework Landscape
+
+### ✅ Reuse (add via SPM)
+| Framework | Detected | Latest Version | Action |
+|-----------|----------|----------------|--------|
+
+### 🔄 Replace (legacy → modern Swift)
+| Old Framework | Detected | Modern Replacement |
+|---------------|----------|-------------------|
+
+### 🍏 Apple Frameworks
+| Framework | Purpose | SwiftUI Equivalent |
+|-----------|---------|--------------------|
+
+### 📱 Native Libraries
+| File | Notes |
+|------|-------|
+
+### 🏷️ App Code (rebuild in Swift)
+| Class Prefix | Estimated Module |
+|-------------|-----------------|
+
+### ❓ Unknown
+| Framework | Notes |
+|-----------|-------|
+
+---
+
+## 📊 Complexity Estimate
+
+| Area | Rating | Notes |
+|------|--------|-------|
+| Data Layer | ●●●○○ | [N] APIs, [N] local DB, keychain |
+| Core Logic | ●●○○○ | [N] crypto, [N] formatters |
+| UI Screens | ●●●●○ | [N] screens, [N] complex |
+| SDK Integration | ●●○○○ | [N] frameworks, [N] native |
+
+---
+
+## 🔍 Key Observations
+
+- [Notable patterns]
+- [Security observations]
+- [Risks]
+
+---
+
+> **Next:** Review map → Phase 1 (Architecture)

package/skills/smali-to-swift/templates/architecture.md

@@ -0,0 +1,97 @@
+# 🏗️ Architecture Blueprint: [App Name] (iOS)
+
+**Generated:** [Date]
+**Based on:** App Map v[date]
+
+---
+
+## 📐 Layer Map
+
+```
+┌─────────────────────────────────────┐
+│ Presentation                        │
+│ ├── Screens/ ([N] screens)          │
+│ ├── Navigation/ (NavigationStack)   │
+│ ├── Theme/ (AppTheme)             │
+│ └── Components/ (Shared Views)     │
+├─────────────────────────────────────┤
+│ Domain                              │
+│ ├── Models/ ([N] business models)   │
+│ ├── Repositories/ ([N] protocols)  │
+│ └── UseCases/ ([N] use cases)       │
+├─────────────────────────────────────┤
+│ Data                                │
+│ ├── Network/ (APIClient)           │
+│ ├── Local/ (SwiftData, Keychain)   │
+│ └── Repositories/ (impls)          │
+├─────────────────────────────────────┤
+│ DI                                  │
+│ └── AppContainer.swift             │
+└─────────────────────────────────────┘
+```
+
+---
+
+## 🗂️ Feature → File Mapping
+
+| Feature | Domain Model | Repository | UseCase | Screen(s) | ViewModel |
+|---------|-------------|-----------|---------|-----------|-----------|
+
+---
+
+## 🌐 API Endpoints
+
+| # | Method | Endpoint | Auth | Notes |
+|---|--------|----------|------|-------|
+
+**Base URL:** `[extracted]`
+
+---
+
+## 💾 Data Schema
+
+| Model | Key Fields | Source | Storage |
+|-------|-----------|--------|---------|
+
+---
+
+## 📁 Xcode Project Structure
+
+```
+App/
+├── App.swift
+├── AppDelegate.swift
+├── DI/AppContainer.swift
+├── Data/Network/
+├── Data/Local/
+├── Data/Repositories/
+├── Domain/Models/
+├── Domain/Repositories/
+├── Domain/UseCases/
+├── Presentation/Navigation/
+├── Presentation/Theme/
+├── Presentation/Components/
+├── Presentation/Screens/
+├── Utilities/
+└── Resources/
+```
+
+---
+
+## 🔢 Build Order
+
+| # | Phase | Scope | Complexity |
+|---|-------|-------|-----------|
+
+**Suggested first feature:** [Name] — because [reason]
+
+---
+
+## 🔧 Tech Decisions
+
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+
+---
+
+> **Next:** Pick feature → Phase 2 (Blueprint)

package/skills/smali-to-swift/templates/blueprint.md

@@ -0,0 +1,82 @@
+# 📐 Feature Blueprint: [Feature Name] (iOS)
+
+**Generated:** [Date]
+**Architecture:** [App Name]
+**Feature:** [Feature Name]
+
+---
+
+## 🔍 Header/Disassembly Analysis
+
+| Item | Value |
+|------|-------|
+| Headers analyzed | [list] |
+| Classes found | [count] |
+| API calls detected | [count] |
+| Delegate patterns | [count] |
+
+### Key Observations
+- [Pattern 1]
+- [Pattern 2]
+
+---
+
+## 📦 Domain Models
+
+```swift
+struct [Model]: Codable, Identifiable, Sendable {
+    let field1: Type
+    // ...
+}
+```
+
+---
+
+## 📡 Repository Protocol
+
+```swift
+protocol [Feature]Repository: Sendable {
+    func [method](...) async throws -> [Type]
+}
+```
+
+---
+
+## 🧩 UseCase Signatures
+
+```swift
+struct [Action]UseCase: Sendable {
+    func execute(...) async throws -> [Type]
+}
+```
+
+---
+
+## 🎨 UI State Design
+
+- ViewModel properties list
+- User actions list
+- Navigation events list
+
+---
+
+## 🖼️ Screen Wireframe
+
+```
+┌────────────────────────┐
+│                        │
+│    [Layout sketch]     │
+│                        │
+└────────────────────────┘
+```
+
+---
+
+## 📁 Files to Create
+
+| File | Layer | Type |
+|------|-------|------|
+
+---
+
+> **Next:** Approve → Phase 3 (Implementation)

package/skills/workflows/nm-import.md

@@ -0,0 +1,73 @@
+---
+description: Import project knowledge into NeuralMemory (decisions, errors, patterns)
+---
+
+# /nm-import — Project Knowledge Import
+
+## When to use
+- Bắt đầu NeuralMemory trên project đã có sẵn
+- Sau khi `awk enable-pack neural-memory` lần đầu
+- Muốn bulk-import từ brain/ Markdown files (legacy)
+
+## What to import
+
+```
+Priority 1 — Decisions (brain/decisions/*.md)
+Priority 2 — Solutions (brain/solutions/*.md)  
+Priority 3 — CODEBASE.md (architecture patterns)
+Priority 4 — .project-identity (project context)
+Priority 5 — git log (recent changes pattern)
+```
+
+## Steps
+
+### Step 1: Scan sources
+```
+Sources found:
+  brain/decisions/ — 12 files
+  brain/solutions/ — 8 files
+  CODEBASE.md — 1 file
+  .project-identity — 1 file
+
+Total import estimate: ~45 memories
+Proceed? [yes/no]
+```
+
+### Step 2: Parse each source
+For each file:
+- Extract individual information units
+- Classify by type (decision, error, fact, instruction)
+- Extract tags from content
+- Set priority based on type
+
+### Step 3: Deduplication
+```python
+# Check NeuralMemory for existing similar memories
+nmem_recall(content_keywords)
+# → Skip if identical
+# → Flag if conflicting
+```
+
+### Step 4: Batch import preview
+Show 10 at a time, confirm each batch
+
+### Step 5: Build synapse graph
+After import, run:
+```python
+nmem_auto()  # Auto-detect relationships between imported memories
+```
+
+### Step 6: Import summary
+```
+✅ Import Complete
+   Imported: 42 memories
+   Skipped: 3 duplicates
+   Auto-linked: 18 synapse connections
+
+Brain is now seeded. Run /memory-audit to check quality.
+```
+
+## Anti-patterns
+- Do NOT import everything blindly — quality over quantity
+- Do NOT import temporary notes or debug snippets
+- Do NOT skip the deduplication step (creates noise)

package/skills/workflows/nm-recall.md

@@ -0,0 +1,67 @@
+---
+description: Query NeuralMemory với associative recall (spreading activation)
+---
+
+# /nm-recall — NeuralMemory Associative Recall
+
+## When to use
+- Cần tìm lại quyết định, lỗi, hoặc patterns từ past sessions
+- Regular recall không đủ — cần associative links
+- Muốn surface hidden connections giữa các memories
+
+## Steps
+
+1. **Extract query keywords** từ user's question
+   - Lấy 3-5 keywords cốt lõi
+   - Bỏ qua stop words
+
+2. **Run activating recall**
+   ```
+   nmem_recall(query, depth=2)
+   ```
+   - `depth=1`: Instant recall — direct matches only
+   - `depth=2`: Context recall — + 1 hop via synapses (default)
+   - `depth=3`: Deep recall — use for complex architecture questions
+
+3. **Format recall results**
+   ```
+   🧠 Recalled [N] memories for: "[query]"
+   
+   [type] "[content excerpt]"
+   → Tags: [tags] | Priority: [P] | Age: [X days]
+   → Connected to: [related memory brief] via [synapse_type]
+   
+   [type] "[content excerpt]"
+   ...
+   ```
+
+4. **Surface connections**
+   - Highlight `CAUSED_BY`, `LEADS_TO`, `DISCUSSED` links
+   - Show causal chains when relevant: A → caused → B → leads to → C
+
+5. **If no results (depth=2)**
+   - Try `depth=3` automatically
+   - If still empty: "🧠 No relevant memories found. Consider /nm-intake to capture this."
+
+## Output Examples
+
+```
+🧠 Recalled 3 memories for: "auth JWT"
+
+[decision] "Chose JWT over sessions for stateless API auth"
+→ Tags: [auth, jwt, api, decision] | Priority: 8 | Age: 14 days
+→ Caused by: "Need to support mobile + web clients simultaneously"
+→ Leads to: "JWT stored in Authorization header, 24h expiry"
+
+[error] "Fixed: JWT middleware running before auth check caused 401 on valid tokens"
+→ Tags: [auth, jwt, middleware, error] | Priority: 7 | Age: 5 days
+→ Solution: "Reorder middleware: auth check → JWT verify → route handler"
+
+[instruction] "Never store JWT in localStorage — XSS vulnerability"
+→ Tags: [auth, security, jwt, instruction] | Priority: 9 | Age: 30 days
+```
+
+## Anti-patterns
+- Do NOT just keyword search — use NeuralMemory's associative engine
+- Do NOT show all memories — only top activations (max 8)
+- Do NOT skip connections — the synapse links ARE the value