@leejungkiin/awkit 1.0.7 → 1.0.9

package/skills/ambient-brain/brain-templates.md

@@ -1,201 +0,0 @@
-# Brain Entry Templates
-
-> Các template chuẩn để lưu vào brain/ — dùng cho cả auto-save và manual /save-brain.
-
----
-
-## Template 1: Decision (brain/decisions/)
-
-**Filename:** `brain/decisions/YYYY-MM-DD-[slug].md`
-
-```markdown
----
-date: 2026-02-22
-type: decision
-topic: [brief topic, e.g., "Database choice for neural-brain"]
-feature: [which feature/project this belongs to]
-tags: [tech, architecture, database, ...]
-salience: 0.90
----
-
-# Decision: [Topic]
-
-## What was decided
-[Clear statement of the decision]
-
-## Why this approach
-[Rationale — key reasons]
-
-## Alternatives considered
-- **[Option A]**: [Why rejected]
-- **[Option B]**: [Why rejected]
-
-## Trade-offs
-- ✅ [Pro 1]
-- ✅ [Pro 2]
-- ⚠️ [Con/caveat]
-
-## Context
-[Additional context: task ID, feature, constraints]
-```
-
----
-
-## Template 2: Solution (brain/solutions/)
-
-**Filename:** `brain/solutions/YYYY-MM-DD-[slug].md`
-
-```markdown
----
-date: 2026-02-22
-type: solution
-error_pattern: [e.g., "TypeError: Cannot read property of undefined"]
-files_affected: [e.g., "activation.js, store.js"]
-tags: [javascript, sqlite, null-check, ...]
-salience: 0.85
----
-
-# Solution: [Error Pattern]
-
-## The Error
-```
-[Paste exact error or describe the bug]
-```
-
-## Root Cause
-[Why this happened — 1-2 sentences]
-
-## The Fix
-[Step-by-step or code snippet showing the solution]
-
-```js
-// Before (broken)
-code here
-
-// After (fixed)
-code here
-```
-
-## How to Prevent
-[Rule or pattern to avoid this in future]
-
-## Context
-[What feature/task was being worked on when this occurred]
-```
-
----
-
-## Template 3: Architecture (brain/decisions/)
-
-**Filename:** `brain/decisions/arch-[feature]-[date].md`
-
-```markdown
----
-date: 2026-02-22
-type: architecture
-feature: [feature name, e.g., "neural-brain"]
-tags: [architecture, design, ...]
-salience: 0.95
----
-
-# Architecture: [Feature Name]
-
-## Overview
-[Brief description of what was designed]
-
-## Structure
-```
-[directory tree or component diagram]
-```
-
-## Key Decisions
-1. [Decision 1 + rationale]
-2. [Decision 2 + rationale]
-3. [Decision 3 + rationale]
-
-## Tech Choices
-| Component | Choice | Reason |
-|-----------|--------|--------|
-| [Layer]   | [Tech] | [Why]  |
-
-## Data Flow
-[How data flows through the system]
-
-## Open Questions
-- [ ] [Question to resolve later]
-```
-
----
-
-## Template 4: Session (brain/session.json)
-
-**Auto-updated by ambient-brain skill.**
-
-```json
-{
-  "last_updated": "2026-02-22T16:56:00+07:00",
-  "working_on": {
-    "project": "main-awf",
-    "feature": "neural-brain + ambient-brain skill",
-    "phase": "implementation",
-    "current_task_id": null,
-    "current_files": ["skills/ambient-brain/SKILL.md"]
-  },
-  "recent_decisions": [
-    {
-      "ref": "decisions/2026-02-22-use-better-sqlite3.md",
-      "summary": "Use better-sqlite3 for neural brain storage"
-    }
-  ],
-  "recent_solutions": [],
-  "active_context": {
-    "neural_brain_port": "Planning phase - studying Python source",
-    "ambient_brain": "Implementing skill files"
-  },
-  "completed_milestones": [],
-  "context_checkpoints": []
-}
-```
-
----
-
-## Template 5: Active Plans (brain/active_plans.json)
-
-```json
-{
-  "plans": [
-    {
-      "id": "neural-brain-nodejs-port",
-      "title": "Port neural-memory to Node.js for main-awf",
-      "status": "planning",
-      "phases": [
-        { "id": "p1", "name": "Study Python source", "status": "done" },
-        { "id": "p2", "name": "Build SQLite schema", "status": "next" },
-        { "id": "p3", "name": "Core data structures", "status": "pending" },
-        { "id": "p4", "name": "Spreading activation engine", "status": "pending" },
-        { "id": "p5", "name": "Public API integration", "status": "pending" }
-      ],
-      "created": "2026-02-22",
-      "last_updated": "2026-02-22"
-    },
-    {
-      "id": "ambient-brain-skill",
-      "title": "Ambient Brain Sync skill for AWF",
-      "status": "implementing",
-      "phases": [
-        { "id": "p1", "name": "Design & brainstorm", "status": "done" },
-        { "id": "p2", "name": "Create skill files", "status": "in_progress" },
-        { "id": "p3", "name": "Update GEMINI.md", "status": "next" },
-        { "id": "p4", "name": "Deploy to antigravity", "status": "pending" },
-        { "id": "p5", "name": "Test with real workflow", "status": "pending" }
-      ],
-      "created": "2026-02-22",
-      "last_updated": "2026-02-22"
-    }
-  ]
-}
-```
-
----
-
-*brain-templates v1.0.0 — Standard formats for consistent brain storage*

