@leejungkiin/awkit 1.0.0

package/skills/awf-error-translator/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: awf-error-translator
+description: >-
+  Translate technical errors to human-friendly language. Keywords: error,
+  translate, explain, help, fix, fail, broken, crash, bug.
+  Activates on /debug, /code, /test when errors detected.
+version: 1.0.0
+---
+
+# AWF Error Translator
+
+Dịch lỗi kỹ thuật sang ngôn ngữ đời thường cho non-tech users.
+
+## Trigger Conditions
+
+**Post-hook for:** `/debug`, `/code`, `/test`
+
+**When:** Error message detected in output
+
+## Execution Logic
+
+### Step 1: Detect Error
+
+```
+if output contains error patterns:
+    → Activate translation
+else:
+    → Skip (no error)
+```
+
+### Step 2: Match & Translate
+
+Match error against database, return human message + action.
+
+### Step 3: Display
+
+```
+❌ Lỗi: [human message]
+💡 Gợi ý: [action]
+```
+
+## Error Translation Database
+
+### Database Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `ECONNREFUSED` | Database chưa chạy | Khởi động PostgreSQL/MySQL |
+| `ETIMEDOUT` | Database phản hồi chậm quá | Kiểm tra kết nối mạng |
+| `ER_ACCESS_DENIED` | Sai mật khẩu database | Kiểm tra file .env |
+| `relation .* does not exist` | Bảng chưa tồn tại | Chạy migration: `/run migrate` |
+| `duplicate key` | Dữ liệu bị trùng | Kiểm tra unique constraint |
+
+### JavaScript/TypeScript Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `TypeError: Cannot read` | Đang đọc biến chưa có giá trị | Kiểm tra null/undefined |
+| `ReferenceError` | Dùng biến chưa khai báo | Kiểm tra tên biến |
+| `SyntaxError` | Code viết sai cú pháp | Kiểm tra dấu ngoặc, chấm phẩy |
+| `Maximum call stack` | Vòng lặp vô hạn | Kiểm tra điều kiện dừng |
+| `Cannot find module` | Thiếu package | Chạy `npm install` |
+
+### Network Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `fetch failed` | Không kết nối được server | Kiểm tra URL và internet |
+| `CORS` | Website chặn request | Cấu hình CORS trên server |
+| `ERR_CERT` | Chứng chỉ SSL lỗi | Dùng HTTP thay HTTPS (dev only) |
+| `timeout` | Request quá lâu | Tăng timeout hoặc kiểm tra server |
+| `ENOTFOUND` | Domain không tồn tại | Kiểm tra lại URL |
+
+### Package Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `npm ERR!` | Cài package bị lỗi | Xóa node_modules, cài lại |
+| `peer dep` | Phiên bản không tương thích | Cập nhật package.json |
+| `EACCES` | Không có quyền truy cập | Chạy với sudo hoặc sửa quyền |
+| `ENOSPC` | Hết dung lượng ổ đĩa | Dọn dẹp disk |
+| `gyp ERR!` | Lỗi build native module | Cài build tools |
+
+### Test Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `Expected .* but received` | Test thất bại - kết quả sai | Sửa code hoặc update test |
+| `Timeout` | Test chạy quá lâu | Tăng timeout hoặc optimize |
+| `before each hook` | Setup test bị lỗi | Kiểm tra beforeEach |
+| `snapshot` | UI thay đổi | Update snapshot nếu đúng |
+| `coverage` | Thiếu test coverage | Viết thêm test |
+
+### Build Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `tsc.*error` | Lỗi TypeScript | Sửa type errors |
+| `ESLint` | Code không đúng style | Chạy lint fix |
+| `Build failed` | Build thất bại | Đọc log chi tiết |
+| `Out of memory` | Hết RAM | Tăng memory limit |
+| `FATAL ERROR` | Lỗi nghiêm trọng | Restart và thử lại |
+
+### Git Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `conflict` | Code bị xung đột | Merge conflict manually |
+| `rejected` | Push bị từ chối | Pull trước khi push |
+| `detached HEAD` | Không ở branch nào | Checkout về branch |
+| `not a git repo` | Chưa init git | Chạy `git init` |
+
+### Deploy Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `502 Bad Gateway` | Server không phản hồi | Restart server |
+| `503 Service` | Server quá tải | Scale up resources |
+| `permission denied` | Không có quyền deploy | Kiểm tra credentials |
+| `quota exceeded` | Hết quota | Nâng cấp plan |
+
+## Output Format
+
+```
+🔍 Translating error...
+
+❌ Lỗi: [human_message]
+   └─ Gốc: [original_error_snippet]
+
+💡 Gợi ý: [action]
+   └─ Hoặc chạy: /debug để tìm hiểu thêm
+
+────────────────────────────────
+```
+
+## Fallback
+
+If no pattern matches:
+```
+❌ Lỗi: Có vấn đề xảy ra
+💡 Gợi ý: Chạy /debug để em phân tích chi tiết
+```
+
+## Performance
+
+- Translation: < 100ms
+- Pattern matching: Simple regex
+- No external API calls
+
+## Security
+
+- Sanitize error messages (remove credentials, paths)
+- Never expose sensitive info in translations

