@leejungkiin/awkit 1.0.6 → 1.0.8

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

@@ -0,0 +1,312 @@
+# 🔨 Phase 3: Logic Build (Per Feature) — iOS
+
+> **Zoom Level:** 3 — Code Implementation
+> **Goal:** Code logic behind the APPROVED UI shell for ONE feature.
+> **Input:** Approved Blueprint + Working SwiftUI Shell from Phase 2.
+> **Output:** Feature fully wired — UI + logic connected.
+
+---
+
+## ✅ PREREQUISITES
+
+Before writing ANY logic code, confirm:
+- [ ] Phase 0 App Map: approved
+- [ ] Phase 1 Architecture Blueprint: approved
+- [ ] Phase 2 Contracts: approved for THIS feature
+- [ ] Phase 2 UI Shell: approved, runs in Preview/Simulator
+
+> ⚠️ If UI is not approved yet, STOP. Go back to Phase 2.
+
+---
+
+## 📋 Implementation Order
+
+### 3.1: Domain Layer
+
+Implement from contracts defined in Phase 2:
+
+1. **Models** — structs (already drafted in 2.2, create actual files)
+2. **Repository protocols** — (already drafted in 2.3, create files)
+3. **UseCases** — implement execute() with repository calls
+
+```swift
+struct LoginUseCase {
+    private let authRepo: AuthRepository
+
+    func execute(email: String, password: String) async throws -> User {
+        try await authRepo.login(email: email, password: password)
+    }
+}
+```
+
+### 3.2: Data Layer
+
+1. **DTOs** — Codable structs matching API JSON
+2. **API Client** — async URLSession with proper error handling
+3. **SwiftData @Model** classes (if applicable)
+4. **Keychain / UserDefaults** wrappers (if applicable)
+5. **Repository implementation** — offline-first pattern
+
+```swift
+final class AuthRepositoryImpl: AuthRepository {
+    private let apiClient: APIClient
+    private let tokenStore: TokenStore
+
+    func login(email: String, password: String) async throws -> User {
+        let dto = try await apiClient.request(
+            AuthEndpoint.login(email: email, password: password),
+            responseType: LoginResponseDTO.self
+        )
+        await tokenStore.save(dto.accessToken)
+        return dto.user.toDomain()
+    }
+
+    func isLoggedIn() -> Bool {
+        tokenStore.hasToken
+    }
+}
+```
+
+### 3.3: DI Container
+
+```swift
+@MainActor
+final class AppContainer {
+    // Singletons
+    lazy var apiClient = APIClient(baseURL: Config.apiBaseURL)
+    lazy var tokenStore = TokenStore()
+
+    // Repositories
+    lazy var authRepository: AuthRepository = AuthRepositoryImpl(
+        apiClient: apiClient,
+        tokenStore: tokenStore
+    )
+
+    // UseCases
+    func makeLoginUseCase() -> LoginUseCase {
+        LoginUseCase(authRepo: authRepository)
+    }
+
+    // ViewModels
+    func makeLoginViewModel() -> LoginViewModel {
+        LoginViewModel(loginUseCase: makeLoginUseCase())
+    }
+}
+```
+
+### 3.4: ViewModel
+
+Implement using ViewState + Events + Actions from Phase 2.6:
+
+```swift
+@Observable
+final class LoginViewModel {
+    var state = LoginViewState()
+
+    private let loginUseCase: LoginUseCase
+    private var onEvent: ((LoginEvent) -> Void)?
+
+    init(loginUseCase: LoginUseCase) {
+        self.loginUseCase = loginUseCase
+    }
+
+    func setEventHandler(_ handler: @escaping (LoginEvent) -> Void) {
+        self.onEvent = handler
+    }
+
+    func handle(_ action: LoginAction) {
+        switch action {
+        case .updateEmail(let email):
+            state.email = email
+        case .updatePassword(let password):
+            state.password = password
+        case .togglePasswordVisibility:
+            state.isPasswordVisible.toggle()
+        case .submit:
+            login()
+        }
+    }
+
+    private func login() {
+        state.isLoading = true
+        state.error = nil
+        Task {
+            do {
+                let _ = try await loginUseCase.execute(
+                    email: state.email,
+                    password: state.password
+                )
+                state.isLoading = false
+                onEvent?(.navigateToHome)
+            } catch {
+                state.isLoading = false
+                state.error = error.localizedDescription
+            }
+        }
+    }
+}
+```
+
+### 3.5: Wire UI ↔ Logic ⭐ (NOT "code new UI")
+
+> **This step does NOT create new UI.** The UI already exists from Phase 2.8.
+> Only CONNECT the existing UI shell to the real ViewModel.
+
+**Changes needed on the UI shell:**
+
+```swift
+// Phase 2 code stays as the STATELESS "Content" view (for Preview):
+struct LoginScreenContent: View {
+    var state: LoginViewState = .normal
+    var onAction: (LoginAction) -> Void = { _ in }
+
+    var body: some View {
+        // ... all UI code from Phase 2.8 — DO NOT MODIFY
+    }
+}
+
+// Previews still work:
+#Preview("Normal") { LoginScreenContent(state: .normal) }
+#Preview("Loading") { LoginScreenContent(state: .loading) }
+
+// ADD a NEW wrapper that wires ViewModel:
+struct LoginScreen: View {
+    @State private var viewModel: LoginViewModel
+    var onNavigateToHome: () -> Void
+
+    init(container: AppContainer, onNavigateToHome: @escaping () -> Void) {
+        _viewModel = State(initialValue: container.makeLoginViewModel())
+        self.onNavigateToHome = onNavigateToHome
+    }
+
+    var body: some View {
+        LoginScreenContent(
+            state: viewModel.state,
+            onAction: viewModel.handle
+        )
+        .onAppear {
+            viewModel.setEventHandler { event in
+                switch event {
+                case .navigateToHome:
+                    onNavigateToHome()
+                case .showError(let msg):
+                    // handle
+                    break
+                }
+            }
+        }
+    }
+}
+```
+
+**Wire Checklist:**
+- [ ] Wrapper view injects ViewModel from DI container
+- [ ] State bindings: ViewModel.state → Content view
+- [ ] Action bindings: Content onAction → ViewModel.handle()
+- [ ] Event handling: navigation, alerts
+- [ ] Previews still work (they use the stateless Content view)
+
+### 3.6: Integration Test ⭐
+
+Verify UI + logic end-to-end:
+
+```markdown
+### 🧪 Integration: [Feature]
+
+Functional:
+- [ ] API calls succeed, data displays on UI
+- [ ] Loading state shows/hides at right time
+- [ ] Error state displays correct message
+- [ ] Navigation works as expected
+- [ ] Form validation works
+
+Data:
+- [ ] Request format matches original app
+- [ ] Response parses correctly
+- [ ] Token/session stored properly
+- [ ] Crypto output matches original (if applicable)
+
+Edge Cases:
+- [ ] Empty input handling
+- [ ] Network error handling
+- [ ] Back navigation
+- [ ] App backgrounding/foregrounding
+```
+
+---
+
+## 🔒 CRYPTO UTILS (Special Handling)
+
+If the feature involves encryption/hashing:
+
+1. Read disassembly carefully — exact algorithm, padding, encoding
+2. Implement in Swift — preserve exact input/output
+3. Unit test IMMEDIATELY with known pairs
+
+```swift
+import CryptoKit
+import CommonCrypto
+
+enum CryptoUtils {
+    static func md5Hash(_ 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()
+    }
+}
+
+// MANDATORY test
+final class CryptoUtilsTests: XCTestCase {
+    func testMD5MatchesOriginal() {
+        XCTAssertEqual("expected_hash", CryptoUtils.md5Hash("known_input"))
+    }
+}
+```
+
+> ⚠️ Crypto functions MUST produce identical output. Any mismatch breaks server communication.
+
+---
+
+## ✅ Checkpoint
+
+```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/LoginRequestDTO.swift, LoginResponseDTO.swift
+- Data/Repositories/AuthRepositoryImpl.swift
+- DI/AppContainer.swift (updated)
+- Presentation/Screens/Auth/LoginViewModel.swift
+- Presentation/Screens/Auth/LoginScreen.swift ← wired (from Phase 2)
+
+### Tests:
+- [ ] Crypto utils verified (if applicable)
+- [ ] API contract matches original
+- [ ] UI + Logic e2e works
+
+### ⏭️ Next Feature: [Name]
+→ Return to Phase 2 (Blueprint + UI Design)
+```
+
+---
+
+## 🔄 Feature Loop
+
+```
+Phase 2 (Blueprint + UI for Feature X) → GATE → Phase 3 (Logic for X) → Checkpoint
+    ↓
+Phase 2 (Blueprint + UI for Feature Y) → GATE → Phase 3 (Logic for Y) → Checkpoint
+    ↓
+... (repeat for all features from Architecture Build Order)
+    ↓
+Phase 4: Final Parity Check & Quality Gate
+```
+
+---
+
+*Phase 3: Logic Build — Wire logic behind approved UI*

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