@nockdev/awf 6.2.0

package/.agent/skills/_categories.yaml

@@ -0,0 +1,145 @@
+# =============================================================================
+# _categories.yaml — Skill Category Definitions
+# =============================================================================
+# Metadata for skill categories in hierarchical organization
+# =============================================================================
+
+version: "1.0.0"
+
+categories:
+  # ==========================================================================
+  # LANGUAGES (28 skills)
+  # ==========================================================================
+  languages:
+    description: "Programming languages"
+    path: "languages/"
+    priority: 1
+    skills:
+      # Systems
+      - c
+      - cpp
+      - rust
+      - go
+      - zig
+      - nim
+      - asm
+
+      # JVM
+      - java
+      - kotlin
+      - scala
+      - clojure
+
+      # .NET
+      - csharp
+      - fsharp
+
+      # Scripting
+      - python
+      - ruby
+      - php
+      - perl
+      - lua
+      - javascript
+      - typescript
+
+      # Functional
+      - haskell
+      - elixir
+      - ocaml
+
+      # Scientific
+      - r
+      - julia
+
+      # Apple/Mobile
+      - swift
+
+      # Blockchain
+      - solidity
+
+      # Crystal
+      - crystal
+
+  # ==========================================================================
+  # FRAMEWORKS (8 skills)
+  # ==========================================================================
+  frameworks:
+    description: "Frontend/Backend frameworks"
+    path: "frameworks/"
+    priority: 2
+    skills:
+      - react
+      - vue
+      - angular
+      - svelte
+      - nextjs
+      - nuxt
+      - flutter
+      - react-native
+
+  # ==========================================================================
+  # DEVOPS (4 skills)
+  # ==========================================================================
+  devops:
+    description: "Infrastructure and deployment"
+    path: "devops/"
+    priority: 3
+    skills:
+      - docker
+      - kubernetes
+      - aws
+      - ci-cd
+
+  # ==========================================================================
+  # CORE (6 skills - always loaded)
+  # ==========================================================================
+  core:
+    description: "Core patterns - security, API design, error handling, logging, observability, authentication"
+    path: "core/"
+    priority: 0
+    always_load: true
+    skills:
+      - security
+      - api-design
+      - error-handling
+      - logging
+      - observability
+      - authentication
+
+  # ==========================================================================
+  # CROSS-CUTTING (10 skills)
+  # ==========================================================================
+  cross-cutting:
+    description: "Cross-cutting concerns and utilities"
+    path: "cross-cutting/"
+    priority: 4
+    skills:
+      - testing
+      - database
+      - sql
+      - tailwind
+      - electron
+      - coding-rules
+      - ui-ux-pro-max
+      - web-perf
+      - deno
+      - bun
+      - audit-pro
+
+# =============================================================================
+# STATISTICS
+# =============================================================================
+
+stats:
+  total_skills: 56
+  categories: 5
+  estimated_tokens:
+    all_meta: 5600 # ~100 tokens × 56
+    router_only: 500 # Router + core META
+    typical_session: 2500 # Router + 2 language + 1 framework
+
+
+# =============================================================================
+# _DOMYH Awesome Code • Category Definitions_
+# =============================================================================

package/.agent/skills/_router.yaml

