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

code

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

code

❌ 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

code

🔍 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:

code

❌ 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