package/skills/awf-session-restore/SKILL.md

@@ -0,0 +1,270 @@
+---
+name: awf-session-restore
+description: Auto-restore context from Beads + Brain + Project Brain on session start
+trigger: session_start
+priority: 2
+---
+
+# AWF Session Restore (v6.4 - Project-Aware)
+
+> **Purpose:** Tự động khôi phục context khi bắt đầu session.
+> **⛔ MANDATORY:** Luôn THỰC SỰ chạy `bd list` qua terminal — không chỉ đề cập.
+
+---
+
+## Trigger
+
+Skill này **BẮT BUỘC** chạy khi:
+- User mở session mới (đầu conversation)
+- User gõ `/recap`
+- AI detect context loss (conversation reset)
+
+---
+
+## Execution Flow
+
+### 0. Project Brain Lookup (CHẠY TRƯỚC BEADS)
+
+**Mục đích:** Load project structure vào context — AI không cần scan cấu trúc lần nào nữa trong session này.
+
+```bash
+# Check project identity
+cat .project-identity 2>/dev/null || echo "No .project-identity found"
+
+# Check codebase map
+cat CODEBASE.md 2>/dev/null || echo "No CODEBASE.md found"
+```
+
+**Output nếu tìm thấy:**
+```
+📚 [ProjectName] | [Stage] | [Architecture]
+🗺️  Codebase loaded: [N layers, M features indexed]
+```
+
+**Output nếu không có:**
+```
+📚 No project identity found — raw mode
+```
+
+---
+
+### 1. Multi-Source Context Check (vẠn MANDATORY)
+
+**Priority 1: Beads (Task State) — PHẢI CHẠY ĐẦU TIÊN**
+```bash
+bd list --status in_progress
+bd list --status open --limit 3
+```
+
+**Output:**
+- Tasks đang làm dở
+- Tasks blocked
+- Tasks ready to start
+
+**Priority 2: Brain (Knowledge & Plans)**
+```bash
+# Check active plans
+cat brain/active_plans.json
+
+# Check recent memories
+ls -lt brain/ | head -5
+```
+
+**Output:**
+- Plan đang active
+- Phase hiện tại
+- Recent decisions/knowledge
+
+**Priority 3: Git (Code State)**
+```bash
+git status
+git log -1
+```
+
+**Output:**
+- Files đang thay đổi
+- Commit gần nhất
+
+---
+
+### 2. Context Synthesis
+
+Kết hợp 4 nguồn để tạo summary:
+
+```markdown
+🧠 **SESSION RESTORED**
+
+📚 **Project Brain:**
+- Project: FitBite Witness | Stage 3 | Clean Architecture + MVVM
+- CODEBASE: Loaded (4 layers, 8 features indexed)
+
+📿 **Beads Context:**
+- In Progress: Task #123 "Implement Login API" (started 2h ago)
+- Ready: 3 tasks
+
+🧠 **Brain Context:**
+- Active Plan: Shopping Cart - Phase 02 (50%)
+- Last Save: 30 minutes ago
+
+📂 **Git Context:**
+- Changed Files: 3 files (src/api/auth/*.ts)
+- Last Commit: "feat: add user model" (1 hour ago)
+
+➡️ **SUGGESTED NEXT STEP:**
+Continue task #123? `/codeExpert` or `/code`
+```
+
+---
+
+### 3. Smart Suggestions
+
+Based on context, suggest appropriate action:
+
+**Case 1: Task In-Progress**
+```
+➡️ Tiếp tục task #123? 
+   `/codeExpert` (Fast) or `/code` (Guided)
+```
+
+**Case 2: Task Blocked**
+```
+⚠️ Task #125 bị block bởi #120
+
+➡️ Làm task #120 trước?
+   `/codeExpert` or switch to another task
+```
+
+**Case 3: No Active Task**
+```
+📋 Có 3 tasks ready to start
+
+➡️ Bắt đầu task mới?
+   `/next` để xem gợi ý
+```
+
+**Case 4: Fresh Start**
+```
+🆕 Chưa có context
+
+➡️ Bắt đầu dự án mới?
+   `/planExpert "Feature"` or `/brainstorm`
+```
+
+---
+
+### 4. Memory Persistence
+
+Update session state:
+
+```json
+// brain/session.json
+{
+  "last_session": "2026-01-30T10:00:00Z",
+  "working_on": {
+    "feature": "Shopping Cart",
+    "plan_path": "plans/260130-1025-shopping-cart/",
+    "current_phase": "phase-02",
+    "current_task": {
+      "id": 123,
+      "name": "Implement Login API",
+      "status": "in_progress"
+    }
+  },
+  "context_sources": {
+    "beads": true,
+    "brain": true,
+    "git": true
+  }
+}
+```
+
+---
+
+## Error Handling
+
+### Beads Unavailable
+```
+⚠️ Beads không khả dụng
+
+Fallback: Dùng Brain + Git context
+```
+
+### Brain Empty
+```
+⚠️ Brain chưa có context
+
+Gợi ý: `/plan` để tạo context mới
+```
+
+### All Sources Fail
+```
+❌ Không thể khôi phục context
+
+➡️ Bắt đầu lại:
+1. `/recap` để quét dự án
+2. `/plan` để tạo plan mới
+3. Kể cho em biết đang làm gì
+```
+
+---
+
+## Integration with Workflows
+
+### Auto-Trigger in Workflows
+
+Các workflows tự động gọi session restore:
+
+```markdown
+# In /code workflow
+1. Check session.json
+2. If no context → Trigger awf-session-restore
+3. Resume from restored context
+```
+
+### Manual Trigger
+
+User có thể gọi thủ công:
+
+```bash
+/recap    # Alias for session restore
+```
+
+---
+
+## Performance
+
+- **Execution Time:** < 1 second
+- **Sources Checked:** 3 (Beads, Brain, Git)
+- **Output:** Concise summary (< 10 lines)
+
+---
+
+## Example Output
+
+```
+🧠 **WELCOME BACK!**
+
+📿 **Beads:** Task #123 "Login API" (in_progress, 2h ago)
+🧠 **Brain:** Plan "Shopping Cart" - Phase 02 (50%)
+📂 **Git:** 3 files changed
+
+➡️ **NEXT:** Continue coding? `/codeExpert`
+
+💡 **TIP:** Gõ `/next` để xem chi tiết hơn
+```
+
+---
+
+## Configuration
+
+User có thể customize trong `brain/preferences.json`:
+
+```json
+{
+  "session_restore": {
+    "auto_trigger": true,
+    "verbosity": "concise",  // concise | detailed
+    "sources": ["beads", "brain", "git"]
+  }
+}
+```