package/skills/context-help/SKILL.md

@@ -1,180 +0,0 @@
----
-name: awf-context-help
-description: >-
-  Context-aware help based on current workflow state. Keywords: help, what,
-  how, confused, stuck, lost, guide, tutorial, explain.
-  Activates on /help or when user asks questions.
-version: 1.0.0
----
-
-# AWF Context Help
-
-Trợ giúp thông minh dựa trên context hiện tại.
-
-## Trigger Conditions
-
-**Activates when:**
-- User runs `/help`
-- User types "?", "giúp", "help", "làm sao"
-- User seems confused (repeated errors, long pause)
-
-## Execution Logic
-
-### Step 1: Read Context
-
-```
-context = {}
-
-if exists(".brain/session.json"):
-    context.workflow = session.working_on.feature
-    context.task = session.working_on.task
-    context.status = session.working_on.status
-    context.pending = session.pending_tasks
-
-if exists(".brain/brain.json"):
-    context.project = brain.project.name
-    context.tech = brain.tech_stack
-```
-
-### Step 2: Detect State
-
-| State | Detection | Response |
-|-------|-----------|----------|
-| `no_project` | No .brain/ folder | Show onboarding |
-| `planning` | workflow contains "plan" | Planning help |
-| `coding` | workflow contains "code" | Coding help |
-| `debugging` | workflow contains "debug" | Debug help |
-| `deploying` | workflow contains "deploy" | Deploy help |
-| `stuck` | status = "blocked" or pending > 5 | Stuck help |
-| `idle` | No active workflow | General help |
-
-### Step 3: Show Contextual Help
-
-## Help Templates
-
-### No Project State
-```
-🆕 Chưa có dự án
-
-Bạn có thể:
-1. /brainstorm - Bàn ý tưởng trước
-2. /init - Tạo dự án mới
-3. Mô tả ý tưởng cho em nghe
-
-Em sẽ hướng dẫn từng bước!
-```
-
-### Planning State
-```
-📋 Đang lập kế hoạch: {context.workflow}
-
-Bạn có thể:
-1. Tiếp tục plan hiện tại
-2. /code - Bắt đầu code phase đầu tiên
-3. Hỏi em về cách thiết kế
-
-💡 Mẹo: Plan tốt = Code nhanh hơn!
-```
-
-### Coding State
-```
-💻 Đang code: {context.task}
-   Status: {context.status}
-
-Bạn có thể:
-1. Tiếp tục code
-2. /test - Kiểm tra code vừa viết
-3. /debug - Nếu gặp lỗi
-4. /save-brain - Lưu tiến độ
-
-💡 Pending tasks: {context.pending.length}
-```
-
-### Debugging State
-```
-🔧 Đang debug: {context.task}
-
-Bạn có thể:
-1. Mô tả lỗi chi tiết hơn
-2. Paste error message
-3. /code - Quay lại code sau khi fix
-
-💡 Mẹo: Copy paste lỗi giúp em hiểu nhanh hơn!
-```
-
-### Deploying State
-```
-🚀 Đang deploy: {context.workflow}
-
-Bạn có thể:
-1. Tiếp tục deploy process
-2. /rollback - Quay về bản trước nếu lỗi
-3. Kiểm tra logs sau deploy
-
-⚠️ Nhớ test kỹ trước khi deploy production!
-```
-
-### Stuck State
-```
-😅 Có vẻ bạn đang bị kẹt
-
-Thử những cách này:
-1. /recap - Xem lại đang làm gì
-2. /debug - Nếu có lỗi
-3. Nghỉ 5 phút rồi quay lại
-4. Hỏi em cụ thể vấn đề
-
-💡 {context.pending.length} tasks đang chờ.
-   Có thể tạm skip task khó, làm cái khác trước?
-```
-
-### Idle/General State
-```
-👋 Em có thể giúp gì?
-
-Lệnh phổ biến:
-┌─────────────────────────────────────┐
-│ /next       │ Gợi ý việc tiếp theo  │
-│ /recap      │ Nhớ lại context       │
-│ /brainstorm │ Bàn ý tưởng mới       │
-│ /plan       │ Lập kế hoạch          │
-│ /code       │ Viết code             │
-└─────────────────────────────────────┘
-
-Hoặc hỏi em bất cứ điều gì!
-```
-
-## Adaptive Language
-
-Help responses adapt to `technical_level`:
-
-**newbie:**
-- Dùng tiếng Việt thuần
-- Giải thích mọi khái niệm
-- Bước nhỏ, chi tiết
-
-**basic:**
-- Mix Việt-Anh
-- Giải thích term lần đầu
-- Bước vừa phải
-
-**technical:**
-- Dùng thuật ngữ chuẩn
-- Không cần giải thích
-- Tập trung action
-
-## Fallback
-
-If context unreadable:
-```
-👋 Em ở đây giúp bạn!
-
-Gõ /next để em gợi ý việc cần làm,
-hoặc mô tả vấn đề cho em nghe.
-```
-
-## Performance
-
-- Context read: < 200ms
-- Response generation: Instant
-- No external API calls

package/skills/error-translator/SKILL.md

@@ -1,153 +0,0 @@
----
-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