@nockdev/awf 6.2.3 → 6.2.5

package/.agent/private/README.md

@@ -1,74 +0,0 @@
-# 🔒 Private Skills
-
-> Skills riêng cho dự án / công ty — **KHÔNG** commit vào repo public.
-
----
-
-## Tạo Private Skill Mới
-
-### Bước 1: Copy template
-
-```bash
-# PowerShell
-Copy-Item -Recurse .agent/private/_template .agent/private/my-skill-name
-```
-
-### Bước 2: Edit files
-
-| File          | Sửa gì                                    |
-| ------------- | ----------------------------------------- |
-| `META.yaml`   | Đổi `name`, `display`, `desc`, `triggers` |
-| `SKILL.md`    | Viết patterns, checklists, examples       |
-| `data/*.yaml` | Thêm data files nếu cần                   |
-
-### Bước 3: Register
-
-Thêm vào `_index.yaml`:
-
-```yaml
-skills:
-  - { id: my-skill-name, has_advanced: false }
-```
-
-### Bước 4: Done!
-
-Router sẽ tự phát hiện skill mới. Test bằng cách dùng keyword đã định nghĩa.
-
----
-
-## Override Public Skills
-
-Private skill có `priority: -1` (cao nhất). Nếu tạo private skill **cùng ID** với public skill, private sẽ được ưu tiên.
-
-Ví dụ: Tạo `private/testing/META.yaml` → override `skills/cross-cutting/testing/META.yaml`
-
----
-
-## Cấu trúc
-
-```
-private/
-├── _index.yaml         ← Registry (bắt buộc)
-├── _template/           ← Template (copy để tạo mới)
-│   ├── META.yaml
-│   ├── SKILL.md
-│   └── data/
-├── autodomyh-api/       ← Skill mẫu
-│   ├── META.yaml
-│   ├── SKILL.md
-│   └── data/
-│       └── conventions.yaml
-└── README.md            ← File này
-```
-
----
-
-## Lưu ý
-
-- ⚠️ Directory này đã được `.gitignore` — KHÔNG bị commit
-- 📋 Nếu cần sync giữa các máy, copy thủ công hoặc dùng private git repo
-- 🔑 KHÔNG lưu credentials/secrets trong skill files
-
----
-
-_DOMYH Awesome Code • Private Skills_

package/.agent/private/_index.yaml

@@ -1,23 +0,0 @@
-# =============================================================================
-# Private Skills Registry
-# =============================================================================
-# Skills listed here are gitignored and NOT shared publicly.
-# They follow the same 3-tier structure: META.yaml → SKILL.md → ADVANCED.md
-#
-# HOW TO ADD:
-#   1. Copy _template/ → your-skill-name/
-#   2. Edit META.yaml and SKILL.md
-#   3. Add entry to this file under 'skills:'
-#   4. Done! The router will auto-discover it.
-# =============================================================================
-
-category: private
-description: "Private/company-specific skills (gitignored)"
-priority: -1 # Highest priority — overrides public skills with same ID
-
-count: 1
-skills:
-  - { id: autodomyh-api, has_advanced: false }
-  # Add your private skills below:
-  # - { id: my-company-api, has_advanced: false }
-  # - { id: internal-patterns, has_advanced: true }

package/.agent/private/_template/META.yaml

@@ -1,38 +0,0 @@
-# =============================================================================
-# META.yaml — Private Skill Template
-# =============================================================================
-# Copy this directory and rename to create a new private skill.
-# Replace all {PLACEHOLDERS} with actual values.
-# =============================================================================
-
-name: "{skill-id}" # lowercase, hyphen-separated
-version: "1.0.0"
-display: "{Skill Display Name}"
-category: private # Always 'private' for private skills
-tier: 1
-priority: -1 # -1 = highest (overrides public skills)
-
-desc: "{Short description of what this skill provides — max 80 chars}"
-
-triggers:
-  file_patterns:
-    # - "*.ext"                 # File patterns that activate this skill
-    # - "specific-config.yaml"
-  keywords:
-    # - "keyword1"             # Keywords that trigger skill loading
-    # - "keyword2"
-
-caps:
-  # - "Capability 1"           # What this skill can do
-  # - "Capability 2"
-
-# Data files (if any)
-data_files: []
-  # - data/patterns.yaml
-  # - data/conventions.yaml
-
-related_skills: []
-  # - testing
-  # - security
-
-# _DOMYH Awesome Code • Private Skill Template_

