@nockdev/awf 6.2.0

package/.agent/skills/cross-cutting/kubernetes/data/workloads.yaml

@@ -0,0 +1,251 @@
+# =============================================================================
+# Kubernetes Workload Patterns (Feb 2026)
+# =============================================================================
+# Sidecar Containers, Jobs, CronJobs, StatefulSets
+
+metadata:
+  skill: kubernetes
+  domain: workloads
+  version: "1.33.0"
+  updated: "2026-02-05"
+  patterns_count: 5
+
+patterns:
+  - id: k8s010
+    name: Native Sidecar Containers (1.29+)
+    category: workloads
+    version: "1.29+"
+    description: Built-in sidecar support with startup/shutdown ordering
+    text: sidecar container init container native lifecycle ordering
+    example: |
+      # Native sidecars (stable in K8s 1.32+)
+      apiVersion: v1
+      kind: Pod
+      metadata:
+        name: app-with-sidecar
+      spec:
+        initContainers:
+          # Sidecar: restartPolicy = Always
+          - name: log-collector
+            image: fluentbit:latest
+            restartPolicy: Always  # This makes it a sidecar!
+            volumeMounts:
+              - name: logs
+                mountPath: /var/log/app
+
+          # Regular init container (runs once)
+          - name: db-migration
+            image: migrate:latest
+            command: ["./migrate", "up"]
+
+        containers:
+          - name: app
+            image: myapp:latest
+            volumeMounts:
+              - name: logs
+                mountPath: /var/log/app
+
+        volumes:
+          - name: logs
+            emptyDir: {}
+
+      # Benefits:
+      # - Sidecar starts BEFORE main containers
+      # - Sidecar terminates AFTER main containers
+      # - Proper lifecycle ordering (critical for logging)
+      # - No more Job completion issues with sidecars
+    severity: CRITICAL
+    docs_url: https://kubernetes.io/docs/concepts/workloads/pods/sidecar-containers/
+
+  - id: k8s011
+    name: Jobs with Backoff Limit
+    category: workloads
+    version: "1.0+"
+    description: One-time batch processing with retry handling
+    text: job batch processing backoff limit completion parallel
+    example: |
+      apiVersion: batch/v1
+      kind: Job
+      metadata:
+        name: data-processor
+      spec:
+        # Retry config
+        backoffLimit: 3
+        backoffLimitPerIndex: 1  # K8s 1.29+
+        activeDeadlineSeconds: 600
+
+        # Parallel execution
+        parallelism: 5
+        completions: 100
+        completionMode: Indexed  # Pod gets JOB_COMPLETION_INDEX
+
+        template:
+          spec:
+            restartPolicy: Never
+            containers:
+              - name: processor
+                image: processor:latest
+                env:
+                  - name: BATCH_INDEX
+                    valueFrom:
+                      fieldRef:
+                        fieldPath: metadata.annotations['batch.kubernetes.io/job-completion-index']
+
+      # K8s 1.29+ features:
+      # - backoffLimitPerIndex: Fail fast per index
+      # - podFailurePolicy: Custom failure handling
+      # - successPolicy: Partial success definitions
+    severity: HIGH
+    docs_url: https://kubernetes.io/docs/concepts/workloads/controllers/job/
+
+  - id: k8s012
+    name: CronJobs with Timezone
+    category: workloads
+    version: "1.27+"
+    description: Scheduled jobs with timezone support
+    text: cronjob scheduled job timezone cron recurring
+    example: |
+      apiVersion: batch/v1
+      kind: CronJob
+      metadata:
+        name: nightly-backup
+      spec:
+        schedule: "0 2 * * *"  # 2 AM
+        timeZone: "America/New_York"  # K8s 1.27+ timezone support!
+
+        # Concurrency handling
+        concurrencyPolicy: Forbid  # Or: Allow, Replace
+        startingDeadlineSeconds: 200
+
+        # Job history
+        successfulJobsHistoryLimit: 3
+        failedJobsHistoryLimit: 3
+
+        jobTemplate:
+          spec:
+            template:
+              spec:
+                restartPolicy: OnFailure
+                containers:
+                  - name: backup
+                    image: backup-tool:latest
+                    envFrom:
+                      - secretRef:
+                          name: backup-secrets
+
+      # Common schedules:
+      # "0 * * * *"     - Every hour
+      # "*/15 * * * *"  - Every 15 minutes
+      # "0 0 * * 0"     - Weekly on Sunday
+      # "0 0 1 * *"     - Monthly on 1st
+    severity: MEDIUM
+    docs_url: https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/
+
+  - id: k8s013
+    name: StatefulSets with VolumeClaimTemplates
+    category: workloads
+    version: "1.0+"
+    description: Stable network identity and persistent storage
+    text: statefulset persistent storage database stable identity
+    example: |
+      apiVersion: apps/v1
+      kind: StatefulSet
+      metadata:
+        name: postgres
+      spec:
+        serviceName: postgres
+        replicas: 3
+        podManagementPolicy: Parallel  # Fast startup
+        updateStrategy:
+          type: RollingUpdate
+          rollingUpdate:
+            partition: 0
+
+        selector:
+          matchLabels:
+            app: postgres
+
+        template:
+          metadata:
+            labels:
+              app: postgres
+          spec:
+            containers:
+              - name: postgres
+                image: postgres:16
+                ports:
+                  - containerPort: 5432
+                volumeMounts:
+                  - name: data
+                    mountPath: /var/lib/postgresql/data
+                env:
+                  - name: POSTGRES_PASSWORD
+                    valueFrom:
+                      secretKeyRef:
+                        name: postgres-secret
+                        key: password
+
+        # Each pod gets its own PVC
+        volumeClaimTemplates:
+          - metadata:
+              name: data
+            spec:
+              accessModes: ["ReadWriteOnce"]
+              storageClassName: fast-ssd
+              resources:
+                requests:
+                  storage: 100Gi
+
+      # Pods created: postgres-0, postgres-1, postgres-2
+      # PVCs created: data-postgres-0, data-postgres-1, data-postgres-2
+    severity: HIGH
+    docs_url: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/
+
+  - id: k8s014
+    name: Pod Disruption Budgets
+    category: workloads
+    version: "1.0+"
+    description: Ensure availability during voluntary disruptions
+    text: pdb pod disruption budget availability maintenance
+    example: |
+      # Ensure at least 2 pods always running
+      apiVersion: policy/v1
+      kind: PodDisruptionBudget
+      metadata:
+        name: api-pdb
+      spec:
+        minAvailable: 2
+        selector:
+          matchLabels:
+            app: api
+
+      # Or: Allow max 1 unavailable
+      apiVersion: policy/v1
+      kind: PodDisruptionBudget
+      metadata:
+        name: worker-pdb
+      spec:
+        maxUnavailable: 1
+        selector:
+          matchLabels:
+            app: worker
+
+      # Or: Percentage based (K8s 1.25+)
+      apiVersion: policy/v1
+      kind: PodDisruptionBudget
+      metadata:
+        name: cache-pdb
+      spec:
+        minAvailable: "50%"
+        selector:
+          matchLabels:
+            app: cache
+        # K8s 1.27+: Unhealthy pod eviction policy
+        unhealthyPodEvictionPolicy: AlwaysAllow
+
+      # Use cases:
+      # - Node draining for maintenance
+      # - Cluster autoscaler scale-down
+      # - Voluntary pod evictions
+    severity: HIGH
+    docs_url: https://kubernetes.io/docs/concepts/workloads/pods/disruptions/

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

