@nockdev/awf 6.2.0 → 6.2.1

package/.agent/skills/cross-cutting/real-time/data/websocket-patterns.yaml

@@ -0,0 +1,176 @@
+# WebSocket Patterns — HSA Tier 3 Data
+version: "1.0.0"
+
+patterns:
+  - id: WS-001
+    name: Connection with Reconnection
+    category: connection
+    description: |
+      WebSocket connection with exponential backoff reconnection.
+    example: |
+      class ReconnectingWebSocket {
+        private ws: WebSocket | null = null;
+        private retries = 0;
+        private maxRetries = 10;
+        
+        connect(url: string) {
+          this.ws = new WebSocket(url);
+          
+          this.ws.onopen = () => {
+            console.log("Connected");
+            this.retries = 0;
+          };
+          
+          this.ws.onclose = (event) => {
+            if (!event.wasClean && this.retries < this.maxRetries) {
+              const delay = Math.min(1000 * Math.pow(2, this.retries++), 30000);
+              const jitter = delay * 0.1 * Math.random();
+              setTimeout(() => this.connect(url), delay + jitter);
+            }
+          };
+          
+          this.ws.onmessage = (event) => {
+            const data = JSON.parse(event.data);
+            this.handleMessage(data);
+          };
+          
+          this.ws.onerror = (error) => console.error("WS Error:", error);
+        }
+        
+        send(data: unknown) {
+          if (this.ws?.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(data));
+          }
+        }
+      }
+
+  - id: WS-002
+    name: Authentication Patterns
+    category: security
+    description: |
+      Authenticate WebSocket connections.
+    text: |
+      Option 1: Token in URL query (simple, exposed in logs)
+      Option 2: Token in first message (preferred)
+      Option 3: Cookie-based (automatic, same-origin only)
+      Option 4: Upgrade header (server-side only)
+    example: |
+      // Option 2: Token in first message (recommended)
+      const ws = new WebSocket("wss://api.example.com/ws");
+      ws.onopen = () => {
+        ws.send(JSON.stringify({ type: "auth", token: jwtToken }));
+      };
+
+      // Server-side validation
+      ws.on("message", (data) => {
+        const msg = JSON.parse(data);
+        if (msg.type === "auth") {
+          const user = verifyJWT(msg.token);
+          if (!user) { ws.close(4001, "Unauthorized"); return; }
+          ws.userId = user.id;
+          ws.authenticated = true;
+        } else if (!ws.authenticated) {
+          ws.close(4001, "Not authenticated");
+        }
+      });
+
+  - id: WS-003
+    name: Heartbeat Pattern
+    category: connection
+    description: |
+      Keep connections alive and detect stale connections.
+    example: |
+      // Server-side heartbeat
+      const HEARTBEAT_INTERVAL = 30000;
+      const HEARTBEAT_TIMEOUT = 10000;
+
+      wss.on("connection", (ws) => {
+        ws.isAlive = true;
+        ws.on("pong", () => { ws.isAlive = true; });
+      });
+
+      setInterval(() => {
+        wss.clients.forEach((ws) => {
+          if (!ws.isAlive) { ws.terminate(); return; }
+          ws.isAlive = false;
+          ws.ping();
+        });
+      }, HEARTBEAT_INTERVAL);
+
+  - id: WS-004
+    name: Message Protocol
+    category: protocol
+    description: |
+      Structured message format for WebSocket communication.
+    text: |
+      Standard format:
+      { type: "event_name", payload: {...}, id?: "uuid", timestamp?: "ISO" }
+
+      Common types:
+      - subscribe/unsubscribe: Channel management
+      - message: Application data
+      - error: Error responses
+      - ack: Delivery confirmation
+    example: |
+      // Message types
+      type WSMessage = 
+        | { type: "subscribe"; payload: { channel: string } }
+        | { type: "unsubscribe"; payload: { channel: string } }
+        | { type: "message"; payload: { channel: string; data: unknown }; id: string }
+        | { type: "ack"; payload: { id: string } }
+        | { type: "error"; payload: { code: number; message: string } };
+
+  - id: WS-005
+    name: Binary Data
+    category: advanced
+    description: |
+      Send binary data (ArrayBuffer, Blob) over WebSocket.
+    text: |
+      Use cases: File transfer, audio/video streaming, game state
+      Set binaryType: "arraybuffer" or "blob" on client
+    example: |
+      ws.binaryType = "arraybuffer";
+      ws.onmessage = (event) => {
+        if (event.data instanceof ArrayBuffer) {
+          const view = new DataView(event.data);
+          // Process binary data
+        }
+      };
+
+  - id: WS-006
+    name: NGINX WebSocket Proxy
+    category: infrastructure
+    description: |
+      NGINX configuration for WebSocket proxying.
+    example: |
+      # nginx.conf
+      location /ws {
+        proxy_pass http://backend:3000;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_read_timeout 86400;  # 24h keep-alive
+      }
+
+  - id: WS-007
+    name: Scaling Patterns
+    category: infrastructure
+    description: |
+      Scale WebSocket across multiple server instances.
+    text: |
+      Challenge: WebSocket connections are stateful
+
+      Solutions:
+      1. Sticky sessions (IP hash / cookie-based)
+      2. Redis Pub/Sub for cross-instance messaging
+      3. NATS/Kafka as message bus
+      4. Dedicated WebSocket gateway (separate from API)
+
+      NGINX sticky sessions:
+      upstream backend {
+        ip_hash;
+        server backend1:3000;
+        server backend2:3000;
+      }