package/.agent/private/_template/SKILL.md

@@ -1,43 +0,0 @@
----
-name: "{skill-id}"
-detect: []
-version: "1.0.0"
----
-
-# {Skill Display Name}
-
-> {One-line description of what this skill provides}
-
-## 📦 Data Files
-
-| File | Content | Records |
-| ---- | ------- | ------- |
-| —    | —       | —       |
-
-## 🎯 Core Problem
-
-```
-❌ Without this skill: {What goes wrong}
-✅ With this skill: {What the agent does differently}
-```
-
-## 📋 Quick Reference
-
-| Topic | Pattern |
-| ----- | ------- |
-| —     | —       |
-
-## ⚠️ Anti-Patterns
-
-| ❌ Don't | ✅ Do |
-| -------- | ----- |
-| —        | —     |
-
-## 📋 Checklist
-
-- [ ] Item 1
-- [ ] Item 2
-
----
-
-_DOMYH Awesome Code — Private Skill Template_

package/.agent/private/autodomyh-api/META.yaml

@@ -1,48 +0,0 @@
-# =============================================================================
-# META.yaml — AutoDomyh API Conventions (Private)
-# =============================================================================
-
-name: autodomyh-api
-version: "1.0.0"
-display: AutoDomyh API Conventions
-category: private
-tier: 1
-priority: -1
-
-desc: "Internal API conventions, domain patterns, and project-specific coding standards for AutoDomyh backend (Go) and frontend (Nuxt)."
-
-triggers:
-  file_patterns:
-    - "cmd/server/*.go"
-    - "internal/**/*.go"
-    - "app/**/*.vue"
-    - "pages/**/*.vue"
-    - "composables/**/*.ts"
-  keywords:
-    - autodomyh
-    - auto_domyh
-    - domyh api
-    - domyh conventions
-    - internal api
-    - nockdev
-    - backend convention
-    - frontend convention
-
-caps:
-  - Go backend modular monolith patterns (atomic delegation, router mounting)
-  - Nuxt frontend component conventions (UModal, UDropdownMenu, composables)
-  - Domain-specific naming conventions (packages, licenses, points, game servers)
-  - API error handling patterns (unified error response)
-  - Database patterns (GORM repository, cache-aside)
-
-data_files:
-  - data/conventions.yaml
-
-related_skills:
-  - go
-  - nuxt
-  - typescript
-  - database
-  - security
-
-# _DOMYH Awesome Code • AutoDomyh API Private Skill_

package/.agent/private/autodomyh-api/SKILL.md