@@ -0,0 +1,88 @@
+name: sql
+version: "6.2.0"
+category: database
+tier: 3
+
+desc: "SQL development patterns for PostgreSQL 17/18, MySQL 8+. Covers query optimization, migrations, indexes, JSON, performance."
+
+patterns:
+  total: 28
+  domains:
+    indexing: 7
+    performance: 9
+    json: 6
+    queries: 6
+
+hsa:
+  enabled: true
+  adapter: sql_adapter.py
+
+triggers:
+  file_patterns:
+    - "*.sql"
+    - "migrations/*.sql"
+    - "*.pgsql"
+  keywords:
+    # Core
+    - sql
+    - query
+    - database query
+    - select from
+    - insert into
+    - update set
+    - delete from
+    # PostgreSQL
+    - postgresql
+    - postgres
+    - psql
+    - pg_dump
+    - pgadmin
+    - pg18
+    - pg17
+    # Features - Indexing
+    - index
+    - gin index
+    - b-tree
+    - covering index
+    - partial index
+    - skip scan
+    # Features - Performance
+    - explain analyze
+    - async io
+    - pg_stat
+    - connection pooling
+    - vacuum
+    # Features - JSON
+    - jsonb
+    - json_table
+    - uuidv7
+    # Features - Queries
+    - cte
+    - window function
+    - upsert
+    - lateral join
+    - recursive
+    # MySQL
+    - mysql
+    - mariadb
+    # SQLite
+    - sqlite
+    # ORM
+    - raw sql
+    - query builder
+  intents:
+    - write sql query
+    - optimize query
+    - create migration
+    - database schema
+    - postgresql performance
+    - indexing strategy
+
+related_skills:
+  - database
+  - python
+  - go
+  - nodejs
+
+prevent_confusion_with:
+  - database: "SQL is query language, database skill covers ORMs"

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