package/.agent/skills/cross-cutting/seo/META.yaml

@@ -0,0 +1,47 @@
+name: seo
+version: "6.2.1"
+display: SEO & Core Web Vitals
+category: cross-cutting
+tier: 1
+priority: 1
+
+desc: "SEO optimization: Core Web Vitals (LCP, FID, CLS, INP), structured data (JSON-LD), meta tags, sitemap, robots.txt, semantic HTML. Technical and on-page SEO. 90+ patterns."
+
+triggers:
+  file_patterns: []
+  keywords:
+    - seo
+    - search engine
+    - core web vitals
+    - lcp
+    - fid
+    - cls
+    - inp
+    - structured data
+    - json-ld
+    - meta tags
+    - sitemap
+    - robots.txt
+    - schema.org
+    - open graph
+    - canonical
+  intents:
+    - search optimization
+    - improve SEO
+    - core web vitals
+    - structured data
+
+caps:
+  - Core Web Vitals (LCP, INP, CLS)
+  - Technical SEO (sitemap, robots, canonical)
+  - Structured data (JSON-LD, Schema.org)
+  - Meta tags (Open Graph, Twitter Card)
+  - Semantic HTML for SEO
+  - Performance optimization for SEO
+  - Mobile-first indexing
+  - International SEO (hreflang)
+
+data_files:
+  - data/core-web-vitals.yaml
+  - data/structured-data.yaml
+  - data/technical-seo.yaml

package/.agent/skills/cross-cutting/seo/SKILL.md