@@ -1,141 +0,0 @@
----
-name: autodomyh-api
-detect: ["cmd/server/*.go", "internal/**/*.go"]
-version: "1.0.0"
----
-
-# AutoDomyh API Conventions
-
-> Internal project conventions — NOT for public sharing. Check `data/conventions.yaml` for lookup tables.
-
-## 📦 Data Files
-
-| File               | Content                            | Records |
-| ------------------ | ---------------------------------- | ------- |
-| `conventions.yaml` | Naming, structure, domain patterns | 25+     |
-
-## 🏗️ Architecture Overview
-
-```
-Backend (Go):
-  Architecture: Modular Monolith + Atomic Delegation
-  ORM: GORM with Repository pattern
-  Cache: Redis Cache-Aside (PERF-001)
-  Auth: JWT + RBAC
-  Router: Chi → modular mount per domain
-
-Frontend (Nuxt 4):
-  UI: Nuxt UI v4 (UModal, UDropdownMenu, UButton, etc.)
-  State: Pinia + composables
-  Auth: useSanctumAuth() composable
-  API: useFetch() / $fetch() with baseURL
-```
-
-## 📋 Backend Conventions
-
-### Handler Pattern (Atomic Delegation)
-
-```go
-// ✅ Correct: Handler → Service → Repository
-func (h *Handler) CreatePackage(w http.ResponseWriter, r *http.Request) {
-    var req CreatePackageRequest
-    if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-        respondError(w, http.StatusBadRequest, "invalid request")
-        return
-    }
-    pkg, err := h.service.Create(r.Context(), req)
-    if err != nil {
-        respondError(w, http.StatusInternalServerError, err.Error())
-        return
-    }
-    respondJSON(w, http.StatusCreated, pkg)
-}
-```
-
-### Router Mounting
-
-```go
-// ✅ Each domain mounts at /api/v1/{domain}
-func (m *Module) Mount(r chi.Router) {
-    r.Route("/api/v1/packages", func(r chi.Router) {
-        r.Use(middleware.Auth)
-        r.Get("/", h.List)
-        r.Post("/", h.Create)
-        r.Get("/{id}", h.Get)
-    })
-}
-```
-
-### Error Response Format
-
-```json
-{
-  "error": true,
-  "message": "validation failed",
-  "code": "VALIDATION_ERROR",
-  "details": { "field": "email", "reason": "required" }
-}
-```
-
-## 📋 Frontend Conventions
-
-### Component Naming
-
-| Type       | Convention          | Example            |
-| ---------- | ------------------- | ------------------ |
-| Page       | `kebab-case.vue`    | `game-servers.vue` |
-| Component  | `PascalCase.vue`    | `PackageCard.vue`  |
-| Composable | `use{Name}.ts`      | `usePackages.ts`   |
-| Store      | `use{Name}Store.ts` | `useAuthStore.ts`  |
-
-### API Call Pattern
-
-```typescript
-// ✅ Correct: composable with proper error handling
-export const usePackages = () => {
-  const { data, error, refresh } = useFetch("/api/v1/packages", {
-    key: "packages",
-    lazy: true,
-  });
-  return { packages: data, error, refresh };
-};
-```
-
-### Modal Pattern (Nuxt UI v4)
-
-```vue
-<!-- ✅ Correct: UModal with v-model -->
-<UModal v-model:open="isOpen">
-  <template #header>
-    <h3>{{ title }}</h3>
-  </template>
-  <template #body>
-    <slot />
-  </template>
-</UModal>
-```
-
-## 📋 Domain Models
-
-| Domain       | Go Package             | API Prefix             | Frontend Page         |
-| ------------ | ---------------------- | ---------------------- | --------------------- |
-| Packages     | `internal/packages`    | `/api/v1/packages`     | `/admin/packages`     |
-| Licenses     | `internal/licenses`    | `/api/v1/licenses`     | `/admin/licenses`     |
-| Game Servers | `internal/gameservers` | `/api/v1/game-servers` | `/admin/game-servers` |
-| Points       | `internal/points`      | `/api/v1/points`       | `/admin/points`       |
-| Payments     | `internal/payments`    | `/api/v1/payments`     | `/admin/payments`     |
-| Users        | `internal/users`       | `/api/v1/users`        | `/admin/users`        |
-
-## ⚠️ Anti-Patterns
-
-| ❌ Don't                    | ✅ Do                     |
-| --------------------------- | ------------------------- |
-| Handle logic in handler     | Delegate to service layer |
-| Raw SQL in handlers         | Repository pattern        |
-| `$fetch` without `useFetch` | Use `useFetch` for SSR    |
-| Inline modal content        | Extract to component      |
-| Global state                | Pinia store per domain    |
-
----
-
-_DOMYH Awesome Code — AutoDomyh API Conventions (Private)_