package/skills/awf-version-tracker/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: awf-version-tracker
+description: Auto-snapshot skills and workflows to ensure rollback capabilities and tracking version drift
+trigger: session_start
+priority: 3
+---
+
+# AWF Version Tracker (Skill Evolver Integration)
+
+> **Purpose:** Tự động tạo snapshot các file kỹ năng (Skills) và quy trình (Workflows) mỗi khi session mới bắt đầu.
+> **Philosophy:** Regression-Averse. Giữ lại một bộ lùi version tự động để an toàn sau những lần `/customize`.
+
+---
+
+## Trigger conditions
+- **Mỗi khi User bắt đầu thao tác ở 1 session mới**
+- Chạy tự động, ngay sau bộ `orchestrator` và `awf-session-restore`.
+
+## Hành động (Execution)
+
+1. **Log thông báo**: "📸 Saving system snapshot..."
+2. **Chạy script `snapshot.sh`**:
+   - `sh ~/.gemini/antigravity/skills/awf-version-tracker/scripts/snapshot.sh`
+   - Kịch bản sẽ sao chép `global_workflows` và `skills` và nén vào thư mục `~/.gemini/antigravity/brain/versions/` với tên file gắn Timestamp.
+   - Kịch bản chỉ giữ lại tối đa 10 snapshots gần nhất.
+3. **Tiếp nối quy trình**: Không chặn hay hỏi thêm người dùng trừ khi có lỗi permission xảy ra.
+
+## Phục hồi (Rollback)
+
+Nếu User yêu cầu lùi phiên bản `/skill-rollback`:
+- Nhắc User xem danh sách snapshot ở `~/.gemini/antigravity/brain/versions/`
+- Command để giải nén lại snapshot: `unzip -o snapshot_name.zip -d /`

package/skills/awf-version-tracker/scripts/snapshot.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# Snapshot skills and workflows
+TARGET_DIR="$HOME/.gemini/antigravity"
+BACKUP_DIR="$TARGET_DIR/brain/versions"
+
+mkdir -p "$BACKUP_DIR"
+
+TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
+
+echo "📸 Tạo bản snapshot hệ thống AWK..."
+
+# Tạo zip file chứa global_workflows và skills
+if [ -d "$TARGET_DIR/global_workflows" ] && [ -d "$TARGET_DIR/skills" ]; then
+    zip -q -r "$BACKUP_DIR/awk_snapshot_$TIMESTAMP.zip" "$TARGET_DIR/global_workflows" "$TARGET_DIR/skills" -x "*.DS_Store"
+    
+    # Giữ lại tối đa 10 bản snapshot gần nhất để tránh tốn dung lượng
+    ls -tp "$BACKUP_DIR"/awk_snapshot_*.zip | grep -v '/$' | tail -n +11 | xargs -I {} rm -- {} 2>/dev/null
+
+    echo "✅ Đã lưu snapshot: awk_snapshot_$TIMESTAMP.zip (Chỉ giữ lại 10 bản gần nhất)"
+else
+    echo "⚠️ Không tìm thấy thư mục global_workflows hoặc skills để snapshot."
+fi