@leejungkiin/awkit 1.4.0 → 1.4.2

package/templates/project-identity/backend-nestjs.json

@@ -1,10 +1,5 @@
 {
-  "_comments": {
-    "projectId": "Auto-generated from folder name. DO NOT change — used by Symphony for task scoping.",
-    "trello": "Fill in your Trello board/list/card names. Run 'awkit trello info' to verify."
-  },
   "projectName": "MyBackendAPI",
-  "projectId": "mybackendapi",
   "projectType": "backend",
   "primaryLanguage": "en",
   "techStack": {
@@ -17,11 +12,6 @@
     "testing": "Jest",
     "deployment": "Docker + Cloud Run"
   },
-  "trello": {
-    "board": "Your Board Name",
-    "list": "Your List Name",
-    "card": "Your Card Name"
-  },
   "projectStage": "planning",
   "codingStandards": {
     "language": "en",

package/templates/project-identity/expo.json

@@ -1,10 +1,5 @@
 {
-  "_comments": {
-    "projectId": "Auto-generated from folder name. DO NOT change — used by Symphony for task scoping.",
-    "trello": "Fill in your Trello board/list/card names. Run 'awkit trello info' to verify."
-  },
   "projectName": "MyExpoApp",
-  "projectId": "myexpoapp",
   "projectType": "expo",
   "bundleIdentifier": "com.company.myexpoapp",
   "primaryLanguage": "en",
@@ -20,11 +15,6 @@
     "testing": "Jest + Detox",
     "build": "EAS Build"
   },
-  "trello": {
-    "board": "Your Board Name",
-    "list": "Your List Name",
-    "card": "Your Card Name"
-  },
   "projectStage": "planning",
   "codingStandards": {
     "language": "en",

package/templates/project-identity/ios.json

@@ -1,10 +1,5 @@
 {
-  "_comments": {
-    "projectId": "Auto-generated from folder name. DO NOT change — used by Symphony for task scoping.",
-    "trello": "Fill in your Trello board/list/card names. Run 'awkit trello info' to verify."
-  },
   "projectName": "MyiOSApp",
-  "projectId": "myiosapp",
   "projectType": "ios",
   "bundleIdentifier": "com.company.myiosapp",
   "primaryLanguage": "en",
@@ -20,11 +15,6 @@
     "testing": "XCTest",
     "packageManager": "SPM"
   },
-  "trello": {
-    "board": "Your Board Name",
-    "list": "Your List Name",
-    "card": "Your Card Name"
-  },
   "projectStage": "planning",
   "codingStandards": {
     "language": "en",

package/templates/project-identity/web-nextjs.json

@@ -1,10 +1,5 @@
 {
-  "_comments": {
-    "projectId": "Auto-generated from folder name. DO NOT change — used by Symphony for task scoping.",
-    "trello": "Fill in your Trello board/list/card names. Run 'awkit trello info' to verify."
-  },
   "projectName": "MyWebApp",
-  "projectId": "mywebapp",
   "projectType": "react_web",
   "primaryLanguage": "en",
   "techStack": {
@@ -17,11 +12,6 @@
     "auth": "NextAuth.js",
     "deployment": "Vercel"
   },
-  "trello": {
-    "board": "Your Board Name",
-    "list": "Your List Name",
-    "card": "Your Card Name"
-  },
   "projectStage": "planning",
   "codingStandards": {
     "language": "en",

package/workflows/_uncategorized/ship-to-code.md

@@ -0,0 +1,85 @@
+---
+description: 🚢 Chuyển đổi mã nguồn từ ngôn ngữ bất kỳ sang ngôn ngữ bất kỳ với cấu trúc hiện đại.
+skill: ship-to-code
+---
+
+# /ship-to-code — Universal Code Porting Workflow
+
+> **Skill:** `ship-to-code` v1.0 | **Tech:** Agnostic (Any-to-Any)
+> **Philosophy:** "Map Dependencies → Bootstrap Architecture → Translate Idiomatically → Parity Check"
+
+---
+
+## ⚡ QUICK START
+
+User cung cấp: Source code hoặc thư mục chứa codebase cũ, và cho biết NGÔN NGỮ NGUỒN + NGÔN NGỮ ĐÍCH.  
+Ví dụ:  
+- "Dịch folder này từ Java sang Go"
+- "/ship-to-code từ Python Django sang Node.js NestJS"
+- "Dùng codebase Ruby làm tham chiếu để viết lại bằng Rust"
+
+Workflow dẫn dắt qua pipeline **6 Phases** để đảm bảo quá trình chuyển đổi an toàn, kiến trúc chuẩn xác, và không bị thất thoát business logic.
+
+---
+
+## 🔵 Session Setup
+
+### Bước 0.1: Khởi tạo session state
+
+```yaml
+porting_session:
+  source_lang: "[Nguồn]"
+  target_lang: "[Đích]"
+  source_dir: "[path_to_source]"
+  current_phase: 0
+  dependency_matrix: pending
+  completed_modules: []
+```
+
+### Bước 0.2: Xác nhận input
+
+```
+🚢 Universal Code Porting v1.0
+
+Xin chào! Để đảm bảo tính chính xác cho quá trình migrate (vừa không rớt logic, vừa chuẩn idiomatic code), cho phép em hỏi để map cấu trúc:
+1. Thư mục chứa code nguồn cũ nằm ở đâu trên máy anh?
+2. Ngôn ngữ / Framework gốc là gì?
+3. Trọng tâm của framework / kiến trúc đích anh đang hướng đến là gì? (Ví dụ: Go standard layout vs NestJS Clean Architecture)
+```
+
+---
+
+## 📋 Pipeline Overview (6 Phases)
+
+| Phase | Name | Focus | Output |
+|-------|------|-------|--------|
+| 0 | 🔍 Ecosystem Mapping | Quét configuration dependencies của code cũ, đề xuất specs/thư viện thay thế. | Dependency Matrix |
+| 1 | 🏗️ Architecture Design | Phân tích app entry points, lifecycle. Thiết kế cấu trúc thư mục mới phù hợp môi trường đích. | Project Scaffold |
+| 2 | 💾 Data & Domain | Port Database schemas/Migrations, Models/DTOs, API Clients, Core Repositories. | Stable Data Layer |
+| 3 | 🧮 Logic & Utils | Dịch thuật toán, mã hóa crypto, helper functions. **PHẢI có Unit Tests**. | Logic + Test Parity |
+| 4 | 🎨 Presentation/Controllers | Dịch Controllers/Routes (Backend) hoặc UI Components (Frontend/Mobile). | Final UX / Routes |
+| 5 | ✅ Final Parity | Kiểm tra Branch coverage của edge-cases. Rà soát Data/Params Parity. | Ready to Deploy |
+
+---
+
+## 🔬 EXECUTION RULES
+
+```yaml
+never_skip:
+  - Phase 0 (Mapping) — Bắt buộc phải ánh xạ thư viện Nguồn → Đích rõ ràng trước khi code.
+  - Viết Unit Tests ở Phase 3 cho các utility xử lý chuỗi/mã hóa/thời gian.
+
+never_do:
+  - Dịch "word-by-word" (Line-by-line syntax translation). 
+    Ví dụ: Không bê nguyên class tĩnh Java sang Go, không xài `try-catch` ép buộc trong Rust, v.v.
+  - Tự ý bỏ qua các nhánh (if-else, try-catch) bắt lỗi ngầm trong codebase gốc.
+
+always_do:
+  - Report / Xin phép chỉ đạo sau mỗi Phase trước khi qua Phase mới.
+  - Viết code **Idiomatic** — áp dụng convention, design patterns và best practices riêng biệt và tự nhiên nhất của NGÔN NGỮ ĐÍCH.
+  - Đảm bảo I/O Parity (mọi Response Data, Crypto Hash) trả về phải GIỐNG Y HỆT API/Logic nguồn.
+```
+
+---
+
+*ship-to-code workflow v1.0.0 — Any-to-Any Porting Pipeline*

package/workflows/context/codebase-sync.md

@@ -23,102 +23,25 @@ MANUAL trigger:
 
 ---
 
-## Phase 1: Assess Current State
+## Execution Phase: Delegate to Gemini CLI
 
-```bash
-# 1. Đọc CODEBASE.md hiện tại
-cat CODEBASE.md
-
-# 2. Check git: files changed/added gần đây (14 ngày)
-git log --since="14 days ago" --name-only --pretty=format: | sort -u | grep -v '^$'
-
-# 3. Lấy session file edits từ memory-sync W6
-cat brain/session.json | grep files_touched_this_session
-
-# 4. Check new files không có trong CODEBASE.md
-# AI tự compare danh sách git + session với entries trong CODEBASE.md
-```
-
-**Output:**
-```
-📊 CODEBASE Sync Assessment:
-  - Files in CODEBASE.md: [N files documented]
-  - New/changed files (14d): [M files]
-  - Missing from CODEBASE.md: [K files listed]
-  - Last updated: [date from CODEBASE.md]
-```
-
----
-
-## Phase 2: Generate Delta
-
-Với mỗi file thiếu trong CODEBASE.md, AI tự suy luận:
-
-```yaml
-for each missing_file:
-  1. Xác định layer:
-     - App/ → App Layer
-     - Core/Domain/ → Domain Layer
-     - Core/Data/ → Data Layer
-     - Core/Services/ → Services Layer
-     - Features/[X]/ → Features Layer
-     - Presentation/Views/ → Views
-     - Presentation/ViewModels/ → ViewModels
-
-  2. Xác định responsibility từ:
-     - Filename (AuthenticationViewModel → Auth UI logic)
-     - Directory (Core/Domain/UseCases → Business logic)
-     - Content (nếu cần, đọc file — chỉ khi không đủ context)
-
-  3. Generate entry:
-     - File: path/to/File.swift
-     - Layer: [layer name]
-     - Purpose: [1-line description]
-     - Key exports: [main class/struct/func]
-
-  4. Xác định section trong CODEBASE.md phù hợp để append
-```
-
----
-
-## Phase 3: Update CODEBASE.md
+Thực thi workflow bằng cách gọi Gemini CLI để tận dụng LLM phân tích chuyên sâu mà không làm ảnh hưởng context của Antigravity. Gemini CLI sẽ tự check file, tính toán delta và cập nhật `CODEBASE.md`.
 
 > [!IMPORTANT]
-> CODEBASE.md dùng **compact format** — AI đọc nhanh, tốn ít context.
+> CODEBASE.md dùng **compact format** dạng bảng.
 > KHÔNG dùng format verbose (multi-line per file).
 
-```yaml
-MO:
-  - APPEND vào đúng section, không xóa gì cũ
-  - Update "Last Updated" timestamp
-  - Nếu thêm feature mới → thêm section mới
-
-Compact Format (BẮT BUỘC):
-  Mỗi file = 1 dòng trong table:
-  | `path/to/File.swift` | Purpose mô tả ngắn (1 câu) |
-
-  Ví dụ:
-  | `Core/Services/PushNotificationService.swift` | FCM push notification registration & handling |
-  | `Features/WeeklyGoal/ViewModels/WeeklyGoalVM.swift` | Weekly goal progress tracking logic |
-
-  ❌ KHÔNG dùng format cũ:
-    #### FileName.swift
-    **Layer:** ...
-    **Purpose:** ...
-    **Key class:** ...
-
-Footer update:
-  **Last Updated**: [current date]
-  **Sync:** Auto-updated via /codebase-sync
+```bash
+gemini -p "Đọc CODEBASE.md, git log (14 ngày gần nhất), và brain/session.json. So sánh để tìm các file mới/bị sửa nhưng chưa có trong CODEBASE.md. Suy luận Layer và Purpose cho mỗi file. Sinh ra Delta dưới dạng bảng (compact format) và APPEND vào CODEBASE.md. Cập nhật ngày Last Updated." --approval-mode auto
 ```
 
-**Preview trước khi apply:**
+**Output mong đợi từ Gemini CLI:**
 ```
-📝 Sẽ thêm [K] entries vào CODEBASE.md:
-  + Core/Services/PushNotificationService.swift → FCM push notification
-  + Features/WeeklyGoal/ViewModels/WeeklyGoalVM.swift → Weekly goal logic
+✅ CODEBASE.md Synced!
 
-Apply? [auto-yes nếu < 10 entries / confirm nếu lớn hơn]
+  📊 Added: [K] new entries
+  📁 Sections updated: [list]
+  🕐 Last Updated: [current date]
 ```
 
 ---