package/.agent/private/autodomyh-api/data/conventions.yaml

@@ -1,107 +0,0 @@
-# =============================================================================
-# conventions.yaml — AutoDomyh Project Conventions (Private)
-# =============================================================================
-
-version: "1.0.0"
-
-backend:
-  language: "Go 1.23+"
-  architecture: "Modular Monolith"
-  patterns:
-    - name: "Atomic Delegation"
-      desc: "Handler → Service → Repository — no logic in handlers"
-      layers:
-        handler: "HTTP parsing, response formatting"
-        service: "Business logic, validation, orchestration"
-        repository: "Database operations (GORM)"
-
-    - name: "Router Mounting"
-      desc: "Each domain module mounts routes at /api/v1/{domain}"
-      pattern: "module.Mount(router)"
-
-    - name: "Cache-Aside (PERF-001)"
-      desc: "Redis cache with TTL, invalidate on write"
-      implementation: "Check cache → miss → fetch DB → set cache"
-
-    - name: "Unified Error Response"
-      desc: "All errors use standard JSON format"
-      fields: ["error", "message", "code", "details"]
-
-  naming:
-    packages: "lowercase, singular (user, payment, license)"
-    handlers: "PascalCase with Handler suffix (PackageHandler)"
-    services: "PascalCase with Service suffix (PackageService)"
-    repositories: "PascalCase with Repository suffix (PackageRepository)"
-    models: "PascalCase, singular (Package, License, User)"
-    tables: "snake_case, plural (packages, licenses, users)"
-
-frontend:
-  framework: "Nuxt 4"
-  ui_library: "Nuxt UI v4"
-  patterns:
-    - name: "Composable Pattern"
-      desc: "All API calls via composables with useFetch"
-      convention: "use{Domain}.ts"
-
-    - name: "Modal Pattern"
-      desc: "UModal with v-model:open and slot structure"
-      slots: ["header", "body", "footer"]
-
-    - name: "DropdownMenu Pattern"
-      desc: "UDropdownMenu with :items array binding"
-      api: "items prop, @select event"
-
-    - name: "Table Pattern"
-      desc: "UTable with :rows and :columns"
-      features: ["sorting", "pagination", "selection"]
-
-  naming:
-    pages: "kebab-case.vue (game-servers.vue)"
-    components: "PascalCase.vue (PackageCard.vue)"
-    composables: "use{Name}.ts (usePackages.ts)"
-    stores: "use{Name}Store.ts (useAuthStore.ts)"
-    types: "types/{domain}.ts (types/package.ts)"
-
-  design:
-    theme: "Dark Glassmorphism"
-    accent: "#3b82f6"
-    fonts: ["Inter", "JetBrains Mono"]
-
-domains:
-  - id: packages
-    go_package: "internal/packages"
-    api: "/api/v1/packages"
-    frontend: "/admin/packages"
-    operations: [list, create, update, delete, toggle-status]
-
-  - id: licenses
-    go_package: "internal/licenses"
-    api: "/api/v1/licenses"
-    frontend: "/admin/licenses"
-    operations: [list, create, revoke, verify, purchase]
-
-  - id: game-servers
-    go_package: "internal/gameservers"
-    api: "/api/v1/game-servers"
-    frontend: "/admin/game-servers"
-    operations: [list, create, update, delete, status]
-
-  - id: points
-    go_package: "internal/points"
-    api: "/api/v1/points"
-    frontend: "/admin/points"
-    operations: [balance, add, deduct, history]
-
-  - id: payments
-    go_package: "internal/payments"
-    api: "/api/v1/payments"
-    frontend: "/admin/payments"
-    operations: [list, create, verify, webhook, reconcile]
-
-  - id: users
-    go_package: "internal/users"
-    api: "/api/v1/users"
-    frontend: "/admin/users"
-    operations: [list, create, update, ban, roles]
-
-# _DOMYH Awesome Code • AutoDomyh Conventions (Private)_