@@ -0,0 +1,232 @@
+# =============================================================================
+# _router.yaml — Smart Skill Router
+# =============================================================================
+# Single Source of Truth for skill loading strategy
+# Integrates with HSA v1.0.0 project detector for optimal token usage
+# =============================================================================
+
+version: "1.0.0"
+engine: "hsa"
+schema: "hierarchical"
+
+# =============================================================================
+# LOADING STRATEGY
+# =============================================================================
+
+strategy:
+  # Always loaded (minimal footprint)
+  baseline:
+    always_load:
+      - category: "core"
+        skill: "security"
+        file: "META.yaml"
+    max_tokens: 100
+
+  # Layer 1: Deterministic — Load from workflow frontmatter (0ms)
+  on_workflow:
+    source: "manifest.commands[].skills"
+    mode: "merge" # Merge with on_detect results
+    load_file: "META.yaml" # Initially load only metadata
+    upgrade_to: "SKILL.md" # Upgrade when actively used
+    resolution:
+      required: "always_load" # skills.required → always load META
+      contextual: "if_detected" # skills.contextual → load only if project has it
+      auto: "delegate_to_on_detect" # [auto] → fallback to Layer 2
+
+  # Layer 2: Contextual — Load on project detection (<50ms)
+  on_detect:
+    source: "project_detector"
+    load_file: "META.yaml"
+    max_skills: 5
+    cache_ttl: 300 # 5 minutes
+
+  # Layer 3: Semantic — Load on user request/workflow (<200ms)
+  on_request:
+    triggers:
+      - "user query contains skill keywords"
+      - "workflow requires skill"
+      - "command references skill"
+    load_file: "SKILL.md"
+    max_tokens: 1500
+
+  # Never preload
+  never_preload:
+    - "ADVANCED.md" # Reference only when explicitly needed
+
+# =============================================================================
+# P0-P2 INTEGRATION (v1.1)
+# =============================================================================
+# References core/ROUTER.yaml for full implementation
+
+selection:
+  # P0: Dynamic threshold (see core/ROUTER.yaml for full config)
+  threshold_config: "$ref:core/ROUTER.yaml#/selection/threshold"
+  default_threshold: 0.50
+
+  # P1: Query expansion (see core/ROUTER.yaml for synonyms)
+  query_expansion: "$ref:core/ROUTER.yaml#/query_expansion"
+
+  # P2: Confidence scoring
+  confidence_scoring: "$ref:core/ROUTER.yaml#/confidence_scoring"
+
+# =============================================================================
+# CATEGORY ROUTING
+# =============================================================================
+
+routing:
+  languages:
+    path: "skills/languages/"
+    detect_by:
+      - "extension" # .py → python, .go → go
+      - "build_system" # go.mod → go, Cargo.toml → rust
+    priority: 1
+    count: 28
+
+  frameworks:
+    path: "skills/frameworks/"
+    detect_by:
+      - "dependency" # react in package.json
+      - "special_file" # next.config.js → nextjs
+    priority: 2
+    count: 8
+
+  devops:
+    path: "skills/devops/"
+    detect_by:
+      - "special_file" # Dockerfile, k8s/
+      - "directory" # .github/workflows/
+    priority: 3
+    count: 4
+
+  core:
+    path: "skills/core/"
+    always_load: true
+    priority: 0
+    count: 6
+
+  cross-cutting:
+    path: "skills/cross-cutting/"
+    detect_by:
+      - "dependency"
+      - "extension"
+    priority: 4
+    count: 10
+
+    # UI/UX Pro Max skill - integrated with HSA adapter
+    skills:
+      ui-ux-pro-max:
+        adapter: "hsa.adapters.uiux_adapter"
+        preload_data: true
+        triggers:
+          file_patterns:
+            - "*.html"
+            - "*.css"
+            - "*.scss"
+            - "*.tsx"
+            - "*.vue"
+            - "*.svelte"
+            - "tailwind.config.*"
+            - "components.json"
+          keywords:
+            - "ui design"
+            - "ux design"
+            - "landing page"
+            - "dashboard"
+            - "glassmorphism"
+            - "dark mode"
+            - "color palette"
+            - "typography"
+            - "font pairing"
+
+      # Electron skill - integrated with dedicated HSA YAML-based adapter
+      electron:
+        adapter: "hsa.adapters.electron_adapter"
+        data_dir: "skills/cross-cutting/electron/data"
+        preload_data: true
+        triggers:
+          file_patterns:
+            - "electron.vite.config.ts"
+            - "electron-builder.json5"
+            - "forge.config.ts"
+            - "**/main.ts:electron"
+            - "**/preload.ts"
+          keywords:
+            - "electron"
+            - "electronjs"
+            - "electron app"
+            - "desktop app"
+            - "BrowserWindow"
+            - "contextBridge"
+            - "ipcMain"
+            - "ipcRenderer"
+            - "electron-builder"
+            - "electron-vite"
+            - "autoUpdater"
+            - "better-sqlite3"
+            - "electron-store"
+
+      # Tailwind skill - integrated with dedicated HSA YAML-based adapter
+      tailwind:
+        adapter: "hsa.adapters.tailwind_adapter"
+        data_dir: "skills/cross-cutting/tailwind/data"
+        preload_data: true
+        triggers:
+          file_patterns:
+            - "tailwind.config.js"
+            - "tailwind.config.ts"
+            - "*.css"
+            - "postcss.config.js"
+            - "vite.config.ts"
+          keywords:
+            # Core
+            - "tailwind"
+            - "tailwindcss"
+            - "@tailwindcss"
+            # v4 Features
+            - "@theme"
+            - "@utility"
+            - "@source"
+            - "container query"
+            # Variants
+            - "dark:"
+            - "hover:"
+            - "responsive"
+            - "mobile first"
+            # Build
+            - "oxide engine"
+            - "lightning css"
+            - "Vite plugin"
+
+# =============================================================================
+# SKILL RESOLUTION
+# =============================================================================
+
+resolution:
+  # Support both flat and hierarchical paths
+  backward_compat: true
+
+  # e.g., "python" → "languages/python"
+  aliases:
+    python: "languages/python"
+    go: "languages/go"
+    typescript: "languages/typescript"
+    react: "frameworks/react"
+    vue: "frameworks/vue"
+    docker: "devops/docker"
+    security: "core/security"
+    testing: "cross-cutting/testing"
+
+# =============================================================================
+# TOKEN BUDGET
+# =============================================================================
+
+token_budget:
+  baseline: 500 # Router + core/security META
+  per_detected: 100 # Each detected skill META
+  per_active: 1500 # Each active skill SKILL.md
+  max_total: 6000 # Cap for skill tokens
+
+
+# =============================================================================
+# _DOMYH Awesome Code • Hierarchical Skill Router_
+# =============================================================================

