@nockdev/awf 6.2.0 → 6.2.2

package/.agent/personas/persona.schema.yaml

@@ -3,7 +3,7 @@
 # All personas must follow this structure
 
 schema:
-  version: "6.1.2"
+  version: "6.2.2"
 
   required_fields:
     - name # Unique identifier

package/.agent/personas/planner.md

@@ -1,6 +1,6 @@
 ---
 name: planner
-version: "6.1.2"
+version: "6.2.2"
 persona_id: "plan-001"
 
 # =============================================================================

package/.agent/personas/researcher.md

@@ -1,6 +1,6 @@
 ---
 name: researcher
-version: "6.1.2"
+version: "6.2.2"
 persona_id: "res-001"
 
 # =============================================================================

package/.agent/personas/security.md

@@ -1,6 +1,6 @@
 ---
 name: security
-version: "6.1.2"
+version: "6.2.2"
 persona_id: "sec-001"
 
 # =============================================================================

package/.agent/personas/tester.md

@@ -1,6 +1,6 @@
 ---
 name: tester
-version: "6.1.2"
+version: "6.2.2"
 persona_id: "tst-001"
 
 # =============================================================================

package/.agent/private/README.md

@@ -0,0 +1,74 @@
+# 🔒 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

@@ -0,0 +1,23 @@
+# =============================================================================
+# 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

@@ -0,0 +1,38 @@
+# =============================================================================
+# 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

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

@@ -0,0 +1,48 @@
+# =============================================================================
+# 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

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

@@ -0,0 +1,107 @@
+# =============================================================================
+# 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)_

package/.agent/rules/README.md

@@ -68,19 +68,20 @@ Additional **modular rules** can be composed for specific use cases.
 
 Composable rule modules for specific use cases:
 
-| Module                    | Purpose                   | Personas            |
-| ------------------------- | ------------------------- | ------------------- |
-| `reflection.yaml`         | Self-improvement patterns | All                 |
-| `context-management.yaml` | Token efficiency          | All                 |
-| `evidence.yaml`           | Evidence requirements     | Auditor, Debugger   |
-| `stop-conditions.yaml`    | When to pause             | All                 |
-| `edit-verification.yaml`  | Code edit verification    | Developer, Debugger |
-| `terminal-safety.yaml`    | Terminal command safety   | Developer, DevOps   |
-| `git-workflow.yaml`       | Git operations            | Developer, DevOps   |
-| `quality.yaml`            | Code quality standards    | Developer, Tester   |
-| `language.yaml`           | Language/i18n rules       | All                 |
-| `yagni.yaml`              | YAGNI enforcement         | Developer, Planner  |
-| `online-research.yaml`    | Web research guidelines   | Researcher          |
+| Module                          | Purpose                      | Personas            |
+| ------------------------------- | ---------------------------- | ------------------- |
+| `stop-conditions.yaml`          | When to pause                | All                 |
+| `edit-verification.yaml`        | Code edit verification       | Developer, Debugger |
+| `terminal-safety.yaml`          | Terminal command safety      | Developer, DevOps   |
+| `git-workflow.yaml`             | Git operations               | Developer, DevOps   |
+| `quality.yaml`                  | Code quality standards       | Developer, Tester   |
+| `language.yaml`                 | Language/i18n rules          | All                 |
+| `yagni.yaml`                    | YAGNI enforcement            | Developer, Planner  |
+| `online-research.yaml`          | Web research guidelines      | Researcher          |
+| `agent-delegation.yaml`         | Task delegation patterns     | Orchestrator        |
+| `performance-optimization.yaml` | Perf optimization guidelines | Developer, DevOps   |
+
+> **Merged into constitutional tiers** (in `archive/`): `reflection.yaml`, `context-management.yaml`, `evidence.yaml`
 
 📁 Location: `modules/*.yaml`
 
@@ -96,7 +97,7 @@ Composable rule modules for specific use cases:
 │   ├── tier-0-core.yaml         # Immutable principles
 │   ├── tier-1-safety.yaml       # Safety rules
 │   └── tier-2-execution.yaml    # Quality guidelines
-├── modules/                     # v6.0 Modular rules (12 YAML files)
+├── modules/                     # v6.0 Modular rules (10 YAML files)
 │   ├── reflection.yaml          # Self-improvement
 │   ├── context-management.yaml  # Token efficiency
 │   ├── evidence.yaml            # Evidence requirements
@@ -110,13 +111,18 @@ Composable rule modules for specific use cases:
 │   └── online-research.yaml     # Web research
 ├── data/                        # Supporting data files
 │   └── build-systems.yaml       # Build system detection data
+├── archive/                     # Merged/legacy rules
+│   ├── constitutional/          # Constitutional YAML tiers
+│   ├── reflection.yaml          # Merged into Tier 2
+│   ├── context-management.yaml  # Merged into Tier 2
+│   ├── evidence.yaml            # Merged into Tier 2
+│   ├── duplication-prevention.md # DRY enforcement
+│   └── incremental-changes.md   # Step-by-step modifications
 └── [Standalone Rules]           # Active standalone rules
     ├── project-detection.md     # Project/stack detection
     ├── shell-commands.md        # Shell syntax per platform
     ├── prompt-injection-guard.md # Security: CVE-2025 protection
-    ├── validation-framework.md  # Input validation patterns
-    ├── duplication-prevention.md # DRY enforcement
-    └── incremental-changes.md   # Step-by-step modifications
+    └── validation-framework.md  # Input validation patterns
 ```
 
 ---
@@ -176,7 +182,7 @@ Each modular rule follows this schema:
 
 ```yaml
 name: rule-name
-version: "6.1.2"
+version: "6.2.2"
 rule_id: "MOD-XXX-001"
 
 description: |