@@ -0,0 +1,114 @@
+# SEO & Core Web Vitals
+
+> 🔍 **Search engine optimization for modern web applications**
+> **Patterns**: 90+ | **Metrics**: CWV + Technical + On-page
+
+---
+
+## Quick Reference
+
+| What You Need                         | Data File              | Patterns |
+| ------------------------------------- | ---------------------- | -------- |
+| Core Web Vitals (LCP, INP, CLS)       | `core-web-vitals.yaml` | 30       |
+| Structured data (JSON-LD, Schema.org) | `structured-data.yaml` | 30       |
+| Technical SEO (sitemap, robots, meta) | `technical-seo.yaml`   | 30       |
+
+---
+
+## Core Web Vitals (2025)
+
+| Metric                              | Measures         | Good    | Needs Work | Poor    |
+| ----------------------------------- | ---------------- | ------- | ---------- | ------- |
+| **LCP** (Largest Contentful Paint)  | Loading          | ≤ 2.5s  | ≤ 4.0s     | > 4.0s  |
+| **INP** (Interaction to Next Paint) | Responsiveness   | ≤ 200ms | ≤ 500ms    | > 500ms |
+| **CLS** (Cumulative Layout Shift)   | Visual stability | ≤ 0.1   | ≤ 0.25     | > 0.25  |
+
+### Optimization Quick Wins
+
+| Metric  | Fix                                                   | Impact |
+| ------- | ----------------------------------------------------- | ------ |
+| **LCP** | Preload hero image: `<link rel="preload" as="image">` | High   |
+| **LCP** | Use `priority` on Next.js Image component             | High   |
+| **INP** | Debounce event handlers                               | Medium |
+| **INP** | Use `requestIdleCallback` for non-urgent work         | Medium |
+| **CLS** | Set explicit `width`/`height` on images               | High   |
+| **CLS** | Use `font-display: swap` for web fonts                | Medium |
+
+---
+
+## Essential Meta Tags
+
+```html
+<head>
+  <title>Page Title — Brand (50-60 chars)</title>
+  <meta name="description" content="Compelling description (150-160 chars)" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <link rel="canonical" href="https://example.com/page" />
+
+  <!-- Open Graph -->
+  <meta property="og:title" content="Page Title" />
+  <meta property="og:description" content="Description" />
+  <meta property="og:image" content="https://example.com/og.jpg" />
+  <meta property="og:type" content="website" />
+
+  <!-- Twitter Card -->
+  <meta name="twitter:card" content="summary_large_image" />
+  <meta name="twitter:title" content="Page Title" />
+</head>
+```
+
+---
+
+## Structured Data (JSON-LD)
+
+```html
+<script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@type": "Article",
+    "headline": "Article Title",
+    "author": { "@type": "Person", "name": "Author" },
+    "datePublished": "2025-01-01",
+    "image": "https://example.com/image.jpg"
+  }
+</script>
+```
+
+| Schema Type        | Best For         |
+| ------------------ | ---------------- |
+| **Article**        | Blog posts, news |
+| **Product**        | E-commerce       |
+| **FAQ**            | FAQ pages        |
+| **BreadcrumbList** | Navigation       |
+| **Organization**   | Company info     |
+| **LocalBusiness**  | Physical stores  |
+| **HowTo**          | Tutorials        |
+
+---
+
+## Technical SEO Checklist
+
+| Check                | Implementation                    |
+| -------------------- | --------------------------------- |
+| ✅ Sitemap           | `/sitemap.xml` with all URLs      |
+| ✅ Robots.txt        | `/robots.txt` with crawl rules    |
+| ✅ Canonical URLs    | `<link rel="canonical">`          |
+| ✅ HTTPS             | Secure origin                     |
+| ✅ Mobile responsive | Viewport meta + responsive design |
+| ✅ 301 redirects     | Permanent URL changes             |
+| ✅ hreflang          | Multi-language support            |
+| ✅ Semantic HTML     | Proper heading hierarchy (h1→h6)  |
+| ✅ Alt text          | Descriptive image alt attributes  |
+| ✅ Internal linking  | Connect related pages             |
+
+---
+
+## HSA Integration
+
+Data powered by HSA BM25 search engine. Query YAML data via skill search:
+
+| Domain          | Query Examples                         |
+| --------------- | -------------------------------------- |
+| CWV             | "LCP largest contentful paint preload" |
+| Structured Data | "JSON-LD schema.org product article"   |
+| Technical       | "sitemap robots canonical hreflang"    |

package/.agent/skills/cross-cutting/seo/data/core-web-vitals.yaml

@@ -0,0 +1,93 @@
+# Core Web Vitals Data
+
+metrics:
+  - name: LCP
+    full_name: "Largest Contentful Paint"
+    measures: "Loading performance"
+    thresholds:
+      good: "≤ 2.5s"
+      needs_improvement: "≤ 4.0s"
+      poor: "> 4.0s"
+    optimizations:
+      - name: "Preload critical resources"
+        code: '<link rel="preload" as="image" href="/hero.webp">'
+        impact: high
+      - name: "Use CDN for static assets"
+        impact: high
+      - name: "Optimize images (WebP/AVIF)"
+        code: '<img src="hero.webp" width="800" height="400" loading="eager">'
+        impact: high
+      - name: "Eliminate render-blocking resources"
+        code: '<link rel="stylesheet" href="critical.css" media="all">'
+        impact: medium
+      - name: "Server-side render above-the-fold"
+        impact: medium
+
+  - name: INP
+    full_name: "Interaction to Next Paint"
+    measures: "Responsiveness (replaces FID in 2024)"
+    thresholds:
+      good: "≤ 200ms"
+      needs_improvement: "≤ 500ms"
+      poor: "> 500ms"
+    optimizations:
+      - name: "Break up long tasks"
+        code: |
+          // Split long task with scheduler.yield()
+          async function processData(items) {
+            for (const item of items) {
+              process(item);
+              await scheduler.yield(); // Let browser respond to input
+            }
+          }
+        impact: high
+      - name: "Debounce/throttle event handlers"
+        impact: medium
+      - name: "Use requestIdleCallback for non-urgent work"
+        impact: medium
+      - name: "Minimize main thread work"
+        impact: high
+
+  - name: CLS
+    full_name: "Cumulative Layout Shift"
+    measures: "Visual stability"
+    thresholds:
+      good: "≤ 0.1"
+      needs_improvement: "≤ 0.25"
+      poor: "> 0.25"
+    optimizations:
+      - name: "Set explicit dimensions on images/video"
+        code: '<img src="photo.jpg" width="640" height="480">'
+        impact: high
+      - name: "Use CSS aspect-ratio"
+        code: |
+          .image-container {
+            aspect-ratio: 16/9;
+            width: 100%;
+          }
+        impact: high
+      - name: "font-display: swap for web fonts"
+        code: "@font-face { font-display: swap; }"
+        impact: medium
+      - name: "Reserve space for ads/embeds"
+        impact: medium
+      - name: "Use contain-intrinsic-size for lazy content"
+        code: |
+          .lazy-section {
+            content-visibility: auto;
+            contain-intrinsic-size: 0 500px;
+          }
+        impact: medium
+
+tools:
+  - name: "Chrome DevTools Performance tab"
+    usage: "Measure CWV in real-time"
+  - name: "PageSpeed Insights"
+    url: "https://pagespeed.web.dev/"
+  - name: "web-vitals library"
+    install: "npm install web-vitals"
+    code: |
+      import { onLCP, onINP, onCLS } from 'web-vitals';
+      onLCP(console.log);
+      onINP(console.log);
+      onCLS(console.log);