package/.agent/skills/core/_index.yaml

@@ -0,0 +1,12 @@
+# core/_index.yaml — Core Skills Index (Always Loaded)
+category: core
+description: "Core patterns - security, API, errors, logging, observability, auth"
+always_load: true
+count: 6
+skills:
+  - { id: security, has_advanced: true }
+  - { id: api-design, has_advanced: true }
+  - { id: error-handling, has_advanced: true }
+  - { id: logging, has_advanced: true }
+  - { id: observability, has_advanced: true }
+  - { id: authentication, has_advanced: true }

package/.agent/skills/core/api-design/META.yaml

@@ -0,0 +1,64 @@
+name: api-design
+version: "6.2.0"
+display: API Design Patterns
+category: core
+tier: 1
+priority: 1
+
+desc: "Comprehensive API design patterns: REST (Richardson Maturity, HATEOAS), GraphQL (schema, resolvers, DataLoader), gRPC (streaming, protocol buffers). Versioning, pagination, rate limiting, error responses (RFC 9457). HSA dynamic search enabled."
+
+triggers:
+  file_patterns:
+    - "openapi.yaml"
+    - "swagger.json"
+    - "*.proto"
+    - "schema.graphql"
+    - "*.graphql"
+  keywords:
+    - api
+    - rest
+    - graphql
+    - grpc
+    - versioning
+    - pagination
+    - hateoas
+    - rate-limiting
+    - openapi
+    - swagger
+    - protocol-buffers
+    - rfc-9457
+  intents:
+    - api design
+    - rest api
+    - graphql schema
+    - grpc service
+
+caps:
+  - REST API design (Richardson Maturity Level 0-3)
+  - GraphQL schema design and resolvers
+  - gRPC protocol buffers and streaming
+  - API versioning strategies (Stripe/GitHub/Twilio)
+  - Pagination patterns (offset/cursor/keyset)
+  - Rate limiting (token bucket/sliding window)
+  - Error responses (RFC 9457)
+  - HATEOAS hypermedia controls
+  - OpenAPI/Swagger documentation
+  - Test API suggestions (JSONPlaceholder/httpbin/reqres)
+
+hsa:
+  enabled: true
+  adapter: api_design_adapter.py
+  functions:
+    - search_api_patterns
+    - suggest_test_api
+
+data_files:
+  - data/rest-patterns.yaml
+  - data/graphql-patterns.yaml
+  - data/grpc-patterns.yaml
+  - data/api-versioning.yaml
+  - data/pagination.yaml
+  - data/rate-limiting.yaml
+  - data/error-responses.yaml
+  - data/http-status-codes.yaml
+  - data/test-apis.yaml

package/.agent/skills/core/api-design/SKILL.md