@@ -0,0 +1,296 @@
+---
+name: sql
+detect: ["*.sql", "migrations/*.sql", "*.pgsql"]
+version: "6.1.2"
+category: database
+tier: 1
+---
+
+# SQL Patterns — DOMYH Awesome Code
+
+> **Version**: PostgreSQL 18, MySQL 8.4+
+> **Focus**: Query optimization, migrations, performance
+> **Philosophy**: Declarative, set-based thinking
+
+---
+
+## 🎯 When to Use This Skill
+
+Use for: Database queries, data analysis, migrations, reporting.
+**NOT for**: Application logic (→ go/python), UI (→ react).
+
+---
+
+## 📦 What's New in PostgreSQL 18 (2025)
+
+| Feature                       | Description                     |
+| ----------------------------- | ------------------------------- |
+| **Async I/O (AIO)**           | Revolutionary performance boost |
+| **uuidv7()**                  | Timestamp-ordered UUIDs         |
+| **Virtual Generated Columns** | Computed on read                |
+| **Skip Scan**                 | B-tree optimization             |
+| **pg_stat_io**                | I/O monitoring                  |
+| **NOT NULL/FK enhancements**  | Data integrity                  |
+
+---
+
+## 📦 Database Comparison
+
+| Feature   | PostgreSQL 18  | MySQL 8.4+ | SQLite    |
+| --------- | -------------- | ---------- | --------- |
+| Async I/O | ✅ AIO 🏆      | Partial    | ❌        |
+| JSON      | JSONB 🏆       | JSON       | JSON1     |
+| UUIDv7    | ✅ Built-in 🏆 | Plugin     | ❌        |
+| CTEs      | Recursive      | Recursive  | Recursive |
+| Window    | Full           | Full       | Basic     |
+| Best for  | Complex apps   | Web apps   | Embedded  |
+
+---
+
+## 🔄 Query Patterns
+
+### Modern SELECT with CTEs
+
+```sql
+WITH active_orders AS (
+  SELECT
+    user_id,
+    COUNT(*) AS order_count,
+    SUM(total) AS total_spent
+  FROM orders
+  WHERE status = 'completed'
+    AND created_at >= CURRENT_DATE - INTERVAL '30 days'
+  GROUP BY user_id
+),
+user_ranks AS (
+  SELECT
+    *,
+    RANK() OVER (ORDER BY total_spent DESC) AS spending_rank,
+    PERCENT_RANK() OVER (ORDER BY total_spent) AS percentile
+  FROM active_orders
+)
+SELECT
+  u.id, u.name, u.email,
+  ur.order_count, ur.total_spent, ur.spending_rank
+FROM users u
+JOIN user_ranks ur ON u.id = ur.user_id
+WHERE ur.percentile >= 0.9
+ORDER BY ur.spending_rank;
+```
+
+### 🆕 UUIDv7 (PostgreSQL 18)
+
+```sql
+-- Timestamp-ordered UUIDs (better for indexing)
+CREATE TABLE orders (
+  id UUID PRIMARY KEY DEFAULT uuidv7(),
+  user_id UUID NOT NULL,
+  total DECIMAL(10,2),
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- UUIDv7 sorts chronologically!
+SELECT * FROM orders ORDER BY id;
+```
+
+### 🆕 Virtual Generated Columns
+
+```sql
+-- Computed on read (no storage)
+ALTER TABLE users
+ADD COLUMN full_name TEXT GENERATED ALWAYS AS (first_name || ' ' || last_name) VIRTUAL;
+
+-- vs STORED (computed on write)
+ALTER TABLE orders
+ADD COLUMN tax DECIMAL GENERATED ALWAYS AS (total * 0.1) STORED;
+```
+
+### Window Functions
+
+```sql
+-- Running totals with moving average
+SELECT
+  date,
+  amount,
+  SUM(amount) OVER (ORDER BY date) AS running_total,
+  AVG(amount) OVER (
+    ORDER BY date
+    ROWS BETWEEN 6 PRECEDING AND CURRENT ROW
+  ) AS moving_avg_7d
+FROM daily_sales;
+
+-- Ranking with gap detection
+SELECT
+  department,
+  employee_name,
+  salary,
+  ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) AS rank,
+  salary - LAG(salary) OVER (PARTITION BY department ORDER BY salary DESC) AS gap
+FROM employees;
+```
+
+### Recursive CTEs
+
+```sql
+WITH RECURSIVE org_tree AS (
+  SELECT id, name, manager_id, 1 AS level, ARRAY[id] AS path
+  FROM employees
+  WHERE manager_id IS NULL
+
+  UNION ALL
+
+  SELECT e.id, e.name, e.manager_id, ot.level + 1, ot.path || e.id
+  FROM employees e
+  JOIN org_tree ot ON e.manager_id = ot.id
+  WHERE NOT e.id = ANY(ot.path)
+)
+SELECT REPEAT('  ', level - 1) || name AS hierarchy, level
+FROM org_tree
+ORDER BY path;
+```
+
+---
+
+## ⚡ Performance Optimization
+
+### Index Strategy
+
+```sql
+-- Partial index (filtered)
+CREATE INDEX CONCURRENTLY idx_orders_active
+ON orders (user_id, status)
+WHERE status != 'cancelled';
+
+-- Covering index (includes columns)
+CREATE INDEX idx_orders_covering
+ON orders (user_id, created_at)
+INCLUDE (total, status);
+
+-- GIN for JSONB
+CREATE INDEX idx_products_attrs
+ON products USING GIN (attributes jsonb_path_ops);
+
+-- Full-text search
+CREATE INDEX idx_posts_search
+ON posts USING GIN (to_tsvector('english', title || ' ' || body));
+```
+
+### 🆕 pg_stat_io Monitoring (PostgreSQL 18)
+
+```sql
+-- I/O statistics per backend type
+SELECT
+  backend_type,
+  object,
+  context,
+  reads,
+  writes,
+  extends,
+  fsyncs
+FROM pg_stat_io
+WHERE reads > 0 OR writes > 0;
+```
+
+### Query Analysis
+
+```sql
+EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)
+SELECT * FROM orders WHERE user_id = 123;
+
+-- Watch for:
+-- - Seq Scan on large tables → Need index
+-- - Nested Loop with high rows → Consider hash join
+-- - Buffers: shared hit vs read → Cache efficiency
+```
+
+---
+
+## 🔒 JSONB Patterns
+
+```sql
+-- Query JSONB
+SELECT * FROM products
+WHERE attributes->>'color' = 'red'
+  AND (attributes->>'price')::numeric < 100;
+
+-- Update JSONB field
+UPDATE products
+SET attributes = jsonb_set(
+  attributes, '{discount}', '"20%"'::jsonb
+)
+WHERE id = 1;
+
+-- Aggregate to JSONB
+SELECT jsonb_agg(
+  jsonb_build_object('id', id, 'name', name, 'total', total)
+  ORDER BY total DESC
+) AS top_customers
+FROM customers
+LIMIT 10;
+```
+
+---
+
+## 📦 Migration Patterns
+
+```sql
+-- Add column with default (non-blocking in PG 11+)
+ALTER TABLE users
+ADD COLUMN preferences JSONB DEFAULT '{}'::jsonb;
+
+-- Create index concurrently (non-blocking)
+CREATE INDEX CONCURRENTLY idx_users_email
+ON users (email);
+
+-- Safe column removal (3-step)
+-- Step 1: Stop writing
+-- Step 2: Deploy code that doesn't read
+-- Step 3: Drop column
+ALTER TABLE users DROP COLUMN deprecated_field;
+```
+
+---
+
+## ✅ Production Checklist
+
+### Performance
+
+- [ ] EXPLAIN ANALYZE on all queries
+- [ ] Proper indexes exist
+- [ ] No SELECT \* in production
+- [ ] Pagination with keyset (not OFFSET)
+- [ ] pg_stat_io monitored
+
+### Safety
+
+- [ ] Transactions for multi-statement ops
+- [ ] ON CONFLICT for upserts
+- [ ] Parameterized queries (no injection)
+- [ ] Timeouts configured
+
+### Monitoring
+
+- [ ] Slow query log enabled
+- [ ] pg_stat_statements for analysis
+- [ ] Connection pool limits
+
+---
+
+## 🔌 HSA Integration
+
+```python
+from .agent.scripts.hsa.adapters import (
+    search_sql_patterns,
+    get_sql_function,
+)
+
+# Search patterns
+results = search_sql_patterns("window function ranking")
+
+# Get function info
+func = get_sql_function("uuidv7")
+```
+
+---
+
+_DOMYH Awesome Code • SQL PostgreSQL 18 • 2026_