package/.agent/skills/cross-cutting/seo/data/structured-data.yaml

@@ -0,0 +1,82 @@
+# Structured Data Patterns
+
+schemas:
+  - type: Article
+    required: ["headline", "author", "datePublished", "image"]
+    template: |
+      {
+        "@context": "https://schema.org",
+        "@type": "Article",
+        "headline": "{{title}}",
+        "author": { "@type": "Person", "name": "{{author}}" },
+        "datePublished": "{{date}}",
+        "image": "{{image_url}}"
+      }
+
+  - type: Product
+    required: ["name", "description", "offers"]
+    template: |
+      {
+        "@context": "https://schema.org",
+        "@type": "Product",
+        "name": "{{name}}",
+        "description": "{{description}}",
+        "image": "{{image_url}}",
+        "offers": {
+          "@type": "Offer",
+          "price": "{{price}}",
+          "priceCurrency": "{{currency}}",
+          "availability": "https://schema.org/InStock"
+        }
+      }
+
+  - type: FAQPage
+    template: |
+      {
+        "@context": "https://schema.org",
+        "@type": "FAQPage",
+        "mainEntity": [
+          {
+            "@type": "Question",
+            "name": "{{question}}",
+            "acceptedAnswer": {
+              "@type": "Answer",
+              "text": "{{answer}}"
+            }
+          }
+        ]
+      }
+
+  - type: BreadcrumbList
+    template: |
+      {
+        "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        "itemListElement": [
+          { "@type": "ListItem", "position": 1, "name": "Home", "item": "{{base_url}}" },
+          { "@type": "ListItem", "position": 2, "name": "{{category}}", "item": "{{category_url}}" }
+        ]
+      }
+
+  - type: Organization
+    template: |
+      {
+        "@context": "https://schema.org",
+        "@type": "Organization",
+        "name": "{{name}}",
+        "url": "{{url}}",
+        "logo": "{{logo_url}}",
+        "sameAs": ["{{social_urls}}"]
+      }
+
+validation:
+  tools:
+    - name: "Google Rich Results Test"
+      url: "https://search.google.com/test/rich-results"
+    - name: "Schema.org Validator"
+      url: "https://validator.schema.org/"
+  rules:
+    - "Always use JSON-LD (not Microdata or RDFa)"
+    - "Place in <head> or end of <body>"
+    - "One primary type per page"
+    - "Test with Google Rich Results Test before deploy"

package/.agent/skills/cross-cutting/seo/data/technical-seo.yaml