@@ -0,0 +1,169 @@
+# 🔗 API Design Patterns
+
+> Comprehensive patterns for REST, GraphQL, and gRPC API design
+> 🚀 HSA Dynamic Search Enabled | 📊 202 Patterns | 25 Test APIs
+
+---
+
+## 🎯 HSA Integration
+
+```python
+# Search API patterns dynamically
+from hsa.adapters import search_api_patterns, suggest_test_api
+
+# Find versioning patterns
+results = search_api_patterns("versioning strategy", max_results=5)
+
+# Search by domain
+results = search_api_patterns("streaming", domain="grpc")
+
+# Get test API suggestions
+apis = suggest_test_api("user data REST")
+for api in apis:
+    print(f"{api.pattern}: {api.url}")
+```
+
+---
+
+## 📊 Quick Reference
+
+### REST Richardson Maturity Model
+
+| Level | Name         | Characteristics                     |
+| ----- | ------------ | ----------------------------------- |
+| 0     | Swamp of POX | Single URI, single method (RPC)     |
+| 1     | Resources    | Individual URIs per resource        |
+| 2     | HTTP Verbs   | Proper GET/POST/PUT/DELETE          |
+| 3     | HATEOAS      | Hypermedia controls, self-discovery |
+
+### API Versioning Strategies (Real-World)
+
+| Strategy   | Example                            | Used By                   |
+| ---------- | ---------------------------------- | ------------------------- |
+| URI        | `/v1/users`                        | Facebook, Twitter, PayPal |
+| Header     | `X-API-Version: 1`                 | Microsoft Azure           |
+| Date-Based | `2024-06-20`                       | **Stripe**, **GitHub**    |
+| Semantic   | `2.1.0`                            | **Twilio** SDKs           |
+| Calendar   | `X-GitHub-Api-Version: 2022-11-28` | GitHub REST               |
+
+### Pagination Patterns
+
+| Pattern | Use Case           | Trade-off        |
+| ------- | ------------------ | ---------------- |
+| Offset  | Small datasets     | Slow at scale    |
+| Cursor  | Large/dynamic data | No random access |
+| Keyset  | Ordered lists      | Sequential only  |
+
+### Rate Limiting
+
+```
+┌─────────────────────────────────────────┐
+│ Token Bucket: Handles bursts            │
+│ - Tokens refill at fixed rate           │
+│ - Burst up to bucket capacity           │
+├─────────────────────────────────────────┤
+│ Sliding Window: Smooth rate             │
+│ - Rolling time window                   │
+│ - More precise than fixed window        │
+└─────────────────────────────────────────┘
+```
+
+### Error Response (RFC 9457)
+
+```json
+{
+  "type": "https://api.example.com/errors/rate-limit",
+  "title": "Rate Limit Exceeded",
+  "status": 429,
+  "detail": "You have exceeded 100 requests per minute",
+  "instance": "/logs/abc123"
+}
+```
+
+---
+
+## 🧪 Test APIs for Learning
+
+| API             | URL                          | Best For           |
+| --------------- | ---------------------------- | ------------------ |
+| JSONPlaceholder | jsonplaceholder.typicode.com | Prototyping, demos |
+| httpbin         | httpbin.org                  | HTTP debugging     |
+| Reqres          | reqres.in                    | Auth flows         |
+| Random User     | randomuser.me/api            | UI testing         |
+| FakeStore API   | fakestoreapi.com             | E-commerce         |
+| Postman Echo    | postman-echo.com             | Request inspection |
+
+> 💡 Use `suggest_test_api("your use case")` to find matching APIs
+
+---
+
+## 📁 Data Files
+
+| File                  | Patterns | Coverage                           |
+| --------------------- | -------- | ---------------------------------- |
+| rest-patterns.csv     | 30       | URI, methods, HATEOAS, caching     |
+| graphql-patterns.csv  | 25       | Schema, resolvers, N+1, DataLoader |
+| grpc-patterns.csv     | 25       | Protobuf, streaming, reliability   |
+| api-versioning.csv    | 25       | URI, header, Stripe/GitHub/Twilio  |
+| pagination.csv        | 15       | Offset, cursor, keyset             |
+| rate-limiting.csv     | 20       | Token bucket, sliding window       |
+| error-responses.csv   | 20       | RFC 9457, validation errors        |
+| http-status-codes.csv | 27       | 2xx, 4xx, 5xx reference            |
+| test-apis.csv         | 25       | Public APIs for testing            |
+
+**Total: 202 patterns**
+
+---
+
+## 🔧 Common Patterns
+
+### REST Best Practices
+
+```yaml
+URI Design:
+  - Use plural nouns: /users, /products
+  - Nest max 2-3 levels: /users/{id}/orders
+  - Use hyphens: /order-items
+  - Keep lowercase: /users not /Users
+  - No verbs: GET /users not /getUsers
+
+HTTP Methods:
+  GET: Read (idempotent)
+  POST: Create
+  PUT: Replace entire resource
+  PATCH: Partial update
+  DELETE: Remove (idempotent)
+```
+
+### GraphQL N+1 Solution
+
+```javascript
+// Without DataLoader (N+1 problem)
+users.map((user) => db.query(`SELECT * FROM orders WHERE userId = ${user.id}`));
+
+// With DataLoader (1 batched query)
+const orderLoader = new DataLoader((userIds) =>
+  db.query(`SELECT * FROM orders WHERE userId IN (${userIds})`),
+);
+users.map((user) => orderLoader.load(user.id));
+```
+
+### gRPC Streaming
+
+```protobuf
+// Unary RPC
+rpc GetUser(UserRequest) returns (User);
+
+// Server streaming
+rpc ListUsers(Empty) returns (stream User);
+
+// Client streaming
+rpc UploadData(stream Chunk) returns (Status);
+
+// Bidirectional streaming
+rpc Chat(stream Message) returns (stream Message);
+```
+
+---
+
+_DOMYH Awesome Code • API Design Patterns • 202 patterns • HSA Enabled_