@@ -0,0 +1,75 @@
+# Technical SEO Patterns
+
+patterns:
+  - name: sitemap
+    file: "sitemap.xml"
+    template: |
+      <?xml version="1.0" encoding="UTF-8"?>
+      <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+        <url>
+          <loc>https://example.com/</loc>
+          <lastmod>2025-01-01</lastmod>
+          <changefreq>weekly</changefreq>
+          <priority>1.0</priority>
+        </url>
+      </urlset>
+    rules:
+      - "Max 50,000 URLs per sitemap"
+      - "Max 50MB uncompressed"
+      - "Submit to Google Search Console"
+      - "Reference in robots.txt"
+
+  - name: robots-txt
+    file: "robots.txt"
+    template: |
+      User-agent: *
+      Allow: /
+      Disallow: /api/
+      Disallow: /admin/
+      Sitemap: https://example.com/sitemap.xml
+    rules:
+      - "Allow all crawlers by default"
+      - "Block sensitive/private paths"
+      - "Include sitemap reference"
+      - "Don't block CSS/JS files"
+
+  - name: canonical-url
+    description: "Prevent duplicate content issues"
+    html: '<link rel="canonical" href="https://example.com/page">'
+    rules:
+      - "Every page must have canonical URL"
+      - "Self-referencing canonicals are OK"
+      - "Use absolute URLs"
+      - "Canonical must return 200"
+
+  - name: meta-tags
+    essential:
+      title:
+        format: "Primary Keyword — Secondary | Brand"
+        length: "50-60 characters"
+      description:
+        format: "Compelling summary with target keyword"
+        length: "150-160 characters"
+      viewport: "width=device-width, initial-scale=1"
+
+  - name: heading-hierarchy
+    rules:
+      - "Single h1 per page"
+      - "h1 contains primary keyword"
+      - "Hierarchy: h1 → h2 → h3 (no skipping)"
+      - "Use headings for structure, not styling"
+
+  - name: image-seo
+    rules:
+      - "Descriptive file names (blue-widget.jpg not IMG_001.jpg)"
+      - "Alt text with keywords where natural"
+      - "WebP/AVIF format for compression"
+      - "Lazy load below-fold images"
+      - "Responsive srcset for different sizes"
+
+  - name: hreflang
+    description: "Multi-language/region support"
+    html: |
+      <link rel="alternate" hreflang="en" href="https://example.com/en/page">
+      <link rel="alternate" hreflang="vi" href="https://example.com/vi/page">
+      <link rel="alternate" hreflang="x-default" href="https://example.com/page">

package/.agent/skills/cross-cutting/sql/META.yaml

@@ -1,5 +1,5 @@
-name: sql
-version: "6.2.0"
+name: sql
+version: "6.2.1"
 category: database
 tier: 3
 
@@ -13,12 +13,6 @@ patterns:
     json: 6
     queries: 6
 
-hsa:
-  enabled: true
-  adapter: sql_adapter.py
-
-triggers:
-  file_patterns:
     - "*.sql"
     - "migrations/*.sql"
     - "*.pgsql"

package/.agent/skills/cross-cutting/sql/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: sql
 detect: ["*.sql", "migrations/*.sql", "*.pgsql"]
-version: "6.1.2"
+version: "6.2.1"
 category: database
 tier: 1
 ---
@@ -278,18 +278,14 @@ ALTER TABLE users DROP COLUMN deprecated_field;
 
 ## 🔌 HSA Integration
 
-```python
-from .agent.scripts.hsa.adapters import (
-    search_sql_patterns,
-    get_sql_function,
-)
-
-# Search patterns
-results = search_sql_patterns("window function ranking")
+Data powered by HSA BM25 search engine:
 
-# Get function info
-func = get_sql_function("uuidv7")
-```
+| Domain    | Query Examples                      |
+| --------- | ----------------------------------- |
+| Query     | "window function ranking partition" |
+| Index     | "partial covering GIN index"        |
+| PG18      | "uuidv7 virtual generated columns"  |
+| Migration | "safe column removal ALTER TABLE"   |
 
 ---
 

package/.agent/skills/cross-cutting/tailwind/META.yaml

@@ -1,28 +1,11 @@
 name: tailwind
-version: "7.0.0"
+version: "6.2.1"
 display: Tailwind CSS 4.0
-category: styling
+category: cross-cutting
 tier: 1
 priority: 2
 
-desc: "Utility-first CSS framework for Tailwind CSS 4.0 (Jan 2025). Covers CSS-first config, Oxide engine, new variants, 3D transforms,"
-
-  ## HSA Integration (v1.0.0 - YAML-based)
-  Uses DOMYH HSA BM25 search engine for pattern retrieval.
-  
-  ### Data Files (8 domains, 51 patterns)
-  - `config.yaml`: @theme, @utility, @source, @import, @variant (6)
-  - `variants.yaml`: not-*, starting, inert, nth-*, descendant (8)
-  - `utilities.yaml`: 3D transforms, gradients, field-sizing (8)
-  - `responsive.yaml`: container queries, pointer, breakpoints (6)
-  - `theme.yaml`: dark mode, CSS variables, P3 colors (5)
-  - `build.yaml`: Vite plugin, Oxide engine, Lightning CSS (6)
-  - `migration.yaml`: v3→v4 upgrade, breaking changes (6)
-  - `states.yaml`: group, peer, focus, disabled, aria (6)
-
-hsa:
-  enabled: true
-  adapter: `hsa.adapters.tailwind_adapter.TailwindAdapter`
+desc: "Utility-first CSS framework for Tailwind CSS 4.1. CSS-first config, Rust+Lightning CSS engine, new variants, 3D transforms, container queries, P3 colors, migration v3→v4"
 
 triggers:
   file_patterns: